@blxzer/pactile 0.5.0

package/dist/templates/cursor/hooks.json

@@ -0,0 +1,52 @@
+{
+  "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

@@ -0,0 +1,19 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,19 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,18 @@
+---
+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

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

package/dist/templates/extract.d.ts

@@ -0,0 +1,38 @@
+type TemplateCategory = "scripts" | "markdown" | "commands";
+/**
+ * Get the path to the pactile templates directory (.pactile/ scaffolding).
+ */
+export declare function getPactileTemplatePath(): string;
+/** @deprecated Use getPactileTemplatePath() instead. */
+export declare function getPactileSourcePath(): string;
+/**
+ * Read a file from the pactile template directory.
+ */
+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`)
+ * must not be copied, hashed, or written into the user tree.
+ */
+export declare function isUserShippedModuleFile(relativePosix: string): boolean;
+/**
+ * Walk `templates/pactile/modules/` and return the user-shipped subset.
+ * Keys are POSIX paths relative to `modules/` (`index.json`, `<id>/contract.md`).
+ * Shared by init (`createWorkflowStructure`) and update (`collectTemplateFiles`).
+ */
+export declare function collectUserModuleTemplates(): Map<string, string>;
+export {};
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +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"}

package/dist/templates/extract.js

@@ -0,0 +1,120 @@
+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);
+/**
+ * Get the path to the pactile templates directory (.pactile/ scaffolding).
+ */
+export function getPactileTemplatePath() {
+    const templatePath = path.join(__dirname, "pactile");
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error("Could not find pactile templates directory. Expected at templates/pactile/");
+}
+/** @deprecated Use getPactileTemplatePath() instead. */
+export function getPactileSourcePath() {
+    return getPactileTemplatePath();
+}
+/**
+ * Read a file from the pactile template directory.
+ */
+export function readPactileFile(relativePath) {
+    const pactilePath = getPactileSourcePath();
+    const filePath = path.join(pactilePath, relativePath);
+    return fs.readFileSync(filePath, "utf-8");
+}
+/**
+ * Read template content from a category directory.
+ */
+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";
+/**
+ * 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`)
+ * must not be copied, hashed, or written into the user tree.
+ */
+export function isUserShippedModuleFile(relativePosix) {
+    const normalized = relativePosix.replace(/\\/g, "/");
+    if (normalized.endsWith(".ts")) {
+        return false;
+    }
+    if (normalized === USER_MODULE_INDEX) {
+        return true;
+    }
+    const parts = normalized.split("/");
+    return (parts.length === 2 &&
+        parts[0].length > 0 &&
+        parts[1] === USER_MODULE_CONTRACT);
+}
+function walkUserModuleFiles(absDir, relDir, out) {
+    if (!fs.existsSync(absDir)) {
+        return;
+    }
+    for (const entry of fs.readdirSync(absDir, { withFileTypes: true })) {
+        const rel = relDir ? `${relDir}/${entry.name}` : entry.name;
+        const abs = path.join(absDir, entry.name);
+        if (entry.isDirectory()) {
+            walkUserModuleFiles(abs, rel, out);
+            continue;
+        }
+        if (!isUserShippedModuleFile(rel)) {
+            continue;
+        }
+        out.set(rel, fs.readFileSync(abs, "utf-8"));
+    }
+}
+/**
+ * Walk `templates/pactile/modules/` and return the user-shipped subset.
+ * Keys are POSIX paths relative to `modules/` (`index.json`, `<id>/contract.md`).
+ * Shared by init (`createWorkflowStructure`) and update (`collectTemplateFiles`).
+ */
+export function collectUserModuleTemplates() {
+    const modulesRoot = path.join(getPactileTemplatePath(), "modules");
+    const files = new Map();
+    walkUserModuleFiles(modulesRoot, "", files);
+    return files;
+}
+//# sourceMappingURL=extract.js.map

package/dist/templates/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/templates/extract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE1E,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAI3C;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,oBAAoB;IAClC,OAAO,sBAAsB,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACtD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA0B,EAC1B,QAAgB;IAEhB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC9D,OAAO,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,OAAO,eAAe,CAAC,WAAW,YAAY,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,eAAuB,EACvB,QAAgB,EAChB,OAAkC;IAElC,MAAM,WAAW,GAAG,oBAAoB,EAAE,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACxD,MAAM,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,GAAW,EACX,IAAY,EACZ,OAAkC;IAElC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhB,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAElC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,gBAAgB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,YAAY,GAChB,OAAO,EAAE,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAC1E,MAAM,SAAS,CAAC,QAAQ,EAAE,4BAA4B,CAAC,OAAO,CAAC,EAAE;gBAC/D,UAAU,EAAE,YAAY;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,iBAAiB,GAAG,YAAY,CAAC;AACvC,MAAM,oBAAoB,GAAG,aAAa,CAAC;AAE3C;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,aAAqB;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACrD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,OAAO,CACL,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC;QACnB,KAAK,CAAC,CAAC,CAAC,KAAK,oBAAoB,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAAc,EACd,MAAc,EACd,GAAwB;IAExB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,mBAAmB,CAAC,WAAW,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/templates/markdown/agents.md

@@ -0,0 +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 -->

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

@@ -0,0 +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.

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

@@ -0,0 +1,85 @@
+# 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