threadwell 0.0.0 → 0.0.2

package/dist/core/memory/context/context-candidates.js

@@ -0,0 +1,64 @@
+const EPHEMERAL_PATTERNS = /\b(today|now|currently|temporary|todo|fix this|error log|stack trace|npm run|validation|token|secret|password)\b/i;
+function cleanTerm(value) {
+    return value
+        .replaceAll("`", "")
+        .replace(/[.:;]+$/g, "")
+        .trim();
+}
+function isUsefulTerm(term, meaning) {
+    if (term.length < 3 || meaning.length < 8)
+        return false;
+    if (term.length > 80 || meaning.length > 300)
+        return false;
+    if (EPHEMERAL_PATTERNS.test(`${term} ${meaning}`))
+        return false;
+    return /[A-Za-z]/.test(term) && /[A-Za-z]/.test(meaning);
+}
+function candidate(term, meaning, reason, confidence, source) {
+    const name = cleanTerm(term);
+    const description = cleanTerm(meaning);
+    if (!isUsefulTerm(name, description))
+        return undefined;
+    return { name, meaning: description, reason, confidence, source };
+}
+export function detectContextCandidates(text, source = "user") {
+    const candidates = [];
+    const patterns = [
+        {
+            regex: /\b(?:call|llam(?:a|emos)|use|usar)\s+(.+?)\s+(?:as|como)\s+(.+?)(?:\.|\n|$)/gi,
+            reason: "explicit naming convention",
+            confidence: 0.8,
+        },
+        {
+            regex: /\b(.+?)\s+(?:means|significa|is defined as|se define como)\s+(.+?)(?:\.|\n|$)/gi,
+            reason: "explicit term definition",
+            confidence: 0.85,
+        },
+        {
+            regex: /\b(?:in this project|en este proyecto),?\s+(.+?)\s+(?:means|significa|refers to|se refiere a)\s+(.+?)(?:\.|\n|$)/gi,
+            reason: "project-scoped vocabulary",
+            confidence: 0.9,
+        },
+    ];
+    for (const pattern of patterns) {
+        for (const match of text.matchAll(pattern.regex)) {
+            const found = candidate(match[1], match[2], pattern.reason, pattern.confidence, source);
+            if (found)
+                candidates.push(found);
+        }
+    }
+    return dedupeContextCandidates(candidates);
+}
+export function dedupeContextCandidates(candidates) {
+    const seen = new Set();
+    const deduped = [];
+    for (const entry of candidates) {
+        const key = entry.name.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        deduped.push(entry);
+    }
+    return deduped.sort((left, right) => right.confidence - left.confidence);
+}
+//# sourceMappingURL=context-candidates.js.map

package/dist/core/memory/context/context-candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-candidates.js","sourceRoot":"","sources":["../../../../src/core/memory/context/context-candidates.ts"],"names":[],"mappings":"AAQA,MAAM,kBAAkB,GACvB,mHAAmH,CAAC;AAErH,SAAS,SAAS,CAAC,KAAa,EAAU;IACzC,OAAO,KAAK;SACV,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,IAAI,EAAE,CAAC;AAAA,CACT;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,OAAe,EAAW;IAC7D,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAAA,CACzD;AAED,SAAS,SAAS,CACjB,IAAY,EACZ,OAAe,EACf,MAAc,EACd,UAAkB,EAClB,MAAkC,EACH;IAC/B,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAAA,CAClE;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,MAAM,GAA+B,MAAM,EAAsB;IACtH,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAiE;QAC9E;YACC,KAAK,EAAE,+EAA+E;YACtF,MAAM,EAAE,4BAA4B;YACpC,UAAU,EAAE,GAAG;SACf;QACD;YACC,KAAK,EAAE,iFAAiF;YACxF,MAAM,EAAE,0BAA0B;YAClC,UAAU,EAAE,IAAI;SAChB;QACD;YACC,KAAK,EAAE,oHAAoH;YAC3H,MAAM,EAAE,2BAA2B;YACnC,UAAU,EAAE,GAAG;SACf;KACD,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACxF,IAAI,KAAK;gBAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IACD,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAAA,CAC3C;AAED,MAAM,UAAU,uBAAuB,CAAC,UAAuC,EAAsB;IACpG,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;AAAA,CACzE","sourcesContent":["import type { ContextTerm } from \"./context-format.js\";\n\nexport interface ContextCandidate extends ContextTerm {\n\treason: string;\n\tconfidence: number;\n\tsource: \"user\" | \"assistant\" | \"memory\";\n}\n\nconst EPHEMERAL_PATTERNS =\n\t/\\b(today|now|currently|temporary|todo|fix this|error log|stack trace|npm run|validation|token|secret|password)\\b/i;\n\nfunction cleanTerm(value: string): string {\n\treturn value\n\t\t.replaceAll(\"`\", \"\")\n\t\t.replace(/[.:;]+$/g, \"\")\n\t\t.trim();\n}\n\nfunction isUsefulTerm(term: string, meaning: string): boolean {\n\tif (term.length < 3 || meaning.length < 8) return false;\n\tif (term.length > 80 || meaning.length > 300) return false;\n\tif (EPHEMERAL_PATTERNS.test(`${term} ${meaning}`)) return false;\n\treturn /[A-Za-z]/.test(term) && /[A-Za-z]/.test(meaning);\n}\n\nfunction candidate(\n\tterm: string,\n\tmeaning: string,\n\treason: string,\n\tconfidence: number,\n\tsource: ContextCandidate[\"source\"],\n): ContextCandidate | undefined {\n\tconst name = cleanTerm(term);\n\tconst description = cleanTerm(meaning);\n\tif (!isUsefulTerm(name, description)) return undefined;\n\treturn { name, meaning: description, reason, confidence, source };\n}\n\nexport function detectContextCandidates(text: string, source: ContextCandidate[\"source\"] = \"user\"): ContextCandidate[] {\n\tconst candidates: ContextCandidate[] = [];\n\tconst patterns: Array<{ regex: RegExp; reason: string; confidence: number }> = [\n\t\t{\n\t\t\tregex: /\\b(?:call|llam(?:a|emos)|use|usar)\\s+(.+?)\\s+(?:as|como)\\s+(.+?)(?:\\.|\\n|$)/gi,\n\t\t\treason: \"explicit naming convention\",\n\t\t\tconfidence: 0.8,\n\t\t},\n\t\t{\n\t\t\tregex: /\\b(.+?)\\s+(?:means|significa|is defined as|se define como)\\s+(.+?)(?:\\.|\\n|$)/gi,\n\t\t\treason: \"explicit term definition\",\n\t\t\tconfidence: 0.85,\n\t\t},\n\t\t{\n\t\t\tregex: /\\b(?:in this project|en este proyecto),?\\s+(.+?)\\s+(?:means|significa|refers to|se refiere a)\\s+(.+?)(?:\\.|\\n|$)/gi,\n\t\t\treason: \"project-scoped vocabulary\",\n\t\t\tconfidence: 0.9,\n\t\t},\n\t];\n\tfor (const pattern of patterns) {\n\t\tfor (const match of text.matchAll(pattern.regex)) {\n\t\t\tconst found = candidate(match[1], match[2], pattern.reason, pattern.confidence, source);\n\t\t\tif (found) candidates.push(found);\n\t\t}\n\t}\n\treturn dedupeContextCandidates(candidates);\n}\n\nexport function dedupeContextCandidates(candidates: readonly ContextCandidate[]): ContextCandidate[] {\n\tconst seen = new Set<string>();\n\tconst deduped: ContextCandidate[] = [];\n\tfor (const entry of candidates) {\n\t\tconst key = entry.name.toLowerCase();\n\t\tif (seen.has(key)) continue;\n\t\tseen.add(key);\n\t\tdeduped.push(entry);\n\t}\n\treturn deduped.sort((left, right) => right.confidence - left.confidence);\n}\n"]}

package/dist/core/memory/context/context-diagnostics.d.ts

