@spikedpunch/mast 0.3.0 → 0.4.0

package/dist/cli/hook.js

@@ -0,0 +1,200 @@
+// Entry module for `mast hook`. Run by the harness before every Grep, so everything
+// reachable through its STATIC imports must be Node built-ins or repo modules that are
+// themselves built-in-only (asserted by hook-import-graph.test.ts, ADR 017 section 5).
+// The session-start branch loads the heavy modules with a dynamic import() instead.
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { resolveHookConfigLight } from './hook-state-dir.js';
+export const SEARCH_REMINDER = 'mast: for TypeScript, JavaScript and Markdown code, try mast_search first (use code tokens such as function and type names); ' +
+    'grep is still right for other languages and for exact-text regex.';
+// Ripgrep type names (what Claude Code's Grep `type` takes) mapped to the extensions
+// they cover. Hand-kept and deliberately small: only the types whose name differs from
+// their extensions. Any other type name is read as its own extension (`py` as `.py`,
+// `vue` as `.vue`), so a project that indexes extra extensions is still matched.
+const RG_TYPE_EXTENSIONS = {
+    ts: ['.ts', '.tsx', '.cts', '.mts'],
+    js: ['.js', '.jsx', '.cjs', '.mjs'],
+    md: ['.md', '.markdown'],
+    markdown: ['.md', '.markdown'],
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isHarness(value) {
+    return value === 'claude' || value === 'cursor' || value === 'vscode';
+}
+function isHookEvent(value) {
+    return value === 'session-start' || value === 'search';
+}
+function anyIn(indexed, extensions) {
+    return extensions.some((e) => indexed.includes(e.toLowerCase()));
+}
+/** A trailing `.ext` of a path segment. All-digit suffixes (`v1.2`) are versions, not extensions. */
+function trailingExtension(segment) {
+    const m = /\.([A-Za-z0-9_]*[A-Za-z_][A-Za-z0-9_]*)$/.exec(segment);
+    return m?.[1] === undefined ? null : `.${m[1]}`;
+}
+/** Extensions a glob can match, or null when they cannot be determined (`src/**`, `*.[jt]s`). */
+function globExtensions(glob) {
+    const segment = glob.slice(glob.lastIndexOf('/') + 1);
+    const braces = /\.\{([^{}]*)\}$/.exec(segment);
+    if (braces?.[1] !== undefined) {
+        const items = braces[1].split(',').map((s) => s.trim());
+        return items.every((s) => /^[A-Za-z0-9_]+$/.test(s)) ? items.map((s) => `.${s}`) : null;
+    }
+    const single = trailingExtension(segment);
+    return single === null ? null : [single];
+}
+function stringField(input, key) {
+    const value = input[key];
+    return typeof value === 'string' ? value : null;
+}
+/**
+ * True when the search's own scoping fields restrict it to files mast does not index.
+ * Unrecognised fields and shapes count as "not scoped": a missed reminder is cheaper
+ * than a wrong one only when we know the language, and here we do not.
+ */
+function isScopedAwayFromIndex(input, facts) {
+    if (!isRecord(input) || !isRecord(input['tool_input']))
+        return false;
+    const toolInput = input['tool_input'];
+    const indexed = facts.indexedExtensions;
+    const type = stringField(toolInput, 'type');
+    if (type !== null && !anyIn(indexed, RG_TYPE_EXTENSIONS[type] ?? [`.${type}`]))
+        return true;
+    // For the Glob tool the `pattern` IS the glob; for Grep it is a regex and says nothing.
+    const glob = input['tool_name'] === 'Glob' ? stringField(toolInput, 'pattern') : stringField(toolInput, 'glob');
+    const globExts = glob === null ? null : globExtensions(glob);
+    if (globExts !== null && !anyIn(indexed, globExts))
+        return true;
+    const path = facts.searchPathIsDirectory ? null : stringField(toolInput, 'path');
+    const pathExt = path === null ? null : trailingExtension(path.slice(path.lastIndexOf('/') + 1));
+    if (pathExt !== null && !anyIn(indexed, [pathExt]))
+        return true;
+    return false;
+}
+function envelope(harness, event, text) {
+    if (harness === 'cursor')
+        return { additional_context: text };
+    return {
+        hookSpecificOutput: {
+            hookEventName: event === 'session-start' ? 'SessionStart' : 'PreToolUse',
+            additionalContext: text,
+        },
+    };
+}
+/**
+ * The whole decision, pure. Returns the harness's envelope, or null for "print nothing".
+ * Unknown harness or event is null rather than a throw: see `runHook` for why.
+ */
+export function decide(harness, event, input, facts) {
+    if (!isHarness(harness) || !isHookEvent(event))
+        return null;
+    if (event === 'session-start')
+        return envelope(harness, event, facts.primeText);
+    if (!facts.indexExists || isScopedAwayFromIndex(input, facts))
+        return null;
+    return envelope(harness, event, SEARCH_REMINDER);
+}
+/** `cwd`, else the first workspace root, else null (caller falls back to process cwd). */
+function projectRootOf(input) {
+    if (typeof input['cwd'] === 'string' && input['cwd'] !== '')
+        return input['cwd'];
+    const roots = input['workspace_roots'];
+    if (Array.isArray(roots) && typeof roots[0] === 'string' && roots[0] !== '')
+        return roots[0];
+    return null;
+}
+function searchPathOf(input) {
+    const toolInput = input['tool_input'];
+    return isRecord(toolInput) ? stringField(toolInput, 'path') : null;
+}
+/**
+ * I/O shell around `decide`.
+ *
+ * Never throws and never sets a failing exit code. A hook that fails breaks the user's
+ * session, and anything on stdout that is not the envelope is a malformed hook response,
+ * so every problem here ends as empty stdout plus one stderr line. Ordinary quiet cases
+ * (no index, a search scoped to another language) say nothing at all.
+ */
+export async function runHook(harness, event, io) {
+    if (!isHarness(harness) || !isHookEvent(event)) {
+        io.warn(`mast hook: unknown harness "${harness}" or event "${event}"; expected claude|cursor|vscode and session-start|search`);
+        return;
+    }
+    try {
+        const raw = await io.readStdin();
+        if (raw.trim() === '') {
+            io.warn('mast hook: empty stdin, expected the harness hook JSON');
+            return;
+        }
+        let input;
+        try {
+            input = JSON.parse(raw);
+        }
+        catch {
+            io.warn('mast hook: stdin is not valid JSON');
+            return;
+        }
+        if (!isRecord(input)) {
+            io.warn('mast hook: stdin JSON is not an object');
+            return;
+        }
+        const projectRoot = projectRootOf(input) ?? io.cwd();
+        const out = decide(harness, event, input, await gatherFacts(event, input, projectRoot, io));
+        if (out !== null)
+            io.write(JSON.stringify(out));
+    }
+    catch (error) {
+        io.warn(`mast hook ${harness} ${event}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function gatherFacts(event, input, projectRoot, io) {
+    if (event === 'session-start') {
+        return {
+            indexExists: false,
+            primeText: await io.prime(projectRoot),
+            searchPathIsDirectory: false,
+            indexedExtensions: [],
+        };
+    }
+    const config = resolveHookConfigLight(projectRoot, io.env);
+    const searchPath = searchPathOf(input);
+    return {
+        indexExists: io.fileExists(join(config.stateDir, 'index.json')),
+        primeText: '',
+        searchPathIsDirectory: searchPath !== null && io.isDirectory(resolve(projectRoot, searchPath)),
+        indexedExtensions: config.fileExtensions.map((e) => e.toLowerCase()),
+    };
+}
+async function readProcessStdin() {
+    // A TTY means someone ran the command by hand; waiting for EOF would just hang.
+    if (process.stdin.isTTY)
+        return '';
+    // Streamed rather than readFileSync(0): that throws EAGAIN on some non-blocking pipes.
+    process.stdin.setEncoding('utf8');
+    let text = '';
+    for await (const chunk of process.stdin)
+        text += String(chunk);
+    return text;
+}
+/** Production wiring, called from `cli/index.ts` and from the commander registration. */
+export async function runHookFromProcess(harness, event) {
+    await runHook(harness, event, {
+        readStdin: readProcessStdin,
+        write: (text) => { process.stdout.write(text); },
+        warn: (line) => { process.stderr.write(`${line}\n`); },
+        env: process.env,
+        cwd: () => process.cwd(),
+        fileExists: existsSync,
+        isDirectory: (path) => statSync(path, { throwIfNoEntry: false })?.isDirectory() ?? false,
+        prime: async (projectRoot) => {
+            // Dynamic so the search path never pays for them (ADR 017 section 5).
+            const { buildStatus } = await import('./status.js');
+            const { renderPrime, PRIME_ASSET_PATH } = await import('./prime-cmd.js');
+            const status = await buildStatus({ path: projectRoot });
+            return renderPrime(status, readFileSync(PRIME_ASSET_PATH, 'utf8'), new Date());
+        },
+    });
+}
+//# sourceMappingURL=hook.js.map

package/dist/cli/hook.js.map

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

package/dist/cli/index.js

@@ -1,4 +1,14 @@
 #!/usr/bin/env node
-import { buildProgram } from './program.js';
-await buildProgram().parseAsync(process.argv);
+// `hook` is dispatched before the program is imported: a hook runs ahead of every Grep,
+// and importing the program (commander, zod, typescript, kysely, the MCP SDK) costs about
+// a second. See ADR 017 section 5 and hook-import-graph.test.ts.
+if (process.argv[2] === 'hook') {
+    const { runHookFromProcess } = await import('./hook.js');
+    await runHookFromProcess(process.argv[3] ?? '', process.argv[4] ?? '');
+}
+else {
+    const { buildProgram } = await import('./program.js');
+    await buildProgram().parseAsync(process.argv);
+}
+export {};
 //# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,YAAY,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,wFAAwF;AACxF,0FAA0F;AAC1F,iEAAiE;AACjE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IAC/B,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC;KAAM,CAAC;IACN,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;IACtD,MAAM,YAAY,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/cli/installed-artifacts.d.ts

@@ -0,0 +1,23 @@
+import type { Harness } from './hook.js';
+/**
+ * What of mast's own writing `mast upgrade` found installed, so it can say what to re-check
+ * after upgrading. `mast upgrade` runs on the OLD binary and cannot know what a newer
+ * version's files should contain; it can only know that they exist.
+ */
+export interface InstalledArtifacts {
+    /** Harnesses whose project-level hook file holds a mast hook command. */
+    readonly projectHooks: readonly Harness[];
+    /** Harnesses whose user-level hook file holds a mast hook command. */
+    readonly globalHooks: readonly Harness[];
+    /** Harnesses with a mast-owned rules file in the project. */
+    readonly rulesHarnesses: readonly ('cursor' | 'windsurf')[];
+    /** Zed rules files, outside the `mast skill --install` set, that carry the marked block. */
+    readonly zedOnlyBlockFiles: readonly string[];
+    /** Files `mast skill --install` reaches that carry the marked block. */
+    readonly skillBlockFiles: readonly string[];
+}
+export declare const NO_INSTALLED_ARTIFACTS: InstalledArtifacts;
+/** Null for a file that is absent or unreadable: an advisory scan cannot fail `mast upgrade`. */
+export declare function readFileOrNull(path: string): string | null;
+export declare function findInstalledArtifacts(projectRoot: string, home: string, readFile: (path: string) => string | null): InstalledArtifacts;
+//# sourceMappingURL=installed-artifacts.d.ts.map

package/dist/cli/installed-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-artifacts.d.ts","sourceRoot":"","sources":["../../src/cli/installed-artifacts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,OAAO,EAAE,CAAC;IAC1C,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,SAAS,OAAO,EAAE,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC;IAC5D,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,eAAO,MAAM,sBAAsB,EAAE,kBAEpC,CAAC;AAIF,iGAAiG;AACjG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM1D;AAOD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACxC,kBAAkB,CAiBpB"}

package/dist/cli/installed-artifacts.js

@@ -0,0 +1,39 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { hookFilePath } from './setup-command.js';
+import { cursorRulesPath, windsurfRulesPaths, ZED_RULES_FILES } from './setup-rules.js';
+import { BEGIN_MARKER, SKILL_TARGET_FILES } from './skill-install.js';
+export const NO_INSTALLED_ARTIFACTS = {
+    projectHooks: [], globalHooks: [], rulesHarnesses: [], zedOnlyBlockFiles: [], skillBlockFiles: [],
+};
+const HOOK_HARNESSES = ['claude', 'cursor', 'vscode'];
+/** Null for a file that is absent or unreadable: an advisory scan cannot fail `mast upgrade`. */
+export function readFileOrNull(path) {
+    try {
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+// A plain substring test on the raw text, not a JSON parse: a file that does not parse is
+// still worth a `--check`, which will report the parse problem itself.
+const hasMastHook = (text, harness) => text !== null && (text.includes(` hook ${harness} session-start`) || text.includes(` hook ${harness} search`));
+export function findInstalledArtifacts(projectRoot, home, readFile) {
+    const hooksIn = (scope) => HOOK_HARNESSES.filter((h) => hasMastHook(readFile(hookFilePath(h, scope, projectRoot, home)), h));
+    const present = (path) => readFile(path) !== null;
+    const carriesBlock = (rel) => readFile(join(projectRoot, rel))?.includes(BEGIN_MARKER) === true;
+    const rulesHarnesses = [];
+    if (present(cursorRulesPath(projectRoot)))
+        rulesHarnesses.push('cursor');
+    if (windsurfRulesPaths(projectRoot).some(present))
+        rulesHarnesses.push('windsurf');
+    return {
+        projectHooks: hooksIn('project'),
+        globalHooks: hooksIn('global'),
+        rulesHarnesses,
+        zedOnlyBlockFiles: ZED_RULES_FILES.filter((f) => !SKILL_TARGET_FILES.includes(f) && carriesBlock(f)),
+        skillBlockFiles: SKILL_TARGET_FILES.filter(carriesBlock),
+    };
+}
+//# sourceMappingURL=installed-artifacts.js.map

package/dist/cli/installed-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installed-artifacts.js","sourceRoot":"","sources":["../../src/cli/installed-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAoBtE,MAAM,CAAC,MAAM,sBAAsB,GAAuB;IACxD,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE;CAClG,CAAC;AAEF,MAAM,cAAc,GAAuB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAE1E,iGAAiG;AACjG,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,uEAAuE;AACvE,MAAM,WAAW,GAAG,CAAC,IAAmB,EAAE,OAAgB,EAAW,EAAE,CACrE,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,OAAO,gBAAgB,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,OAAO,SAAS,CAAC,CAAC,CAAC;AAEjH,MAAM,UAAU,sBAAsB,CACpC,WAAmB,EACnB,IAAY,EACZ,QAAyC;IAEzC,MAAM,OAAO,GAAG,CAAC,KAA2B,EAAa,EAAE,CACzD,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpG,MAAM,OAAO,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACnE,MAAM,YAAY,GAAG,CAAC,GAAW,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,CAAC;IAEjH,MAAM,cAAc,GAA8B,EAAE,CAAC;IACrD,IAAI,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QAAE,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzE,IAAI,kBAAkB,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEnF,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC;QAChC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC;QAC9B,cAAc;QACd,iBAAiB,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;QACpG,eAAe,EAAE,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/cli/prime-cmd.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+import { type StatusReport } from './status.js';
+/** Absolute path of the shipped rules text; `assets` is in the package's `files`. */
+export declare const PRIME_ASSET_PATH: string;
+/**
+ * Renders the session primer for one of four index states.
+ *
+ * The rules are printed only when the index can be trusted to answer (fresh, or
+ * stale with a reindex instruction). Telling a model to use an index that does not
+ * exist, or one that describes a different tree, teaches it to ignore the primer,
+ * so those two states say what is wrong instead.
+ *
+ * Pure: `now` is a parameter so the age line is deterministic.
+ */
+export declare function renderPrime(status: StatusReport, rules: string, now: Date): string;
+export declare function registerPrimeCommand(program: Command): void;
+//# sourceMappingURL=prime-cmd.d.ts.map

package/dist/cli/prime-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/prime-cmd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7D,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AAEzE;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAgClF;AAWD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa3D"}

package/dist/cli/prime-cmd.js

@@ -0,0 +1,70 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { buildStatus } from './status.js';
+import { PACKAGE_ROOT } from './docs-cmd.js';
+/** Absolute path of the shipped rules text; `assets` is in the package's `files`. */
+export const PRIME_ASSET_PATH = join(PACKAGE_ROOT, 'assets', 'prime.md');
+/**
+ * Renders the session primer for one of four index states.
+ *
+ * The rules are printed only when the index can be trusted to answer (fresh, or
+ * stale with a reindex instruction). Telling a model to use an index that does not
+ * exist, or one that describes a different tree, teaches it to ignore the primer,
+ * so those two states say what is wrong instead.
+ *
+ * Pure: `now` is a parameter so the age line is deterministic.
+ */
+export function renderPrime(status, rules, now) {
+    if (!status.initialised) {
+        return [
+            `mast has no index at ${status.state_dir}.`,
+            'Use ordinary search tools (grep, glob, reading files) here.',
+            'Run `mast init` in the project to create an index.',
+        ].join('\n') + '\n';
+    }
+    if (status.freshness_cause === 'root_mismatch') {
+        return [
+            `The mast index at ${status.state_dir} describes a different tree than ${status.project_root}.`,
+            'mast results here cannot be trusted, and reindexing will not fix it.',
+            'Use ordinary search tools, and check the project path and --state-dir.',
+        ].join('\n') + '\n';
+    }
+    const health = [
+        `mast index: ${String(status.indexed_files ?? 0)} files, last indexed ${describeAge(status.last_indexed, now)}.`,
+    ];
+    if (!status.index_fresh) {
+        const b = status.stale_breakdown;
+        const split = b === null
+            ? ''
+            : ` (changed ${String(b.changed)}, unindexed ${String(b.unindexed)}, deleted ${String(b.deleted)})`;
+        health.push(`The index is stale: ${String(status.stale_files ?? 0)} files differ from disk${split}.`, 'Call mast_reindex before relying on mast results.');
+    }
+    return rules.trimEnd() + '\n\n' + health.join('\n') + '\n';
+}
+function describeAge(lastIndexed, now) {
+    if (lastIndexed === null)
+        return 'never';
+    const seconds = Math.max(0, Math.floor((now.getTime() - new Date(lastIndexed).getTime()) / 1_000));
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    if (seconds < 3_600)
+        return `${Math.floor(seconds / 60)}m ago`;
+    if (seconds < 86_400)
+        return `${Math.floor(seconds / 3_600)}h ago`;
+    return `${Math.floor(seconds / 86_400)}d ago`;
+}
+export function registerPrimeCommand(program) {
+    program
+        .command('prime [path]')
+        .description('Print the session primer: how to use mast here, and the live index health')
+        .option('--state-dir <dir>', 'State directory')
+        .action(async (projectPath, opts) => {
+        // Exit 0 in every state, unlike `mast status`: this runs from a session-start
+        // hook, where a non-zero exit is a failure the user sees. "No index" is a
+        // state the primer reports in its text, not an error of the command.
+        const status = await buildStatus({ path: projectPath, stateDir: opts.stateDir });
+        const rules = readFileSync(PRIME_ASSET_PATH, 'utf8');
+        process.stdout.write(renderPrime(status, rules, new Date()));
+    });
+}
+//# sourceMappingURL=prime-cmd.js.map

package/dist/cli/prime-cmd.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAmBtC;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAE1D"}
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAsBtC;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,IAAI,SAAS,MAAM,EAAE,CAE1D"}

package/dist/cli/program.js

@@ -10,6 +10,9 @@ import { registerMetricsCommand } from './metrics-cmd.js';
 import { registerQueryCommand } from './query.js';
 import { registerDocsCommand, registerSkillCommand } from './docs-cmd.js';
 import { registerUpgradeCommand } from './upgrade-cmd.js';
+import { registerPrimeCommand } from './prime-cmd.js';
+import { registerHookCommand } from './hook-cmd.js';
+import { registerSetupCommand } from './setup-cmd.js';
 /**
  * Builds the CLI. This is the *only* place commands are registered.
  *
@@ -34,6 +37,9 @@ export function buildProgram() {
     registerQueryCommand(program);
     registerDocsCommand(program);
     registerSkillCommand(program);
+    registerPrimeCommand(program);
+    registerHookCommand(program);
+    registerSetupCommand(program);
     registerUpgradeCommand(program);
     return program;
 }

package/dist/cli/program.js.map

@@ -1 +1 @@
-{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,+FAA+F,CAAC;SAC5G,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,MAAM,CAAC;SACZ,WAAW,CAAC,+FAA+F,CAAC;SAC5G,OAAO,CAAC,WAAW,CAAC,CAAC;IAExB,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACrC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEhC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB;IACpC,OAAO,YAAY,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { Command } from 'commander';
+import { type InstallKind } from './upgrade-cmd.js';
+export interface SetupOptions {
+    readonly harness: string;
+    readonly projectRoot: string;
+    readonly global: boolean;
+    readonly check: boolean;
+    readonly remove: boolean;
+    readonly dryRun: boolean;
+}
+/** Everything about the machine `setup` reads, injected so tests never touch the real home. */
+export interface SetupEnv {
+    readonly installKind: InstallKind;
+    readonly home: string;
+    readonly cliEntry: string;
+    /** The text of `assets/skill.md`, which every rules file is rendered from. */
+    readonly skillText: string;
+}
+export interface SetupIo {
+    /** Null when the file does not exist. Throws on any other failure. */
+    readFile(path: string): string | null;
+    /** Creates parent directories. Must never leave a half-written file at `path`. */
+    writeFileAtomic(path: string, content: string): void;
+    removeFile(path: string): void;
+    fileExists(path: string): boolean;
+    directoryExists(path: string): boolean;
+    out(line: string): void;
+    err(line: string): void;
+}
+/** Returns the process exit code: 0 done, 1 refused or failed, 2 usage error. */
+export declare function runSetup(opts: SetupOptions, env: SetupEnv, io: SetupIo): number;
+export declare function createNodeSetupIo(): SetupIo;
+export declare function registerSetupCommand(program: Command): void;
+//# sourceMappingURL=setup-cmd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/setup-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAcvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,+FAA+F;AAC/F,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,kFAAkF;IAClF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAyDD,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAoB/E;AAsED,wBAAgB,iBAAiB,IAAI,OAAO,CAoB3C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB3D"}