greprag 0.8.2 → 0.8.5

package/dist/commands/fact.d.ts

@@ -0,0 +1,21 @@
+/** greprag fact — per-project self-organizing knowledge substrate.
+ *
+ *  Pull-based phase 1 (see docs/agent-coordination.md § Block 0.5). Agents
+ *  seed facts 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.
+ *
+ *  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>]
+ *    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 runFact(args: string[]): Promise<void>;

package/dist/commands/fact.js

@@ -0,0 +1,336 @@
+"use strict";
+/** greprag fact — per-project self-organizing knowledge substrate.
+ *
+ *  Pull-based phase 1 (see docs/agent-coordination.md § Block 0.5). Agents
+ *  seed facts 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.
+ *
+ *  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>]
+ *    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.runFact = runFact;
+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 fact 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 fact add "<text>" --scope <scope> [--project <name>] [--source-session <id>]');
+        process.exit(1);
+    }
+    const scope = getFlag(args, '--scope');
+    if (!scope) {
+        console.error('Usage: greprag fact 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 fact [${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,
+            facts: result.facts,
+        }, null, 2));
+        return;
+    }
+    if (result.facts.length === 0) {
+        const scopeNote = scope ? ` (scope=${scope})` : '';
+        const queryNote = queryStr ? ` matching "${queryStr}"` : '';
+        console.log(`No facts 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 { 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 (result.facts.length === 0) {
+        console.log(`No facts seeded in ${projectName} yet.`);
+        console.log('Add one: greprag fact 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} fact${result.facts.length === 1 ? '' : 's'} 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 fact 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 fact 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 fact [${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 fact — per-project self-organizing knowledge substrate.
+
+Subcommands:
+  add "<text>" --scope <S> [--project <name>] [--source-session <id>]
+                                Append a new fact under the given scope.
+  query [--scope <S>] [--query "<intent>"] [--project <name>]
+        [--limit N=10] [--format markdown|json]
+                                Read facts. With --query, lexical-rank by
+                                relevance. Without, most recent first.
+  list  [--project <name>]      Every fact grouped by scope (for review).
+  delete <nodeId> [--project <name>]
+                                Drop one fact by its 8-char nodeId.
+  scopes [--project <name>]     Distinct scope labels present in this project.
+
+Examples:
+  greprag fact add "Migrations live at repo root, not packages/api/migrations." --scope chip-startup
+  greprag fact query --scope chip-startup --limit 10 --format markdown
+  greprag fact query --query "where do migrations live" --limit 5
+  greprag fact list
+  greprag fact delete a3f2c1d4
+  greprag fact scopes
+`.trim();
+async function runFact(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=fact.js.map

package/dist/commands/fact.js.map

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

package/dist/commands/inbox-watch.d.ts

@@ -24,6 +24,33 @@ interface WatchOptions {
     json?: boolean;
     signal?: AbortSignal;
     backoffInitialMs?: number;
+    idleTimeoutMs?: number;
+}
+interface InboxReferences {
+    memory_ids?: string[];
+    artifacts?: Array<{
+        type: string;
+        id: string;
+        url?: string | null;
+    }>;
+    files?: Array<{
+        path: string;
+        lines?: string;
+    }>;
+}
+interface StreamMessage {
+    id: string;
+    from: {
+        tenant: string;
+        email: string | null;
+        project_id: string | null;
+        session_id?: string | null;
+    };
+    to_session_id?: string | null;
+    body: string;
+    references: InboxReferences | null;
+    message_type: string;
+    created_at: string;
 }
 interface SSEEvent {
     event: string;
@@ -33,5 +60,9 @@ interface SSEEvent {
 /** Parse one SSE event block (fields separated by single LF, block terminated
  *  by a blank line). Returns null for comment-only blocks (`:ping`). */
 export declare function parseEventBlock(block: string): SSEEvent | null;
+/** Truncate every session_id field on a StreamMessage to its 8-hex form.
+ *  Used for both the JSON --json line and the pretty-printed display.
+ *  Exported for tests. adr: adr/session-id-awareness.md */
+export declare function withTruncatedSessions(msg: StreamMessage): StreamMessage;
 export declare function runInboxWatch(opts: WatchOptions): Promise<void>;
 export {};