greprag 5.6.2 → 5.8.1

package/dist/commands/lore.d.ts

@@ -0,0 +1,28 @@
+/** greprag lore — per-project LEARNINGS substrate.
+ *
+ *  Lore = what was learned (Old English `lār`). Project-specific emergent
+ *  knowledge — discovered constraints, gotchas, tribal knowledge that drifts
+ *  as the codebase evolves. Reviewed via /lore-advisor. Distinct from static
+ *  project knowledge (which lives in CLAUDE.md / docs / code structure).
+ *
+ *  Pull-based: agents seed lore they wish a future spawned chip had known;
+ *  future chips query the relevant scope at spawn time and skip the
+ *  discovery they would otherwise repeat. All server work delegates to
+ *  FactsService in @greprag/core via /v1/facts/:projectId — the CLI is a
+ *  thin HTTP printer + project resolver.
+ *
+ *  Note: the server-side route + DB column stay named `facts` (internal —
+ *  surface-only rename in v5.7.0). The CLI maps `lore` commands to `facts` URLs.
+ *
+ *  Subcommands:
+ *    add "<text>" --scope <S> [--project <name>] [--source-session <id>]
+ *    query [--scope <S>] [--query "<intent>"] [--project <name>]
+ *          [--limit <N=10>] [--format markdown|json]
+ *    list  [--project <name>] [--format markdown|json]
+ *    delete <nodeId> [--project <name>]
+ *    scopes [--project <name>]
+ *
+ *  Project resolution: without --project, uses the current cwd's project
+ *  anchor (readAnchor). With --project <name>, hits /v1/projects to
+ *  resolve name → projectId (case-insensitive). */
+export declare function runLore(args: string[]): Promise<void>;

package/dist/commands/lore.js

