@punks/cli 1.0.6 → 1.0.7

package/dist/data/catalog/hooks.ts

@@ -15,12 +15,4 @@ export const hookCatalog = [
       "Shared hook that auto-formats edited JS/TS/JSON files and lint-checks product files after tool use.",
     sourcePath: "hooks/format-edited-file.mjs",
   },
-  {
-    id: "require-tests-for-pr",
-    harness: "shared",
-    outputPath: ".agents/hooks/require-tests-for-pr.mjs",
-    description:
-      "Shared hook that blocks PR creation while tests are failing.",
-    sourcePath: "hooks/require-tests-for-pr.mjs",
-  },
 ] as const satisfies ReadonlyArray<HookDefinition>;

package/dist/data/catalog/packs.ts

@@ -2,7 +2,7 @@ import type { PackCategory, PackId } from "../../core/models";
 import type { LintAssetId } from "./lint";
 import type { SkillId } from "./skills";
 
-export type PackHookId = "format-edited-file" | "require-tests-for-pr";
+export type PackHookId = "format-edited-file";
 export type PackPromptSurfaceId =
   | "shared-agents"
   | "root-prompt-spec"
@@ -42,5 +42,5 @@ export const packCatalog = [
   { id: "trpc", category: "detected", triggerPackages: ["@trpc/"], description: "tRPC guidance pack.", skills: [], lintAssets: [], hooks: [], promptSurfaces: ["shared-agents", "root-prompt-spec", "workspace-prompt-spec"], promptDetails: ["shared contract-first baseline", "workspace client/server boundaries"] },
   { id: "turborepo", category: "detected", triggerPackages: ["turbo"], description: "Turborepo guidance pack.", skills: ["turborepo"], lintAssets: [], hooks: [], promptSurfaces: ["shared-agents", "root-prompt-spec", "workspace-prompt-spec"], promptDetails: ["shared monorepo baseline", "workspace task boundary rules"] },
   { id: "python", category: "language", triggerPackages: [], description: "Shared Python language pack for async, style, structure, testing, and design guidance.", skills: ["async-python-patterns", "python-code-style", "python-design-patterns", "python-project-structure", "python-testing-patterns"], lintAssets: [], hooks: [], promptSurfaces: [], promptDetails: [] },
-  { id: "typescript", category: "language", triggerPackages: ["typescript"], description: "Shared JavaScript / TypeScript language pack for hook and language-level scaffold assets.", skills: ["quality-types"], lintAssets: [], hooks: ["format-edited-file", "require-tests-for-pr"], promptSurfaces: [], promptDetails: [] },
+  { id: "typescript", category: "language", triggerPackages: ["typescript"], description: "Shared JavaScript / TypeScript language pack for hook and language-level scaffold assets.", skills: ["quality-types"], lintAssets: [], hooks: ["format-edited-file"], promptSurfaces: [], promptDetails: [] },
 ] as const satisfies ReadonlyArray<PackCatalogEntry>;

package/dist/data/hooks.test.ts