@@ -0,0 +1,12 @@
+import type { ContextDocument } from "./context-format.js";
+export type ContextDiagnosticSeverity = "info" | "warning" | "error";
+export interface ContextDiagnostic {
+    severity: ContextDiagnosticSeverity;
+    code: string;
+    message: string;
+    term?: string;
+    suggestion?: string;
+}
+export declare function diagnoseContextDocument(document: ContextDocument): ContextDiagnostic[];
+export declare function renderContextDiagnostics(diagnostics: readonly ContextDiagnostic[]): string;
+//# sourceMappingURL=context-diagnostics.d.ts.map

package/dist/core/memory/context/context-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/context/context-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAmCtF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,CAU1F","sourcesContent":["import type { ContextDocument } from \"./context-format.js\";\n\nexport type ContextDiagnosticSeverity = \"info\" | \"warning\" | \"error\";\n\nexport interface ContextDiagnostic {\n\tseverity: ContextDiagnosticSeverity;\n\tcode: string;\n\tmessage: string;\n\tterm?: string;\n\tsuggestion?: string;\n}\n\nconst FORBIDDEN_HISTORY_PATTERNS =\n\t/\\b(npm run|stack trace|today I|current task|todo|temporary|raw output|password|secret|token)\\b/i;\n\nexport function diagnoseContextDocument(document: ContextDocument): ContextDiagnostic[] {\n\tconst diagnostics: ContextDiagnostic[] = [];\n\tconst seenTerms = new Map<string, string>();\n\tfor (const term of document.terms) {\n\t\tconst key = term.name.toLowerCase();\n\t\tconst existing = seenTerms.get(key);\n\t\tif (existing && existing !== term.meaning) {\n\t\t\tdiagnostics.push({\n\t\t\t\tseverity: \"warning\",\n\t\t\t\tcode: \"duplicate-term-conflict\",\n\t\t\t\tterm: term.name,\n\t\t\t\tmessage: `Term \"${term.name}\" has multiple meanings.`,\n\t\t\t\tsuggestion: \"Merge the duplicate entries or clarify aliases/related terms.\",\n\t\t\t});\n\t\t}\n\t\tseenTerms.set(key, term.meaning);\n\t\tif (FORBIDDEN_HISTORY_PATTERNS.test(`${term.name} ${term.meaning}`)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tseverity: \"warning\",\n\t\t\t\tcode: \"ephemeral-or-sensitive-term\",\n\t\t\t\tterm: term.name,\n\t\t\t\tmessage: `Term \"${term.name}\" looks ephemeral, task-history-like, or sensitive.`,\n\t\t\t\tsuggestion: \"Remove raw progress, validation output, secrets, or task history from CONTEXT.md.\",\n\t\t\t});\n\t\t}\n\t}\n\tif (!document.purpose.trim()) {\n\t\tdiagnostics.push({\n\t\t\tseverity: \"info\",\n\t\t\tcode: \"missing-purpose\",\n\t\t\tmessage: \"CONTEXT.md has no project purpose.\",\n\t\t\tsuggestion: \"Add a stable project purpose in the Purpose section.\",\n\t\t});\n\t}\n\treturn diagnostics;\n}\n\nexport function renderContextDiagnostics(diagnostics: readonly ContextDiagnostic[]): string {\n\tif (diagnostics.length === 0) return \"CONTEXT.md diagnostics: OK\";\n\treturn [\n\t\t\"CONTEXT.md diagnostics:\",\n\t\t...diagnostics.map((diagnostic) => {\n\t\t\tconst term = diagnostic.term ? ` (${diagnostic.term})` : \"\";\n\t\t\tconst suggestion = diagnostic.suggestion ? `\\n  suggestion: ${diagnostic.suggestion}` : \"\";\n\t\t\treturn `- ${diagnostic.severity} ${diagnostic.code}${term}: ${diagnostic.message}${suggestion}`;\n\t\t}),\n\t].join(\"\\n\");\n}\n"]}

package/dist/core/memory/context/context-diagnostics.js

@@ -0,0 +1,50 @@
+const FORBIDDEN_HISTORY_PATTERNS = /\b(npm run|stack trace|today I|current task|todo|temporary|raw output|password|secret|token)\b/i;
+export function diagnoseContextDocument(document) {
+    const diagnostics = [];
+    const seenTerms = new Map();
+    for (const term of document.terms) {
+        const key = term.name.toLowerCase();
+        const existing = seenTerms.get(key);
+        if (existing && existing !== term.meaning) {
+            diagnostics.push({
+                severity: "warning",
+                code: "duplicate-term-conflict",
+                term: term.name,
+                message: `Term "${term.name}" has multiple meanings.`,
+                suggestion: "Merge the duplicate entries or clarify aliases/related terms.",
+            });
+        }
+        seenTerms.set(key, term.meaning);
+        if (FORBIDDEN_HISTORY_PATTERNS.test(`${term.name} ${term.meaning}`)) {
+            diagnostics.push({
+                severity: "warning",
+                code: "ephemeral-or-sensitive-term",
+                term: term.name,
+                message: `Term "${term.name}" looks ephemeral, task-history-like, or sensitive.`,
+                suggestion: "Remove raw progress, validation output, secrets, or task history from CONTEXT.md.",
+            });
+        }
+    }
+    if (!document.purpose.trim()) {
+        diagnostics.push({
+            severity: "info",
+            code: "missing-purpose",
+            message: "CONTEXT.md has no project purpose.",
+            suggestion: "Add a stable project purpose in the Purpose section.",
+        });
+    }
+    return diagnostics;
+}
+export function renderContextDiagnostics(diagnostics) {
+    if (diagnostics.length === 0)
+        return "CONTEXT.md diagnostics: OK";
+    return [
+        "CONTEXT.md diagnostics:",
+        ...diagnostics.map((diagnostic) => {
+            const term = diagnostic.term ? ` (${diagnostic.term})` : "";
+            const suggestion = diagnostic.suggestion ? `\n  suggestion: ${diagnostic.suggestion}` : "";
+            return `- ${diagnostic.severity} ${diagnostic.code}${term}: ${diagnostic.message}${suggestion}`;
+        }),
+    ].join("\n");
+}
+//# sourceMappingURL=context-diagnostics.js.map

