@zelari/core 0.7.11 → 0.7.14

package/dist/council/lessons/io.d.ts

@@ -0,0 +1,5 @@
+import type { LessonRecord } from './types.js';
+export declare const LESSONS_FILE = "lessons.jsonl";
+/** Read lessons.jsonl, keeping the latest record per id. */
+export declare function readLessonsDeduped(zelariRoot: string): LessonRecord[];
+//# sourceMappingURL=io.d.ts.map

package/dist/council/lessons/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/council/lessons/io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAqBrE"}

package/dist/council/lessons/io.js

@@ -0,0 +1,30 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+export const LESSONS_FILE = 'lessons.jsonl';
+/** Read lessons.jsonl, keeping the latest record per id. */
+export function readLessonsDeduped(zelariRoot) {
+    const path = join(zelariRoot, LESSONS_FILE);
+    try {
+        const raw = readFileSync(path, 'utf8');
+        const byId = new Map();
+        for (const line of raw.split(/\r?\n/)) {
+            if (!line.trim())
+                continue;
+            try {
+                const rec = JSON.parse(line);
+                const prev = byId.get(rec.id);
+                if (!prev || rec.updatedAt >= prev.updatedAt) {
+                    byId.set(rec.id, rec);
+                }
+            }
+            catch {
+                // skip corrupt line
+            }
+        }
+        return [...byId.values()];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=io.js.map

package/dist/council/lessons/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/council/lessons/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAwB,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;gBAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC9B,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,oBAAoB;YACtB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/council/lessons/isAnswerLeak.d.ts

@@ -0,0 +1,7 @@
+export interface LeakCheckResult {
+    leak: boolean;
+    reason?: string;
+}
+/** Reject lesson text that looks like an answer leak, not methodology. */
+export declare function isAnswerLeak(text: string): LeakCheckResult;
+//# sourceMappingURL=isAnswerLeak.d.ts.map

package/dist/council/lessons/isAnswerLeak.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAnswerLeak.d.ts","sourceRoot":"","sources":["../../../src/council/lessons/isAnswerLeak.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAU1D"}

package/dist/council/lessons/isAnswerLeak.js

@@ -0,0 +1,26 @@
+const FLAG_RE = /flag\{[^}]+\}/i;
+const CHALLENGE_ANSWER_RE = /challenge[-_\s]?id\s*[:=].{0,40}answer\s*[:=]/i;
+const TEST_WORKSPACE_RE = /\b(TESTMCP|T3MP3ST)\b/i;
+const WIN_ABS_PATH_RE = /[A-Z]:\\[^\s'"]+/i;
+const UNIX_ABS_PATH_RE = /\/(?:Users|home|tmp|var)\/[^\s'"]+/i;
+const HARDCODED_BENCHMARK_RE = /\b\d{4,}\s*bytes\b/i;
+/** Reject lesson text that looks like an answer leak, not methodology. */
+export function isAnswerLeak(text) {
+    const t = text.trim();
+    if (!t)
+        return { leak: true, reason: 'empty' };
+    if (FLAG_RE.test(t))
+        return { leak: true, reason: 'flag-shaped secret' };
+    if (CHALLENGE_ANSWER_RE.test(t))
+        return { leak: true, reason: 'challenge-id + answer pair' };
+    if (TEST_WORKSPACE_RE.test(t))
+        return { leak: true, reason: 'test workspace name' };
+    if (WIN_ABS_PATH_RE.test(t))
+        return { leak: true, reason: 'absolute windows path' };
+    if (UNIX_ABS_PATH_RE.test(t))
+        return { leak: true, reason: 'absolute unix path' };
+    if (HARDCODED_BENCHMARK_RE.test(t))
+        return { leak: true, reason: 'hardcoded byte benchmark' };
+    return { leak: false };
+}
+//# sourceMappingURL=isAnswerLeak.js.map

package/dist/council/lessons/isAnswerLeak.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isAnswerLeak.js","sourceRoot":"","sources":["../../../src/council/lessons/isAnswerLeak.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,GAAG,gBAAgB,CAAC;AACjC,MAAM,mBAAmB,GAAG,gDAAgD,CAAC;AAC7E,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AACnD,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAC5C,MAAM,gBAAgB,GAAG,qCAAqC,CAAC;AAC/D,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAOrD,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC/C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACzE,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IAC7F,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACpF,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACpF,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAClF,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IAC9F,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/council/lessons/recallLessons.d.ts

@@ -0,0 +1,8 @@
+import type { LessonRecord, RecallLessonsOptions } from './types.js';
+/**
+ * Recall top lessons for council context (enforced preferred, keyword overlap).
+ */
+export declare function recallLessons(zelariRoot: string, options?: RecallLessonsOptions): LessonRecord[];
+/** Markdown block for workspace context injection. */
+export declare function formatLessonsForContext(lessons: LessonRecord[]): string | null;
+//# sourceMappingURL=recallLessons.d.ts.map

package/dist/council/lessons/recallLessons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recallLessons.d.ts","sourceRoot":"","sources":["../../../src/council/lessons/recallLessons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAcrE;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,oBAAyB,GACjC,YAAY,EAAE,CAwBhB;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAW9E"}

package/dist/council/lessons/recallLessons.js

@@ -0,0 +1,56 @@
+import { readLessonsDeduped } from './io.js';
+function scoreLesson(lesson, taskText) {
+    const low = taskText.toLowerCase();
+    let score = lesson.tier === 'enforced' ? 10 : 1;
+    for (const kw of lesson.keywords) {
+        if (low.includes(kw.toLowerCase()))
+            score += 3;
+    }
+    if (low.includes(lesson.checkId.replace(/\./g, ' ')))
+        score += 2;
+    score += lesson.recurrence;
+    return score;
+}
+/**
+ * Recall top lessons for council context (enforced preferred, keyword overlap).
+ */
+export function recallLessons(zelariRoot, options = {}) {
+    const maxLessons = options.maxLessons ?? 5;
+    const maxBytes = options.maxBytes ?? 2048;
+    const taskText = options.taskText ?? '';
+    const all = readLessonsDeduped(zelariRoot);
+    if (all.length === 0)
+        return [];
+    const ranked = [...all].sort((a, b) => {
+        const sa = scoreLesson(a, taskText);
+        const sb = scoreLesson(b, taskText);
+        return sb - sa;
+    });
+    const picked = [];
+    let bytes = 0;
+    for (const lesson of ranked) {
+        if (picked.length >= maxLessons)
+            break;
+        const line = JSON.stringify(lesson);
+        if (bytes + line.length > maxBytes && picked.length > 0)
+            break;
+        picked.push(lesson);
+        bytes += line.length;
+    }
+    return picked;
+}
+/** Markdown block for workspace context injection. */
+export function formatLessonsForContext(lessons) {
+    if (lessons.length === 0)
+        return null;
+    const lines = [
+        '## Council lessons (methodology — not answers)',
+        'Apply enforced lessons before claiming verification PASS.',
+        '',
+    ];
+    for (const l of lessons) {
+        lines.push(`- **[${l.tier}]** \`${l.checkId}\`: ${l.methodology}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=recallLessons.js.map

package/dist/council/lessons/recallLessons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recallLessons.js","sourceRoot":"","sources":["../../../src/council/lessons/recallLessons.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,SAAS,WAAW,CAAC,MAAoB,EAAE,QAAgB;IACzD,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,KAAK,GAAG,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IACjE,KAAK,IAAI,MAAM,CAAC,UAAU,CAAC;IAC3B,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAkB,EAClB,UAAgC,EAAE;IAElC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;IAExC,MAAM,GAAG,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpC,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,MAAM,IAAI,UAAU;YAAE,MAAM;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM;QAC/D,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpB,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG;QACZ,gDAAgD;QAChD,2DAA2D;QAC3D,EAAE;KACH,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/council/lessons/recordFailure.d.ts

@@ -0,0 +1,7 @@
+import type { VerificationCheckResult } from '../verification/types.js';
+import type { CaptureFailureResult } from './types.js';
+/**
+ * Capture a verification FAIL as a methodology lesson (append-only jsonl).
+ */
+export declare function captureFailure(zelariRoot: string, check: VerificationCheckResult): CaptureFailureResult;
+//# sourceMappingURL=recordFailure.d.ts.map

package/dist/council/lessons/recordFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordFailure.d.ts","sourceRoot":"","sources":["../../../src/council/lessons/recordFailure.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAuB,MAAM,0BAA0B,CAAC;AAI7F,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,YAAY,CAAC;AAgDrE;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,uBAAuB,GAC7B,oBAAoB,CA0CtB"}

package/dist/council/lessons/recordFailure.js

@@ -0,0 +1,86 @@
+import { appendFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { isAnswerLeak } from './isAnswerLeak.js';
+import { LESSONS_FILE, readLessonsDeduped } from './io.js';
+import { jaccardSimilarity, normalizeForSignature, tokenizeForSignature } from './signatures.js';
+const JACCARD_MERGE_THRESHOLD = 0.72;
+const ENFORCED_AFTER_RECURRENCE = 2;
+const METHODOLOGY = {
+    'motion.keyframes': 'Grep @keyframes in targets before PASS; compositor budget allows only transform and opacity.',
+    'motion.transitions': 'Grep transition properties before PASS; forbid layout-affecting props (grid-template-rows, box-shadow, etc.).',
+    'css.dead-hook': 'Every classList.add must have a matching CSS rule; grep both script and style blocks.',
+    'synthesis.tier-inflation': 'Verification status tier cannot exceed the report; never PASS a check prefix that still has FAIL in verification-report.',
+    'synthesis.honesty': 'Claims like verificato/regressione require Evidence table with path:Lline or tool output — not prose alone.',
+    'synthesis.cite-invalid': 'Every path:Lline citation must exist and be non-empty; grep before citing.',
+    'synthesis.degraded-banner': 'Degraded runs must include DEGRADED_RUN banner; do not claim ready-to-commit.',
+    'plan.reality': 'Milestone keywords in plan.json must appear in implementation targets before claiming compatibility.',
+};
+function methodologyFor(check) {
+    return (METHODOLOGY[check.id] ??
+        `When ${check.id} fails, fix the underlying issue and cite grep/tool evidence before claiming PASS.`);
+}
+function keywordsFrom(check, signature) {
+    const words = signature.split(' ').filter((w) => w.length >= 4);
+    const fromId = check.id.split(/[.-]/).filter((p) => p.length >= 4);
+    return [...new Set([...fromId, ...words])].slice(0, 12);
+}
+function writeLesson(zelariRoot, lesson) {
+    const path = join(zelariRoot, LESSONS_FILE);
+    appendFileSync(path, `${JSON.stringify(lesson)}\n`, 'utf8');
+}
+function findSimilar(lessons, signature) {
+    const sigTokens = tokenizeForSignature(signature);
+    let best = null;
+    let bestScore = 0;
+    for (const l of lessons) {
+        const score = jaccardSimilarity(sigTokens, tokenizeForSignature(l.signature));
+        if (score > bestScore) {
+            bestScore = score;
+            best = l;
+        }
+    }
+    return bestScore >= JACCARD_MERGE_THRESHOLD ? best : null;
+}
+/**
+ * Capture a verification FAIL as a methodology lesson (append-only jsonl).
+ */
+export function captureFailure(zelariRoot, check) {
+    if (check.ok) {
+        return { captured: false, reason: 'check passed' };
+    }
+    const methodology = methodologyFor(check);
+    const leak = isAnswerLeak(`${methodology} ${check.message} ${check.evidence ?? ''}`);
+    if (leak.leak) {
+        return { captured: false, rejected: true, reason: leak.reason };
+    }
+    const signature = normalizeForSignature(check.id, check.message);
+    const existing = readLessonsDeduped(zelariRoot);
+    const similar = findSimilar(existing, signature);
+    const now = new Date().toISOString();
+    if (similar) {
+        const recurrence = similar.recurrence + 1;
+        const tier = recurrence >= ENFORCED_AFTER_RECURRENCE ? 'enforced' : similar.tier;
+        const updated = {
+            ...similar,
+            recurrence,
+            tier,
+            updatedAt: now,
+        };
+        writeLesson(zelariRoot, updated);
+        return { captured: true, lesson: updated };
+    }
+    const lesson = {
+        id: `lesson-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+        signature,
+        checkId: check.id,
+        methodology,
+        tier: 'advisory',
+        keywords: keywordsFrom(check, signature),
+        recurrence: 1,
+        createdAt: now,
+        updatedAt: now,
+    };
+    writeLesson(zelariRoot, lesson);
+    return { captured: true, lesson };
+}
+//# sourceMappingURL=recordFailure.js.map

package/dist/council/lessons/recordFailure.js.map

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

package/dist/council/lessons/signatures.d.ts

@@ -0,0 +1,6 @@
+/** Tokenize for Jaccard similarity (lowercase words ≥3 chars). */
+export declare function tokenizeForSignature(text: string): Set<string>;
+export declare function jaccardSimilarity(a: Set<string>, b: Set<string>): number;
+/** Normalize check message for stable signatures (strip paths, lines, numbers). */
+export declare function normalizeForSignature(checkId: string, message: string): string;
+//# sourceMappingURL=signatures.d.ts.map

package/dist/council/lessons/signatures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatures.d.ts","sourceRoot":"","sources":["../../../src/council/lessons/signatures.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAM9D;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAQxE;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9E"}

package/dist/council/lessons/signatures.js

@@ -0,0 +1,31 @@
+/** Tokenize for Jaccard similarity (lowercase words ≥3 chars). */
+export function tokenizeForSignature(text) {
+    const out = new Set();
+    for (const w of text.toLowerCase().split(/\W+/)) {
+        if (w.length >= 3)
+            out.add(w);
+    }
+    return out;
+}
+export function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 1;
+    let inter = 0;
+    for (const x of a) {
+        if (b.has(x))
+            inter++;
+    }
+    const union = new Set([...a, ...b]).size;
+    return union === 0 ? 0 : inter / union;
+}
+/** Normalize check message for stable signatures (strip paths, lines, numbers). */
+export function normalizeForSignature(checkId, message) {
+    const base = `${checkId} ${message}`
+        .toLowerCase()
+        .replace(/[A-Za-z]:\\[^\s]+/g, 'path')
+        .replace(/\/[\w./-]+/g, 'path')
+        .replace(/l\d{1,6}/gi, 'line')
+        .replace(/\d+/g, 'n');
+    return [...tokenizeForSignature(base)].sort().join(' ');
+}
+//# sourceMappingURL=signatures.js.map

package/dist/council/lessons/signatures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signatures.js","sourceRoot":"","sources":["../../../src/council/lessons/signatures.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAc,EAAE,CAAc;IAC9D,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,KAAK,EAAE,CAAC;IACxB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,OAAe;IACpE,MAAM,IAAI,GAAG,GAAG,OAAO,IAAI,OAAO,EAAE;SACjC,WAAW,EAAE;SACb,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC;SACrC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC;SAC9B,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;SAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/dist/council/lessons/types.d.ts

@@ -0,0 +1,27 @@
+export type LessonTier = 'advisory' | 'enforced';
+export interface LessonRecord {
+    id: string;
+    /** Normalized tokens for recurrence matching. */
+    signature: string;
+    checkId: string;
+    /** Methodology guidance — not task-specific answers. */
+    methodology: string;
+    tier: LessonTier;
+    keywords: string[];
+    recurrence: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CaptureFailureResult {
+    captured: boolean;
+    rejected?: boolean;
+    reason?: string;
+    lesson?: LessonRecord;
+}
+export interface RecallLessonsOptions {
+    maxLessons?: number;
+    maxBytes?: number;
+    /** User task text for keyword overlap scoring. */
+    taskText?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/council/lessons/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/council/lessons/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAEjD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/council/lessons/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/council/lessons/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/council/lessons/types.ts"],"names":[],"mappings":""}

package/dist/council/modeBanners.d.ts

@@ -1,5 +1,28 @@
 import type { CouncilRunMode } from './runMode.js';
 export declare const DESIGN_PHASE_MODE_BANNER = "COUNCIL RUN MODE: design-phase.\nWorkspace tool emissions described in your role prompt are MANDATORY in this run \u2014 prose alone does not count as a deliverable. Persist artifacts via the workspace tools listed in your AVAILABLE TOOLS section.";
 export declare const IMPLEMENTATION_MODE_BANNER = "COUNCIL RUN MODE: implementation.\nPrefer write_file, edit_file, and bash for code changes. Design-phase mandatory workspace blocks in your role prompt are INACTIVE in this run \u2014 only call workspace tools when they add durable project value.";
-export declare function councilModeBanner(runMode: CouncilRunMode): string;
+/**
+ * Implementation-mode banner for the SOLE implementer (the chairman, Lucifero).
+ * Only this member writes/edits project files, so the "who implemented" signal
+ * stays unambiguous and multiple agents never edit the same files.
+ */
+export declare const IMPLEMENTATION_IMPLEMENTER_BANNER = "COUNCIL RUN MODE: implementation \u2014 you are the IMPLEMENTER.\nYou are the only member that writes code this run. Implement the solution with write_file / edit_file and verify with bash. Reconcile the specialists' analysis and Minosse's critique into working, verified changes. Design-phase mandatory workspace blocks in your role prompt are INACTIVE \u2014 only call workspace tools when they add durable project value.";
+/**
+ * Implementation-mode banner for advisors (specialists + Minosse). They analyze,
+ * plan and critique; they must NOT modify project files (the implementer does).
+ * This prevents multi-writer chaos where several agents edit the same files and
+ * pile up conflicting changes.
+ */
+export declare const IMPLEMENTATION_ADVISOR_BANNER = "COUNCIL RUN MODE: implementation \u2014 you are an ADVISOR.\nDo NOT write or edit project files (not via write_file/edit_file, and not via bash) \u2014 the final synthesizer (Lucifero) is the sole implementer. Your job is to inspect the codebase (read_file, grep_content, list_files) and produce analysis, a concrete plan, or critique that the implementer will execute. Design-phase mandatory workspace blocks in your role prompt are INACTIVE in this run.";
+/**
+ * Pick the run-mode banner for a member.
+ *
+ * @param opts.isImplementer  In implementation mode, `true` selects the
+ *   implementer banner (chairman/Lucifero), `false` the advisor banner
+ *   (specialists + Minosse). Omitted → the legacy generic banner (kept for
+ *   backward compatibility with callers that don't distinguish roles).
+ */
+export declare function councilModeBanner(runMode: CouncilRunMode, opts?: {
+    isImplementer?: boolean;
+}): string;
 //# sourceMappingURL=modeBanners.d.ts.map

package/dist/council/modeBanners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"modeBanners.d.ts","sourceRoot":"","sources":["../../src/council/modeBanners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,wBAAwB,4PAC6K,CAAC;AAEnN,eAAO,MAAM,0BAA0B,2PACwK,CAAC;AAEhN,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAIjE"}
+{"version":3,"file":"modeBanners.d.ts","sourceRoot":"","sources":["../../src/council/modeBanners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,eAAO,MAAM,wBAAwB,4PAC6K,CAAC;AAEnN,eAAO,MAAM,0BAA0B,2PACwK,CAAC;AAEhN;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,4aACmT,CAAC;AAElW;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,4cAC4V,CAAC;AAEvY;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,MAAM,CAKR"}

package/dist/council/modeBanners.js

@@ -2,9 +2,36 @@ export const DESIGN_PHASE_MODE_BANNER = `COUNCIL RUN MODE: design-phase.
 Workspace tool emissions described in your role prompt are MANDATORY in this run — prose alone does not count as a deliverable. Persist artifacts via the workspace tools listed in your AVAILABLE TOOLS section.`;
 export const IMPLEMENTATION_MODE_BANNER = `COUNCIL RUN MODE: implementation.
 Prefer write_file, edit_file, and bash for code changes. Design-phase mandatory workspace blocks in your role prompt are INACTIVE in this run — only call workspace tools when they add durable project value.`;
-export function councilModeBanner(runMode) {
-    return runMode === 'design-phase'
-        ? DESIGN_PHASE_MODE_BANNER
-        : IMPLEMENTATION_MODE_BANNER;
+/**
+ * Implementation-mode banner for the SOLE implementer (the chairman, Lucifero).
+ * Only this member writes/edits project files, so the "who implemented" signal
+ * stays unambiguous and multiple agents never edit the same files.
+ */
+export const IMPLEMENTATION_IMPLEMENTER_BANNER = `COUNCIL RUN MODE: implementation — you are the IMPLEMENTER.
+You are the only member that writes code this run. Implement the solution with write_file / edit_file and verify with bash. Reconcile the specialists' analysis and Minosse's critique into working, verified changes. Design-phase mandatory workspace blocks in your role prompt are INACTIVE — only call workspace tools when they add durable project value.`;
+/**
+ * Implementation-mode banner for advisors (specialists + Minosse). They analyze,
+ * plan and critique; they must NOT modify project files (the implementer does).
+ * This prevents multi-writer chaos where several agents edit the same files and
+ * pile up conflicting changes.
+ */
+export const IMPLEMENTATION_ADVISOR_BANNER = `COUNCIL RUN MODE: implementation — you are an ADVISOR.
+Do NOT write or edit project files (not via write_file/edit_file, and not via bash) — the final synthesizer (Lucifero) is the sole implementer. Your job is to inspect the codebase (read_file, grep_content, list_files) and produce analysis, a concrete plan, or critique that the implementer will execute. Design-phase mandatory workspace blocks in your role prompt are INACTIVE in this run.`;
+/**
+ * Pick the run-mode banner for a member.
+ *
+ * @param opts.isImplementer  In implementation mode, `true` selects the
+ *   implementer banner (chairman/Lucifero), `false` the advisor banner
+ *   (specialists + Minosse). Omitted → the legacy generic banner (kept for
+ *   backward compatibility with callers that don't distinguish roles).
+ */
+export function councilModeBanner(runMode, opts) {
+    if (runMode === 'design-phase')
+        return DESIGN_PHASE_MODE_BANNER;
+    if (opts?.isImplementer === true)
+        return IMPLEMENTATION_IMPLEMENTER_BANNER;
+    if (opts?.isImplementer === false)
+        return IMPLEMENTATION_ADVISOR_BANNER;
+    return IMPLEMENTATION_MODE_BANNER;
 }
 //# sourceMappingURL=modeBanners.js.map

package/dist/council/modeBanners.js.map

@@ -1 +1 @@
-{"version":3,"file":"modeBanners.js","sourceRoot":"","sources":["../../src/council/modeBanners.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG;kNAC0K,CAAC;AAEnN,MAAM,CAAC,MAAM,0BAA0B,GAAG;+MACqK,CAAC;AAEhN,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,OAAO,OAAO,KAAK,cAAc;QAC/B,CAAC,CAAC,wBAAwB;QAC1B,CAAC,CAAC,0BAA0B,CAAC;AACjC,CAAC"}
+{"version":3,"file":"modeBanners.js","sourceRoot":"","sources":["../../src/council/modeBanners.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAG;kNAC0K,CAAC;AAEnN,MAAM,CAAC,MAAM,0BAA0B,GAAG;+MACqK,CAAC;AAEhN;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;iWACgT,CAAC;AAElW;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG;sYACyV,CAAC;AAEvY;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAuB,EACvB,IAAkC;IAElC,IAAI,OAAO,KAAK,cAAc;QAAE,OAAO,wBAAwB,CAAC;IAChE,IAAI,IAAI,EAAE,aAAa,KAAK,IAAI;QAAE,OAAO,iCAAiC,CAAC;IAC3E,IAAI,IAAI,EAAE,aAAa,KAAK,KAAK;QAAE,OAAO,6BAA6B,CAAC;IACxE,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/dist/council/scope/extractTaskScope.d.ts

@@ -0,0 +1,35 @@
+import type { NfrSpec } from '../verification/types.js';
+/** Keywords that indicate measurable NFR constraints (motion, perf, budget). */
+export declare const NFR_KEYWORDS: readonly ["motion", "animation", "animate", "keyframes", "transition", "compositor", "reduced-motion", "prefers-reduced-motion", "byte budget", "bytes", "performance", "perf budget", "nfr", "layout thrash", "box-shadow", "inline js", "inline-js"];
+export interface TaskScope {
+    /** Project-relative file targets for this task. */
+    targets: string[];
+    /** Task theme keywords (animation, motion, …). */
+    keywords: string[];
+    /** Features explicitly deferred or out of scope for this run. */
+    explicitOut: string[];
+    /** Whether NFR-style constraints appear in the user request. */
+    nfrRelevant: boolean;
+    sources: Array<'userMessage' | 'nfr-spec'>;
+}
+export interface ExtractTaskScopeInput {
+    userMessage: string;
+    nfrSpec?: NfrSpec | null;
+    /** Optional plan text (JSON string or markdown) for backlog hints. */
+    planText?: string;
+}
+/** True when the task text mentions measurable NFR themes. */
+export declare function taskMatchesNfrKeywords(userMessage: string, planText?: string): boolean;
+/**
+ * Deterministic task scope from user message + optional nfr-spec.
+ * No NLP — keyword overlap, file-path regex, and nfr-spec targets only.
+ */
+export declare function extractTaskScope(input: ExtractTaskScopeInput): TaskScope;
+export interface ScopeMatchInput {
+    name?: string;
+    description?: string;
+    id?: string;
+}
+/** Classify a plan task relative to extracted scope. */
+export declare function classifyTaskScope(task: ScopeMatchInput, scope: TaskScope): 'in-scope' | 'backlog' | 'neutral';
+//# sourceMappingURL=extractTaskScope.d.ts.map

package/dist/council/scope/extractTaskScope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractTaskScope.d.ts","sourceRoot":"","sources":["../../../src/council/scope/extractTaskScope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAExD,gFAAgF;AAChF,eAAO,MAAM,YAAY,wPAkBf,CAAC;AAgCX,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gEAAgE;IAChE,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC,aAAa,GAAG,UAAU,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAGT;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAiCxE;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,SAAS,GACf,UAAU,GAAG,SAAS,GAAG,SAAS,CAgCpC"}