@spikedpunch/mast 0.2.0 → 0.4.0

package/dist/cli/setup-plan.js

@@ -0,0 +1,221 @@
+import { z } from 'zod';
+import { isMastCommand } from './setup-command.js';
+/** Seconds, in all three harnesses. Session start builds the primer; search must stay cheap. */
+const SESSION_START_TIMEOUT = 30;
+const SEARCH_TIMEOUT = 5;
+/**
+ * The hooks each harness gets. The Claude session-start group has no matcher on purpose:
+ * that matches every source, including `compact`. VS Code has no search hook because its
+ * docs say matchers are ignored (it would run on every tool call) and the search tool's
+ * name is undocumented.
+ */
+export const HOOK_DEFS = {
+    claude: [
+        { event: 'session-start', nativeEvent: 'SessionStart', timeout: SESSION_START_TIMEOUT },
+        { event: 'search', nativeEvent: 'PreToolUse', matcher: 'Grep|Glob', timeout: SEARCH_TIMEOUT },
+    ],
+    cursor: [
+        { event: 'session-start', nativeEvent: 'sessionStart', timeout: SESSION_START_TIMEOUT },
+        { event: 'search', nativeEvent: 'postToolUse', matcher: 'Grep', timeout: SEARCH_TIMEOUT },
+    ],
+    vscode: [{ event: 'session-start', nativeEvent: 'SessionStart', timeout: SESSION_START_TIMEOUT }],
+};
+// Zod is used to validate, not to rebuild: a parsed loose object puts its known keys
+// first, which would reorder a user's file. `passThrough` validates and hands back the
+// original value, so key order survives and only mast's entries are edited.
+const rootShape = z.looseObject({ hooks: z.looseObject({}).optional() });
+const handlerShape = z.looseObject({ command: z.string().optional() });
+const groupShape = z.looseObject({ matcher: z.string().optional(), hooks: z.array(handlerShape) });
+const flatEntryShape = z.looseObject({ command: z.string().optional() });
+function passThrough(schema) {
+    return z.custom((value) => schema.safeParse(value).success);
+}
+function readTyped(schema, value, where) {
+    const result = schema.safeParse(value);
+    if (!result.success) {
+        const found = result.error.issues
+            .slice(0, 3)
+            .map((issue) => `${[where, ...issue.path.map(String)].join('.')}: ${issue.message}`);
+        return { ok: false, problem: `unexpected structure (${found.join('; ')})` };
+    }
+    return { ok: true, data: structuredClone(passThrough(schema).parse(value)) };
+}
+function readRoot(existing) {
+    return existing === null ? { ok: true, data: {} } : readTyped(rootShape, existing, 'file');
+}
+const fail = (problem) => ({ ok: false, problem });
+function hooksOf(root) {
+    const hooks = root.hooks ?? {};
+    root.hooks = hooks;
+    return hooks;
+}
+/**
+ * Claude Code: `hooks.<Event>` is a list of groups, each `{matcher?, hooks: [handler]}`.
+ * Within a group only mast's handler is touched; a group mast empties is removed, a group
+ * with other handlers keeps them.
+ */
+export function planClaude(existing, mode) {
+    const rootRead = readRoot(existing);
+    if (!rootRead.ok)
+        return fail(rootRead.problem);
+    const root = rootRead.data;
+    const items = [];
+    let removedCount = 0;
+    let changed = false;
+    for (const def of HOOK_DEFS.claude) {
+        const rawGroups = root.hooks?.[def.nativeEvent];
+        const read = rawGroups === undefined ? null : readTyped(z.array(groupShape), rawGroups, `hooks.${def.nativeEvent}`);
+        if (read !== null && !read.ok)
+            return fail(read.problem);
+        let groups = read === null ? [] : read.data;
+        const isMast = (command) => isMastCommand(command, 'claude', def.event);
+        const touched = new Set();
+        if (mode.kind === 'remove') {
+            for (const group of groups) {
+                const kept = group.hooks.filter((h) => !isMast(h.command));
+                if (kept.length === group.hooks.length)
+                    continue;
+                removedCount += group.hooks.length - kept.length;
+                group.hooks = kept;
+                touched.add(group);
+            }
+            if (touched.size === 0)
+                continue;
+            groups = groups.filter((g) => !touched.has(g) || g.hooks.length > 0);
+            changed = true;
+            if (groups.length === 0)
+                delete hooksOf(root)[def.nativeEvent];
+            else
+                hooksOf(root)[def.nativeEvent] = groups;
+            continue;
+        }
+        const command = mode.commands[def.event];
+        if (command === undefined)
+            continue;
+        const handler = { type: 'command', command, timeout: def.timeout };
+        const found = groups.flatMap((group) => group.hooks.filter((h) => isMast(h.command)).map((h) => ({ group, h })));
+        const first = found[0];
+        const duplicates = found.slice(1);
+        const fresh = () => ({ ...(def.matcher === undefined ? {} : { matcher: def.matcher }), hooks: [{ ...handler }] });
+        let state = 'current';
+        if (first === undefined) {
+            groups.push(fresh());
+            state = 'missing';
+        }
+        else {
+            const sameHandler = first.h['type'] === handler.type && first.h.command === command && first.h['timeout'] === handler.timeout;
+            if (!sameHandler || first.group.matcher !== def.matcher) {
+                state = 'outdated';
+                const ownsGroup = first.group.hooks.every((h) => isMast(h.command));
+                if (ownsGroup || first.group.matcher === def.matcher) {
+                    Object.assign(first.h, handler);
+                    if (ownsGroup) {
+                        if (def.matcher === undefined)
+                            delete first.group.matcher;
+                        else
+                            first.group.matcher = def.matcher;
+                    }
+                }
+                else {
+                    // The group's matcher also scopes someone else's handler, so it cannot be edited.
+                    first.group.hooks = first.group.hooks.filter((h) => h !== first.h);
+                    touched.add(first.group);
+                    groups.push(fresh());
+                }
+            }
+        }
+        for (const dup of duplicates) {
+            dup.group.hooks = dup.group.hooks.filter((h) => h !== dup.h);
+            touched.add(dup.group);
+            state = 'outdated';
+        }
+        groups = groups.filter((g) => !touched.has(g) || g.hooks.length > 0);
+        items.push({ label: def.nativeEvent, state });
+        if (state !== 'current') {
+            changed = true;
+            hooksOf(root)[def.nativeEvent] = groups;
+        }
+    }
+    return { ok: true, next: root, changed, items, removedCount };
+}
+/** Cursor (`hooks.json`) and VS Code (`mast.json`): `hooks.<event>` is a flat list of entries. */
+function planFlat(harness, existing, mode) {
+    const rootRead = readRoot(existing);
+    if (!rootRead.ok)
+        return fail(rootRead.problem);
+    const root = rootRead.data;
+    const items = [];
+    let removedCount = 0;
+    let changed = false;
+    if (mode.kind === 'install' && harness === 'cursor' && !('version' in root)) {
+        root['version'] = 1;
+        items.push({ label: 'version', state: 'missing' });
+        changed = true;
+    }
+    for (const def of HOOK_DEFS[harness]) {
+        const rawEntries = root.hooks?.[def.nativeEvent];
+        const read = rawEntries === undefined ? null : readTyped(z.array(flatEntryShape), rawEntries, `hooks.${def.nativeEvent}`);
+        if (read !== null && !read.ok)
+            return fail(read.problem);
+        const entries = read === null ? [] : read.data;
+        const isMast = (e) => isMastCommand(e.command, harness, def.event);
+        if (mode.kind === 'remove') {
+            const kept = entries.filter((e) => !isMast(e));
+            if (kept.length === entries.length)
+                continue;
+            removedCount += entries.length - kept.length;
+            changed = true;
+            if (kept.length === 0)
+                delete hooksOf(root)[def.nativeEvent];
+            else
+                hooksOf(root)[def.nativeEvent] = kept;
+            continue;
+        }
+        const command = mode.commands[def.event];
+        if (command === undefined)
+            continue;
+        const wanted = harness === 'cursor'
+            ? { command, type: 'command', ...(def.matcher === undefined ? {} : { matcher: def.matcher }), timeout: def.timeout }
+            : { type: 'command', command, timeout: def.timeout };
+        const found = entries.filter(isMast);
+        const first = found[0];
+        let state = 'current';
+        let next = entries;
+        if (first === undefined) {
+            next = [...entries, wanted];
+            state = 'missing';
+        }
+        else {
+            const same = Object.entries(wanted).every(([key, value]) => first[key] === value) && 'matcher' in first === 'matcher' in wanted;
+            if (!same) {
+                Object.assign(first, wanted);
+                if (!('matcher' in wanted))
+                    delete first['matcher'];
+                state = 'outdated';
+            }
+            if (found.length > 1) {
+                next = entries.filter((e) => e === first || !isMast(e));
+                state = 'outdated';
+            }
+        }
+        items.push({ label: def.nativeEvent, state });
+        if (state !== 'current') {
+            changed = true;
+            hooksOf(root)[def.nativeEvent] = next;
+        }
+    }
+    // mast.json belongs to mast outright: once its last entry goes, so does the file.
+    const hooksLeft = root.hooks === undefined ? 0 : Object.keys(root.hooks).length;
+    if (harness === 'vscode' && removedCount > 0 && Object.keys(root).length === 1 && hooksLeft === 0) {
+        return { ok: true, next: null, changed, items, removedCount };
+    }
+    return { ok: true, next: root, changed, items, removedCount };
+}
+export const planCursor = (existing, mode) => planFlat('cursor', existing, mode);
+export const planVscode = (existing, mode) => planFlat('vscode', existing, mode);
+export function planFor(harness, existing, mode) {
+    if (harness === 'claude')
+        return planClaude(existing, mode);
+    return harness === 'cursor' ? planCursor(existing, mode) : planVscode(existing, mode);
+}
+//# sourceMappingURL=setup-plan.js.map

