@theihtisham/agent-shadow-brain 6.0.0 → 6.0.3

package/dist/brain/confidence-gate.js

@@ -0,0 +1,244 @@
+// src/brain/confidence-gate.ts — Active output filter for confidence-tagged results
+// v6.0.2 — Hive Mind Edition
+//
+// CalibrationMonitor is passive: it watches claims roll past and scores them.
+// This module is the active half: given a `{text, confidence}` result, it
+// can block it, downgrade its tone, or flag it with a warning — depending on
+// the gate mode chosen by the caller.
+//
+// Why three modes? Different callers want different ergonomics:
+//   - block:     hard gate for tool calls / autonomous agents that must not
+//                act on shaky info.
+//   - downgrade: chat surfaces, where we still want to say something but
+//                visibly hedge so the user doesn't trust it blindly.
+//   - flag:     observability layer that lets downstream logic decide.
+//
+// Calibration history (predicted → outcome) is logged as JSONL so the
+// reliability of `confidence` itself is auditable. Brier score + ECE on
+// .stats() lets us tell whether the gate threshold is well-chosen.
+//
+// Exposed: ConfidenceGate, getConfidenceGate(), resetConfidenceGateForTests().
+//   .gate(result, opts)
+//   .recordOutcome(predicted, wasCorrect, meta?)
+//   .stats()
+//   .setThreshold(t), .getThreshold()
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const HOME_DIR = path.join(os.homedir(), '.shadow-brain');
+const HISTORY_PATH = path.join(HOME_DIR, 'calibration-history.jsonl');
+const CONFIG_PATH = path.join(HOME_DIR, 'config.json');
+const DEFAULT_THRESHOLD = 0.6;
+const ECE_BUCKETS = 10;
+export class ConfidenceGate {
+    constructor() {
+        this.threshold = DEFAULT_THRESHOLD;
+        this.historyCache = null;
+        this.initialized = false;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(HOME_DIR, { recursive: true });
+        this.threshold = this.readConfiguredThreshold();
+        this.initialized = true;
+    }
+    /** Apply the gate. Synchronous because the threshold is already loaded. */
+    gate(result, opts) {
+        if (!this.initialized)
+            this.threshold = this.readConfiguredThreshold();
+        const threshold = opts.threshold ?? this.threshold;
+        const predicted = clamp(result.confidence, 0, 1);
+        if (predicted >= threshold) {
+            return {
+                blocked: false,
+                result,
+                mode: opts.mode,
+                predicted,
+                threshold,
+                downgraded: false,
+            };
+        }
+        switch (opts.mode) {
+            case 'block':
+                return {
+                    blocked: true,
+                    reason: `Confidence ${(predicted * 100).toFixed(0)}% below threshold ${(threshold * 100).toFixed(0)}%`,
+                    predicted,
+                    threshold,
+                };
+            case 'downgrade': {
+                const hedged = {
+                    ...result,
+                    text: hedge(result.text, predicted, opts.hedgeHint),
+                    _warning: `low-confidence (${(predicted * 100).toFixed(0)}%)`,
+                };
+                return { blocked: false, result: hedged, mode: 'downgrade', predicted, threshold, downgraded: true };
+            }
+            case 'flag':
+            default:
+                return {
+                    blocked: false,
+                    result: { ...result, _warning: `low-confidence (${(predicted * 100).toFixed(0)}%)` },
+                    mode: 'flag',
+                    predicted,
+                    threshold,
+                    downgraded: false,
+                };
+        }
+    }
+    /** Record what actually happened so we can compute calibration stats later. */
+    async recordOutcome(predicted, wasCorrect, meta) {
+        await this.init();
+        const entry = {
+            ts: new Date().toISOString(),
+            predicted: clamp(predicted, 0, 1),
+            wasCorrect: wasCorrect === 'partial' ? 0.5 : wasCorrect ? 1 : 0,
+            meta,
+        };
+        try {
+            fs.appendFileSync(HISTORY_PATH, JSON.stringify(entry) + '\n');
+        }
+        catch { /* non-fatal */ }
+        if (this.historyCache)
+            this.historyCache.push(entry);
+    }
+    /** Brier + ECE over all recorded outcomes. */
+    async stats() {
+        await this.init();
+        const entries = this.loadHistory();
+        if (!entries.length) {
+            return {
+                sampleSize: 0,
+                brierScore: 0,
+                expectedCalibrationError: 0,
+                bucketBreakdown: [],
+                threshold: this.threshold,
+            };
+        }
+        let brierSum = 0;
+        for (const e of entries) {
+            const d = e.predicted - e.wasCorrect;
+            brierSum += d * d;
+        }
+        const brier = brierSum / entries.length;
+        const buckets = [];
+        for (let i = 0; i < ECE_BUCKETS; i++) {
+            const lo = i / ECE_BUCKETS;
+            const hi = (i + 1) / ECE_BUCKETS;
+            const inBucket = entries.filter(e => e.predicted >= lo && (i === ECE_BUCKETS - 1 ? e.predicted <= hi : e.predicted < hi));
+            if (!inBucket.length)
+                continue;
+            const meanPredicted = avg(inBucket.map(e => e.predicted));
+            const meanOutcome = avg(inBucket.map(e => e.wasCorrect));
+            buckets.push({
+                bucket: `${lo.toFixed(1)}-${hi.toFixed(1)}`,
+                samples: inBucket.length,
+                meanPredicted: +meanPredicted.toFixed(3),
+                meanOutcome: +meanOutcome.toFixed(3),
+                gap: +Math.abs(meanPredicted - meanOutcome).toFixed(3),
+            });
+        }
+        const ece = buckets.reduce((s, b) => s + (b.samples / entries.length) * b.gap, 0);
+        return {
+            sampleSize: entries.length,
+            brierScore: +brier.toFixed(4),
+            expectedCalibrationError: +ece.toFixed(4),
+            bucketBreakdown: buckets,
+            threshold: this.threshold,
+        };
+    }
+    setThreshold(t) {
+        this.threshold = clamp(t, 0, 1);
+        this.writeConfiguredThreshold(this.threshold);
+    }
+    getThreshold() { return this.threshold; }
+    /** Convenience wrapper for promise-returning functions. */
+    async wrap(fn, opts) {
+        await this.init();
+        const result = await fn();
+        return this.gate(result, opts);
+    }
+    // -- Internals -----------------------------------------------------------
+    loadHistory() {
+        if (this.historyCache)
+            return this.historyCache;
+        if (!fs.existsSync(HISTORY_PATH)) {
+            this.historyCache = [];
+            return this.historyCache;
+        }
+        const out = [];
+        try {
+            const lines = fs.readFileSync(HISTORY_PATH, 'utf-8').split('\n');
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    out.push(JSON.parse(line));
+                }
+                catch { /* skip malformed */ }
+            }
+        }
+        catch { /* fall through with empty cache */ }
+        this.historyCache = out;
+        return out;
+    }
+    readConfiguredThreshold() {
+        try {
+            if (!fs.existsSync(CONFIG_PATH))
+                return DEFAULT_THRESHOLD;
+            const cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+            const raw = cfg.confidenceGate;
+            if (typeof raw === 'number')
+                return clamp(raw, 0, 1);
+            if (raw && typeof raw === 'object' && typeof raw.threshold === 'number')
+                return clamp(raw.threshold, 0, 1);
+            return DEFAULT_THRESHOLD;
+        }
+        catch {
+            return DEFAULT_THRESHOLD;
+        }
+    }
+    writeConfiguredThreshold(t) {
+        try {
+            let cfg = {};
+            if (fs.existsSync(CONFIG_PATH)) {
+                try {
+                    cfg = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+                }
+                catch {
+                    cfg = {};
+                }
+            }
+            cfg.confidenceGate = t;
+            fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2));
+        }
+        catch { /* non-fatal */ }
+    }
+}
+function hedge(text, confidence, hint) {
+    const pct = Math.round(confidence * 100);
+    const verifyTarget = hint || 'the key claims';
+    return `I'm only ${pct}% confident — verify ${verifyTarget} first:\n\n${text}`;
+}
+function clamp(x, lo, hi) {
+    if (Number.isNaN(x))
+        return lo;
+    return x < lo ? lo : x > hi ? hi : x;
+}
+function avg(xs) {
+    if (!xs.length)
+        return 0;
+    let s = 0;
+    for (const x of xs)
+        s += x;
+    return s / xs.length;
+}
+let _instance = null;
+export function getConfidenceGate() {
+    if (!_instance)
+        _instance = new ConfidenceGate();
+    return _instance;
+}
+export function resetConfidenceGateForTests() { _instance = null; }
+//# sourceMappingURL=confidence-gate.js.map

