everything-claude-code 1.4.3

package/docs/ecc.md

@@ -0,0 +1,117 @@
+# ECC CLI (Engineering Change Conveyor)
+
+ECC turns an "AI-assisted coding" request into a **replayable, auditable, verifiable** engineering workflow:
+
+`init -> doctor -> plan -> exec -> verify -> run`
+
+Core properties:
+- **Code sovereignty**: providers output only structured JSON + unified diff patches; ECC applies patches.
+- **Isolation**: `exec/verify` run in an **external git worktree**, so your main working tree is never polluted.
+- **Evidence chain**: all artifacts are written under `.ecc/runs/<runId>/`.
+
+---
+
+## Install
+
+### Option A: Run from source (this repo)
+
+```bash
+node scripts/ecc.js --help
+```
+
+## Rust Kernel (Optional, Low-Memory)
+
+ECC can offload the heavy "kernel" operations (worktree / patch apply / verify command runner)
+to a small Rust binary: `ecc-kernel`.
+
+### Prebuilt (no Rust required)
+
+When installed via npm, ECC runs a `postinstall` that tries to download a prebuilt `ecc-kernel`
+from the GitHub release matching your `package.json` version tag (`vX.Y.Z`).
+
+Controls:
+- `ECC_KERNEL_INSTALL=0` disables download
+- `ECC_KERNEL_INSTALL=required` fails install if download fails
+- `ECC_KERNEL_BASE_URL=...` overrides download base URL
+
+### Build From Source
+
+Build it (from repo root):
+
+```bash
+cargo build --release --manifest-path crates/ecc-kernel/Cargo.toml
+```
+
+Then rerun `ecc`; `ecc doctor` will report `kernel: rust (...)`.
+
+Environment:
+- `ECC_KERNEL=auto|rust|node` (default: `auto`)
+- `ECC_KERNEL_PATH=/absolute/path/to/ecc-kernel`
+
+### Option B: Install as a CLI (global)
+
+```bash
+# from a local checkout path
+npm install -g /path/to/everything-claude-code
+
+ecc --help
+```
+
+### Option C: Install into a project (recommended)
+
+```bash
+# from a local checkout path
+npm install -D /path/to/everything-claude-code
+
+npx ecc --help
+```
+
+---
+
+## Quickstart (Mock Provider)
+
+Use the deterministic mock provider to validate the pipeline without calling Codex:
+
+```bash
+ecc init
+
+ECC_PROVIDER=mock ECC_FIXTURE=basic ecc run "demo" --run-id demo
+```
+
+Artifacts:
+- `.ecc/ecc.json`
+- `.ecc/locks/registry.lock.json`
+- `.ecc/runs/demo/` (plan, patches, apply evidence, verify evidence, report)
+
+---
+
+## Quickstart (Codex Provider)
+
+Prereqs:
+- `codex` installed and on `PATH`
+- project is a git repo
+
+```bash
+ecc init
+ecc doctor
+
+ecc run "Add a hello endpoint" --run-id hello-endpoint
+```
+
+---
+
+## Commands
+
+```bash
+ecc packs
+ecc init [--backend codex|claude] [--packs a,b,c]
+ecc doctor
+ecc plan "<intent>" [--run-id <id>]
+ecc exec <runId> [--worktree-root <path>] [--keep-worktree] [--commit]
+ecc verify <runId> [--worktree-root <path>]
+ecc run "<intent>" [--run-id <id>] [--worktree-root <path>] [--keep-worktree] [--commit]
+```
+
+Notes:
+- `--commit` commits in the worktree **only after verify passes**.
+- If a patch touches files outside a task's `allowedPathPrefixes`, `exec` **fails fast**.

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "everything-claude-code",
+  "version": "1.4.3",
+  "description": "Everything Claude Code + ECC (Engineering Change Conveyor) CLI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sumulige/everything-claude-code.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sumulige/everything-claude-code/issues"
+  },
+  "homepage": "https://github.com/sumulige/everything-claude-code#readme",
+  "bin": {
+    "ecc": "./scripts/ecc.js"
+  },
+  "files": [
+    "scripts/ecc.js",
+    "scripts/ecc/*.js",
+    "scripts/ecc/providers/",
+    "scripts/ecc/fixtures/",
+    "scripts/lib/",
+    "crates/ecc-kernel/Cargo.toml",
+    "crates/ecc-kernel/Cargo.lock",
+    "crates/ecc-kernel/src/",
+    "packs/",
+    "schemas/",
+    "prompts/ecc/",
+    "docs/ecc.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "ecc:build-kernel": "cargo build --release --manifest-path crates/ecc-kernel/Cargo.toml",
+    "ecc:install-kernel": "node scripts/ecc/install-kernel.js",
+    "postinstall": "node scripts/ecc/install-kernel.js",
+    "test": "node tests/run-all.js"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "eslint": "^9.39.2",
+    "globals": "^17.1.0",
+    "markdownlint-cli": "^0.47.0"
+  }
+}

