@mquan/mochi 0.1.0

package/dist/server/analysis/index.js

@@ -0,0 +1,86 @@
+// Orchestrator for the static-analysis layer.
+//
+// Runs the three analyzers in parallel and assembles the result into the
+// `AnalysisContext` defined in `shared/analysis-schema.ts`. Each analyzer is
+// isolated via Promise.allSettled — a thrown failure in one module degrades
+// that slice (and possibly the depth tier) but never aborts the whole
+// analysis.
+//
+// `runAnalysis` itself only throws on schema drift (the final zod parse),
+// which is a programmer error — surfaces during dev rather than producing a
+// half-formed payload that would confuse the diagram generator.
+//
+// Note: mochi m1 omits the dependency-cruiser pass that exists in miso. The
+// `depGraph` field in AnalysisContext remains optional so a future task can
+// re-introduce it without a schema bump.
+import { AnalysisContext } from "../../shared/analysis-schema.js";
+import { getGitContext } from "./git-context.js";
+import { analyzeTsMorph } from "./ts-morph.js";
+import { analyzeWithTreeSitter } from "./tree-sitter.js";
+function summariseSkips(summaries) {
+    let parsed = 0;
+    let tooLarge = 0;
+    let unsupported = 0;
+    let parseError = 0;
+    for (const s of summaries) {
+        if (s.parsed) {
+            parsed++;
+        }
+        else if (s.skipReason === "too-large") {
+            tooLarge++;
+        }
+        else if (s.skipReason === "unsupported-language") {
+            unsupported++;
+        }
+        else if (s.skipReason === "parse-error") {
+            parseError++;
+        }
+    }
+    return { parsed, tooLarge, unsupported, parseError };
+}
+export async function runAnalysis(files, rootDir) {
+    const filePaths = files.map((f) => f.path);
+    const [tsResult, tsMorphResult, gitResult] = await Promise.allSettled([
+        analyzeWithTreeSitter(files),
+        Promise.resolve().then(() => analyzeTsMorph(files, rootDir)),
+        getGitContext(rootDir, filePaths),
+    ]);
+    const astSummaries = tsResult.status === "fulfilled" ? tsResult.value.astSummaries : [];
+    if (tsResult.status === "rejected") {
+        console.warn(`mochi: tree-sitter pass rejected — ${String(tsResult.reason)}`);
+    }
+    let tsContext = null;
+    if (tsMorphResult.status === "fulfilled") {
+        tsContext = tsMorphResult.value;
+    }
+    else {
+        console.warn(`mochi: ts-morph pass rejected — ${String(tsMorphResult.reason)}`);
+    }
+    let git;
+    if (gitResult.status === "fulfilled") {
+        git = gitResult.value;
+    }
+    else {
+        console.warn(`mochi: git pass rejected — ${String(gitResult.reason)}`);
+        git = { recentCommits: [] };
+    }
+    const depthTier = tsContext !== null ? "deep" : "structural";
+    const counts = summariseSkips(astSummaries);
+    const tsCount = tsContext
+        ? `${tsContext.imports.length} imports / ${tsContext.callHierarchy.length} call edges`
+        : "none";
+    console.info(`mochi: analyzed ${files.length} files (parsed=${counts.parsed}, skipped: too-large=${counts.tooLarge}, unsupported=${counts.unsupported}, parse-error=${counts.parseError}; ts-morph: ${tsCount}; git: ${git.recentCommits.length} commits; depthTier=${depthTier})`);
+    const result = {
+        files,
+        git,
+        depthTier,
+    };
+    if (tsContext !== null) {
+        result.tsContext = {
+            callHierarchy: tsContext.callHierarchy,
+            imports: tsContext.imports,
+        };
+    }
+    return AnalysisContext.parse(result);
+}
+//# sourceMappingURL=index.js.map

package/dist/server/analysis/index.js.map

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

package/dist/server/analysis/tree-sitter.d.ts

