@agents-inc/cli 0.79.0 → 0.80.0

package/dist/components/wizard/wizard.js

@@ -1,44 +1,44 @@
 #!/usr/bin/env node
 import {
   Wizard
-} from "../../chunk-B4C2S5LP.js";
-import "../../chunk-VDVLM3KB.js";
-import "../../chunk-KQDGLEBF.js";
-import "../../chunk-YFHVP3VA.js";
-import "../../chunk-F4IZ3UAS.js";
+} from "../../chunk-BORVYGIX.js";
+import "../../chunk-3HWFTE3S.js";
+import "../../chunk-TJXBRYM4.js";
+import "../../chunk-F4VG5XWZ.js";
+import "../../chunk-55AZIEK6.js";
 import "../../chunk-V36FRPAU.js";
-import "../../chunk-N2XGUAJU.js";
-import "../../chunk-OOWNDQCG.js";
-import "../../chunk-HANGA633.js";
-import "../../chunk-KVRR4PEJ.js";
+import "../../chunk-6YJXWQCI.js";
+import "../../chunk-3WDZKBCE.js";
+import "../../chunk-OBTC2FD7.js";
+import "../../chunk-NJCU7OC2.js";
 import "../../chunk-PZERKWE2.js";
 import "../../chunk-K77I4XGL.js";
-import "../../chunk-NKLNT7N7.js";
+import "../../chunk-H3NQGJMB.js";
 import "../../chunk-K63OEZW7.js";
-import "../../chunk-D4T3HHE7.js";
+import "../../chunk-MNJAF4K2.js";
 import "../../chunk-7SOPVGDV.js";
 import "../../chunk-A5JSBU65.js";
-import "../../chunk-W46L2PXK.js";
+import "../../chunk-WZGROC5L.js";
 import "../../chunk-P2FHS5IS.js";
-import "../../chunk-QD3GQ2CH.js";
-import "../../chunk-7JQIMEUX.js";
+import "../../chunk-II3ISVCE.js";
+import "../../chunk-3SCIYMRK.js";
 import "../../chunk-RU5XLS5Q.js";
 import "../../chunk-SQ7WINEU.js";
 import "../../chunk-FFMWFEUH.js";
 import "../../chunk-C22ACAL2.js";
 import "../../chunk-MLXAZODL.js";
 import "../../chunk-KUV24B5M.js";
-import "../../chunk-N34D3ROY.js";
+import "../../chunk-TXFQBYOX.js";
 import "../../chunk-3REKTRAN.js";
 import "../../chunk-U3IGFMCY.js";
 import "../../chunk-HK53FRMU.js";
-import "../../chunk-OIHZ2YH3.js";
-import "../../chunk-IFCASC6R.js";
-import "../../chunk-FSK4TQX7.js";
-import "../../chunk-XYPAOBBV.js";
-import "../../chunk-32HX6UYI.js";
+import "../../chunk-XFL7EIM7.js";
+import "../../chunk-TZY7WNWO.js";
+import "../../chunk-4R6I6A3U.js";
+import "../../chunk-633YIZOU.js";
+import "../../chunk-BN73X3JN.js";
 import "../../chunk-FMYAYX6W.js";
-import "../../chunk-EO6KJI5D.js";
+import "../../chunk-PPBUSAKG.js";
 import "../../chunk-DHET7RCE.js";
 export {
   Wizard

package/dist/config-exports.js

@@ -4,7 +4,7 @@ import {
   defaultRules,
   defaultStacks,
   defineConfig
-} from "./chunk-EO6KJI5D.js";
+} from "./chunk-PPBUSAKG.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";

package/dist/hooks/init.js

@@ -1,35 +1,35 @@
 #!/usr/bin/env node
 import {
   showDashboard
-} from "../chunk-OTMIGYBB.js";
-import "../chunk-B4C2S5LP.js";
-import "../chunk-VDVLM3KB.js";
-import "../chunk-KQDGLEBF.js";
-import "../chunk-YFHVP3VA.js";
-import "../chunk-F4IZ3UAS.js";
+} from "../chunk-RTHAMTDE.js";
+import "../chunk-BORVYGIX.js";
+import "../chunk-3HWFTE3S.js";
+import "../chunk-TJXBRYM4.js";
+import "../chunk-F4VG5XWZ.js";
+import "../chunk-55AZIEK6.js";
 import "../chunk-V36FRPAU.js";
