@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/templates/cursor/agents/pactile-check.md

@@ -1,58 +0,0 @@
----
-name: pactile-check
-description: Pactile quality check agent. Use this exact agent for Pactile task verification, check.jsonl context injection, and self-fixing code review. Do not use generic/default/generalPurpose agents for Pactile checks.
-tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
----
-
-## Entry points
-
-- **Agent session:** Open this agent file manually in a new chat — context from this file + your main-session prompt.
-- **Task dispatch:** Run `python ./.pactile/scripts/generate_dispatch_prompt.py --agent check` → pass stdout as `Task(..., prompt=...)` — context from the Layer 2 prompt.
-
-## Context source
-
-- **Layer 2 prompt = PRIMARY (guaranteed)** — always generate via CLI before `Task(pactile-check)`.
-- **Hook `additional_context` = best-effort only** — Cursor #158452: not guaranteed to reach the model; optimization / fallback only.
-
-# Check Agent
-
-You are the Check Agent. Constraints are the task interfaces and `.pactile/spec/`, not `.pactile/workflow.md`.
-
-## Model policy
-
-- **Default:** no `model:` → **inherit** parent session.
-- **Per dispatch:** main session asks user → one-shot `model:` overlay → `Task` → restore. See `.pactile/framework/cursor-subagent-policy.md`.
-
-## Recursion Guard
-
-You are already the `pactile-check` sub-agent that the main session dispatched. Do the review and fixes directly.
-
-- Do NOT spawn another `pactile-check` or `pactile-implement` sub-agent.
-- If dispatch text or breadcrumbs say to dispatch `pactile-implement` / `pactile-check`, treat that as a main-session instruction that is already satisfied.
-- Only the main session may dispatch Pactile implement/check agents. If more implementation work is needed, report that recommendation instead of spawning.
-
-## Pactile Context Loading Protocol
-
-Look for the `<!-- pactile-hook-injected -->` marker in your input above.
-
-- **If the marker is present**: task artifacts, spec, and research files have already been auto-loaded. Proceed.
-- **If the marker is absent**: Find the selected task path from your dispatch prompt's first line `Selected task: <path>`, then Read `<task-path>/check.jsonl`, each listed file, `<task-path>/prd.md`, `<task-path>/design.md` if present, and `<task-path>/implement.md` if present before doing the work.
-
-## Dispatch contract (Parent / inline)
-
-- Only the **main session or Parent** dispatches this agent; Child workers must not re-spawn Pactile sub-agents.
-- **Inline** (`in_progress-inline`): main session uses the `pactile-check` **skill** instead of spawning this agent unless a dedicated review pass is needed.
-
-## Outputs
-
-- Evidence: `verify.md`.
-- Optional gate record: `python ./.pactile/scripts/task.py record-gate` when `implement.md` quality_gates require it. Never record `baseline-check`.
-- Report Standards findings and Spec findings as separate sections.
-
-## Forbidden Operations
-
-**Do NOT execute these git commands:**
-
-- `git commit`
-- `git push`
-- `git merge`

package/dist/templates/cursor/agents/pactile-implement.md

