@spikedpunch/mast 0.2.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/query.d.ts

@@ -1,4 +1,6 @@
 import type { Command } from 'commander';
+import { type ResolvedConfig } from '../store/config.js';
+import { type IndexResult } from '../indexer/index.js';
 /**
  * D0 (IMPLEMENTATION_PLAN.md "Stage 4: Determinism, hygiene, and the
  * measurement harness", "### D0 — CLI query surface"): `mast query <tool>
@@ -29,6 +31,37 @@ export interface RunQueryOptions {
     readonly stateDir?: string;
     /** Project root path (the CLI's positional `[path]`); defaults to cwd via `resolveConfig`. */
     readonly path?: string;
+    /**
+     * Refresh the index incrementally before dispatching the query.
+     *
+     * The CLI has neither of the freshness mechanisms the MCP server has — no
+     * watcher, and no cached freshness probe, because a one-shot process has no
+     * lifetime to amortise a TTL over. This flag is its answer.
+     *
+     * Opt-in rather than default, because it adds a whole incremental index run
+     * to an invocation that would otherwise be a single query. Measured on this
+     * repository (212 indexable files) on 2026-09-03: a no-op incremental run
+     * reports 25-34 ms of index work inside ~0.5 s of process wall clock, and a
+     * run that found 11 changed files reported 424 ms. It scales with the tree,
+     * so on a large monorepo it is materially more — which is punishing in the
+     * scripts and loops where `mast search` gets used.
+     *
+     * Incremental, never full. Refreshes an existing index; it does not create
+     * one — see the never-indexed guard in {@link runQuery}.
+     */
+    readonly reindex?: boolean;
+    /**
+     * Test-only injection point (§4.4 DI): substitutes for the real incremental
+     * `runIndex`, so the lock-contention degradation path can be driven without
+     * standing up a competing writer. Production passes nothing.
+     */
+    readonly reindexer?: (config: ResolvedConfig) => Promise<IndexResult>;
+    /**
+     * Where `--reindex` reports itself. Defaults to stderr, deliberately: the
+     * refresh is a side effect of the query, not part of its answer, and
+     * `--json` consumers must keep a parseable stdout.
+     */
+    readonly warn?: (message: string) => void;
 }
 /**
  * Dispatch a single CLI query through the exact registered MCP tool handler
@@ -42,5 +75,11 @@ export interface RunQueryOptions {
  * would over the MCP transport.
  */
 export declare function runQuery(toolName: string, jsonArgs: string, options?: RunQueryOptions): Promise<string>;
-export declare function registerQueryCommand(program: Command): void;
+/**
+ * @param run Injected so the flag wiring can be tested without a real index
+ *   (§4.4). Production passes {@link runQuery}. A `--reindex` flag that is
+ *   declared but never threaded through would be an asserted-and-unimplemented
+ *   property (SHAPES S-04), which is why it is pinned rather than assumed.
+ */
+export declare function registerQueryCommand(program: Command, run?: typeof runQuery): void;
 //# sourceMappingURL=query.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/cli/query.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQzC;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAoCxC;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAW3D;AAED,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CA6DjH;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwB3D"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/cli/query.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMjE;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAoCxC;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAW3D;AAED,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACtE;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuFjH;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,OAAO,QAAmB,GAAG,IAAI,CA2B5F"}

package/dist/cli/query.js

@@ -3,6 +3,7 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { z, ZodError } from 'zod';
 import { resolveConfig } from '../store/config.js';
+import { runIndex } from '../indexer/index.js';
 import { openDatabase } from '../graph/db.js';
 import { SqliteChunkStore } from '../store/sqliteChunkStore.js';
 import { registerAllTools } from '../mcp/register-tools.js';