-import "../chunk-N2XGUAJU.js";
-import "../chunk-OOWNDQCG.js";
-import "../chunk-HANGA633.js";
-import "../chunk-KVRR4PEJ.js";
+import "../chunk-6YJXWQCI.js";
+import "../chunk-3WDZKBCE.js";
+import "../chunk-OBTC2FD7.js";
+import "../chunk-NJCU7OC2.js";
 import "../chunk-PZERKWE2.js";
 import "../chunk-K77I4XGL.js";
-import "../chunk-NKLNT7N7.js";
+import "../chunk-H3NQGJMB.js";
 import "../chunk-K63OEZW7.js";
-import "../chunk-D4T3HHE7.js";
+import "../chunk-MNJAF4K2.js";
 import "../chunk-7SOPVGDV.js";
 import "../chunk-A5JSBU65.js";
-import "../chunk-W46L2PXK.js";
+import "../chunk-WZGROC5L.js";
 import "../chunk-P2FHS5IS.js";
-import "../chunk-QD3GQ2CH.js";
-import "../chunk-7JQIMEUX.js";
+import "../chunk-II3ISVCE.js";
+import "../chunk-3SCIYMRK.js";
 import "../chunk-RU5XLS5Q.js";
 import "../chunk-SQ7WINEU.js";
 import "../chunk-FFMWFEUH.js";
 import "../chunk-C22ACAL2.js";
 import "../chunk-MLXAZODL.js";
 import "../chunk-KUV24B5M.js";
-import "../chunk-N34D3ROY.js";
+import "../chunk-TXFQBYOX.js";
 import "../chunk-3REKTRAN.js";
 import "../chunk-U3IGFMCY.js";
 import "../chunk-HK53FRMU.js";
@@ -37,16 +37,16 @@ import "../chunk-M76LNKMY.js";
 import {
   detectInstallation,
   resolveSource
-} from "../chunk-OIHZ2YH3.js";
-import "../chunk-IFCASC6R.js";
-import "../chunk-FSK4TQX7.js";
+} from "../chunk-XFL7EIM7.js";
+import "../chunk-TZY7WNWO.js";
+import "../chunk-4R6I6A3U.js";
 import {
   EXIT_CODES
-} from "../chunk-7LBYURQR.js";
-import "../chunk-XYPAOBBV.js";
-import "../chunk-32HX6UYI.js";
+} from "../chunk-TQ363UUH.js";
+import "../chunk-633YIZOU.js";
+import "../chunk-BN73X3JN.js";
 import "../chunk-FMYAYX6W.js";
-import "../chunk-EO6KJI5D.js";
+import "../chunk-PPBUSAKG.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";

package/dist/{loader-JMOO2A7C.js → loader-LI3EM4VG.js}

@@ -5,9 +5,9 @@ import {
   loadProjectAgents,
   loadSkillsByIds,
   parseFrontmatter
-} from "./chunk-IFCASC6R.js";
-import "./chunk-XYPAOBBV.js";
-import "./chunk-32HX6UYI.js";
+} from "./chunk-TZY7WNWO.js";
+import "./chunk-633YIZOU.js";
+import "./chunk-BN73X3JN.js";
 import "./chunk-FMYAYX6W.js";
 import "./chunk-DHET7RCE.js";
 export {
@@ -17,4 +17,4 @@ export {
   loadSkillsByIds,
   parseFrontmatter
 };
-//# sourceMappingURL=loader-JMOO2A7C.js.map
+//# sourceMappingURL=loader-LI3EM4VG.js.map

package/dist/{source-loader-D3VIG3GM.js → source-loader-TPUCZELX.js}

@@ -4,13 +4,13 @@ import {
   extractSourceName,
   loadSkillsMatrixFromSource,
   mergeLocalSkillsIntoMatrix
-} from "./chunk-OIHZ2YH3.js";
-import "./chunk-IFCASC6R.js";
-import "./chunk-FSK4TQX7.js";
-import "./chunk-XYPAOBBV.js";
-import "./chunk-32HX6UYI.js";
+} from "./chunk-XFL7EIM7.js";
+import "./chunk-TZY7WNWO.js";
+import "./chunk-4R6I6A3U.js";
+import "./chunk-633YIZOU.js";
+import "./chunk-BN73X3JN.js";
 import "./chunk-FMYAYX6W.js";
