alexion
d03a079854
- CONVENTIONAL-COMMITS.md: vendored spec (v1.0.0); CLAUDE.md requires agent-written commits to follow it - tasks 0002-0020: remaining task breakdown of the gitea-axi spec (0019 reframed around the three-tier test taxonomy: unit, integration, end-to-end) - spec, CONTEXT.md, and ADRs 0006/0007/0011: pending design refinements from the planning sessions
2.0 KiB
spec, blocked-by
| spec | blocked-by |
|---|---|
| gitea-axi | 0017-dashboard |
What to build
Ambient-context distribution: the bundled Agent Skill, the setup command, the opt-in setup hooks, and the shadowed update command (see ADRs 0009 and 0013).
Author the Agent Skill markdown as a minimal pointer, not a command reference: frontmatter description triggering on Gitea issue/PR/label work; a body saying when to use gitea-axi over tea, raw API calls, or git; one-line command-group summaries; and pointers at the bare dashboard and per-command --help — the CLI stays the single source of interface truth.
setup installs the skill into the user-level skills directory, idempotently reporting installed/updated/unchanged.
setup hooks installs a SessionStart hook via axi-sdk-js's installSessionStartHooks() for Claude Code, Codex, and OpenCode; the hook runs the bare binary (short dashboard tier) at session start.
update shadows the SDK's built-in self-update command, failing with VALIDATION_ERROR and a help line pointing at the npm update command, keeping the ten-code error list intact.
There is no postinstall script — skill and hook installation are always explicit user actions.
Acceptance criteria
- The Agent Skill markdown is bundled in the package and follows the minimal-pointer shape (trigger description, when-to-use, command-group one-liners, discovery pointers)
gitea-axi setupinstalls the skill and outputssetup: { skill, path, status }; re-running reportsupdatedorunchangedrather than failinggitea-axi setup hooksregisters the SessionStart hook for all three integrations via the SDK and outputs thehooks:block with a restart help line; managed entries are updated in place on re-rungitea-axi updatefails withVALIDATION_ERROR(exit 2) and the npm update help line; the SDK'sUPDATE_ERRORnever surfaces- Tests cover the setup idempotency states and the update shadow (hook installation verified against a temp home directory)