cc-codeconductor 1.1.0 → 1.3.0

package/README.md

@@ -43,7 +43,7 @@ contracts, task cards, and risk-based routing.
 > - `npx cc-codeconductor goal` / `ingest` / `product` / `orchestrate` /
 >   `impact` / `verify` — Product OS (see
 >   [docs/v1.0.0-release-notes.md](docs/v1.0.0-release-notes.md))
-> - Slash commands after `install preset` — 20 CCEP workflows plus `/cc-ask`;
+> - Slash commands after `install preset` — 21 CCEP workflows plus `/cc-ask`;
 >   prefer `/cc-iterative`, `/cc-triage`, `/cc-handoff` for wayfinding;
 >   `/cc-backlog` authors `BACKLOG.md`; `/cc-openspec` and `/cc-tdd-cycle`
 >   for delivery and TDD
@@ -124,16 +124,19 @@ not only because features were added. Re-install presets after upgrading.
 
 ### Slash commands
 
-After `install preset`, 18 CCEP workflows plus `/cc-ask`:
+After `install preset`, 21 CCEP workflows plus `/cc-ask` (22 total), tiered by
+what they do rather than which subsystem they touch:
 
-| Group          | Commands                                                                                                                     |
-| -------------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| Delivery       | `/cc-feature`, `/cc-fix`, `/cc-refactor`, `/cc-api-contract`, `/cc-db-migration`                                             |
-| Quality        | `/cc-tdd-cycle`, `/cc-test-plan`, `/cc-review`, `/cc-council`, `/cc-scorecard`                                               |
-| OpenSpec / ops | `/cc-openspec`, `/cc-iterative`, `/cc-triage`, `/cc-explore`, `/cc-prototype`, `/cc-handoff`, `/cc-clarify`, `/cc-pagespeed` |
-| Entry          | `/cc-ask` — CLI `ask` recommends a slash command; it does not start the workflow                                             |
+| Tier          | Commands                                                                                                    | Purpose                                        |
+| ------------- | ------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| Entry         | `/cc-ask`, `/cc-triage`, `/cc-explore`                                                                          | Recommend a next command and stop — no writes.  |
+| Delivery      | `/cc-feature`, `/cc-fix`, `/cc-refactor`, `/cc-tdd-cycle`, `/cc-api-contract`, `/cc-db-migration`, `/cc-spec-mutation` | Implement, test-before-implement where both apply. |
+| Verification  | `/cc-review`, `/cc-council`, `/cc-scorecard`, `/cc-test-plan`, `/cc-security`                                    | Gate a diff or a decision before merge.         |
+| Management    | `/cc-backlog`, `/cc-openspec`, `/cc-handoff`, `/cc-clarify`, `/cc-prototype`, `/cc-pagespeed`, `/cc-iterative`   | Author BACKLOG.md, deliver it, or one-off ops.  |
 
 Prefer `/cc-iterative`, `/cc-triage`, and `/cc-handoff` for wayfinding.
+`/cc-ask` recommends a command from a natural-language problem; it does not
+start the workflow.
 
 ### OpenSpec and TDD
 
@@ -229,7 +232,7 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
 
 ## Current Support
 
-- OpenCode, Claude, Codex, Gemini, Cursor, and Agy presets
+- OpenCode, Claude, Codex, Gemini, Cursor, Agy, and Pi presets
 - Claude Code-compatible preset (see
   [Claude Environment Options & Best Practices](docs/claude-env-options.md))
 - Spring Boot / Kotlin workflow
@@ -237,7 +240,7 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
 - **15 Conductor Agents** — including `reviewer`, `security-reviewer`,
   `complexity-auditor`, `business-agent`, `continuous-architect`, and
   `impact-analyst`
-- 18 CCEP slash-command workflows plus `/cc-ask` after `install preset`
+- 21 CCEP slash-command workflows plus `/cc-ask` after `install preset`
 - OpenSpec delivery loop (`validate` … `archive`) with test-before-implement
 - Deterministic CCEP validation (Zod schemas per agent role)
 - Task Card template
@@ -398,6 +401,7 @@ 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 pi            # pi.dev coding agent
 npx cc-codeconductor install preset --target all          # all targets
 
 npx cc-codeconductor install preset --target claude --global   # write to ~/.claude/
@@ -473,6 +477,7 @@ 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 agy          # antigravity cli
+npx cc-codeconductor install council --target pi            # pi.dev coding agent
 npx cc-codeconductor install council --target all          # all targets
 
 npx cc-codeconductor install council --target claude --global  # write to ~/.claude/
@@ -522,6 +527,21 @@ 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.
 
+#### `migrate` — repair a Claude Code settings.json
+
+```bash
+npx cc-codeconductor migrate               # ./.claude/settings.json
+npx cc-codeconductor migrate --global      # ~/.claude/settings.json
+npx cc-codeconductor migrate --dry-run     # preview without writing
+npx cc-codeconductor migrate --file .claude/settings.local.json
+```
+
+Rewrites every `Write(path)` permission rule to `Edit(path)` — Claude Code
+only applies file-scoped rules written the second way, so a `Write(path)`
+rule silently never matches — and dedupes the result. A reinstall can't
+remove a bad rule already on disk (permission arrays merge by union), so this
+is a standalone repair pass, not something `update` fixes on its own.
+
 #### `help` / `cc-help` — distinct help contracts
 
 ```bash
@@ -601,6 +621,7 @@ Zod schema for that role. `consensus` exit codes: `0` APPROVED, `1` REJECTED,
 npx cc-codeconductor openspec validate
 npx cc-codeconductor openspec scan
 npx cc-codeconductor openspec plan BC-001
+npx cc-codeconductor openspec analyze --output json
 npx cc-codeconductor openspec status
 npx cc-codeconductor openspec next
 npx cc-codeconductor openspec start BC-001-discover
@@ -609,8 +630,9 @@ npx cc-codeconductor openspec block BC-001-implement --reason "waiting on design
 npx cc-codeconductor openspec archive BC-001
 ```
 