package/dist/cli/setup-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-plan.js","sourceRoot":"","sources":["../../src/cli/setup-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,gGAAgG;AAChG,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,cAAc,GAAG,CAAC,CAAC;AAUzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAkD;IACtE,MAAM,EAAE;QACN,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE;QACvF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE;KAC9F;IACD,MAAM,EAAE;QACN,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE;QACvF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE;KAC1F;IACD,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClG,CAAC;AA2BF,qFAAqF;AACrF,uFAAuF;AACvF,4EAA4E;AAC5E,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACzE,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACvE,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AACnG,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAMzE,SAAS,WAAW,CAAsB,MAAS;IACjD,OAAO,CAAC,CAAC,MAAM,CAAa,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAC1E,CAAC;AAID,SAAS,SAAS,CAAsB,MAAS,EAAE,KAAc,EAAE,KAAa;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC9B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,SAAS,QAAQ,CAAC,QAAiB;IACjC,OAAO,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,OAAe,EAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAEvE,SAAS,OAAO,CAAC,IAAU;IACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAAiB,EAAE,IAAc;IAC1D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,SAAS,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACpH,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,IAAI,MAAM,GAAY,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACrD,MAAM,MAAM,GAAG,CAAC,OAA2B,EAAW,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACrG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAS,CAAC;QAEjC,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM;oBAAE,SAAS;gBACjD,YAAY,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;gBACjD,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YACD,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;gBAAE,SAAS;YACjC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrE,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;;gBAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;YAC7C,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACjH,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,GAAU,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QAEzH,IAAI,KAAK,GAAc,SAAS,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACrB,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GACf,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC;YAC5G,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;gBACxD,KAAK,GAAG,UAAU,CAAC;gBACnB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;gBACpE,IAAI,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;oBACrD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBAChC,IAAI,SAAS,EAAE,CAAC;wBACd,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;4BAAE,OAAO,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;;4BACrD,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;oBACzC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,kFAAkF;oBAClF,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC;oBACnE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBACzB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvB,KAAK,GAAG,UAAU,CAAC;QACrB,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAChE,CAAC;AAED,kGAAkG;AAClG,SAAS,QAAQ,CAAC,OAA4B,EAAE,QAAiB,EAAE,IAAc;IAC/E,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACnD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,EAAE,UAAU,EAAE,SAAS,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1H,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,OAAO,GAAgB,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5D,MAAM,MAAM,GAAG,CAAC,CAAY,EAAW,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QAEvF,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;gBAAE,SAAS;YAC7C,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC7C,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;;gBACxD,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;YAC3C,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,MAAM,GACV,OAAO,KAAK,QAAQ;YAClB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;YACpH,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,IAAI,KAAK,GAAc,SAAS,CAAC;QACjC,IAAI,IAAI,GAAG,OAAO,CAAC;QACnB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,GAAG,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GACR,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC;YACrH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;gBAC7B,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC;oBAAE,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC;gBACpD,KAAK,GAAG,UAAU,CAAC;YACrB,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxD,KAAK,GAAG,UAAU,CAAC;YACrB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QACxC,CAAC;IACH,CAAC;IAED,kFAAkF;IAClF,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC;IAChF,IAAI,OAAO,KAAK,QAAQ,IAAI,YAAY,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QAClG,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAChE,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAChE,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAiB,EAAE,IAAc,EAAc,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAChH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAiB,EAAE,IAAc,EAAc,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AAEhH,MAAM,UAAU,OAAO,CAAC,OAAgB,EAAE,QAAiB,EAAE,IAAc;IACzE,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC5D,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxF,CAAC"}

