paths-engine 0.0.0-stage → 0.1.0

package/dist/cli/commands/sync.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerSyncCommands(parentCommand: Command): void;
+//# sourceMappingURL=sync.d.ts.map

package/dist/cli/commands/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiDpC,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI,CAqIjE"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,168 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { initDb, resolveDbPath } from '../../core/db/index.js';
+import { SqliteStore } from '../../core/db/store.js';
+import { SyncRepository } from '../../core/db/sync-repository.js';
+import { SyncService } from '../../core/sync/sync.service.js';
+import { getOrCreateProject } from '../../core/project.js';
+import { formatCliError } from '../formatters/errors.js';
+const MAX_BUNDLE_FILE_BYTES = 2 * 1024 * 1024;
+function isForbiddenSyncPath(resolved) {
+    const normalized = resolved.toLowerCase().replace(/\\/g, '/');
+    if (normalized.includes('/windows/system32') ||
+        normalized.includes('/program files')) {
+        return true;
+    }
+    if (/^\/etc(\/|$)/.test(normalized) ||
+        /^\/proc(\/|$)/.test(normalized) ||
+        /^\/sys(\/|$)/.test(normalized) ||
+        /^\/dev(\/|$)/.test(normalized)) {
+        return true;
+    }
+    return false;
+}
+function resolveSyncOutputPath(output) {
+    const normalizedInput = output.toLowerCase().replace(/\\/g, '/');
+    if (/^\/etc(\/|$)/.test(normalizedInput) ||
+        /^\/proc(\/|$)/.test(normalizedInput) ||
+        /^\/sys(\/|$)/.test(normalizedInput) ||
+        /^\/dev(\/|$)/.test(normalizedInput)) {
+        throw new Error('Output path targets a forbidden system location.');
+    }
+    const resolved = path.resolve(output);
+    if (isForbiddenSyncPath(resolved)) {
+        throw new Error('Output path targets a forbidden system location.');
+    }
+    return resolved;
+}
+export function registerSyncCommands(parentCommand) {
+    const syncGroup = parentCommand
+        .command('sync')
+        .description('Multi-machine distributed synchronization commands');
+    syncGroup
+        .command('export')
+        .alias('bundle')
+        .description('Export a synchronization bundle of project changes')
+        .option('-o, --output <file>', 'Path to write exported sync bundle JSON file')
+        .option('-c, --cursor <json>', 'Per-device vector clock cursor JSON')
+        .option('-f, --force', 'Overwrite output file if it already exists')
+        .action((options) => {
+        try {
+            const dbPath = resolveDbPath();
+            const db = initDb(dbPath);
+            const store = new SqliteStore(db);
+            const syncRepo = new SyncRepository(store);
+            const syncService = new SyncService(store, syncRepo);
+            const project = getOrCreateProject(store, process.cwd());
+            let cursorObj;
+            if (options.cursor) {
+                try {
+                    cursorObj = { deviceCursors: JSON.parse(options.cursor) };
+                }
+                catch {
+                    console.error('Error: Cursor must be valid JSON.');
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            const bundle = syncService.exportSyncBundle(project.key, cursorObj);
+            const jsonStr = JSON.stringify(bundle, null, 2);
+            const signedLabel = bundle.signature ? 'signed' : 'unsigned (set PATHS_SYNC_KEY to sign)';
+            if (options.output) {
+                const resolvedOutput = resolveSyncOutputPath(options.output);
+                if (fs.existsSync(resolvedOutput) && !options.force) {
+                    console.error(`Error: Output file already exists: '${options.output}'. Use --force to overwrite.`);
+                    process.exitCode = 1;
+                    return;
+                }
+                fs.writeFileSync(resolvedOutput, jsonStr, 'utf-8');
+                console.log(`Sync bundle exported to ${options.output} (${bundle.changes.length} changes, ${signedLabel}).`);
+            }
+            else {
+                console.log(jsonStr);
+            }
+        }
+        catch (err) {
+            console.error(formatCliError(err));
+            process.exitCode = 1;
+        }
+    });
+    syncGroup
+        .command('apply [bundleSource]')
+        .description('Apply a synchronization bundle from a file or JSON string')
+        .action((bundleSource) => {
+        try {
+            if (!bundleSource) {
+                console.error('Error: A bundle file path or JSON string must be provided.');
+                process.exitCode = 1;
+                return;
+            }
+            let bundleStr;
+            if (bundleSource.trimStart().startsWith('{')) {
+                bundleStr = bundleSource;
+            }
+            else if (fs.existsSync(bundleSource)) {
+                const stat = fs.statSync(bundleSource);
+                if (!stat.isFile()) {
+                    console.error('Error: Bundle path is not a file.');
+                    process.exitCode = 1;
+                    return;
+                }
+                if (stat.size > MAX_BUNDLE_FILE_BYTES) {
+                    console.error('Error: Bundle file exceeds maximum size.');
+                    process.exitCode = 1;
+                    return;
+                }
+                bundleStr = fs.readFileSync(bundleSource, 'utf-8');
+            }
+            else {
+                bundleStr = bundleSource;
+            }
+            if (Buffer.byteLength(bundleStr, 'utf-8') > MAX_BUNDLE_FILE_BYTES) {
+                console.error('Error: Bundle input exceeds maximum size.');
+                process.exitCode = 1;
+                return;
+            }
+            let bundle;
+            try {
+                bundle = JSON.parse(bundleStr);
+            }
+            catch {
+                console.error('Error: Invalid JSON bundle format.');
+                process.exitCode = 1;
+                return;
+            }
+            const dbPath = resolveDbPath();
+            const db = initDb(dbPath);
+            const store = new SqliteStore(db);
+            const syncRepo = new SyncRepository(store);
+            const syncService = new SyncService(store, syncRepo);
+            const result = syncService.applySyncBundle(bundle);
+            console.log(JSON.stringify(result, null, 2));
+        }
+        catch (err) {
+            console.error(formatCliError(err));
+            process.exitCode = 1;
+        }
+    });
+    syncGroup
+        .command('status')
+        .description('Display the synchronization and device status for the current project')
+        .action(() => {
+        try {
+            const dbPath = resolveDbPath();
+            const db = initDb(dbPath);
+            const store = new SqliteStore(db);
+            const syncRepo = new SyncRepository(store);
+            const syncService = new SyncService(store, syncRepo);
+            const project = getOrCreateProject(store, process.cwd());
+            const status = syncService.getSyncStatus(project.key);
+            console.log(JSON.stringify(status, null, 2));
+        }
+        catch (err) {
+            console.error(formatCliError(err));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=sync.js.map

package/dist/cli/commands/sync.js.map

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

package/dist/cli/commands/todo.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerTodoCommands(parentCommand: Command): void;
+//# sourceMappingURL=todo.d.ts.map

package/dist/cli/commands/todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/todo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI,CAqIjE"}

package/dist/cli/commands/todo.js

@@ -0,0 +1,116 @@
+import { initDb, resolveDbPath } from '../../core/db/index.js';
+import { SqliteStore } from '../../core/db/store.js';
+import { TodoRepository } from '../../core/db/todo-repository.js';
+import { LineageRepository } from '../../core/db/lineage-repository.js';
+import { NodeRepository } from '../../core/db/node-repository.js';
+import { PlanRepository } from '../../core/db/plan-repository.js';
+import { getOrCreateProject } from '../../core/project.js';
+import { addTodo, completeTodo, listOpenTodos } from '../../core/todo.js';
+import { formatCliError } from '../formatters/errors.js';
+export function registerTodoCommands(parentCommand) {
+    const todoGroup = parentCommand
+        .command('todo')
+        .description('Manage project and lineage todos');
+    todoGroup
+        .command('add <text>')
+        .description('Add a new todo')
+        .option('--lineage <id>', 'Lineage ID to scope this todo to')
+        .option('--plan <id>', 'Plan ID to link this todo to')
+        .action((text, options) => {
+        try {
+            const dbPath = resolveDbPath();
+            const db = initDb(dbPath);
+            const store = new SqliteStore(db);
+            const todoRepo = new TodoRepository(store);
+            const lineageRepo = new LineageRepository(store);
+            const nodeRepo = new NodeRepository(store);
+            const planRepo = new PlanRepository(store);
+            const project = getOrCreateProject(store, process.cwd());
+            let explicitLineageId;
+            if (options.lineage) {
+                explicitLineageId = parseInt(options.lineage, 10);
+                if (isNaN(explicitLineageId)) {
+                    console.error('Error: Lineage ID must be a valid number.');
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            let explicitPlanId;
+            if (options.plan) {
+                explicitPlanId = parseInt(options.plan, 10);
+                if (isNaN(explicitPlanId)) {
+                    console.error('Error: Plan ID must be a valid number.');
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            const todo = addTodo(todoRepo, lineageRepo, nodeRepo, project.id, text, explicitLineageId, undefined, explicitPlanId, planRepo);
+            const planSuffix = todo.planId !== null ? ` [Plan: #${todo.planId}]` : '';
+            if (todo.lineageId !== null) {
+                const lineage = lineageRepo.findById(todo.lineageId);
+                console.log(`Added todo: "${todo.text}" [Lineage: ${lineage?.name ?? todo.lineageId}]${planSuffix}`);
+            }
+            else {
+                console.log(`Added todo: "${todo.text}" [Project-wide]${planSuffix}`);
+            }
+        }
+        catch (err) {
+            console.error(formatCliError(err));
+            process.exitCode = 1;
+        }
+    });
+    todoGroup
+        .command('done <matchText>')
+        .description('Complete an open todo by matching a substring of its text')
+        .action((matchText) => {
+        try {
+            const dbPath = resolveDbPath();
+            const db = initDb(dbPath);
+            const store = new SqliteStore(db);
+            const todoRepo = new TodoRepository(store);
+            const project = getOrCreateProject(store, process.cwd());
+            const todo = completeTodo(todoRepo, project.id, matchText);
+            console.log(`Completed todo: "${todo.text}"`);
+        }
+        catch (err) {
+            console.error(formatCliError(err));
+            process.exitCode = 1;
+        }
+    });
+    todoGroup
+        .command('list')
+        .description('List open todos for the project or lineage')
+        .option('--lineage <id>', 'Filter open todos by lineage ID')
+        .action((options) => {
+        try {
+            const dbPath = resolveDbPath();
+            const db = initDb(dbPath);
+            const store = new SqliteStore(db);
+            const todoRepo = new TodoRepository(store);
+            const lineageRepo = new LineageRepository(store);
+            const project = getOrCreateProject(store, process.cwd());
+            let explicitLineageId;
+            if (options.lineage) {
+                explicitLineageId = parseInt(options.lineage, 10);
+                if (isNaN(explicitLineageId)) {
+                    console.error('Error: Lineage ID must be a valid number.');
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            const todos = listOpenTodos(todoRepo, lineageRepo, project.id, explicitLineageId);
+            if (todos.length === 0) {
+                console.log('No open todos found.');
+                return;
+            }
+            for (const todo of todos) {
+                console.log(`[ ] ${todo.text}`);
+            }
+        }
+        catch (err) {
+            console.error(formatCliError(err));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=todo.js.map

package/dist/cli/commands/todo.js.map

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

package/dist/cli/file-reader.d.ts

@@ -0,0 +1,3 @@
+export declare const MAX_FILE_BYTES = 1048576;
+export declare function readCliFile(filePath: string): string;
+//# sourceMappingURL=file-reader.d.ts.map

package/dist/cli/file-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../src/cli/file-reader.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,UAAY,CAAC;AAExC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAmBpD"}

package/dist/cli/file-reader.js

@@ -0,0 +1,29 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const MAX_FILE_BYTES = 1_048_576; // 1 MiB
+export function readCliFile(filePath) {
+    const resolved = path.resolve(filePath);
+    let stat;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch {
+        throw new Error(`File not found: ${resolved}`);
+    }
+    if (!stat.isFile())
+        throw new Error(`Path is not a file: ${resolved}`);
+    if (stat.size > MAX_FILE_BYTES)
+        throw new Error(`File too large (max 1 MiB): ${resolved}`);
+    let content;
+    try {
+        content = new TextDecoder('utf-8', { fatal: true }).decode(fs.readFileSync(resolved));
+    }
+    catch {
+        throw new Error(`File is not valid UTF-8: ${resolved}`);
+    }
+    const trimmed = content.trim();
+    if (trimmed.length === 0)
+        throw new Error(`File is empty: ${resolved}`);
+    return trimmed;
+}
+//# sourceMappingURL=file-reader.js.map

package/dist/cli/file-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-reader.js","sourceRoot":"","sources":["../../src/cli/file-reader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,QAAQ;AAEjD,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,EAAE,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc;QAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAC;IAC3F,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxF,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,EAAE,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/formatters/context.d.ts

@@ -0,0 +1,3 @@
+import { TaskContext } from '../../core/types/task-context.js';
+export declare function formatTaskContextHuman(ctx: TaskContext): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/formatters/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/context.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAIZ,MAAM,kCAAkC,CAAC;AAmE1C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAW/D"}

package/dist/cli/formatters/context.js

@@ -0,0 +1,58 @@
+const formatSourceTag = (matchReason, matchedValue) => typeof matchedValue === 'string' && matchReason.startsWith('query')
+    ? `[${matchReason}: "${matchedValue}"]`
+    : `[${matchReason}: ${matchedValue}]`;
+const formatTags = (sources) => sources.map((s) => formatSourceTag(s.matchReason, s.matchedValue)).join(' ');
+const formatHeader = (ctx) => [
+    'Task Context',
+    '────────────────────────────────────────',
+    `Project      ${ctx.summary.project}`,
+    `Lineage      ${ctx.summary.lineage}`,
+    `Files        ${ctx.summary.targetFiles.length > 0 ? ctx.summary.targetFiles.join(', ') : '(none)'}`,
+    `Query        ${ctx.summary.query ?? '(none)'}`,
+    `Matched      ${ctx.summary.matchedKnowledgeCount} knowledge · ${ctx.summary.matchedSessionCount} sessions · ${ctx.summary.openTodoCount} open todos`,
+];
+const formatPlan = (plan) => plan === null
+    ? ['Plan', '  (none)']
+    : [
+        'Plan',
+        `  ${plan.title} (#${plan.id}, ${plan.status})`,
+        `  Intent: ${plan.intent}`,
+        `  Done: ${plan.definition_of_done}`,
+    ];
+const formatKnowledgeEntry = (entry) => [
+    `  #${entry.item.id} [${entry.item.category}] ${entry.item.fact}`,
+    `  Why: ${entry.item.why} ${formatTags(entry.sources)}`,
+];
+const formatKnowledge = (knowledge) => knowledge.length === 0
+    ? ['Matched Knowledge', '  (none)']
+    : ['Matched Knowledge', ...knowledge.flatMap(formatKnowledgeEntry)];
+const formatSessionEntry = (entry) => [
+    `  #${entry.node.id} (${entry.node.tool}) ${entry.node.summary} ${formatTags(entry.sources)}`,
+];
+const formatSessions = (sessions) => sessions.length === 0
+    ? ['Matched Sessions', '  (none)']
+    : ['Matched Sessions', ...sessions.flatMap(formatSessionEntry)];
+const formatTodoEntry = (todo) => [
+    `  #${todo.id} ${todo.text}${todo.planId === null ? ' (unlinked)' : ` (plan #${todo.planId})`}`,
+];
+const formatTodos = (todos) => todos.length === 0
+    ? ['Open Todos', '  (none)']
+    : ['Open Todos', ...todos.flatMap(formatTodoEntry)];
+const formatOverflow = (overflow) => overflow === undefined
+    ? []
+    : [
+        'Overflow',
+        `  Truncated ${overflow.knowledgeTruncated} knowledge · ${overflow.sessionsTruncated} sessions · ${overflow.todosTruncated} todos${overflow.budgetExceededBy !== undefined ? ` · over budget by ${overflow.budgetExceededBy} tokens` : ''}`,
+    ];
+export function formatTaskContextHuman(ctx) {
+    const sections = [
+        formatHeader(ctx),
+        formatPlan(ctx.plan),
+        formatKnowledge(ctx.knowledge),
+        formatSessions(ctx.sessions),
+        formatTodos(ctx.todos),
+        formatOverflow(ctx.overflow),
+    ];
+    return `${sections.filter((s) => s.length > 0).map((s) => s.join('\n')).join('\n\n')}\n`;
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/formatters/context.js.map

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

package/dist/cli/formatters/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function formatCliError(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/cli/formatters/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/errors.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGrD"}

package/dist/cli/formatters/errors.js

@@ -0,0 +1,7 @@
+import { classifyError } from '../../core/security/error-classifier.js';
+// Formatting only. No side effects. Does not write to stderr. Does not exit.
+export function formatCliError(error) {
+    const { safeMessage } = classifyError(error);
+    return safeMessage.startsWith('Error:') ? safeMessage : `Error: ${safeMessage}`;
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/formatters/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/cli/formatters/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,WAAW,EAAE,CAAC;AAClF,CAAC"}

package/dist/cli/formatters/status.d.ts

@@ -0,0 +1,6 @@
+import { CompiledContext, ContextSummary } from '../../core/types/context.js';
+import { LineageSummary } from '../../core/types/lineage.js';
+import { StatusJsonOutput } from '../../core/types/status-json.js';
+export declare function formatStatus(summary: ContextSummary): string;
+export declare function formatStatusJson(context: CompiledContext, lineages: LineageSummary[]): StatusJsonOutput;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/formatters/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/formatters/status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,cAAc,EAEf,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAGL,gBAAgB,EAEjB,MAAM,iCAAiC,CAAC;AAgCzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAkB5D;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,cAAc,EAAE,GACzB,gBAAgB,CAqClB"}

package/dist/cli/formatters/status.js

@@ -0,0 +1,79 @@
+function formatLastSession(lastSession) {
+    if (!lastSession) {
+        return ['Last Session', '  (none)'];
+    }
+    return [
+        'Last Session',
+        `  ${lastSession.tool} · ${lastSession.when}`,
+        `  ${lastSession.summary}`,
+    ];
+}
+function formatGoal(goal) {
+    if (goal === null) {
+        return [];
+    }
+    return ['Goal', `  ${goal}`];
+}
+function formatNextTask(task) {
+    return ['Next Task', `  ${task ?? '(none)'}`];
+}
+function formatMetrics(openTodoCount, blockers) {
+    const blockersDisplay = blockers.length > 0 ? blockers.join(', ') : 'None';
+    return [
+        `Open Todos   ${openTodoCount}`,
+        `Blockers     ${blockersDisplay}`,
+    ];
+}
+export function formatStatus(summary) {
+    const header = [
+        'Paths',
+        '────────────────────────────────────────',
+        `Project      ${summary.project}`,
+        `Lineage      ${summary.lineage}`,
+    ];
+    const sections = [
+        header,
+        formatLastSession(summary.last_session),
+        formatGoal(summary.current_goal),
+        formatNextTask(summary.next_suggested_task),
+        formatMetrics(summary.open_todo_count, summary.blockers),
+    ];
+    const nonEmptySections = sections.filter((s) => s.length > 0);
+    return `${nonEmptySections.map((s) => s.join('\n')).join('\n\n')}\n`;
+}
+export function formatStatusJson(context, lineages) {
+    const plan = context.plan
+        ? {
+            id: context.plan.id,
+            title: context.plan.title,
+            intent: context.plan.intent,
+            approach: context.plan.approach,
+            definition_of_done: context.plan.definition_of_done,
+            status: context.plan.status,
+        }
+        : null;
+    const lastSession = context.summary.last_session
+        ? {
+            tool: context.summary.last_session.tool,
+            when: context.summary.last_session.when,
+            summary: context.summary.last_session.summary,
+        }
+        : null;
+    const lineageList = lineages.map((lineage) => ({
+        id: lineage.id,
+        name: lineage.name,
+        status: lineage.status,
+        node_count: lineage.nodeCount,
+        is_current: lineage.isCurrent,
+    }));
+    return {
+        project: context.summary.project,
+        current_lineage: context.summary.lineage || null,
+        lineages: lineageList,
+        plan,
+        open_todo_count: context.summary.open_todo_count,
+        last_session: lastSession,
+        blockers: [...context.summary.blockers],
+    };
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/formatters/status.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { join, dirname } from 'path';
+import { registerIdentityCommands } from './commands/identity.js';
+import { registerLineageCommands } from './commands/lineage.js';
+import { registerSessionCommands } from './commands/session.js';
+import { registerTodoCommands } from './commands/todo.js';
+import { registerKnowledgeCommands } from './commands/knowledge.js';
+import { registerContextCommands } from './commands/context.js';
+import { registerStatusCommands } from './commands/status.js';
+import { registerSyncCommands } from './commands/sync.js';
+import { registerIngestCommands } from './commands/ingest.js';
+import { registerPlanCommands } from './commands/plan.js';
+import { registerGuiCommand } from './commands/gui.js';
+import { registerMcpSetupCommand } from './commands/mcp-setup.js';
+// Read version from package.json — never hardcoded as a string literal
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('paths')
+    .description('A tool-agnostic Knowledge Continuity Engine for AI-assisted development')
+    .version(pkg.version);
+registerIdentityCommands(program);
+registerLineageCommands(program);
+registerSessionCommands(program);
+registerTodoCommands(program);
+registerKnowledgeCommands(program);
+registerContextCommands(program);
+registerStatusCommands(program);
+registerSyncCommands(program);
+registerIngestCommands(program);
+registerPlanCommands(program);
+registerGuiCommand(program);
+registerMcpSetupCommand(program);
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,uEAAuE;AACvE,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AACtC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAC5C,CAAC;AAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,yEAAyE,CAAC;KACtF,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,wBAAwB,CAAC,OAAO,CAAC,CAAC;AAClC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,yBAAyB,CAAC,OAAO,CAAC,CAAC;AACnC,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}