@sirius-mcp/mcp 1.4.0

package/dist/domain/index-writer.js

@@ -0,0 +1,203 @@
+import {} from "./index.js";
+const defaultScheduler = {
+    yield: () => new Promise((resolve) => setTimeout(resolve, 0)),
+};
+export class IndexWriteQueue {
+    indexPort;
+    scheduler;
+    now;
+    bulkChunkSize;
+    interactive = [];
+    bulk = [];
+    rebuildPending = null;
+    running = false;
+    idleResolvers = [];
+    writeWarnings = [];
+    lastWriteAtValue = null;
+    constructor(indexPort, scheduler = defaultScheduler, now = () => new Date(), bulkChunkSize = 20) {
+        this.indexPort = indexPort;
+        this.scheduler = scheduler;
+        this.now = now;
+        this.bulkChunkSize = bulkChunkSize;
+    }
+    upsert(doc) {
+        return this.enqueueTask({ kind: "upsert", lane: "interactive", doc });
+    }
+    upsertBulk(doc) {
+        return this.enqueueTask({ kind: "upsert", lane: "bulk", doc });
+    }
+    remove(type, id) {
+        return this.enqueueTask({
+            kind: "remove",
+            lane: "interactive",
+            type,
+            id,
+            path: `.context/${type}/${id}.md`,
+        });
+    }
+    rebuild(docs) {
+        const resolvers = [];
+        const outcome = new Promise((resolve) => {
+            resolvers.push(resolve);
+        });
+        if (this.rebuildPending) {
+            for (const r of this.rebuildPending.resolvers) {
+                r({ ok: true });
+            }
+        }
+        this.rebuildPending = { docs, resolvers };
+        const discarded = [...this.interactive, ...this.bulk];
+        this.interactive = [];
+        this.bulk = [];
+        for (const task of discarded) {
+            this.resolveAll(task, { ok: false, reason: "discarded" });
+            this.writeWarnings.push({
+                path: task.path,
+                reason: "Discarded by rebuild",
+            });
+        }
+        void this.pump();
+        return outcome;
+    }
+    idle() {
+        if (!this.running && !this.hasWork()) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            this.idleResolvers.push(resolve);
+        });
+    }
+    isOpen() {
+        return this.indexPort.isOpen();
+    }
+    status() {
+        return {
+            pendingWrites: this.interactive.length + this.bulk.length + (this.rebuildPending ? 1 : 0),
+            lastWriteAt: this.lastWriteAtValue,
+            warnings: [...this.writeWarnings],
+        };
+    }
+    takeWarnings() {
+        return this.writeWarnings.splice(0);
+    }
+    enqueueTask(init) {
+        const queue = init.lane === "interactive" ? this.interactive : this.bulk;
+        const resolvers = [];
+        const outcome = new Promise((resolve) => {
+            resolvers.push(resolve);
+        });
+        const task = {
+            kind: init.kind,
+            lane: init.lane,
+            doc: init.doc,
+            type: init.type ?? init.doc?.type,
+            id: init.id ?? init.doc?.id,
+            path: init.path ?? (init.doc ? init.doc.path : ""),
+            resolvers,
+        };
+        const coalesceIndex = findCoalescable(queue, task);
+        if (coalesceIndex >= 0) {
+            task.resolvers.push(...queue[coalesceIndex].resolvers);
+            queue[coalesceIndex] = task;
+        }
+        else {
+            queue.push(task);
+        }
+        void this.pump();
+        return outcome;
+    }
+    hasWork() {
+        return (this.rebuildPending !== null || this.interactive.length > 0 || this.bulk.length > 0);
+    }
+    async pump() {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        try {
+            while (this.hasWork()) {
+                await this.scheduler.yield();
+                this.processNextBatch();
+            }
+        }
+        finally {
+            this.running = false;
+            const resolvers = this.idleResolvers.splice(0);
+            for (const resolve of resolvers) {
+                resolve();
+            }
+        }
+    }
+    processNextBatch() {
+        if (this.rebuildPending) {
+            this.runRebuild();
+            return;
+        }
+        if (this.interactive.length > 0) {
+            const batch = this.interactive.splice(0);
+            for (const task of batch) {
+                this.runTask(task);
+            }
+            return;
+        }
+        const chunk = this.bulk.splice(0, this.bulkChunkSize);
+        for (const task of chunk) {
+            this.runTask(task);
+        }
+    }
+    runTask(task) {
+        try {
+            if (task.kind === "upsert") {
+                this.indexPort.upsert(task.doc);
+            }
+            else {
+                this.indexPort.remove(task.type, task.id);
+            }
+            this.markWrite();
+            this.resolveAll(task, { ok: true });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            this.writeWarnings.push({ path: task.path, reason });
+            this.resolveAll(task, { ok: false, reason });
+        }
+    }
+    runRebuild() {
+        const pending = this.rebuildPending;
+        if (!pending) {
+            return;
+        }
+        this.rebuildPending = null;
+        try {
+            this.indexPort.rebuild(pending.docs);
+            this.markWrite();
+            for (const resolve of pending.resolvers) {
+                resolve({ ok: true });
+            }
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            this.writeWarnings.push({ path: ".context/", reason });
+            for (const resolve of pending.resolvers) {
+                resolve({ ok: false, reason });
+            }
+        }
+    }
+    resolveAll(task, outcome) {
+        for (const resolve of task.resolvers) {
+            resolve(outcome);
+        }
+    }
+    markWrite() {
+        this.lastWriteAtValue = this.now().toISOString();
+    }
+}
+function findCoalescable(queue, task) {
+    for (let i = queue.length - 1; i >= 0; i--) {
+        if (queue[i].type === task.type && queue[i].id === task.id) {
+            return i;
+        }
+    }
+    return -1;
+}
+//# sourceMappingURL=index-writer.js.map