package/dist/cli/setup-rules.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The static channel of `mast setup` (ADR 017 sections 2 and 6): rules files that carry the
+ * short skill text. Everything here is pure; reading and writing happen in `setup-cmd.ts`.
+ */
+export type TextState = 'missing' | 'outdated' | 'current';
+export interface TextPlan {
+    /** Install-mode state of the file or block as found. Meaningless in remove mode. */
+    readonly state: TextState;
+    /** False means nothing may be written. */
+    readonly changed: boolean;
+    /** The next file content, or null when the file should be deleted. */
+    readonly next: string | null;
+}
+export type OwnedRulesHarness = 'cursor' | 'windsurf';
+/**
+ * Cursor: project rules are `.mdc` files in `.cursor/rules`, and `alwaysApply: true`
+ * applies the rule to every chat (Cursor's rules docs). Windsurf: `trigger: always_on`
+ * (Windsurf's rules docs). Both are read from the vendors' docs, not exercised in the tool.
+ */
+export declare function renderOwnedRules(harness: OwnedRulesHarness, skillText: string): string;
+/**
+ * A file mast owns outright. There is no marker to tell mast's file from someone else's
+ * with the same name: `.mdc` frontmatter has no room for a comment line, so the whole file
+ * is treated as mast's because of its name (`mast.mdc`, `mast.md`). Someone who hand-writes
+ * a file at that exact path gets it overwritten; the name is the claim.
+ */
+export declare function planOwnedFile(existing: string | null, wanted: string, remove: boolean): TextPlan;
+/** The marked block inside a file mast does not own (Zed's rules file). */
+export declare function planMarkedBlock(existing: string, skillText: string, remove: boolean): TextPlan;
+/**
+ * Files Zed reads project rules from, first existing one wins. This list is from memory of
+ * Zed's docs (zed.dev/docs/ai/instructions) and has NOT been verified against them:
+ * re-check the names and their order before relying on it.
+ */
+export declare const ZED_RULES_FILES: readonly string[];
+export declare function firstExisting(files: readonly string[], exists: (file: string) => boolean): string | null;
+export declare const cursorRulesPath: (root: string) => string;
+export declare const windsurfRulesPaths: (root: string) => readonly string[];
+/** `.devin/rules` when a `.devin` directory exists (Windsurf's docs now redirect to Devin), else `.windsurf/rules`. */
+export declare function chooseWindsurfRulesPath(root: string, devinDirExists: boolean): string;
+//# sourceMappingURL=setup-rules.d.ts.map