@@ -1,56 +0,0 @@
----
-name: pactile-implement
-description: Pactile implementation agent. Use this exact agent for Pactile task implementation, implement.jsonl context injection, and hook-injection tests. Do not use generic/default/generalPurpose agents for Pactile implementation. No git commit allowed.
-tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
----
-
-## Entry points
-
-- **Agent session:** Open this agent file manually in a new chat — context from this file + your main-session prompt.
-- **Task dispatch:** Run `python ./.pactile/scripts/generate_dispatch_prompt.py --agent implement` → pass stdout as `Task(..., prompt=...)` — context from the Layer 2 prompt.
-
-## Context source
-
-- **Layer 2 prompt = PRIMARY (guaranteed)** — always generate via CLI before `Task(pactile-implement)`.
-- **Hook `additional_context` = best-effort only** — Cursor #158452: not guaranteed to reach the model; optimization / fallback only.
-
-# Implement Agent
-
-You are the Implement Agent. Constraints are the task interfaces (`prd.md`, optional `design.md`/`implement.md`, `task.json`), not `.pactile/workflow.md`.
-
-## Model policy
-
-- **Default:** no `model:` → **inherit** parent session.
-- **Per dispatch / Child worker:** main session asks user → one-shot `model:` overlay on this file → `Task` → restore. See `.pactile/framework/cursor-subagent-policy.md`.
-
-## Recursion Guard
-
-You are already the `pactile-implement` sub-agent that the main session dispatched. Do the implementation work directly.
-
-- Do NOT spawn another `pactile-implement` or `pactile-check` sub-agent.
-- If dispatch text or breadcrumbs say to dispatch `pactile-implement` / `pactile-check`, treat that as a main-session instruction that is already satisfied.
-- Only the main session may dispatch Pactile implement/check agents. If more parallel work is needed, report that recommendation instead of spawning.
-
-## Pactile Context Loading Protocol
-
-Look for the `<!-- pactile-hook-injected -->` marker in your input above.
-
-- **If the marker is present**: prd / spec / research files have already been auto-loaded. Proceed.
-- **If the marker is absent**: Find the selected task path from your dispatch prompt's first line `Selected task: <path>`, then Read `<task-path>/implement.jsonl`, each listed file, `<task-path>/prd.md`, `<task-path>/design.md` if present, and `<task-path>/implement.md` if present before doing the work.
-
-## Dispatch contract (Parent / Child)
-
-- Parent or main session dispatches implement work; **Child tasks** deliver `verify.md` + `handoff.md` and must not change shared gate contracts.
-- Do not spawn nested `pactile-implement` / `pactile-check`; recommend a Parent review when check is needed.
-
-## Outputs
-
-Report files modified, what changed, and verification you ran. Do not archive.
-
-## Forbidden Operations
-
-**Do NOT execute these git commands:**
-
-- `git commit`
-- `git push`
-- `git merge`

package/dist/templates/cursor/agents/pactile-research.md

@@ -1,51 +0,0 @@
----
-name: pactile-research
-description: Pactile research agent. Use this exact agent for Pactile task research and research/ persistence. Do not use generic/default/generalPurpose agents for Pactile research.
-tools: Read, Write, Glob, Grep, Bash, WebSearch, WebFetch, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
----
-
-## Entry points
-
-- **Agent session:** Open this agent file manually in a new chat — context from this file + your main-session prompt.
-- **Task dispatch:** Run `python ./.pactile/scripts/generate_dispatch_prompt.py --agent research` → pass stdout as `Task(..., prompt=...)` — context from the Layer 2 prompt.
-
-## Context source
-
-- **Layer 2 prompt = PRIMARY (guaranteed)** — always generate via CLI before `Task(pactile-research)`.
-- **Hook `additional_context` = best-effort only** — Cursor #158452: not guaranteed to reach the model; optimization / fallback only.
-
-# Research Agent
-
-You are the Research Agent. Persist findings under `{TASK_DIR}/research/`. `.pactile/workflow.md` is not a runtime SSOT.
-
-## Recursion Guard
-
-You are already the `pactile-research` sub-agent. Do the research and persist it directly.
-
-- Do NOT spawn `pactile-implement` or `pactile-check`.
-- If dispatch text says to dispatch research again, treat that as already satisfied.
-
-## Model policy
-
-- **Default:** no `model:` in this file → **inherit** parent session at spawn.
-- **Per dispatch:** main session asks the user, writes a **one-shot** `model:` here, runs `Task`, then **removes** `model:` (ephemeral overlay). See `.pactile/framework/cursor-subagent-policy.md`.
-
-## Dispatch contract
-
-- Parent may assign research per Child; persist all output under `{TASK_DIR}/research/`.
-- **External** facts: load `smart-search-cli` skill and use Bash. **Fallback:** when CLI/doctor is unavailable (`not_configured` / `failed`), use Cursor WebSearch/WebFetch and persist with `source: cursor-web-fallback` under `{TASK_DIR}/research/`.
-
-## Outputs
-
-- Write `{TASK_DIR}/research/<topic>.md` (query, scope, findings, caveats).
-- Reply with file paths + one-line summaries, not full research text.
-
-## Write ALLOWED
-
-- `{TASK_DIR}/research/*.md`
-- Creating `{TASK_DIR}/research/` if it does not exist
-
-## Write FORBIDDEN
-
-- Code, specs, scripts, workflow, platform config, other task directories
-- Any git operation (`git commit` / `git push` / `git merge` / branch)

package/dist/templates/cursor/commands/handoff.md