package/dist/brain/confidence-gate.js.map

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

package/dist/brain/constitution.d.ts

@@ -0,0 +1,59 @@
+export type RuleSeverity = 'must' | 'should' | 'never';
+export type RuleScope = 'all' | 'code' | 'commits' | 'tests';
+export interface ConstitutionRule {
+    id: string;
+    severity: RuleSeverity;
+    scope: RuleScope;
+    title: string;
+    text: string;
+    keywords: string[];
+    source: 'file' | 'proposed' | 'approved';
+}
+export interface Violation {
+    rule: ConstitutionRule;
+    confidence: number;
+    evidence: string;
+}
+export interface ValidateResult {
+    violations: Violation[];
+    passed: ConstitutionRule[];
+}
+interface InjectOpts {
+    scope?: RuleScope;
+    maxRules?: number;
+}
+export declare class Constitution {
+    private rules;
+    private approved;
+    private projectRoot;
+    private watcher;
+    private initialized;
+    private embeddings;
+    private vectorCache;
+    constructor(projectRoot?: string);
+    init(): Promise<void>;
+    /** Prepend the most relevant constitution rules to a prompt as a preamble. */
+    injectInto(prompt: string, opts?: InjectOpts): string;
+    /**
+     * Score `text` against every rule. Uses both keyword matching (fast, precise)
+     * and semantic similarity (slower, fuzzy). Reports a confidence in [0,1].
+     */
+    validate(text: string): Promise<ValidateResult>;
+    /** Build a candidate rule from an observed pattern. Template-only, no LLM. */
+    proposeRule(observation: string): ConstitutionRule;
+    /** Persist a user-approved rule to constitution-approved.json. */
+    approve(rule: ConstitutionRule): Promise<ConstitutionRule>;
+    listRules(): ConstitutionRule[];
+    dispose(): void;
+    private allRules;
+    private loadFromDisk;
+    private startWatcher;
+    private cachedEmbed;
+    private extractEvidence;
+    private logViolation;
+}
+export declare function parseConstitutionMarkdown(md: string): ConstitutionRule[];
+export declare function getConstitution(projectRoot?: string): Constitution;
+export declare function resetConstitutionForTests(): void;
+export {};
+//# sourceMappingURL=constitution.d.ts.map