-Subcommands: `validate` / `scan` / `plan` / `status` / `next` / `start` / `done`
-/ `block` / `archive`. Illegal status transitions fail closed. See
+Subcommands: `validate` / `scan` / `plan` / `analyze` / `status` / `next` /
+`start` / `done` / `block` / `archive`. `analyze` is read-only coverage
+(FR/SC → tasks → tests). Illegal status transitions fail closed. See
 [docs/SDD.md](docs/SDD.md) and the OpenSpec skill.
 
 #### Product OS — `ingest` / `product` / `orchestrate` / `impact` / `verify`

package/dist/core/config/codeconductor-config.d.ts

@@ -1,3 +1,4 @@
+import type { IndividualRunnerTarget } from '../runner/runner-target';
 /**
  * CodeConductor configuration interface
  */
@@ -8,7 +9,7 @@ export interface CodeConductorConfig {
         profile?: string;
     };
     defaults: {
-        target: 'opencode' | 'claude' | 'codex' | 'gemini' | 'cursor' | 'agy';
+        target: IndividualRunnerTarget;
         overwrite: boolean;
         locale: 'en' | 'es';
     };

package/dist/core/presets/package-paths.d.ts

@@ -2,3 +2,4 @@ export declare const PACKAGE_ROOT: string;
 export declare const SRC_PRESETS_DIR: string;
 export declare const ROOT_PRESETS_DIR: string;
 export declare const POLICY_PATH: string;
+export declare const SKILLS_REGISTRY_PATH: string;

package/dist/core/runner/runner-target.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Runner target type
+ */
+export type RunnerTarget = 'opencode' | 'claude' | 'codex' | 'gemini' | 'cursor' | 'agy' | 'pi' | 'all';
+/**
+ * Valid runner targets
+ */
+export declare const RUNNER_TARGETS: readonly ["opencode", "claude", "codex", "gemini", "cursor", "agy", "pi", "all"];
+/**
+ * Individual runner targets (excluding 'all')
+ */
+export declare const INDIVIDUAL_TARGETS: readonly ["opencode", "claude", "codex", "gemini", "cursor", "agy", "pi"];
+/**
+ * A single, installable runner target — every RunnerTarget value except
+ * 'all'. The single source for the union type repeated inline across
+ * loaders/commands (manifest-loader.ts, install.command.ts, ...) — import
+ * this instead of re-listing the 7 targets, so adding an 8th only requires
+ * updating INDIVIDUAL_TARGETS above.
+ */
+export type IndividualRunnerTarget = (typeof INDIVIDUAL_TARGETS)[number];
+/**
+ * Check if a string is a valid runner target
+ */
+export declare function isRunnerTarget(value: string): value is RunnerTarget;
+/**
+ * Parse runner target from string
+ */
+export declare function parseRunnerTarget(value: string): RunnerTarget;
+/**
+ * Get individual targets from 'all' or single target
+ */
+export declare function getIndividualTargets(target: RunnerTarget): RunnerTarget[];

package/dist/core/verification/verification-runner.d.ts

@@ -37,6 +37,8 @@ export declare function runVerification(projectRoot: string, taskId: string, goa
  * unreadable evidence all block completion.
  */
 export declare function gateTaskCompletion(projectRoot: string, taskId: string, evidenceRequired: string[], evidenceIds?: string[]): Promise<Result<boolean, Error>>;
+export declare const TDD_EVIDENCE_SOURCE = "cc verify";
+export declare const TDD_CAPTURED_BY = "verification-runner";
 export interface CaptureTddSuiteOptions extends RunVerificationOptions {
     /** Allowlisted test command (`bun test`, `npm test`, …). */
     readonly command: string;
@@ -55,3 +57,8 @@ export declare function captureTddSuiteEvidence(projectRoot: string, taskId: str
  * files (wrong source/type/`capturedBy`) are rejected.
  */
 export declare function loadTddSuiteEvidence(projectRoot: string, taskId: string, evidenceId: string): Promise<Result<TddSuiteEvidence, Error>>;
+/**
+ * True when the verification runner stored TDD evidence for this task.
+ * Handmade JSON (wrong source/type/capturedBy) does not count.
+ */
+export declare function hasTddRunnerEvidence(projectRoot: string, taskId: string): Promise<boolean>;

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { getReadyTasks, goalTaskToCanonicalCard, buildTaskEnvelope, getNextTask,
 export type { OrchestratorNextResult } from './core/orchestrator/runtime-orchestrator';
 export { LoopEngine, runLoop, runLoopForProject, shouldRunAgentLoop, formatFeedback, advanceTddPhase, } from './core/loop/loop-engine';
 export type { LoopConfig, LoopResult, EscalationReport, GuardrailHit, GenerateFn, CompileCheckFn, } from './core/loop/loop-engine';
-export { runVerification, gateTaskCompletion, validateEvidenceIds, captureTddSuiteEvidence, loadTddSuiteEvidence, } from './core/verification/verification-runner';
+export { runVerification, gateTaskCompletion, validateEvidenceIds, captureTddSuiteEvidence, loadTddSuiteEvidence, hasTddRunnerEvidence, } from './core/verification/verification-runner';
 export type { RunVerificationOptions, VerificationCheck, CaptureTddSuiteOptions, } from './core/verification/verification-runner';
 export * from './validation/schemas';
 export { createInitialState, loopStateMachine, createInitialTddState, tddCycleStateMachine, } from './domain/loop/loop-state';