package/dist/core/memory/context/context-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-diagnostics.js","sourceRoot":"","sources":["../../../../src/core/memory/context/context-diagnostics.ts"],"names":[],"mappings":"AAYA,MAAM,0BAA0B,GAC/B,iGAAiG,CAAC;AAEnG,MAAM,UAAU,uBAAuB,CAAC,QAAyB,EAAuB;IACvF,MAAM,WAAW,GAAwB,EAAE,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,WAAW,CAAC,IAAI,CAAC;gBAChB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,yBAAyB;gBAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,0BAA0B;gBACrD,UAAU,EAAE,+DAA+D;aAC3E,CAAC,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,0BAA0B,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACrE,WAAW,CAAC,IAAI,CAAC;gBAChB,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,6BAA6B;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,qDAAqD;gBAChF,UAAU,EAAE,mFAAmF;aAC/F,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,CAAC;YAChB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,oCAAoC;YAC7C,UAAU,EAAE,sDAAsD;SAClE,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AAAA,CACnB;AAED,MAAM,UAAU,wBAAwB,CAAC,WAAyC,EAAU;IAC3F,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IAClE,OAAO;QACN,yBAAyB;QACzB,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3F,OAAO,KAAK,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI,GAAG,IAAI,KAAK,UAAU,CAAC,OAAO,GAAG,UAAU,EAAE,CAAC;QAAA,CAChG,CAAC;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACb","sourcesContent":["import type { ContextDocument } from \"./context-format.js\";\n\nexport type ContextDiagnosticSeverity = \"info\" | \"warning\" | \"error\";\n\nexport interface ContextDiagnostic {\n\tseverity: ContextDiagnosticSeverity;\n\tcode: string;\n\tmessage: string;\n\tterm?: string;\n\tsuggestion?: string;\n}\n\nconst FORBIDDEN_HISTORY_PATTERNS =\n\t/\\b(npm run|stack trace|today I|current task|todo|temporary|raw output|password|secret|token)\\b/i;\n\nexport function diagnoseContextDocument(document: ContextDocument): ContextDiagnostic[] {\n\tconst diagnostics: ContextDiagnostic[] = [];\n\tconst seenTerms = new Map<string, string>();\n\tfor (const term of document.terms) {\n\t\tconst key = term.name.toLowerCase();\n\t\tconst existing = seenTerms.get(key);\n\t\tif (existing && existing !== term.meaning) {\n\t\t\tdiagnostics.push({\n\t\t\t\tseverity: \"warning\",\n\t\t\t\tcode: \"duplicate-term-conflict\",\n\t\t\t\tterm: term.name,\n\t\t\t\tmessage: `Term \"${term.name}\" has multiple meanings.`,\n\t\t\t\tsuggestion: \"Merge the duplicate entries or clarify aliases/related terms.\",\n\t\t\t});\n\t\t}\n\t\tseenTerms.set(key, term.meaning);\n\t\tif (FORBIDDEN_HISTORY_PATTERNS.test(`${term.name} ${term.meaning}`)) {\n\t\t\tdiagnostics.push({\n\t\t\t\tseverity: \"warning\",\n\t\t\t\tcode: \"ephemeral-or-sensitive-term\",\n\t\t\t\tterm: term.name,\n\t\t\t\tmessage: `Term \"${term.name}\" looks ephemeral, task-history-like, or sensitive.`,\n\t\t\t\tsuggestion: \"Remove raw progress, validation output, secrets, or task history from CONTEXT.md.\",\n\t\t\t});\n\t\t}\n\t}\n\tif (!document.purpose.trim()) {\n\t\tdiagnostics.push({\n\t\t\tseverity: \"info\",\n\t\t\tcode: \"missing-purpose\",\n\t\t\tmessage: \"CONTEXT.md has no project purpose.\",\n\t\t\tsuggestion: \"Add a stable project purpose in the Purpose section.\",\n\t\t});\n\t}\n\treturn diagnostics;\n}\n\nexport function renderContextDiagnostics(diagnostics: readonly ContextDiagnostic[]): string {\n\tif (diagnostics.length === 0) return \"CONTEXT.md diagnostics: OK\";\n\treturn [\n\t\t\"CONTEXT.md diagnostics:\",\n\t\t...diagnostics.map((diagnostic) => {\n\t\t\tconst term = diagnostic.term ? ` (${diagnostic.term})` : \"\";\n\t\t\tconst suggestion = diagnostic.suggestion ? `\\n  suggestion: ${diagnostic.suggestion}` : \"\";\n\t\t\treturn `- ${diagnostic.severity} ${diagnostic.code}${term}: ${diagnostic.message}${suggestion}`;\n\t\t}),\n\t].join(\"\\n\");\n}\n"]}

package/dist/core/memory/context/context-format.d.ts

@@ -0,0 +1,41 @@
+export interface ContextTerm {
+    name: string;
+    meaning: string;
+    aliases?: string[];
+    related?: string[];
+}
+export interface ContextConvention {
+    name: string;
+    description: string;
+}
+export interface ContextDocument {
+    project: string;
+    purpose: string;
+    terms: ContextTerm[];
+    conventions: ContextConvention[];
+    openQuestions: string[];
+}
+export interface ContextWriteResult {
+    path: string;
+    changed: boolean;
+    addedTerms: string[];
+    skippedTerms: string[];
+}
+export declare const CONTEXT_FILE_NAME = "CONTEXT.md";
+export declare function createContextScaffold(projectName: string): string;
+export declare function parseContextDocument(markdown: string): ContextDocument;
+export declare function getContextPath(projectRoot: string): string;
+export declare function ensureContextScaffold(projectRoot: string, projectName: string): {
+    path: string;
+    created: boolean;
+};
+export declare function mergeAcceptedContextTerms(markdown: string, terms: readonly ContextTerm[]): {
+    markdown: string;
+    addedTerms: string[];
+    skippedTerms: string[];
+};
+export declare function writeAcceptedContextTerms(projectRoot: string, projectName: string, terms: readonly ContextTerm[]): ContextWriteResult;
+export declare function findRelevantContextTerms(document: ContextDocument, query: string, limit?: number): ContextTerm[];
+export declare function renderContextTerms(terms: readonly ContextTerm[]): string | undefined;
+export declare function readContextDocument(projectRoot: string): ContextDocument | undefined;
+//# sourceMappingURL=context-format.d.ts.map