package/packs/blueprint.json

@@ -0,0 +1,8 @@
+{
+  "id": "blueprint",
+  "name": "Blueprint",
+  "description": "Turn vague intent into an executable plan: requirements, risk, interfaces, and an incremental path to shipping.",
+  "tags": ["planning", "architecture", "scope"],
+  "modules": ["command:plan", "command:multi-plan", "agent:planner", "agent:architect"]
+}
+

package/packs/forge.json

@@ -0,0 +1,16 @@
+{
+  "id": "forge",
+  "name": "Forge",
+  "description": "Ship with confidence: TDD-first workflows, coverage discipline, and fast iteration when builds break.",
+  "tags": ["tdd", "implementation", "reliability"],
+  "modules": [
+    "command:tdd",
+    "command:test-coverage",
+    "command:build-fix",
+    "command:multi-execute",
+    "agent:tdd-guide",
+    "agent:build-error-resolver",
+    "skill:tdd-workflow"
+  ]
+}
+

package/packs/instinct.json

@@ -0,0 +1,16 @@
+{
+  "id": "instinct",
+  "name": "Instinct",
+  "description": "Make your agent learn. Extract patterns from real sessions, score confidence, and evolve stable workflows over time.",
+  "tags": ["learning", "memory", "automation"],
+  "modules": [
+    "command:learn",
+    "command:instinct-status",
+    "command:instinct-import",
+    "command:instinct-export",
+    "command:evolve",
+    "skill:continuous-learning",
+    "skill:continuous-learning-v2"
+  ]
+}
+

package/packs/orchestra.json

@@ -0,0 +1,15 @@
+{
+  "id": "orchestra",
+  "name": "Orchestra",
+  "description": "Scale beyond a single agent: orchestrate multi-service work, keep state, and run parallel workflows without chaos.",
+  "tags": ["multi-agent", "orchestration", "systems"],
+  "modules": [
+    "command:orchestrate",
+    "command:pm2",
+    "command:multi-workflow",
+    "command:multi-backend",
+    "command:multi-frontend",
+    "command:multi-execute"
+  ]
+}
+

package/packs/proof.json

@@ -0,0 +1,8 @@
+{
+  "id": "proof",
+  "name": "Proof",
+  "description": "Verification loops that earn trust: checkpoints, build + test discipline, and eval-driven development patterns.",
+  "tags": ["verification", "quality", "evals"],
+  "modules": ["command:verify", "command:checkpoint", "command:eval", "skill:verification-loop", "skill:eval-harness"]
+}
+

package/packs/sentinel.json

@@ -0,0 +1,8 @@
+{
+  "id": "sentinel",
+  "name": "Sentinel",
+  "description": "Security and review as defaults: systematic threat checks, safer diffs, and an opinionated quality gate.",
+  "tags": ["security", "review", "risk"],
+  "modules": ["command:code-review", "agent:code-reviewer", "agent:security-reviewer", "skill:security-review"]
+}
+

package/prompts/ecc/patch.md