package/dist/domain/index-writer.js.map

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

package/dist/domain/index.d.ts

@@ -0,0 +1,37 @@
+export interface IndexedDocument {
+    id: string;
+    type: string;
+    status: string;
+    title: string;
+    body: string;
+    path: string;
+}
+export interface SearchHit {
+    id: string;
+    type: string;
+    status: string;
+    title: string;
+    path: string;
+    snippet: string;
+}
+export interface IndexPort {
+    open(root: string): void;
+    close(): void;
+    isOpen(): boolean;
+    upsert(doc: IndexedDocument): void;
+    remove(type: string, id: string): void;
+    search(query: string, limit?: number): SearchHit[];
+    rebuild(docs: IndexedDocument[]): void;
+    needsRebuild(): boolean;
+}
+export interface IndexError {
+    code: string;
+    message: string;
+    cause?: unknown;
+}
+export declare class IndexAdapterError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(code: string, message: string, cause?: unknown | undefined);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,OAAO,CAAC;IAClB,MAAM,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACnD,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACvC,YAAY,IAAI,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,IAAI,EAAE,MAAM;aAEZ,KAAK,CAAC,EAAE,OAAO;gBAFf,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,OAAO,YAAA;CAKlC"}

package/dist/domain/index.js

@@ -0,0 +1,11 @@
+export class IndexAdapterError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "IndexAdapterError";
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAmCA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAExB;IAEA;IAHlB,YACkB,IAAY,EAC5B,OAAe,EACC,KAAe;QAE/B,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,UAAK,GAAL,KAAK,CAAU;QAG/B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/domain/license.d.ts

@@ -0,0 +1,32 @@
+export type LicenseState = "valid" | "grace" | "expired" | "revoked" | "missing" | "dev";
+export interface LicenseStatus {
+    state: LicenseState;
+    canWrite: boolean;
+    canRead: boolean;
+    lastValidatedAt?: string;
+    expiresAt?: string;
+    graceDaysRemaining?: number;
+    details?: Record<string, unknown>;
+}
+export interface LicensePort {
+    validate(): Promise<LicenseStatus> | LicenseStatus;
+    canWrite(): Promise<boolean> | boolean;
+    canRead(): Promise<boolean> | boolean;
+    status(): LicenseState;
+}
+export interface LicenseStateData {
+    licenseKey?: string;
+    state: LicenseState;
+    lastValidatedAt?: string;
+    expiresAt?: string;
+    graceDaysRemaining?: number;
+}
+export declare const devLicensePort: LicensePort;
+/**
+ * Alias for {@link devLicensePort}. The solo tier is the free default and is
+ * stateless: no license.json is written, no network calls are made, and all
+ * core tools are allowed.
+ */
+export declare const soloLicensePort: LicensePort;
+export declare function defaultLicenseStatePath(): string;
+//# sourceMappingURL=license.d.ts.map

package/dist/domain/license.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../../src/domain/license.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,OAAO,GACP,SAAS,GACT,SAAS,GACT,SAAS,GACT,KAAK,CAAC;AAEV,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;IACnD,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACvC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACtC,MAAM,IAAI,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,WAA4B,CAAC;AAE3D,wBAAgB,uBAAuB,IAAI,MAAM,CAQhD"}

package/dist/domain/license.js

@@ -0,0 +1,23 @@
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+export const devLicensePort = {
+    validate: () => ({ state: "dev", canWrite: true, canRead: true }),
+    canWrite: () => true,
+    canRead: () => true,
+    status: () => "dev",
+};
+/**
+ * Alias for {@link devLicensePort}. The solo tier is the free default and is
+ * stateless: no license.json is written, no network calls are made, and all
+ * core tools are allowed.
+ */
+export const soloLicensePort = devLicensePort;
+export function defaultLicenseStatePath() {
+    if (platform() === "win32") {
+        const appData = process.env.APPDATA ?? join(homedir(), "AppData", "Roaming");
+        return join(appData, "sirius", "license.json");
+    }
+    const xdg = process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
+    return join(xdg, "sirius", "license.json");
+}
+//# sourceMappingURL=license.js.map

