dual-brain 0.2.30 → 0.3.1

package/dist/src/calibration.d.ts

@@ -0,0 +1,32 @@
+interface AnalysisResult {
+    specificity: number;
+    signals: {
+        hasFileRefs: boolean;
+        hasTechTerms: boolean;
+        hasExactInstructions: boolean;
+        isVague: boolean;
+        wordCount: number;
+    };
+}
+export declare function analyzeInput(input: string | null | undefined): AnalysisResult;
+export declare function detectCorrection(input: string | null | undefined): boolean;
+export interface Calibration {
+    specificity?: number;
+    corrections?: number;
+    autonomy?: number;
+    interactions?: number;
+    lastUpdated?: string;
+}
+export declare function updateCalibration(calibration: Calibration, input: string, correction?: boolean): Calibration;
+interface Adaptation {
+    clarifyBeforeActing: boolean;
+    explainReasoning: boolean;
+    suggestNextSteps: boolean;
+    askForApproval: boolean;
+    autoExecute: boolean;
+    responseStyle: 'terse' | 'normal' | 'detailed';
+    userLevel: 'advanced' | 'intermediate' | 'beginner';
+}
+export declare function getAdaptation(calibration: Calibration): Adaptation;
+export declare function formatCalibration(calibration: Calibration): string;
+export {};

package/dist/src/calibration.js