package/dist/core/memory/context/context-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-format.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/context/context-format.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAW9C,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BjE;AA0DD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAQtE;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAMlH;AA0BD,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,WAAW,EAAE,GAC3B;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB,CAYA;AAED,wBAAgB,yBAAyB,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,WAAW,EAAE,GAC3B,kBAAkB,CAapB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,WAAW,EAAE,CAqB3G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,GAAG,SAAS,CAGpF;AAED,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAIpF","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nexport interface ContextTerm {\n\tname: string;\n\tmeaning: string;\n\taliases?: string[];\n\trelated?: string[];\n}\n\nexport interface ContextConvention {\n\tname: string;\n\tdescription: string;\n}\n\nexport interface ContextDocument {\n\tproject: string;\n\tpurpose: string;\n\tterms: ContextTerm[];\n\tconventions: ContextConvention[];\n\topenQuestions: string[];\n}\n\nexport interface ContextWriteResult {\n\tpath: string;\n\tchanged: boolean;\n\taddedTerms: string[];\n\tskippedTerms: string[];\n}\n\nexport const CONTEXT_FILE_NAME = \"CONTEXT.md\";\n\nconst SECTION_HEADINGS = [\n\t\"## Project\",\n\t\"## Purpose\",\n\t\"## Terms\",\n\t\"## Conventions\",\n\t\"## Open Questions\",\n\t\"## Not For This File\",\n] as const;\n\nexport function createContextScaffold(projectName: string): string {\n\treturn `# ${projectName} Context\n\n## Project\n\n${projectName}\n\n## Purpose\n\nDescribe the stable project purpose, domain, and mental model here.\n\n## Terms\n\n<!-- Threadwell writes accepted stable vocabulary here. Keep task history out. -->\n\n- **Example term**: Replace with project-specific language.\n  - Aliases: example alias\n  - Related: related concept\n\n## Conventions\n\n- **Naming**: Record durable naming and architecture conventions here.\n\n## Open Questions\n\n- Record durable semantic ambiguities that need user clarification.\n\n## Not For This File\n\nDo not store raw logs, transient task history, secrets, validation output, or ephemeral progress here.\n`;\n}\n\nfunction sectionBody(markdown: string, heading: string): string {\n\tconst start = markdown.indexOf(heading);\n\tif (start === -1) return \"\";\n\tconst bodyStart = start + heading.length;\n\tconst next = SECTION_HEADINGS.map((candidate) => markdown.indexOf(candidate, bodyStart))\n\t\t.filter((index) => index !== -1)\n\t\t.sort((left, right) => left - right)[0];\n\treturn markdown.slice(bodyStart, next ?? markdown.length).trim();\n}\n\nfunction parseTerms(body: string): ContextTerm[] {\n\tconst terms: ContextTerm[] = [];\n\tconst blocks = body.split(/\\n(?=- \\*\\*)/g);\n\tfor (const block of blocks) {\n\t\tconst firstLine = block.split(/\\r?\\n/, 1)[0]?.trim();\n\t\tconst match = firstLine?.match(/^- \\*\\*(.+?)\\*\\*:\\s*(.+)$/);\n\t\tif (!match) continue;\n\t\tconst aliases = block\n\t\t\t.match(/Aliases:\\s*(.+)/)?.[1]\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t\tconst related = block\n\t\t\t.match(/Related:\\s*(.+)/)?.[1]\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t\tterms.push({\n\t\t\tname: match[1].trim(),\n\t\t\tmeaning: match[2].trim(),\n\t\t\taliases: aliases && aliases.length > 0 ? aliases : undefined,\n\t\t\trelated: related && related.length > 0 ? related : undefined,\n\t\t});\n\t}\n\treturn terms;\n}\n\nfunction parseConventions(body: string): ContextConvention[] {\n\treturn body\n\t\t.split(/\\r?\\n/)\n\t\t.map((line) => line.trim())\n\t\t.flatMap((line) => {\n\t\t\tconst match = line.match(/^- \\*\\*(.+?)\\*\\*:\\s*(.+)$/);\n\t\t\treturn match ? [{ name: match[1].trim(), description: match[2].trim() }] : [];\n\t\t});\n}\n\nfunction parseList(body: string): string[] {\n\treturn body\n\t\t.split(/\\r?\\n/)\n\t\t.map((line) => line.trim())\n\t\t.filter((line) => line.startsWith(\"- \"))\n\t\t.map((line) => line.slice(2).trim())\n\t\t.filter(Boolean);\n}\n\nexport function parseContextDocument(markdown: string): ContextDocument {\n\treturn {\n\t\tproject: sectionBody(markdown, \"## Project\") || \"Unknown project\",\n\t\tpurpose: sectionBody(markdown, \"## Purpose\"),\n\t\tterms: parseTerms(sectionBody(markdown, \"## Terms\")),\n\t\tconventions: parseConventions(sectionBody(markdown, \"## Conventions\")),\n\t\topenQuestions: parseList(sectionBody(markdown, \"## Open Questions\")),\n\t};\n}\n\nexport function getContextPath(projectRoot: string): string {\n\treturn join(projectRoot, CONTEXT_FILE_NAME);\n}\n\nexport function ensureContextScaffold(projectRoot: string, projectName: string): { path: string; created: boolean } {\n\tconst path = getContextPath(projectRoot);\n\tif (existsSync(path)) return { path, created: false };\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteFileSync(path, createContextScaffold(projectName), \"utf-8\");\n\treturn { path, created: true };\n}\n\nfunction formatContextTerm(term: ContextTerm): string {\n\tconst aliases = term.aliases && term.aliases.length > 0 ? `\\n  - Aliases: ${term.aliases.join(\", \")}` : \"\";\n\tconst related = term.related && term.related.length > 0 ? `\\n  - Related: ${term.related.join(\", \")}` : \"\";\n\treturn `- **${term.name.trim()}**: ${term.meaning.trim()}${aliases}${related}`;\n}\n\nfunction isEphemeralContextTerm(term: ContextTerm): boolean {\n\tconst text = `${term.name} ${term.meaning}`.toLowerCase();\n\treturn /\\b(task|todo|log|today|yesterday|temporary|validation output|stack trace|raw output|secret|token|password)\\b/.test(\n\t\ttext,\n\t);\n}\n\nfunction insertBeforeNextSection(markdown: string, heading: string, content: string): string {\n\tconst start = markdown.indexOf(heading);\n\tif (start === -1) return `${markdown.trimEnd()}\\n\\n${heading}\\n\\n${content}\\n`;\n\tconst bodyStart = start + heading.length;\n\tconst next = SECTION_HEADINGS.map((candidate) => markdown.indexOf(candidate, bodyStart))\n\t\t.filter((index) => index !== -1)\n\t\t.sort((left, right) => left - right)[0];\n\tif (next === undefined) return `${markdown.trimEnd()}\\n${content}\\n`;\n\treturn `${markdown.slice(0, next).trimEnd()}\\n${content}\\n\\n${markdown.slice(next).trimStart()}`;\n}\n\nexport function mergeAcceptedContextTerms(\n\tmarkdown: string,\n\tterms: readonly ContextTerm[],\n): {\n\tmarkdown: string;\n\taddedTerms: string[];\n\tskippedTerms: string[];\n} {\n\tconst document = parseContextDocument(markdown);\n\tconst existing = new Set(document.terms.map((term) => term.name.toLowerCase()));\n\tconst accepted = terms.filter((term) => term.name.trim() && term.meaning.trim() && !isEphemeralContextTerm(term));\n\tconst added = accepted.filter((term) => !existing.has(term.name.toLowerCase()));\n\tconst skippedTerms = terms\n\t\t.filter((term) => !added.includes(term))\n\t\t.map((term) => term.name.trim())\n\t\t.filter(Boolean);\n\tif (added.length === 0) return { markdown, addedTerms: [], skippedTerms };\n\tconst nextMarkdown = insertBeforeNextSection(markdown, \"## Terms\", `\\n${added.map(formatContextTerm).join(\"\\n\")}`);\n\treturn { markdown: nextMarkdown, addedTerms: added.map((term) => term.name), skippedTerms };\n}\n\nexport function writeAcceptedContextTerms(\n\tprojectRoot: string,\n\tprojectName: string,\n\tterms: readonly ContextTerm[],\n): ContextWriteResult {\n\tconst scaffold = ensureContextScaffold(projectRoot, projectName);\n\tconst current = readFileSync(scaffold.path, \"utf-8\");\n\tconst merged = mergeAcceptedContextTerms(current, terms);\n\tif (merged.markdown !== current) {\n\t\twriteFileSync(scaffold.path, merged.markdown, \"utf-8\");\n\t}\n\treturn {\n\t\tpath: scaffold.path,\n\t\tchanged: merged.markdown !== current,\n\t\taddedTerms: merged.addedTerms,\n\t\tskippedTerms: merged.skippedTerms,\n\t};\n}\n\nexport function findRelevantContextTerms(document: ContextDocument, query: string, limit = 5): ContextTerm[] {\n\tconst tokens = new Set(\n\t\tquery\n\t\t\t.toLowerCase()\n\t\t\t.split(/[^a-z0-9_-]+/i)\n\t\t\t.map((token) => token.trim())\n\t\t\t.filter((token) => token.length >= 3),\n\t);\n\tif (tokens.size === 0) return [];\n\treturn document.terms\n\t\t.map((term) => {\n\t\t\tconst haystack = [term.name, term.meaning, ...(term.aliases ?? []), ...(term.related ?? [])]\n\t\t\t\t.join(\" \")\n\t\t\t\t.toLowerCase();\n\t\t\tconst score = [...tokens].filter((token) => haystack.includes(token)).length;\n\t\t\treturn { term, score };\n\t\t})\n\t\t.filter((entry) => entry.score > 0)\n\t\t.sort((left, right) => right.score - left.score)\n\t\t.slice(0, limit)\n\t\t.map((entry) => entry.term);\n}\n\nexport function renderContextTerms(terms: readonly ContextTerm[]): string | undefined {\n\tif (terms.length === 0) return undefined;\n\treturn [\"Relevant CONTEXT.md terms:\", ...terms.map((term) => `- ${term.name}: ${term.meaning}`)].join(\"\\n\");\n}\n\nexport function readContextDocument(projectRoot: string): ContextDocument | undefined {\n\tconst path = getContextPath(projectRoot);\n\tif (!existsSync(path)) return undefined;\n\treturn parseContextDocument(readFileSync(path, \"utf-8\"));\n}\n"]}

package/dist/core/memory/context/context-format.js

