mindweave 2.5.0 → 3.0.0

package/dist/dynamo/usageLimits.js

@@ -0,0 +1,446 @@
+/**
+ * usageLimits.ts — a cap you set on your own use, in windows that open and close.
+ *
+ * Shaped like the plans people already know: a short window (5 hours) that closes when its
+ * amount is used and reopens when it ends; a longer one (a week) that does the same; and the
+ * month's own budget above both. You set the month, "Analyze" works out the other two from how
+ * you actually use the tool, and the numbers stay editable.
+ *
+ * THE UNIT IS YOURS: tokens (fresh input plus output, the same "billed" figure the Spend tab
+ * shows) or money (those tokens at each model's own rates). Both come from the per-call log
+ * every session already keeps, so nothing new is recorded and nothing leaves the machine.
+ *
+ * WINDOWS ARE DERIVED, NOT STORED. A window opens at the first use after the previous one
+ * ended and lasts its span, so where one starts is a fact about the usage history and can be
+ * recomputed from it. That keeps the app and the terminal agreeing without sharing any state
+ * beyond the history they both already write.
+ *
+ * A LIMIT IS CHECKED BETWEEN STEPS, never inside one. A step that begins under the limit
+ * finishes, so a window can be passed by what that one step cost (a few thousand tokens) and
+ * never by more. The next step is what stops, and it stops cleanly: nothing is lost, and the
+ * work can carry on once the window reopens.
+ */
+import { promises as fs } from "node:fs";
+import { join } from "node:path";
+import { callRecords, everyMeta } from "../memory/allMetas.js";
+import { stateRoot } from "../memory/store.js";
+import { priceFor } from "./pricing.js";
+export const DEFAULT_LIMITS = {
+    enabled: false,
+    unit: "tokens",
+    monthly: 0,
+    monthStartDay: 1,
+    fiveHour: 0,
+    weekly: 0,
+    enforce: true,
+};
+export const FIVE_HOURS_MS = 5 * 60 * 60 * 1000;
+export const WEEK_MS = 7 * 24 * 60 * 60 * 1000;
+/** How much history the windows are worked out from. Long enough for a week's chain to settle. */
+const HORIZON_MS = 62 * 24 * 60 * 60 * 1000;
+/** Warnings, lowest first. Each fires once per window. */
+const WARN_AT = [0.8, 0.95];
+/** The disk is re-read at most this often; live use is added in between. */
+const REFRESH_MS = 60_000;
+// ── config ───────────────────────────────────────────────────────────────────
+export function limitsPath() {
+    return join(stateRoot(), "limits.json");
+}
+function num(v, fallback, max = Number.MAX_SAFE_INTEGER) {
+    const n = typeof v === "number" ? v : Number(v);
+    return Number.isFinite(n) && n >= 0 ? Math.min(n, max) : fallback;
+}
+/** Whatever was written, made safe: a hand-edited or half-written file never breaks the app. */
+export function sanitizeLimits(raw) {
+    const r = (raw && typeof raw === "object" ? raw : {});
+    const unit = r["unit"] === "usd" ? "usd" : "tokens";
+    const money = unit === "usd";
+    const round = (n) => (money ? Math.round(n * 100) / 100 : Math.round(n));
+    const cfg = {
+        enabled: r["enabled"] === true,
+        unit,
+        monthly: round(num(r["monthly"], 0)),
+        monthStartDay: Math.min(28, Math.max(1, Math.round(num(r["monthStartDay"], 1)))),
+        fiveHour: round(num(r["fiveHour"], 0)),
+        weekly: round(num(r["weekly"], 0)),
+        enforce: r["enforce"] !== false,
+    };
+    const at = num(r["analyzedAt"], 0);
+    if (at > 0)
+        cfg.analyzedAt = at;
+    const reset = num(r["weeklyResetAt"], 0);
+    if (reset > 0)
+        cfg.weeklyResetAt = reset;
+    return cfg;
+}
+export async function readLimitsConfig() {
+    try {
+        return sanitizeLimits(JSON.parse(await fs.readFile(limitsPath(), "utf8")));
+    }
+    catch {
+        return { ...DEFAULT_LIMITS };
+    }
+}
+async function writeLimitsFile(cfg) {
+    const file = limitsPath();
+    await fs.mkdir(stateRoot(), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(cfg, null, 2), "utf8");
+    await fs.rename(tmp, file); // whole file or nothing: a crash mid-write cannot leave half of one
+}
+let config = { ...DEFAULT_LIMITS };
+let ledger = [];
+let loadedAt = 0;
+const told = new Set();
+/** Fresh input plus output, and what those cost at the model's own rates. */
+export function callAmount(model, hit, miss, out) {
+    const price = priceFor(model);
+    return { tokens: miss + out, usd: (hit * price.cacheHit + miss * price.cacheMiss + out * price.output) / 1_000_000 };
+}
+async function loadLedger(now) {
+    const since = now - HORIZON_MS;
+    const recs = [];
+    for (const meta of await everyMeta()) {
+        for (const c of callRecords(meta)) {
+            if (c.at >= since)
+                recs.push({ at: c.at, ...callAmount(c.model, c.hit, c.miss, c.out) });
+        }
+    }
+    return recs.sort((a, b) => a.at - b.at);
+}
+// ── the 5-hour session's start, remembered ──────────────────────────────────
+function statePath() {
+    return join(stateRoot(), "limits-state.json");
+}
+/**
+ * Where the current 5-hour session began. A session opens at the first use after the last one
+ * ended, so its start is a fact of the history; it is kept so that it stays put, rather than
+ * being worked out again from however much history happens to be in view (nonstop use would
+ * otherwise slide its boundaries as old records age out).
+ */
+let fiveSeed = null;
+async function readFiveSeed() {
+    try {
+        const v = JSON.parse(await fs.readFile(statePath(), "utf8")).fiveHourStart;
+        return typeof v === "number" && Number.isFinite(v) && v > 0 ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeFiveSeed() {
+    try {
+        await fs.mkdir(stateRoot(), { recursive: true });
+        const tmp = `${statePath()}.${process.pid}.tmp`;
+        await fs.writeFile(tmp, JSON.stringify({ fiveHourStart: fiveSeed }), "utf8");
+        await fs.rename(tmp, statePath());
+    }
+    catch {
+        /* the start is re-derived from the history next time: losing this only costs exactness */
+    }
+}
+/** Where a session that began at `seed` stands once a use at `at` happens. */
+function advanceSeed(seed, at) {
+    return seed === null || at >= seed + FIVE_HOURS_MS ? at : seed;
+}
+/**
+ * Bring the settings and the history up to date. Cheap when limits are off (one small file
+ * read), and when on the disk is scanned at most once a minute, with live use added between.
+ * `force` reads the history even while limits are off: Analyze needs it before they are on.
+ */
+export async function refreshUsageLimits(opts = {}) {
+    const now = opts.now ?? Date.now();
+    config = await readLimitsConfig();
+    if (!config.enabled && !opts.force)
+        return config;
+    if (opts.force || loadedAt === 0 || now - loadedAt >= REFRESH_MS)
+        await adoptLedger(await loadLedger(now), now);
+    // A limit set before the week had a fixed reset: keep the week it was already in.
+    if (config.enabled && config.weekly > 0 && !config.weeklyResetAt) {
+        config = { ...config, weeklyResetAt: latestWindow(ledger, WEEK_MS, "tokens")?.start ?? now };
+        await writeLimitsFile(config);
+    }
+    return config;
+}
+/**
+ * Take a freshly read history as the truth, together with where the 5-hour session began: the
+ * remembered start carried forward through whatever has happened since. The two always move
+ * together, because a history without its session start would let the next call open a new
+ * session and ignore the hours already used.
+ */
+async function adoptLedger(recs, now) {
+    ledger = recs;
+    loadedAt = now;
+    const before = await readFiveSeed();
+    fiveSeed = latestWindow(ledger, FIVE_HOURS_MS, "tokens", before)?.start ?? null;
+    if (fiveSeed !== before)
+        await writeFiveSeed();
+}
+/** A model call finished: count it. Ignored while limits are off. */
+export function noteUsage(model, u, at = Date.now()) {
+    if (!config.enabled)
+        return;
+    // Exactly what the per-call log records for this call (fresh input plus output), so the figure
+    // does not change when the history is read back from disk, and matches the Spend tab.
+    ledger.push({ at, ...callAmount(model, u.cacheHitTokens, u.cacheMissTokens, u.completionTokens) });
+    const next = advanceSeed(fiveSeed, at);
+    if (next !== fiveSeed) {
+        fiveSeed = next;
+        void writeFiveSeed();
+    }
+}
+/**
+ * The latest window in a history: opens at the first use after the last one ended. With a
+ * `seed` (where a window is known to have begun) it carries on from there and ignores anything
+ * older, so the answer does not depend on how far back the history happens to reach.
+ */
+function latestWindow(recs, span, field, seed = null) {
+    let cur = seed !== null ? { start: seed, end: seed + span, used: 0 } : null;
+    for (const r of recs) {
+        if (seed !== null && r.at < seed)
+            continue;
+        if (!cur || r.at >= cur.end)
+            cur = { start: r.at, end: r.at + span, used: 0 };
+        cur.used += r[field];
+    }
+    return cur;
+}
+function daysIn(year, month) {
+    return new Date(year, month + 1, 0).getDate();
+}
+function billingStart(year, month, day) {
+    return new Date(year, month, Math.min(day, daysIn(year, month)), 0, 0, 0, 0).getTime();
+}
+/** The billing month containing `now`: [start, end) in local time. */
+export function billingMonth(now, day) {
+    const d = new Date(now);
+    let y = d.getFullYear();
+    let m = d.getMonth();
+    if (billingStart(y, m, day) > now) {
+        m -= 1;
+        if (m < 0) {
+            m = 11;
+            y -= 1;
+        }
+    }
+    const start = billingStart(y, m, day);
+    const ny = m === 11 ? y + 1 : y;
+    const nm = m === 11 ? 0 : m + 1;
+    return { start, end: billingStart(ny, nm, day) };
+}
+function stateOf(fraction, now, end) {
+    if (end === null)
+        return "idle";
+    if (now >= end)
+        return "idle";
+    if (fraction >= 1)
+        return "blocked";
+    if (fraction >= WARN_AT[0])
+        return "warn";
+    return "ok";
+}
+function windowStatus(id, label, limit, chain, now) {
+    const open = chain !== null && now < chain.end;
+    const used = open ? chain.used : 0;
+    const fraction = limit > 0 ? used / limit : 0;
+    return {
+        id,
+        label,
+        limit,
+        used,
+        fraction,
+        start: open ? chain.start : null,
+        end: open ? chain.end : null,
+        state: stateOf(fraction, now, open ? chain.end : null),
+    };
+}
+/** Where every window stands. Pure: hand it a config and a history. */
+export function computeStatus(cfg, recs, now, fiveStart = null) {
+    const field = cfg.unit === "usd" ? "usd" : "tokens";
+    const inHorizon = recs.filter((r) => r.at <= now).sort((a, b) => a.at - b.at); // windows chain in time order
+    const windows = [];
+    if (cfg.fiveHour > 0)
+        windows.push(windowStatus("fiveHour", "5-hour", cfg.fiveHour, latestWindow(inHorizon, FIVE_HOURS_MS, field, fiveStart), now));
+    if (cfg.weekly > 0) {
+        // A fixed weekly reset: the same day and time every week, whenever you use the tool. Weeks
+        // are counted from the reset moment, so they never depend on the history at all.
+        const anchor = cfg.weeklyResetAt ?? now;
+        const start = anchor + Math.floor((now - anchor) / WEEK_MS) * WEEK_MS;
+        const used = inHorizon.filter((r) => r.at >= start && r.at < start + WEEK_MS).reduce((s, r) => s + r[field], 0);
+        windows.push(windowStatus("weekly", "weekly", cfg.weekly, { start, end: start + WEEK_MS, used }, now));
+    }
+    if (cfg.monthly > 0) {
+        const m = billingMonth(now, cfg.monthStartDay);
+        const used = inHorizon.filter((r) => r.at >= m.start && r.at < m.end).reduce((s, r) => s + r[field], 0);
+        windows.push(windowStatus("monthly", "monthly", cfg.monthly, { start: m.start, end: m.end, used }, now));
+    }
+    const blocking = windows.filter((w) => w.state === "blocked");
+    const blocked = blocking.length > 0 ? blocking.reduce((a, b) => ((b.end ?? 0) > (a.end ?? 0) ? b : a)) : null;
+    return { unit: cfg.unit, enabled: cfg.enabled, enforce: cfg.enforce, windows, blocked, now };
+}
+/** Where the windows stand right now, from the live history. */
+export function limitStatus(now = Date.now()) {
+    return computeStatus(config, ledger, now, fiveSeed);
+}
+/** The settings as last read. */
+export function currentLimits() {
+    return config;
+}
+// ── wording ──────────────────────────────────────────────────────────────────
+export function formatAmount(unit, n) {
+    if (unit === "usd")
+        return n >= 100 ? `$${Math.round(n).toLocaleString("en-US")}` : `$${n.toFixed(2)}`;
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(n >= 10_000_000 ? 0 : 1)}M tokens`;
+    if (n >= 10_000)
+        return `${Math.round(n / 1000)}K tokens`;
+    if (n >= 1000)
+        return `${(n / 1000).toFixed(1)}K tokens`;
+    return `${Math.round(n)} tokens`;
+}
+/** "40m", "2h 10m", "3d 4h": how long until something happens. */
+export function formatWait(ms) {
+    const min = Math.max(1, Math.round(ms / 60_000));
+    if (min < 60)
+        return `${min}m`;
+    const h = Math.floor(min / 60);
+    if (h < 24)
+        return `${h}h${min % 60 ? ` ${min % 60}m` : ""}`;
+    const d = Math.floor(h / 24);
+    return `${d}d${h % 24 ? ` ${h % 24}h` : ""}`;
+}
+/** "7:40 PM" today, "Thu 9:15 AM" within the week, "Oct 1" beyond. */
+export function formatWhen(at, now) {
+    const d = new Date(at);
+    const time = d.toLocaleTimeString([], { hour: "numeric", minute: "2-digit" });
+    const sameDay = new Date(now).toDateString() === d.toDateString();
+    if (sameDay)
+        return time;
+    if (at - now < WEEK_MS)
+        return `${d.toLocaleDateString([], { weekday: "short" })} ${time}`;
+    return d.toLocaleDateString([], { month: "short", day: "numeric" });
+}
+function windowName(w) {
+    return w.id === "fiveHour" ? "5-hour" : w.id === "weekly" ? "weekly" : "monthly";
+}
+/** Why work is being held, in one sentence, or null when nothing is. */
+export function blockReason(status) {
+    const w = status.blocked;
+    if (!w || w.end === null)
+        return null;
+    return (`your ${windowName(w)} limit is used up (${formatAmount(status.unit, w.used)} of ${formatAmount(status.unit, w.limit)}). ` +
+        `It opens again ${formatWhen(w.end, status.now)} (in ${formatWait(w.end - status.now)})`);
+}
+/** What the engine asks before each step: a reason to stop, or null to carry on. */
+export function limitGateReason(now = Date.now()) {
+    if (!config.enabled || !config.enforce)
+        return null;
+    return blockReason(limitStatus(now));
+}
+/**
+ * Heads-up lines for windows that just crossed 80% or 95%. Each threshold speaks once per window,
+ * and if several were crossed at once only the highest is said.
+ */
+export function takeLimitWarnings(now = Date.now()) {
+    if (!config.enabled)
+        return [];
+    const status = limitStatus(now);
+    const out = [];
+    for (const w of status.windows) {
+        if (w.state === "idle" || w.end === null || w.start === null)
+            continue;
+        let hit = null;
+        for (const t of WARN_AT)
+            if (w.fraction >= t)
+                hit = t;
+        if (hit === null || w.fraction >= 1)
+            continue; // at 100% the gate speaks instead
+        if (told.has(`${w.id}:${w.start}:${hit}`))
+            continue;
+        // Anything lower counts as told too, so an 80% heads-up never follows a 95% one.
+        for (const t of WARN_AT)
+            if (t <= hit)
+                told.add(`${w.id}:${w.start}:${t}`);
+        out.push(`${Math.round(hit * 100)}% of your ${windowName(w)} limit is used (${formatAmount(status.unit, w.used)} of ${formatAmount(status.unit, w.limit)}). ` +
+            `It resets ${formatWhen(w.end, now)} (in ${formatWait(w.end - now)}).`);
+    }
+    return out;
+}
+const DEFAULT_WINDOWS_PER_WEEK = 8;
+/**
+ * Turn a month's budget into the windows that fit it.
+ *
+ * The week gets its share of the month (7 days out of however many this month has), so weeks
+ * spent in full add up to the month and nothing more. The 5-hour window comes from how you
+ * work: if you typically open about eight windows a week, one window's fair share is an eighth
+ * of the week; it is given half again as much so a long session is not cut short, but never
+ * more than half the week, so one heavy afternoon cannot spend the whole of it.
+ */
+export function analyzeLimits(cfg, recs, now) {
+    const money = cfg.unit === "usd";
+    const month = billingMonth(now, cfg.monthStartDay);
+    const days = Math.round((month.end - month.start) / 86_400_000);
+    const weekly = (cfg.monthly * 7) / days;
+    const since = now - 28 * 86_400_000;
+    const recent = recs.filter((r) => r.at >= since && r.at <= now).sort((a, b) => a.at - b.at);
+    let perWeek = DEFAULT_WINDOWS_PER_WEEK;
+    let basedOnDays = 0;
+    if (recent.length > 0) {
+        let windows = 0;
+        let end = 0;
+        for (const r of recent) {
+            if (r.at >= end) {
+                windows++;
+                end = r.at + FIVE_HOURS_MS;
+            }
+        }
+        basedOnDays = Math.max(1, Math.min(28, Math.ceil((now - recent[0].at) / 86_400_000)));
+        const weeks = Math.max(1, basedOnDays / 7);
+        perWeek = Math.min(14, Math.max(4, Math.round(windows / weeks)));
+    }
+    const fiveHourRaw = Math.min(weekly * 0.5, (weekly / perWeek) * 1.5);
+    const tidy = (n) => (money ? Math.max(0.01, Math.round(n * 100) / 100) : Math.max(1000, Math.round(n / 1000) * 1000));
+    const note = (basedOnDays > 0
+        ? `Based on your last ${basedOnDays} day${basedOnDays === 1 ? "" : "s"}: about ${perWeek} separate 5-hour windows a week. `
+        : `No history yet, so it assumes about ${perWeek} separate 5-hour windows a week. `) +
+        `The week gets 7 of this month's ${days} days of the budget, and a 5-hour window up to 1.5 times its fair share so a long session is not cut short.`;
+    return { fiveHour: tidy(fiveHourRaw), weekly: tidy(weekly), windowsPerWeek: perWeek, basedOnDays, note };
+}
+/** Analyze against the live history. */
+export function analyzeCurrent(cfg, now = Date.now()) {
+    return analyzeLimits(cfg, ledger, now);
+}
+// ── writing ──────────────────────────────────────────────────────────────────
+/** Save new settings (merged over the current ones), and start using them at once. */
+export async function saveLimits(patch) {
+    const next = sanitizeLimits({ ...(await readLimitsConfig()), ...patch });
+    // The week's fixed reset is the moment limits with a weekly amount are first turned on.
+    if (next.enabled && next.weekly > 0 && !next.weeklyResetAt)
+        next.weeklyResetAt = Date.now();
+    // Tracking with nothing to track is just "off", so the panel and the engine agree.
+    if (next.monthly <= 0 && next.fiveHour <= 0 && next.weekly <= 0)
+        next.enabled = false;
+    await writeLimitsFile(next);
+    const wasEnabled = config.enabled;
+    config = next;
+    if (next.enabled && (!wasEnabled || ledger.length === 0))
+        await adoptLedger(await loadLedger(Date.now()), Date.now());
+    told.clear(); // new numbers: earlier heads-ups no longer describe them
+    return next;
+}
+/** For tests: forget everything held in memory. */
+export function resetUsageLimitsForTests() {
+    config = { ...DEFAULT_LIMITS };
+    ledger = [];
+    loadedAt = 0;
+    fiveSeed = null;
+    told.clear();
+}
+/** For tests: put a history in place. */
+export function setLedgerForTests(recs, cfg) {
+    ledger = [...recs].sort((a, b) => a.at - b.at);
+    config = cfg;
+    loadedAt = Date.now();
+    fiveSeed = latestWindow(ledger, FIVE_HOURS_MS, "tokens")?.start ?? null;
+}
+//# sourceMappingURL=usageLimits.js.map

package/dist/dynamo/usageLimits.js.map

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

package/dist/governor/freshness.js

@@ -27,9 +27,9 @@
  */
 import { promises as fs } from "node:fs";
 import { join } from "node:path";
-import { projectDir } from "../memory/store.js";
+import { projectDir, stateRoot } from "../memory/store.js";
 /** The files and directories a project's governance is read from. */
-const FORBIDDEN_FILES = ["forbidden.md", "forbidden-commands.md", "forbidden-mcp-tools.md"];
+const FORBIDDEN_FILES = ["forbidden.md", "forbidden-commands.md", "forbidden-mcp-tools.md", "sentinel-allow.md", "context.json"];
 /** One directory's entries as `name:mtime:size`, sorted so the stamp is order-stable. */
 async function dirStamp(dir, depth) {
     let names;
@@ -65,19 +65,22 @@ async function dirStamp(dir, depth) {
  */
 export async function governanceStamp(cwd) {
     const stateDir = projectDir(cwd);
-    const [rules, skills, ...files] = await Promise.all([
+    const [rules, skills, globalRules, globalSkills, ...files] = await Promise.all([
         dirStamp(join(stateDir, "rules"), 0),
         dirStamp(join(stateDir, "skills"), 1),
-        ...FORBIDDEN_FILES.map(async (name) => {
+        dirStamp(join(stateRoot(), "rules"), 0),
+        dirStamp(join(stateRoot(), "skills"), 1),
+        // Both scopes: an edit to a universal list must reach sessions already running.
+        ...[stateDir, stateRoot()].flatMap((dir) => FORBIDDEN_FILES.map(async (name) => {
             try {
-                const st = await fs.stat(join(stateDir, name));
+                const st = await fs.stat(join(dir, name));
                 return `${name}:${st.mtimeMs}:${st.size}`;
             }
             catch {
                 return `${name}:-`;
             }
-        }),
+        })),
     ]);
-    return `r[${rules}] s[${skills}] f[${files.join("|")}]`;
+    return `r[${rules}] s[${skills}] gr[${globalRules}] gs[${globalSkills}] f[${files.join("|")}]`;
 }
 //# sourceMappingURL=freshness.js.map

package/dist/governor/freshness.js.map

@@ -1 +1 @@
-{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../src/governor/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,qEAAqE;AACrE,MAAM,eAAe,GAAG,CAAC,cAAc,EAAE,uBAAuB,EAAE,wBAAwB,CAAC,CAAC;AAE5F,yFAAyF;AACzF,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,KAAa;IAChD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,gEAAgE;IACrF,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,6EAA6E;YAC7E,kEAAkE;YAClE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;;gBACzF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACrC,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpC,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC/C,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,IAAI,IAAI,CAAC;YACrB,CAAC;QACH,CAAC,CAAC;KACH,CAAC,CAAC;IACH,OAAO,KAAK,KAAK,OAAO,MAAM,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../src/governor/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE3D,qEAAqE;AACrE,MAAM,eAAe,GAAG,CAAC,cAAc,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC;AAEjI,yFAAyF;AACzF,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,KAAa;IAChD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,gEAAgE;IACrF,CAAC;IACD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,6EAA6E;YAC7E,kEAAkE;YAClE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,MAAM,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;;gBACzF,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC7E,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxC,gFAAgF;QAChF,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CACzC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACjC,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;gBAC1C,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,GAAG,IAAI,IAAI,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CACH;KACF,CAAC,CAAC;IACH,OAAO,KAAK,KAAK,OAAO,MAAM,QAAQ,WAAW,QAAQ,YAAY,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACjG,CAAC"}

package/dist/governor/index.js

@@ -14,7 +14,7 @@
  * mechanical enforcement; the rules and skill catalog are rendered into the
  * system prompt by the engine.
  */
-import { projectDir } from "../memory/store.js";
+import { projectDir, stateRoot } from "../memory/store.js";
 import { promises as fs } from "node:fs";
 import { join } from "node:path";
 import { loadRules } from "./rules.js";
@@ -29,25 +29,92 @@ async function readStateFile(stateDir, name) {
         return "";
     }
 }
-/** Load all governance for the project rooted at `cwd`. Always succeeds (empties). */
+/**
+ * Where one scope's permission files live: the project's state dir, or the universal
+ * one (`~/.mindweave`) whose lists apply in every project.
+ */
+export function governanceDir(cwd, scope) {
+    return scope === "global" ? stateRoot() : projectDir(cwd);
+}
+/** The deny-lists and Sentinel allowances of ONE scope, unmerged, for a settings screen. */
+export async function loadPermissionLists(cwd, scope) {
+    const dir = governanceDir(cwd, scope);
+    const [paths, commands, mcpTools, sentinel] = await Promise.all([
+        readStateFile(dir, "forbidden.md"),
+        readStateFile(dir, "forbidden-commands.md"),
+        readStateFile(dir, "forbidden-mcp-tools.md"),
+        readStateFile(dir, "sentinel-allow.md"),
+    ]);
+    return {
+        paths: parseForbidden(paths),
+        commands: parseForbiddenCommands(commands),
+        mcpTools: parseForbiddenMcpTools(mcpTools),
+        sentinelAllow: parseForbiddenCommands(sentinel),
+    };
+}
+const unique = (list) => [...new Set(list)];
+const CONTEXT_FILE = "context.json";
+/** One scope's auto-compaction override, or null if unset/unreadable/invalid. */
+export async function loadContextOverride(cwd, scope) {
+    try {
+        const raw = JSON.parse(await fs.readFile(join(governanceDir(cwd, scope), CONTEXT_FILE), "utf8"));
+        const n = raw.autoCompactTokens;
+        return typeof n === "number" && Number.isFinite(n) && n > 0 ? Math.round(n) : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Set or clear one scope's auto-compaction override. `tokens: null` clears it. */
+export async function saveContextOverride(cwd, scope, tokens) {
+    const dir = governanceDir(cwd, scope);
+    const file = join(dir, CONTEXT_FILE);
+    if (tokens === null) {
+        await fs.rm(file, { force: true });
+        return;
+    }
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(file, JSON.stringify({ autoCompactTokens: Math.round(tokens) }, null, 2), "utf8");
+}
+/**
+ * Load all governance for the project rooted at `cwd`. Always succeeds (empties).
+ *
+ * The deny-lists and Sentinel allowances are the universal layer plus the project's,
+ * merged: something forbidden everywhere is forbidden here too, and a project can only
+ * add to it. Rules and skills stay per project.
+ */
 export async function loadGovernance(cwd) {
     const stateDir = projectDir(cwd);
-    const [rules, skills, forbiddenText, forbiddenCmdText, forbiddenMcpText] = await Promise.all([
+    const [projectRules, projectSkills, globalRules, globalSkills, global, project, globalContext, projectContext] = await Promise.all([
         loadRules(stateDir),
         loadSkillCatalog(stateDir),
-        readStateFile(stateDir, "forbidden.md"),
-        readStateFile(stateDir, "forbidden-commands.md"),
-        readStateFile(stateDir, "forbidden-mcp-tools.md"),
+        loadRules(stateRoot()),
+        loadSkillCatalog(stateRoot()),
+        loadPermissionLists(cwd, "global"),
+        loadPermissionLists(cwd, "project"),
+        loadContextOverride(cwd, "global"),
+        loadContextOverride(cwd, "project"),
     ]);
+    // Rules and skills for every project come first; a project's own of the same name
+    // replaces the universal one, so a project can override a general habit.
+    const byName = (general, own) => {
+        const ownNames = new Set(own.map((x) => x.name));
+        return [...general.filter((x) => !ownNames.has(x.name)), ...own];
+    };
+    const rules = byName(globalRules, projectRules);
+    const skills = byName(globalSkills, projectSkills);
+    const sentinelAllow = unique([...global.sentinelAllow, ...project.sentinelAllow]);
     return {
         rules,
         skills,
         forbidden: {
-            patterns: parseForbidden(forbiddenText),
-            commands: parseForbiddenCommands(forbiddenCmdText),
-            mcpTools: parseForbiddenMcpTools(forbiddenMcpText),
+            patterns: unique([...global.paths, ...project.paths]),
+            commands: unique([...global.commands, ...project.commands]),
+            mcpTools: unique([...global.mcpTools, ...project.mcpTools]),
             root: cwd,
         },
+        ...(sentinelAllow.length ? { sentinelAllow } : {}),
+        ...(projectContext !== null ? { contextAutoCompactTokens: projectContext } : globalContext !== null ? { contextAutoCompactTokens: globalContext } : {}),
     };
 }
 export { renderRules } from "./rules.js";