greprag 5.6.1 → 5.7.1

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/commands/status.d.ts

@@ -25,7 +25,7 @@ interface StatusReport {
     hooks: {
         session_start_recap: boolean;
         stop_store: boolean;
-        post_tool_use_spawn_reminder: boolean;
+        pre_tool_use_spawn_check: boolean;
     };
     project: {
         cwd: string;

package/dist/commands/status.js

@@ -121,10 +121,12 @@ function buildStatus(cwd) {
         hooks: {
             session_start_recap: hasGrepragHook(settings.hooks?.SessionStart, 'recap'),
             stop_store: hasGrepragHook(settings.hooks?.Stop, 'store'),
-            post_tool_use_spawn_reminder: hasGrepragHook(settings.hooks?.PostToolUse, 'spawn-reminder'),
+            pre_tool_use_spawn_check: hasGrepragHook(settings.hooks?.PreToolUse, 'pre-spawn-check'),
             // user_prompt_submit_notify removed in v5.6.1 — the inbox-count polling
             // it surfaced was the eavesdrop vector. Live inbox delivery is now the
             // Monitor watcher's exclusive job.
+            // post_tool_use_spawn_reminder removed in v5.6.2 — validation moved to
+            // PreToolUse pre-spawn-check + SessionStart auto-armed watcher.
         },
         project: {
             cwd: path.resolve(cwd),
@@ -155,7 +157,7 @@ function renderHuman(s) {
         `Hooks:`,
         `  SessionStart recap:        ${check(s.hooks.session_start_recap)}`,
         `  Stop store:                ${check(s.hooks.stop_store)}`,
-        `  PostToolUse spawn-reminder:${check(s.hooks.post_tool_use_spawn_reminder)}`,
+        `  PreToolUse pre-spawn-check:${check(s.hooks.pre_tool_use_spawn_check)}`,
         ``,
         `Project (${s.project.cwd}):`,
         `  Anchor found:        ${check(s.project.anchor_found)}${s.project.is_deterministic_fallback ? ' (using deterministic-hash fallback)' : ''}`,

package/dist/commands/status.js.map

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

package/dist/hook.js

@@ -1010,60 +1010,47 @@ async function notify(_input) {
     // Intentional no-op. See docstring above.
     return;
 }
-/** PostToolUse hook fired on `mcp__ccd_session__spawn_task`. Emits a
- *  short `<system-reminder>` instructing the agent to arm a Monitor
- *  watcher on its own inbox in the same turn — the chip will report back
- *  via `greprag inbox` and mid-task replies are invisible without an SSE
- *  watcher.
- *
- *  Session-scoped is the default and the recommendation. The orchestrator's
- *  own session id is always available (the SessionStart hook publishes it
- *  on every session). Project-scoped watchers exist only for the rare
- *  multi-chip-campaign case where N chips are fanned out in parallel and
- *  the parent wants every report on one merged stream. The previous
- *  iteration of this hook presented both scopes as coequal options and
- *  said "if unsure, arm both"; that turned out to push orchestrators
- *  toward project-scoped by default and produced cross-project broadcasts
- *  that polluted sibling chips' inboxes (observed in production
- *  2026-05-26). Project-scope must be opted into deliberately, not
- *  defaulted to.
- *
- *  Session-id sourcing: PostToolUse `input.session_id` has been observed
- *  to be unreliable for the spawn_task tool (in one incident it carried a
- *  third party's UUID, not the parent's). Rather than emit a wrong concrete
- *  id, we render `<your-own-session-id>` as a placeholder — the agent
- *  already learned its own session id from the SessionStart session-id
- *  hook earlier in the conversation and substitutes correctly.
- *
- *  adr: adr/spawn-task-hook-mode.md */
-function handleSpawnReminderHook(_input) {
-    const ownIdToken = '<your-own-session-id>';
-    const text = `[GrepRAG] Chip spawned. The chip will report back via greprag inbox; `
-        + `mid-task replies are invisible without an SSE watcher. `
-        + `Arm THIS under \`Monitor\` (persistent:true) THIS TURN, and make sure `
-        + `your chip prompt's Block 2 sends with --to <email>/${ownIdToken} `
-        + `(scope mismatch = silent delivery failure):\n`
-        + `  \`while true; do greprag inbox watch --session ${ownIdToken} --json; `
-        + `echo "[wrapper] watcher exited, restarting in 1s" >&2; sleep 1; done\`\n`
-        + `Substitute ${ownIdToken} with the short id from your SessionStart hook `
-        + `("Your greprag session id: <8-hex>"). It is always present in a current session. `
-        + `The \`--project <parent-project>\` form exists ONLY for the rare case of `
-        + `orchestrating multiple chips in parallel and wanting all reports on one stream — `
-        + `do not default to it. Cross-project broadcasts pollute sibling chips' inboxes. `
-        + `See ~/.claude/docs/agent-coordination.md § Block 3 + Parent-side: watch for the report.`;
+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 ?? '';
+    const violations = [];
+    if (!title.startsWith('Chip: ')) {
+        violations.push(`title "${title}" missing required "Chip: " prefix. ` +
+            `Format: "Chip: <imperative verb phrase>" — e.g. "Chip: Fix stale README badge". ` +
+            `The prefix distinguishes chip-spawned sessions from IDE/human sessions in FleetView.`);
+    }
+    if (!/\bgit\s+worktree\s+add\b/.test(prompt)) {
+        violations.push(`prompt missing worktree setup. ` +
+            `Block 1 requires the chip to open with: \`git worktree add .claude/worktrees/<slug> -b chip/<slug>\` ` +
+            `then \`cd\` into it. Chips never edit the main checkout.`);
+    }
+    if (!/\bgreprag\s+send\b/.test(prompt)) {
+        violations.push(`prompt missing report-back instruction. ` +
+            `Block 2 requires the chip to send a status message via: ` +
+            `\`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;
+    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: 'PostToolUse',
-            additionalContext: text,
+            hookEventName: 'PreToolUse',
+            permissionDecision: 'deny',
+            permissionDecisionReason: reason,
         },
     };
     process.stdout.write(JSON.stringify(payload) + '\n');
 }
 async function main() {
     const subcommand = process.argv[2];
-    const validSubs = new Set(['store', 'recap', 'notify', 'session-id', 'spawn-reminder']);
+    const validSubs = new Set(['store', 'recap', 'notify', 'session-id', 'pre-spawn-check']);
     if (!validSubs.has(subcommand)) {
-        process.stderr.write(`Usage: greprag-hook <store|recap|notify|session-id|spawn-reminder>\n`);
+        process.stderr.write(`Usage: greprag-hook <store|recap|notify|session-id|pre-spawn-check>\n`);
         process.exit(1);
     }
     let input = {};
@@ -1095,8 +1082,8 @@ async function main() {
         const cfg = getConfig(cwd);
         (0, session_id_1.handleSessionIdHook)(input, { armWatcher: cfg.enabled && !!cfg.apiKey });
     }
-    else if (subcommand === 'spawn-reminder') {
-        handleSpawnReminderHook(input);
+    else if (subcommand === 'pre-spawn-check') {
+        handlePreSpawnCheck(input);
     }
     else {
         await store(input);