@@ -0,0 +1,133 @@
+// User calibration module — tracks specificity, corrections, and autonomy signals
+// to adapt dual-brain behavior to any user from vague vibe-coder to precise expert.
+const FILE_REF_RE = /(?:src\/|\.mjs|\.tsx?|\.jsx?|\.json|\.ya?ml|\.sh|line\s+\d+|\bL\d+\b)/i;
+const TECH_TERM_RE = /\b(?:regex|middleware|api|endpoint|refactor|migration|schema|auth(?:entication)?|jwt|token|hook|dispatch|pipeline|module|function|class|interface|type|import|export|async|await|promise|callback|handler|router|controller|service|repository|factory|singleton|decorator|mixin|proxy|guard|interceptor|serializer|validator|transformer|adapter|facade|strategy|observer|subscriber|emitter|stream|buffer|cache|queue|worker|thread|mutex|semaphore|socket|websocket|http|grpc|graphql|rest|orm|sql|nosql|index|query|transaction|migration|seed|fixture|mock|stub|spy|assertion|coverage|lint|typecheck|bundle|compile|transpile|minify|tree.shake|dead.code|chunk|lazy.load|ssr|csr|hydrat)\b/i;
+const VAGUE_RE = /\b(?:idk|just|make\s+it|fix\s+it|whatever|vibes?|better|nicer|faster|cleaner|improve|help|do\s+it|yeah|sure|ok|okay|hmm|uh|er|um)\b/i;
+const AUTONOMY_HIGH_RE = /\b(?:just\s+do\s+it|go(?:\s+ahead)?|build\s+it|ship\s+it|run\s+it|execute|do\s+it|proceed|continue|carry\s+on|handle\s+it|take\s+care|make\s+it\s+happen|yolo)\b/i;
+const QUESTION_RE = /\?|^(?:how|what|why|when|where|which|should|can|could|would|is|are|do|does|did|will|won't|don't)\b/i;
+const CORRECTION_RE = /^(?:no[,.]?|not\s|wrong|stop|don't|that'?s?\s+not|i\s+said|i\s+meant)\b|(?:\binstead\b|\brather\b|\bactually\b)/i;
+export function analyzeInput(input) {
+    const text = (input || '').trim();
+    const words = text.split(/\s+/).filter(Boolean);
+    const wordCount = words.length;
+    const hasFileRefs = FILE_REF_RE.test(text);
+    const hasTechTerms = TECH_TERM_RE.test(text);
+    const hasExactInstructions = /\b(?:step\s+\d|first[,\s]|then[,\s]|finally[,\s]|specifically|exactly|must|should\s+(?:use|call|return|handle)|(?:use|call|return|throw|emit|dispatch)\s+\w)/i.test(text);
+    const isVague = VAGUE_RE.test(text.toLowerCase()) || wordCount <= 3;
+    let specificity;
+    if (hasFileRefs || /\bline\s*\d+\b|\bL\d+\b/i.test(text) || (hasTechTerms && hasExactInstructions)) {
+        specificity = 5;
+    }
+    else if (hasTechTerms && wordCount >= 6) {
+        specificity = 4;
+    }
+    else if (!isVague && wordCount >= 8) {
+        specificity = 3;
+    }
+    else if (wordCount >= 4 && !isVague) {
+        specificity = 2;
+    }
+    else {
+        specificity = 1;
+    }
+    return {
+        specificity,
+        signals: {
+            hasFileRefs,
+            hasTechTerms,
+            hasExactInstructions,
+            isVague,
+            wordCount
+        }
+    };
+}
+export function detectCorrection(input) {
+    return CORRECTION_RE.test((input || '').trim());
+}
+function clamp(value, min = 1, max = 5) {
+    return Math.min(max, Math.max(min, value));
+}
+function round1(value) {
+    return Math.round(value * 10) / 10;
+}
+function detectAutonomySignal(input) {
+    const text = (input || '').trim();
+    if (AUTONOMY_HIGH_RE.test(text))
+        return 5;
+    if (QUESTION_RE.test(text))
+        return 2;
+    return null;
+}
+export function updateCalibration(calibration, input, correction = false) {
+    const { specificity: newSpec } = analyzeInput(input);
+    const autonomySignal = detectAutonomySignal(input);
+    const prev = {
+        specificity: calibration.specificity ?? 3,
+        corrections: calibration.corrections ?? 3,
+        autonomy: calibration.autonomy ?? 3,
+        interactions: calibration.interactions ?? 0
+    };
+    const specificity = round1(clamp(prev.specificity * 0.7 + newSpec * 0.3));
+    const corrections = round1(clamp(correction ? prev.corrections - 0.3 : prev.corrections + 0.1));
+    let autonomy = prev.autonomy;
+    if (autonomySignal !== null) {
+        autonomy = round1(clamp(prev.autonomy * 0.7 + autonomySignal * 0.3));
+    }
+    return {
+        specificity,
+        corrections,
+        autonomy,
+        interactions: prev.interactions + 1,
+        lastUpdated: new Date().toISOString()
+    };
+}
+export function getAdaptation(calibration) {
+    const s = calibration.specificity ?? 3;
+    const c = calibration.corrections ?? 3;
+    const a = calibration.autonomy ?? 3;
+    const clarifyBeforeActing = s < 2.5 || c > 3;
+    const explainReasoning = a < 3;
+    const suggestNextSteps = a < 4;
+    const askForApproval = c < 2.5;
+    const autoExecute = a > 4 && c > 3.5;
+    let responseStyle;
+    const combined = (s + c + a) / 3;
+    if (combined >= 4) {
+        responseStyle = 'terse';
+    }
+    else if (combined >= 2.5) {
+        responseStyle = 'normal';
+    }
+    else {
+        responseStyle = 'detailed';
+    }
+    let userLevel;
+    if (s >= 4) {
+        userLevel = 'advanced';
+    }
+    else if (s >= 2.5) {
+        userLevel = 'intermediate';
+    }
+    else {
+        userLevel = 'beginner';
+    }
+    return {
+        clarifyBeforeActing,
+        explainReasoning,
+        suggestNextSteps,
+        askForApproval,
+        autoExecute,
+        responseStyle,
+        userLevel
+    };
+}
+export function formatCalibration(calibration) {
+    const { userLevel, responseStyle } = getAdaptation(calibration);
+    const s = calibration.specificity ?? 3;
+    const c = calibration.corrections ?? 3;
+    const a = calibration.autonomy ?? 3;
+    const autonomyLabel = a >= 4 ? 'high autonomy' : a >= 2.5 ? 'normal autonomy' : 'low autonomy';
+    const trustLabel = c >= 4 ? 'high trust' : c >= 2.5 ? 'good trust' : 'low trust';
+    return `User: ${userLevel} · ${autonomyLabel} · ${trustLabel}\n      (specificity: ${s}, corrections: ${c}, autonomy: ${a})`;
+}
+//# sourceMappingURL=calibration.js.map