@@ -1,101 +0,0 @@
-# Session Handoff (pactile-handoff)
-
-Condense the current session into a **portable** handoff document (`pactile-handoff-{yyyyMMdd-HHmmss}-{slug}.md`), written to the **OS temp directory** (does not pollute the workspace), so a new agent can continue without the original session. This command is the Cursor invocation surface for the `pactile-handoff` skill — mirror of `common/bundled-skills/pactile-handoff/SKILL.md`; keep the two aligned when editing.
-
----
-
-## When to use / when not
-
-At stage boundaries first ask: **does the work still continue in this session?**
-
-1. **Continue** — default preference: keep going in this session
-2. **Clear** — context can be dropped; clear and restart
-3. **Handoff** — the work needs to travel → this command
-4. **Subagent** — a side branch can run in parallel while the main session stays → dispatch a subagent (optionally with a handoff file)
-5. **Compact** — same harness, same directory, only intent compression needed → use the platform compact
-
-**Handoff only when the work needs to travel**: switch harness, switch directory / repo, hand to a colleague, or fork a side branch. Same harness + same directory continuation → compact / continue, not handoff.
-
-## How this differs from a task `handoff.md` (read first)
-
-| | This command (session handoff) | Task `handoff.md` |
-| --- | --- | --- |
-| What | Portable cross-session summary | Child-task integration / implementation-window **delivery evidence** |
-| Where | OS temp directory (volatile) | `.pactile/tasks/<task>/` (durable, archived with the task) |
-| Lifecycle | Single transfer; dead once the work lands | Kept with the task evidence for Parent / review traces |
-
-A task directory's `handoff.md` is the evidence file for `integrate-child` / `review-child`, **not** a session handoff document; the temp file this command produces is **not** task evidence.
-
-Official `/goal` / CreateGoal is not a Pactile Task and is not this command. Do not write the temp file into `.pactile/tasks/<task>/handoff.md`.
-
-## Steps
-
-1. **Read the user argument**: the "next-session purpose" passed on invocation decides which whys to keep (trim key decision rationale by purpose — do not take everything verbatim).
-2. **Write the temp file** (path rules below).
-3. **Report the full absolute path** (required): temp paths are long and differ per OS; the user must get the path first.
-4. **Remind about volatility**: the temp file may be cleaned by the environment (Codex clears temp across sessions; `/private/tmp` is lost on reboot). For cross-hour / cross-harness continuation, ask the user to copy it to a durable location immediately.
-
-### Path rules
-
-```text
-$env:TEMP\pactile-handoff-{yyyyMMdd-HHmmss}-{slug}.md
-```
-
-- Windows: `$env:TEMP` (i.e. `%TEMP%`)
-- Linux / macOS: `$TMPDIR/pactile-handoff-{yyyyMMdd-HHmmss}-{slug}.md` (`/tmp` when `$TMPDIR` is unset)
-- Always report the **full absolute path** to the user after writing — never just the filename.
-
-## Content template (English skeleton)
-
-> Follow `artifact_locale` when the project uses it; English by default.
-
-```markdown
-# Session handoff — <work summary>
-
-> Generated by pactile-handoff at <time> · Next-session purpose: <user argument>
-
-## Goal
-<what the in-flight work is trying to achieve>
-
-## Done
-- <items>
-
-## Not done / Blocked
-- <items>
-
-## Next steps
-1. <ordered steps>
-
-## Key whys (trimmed by next-session purpose)
-- <decision + reason; whys unrelated to this purpose can be omitted>
-
-## Facts vs unverified beliefs
-- Facts: <verified>
-- Beliefs (unverified): <assumptions — never write them as facts>
-
-## Pointers (reference paths only, never copy bodies)
-- Task: `.pactile/tasks/<task>/` (prd.md / design.md / implement.md / verify.md)
-- Context: `CONTEXT.md` · Research: `<task>/research/`
-- Prototype evidence (if a prototype was involved): `<task>/research/prototype-<slug>.py` (see `.pactile/spec/guides/prototype-guide.md` §9)
-- Other: ADR / issue / commit / diff paths or URLs
-
-## Suggested skills (for the continuing agent)
-- <skill name list, e.g. pactile-brainstorm, pactile-check, pactile-continue>
-```
-
-## Rules
-
-- **Reference, don't copy**: anything already on disk (spec / PRD / ADR / issue / commit / diff) gets a path or URL only, never pasted verbatim.
-- **Redact**: API keys, tokens, passwords, PII → replace with `<REDACTED>` before writing; when unsure, write `<REDACTED>`.
-- **Facts vs beliefs**: unverified assumptions must be marked, never written as verified facts — the continuing agent will treat the document as a contract and will not re-check.
-- **Prototype evidence pointer**: when the session involved a prototype, list the prototype evidence path in the pointers section and confirm the evidence is captured before cleanup.
-- **Delivery**: have the new agent **read the file path**; do not stuff the summary into shell quotes to launch the new agent (backticks / `$(...)` get swallowed and silently truncated).
-
-## Anti-patterns
-
-- ❌ Treating handoff as a long-lived document: it is a transit document for a single transfer and dies once the work lands (long-term facts belong in `AGENTS.md` / spec, not handoff)
-- ❌ Pasting large spec / PRD / diff bodies (should reference paths only)
-- ❌ Stuffing the summary into shell quotes to launch the next agent (silent truncation risk)
-- ❌ Not reporting the full path / not reminding about temp volatility
-- ❌ Writing a handoff for same-harness same-directory continuation (should compact / continue)
-- ❌ Writing keys / tokens into the document