@@ -0,0 +1,199 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+export const CONTEXT_FILE_NAME = "CONTEXT.md";
+const SECTION_HEADINGS = [
+    "## Project",
+    "## Purpose",
+    "## Terms",
+    "## Conventions",
+    "## Open Questions",
+    "## Not For This File",
+];
+export function createContextScaffold(projectName) {
+    return `# ${projectName} Context
+
+## Project
+
+${projectName}
+
+## Purpose
+
+Describe the stable project purpose, domain, and mental model here.
+
+## Terms
+
+<!-- Threadwell writes accepted stable vocabulary here. Keep task history out. -->
+
+- **Example term**: Replace with project-specific language.
+  - Aliases: example alias
+  - Related: related concept
+
+## Conventions
+
+- **Naming**: Record durable naming and architecture conventions here.
+
+## Open Questions
+
+- Record durable semantic ambiguities that need user clarification.
+
+## Not For This File
+
+Do not store raw logs, transient task history, secrets, validation output, or ephemeral progress here.
+`;
+}
+function sectionBody(markdown, heading) {
+    const start = markdown.indexOf(heading);
+    if (start === -1)
+        return "";
+    const bodyStart = start + heading.length;
+    const next = SECTION_HEADINGS.map((candidate) => markdown.indexOf(candidate, bodyStart))
+        .filter((index) => index !== -1)
+        .sort((left, right) => left - right)[0];
+    return markdown.slice(bodyStart, next ?? markdown.length).trim();
+}
+function parseTerms(body) {
+    const terms = [];
+    const blocks = body.split(/\n(?=- \*\*)/g);
+    for (const block of blocks) {
+        const firstLine = block.split(/\r?\n/, 1)[0]?.trim();
+        const match = firstLine?.match(/^- \*\*(.+?)\*\*:\s*(.+)$/);
+        if (!match)
+            continue;
+        const aliases = block
+            .match(/Aliases:\s*(.+)/)?.[1]
+            .split(",")
+            .map((entry) => entry.trim())
+            .filter(Boolean);
+        const related = block
+            .match(/Related:\s*(.+)/)?.[1]
+            .split(",")
+            .map((entry) => entry.trim())
+            .filter(Boolean);
+        terms.push({
+            name: match[1].trim(),
+            meaning: match[2].trim(),
+            aliases: aliases && aliases.length > 0 ? aliases : undefined,
+            related: related && related.length > 0 ? related : undefined,
+        });
+    }
+    return terms;
+}
+function parseConventions(body) {
+    return body
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .flatMap((line) => {
+        const match = line.match(/^- \*\*(.+?)\*\*:\s*(.+)$/);
+        return match ? [{ name: match[1].trim(), description: match[2].trim() }] : [];
+    });
+}
+function parseList(body) {
+    return body
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line.startsWith("- "))
+        .map((line) => line.slice(2).trim())
+        .filter(Boolean);
+}
+export function parseContextDocument(markdown) {
+    return {
+        project: sectionBody(markdown, "## Project") || "Unknown project",
+        purpose: sectionBody(markdown, "## Purpose"),
+        terms: parseTerms(sectionBody(markdown, "## Terms")),
+        conventions: parseConventions(sectionBody(markdown, "## Conventions")),
+        openQuestions: parseList(sectionBody(markdown, "## Open Questions")),
+    };
+}
+export function getContextPath(projectRoot) {
+    return join(projectRoot, CONTEXT_FILE_NAME);
+}
+export function ensureContextScaffold(projectRoot, projectName) {
+    const path = getContextPath(projectRoot);
+    if (existsSync(path))
+        return { path, created: false };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, createContextScaffold(projectName), "utf-8");
+    return { path, created: true };
+}
+function formatContextTerm(term) {
+    const aliases = term.aliases && term.aliases.length > 0 ? `\n  - Aliases: ${term.aliases.join(", ")}` : "";
+    const related = term.related && term.related.length > 0 ? `\n  - Related: ${term.related.join(", ")}` : "";
+    return `- **${term.name.trim()}**: ${term.meaning.trim()}${aliases}${related}`;
+}
+function isEphemeralContextTerm(term) {
+    const text = `${term.name} ${term.meaning}`.toLowerCase();
+    return /\b(task|todo|log|today|yesterday|temporary|validation output|stack trace|raw output|secret|token|password)\b/.test(text);
+}
+function insertBeforeNextSection(markdown, heading, content) {
+    const start = markdown.indexOf(heading);
+    if (start === -1)
+        return `${markdown.trimEnd()}\n\n${heading}\n\n${content}\n`;
+    const bodyStart = start + heading.length;
+    const next = SECTION_HEADINGS.map((candidate) => markdown.indexOf(candidate, bodyStart))
+        .filter((index) => index !== -1)
+        .sort((left, right) => left - right)[0];
+    if (next === undefined)
+        return `${markdown.trimEnd()}\n${content}\n`;
+    return `${markdown.slice(0, next).trimEnd()}\n${content}\n\n${markdown.slice(next).trimStart()}`;
+}
+export function mergeAcceptedContextTerms(markdown, terms) {
+    const document = parseContextDocument(markdown);
+    const existing = new Set(document.terms.map((term) => term.name.toLowerCase()));
+    const accepted = terms.filter((term) => term.name.trim() && term.meaning.trim() && !isEphemeralContextTerm(term));
+    const added = accepted.filter((term) => !existing.has(term.name.toLowerCase()));
+    const skippedTerms = terms
+        .filter((term) => !added.includes(term))
+        .map((term) => term.name.trim())
+        .filter(Boolean);
+    if (added.length === 0)
+        return { markdown, addedTerms: [], skippedTerms };
+    const nextMarkdown = insertBeforeNextSection(markdown, "## Terms", `\n${added.map(formatContextTerm).join("\n")}`);
+    return { markdown: nextMarkdown, addedTerms: added.map((term) => term.name), skippedTerms };
+}
+export function writeAcceptedContextTerms(projectRoot, projectName, terms) {
+    const scaffold = ensureContextScaffold(projectRoot, projectName);
+    const current = readFileSync(scaffold.path, "utf-8");
+    const merged = mergeAcceptedContextTerms(current, terms);
+    if (merged.markdown !== current) {
+        writeFileSync(scaffold.path, merged.markdown, "utf-8");
+    }
+    return {
+        path: scaffold.path,
+        changed: merged.markdown !== current,
+        addedTerms: merged.addedTerms,
+        skippedTerms: merged.skippedTerms,
+    };
+}
+export function findRelevantContextTerms(document, query, limit = 5) {
+    const tokens = new Set(query
+        .toLowerCase()
+        .split(/[^a-z0-9_-]+/i)
+        .map((token) => token.trim())
+        .filter((token) => token.length >= 3));
+    if (tokens.size === 0)
+        return [];
+    return document.terms
+        .map((term) => {
+        const haystack = [term.name, term.meaning, ...(term.aliases ?? []), ...(term.related ?? [])]
+            .join(" ")
+            .toLowerCase();
+        const score = [...tokens].filter((token) => haystack.includes(token)).length;
+        return { term, score };
+    })
+        .filter((entry) => entry.score > 0)
+        .sort((left, right) => right.score - left.score)
+        .slice(0, limit)
+        .map((entry) => entry.term);
+}
+export function renderContextTerms(terms) {
+    if (terms.length === 0)
+        return undefined;
+    return ["Relevant CONTEXT.md terms:", ...terms.map((term) => `- ${term.name}: ${term.meaning}`)].join("\n");
+}
+export function readContextDocument(projectRoot) {
+    const path = getContextPath(projectRoot);
+    if (!existsSync(path))
+        return undefined;
+    return parseContextDocument(readFileSync(path, "utf-8"));
+}
+//# sourceMappingURL=context-format.js.map