-import "./chunk-EO6KJI5D.js";
+import "./chunk-PPBUSAKG.js";
 import "./chunk-DHET7RCE.js";
 export {
   convertStackToResolvedStack,
@@ -18,4 +18,4 @@ export {
   loadSkillsMatrixFromSource,
   mergeLocalSkillsIntoMatrix
 };
-//# sourceMappingURL=source-loader-D3VIG3GM.js.map
+//# sourceMappingURL=source-loader-TPUCZELX.js.map

package/dist/source-manager-PJ5APXX2.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import {
+  addSource,
+  getSourceSummary,
+  removeSource
+} from "./chunk-XFL7EIM7.js";
+import "./chunk-TZY7WNWO.js";
+import "./chunk-4R6I6A3U.js";
+import "./chunk-633YIZOU.js";
+import "./chunk-BN73X3JN.js";
+import "./chunk-FMYAYX6W.js";
+import "./chunk-PPBUSAKG.js";
+import "./chunk-DHET7RCE.js";
+export {
+  addSource,
+  getSourceSummary,
+  removeSource
+};
+//# sourceMappingURL=source-manager-PJ5APXX2.js.map

package/dist/src/agents/meta/agent-summoner/workflow.md

@@ -436,7 +436,7 @@ Boundaries:
 - `researcher/` - Read-only research agents (web-researcher, api-researcher)
 - `planning/` - Planning agents (web-pm)
 - `pattern/` - Pattern discovery agents (pattern-scout, web-pattern-critique)
-- `meta/` - Meta-level agents (agent-summoner, skill-summoner, documentor)
+- `meta/` - Meta-level agents (agent-summoner, skill-summoner, scribe, convention-keeper)
 - `tester/` - Testing agents (web-tester, cli-tester)
 
 **Directory structure:**
@@ -1493,15 +1493,15 @@ Output formats are determined by the file system with cascading resolution:
 1. **Agent-level**: `src/agents/{category}/{agent-name}/output-format.md`
 2. **Category fallback**: `src/agents/{category}/output-format.md`
 
-| Category   | Example Agents                              |
-| ---------- | ------------------------------------------- |
-| developer  | web-developer, api-developer, cli-developer |
-| reviewer   | web-reviewer, api-reviewer, cli-reviewer    |
-| researcher | web-researcher, api-researcher              |
-| planning   | web-pm, web-architecture                    |
-| tester     | web-tester, cli-tester                      |
-| pattern    | pattern-scout, web-pattern-critique         |
-| meta       | documentor, agent-summoner, skill-summoner  |
+| Category   | Example Agents                                            |
+| ---------- | --------------------------------------------------------- |
+| developer  | web-developer, api-developer, cli-developer               |
+| reviewer   | web-reviewer, api-reviewer, cli-reviewer                  |
+| researcher | web-researcher, api-researcher                            |
+| planning   | web-pm, web-architecture                                  |
+| tester     | web-tester, cli-tester                                    |
+| pattern    | pattern-scout, web-pattern-critique                       |
+| meta       | scribe, agent-summoner, skill-summoner, convention-keeper |
 
 ---
 

package/dist/src/agents/meta/convention-keeper/critical-reminders.md

@@ -0,0 +1,17 @@
+## CRITICAL REMINDERS
+
+**(You MUST read ALL unprocessed findings in `.agents-docs/findings/` before proposing any changes)**
+
+**(You MUST cross-reference every finding against existing standards in `docs/standards/` and `CLAUDE.md`)**
+
+**(You MUST classify each finding group as: enforcement gap, documentation gap, or convention drift)**
+
+**(You MUST propose surgical additions to existing docs - never rewrite entire documents or create new doc files)**
+
+**(You MUST move processed findings to `findings/done/` after updates are applied - never delete findings)**
+
+**(You MUST re-read files after editing to verify changes were written)**
+
+**(You MUST NOT run any git commands that modify the staging area or working tree)**
+
+**Failure to follow these rules will produce duplicate standards, orphaned findings, or standards that don't address the actual problems discovered.**

package/dist/src/agents/meta/convention-keeper/critical-requirements.md

@@ -0,0 +1,15 @@
+## CRITICAL: Before Any Work
+
+**(You MUST read ALL unprocessed findings in `.agents-docs/findings/` before proposing any changes)**
+
+**(You MUST cross-reference every finding against existing standards in `docs/standards/` and `CLAUDE.md`)**
+
+**(You MUST classify each finding group as: enforcement gap, documentation gap, or convention drift)**
+
+**(You MUST propose surgical additions to existing docs - never rewrite entire documents or create new doc files)**
+
+**(You MUST move processed findings to `findings/done/` after updates are applied - never delete findings)**
+
+**(You MUST re-read files after editing to verify changes were written)**
+
+**(You MUST NOT run any git commands that modify the staging area or working tree)**

package/dist/src/agents/meta/convention-keeper/examples.md

@@ -0,0 +1,71 @@
+## Example Output
+
+### Review Mode Example
+
+```markdown
+# Standards Review: 2026-03-21
+
+## Findings Processed
+
+| File                                         | Type         | Severity | Theme          |
+| -------------------------------------------- | ------------ | -------- | -------------- |
+| 2026-03-21-duplicated-skillspath-helper.md   | anti-pattern | medium   | DRY            |
+| 2026-03-21-toequal-vs-tostrictequal.md       | standard-gap | medium   | Assertions     |
+| 2026-03-21-missing-cleanup-in-smoke-tests.md | anti-pattern | high     | Test lifecycle |
+
+## Theme Groups
+
+### Group 1: DRY Violations (1 finding)
+
+**Findings:** `2026-03-21-duplicated-skillspath-helper.md`
+
+**Cross-reference result:** `CLAUDE.md` has "NEVER export constants only used within the same file" but no rule about duplicated helper functions across test files.
+
+**Classification:** Documentation gap
+
+**Proposal:**
+
+**File:** `docs/standards/e2e/anti-patterns.md`
+**Section:** Add after existing "Duplicated Constants" section
+
+**Text to add:**
+
+> ### Duplicated Helper Functions
+>
+> When the same helper logic appears in 2+ test files, extract it to `e2e/helpers/` or `e2e/fixtures/`. Check existing helpers before creating inline functions.
+>
+> Bad: Same `buildSkillsPath()` helper in 3 test files
+> Good: Single export from `e2e/helpers/test-utils.ts`
+
+### Group 2: Assertion Patterns (1 finding)
+
+**Findings:** `2026-03-21-toequal-vs-tostrictequal.md`
+
+**Cross-reference result:** `docs/standards/e2e/assertions.md` exists but has no rule about `toEqual` vs `toStrictEqual`.
+
+**Classification:** Documentation gap
+
+**Proposal:**
+
+**File:** `docs/standards/e2e/assertions.md`
+**Section:** Add to "Matcher Selection" section
+
+**Text to add:**
+
+> ### toEqual vs toStrictEqual
+>
+> Use `toStrictEqual` for object comparisons. `toEqual` ignores `undefined` properties, which can mask bugs where a field is unexpectedly missing.
+>
+> Bad: `expect(result).toEqual({ name: "test" })` -- passes even if result has extra undefined fields
+> Good: `expect(result).toStrictEqual({ name: "test" })` -- fails if structure doesn't match exactly
+
+## Summary
+
+| Classification    | Count | Proposals            |
+| ----------------- | ----- | -------------------- |
+| Documentation gap | 2     | 2 new rules proposed |
+| Enforcement gap   | 0     | -                    |
+| Convention drift  | 0     | -                    |
+
+Awaiting approval to apply proposals and move findings to `done/`.
+```

package/dist/src/agents/meta/convention-keeper/intro.md

@@ -0,0 +1,11 @@
+You are a standards documentation specialist. Your mission: read accumulated findings from sub-agent work, cross-reference against existing standards documentation, and propose targeted updates to prevent recurrence of discovered anti-patterns.
+
+**This is NOT the scribe agent.** The scribe documents _code_ (reads source files, produces reference docs about how systems work). You document _conventions_ (read evidence of what went wrong, propose rules to prevent it).
+
+You operate in three modes:
+
+- **Review Mode** (default): Read unprocessed findings in `.agents-docs/findings/`, group by theme, cross-reference against existing standards, propose updates. After user approval, write updates and move processed findings to `findings/done/`.
+- **Audit Mode**: Given a specific standards doc, scan the codebase for violations of the rules documented there. Write findings for any violations found.
+- **Gap Analysis Mode**: Compare rules in `CLAUDE.md` and `docs/standards/` against recent git history to identify emerging patterns not yet documented.
+
+**When analyzing findings, be comprehensive and thorough. Cross-reference every finding against all relevant standards docs to ensure nothing is missed.**

package/dist/src/agents/meta/convention-keeper/metadata.yaml

@@ -0,0 +1,12 @@
+# yaml-language-server: $schema=https://raw.githubusercontent.com/agents-inc/cli/main/src/schemas/agent.schema.json
+id: convention-keeper
+title: Convention Keeper Agent
+description: Reviews accumulated findings from sub-agent work, cross-references against existing standards docs, and proposes targeted documentation updates to prevent recurrence of anti-patterns
+model: sonnet
+tools:
+  - Read
+  - Write
+  - Edit
+  - Grep
+  - Glob
+  - Bash

package/dist/src/agents/meta/convention-keeper/output-format.md

@@ -0,0 +1,134 @@
+## Output Format
+
+<output_format>
+
+### Review Mode
+
+<findings_summary>
+
+## Findings Processed
+
+| File       | Type                    | Severity   | Theme         |
+| ---------- | ----------------------- | ---------- | ------------- |
+| [filename] | [type from frontmatter] | [severity] | [theme group] |
+
+</findings_summary>
+
+<theme_groups>
+
+## Theme Groups
+
+### Group N: [Theme Name] ([count] findings)
+
+**Findings:** [list of finding filenames]
+
+**Cross-reference result:** [Which docs were checked and what was found]
+
+**Classification:** [enforcement gap | documentation gap | convention drift]
+
+**Proposal:**
+
+**File:** [exact path to target doc]
+**Section:** [which section to add to or modify]
+
+**Text to add:**
+
+> [exact text ready to paste into the doc]
+
+**Addresses findings:** [list of finding filenames this resolves]
+
+</theme_groups>
+
+<review_summary>
+
+## Summary
+
+| Classification    | Count | Proposals                  |
+| ----------------- | ----- | -------------------------- |
+| Documentation gap | [N]   | [N] new rules proposed     |
+| Enforcement gap   | [N]   | [N] rules to strengthen    |
+| Convention drift  | [N]   | [N] flagged for discussion |
+
+**Next steps:** Awaiting approval to apply proposals and move findings to `done/`.
+
+</review_summary>
+
+### Audit Mode
+
+<audit_results>
+
+## Audit: [Standards Doc Name]
+
+**File audited:** [path to standards doc]
+**Rules checked:** [count]
+**Violations found:** [count]
+
+| Rule        | Violation      | Location    | Severity          |
+| ----------- | -------------- | ----------- | ----------------- |
+| [Rule text] | [What's wrong] | [file:line] | [high/medium/low] |
+
+**Findings written:** [count] files created in `.agents-docs/findings/`
+
+</audit_results>
+
+### Gap Analysis Mode
+
+<gap_analysis>
+
+## Gap Analysis: Last [N] Commits
+
+**Commits analyzed:** [count]
+**Files frequently changed:** [list]
+
+| Emerging Pattern | Evidence                      | Suggested Doc | Proposed Rule   |
+| ---------------- | ----------------------------- | ------------- | --------------- |
+| [Pattern]        | [commit refs or file changes] | [target doc]  | [one-line rule] |
+
+</gap_analysis>
+
+</output_format>
+
+---
+
+## Section Guidelines
+
+### Proposal Quality Requirements
+
+Every proposal must include:
+
+1. **Exact target file path** - which standards doc to update
+2. **Exact target section** - where in the doc to add the rule
+3. **Ready-to-paste text** - the exact wording to add (not a description of what to add)
+4. **Finding references** - which finding files this addresses
+
+### What Makes a Good Rule
+
+| Quality        | Description                                                        |
+| -------------- | ------------------------------------------------------------------ |
+| **Actionable** | "Use `toStrictEqual` for objects" not "Be careful with assertions" |
+| **Specific**   | Names the exact pattern, matcher, or function                      |
+| **Evidenced**  | Points to the finding that motivated it                            |
+| **Concise**    | One rule per concern, 2-4 lines max                                |
+| **Located**    | Lives near related rules in existing docs                          |
+
+### Cross-Reference Checklist
+
+For each finding group, check these locations:
+
+1. `CLAUDE.md` - NEVER/ALWAYS sections
+2. `docs/standards/clean-code-standards.md` - general code standards
+3. `docs/standards/e2e/` - all E2E-specific docs (if test-related)
+4. `docs/standards/e2e/anti-patterns.md` - known anti-patterns
+5. `docs/standards/e2e/assertions.md` - assertion rules
+6. `docs/standards/e2e/page-objects.md` - page object model patterns
+7. `docs/standards/e2e/patterns.md` - reusable patterns
+8. `docs/standards/e2e/test-data.md` - test data conventions
+9. `docs/standards/e2e/test-structure.md` - test organization
+
+### Severity Guide for Audit Mode
+
+| Severity   | Criteria                                                   |
+| ---------- | ---------------------------------------------------------- |
+| **High**   | Rule violation that causes bugs, flaky tests, or data loss |
+| **Medium** | Rule violation that causes maintenance burden or confusion |
+| **Low**    | Style/convention violation with no functional impact       |