package/dist/brain/constitution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitution.d.ts","sourceRoot":"","sources":["../../src/brain/constitution.ts"],"names":[],"mappings":"AAkCA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AACvD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;CAC1C;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,WAAW,CAAoC;gBAE3C,WAAW,GAAE,MAAsB;IAIzC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,8EAA8E;IAC9E,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,MAAM;IAgBzD;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgCrD,8EAA8E;IAC9E,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IAgBlD,kEAAkE;IAC5D,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAUhE,SAAS,IAAI,gBAAgB,EAAE;IAE/B,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,QAAQ;IAEhB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,YAAY;YAcN,WAAW;IAQzB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,YAAY;CAarB;AAID,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkCxE;AA2CD,wBAAgB,eAAe,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAGlE;AACD,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD"}

package/dist/brain/constitution.js

@@ -0,0 +1,315 @@
+// src/brain/constitution.ts — Project invariants ("constitution") layer
+// v6.0.2 — Hive Mind Edition
+//
+// Reads <project_root>/.shadow-brain/constitution.md, parses Markdown rules
+// under `## Rule N` headings, and exposes them to other parts of the brain
+// for prompt injection and post-hoc validation.
+//
+// Each rule is one of:
+//   - must    : hard requirement, violations always flagged
+//   - should  : strong preference, flagged with lower confidence
+//   - never   : prohibition, treated like must but inverted
+//
+// Rule format inside constitution.md:
+//
+//   ## Rule 1: short title
+//   severity: must|should|never
+//   scope: all|code|commits|tests
+//   No secrets in commits. Use env vars only.
+//
+// Why no LLM call in proposeRule? The point is to draft a rule the user can
+// review and edit; an LLM round-trip would slow that loop. The template-based
+// proposer is "good enough" — humans confirm before persisting.
+//
+// Exposed: Constitution, getConstitution(), resetConstitutionForTests().
+//   .injectInto(prompt, opts)
+//   .validate(text)
+//   .proposeRule(observation)
+//   .approve(rule), .listRules()
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getEmbeddings } from './embeddings.js';
+const HOME_DIR = path.join(os.homedir(), '.shadow-brain');
+const VIOLATIONS_LOG = path.join(HOME_DIR, 'constitution-violations.jsonl');
+const PROJECT_REL_PATH = path.join('.shadow-brain', 'constitution.md');
+const APPROVED_REL_PATH = path.join('.shadow-brain', 'constitution-approved.json');
+const DEFAULT_MAX_RULES = 6;
+export class Constitution {
+    constructor(projectRoot = process.cwd()) {
+        this.rules = [];
+        this.approved = [];
+        this.watcher = null;
+        this.initialized = false;
+        this.embeddings = getEmbeddings();
+        this.vectorCache = new Map();
+        this.projectRoot = projectRoot;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(HOME_DIR, { recursive: true });
+        this.loadFromDisk();
+        this.startWatcher();
+        this.initialized = true;
+    }
+    /** Prepend the most relevant constitution rules to a prompt as a preamble. */
+    injectInto(prompt, opts = {}) {
+        const scope = opts.scope ?? 'all';
+        const max = opts.maxRules ?? DEFAULT_MAX_RULES;
+        const relevant = this.allRules()
+            .filter(r => r.scope === 'all' || r.scope === scope)
+            .slice(0, max);
+        if (!relevant.length)
+            return prompt;
+        const preamble = [
+            '## Project Constitution (binding rules)',
+            ...relevant.map((r, i) => `${i + 1}. [${r.severity.toUpperCase()}] ${r.title} — ${r.text}`),
+            '',
+            '## Task',
+        ].join('\n');
+        return `${preamble}\n${prompt}`;
+    }
+    /**
+     * Score `text` against every rule. Uses both keyword matching (fast, precise)
+     * and semantic similarity (slower, fuzzy). Reports a confidence in [0,1].
+     */
+    async validate(text) {
+        await this.init();
+        const violations = [];
+        const passed = [];
+        const haystack = text.toLowerCase();
+        for (const rule of this.allRules()) {
+            const keywordHit = rule.keywords.some(k => haystack.includes(k));
+            let semanticScore = 0;
+            try {
+                const q = await this.embeddings.embed(text.slice(0, 4000));
+                const r = await this.cachedEmbed(rule.text);
+                semanticScore = cosine(q, r);
+            }
+            catch { /* embeddings optional */ }
+            const triggers = rule.severity === 'never'
+                ? keywordHit || semanticScore > 0.55
+                : keywordHit && semanticScore > 0.35;
+            if (triggers) {
+                const confidence = clamp(0.4 * (keywordHit ? 1 : 0) + 0.6 * semanticScore, 0, 1);
+                const evidence = this.extractEvidence(text, rule.keywords);
+                violations.push({ rule, confidence: +confidence.toFixed(3), evidence });
+                this.logViolation(rule, confidence, evidence);
+            }
+            else {
+                passed.push(rule);
+            }
+        }
+        return { violations, passed };
+    }
+    /** Build a candidate rule from an observed pattern. Template-only, no LLM. */
+    proposeRule(observation) {
+        const trimmed = observation.trim().slice(0, 600);
+        const severity = guessSeverity(trimmed);
+        const scope = guessScope(trimmed);
+        const title = trimmed.split(/[.\n]/)[0].slice(0, 80) || 'Untitled rule';
+        return {
+            id: `proposed-${Date.now().toString(36)}`,
+            severity,
+            scope,
+            title,
+            text: trimmed,
+            keywords: extractKeywords(trimmed),
+            source: 'proposed',
+        };
+    }
+    /** Persist a user-approved rule to constitution-approved.json. */
+    async approve(rule) {
+        const approved = { ...rule, source: 'approved' };
+        this.approved.push(approved);
+        const dir = path.join(this.projectRoot, '.shadow-brain');
+        fs.mkdirSync(dir, { recursive: true });
+        const file = path.join(this.projectRoot, APPROVED_REL_PATH);
+        fs.writeFileSync(file, JSON.stringify(this.approved, null, 2));
+        return approved;
+    }
+    listRules() { return this.allRules(); }
+    dispose() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    // -- Internals -----------------------------------------------------------
+    allRules() { return [...this.rules, ...this.approved]; }
+    loadFromDisk() {
+        const file = path.join(this.projectRoot, PROJECT_REL_PATH);
+        if (fs.existsSync(file)) {
+            try {
+                this.rules = parseConstitutionMarkdown(fs.readFileSync(file, 'utf-8'));
+            }
+            catch {
+                this.rules = [];
+            }
+        }
+        else {
+            this.rules = [];
+        }
+        const approvedFile = path.join(this.projectRoot, APPROVED_REL_PATH);
+        if (fs.existsSync(approvedFile)) {
+            try {
+                this.approved = JSON.parse(fs.readFileSync(approvedFile, 'utf-8'));
+            }
+            catch {
+                this.approved = [];
+            }
+        }
+        else {
+            this.approved = [];
+        }
+        this.vectorCache.clear();
+    }
+    startWatcher() {
+        const dir = path.join(this.projectRoot, '.shadow-brain');
+        if (!fs.existsSync(dir))
+            return;
+        try {
+            this.watcher = fs.watch(dir, { persistent: false }, (_event, filename) => {
+                if (!filename)
+                    return;
+                if (filename.toString().endsWith('constitution.md') ||
+                    filename.toString().endsWith('constitution-approved.json')) {
+                    this.loadFromDisk();
+                }
+            });
+        }
+        catch { /* watcher not critical */ }
+    }
+    async cachedEmbed(text) {
+        const cached = this.vectorCache.get(text);
+        if (cached)
+            return cached;
+        const v = await this.embeddings.embed(text);
+        this.vectorCache.set(text, v);
+        return v;
+    }
+    extractEvidence(text, keywords) {
+        const lower = text.toLowerCase();
+        for (const k of keywords) {
+            const idx = lower.indexOf(k);
+            if (idx >= 0) {
+                const start = Math.max(0, idx - 40);
+                const end = Math.min(text.length, idx + k.length + 40);
+                return text.slice(start, end).replace(/\s+/g, ' ');
+            }
+        }
+        return text.slice(0, 120).replace(/\s+/g, ' ');
+    }
+    logViolation(rule, confidence, evidence) {
+        try {
+            const entry = {
+                ts: new Date().toISOString(),
+                projectRoot: this.projectRoot,
+                ruleId: rule.id,
+                severity: rule.severity,
+                confidence,
+                evidence,
+            };
+            fs.appendFileSync(VIOLATIONS_LOG, JSON.stringify(entry) + '\n');
+        }
+        catch { /* non-fatal */ }
+    }
+}
+// -- Markdown parser ------------------------------------------------------
+export function parseConstitutionMarkdown(md) {
+    const out = [];
+    // Split on H2 headings that start with "Rule".
+    const blocks = md.split(/^##\s+Rule\s+/im).slice(1);
+    for (const block of blocks) {
+        const lines = block.split(/\r?\n/);
+        const headLine = lines.shift() ?? '';
+        const m = headLine.match(/^(\S+)\s*[:\-—]?\s*(.*)$/);
+        const id = `rule-${(m?.[1] ?? out.length + 1).toString().replace(/[^\w-]/g, '')}`;
+        const title = (m?.[2] ?? '').trim() || `Rule ${out.length + 1}`;
+        let severity = 'must';
+        let scope = 'all';
+        const bodyLines = [];
+        for (const line of lines) {
+            const sev = line.match(/^severity\s*:\s*(must|should|never)/i);
+            const sco = line.match(/^scope\s*:\s*(all|code|commits|tests)/i);
+            if (sev) {
+                severity = sev[1].toLowerCase();
+                continue;
+            }
+            if (sco) {
+                scope = sco[1].toLowerCase();
+                continue;
+            }
+            bodyLines.push(line);
+        }
+        const text = bodyLines.join('\n').trim();
+        if (!text)
+            continue;
+        out.push({
+            id,
+            severity,
+            scope,
+            title,
+            text,
+            keywords: extractKeywords(`${title} ${text}`),
+            source: 'file',
+        });
+    }
+    return out;
+}
+function extractKeywords(text) {
+    const stop = new Set(['the', 'a', 'an', 'and', 'or', 'of', 'to', 'for', 'in', 'on', 'is', 'it', 'this', 'that', 'as', 'by', 'be', 'do', 'not', 'no', 'use', 'with', 'must', 'should', 'never', 'only']);
+    const seen = new Set();
+    const out = [];
+    const norm = text.toLowerCase().replace(/[^a-z0-9\s]/g, ' ');
+    for (const tok of norm.split(/\s+/)) {
+        if (tok.length < 4 || stop.has(tok) || seen.has(tok))
+            continue;
+        seen.add(tok);
+        out.push(tok);
+        if (out.length >= 8)
+            break;
+    }
+    return out;
+}
+function guessSeverity(text) {
+    const lower = text.toLowerCase();
+    if (/\b(never|don'?t|prohibit|forbid|disallow|do not)\b/.test(lower))
+        return 'never';
+    if (/\b(should|prefer|avoid|try to)\b/.test(lower))
+        return 'should';
+    return 'must';
+}
+function guessScope(text) {
+    const lower = text.toLowerCase();
+    if (/\b(commit|git|push|branch|merge)\b/.test(lower))
+        return 'commits';
+    if (/\b(test|spec|coverage|assert)\b/.test(lower))
+        return 'tests';
+    if (/\b(code|function|class|import|api)\b/.test(lower))
+        return 'code';
+    return 'all';
+}
+function cosine(a, b) {
+    let d = 0;
+    const n = Math.min(a.length, b.length);
+    for (let i = 0; i < n; i++)
+        d += a[i] * b[i];
+    return d;
+}
+function clamp(x, lo, hi) {
+    return x < lo ? lo : x > hi ? hi : x;
+}
+let _instance = null;
+export function getConstitution(projectRoot) {
+    if (!_instance)
+        _instance = new Constitution(projectRoot);
+    return _instance;
+}
+export function resetConstitutionForTests() {
+    if (_instance)
+        _instance.dispose();
+    _instance = null;
+}
+//# sourceMappingURL=constitution.js.map

package/dist/brain/constitution.js.map

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