package/dist/templates/cursor/fixtures/expected-rules.d.ts

@@ -1,14 +0,0 @@
-/**
- * Expected Cursor rules manifest for validate-rules hard gate.
- * Update alongside rule content changes in templates/cursor/rules/.
- */
-export interface ExpectedRule {
-    /** Filename including .mdc extension, e.g. "pactile-bootstrap.mdc" */
-    filename: string;
-    /** Substrings that must appear in rule body (case-sensitive) */
-    requiredSections: string[];
-    /** Minimum byte length of normalized rule content */
-    minBytes: number;
-}
-export declare const expectedRules: ExpectedRule[];
-//# sourceMappingURL=expected-rules.d.ts.map

package/dist/templates/cursor/fixtures/expected-rules.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"expected-rules.d.ts","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,aAAa,EAAE,YAAY,EAcvC,CAAC"}

package/dist/templates/cursor/fixtures/expected-rules.js

@@ -1,20 +0,0 @@
-/**
- * Expected Cursor rules manifest for validate-rules hard gate.
- * Update alongside rule content changes in templates/cursor/rules/.
- */
-export const expectedRules = [
-    {
-        filename: "pactile-bootstrap.mdc",
-        requiredSections: [
-            "Event Bridge",
-            "Capability router",
-            "external-knowledge",
-            "Optional",
-            "Native SSOT",
-            ".pactile/middleware",
-            "Next native action",
-        ],
-        minBytes: 400,
-    },
-];
-//# sourceMappingURL=expected-rules.js.map

package/dist/templates/cursor/fixtures/expected-rules.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"expected-rules.js","sourceRoot":"","sources":["../../../../src/templates/cursor/fixtures/expected-rules.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C;QACE,QAAQ,EAAE,uBAAuB;QACjC,gBAAgB,EAAE;YAChB,cAAc;YACd,mBAAmB;YACnB,oBAAoB;YACpB,UAAU;YACV,aAAa;YACb,qBAAqB;YACrB,oBAAoB;SACrB;QACD,QAAQ,EAAE,GAAG;KACd;CACF,CAAC"}

package/dist/templates/cursor/hooks.json

@@ -1,52 +0,0 @@
-{
-  "version": 1,
-  "hooks": {
-    "preToolUse": [
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/inject-subagent-context.py",
-        "matcher": "Task|Subagent",
-        "timeout": 30
-      },
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/spec-write-audit.py",
-        "matcher": "Write|Edit|NotebookEdit|ApplyDiff|MultipleDiff",
-        "timeout": 5
-      }
-    ],
-    "sessionStart": [
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/event-bridge.py --event sessionStart",
-        "timeout": 30
-      },
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/session-start.py",
-        "timeout": 30
-      }
-    ],
-    "beforeSubmitPrompt": [
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/inject-retrieval-plan.py",
-        "timeout": 15
-      }
-    ],
-    "beforeShellExecution": [
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/inject-shell-session-context.py",
-        "timeout": 5
-      }
-    ],
-    "afterShellExecution": [
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/rename-session-for-task.py",
-        "matcher": "task\\.py.*(select|start-execution)",
-        "timeout": 5
-      }
-    ],
-    "stop": [
-      {
-        "command": "{{PYTHON_CMD}} .cursor/hooks/research-end-retrieval-pack.py",
-        "timeout": 60
-      }
-    ]
-  }
-}

