@spikedpunch/mast 0.1.0

package/dist/cli/serve.js

@@ -0,0 +1,19 @@
+import { resolveConfig } from '../store/config.js';
+import { serve } from '../mcp/server.js';
+export function registerServeCommand(program) {
+    program
+        .command('serve')
+        .description('Start the MCP server over stdio')
+        .option('--state-dir <dir>', 'State directory')
+        .option('--no-startup-reindex', 'Skip the startup staleness check (not recommended)')
+        .option('--watch', 'Watch source files and incrementally reindex on change (interactive use)')
+        .action(async (opts) => {
+        const config = resolveConfig({ stateDirOverride: opts.stateDir });
+        await serve({
+            config,
+            noStartupReindex: !opts.startupReindex,
+            watch: opts.watch === true,
+        });
+    });
+}
+//# sourceMappingURL=serve.js.map

package/dist/cli/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/cli/serve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC;SAC9C,MAAM,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;SACpF,MAAM,CAAC,SAAS,EAAE,0EAA0E,CAAC;SAC7F,MAAM,CAAC,KAAK,EAAE,IAId,EAAE,EAAE;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClE,MAAM,KAAK,CAAC;YACV,MAAM;YACN,gBAAgB,EAAE,CAAC,IAAI,CAAC,cAAc;YACtC,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,IAAI;SAC3B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * `mast skill --install` — splices the MAST instructions into a project's agent config.
+ *
+ * Two rules shape this, both about not surprising someone. It writes only into files that
+ * ALREADY exist — creating a `CLAUDE.md` in a repo that deliberately has none is not a
+ * decision this tool gets to make. And it writes inside a marked block, so re-running
+ * after an upgrade replaces the previous copy instead of appending a second one; two
+ * copies of the skill in a prompt is worse than none, because after the next upgrade they
+ * disagree with each other.
+ *
+ * It is never automatic. `mast skill` prints; `--install` writes, and `--dry-run` shows
+ * exactly what would change first. These files are hand-curated and committed, and a tool
+ * that edits them uninvited is a tool that turns up in someone's `git diff` unannounced.
+ */
+export declare const BEGIN_MARKER = "<!-- BEGIN mast skill \u2014 managed by `mast skill --install`, edits here are overwritten -->";
+export declare const END_MARKER = "<!-- END mast skill -->";
+export interface SkillTarget {
+    /** Path relative to the project root, as displayed. */
+    readonly file: string;
+    /** Absolute path. */
+    readonly path: string;
+    /** The agent this file configures, for the confirmation line. */
+    readonly agent: string;
+}
+/** Agent config files that exist in this project. Never invents one. */
+export declare function detectSkillTargets(projectRoot: string): readonly SkillTarget[];
+/**
+ * Inserts or replaces the managed block. Returns the content unchanged when the block is
+ * already present and identical, so a re-run is a genuine no-op rather than a whitespace diff.
+ */
+export declare function spliceSkillBlock(existing: string, skillText: string): string;
+export interface InstallOutcome {
+    readonly target: SkillTarget;
+    readonly changed: boolean;
+}
+export declare function installSkillInto(targets: readonly SkillTarget[], skillText: string, options?: {
+    dryRun?: boolean;
+}): readonly InstallOutcome[];
+//# sourceMappingURL=skill-install.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/skill-install.js

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * `mast skill --install` — splices the MAST instructions into a project's agent config.
+ *
+ * Two rules shape this, both about not surprising someone. It writes only into files that
+ * ALREADY exist — creating a `CLAUDE.md` in a repo that deliberately has none is not a
+ * decision this tool gets to make. And it writes inside a marked block, so re-running
+ * after an upgrade replaces the previous copy instead of appending a second one; two
+ * copies of the skill in a prompt is worse than none, because after the next upgrade they
+ * disagree with each other.
+ *
+ * It is never automatic. `mast skill` prints; `--install` writes, and `--dry-run` shows
+ * exactly what would change first. These files are hand-curated and committed, and a tool
+ * that edits them uninvited is a tool that turns up in someone's `git diff` unannounced.
+ */
+export const BEGIN_MARKER = '<!-- BEGIN mast skill — managed by `mast skill --install`, edits here are overwritten -->';
+export const END_MARKER = '<!-- END mast skill -->';
+const CANDIDATES = [
+    { file: 'CLAUDE.md', agent: 'Claude Code / Claude Desktop' },
+    { file: 'AGENTS.md', agent: 'Codex and other AGENTS.md readers' },
+    { file: '.cursorrules', agent: 'Cursor' },
+    { file: '.windsurfrules', agent: 'Windsurf' },
+    { file: '.github/copilot-instructions.md', agent: 'GitHub Copilot' },
+];
+/** Agent config files that exist in this project. Never invents one. */
+export function detectSkillTargets(projectRoot) {
+    return CANDIDATES
+        .map((c) => ({ ...c, path: join(projectRoot, c.file) }))
+        .filter((c) => existsSync(c.path));
+}
+/**
+ * Inserts or replaces the managed block. Returns the content unchanged when the block is
+ * already present and identical, so a re-run is a genuine no-op rather than a whitespace diff.
+ */
+export function spliceSkillBlock(existing, skillText) {
+    const block = `${BEGIN_MARKER}\n\n${skillText.trimEnd()}\n\n${END_MARKER}`;
+    const begin = existing.indexOf(BEGIN_MARKER);
+    const end = existing.indexOf(END_MARKER);
+    if (begin !== -1 && end !== -1 && end > begin) {
+        const replaced = existing.slice(0, begin) + block + existing.slice(end + END_MARKER.length);
+        return replaced === existing ? existing : replaced;
+    }
+    const base = existing.trimEnd();
+    return base === '' ? block + '\n' : `${base}\n\n${block}\n`;
+}
+export function installSkillInto(targets, skillText, options = {}) {
+    return targets.map((target) => {
+        const before = existsSync(target.path) ? readFileSync(target.path, 'utf8') : '';
+        const after = spliceSkillBlock(before, skillText);
+        const changed = after !== before;
+        if (changed && options.dryRun !== true)
+            writeFileSync(target.path, after);
+        return { target, changed };
+    });
+}
+//# sourceMappingURL=skill-install.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,35 @@
+import type { Command } from 'commander';
+export interface StatusReport {
+    readonly state_dir: string;
+    /** False when nothing has ever been indexed at `state_dir`. */
+    readonly initialised: boolean;
+    readonly schema_version: string;
+    readonly last_indexed: string | null;
+    readonly indexed_files: number | null;
+    readonly chunk_count: number | null;
+    /** `null` when there is no index — a stale count against nothing is meaningless. */
+    readonly stale_files: number | null;
+    readonly parse_errors: number | null;
+    readonly write_errors: number | null;
+    readonly index_fresh: boolean;
+    readonly freshness_cause: string | null;
+    readonly seed_commit?: string | undefined;
+}
+/**
+ * Builds the status report.
+ *
+ * The `initialised` distinction is load-bearing. M6 (ADR 008) fixed `mast serve`
+ * answering meaningfully against a never-indexed state directory; the same shape
+ * survived here. Pointed at a path with no index, this used to report an invented
+ * schema version, a stale-file count computed against an empty manifest, and
+ * `freshness_cause: phase1_stale` — telling a caller their index was stale when in
+ * fact they were looking in the wrong place. The case that produces it is ordinary:
+ * `mast init --state-dir ./elsewhere`, then any later command without the flag,
+ * because path keys are deliberately never read back from a persisted config.
+ */
+export declare function buildStatus(options?: {
+    path?: string;
+    stateDir?: string;
+}): Promise<StatusReport>;
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +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"}