@@ -0,0 +1,357 @@
+"use strict";
+// adr: adr/lore-rename.md
+/** greprag lore — per-project LEARNINGS substrate.
+ *
+ *  Lore = what was learned (Old English `lār`). Project-specific emergent
+ *  knowledge — discovered constraints, gotchas, tribal knowledge that drifts
+ *  as the codebase evolves. Reviewed via /lore-advisor. Distinct from static
+ *  project knowledge (which lives in CLAUDE.md / docs / code structure).
+ *
+ *  Pull-based: agents seed lore they wish a future spawned chip had known;
+ *  future chips query the relevant scope at spawn time and skip the
+ *  discovery they would otherwise repeat. All server work delegates to
+ *  FactsService in @greprag/core via /v1/facts/:projectId — the CLI is a
+ *  thin HTTP printer + project resolver.
+ *
+ *  Note: the server-side route + DB column stay named `facts` (internal —
+ *  surface-only rename in v5.7.0). The CLI maps `lore` commands to `facts` URLs.
+ *
+ *  Subcommands:
+ *    add "<text>" --scope <S> [--project <name>] [--source-session <id>]
+ *    query [--scope <S>] [--query "<intent>"] [--project <name>]
+ *          [--limit <N=10>] [--format markdown|json]
+ *    list  [--project <name>] [--format markdown|json]
+ *    delete <nodeId> [--project <name>]
+ *    scopes [--project <name>]
+ *
+ *  Project resolution: without --project, uses the current cwd's project
+ *  anchor (readAnchor). With --project <name>, hits /v1/projects to
+ *  resolve name → projectId (case-insensitive). */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLore = runLore;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const project_anchor_1 = require("../project-anchor");
+const API_URL_DEFAULT = 'https://api.greprag.com';
+// ---------- Config / env (mirrors corpus.ts) ------------------------------
+function loadEnvFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        for (const line of content.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            const eqIdx = trimmed.indexOf('=');
+            if (eqIdx < 1)
+                continue;
+            const key = trimmed.slice(0, eqIdx).trim();
+            let value = trimmed.slice(eqIdx + 1).trim();
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (!process.env[key])
+                process.env[key] = value;
+        }
+    }
+    catch { /* file missing — fine */ }
+}
+function getConfig() {
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    if (homeDir)
+        loadEnvFile(path.join(homeDir, '.greprag', '.env'));
+    if (!process.env.GREPRAG_API_KEY)
+        loadEnvFile(path.join(process.cwd(), '.env'));
+    return {
+        apiUrl: process.env.GREPRAG_API_URL || API_URL_DEFAULT,
+        apiKey: process.env.GREPRAG_API_KEY || '',
+    };
+}
+async function apiCall(url, apiKey, body) {
+    const res = await fetch(url, {
+        method: 'POST',
+        headers: { 'Authorization': `Bearer ${apiKey}`, 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+async function apiGet(url, apiKey) {
+    const res = await fetch(url, { headers: { 'Authorization': `Bearer ${apiKey}` } });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+async function apiDelete(url, apiKey) {
+    const res = await fetch(url, {
+        method: 'DELETE',
+        headers: { 'Authorization': `Bearer ${apiKey}` },
+    });
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${await res.text()}`);
+    return res.json();
+}
+// ---------- Helpers --------------------------------------------------------
+function getFlag(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx === -1 || idx + 1 >= args.length)
+        return undefined;
+    return args[idx + 1];
+}
+function abortNotConfigured() {
+    console.error('Not configured. Run: greprag init');
+    process.exit(1);
+}
+/** Resolve which project a lore command operates on. --project <name> wins
+ *  via the tenant's projects registry; otherwise the cwd's anchor decides. */
+async function resolveProject(args, apiUrl, apiKey) {
+    const projectArg = getFlag(args, '--project');
+    if (!projectArg) {
+        const anchor = (0, project_anchor_1.readAnchor)(process.cwd());
+        return { projectId: anchor.projectId, projectName: anchor.projectName };
+    }
+    const r = await apiGet(`${apiUrl}/v1/projects`, apiKey);
+    const needle = projectArg.trim().toLowerCase();
+    const match = (r.projects || []).find(p => p.project_name.toLowerCase() === needle);
+    if (!match) {
+        throw new Error(`project "${projectArg}" not found under this tenant. ` +
+            `Register it via 'greprag init' in that directory, then retry.`);
+    }
+    return { projectId: match.project_id, projectName: match.project_name };
+}
+/** Try to read the current session's UUID from the harness env (Claude Code
+ *  exposes it as CLAUDE_SESSION_ID on hook invocations). Falls back to
+ *  undefined — callers should pass --source-session explicitly when they
+ *  know it. */
+function readSessionEnv() {
+    return process.env.CLAUDE_SESSION_ID || process.env.GREPRAG_SESSION_ID || null;
+}
+// ---------- add -----------------------------------------------------------
+async function addCmd(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey)
+        abortNotConfigured();
+    const text = args[0];
+    if (!text || text.startsWith('--')) {
+        console.error('Usage: greprag lore add "<text>" --scope <scope> [--project <name>] [--source-session <id>]');
+        process.exit(1);
+    }
+    const scope = getFlag(args, '--scope');
+    if (!scope) {
+        console.error('Usage: greprag lore add "<text>" --scope <scope> [--project <name>]');
+        process.exit(1);
+    }
+    const sourceSession = getFlag(args, '--source-session') || readSessionEnv();
+    const { projectId, projectName } = await resolveProject(args, cfg.apiUrl, cfg.apiKey);
+    const result = await apiCall(`${cfg.apiUrl}/v1/facts/${projectId}`, cfg.apiKey, {
+        text, scope,
+        sourceSessionId: sourceSession,
+        projectName,
+    });
+    if (!result.ok || !result.nodeId)
+        throw new Error(result.error || 'add failed');
+    console.log(`Added lore [${result.nodeId}] scope=${scope} project=${projectName}`);
+}
+// ---------- query ---------------------------------------------------------
+async function queryCmd(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey)
+        abortNotConfigured();
+    const scope = getFlag(args, '--scope');
+    const queryStr = getFlag(args, '--query');
+    const limit = parseInt(getFlag(args, '--limit') || '10', 10);
+    const format = (getFlag(args, '--format') || 'markdown').toLowerCase();
+    if (format !== 'markdown' && format !== 'json') {
+        console.error('--format must be markdown or json');
+        process.exit(1);
+    }
+    const { projectId, projectName } = await resolveProject(args, cfg.apiUrl, cfg.apiKey);
+    const params = new URLSearchParams();
+    if (scope)
+        params.set('scope', scope);
+    if (queryStr)
+        params.set('query', queryStr);
+    params.set('limit', String(limit));
+    const result = await apiGet(`${cfg.apiUrl}/v1/facts/${projectId}?${params.toString()}`, cfg.apiKey);
+    if (!result.ok || !result.facts)
+        throw new Error(result.error || 'query failed');
+    if (format === 'json') {
+        console.log(JSON.stringify({
+            project: projectName,
+            scope: scope ?? null,
+            query: queryStr ?? null,
+            lore: result.facts,
+        }, null, 2));
+        return;
+    }
+    if (result.facts.length === 0) {
+        const scopeNote = scope ? ` (scope=${scope})` : '';
+        const queryNote = queryStr ? ` matching "${queryStr}"` : '';
+        console.log(`No lore in ${projectName}${scopeNote}${queryNote}.`);
+        return;
+    }
+    for (let i = 0; i < result.facts.length; i++) {
+        console.log(`${i + 1}. ${result.facts[i].text}`);
+    }
+}
+// ---------- list ----------------------------------------------------------
+async function listCmd(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey)
+        abortNotConfigured();
+    const format = (getFlag(args, '--format') || 'text').toLowerCase();
+    if (format !== 'text' && format !== 'json' && format !== 'markdown') {
+        console.error('--format must be text, markdown, or json');
+        process.exit(1);
+    }
+    const { projectId, projectName } = await resolveProject(args, cfg.apiUrl, cfg.apiKey);
+    const result = await apiGet(`${cfg.apiUrl}/v1/facts/${projectId}/list`, cfg.apiKey);
+    if (!result.ok || !result.facts)
+        throw new Error(result.error || 'list failed');
+    if (format === 'json') {
+        console.log(JSON.stringify({
+            project: projectName,
+            lore: result.facts,
+        }, null, 2));
+        return;
+    }
+    if (result.facts.length === 0) {
+        console.log(`No lore seeded in ${projectName} yet.`);
+        console.log('Add some: greprag lore add "<text>" --scope <scope>');
+        return;
+    }
+    // Group by scope (server already orders scope ASC, createdAt DESC).
+    const grouped = new Map();
+    for (const f of result.facts) {
+        const scope = f.scope || '(no scope)';
+        if (!grouped.has(scope))
+            grouped.set(scope, []);
+        grouped.get(scope).push(f);
+    }
+    console.log(`\n${result.facts.length} lore entr${result.facts.length === 1 ? 'y' : 'ies'} in ${projectName}:\n`);
+    for (const [scope, rows] of grouped) {
+        console.log(`## ${scope}  (${rows.length})`);
+        for (const f of rows) {
+            const date = f.createdAt ? f.createdAt.slice(0, 10) : '';
+            console.log(`  [${f.nodeId}] ${date}  ${f.text}`);
+        }
+        console.log('');
+    }
+}
+// ---------- delete --------------------------------------------------------
+async function deleteCmd(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey)
+        abortNotConfigured();
+    const nodeId = args[0];
+    if (!nodeId || nodeId.startsWith('--')) {
+        console.error('Usage: greprag lore delete <nodeId> [--project <name>]');
+        process.exit(1);
+    }
+    if (!/^[0-9a-f]{8}$/i.test(nodeId)) {
+        console.error('nodeId must be 8 hex chars (printed in `greprag lore list`).');
+        process.exit(1);
+    }
+    const { projectId, projectName } = await resolveProject(args, cfg.apiUrl, cfg.apiKey);
+    const result = await apiDelete(`${cfg.apiUrl}/v1/facts/${projectId}/${nodeId}`, cfg.apiKey);
+    if (!result.ok)
+        throw new Error(result.error || 'delete failed');
+    console.log(`Deleted lore [${nodeId}] from ${projectName}`);
+}
+// ---------- scopes --------------------------------------------------------
+async function scopesCmd(args) {
+    const cfg = getConfig();
+    if (!cfg.apiKey)
+        abortNotConfigured();
+    const { projectId, projectName } = await resolveProject(args, cfg.apiUrl, cfg.apiKey);
+    const result = await apiGet(`${cfg.apiUrl}/v1/facts/${projectId}/scopes`, cfg.apiKey);
+    if (!result.ok || !result.scopes)
+        throw new Error(result.error || 'scopes failed');
+    if (result.scopes.length === 0) {
+        console.log(`No scopes in ${projectName} yet.`);
+        return;
+    }
+    for (const s of result.scopes)
+        console.log(s);
+}
+// ---------- Dispatch ------------------------------------------------------
+const SUB_HELP = `
+greprag lore — per-project LEARNINGS substrate.
+
+Subcommands:
+  add "<text>" --scope <S> [--project <name>] [--source-session <id>]
+                                Append a new lore entry under the given scope.
+  query [--scope <S>] [--query "<intent>"] [--project <name>]
+        [--limit N=10] [--format markdown|json]
+                                Read lore. With --query, lexical-rank by
+                                relevance. Without, most recent first.
+  list  [--project <name>] [--format markdown|json]
+                                Every lore entry grouped by scope (for review).
+  delete <nodeId> [--project <name>]
+                                Drop one lore entry by its 8-char nodeId.
+  scopes [--project <name>]     Distinct scope labels present in this project.
+
+Examples:
+  greprag lore add "Migrations live at repo root, not packages/api/migrations." --scope chip-startup
+  greprag lore query --scope chip-startup --limit 10 --format markdown
+  greprag lore query --query "where do migrations live" --limit 5
+  greprag lore list
+  greprag lore delete a3f2c1d4
+  greprag lore scopes
+`.trim();
+async function runLore(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+    switch (sub) {
+        case 'add': return addCmd(rest);
+        case 'query': return queryCmd(rest);
+        case 'list': return listCmd(rest);
+        case 'delete': return deleteCmd(rest);
+        case 'scopes': return scopesCmd(rest);
+        case undefined:
+        case 'help':
+        case '--help':
+        case '-h':
+            console.log(SUB_HELP);
+            return;
+        default:
+            console.error(`Unknown subcommand: ${sub}\n`);
+            console.log(SUB_HELP);
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=lore.js.map

package/dist/commands/lore.js.map

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

package/dist/hook.d.ts

@@ -5,4 +5,20 @@
  * /v1/memory/turn. No LLM, no enrichment — the API just inserts the row.
  * See C:/greprag/docs/episodic-memory.md.
  */
-export {};
+/** Derive a chip slug from the title. Strip the `Chip: ` prefix, lowercase,
+ *  replace non-alphanumeric runs with `-`, trim leading/trailing dashes.
+ *  `Chip: Fix synthesis loop` → `fix-synthesis-loop`. */
+export declare function deriveSlugFromTitle(title: string): string;
+/** Returns true when the prompt is "new-style" — neither Block 1 nor Block 2
+ *  evidence is present, so the hook should auto-inject both. Old-style
+ *  prompts (anything containing `git worktree add` or `greprag send`) pass
+ *  through unchanged for back-compat. */
+export declare function isNewStylePrompt(prompt: string): boolean;
+/** Augment a new-style prompt: prepend Block 1, append Block 2.
+ *  Returns the same prompt when slug derivation produces an empty string
+ *  (e.g. title is just `Chip: ` with no verb phrase) — validation then
+ *  rejects with a clean "missing worktree" message. */
+export declare function augmentPrompt(title: string, prompt: string): string;
+/** Substitute Tier 1 placeholders in the prompt. Best-effort: missing
+ *  values leave the placeholder in for loud chip-runtime failure. */
+export declare function substitutePlaceholders(prompt: string, sessionId: string | undefined, alias: string | null): string;

package/dist/hook.js

@@ -40,6 +40,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveSlugFromTitle = deriveSlugFromTitle;
+exports.isNewStylePrompt = isNewStylePrompt;
+exports.augmentPrompt = augmentPrompt;
+exports.substitutePlaceholders = substitutePlaceholders;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const crypto = __importStar(require("crypto"));
@@ -1010,11 +1014,104 @@ async function notify(_input) {
     // Intentional no-op. See docstring above.
     return;
 }
-function handlePreSpawnCheck(input) {
-    if (input.tool_name !== 'mcp__ccd_session__spawn_task')
-        return;
-    const title = input.tool_input?.title ?? '';
-    const prompt = input.tool_input?.prompt ?? '';
+/** Derive a chip slug from the title. Strip the `Chip: ` prefix, lowercase,
+ *  replace non-alphanumeric runs with `-`, trim leading/trailing dashes.
+ *  `Chip: Fix synthesis loop` → `fix-synthesis-loop`. */
+function deriveSlugFromTitle(title) {
+    return title
+        .replace(/^Chip:\s*/, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/** Read the cached identity handle. Returns the alias part (before `@`) so
+ *  it can be substituted in `<handle>@greprag.com/<id>` templates without
+ *  doubling the domain. Returns null on any read/parse error — caller leaves
+ *  the placeholder in for loud runtime failure. */
+function readIdentityAlias() {
+    try {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        if (!home)
+            return null;
+        const cachePath = path.join(home, '.greprag', 'identity.json');
+        const raw = fs.readFileSync(cachePath, 'utf-8');
+        const data = JSON.parse(raw);
+        if (typeof data?.handle !== 'string' || !data.handle)
+            return null;
+        const at = data.handle.indexOf('@');
+        return at > 0 ? data.handle.slice(0, at) : data.handle;
+    }
+    catch {
+        return null;
+    }
+}
+/** Build Block 1 (escape-to-root + worktree-add + parent-session-id ref).
+ *  Uses literal `<parent-session-id>` so Tier 1 substitution can replace it
+ *  later in a single uniform pass. */
+function buildBlock1(slug) {
+    return ('**Setup — do this FIRST:**\n' +
+        '\n' +
+        '```bash\n' +
+        'main_root=$(git rev-parse --git-common-dir | xargs dirname)\n' +
+        'cd "$main_root"\n' +
+        `git worktree add .claude/worktrees/${slug} -b chip/${slug}\n` +
+        `cd .claude/worktrees/${slug}\n` +
+        '```\n' +
+        '\n' +
+        'Your parent\'s session id is `<parent-session-id>`.\n' +
+        '\n' +
+        '---\n');
+}
+/** Build Block 2 (greprag send report-back + cleanup discipline).
+ *  Uses literal `<handle>` and `<parent-session-id>` for Tier 1 substitution. */
+function buildBlock2(slug) {
+    return ('---\n' +
+        '\n' +
+        '**Block 2 — Report back via greprag inbox:**\n' +
+        '\n' +
+        '```bash\n' +
+        `greprag send "<status>: <commit hash> on chip/${slug} — <one-line>" \\\n` +
+        '  --to <handle>@greprag.com/<parent-session-id> \\\n' +
+        '  --from-session <own-session-id> \\\n' +
+        '  --artifact commit:<hash>\n' +
+        '```\n' +
+        '\n' +
+        'Substitute `<own-session-id>` from your SessionStart hook output.\n' +
+        '\n' +
+        '**Cleanup discipline (HARD RULE):** chip prompts forbid `git clean`, ' +
+        '`git reset --hard`, `git worktree remove`, `git checkout <other>`, ' +
+        'raw `rm -rf` outside the worktree\'s tracked files.\n');
+}
+/** Returns true when the prompt is "new-style" — neither Block 1 nor Block 2
+ *  evidence is present, so the hook should auto-inject both. Old-style
+ *  prompts (anything containing `git worktree add` or `greprag send`) pass
+ *  through unchanged for back-compat. */
+function isNewStylePrompt(prompt) {
+    return !/\bgit\s+worktree\s+add\b/.test(prompt) &&
+        !/\bgreprag\s+send\b/.test(prompt);
+}
+/** Augment a new-style prompt: prepend Block 1, append Block 2.
+ *  Returns the same prompt when slug derivation produces an empty string
+ *  (e.g. title is just `Chip: ` with no verb phrase) — validation then
+ *  rejects with a clean "missing worktree" message. */
+function augmentPrompt(title, prompt) {
+    const slug = deriveSlugFromTitle(title);
+    if (!slug)
+        return prompt;
+    return buildBlock1(slug) + '\n' + prompt + '\n\n' + buildBlock2(slug);
+}
+/** Substitute Tier 1 placeholders in the prompt. Best-effort: missing
+ *  values leave the placeholder in for loud chip-runtime failure. */
+function substitutePlaceholders(prompt, sessionId, alias) {
+    let out = prompt;
+    const short = (0, session_id_1.truncateSessionId)(sessionId);
+    if (short)
+        out = out.split('<parent-session-id>').join(short);
+    if (alias)
+        out = out.split('<handle>').join(alias);
+    return out;
+}
+function validateChip(title, prompt) {
     const violations = [];
     if (!title.startsWith('Chip: ')) {
         violations.push(`title "${title}" missing required "Chip: " prefix. ` +
@@ -1032,19 +1129,56 @@ function handlePreSpawnCheck(input) {
             `\`greprag send "<status>: <commit> on chip/<slug>" --to <handle>@greprag.com/<parent-session-id> ` +
             `--from-session <own-session-id> --artifact commit:<hash>\`.`);
     }
-    if (violations.length === 0)
+    return violations;
+}
+function handlePreSpawnCheck(input) {
+    if (input.tool_name !== 'mcp__ccd_session__spawn_task')
         return;
-    const reason = `Chip prompt rejected by greprag PreToolUse validator. Fix the following and re-call spawn_task:\n  - ` +
-        violations.join('\n  - ') +
-        `\n\nFull conventions: ~/.claude/CLAUDE.md § Chip Spawning.`;
-    const payload = {
-        hookSpecificOutput: {
-            hookEventName: 'PreToolUse',
-            permissionDecision: 'deny',
-            permissionDecisionReason: reason,
-        },
-    };
-    process.stdout.write(JSON.stringify(payload) + '\n');
+    const title = input.tool_input?.title ?? '';
+    const originalPrompt = input.tool_input?.prompt ?? '';
+    // Tier 2 — augment new-style minimal prompts.
+    let prompt = isNewStylePrompt(originalPrompt)
+        ? augmentPrompt(title, originalPrompt)
+        : originalPrompt;
+    // Tier 1 — substitute placeholders (applies to augmented body AND any
+    // placeholders the agent included in an old-style prompt).
+    const alias = readIdentityAlias();
+    prompt = substitutePlaceholders(prompt, input.session_id, alias);
+    // Validate the final prompt. Augmented prompts should pass; old-style
+    // prompts missing Block 1/2 still get a clean deny.
+    const violations = validateChip(title, prompt);
+    if (violations.length > 0) {
+        const reason = `Chip prompt rejected by greprag PreToolUse validator. Fix the following and re-call spawn_task:\n  - ` +
+            violations.join('\n  - ') +
+            `\n\nFull conventions: ~/.claude/docs/chip-spawn.md.`;
+        process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: 'PreToolUse',
+                permissionDecision: 'deny',
+                permissionDecisionReason: reason,
+            },
+        }) + '\n');
+        return;
+    }
+    // Augmented or substituted — emit modifiedInput so the harness picks up
+    // the rewritten prompt. Otherwise stay silent.
+    if (prompt !== originalPrompt) {
+        const modifiedInput = {
+            title,
+            prompt,
+        };
+        if (input.tool_input?.tldr !== undefined)
+            modifiedInput.tldr = input.tool_input.tldr;
+        if (input.tool_input?.cwd !== undefined)
+            modifiedInput.cwd = input.tool_input.cwd;
+        process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+                hookEventName: 'PreToolUse',
+                permissionDecision: 'allow',
+                modifiedInput,
+            },
+        }) + '\n');
+    }
 }
 async function main() {
     const subcommand = process.argv[2];