package/dist/domain/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../../src/domain/license.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmCjC,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;IACnB,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgB,cAAc,CAAC;AAE3D,MAAM,UAAU,uBAAuB;IACrC,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,GACX,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC"}

package/dist/domain/source-adapter.d.ts

@@ -0,0 +1,31 @@
+import { type DocumentType } from "../schemas/document.js";
+export interface ProjectHints {
+    name: string;
+    manifests: string[];
+}
+export interface CrawlFileContext {
+    relativePath: string;
+    absolutePath: string;
+    fileName: string;
+    ext: string;
+    content: string;
+    mtime: Date;
+    projectHints: ProjectHints;
+}
+export interface MappedDocument {
+    type: DocumentType;
+    id: string;
+    title: string;
+    updated: string;
+    body: string;
+    code_refs?: string[];
+}
+export interface CrawlAdapter {
+    name: string;
+    map(context: CrawlFileContext): MappedDocument | null;
+}
+export declare function stableDocumentId(relativePath: string): string;
+export declare function mtimeToIsoDate(mtime: Date): string;
+export declare function titleFromMarkdown(content: string, fallback: string): string;
+export declare function mapMarkdownSource(context: CrawlFileContext, componentFallback: string): MappedDocument | null;
+//# sourceMappingURL=source-adapter.d.ts.map

package/dist/domain/source-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-adapter.d.ts","sourceRoot":"","sources":["../../src/domain/source-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,CAAC;IACZ,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,cAAc,GAAG,IAAI,CAAC;CACvD;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAKlD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO3E;AAgCD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,iBAAiB,EAAE,MAAM,GACxB,cAAc,GAAG,IAAI,CAoBvB"}

package/dist/domain/source-adapter.js

@@ -0,0 +1,70 @@
+import { basename, extname } from "node:path";
+import { createHash } from "node:crypto";
+import {} from "../schemas/document.js";
+export function stableDocumentId(relativePath) {
+    const normalized = relativePath.replace(/\\/g, "/");
+    const hash = createHash("sha256").update(normalized).digest("hex").slice(0, 6);
+    const stem = basename(normalized, extname(normalized))
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    const base = stem.length > 0 ? stem : "doc";
+    return `${base}-${hash}`;
+}
+export function mtimeToIsoDate(mtime) {
+    if (Number.isNaN(mtime.getTime())) {
+        return "1970-01-01";
+    }
+    return mtime.toISOString().slice(0, 10);
+}
+export function titleFromMarkdown(content, fallback) {
+    const match = /^#\s+(.+?)\s*$/m.exec(content);
+    const title = match?.[1]?.trim();
+    if (!title) {
+        return fallback;
+    }
+    return title.slice(0, 200);
+}
+const MARKDOWN_EXTENSIONS = new Set([".md", ".markdown"]);
+function isMarkdownFile(ext) {
+    return MARKDOWN_EXTENSIONS.has(ext.toLowerCase());
+}
+function resolveDocumentType(fileName, rel, ext) {
+    const isRoot = !rel.includes("/");
+    if (isRoot && /^readme(\.|$)/i.test(fileName)) {
+        return "component";
+    }
+    if (isRoot && /^architecture(\.|$)/i.test(fileName)) {
+        return "architecture";
+    }
+    if (!isMarkdownFile(ext)) {
+        return null;
+    }
+    if (rel.startsWith("docs/architecture/") || rel.startsWith("docs/arch/")) {
+        return "architecture";
+    }
+    if (rel.startsWith("docs/")) {
+        return "feature";
+    }
+    return null;
+}
+export function mapMarkdownSource(context, componentFallback) {
+    const rel = context.relativePath.replace(/\\/g, "/");
+    const type = resolveDocumentType(context.fileName, rel, context.ext);
+    if (!type) {
+        return null;
+    }
+    const isRootReadme = type === "component" && !rel.includes("/");
+    const fallback = isRootReadme
+        ? componentFallback
+        : context.fileName.replace(/\.[^.]+$/, "");
+    return {
+        type,
+        id: stableDocumentId(rel),
+        title: titleFromMarkdown(context.content, fallback),
+        updated: mtimeToIsoDate(context.mtime),
+        body: context.content,
+        code_refs: [rel],
+    };
+}
+//# sourceMappingURL=source-adapter.js.map

package/dist/domain/source-adapter.js.map

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

package/dist/domain/watch-config.d.ts