package/dist/cli/setup-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-rules.d.ts","sourceRoot":"","sources":["../../src/cli/setup-rules.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D,MAAM,WAAW,QAAQ;IACvB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAKtD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,CAKhG;AAgBD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,QAAQ,CAM9F;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAG5C,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GAAG,MAAM,GAAG,IAAI,CAExG;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAAoD,CAAC;AAEpG,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,SAAS,MAAM,EAGhE,CAAC;AAEF,uHAAuH;AACvH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CAGrF"}

package/dist/cli/setup-rules.js

@@ -0,0 +1,76 @@
+import { join } from 'node:path';
+import { BEGIN_MARKER, END_MARKER, spliceSkillBlock } from './skill-install.js';
+const CURSOR_DESCRIPTION = 'Use mast (AST code search) before grep or reading files';
+const OWNED_NOTICE = '<!-- Managed by `mast setup`; edits here are overwritten. Remove with `mast setup <harness> --remove`. -->';
+/**
+ * Cursor: project rules are `.mdc` files in `.cursor/rules`, and `alwaysApply: true`
+ * applies the rule to every chat (Cursor's rules docs). Windsurf: `trigger: always_on`
+ * (Windsurf's rules docs). Both are read from the vendors' docs, not exercised in the tool.
+ */
+export function renderOwnedRules(harness, skillText) {
+    const frontmatter = harness === 'cursor'
+        ? `---\ndescription: ${CURSOR_DESCRIPTION}\nalwaysApply: true\n---\n`
+        : '---\ntrigger: always_on\n---\n';
+    return `${frontmatter}\n${OWNED_NOTICE}\n\n${skillText.trimEnd()}\n`;
+}
+/**
+ * A file mast owns outright. There is no marker to tell mast's file from someone else's
+ * with the same name: `.mdc` frontmatter has no room for a comment line, so the whole file
+ * is treated as mast's because of its name (`mast.mdc`, `mast.md`). Someone who hand-writes
+ * a file at that exact path gets it overwritten; the name is the claim.
+ */
+export function planOwnedFile(existing, wanted, remove) {
+    if (remove)
+        return { state: 'current', changed: existing !== null, next: null };
+    if (existing === null)
+        return { state: 'missing', changed: true, next: wanted };
+    if (existing === wanted)
+        return { state: 'current', changed: false, next: wanted };
+    return { state: 'outdated', changed: true, next: wanted };
+}
+const hasBlock = (text) => {
+    const begin = text.indexOf(BEGIN_MARKER);
+    return begin !== -1 && text.indexOf(END_MARKER) > begin;
+};
+function withoutBlock(text) {
+    const begin = text.indexOf(BEGIN_MARKER);
+    const before = text.slice(0, begin).trimEnd();
+    // Only blank lines are dropped after the block: leading spaces on the next line are content.
+    const after = text.slice(text.indexOf(END_MARKER) + END_MARKER.length).replace(/^(?:[ \t]*\r?\n)+/, '');
+    if (before === '')
+        return after;
+    return after === '' ? `${before}\n` : `${before}\n\n${after}`;
+}
+/** The marked block inside a file mast does not own (Zed's rules file). */
+export function planMarkedBlock(existing, skillText, remove) {
+    const present = hasBlock(existing);
+    if (remove)
+        return { state: 'current', changed: present, next: present ? withoutBlock(existing) : existing };
+    const next = spliceSkillBlock(existing, skillText);
+    if (!present)
+        return { state: 'missing', changed: true, next };
+    return next === existing ? { state: 'current', changed: false, next } : { state: 'outdated', changed: true, next };
+}
+/**
+ * Files Zed reads project rules from, first existing one wins. This list is from memory of
+ * Zed's docs (zed.dev/docs/ai/instructions) and has NOT been verified against them:
+ * re-check the names and their order before relying on it.
+ */
+export const ZED_RULES_FILES = [
+    '.rules', '.cursorrules', '.windsurfrules', '.clinerules', '.github/copilot-instructions.md',
+    'AGENT.md', 'AGENTS.md', 'CLAUDE.md', 'GEMINI.md',
+];
+export function firstExisting(files, exists) {
+    return files.find(exists) ?? null;
+}
+export const cursorRulesPath = (root) => join(root, '.cursor', 'rules', 'mast.mdc');
+export const windsurfRulesPaths = (root) => [
+    join(root, '.devin', 'rules', 'mast.md'),
+    join(root, '.windsurf', 'rules', 'mast.md'),
+];
+/** `.devin/rules` when a `.devin` directory exists (Windsurf's docs now redirect to Devin), else `.windsurf/rules`. */
+export function chooseWindsurfRulesPath(root, devinDirExists) {
+    const [devin, windsurf] = windsurfRulesPaths(root);
+    return (devinDirExists ? devin : windsurf) ?? join(root, '.windsurf', 'rules', 'mast.md');
+}
+//# sourceMappingURL=setup-rules.js.map