package/dist/core/memory/context/context-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-format.js","sourceRoot":"","sources":["../../../../src/core/memory/context/context-format.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\n\nexport interface ContextTerm {\n\tname: string;\n\tmeaning: string;\n\taliases?: string[];\n\trelated?: string[];\n}\n\nexport interface ContextConvention {\n\tname: string;\n\tdescription: string;\n}\n\nexport interface ContextDocument {\n\tproject: string;\n\tpurpose: string;\n\tterms: ContextTerm[];\n\tconventions: ContextConvention[];\n\topenQuestions: string[];\n}\n\nexport interface ContextWriteResult {\n\tpath: string;\n\tchanged: boolean;\n\taddedTerms: string[];\n\tskippedTerms: string[];\n}\n\nexport const CONTEXT_FILE_NAME = \"CONTEXT.md\";\n\nconst SECTION_HEADINGS = [\n\t\"## Project\",\n\t\"## Purpose\",\n\t\"## Terms\",\n\t\"## Conventions\",\n\t\"## Open Questions\",\n\t\"## Not For This File\",\n] as const;\n\nexport function createContextScaffold(projectName: string): string {\n\treturn `# ${projectName} Context\n\n## Project\n\n${projectName}\n\n## Purpose\n\nDescribe the stable project purpose, domain, and mental model here.\n\n## Terms\n\n<!-- Threadwell writes accepted stable vocabulary here. Keep task history out. -->\n\n- **Example term**: Replace with project-specific language.\n  - Aliases: example alias\n  - Related: related concept\n\n## Conventions\n\n- **Naming**: Record durable naming and architecture conventions here.\n\n## Open Questions\n\n- Record durable semantic ambiguities that need user clarification.\n\n## Not For This File\n\nDo not store raw logs, transient task history, secrets, validation output, or ephemeral progress here.\n`;\n}\n\nfunction sectionBody(markdown: string, heading: string): string {\n\tconst start = markdown.indexOf(heading);\n\tif (start === -1) return \"\";\n\tconst bodyStart = start + heading.length;\n\tconst next = SECTION_HEADINGS.map((candidate) => markdown.indexOf(candidate, bodyStart))\n\t\t.filter((index) => index !== -1)\n\t\t.sort((left, right) => left - right)[0];\n\treturn markdown.slice(bodyStart, next ?? markdown.length).trim();\n}\n\nfunction parseTerms(body: string): ContextTerm[] {\n\tconst terms: ContextTerm[] = [];\n\tconst blocks = body.split(/\\n(?=- \\*\\*)/g);\n\tfor (const block of blocks) {\n\t\tconst firstLine = block.split(/\\r?\\n/, 1)[0]?.trim();\n\t\tconst match = firstLine?.match(/^- \\*\\*(.+?)\\*\\*:\\s*(.+)$/);\n\t\tif (!match) continue;\n\t\tconst aliases = block\n\t\t\t.match(/Aliases:\\s*(.+)/)?.[1]\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t\tconst related = block\n\t\t\t.match(/Related:\\s*(.+)/)?.[1]\n\t\t\t.split(\",\")\n\t\t\t.map((entry) => entry.trim())\n\t\t\t.filter(Boolean);\n\t\tterms.push({\n\t\t\tname: match[1].trim(),\n\t\t\tmeaning: match[2].trim(),\n\t\t\taliases: aliases && aliases.length > 0 ? aliases : undefined,\n\t\t\trelated: related && related.length > 0 ? related : undefined,\n\t\t});\n\t}\n\treturn terms;\n}\n\nfunction parseConventions(body: string): ContextConvention[] {\n\treturn body\n\t\t.split(/\\r?\\n/)\n\t\t.map((line) => line.trim())\n\t\t.flatMap((line) => {\n\t\t\tconst match = line.match(/^- \\*\\*(.+?)\\*\\*:\\s*(.+)$/);\n\t\t\treturn match ? [{ name: match[1].trim(), description: match[2].trim() }] : [];\n\t\t});\n}\n\nfunction parseList(body: string): string[] {\n\treturn body\n\t\t.split(/\\r?\\n/)\n\t\t.map((line) => line.trim())\n\t\t.filter((line) => line.startsWith(\"- \"))\n\t\t.map((line) => line.slice(2).trim())\n\t\t.filter(Boolean);\n}\n\nexport function parseContextDocument(markdown: string): ContextDocument {\n\treturn {\n\t\tproject: sectionBody(markdown, \"## Project\") || \"Unknown project\",\n\t\tpurpose: sectionBody(markdown, \"## Purpose\"),\n\t\tterms: parseTerms(sectionBody(markdown, \"## Terms\")),\n\t\tconventions: parseConventions(sectionBody(markdown, \"## Conventions\")),\n\t\topenQuestions: parseList(sectionBody(markdown, \"## Open Questions\")),\n\t};\n}\n\nexport function getContextPath(projectRoot: string): string {\n\treturn join(projectRoot, CONTEXT_FILE_NAME);\n}\n\nexport function ensureContextScaffold(projectRoot: string, projectName: string): { path: string; created: boolean } {\n\tconst path = getContextPath(projectRoot);\n\tif (existsSync(path)) return { path, created: false };\n\tmkdirSync(dirname(path), { recursive: true });\n\twriteFileSync(path, createContextScaffold(projectName), \"utf-8\");\n\treturn { path, created: true };\n}\n\nfunction formatContextTerm(term: ContextTerm): string {\n\tconst aliases = term.aliases && term.aliases.length > 0 ? `\\n  - Aliases: ${term.aliases.join(\", \")}` : \"\";\n\tconst related = term.related && term.related.length > 0 ? `\\n  - Related: ${term.related.join(\", \")}` : \"\";\n\treturn `- **${term.name.trim()}**: ${term.meaning.trim()}${aliases}${related}`;\n}\n\nfunction isEphemeralContextTerm(term: ContextTerm): boolean {\n\tconst text = `${term.name} ${term.meaning}`.toLowerCase();\n\treturn /\\b(task|todo|log|today|yesterday|temporary|validation output|stack trace|raw output|secret|token|password)\\b/.test(\n\t\ttext,\n\t);\n}\n\nfunction insertBeforeNextSection(markdown: string, heading: string, content: string): string {\n\tconst start = markdown.indexOf(heading);\n\tif (start === -1) return `${markdown.trimEnd()}\\n\\n${heading}\\n\\n${content}\\n`;\n\tconst bodyStart = start + heading.length;\n\tconst next = SECTION_HEADINGS.map((candidate) => markdown.indexOf(candidate, bodyStart))\n\t\t.filter((index) => index !== -1)\n\t\t.sort((left, right) => left - right)[0];\n\tif (next === undefined) return `${markdown.trimEnd()}\\n${content}\\n`;\n\treturn `${markdown.slice(0, next).trimEnd()}\\n${content}\\n\\n${markdown.slice(next).trimStart()}`;\n}\n\nexport function mergeAcceptedContextTerms(\n\tmarkdown: string,\n\tterms: readonly ContextTerm[],\n): {\n\tmarkdown: string;\n\taddedTerms: string[];\n\tskippedTerms: string[];\n} {\n\tconst document = parseContextDocument(markdown);\n\tconst existing = new Set(document.terms.map((term) => term.name.toLowerCase()));\n\tconst accepted = terms.filter((term) => term.name.trim() && term.meaning.trim() && !isEphemeralContextTerm(term));\n\tconst added = accepted.filter((term) => !existing.has(term.name.toLowerCase()));\n\tconst skippedTerms = terms\n\t\t.filter((term) => !added.includes(term))\n\t\t.map((term) => term.name.trim())\n\t\t.filter(Boolean);\n\tif (added.length === 0) return { markdown, addedTerms: [], skippedTerms };\n\tconst nextMarkdown = insertBeforeNextSection(markdown, \"## Terms\", `\\n${added.map(formatContextTerm).join(\"\\n\")}`);\n\treturn { markdown: nextMarkdown, addedTerms: added.map((term) => term.name), skippedTerms };\n}\n\nexport function writeAcceptedContextTerms(\n\tprojectRoot: string,\n\tprojectName: string,\n\tterms: readonly ContextTerm[],\n): ContextWriteResult {\n\tconst scaffold = ensureContextScaffold(projectRoot, projectName);\n\tconst current = readFileSync(scaffold.path, \"utf-8\");\n\tconst merged = mergeAcceptedContextTerms(current, terms);\n\tif (merged.markdown !== current) {\n\t\twriteFileSync(scaffold.path, merged.markdown, \"utf-8\");\n\t}\n\treturn {\n\t\tpath: scaffold.path,\n\t\tchanged: merged.markdown !== current,\n\t\taddedTerms: merged.addedTerms,\n\t\tskippedTerms: merged.skippedTerms,\n\t};\n}\n\nexport function findRelevantContextTerms(document: ContextDocument, query: string, limit = 5): ContextTerm[] {\n\tconst tokens = new Set(\n\t\tquery\n\t\t\t.toLowerCase()\n\t\t\t.split(/[^a-z0-9_-]+/i)\n\t\t\t.map((token) => token.trim())\n\t\t\t.filter((token) => token.length >= 3),\n\t);\n\tif (tokens.size === 0) return [];\n\treturn document.terms\n\t\t.map((term) => {\n\t\t\tconst haystack = [term.name, term.meaning, ...(term.aliases ?? []), ...(term.related ?? [])]\n\t\t\t\t.join(\" \")\n\t\t\t\t.toLowerCase();\n\t\t\tconst score = [...tokens].filter((token) => haystack.includes(token)).length;\n\t\t\treturn { term, score };\n\t\t})\n\t\t.filter((entry) => entry.score > 0)\n\t\t.sort((left, right) => right.score - left.score)\n\t\t.slice(0, limit)\n\t\t.map((entry) => entry.term);\n}\n\nexport function renderContextTerms(terms: readonly ContextTerm[]): string | undefined {\n\tif (terms.length === 0) return undefined;\n\treturn [\"Relevant CONTEXT.md terms:\", ...terms.map((term) => `- ${term.name}: ${term.meaning}`)].join(\"\\n\");\n}\n\nexport function readContextDocument(projectRoot: string): ContextDocument | undefined {\n\tconst path = getContextPath(projectRoot);\n\tif (!existsSync(path)) return undefined;\n\treturn parseContextDocument(readFileSync(path, \"utf-8\"));\n}\n"]}