package/dist/templates/cursor/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Cursor templates
- *
- * Directory structure:
- *   cursor/
- *   ├── agents/        # Sub-agent definitions
- *   ├── commands/      # Cursor-only slash commands (optional extras)
- *   ├── rules/         # .cursor/rules/*.mdc (alwaysApply / glob-scoped rules)
- *   ├── hooks.json     # Hooks configuration
- *   └── worktrees.json # Cursor native worktree setup
- */
-import { type AgentTemplate } from "../template-utils.js";
-export type { AgentTemplate };
-export declare const getAllAgents: () => AgentTemplate[];
-export declare const getAllRules: () => AgentTemplate[];
-export declare const getCursorCommands: () => AgentTemplate[];
-export declare const getHooksConfig: () => string;
-export declare const getWorktreesConfig: () => string;
-//# sourceMappingURL=index.d.ts.map

package/dist/templates/cursor/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAChF,YAAY,EAAE,aAAa,EAAE,CAAC;AAI9B,eAAO,MAAM,YAAY,QAAO,aAAa,EAAoB,CAAC;AAClE,eAAO,MAAM,WAAW,QAAO,aAAa,EAAoB,CAAC;AACjE,eAAO,MAAM,iBAAiB,QAAO,aAAa,EAAgC,CAAC;AACnF,eAAO,MAAM,cAAc,QAAO,MAAiC,CAAC;AACpE,eAAO,MAAM,kBAAkB,QAAO,MAAqC,CAAC"}

package/dist/templates/cursor/index.js

@@ -1,19 +0,0 @@
-/**
- * Cursor templates
- *
- * Directory structure:
- *   cursor/
- *   ├── agents/        # Sub-agent definitions
- *   ├── commands/      # Cursor-only slash commands (optional extras)
- *   ├── rules/         # .cursor/rules/*.mdc (alwaysApply / glob-scoped rules)
- *   ├── hooks.json     # Hooks configuration
- *   └── worktrees.json # Cursor native worktree setup
- */
-import { createTemplateReader } from "../template-utils.js";
-const { listMdAgents, listMdcRules, listMdCommands, getConfig } = createTemplateReader(import.meta.url);
-export const getAllAgents = () => listMdAgents();
-export const getAllRules = () => listMdcRules();
-export const getCursorCommands = () => listMdCommands("commands");
-export const getHooksConfig = () => getConfig("hooks.json");
-export const getWorktreesConfig = () => getConfig("worktrees.json");
-//# sourceMappingURL=index.js.map

package/dist/templates/cursor/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,oBAAoB,EAAsB,MAAM,sBAAsB,CAAC;AAGhF,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAExG,MAAM,CAAC,MAAM,YAAY,GAAG,GAAoB,EAAE,CAAC,YAAY,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG,GAAoB,EAAE,CAAC,YAAY,EAAE,CAAC;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAoB,EAAE,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/templates/cursor/rules/pactile-bootstrap.mdc

@@ -1,18 +0,0 @@
----
-description: "Cursor Adapter Bootstrap — Event Bridge pointer, four retrieval intents, independent Middleware. Prefer this thin rule over adding more always-on."
-alwaysApply: true
----
-
-# Cursor Adapter Bootstrap
-
-This is the **single thin Bootstrap** for Cursor. It points; it does not carry full Triage, Gate, smart-search, or codegraph methodology.
-
-- **Event Bridge:** Cursor hook events (`sessionStart` and others) record/dispatch through Kernel `event_bridge` extras. Unsubscribed modules must not fail the hook.
-- **Capability router:** Baseline intents are only `exact` / `semantic` / `structural` / `external`. Do not bind Agent tool names here.
-- **external-knowledge:** smart-search is an independent Middleware Provider. Probe readiness. Missing → Profile `degraded`. Tasks that do not need the capability may Close. Platform Web is a downgrade, not an equivalent.
-- **Optional code intelligence:** codegraph and fast-context stay Optional. Do not treat them as default always-on or forced install.
-- **Native SSOT:** use supported host APIs and declared Adapter facts; do not install patched-client control planes.
-- **User overlay:** project `.pactile/middleware/` Manifests. `pactile init` / `pactile update` never write, delete, or hash that directory. Protocol: `.pactile/framework/middleware-protocol.md`. Shipped optional MCP providers are not force-installed at init.
-- **Next native action:** With a selected task, do the host surface in `.pactile/framework/cursor-native-modes-guide.md`. Do not ask the user to type `python`.
-
-This is the only default always-on rule. Do **not** add middleware-specific always-on. Methodology lives in `.pactile/workflow.md` (human overview, not runtime SSOT) and on-demand docs.