@@ -31,35 +31,6 @@ const tempRepo = (files: Record<string, string>) => {
 };
 
 describe("scaffolded hooks", () => {
-  it("runs the PR test gate with the repo package manager", async () => {
-    const { testHooks } = await loadHookModule("require-tests-for-pr.mjs");
-
-    expect(
-      testHooks.testCommand?.(
-        tempRepo({
-          "package.json": JSON.stringify({ packageManager: "bun@1.3.5" }),
-        }),
-      ),
-    ).toEqual(["bun", "run", "test"]);
-
-    expect(
-      testHooks.testCommand?.(
-        tempRepo({
-          "package.json": JSON.stringify({ packageManager: "pnpm@10.0.0" }),
-        }),
-      ),
-    ).toEqual(["pnpm", "--silent", "test"]);
-
-    expect(
-      testHooks.testCommand?.(
-        tempRepo({
-          "package.json": "{}",
-          "package-lock.json": "",
-        }),
-      ),
-    ).toEqual(["npm", "--silent", "test"]);
-  });
-
   it("executes formatter tools with the repo package manager", async () => {
     const { testHooks } = await loadHookModule("format-edited-file.mjs");
 

package/dist/data/scripts/sync-subagents.mjs

@@ -52,7 +52,7 @@ const cursorManagedComment =
 const opencodeManagedComment =
   "<!-- Generated by scripts/sync-subagents.mjs. Edit .agents/subagents/manifest.mjs instead. -->";
 
-function buildCodexAgentConfig({ hasFormatHook, hasTestHook }) {
+function buildCodexAgentConfig({ hasFormatHook }) {
   const lines = [
     "[agents]",
     "max_threads = 6",
@@ -74,16 +74,6 @@ function buildCodexAgentConfig({ hasFormatHook, hasTestHook }) {
     );
   }
 
-  if (hasTestHook) {
-    lines.push(
-      "PreToolUse = [",
-      '  { matcher = "Bash|.*[Pp]ull.?[Rr]equest.*|.*[Pp][Rr].?[Cc]reate.*|.*create[_-]?pull[_-]?request.*", hooks = [',
-      '    { type = "command", command = "node \\"$(git rev-parse --show-toplevel)/.codex/hooks/require-tests-for-pr.mjs\\" codex", statusMessage = "Checking tests before PR creation", timeout = 600 },',
-      "  ] },",
-      "]",
-    );
-  }
-
   if (hasFormatHook) {
     lines.push(
       "PostToolUse = [",
@@ -98,35 +88,9 @@ function buildCodexAgentConfig({ hasFormatHook, hasTestHook }) {
   return lines.join("\n");
 }
 
-function buildClaudeSettingsConfig({ hasFormatHook, hasTestHook }) {
+function buildClaudeSettingsConfig({ hasFormatHook }) {
   return {
     hooks: {
-      ...(hasTestHook
-        ? {
-            PreToolUse: [
-              {
-                matcher: "mcp__github__create_pull_request",
-                hooks: [
-                  {
-                    type: "command",
-                    command: 'node "$CLAUDE_PROJECT_DIR"/.claude/hooks/require-tests-for-pr.mjs claude',
-                    timeout: 600,
-                  },
-                ],
-              },
-              {
-                matcher: "Bash",
-                hooks: [
-                  {
-                    type: "command",
-                    command: 'node "$CLAUDE_PROJECT_DIR"/.claude/hooks/require-tests-for-pr.mjs claude',
-                    timeout: 600,
-                  },
-                ],
-              },
-            ],
-          }
-        : {}),
       ...(hasFormatHook
         ? {
             PostToolUse: [
@@ -147,24 +111,10 @@ function buildClaudeSettingsConfig({ hasFormatHook, hasTestHook }) {
   };
 }
 
-function buildCursorHooksConfig({ hasFormatHook, hasTestHook }) {
+function buildCursorHooksConfig({ hasFormatHook }) {
   return {
     version: 1,
     hooks: {
-      ...(hasTestHook
-        ? {
-            beforeMCPExecution: [
-              {
-                command: "node .cursor/hooks/require-tests-for-pr.mjs cursor",
-              },
-            ],
-            beforeShellExecution: [
-              {
-                command: "node .cursor/hooks/require-tests-for-pr.mjs cursor",
-              },
-            ],
-          }
-        : {}),
       ...(hasFormatHook
         ? {
             afterFileEdit: [
@@ -391,7 +341,7 @@ async function syncHookSurface() {
   await mkdir(cursorHooksDir, { recursive: true });
   await mkdir(opencodePluginsDir, { recursive: true });
 
-  for (const hookName of ["format-edited-file.mjs", "require-tests-for-pr.mjs"]) {
+  for (const hookName of ["format-edited-file.mjs"]) {
     const sourcePath = path.join(sharedHooksPath, hookName);
     const targetPaths = [
       path.join(codexHooksDir, hookName),
@@ -445,7 +395,6 @@ async function main() {
   await mkdir(path.dirname(cursorHooksJsonPath), { recursive: true });
   const availableHooks = {
     hasFormatHook: await pathExists(path.join(sharedHooksPath, "format-edited-file.mjs")),
-    hasTestHook: await pathExists(path.join(sharedHooksPath, "require-tests-for-pr.mjs")),
   };
   await writeFile(codexConfigPath, buildCodexAgentConfig(availableHooks), "utf8");
   await rm(path.join(codexDir, "hooks.json"), { force: true });

package/dist/index.js

@@ -41910,13 +41910,6 @@ var hookCatalog = [
     outputPath: ".agents/hooks/format-edited-file.mjs",
     description: "Shared hook that auto-formats edited JS/TS/JSON files and lint-checks product files after tool use.",
     sourcePath: "hooks/format-edited-file.mjs"
-  },
-  {
-    id: "require-tests-for-pr",
-    harness: "shared",
-    outputPath: ".agents/hooks/require-tests-for-pr.mjs",
-    description: "Shared hook that blocks PR creation while tests are failing.",
-    sourcePath: "hooks/require-tests-for-pr.mjs"
   }
 ];
 
@@ -42215,7 +42208,7 @@ var packCatalog = [
   { id: "trpc", category: "detected", triggerPackages: ["@trpc/"], description: "tRPC guidance pack.", skills: [], lintAssets: [], hooks: [], promptSurfaces: ["shared-agents", "root-prompt-spec", "workspace-prompt-spec"], promptDetails: ["shared contract-first baseline", "workspace client/server boundaries"] },
   { id: "turborepo", category: "detected", triggerPackages: ["turbo"], description: "Turborepo guidance pack.", skills: ["turborepo"], lintAssets: [], hooks: [], promptSurfaces: ["shared-agents", "root-prompt-spec", "workspace-prompt-spec"], promptDetails: ["shared monorepo baseline", "workspace task boundary rules"] },
   { id: "python", category: "language", triggerPackages: [], description: "Shared Python language pack for async, style, structure, testing, and design guidance.", skills: ["async-python-patterns", "python-code-style", "python-design-patterns", "python-project-structure", "python-testing-patterns"], lintAssets: [], hooks: [], promptSurfaces: [], promptDetails: [] },
-  { id: "typescript", category: "language", triggerPackages: ["typescript"], description: "Shared JavaScript / TypeScript language pack for hook and language-level scaffold assets.", skills: ["quality-types"], lintAssets: [], hooks: ["format-edited-file", "require-tests-for-pr"], promptSurfaces: [], promptDetails: [] }
+  { id: "typescript", category: "language", triggerPackages: ["typescript"], description: "Shared JavaScript / TypeScript language pack for hook and language-level scaffold assets.", skills: ["quality-types"], lintAssets: [], hooks: ["format-edited-file"], promptSurfaces: [], promptDetails: [] }
 ];
 
 // src/data/catalog/skills.ts
@@ -42296,7 +42289,7 @@ var toolCatalog = [
 
 // package.json
 var name = "@punks/cli";
-var version = "1.0.6";
+var version = "1.0.7";
 // src/baseline/bundled.ts
 var bundledBaseline = {
   summary: {
@@ -46694,6 +46687,9 @@ var runUpdate = ({
         relativePath: change.path
       });
     }
+    for (const staleFile of staleFiles) {
+      rmSync3(path12.join(rootDirectory, staleFile), { recursive: true, force: true });
+    }
   }
   if (check2 && needsAttention) {
     process.exitCode = 1;

package/dist/skills/agnostic/planning/implement-spec/SKILL.md

@@ -41,12 +41,11 @@ That means `implement-spec` itself owns all of the following in parallel mode:
 3. Choose the execution mode explicitly:
    - Read `references/sequential.md` for one-thread execution.
    - Read `references/parallel.md` for wave-based worker execution.
-4. In Codex parallel mode, read `references/parallel-reasoning.md` before spawning workers and apply the Codex-only worker reasoning policy.
-5. Record the chosen mode under **Execution mode** in `IMPLEMENTATION-NOTES.md` before coding.
-6. Execute only the chosen mode. Do not mix modes inside one run.
-7. After each completed task or wave, update `PLAN.md`, `IMPLEMENTATION-NOTES.md`, and spec-linked tech debt before advancing.
-8. If backlog sync is in scope, keep epic/story bodies product-facing and use native metadata or comments instead of execution handoff rewrites.
-9. Finish with the shared acceptance audit and spec finalization contract.
+4. Record the chosen mode under **Execution mode** in `IMPLEMENTATION-NOTES.md` before coding.
+5. Execute only the chosen mode. Do not mix modes inside one run.
+6. After each completed task or wave, update `PLAN.md`, `IMPLEMENTATION-NOTES.md`, and spec-linked tech debt before advancing.
+7. If backlog sync is in scope, keep epic/story bodies product-facing and use native metadata or comments instead of execution handoff rewrites.
+8. Finish with the shared acceptance audit and spec finalization contract.
 
 ## Mode selection
 
@@ -71,4 +70,3 @@ If the user already chose a mode, honor it. If not, make the smallest safe choic
 - Parallel execution specifics: see [references/parallel.md](references/parallel.md)
 - Parallel plan parsing and wave construction: see [references/parallel-orchestration.md](references/parallel-orchestration.md)
 - Parallel worker brief contract: see [references/parallel-worker-brief.md](references/parallel-worker-brief.md)
-- Codex parallel worker reasoning policy: see [references/parallel-reasoning.md](references/parallel-reasoning.md)

package/dist/skills/agnostic/planning/implement-spec/references/parallel-orchestration.md

@@ -56,7 +56,6 @@ Launch all unblocked tasks in parallel.
 For each unblocked task:
 
 - choose the worker template from `.agents/subagents/manifest.mjs`
-- in Codex, apply the worker `reasoning_effort` policy from [parallel-reasoning.md](parallel-reasoning.md)
 - use the worker-brief contract from [parallel-worker-brief.md](parallel-worker-brief.md)
 - keep the task scope narrow
 - ensure the worker owns only the assigned task and its required validation

package/dist/skills/agnostic/planning/implement-spec/references/parallel-worker-brief.md

@@ -34,8 +34,6 @@ Each worker brief should require:
 9. running the exact task validation evidence before returning, plus extra plan validation when feasible
 10. updating the plan entry with status, log, touched files, and gotchas before handoff closes
 
-When spawning Codex workers, apply [parallel-reasoning.md](parallel-reasoning.md): `xhigh -> high`, `high -> medium`, `medium -> low`, `low -> low`.
-
 ## Worker output contract
 
 Require the worker to return:
@@ -65,4 +63,3 @@ The parent `implement-spec` run owns:
 - review of worker outputs
 - retry and escalation decisions
 - deciding when the wave is complete
-- the final acceptance audit

package/dist/skills/agnostic/planning/implement-spec/references/parallel.md

@@ -31,18 +31,16 @@ Do not treat worker spawning as the whole job. The orchestration loop is part of
 1. Load the shared lifecycle from `lifecycle.md`.
 2. Record `parallel` under **Execution mode** in `IMPLEMENTATION-NOTES.md`.
 3. Read `.agents/subagents/manifest.mjs` before the first spawn and choose explicit worker templates per task.
-4. In Codex, read [parallel-reasoning.md](parallel-reasoning.md) and set each worker `reasoning_effort` lower than the parent orchestrator.
-5. Read [parallel-orchestration.md](parallel-orchestration.md) and parse `PLAN.md` into a task graph.
-6. Build the current wave from the unblocked tasks only.
-7. Read [parallel-worker-brief.md](parallel-worker-brief.md) and use that contract when spawning workers.
-8. Validate each wave before moving on. Fix failures before the next wave.
-9. Update the plan, notes, and tech debt after every wave.
+4. Read [parallel-orchestration.md](parallel-orchestration.md) and parse `PLAN.md` into a task graph.
+5. Build the current wave from the unblocked tasks only.
+6. Read [parallel-worker-brief.md](parallel-worker-brief.md) and use that contract when spawning workers.
+7. Validate each wave before moving on. Fix failures before the next wave.
+8. Update the plan, notes, and tech debt after every wave.
 
 ## Required evidence
 
 - plan-derived wave selection
 - explicit worker briefs per task
-- explicit Codex worker `reasoning_effort` when running in Codex
 - post-wave review of worker outputs
 - acceptance-criteria coverage plus RED -> GREEN evidence, or explicit non-testable verification
 - task completion only after validation and plan/log updates

package/docs/README.md

@@ -3,6 +3,12 @@
 - [Requirements](./reference/dp-requirements.md)
 - [Scaffolding runbook](./runbooks/dp-cli-scaffolding.md)
 
+Domain knowledge:
+
+- [Wiki index](../wiki/index.md)
+
+The wiki is the durable domain layer for specs, raw inputs, flows, and concepts. Keep operator runbooks and implementation reference in `docs/`; keep stable product/domain knowledge in `wiki/`.
+
 Implementation notes:
 
 - canonical bundled scaffold metadata and shared assets live in `src/data/`
@@ -16,7 +22,7 @@ Implementation notes:
 - shared neutral hook and sync assets live in `src/data/hooks/` and `src/data/scripts/`; hook commands infer the target repo package manager from `packageManager` and lockfiles
 - scaffolded required tools always include `portless` and `skills` so generated guidance can standardize local dev origins and keep skill entrypoints up to date
 - `punks scaffold setup` checks the base required tools (`portless`, `skills`) before repo detection and checks selected-pack tools after pack confirmation.
-- Oxlint specs/starter config are scaffolded only when scanned manifests already declare `oxlint`; the auto format/lint hook is scaffolded only when manifests declare `oxfmt`. Other lint/format stacks are intentionally left untouched for now.
+- Oxlint specs/starter config are scaffolded only when scanned manifests already declare `oxlint`; the auto format/lint hook is scaffolded only when manifests declare `oxfmt`. PR creation is not gated by a scaffolded test-suite hook. Other lint/format stacks are intentionally left untouched for now.
 - the default debug pack scaffolds the local `debug-agent` skill and installs/verifies the `debug-agent` CLI without running its agent-install wizard
 - scaffolded repos keep project-local skills in `.agents/skills/`; only `.claude/skills` is a compatibility symlink mirror
 - React scaffold surfaces include `async-react-patterns` alongside the existing React composition, structure, and Vercel guidance so agents avoid outdated manual async state patterns.

package/docs/harness-intelligence-grill-log.md

@@ -0,0 +1,39 @@
+# Harness Intelligence Grill Log
+
+This log records locked requirements decisions for rethinking this repo as the Harness Intelligence project.
+
+## Initial Situation
+
+The repo currently provides real value as the `punks`/`dp` scaffolding CLI plus canonical scaffold baseline data. It has battle-tested workflow assets, repo-aware setup behavior, baseline publishing, and a local wiki-shaped knowledge tree.
+
+The repo does not yet provide the full product/distribution surface needed for wider colleague adoption or public company communication:
+
+- no Turborepo application layout
+- no public Fumadocs wiki/docs app
+- no public landing page
+- no Effect backend for scaffold distribution, validation, or future orchestration
+- no settled CLI-vs-backend boundary
+- no durable explanation of harness theory, criteria, trust model, and sales/marketing narrative
+
+## Branches
+
+### Branch A: Product Boundary
+
+Purpose: define what "Harness Intelligence" is as a product/system, and what this repo must own.
+
+### Branch B: Distribution Architecture
+
+Purpose: define Turborepo shape, app/package boundaries, backend role, CLI role, baseline/data flow, and public surfaces.
+
+### Branch C: Wiki and Theory
+
+Purpose: define the docs knowledge model, Fumadocs information architecture, and the harness engineering criteria currently living in the user's head.
+
+### Branch D: Trust and Adoption
+
+Purpose: define what colleagues need to trust the AI harness setup, how validation works, and what proof material must exist.
+
+### Branch E: Company Communication
+
+Purpose: define landing-page and sales narrative for how Devpunks engineers are AI-superpowered without becoming vague marketing copy.
+

package/docs/harness-intelligence-grill-status.md

@@ -0,0 +1,25 @@
+# Harness Intelligence Grill Status
+
+Current grill artifacts:
+
+- Log: `docs/harness-intelligence-grill-log.md`
+- Status: `docs/harness-intelligence-grill-status.md`
+
+## Branch Dashboard
+
+| Branch | Completion | Locked direction | Still open |
+| --- | ---: | --- | --- |
+| Product Boundary | 10% | Repo is being reconsidered as the Harness Intelligence project, not only a CLI package. | Canonical product definition, audience split, repo ownership boundary. |
+| Distribution Architecture | 10% | Target mentions Turborepo, public docs app, landing page, Effect backend, and CLI. | App/package boundaries, backend-vs-CLI responsibilities, data/source-of-truth flow. |
+| Wiki and Theory | 10% | Existing wiki shape exists locally; missing public Fumadocs app and full theory/criteria content. | IA, criteria taxonomy, private vs public knowledge split, docs ownership. |
+| Trust and Adoption | 10% | Colleague recognition/validation is a primary requirement. | Trust evidence, onboarding path, validation gates, adoption metrics. |
+| Company Communication | 10% | Public explanation must support sales/marketing around AI-superpowered developers. | Landing page promise, proof points, tone, relationship to devpunks.com. |
+
+## Parked Branches
+
+- None yet.
+
+## Current Question
+
+Q1: Product Boundary.
+

package/docs/runbooks/dp-cli-scaffolding.md

@@ -95,7 +95,7 @@ Current scope:
 - check the base required tools (`portless`, `skills`) at the start of setup before repo detection, then check selected-pack tools after pack confirmation
 - include `debug-agent` through the default debug pack and install/verify the `debug-agent` CLI without running `debug-agent init`, because the CLI already scaffolds the project-local skill
 - scaffold Oxlint specs/starter config only when scanned package manifests declare `oxlint`, and scaffold the `format-edited-file` Oxfmt/Oxlint hook only when manifests declare `oxfmt`; repos without those tools keep their existing lint/format setup untouched
-- scaffolded hooks infer the target repo package manager from `packageManager` first, then lockfiles, so PR test gates and Oxfmt/Oxlint execution do not hardcode the CLI repo's package manager
+- scaffolded hooks infer the target repo package manager from `packageManager` first, then lockfiles, so Oxfmt/Oxlint execution does not hardcode the CLI repo's package manager
 - select language packs separately from framework packs; TypeScript is selected from a `typescript` package dependency or nested `.ts` / `.tsx` files, and Python is selected from nested `.py` files, while ignoring root config files plus vendor, virtualenv, scaffold, docs, examples, scripts, `opensrc`, cache, and build output
 - seed Python subagent templates that combine the Python language skills into `python-app`, `python-async`, and `python-testing` specialists
 - seed a read-only `code-review` subagent template that uses `simplify` for changed-code cleanup review and `improve-codebase-architecture` for grounded architecture-friction findings

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punks/cli",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Devpunks AI scaffolding CLI",
   "type": "module",
   "bin": {

package/dist/data/hooks/format-edited-file.py

@@ -1,157 +0,0 @@
-#!/usr/bin/env python3
-
-from __future__ import annotations
-
-import hashlib
-import json
-import os
-import subprocess
-import sys
-from pathlib import Path
-
-SUPPORTED_SUFFIXES = (".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".json")
-IGNORED_PARTS = {".git", "node_modules", ".next", "dist"}
-
-
-def read_input() -> dict[str, object]:
-    try:
-        return json.load(sys.stdin)
-    except json.JSONDecodeError:
-        return {}
-
-
-def run_git(args: list[str], cwd: str) -> str:
-    result = subprocess.run(
-        ["git", "-C", cwd, *args],
-        check=True,
-        capture_output=True,
-        text=True,
-    )
-    return result.stdout
-
-
-def repo_root(cwd: str) -> str:
-    try:
-        return run_git(["rev-parse", "--show-toplevel"], cwd).strip()
-    except subprocess.CalledProcessError:
-        return ""
-
-
-def dirty_files(root: str) -> list[str]:
-    try:
-        output = run_git(["ls-files", "-m", "-o", "--exclude-standard"], root)
-    except subprocess.CalledProcessError:
-        return []
-
-    files: list[str] = []
-    for raw_path in output.splitlines():
-        path = raw_path.strip()
-        if not path:
-            continue
-        if not path.endswith(SUPPORTED_SUFFIXES):
-            continue
-        if any(part in IGNORED_PARTS for part in Path(path).parts):
-            continue
-        files.append(path)
-
-    return sorted(set(files))
-
-
-def file_hash(path: Path) -> str:
-    digest = hashlib.sha256()
-    with path.open("rb") as handle:
-        for chunk in iter(lambda: handle.read(65536), b""):
-            digest.update(chunk)
-    return digest.hexdigest()
-
-
-def snapshot_path(root: str, session_id: str, tool_use_id: str) -> Path:
-    repo_name = Path(root).name or "repo"
-    safe_session_id = session_id.replace("/", "_")
-    safe_tool_use_id = tool_use_id.replace("/", "_")
-    state_dir = Path(os.environ.get("TMPDIR", "/tmp")) / "codex-hooks" / repo_name / safe_session_id
-    state_dir.mkdir(parents=True, exist_ok=True)
-    return state_dir / f"{safe_tool_use_id}.json"
-
-
-def load_snapshot(path: Path) -> dict[str, str]:
-    if not path.exists():
-        return {}
-    try:
-        return json.loads(path.read_text(encoding="utf-8"))
-    except (OSError, json.JSONDecodeError):
-        return {}
-
-
-def fingerprints(root: str) -> dict[str, str]:
-    snapshot: dict[str, str] = {}
-    for relative_path in dirty_files(root):
-        absolute_path = Path(root) / relative_path
-        if absolute_path.exists():
-            snapshot[relative_path] = file_hash(absolute_path)
-    return snapshot
-
-
-def format_files(root: str, files: list[str]) -> list[str]:
-    failed: list[str] = []
-    for relative_path in files:
-        absolute_path = Path(root) / relative_path
-        result = subprocess.run(
-            ["npx", "oxfmt", "--write", str(absolute_path)],
-            cwd=root,
-            stdout=subprocess.DEVNULL,
-            stderr=subprocess.DEVNULL,
-            check=False,
-        )
-        if result.returncode != 0:
-            failed.append(relative_path)
-    return failed
-
-
-def emit_failure(files: list[str]) -> None:
-    message = "Auto-format failed for " + ", ".join(files) + ". Review the file and format it manually if needed."
-    print(json.dumps({"systemMessage": message}))
-
-
-def main() -> int:
-    mode = sys.argv[1] if len(sys.argv) > 1 else ""
-    payload = read_input()
-
-    cwd = str(payload.get("cwd") or os.getcwd())
-    session_id = str(payload.get("session_id") or "")
-    tool_use_id = str(payload.get("tool_use_id") or "")
-    root = repo_root(cwd)
-
-    if not root or not session_id or not tool_use_id:
-        return 0
-
-    state_file = snapshot_path(root, session_id, tool_use_id)
-
-    if mode == "pre":
-        state_file.write_text(json.dumps(fingerprints(root), sort_keys=True), encoding="utf-8")
-        return 0
-
-    if mode != "post":
-        return 0
-
-    previous = load_snapshot(state_file)
-    current = fingerprints(root)
-
-    try:
-        state_file.unlink()
-    except OSError:
-        pass
-
-    touched = [path for path, digest in current.items() if previous.get(path) != digest]
-    if not touched:
-        return 0
-
-    failed = format_files(root, touched)
-    if failed:
-        emit_failure(failed)
-
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/dist/data/hooks/require-tests-for-pr.mjs

@@ -1,206 +0,0 @@
-#!/usr/bin/env node
-
-import { spawnSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const denyMessage = "Tests are failing. Fix all test failures before creating a PR.";
-const prCommandPattern = /\bgh\s+pr\s+create\b/i;
-const prToolPattern = /(^|[._-])create[_-]?pull[_-]?request([._-]|$)/i;
-const packageManagers = new Set(["bun", "pnpm", "npm", "yarn"]);
-
-function readStdinJson() {
-  try {
-    return JSON.parse(readFileSync(0, "utf8"));
-  } catch {
-    return {};
-  }
-}
-
-function runGit(args, cwd) {
-  const result = spawnSync("git", ["-C", cwd, ...args], {
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"],
-  });
-
-  return result.status === 0 ? result.stdout : null;
-}
-
-function repoRoot(cwd) {
-  return runGit(["rev-parse", "--show-toplevel"], cwd)?.trim() ?? "";
-}
-
-function collectStrings(value, values = []) {
-  if (typeof value === "string") {
-    const trimmed = value.trim();
-    if (trimmed) {
-      values.push(trimmed);
-    }
-    return values;
-  }
-
-  if (Array.isArray(value)) {
-    for (const entry of value) {
-      collectStrings(entry, values);
-    }
-    return values;
-  }
-
-  if (!value || typeof value !== "object") {
-    return values;
-  }
-
-  for (const entry of Object.values(value)) {
-    collectStrings(entry, values);
-  }
-
-  return values;
-}
-
-function matchesPrAction(...values) {
-  const strings = [...new Set(values.flatMap((value) => collectStrings(value)))];
-
-  return strings.some((value) => prCommandPattern.test(value) || prToolPattern.test(value));
-}
-
-function readPackageJson(root) {
-  try {
-    return JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
-  } catch {
-    return {};
-  }
-}
-
-function packageManagerFromPackageJson(root) {
-  const packageManager = readPackageJson(root)?.packageManager;
-
-  if (typeof packageManager !== "string") {
-    return null;
-  }
-
-  const name = packageManager.split("@")[0];
-  return packageManagers.has(name) ? name : null;
-}
-
-function packageManagerFromLockfile(root) {
-  if (existsSync(path.join(root, "bun.lock")) || existsSync(path.join(root, "bun.lockb"))) {
-    return "bun";
-  }
-
-  if (
-    existsSync(path.join(root, "pnpm-lock.yaml")) ||
-    existsSync(path.join(root, "pnpm-workspace.yaml"))
-  ) {
-    return "pnpm";
-  }
-
-  if (existsSync(path.join(root, "yarn.lock"))) {
-    return "yarn";
-  }
-
-  if (existsSync(path.join(root, "package-lock.json"))) {
-    return "npm";
-  }
-
-  return null;
-}
-
-function testCommand(root) {
-  switch (packageManagerFromPackageJson(root) ?? packageManagerFromLockfile(root) ?? "npm") {
-    case "bun":
-      return ["bun", "run", "test"];
-    case "pnpm":
-      return ["pnpm", "--silent", "test"];
-    case "yarn":
-      return ["yarn", "--silent", "test"];
-    case "npm":
-    default:
-      return ["npm", "--silent", "test"];
-  }
-}
-
-function runTests(root) {
-  const command = testCommand(root);
-  const result = spawnSync(command[0], command.slice(1), {
-    cwd: root,
-    stdio: "ignore",
-  });
-
-  return result.status === 0;
-}
-
-function emitCodexOrClaudeBlock(message) {
-  process.stdout.write(
-    JSON.stringify({
-      hookSpecificOutput: {
-        hookEventName: "PreToolUse",
-        permissionDecision: "deny",
-        permissionDecisionReason: message,
-      },
-      systemMessage: message,
-    }),
-  );
-}
-
-function emitCursorBlock(message) {
-  process.stdout.write(
-    JSON.stringify({
-      continue: false,
-      permission: "deny",
-      agent_message: message,
-      user_message: message,
-    }),
-  );
-}
-
-function runCommandHook(style) {
-  const payload = readStdinJson();
-  const root = repoRoot(String(payload.cwd ?? process.cwd()));
-
-  if (!root || !matchesPrAction(payload) || runTests(root)) {
-    return;
-  }
-
-  if (style === "cursor") {
-    emitCursorBlock(denyMessage);
-    return;
-  }
-
-  emitCodexOrClaudeBlock(denyMessage);
-}
-
-export const RequireTestsForPrPlugin = async ({ worktree }) => {
-  return {
-    "tool.execute.before": async (input, output) => {
-      if (!matchesPrAction(input?.tool, output?.args?.command)) {
-        return;
-      }
-
-      if (runTests(worktree)) {
-        return;
-      }
-
-      throw new Error(denyMessage);
-    },
-  };
-};
-
-export const testHooks = {
-  testCommand,
-};
-
-function main() {
-  const mode = process.argv[2] ?? "";
-
-  if (mode === "claude" || mode === "codex" || mode === "cursor") {
-    runCommandHook(mode);
-  }
-}
-
-const invokedPath = process.argv[1] ? path.resolve(process.argv[1]) : "";
-const modulePath = fileURLToPath(import.meta.url);
-
-if (invokedPath && path.basename(invokedPath) === path.basename(modulePath)) {
-  main();
-}

package/dist/skills/agnostic/planning/implement-spec/references/parallel-reasoning.md

@@ -1,19 +0,0 @@
-# Codex Parallel Reasoning
-
-Use this reference only when `implement-spec` runs in Codex parallel mode and calls Codex `spawn_agent`.
-
-Set worker `reasoning_effort` lower than the parent orchestrator:
-
-| Orchestrator reasoning | Worker reasoning |
-|------------------------|------------------|
-| `xhigh`                | `high`           |
-| `high`                 | `medium`         |
-| `medium`               | `low`            |
-| `low`                  | `low`            |
-
-Rules:
-
-- This policy is Codex-only. Do not apply it to other models or hosts.
-- Pass the mapped value as `reasoning_effort` in each Codex `spawn_agent` call.
-- Keep orchestration, retries, dependency decisions, and acceptance audit in the parent.
-- If a worker task needs equal or higher reasoning, keep that task in the parent instead of spawning it.