@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/templates/extract.d.ts

@@ -1,4 +1,4 @@
-type TemplateCategory = "scripts" | "markdown" | "commands";
+type TemplateCategory = "markdown" | "commands";
 /**
  * Get the path to the pactile templates directory (.pactile/ scaffolding).
  */
@@ -13,15 +13,8 @@ export declare function readPactileFile(relativePath: string): string;
  * Read template content from a category directory.
  */
 export declare function readTemplate(category: TemplateCategory, filename: string): string;
-export declare function readScript(relativePath: string): string;
 export declare function readMarkdown(relativePath: string): string;
 export declare function readCommand(filename: string): string;
-/**
- * Copy a directory from pactile templates to target, making scripts executable.
- */
-export declare function copyPactileDir(srcRelativePath: string, destPath: string, options?: {
-    executable?: boolean;
-}): Promise<void>;
 /**
  * User `.pactile/modules/` may only contain the catalog index and each module's
  * short contract. CLI source next to the templates (`catalog.ts`, any `.ts`)

package/dist/templates/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"AASA,KAAK,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAIf;AA8BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CActE;AAwBD;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKhE"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"AAOA,KAAK,gBAAgB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAQ/C;AAED,wDAAwD;AACxD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAKD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CActE;AAwBD;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAKhE"}

package/dist/templates/extract.js

@@ -1,8 +1,6 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
-import { ensureDir, writeFile } from "../utils/file-writer.js";
-import { replacePythonCommandLiterals } from "../configurators/shared.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 /**
@@ -34,41 +32,12 @@ export function readTemplate(category, filename) {
     const templatePath = path.join(__dirname, category, filename);
     return fs.readFileSync(templatePath, "utf-8");
 }
-export function readScript(relativePath) {
-    return readPactileFile(`scripts/${relativePath}`);
-}
 export function readMarkdown(relativePath) {
     return readPactileFile(relativePath);
 }
 export function readCommand(filename) {
     return readTemplate("commands", filename);
 }
-/**
- * Copy a directory from pactile templates to target, making scripts executable.
- */
-export async function copyPactileDir(srcRelativePath, destPath, options) {
-    const pactilePath = getPactileSourcePath();
-    const srcPath = path.join(pactilePath, srcRelativePath);
-    await copyDirRecursive(srcPath, destPath, options);
-}
-async function copyDirRecursive(src, dest, options) {
-    ensureDir(dest);
-    for (const entry of fs.readdirSync(src)) {
-        const srcPath = path.join(src, entry);
-        const destPath = path.join(dest, entry);
-        const stat = fs.statSync(srcPath);
-        if (stat.isDirectory()) {
-            await copyDirRecursive(srcPath, destPath, options);
-        }
-        else {
-            const content = fs.readFileSync(srcPath, "utf-8");
-            const isExecutable = options?.executable && (entry.endsWith(".sh") || entry.endsWith(".py"));
-            await writeFile(destPath, replacePythonCommandLiterals(content), {
-                executable: isExecutable,
-            });
-        }
-    }
-}
 const USER_MODULE_INDEX = "index.json";
 const USER_MODULE_CONTRACT = "contract.md";
 /**

package/dist/templates/extract.js.map

@@ -1 +1 @@
-{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"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"}

package/dist/templates/markdown/agents.md

@@ -1,14 +1,14 @@
-<!-- PACTILE:START -->
-# Pactile (pactile)
-
-This project is managed by pactile. Working knowledge is pointers, not a playbook:
-
-- `.pactile/framework/index.md` — framework docs (gates, parallel-first, retrieval, skills)
-- `.pactile/workflow.md` — interface card (not runtime SSOT)
-- `docs/` — harness docs
-
-User commands: `pactile-continue`, `pactile-finish-work`, `pactile-handoff` (and `pactile-start` when needed).
-
-Managed by pactile. Edits outside this block are preserved; edits inside may be overwritten by a future `pactile update`.
-
-<!-- PACTILE:END -->
+<!-- PACTILE:START -->
+# Pactile (pactile)
+
+This project is managed by pactile. Working knowledge is pointers, not a playbook:
+
+- `.pactile/framework/index.md` — framework docs (gates, parallel-first, retrieval, skills)
+- `.pactile/workflow.md` — interface card (not runtime SSOT)
+- `docs/` — harness docs
+
+User commands: `pactile-continue`, `pactile-finish-work`, `pactile-handoff` (and `pactile-start` when needed).
+
+Managed by pactile. Edits outside this block are preserved; edits inside may be overwritten by a future `pactile update`.
+
+<!-- PACTILE:END -->

package/dist/templates/markdown/framework/artifact-locale-guide.md.txt

@@ -1,93 +1,93 @@
-# Human-Reviewed Artifact Locale Guide
-
-> **Purpose:** Let PRD / DESIGN / IMPLEMENT / VERIFY / HANDOFF follow the user's language (Chinese or English) without turning Pactile into a full i18n product.
-
----
-
-## 1. Non-goals
-
-| In scope | Out of scope |
-| --- | --- |
-| Workspace / task `artifact_locale` | Full CLI `--help` / stderr i18n |
-| `task.py create` PRD seed language | Auto-translating archived tasks |
-| Session / planning hints for artifact language | Bilingual mirrors of `workflow.md` or `.cursor/rules` |
-| `prd.md` / `design.md` / `implement.md` / `verify.md` / `handoff.md` | `task.json` field names or gate enums |
-
-**Rollback:** `python ./.pactile/scripts/task.py artifact-locale set zh` or remove `artifact_locale` from `.pactile/config.yaml`. For a single task, delete `task.json` → `meta.artifact_locale`.
-
----
-
-## 2. Configuration
-
-### Workspace default (`.pactile/config.yaml`)
-
-```yaml
-# Human-reviewed artifact locale (zh | en)
-artifact_locale: zh
-```
-
-Default when unset: **`zh`** (matches current dogfood and User Rules for Simplified Chinese replies).
-
-### CLI
-
-```powershell
-# Resolved locale (workspace default)
-python ./.pactile/scripts/task.py artifact-locale get
-
-# Resolved locale for one task (includes task override)
-python ./.pactile/scripts/task.py artifact-locale get --task .pactile/tasks/<dir>
-
-# Workspace default
-python ./.pactile/scripts/task.py artifact-locale set en
-python ./.pactile/scripts/task.py artifact-locale set zh
-
-# Per-task override
-python ./.pactile/scripts/task.py artifact-locale set zh --task .pactile/tasks/<dir>
-```
-
-Invalid values print a warning and fall back to the next layer (`task` → `workspace` → `zh`).
-
----
-
-## 3. What respects locale
-
-| Artifact | Mechanism |
-| --- | --- |
-| `prd.md` on `task.py create` | Locale template under `.pactile/tasks/locale/{zh,en}/default-prd.md` |
-| `design.md` / `implement.md` | Agent planning (session context + `pactile-brainstorm`) |
-| `verify.md` / `handoff.md` | Agent execution / finish (same session hint) |
-| Optional `tasks/templates/*` copies | Agent follows guide; English paths stay canonical |
-
-**Does not change:** existing files in a task directory, CLI diagnostics, hooks, or machine gate names.
-
----
-
-## 4. Dogfood checklist
-
-1. `artifact-locale set en` → `task.py create "Locale EN" --slug locale-dogfood-en` → `prd.md` uses `## Goal`, `## Requirements`.
-2. `artifact-locale set zh` → `task.py create "Locale ZH" --slug locale-dogfood-zh` → `prd.md` uses `## 目标`, `## 需求`.
-3. With workspace `en`, `artifact-locale set zh --task <dir>` → next create for that task only uses Chinese if `meta.artifact_locale` was set before create (override applies to resolved locale for that task).
-
----
-
-## 5. Orthogonal `locale` settings
-
-| Setting | Purpose |
-| --- | --- |
-| **`artifact_locale`** (this guide) | Human-reviewed task artifacts |
-| Retrieval / semantic `locale` | Code search ranking and plan language |
-| smart-search `locale-scope` | External research evidence language |
-
-Do not merge these keys; they solve different problems.
-
----
-
-## 6. Rollback
-
-1. `artifact-locale set zh` (workspace).
-2. Remove `meta.artifact_locale` from any task that should follow workspace only.
-3. Revert code/templates if needed — default `zh` keeps dogfood behavior without config.
-
----
-
-**Core principle:** Product language follows the user for artifacts they review; infrastructure stays English unless explicitly scoped.
+# Human-Reviewed Artifact Locale Guide
+
+> **Purpose:** Let PRD / DESIGN / IMPLEMENT / VERIFY / HANDOFF follow the user's language (Chinese or English) without turning Pactile into a full i18n product.
+
+---
+
+## 1. Non-goals
+
+| In scope | Out of scope |
+| --- | --- |
+| Workspace / task `artifact_locale` | Full CLI `--help` / stderr i18n |
+| `pactile task create` PRD seed language | Auto-translating archived tasks |
+| Session / planning hints for artifact language | Managed `AGENTS.md` block or project spec |
+| `prd.md` / `design.md` / `implement.md` / `verify.md` / `handoff.md` | `task.json` field names or gate enums |
+
+**Rollback:** `pactile task artifact-locale set zh` or remove `artifact_locale` from `.pactile/config.yaml`. For a single task, delete `task.json` → `meta.artifact_locale`.
+
+---
+
+## 2. Configuration
+
+### Workspace default (`.pactile/config.yaml`)
+
+```yaml
+# Human-reviewed artifact locale (zh | en)
+artifact_locale: zh
+```
+
+Default when unset: **`zh`** (matches current dogfood and User Rules for Simplified Chinese replies).
+
+### CLI
+
+```powershell
+# Resolved locale (workspace default)
+pactile task artifact-locale get
+
+# Resolved locale for one task (includes task override)
+pactile task artifact-locale get --task .pactile/tasks/<dir>
+
+# Workspace default
+pactile task artifact-locale set en
+pactile task artifact-locale set zh
+
+# Per-task override
+pactile task artifact-locale set zh --task .pactile/tasks/<dir>
+```
+
+Invalid values print a warning and fall back to the next layer (`task` → `workspace` → `zh`).
+
+---
+
+## 3. What respects locale
+
+| Artifact | Mechanism |
+| --- | --- |
+| `prd.md` on `pactile task create` | Locale template under `.pactile/tasks/locale/{zh,en}/default-prd.md` |
+| `design.md` / `implement.md` | Agent planning (session context + `pactile-brainstorm`) |
+| `verify.md` / `handoff.md` | Agent execution / finish (same session hint) |
+| Optional `tasks/templates/*` copies | Agent follows guide; English paths stay canonical |
+
+**Does not change:** existing files in a task directory, CLI diagnostics, hooks, or machine gate names.
+
+---
+
+## 4. Dogfood checklist
+
+1. `artifact-locale set en` → `pactile task create "Locale EN" --slug locale-dogfood-en` → `prd.md` uses `## Goal`, `## Requirements`.
+2. `artifact-locale set zh` → `pactile task create "Locale ZH" --slug locale-dogfood-zh` → `prd.md` uses `## 目标`, `## 需求`.
+3. With workspace `en`, `artifact-locale set zh --task <dir>` → next create for that task only uses Chinese if `meta.artifact_locale` was set before create (override applies to resolved locale for that task).
+
+---
+
+## 5. Orthogonal `locale` settings
+
+| Setting | Purpose |
+| --- | --- |
+| **`artifact_locale`** (this guide) | Human-reviewed task artifacts |
+| Retrieval / semantic `locale` | Code search ranking and plan language |
+| smart-search `locale-scope` | External research evidence language |
+
+Do not merge these keys; they solve different problems.
+
+---
+
+## 6. Rollback
+
+1. `artifact-locale set zh` (workspace).
+2. Remove `meta.artifact_locale` from any task that should follow workspace only.
+3. Revert code/templates if needed — default `zh` keeps dogfood behavior without config.
+
+---
+
+**Core principle:** Product language follows the user for artifacts they review; infrastructure stays English unless explicitly scoped.

package/dist/templates/markdown/framework/codex-worker-dispatch.md.txt

@@ -0,0 +1,9 @@
+# Codex worker dispatch
+
+Codex work uses independent desktop tasks and cross-session messaging. The main task owns planning, integration, review, and final acceptance. Pactile does not dispatch Codex subagents.
+
+Use `pactile codex prepare <task> --tool create|message|wait|read ...` to bind a Pactile Task and its Kernel revision to a native desktop tool request. Roles are `plan`, `execute`, and `review`; Execute requires recorded user approval and a project worktree. The current Codex desktop task invokes the native tool, then records its returned identity and outcome with `pactile codex receipt <task> <request-id> --result-file <file>`. Inspect `pactile codex status <task>` for pending requests, bound desktop tasks, and stale contracts. An Execute Child holds its Parent's bounded dispatch slot until a completed wait receipt; failed creation releases it. Only create a new desktop task when the user explicitly requests one.
+
+Each worker receives a bounded objective, write set, and acceptance evidence. Record the destination task identity and final evidence in the parent task. A worker message alone does not prove implementation or verification.
+
+The Node CLI does not call the desktop tools directly. A receipt is host-reported evidence, not implementation or acceptance proof. `pactile task` and the Kernel retain phase, approval, and review authority; `pactile pi run` checks execution approval before Pi dispatch. If cross-session coordination is unavailable, continue in the current task and record the reason for serial execution. Do not silently substitute a Codex subagent or a Codex CLI/App Server/ACP session.

package/dist/templates/markdown/framework/dogfood-only-surfaces.md.txt

@@ -1,28 +1,7 @@
-# Dogfood-Only vs Default Install Surfaces
-
-> **Purpose**: An inventory of surfaces that exist in the **maintainer harness** (MyHarness) but are **not** shipped by a default `pactile init` / `pactile update`. Use it to avoid the false conclusion "the product feature disappeared" when comparing a consumer repo to the harness. A file missing from a consumer project is **by design**, not a regression — the CLI/script/guide surface still carries the capability.
-
-## Rule of thumb
-
-- **Shipped by default** = written by `pactile init --cursor` and refreshed by `pactile update` (workflow, `.pactile/framework/` docs, scripts, AGENTS.md PACTILE block, `.cursor/{commands,rules,agents,hooks}`). `.pactile/spec/` seeds are init-only and **never** refreshed — update never touches that directory.
-- **Dogfood-only / harness-only** = present only in the maintainer harness or after manual copy. Absence in a consumer repo is expected.
-
-## Inventory
-
-| Surface | Where it exists | Why dogfood-only | Decision |
-| --- | --- | --- | --- |
-| `.claude/skills/*` full suite | `.claude/skills/` in the harness | Cursor default install is **commands-only**; Claude skill files are for Claude platforms, not Cursor consumers | **non-Cursor** (not in Cursor default install) |
-| Private review-pool items / plan narratives | `.pactile/pool/items/`, `{TASK}/research/` in the harness | Personal or project-specific content; the pool **mechanism** ships, the items do not | **narrative not packaged** — mechanism ships, content stays local |
-| `.codegraph/`, `.worktrees/`, scratch/analysis files | Harness root | Per-machine index / tooling state | **local only** |
-
-## If a capability seems missing in a consumer repo
-
-1. Check the [internal-skills-cursor-reachability.md](./internal-skills-cursor-reachability.md) matrix — the capability's load channel (guide / script / agent / CLI) should be present.
-2. Check AGENTS.md `Invocation map (short)` — the intended entry point (`/pactile-handoff`, etc.).
-3. If the entry point is a harness-only file from the table above, the capability is intentionally **not** shipped to consumers — do not backfill it by copying harness files.
-
-## Related
-
-- [internal-skills-cursor-reachability.md](./internal-skills-cursor-reachability.md) — reachability of internal skill names.
-- [prd-grill-frontier.md](./prd-grill-frontier.md) — P11 grilling on-demand path.
-- AGENTS.md `Invocation map (short)` — session handoff = `/pactile-handoff`.
+# Product and maintainer-local surfaces
+
+A default `pactile init --codex` creates canonical files under `.pactile/` and projects managed instructions and Skills into `AGENTS.md` and `.agents/skills/`. Native Codex bindings depend on host readiness. `pactile update` refreshes framework-owned files after conflict review; `.pactile/spec/` remains user-owned.
+
+The maintainer's local harness can contain private tasks, research, indexes, worktrees, and host configuration. Those files are not product templates and are not copied into a consumer project.
+
+If a capability seems absent, inspect the package's generated files and the output of `pactile capability-smoke --json`. Do not copy files from a maintainer workspace into a consumer project.

package/dist/templates/markdown/framework/execution-strategy.md.txt

@@ -1,45 +1,14 @@
-# Execution strategy (execution_mode / isolation)
-
-> **Purpose**: Suggest a Development Strategy Contract before you freeze `implement.md`, and align Phase 2 dispatch with the approved contract.
-
-This file answers **who** implements/checks and **where** files are edited. It is **not** a parallel scheduler. Parallel-first (default native parallel, serial needs `serial_reason`) lives in `workflow.md` and `cursor-native-modes-guide.md`; declaration fields in `parallel-first-execution.md`.
-
----
-
-## Two orthogonal dimensions
-
-| Field | Question |
-| --- | --- |
-| `execution_mode` | **Who** implements and checks? (`inline` main session, `worker` pactile-implement/check agents, `child-task` Child worker) |
-| `isolation` | **Where** are files edited? (`main-worktree` vs `git-worktree` for Child) |
-
-Non-git repo roots do **not** force `inline` for code Full tasks; they only affect whether `git-worktree` / `prepare-child-worktree` is recommended.
-
-## Suggest (planning)
-
-```bash
-python3 ./.pactile/scripts/task.py suggest-execution-strategy <task-dir>
-python3 ./.pactile/scripts/task.py suggest-execution-strategy <task-dir> --json
-```
-
-Run during brainstorm / before finalizing the YAML block in `implement.md`. Reconcile suggestion with product intent; the contract in `implement.md` is authoritative after approval.
-
-## Default policy (v1)
-
-| Profile / signal | Suggested `execution_mode` | Suggested `isolation` |
-| --- | --- | --- |
-| Lite | (no contract) | — |
-| Full + touches code | `worker` | `main-worktree` |
-| Full + doc-only capabilities | `inline` | `main-worktree` |
-| Parent / has children | `inline` | `main-worktree` |
-| Child (`task.json` parent set) | `child-task` | `git-worktree` when git package root resolves; else `main-worktree` + WARN |
-
-`touches_code` is deterministic: code `optional_capabilities`, `package`/`scope` path segments (`src`, `packages`, `scripts`, …), or Full with `design.md` and non-doc-only capabilities. Rules live in `.pactile/config/execution-strategy-rules.json`.
-
-## Drift warning (preflight)
-
-`task.py start-execution <task> --check` prints `[execution-strategy] WARN` when the approved contract differs from a fresh suggestion. **Advisory only** — does not fail the gate.
-
-## Phase 2 alignment
-
-See `workflow.md` Phase 2.1 / 2.2 tables: spawn `pactile-implement` / `pactile-check` only when `execution_mode: worker`.
+# Execution strategy (execution_mode / isolation)
+
+Choose who implements and checks, and where edits happen, before freezing `implement.md`. The approved task contract is authoritative.
+
+| Field | Meaning |
+| --- | --- |
+| `execution_mode` | `inline` for the current task, `worker` for an independent task, or `child-task` for a task with a parent |
+| `isolation` | `main-worktree` or `git-worktree` |
+
+Codex desktop planning, Execute, and review tasks use native cross-task messaging with `pactile codex` request/receipt records. Execute requires recorded approval and a project worktree. The desktop task must invoke its native tool; the Node CLI cannot invoke App tools by itself. Pi implementation workers use `pactile pi run` after execution approval. Parent batches can use `pactile parallel run <parent> --manifest <file>` with a cap of 2 by default (at most 4), declared Child write sets, and serial Parent integration. Pactile does not dispatch Codex subagents. See `codex-worker-dispatch.md`.
+
+The execution strategy is documented in `implement.md`. Review it against the task scope before running `pactile task start-execution <task> --check`; the Node CLI checks the transition without changing approval state.
+
+A non-Git project may still use a worker; it changes the isolation choices, not the execution mode. Parallel work must have independent write sets and a recorded integration owner.

package/dist/templates/markdown/framework/index.md.txt

@@ -1,31 +1,20 @@
-# Framework Docs (`.pactile/framework/`)
-
-> **Ownership**: These files are **framework-managed**. `pactile update` refreshes them (with the same hash-conflict prompt as `workflow.md`). If you edit one, update will ask before overwriting — prefer putting project-specific norms in `.pactile/spec/` instead, which update never touches.
-
-Versioned framework and platform-adapter documentation. Project/team knowledge lives in `.pactile/spec/` (user-owned); this directory documents how the framework itself behaves.
-
-## Docs
-
-| Doc | What it covers |
-| --- | --- |
-| [prd-grill-frontier.md](./prd-grill-frontier.md) | On-demand path to the PRD grill and Frontier discipline (bundled `brainstorm` skill is SSOT) |
-| [internal-skills-cursor-reachability.md](./internal-skills-cursor-reachability.md) | How each internal workflow skill is reachable on Cursor (commands-only baseline) |
-| [dogfood-only-surfaces.md](./dogfood-only-surfaces.md) | Which surfaces ship by default vs exist only in the maintainer harness |
-| [cursor-subagent-policy.md](./cursor-subagent-policy.md) | When to spawn Pactile custom agents; model policy stays on the Cursor side |
-| [retrieval-daily-guide.md](./retrieval-daily-guide.md) | Daily retrieval tool routing (search vs retrieval-pack scoring; web-research gate) |
-| [cursor-native-modes-guide.md](./cursor-native-modes-guide.md) | Mapping Cursor Plan / Ask / Debug / Agent / Multitask onto Pactile phases |
-| [parallel-first-execution.md](./parallel-first-execution.md) | Parallel-first **product** principle + execution contract: native parallel default, `serial_reason`, task-map fields |
-| [middleware-protocol.md](./middleware-protocol.md) | Middleware Protocol v1: one ABI, overlay `.pactile/middleware/`, shipped providers (smart-search required; others optional), `update` never writes/deletes/hashes overlay |
-| [upgrade.md](./upgrade.md) | Terminal-user upgrade half-page: install package → `pactile update` → confirm → keep working |
-| [release-boundary.md](./release-boundary.md) | PACTILE this-batch ship vs independent pactile-byok ship; BYOK is not a PACTILE release gate |
-| [cursor-context-injection-guide.md](./cursor-context-injection-guide.md) | Which Cursor injection channels actually reach the model |
-| [cursor-semantic-compliance.md](./cursor-semantic-compliance.md) | Plan-vs-exec semantic compliance on Cursor |
-| [injection-budget-guide.md](./injection-budget-guide.md) | Context injection budget across reliable Cursor channels |
-| [execution-strategy.md](./execution-strategy.md) | Development Strategy Contract (`execution_mode` / isolation) |
-| [verification-strength-guide.md](./verification-strength-guide.md) | How deeply tasks must be verified before closeout, graded by task mode |
-| [artifact-locale-guide.md](./artifact-locale-guide.md) | How human-reviewed artifacts follow the user's language |
-
-## Related
-
-- `.pactile/workflow.md` — the workflow itself (also framework-managed)
-- `.pactile/spec/guides/` — project thinking guides (user-owned; update never modifies)
+# Framework Docs (`.pactile/framework/`)
+
+These framework-owned files are refreshed by `pactile update` with conflict review. Project-specific rules belong in `.pactile/spec/`.
+
+| Doc | Purpose |
+| --- | --- |
+| [prd-grill-frontier.md](./prd-grill-frontier.md) | Requirements and planning questions |
+| [dogfood-only-surfaces.md](./dogfood-only-surfaces.md) | Product versus maintainer-local files |
+| [codex-worker-dispatch.md](./codex-worker-dispatch.md) | Codex desktop task request/receipt bridge and worker boundary |
+| [retrieval-daily-guide.md](./retrieval-daily-guide.md) | Source search and evidence routing |
+| [parallel-first-execution.md](./parallel-first-execution.md) | Parallel work declarations |
+| [middleware-protocol.md](./middleware-protocol.md) | Middleware overlay and provider contracts |
+| [upgrade.md](./upgrade.md) | Project update steps |
+| [execution-strategy.md](./execution-strategy.md) | Execution mode and isolation |
+| [verification-strength-guide.md](./verification-strength-guide.md) | Verification depth |
+| [injection-budget-guide.md](./injection-budget-guide.md) | Context budget |
+| [artifact-locale-guide.md](./artifact-locale-guide.md) | Artifact language |
+| [release-boundary.md](./release-boundary.md) | Release scope |
+
+`.pactile/workflow.md` is the human workflow overview. `.pactile/spec/guides/` is user-owned and is not refreshed by update.

package/dist/templates/markdown/framework/injection-budget-guide.md.txt

@@ -1,111 +1,7 @@
-# Injection Budget Guide
-
-> **Purpose**: Allocate context injection across **reliable Cursor channels** with measurable caps —「完整 = 证据密度」, not unbounded prose.
-
-**Matrix input:** `08-06-pactile-p0-channel-baseline-matrix` → `research/channel-matrix.md` (C01–C04, C16).
-
----
-
-## 1. Non-goals
-
-- **No `beforeSubmitPrompt` injection** — C04 stays telemetry-only until Cursor changelog proves otherwise.
-- **No black-box silent injection** — Layer 2 and jsonl loads emit stderr manifest lines.
-- **No weakening active controls** — execution approval and retrieval policy remain enforced. Intake is handled by `intake-basic`; it has no `[Triage:]` line, and the removed `pactile-triage.mdc` is not an always-on gate.
-- **No Auto-Trigger Skill as retrieval primary** — C16 stays Rules + `route_codebase_retrieval.py --instructions`.
-
----
-
-## 2. Channel budget tiers
-
-| Tier | Channels | When | Budget |
-| --- | --- | --- | --- |
-| **Per-turn hard** | C01 Rules, C02 AGENTS | Every agent turn | Rules total warn 20 KiB / fail 32 KiB; AGENTS PACTILE block warn 4 KiB |
-| **Session once** | C03 sessionStart | New session | Keep the context-progressive Session pack compact; not a substitute for per-turn rules |
-| **Zero** | C04 beforeSubmit | Every message | **0** — log only |
-| **Subagent only** | C06 Layer 2 | `generate_dispatch_prompt` → Task | Role default `max_chars` + jsonl caps (§3) |
-| **On demand** | C16 retrieval | When agent needs a plan | Rules default order or router CLI; no per-message plan block |
-
----
-
-## 3. JSONL manifest budgets (implement / check)
-
-Curate **spec/research only** — never pre-register code paths you will edit.
-
-| Limit | Value | Enforcement |
-| --- | --- | --- |
-| Max entries | 8 | Skip excess at Layer 2 load; `task.py validate` WARN |
-| Max single expansion | 12,000 chars | Skip file/directory block |
-| Max total jsonl body | 48,000 chars | Skip when cumulative would exceed |
-
-**Curator rules:**
-
-1. Prefer **index + one layer spec** over whole package trees.
-2. Use `task.py add-context` with a one-line **reason** (replayable intent).
-3. Delete the seed `_example` row when adding real entries.
-4. Full task artifacts (`prd.md`, `design.md`, `implement.md`) are **always** embedded separately — do not duplicate them in jsonl.
-
-**Dispatch manifest (stderr):**
-
-```text
-[subagent-dispatch] injection-budget: .pactile/tasks/.../implement.jsonl loaded 2 entries (8421 chars): ...
-[subagent-dispatch] injection-budget: skipped path: total cap (...)
-```
-
----
-
-## 4. Layer 2 role defaults
-
-When `--max-chars` is omitted, `generate_dispatch_prompt.py` uses:
-
-| Role | Default `max_chars` |
-| --- | --- |
-| implement | 96,000 |
-| check | 64,000 |
-| research | 48,000 |
-
-Override per dispatch when a task truly needs more — document the override in `implement.md` DSC and `verify.md`.
-
-Truncation order after jsonl budget: whole context string tail-truncated with `...[truncated]...` warning.
-
----
-
-## 5. alwaysApply rule hygiene
-
-Before adding a new `.cursor/rules/*.mdc` with `alwaysApply: true`:
-
-1. Confirm the content **must** be visible **every turn** (see `cursor-context-injection-guide.md`).
-2. Run `python ./.pactile/scripts/injection_budget_probe.py --repo-root .`.
-3. If total alwaysApply exceeds **20 KiB**, trim or move detail to on-demand spec / `get_context.py`.
-
-**Rollback:** remove or scope the new rule; re-run probe.
-
----
-
-## 6. Observability probe
-
-```powershell
-# Workspace surfaces
-python ./.pactile/scripts/injection_budget_probe.py --repo-root .
-
-# Task jsonl + dispatch size
-python ./.pactile/scripts/injection_budget_probe.py --repo-root . --task .pactile/tasks/<task-dir> --dispatch-role implement
-
-# CI / gate style (fail on WARN or rules >32KiB)
-python ./.pactile/scripts/injection_budget_probe.py --repo-root . --strict
-```
-
-Constants live in `.pactile/scripts/common/injection_budget.py` (single source).
-
----
-
-## 7. Related
-
-- [Cursor context injection guide](./cursor-context-injection-guide.md) — channel reliability matrix
-- [Cursor subagent policy](./cursor-subagent-policy.md) — Layer 2 dispatch contract
-- [Verification strength guide](./verification-strength-guide.md) — evidence density for closeout (orthogonal axis)
-
----
-
-## 8. Rollback
-
-Revert `injection_budget.py`, probe script, `subagent_dispatch` budget branch, validate WARNs, and this guide. Layer 2 returns to unbounded jsonl expansion; C04 remains telemetry-only.
+# Context budget
+
+Keep the per-session context small and evidence-focused. Put durable project constraints in the managed `AGENTS.md` block or user-owned `.pactile/spec/`. Put long task detail in task artifacts and load it when needed.
+
+The default budget is a short orientation, the selected task's acceptance criteria, and only the relevant spec or research files. Before adding a new always-visible instruction, check whether it applies to every task; otherwise keep it on demand.
+
+A generated file or hook registration does not prove that the Codex host delivered content to the model. Verify an observed session result before relying on an injection channel.