package/dist/cli/setup-rules.js.map

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

package/dist/cli/setup-static.d.ts

@@ -0,0 +1,13 @@
+import type { SetupEnv, SetupIo, SetupOptions } from './setup-cmd.js';
+/**
+ * The static channel of `mast setup` (ADR 017 sections 2 and 6): rules files, for harnesses
+ * with no usable hook system and, for Cursor, alongside its hooks. The planners are pure
+ * (`setup-rules.ts`); this file is the shell around them, with every read and write injected.
+ */
+export type StaticHarness = 'windsurf' | 'zed' | 'desktop';
+export declare const STATIC_HARNESSES: readonly StaticHarness[];
+/** Cursor's `.cursor/rules/mast.mdc`, project scope only. */
+export declare function runCursorRules(opts: SetupOptions, env: SetupEnv, io: SetupIo): number;
+/** Returns the process exit code: 0 done, 1 refused or failed. */
+export declare function runStaticSetup(harness: StaticHarness, opts: SetupOptions, env: SetupEnv, io: SetupIo): number;
+//# sourceMappingURL=setup-static.d.ts.map

package/dist/cli/setup-static.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-static.d.ts","sourceRoot":"","sources":["../../src/cli/setup-static.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAMtE;;;;GAIG;AAEH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAC3D,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAAmC,CAAC;AAiDzF,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAOrF;AA4CD,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAY7G"}

