feat(cli): export — patch a local agent back to its source-of-truth repo

[matheusmlopess]

agentfactory-gen export — patch a local agent back to its source repo

The inverse of import. When you've edited an imported agent in
.ai/agents/<name>/, export flows those changes back upstream to the
agent's source-of-truth repo as a reviewable PR.

flowchart LR
    A[".ai/agents/&lt;name&gt;/<br/>(local edits)"] --> E([agentfactory-gen export])
    E --> C[clone source repo]
    C --> P["apply over agent/ subpath<br/>(auto-detected)"]
    P --> B["branch agentfactory/export-&lt;name&gt;<br/>commit + push"]
    B --> R([gh pr create])

Loading

What it does

1. Resolves the source repo: --git URL, else the source recorded at import.
2. Clones it; detects where the agent lives (agent/ subpath or repo root).
3. Copies the local agent-manifest.json + tracked dirs (skills/ commands/ docs/ scripts/ orchestration/) over it.
4. Commits on agentfactory/export-<name>, pushes, opens a PR.

Options

--git URL · --subpath · --branch · -m/--message · --project-root ·
--push/--no-push (writes a .patch) · --pr/--no-pr.

Also in this PR

• import records the source ({"git": url} / {"registry": slug}) in the agent
  manifest, so export defaults to it (no need to retype the URL).
• --git accepts local paths / file:// — offline use + makes the feature testable
  against a bare repo. (Also a step toward AgentFactory#179 gap 2.)

Tests

src/tests/test_export.py — 5 tests (push-to-recorded-source, explicit --git,
no-source error, --no-push patch, missing-agent error). All pass.

Full suite: 300 passed, 2 failed — the 2 are pre-existing live external-CLI tests
(test_live_agent_acknowledges_harness[gemini/codex]) failing on Gemini/Codex auth,
confirmed failing on clean main. Unrelated to this change.

🤖 Generated with Claude Code