cc-codeconductor 1.2.0 → 1.4.0

package/README.md

@@ -2,7 +2,7 @@
 
 **Stop prompting. Start orchestrating.**
 
-[![Socket Badge](https://badge.socket.dev/npm/package/cc-codeconductor/1.0.0)](https://badge.socket.dev/npm/package/cc-codeconductor/1.0.0)
+[![Socket Badge](https://badge.socket.dev/npm/package/cc-codeconductor/1.3.0)](https://badge.socket.dev/npm/package/cc-codeconductor/1.3.0)
 
 CodeConductor is an open-source framework for building structured, reproducible
 AI-assisted software engineering workflows.
@@ -15,11 +15,11 @@ contracts, task cards, and risk-based routing.
 >
 > ## Current Scope
 >
-> Published package is **1.0.0**. Limitations matrix:
+> Published package is **1.3.x (current stable: 1.3.0)**. Limitations matrix:
 > [docs/current-status.md](docs/current-status.md). This repository:
 > `bun run dev …` (not `npx`) while iterating.
 >
-> Shipped in 1.0.0:
+> Shipped in the 1.3.x stable line:
 >
 > - `npx cc-codeconductor init` — detects project stack, writes
 >   `.codeconductor/config.yml`, copies `council.yml` and `policy.yml` into
@@ -42,8 +42,8 @@ contracts, task cards, and risk-based routing.
 > - `npx cc-codeconductor scorecard …`
 > - `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`;
+>   [docs/v1.3.0-release-notes.md](docs/v1.3.0-release-notes.md))
+> - 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
@@ -96,10 +96,12 @@ This is not a prompt collection. It is a workflow framework.
 
 ---
 
-## What's new in v1.0.0
+## What's new in v1.3.0
 
-v1.0.0 is a **major** bump from v0.5.0 because the workflow contracts changed,
-not only because features were added. Re-install presets after upgrading.
+v1.3.0 is the current **stable** release in the 1.3.x line. It retains the
+v1.0.0 workflow contract baseline and adds cross-target preset fixes, centralized
+skill versioning, runner parity improvements, and the contextual web design
+engineering skill. Re-install presets after upgrading.
 
 ### Breaking changes vs v0.5.0
 
@@ -124,16 +126,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
 
@@ -158,7 +163,8 @@ review. Test-before-implement is required whenever both phases apply.
 - `complexity-auditor` — bloat and non-native abstractions; runs before
   `reviewer` on refactor, API change, and database migration routes
 
-New v1.0.0 agents: `business-agent`, `continuous-architect`, `impact-analyst`.
+The v1.0.0 contract baseline introduced `business-agent`,
+`continuous-architect`, and `impact-analyst`.
 
 ### Deterministic TypeScript validation (CCEP)
 
@@ -184,9 +190,9 @@ npx cc-codeconductor ccep taskcard --command feature --input @card.json
 
 ### Product OS
 
-Also in 1.0.0: `goal` / `ingest` / `product` / `orchestrate` / `impact` /
+The stable line includes `goal` / `ingest` / `product` / `orchestrate` / `impact` /
 `verify`, plus `.codeconductor/product-graph.json` and related artifacts.
-Details: [docs/v1.0.0-release-notes.md](docs/v1.0.0-release-notes.md) and
+Details: [docs/v1.3.0-release-notes.md](docs/v1.3.0-release-notes.md) and
 [docs/product-os.md](docs/product-os.md).
 
 ### Migrate from v0.5.0
@@ -229,7 +235,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 +243,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
@@ -271,14 +277,14 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
 
 ## Supply chain
 
-Published **1.0.0** declares two production dependencies (`package.json`
+Published **1.3.0** declares two production dependencies (`package.json`
 `dependencies`; same on
 [npm](https://www.npmjs.com/package/cc-codeconductor)). Neither has further
 npm transitive dependencies.
 
 ```mermaid
 graph LR
-  cc["cc-codeconductor@1.0.0"]
+  cc["cc-codeconductor@1.3.0"]
   zod["zod@^3.23.8"]
   yaml["yaml@^2.4.5"]
   cc --> zod
@@ -398,6 +404,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 +480,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 +530,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
@@ -612,7 +635,9 @@ npx cc-codeconductor openspec archive BC-001
 
 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
+(FR/SC → tasks → tests). Planned changes use capability-scoped delta specs;
+archive synchronizes validated deltas into durable specs before filing the
+change. Illegal status transitions fail closed. See
 [docs/SDD.md](docs/SDD.md) and the OpenSpec skill.
 
 #### Product OS — `ingest` / `product` / `orchestrate` / `impact` / `verify`
@@ -773,10 +798,10 @@ codeconductor/
 
 ## Roadmap
 
-Published package: **1.0.0**. Remaining gaps (sandbox, policy compiler, full
+Published package: **1.3.x (current stable: 1.3.0)**. Remaining gaps (sandbox, policy compiler, full
 stack-specific asset pruning): [docs/current-status.md](docs/current-status.md).
-Product OS surface:
-[docs/v1.0.0-release-notes.md](docs/v1.0.0-release-notes.md).
+Release details:
+[docs/v1.3.0-release-notes.md](docs/v1.3.0-release-notes.md).
 
 See [ROADMAP.md](ROADMAP.md) for historical notes.
 

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[];