@@ -0,0 +1,25 @@
+# ECC Patch (JSON Only)
+
+You are generating a **unified diff patch** for a single ECC task.
+
+## Output Contract (MANDATORY)
+- Output **JSON only** with this shape:
+  - `patch` (string): a unified diff usable by `git apply`
+  - `meta` (object): extra notes
+    - Allowed keys only: `note`, `reason`, `provider`
+    - Include all 3 keys (use empty string if not applicable)
+
+## Hard Constraints
+- You MUST ONLY modify files within the provided `allowedPathPrefixes`.
+- If you cannot complete the task without touching other files, still obey ownership:
+  - put all necessary changes within allowed prefixes
+  - otherwise output an **empty patch** and explain in `meta` why
+- Patch must be minimal and production-grade (readable, consistent with existing patterns).
+
+## Input (from caller)
+You will be given:
+- Task (id, title, prompt)
+- allowedPathPrefixes
+- Project context (light)
+
+## Return JSON

package/prompts/ecc/plan.md

@@ -0,0 +1,28 @@
+# ECC Plan (JSON Only)
+
+You are generating an ECC plan for an engineering task.
+
+## Output Contract (MANDATORY)
+- Output **JSON only**.
+- The JSON must match the `schemas/ecc.plan.schema.json` contract:
+  - `version` must be `1`
+  - `intent` is the user's intent string
+  - `tasks[]` is a list of patch tasks that can be executed sequentially
+
+## Planning Rules
+- Keep tasks **small and file-disjoint**. Assume tasks run sequentially in P0, but avoid overlapping file ownership anyway.
+- Each task must include `allowedPathPrefixes` (non-empty) so the executor can block unauthorized edits.
+- Prefer **3-6 tasks** for typical features:
+  - one for core implementation
+  - one for tests
+  - optional: one for wiring/config
+- `prompt` must be sufficient for a patch generator to act without extra coordination.
+
+## Input (from caller)
+You will be given:
+- Project root
+- Selected packs (paradigms)
+- User intent
+
+## Return JSON
+

package/schemas/ecc.apply.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ECC Apply Result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "appliedAt", "baseSha", "tasks"],
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "appliedAt": { "type": "string", "minLength": 1 },
+    "baseSha": { "type": "string", "minLength": 1 },
+    "tasks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "patchPath", "ok"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "patchPath": { "type": "string", "minLength": 1 },
+          "ok": { "type": "boolean" },
+          "error": { "type": "string" }
+        }
+      }
+    },
+    "commit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sha", "message"],
+      "properties": {
+        "sha": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/schemas/ecc.config.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ECC Project Config",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "backend", "packs", "verify", "createdAt"],
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "backend": { "type": "string", "enum": ["codex", "claude"] },
+    "packs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "verify": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode"],
+      "properties": {
+        "mode": { "type": "string", "enum": ["auto", "manual"] },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "command"],
+            "properties": {
+              "name": { "type": "string", "minLength": 1 },
+              "command": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    },
+    "createdAt": { "type": "string", "minLength": 1 }
+  }
+}

package/schemas/ecc.lock.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ECC Registry Lock",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "lockedAt", "engine", "catalog", "packs"],
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "lockedAt": { "type": "string", "minLength": 1 },
+    "engine": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name"],
+      "properties": {
+        "name": { "type": "string", "const": "ecc" },
+        "version": { "type": "string" }
+      }
+    },
+    "catalog": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "digest"],
+      "properties": {
+        "type": { "type": "string", "const": "embedded" },
+        "digest": { "type": "string", "minLength": 1 }
+      }
+    },
+    "packs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    }
+  }
+}