@@ -86,6 +87,30 @@ export async function runQuery(toolName, jsonArgs, options = {}) {
     if (!existsSync(graphDbPath)) {
         throw new QueryError(`no index found at ${config.resolved_state_dir}; run \`mast init\` / \`mast index\` first`);
     }
+    // AFTER the never-indexed guard above, and deliberately so. Running the
+    // indexer first would create graph.db as a side effect and let the guard
+    // pass, silently promoting `--reindex` from "refresh" to "bootstrap" and
+    // masking the very state the guard reports — the same ordering hazard its
+    // own comment describes for `openDatabase`. `mast index` creates; this
+    // refreshes.
+    if (options.reindex === true) {
+        const warn = options.warn ?? ((message) => process.stderr.write(`${message}\n`));
+        const reindex = options.reindexer ?? ((c) => runIndex(c, { incremental: true }));
+        try {
+            const result = await reindex(config);
+            warn(`[mast] reindexed: ${String(result.filesIndexed)} file(s) indexed, ` +
+                `${String(result.filesSkipped)} unchanged, +${String(result.chunksAdded)}/` +
+                `-${String(result.chunksRemoved)} chunks (${String(result.durationMs)} ms)`);
+        }
+        catch (err) {
+            // Never fatal. `runIndex` takes `structure.lock`, and `mast serve` now
+            // watches by default, so losing the race to a concurrent writer is an
+            // ordinary outcome. Failing the query over a refresh that did not happen
+            // would be a worse answer than a slightly stale one — but staying silent
+            // about it would be worse than both, because the caller asked for fresh.
+            warn(`[mast] --reindex failed, querying the existing index instead: ${String(err)}`);
+        }
+    }
     let parsedArgs;
     try {
         parsedArgs = JSON.parse(jsonArgs);
@@ -128,15 +153,24 @@ export async function runQuery(toolName, jsonArgs, options = {}) {
         await db.destroy();
     }
 }
-export function registerQueryCommand(program) {
+/**
+ * @param run Injected so the flag wiring can be tested without a real index
+ *   (§4.4). Production passes {@link runQuery}. A `--reindex` flag that is
+ *   declared but never threaded through would be an asserted-and-unimplemented
+ *   property (SHAPES S-04), which is why it is pinned rather than assumed.
+ */
+export function registerQueryCommand(program, run = runQuery) {
     program
         .command('query <tool> [json] [path]')
         .description('Invoke an MCP read tool directly from the CLI — identical output to the MCP transport (MAST_SPEC.md §8)')
         .option('--state-dir <dir>', 'State directory')
+        .option('--reindex', 'Incrementally reindex before querying — the CLI has no watcher (see `mast serve`)')
         .option('--json', 'Emit the exact single-line MCP response text (machine use); default pretty-prints for humans')
         .action(async (toolName, jsonArg, path, opts) => {
         try {
-            const text = await runQuery(toolName, jsonArg ?? '{}', { stateDir: opts.stateDir, path });
+            const text = await run(toolName, jsonArg ?? '{}', {
+                stateDir: opts.stateDir, path, reindex: opts.reindex === true,
+            });
             if (opts.json) {
                 process.stdout.write(text + '\n');
             }

package/dist/cli/query.js.map

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

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

@@ -1,4 +1,5 @@
 import type { Command } from 'commander';
+import { runQuery } from './query.js';
 /**
  * `mast search <query>` — the readable front door to `mast_search`.
  *
@@ -29,5 +30,9 @@ export declare function buildSearchArgs(query: string, flags: SearchFlags): stri
  * severity scale is built around.
  */
 export declare function formatSearchResults(responseText: string): string;
-export declare function registerSearchCommand(program: Command): void;
+/**
+ * @param run Injected so the `--reindex` wiring can be tested without a real
+ *   index (§4.4). Production passes {@link runQuery}.
+ */
+export declare function registerSearchCommand(program: Command, run?: typeof runQuery): void;
 //# sourceMappingURL=search-cmd.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/search-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAczE;AAqBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA8EhE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoB5D"}
+{"version":3,"file":"search-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/search-cmd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAc,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM,CAczE;AAqBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CA8EhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,GAAE,OAAO,QAAmB,GAAG,IAAI,CAuB7F"}