package/dist/templates/cursor/worktrees.json

@@ -1,11 +0,0 @@
-{
-  "setup-worktree": [
-    "npm install"
-  ],
-  "setup-worktree-windows": [
-    "npm install"
-  ],
-  "setup-worktree-unix": [
-    "npm install"
-  ]
-}

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

@@ -1,85 +0,0 @@
-# Cursor Context Injection Guide
-
-> **Purpose**: Know which Cursor injection channels actually reach the model, and route Pactile content accordingly. Most "agent ignored my instructions" failures on Cursor are channel-routing bugs, not wording problems.
-
----
-
-## The channel matrix (verified 2026-08-05, Cursor Native 3.8.x)
-
-Cursor has **several** channels that can put text in front of the model. They are **not** equally reliable:
-
-| Channel | How it loads | Reliable on Cursor? | Pactile content here |
-|---|---|---|---|
-| `.cursor/rules/*.mdc` (`alwaysApply: true`) | Prepended before **every** prompt, independent path | ✅ **Yes** | Thin `pactile-bootstrap.mdc` adapter pointer plus any project-specific hard constraints; the former `pactile-triage.mdc` no longer exists |
-| `AGENTS.md` (repo root + nested) | Read automatically, treated as an always-on rule | ✅ **Yes** | Compact PACTILE pointers to the framework index, workflow interface card, and project docs (the `<!-- PACTILE:START -->` block) |
-| `sessionStart` hook → `additional_context` | Once per session; delivered via `hooks_context` | ✅ **Yes** (fixed — verified 2026-08-05; was #158452) | Context-progressive Session pack and first-reply notice |
-| `beforeSubmitPrompt` hook → `additional_context` | Per user message; router would emit `## 代码库检索计划` | ❌ **No (telemetry-only since 2026-06-24)** | `inject-retrieval-plan.py` logs to `.pactile/.runtime/retrieval-plan-events.log`; **no injection** |
-| `.pactile/workflow.md` (read on demand) | Only if the agent explicitly reads the file | ⚠️ Depends on agent taking action | Human interface card, artifact / Kernel pointers, and `workflow-state` accounting facts; **not runtime SSOT** |
-| **`task.py generate-dispatch-prompt` → Task `prompt`** (CLI Layer 2) | Main session runs Pactile script before `Task(...)` | ✅ **Yes (primary for subagent task context on Cursor)** | Full embed: marker, `Selected task:`, prd/jsonl/spec bodies (budgeted — see [injection-budget-guide](./injection-budget-guide.md)) |
-
-**Key takeaway**: anything that must reach the model **every turn** must live in `.cursor/rules` or `AGENTS.md`. `sessionStart` is reliable for the **session-level** context-progressive pack but fires only once. Retrieval plans: use the capability router or run `route_codebase_retrieval.py --instructions` on demand — do **not** rely on `beforeSubmitPrompt` injection. Subagent task context uses **CLI Layer 2** before Task dispatch.
-
-**Intake is not a per-turn print ritual**: request routing belongs to the baseline `intake-basic` module. It has no `[Triage:]` line, and a derived summary may stay internal; never require the agent to print one every turn.
-
----
-
-## The sessionStart bug (#158452) — history and current status
-
-- **Bug**: Cursor forum #158452 — `sessionStart` hook `additional_context` was executed and JSON-parsed correctly, but the value was **not added to the agent's initial system context** (through ~2026-06).
-- **Status (2026-08-05)**: **Fixed** on Cursor Native 3.8.x — first-reply-notice probe passes; `hooks_context` contains full SessionStart payload. Re-verify after major Cursor upgrades.
-- **Historical scope**: Also affected `postToolUse` `additional_context` on some builds. The `env` field of the same hook uses a separate storage path.
-- **Routing implication**: Even with sessionStart working, a genuine per-turn adapter policy belongs in `.cursor/rules` or `AGENTS.md` because sessionStart fires only once. Intake is instead the `intake-basic` baseline module and must not print a `[Triage:]` line.
-
-### How to diagnose "is sessionStart injection actually reaching the model?"
-
-1. **First-reply-notice test**: put a `<first-reply-notice>` in the sessionStart payload asking the agent to say a specific phrase on its first reply. If the agent doesn't say it → injection failed.
-2. **Side-channel trace**: write a line to a logfile at the top of the hook's `main()`. If the line appears → hook executed. Combined with the first-reply test failing → confirms the "hook ran but content discarded" pattern.
-3. **Marker probe**: inject a unique marker string (`CURSOR_HOOK_REPRO_MARKER_...`) into `additional_context`, then ask the agent if it sees the marker.
-
----
-
-## Pactile routing rules on Cursor
-
-Pactile routes content by reliability on Cursor:
-
-| Pactile content | Where it lives | Why |
-|---|---|---|
-| **Intake orientation** (silent request routing; do **not** print a `[Triage:]` line) | Baseline `intake-basic` module in the Session pack | No dedicated triage rule; `pactile-triage.mdc` no longer exists |
-| **Codebase retrieval capability routing** | Thin `.cursor/rules/pactile-bootstrap.mdc` pointer + `retrieval-daily-guide.md` / router CLI on demand | `beforeSubmitPrompt` injection is telemetry-only; provider detail stays out of always-on rules |
-| **Prefer Cursor native modes** (Plan/Ask/Debug/Agent/Multitask × Pactile) | `.cursor/rules/pactile-bootstrap.mdc` pointer + `cursor-native-modes-guide.md` | The thin adapter points to the on-demand guide |
-| **Framework entry pointers** | `AGENTS.md` (PACTILE block) | Reliable always-on pointers to the framework index, workflow interface card, and project docs |
-| **Session orientation** (context-progressive pack, first-reply notice) | `sessionStart` hook → `additional_context` | Reliable on Cursor 3.8.x+; session-level only |
-| **Workflow interface card and `workflow-state` accounting facts** | `.pactile/workflow.md` | Human overview and pointers only; runtime facts come from Kernel / `task.json` projections and the Session pack |
-
-**If a new "must-always-be-visible" rule is added to Pactile**: keep it thin and ship it as a `.cursor/rules/*.mdc` (Cursor) — do **not** rely on `workflow.md` or sessionStart alone for per-turn enforcement, and do not restore a triage rule or `[Triage:]` ritual. Run `injection_budget_probe.py` after adding rules (see [injection-budget-guide](./injection-budget-guide.md)).
-
----
-
-## Injection budget (P0)
-
-Per-channel caps and jsonl/Layer 2 limits are defined in **[injection-budget-guide](./injection-budget-guide.md)**. Summary from channel matrix (2026-08-06):
-
-- **Per-turn:** C01 Rules + C02 AGENTS only (not C04).
-- **Session once:** C03 context-progressive Session pack.
-- **Subagent:** C06 Layer 2 with role `max_chars` + jsonl entry/file/total caps.
-- **Retrieval:** C16 Rules + router CLI on demand.
-
-Probe: `python ./.pactile/scripts/injection_budget_probe.py --repo-root .`
-
----
-
-## When to update this guide
-
-- Cursor major upgrade → re-run sessionStart first-reply-notice probe and update the matrix date.
-- `beforeSubmitPrompt.additional_context` becomes reliable on a future build → re-enable injection in `inject-retrieval-plan.py` and update this guide.
-- Pactile adds a new `.cursor/rules/*.mdc` → add a row to the routing table.
-
----
-
-## Related
-
-- `cursor-subagent-policy.md` — Task tool scenes, model routing (this guide is about **context injection**, that one is about **subagent dispatch**).
-- `cursor-native-modes-guide.md` — Prefer Plan/Ask/Debug/Agent/Multitask; reached from the thin `pactile-bootstrap.mdc` pointer.
-- `.pactile/workflow.md` — human interface card and `workflow-state` accounting facts; not runtime SSOT.
-- Task `06-19-cursor-rules-triage` (archive) — the investigation that produced this guide.
-- Cursor forum thread: https://forum.cursor.com/t/sessionstart-hook-additional-context-is-never-injected-into-agents-initial-system-context/158452