package/dist/core/memory/context/index.d.ts

@@ -0,0 +1,4 @@
+export { type ContextCandidate, dedupeContextCandidates, detectContextCandidates, } from "./context-candidates.js";
+export { type ContextDiagnostic, type ContextDiagnosticSeverity, diagnoseContextDocument, renderContextDiagnostics, } from "./context-diagnostics.js";
+export { CONTEXT_FILE_NAME, type ContextConvention, type ContextDocument, type ContextTerm, type ContextWriteResult, createContextScaffold, ensureContextScaffold, findRelevantContextTerms, getContextPath, mergeAcceptedContextTerms, parseContextDocument, readContextDocument, renderContextTerms, writeAcceptedContextTerms, } from "./context-format.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/memory/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/memory/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,gBAAgB,EACrB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC9B,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,iBAAiB,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,qBAAqB,CAAC","sourcesContent":["export {\n\ttype ContextCandidate,\n\tdedupeContextCandidates,\n\tdetectContextCandidates,\n} from \"./context-candidates.js\";\nexport {\n\ttype ContextDiagnostic,\n\ttype ContextDiagnosticSeverity,\n\tdiagnoseContextDocument,\n\trenderContextDiagnostics,\n} from \"./context-diagnostics.js\";\nexport {\n\tCONTEXT_FILE_NAME,\n\ttype ContextConvention,\n\ttype ContextDocument,\n\ttype ContextTerm,\n\ttype ContextWriteResult,\n\tcreateContextScaffold,\n\tensureContextScaffold,\n\tfindRelevantContextTerms,\n\tgetContextPath,\n\tmergeAcceptedContextTerms,\n\tparseContextDocument,\n\treadContextDocument,\n\trenderContextTerms,\n\twriteAcceptedContextTerms,\n} from \"./context-format.js\";\n"]}

package/dist/core/memory/context/index.js

@@ -0,0 +1,4 @@
+export { dedupeContextCandidates, detectContextCandidates, } from "./context-candidates.js";
+export { diagnoseContextDocument, renderContextDiagnostics, } from "./context-diagnostics.js";
+export { CONTEXT_FILE_NAME, createContextScaffold, ensureContextScaffold, findRelevantContextTerms, getContextPath, mergeAcceptedContextTerms, parseContextDocument, readContextDocument, renderContextTerms, writeAcceptedContextTerms, } from "./context-format.js";
+//# sourceMappingURL=index.js.map

package/dist/core/memory/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/memory/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAGN,uBAAuB,EACvB,wBAAwB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACN,iBAAiB,EAKjB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,qBAAqB,CAAC","sourcesContent":["export {\n\ttype ContextCandidate,\n\tdedupeContextCandidates,\n\tdetectContextCandidates,\n} from \"./context-candidates.js\";\nexport {\n\ttype ContextDiagnostic,\n\ttype ContextDiagnosticSeverity,\n\tdiagnoseContextDocument,\n\trenderContextDiagnostics,\n} from \"./context-diagnostics.js\";\nexport {\n\tCONTEXT_FILE_NAME,\n\ttype ContextConvention,\n\ttype ContextDocument,\n\ttype ContextTerm,\n\ttype ContextWriteResult,\n\tcreateContextScaffold,\n\tensureContextScaffold,\n\tfindRelevantContextTerms,\n\tgetContextPath,\n\tmergeAcceptedContextTerms,\n\tparseContextDocument,\n\treadContextDocument,\n\trenderContextTerms,\n\twriteAcceptedContextTerms,\n} from \"./context-format.js\";\n"]}

package/dist/core/memory/context-pressure.d.ts

@@ -0,0 +1,15 @@
+export type ContextPressureLevel = "low" | "medium" | "high" | "critical";
+export interface ContextPressureInput {
+    textBytes?: number;
+    estimatedTokens?: number;
+    contextWindowTokens?: number;
+    artifactThresholdBytes?: number;
+}
+export interface ContextPressureResult {
+    level: ContextPressureLevel;
+    shouldArtifact: boolean;
+    shouldSummarize: boolean;
+    reason: string;
+}
+export declare function detectContextPressure(input: ContextPressureInput): ContextPressureResult;
+//# sourceMappingURL=context-pressure.d.ts.map

package/dist/core/memory/context-pressure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pressure.d.ts","sourceRoot":"","sources":["../../../src/core/memory/context-pressure.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAmCxF","sourcesContent":["export type ContextPressureLevel = \"low\" | \"medium\" | \"high\" | \"critical\";\n\nexport interface ContextPressureInput {\n\ttextBytes?: number;\n\testimatedTokens?: number;\n\tcontextWindowTokens?: number;\n\tartifactThresholdBytes?: number;\n}\n\nexport interface ContextPressureResult {\n\tlevel: ContextPressureLevel;\n\tshouldArtifact: boolean;\n\tshouldSummarize: boolean;\n\treason: string;\n}\n\nexport function detectContextPressure(input: ContextPressureInput): ContextPressureResult {\n\tconst artifactThresholdBytes = input.artifactThresholdBytes ?? 16 * 1024;\n\tconst bytes = input.textBytes ?? 0;\n\tconst tokenRatio =\n\t\tinput.contextWindowTokens && input.estimatedTokens ? input.estimatedTokens / input.contextWindowTokens : 0;\n\tif (bytes >= artifactThresholdBytes * 4 || tokenRatio >= 0.9) {\n\t\treturn {\n\t\t\tlevel: \"critical\",\n\t\t\tshouldArtifact: true,\n\t\t\tshouldSummarize: true,\n\t\t\treason: \"content is too large for safe prompt inclusion\",\n\t\t};\n\t}\n\tif (bytes >= artifactThresholdBytes || tokenRatio >= 0.7) {\n\t\treturn {\n\t\t\tlevel: \"high\",\n\t\t\tshouldArtifact: true,\n\t\t\tshouldSummarize: true,\n\t\t\treason: \"content should be artifacted and summarized\",\n\t\t};\n\t}\n\tif (bytes >= artifactThresholdBytes / 2 || tokenRatio >= 0.5) {\n\t\treturn {\n\t\t\tlevel: \"medium\",\n\t\t\tshouldArtifact: false,\n\t\t\tshouldSummarize: true,\n\t\t\treason: \"content is approaching context pressure\",\n\t\t};\n\t}\n\treturn {\n\t\tlevel: \"low\",\n\t\tshouldArtifact: false,\n\t\tshouldSummarize: false,\n\t\treason: \"content fits normal context handling\",\n\t};\n}\n"]}

package/dist/core/memory/context-pressure.js

@@ -0,0 +1,36 @@
+export function detectContextPressure(input) {
+    const artifactThresholdBytes = input.artifactThresholdBytes ?? 16 * 1024;
+    const bytes = input.textBytes ?? 0;
+    const tokenRatio = input.contextWindowTokens && input.estimatedTokens ? input.estimatedTokens / input.contextWindowTokens : 0;
+    if (bytes >= artifactThresholdBytes * 4 || tokenRatio >= 0.9) {
+        return {
+            level: "critical",
+            shouldArtifact: true,
+            shouldSummarize: true,
+            reason: "content is too large for safe prompt inclusion",
+        };
+    }
+    if (bytes >= artifactThresholdBytes || tokenRatio >= 0.7) {
+        return {
+            level: "high",
+            shouldArtifact: true,
+            shouldSummarize: true,
+            reason: "content should be artifacted and summarized",
+        };
+    }
+    if (bytes >= artifactThresholdBytes / 2 || tokenRatio >= 0.5) {
+        return {
+            level: "medium",
+            shouldArtifact: false,
+            shouldSummarize: true,
+            reason: "content is approaching context pressure",
+        };
+    }
+    return {
+        level: "low",
+        shouldArtifact: false,
+        shouldSummarize: false,
+        reason: "content fits normal context handling",
+    };
+}
+//# sourceMappingURL=context-pressure.js.map