@@ -0,0 +1,14 @@
+import { type WatchStrategyName } from "./watch.js";
+export type ConfiguredWatchStrategy = "auto" | "poll" | "native";
+export interface WatchStrategyResolution {
+    strategy: WatchStrategyName;
+    warning?: string;
+}
+export declare const MIN_WATCH_INTERVAL_MS = 100;
+export declare function resolveWatchStrategy(input: {
+    configured: ConfiguredWatchStrategy;
+    platform: string;
+    isDocker: boolean;
+}): WatchStrategyResolution;
+export declare function clampWatchInterval(value: number): number;
+//# sourceMappingURL=watch-config.d.ts.map

package/dist/domain/watch-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-config.d.ts","sourceRoot":"","sources":["../../src/domain/watch-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,UAAU,EAAE,uBAAuB,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB,GAAG,uBAAuB,CA4B1B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/domain/watch-config.js

@@ -0,0 +1,29 @@
+import {} from "./watch.js";
+export const MIN_WATCH_INTERVAL_MS = 100;
+export function resolveWatchStrategy(input) {
+    const { configured, platform, isDocker } = input;
+    if (configured === "poll") {
+        return { strategy: "polling" };
+    }
+    if (platform === "win32") {
+        return {
+            strategy: "polling",
+            warning: configured === "native"
+                ? "SIRIUS_WATCH_STRATEGY=native is not supported on win32; using polling."
+                : undefined,
+        };
+    }
+    if (isDocker) {
+        return {
+            strategy: "polling",
+            warning: configured === "native"
+                ? "SIRIUS_WATCH_STRATEGY=native is not supported inside Docker; using polling."
+                : undefined,
+        };
+    }
+    return { strategy: "native" };
+}
+export function clampWatchInterval(value) {
+    return Math.max(MIN_WATCH_INTERVAL_MS, value);
+}
+//# sourceMappingURL=watch-config.js.map

package/dist/domain/watch-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-config.js","sourceRoot":"","sources":["../../src/domain/watch-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,MAAM,YAAY,CAAC;AASpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,UAAU,oBAAoB,CAAC,KAIpC;IACC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAEjD,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,OAAO,EACL,UAAU,KAAK,QAAQ;gBACrB,CAAC,CAAC,wEAAwE;gBAC1E,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,OAAO,EACL,UAAU,KAAK,QAAQ;gBACrB,CAAC,CAAC,6EAA6E;gBAC/E,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC"}

package/dist/domain/watch.d.ts

@@ -0,0 +1,64 @@
+import { type DocumentType } from "../schemas/document.js";
+export type WatchStrategyName = "polling" | "native";
+export type WatchEventKind = "created" | "changed" | "deleted";
+export interface WatchEvent {
+    path: string;
+    kind: WatchEventKind;
+}
+export interface ChangeSet {
+    events: WatchEvent[];
+    burst: boolean;
+}
+export type WatchHandler = (events: WatchEvent[]) => void;
+export interface WatcherPortStatus {
+    strategy: WatchStrategyName;
+    healthy: boolean;
+    pausedForCrawl: boolean;
+}
+export interface WatcherPort {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    setHandler(handler: WatchHandler): void;
+    status(): WatcherPortStatus;
+}
+export interface FileStamp {
+    path: string;
+    mtimeMs: number;
+    size: number;
+    ctimeMs: number;
+}
+export interface SnapshotDiff {
+    created: string[];
+    changed: string[];
+    deleted: string[];
+}
+export declare function diffSnapshots(before: FileStamp[], after: FileStamp[]): SnapshotDiff;
+export declare function snapshotsDiffer(diff: SnapshotDiff): boolean;
+export declare function deriveDocumentIdentity(path: string): {
+    type: DocumentType;
+    id: string;
+} | null;
+export interface AggregatorOptions {
+    debounceMs: number;
+    burstThreshold: number;
+    cooldownMs: number;
+    onFlush: (set: ChangeSet) => void;
+    now?: () => number;
+}
+export declare class ChangeAggregator {
+    private readonly options;
+    private readonly pending;
+    private timer;
+    private cooldownUntil;
+    private cooledEvents;
+    private stopped;
+    constructor(options: AggregatorOptions);
+    add(events: WatchEvent[]): void;
+    flushNow(): void;
+    stop(): void;
+    private flush;
+    private currentTime;
+}
+//# sourceMappingURL=watch.d.ts.map

package/dist/domain/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/domain/watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IACxC,MAAM,IAAI,iBAAiB,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,YAAY,CA6BnF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE3D;AAKD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAM3C;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAOf,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;gBAEK,OAAO,EAAE,iBAAiB;IAEvD,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAe/B,QAAQ,IAAI,IAAI;IAQhB,IAAI,IAAI,IAAI;IAQZ,OAAO,CAAC,KAAK;IAwBb,OAAO,CAAC,WAAW;CAGpB"}