hippo-memory 1.70.0 → 1.72.0

package/dist/cli/briefs.js

@@ -1,46 +1,20 @@
-// First-class object verbs for project briefs and customer notes, plus the entity graph.
-import * as fs from 'fs';
-import { spawn } from 'child_process';
-import { extractPathTags } from '../search/path-context.js';
+// The project brief verbs: one repo's brief, versioned by supersession and refreshable from the repo's receipts.
 import * as briefsModule from '../objects/project-briefs.js';
-import * as customerNotesModule from '../objects/customer-notes.js';
-import { extractGraph } from '../graph/extract.js';
-import { buildGraphModel, renderGraphHtml, renderGraphCanvas, DEFAULT_VIEW_LIMIT } from '../graph/view.js';
-import { resolveTenantId } from '../store/tenant.js';
-import { errorMessage, log } from '../util/log.js';
+import { errorMessage } from '../util/log.js';
 import { printError } from './output.js';
-import { nonEmptyStringFlag, boolFlag, stringFlag } from './flag-values.js';
-import { requireInit } from './shared.js';
-import { closeObject, foundOrExit, idArgOrExit, listObjects, printLifecycleTail } from './object-verbs.js';
-const BRIEF = { cmd: 'brief', noun: 'Project brief', idLabel: 'brief' };
-const NOTE = { cmd: 'note', noun: 'Customer note', idLabel: 'note' };
+import { boolFlag, stringFlag } from './flag-values.js';
+import { CliExit } from './exit.js';
+import { requiredText, versionedVerbs } from './versioned-verbs.js';
 function printBriefRow(b) {
     console.log(`#${b.id} [${b.status}] v${b.version} repo="${b.repo}" memory=${b.memoryId ?? '-'}`);
     if (b.changeSummary)
         console.log(`    change: ${b.changeSummary}`);
 }