package/dist/core/memory/context-pressure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-pressure.js","sourceRoot":"","sources":["../../../src/core/memory/context-pressure.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,qBAAqB,CAAC,KAA2B,EAAyB;IACzF,MAAM,sBAAsB,GAAG,KAAK,CAAC,sBAAsB,IAAI,EAAE,GAAG,IAAI,CAAC;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IACnC,MAAM,UAAU,GACf,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,IAAI,KAAK,IAAI,sBAAsB,GAAG,CAAC,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC9D,OAAO;YACN,KAAK,EAAE,UAAU;YACjB,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,gDAAgD;SACxD,CAAC;IACH,CAAC;IACD,IAAI,KAAK,IAAI,sBAAsB,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC1D,OAAO;YACN,KAAK,EAAE,MAAM;YACb,cAAc,EAAE,IAAI;YACpB,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,6CAA6C;SACrD,CAAC;IACH,CAAC;IACD,IAAI,KAAK,IAAI,sBAAsB,GAAG,CAAC,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QAC9D,OAAO;YACN,KAAK,EAAE,QAAQ;YACf,cAAc,EAAE,KAAK;YACrB,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,yCAAyC;SACjD,CAAC;IACH,CAAC;IACD,OAAO;QACN,KAAK,EAAE,KAAK;QACZ,cAAc,EAAE,KAAK;QACrB,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,sCAAsC;KAC9C,CAAC;AAAA,CACF","sourcesContent":["export type ContextPressureLevel = \"low\" | \"medium\" | \"high\" | \"critical\";\n\nexport interface ContextPressureInput {\n\ttextBytes?: number;\n\testimatedTokens?: number;\n\tcontextWindowTokens?: number;\n\tartifactThresholdBytes?: number;\n}\n\nexport interface ContextPressureResult {\n\tlevel: ContextPressureLevel;\n\tshouldArtifact: boolean;\n\tshouldSummarize: boolean;\n\treason: string;\n}\n\nexport function detectContextPressure(input: ContextPressureInput): ContextPressureResult {\n\tconst artifactThresholdBytes = input.artifactThresholdBytes ?? 16 * 1024;\n\tconst bytes = input.textBytes ?? 0;\n\tconst tokenRatio =\n\t\tinput.contextWindowTokens && input.estimatedTokens ? input.estimatedTokens / input.contextWindowTokens : 0;\n\tif (bytes >= artifactThresholdBytes * 4 || tokenRatio >= 0.9) {\n\t\treturn {\n\t\t\tlevel: \"critical\",\n\t\t\tshouldArtifact: true,\n\t\t\tshouldSummarize: true,\n\t\t\treason: \"content is too large for safe prompt inclusion\",\n\t\t};\n\t}\n\tif (bytes >= artifactThresholdBytes || tokenRatio >= 0.7) {\n\t\treturn {\n\t\t\tlevel: \"high\",\n\t\t\tshouldArtifact: true,\n\t\t\tshouldSummarize: true,\n\t\t\treason: \"content should be artifacted and summarized\",\n\t\t};\n\t}\n\tif (bytes >= artifactThresholdBytes / 2 || tokenRatio >= 0.5) {\n\t\treturn {\n\t\t\tlevel: \"medium\",\n\t\t\tshouldArtifact: false,\n\t\t\tshouldSummarize: true,\n\t\t\treason: \"content is approaching context pressure\",\n\t\t};\n\t}\n\treturn {\n\t\tlevel: \"low\",\n\t\tshouldArtifact: false,\n\t\tshouldSummarize: false,\n\t\treason: \"content fits normal context handling\",\n\t};\n}\n"]}

package/dist/core/memory/continuity-import.d.ts

@@ -0,0 +1,6 @@
+import { loadContinuityState } from "../continuity/index.js";
+import type { MemoryService } from "./memory-service.js";
+import type { MemoryEventInput } from "./memory-types.js";
+export declare function continuityStateToMemoryEvents(cwd: string, state: Awaited<ReturnType<typeof loadContinuityState>>): MemoryEventInput[];
+export declare function importContinuityIntoMemory(cwd: string, memoryService: MemoryService): Promise<number>;
+//# sourceMappingURL=continuity-import.d.ts.map

package/dist/core/memory/continuity-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuity-import.d.ts","sourceRoot":"","sources":["../../../src/core/memory/continuity-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,wBAAgB,6BAA6B,CAC5C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,GACpD,gBAAgB,EAAE,CAiDpB;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAS3G","sourcesContent":["import { loadContinuityState } from \"../continuity/index.js\";\nimport type { MemoryService } from \"./memory-service.js\";\nimport type { MemoryEventInput } from \"./memory-types.js\";\n\nexport function continuityStateToMemoryEvents(\n\tcwd: string,\n\tstate: Awaited<ReturnType<typeof loadContinuityState>>,\n): MemoryEventInput[] {\n\tconst events: MemoryEventInput[] = [];\n\tif (state.goal || state.currentTask || state.nextAction) {\n\t\tevents.push({\n\t\t\ttype: \"handoff\",\n\t\t\tsummary: state.currentTask ?? state.goal ?? state.nextAction ?? \"Continuity handoff\",\n\t\t\tcontent: [state.goal, state.currentTask, state.nextAction].filter(Boolean).join(\"\\n\"),\n\t\t\tpriority: 4,\n\t\t\ttags: [\"continuity\", \"import\", \"handoff\"],\n\t\t\tmetadata: { cwd, status: state.status },\n\t\t});\n\t}\n\tfor (const file of state.modifiedFiles.slice(-25)) {\n\t\tevents.push({\n\t\t\ttype: \"file_modified\",\n\t\t\tsummary: `Continuity modified file: ${file}`,\n\t\t\tpriority: 3,\n\t\t\tfilePaths: [file],\n\t\t\ttags: [\"continuity\", \"import\", \"file\"],\n\t\t});\n\t}\n\tfor (const question of state.openQuestions.slice(-10)) {\n\t\tevents.push({\n\t\t\ttype: \"open_question\",\n\t\t\tsummary: question,\n\t\t\tpriority: 4,\n\t\t\ttags: [\"continuity\", \"import\", \"question\"],\n\t\t});\n\t}\n\tfor (const blocker of state.blockedOn.slice(-10)) {\n\t\tevents.push({\n\t\t\ttype: \"blocker\",\n\t\t\tsummary: blocker,\n\t\t\tpriority: 5,\n\t\t\ttags: [\"continuity\", \"import\", \"blocker\"],\n\t\t});\n\t}\n\tfor (const checkpoint of state.checkpoints.slice(-10)) {\n\t\tevents.push({\n\t\t\ttype: \"handoff\",\n\t\t\tsummary: `Imported continuity checkpoint: ${checkpoint.reason}`,\n\t\t\tcontent: JSON.stringify(checkpoint),\n\t\t\tpriority: checkpoint.reason === \"loop_end\" ? 4 : 3,\n\t\t\tfilePaths: checkpoint.modifiedFiles,\n\t\t\ttags: [\"continuity\", \"import\", \"checkpoint\"],\n\t\t\tcreatedAt: new Date(checkpoint.timestamp).toISOString(),\n\t\t});\n\t}\n\treturn events;\n}\n\nexport async function importContinuityIntoMemory(cwd: string, memoryService: MemoryService): Promise<number> {\n\tconst state = await loadContinuityState(cwd);\n\tconst events = continuityStateToMemoryEvents(cwd, state);\n\tlet imported = 0;\n\tfor (const event of events) {\n\t\tconst recorded = await memoryService.recordEvent(event);\n\t\tif (recorded) imported++;\n\t}\n\treturn imported;\n}\n"]}