package/schemas/ecc.patch.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "ecc.patch.schema.json",
+  "title": "ECC Patch Output (P0)",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["patch", "meta"],
+  "properties": {
+    "patch": {
+      "type": "string",
+      "description": "Unified diff (git apply compatible). May be empty when task cannot be completed within allowedPathPrefixes."
+    },
+    "meta": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Structured notes.",
+      "required": ["note", "reason", "provider"],
+      "properties": {
+        "note": { "type": "string" },
+        "reason": { "type": "string" },
+        "provider": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/ecc.plan.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ECC Plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "intent", "tasks"],
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "intent": { "type": "string", "minLength": 1 },
+    "tasks": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "kind", "dependsOn", "allowedPathPrefixes", "prompt"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1 },
+          "title": { "type": "string", "minLength": 1 },
+          "kind": { "type": "string", "const": "patch" },
+          "dependsOn": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+          "allowedPathPrefixes": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "type": "string", "minLength": 1 }
+          },
+          "prompt": { "type": "string", "minLength": 1 }
+        }
+      }
+    }
+  }
+}

package/schemas/ecc.run.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ECC Run",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "runId",
+    "intent",
+    "backend",
+    "packs",
+    "status",
+    "base",
+    "worktree",
+    "artifacts",
+    "startedAt"
+  ],
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "runId": { "type": "string", "minLength": 1 },
+    "intent": { "type": "string", "minLength": 1 },
+    "backend": { "type": "string", "enum": ["codex", "claude"] },
+    "packs": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "status": {
+      "type": "string",
+      "enum": ["planned", "executing", "verifying", "succeeded", "failed"]
+    },
+    "base": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["repoRoot", "branch", "sha"],
+      "properties": {
+        "repoRoot": { "type": "string", "minLength": 1 },
+        "branch": { "type": "string" },
+        "sha": { "type": "string" }
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "branch"],
+      "properties": {
+        "path": { "type": "string" },
+        "branch": { "type": "string" }
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["planJson", "planMd", "patchesDir", "applyJson", "verifyDir", "reportMd"],
+      "properties": {
+        "planJson": { "type": "string", "minLength": 1 },
+        "planMd": { "type": "string", "minLength": 1 },
+        "patchesDir": { "type": "string", "minLength": 1 },
+        "applyJson": { "type": "string", "minLength": 1 },
+        "verifyDir": { "type": "string", "minLength": 1 },
+        "reportMd": { "type": "string", "minLength": 1 }
+      }
+    },
+    "startedAt": { "type": "string", "minLength": 1 },
+    "endedAt": { "type": "string" }
+  }
+}

package/schemas/ecc.verify.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ECC Verify Summary",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "ranAt", "commands", "ok"],
+  "properties": {
+    "version": { "type": "integer", "const": 1 },
+    "ranAt": { "type": "string", "minLength": 1 },
+    "commands": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["name", "command", "ok", "exitCode", "outputPath"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "command": { "type": "string", "minLength": 1 },
+          "ok": { "type": "boolean" },
+          "exitCode": { "type": "integer" },
+          "outputPath": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "ok": { "type": "boolean" }
+  }
+}

package/schemas/hooks.schema.json

@@ -0,0 +1,81 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Claude Code Hooks Configuration",
+  "description": "Configuration for Claude Code hooks. Event types are validated at runtime and must be one of: PreToolUse, PostToolUse, PreCompact, SessionStart, SessionEnd, Stop, Notification, SubagentStop",
+  "$defs": {
+    "hookItem": {
+      "type": "object",
+      "required": [
+        "type",
+        "command"
+      ],
+      "properties": {
+        "type": {
+          "type": "string"
+        },
+        "command": {
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ]
+        }
+      }
+    },
+    "matcherEntry": {
+      "type": "object",
+      "required": [
+        "matcher",
+        "hooks"
+      ],
+      "properties": {
+        "matcher": {
+          "type": "string"
+        },
+        "hooks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/hookItem"
+          }
+        },
+        "description": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "oneOf": [
+    {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string"
+        },
+        "hooks": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/matcherEntry"
+            }
+          }
+        }
+      },
+      "required": [
+        "hooks"
+      ]
+    },
+    {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/matcherEntry"
+      }
+    }
+  ]
+}

package/schemas/package-manager.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Package Manager Configuration",
+  "type": "object",
+  "properties": {
+    "packageManager": {
+      "type": "string",
+      "enum": [
+        "npm",
+        "pnpm",
+        "yarn",
+        "bun"
+      ]
+    }
+  },
+  "additionalProperties": false
+}