@@ -0,0 +1,20 @@
+import type { FileEntry } from "./types.js";
+export type AstSummary = {
+    path: string;
+    parsed: true;
+    language: string;
+    nodeCount: number;
+} | {
+    path: string;
+    parsed: false;
+    language: string;
+    skipReason: "too-large" | "unsupported-language" | "parse-error";
+    error?: string;
+};
+export declare function analyzeWithTreeSitter(files: FileEntry[]): Promise<{
+    astSummaries: AstSummary[];
+}>;
+export declare const __testing__: {
+    resetCaches(): void;
+};
+//# sourceMappingURL=tree-sitter.d.ts.map

package/dist/server/analysis/tree-sitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter.d.ts","sourceRoot":"","sources":["../../../server/analysis/tree-sitter.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnE;IACE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,WAAW,GAAG,sBAAsB,GAAG,aAAa,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAsCN,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,EAAE,GACjB,OAAO,CAAC;IAAE,YAAY,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CAgEzC;AAED,eAAO,MAAM,WAAW;mBACP,IAAI;CAIpB,CAAC"}

package/dist/server/analysis/tree-sitter.js

@@ -0,0 +1,126 @@
+// Tree-sitter wrapper.
+//
+// Produces an AST summary per file: `{ parsed, language, nodeCount? | skipReason }`.
+// astSummaries are NOT propagated into AnalysisContext (the wire schema doesn't
+// carry them); they exist so the orchestrator can emit a one-line summary log
+// of how many files parsed/skipped/erred.
+//
+// All failure modes are turned into structured skip records — this function
+// never throws. Per-file try/catch handles tree-sitter's RangeError on huge
+// inputs (the 500KB pre-filter is belt-and-suspenders for the same case).
+//
+// Init/grammar caching: a single Parser.init() promise is memoized at module
+// scope; `loadGrammar` returns a per-language Promise (NOT a resolved Language)
+// so concurrent first-loads dedupe to one in-flight Language.load.
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { Language, Parser } from "web-tree-sitter";
+import { MAX_FILE_BYTES } from "../input/path-selector.js";
+import { LANGUAGE_GRAMMARS, isSupportedLanguage } from "./grammars.js";
+const requireFromHere = createRequire(import.meta.url);
+let parserInitPromise = null;
+const grammarPromises = new Map();
+async function ensureParserInit() {
+    if (parserInitPromise === null) {
+        parserInitPromise = (async () => {
+            // web-tree-sitter ships its runtime `tree-sitter.wasm` next to the JS
+            // entry. The default Emscripten loader looks for it relative to the
+            // script, which fails reliably in Node ESM (and in Vitest's SSR).
+            // Read it ourselves and pass via wasmBinary — same payload, no
+            // resolution dance at runtime.
+            const wasmFile = requireFromHere.resolve("web-tree-sitter/tree-sitter.wasm");
+            const wasmBinary = await readFile(wasmFile);
+            await Parser.init({ wasmBinary });
+        })();
+    }
+    return parserInitPromise;
+}
+function loadGrammar(language) {
+    const cached = grammarPromises.get(language);
+    if (cached)
+        return cached;
+    const resolver = LANGUAGE_GRAMMARS[language];
+    if (!resolver) {
+        return Promise.reject(new Error(`mochi: unsupported tree-sitter language: ${language}`));
+    }
+    const p = Language.load(resolver());
+    grammarPromises.set(language, p);
+    return p;
+}
+function logSkip(path, language, reason, extra) {
+    const tail = extra ? `; ${extra}` : "";
+    console.warn(`mochi: tree-sitter skipping ${path} (${reason}${tail}; language=${language})`);
+}
+export async function analyzeWithTreeSitter(files) {
+    await ensureParserInit();
+    const summaries = [];
+    for (const file of files) {
+        if (file.size > MAX_FILE_BYTES) {
+            logSkip(file.path, file.language, "too-large", `size=${file.size}`);
+            summaries.push({
+                path: file.path,
+                parsed: false,
+                language: file.language,
+                skipReason: "too-large",
+            });
+            continue;
+        }
+        if (!isSupportedLanguage(file.language)) {
+            summaries.push({
+                path: file.path,
+                parsed: false,
+                language: file.language,
+                skipReason: "unsupported-language",
+            });
+            continue;
+        }
+        try {
+            const grammar = await loadGrammar(file.language);
+            const parser = new Parser();
+            parser.setLanguage(grammar);
+            const tree = parser.parse(file.content);
+            try {
+                if (tree === null) {
+                    summaries.push({
+                        path: file.path,
+                        parsed: false,
+                        language: file.language,
+                        skipReason: "parse-error",
+                        error: "parser returned null",
+                    });
+                }
+                else {
+                    summaries.push({
+                        path: file.path,
+                        parsed: true,
+                        language: file.language,
+                        nodeCount: tree.rootNode.descendantCount,
+                    });
+                }
+            }
+            finally {
+                tree?.delete();
+                parser.delete();
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            logSkip(file.path, file.language, "parse-error", message);
+            summaries.push({
+                path: file.path,
+                parsed: false,
+                language: file.language,
+                skipReason: "parse-error",
+                error: message,
+            });
+        }
+    }
+    return { astSummaries: summaries };
+}
+export const __testing__ = {
+    resetCaches() {
+        parserInitPromise = null;
+        grammarPromises.clear();
+    },
+};
+//# sourceMappingURL=tree-sitter.js.map

package/dist/server/analysis/tree-sitter.js.map

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

package/dist/server/analysis/ts-morph.d.ts

@@ -0,0 +1,17 @@
+import type { FileEntry } from "./types.js";
+export interface CallEdge {
+    fromFile: string;
+    fromFunction: string;
+    toName: string;
+}
+export interface ImportEntry {
+    fromFile: string;
+    specifier: string;
+    resolvedPath: string | null;
+}
+export interface TsMorphResult {
+    callHierarchy: CallEdge[];
+    imports: ImportEntry[];
+}
+export declare function analyzeTsMorph(files: FileEntry[], rootDir: string): TsMorphResult | null;
+//# sourceMappingURL=ts-morph.d.ts.map

package/dist/server/analysis/ts-morph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-morph.d.ts","sourceRoot":"","sources":["../../../server/analysis/ts-morph.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,QAAQ,EAAE,CAAC;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAsDD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,MAAM,GACd,aAAa,GAAG,IAAI,CAuEtB"}

package/dist/server/analysis/ts-morph.js

@@ -0,0 +1,143 @@
+// ts-morph wrapper.
+//
+// Builds a transient ts-morph Project from the in-memory file contents (we
+// avoid loading the user's tsconfig — it could be slow, missing, or invalid,
+// and it makes test setup unpredictable). Extracts two slices used by the
+// diagram generator (m2):
+//   - imports:        module-level import declarations, with resolved file
+//                     paths (relative to rootDir) when the target is in scope.
+//   - callHierarchy:  best-effort top-level call edges from exported functions.
+//                     This is intentionally shallow — narration anchoring
+//                     tolerates noise; symbol resolution is not in v1 scope.
+//
+// Returns `null` when the file set has zero TS/JS files. That null is the
+// depth-tier downgrade signal the orchestrator uses to mark the analysis
+// "structural" instead of "deep".
+//
+// Failure modes:
+//   - Project construction throws → outer try/catch returns `null`.
+//   - Per-file `createSourceFile` throws → log + skip that file, continue.
+// Files larger than MAX_FILE_BYTES are filtered out before being passed to
+// ts-morph (consistency with the tree-sitter guardrail).
+import path from "node:path";
+import { ModuleKind, ModuleResolutionKind, Project, ScriptTarget, SyntaxKind, } from "ts-morph";
+import { MAX_FILE_BYTES } from "../input/path-selector.js";
+const TS_JS_LANGS = new Set(["typescript", "tsx", "javascript", "jsx"]);
+function isTsJsFile(file) {
+    return TS_JS_LANGS.has(file.language);
+}
+function relPath(absPath, rootDir) {
+    const r = path.relative(rootDir, absPath);
+    return r === "" ? path.basename(absPath) : r;
+}
+// Collapse the callee expression of a CallExpression to a single name.
+//   foo()                  → "foo"
+//   obj.method()           → "method"
+//   pkg.sub.fn()           → "fn"
+//   (x as T).fn()          → null (skipped — non-identifier-rooted)
+//   arr[0]()               → null (computed)
+//   foo()()                → null (call result)
+function calleeName(call) {
+    const expr = call.getExpression();
+    if (expr.getKind() === SyntaxKind.Identifier) {
+        return expr.getText();
+    }
+    if (expr.getKind() === SyntaxKind.PropertyAccessExpression) {
+        const prop = expr.asKindOrThrow(SyntaxKind.PropertyAccessExpression);
+        return prop.getName();
+    }
+    return null;
+}
+function collectExportedFunctions(source) {
+    const out = [];
+    for (const fn of source.getFunctions()) {
+        if (!fn.isExported())
+            continue;
+        const name = fn.getName();
+        if (name)
+            out.push({ name, node: fn });
+    }
+    for (const v of source.getVariableStatements()) {
+        if (!v.isExported())
+            continue;
+        for (const decl of v.getDeclarations()) {
+            const init = decl.getInitializer();
+            if (!init)
+                continue;
+            const k = init.getKind();
+            if (k === SyntaxKind.ArrowFunction || k === SyntaxKind.FunctionExpression) {
+                out.push({ name: decl.getName(), node: init });
+            }
+        }
+    }
+    return out;
+}
+export function analyzeTsMorph(files, rootDir) {
+    const candidates = files.filter((f) => {
+        if (!isTsJsFile(f))
+            return false;
+        if (f.size > MAX_FILE_BYTES) {
+            console.warn(`mochi: ts-morph skipping ${f.path} (too-large; size=${f.size})`);
+            return false;
+        }
+        return true;
+    });
+    if (candidates.length === 0)
+        return null;
+    let project;
+    try {
+        project = new Project({
+            useInMemoryFileSystem: false,
+            skipAddingFilesFromTsConfig: true,
+            compilerOptions: {
+                allowJs: true,
+                noEmit: true,
+                target: ScriptTarget.ES2022,
+                module: ModuleKind.ESNext,
+                moduleResolution: ModuleResolutionKind.NodeNext,
+                baseUrl: rootDir,
+            },
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`mochi: ts-morph Project construction failed: ${msg}`);
+        return null;
+    }
+    const sourceFiles = [];
+    for (const file of candidates) {
+        const abs = path.isAbsolute(file.path) ? file.path : path.join(rootDir, file.path);
+        try {
+            const sf = project.createSourceFile(abs, file.content, { overwrite: true });
+            sourceFiles.push(sf);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`mochi: ts-morph skipping ${file.path} (createSourceFile: ${msg})`);
+        }
+    }
+    const imports = [];
+    const callHierarchy = [];
+    for (const source of sourceFiles) {
+        const fromFile = relPath(source.getFilePath(), rootDir);
+        for (const decl of source.getImportDeclarations()) {
+            const specifier = decl.getModuleSpecifierValue();
+            const resolved = decl.getModuleSpecifierSourceFile();
+            const resolvedPath = resolved
+                ? relPath(resolved.getFilePath(), rootDir)
+                : null;
+            imports.push({ fromFile, specifier, resolvedPath });
+        }
+        for (const { name, node } of collectExportedFunctions(source)) {
+            const calls = node.getDescendantsOfKind(SyntaxKind.CallExpression);
+            for (const call of calls) {
+                const toName = calleeName(call);
+                if (toName === null)
+                    continue;
+                callHierarchy.push({ fromFile, fromFunction: name, toName });
+            }
+        }
+    }
+    return { callHierarchy, imports };
+}
+//# sourceMappingURL=ts-morph.js.map

package/dist/server/analysis/ts-morph.js.map

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

package/dist/server/analysis/types.d.ts

@@ -0,0 +1,7 @@
+export interface FileEntry {
+    path: string;
+    content: string;
+    language: string;
+    size: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/analysis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../server/analysis/types.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/server/analysis/types.js

@@ -0,0 +1,9 @@
+// Shared internal types for the analysis layer. Kept in a leaf module so
+// each analyzer can import without pulling in the orchestrator (which would
+// create an import cycle).
+//
+// `FileEntry` mirrors the per-file element of `AnalysisContext.files` in
+// `shared/analysis-schema.ts`. It is re-exported from `./index.ts` as the
+// public API for peer tasks (m2 diagram-generate).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/analysis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../server/analysis/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,mDAAmD"}

package/dist/server/api.d.ts

@@ -0,0 +1,14 @@
+import { Router, type RequestHandler } from "express";
+export declare const EXT_TO_LANG: Record<string, string>;
+export declare function languageFor(ext: string): string;
+export declare function resolveContainedPath(realRoot: string, rel: string): Promise<string | null>;
+export interface ApiRouterOptions {
+    root: string;
+    files: string[];
+    diagramHandler?: RequestHandler;
+}
+export interface ApiRouterHandle {
+    router: Router;
+}
+export declare function createApiRouter(opts: ApiRouterOptions): ApiRouterHandle;
+//# sourceMappingURL=api.d.ts.map

package/dist/server/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../server/api.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAEN,KAAK,cAAc,EAEpB,MAAM,SAAS,CAAC;AAKjB,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqB9C,CAAC;AAEF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAMD,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAiBD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IAGb,KAAK,EAAE,MAAM,EAAE,CAAC;IAGhB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CA8EvE"}

package/dist/server/api.js

@@ -0,0 +1,121 @@
+import { Router, } from "express";
+import { realpath, readFile, stat } from "node:fs/promises";
+import path from "node:path";
+import { MAX_FILE_BYTES } from "./input/path-selector.js";
+export const EXT_TO_LANG = {
+    ".ts": "typescript",
+    ".tsx": "tsx",
+    ".js": "javascript",
+    ".mjs": "javascript",
+    ".cjs": "javascript",
+    ".jsx": "jsx",
+    ".py": "python",
+    ".go": "go",
+    ".rs": "rust",
+    ".java": "java",
+    ".rb": "ruby",
+    ".md": "markdown",
+    ".json": "json",
+    ".yaml": "yaml",
+    ".yml": "yaml",
+    ".html": "html",
+    ".css": "css",
+    ".scss": "scss",
+    ".sh": "bash",
+    ".toml": "toml",
+};
+export function languageFor(ext) {
+    return EXT_TO_LANG[ext.toLowerCase()] ?? "plaintext";
+}
+// Resolves `rel` against `realRoot` and returns the realpath only if it
+// stays inside `realRoot` after symlink resolution. Returns null on
+// containment failure, missing file, or any realpath error. `realRoot`
+// must already be a realpath (caller handles the one-time root resolution).
+export async function resolveContainedPath(realRoot, rel) {
+    const requested = path.resolve(realRoot, rel);
+    const lexContained = requested === realRoot || requested.startsWith(realRoot + path.sep);
+    if (!lexContained)
+        return null;
+    try {
+        const real = await realpath(requested);
+        const realContained = real === realRoot || real.startsWith(realRoot + path.sep);
+        return realContained ? real : null;
+    }
+    catch {
+        return null;
+    }
+}
+function sendErr(res, status, error, message) {
+    res.status(status).json({ error, message });
+}
+function asyncHandler(fn) {
+    return (req, res) => {
+        fn(req, res).catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            sendErr(res, 500, "internal-error", msg);
+        });
+    };
+}
+export function createApiRouter(opts) {
+    const { root, files, diagramHandler } = opts;
+    const router = Router();
+    let cachedRealRoot = null;
+    async function getRealRoot() {
+        if (cachedRealRoot === null) {
+            cachedRealRoot = await realpath(root);
+        }
+        return cachedRealRoot;
+    }
+    router.get("/files", asyncHandler(async (req, res) => {
+        const raw = req.query.path;
+        // No `?path=` → list mode. Return the boot-time file index. Replaces
+        // miso's separate /tree route; t4 (web-shell) calls this for the
+        // sidebar.
+        if (raw === undefined) {
+            res.json({ files });
+            return;
+        }
+        if (typeof raw !== "string" || raw.length === 0) {
+            return sendErr(res, 400, "bad-path", "query param 'path' must be a non-empty string");
+        }
+        const realRoot = await getRealRoot();
+        const real = await resolveContainedPath(realRoot, raw);
+        if (real === null) {
+            // Distinguish missing vs traversal so the UI can show a sensible
+            // message. Re-do a lexical-only check to tell them apart.
+            const requested = path.resolve(realRoot, raw);
+            const lexContained = requested === realRoot || requested.startsWith(realRoot + path.sep);
+            if (!lexContained) {
+                return sendErr(res, 400, "path-traversal", "path escapes the selected root");
+            }
+            return sendErr(res, 404, "not-found", "file not found: " + raw);
+        }
+        const st = await stat(real);
+        if (!st.isFile()) {
+            return sendErr(res, 400, "not-a-file", "path is not a file: " + raw);
+        }
+        if (st.size > MAX_FILE_BYTES) {
+            return sendErr(res, 413, "file-too-large", "file exceeds " + MAX_FILE_BYTES + " bytes");
+        }
+        const content = await readFile(real, "utf8");
+        const language = languageFor(path.extname(real));
+        res.json({ path: raw, content, language });
+    }));
+    // /api/diagram — POST and GET both supported. POST is the recommended form
+    // (scope can be large); GET satisfies the curl verify command in the
+    // milestone manifest. When no handler is wired, return 503 so callers see a
+    // clear "this build was started without diagram support" message.
+    if (diagramHandler) {
+        router.post("/diagram", diagramHandler);
+        router.get("/diagram", diagramHandler);
+    }
+    else {
+        const stub = (_req, res) => {
+            sendErr(res, 503, "diagram-disabled", "diagram endpoint not configured (server started without diagram support)");
+        };
+        router.post("/diagram", stub);
+        router.get("/diagram", stub);
+    }
+    return { router };
+}
+//# sourceMappingURL=api.js.map

package/dist/server/api.js.map

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

package/dist/server/diagram/cache.d.ts

@@ -0,0 +1,23 @@
+import { type DiagramSpec } from "../../shared/diagram-spec.js";
+export interface CacheKeyArgs {
+    files: {
+        path: string;
+        content: string;
+    }[];
+    intent?: string;
+    model: string;
+    prompt_version: string;
+}
+export interface DiagramCache {
+    get(key: string): Promise<DiagramSpec | null>;
+    put(key: string, spec: DiagramSpec): Promise<void>;
+    readonly dir: string;
+    readonly disabled: boolean;
+}
+export interface CreateDiagramCacheOptions {
+    dir?: string;
+}
+export declare function defaultCacheDir(): string;
+export declare function makeCacheKey(args: CacheKeyArgs): string;
+export declare function createDiagramCache(opts?: CreateDiagramCacheOptions): DiagramCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/server/diagram/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../server/diagram/cache.ts"],"names":[],"mappings":"AA8BA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAID,wBAAgB,eAAe,IAAI,MAAM,CAWxC;AAMD,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAiBvD;AAiBD,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,yBAA8B,GACnC,YAAY,CAsGd"}