package/dist/cli/status.js

@@ -0,0 +1,117 @@
+import { resolveConfig, CURRENT_SCHEMA_VERSION } from '../store/config.js';
+import { loadIndexMeta, freshnessCause } from '../indexer/index.js';
+import { measureFreshness } from '../indexer/freshness.js';
+import { openDatabase } from '../graph/db.js';
+/**
+ * Builds the status report.
+ *
+ * The `initialised` distinction is load-bearing. M6 (ADR 008) fixed `mast serve`
+ * answering meaningfully against a never-indexed state directory; the same shape
+ * survived here. Pointed at a path with no index, this used to report an invented
+ * schema version, a stale-file count computed against an empty manifest, and
+ * `freshness_cause: phase1_stale` — telling a caller their index was stale when in
+ * fact they were looking in the wrong place. The case that produces it is ordinary:
+ * `mast init --state-dir ./elsewhere`, then any later command without the flag,
+ * because path keys are deliberately never read back from a persisted config.
+ */
+export async function buildStatus(options = {}) {
+    const config = resolveConfig({ projectRoot: options.path, stateDirOverride: options.stateDir });
+    const meta = loadIndexMeta(config.resolved_state_dir);
+    if (meta === null) {
+        return {
+            state_dir: config.resolved_state_dir,
+            initialised: false,
+            schema_version: CURRENT_SCHEMA_VERSION,
+            last_indexed: null,
+            indexed_files: null,
+            chunk_count: null,
+            stale_files: null,
+            parse_errors: null,
+            write_errors: null,
+            index_fresh: false,
+            freshness_cause: 'not_initialised',
+        };
+    }
+    // Freshness needs the `files` stamps as well as the manifest (see
+    // `measureFreshness`), so this opens the graph db — safe here and nowhere
+    // above, because the `meta === null` branch has already returned for a state
+    // dir that was never indexed.
+    const db = openDatabase(config.resolved_state_dir);
+    let staleCount;
+    try {
+        staleCount = (await measureFreshness(config, db)).total;
+    }
+    finally {
+        await db.destroy();
+    }
+    return {
+        state_dir: config.resolved_state_dir,
+        initialised: true,
+        // From the binary, never from index.json — see StatusResult.schema_version.
+        schema_version: CURRENT_SCHEMA_VERSION,
+        last_indexed: meta.last_indexed ?? null,
+        indexed_files: meta.file_count ?? 0,
+        chunk_count: meta.chunk_count ?? 0,
+        stale_files: staleCount,
+        parse_errors: meta.parse_errors ?? 0,
+        write_errors: meta.write_errors ?? 0,
+        index_fresh: staleCount === 0,
+        freshness_cause: freshnessCause(staleCount),
+        seed_commit: meta.seed_commit,
+    };
+}
+export function registerStatusCommand(program) {
+    program
+        .command('status [path]')
+        .description('Print index health')
+        .option('--state-dir <dir>', 'State directory')
+        .option('--json', 'Output as JSON')
+        .action(async (projectPath, opts) => {
+        const status = await buildStatus({ path: projectPath, stateDir: opts.stateDir });
+        if (opts.json) {
+            process.stdout.write(JSON.stringify(status, null, 2) + '\n');
+            return;
+        }
+        // An absent index gets a short, unambiguous answer and a non-zero exit — not a
+        // health table with zeros in it, which reads as a report on something real.
+        if (!status.initialised) {
+            process.stdout.write([
+                `state_dir:      ${status.state_dir}`,
+                'index:          NOT INITIALISED — nothing has been indexed at this path',
+                '',
+                'Run `mast init` here, or pass --state-dir if you indexed somewhere else.',
+                'A custom --state-dir is not remembered between runs; set `state_dir` in',
+                'mast.config.json or export MAST_STATE_DIR to make it stick.',
+            ].join('\n') + '\n');
+            process.exitCode = 1;
+            return;
+        }
+        const ago = status.last_indexed != null
+            ? ` (${formatAge(new Date(status.last_indexed))} ago)`
+            : '';
+        process.stdout.write([
+            `state_dir:      ${status.state_dir}`,
+            `schema_version: ${status.schema_version}`,
+            `last_indexed:   ${status.last_indexed ?? 'never'}${ago}`,
+            `indexed_files:  ${String(status.indexed_files)}`,
+            `chunk_count:    ${String(status.chunk_count)}`,
+            `stale_files:    ${String(status.stale_files)}`,
+            `parse_errors:   ${String(status.parse_errors)}`,
+            `write_errors:   ${String(status.write_errors)}`,
+            `index_fresh:    ${String(status.index_fresh)}`,
+            `freshness_cause: ${status.freshness_cause ?? 'none'}`,
+            ...(status.seed_commit != null ? [`seed_commit:    ${status.seed_commit}`] : []),
+        ].join('\n') + '\n');
+    });
+}
+function formatAge(date) {
+    const seconds = Math.floor((Date.now() - date.getTime()) / 1_000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    if (seconds < 3_600)
+        return `${Math.floor(seconds / 60)}m`;
+    if (seconds < 86_400)
+        return `${Math.floor(seconds / 3_600)}h`;
+    return `${Math.floor(seconds / 86_400)}d`;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

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

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

@@ -0,0 +1,48 @@
+import type { Command } from 'commander';
+/**
+ * `mast upgrade` — checks and instructs. It deliberately does NOT perform the upgrade.
+ *
+ * Two reasons, both practical rather than stylistic. A CLI cannot reliably know how it
+ * was installed — global, devDependency, dlx, a monorepo catalog — and guessing wrong
+ * means running the wrong command in someone's repository. And self-mutating requires
+ * write access to its own install directory, which is exactly what fails in CI and
+ * containers.
+ *
+ * What the package manager *cannot* do is the reason this command exists at all:
+ * upgrading across a schema-version change makes `bootstrapState` discard the index and
+ * reindex from scratch (`mcp/startup.ts`). On a 150k-chunk monorepo that is minutes of
+ * silence on the next `serve`, and `pnpm up` will never mention it. Telling the user
+ * before they upgrade is this command's whole job.
+ */
+export type InstallKind = 'local' | 'global' | 'source';
+export type PackageManager = 'pnpm' | 'npm' | 'yarn';
+export interface UpgradeFacts {
+    readonly current: string;
+    /** `null` when the registry could not be reached — never conflated with "current". */
+    readonly latest: string | null;
+    readonly installKind: InstallKind;
+    readonly packageManager: PackageManager;
+    readonly currentSchema: string;
+    /** Schema recorded in the user's index, or `null` if never indexed. */
+    readonly indexedSchema: string | null;
+    readonly chunkCount: number | null;
+}
+/** Semver compare, prerelease-aware. Returns <0, 0, or >0. */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Classifies how this binary was installed, from the directory it is executing out of.
+ * `node_modules` under the project being indexed is a dependency; `node_modules`
+ * elsewhere is a global prefix; anything else is a checkout.
+ */
+export declare function detectInstallKind(moduleDir: string, projectRoot: string): InstallKind;
+export declare function upgradeCommandFor(kind: InstallKind, pm: PackageManager): string;
+export declare function buildUpgradeReport(f: UpgradeFacts): string;
+/** Registry lookup, injected so tests never depend on the network. */
+export type LatestVersionLookup = () => Promise<string | null>;
+export declare const fetchLatestFromNpm: LatestVersionLookup;
+export declare function gatherUpgradeFacts(options?: {
+    path?: string;
+    stateDir?: string;
+}, lookup?: LatestVersionLookup): Promise<UpgradeFacts>;
+export declare function registerUpgradeCommand(program: Command): void;
+//# sourceMappingURL=upgrade-cmd.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-cmd.d.ts","sourceRoot":"","sources":["../../src/cli/upgrade-cmd.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uEAAuE;IACvE,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAe5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAIrF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,GAAG,MAAM,CAU/E;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAuB1D;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE/D,eAAO,MAAM,kBAAkB,EAAE,mBAahC,CAAC;AASF,wBAAsB,kBAAkB,CACtC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,EAClD,MAAM,GAAE,mBAAwC,GAC/C,OAAO,CAAC,YAAY,CAAC,CAqBvB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa7D"}

package/dist/cli/upgrade-cmd.js

@@ -0,0 +1,129 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join, relative, isAbsolute } from 'node:path';
+import { CLI_VERSION, PACKAGE_NAME } from './version.js';
+import { resolveConfig, CURRENT_SCHEMA_VERSION } from '../store/config.js';
+/** Semver compare, prerelease-aware. Returns <0, 0, or >0. */
+export function compareVersions(a, b) {
+    const split = (v) => {
+        const [core = '', ...rest] = v.split('-');
+        return { nums: core.split('.').map((n) => Number(n) || 0), pre: rest.join('-') };
+    };
+    const x = split(a), y = split(b);
+    for (let i = 0; i < 3; i++) {
+        const d = (x.nums[i] ?? 0) - (y.nums[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    // Equal cores: a prerelease sorts BEFORE its release (1.0.0-rc.1 < 1.0.0).
+    if (x.pre === y.pre)
+        return 0;
+    if (x.pre === '')
+        return 1;
+    if (y.pre === '')
+        return -1;
+    return x.pre < y.pre ? -1 : 1;
+}
+/**
+ * Classifies how this binary was installed, from the directory it is executing out of.
+ * `node_modules` under the project being indexed is a dependency; `node_modules`
+ * elsewhere is a global prefix; anything else is a checkout.
+ */
+export function detectInstallKind(moduleDir, projectRoot) {
+    if (!moduleDir.includes('node_modules'))
+        return 'source';
+    const rel = relative(projectRoot, moduleDir);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel) ? 'local' : 'global';
+}
+export function upgradeCommandFor(kind, pm) {
+    if (kind === 'source')
+        return 'git pull && pnpm install && pnpm build';
+    if (kind === 'global') {
+        return pm === 'npm' ? `npm install -g ${PACKAGE_NAME}@latest`
+            : pm === 'yarn' ? `yarn global add ${PACKAGE_NAME}@latest`
+                : `pnpm add -g ${PACKAGE_NAME}@latest`;
+    }
+    return pm === 'npm' ? `npm install --save-dev ${PACKAGE_NAME}@latest`
+        : pm === 'yarn' ? `yarn upgrade ${PACKAGE_NAME}@latest`
+            : `pnpm up ${PACKAGE_NAME}@latest`;
+}
+export function buildUpgradeReport(f) {
+    const out = [`${PACKAGE_NAME} ${f.current}`, ''];
+    if (f.latest === null) {
+        out.push('Could not reach the npm registry, so the latest version is unknown.', `When you do upgrade:  ${upgradeCommandFor(f.installKind, f.packageManager)}`, '');
+    }
+    else if (compareVersions(f.current, f.latest) >= 0) {
+        out.push(`Up to date — ${f.latest} is the latest release.`, '');
+    }
+    else {
+        out.push(`${f.current} → ${f.latest} available`, '', `  installed as:  ${f.installKind === 'local' ? 'project dependency' : f.installKind === 'global' ? 'global install' : 'source checkout'} (${f.packageManager})`, `  run:           ${upgradeCommandFor(f.installKind, f.packageManager)}`, '');
+    }
+    // The half npm cannot tell them. Only warn when there is an index to lose.
+    if (f.indexedSchema !== null && f.indexedSchema !== f.currentSchema) {
+        const size = f.chunkCount === null ? 'your whole project' : `${f.chunkCount.toLocaleString('en-US')} chunks`;
+        out.push(`Your index was built under schema ${f.indexedSchema}; this build expects ${f.currentSchema}.`, `The next \`mast serve\` or \`mast index\` will discard it and reindex ${size} from scratch.`, 'Nothing is lost that cannot be rebuilt — the index is derived state — but budget the time.', '');
+    }
+    return out.join('\n').trimEnd();
+}
+export const fetchLatestFromNpm = async () => {
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+            headers: { accept: 'application/vnd.npm.install-v1+json' },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        return (await res.json()).version ?? null;
+    }
+    catch {
+        // Offline, proxied, or unpublished. The report handles null honestly; a thrown
+        // error here would make `mast upgrade` useless exactly when it is most wanted.
+        return null;
+    }
+};
+function detectPackageManager() {
+    const ua = process.env['npm_config_user_agent'] ?? '';
+    if (ua.startsWith('npm'))
+        return 'npm';
+    if (ua.startsWith('yarn'))
+        return 'yarn';
+    return 'pnpm';
+}
+export async function gatherUpgradeFacts(options = {}, lookup = fetchLatestFromNpm) {
+    const config = resolveConfig({ projectRoot: options.path, stateDirOverride: options.stateDir });
+    let indexedSchema = null;
+    let chunkCount = null;
+    try {
+        const meta = JSON.parse(readFileSync(join(config.resolved_state_dir, 'index.json'), 'utf8'));
+        indexedSchema = meta.schema_version ?? null;
+        chunkCount = meta.chunk_count ?? null;
+    }
+    catch {
+        // No index yet — then there is nothing to warn about losing.
+    }
+    return {
+        current: CLI_VERSION,
+        latest: await lookup(),
+        installKind: detectInstallKind(dirname(fileURLToPath(import.meta.url)), config.resolved_project_root),
+        packageManager: detectPackageManager(),
+        currentSchema: CURRENT_SCHEMA_VERSION,
+        indexedSchema,
+        chunkCount,
+    };
+}
+export function registerUpgradeCommand(program) {
+    program
+        .command('upgrade [path]')
+        .description('Check for a newer release and print how to install it, including any reindex it will cost')
+        .option('--state-dir <dir>', 'State directory')
+        .action(async (path, opts) => {
+        try {
+            process.stdout.write(buildUpgradeReport(await gatherUpgradeFacts({ path, stateDir: opts.stateDir })) + '\n');
+        }
+        catch (err) {
+            process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=upgrade-cmd.js.map

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

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

package/dist/cli/version.d.ts

@@ -0,0 +1,3 @@
+export declare const PACKAGE_NAME: string;
+export declare const CLI_VERSION: string;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,YAAY,EAAE,MAAsB,CAAC;AAClD,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC"}

package/dist/cli/version.js

@@ -0,0 +1,19 @@
+import { createRequire } from 'node:module';
+/**
+ * Package identity, read from the manifest rather than restated.
+ *
+ * The CLI previously carried a literal `.version('0.1.0')` next to package.json's
+ * own `"version"`. Two producers of one value drift (defect shape S-05), and this
+ * pair drifts silently: nothing fails when `mast --version` reports a release the
+ * binary is not, which is precisely the confusion D8 cost three days to untangle.
+ *
+ * `createRequire` rather than a JSON import attribute: the same mechanism
+ * `ast/parser.ts` already uses, and it resolves identically from `src/` under
+ * vitest and from `dist/cli/` in the published package, because both sit two
+ * directories below the manifest.
+ */
+const require = createRequire(import.meta.url);
+const manifest = require('../../package.json');
+export const PACKAGE_NAME = manifest.name;
+export const CLI_VERSION = manifest.version;
+//# sourceMappingURL=version.js.map

package/dist/cli/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,oBAAoB,CAAsC,CAAC;AAEpF,MAAM,CAAC,MAAM,YAAY,GAAW,QAAQ,CAAC,IAAI,CAAC;AAClD,MAAM,CAAC,MAAM,WAAW,GAAW,QAAQ,CAAC,OAAO,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Single source of truth for all environment variables read by MAST.
+ *
+ * `ConfigEnvSchema` is used by the main process in `store/config.ts`. The
+ * background embedder worker's `WorkerEnvSchema` was removed in Stage 7.1
+ * (IMPLEMENTATION_PLAN.md "Stage 7: Vector-store deletion") along with the
+ * worker process it configured.
+ *
+ * Nothing below the process entry point should call `process.env` directly.
+ */
+import { z } from 'zod';
+/** Environment variables relevant to the main CLI / MCP server process. */
+export declare const ConfigEnvSchema: z.ZodObject<{
+    MAST_STATE_DIR: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ConfigEnv = z.infer<typeof ConfigEnvSchema>;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2EAA2E;AAC3E,eAAO,MAAM,eAAe;;iBAG1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/env.js

@@ -0,0 +1,17 @@
+/**
+ * Single source of truth for all environment variables read by MAST.
+ *
+ * `ConfigEnvSchema` is used by the main process in `store/config.ts`. The
+ * background embedder worker's `WorkerEnvSchema` was removed in Stage 7.1
+ * (IMPLEMENTATION_PLAN.md "Stage 7: Vector-store deletion") along with the
+ * worker process it configured.
+ *
+ * Nothing below the process entry point should call `process.env` directly.
+ */
+import { z } from 'zod';
+/** Environment variables relevant to the main CLI / MCP server process. */
+export const ConfigEnvSchema = z.object({
+    /** Override for the state directory path. Falls back to config file then default. */
+    MAST_STATE_DIR: z.string().min(1).optional(),
+});
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,qFAAqF;IACrF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC"}