cc-codeconductor 0.3.2 → 0.4.0

package/README.md

@@ -18,9 +18,9 @@ contracts, task cards, and risk-based routing.
 > - `npx cc-codeconductor init` — detects project stack, writes
 >   `.codeconductor/config.yml`, copies `council.yml` and `policy.yml` into
 >   `.codeconductor/presets/`
-> - `npx cc-codeconductor install council --target <opencode|claude|codex|all>` —
+> - `npx cc-codeconductor install council --target <opencode|claude|codex|agy|all>` —
 >   generates and writes preset files; supports `--global` to install to
->   `~/.opencode/`, `~/.claude/`, `~/.codex/`
+>   `~/.opencode/`, `~/.claude/`, `~/.codex/`, `~/.agents/`
 > - `npx cc-codeconductor install lsp --target <opencode|claude|codex|gemini|cursor|agy|all>` —
 >   installs LSP servers and configures AI coding tools; auto-detects project
 >   languages or use `--lang` to override
@@ -36,12 +36,16 @@ contracts, task cards, and risk-based routing.
 >   a sitemap.xml with rate limiting and SSRF prevention
 > - `npx cc-codeconductor seo llms --sitemap <url>` — generates a `llms.txt` file
 >   for AI-search readiness from sitemap content
+> - `npx cc-codeconductor help` (alias: `cc-help`) — shows preset inventory
+>   (skills, subagents, commands) for the active or specified target
+> - `npx cc-codeconductor debt-harvest` (alias: `harvest`) — scans source files
+>   for `// defer` comments and writes `.codeconductor/debt-ledger.md`
 > - `/cc-pagespeed --url <url>` — audits web performance using the PageSpeed
 >   Insights API; applies the 80/20 principle to produce a prioritized report of
 >   Core Web Vitals (LCP, TBT, CLS, FCP, TTFB) with framework-specific fixes;
 >   requires `PAGESPEED_API_KEY` env var for full CrUX field data (optional but
 >   recommended)
-> - `npx cc-codeconductor install preset --target <opencode|claude|codex|all>` —
+> - `npx cc-codeconductor install preset --target <opencode|claude|codex|agy|all>` —
 >   installs the full preset (agents, prompts, skills, commands, settings) for the
 >   chosen runner; use `--locale=es` to inject Spanish-aware instructions into
 >   agent files, or rely on the locale saved during `init`
@@ -123,12 +127,14 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
 - Codex preset
 - Spring Boot / Kotlin workflow
 - Python / Django workflow guidance
-- 8 core Conductor Agents
-- Routing Policy v0.1.0
+- 10 core Conductor Agents
+- Routing Policy v0.2.0
 - Task Card template
 - Scorecard template
 - End-to-end example
 - YAML-driven model configuration
+- Provider-agnostic `AgentContract` abstraction with target renderers for Claude, OpenCode, Codex, and Agy
+- Council consensus engine (`councilConsensus()`) for multi-agent governance with majority/unanimous algorithms and security veto
 
 ---
 
@@ -189,6 +195,7 @@ Detected:
 npx cc-codeconductor install preset --target opencode     # project-level
 npx cc-codeconductor install preset --target claude
 npx cc-codeconductor install preset --target codex
+npx cc-codeconductor install preset --target agy          # antigravity cli
 npx cc-codeconductor install preset --target all          # all targets
 
 npx cc-codeconductor install preset --target claude --global   # write to ~/.claude/
@@ -221,7 +228,8 @@ With `--global`, files are written under `~/` instead of `./`.
 npx cc-codeconductor install council --target opencode     # project-level
 npx cc-codeconductor install council --target claude
 npx cc-codeconductor install council --target codex
-npx cc-codeconductor install council --target all          # all three targets
+npx cc-codeconductor install council --target agy          # antigravity cli
+npx cc-codeconductor install council --target all          # all targets
 
 npx cc-codeconductor install council --target claude --global  # write to ~/.claude/
 npx cc-codeconductor install council --target opencode --global
@@ -264,6 +272,34 @@ npx cc-codeconductor update --global
 
 Smart updates all currently installed target presets, council configurations, and skills (from `skills-lock.json`), preserving user edits outside managed blocks. Also validates that `AGENTS.md` and `CLAUDE.md` do not exceed the 40KB size limit.
 
+#### `help` — show preset inventory
+
+```bash
+npx cc-codeconductor help                    # show inventory for active target
+npx cc-codeconductor help --target claude    # show inventory for specific target
+npx cc-codeconductor cc-help                 # alias
+npx cc-codeconductor help --output json      # machine-readable output
+```
+
+Lists the skills, subagents, commands, and workflows available in the active
+preset. Reads from `presets/<target>/` in the project root.
+
+#### `debt-harvest` — collect deferred debt items
+
+```bash
+npx cc-codeconductor debt-harvest            # scan src/ for // defer comments
+npx cc-codeconductor debt-harvest --dir lib  # scan a different directory
+npx cc-codeconductor harvest                 # alias
+npx cc-codeconductor debt-harvest --output json
+```
+
+Scans source files for `// defer - [reason]` comments and consolidates them
+into `.codeconductor/debt-ledger.md`, grouped by optional tag
+(`// defer - reason --tag`). Read-only on source files; only writes the ledger.
+
+Supported extensions: `.ts`, `.tsx`, `.js`, `.jsx`, `.go`, `.rs`, `.java`,
+`.kt`, `.swift`, `.cs`, `.php`, `.scala`, `.dart`, `.c`, `.cpp`, `.h`, `.hpp`.
+
 
 ### Global options