@codeledger/engine 0.7.0

package/dist/iole/failure-vector.js

@@ -0,0 +1,156 @@
+/**
+ * IOLE — Failure Vector
+ *
+ * Parses agent execution failures (test output, stack traces, rejected diffs)
+ * into a structured FailureVector that the expansion ladder uses to determine
+ * which files to add in the next context iteration.
+ *
+ * Deterministic: parses raw strings, no ML, no embeddings.
+ */
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Parse raw output strings into a structured FailureVector.
+ *
+ * Handles:
+ * - Test runner output (vitest, jest, mocha patterns)
+ * - Node.js/TypeScript stack traces
+ * - Build errors (tsc, esbuild)
+ * - Rejected diffs (conflict markers)
+ */
+export function parseFailureVector(outputs) {
+    const combined = outputs.join('\n');
+    const failures = [];
+    const implicated_files = new Set();
+    const implicated_symbols = new Set();
+    // 1. Extract failing test names
+    const testFailures = extractTestFailures(combined);
+    for (const f of testFailures) {
+        failures.push(f);
+        if (f.file)
+            implicated_files.add(f.file);
+        if (f.symbol)
+            implicated_symbols.add(f.symbol);
+    }
+    // 2. Extract stack trace frames
+    const stackFrames = extractStackTraceFiles(combined);
+    for (const f of stackFrames) {
+        implicated_files.add(f);
+    }
+    // 3. Extract build errors
+    const buildErrors = extractBuildErrors(combined);
+    for (const f of buildErrors) {
+        failures.push(f);
+        if (f.file)
+            implicated_files.add(f.file);
+    }
+    // 4. Detect kind summary
+    const kind = summarizeKind(failures);
+    return {
+        kind,
+        failures,
+        implicated_files: [...implicated_files],
+        implicated_symbols: [...implicated_symbols],
+        raw_output_hash: hashOutputs(combined),
+        parsed_at: new Date().toISOString(),
+    };
+}
+function extractTestFailures(output) {
+    const failures = [];
+    // Vitest/Jest: "✕ test name" or "× test name" or "FAIL src/foo.test.ts"
+    const vitestFailRe = /[✕×✗●]\s+(.+)/g;
+    let m;
+    while ((m = vitestFailRe.exec(output)) !== null) {
+        failures.push({
+            kind: 'test_failure',
+            message: m[1]?.trim() ?? '',
+        });
+    }
+    // Jest: "● describe > test name"
+    const jestRe = /●\s+(.+)/g;
+    while ((m = jestRe.exec(output)) !== null) {
+        const msg = m[1]?.trim() ?? '';
+        if (!failures.some((f) => f.message === msg)) {
+            failures.push({ kind: 'test_failure', message: msg });
+        }
+    }
+    // File-level failures: "FAIL src/foo.test.ts"
+    const fileFailRe = /(?:FAIL|FAILED)\s+([\w./\-@]+\.test\.[tj]sx?)/g;
+    while ((m = fileFailRe.exec(output)) !== null) {
+        failures.push({
+            kind: 'test_failure',
+            message: `Test file failed: ${m[1]}`,
+            file: m[1],
+        });
+    }
+    return failures;
+}
+function extractStackTraceFiles(output) {
+    const files = [];
+    // Node stack trace: "    at Object.<anonymous> (src/foo.ts:42:10)"
+    const stackRe = /at\s+[\w.<>[\]]+\s+\(([^)]+\.(?:ts|tsx|js|jsx)):(\d+):\d+\)/g;
+    let m;
+    while ((m = stackRe.exec(output)) !== null) {
+        if (m[1] && !m[1].includes('node_modules')) {
+            files.push(m[1]);
+        }
+    }
+    // Simple "at src/foo.ts:42" pattern
+    const simpleRe = /at\s+([\w./\-@]+\.(?:ts|tsx|js|jsx)):(\d+)/g;
+    while ((m = simpleRe.exec(output)) !== null) {
+        if (m[1] && !m[1].includes('node_modules')) {
+            files.push(m[1]);
+        }
+    }
+    return [...new Set(files)];
+}
+function extractBuildErrors(output) {
+    const failures = [];
+    // TypeScript errors: "src/foo.ts(42,10): error TS2304: Cannot find name 'bar'."
+    const tscRe = /([\w./\-@]+\.tsx?)\((\d+),\d+\):\s+error\s+(TS\d+):\s+(.+)/g;
+    let m;
+    while ((m = tscRe.exec(output)) !== null) {
+        failures.push({
+            kind: 'build_error',
+            message: `${m[3]}: ${m[4]?.trim()}`,
+            file: m[1],
+            line: parseInt(m[2] ?? '0', 10),
+            symbol: extractSymbolFromTscError(m[4] ?? ''),
+        });
+    }
+    // ESBuild errors: "src/foo.ts:42:10: error: ..."
+    const esbuildRe = /([\w./\-@]+\.tsx?):\d+:\d+:\s+error:\s+(.+)/g;
+    while ((m = esbuildRe.exec(output)) !== null) {
+        failures.push({
+            kind: 'build_error',
+            message: m[2]?.trim() ?? '',
+            file: m[1],
+        });
+    }
+    return failures;
+}
+function extractSymbolFromTscError(msg) {
+    // "Cannot find name 'foo'" → "foo"
+    const nameRe = /'(\w+)'/;
+    const m = nameRe.exec(msg);
+    return m?.[1];
+}
+function summarizeKind(failures) {
+    const kinds = new Set(failures.map((f) => f.kind));
+    if (kinds.has('build_error'))
+        return 'build_error';
+    if (kinds.has('test_failure'))
+        return 'test_failure';
+    if (kinds.size > 0)
+        return [...kinds][0];
+    return 'unknown';
+}
+function hashOutputs(combined) {
+    // Simple non-crypto hash for deduplication (FNV-1a)
+    let h = 2166136261;
+    for (let i = 0; i < combined.length; i++) {
+        h ^= combined.charCodeAt(i);
+        h = (h * 16777619) >>> 0;
+    }
+    return h.toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=failure-vector.js.map

package/dist/iole/failure-vector.js.map

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

package/dist/iole/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * IOLE — Intent & Outcome Loop Engine
+ *
+ * Eliminates agent drift and stuck loops via deterministic feedback loops.
+ *
+ * Subsystems:
+ * - intent-signature: Derive stable hash from task prompt; detect drift
+ * - failure-vector: Parse test/build/trace failures into structured form
+ * - expansion-ladder: 4-level context escalation triggered by failures
+ * - outcome-score: Track pass rates, stability, improvement trends
+ */
+export { deriveIntentSignature, compareIntentSignatures, } from './intent-signature.js';
+export type { IntentDriftLevel, IntentDriftResult } from './intent-signature.js';
+export { parseFailureVector } from './failure-vector.js';
+export { initExpansionLadder, recordOutcome, getLevelParams, isStuck, } from './expansion-ladder.js';
+export type { LevelParams } from './expansion-ladder.js';
+export { computeOutcomeScore, recordIteration } from './outcome-score.js';
+export { decomposeIntent, compareIntentObjects, } from './intent-decomposition.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/iole/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,OAAO,GACR,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/iole/index.js

@@ -0,0 +1,17 @@
+/**
+ * IOLE — Intent & Outcome Loop Engine
+ *
+ * Eliminates agent drift and stuck loops via deterministic feedback loops.
+ *
+ * Subsystems:
+ * - intent-signature: Derive stable hash from task prompt; detect drift
+ * - failure-vector: Parse test/build/trace failures into structured form
+ * - expansion-ladder: 4-level context escalation triggered by failures
+ * - outcome-score: Track pass rates, stability, improvement trends
+ */
+export { deriveIntentSignature, compareIntentSignatures, } from './intent-signature.js';
+export { parseFailureVector } from './failure-vector.js';
+export { initExpansionLadder, recordOutcome, getLevelParams, isStuck, } from './expansion-ladder.js';
+export { computeOutcomeScore, recordIteration } from './outcome-score.js';
+export { decomposeIntent, compareIntentObjects, } from './intent-decomposition.js';
+//# sourceMappingURL=index.js.map

package/dist/iole/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/iole/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,OAAO,GACR,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EACL,eAAe,EACf,oBAAoB,GACrB,MAAM,2BAA2B,CAAC"}

package/dist/iole/intent-decomposition.d.ts

@@ -0,0 +1,33 @@
+/**
+ * IOLE — Intent Decomposition Engine
+ *
+ * Upgrades the intent signature to a fully structured IntentObject:
+ *   { domain, operation, layer, entities, constraints }
+ *
+ * All extraction uses deterministic keyword parsing — no embeddings, no LLMs.
+ * Same task string → same IntentObject.
+ *
+ * Benefits over raw intent signature:
+ * - Smarter expansion ladder decisions (bug in routes layer → add route deps)
+ * - Better exemplar matching (feature in services → fetch service exemplar)
+ * - Reusable across sessions (IntentObjects can be compared structurally)
+ */
+import type { IntentObject } from '@codeledger/types';
+/**
+ * Decompose a task string into a structured IntentObject.
+ *
+ * All extraction is deterministic keyword/regex parsing.
+ * Same task → same IntentObject (modulo timestamp).
+ *
+ * v2.1.1 additions:
+ * - `category`: deterministic "{domain}_{operation}" or "general_task" fallback
+ * - `intentConfidence`: 0–1 score reflecting extraction quality (low = ambiguous input)
+ */
+export declare function decomposeIntent(task: string): IntentObject;
+/**
+ * Compare two IntentObjects for semantic similarity.
+ * Returns a score from 0 (completely different) to 1 (identical).
+ * Used by the expansion ladder to detect if intent shifted between iterations.
+ */
+export declare function compareIntentObjects(a: IntentObject, b: IntentObject): number;
+//# sourceMappingURL=intent-decomposition.d.ts.map

package/dist/iole/intent-decomposition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-decomposition.d.ts","sourceRoot":"","sources":["../../src/iole/intent-decomposition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAqB,MAAM,mBAAmB,CAAC;AAuGzE;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAmE1D;AA0DD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAiC7E"}

package/dist/iole/intent-decomposition.js

@@ -0,0 +1,252 @@
+/**
+ * IOLE — Intent Decomposition Engine
+ *
+ * Upgrades the intent signature to a fully structured IntentObject:
+ *   { domain, operation, layer, entities, constraints }
+ *
+ * All extraction uses deterministic keyword parsing — no embeddings, no LLMs.
+ * Same task string → same IntentObject.
+ *
+ * Benefits over raw intent signature:
+ * - Smarter expansion ladder decisions (bug in routes layer → add route deps)
+ * - Better exemplar matching (feature in services → fetch service exemplar)
+ * - Reusable across sessions (IntentObjects can be compared structurally)
+ */
+// ─── Domain Patterns ─────────────────────────────────────────────────────────
+const DOMAIN_PATTERNS = [
+    [/\b(auth|authen|login|logout|jwt|token|session|oauth|permission|rbac)\b/i, 'auth'],
+    [/\b(api|endpoint|route|rest|graphql|grpc|handler|controller)\b/i, 'api'],
+    [/\b(db|database|sql|query|migration|schema|prisma|orm|mongo|postgres|mysql)\b/i, 'database'],
+    [/\b(ui|component|render|view|page|screen|frontend|react|vue|svelte)\b/i, 'ui'],
+    [/\b(payment|billing|stripe|invoice|subscription|checkout)\b/i, 'payments'],
+    [/\b(email|notification|smtp|sendgrid|webhook|event|message|queue)\b/i, 'messaging'],
+    [/\b(cache|redis|memory|performance|latency|throughput|speed)\b/i, 'performance'],
+    [/\b(deploy|ci|cd|docker|kubernetes|infra|pipeline|workflow)\b/i, 'infrastructure'],
+    [/\b(test|spec|coverage|mock|stub|fixture|assertion)\b/i, 'testing'],
+    [/\b(config|env|setting|flag|feature.flag|dotenv)\b/i, 'config'],
+    [/\b(log|logger|trace|telemetry|metric|monitor|observ)\b/i, 'observability'],
+    [/\b(search|index|elastic|solr|fulltext|filter|sort)\b/i, 'search'],
+    [/\b(file|upload|download|storage|s3|blob|asset|media)\b/i, 'storage'],
+    [/\b(security|crypto|encrypt|decrypt|hash|salt|secret|vulnerability)\b/i, 'security'],
+];
+// ─── Layer Patterns ───────────────────────────────────────────────────────────
+const LAYER_PATTERNS = [
+    [/\b(type|interface|schema|model|entity|dto|struct)\b/i, 'types'],
+    [/\b(route|endpoint|handler|controller|resource)\b/i, 'routes'],
+    [/\b(service|business.logic|use.case|usecase|domain)\b/i, 'services'],
+    [/\b(test|spec|unit|integration|e2e|fixture)\b/i, 'tests'],
+    [/\b(config|setting|env|environment)\b/i, 'config'],
+    [/\b(infra|deploy|pipeline|migration|seed)\b/i, 'infra'],
+    [/\b(model|repository|dao|store|persist|storage)\b/i, 'models'],
+];
+// ─── Operation Patterns ───────────────────────────────────────────────────────
+const OPERATION_PATTERNS = [
+    [/\b(fix|bug|error|crash|broken|fail|issue|regression|resolve|debug)\b/i, 'bugfix'],
+    [/\b(add|create|implement|new|build|introduce|feature|extend|support)\b/i, 'feature'],
+    [/\b(refactor|extract|cleanup|rename|reorganize|simplify|move|restructure)\b/i, 'refactor'],
+    [/\b(test|spec|coverage|assertion|mock|vitest|jest)\b/i, 'test_update'],
+    [/\b(config|env|setting|env.var|deploy|ci|yaml|toml|json)\b/i, 'config'],
+];
+// ─── Constraint Patterns ──────────────────────────────────────────────────────
+const CONSTRAINT_PATTERNS = [
+    [/\bno\s+breaking\s+change/i, 'no breaking changes'],
+    [/\bbackward.compat/i, 'maintain backward compatibility'],
+    [/\btype.safe/i, 'must be type-safe'],
+    [/\bno\s+migration/i, 'no database migration'],
+    [/\bperformance/i, 'preserve performance'],
+    [/\bsecurity/i, 'must not introduce security issues'],
+    [/\btest\s+must\s+pass/i, 'all tests must pass'],
+    [/\bno\s+new\s+dep/i, 'no new dependencies'],
+    [/\bminimal\s+change/i, 'minimal diff'],
+];
+// ─── Entity Extraction ────────────────────────────────────────────────────────
+/**
+ * Extract specific named entities from a task string.
+ * Looks for: PascalCase names, camelCase identifiers, quoted strings,
+ * kebab-case file names, and explicit function/class references.
+ */
+function extractEntities(task) {
+    const entities = new Set();
+    // PascalCase (likely type/class names): AuthMiddleware, UserService
+    const pascalRe = /\b([A-Z][a-z]+(?:[A-Z][a-z]+)+)\b/g;
+    let m;
+    while ((m = pascalRe.exec(task)) !== null) {
+        entities.add(m[1]);
+    }
+    // camelCase identifiers: validateToken, getUserById
+    const camelRe = /\b([a-z][a-z]+[A-Z][a-zA-Z]+)\b/g;
+    while ((m = camelRe.exec(task)) !== null) {
+        if (m[1].length > 4)
+            entities.add(m[1]); // filter out very short camelCase
+    }
+    // Quoted strings: "auth middleware", 'user service'
+    const quotedRe = /['"]([^'"]{3,40})['"]/g;
+    while ((m = quotedRe.exec(task)) !== null) {
+        entities.add(m[1].trim());
+    }
+    // File-like references: auth.service.ts, user.controller.ts
+    const fileRe = /\b([\w-]+\.[tj]sx?)\b/g;
+    while ((m = fileRe.exec(task)) !== null) {
+        entities.add(m[1]);
+    }
+    // snake_case: validate_token, get_user_by_id
+    const snakeRe = /\b([a-z]{2,}(?:_[a-z]+){2,})\b/g;
+    while ((m = snakeRe.exec(task)) !== null) {
+        entities.add(m[1]);
+    }
+    return [...entities].slice(0, 10); // cap at 10 entities
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Decompose a task string into a structured IntentObject.
+ *
+ * All extraction is deterministic keyword/regex parsing.
+ * Same task → same IntentObject (modulo timestamp).
+ *
+ * v2.1.1 additions:
+ * - `category`: deterministic "{domain}_{operation}" or "general_task" fallback
+ * - `intentConfidence`: 0–1 score reflecting extraction quality (low = ambiguous input)
+ */
+export function decomposeIntent(task) {
+    const lower = task.toLowerCase();
+    // Domain
+    let domain = 'general';
+    let domainMatched = false;
+    for (const [pattern, name] of DOMAIN_PATTERNS) {
+        if (pattern.test(lower)) {
+            domain = name;
+            domainMatched = true;
+            break;
+        }
+    }
+    // Operation
+    let operation = 'unknown';
+    let operationMatched = false;
+    for (const [pattern, op] of OPERATION_PATTERNS) {
+        if (pattern.test(lower)) {
+            operation = op;
+            operationMatched = true;
+            break;
+        }
+    }
+    // Layer
+    let layer = 'unknown';
+    let layerMatched = false;
+    for (const [pattern, l] of LAYER_PATTERNS) {
+        if (pattern.test(lower)) {
+            layer = l;
+            layerMatched = true;
+            break;
+        }
+    }
+    // Entities
+    const entities = extractEntities(task);
+    // Constraints
+    const constraints = [];
+    for (const [pattern, constraint] of CONSTRAINT_PATTERNS) {
+        if (pattern.test(task)) {
+            constraints.push(constraint);
+        }
+    }
+    // Category: deterministic "{domain}_{operation}"; fallback when either is ambiguous
+    const category = deriveCategory(domain, operation, domainMatched, operationMatched);
+    // Intent confidence: fraction of extraction passes that produced a specific result
+    // (not falling back to default). Low confidence = ambiguous prompt.
+    const intentConfidence = computeIntentConfidence(domainMatched, operationMatched, layerMatched, entities.length);
+    return {
+        domain,
+        operation,
+        layer,
+        entities,
+        constraints,
+        category,
+        intentConfidence,
+        raw_task: task,
+        decomposed_at: new Date().toISOString(),
+    };
+}
+// ─── Category Derivation ──────────────────────────────────────────────────────
+/**
+ * Derive the aggregation category from domain + operation.
+ * Falls back to "general_task" when either is unknown/general.
+ *
+ * Examples: auth + bugfix → "auth_bugfix", api + feature → "api_feature"
+ */
+function deriveCategory(domain, operation, domainMatched, operationMatched) {
+    // Both specific → concrete category (enables meaningful history aggregation)
+    if (domainMatched && operationMatched) {
+        return `${domain}_${operation}`;
+    }
+    // Domain known, operation unknown → partial category (still useful for aggregation)
+    if (domainMatched && !operationMatched) {
+        return `${domain}_task`;
+    }
+    // Operation known, domain unknown → operation-level fallback
+    if (!domainMatched && operationMatched) {
+        return `general_${operation}`;
+    }
+    // Neither matched → generic fallback
+    return 'general_task';
+}
+// ─── Intent Confidence ────────────────────────────────────────────────────────
+/**
+ * Compute extraction confidence as a weighted fraction of signals that fired.
+ *
+ * Scoring:
+ * - Domain match    : 0.35 (most important — determines context area)
+ * - Operation match : 0.35 (determines what to do)
+ * - Layer match     : 0.15 (narrows architectural scope)
+ * - Entities found  : 0.15 (presence of specific names increases confidence)
+ */
+function computeIntentConfidence(domainMatched, operationMatched, layerMatched, entityCount) {
+    let score = 0;
+    if (domainMatched)
+        score += 0.35;
+    if (operationMatched)
+        score += 0.35;
+    if (layerMatched)
+        score += 0.15;
+    // Entities: at least 1 → full 0.15; 0 → 0
+    if (entityCount > 0)
+        score += 0.15;
+    return score; // already [0,1] by construction
+}
+/**
+ * Compare two IntentObjects for semantic similarity.
+ * Returns a score from 0 (completely different) to 1 (identical).
+ * Used by the expansion ladder to detect if intent shifted between iterations.
+ */
+export function compareIntentObjects(a, b) {
+    let score = 0;
+    let total = 0;
+    // Domain match (high weight)
+    total += 3;
+    if (a.domain === b.domain)
+        score += 3;
+    // Operation match
+    total += 2;
+    if (a.operation === b.operation)
+        score += 2;
+    // Layer match
+    total += 2;
+    if (a.layer === b.layer)
+        score += 2;
+    // Entity overlap (Jaccard on entity sets)
+    total += 2;
+    const aEnts = new Set(a.entities.map((e) => e.toLowerCase()));
+    const bEnts = new Set(b.entities.map((e) => e.toLowerCase()));
+    const intersection = [...aEnts].filter((e) => bEnts.has(e)).length;
+    const union = new Set([...aEnts, ...bEnts]).size;
+    if (union > 0)
+        score += 2 * (intersection / union);
+    // Constraint overlap
+    total += 1;
+    const aConst = new Set(a.constraints);
+    const bConst = new Set(b.constraints);
+    const constIntersect = [...aConst].filter((c) => bConst.has(c)).length;
+    const constUnion = new Set([...aConst, ...bConst]).size;
+    if (constUnion > 0)
+        score += constIntersect / constUnion;
+    return total > 0 ? score / total : 0;
+}
+//# sourceMappingURL=intent-decomposition.js.map

package/dist/iole/intent-decomposition.js.map

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

package/dist/iole/intent-signature.d.ts

@@ -0,0 +1,37 @@
+/**
+ * IOLE — Intent Signature
+ *
+ * Derives a stable, deterministic hash from a task prompt and optional
+ * CLI parameters. Used to detect intent drift across iterations and
+ * to correlate outcomes with their originating intent.
+ *
+ * Deterministic: same task string → same signature.
+ */
+import type { IntentSignature } from '@codeledger/types';
+/**
+ * Derive a deterministic IntentSignature from a task description.
+ *
+ * The signature includes:
+ * - A stable hash (SHA-256 truncated to 16 hex chars)
+ * - Normalized task keywords (lowercased, de-duped, sorted)
+ * - Inferred task category (bug_fix, feature_add, refactor, test_update, config, unknown)
+ * - Timestamp of derivation
+ */
+export declare function deriveIntentSignature(task: string, params?: Record<string, string>): IntentSignature;
+/**
+ * Compare two intent signatures to detect drift.
+ *
+ * Returns a DriftLevel:
+ * - 'none'    → same hash (identical intent)
+ * - 'minor'   → same category, similar keywords (Jaccard ≥ 0.6)
+ * - 'major'   → same category, diverged keywords (Jaccard 0.3–0.6)
+ * - 'critical' → different category or Jaccard < 0.3
+ */
+export declare function compareIntentSignatures(a: IntentSignature, b: IntentSignature): IntentDriftResult;
+export type IntentDriftLevel = 'none' | 'minor' | 'major' | 'critical';
+export interface IntentDriftResult {
+    level: IntentDriftLevel;
+    jaccard: number;
+    category_changed: boolean;
+}
+//# sourceMappingURL=intent-signature.d.ts.map

package/dist/iole/intent-signature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-signature.d.ts","sourceRoot":"","sources":["../../src/iole/intent-signature.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAClC,eAAe,CAoBjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,eAAe,EAClB,CAAC,EAAE,eAAe,GACjB,iBAAiB,CAkBnB;AAqDD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;CAC3B"}