@sirius-mcp/mcp 1.4.0

package/dist/adapters/fs/config.d.ts

@@ -0,0 +1,6 @@
+export declare const CONTEXT_DIR = ".context";
+export declare const CONFIG_FILE = "context.config.yaml";
+export declare function projectConfigPath(root: string): string;
+export declare function readProjectConfig(root: string): Promise<string | null>;
+export declare function writeProjectConfig(root: string, content: string): Promise<void>;
+//# sourceMappingURL=config.d.ts.map

package/dist/adapters/fs/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,eAAO,MAAM,WAAW,wBAAwB,CAAC;AAEjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU5E;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/adapters/fs/config.js

@@ -0,0 +1,30 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { atomicWriteFile } from "./atomic.js";
+export const CONTEXT_DIR = ".context";
+export const CONFIG_FILE = "context.config.yaml";
+export function projectConfigPath(root) {
+    return resolve(root, CONTEXT_DIR, CONFIG_FILE);
+}
+export async function readProjectConfig(root) {
+    const path = projectConfigPath(root);
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (isENOENT(err)) {
+            return null;
+        }
+        throw err;
+    }
+}
+export async function writeProjectConfig(root, content) {
+    await atomicWriteFile(projectConfigPath(root), content);
+}
+function isENOENT(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+//# sourceMappingURL=config.js.map

package/dist/adapters/fs/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/adapters/fs/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAY,EACZ,OAAe;IAEf,MAAM,eAAe,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,GAAY;IAC5B,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,MAAM,IAAI,GAAG;QACZ,GAA6B,CAAC,IAAI,KAAK,QAAQ,CACjD,CAAC;AACJ,CAAC"}

package/dist/adapters/fs/container-mounts.d.ts

@@ -0,0 +1,4 @@
+export declare function parseContainerMountRoots(content: string): string[];
+export declare function isInsideContainerMount(absPath: string): boolean;
+export declare function isPathUnderMounts(absPath: string, roots: string[]): boolean;
+//# sourceMappingURL=container-mounts.d.ts.map

package/dist/adapters/fs/container-mounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-mounts.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/container-mounts.ts"],"names":[],"mappings":"AAWA,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBlE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAY/D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAM3E"}

package/dist/adapters/fs/container-mounts.js

@@ -0,0 +1,51 @@
+import { readFileSync } from "node:fs";
+// Mount detection for container absolute crawl paths (DT-F2-8, G2-4).
+// Validated 2026-08-18 in the release pipeline: Docker Desktop reports bind
+// mounts with Windows-style devices (e.g. "C:\134" via 9p/drvfs, matched by
+// the /^[A-Za-z]:/ rule); GitHub-hosted runners (Linux host, docker run)
+// report the host disk device "/dev/sdXX" (matched by the /dev/ rule).
+// If a future runner reports neither pattern, the documented remedy is an
+// env override (e.g. SIRIUS_EXTRA_MOUNT_ROOTS, csv) appended to the parsed
+// roots — to be implemented only when such evidence appears.
+export function parseContainerMountRoots(content) {
+    const roots = [];
+    for (const line of content.split("\n")) {
+        const fields = line.split(/\s+/);
+        if (fields.length < 2) {
+            continue;
+        }
+        const device = fields[0];
+        const mountPoint = fields[1].replace(/\\040/g, " ").replace(/\\011/g, "\t");
+        if (mountPoint === "/") {
+            continue;
+        }
+        const isVolume = device.startsWith("/dev/") || /^[A-Za-z]:/.test(device);
+        if (!isVolume) {
+            continue;
+        }
+        roots.push(mountPoint);
+    }
+    return roots.sort((a, b) => b.length - a.length);
+}
+export function isInsideContainerMount(absPath) {
+    let mounts;
+    try {
+        mounts = readFileSync("/proc/mounts", "utf8");
+    }
+    catch {
+        return false;
+    }
+    const roots = parseContainerMountRoots(mounts);
+    if (roots.length === 0) {
+        return false;
+    }
+    return isPathUnderMounts(absPath, roots);
+}
+export function isPathUnderMounts(absPath, roots) {
+    const normalized = absPath.replace(/\\/g, "/");
+    return roots.some((root) => {
+        const prefix = root.endsWith("/") ? root : `${root}/`;
+        return normalized === root || normalized.startsWith(prefix);
+    });
+}
+//# sourceMappingURL=container-mounts.js.map

package/dist/adapters/fs/container-mounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-mounts.js","sourceRoot":"","sources":["../../../src/adapters/fs/container-mounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,sEAAsE;AACtE,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,uEAAuE;AACvE,0EAA0E;AAC1E,2EAA2E;AAC3E,6DAA6D;AAE7D,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5E,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,KAAe;IAChE,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;QACtD,OAAO,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/adapters/fs/source-scan.d.ts

@@ -0,0 +1,16 @@
+import { type McpError } from "../../errors.js";
+export declare const DEFAULT_CRAWL_MAX_FILE_BYTES = 1048576;
+export type SourcePathValidation = {
+    success: true;
+    sourceRoot: string;
+} | {
+    success: false;
+    error: McpError;
+};
+export declare function invalidPathError(path: string, message: string): McpError;
+export declare function validateCrawlSourcePath(input: {
+    projectRoot: string;
+    inputPath: string;
+    isContainer: boolean;
+}): Promise<SourcePathValidation>;
+//# sourceMappingURL=source-scan.d.ts.map

package/dist/adapters/fs/source-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-scan.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/source-scan.ts"],"names":[],"mappings":"AAGA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAI1D,eAAO,MAAM,4BAA4B,UAAU,CAAC;AAEpD,MAAM,MAAM,oBAAoB,GAC5B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAExC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAExE;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAsBhC"}

package/dist/adapters/fs/source-scan.js

@@ -0,0 +1,118 @@
+import { realpath } from "node:fs/promises";
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
+import { mcpError } from "../../errors.js";
+import { isInsideContainerMount } from "./container-mounts.js";
+import { isWithin } from "./source-walk.js";
+export const DEFAULT_CRAWL_MAX_FILE_BYTES = 1048576;
+export function invalidPathError(path, message) {
+    return mcpError("INVALID_PATH", message, { path });
+}
+export async function validateCrawlSourcePath(input) {
+    const { projectRoot, inputPath, isContainer } = input;
+    const trimmed = inputPath.trim();
+    if (trimmed.length === 0) {
+        return {
+            success: false,
+            error: invalidPathError(inputPath, "Crawl path is empty."),
+        };
+    }
+    if (trimmed.split(/[\\/]+/).includes("..")) {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Crawl path must not contain '..' segments."),
+        };
+    }
+    if (isAbsolute(trimmed)) {
+        return validateContainerAbsolutePath(trimmed, isContainer);
+    }
+    return validateRelativeSource(projectRoot, trimmed);
+}
+async function validateRelativeSource(projectRoot, trimmed) {
+    const resolved = resolve(projectRoot, trimmed);
+    const rel = relative(projectRoot, resolved);
+    if (rel === "") {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Self-ingestion is not allowed: crawl path must not be the project root."),
+        };
+    }
+    if (rel.startsWith("..") || isAbsolute(rel)) {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Crawl path escapes the project root or crosses drives."),
+        };
+    }
+    if (!isDirectorySync(resolved)) {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Crawl path does not exist or is not a directory."),
+        };
+    }
+    const realRoot = await safeRealpath(projectRoot);
+    const realSource = await safeRealpath(resolved);
+    if (!realRoot || !realSource) {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Crawl path does not exist or is not a directory."),
+        };
+    }
+    if (!isWithin(realRoot, realSource)) {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Crawl path resolves outside the project root."),
+        };
+    }
+    if (existsSync(resolve(realSource, ".context"))) {
+        return {
+            success: false,
+            error: invalidPathError(trimmed, "Self-ingestion is not allowed: crawl path contains a .context store."),
+        };
+    }
+    return { success: true, sourceRoot: realSource };
+}
+async function validateContainerAbsolutePath(path, isContainer) {
+    if (!isContainer) {
+        return {
+            success: false,
+            error: invalidPathError(path, "Absolute crawl paths are only allowed inside the container (bind-mounted volumes)."),
+        };
+    }
+    if (!isDirectorySync(path)) {
+        return {
+            success: false,
+            error: invalidPathError(path, "Crawl path does not exist or is not a directory."),
+        };
+    }
+    if (!isInsideContainerMount(path)) {
+        return {
+            success: false,
+            error: invalidPathError(path, "Absolute crawl path must point inside a bind-mounted volume."),
+        };
+    }
+    const real = await safeRealpath(path);
+    if (!real || !isInsideContainerMount(real)) {
+        return {
+            success: false,
+            error: invalidPathError(path, "Absolute crawl path resolves outside a bind-mounted volume."),
+        };
+    }
+    return { success: true, sourceRoot: real };
+}
+async function safeRealpath(path) {
+    try {
+        return await realpath(path);
+    }
+    catch {
+        return null;
+    }
+}
+function isDirectorySync(path) {
+    try {
+        return statSync(path).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=source-scan.js.map

package/dist/adapters/fs/source-scan.js.map

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

package/dist/adapters/fs/source-walk.d.ts

@@ -0,0 +1,16 @@
+import type { CrawlFileContext, ProjectHints } from "../../domain/source-adapter.js";
+export interface SourceScanOptions {
+    maxFileBytes: number;
+}
+export interface SourceScanFailure {
+    path: string;
+    reason: string;
+}
+export interface SourceScanResult {
+    contexts: CrawlFileContext[];
+    failures: SourceScanFailure[];
+    projectHints: ProjectHints;
+}
+export declare function scanSourceTree(sourceRoot: string, options: SourceScanOptions): Promise<SourceScanResult>;
+export declare function isWithin(root: string, target: string): boolean;
+//# sourceMappingURL=source-walk.d.ts.map

package/dist/adapters/fs/source-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-walk.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/source-walk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,gCAAgC,CAAC;AAKxC,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9D"}

package/dist/adapters/fs/source-walk.js

@@ -0,0 +1,195 @@
+import { readdir, readFile, realpath, stat } from "node:fs/promises";
+import { basename, extname, isAbsolute, join, relative } from "node:path";
+const EXCLUDED_DIRS = new Set([".git", "node_modules", ".context"]);
+const BINARY_PROBE_BYTES = 8000;
+export async function scanSourceTree(sourceRoot, options) {
+    const projectHints = await detectProjectHints(sourceRoot);
+    const contexts = [];
+    const failures = [];
+    const visited = new Set();
+    await walkDirectory(sourceRoot, sourceRoot, options, projectHints, contexts, failures, visited);
+    contexts.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    return { contexts, failures, projectHints };
+}
+export function isWithin(root, target) {
+    const rel = relative(root, target);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+async function walkDirectory(root, dir, options, hints, contexts, failures, visited) {
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch (err) {
+        if (!isENOENT(err)) {
+            failures.push({
+                path: dirRelativePath(root, dir),
+                reason: `Could not read directory: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+        return;
+    }
+    entries.sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (!EXCLUDED_DIRS.has(entry.name.toLowerCase())) {
+                await walkDirectory(root, full, options, hints, contexts, failures, visited);
+            }
+            continue;
+        }
+        if (entry.isSymbolicLink()) {
+            await walkSymlink(root, full, options, hints, contexts, failures, visited);
+            continue;
+        }
+        const info = await safeStat(full);
+        if (info && info.isFile()) {
+            await collectFile(root, full, info, options, hints, contexts, failures);
+        }
+    }
+}
+async function walkSymlink(root, linkPath, options, hints, contexts, failures, visited) {
+    let target;
+    try {
+        target = await realpath(linkPath);
+    }
+    catch {
+        return;
+    }
+    if (!isWithin(root, target)) {
+        return;
+    }
+    const info = await safeStat(target);
+    if (!info) {
+        return;
+    }
+    if (info.isDirectory()) {
+        if (visited.has(target)) {
+            return;
+        }
+        visited.add(target);
+        await walkDirectory(root, target, options, hints, contexts, failures, visited);
+    }
+    else if (info.isFile()) {
+        await collectSymlinkedFile(root, linkPath, info, options, hints, contexts, failures);
+    }
+}
+async function collectSymlinkedFile(root, linkPath, info, options, hints, contexts, failures) {
+    const rel = toRelativePath(root, linkPath);
+    if (info.size > options.maxFileBytes) {
+        return;
+    }
+    let content;
+    try {
+        content = await readFile(linkPath, "utf8");
+    }
+    catch (err) {
+        failures.push({
+            path: rel,
+            reason: `Could not read file: ${err instanceof Error ? err.message : String(err)}`,
+        });
+        return;
+    }
+    if (content.slice(0, BINARY_PROBE_BYTES).includes("\u0000")) {
+        return;
+    }
+    contexts.push({
+        relativePath: rel,
+        absolutePath: linkPath,
+        fileName: basename(linkPath),
+        ext: extname(linkPath).toLowerCase(),
+        content,
+        mtime: info.mtime,
+        projectHints: hints,
+    });
+}
+async function collectFile(root, full, info, options, hints, contexts, failures) {
+    const rel = toRelativePath(root, full);
+    if (info.size > options.maxFileBytes) {
+        return;
+    }
+    let content;
+    try {
+        content = await readFile(full, "utf8");
+    }
+    catch (err) {
+        failures.push({
+            path: rel,
+            reason: `Could not read file: ${err instanceof Error ? err.message : String(err)}`,
+        });
+        return;
+    }
+    if (content.slice(0, BINARY_PROBE_BYTES).includes("\u0000")) {
+        return;
+    }
+    contexts.push({
+        relativePath: rel,
+        absolutePath: full,
+        fileName: basename(full),
+        ext: extname(full).toLowerCase(),
+        content,
+        mtime: info.mtime,
+        projectHints: hints,
+    });
+}
+async function detectProjectHints(sourceRoot) {
+    const manifests = [];
+    let entries;
+    try {
+        entries = await readdir(sourceRoot, { withFileTypes: true });
+    }
+    catch {
+        return { name: basename(sourceRoot), manifests };
+    }
+    for (const entry of entries) {
+        if (entry.isFile() && isManifestName(entry.name)) {
+            manifests.push(entry.name);
+        }
+    }
+    manifests.sort();
+    return { name: basename(sourceRoot), manifests };
+}
+const EXACT_MANIFEST_NAMES = new Set([
+    "package.json",
+    "pom.xml",
+    "build.gradle",
+    "build.gradle.kts",
+    "settings.gradle",
+    "settings.gradle.kts",
+    "pyproject.toml",
+    "setup.py",
+    "setup.cfg",
+    "requirements.txt",
+    "pipfile",
+    "go.mod",
+    "go.work",
+    "cargo.toml",
+]);
+function isManifestName(name) {
+    const lower = name.toLowerCase();
+    return (EXACT_MANIFEST_NAMES.has(lower) ||
+        lower.endsWith(".csproj") ||
+        lower.endsWith(".sln"));
+}
+async function safeStat(path) {
+    try {
+        return await stat(path);
+    }
+    catch {
+        return null;
+    }
+}
+function dirRelativePath(root, dir) {
+    const rel = relative(root, dir).replace(/\\/g, "/");
+    return rel === "" ? "." : rel;
+}
+function isENOENT(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+function toRelativePath(root, full) {
+    return relative(root, full).replace(/\\/g, "/");
+}
+//# sourceMappingURL=source-walk.js.map

package/dist/adapters/fs/source-walk.js.map

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

package/dist/adapters/fs/structure.d.ts

@@ -0,0 +1,22 @@
+export declare const DocumentTypes: readonly ["feature", "business-rule", "decision", "component", "architecture"];
+export type DocumentType = (typeof DocumentTypes)[number];
+export interface DocumentListItem {
+    id: string;
+    type: DocumentType;
+    title?: string;
+    status?: string;
+    path: string;
+    warning?: string;
+}
+export interface ListDocumentFilters {
+    type?: DocumentType;
+    status?: string;
+    pathPrefix?: string;
+}
+export declare function documentPath(root: string, type: DocumentType, id: string): string;
+export declare function writeDocument(root: string, type: DocumentType, id: string, content: string): Promise<void>;
+export declare function createDocumentExclusive(root: string, type: DocumentType, id: string, content: string): Promise<"created" | "exists">;
+export declare function readDocumentByPath(path: string): Promise<string | null>;
+export declare function ensureContextStructure(root: string, configYaml: string): Promise<void>;
+export declare function listDocumentFiles(root: string, filters?: ListDocumentFilters): Promise<DocumentListItem[]>;
+//# sourceMappingURL=structure.d.ts.map

package/dist/adapters/fs/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/adapters/fs/structure.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,aAAa,gFAMhB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,GACT,MAAM,CAER;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,EAClB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,CAoB/B;AAWD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS7E;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA2B7B"}

package/dist/adapters/fs/structure.js

@@ -0,0 +1,146 @@
+import { mkdir, open, readdir, readFile } from "node:fs/promises";
+import { resolve, join, parse } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { writeProjectConfig } from "./config.js";
+import { atomicWriteFile } from "./atomic.js";
+export const DocumentTypes = [
+    "feature",
+    "business-rule",
+    "decision",
+    "component",
+    "architecture",
+];
+export function documentPath(root, type, id) {
+    return resolve(root, ".context", type, `${id}.md`);
+}
+export async function writeDocument(root, type, id, content) {
+    const target = documentPath(root, type, id);
+    const dir = resolve(target, "..");
+    await mkdir(dir, { recursive: true });
+    await atomicWriteFile(target, content);
+}
+export async function createDocumentExclusive(root, type, id, content) {
+    const target = documentPath(root, type, id);
+    const dir = resolve(target, "..");
+    await mkdir(dir, { recursive: true });
+    let handle;
+    try {
+        handle = await open(target, "wx");
+    }
+    catch (err) {
+        if (isEEXIST(err)) {
+            return "exists";
+        }
+        throw err;
+    }
+    try {
+        await handle.writeFile(content, "utf8");
+        return "created";
+    }
+    finally {
+        await handle.close();
+    }
+}
+function isEEXIST(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "EEXIST");
+}
+export async function readDocumentByPath(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (err) {
+        if (isENOENT(err)) {
+            return null;
+        }
+        throw err;
+    }
+}
+export async function ensureContextStructure(root, configYaml) {
+    const contextRoot = resolve(root, ".context");
+    await mkdir(contextRoot, { recursive: true });
+    for (const type of DocumentTypes) {
+        await mkdir(join(contextRoot, type), { recursive: true });
+    }
+    await mkdir(join(contextRoot, ".index"), { recursive: true });
+    await writeProjectConfig(root, configYaml);
+    await atomicWriteFile(join(contextRoot, ".index", ".gitignore"), "# Sirius index artifacts\nsirius.db\nsirius.db-wal\nsirius.db-shm\n");
+}
+export async function listDocumentFiles(root, filters) {
+    const contextRoot = resolve(root, ".context");
+    const items = [];
+    const typesToScan = filters?.type ? [filters.type] : DocumentTypes;
+    for (const type of typesToScan) {
+        const dir = join(contextRoot, type);
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch (err) {
+            if (isENOENT(err)) {
+                continue;
+            }
+            throw err;
+        }
+        for (const entry of entries) {
+            const item = await toDocumentListItem(type, dir, entry, filters);
+            if (item) {
+                items.push(item);
+            }
+        }
+    }
+    return items;
+}
+async function toDocumentListItem(type, dir, entry, filters) {
+    if (!entry.endsWith(".md")) {
+        return null;
+    }
+    const filePath = join(dir, entry);
+    const id = parse(entry).name;
+    const displayPath = `.context/${type}/${id}.md`;
+    const normalizedPrefix = filters?.pathPrefix?.replace(/\\/g, "/");
+    if (normalizedPrefix && !displayPath.startsWith(normalizedPrefix)) {
+        return null;
+    }
+    const frontmatter = await readDocumentFrontmatter(filePath);
+    if (filters?.status && frontmatter?.status !== filters.status) {
+        return null;
+    }
+    return buildListItem(id, type, displayPath, frontmatter);
+}
+function buildListItem(id, type, displayPath, frontmatter) {
+    const title = typeof frontmatter?.title === "string" ? frontmatter.title : undefined;
+    const status = typeof frontmatter?.status === "string" ? frontmatter.status : undefined;
+    return {
+        id,
+        type,
+        title,
+        status,
+        path: displayPath,
+        warning: frontmatter === null
+            ? `Could not parse frontmatter in ${displayPath}; skipping metadata.`
+            : undefined,
+    };
+}
+async function readDocumentFrontmatter(filePath) {
+    try {
+        const content = await readFile(filePath, "utf8");
+        const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
+        if (!match) {
+            return null;
+        }
+        return parseYaml(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+function isENOENT(err) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === "ENOENT");
+}
+//# sourceMappingURL=structure.js.map