@nirnex/cli 2.0.3 → 4.0.0

package/dist/commands/status.js

@@ -1,31 +1,162 @@
-// Command: dev status
-// Reads the local .aidos.db (or path from AIDOS_DB env var)
-// and prints a one-line index summary.
+// Command: nirnex status
+// Shows project readiness, index health, and freshness.
 import { openDb, indexStats } from '@nirnex/core';
 import path from 'node:path';
-import { existsSync } from 'node:fs';
-export function statusCommand(args) {
-    // Resolve db path: flag --db <path> > env var > cwd default
-    let dbPath;
-    const dbFlagIdx = args.indexOf('--db');
-    if (dbFlagIdx !== -1 && args[dbFlagIdx + 1]) {
-        dbPath = args[dbFlagIdx + 1];
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+function tick(msg) {
+    process.stdout.write(`  \x1b[32m✔\x1b[0m ${msg}\n`);
+}
+function cross(msg) {
+    process.stdout.write(`  \x1b[31m✘\x1b[0m ${msg}\n`);
+}
+function warn(msg) {
+    process.stdout.write(`  \x1b[33m!\x1b[0m ${msg}\n`);
+}
+export function statusCommand(_args) {
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, 'nirnex.config.json');
+    const dbPath = path.join(cwd, '.aidos.db');
+    console.log('\n\x1b[1mNirnex Status\x1b[0m\n');
+    // Check if project is Nirnex-enabled
+    const isEnabled = existsSync(configPath);
+    if (!isEnabled) {
+        cross('nirnex.config.json not found — project is not Nirnex-enabled');
+        console.log('\n  Run \x1b[1mnirnex setup\x1b[0m to initialize this project.\n');
+        process.exit(1);
+    }
+    let config = {};
+    try {
+        config = JSON.parse(readFileSync(configPath, 'utf8'));
+        tick(`Project: \x1b[1m${config.projectName ?? path.basename(cwd)}\x1b[0m`);
+    }
+    catch {
+        warn('nirnex.config.json is malformed');
+    }
+    // Check .ai/ structure
+    const aiDir = path.join(cwd, '.ai');
+    existsSync(aiDir)
+        ? tick('.ai/ workspace present')
+        : cross('.ai/ workspace missing — re-run nirnex setup');
+    const promptsDir = path.join(aiDir, 'prompts');
+    existsSync(path.join(promptsDir, 'analyst.md')) && existsSync(path.join(promptsDir, 'implementer.md'))
+        ? tick('.ai/prompts/ configured')
+        : warn('.ai/prompts/ missing analyst.md or implementer.md');
+    // Check index
+    const dbExists = existsSync(dbPath);
+    if (!dbExists) {
+        cross('Index not found — run \x1b[1mnirnex index --rebuild\x1b[0m');
     }
-    else if (process.env['AIDOS_DB']) {
-        dbPath = process.env['AIDOS_DB'];
+    else {
+        try {
+            const db = openDb(dbPath);
+            const stats = indexStats(db);
+            db.close();
+            if (stats.moduleCount === 0) {
+                warn(`Index empty (0 modules) — run \x1b[1mnirnex index --rebuild\x1b[0m`);
+            }
+            else {
+                tick(`Index: ${stats.moduleCount} modules, ${stats.edgeCount} edges, schema v${stats.schemaVersion}`);
+            }
+        }
+        catch (e) {
+            warn(`Index read error: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    // Check freshness
+    try {
+        const currentHead = execSync('git rev-parse HEAD', { cwd, encoding: 'utf8' }).trim();
+        if (dbExists) {
+            try {
+                const db = openDb(dbPath);
+                const meta = db.prepare('SELECT value FROM _meta WHERE key = ?').get('commit_hash');
+                db.close();
+                if (meta?.value === currentHead) {
+                    tick('Index is fresh (matches current HEAD)');
+                }
+                else {
+                    warn('Index is stale — run \x1b[1mnirnex index\x1b[0m to refresh');
+                }
+            }
+            catch { }
+        }
+    }
+    catch {
+        // not a git repo or git not available
+    }
+    // Check git hook
+    const hookPath = path.join(cwd, '.git', 'hooks', 'post-commit');
+    existsSync(hookPath)
+        ? tick('Git post-commit hook installed')
+        : warn('Git post-commit hook not installed (index may drift)');
+    // Check Claude hooks
+    console.log('');
+    console.log('\x1b[1mClaude Hooks\x1b[0m');
+    const claudeSettingsPath = path.join(cwd, '.claude', 'settings.json');
+    if (!existsSync(claudeSettingsPath)) {
+        warn('.claude/settings.json not found — run nirnex setup to install hooks');
     }
     else {
-        dbPath = path.join(process.cwd(), '.aidos.db');
+        try {
+            const settings = JSON.parse(readFileSync(claudeSettingsPath, 'utf8'));
+            settings.hooks
+                ? tick('.claude/settings.json hook bindings present')
+                : warn('.claude/settings.json has no hooks section — re-run nirnex setup');
+        }
+        catch {
+            warn('.claude/settings.json is malformed');
+        }
+    }
+    const claudeHooks = [
+        'nirnex-bootstrap.sh',
+        'nirnex-entry.sh',
+        'nirnex-guard.sh',
+        'nirnex-trace.sh',
+        'nirnex-validate.sh',
+    ];
+    const hooksDir = path.join(cwd, '.claude', 'hooks');
+    let hooksMissing = 0;
+    for (const h of claudeHooks) {
+        if (!existsSync(path.join(hooksDir, h)))
+            hooksMissing++;
     }
-    const isNew = !existsSync(dbPath);
-    const db = openDb(dbPath);
-    const stats = indexStats(db);
-    db.close();
-    if (isNew || stats.moduleCount === 0) {
-        console.log(`index empty, ${stats.moduleCount} modules, ${stats.edgeCount} edges  [db: ${dbPath}]`);
+    hooksMissing === 0
+        ? tick('All 5 Claude hook scripts present')
+        : warn(`${hooksMissing} Claude hook script(s) missing in .claude/hooks/ — re-run nirnex setup`);
+    // Check runtime state
+    const runtimeDir = path.join(cwd, '.ai-index', 'runtime');
+    const sessionsDir = path.join(runtimeDir, 'sessions');
+    const envelopesDir = path.join(runtimeDir, 'envelopes');
+    if (existsSync(sessionsDir)) {
+        try {
+            const sessions = readdirSync(sessionsDir).filter(f => f.endsWith('.json'));
+            tick(`Runtime sessions: ${sessions.length} recorded`);
+        }
+        catch {
+            warn('Could not read runtime sessions dir');
+        }
     }
     else {
-        console.log(`index ok — ${stats.moduleCount} modules, ${stats.edgeCount} edges, schema v${stats.schemaVersion}  [db: ${dbPath}]`);
+        tick('Runtime sessions: none yet (hooks not yet triggered)');
+    }
+    if (existsSync(envelopesDir)) {
+        try {
+            const envelopes = readdirSync(envelopesDir).filter(f => f.endsWith('.json'));
+            const activeCount = envelopes.filter(f => {
+                try {
+                    const e = JSON.parse(readFileSync(path.join(envelopesDir, f), 'utf8'));
+                    return e.status === 'active';
+                }
+                catch {
+                    return false;
+                }
+            }).length;
+            tick(`Task envelopes: ${envelopes.length} total, ${activeCount} active`);
+        }
+        catch {
+            warn('Could not read envelopes dir');
+        }
     }
+    console.log('');
 }
 //# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,4DAA4D;AAC5D,uCAAuC;AAEvC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,4DAA4D;IAC5D,IAAI,MAA0B,CAAC;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,SAAS,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,IAAI,KAAK,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CACT,gBAAgB,KAAK,CAAC,WAAW,aAAa,KAAK,CAAC,SAAS,gBAAgB,MAAM,GAAG,CACvF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CACT,cAAc,KAAK,CAAC,WAAW,aAAa,KAAK,CAAC,SAAS,mBAAmB,KAAK,CAAC,aAAa,UAAU,MAAM,GAAG,CACrH,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,wDAAwD;AAExD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,SAAS,IAAI,CAAC,GAAW;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,IAAI,CAAC,GAAW;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAe;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAE/C,qCAAqC;IACrC,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,GAAwB,EAAE,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,mBAAmB,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC1C,CAAC;IAED,uBAAuB;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpC,UAAU,CAAC,KAAK,CAAC;QACf,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC;QAChC,CAAC,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAE1D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC/C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACpG,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAE9D,cAAc;IACd,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,CAAC,4DAA4D,CAAC,CAAC;IACtE,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;YAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;YAEX,IAAI,KAAK,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,oEAAoE,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,UAAU,KAAK,CAAC,WAAW,aAAa,KAAK,CAAC,SAAS,mBAAmB,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;YACxG,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,qBAAqB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrF,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAkC,CAAC;gBACrH,EAAE,CAAC,KAAK,EAAE,CAAC;gBACX,IAAI,IAAI,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;oBAChC,IAAI,CAAC,uCAAuC,CAAC,CAAC;gBAChD,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,4DAA4D,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,sCAAsC;IACxC,CAAC;IAED,iBAAiB;IACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAChE,UAAU,CAAC,QAAQ,CAAC;QAClB,CAAC,CAAC,IAAI,CAAC,gCAAgC,CAAC;QACxC,CAAC,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAEjE,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAE1C,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACtE,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;YACtE,QAAQ,CAAC,KAAK;gBACZ,CAAC,CAAC,IAAI,CAAC,6CAA6C,CAAC;gBACrD,CAAC,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;QAC/E,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG;QAClB,qBAAqB;QACrB,iBAAiB;QACjB,iBAAiB;QACjB,iBAAiB;QACjB,oBAAoB;KACrB,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAAE,YAAY,EAAE,CAAC;IAC1D,CAAC;IACD,YAAY,KAAK,CAAC;QAChB,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC;QAC3C,CAAC,CAAC,IAAI,CAAC,GAAG,YAAY,wEAAwE,CAAC,CAAC;IAElG,sBAAsB;IACtB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAExD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC3E,IAAI,CAAC,qBAAqB,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,qCAAqC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,sDAAsD,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7E,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBACvC,IAAI,CAAC;oBACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;oBACvE,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBAAC,OAAO,KAAK,CAAC;gBAAC,CAAC;YAC3B,CAAC,CAAC,CAAC,MAAM,CAAC;YACV,IAAI,CAAC,mBAAmB,SAAS,CAAC,MAAM,WAAW,WAAW,SAAS,CAAC,CAAC;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,8BAA8B,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/commands/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAEjD"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AA6BA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAiEjD"}

package/dist/commands/trace.js

@@ -1,4 +1,77 @@
+// Command: nirnex trace
+// View execution traces from .ai-index/traces/
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+import { listTraces, readTrace } from '@nirnex/core/dist/trace.js';
+function tick(msg) {
+    process.stdout.write(`  \x1b[32m✔\x1b[0m ${msg}\n`);
+}
+function info(msg) {
+    process.stdout.write(`  \x1b[90m·\x1b[0m ${msg}\n`);
+}
+function warn(msg) {
+    process.stdout.write(`  \x1b[33m!\x1b[0m ${msg}\n`);
+}
+const TRACE_USAGE = `
+nirnex trace [options]
+
+Options:
+  --last            Show the most recent trace in full
+  --list            List recent traces (default)
+  --id <trace_id>   Show a specific trace by ID
+  --limit <n>       Number of traces to list (default: 20)
+`.trimStart();
 export function traceCommand(args) {
-    console.log('[dev trace] executing trace command');
+    const cwd = process.cwd();
+    const configPath = path.join(cwd, 'nirnex.config.json');
+    if (!existsSync(configPath)) {
+        warn('Not a Nirnex project. Run nirnex setup first.');
+        process.exit(1);
+    }
+    // Parse flags
+    const showLast = args.includes('--last');
+    const idIdx = args.indexOf('--id');
+    const traceId = idIdx !== -1 ? args[idIdx + 1] : undefined;
+    const limitIdx = args.indexOf('--limit');
+    const limit = limitIdx !== -1 ? parseInt(args[limitIdx + 1], 10) || 20 : 20;
+    const help = args.includes('--help') || args.includes('-h');
+    if (help) {
+        process.stdout.write(TRACE_USAGE + '\n');
+        return;
+    }
+    // Show specific trace by ID
+    if (traceId) {
+        const trace = readTrace(cwd, traceId);
+        if (!trace) {
+            warn(`Trace not found: ${traceId}`);
+            process.exit(1);
+        }
+        console.log(JSON.stringify(trace, null, 2));
+        return;
+    }
+    // List traces
+    const traces = listTraces(cwd, showLast ? 1 : limit);
+    if (traces.length === 0) {
+        info('No traces found in .ai-index/traces/');
+        info('Traces are written by nirnex plan and the runtime entry hook.');
+        return;
+    }
+    if (showLast) {
+        // Print full JSON of most recent trace
+        const full = readTrace(cwd, traces[0].trace_id);
+        console.log(JSON.stringify(full ?? traces[0], null, 2));
+        return;
+    }
+    // Print table
+    console.log('\n\x1b[1mNirnex Traces\x1b[0m\n');
+    console.log(`  ${'Trace ID'.padEnd(34)} ${'Date'.padEnd(12)} ${'Intent'.padEnd(20)} ${'Conf'.padEnd(6)} ${'Lane'}`);
+    console.log('  ' + '─'.repeat(80));
+    for (const t of traces) {
+        const intent = (t.intent ?? 'unknown').slice(0, 18);
+        const score = t.confidence_score != null ? String(t.confidence_score) : '—';
+        const lane = t.lane ?? '—';
+        console.log(`  ${t.trace_id.padEnd(34)} ${t.date.padEnd(12)} ${intent.padEnd(20)} ${score.padEnd(6)} ${lane}`);
+    }
+    console.log('');
 }
 //# sourceMappingURL=trace.js.map

package/dist/commands/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,26 +1,34 @@
 #!/usr/bin/env node
-// nirnex dev CLI
-// Usage: dev <command> [args]
-// Commands: plan | query | status | replay
+// Nirnex CLI — Decision Intelligence for software delivery
+// Usage: nirnex <command> [args]
 import { planCommand } from './commands/plan.js';
 import { queryCommand } from './commands/query.js';
 import { statusCommand } from './commands/status.js';
 import { replayCommand } from './commands/replay.js';
 import { indexCommand } from './commands/index.js';
 import { traceCommand } from './commands/trace.js';
+import { setupCommand } from './commands/setup.js';
+import { runtimeCommand } from './commands/runtime.js';
 const [, , command = '', ...rest] = process.argv;
 const USAGE = `
-nirnex dev CLI
+Nirnex — Decision Intelligence for software delivery
 
 Usage:
-  dev index   [options]   Run the indexer
-  dev plan    [options]   Generate / update a delivery plan
-  dev query   [options]   Query the knowledge index
-  dev status  [options]   Show index status
-  dev replay  [options]   Replay a past analysis run
-  dev trace   [options]   Capture or view traces
+  nirnex setup    [options]   Initialize Nirnex in this repository
+  nirnex index    [options]   Index the codebase into the knowledge graph
+  nirnex plan     [options]   Generate a delivery plan from a spec or query
+  nirnex query    [options]   Query the knowledge graph
+  nirnex status   [options]   Show index and project health
+  nirnex trace    [options]   View execution traces
+  nirnex replay   [options]   Replay a past analysis run
+  nirnex runtime  <sub>       Claude hook pipeline commands (machine-facing)
+
+Run \`nirnex setup\` to get started.
 `.trimStart();
 switch (command) {
+    case 'setup':
+        setupCommand(rest).catch(console.error);
+        break;
     case 'index':
         indexCommand(rest);
         break;
@@ -39,6 +47,9 @@ switch (command) {
     case 'trace':
         traceCommand(rest);
         break;
+    case 'runtime':
+        runtimeCommand(rest).catch(console.error);
+        break;
     default:
         console.log(USAGE);
         if (command && command !== '--help' && command !== '-h') {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,iBAAiB;AACjB,8BAA8B;AAC9B,2CAA2C;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAQ,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAO,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAO,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAO,qBAAqB,CAAC;AAEpD,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAEjD,MAAM,KAAK,GAAG;;;;;;;;;;CAUb,CAAC,SAAS,EAAE,CAAC;AAEd,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM;IACR,KAAK,MAAM;QACT,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM;IACR,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM;IACR,KAAK,QAAQ;QACX,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM;IACR,KAAK,QAAQ;QACX,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM;IACR,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM;IACR;QACE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,GAAG,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM;AACV,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,2DAA2D;AAC3D,iCAAiC;AAEjC,OAAO,EAAE,WAAW,EAAE,MAAS,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAQ,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAO,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAO,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAQ,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAQ,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAQ,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,CAAC,EAAE,AAAD,EAAG,OAAO,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAEjD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;CAcb,CAAC,SAAS,EAAE,CAAC;AAEd,QAAQ,OAAO,EAAE,CAAC;IAChB,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM;IACR,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM;IACR,KAAK,MAAM;QACT,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM;IACR,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM;IACR,KAAK,QAAQ;QACX,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM;IACR,KAAK,QAAQ;QACX,aAAa,CAAC,IAAI,CAAC,CAAC;QACpB,MAAM;IACR,KAAK,OAAO;QACV,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM;IACR,KAAK,SAAS;QACZ,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM;IACR;QACE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,GAAG,CAAC,CAAC;YAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM;AACV,CAAC"}

package/dist/runtime/bootstrap.d.ts

@@ -0,0 +1,2 @@
+export declare function runBootstrap(): Promise<void>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/runtime/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAsCA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA8DlD"}

package/dist/runtime/bootstrap.js

@@ -0,0 +1,90 @@
+// SessionStart hook handler.
+// Called by .claude/hooks/nirnex-bootstrap.sh at the start of each Claude session.
+// Reads nirnex.config.json, checks index freshness, writes env vars to CLAUDE_ENV_FILE,
+// and creates a session state file.
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { createSession, saveSession, loadSession } from './session.js';
+function readStdin() {
+    return new Promise(resolve => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', chunk => { buf += chunk; });
+        process.stdin.on('end', () => resolve(buf));
+    });
+}
+function getIndexFreshness(repoRoot) {
+    try {
+        const head = execSync('git rev-parse HEAD', { cwd: repoRoot, encoding: 'utf8' }).trim();
+        const dbPath = path.join(repoRoot, '.aidos.db');
+        if (!fs.existsSync(dbPath))
+            return { freshness: 'unknown', head };
+        // Read stored commit hash from DB
+        const { openDb } = require('@nirnex/core/dist/db.js');
+        const db = openDb(dbPath);
+        const meta = db.prepare('SELECT value FROM _meta WHERE key = ?').get('commit_hash');
+        db.close();
+        return { freshness: meta?.value === head ? 'fresh' : 'stale', head };
+    }
+    catch {
+        return { freshness: 'unknown', head: '' };
+    }
+}
+export async function runBootstrap() {
+    const raw = await readStdin();
+    let hookData = { session_id: 'unknown' };
+    try {
+        hookData = JSON.parse(raw || '{}');
+    }
+    catch {
+        // Non-fatal: proceed with generated session id
+    }
+    const sessionId = hookData.session_id || `sess_${Date.now().toString(36)}`;
+    const repoRoot = process.cwd();
+    // Verify project is Nirnex-enabled
+    const configPath = path.join(repoRoot, 'nirnex.config.json');
+    if (!fs.existsSync(configPath)) {
+        // Not a Nirnex project — exit silently
+        process.exit(0);
+    }
+    let config = {};
+    try {
+        config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+    catch {
+        process.exit(0);
+    }
+    const { freshness, head } = getIndexFreshness(repoRoot);
+    // Create or update session
+    const existing = loadSession(repoRoot, sessionId);
+    const session = existing ?? createSession(repoRoot, sessionId, {
+        index_freshness: freshness,
+        current_head: head,
+        policy_mode: config.hooks?.policyMode ?? 'standard',
+    });
+    if (!existing) {
+        saveSession(repoRoot, session);
+    }
+    // Write env vars to CLAUDE_ENV_FILE if set
+    const envFile = process.env.CLAUDE_ENV_FILE;
+    if (envFile) {
+        const envVars = [
+            `NIRNEX_REPO_ROOT=${repoRoot}`,
+            `NIRNEX_DB_PATH=${path.join(repoRoot, '.aidos.db')}`,
+            `NIRNEX_INDEX_FRESHNESS=${freshness}`,
+            `NIRNEX_CURRENT_HEAD=${head}`,
+            `NIRNEX_POLICY_MODE=${session.policy_mode}`,
+            `NIRNEX_SESSION_ID=${sessionId}`,
+        ].join('\n') + '\n';
+        try {
+            fs.writeFileSync(envFile, envVars, 'utf8');
+        }
+        catch {
+            // Non-fatal
+        }
+    }
+    // No JSON output needed for SessionStart (env vars are the output)
+    process.exit(0);
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/runtime/bootstrap.js.map

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

package/dist/runtime/entry.d.ts

@@ -0,0 +1,2 @@
+export declare function runEntry(): Promise<void>;
+//# sourceMappingURL=entry.d.ts.map

package/dist/runtime/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/runtime/entry.ts"],"names":[],"mappings":"AAoBA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CA6E9C"}

package/dist/runtime/entry.js

@@ -0,0 +1,86 @@
+// UserPromptSubmit hook handler.
+// Called before Claude processes each user prompt.
+// Builds ECO from the prompt, creates a task envelope, writes session state,
+// and returns additionalContext so Claude sees the envelope before acting.
+import fs from 'node:fs';
+import path from 'node:path';
+import { buildEnvelope, formatEnvelopeContext } from './envelope.js';
+import { loadSession, saveSession, saveEnvelope } from './session.js';
+function readStdin() {
+    return new Promise(resolve => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', chunk => { buf += chunk; });
+        process.stdin.on('end', () => resolve(buf));
+    });
+}
+export async function runEntry() {
+    const raw = await readStdin();
+    let hookData = {
+        session_id: 'unknown',
+        hook_event_name: 'UserPromptSubmit',
+        prompt: '',
+    };
+    try {
+        hookData = JSON.parse(raw || '{}');
+    }
+    catch {
+        // Non-fatal: proceed with empty prompt
+    }
+    const repoRoot = process.env.NIRNEX_REPO_ROOT ?? process.cwd();
+    const sessionId = hookData.session_id ?? process.env.NIRNEX_SESSION_ID ?? `sess_${Date.now().toString(36)}`;
+    const prompt = hookData.prompt ?? '';
+    // Skip if not a Nirnex project
+    if (!fs.existsSync(path.join(repoRoot, 'nirnex.config.json'))) {
+        process.exit(0);
+    }
+    // Skip very short or empty prompts (e.g. clarifications, single words)
+    if (prompt.trim().length < 10) {
+        process.exit(0);
+    }
+    let eco = {};
+    try {
+        const { buildECO } = await import('@nirnex/core/dist/eco.js');
+        eco = buildECO(null, repoRoot, { query: prompt });
+    }
+    catch {
+        // Degraded mode: use a minimal ECO
+        eco = {
+            recommended_lane: 'A',
+            forced_lane_minimum: 'A',
+            confidence_score: 50,
+            forced_unknown: false,
+            blocked: false,
+            intent: { primary: 'unknown' },
+            modules_touched: [],
+            penalties: [],
+            escalation_reasons: [],
+            boundary_warnings: [],
+            eco_dimensions: {},
+            evidence_checkpoints: {},
+        };
+    }
+    const envelope = buildEnvelope(eco, prompt, sessionId);
+    // Persist envelope and link to session
+    saveEnvelope(repoRoot, envelope);
+    const session = loadSession(repoRoot, sessionId);
+    if (session) {
+        session.active_task_id = envelope.task_id;
+        session.tasks.push(envelope.task_id);
+        saveSession(repoRoot, session);
+    }
+    // Block if ECO says blocked
+    if (eco.blocked) {
+        const output = {
+            blockMessage: `[Nirnex] Task blocked by ECO. Reasons: ${(eco.escalation_reasons ?? []).join('; ') || 'unknown'}. Please revise the spec or run nirnex plan for details.`,
+        };
+        process.stdout.write(JSON.stringify(output));
+        process.exit(0);
+    }
+    // Return envelope context to Claude
+    const contextText = formatEnvelopeContext(envelope);
+    const output = { additionalContext: contextText };
+    process.stdout.write(JSON.stringify(output));
+    process.exit(0);
+}
+//# sourceMappingURL=entry.js.map

package/dist/runtime/entry.js.map

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

package/dist/runtime/envelope.d.ts

@@ -0,0 +1,4 @@
+import { TaskEnvelope } from './types.js';
+export declare function buildEnvelope(eco: Record<string, any>, prompt: string, sessionId: string): TaskEnvelope;
+export declare function formatEnvelopeContext(envelope: TaskEnvelope): string;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/runtime/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/runtime/envelope.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAQ,MAAM,YAAY,CAAC;AAyBhD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAmEvG;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CA0BpE"}