package/dist/src/calibration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibration.js","sourceRoot":"","sources":["../../src/calibration.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,oFAAoF;AAEpF,MAAM,WAAW,GAAG,wEAAwE,CAAC;AAC7F,MAAM,YAAY,GAAG,oqBAAoqB,CAAC;AAC1rB,MAAM,QAAQ,GAAG,sIAAsI,CAAC;AACxJ,MAAM,gBAAgB,GAAG,mKAAmK,CAAC;AAC7L,MAAM,WAAW,GAAG,qGAAqG,CAAC;AAC1H,MAAM,aAAa,GAAG,kHAAkH,CAAC;AAazI,MAAM,UAAU,YAAY,CAAC,KAAgC;IAC3D,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;IAE/B,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,oBAAoB,GAAG,+JAA+J,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxM,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC;IAEpE,IAAI,WAAmB,CAAC;IACxB,IAAI,WAAW,IAAI,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,oBAAoB,CAAC,EAAE,CAAC;QACnG,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;SAAM,IAAI,YAAY,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAC1C,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;SAAM,IAAI,CAAC,OAAO,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACtC,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;SAAM,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACtC,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,WAAW;QACX,OAAO,EAAE;YACP,WAAW;YACX,YAAY;YACZ,oBAAoB;YACpB,OAAO;YACP,SAAS;SACV;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAgC;IAC5D,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAUD,MAAM,UAAU,iBAAiB,CAAC,WAAwB,EAAE,KAAa,EAAE,UAAU,GAAG,KAAK;IAC3F,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,cAAc,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEnD,MAAM,IAAI,GAAG;QACX,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,CAAC;QACzC,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,CAAC;QACzC,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,CAAC;QACnC,YAAY,EAAE,WAAW,CAAC,YAAY,IAAI,CAAC;KAC5C,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;IAE1E,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAC9B,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,GAAG,CAC7D,CAAC,CAAC;IAEH,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC7B,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,GAAG,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,WAAW;QACX,WAAW;QACX,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,YAAY,GAAG,CAAC;QACnC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAYD,MAAM,UAAU,aAAa,CAAC,WAAwB;IACpD,MAAM,CAAC,GAAG,WAAW,CAAC,WAAW,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,WAAW,CAAC,WAAW,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,IAAI,CAAC,CAAC;IAEpC,MAAM,mBAAmB,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,gBAAgB,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,cAAc,GAAG,CAAC,GAAG,GAAG,CAAC;IAC/B,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;IAErC,IAAI,aAA8C,CAAC;IACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;QAClB,aAAa,GAAG,OAAO,CAAC;IAC1B,CAAC;SAAM,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;QAC3B,aAAa,GAAG,QAAQ,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,aAAa,GAAG,UAAU,CAAC;IAC7B,CAAC;IAED,IAAI,SAAmD,CAAC;IACxD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,SAAS,GAAG,UAAU,CAAC;IACzB,CAAC;SAAM,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,SAAS,GAAG,cAAc,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,UAAU,CAAC;IACzB,CAAC;IAED,OAAO;QACL,mBAAmB;QACnB,gBAAgB;QAChB,gBAAgB;QAChB,cAAc;QACd,WAAW;QACX,aAAa;QACb,SAAS;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAwB;IACxD,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,CAAC,GAAG,WAAW,CAAC,WAAW,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,WAAW,CAAC,WAAW,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,WAAW,CAAC,QAAQ,IAAI,CAAC,CAAC;IAEpC,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC;IAC/F,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IAEjF,OAAO,SAAS,SAAS,MAAM,aAAa,MAAM,UAAU,yBAAyB,CAAC,kBAAkB,CAAC,eAAe,CAAC,GAAG,CAAC;AAC/H,CAAC"}