-function briefUsage() {
-    printError('Usage: hippo brief new "<repo>" --summary "<text>"');
-    printError('       hippo brief list [--status active|superseded|closed|all] [--repo "<repo>"] [--limit N]');
-    printError('       hippo brief get <id>');
-    printError('       hippo brief supersede <id> --summary "<text>" [--change "<summary>"]');
-    printError('       hippo brief close <id>');
-    printError('       hippo brief refresh "<repo>" [--dry-run]   (auto-assemble the brief from the repo\'s receipts)');
-}
-function briefList(hippoRoot, tenantId, flags) {
-    const repo = stringFlag(flags, 'repo')?.trim() || undefined;
-    listObjects(flags, {
-        plural: 'project briefs',
-        states: briefsModule.VALID_BRIEF_STATES,
-        load: (opts) => briefsModule.loadProjectBriefs(hippoRoot, tenantId, { ...opts, repo }),
-        printRow: printBriefRow,
-    });
-}
 function briefRefresh(hippoRoot, tenantId, args, flags) {
     const repoRaw = args[1];
     if (!repoRaw) {
         printError('Usage: hippo brief refresh "<repo>" [--dry-run]');
-        process.exit(1);
+        throw new CliExit(1);
     }
     const dryRun = boolFlag(flags, 'dry-run');
     try {
@@ -59,273 +33,40 @@ function briefRefresh(hippoRoot, tenantId, args, flags) {
     }
     catch (e) {
         printError(errorMessage(e));
-        process.exit(1);
-    }
-}
-function briefGet(hippoRoot, tenantId, args) {
-    const id = idArgOrExit(args, 'Usage: hippo brief get <id>', BRIEF.idLabel);
-    const b = foundOrExit(briefsModule.loadProjectBriefById(hippoRoot, tenantId, id), BRIEF.noun, id);
-    console.log(`Project brief #${b.id}`);
-    console.log(`  repo: ${b.repo}`);
-    console.log(`  status: ${b.status}`);
-    console.log(`  version: ${b.version}`);
-    console.log(`  summary: ${b.summary}`);
-    printLifecycleTail(b);
-}
-function briefSupersede(hippoRoot, tenantId, args, flags) {
-    const id = idArgOrExit(args, 'Usage: hippo brief supersede <id> --summary "<text>" [--change "<summary>"]', BRIEF.idLabel);
-    const summaryRaw = stringFlag(flags, 'summary');
-    if (!summaryRaw?.trim()) {
-        printError('hippo brief supersede requires --summary "<text>" for the new version.');
-        process.exit(1);
-    }
-    const existing = foundOrExit(briefsModule.loadProjectBriefById(hippoRoot, tenantId, id), BRIEF.noun, id);
-    try {
-        const created = briefsModule.saveProjectBrief(hippoRoot, tenantId, {
-            repo: existing.repo,
-            summary: summaryRaw,
-            changeSummary: nonEmptyStringFlag(flags, 'change'),
-            supersedesBriefId: id,
-            extraTags: extractPathTags(process.cwd()),
-        });
-        console.log(`Project brief #${created.id} recorded (v${created.version}), superseding #${id}.`);
-        if (created.memoryId)
-            console.log(`  memory: ${created.memoryId}`);
-    }
-    catch (e) {
-        printError(errorMessage(e));
-        process.exit(1);
-    }
-}
-function briefClose(hippoRoot, tenantId, args) {
-    closeObject(args, BRIEF, (id) => briefsModule.closeProjectBrief(hippoRoot, tenantId, id));
-}
-function briefCreate(hippoRoot, tenantId, args, flags) {
-    const subcommand = args[0] ?? '';
-    // Default subcommand: new (create). Accept both `brief new "<repo>"` and the
-    // bare `brief "<repo>"` form: for the `new` keyword the repo is args[1].
-    const repo = subcommand === 'new' ? (args[1] ?? '') : subcommand;
-    const summaryRaw = stringFlag(flags, 'summary');
-    if (!repo || !summaryRaw?.trim()) {
-        briefUsage();
-        process.exit(1);
-    }
-    try {
-        const created = briefsModule.saveProjectBrief(hippoRoot, tenantId, {
-            repo,
-            summary: summaryRaw,
-            extraTags: extractPathTags(process.cwd()),
-        });
-        console.log(`Project brief recorded: #${created.id} (v${created.version}) for repo "${created.repo}"`);
-        if (created.memoryId)
-            console.log(`  memory: ${created.memoryId}`);
-    }
-    catch (e) {
-        printError(errorMessage(e));
-        process.exit(1);
-    }
-}
-export function cmdProjectBrief(hippoRoot, args, flags) {
-    requireInit(hippoRoot);
-    const tenantId = resolveTenantId({});
-    const subcommand = args[0] ?? '';
-    if (subcommand === 'list')
-        return briefList(hippoRoot, tenantId, flags);
-    if (subcommand === 'refresh')
-        return briefRefresh(hippoRoot, tenantId, args, flags);
-    if (subcommand === 'get')
-        return briefGet(hippoRoot, tenantId, args);
-    if (subcommand === 'supersede')
-        return briefSupersede(hippoRoot, tenantId, args, flags);
-    if (subcommand === 'close')
-        return briefClose(hippoRoot, tenantId, args);
-    briefCreate(hippoRoot, tenantId, args, flags);
-}
-function printNoteRow(n) {
-    console.log(`#${n.id} [${n.status}] v${n.version} customer="${n.customer}" memory=${n.memoryId ?? '-'}`);
-    if (n.changeSummary)
-        console.log(`    change: ${n.changeSummary}`);
-}
-function noteUsage() {
-    printError('Usage: hippo note new "<customer>" --text "<note>"');
-    printError('       hippo note list [--status active|superseded|closed|all] [--customer "<id>"] [--limit N]');
-    printError('       hippo note get <id>');
-    printError('       hippo note supersede <id> --text "<note>" [--change "<summary>"]');
-    printError('       hippo note close <id>');
-}
-function graphExtract(hippoRoot, tenantId) {
-    const result = extractGraph(hippoRoot, tenantId);
-    const byType = Object.entries(result.byType)
-        .map(([t, n]) => `${t} ${n}`)
-        .join(', ');
-    const supersedes = result.relations - result.references;
-    console.log(`Graph extracted: ${result.entities} entities (${byType}) + ${result.relations} relations (${supersedes} supersedes, ${result.references} references).`);
-    if (result.truncated.length > 0) {
-        printError(`WARNING: under-extracted (hit the per-type cap): ${result.truncated.join(', ')}. The graph is incomplete for those types.`);
-    }
-}
-function graphShow(hippoRoot, tenantId, entity, flags) {
-    const model = buildGraphModel(hippoRoot, tenantId, { entity, limit: DEFAULT_VIEW_LIMIT });
-    if (flags['json']) {
-        console.log(JSON.stringify(model, null, 2));
-        return;
-    }
-    if (model.nodes.length === 0) {
-        console.log(entity ? `No entity named "${entity}".` : 'Graph is empty. Run `hippo graph extract` first.');
-        return;
-    }
-    console.log(`Graph: ${model.nodes.length} entities, ${model.edges.length} relations${model.truncated ? ' (truncated)' : ''}`);
-    const byType = new Map();
-    for (const n of model.nodes) {
-        const arr = byType.get(n.type) ?? [];
-        arr.push({ id: n.id, name: n.name });
-        byType.set(n.type, arr);
-    }
-    for (const [type, ns] of byType) {
-        console.log(`\n${type} (${ns.length}):`);
-        for (const n of ns)
-            console.log(`  [${n.id}] ${n.name}`);
-    }
-    if (model.edges.length > 0) {
-        const nameById = new Map(model.nodes.map((n) => [n.id, n.name]));
-        console.log('\nrelations:');
-        for (const e of model.edges) {
-            console.log(`  ${nameById.get(e.from)} --${e.relType}--> ${nameById.get(e.to)}`);
-        }
-    }
-}
-function openInBrowser(out) {
-    // Best-effort browser launch; never fail the command if it doesn't work.
-    try {
-        const [cmd, cmdArgs] = process.platform === 'win32'
-            ? ['cmd', ['/c', 'start', '', out]]
-            : process.platform === 'darwin'
-                ? ['open', [out]]
-                : ['xdg-open', [out]];
-        const child = spawn(cmd, cmdArgs, { detached: true, stdio: 'ignore', windowsHide: true });
-        // A missing launcher (e.g. xdg-open absent) emits 'error' asynchronously;
-        // an unhandled 'error' event would throw, so swallow it — the file is
-        // already written and its path printed above.
-        child.on('error', () => { });
-        child.unref();
-    }
-    catch (err) {
-        // The file is written and its path printed above, so a browser that will not start costs nothing.
-        log.debug(`browser not opened: ${errorMessage(err)}`);
-    }
-}
-function graphView(hippoRoot, tenantId, entity, flags) {
-    const format = stringFlag(flags, 'format') ?? 'html';
-    if (format !== 'html' && format !== 'canvas') {
-        printError("graph view: --format must be 'html' or 'canvas'");
-        process.exit(1);
-    }
-    const model = buildGraphModel(hippoRoot, tenantId, { entity, limit: DEFAULT_VIEW_LIMIT });
-    const content = format === 'canvas' ? renderGraphCanvas(model) : renderGraphHtml(model);
-    const defaultOut = format === 'canvas' ? 'hippo-graph.canvas' : 'hippo-graph.html';
-    const out = stringFlag(flags, 'out') ?? defaultOut;
-    fs.writeFileSync(out, content, 'utf8');
-    console.log(`Wrote ${model.nodes.length} entities + ${model.edges.length} relations to ${out}${model.truncated ? ' (truncated)' : ''}`);
-    if (flags['open'] && format === 'html')
-        openInBrowser(out);
-}
-export function cmdGraph(hippoRoot, args, flags) {
-    requireInit(hippoRoot);
-    const tenantId = resolveTenantId({});
-    const subcommand = args[0] ?? '';
-    if (subcommand === 'extract')
-        return graphExtract(hippoRoot, tenantId);
-    const entity = stringFlag(flags, 'entity');
-    if (subcommand === 'show')
-        return graphShow(hippoRoot, tenantId, entity, flags);
-    if (subcommand === 'view')
-        return graphView(hippoRoot, tenantId, entity, flags);
-    printError('Usage:\n' +
-        '  hippo graph extract                     Rebuild the entity/relation graph from consolidated objects\n' +
-        '  hippo graph show [--entity NAME] [--json]   Inspect entities + their edges (text or JSON)\n' +
-        '  hippo graph view [--out FILE] [--open] [--format html|canvas] [--entity NAME]   Generate an interactive node-link diagram');
-    process.exit(1);
-}
-function noteList(hippoRoot, tenantId, flags) {
-    const customer = stringFlag(flags, 'customer')?.trim() || undefined;
-    listObjects(flags, {
-        plural: 'customer notes',
-        states: customerNotesModule.VALID_NOTE_STATES,
-        load: (opts) => customerNotesModule.loadCustomerNotes(hippoRoot, tenantId, { ...opts, customer }),
-        printRow: printNoteRow,
-    });
-}
-function noteGet(hippoRoot, tenantId, args) {
-    const id = idArgOrExit(args, 'Usage: hippo note get <id>', NOTE.idLabel);
-    const n = foundOrExit(customerNotesModule.loadCustomerNoteById(hippoRoot, tenantId, id), NOTE.noun, id);
-    console.log(`Customer note #${n.id}`);
-    console.log(`  customer: ${n.customer}`);
-    console.log(`  status: ${n.status}`);
-    console.log(`  version: ${n.version}`);
-    console.log(`  note: ${n.note}`);
-    printLifecycleTail(n);
-}
-function noteSupersede(hippoRoot, tenantId, args, flags) {
-    const id = idArgOrExit(args, 'Usage: hippo note supersede <id> --text "<note>" [--change "<summary>"]', NOTE.idLabel);
-    const textRaw = stringFlag(flags, 'text');
-    if (!textRaw?.trim()) {
-        printError('hippo note supersede requires --text "<note>" for the new version.');
-        process.exit(1);
-    }
-    const existing = foundOrExit(customerNotesModule.loadCustomerNoteById(hippoRoot, tenantId, id), NOTE.noun, id);
-    try {
-        const created = customerNotesModule.saveCustomerNote(hippoRoot, tenantId, {
-            customer: existing.customer,
-            note: textRaw,
-            changeSummary: nonEmptyStringFlag(flags, 'change'),
-            supersedesNoteId: id,
-            extraTags: extractPathTags(process.cwd()),
-        });
-        console.log(`Customer note #${created.id} recorded (v${created.version}), superseding #${id}.`);
-        if (created.memoryId)
-            console.log(`  memory: ${created.memoryId}`);
-    }
-    catch (e) {
-        printError(errorMessage(e));
-        process.exit(1);
-    }
-}
-function noteClose(hippoRoot, tenantId, args) {
-    closeObject(args, NOTE, (id) => customerNotesModule.closeCustomerNote(hippoRoot, tenantId, id));
-}
-export function cmdCustomerNote(hippoRoot, args, flags) {
-    requireInit(hippoRoot);
-    const tenantId = resolveTenantId({});
-    const subcommand = args[0] ?? '';
-    if (subcommand === 'list')
-        return noteList(hippoRoot, tenantId, flags);
-    if (subcommand === 'get')
-        return noteGet(hippoRoot, tenantId, args);
-    if (subcommand === 'supersede')
-        return noteSupersede(hippoRoot, tenantId, args, flags);
-    if (subcommand === 'close')
-        return noteClose(hippoRoot, tenantId, args);
-    // Default subcommand: new (create). Accept both `note new "<customer>"` and the
-    // bare `note "<customer>"` form: for the `new` keyword the customer is args[1].
-    const customer = subcommand === 'new' ? (args[1] ?? '') : subcommand;
-    const textRaw = stringFlag(flags, 'text');
-    if (!customer || !textRaw?.trim()) {
-        noteUsage();
-        process.exit(1);
-    }
-    try {
-        const created = customerNotesModule.saveCustomerNote(hippoRoot, tenantId, {
-            customer,
-            note: textRaw,
-            extraTags: extractPathTags(process.cwd()),
-        });
-        console.log(`Customer note recorded: #${created.id} (v${created.version}) for customer "${created.customer}"`);
-        if (created.memoryId)
-            console.log(`  memory: ${created.memoryId}`);
-    }
-    catch (e) {
-        printError(errorMessage(e));
-        process.exit(1);
-    }
-}
+        throw new CliExit(1);
+    }
+}
+const briefKind = (hippoRoot, tenantId) => ({
+    names: { cmd: 'brief', noun: 'Project brief', idLabel: 'brief' },
+    plural: 'project briefs',
+    states: briefsModule.VALID_BRIEF_STATES,
+    usage: [
+        'Usage: hippo brief new "<repo>" --summary "<text>"',
+        '       hippo brief list [--status active|superseded|closed|all] [--repo "<repo>"] [--limit N]',
+        '       hippo brief get <id>',
+        '       hippo brief supersede <id> --summary "<text>" [--change "<summary>"]',
+        '       hippo brief close <id>',
+        '       hippo brief refresh "<repo>" [--dry-run]   (auto-assemble the brief from the repo\'s receipts)',
+    ],
+    supersedeUsage: 'Usage: hippo brief supersede <id> --summary "<text>" [--change "<summary>"]',
+    bodyRequired: '--summary "<text>"',
+    body: (flags) => requiredText(flags, 'summary'),
+    keyOf: (b) => b.repo,
+    save: (repo, summary, extraTags, from) => briefsModule.saveProjectBrief(hippoRoot, tenantId, {
+        repo, summary, extraTags, changeSummary: from?.changeSummary, supersedesBriefId: from?.id,
+    }),
+    recorded: (b) => `Project brief recorded: #${b.id} (v${b.version}) for repo "${b.repo}"`,
+    list: (opts, flags) => briefsModule.loadProjectBriefs(hippoRoot, tenantId, { ...opts, repo: stringFlag(flags, 'repo')?.trim() || undefined }),
+    loadById: (id) => briefsModule.loadProjectBriefById(hippoRoot, tenantId, id),
+    close: (id) => briefsModule.closeProjectBrief(hippoRoot, tenantId, id),
+    printRow: printBriefRow,
+    printDetail: (b) => {
+        console.log(`  repo: ${b.repo}`);
+        console.log(`  status: ${b.status}`);
+        console.log(`  version: ${b.version}`);
+        console.log(`  summary: ${b.summary}`);
+    },
+    extra: { sub: 'refresh', run: (args, flags) => briefRefresh(hippoRoot, tenantId, args, flags) },
+});
+export const handleProjectBrief = versionedVerbs(briefKind);
 //# sourceMappingURL=briefs.js.map

package/dist/cli/card.d.ts

@@ -1,4 +1,4 @@
-import { type CliFlags } from './flag-values.js';
+import { type CommandContext } from './flag-values.js';
 /** Runs `hippo card <subcommand>`: rejects flags the subcommand never reads, then hands off to its handler. */
-export declare function cmdCard(hippoRoot: string, args: string[], flags: CliFlags): void;
+export declare function handleCard({ hippoRoot, tenantId, args, flags }: CommandContext): void;
 //# sourceMappingURL=card.d.ts.map