package/dist/cli/setup-static.js

@@ -0,0 +1,116 @@
+import { join } from 'node:path';
+import { chooseWindsurfRulesPath, cursorRulesPath, firstExisting, planMarkedBlock, planOwnedFile, renderOwnedRules, windsurfRulesPaths, ZED_RULES_FILES, } from './setup-rules.js';
+export const STATIC_HARNESSES = ['windsurf', 'zed', 'desktop'];
+const HARNESS_NAMES = {
+    windsurf: 'Windsurf',
+    zed: 'Zed',
+    desktop: 'Claude Desktop',
+};
+/** One output line for the file, in stage 4's vocabulary, and the write that goes with it. */
+function applyTextTarget(io, path, plan, flags, showContent) {
+    if (flags.check) {
+        if (plan.state === 'current' && !plan.changed) {
+            io.out(`${path}: already up to date`);
+            return 0;
+        }
+        io.out(`${path}: ${plan.state === 'missing' ? 'not installed' : 'out of date'}`);
+        return 1;
+    }
+    const status = flags.remove
+        ? plan.changed ? 'removed' : 'not installed'
+        : !plan.changed ? 'already up to date' : plan.state === 'missing' ? 'installed' : 'updated';
+    if (flags.dryRun) {
+        io.out(`${path}: ${status} (dry run, nothing written)`);
+        if (plan.changed && showContent)
+            io.out(plan.next === null ? '(the file would be deleted)' : plan.next.trimEnd());
+        return 0;
+    }
+    if (plan.changed) {
+        if (plan.next === null)
+            io.removeFile(path);
+        else
+            io.writeFileAtomic(path, plan.next);
+    }
+    io.out(`${path}: ${status}`);
+    return 0;
+}
+function runOwnedFile(io, path, wanted, flags) {
+    return applyTextTarget(io, path, planOwnedFile(io.readFile(path), wanted, flags.remove), flags, true);
+}
+function guarded(io, where, work) {
+    try {
+        return work();
+    }
+    catch (error) {
+        io.err(`mast setup: ${where}: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+/** Cursor's `.cursor/rules/mast.mdc`, project scope only. */
+export function runCursorRules(opts, env, io) {
+    if (opts.global) {
+        if (!opts.remove)
+            io.out('Note: Cursor has no user-level rules file, so --global handled the hooks only.');
+        return 0;
+    }
+    const path = cursorRulesPath(opts.projectRoot);
+    return guarded(io, path, () => runOwnedFile(io, path, renderOwnedRules('cursor', env.skillText), opts));
+}
+function runWindsurf(opts, env, io) {
+    const chosen = chooseWindsurfRulesPath(opts.projectRoot, io.directoryExists(join(opts.projectRoot, '.devin')));
+    if (!opts.remove)
+        return runOwnedFile(io, chosen, renderOwnedRules('windsurf', env.skillText), opts);
+    // Removal sweeps both locations: the `.devin` directory may have appeared after install.
+    const present = windsurfRulesPaths(opts.projectRoot).filter((p) => io.readFile(p) !== null);
+    if (present.length === 0)
+        return runOwnedFile(io, chosen, '', opts);
+    return Math.max(...present.map((p) => runOwnedFile(io, p, '', opts)));
+}
+function runZed(opts, env, io) {
+    const exists = (rel) => io.fileExists(join(opts.projectRoot, rel));
+    if (opts.remove) {
+        // Every candidate is swept, not just the first: the block may sit in a file that is no
+        // longer the first one Zed reads, because someone created `.rules` after install.
+        let touched = 0;
+        let code = 0;
+        for (const rel of ZED_RULES_FILES.filter(exists)) {
+            const path = join(opts.projectRoot, rel);
+            const plan = planMarkedBlock(io.readFile(path) ?? '', env.skillText, true);
+            if (!plan.changed)
+                continue;
+            touched += 1;
+            code = Math.max(code, applyTextTarget(io, path, plan, opts, false));
+        }
+        if (touched === 0)
+            io.out(`${opts.projectRoot}: not installed (no mast block in any Zed rules file)`);
+        return code;
+    }
+    const rel = firstExisting(ZED_RULES_FILES, exists);
+    if (rel === null) {
+        if (opts.check) {
+            io.out(`${opts.projectRoot}: not installed (no Zed rules file found)`);
+        }
+        else {
+            io.err(`mast setup: no Zed rules file found in ${opts.projectRoot}. mast does not create one, because a rules file is a prompt you curate. ` +
+                'Create .rules and run `mast setup zed` again.');
+        }
+        return 1;
+    }
+    const path = join(opts.projectRoot, rel);
+    return applyTextTarget(io, path, planMarkedBlock(io.readFile(path) ?? '', env.skillText, false), opts, false);
+}
+/** Returns the process exit code: 0 done, 1 refused or failed. */
+export function runStaticSetup(harness, opts, env, io) {
+    if (harness === 'desktop') {
+        io.out(`${HARNESS_NAMES[harness]} has no hook system mast can use, so only static instructions apply.`);
+        io.out('Its only channel is the instructions string `mast serve` sends in the MCP handshake. That needs no setup, and nothing was written.');
+        return 0;
+    }
+    io.out(`${HARNESS_NAMES[harness]} has no hook system mast can use, so only static instructions are installed.`);
+    if (opts.global) {
+        io.err(`mast setup: no user-level rules file is supported for ${harness}. Run without --global, from the project root.`);
+        return 1;
+    }
+    return guarded(io, opts.projectRoot, () => (harness === 'windsurf' ? runWindsurf(opts, env, io) : runZed(opts, env, io)));
+}
+//# sourceMappingURL=setup-static.js.map

package/dist/cli/setup-static.js.map

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

package/dist/cli/skill-install.d.ts

@@ -22,6 +22,8 @@ export interface SkillTarget {
     /** The agent this file configures, for the confirmation line. */
     readonly agent: string;
 }
+/** The files `--install` is willing to write into, relative to the project root. */
+export declare const SKILL_TARGET_FILES: readonly string[];
 /** Agent config files that exist in this project. Never invents one. */
 export declare function detectSkillTargets(projectRoot: string): readonly SkillTarget[];
 /**

package/dist/cli/skill-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-install.d.ts","sourceRoot":"","sources":["../../src/cli/skill-install.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,YAAY,mGAA8F,CAAC;AACxH,eAAO,MAAM,UAAU,4BAA4B,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAUD,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAI9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,SAAS,cAAc,EAAE,CAQ3B"}
+{"version":3,"file":"skill-install.d.ts","sourceRoot":"","sources":["../../src/cli/skill-install.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,YAAY,mGAA8F,CAAC;AACxH,eAAO,MAAM,UAAU,4BAA4B,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAUD,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAkC,CAAC;AAEnF,wEAAwE;AACxE,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAI9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAW5E;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,SAAS,cAAc,EAAE,CAQ3B"}

package/dist/cli/skill-install.js

@@ -23,6 +23,8 @@ const CANDIDATES = [
     { file: '.windsurfrules', agent: 'Windsurf' },
     { file: '.github/copilot-instructions.md', agent: 'GitHub Copilot' },
 ];
+/** The files `--install` is willing to write into, relative to the project root. */
+export const SKILL_TARGET_FILES = CANDIDATES.map((c) => c.file);
 /** Agent config files that exist in this project. Never invents one. */
 export function detectSkillTargets(projectRoot) {
     return CANDIDATES

package/dist/cli/skill-install.js.map

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

package/dist/cli/status.d.ts

@@ -1,6 +1,16 @@
 import type { Command } from 'commander';
+import type { StaleBreakdown } from '../ast/types.js';
 export interface StatusReport {
     readonly state_dir: string;
+    /**
+     * The tree this report was measured against.
+     *
+     * Reported because `state_dir` alone does not identify it, and the two are
+     * independently settable: a relative `--state-dir` resolves against the path
+     * argument, so it is entirely possible to read one project's index while
+     * asking about another project's files (D048).
+     */
+    readonly project_root: string;
     /** False when nothing has ever been indexed at `state_dir`. */
     readonly initialised: boolean;
     readonly schema_version: string;
@@ -9,6 +19,11 @@ export interface StatusReport {
     readonly chunk_count: number | null;
     /** `null` when there is no index — a stale count against nothing is meaningless. */
     readonly stale_files: number | null;
+    /**
+     * `stale_files` split into the three categories it sums. `null` on the same
+     * condition, and for the same reason.
+     */
+    readonly stale_breakdown: StaleBreakdown | null;
     readonly parse_errors: number | null;
     readonly write_errors: number | null;
     readonly index_fresh: boolean;

package/dist/cli/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,OAAO,CAAC,YAAY,CAAC,CA+CvB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkD5D"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,eAAe,EAAE,cAAc,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,OAAO,CAAC,YAAY,CAAC,CAuDvB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqE5D"}