package/dist/src/checkpoint.d.ts

@@ -0,0 +1,33 @@
+export interface CheckpointResult {
+    success: boolean;
+    id: string | null;
+    label: string;
+    timestamp: string;
+}
+interface CheckpointEntry {
+    id: string;
+    label: string;
+    timestamp: string;
+    type: string;
+    tag?: string;
+    status: string;
+}
+/**
+ * Check if checkpoint capability is available.
+ */
+export declare function hasCheckpoints(): boolean;
+/**
+ * Create a checkpoint before a risky operation.
+ */
+export declare function createCheckpoint(label: string, opts?: {
+    cwd?: string;
+}): CheckpointResult;
+/**
+ * List recent checkpoints (most recent first, up to 20).
+ */
+export declare function listCheckpoints(cwd?: string): CheckpointEntry[];
+/**
+ * Get the most recent checkpoint.
+ */
+export declare function getLastCheckpoint(cwd?: string): CheckpointEntry | null;
+export {};

package/dist/src/checkpoint.js

@@ -0,0 +1,99 @@
+// checkpoint.ts — Checkpoint wrapper for dual-brain execution safety.
+// Wraps Replit's native checkpoint system with a git-based fallback.
+// Exports: hasCheckpoints, createCheckpoint, listCheckpoints, getLastCheckpoint
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execSync } from 'node:child_process';
+/**
+ * Check if checkpoint capability is available.
+ */
+export function hasCheckpoints() {
+    try {
+        // Check for Replit checkpoint binary
+        if (existsSync('/usr/local/bin/replit-checkpoint'))
+            return true;
+        execSync('which replit-checkpoint', { stdio: 'pipe', timeout: 2000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a checkpoint before a risky operation.
+ */
+export function createCheckpoint(label, opts = {}) {
+    const cwd = opts.cwd || process.cwd();
+    const timestamp = new Date().toISOString();
+    const id = `cp-${Date.now()}`;
+    // Try Replit checkpoint first
+    if (hasCheckpoints()) {
+        try {
+            execSync('replit-checkpoint create', { cwd, stdio: 'pipe', timeout: 10000 });
+            _logCheckpoint({ id, label, timestamp, type: 'replit', status: 'created' }, cwd);
+            return { success: true, id, label, timestamp };
+        }
+        catch {
+            // Fall through to git-based checkpoint
+        }
+    }
+    // Fallback: git stash + tag
+    try {
+        // Stash any uncommitted changes
+        const status = execSync('git status --porcelain', { cwd, encoding: 'utf8', timeout: 5000 }).trim();
+        if (status) {
+            execSync(`git stash push -m "dual-brain-checkpoint: ${label}"`, { cwd, stdio: 'pipe', timeout: 10000 });
+            execSync('git stash pop', { cwd, stdio: 'pipe', timeout: 10000 });
+        }
+        // Create a lightweight tag
+        const safeLabel = label.replace(/[^a-zA-Z0-9-_]/g, '-').slice(0, 50);
+        const tagName = `db-checkpoint/${safeLabel}-${Date.now()}`;
+        execSync(`git tag "${tagName}"`, { cwd, stdio: 'pipe', timeout: 5000 });
+        _logCheckpoint({ id, label, timestamp, type: 'git-tag', tag: tagName, status: 'created' }, cwd);
+        return { success: true, id, label, timestamp };
+    }
+    catch {
+        _logCheckpoint({ id, label, timestamp, type: 'failed', status: 'failed' }, cwd);
+        return { success: false, id: null, label, timestamp };
+    }
+}
+/**
+ * List recent checkpoints (most recent first, up to 20).
+ */
+export function listCheckpoints(cwd) {
+    const logPath = join(cwd || process.cwd(), '.dual-brain', 'checkpoints.jsonl');
+    if (!existsSync(logPath))
+        return [];
+    try {
+        return readFileSync(logPath, 'utf8')
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map(line => JSON.parse(line))
+            .reverse()
+            .slice(0, 20);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the most recent checkpoint.
+ */
+export function getLastCheckpoint(cwd) {
+    const checkpoints = listCheckpoints(cwd);
+    return checkpoints[0] || null;
+}
+// ─── Internal helpers ─────────────────────────────────────────────────────────
+function _logCheckpoint(entry, cwd) {
+    const dir = join(cwd || process.cwd(), '.dual-brain');
+    mkdirSync(dir, { recursive: true });
+    const logPath = join(dir, 'checkpoints.jsonl');
+    const line = JSON.stringify(entry) + '\n';
+    try {
+        const existing = existsSync(logPath) ? readFileSync(logPath, 'utf8') : '';
+        writeFileSync(logPath, existing + line);
+    }
+    catch { /* non-fatal */ }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/src/checkpoint.js.map

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

package/dist/src/ci-triage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Detect CI system in use.
+ * @param {string} [cwd]
+ * @returns {{ systems: string[], primary: string|null }}
+ */
+export declare function detectCI(cwd?: string): {
+    systems: string[];
+    primary: string | null;
+};
+/**
+ * Get recent CI run status using gh CLI.
+ * @param {string} [cwd]
+ * @returns {{ available: boolean, runs: object[], hasFailures: boolean, lastRun: object|null }}
+ */
+export declare function getCIStatus(cwd?: string): {
+    available: boolean;
+    runs: unknown[];
+    hasFailures: boolean;
+    lastRun: unknown;
+};
+/**
+ * Get failed CI run logs and classify the failure.
+ * @param {string|number} runId
+ * @param {string} [cwd]
+ * @returns {object}
+ */
+export declare function triageFailure(runId: string | number, cwd?: string): Record<string, unknown>;
+/**
+ * Full CI triage: detect CI, fetch status, classify failures, map to files.
+ * @param {string} [cwd]
+ * @returns {object}
+ */
+export declare function fullTriage(cwd?: string): Record<string, unknown>;

package/dist/src/ci-triage.js

@@ -0,0 +1,193 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Detect CI system in use.
+ * @param {string} [cwd]
+ * @returns {{ systems: string[], primary: string|null }}
+ */
+export function detectCI(cwd) {
+    const root = cwd || process.cwd();
+    const systems = [];
+    if (existsSync(join(root, '.github/workflows')))
+        systems.push('github-actions');
+    if (existsSync(join(root, '.circleci')))
+        systems.push('circleci');
+    if (existsSync(join(root, '.gitlab-ci.yml')))
+        systems.push('gitlab-ci');
+    if (existsSync(join(root, 'Jenkinsfile')))
+        systems.push('jenkins');
+    if (existsSync(join(root, '.travis.yml')))
+        systems.push('travis');
+    if (existsSync(join(root, 'vercel.json')) || existsSync(join(root, '.vercel')))
+        systems.push('vercel');
+    if (existsSync(join(root, 'netlify.toml')))
+        systems.push('netlify');
+    return { systems, primary: systems[0] || null };
+}
+/**
+ * Get recent CI run status using gh CLI.
+ * @param {string} [cwd]
+ * @returns {{ available: boolean, runs: object[], hasFailures: boolean, lastRun: object|null }}
+ */
+export function getCIStatus(cwd) {
+    try {
+        const json = execSync('gh run list --limit 5 --json databaseId,name,status,conclusion,headBranch,createdAt', { cwd, encoding: 'utf8', timeout: 10000 });
+        const runs = JSON.parse(json);
+        return {
+            available: true,
+            runs: runs.map((r) => ({
+                id: r.databaseId,
+                name: r.name,
+                status: r.status,
+                conclusion: r.conclusion,
+                branch: r.headBranch,
+                createdAt: r.createdAt,
+            })),
+            hasFailures: runs.some((r) => r.conclusion === 'failure'),
+            lastRun: runs[0] || null,
+        };
+    }
+    catch {
+        return { available: false, runs: [], hasFailures: false, lastRun: null };
+    }
+}
+/**
+ * Get failed CI run logs and classify the failure.
+ * @param {string|number} runId
+ * @param {string} [cwd]
+ * @returns {object}
+ */
+export function triageFailure(runId, cwd) {
+    try {
+        const logs = execSync(`gh run view ${runId} --log-failed 2>/dev/null | tail -100`, {
+            cwd, encoding: 'utf8', timeout: 15000,
+        });
+        const classification = classifyFailure(logs);
+        const fileHints = extractFileHints(logs, cwd);
+        return {
+            success: true,
+            runId,
+            logs: logs.slice(-3000), // last 3000 chars
+            classification,
+            fileHints,
+            suggestedAction: getSuggestedAction(classification),
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, runId, error: msg };
+    }
+}
+/**
+ * Classify a CI failure from log output.
+ * @param {string} logs
+ * @returns {{ type: string, confidence: string }}
+ */
+function classifyFailure(logs) {
+    const lower = logs.toLowerCase();
+    if (lower.includes('syntaxerror') || lower.includes('parse error'))
+        return { type: 'syntax', confidence: 'high' };
+    if (lower.includes('typeerror') || lower.includes('type error'))
+        return { type: 'type-error', confidence: 'high' };
+    if (lower.includes('referenceerror'))
+        return { type: 'reference-error', confidence: 'high' };
+    if (lower.includes('test fail') || lower.includes('tests failed') || lower.includes('assertion'))
+        return { type: 'test-failure', confidence: 'high' };
+    if (lower.includes('enoent') || lower.includes('no such file'))
+        return { type: 'missing-file', confidence: 'high' };
+    if (lower.includes('permission denied') || lower.includes('eacces'))
+        return { type: 'permissions', confidence: 'high' };
+    if (lower.includes('timeout') || lower.includes('timed out'))
+        return { type: 'timeout', confidence: 'medium' };
+    if (lower.includes('out of memory') || lower.includes('heap'))
+        return { type: 'oom', confidence: 'medium' };
+    if (lower.includes('npm err') || lower.includes('yarn error') || lower.includes('dependency'))
+        return { type: 'dependency', confidence: 'medium' };
+    if (lower.includes('lint') || lower.includes('eslint'))
+        return { type: 'lint', confidence: 'high' };
+    if (lower.includes('build fail'))
+        return { type: 'build', confidence: 'medium' };
+    if (lower.includes('docker') || lower.includes('container'))
+        return { type: 'container', confidence: 'medium' };
+    return { type: 'unknown', confidence: 'low' };
+}
+/**
+ * Extract local file paths referenced in CI logs.
+ * @param {string} logs
+ * @param {string} [cwd]
+ * @returns {string[]}
+ */
+function extractFileHints(logs, cwd) {
+    const files = new Set();
+    const root = cwd || process.cwd();
+    const patterns = [
+        /(?:at\s+)?([a-zA-Z0-9_./\\-]+\.[a-zA-Z]+):(\d+)/g,
+        /(?:in\s+)?([a-zA-Z0-9_./\\-]+\.[a-zA-Z]+)\((\d+)\)/g,
+        /Error in ([a-zA-Z0-9_./\\-]+\.[a-zA-Z]+)/g,
+    ];
+    for (const pattern of patterns) {
+        for (const match of logs.matchAll(pattern)) {
+            const file = match[1];
+            if (file && !file.includes('node_modules') && existsSync(join(root, file))) {
+                files.add(file);
+            }
+        }
+    }
+    return [...files];
+}
+/**
+ * Get a human-readable suggested action for a failure classification.
+ * @param {{ type: string }} classification
+ * @returns {string}
+ */
+function getSuggestedAction(classification) {
+    const actions = {
+        'syntax': 'Fix syntax error in the identified file',
+        'type-error': 'Check type annotations and function signatures',
+        'reference-error': 'Check for undefined variables or missing imports',
+        'test-failure': 'Run tests locally and fix failing assertions',
+        'missing-file': 'Check if a required file was deleted or not committed',
+        'permissions': 'Check file permissions and access rights',
+        'timeout': 'Investigate slow operations or increase timeout',
+        'oom': 'Check for memory leaks or reduce batch size',
+        'dependency': 'Run npm install and check for version conflicts',
+        'lint': 'Run linter locally and fix violations',
+        'build': 'Check build configuration and dependencies',
+        'container': 'Check Dockerfile and container configuration',
+        'unknown': 'Review full CI logs for error details',
+    };
+    return actions[classification.type] || actions.unknown;
+}
+/**
+ * Full CI triage: detect CI, fetch status, classify failures, map to files.
+ * @param {string} [cwd]
+ * @returns {object}
+ */
+export function fullTriage(cwd) {
+    const ci = detectCI(cwd);
+    if (!ci.primary)
+        return { available: false, reason: 'no-ci-detected' };
+    const status = getCIStatus(cwd);
+    if (!status.available)
+        return { available: false, reason: 'gh-cli-unavailable' };
+    if (!status.hasFailures)
+        return { available: true, healthy: true, message: 'All CI runs passing' };
+    const failedRuns = status.runs.filter((r) => r.conclusion === 'failure');
+    const triages = failedRuns.slice(0, 3).map((r) => triageFailure(r.id, cwd));
+    return {
+        available: true,
+        healthy: false,
+        failedRuns: failedRuns.length,
+        triages,
+        topIssue: triages[0]?.classification || null,
+    };
+}
+// ─── CLI (direct invocation) ──────────────────────────────────────────────────
+const isMain = process.argv[1]?.endsWith('ci-triage.ts') || process.argv[1]?.endsWith('ci-triage.js');
+if (isMain) {
+    const cwd = process.argv[2] || process.cwd();
+    const result = fullTriage(cwd);
+    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+}
+//# sourceMappingURL=ci-triage.js.map

package/dist/src/ci-triage.js.map

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

package/dist/src/cognitive-loop.d.ts

@@ -0,0 +1,56 @@
+interface LoopAction {
+    type: string;
+    mode?: string;
+}
+interface LoopResult {
+    phase: string;
+    action: LoopAction;
+    rationale?: string;
+    shouldAskUser?: boolean;
+    surfaceNoticings?: unknown[];
+    plan: unknown | null;
+    nextDispatch: unknown | null;
+    mode?: {
+        primary: string;
+        confidence: number;
+    };
+    estimatedCost?: number;
+    suggestion?: unknown;
+    waveSummary?: unknown;
+    replanned?: boolean;
+    gateCondition?: string;
+}
+interface LoopContext {
+    files?: string[];
+    recentFiles?: string[];
+    priorFailures?: unknown[];
+    uncommittedFiles?: string[];
+    _detectedIntent?: string | null;
+    _immersionContext?: string;
+    _inboxBrief?: string;
+    _crystallizedIdeas?: string[];
+    _updateNotice?: string;
+    priorDebriefs?: unknown[];
+    [key: string]: unknown;
+}
+/**
+ * Entry point: process a user message through the full cognitive loop.
+ * Returns a LoopResult that tells the caller exactly what to do next.
+ */
+export declare function enter(userMessage: string, context?: LoopContext): LoopResult;
+/**
+ * Called after a wave completes. Processes debriefs and determines next action.
+ */
+export declare function advance(rawResults: string[], completedWaveId: string, context?: LoopContext): LoopResult;
+export declare function getActivePlan(): unknown;
+export declare function getLoopStatus(): {
+    hasActivePlan: boolean;
+    completedWaves: number;
+    totalWaves: number;
+    replans: number;
+    totalDispatches: number;
+    debriefCount: number;
+};
+export declare function resetLoop(): void;
+export declare function shutdown(): void;
+export {};