Jido.Lib

Warning

jido_lib is deprecated and unsupported. It is no longer maintained and will not receive dependency updates, bug fixes, security fixes, or new releases. Do not use it for new projects.

Standard library modules for the Jido ecosystem, including six canonical GitHub bot workflows:

• Issue Triage Bot
• Documentation Writer Bot
• PR Bot
• Quality Bot
• Release Bot
• Roadmap Bot

Package Purpose

jido_lib owns GitHub-domain workflow orchestration:

• issue triage in Sprite workspaces
• documentation generation via persistent multi-repo sprite context
• provider-swappable coding agent execution (:claude | :amp | :codex | :gemini)
• branch/commit/check/push/PR/comment lifecycle for issue-to-PR automation
• policy-driven repository quality evaluation and safe-fix flows
• release orchestration (versioning/changelog/quality gate/publish)
• dependency-aware roadmap queue execution

Lower-level runtime concerns stay in jido_harness, jido_shell, and jido_vfs.

Canonical APIs

GitHub PR Bot

• Jido.Lib.Github.Agents.PrBot.run_issue/2
• Jido.Lib.Github.Agents.PrBot.build_intake/2
• Jido.Lib.Github.Agents.PrBot.intake_signal/1

Jido.Lib.Github.Agents.PrBot.run_issue(
  "https://github.com/owner/repo/issues/42",
  jido: Jido.Default,
  timeout: 900_000
)

GitHub Issue Triage Bot

• Jido.Lib.Github.Agents.IssueTriageBot.triage/2
• Jido.Lib.Github.Agents.IssueTriageBot.intake_signal/2

Jido.Lib.Github.Agents.IssueTriageBot.triage(
  "https://github.com/owner/repo/issues/42",
  jido: Jido.Default,
  timeout: 600_000
)

GitHub Documentation Writer Bot

• Jido.Lib.Github.Agents.DocumentationWriterBot.run_brief/2

Jido.Lib.Github.Agents.DocumentationWriterBot.run_brief(
  File.read!("brief.md"),
  repos: ["owner/repo:primary", "owner/context_repo:context"],
  output_repo: "primary",
  sprite_name: "docs-sprite-1",
  jido: Jido.Default
)

GitHub Quality Bot

• Jido.Lib.Github.Agents.QualityBot.run_target/2

Jido.Lib.Github.Agents.QualityBot.run_target(
  "owner/repo",
  apply: false,
  jido: Jido.Default
)

GitHub Release Bot

• Jido.Lib.Github.Agents.ReleaseBot.run_repo/2

Jido.Lib.Github.Agents.ReleaseBot.run_repo(
  "owner/repo",
  publish: false,
  jido: Jido.Default
)

GitHub Roadmap Bot

• Jido.Lib.Github.Agents.RoadmapBot.run_plan/2

Jido.Lib.Github.Agents.RoadmapBot.run_plan(
  "owner/repo",
  apply: false,
  push: false,
  open_pr: false,
  jido: Jido.Default
)

Mix Tasks

mix jido_lib.github.triage https://github.com/owner/repo/issues/42
mix jido_lib.github.docs path/to/brief.md --repo owner/repo:primary --output-repo primary --sprite-name docs-sprite-1
mix jido_lib.github.pr https://github.com/owner/repo/issues/42
mix jido_lib.github.quality owner/repo --yes
mix jido_lib.github.release owner/repo --yes
mix jido_lib.github.roadmap owner/repo --yes

Mutation defaults for the new tasks are intentionally aggressive and require --yes:

• mix jido_lib.github.quality defaults to --apply true
• mix jido_lib.github.release defaults to --publish true --dry-run false
• mix jido_lib.github.roadmap defaults to --apply true --push true --open-pr true

To run non-mutating mode without --yes, explicitly disable mutation flags:

mix jido_lib.github.quality owner/repo --apply false
mix jido_lib.github.release owner/repo --publish false
mix jido_lib.github.roadmap owner/repo --apply false --push false --open-pr false

Testing Paths

1) Deterministic local test suite

mix test
mix quality

Bot-focused suite:

mix test test/jido_lib/github/agents test/jido_lib/github/actions test/mix/tasks

2) Live Issue Triage bot smoke test

mix jido_lib.github.triage \
  https://github.com/owner/repo/issues/42 \
  --provider claude \
  --timeout 600 \
  --setup-cmd "mix deps.get"

3) Live PR bot smoke test

For orchestration-only validation (skip project checks):

mix jido_lib.github.pr \
  https://github.com/owner/repo/issues/42 \
  --provider claude \
  --timeout 600 \
  --setup-cmd "mix deps.get" \
  --check-cmd "true"

For full gating with project checks:

mix jido_lib.github.pr \
  https://github.com/owner/repo/issues/42 \
  --provider claude \
  --timeout 600 \
  --setup-cmd "mix deps.get" \
  --check-cmd "mix test --exclude integration"

Note: when --check-cmd is omitted, PR bot defaults to mix test --exclude integration.

4) Live Quality/Release/Roadmap smoke commands

mix jido_lib.github.quality owner/repo --yes
mix jido_lib.github.release owner/repo --yes
mix jido_lib.github.roadmap owner/repo --yes

Credentials Required for Successful Live Runs

Core required

• SPRITES_TOKEN
• GH_TOKEN or GITHUB_TOKEN

Provider-specific required

• claude: one of ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY, CLAUDE_CODE_API_KEY
• amp: AMP_API_KEY
• codex: OPENAI_API_KEY
• gemini: one of GEMINI_API_KEY, GOOGLE_API_KEY, GOOGLE_GENAI_USE_VERTEXAI, GOOGLE_GENAI_USE_GCA

Optional but common

• ANTHROPIC_BASE_URL (for Claude-compatible proxy endpoints such as Z.AI)

Workflow Docs

• docs/github_issue_triage_workflow.md
• docs/github_documentation_writer_workflow.md
• docs/github_pr_bot_workflow.md
• docs/github_quality_bot_workflow.md
• docs/github_release_bot_workflow.md
• docs/github_roadmap_bot_workflow.md

Development

mix setup
mix test
mix quality