@sirius-mcp/mcp 1.4.0

package/dist/app/watch.d.ts

@@ -0,0 +1,56 @@
+import { type FileStamp } from "../adapters/fs/watch-fs.js";
+import { type IndexWriterPort } from "../domain/index-writer.js";
+import { type WatcherPort } from "../domain/watch.js";
+export declare const DEFAULT_BURST_COOLDOWN_MS = 5000;
+export declare const STATUS_LIST_CAP = 50;
+export interface WatchSettings {
+    intervalMs: number;
+    debounceMs: number;
+    burstThreshold: number;
+    cooldownMs: number;
+}
+export interface WatcherSkippedInvalid {
+    path: string;
+    reason: string;
+}
+export interface ContextWatcherStatus {
+    strategy: "polling" | "native";
+    healthy: boolean;
+    pausedForCrawl: boolean;
+    skippedInvalid: WatcherSkippedInvalid[];
+    skippedInvalidTruncated: boolean;
+    unidentifiableDeletes: string[];
+    unidentifiableDeletesTruncated: boolean;
+}
+export interface ContextWatcherOptions {
+    root: string;
+    writer: IndexWriterPort;
+    port: WatcherPort;
+    settings: WatchSettings;
+    bootBaseline?: FileStamp[];
+    now?: () => number;
+}
+export declare class ContextWatcher {
+    private readonly options;
+    private readonly skippedInvalid;
+    private readonly unidentifiableDeletes;
+    private skippedInvalidTruncated;
+    private unidentifiableDeletesTruncated;
+    private flushChain;
+    private lastBurstRebuildAt;
+    private readonly aggregator;
+    constructor(options: ContextWatcherOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    status(): ContextWatcherStatus;
+    lastBurstRebuild(): string | null;
+    private addDiffEvents;
+    private applyChangeSet;
+    private applyEvent;
+    private rejectInvalid;
+    private pushSkippedInvalid;
+    private removeFromIndex;
+}
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/app/watch.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAC9C,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,qBAAqB,EAAE,CAAC;IACxC,uBAAuB,EAAE,OAAO,CAAC;IACjC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,8BAA8B,EAAE,OAAO,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IASb,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAC9D,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAgB;IACtD,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,8BAA8B,CAAS;IAC/C,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;gBAEjB,OAAO,EAAE,qBAAqB;IAkBrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAOtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAI7B,MAAM,IAAI,oBAAoB;IAa9B,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,aAAa;YAWP,cAAc;YAiBd,UAAU;YA2BV,aAAa;IAa3B,OAAO,CAAC,kBAAkB;YAQZ,eAAe;CAY9B"}

package/dist/app/watch.js

@@ -0,0 +1,154 @@
+import { resolve } from "node:path";
+import { parseDocumentMarkdown } from "../schemas/document.js";
+import { readDocumentByPath } from "../adapters/fs/structure.js";
+import { snapshotContextFiles, } from "../adapters/fs/watch-fs.js";
+import {} from "../domain/index-writer.js";
+import { ChangeAggregator, deriveDocumentIdentity, diffSnapshots, } from "../domain/watch.js";
+import { collectStoreDocuments } from "./reindex.js";
+export const DEFAULT_BURST_COOLDOWN_MS = 5000;
+export const STATUS_LIST_CAP = 50;
+export class ContextWatcher {
+    options;
+    skippedInvalid = [];
+    unidentifiableDeletes = [];
+    skippedInvalidTruncated = false;
+    unidentifiableDeletesTruncated = false;
+    flushChain = Promise.resolve();
+    lastBurstRebuildAt = null;
+    aggregator;
+    constructor(options) {
+        this.options = options;
+        this.aggregator = new ChangeAggregator({
+            debounceMs: options.settings.debounceMs,
+            burstThreshold: options.settings.burstThreshold,
+            cooldownMs: options.settings.cooldownMs,
+            now: options.now,
+            onFlush: (set) => {
+                this.flushChain = this.flushChain
+                    .then(() => this.applyChangeSet(set))
+                    .catch((err) => {
+                    console.error(`[sirius] watcher apply failed: ${err instanceof Error ? err.message : String(err)}`);
+                });
+            },
+        });
+    }
+    async start() {
+        const current = await snapshotContextFiles(this.options.root);
+        const baseline = this.options.bootBaseline ?? current;
+        this.addDiffEvents(diffSnapshots(baseline, current));
+        this.options.port.setHandler((events) => this.aggregator.add(events));
+        await this.options.port.start();
+    }
+    async stop() {
+        this.aggregator.stop();
+        await this.flushChain;
+        await this.options.port.stop();
+    }
+    async pause() {
+        this.aggregator.flushNow();
+        await this.flushChain;
+        await this.options.writer.idle();
+        await this.options.port.pause();
+    }
+    async resume() {
+        await this.options.port.resume();
+    }
+    status() {
+        const port = this.options.port.status();
+        return {
+            strategy: port.strategy,
+            healthy: port.healthy,
+            pausedForCrawl: port.pausedForCrawl,
+            skippedInvalid: [...this.skippedInvalid],
+            skippedInvalidTruncated: this.skippedInvalidTruncated,
+            unidentifiableDeletes: [...this.unidentifiableDeletes],
+            unidentifiableDeletesTruncated: this.unidentifiableDeletesTruncated,
+        };
+    }
+    lastBurstRebuild() {
+        return this.lastBurstRebuildAt;
+    }
+    addDiffEvents(diff) {
+        const events = [
+            ...diff.created.map((path) => ({ path, kind: "created" })),
+            ...diff.changed.map((path) => ({ path, kind: "changed" })),
+            ...diff.deleted.map((path) => ({ path, kind: "deleted" })),
+        ];
+        if (events.length > 0) {
+            this.aggregator.add(events);
+        }
+    }
+    async applyChangeSet(set) {
+        if (set.burst) {
+            const collected = await collectStoreDocuments(this.options.root);
+            await this.options.writer.rebuild(collected.docs);
+            this.lastBurstRebuildAt = new Date(this.options.now ? this.options.now() : Date.now()).toISOString();
+            for (const warning of collected.warnings) {
+                this.skippedInvalid.push({ path: warning.path, reason: warning.reason });
+            }
+            return;
+        }
+        for (const event of set.events) {
+            await this.applyEvent(event);
+        }
+    }
+    async applyEvent(event) {
+        const rel = event.path.replace(/\\/g, "/");
+        if (event.kind === "deleted") {
+            await this.removeFromIndex(rel);
+            return;
+        }
+        const content = await readDocumentByPath(resolve(this.options.root, rel));
+        if (content === null) {
+            await this.removeFromIndex(rel);
+            return;
+        }
+        const parsed = parseDocumentMarkdown(content);
+        if (!parsed.success) {
+            await this.rejectInvalid(rel, parsed.error.message);
+            return;
+        }
+        const frontmatter = parsed.data.frontmatter;
+        await this.options.writer.upsert({
+            id: frontmatter.id,
+            type: frontmatter.type,
+            status: frontmatter.status,
+            title: frontmatter.title,
+            body: parsed.data.body,
+            path: rel,
+        });
+    }
+    async rejectInvalid(rel, reason) {
+        const identity = deriveDocumentIdentity(rel);
+        if (identity) {
+            await this.options.writer.remove(identity.type, identity.id);
+            this.pushSkippedInvalid({ path: rel, reason });
+        }
+        else {
+            this.pushSkippedInvalid({
+                path: rel,
+                reason: `Invalid frontmatter and unidentifiable path: ${reason}`,
+            });
+        }
+    }
+    pushSkippedInvalid(entry) {
+        if (this.skippedInvalid.length >= STATUS_LIST_CAP) {
+            this.skippedInvalid.shift();
+            this.skippedInvalidTruncated = true;
+        }
+        this.skippedInvalid.push(entry);
+    }
+    async removeFromIndex(rel) {
+        const identity = deriveDocumentIdentity(rel);
+        if (!identity) {
+            if (this.unidentifiableDeletes.length >= STATUS_LIST_CAP) {
+                this.unidentifiableDeletes.shift();
+                this.unidentifiableDeletesTruncated = true;
+            }
+            this.unidentifiableDeletes.push(rel);
+            return;
+        }
+        await this.options.writer.remove(identity.type, identity.id);
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/app/watch.js.map

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

package/dist/app/web-portal-search.d.ts

@@ -0,0 +1,11 @@
+import { type BlueprintNode } from "./web-portal-service.js";
+import { type HybridSearchHit } from "../domain/hybrid-search.js";
+export declare function computeDocMatchScore(node: BlueprintNode, body: string, q: string, tokens: string[]): {
+    score: number;
+    bodyMatchIdx: number;
+};
+export declare function buildDocSnippet(body: string, bodyMatchIdx: number, fallback: string): string;
+export declare function executeFallbackSearch(docs: BlueprintNode[], readDetail: (type: string, id: string) => {
+    body: string;
+} | null, query: string, limit?: number): HybridSearchHit[];
+//# sourceMappingURL=web-portal-search.d.ts.map

package/dist/app/web-portal-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-portal-search.d.ts","sourceRoot":"","sources":["../../src/app/web-portal-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAgDlE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EAAE,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAczC;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAiBR;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EAAE,EACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EACjE,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,eAAe,EAAE,CAoCnB"}

package/dist/app/web-portal-search.js

@@ -0,0 +1,97 @@
+import {} from "./web-portal-service.js";
+import {} from "../domain/hybrid-search.js";
+function computeHeaderScore(id, title, type, q) {
+    let score = 0;
+    if (id === q) {
+        score += 0.85;
+    }
+    else if (id.includes(q)) {
+        score += 0.5;
+    }
+    if (title.includes(q)) {
+        score += 0.4;
+    }
+    if (type === q || type.includes(q)) {
+        score += 0.2;
+    }
+    return score;
+}
+function computeTokenScore(id, title, tags, body, tokens) {
+    let score = 0;
+    let bodyMatchIdx = -1;
+    for (const token of tokens) {
+        if (id.includes(token))
+            score += 0.15;
+        if (title.includes(token))
+            score += 0.15;
+        if (tags.some((t) => t.includes(token)))
+            score += 0.2;
+        const idx = body.indexOf(token);
+        if (idx !== -1) {
+            score += 0.1;
+            if (bodyMatchIdx === -1 || idx < bodyMatchIdx) {
+                bodyMatchIdx = idx;
+            }
+        }
+    }
+    return { score, bodyMatchIdx };
+}
+export function computeDocMatchScore(node, body, q, tokens) {
+    const lowerBody = body.toLowerCase();
+    const lowerId = node.id.toLowerCase();
+    const lowerTitle = node.title.toLowerCase();
+    const lowerType = node.type.toLowerCase();
+    const tags = (node.tags ?? []).map((t) => t.toLowerCase());
+    const headerScore = computeHeaderScore(lowerId, lowerTitle, lowerType, q);
+    const tokenResult = computeTokenScore(lowerId, lowerTitle, tags, lowerBody, tokens);
+    return {
+        score: headerScore + tokenResult.score,
+        bodyMatchIdx: tokenResult.bodyMatchIdx,
+    };
+}
+export function buildDocSnippet(body, bodyMatchIdx, fallback) {
+    if (bodyMatchIdx !== -1) {
+        const start = Math.max(0, bodyMatchIdx - 40);
+        const end = Math.min(body.length, bodyMatchIdx + 120);
+        return ((start > 0 ? "..." : "") +
+            body.slice(start, end).replace(/\r?\n/g, " ").trim() +
+            (end < body.length ? "..." : ""));
+    }
+    if (body.trim().length > 0) {
+        return (body.slice(0, 120).replace(/\r?\n/g, " ").trim() +
+            (body.length > 120 ? "..." : ""));
+    }
+    return fallback;
+}
+export function executeFallbackSearch(docs, readDetail, query, limit = 10) {
+    const q = query.toLowerCase().trim();
+    if (!q)
+        return [];
+    const tokens = q.split(/\s+/).filter(Boolean);
+    const matches = [];
+    for (const node of docs) {
+        const detail = readDetail(node.type, node.id);
+        const body = detail?.body ?? "";
+        const { score, bodyMatchIdx } = computeDocMatchScore(node, body, q, tokens);
+        if (score > 0) {
+            const snippet = buildDocSnippet(body, bodyMatchIdx, `Document ${node.title} (${node.id}) [${node.type}]`);
+            matches.push({
+                node,
+                score: Math.min(1.0, Number(score.toFixed(3))),
+                snippet,
+            });
+        }
+    }
+    matches.sort((a, b) => b.score - a.score);
+    return matches.slice(0, limit).map((m, idx) => ({
+        id: m.node.id,
+        type: m.node.type,
+        status: m.node.status,
+        title: m.node.title,
+        path: m.node.path,
+        snippet: m.snippet,
+        score: m.score,
+        lexicalRank: idx + 1,
+    }));
+}
+//# sourceMappingURL=web-portal-search.js.map

package/dist/app/web-portal-search.js.map

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

package/dist/app/web-portal-service.d.ts

@@ -0,0 +1,37 @@
+import { type WebServerConfig, type WebServerInfo } from "../domain/web-server-port.js";
+import { EmbeddedWebServer } from "../adapters/http/embedded-server.js";
+import { type SearchOrchestrator } from "./search-orchestrator.js";
+export interface BlueprintNode {
+    id: string;
+    type: string;
+    title: string;
+    status: string;
+    path: string;
+    tags?: string[];
+}
+export interface BlueprintEdge {
+    from: string;
+    to: string;
+    relationship: string;
+}
+export interface BlueprintTopology {
+    nodes: BlueprintNode[];
+    edges: BlueprintEdge[];
+}
+export declare class WebPortalService {
+    private readonly root;
+    private readonly server;
+    private readonly orchestrator?;
+    constructor(root: string, server: EmbeddedWebServer, orchestrator?: SearchOrchestrator | undefined);
+    private setupHandlers;
+    start(config: WebServerConfig): Promise<WebServerInfo>;
+    stop(): Promise<void>;
+    notifyDocumentChanged(type: string, id: string, action: "upsert" | "delete"): void;
+    notifyBlueprintUpdated(): void;
+    private listAllDocuments;
+    private readDocumentDetail;
+    private generateBlueprintTopology;
+    private parseMarkdownFile;
+    private fallbackSearch;
+}
+//# sourceMappingURL=web-portal-service.d.ts.map

package/dist/app/web-portal-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-portal-service.d.ts","sourceRoot":"","sources":["../../src/app/web-portal-service.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,aAAa,EAEnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAYnE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAFb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,EACzB,YAAY,CAAC,EAAE,kBAAkB,YAAA;IAMpD,OAAO,CAAC,aAAa;IAuCf,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAItD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,qBAAqB,CACnB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAC1B,IAAI;IASP,sBAAsB,IAAI,IAAI;IAS9B,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,yBAAyB;IAoDjC,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,cAAc;CAQvB"}

package/dist/app/web-portal-service.js

@@ -0,0 +1,198 @@
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import YAML from "yaml";
+import {} from "../domain/web-server-port.js";
+import { EmbeddedWebServer } from "../adapters/http/embedded-server.js";
+import {} from "./search-orchestrator.js";
+import {} from "../domain/hybrid-search.js";
+import { executeFallbackSearch } from "./web-portal-search.js";
+const CANONICAL_TYPES = [
+    "feature",
+    "business-rule",
+    "decision",
+    "component",
+    "architecture",
+];
+export class WebPortalService {
+    root;
+    server;
+    orchestrator;
+    constructor(root, server, orchestrator) {
+        this.root = root;
+        this.server = server;
+        this.orchestrator = orchestrator;
+        this.server.setProjectRoot(this.root);
+        this.setupHandlers();
+    }
+    setupHandlers() {
+        this.server.setHealthHandler(async () => {
+            const docs = this.listAllDocuments();
+            return {
+                status: "ok",
+                docsCount: docs.length,
+                vectorDim: 384,
+                vectorQueuePending: 0,
+                uptime: process.uptime(),
+            };
+        });
+        this.server.setDocumentsHandler(async () => {
+            return this.listAllDocuments();
+        });
+        this.server.setDocumentDetailHandler(async (type, id) => {
+            return this.readDocumentDetail(type, id);
+        });
+        this.server.setBlueprintsHandler(async () => {
+            return this.generateBlueprintTopology();
+        });
+        this.server.setSearchHandler(async (query, limit) => {
+            if (this.orchestrator) {
+                try {
+                    const hits = await this.orchestrator.search(query, limit);
+                    if (hits && hits.length > 0) {
+                        return hits;
+                    }
+                }
+                catch {
+                    // Fall through to fallbackSearch
+                }
+            }
+            return this.fallbackSearch(query, limit);
+        });
+    }
+    async start(config) {
+        return this.server.start({ projectRoot: this.root, ...config });
+    }
+    async stop() {
+        return this.server.stop();
+    }
+    notifyDocumentChanged(type, id, action) {
+        const event = {
+            type: "document_changed",
+            payload: { type, id, action },
+            timestamp: Date.now(),
+        };
+        this.server.broadcast(event);
+    }
+    notifyBlueprintUpdated() {
+        const event = {
+            type: "blueprint_updated",
+            payload: { timestamp: Date.now() },
+            timestamp: Date.now(),
+        };
+        this.server.broadcast(event);
+    }
+    listAllDocuments() {
+        const contextDir = join(this.root, ".context");
+        if (!existsSync(contextDir)) {
+            return [];
+        }
+        const docs = [];
+        for (const type of CANONICAL_TYPES) {
+            const typeDir = join(contextDir, type);
+            if (existsSync(typeDir)) {
+                const files = readdirSync(typeDir).filter((f) => f.endsWith(".md"));
+                for (const file of files) {
+                    const id = file.replace(/\.md$/, "");
+                    const filePath = join(typeDir, file);
+                    const { frontmatter } = this.parseMarkdownFile(filePath);
+                    docs.push({
+                        id,
+                        type,
+                        title: frontmatter.title ?? id,
+                        status: frontmatter.status ?? "active",
+                        path: `.context/${type}/${file}`,
+                        tags: Array.isArray(frontmatter.tags)
+                            ? frontmatter.tags
+                            : undefined,
+                    });
+                }
+            }
+        }
+        return docs;
+    }
+    readDocumentDetail(type, id) {
+        const filePath = join(this.root, ".context", type, `${id}.md`);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        const { frontmatter, body } = this.parseMarkdownFile(filePath);
+        return {
+            type,
+            id,
+            title: frontmatter.title ?? id,
+            status: frontmatter.status ?? "active",
+            path: `.context/${type}/${id}.md`,
+            body,
+            tags: Array.isArray(frontmatter.tags)
+                ? frontmatter.tags
+                : undefined,
+        };
+    }
+    generateBlueprintTopology() {
+        const nodes = this.listAllDocuments();
+        const edges = [];
+        const contextDir = join(this.root, ".context");
+        if (!existsSync(contextDir)) {
+            return { nodes: [], edges: [] };
+        }
+        for (const node of nodes) {
+            const filePath = join(this.root, node.path);
+            if (existsSync(filePath)) {
+                const { frontmatter } = this.parseMarkdownFile(filePath);
+                // Extract binds
+                if (Array.isArray(frontmatter.binds)) {
+                    for (const target of frontmatter.binds) {
+                        edges.push({
+                            from: node.id,
+                            to: String(target),
+                            relationship: "binds",
+                        });
+                    }
+                }
+                // Extract sources
+                if (Array.isArray(frontmatter.sources)) {
+                    for (const target of frontmatter.sources) {
+                        edges.push({
+                            from: node.id,
+                            to: String(target),
+                            relationship: "sources",
+                        });
+                    }
+                }
+                // Extract companions
+                if (Array.isArray(frontmatter.companions)) {
+                    for (const target of frontmatter.companions) {
+                        edges.push({
+                            from: node.id,
+                            to: String(target),
+                            relationship: "companions",
+                        });
+                    }
+                }
+            }
+        }
+        return { nodes, edges };
+    }
+    parseMarkdownFile(filePath) {
+        try {
+            const raw = readFileSync(filePath, "utf8");
+            if (raw.startsWith("---")) {
+                const parts = raw.split("---");
+                if (parts.length >= 3) {
+                    const yamlStr = parts[1];
+                    const body = parts.slice(2).join("---").trim();
+                    const parsed = YAML.parse(yamlStr) ?? {};
+                    return { frontmatter: parsed, body };
+                }
+            }
+            return { frontmatter: {}, body: raw };
+        }
+        catch {
+            return { frontmatter: {}, body: "" };
+        }
+    }
+    fallbackSearch(query, limit = 10) {
+        return executeFallbackSearch(this.listAllDocuments(), (type, id) => this.readDocumentDetail(type, id), query, limit);
+    }
+}
+//# sourceMappingURL=web-portal-service.js.map

package/dist/app/web-portal-service.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+import { type ConfiguredWatchStrategy } from "./domain/watch-config.js";
+export declare const DEFAULT_RELEASE_ENDPOINT = "https://api.siriusmcp.dev/api/releases/latest";
+export interface ServerConfig {
+    readonly projectRoot: string;
+    readonly autoUpdate: "enabled" | "disabled";
+    readonly updateIntervalHours: number;
+    readonly releaseEndpoint: string;
+    readonly licenseKey?: string;
+    readonly licenseGraceDays: number;
+    readonly licenseHardGate: boolean;
+    readonly licenseOffline: boolean;
+    readonly licenseEnforce: boolean;
+    readonly licenseServerUrl: string;
+    readonly watchEnabled: boolean;
+    readonly watchStrategy: ConfiguredWatchStrategy;
+    readonly watchIntervalMs: number;
+    readonly watchDebounceMs: number;
+    readonly watchBurstThreshold: number;
+    readonly crawlMaxFileBytes: number;
+    readonly webPortalEnabled: boolean;
+    readonly webPort: number;
+    readonly webHost: string;
+}
+export declare function resolveProjectRoot(): string;
+export declare function parseIntDefault(value: string | undefined, fallback: number): number;
+export declare function effectiveHardGate(config: ServerConfig): boolean;
+export declare function loadConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,wBAAwB,kDACY,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMnF;AASD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE/D;AAED,wBAAgB,UAAU,IAAI,YAAY,CA4CzC"}