@sirius-mcp/mcp 1.4.0

package/dist/app/get.d.ts

@@ -0,0 +1,64 @@
+import { z } from "zod";
+import { type DocumentType } from "../adapters/fs/structure.js";
+import { type DocumentStatus } from "../schemas/document.js";
+import { type McpError } from "../errors.js";
+import { type LicensePort } from "../domain/license.js";
+export declare const DEFAULT_MAX_BODY_BYTES = 8192;
+export declare const GetDocumentInput: z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<["feature", "business-rule", "decision", "component", "architecture"]>>;
+    id: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    path?: string | undefined;
+    id?: string | undefined;
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+}, {
+    path?: string | undefined;
+    id?: string | undefined;
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+}>, {
+    path?: string | undefined;
+    id?: string | undefined;
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+}, {
+    path?: string | undefined;
+    id?: string | undefined;
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+}>, {
+    path?: string | undefined;
+    id?: string | undefined;
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+}, {
+    path?: string | undefined;
+    id?: string | undefined;
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+}>;
+export type GetDocumentInput = z.infer<typeof GetDocumentInput>;
+export interface GetDocumentResult {
+    frontmatter: {
+        id: string;
+        type: DocumentType;
+        status: DocumentStatus;
+        title: string;
+        updated: string;
+        related?: {
+            id: string;
+            type?: DocumentType;
+        }[];
+        code_refs?: string[];
+        tags?: string[];
+        summary?: string;
+    };
+    body: string;
+    path: string;
+    truncated?: boolean;
+    warning?: string;
+}
+export declare function getDocument(root: string, input: GetDocumentInput, licensePort?: LicensePort, hardGate?: boolean): Promise<{
+    success: true;
+    data: GetDocumentResult;
+} | {
+    success: false;
+    error: McpError;
+}>;
+//# sourceMappingURL=get.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/app/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmD,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACjH,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB1B,CAAC;AAEJ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,YAAY,CAAC;QACnB,MAAM,EAAE,cAAc,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,YAAY,CAAA;SAAE,EAAE,CAAC;QAChD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,gBAAgB,EACvB,WAAW,GAAE,WAA4B,EACzC,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAuD3F"}

package/dist/app/get.js

@@ -0,0 +1,130 @@
+import { z } from "zod";
+import { loadProjectConfig, configLoadError } from "./loadProjectConfig.js";
+import { readDocumentByPath, documentPath, DocumentTypes } from "../adapters/fs/structure.js";
+import { parseDocumentMarkdown } from "../schemas/document.js";
+import { mcpError, toMcpError } from "../errors.js";
+import { resolve, relative, isAbsolute } from "node:path";
+import { devLicensePort } from "../domain/license.js";
+import { licenseGate } from "./license-gate.js";
+export const DEFAULT_MAX_BODY_BYTES = 8192;
+export const GetDocumentInput = z
+    .object({
+    type: z.enum(DocumentTypes).optional(),
+    id: z
+        .string()
+        .min(1)
+        .regex(/^[a-z0-9-]+$/, "id must contain only lowercase letters, numbers, and hyphens")
+        .optional(),
+    path: z.string().min(1).optional(),
+})
+    .refine((data) => (data.type && data.id) || data.path, {
+    message: "Provide either type and id, or a document path.",
+    path: ["input"],
+})
+    .refine((data) => !(data.type && data.id && data.path), {
+    message: "Provide either type and id, or a document path — not both.",
+    path: ["input"],
+});
+export async function getDocument(root, input, licensePort = devLicensePort, hardGate = false) {
+    try {
+        const gate = await licenseGate({
+            tool: "context_get",
+            licensePort,
+            hardGate,
+            mode: "read",
+        });
+        if (gate) {
+            return { success: false, error: gate };
+        }
+        const config = await loadProjectConfig(root);
+        if (config.kind !== "ok") {
+            return { success: false, error: configLoadError(config) };
+        }
+        const validated = GetDocumentInput.parse(input);
+        const pathResult = resolveDocumentPath(root, validated);
+        if (!pathResult.success) {
+            return { success: false, error: pathResult.error };
+        }
+        const content = await readDocumentByPath(pathResult.path);
+        if (content === null) {
+            return {
+                success: false,
+                error: mcpError("NOT_FOUND", `Document not found: ${pathResult.display}`),
+            };
+        }
+        const parsed = parseDocumentMarkdown(content);
+        if (!parsed.success) {
+            return { success: false, error: parsed.error };
+        }
+        const { body, truncated } = truncateBody(parsed.data.body, DEFAULT_MAX_BODY_BYTES);
+        const result = {
+            frontmatter: parsed.data.frontmatter,
+            body,
+            path: pathResult.display,
+        };
+        if (truncated) {
+            result.truncated = true;
+            result.warning = `Body exceeded ${DEFAULT_MAX_BODY_BYTES} bytes and was truncated. Read the file directly for the full content.`;
+        }
+        return { success: true, data: result };
+    }
+    catch (err) {
+        return { success: false, error: toMcpError(err, "GET_FAILED") };
+    }
+}
+function resolveDocumentPath(root, input) {
+    if (input.type && input.id) {
+        const path = documentPath(root, input.type, input.id);
+        return {
+            success: true,
+            path,
+            display: `.context/${input.type}/${input.id}.md`,
+        };
+    }
+    if (input.path) {
+        const rawPath = input.path;
+        const normalized = rawPath.startsWith(".context/")
+            ? rawPath
+            : rawPath.includes("/")
+                ? rawPath
+                : `.context/${rawPath}`;
+        const resolved = isAbsolute(normalized)
+            ? normalized
+            : resolve(root, normalized);
+        const contextRoot = resolve(root, ".context");
+        const rel = relative(contextRoot, resolved);
+        if (rel.startsWith("..") || rel.includes("..") || isAbsolute(rel)) {
+            return {
+                success: false,
+                error: mcpError("INVALID_PATH", `Document path escapes the context store: ${rawPath}`, { path: rawPath }),
+            };
+        }
+        return {
+            success: true,
+            path: resolved,
+            display: normalized,
+        };
+    }
+    return {
+        success: false,
+        error: mcpError("VALIDATION_ERROR", "Provide either type and id, or a document path."),
+    };
+}
+const TRUNCATION_MARKER = "\n\n[truncated]";
+function truncateBody(body, maxBytes) {
+    const totalBytes = Buffer.byteLength(body, "utf8");
+    if (totalBytes <= maxBytes) {
+        return { body, truncated: false };
+    }
+    const markerBytes = Buffer.byteLength(TRUNCATION_MARKER, "utf8");
+    const targetBytes = Math.max(0, maxBytes - markerBytes);
+    const buf = Buffer.from(body, "utf8");
+    let cut = Math.min(targetBytes, buf.length);
+    // Walk back past any UTF-8 continuation bytes (0x80-0xBF) so we don't split a code point.
+    while (cut > 0 && (buf[cut] ?? 0) >= 0x80 && (buf[cut] ?? 0) <= 0xbf) {
+        cut--;
+    }
+    const truncated = buf.subarray(0, cut).toString("utf8");
+    return { body: truncated + TRUNCATION_MARKER, truncated: true };
+}
+//# sourceMappingURL=get.js.map

package/dist/app/get.js.map

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

package/dist/app/index-lifecycle.d.ts

@@ -0,0 +1,14 @@
+import { type SqliteVecAdapter } from "../adapters/db/sqlite-vec-adapter.js";
+import { type EmbeddingPort } from "../domain/embedding-port.js";
+export interface ModelLockResult {
+    migrated: boolean;
+    warning?: string;
+}
+export declare class IndexLifecycleManager {
+    private readonly vecAdapter;
+    private readonly embeddingPort;
+    constructor(vecAdapter: SqliteVecAdapter, embeddingPort: EmbeddingPort);
+    ensureModelLock(): Promise<ModelLockResult>;
+    private updateMetadata;
+}
+//# sourceMappingURL=index-lifecycle.d.ts.map

package/dist/app/index-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-lifecycle.d.ts","sourceRoot":"","sources":["../../src/app/index-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBADb,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa;IAGzC,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IAiCjD,OAAO,CAAC,cAAc;CAWvB"}

package/dist/app/index-lifecycle.js

@@ -0,0 +1,43 @@
+import {} from "../adapters/db/sqlite-vec-adapter.js";
+import {} from "../domain/embedding-port.js";
+export class IndexLifecycleManager {
+    vecAdapter;
+    embeddingPort;
+    constructor(vecAdapter, embeddingPort) {
+        this.vecAdapter = vecAdapter;
+        this.embeddingPort = embeddingPort;
+    }
+    async ensureModelLock() {
+        const activeModel = this.embeddingPort.getModelInfo();
+        const storedModelName = this.vecAdapter.getMeta("model_name");
+        const storedModelVersion = this.vecAdapter.getMeta("model_version");
+        const storedVectorDim = this.vecAdapter.getMeta("vector_dim");
+        if (!storedModelName) {
+            // First-time initialization
+            this.updateMetadata(activeModel.name, activeModel.version, activeModel.dimensions);
+            return { migrated: false };
+        }
+        const mismatch = storedModelName !== activeModel.name ||
+            storedModelVersion !== activeModel.version ||
+            storedVectorDim !== String(activeModel.dimensions);
+        if (mismatch) {
+            const warning = `[ModelLifecycle] Embedding model identity mismatch detected: expected ${activeModel.name}@${activeModel.version} (${activeModel.dimensions}d), found ${storedModelName}@${storedModelVersion} (${storedVectorDim}d). Initiating zero-loss vector reindex.`;
+            // AD-F2-17: Drop & recreate vec_documents table
+            this.vecAdapter.recreateVecTable(activeModel.dimensions);
+            this.updateMetadata(activeModel.name, activeModel.version, activeModel.dimensions);
+            return {
+                migrated: true,
+                warning,
+            };
+        }
+        return { migrated: false };
+    }
+    updateMetadata(modelName, modelVersion, vectorDim) {
+        this.vecAdapter.setMeta("schema_version", "3");
+        this.vecAdapter.setMeta("model_name", modelName);
+        this.vecAdapter.setMeta("model_version", modelVersion);
+        this.vecAdapter.setMeta("vector_dim", String(vectorDim));
+        this.vecAdapter.setMeta("indexed_at", new Date().toISOString());
+    }
+}
+//# sourceMappingURL=index-lifecycle.js.map

package/dist/app/index-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-lifecycle.js","sourceRoot":"","sources":["../../src/app/index-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAsB,MAAM,6BAA6B,CAAC;AAOjE,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,UAA4B,EAC5B,aAA4B;QAD5B,eAAU,GAAV,UAAU,CAAkB;QAC5B,kBAAa,GAAb,aAAa,CAAe;IAC5C,CAAC;IAEJ,KAAK,CAAC,eAAe;QACnB,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9D,MAAM,kBAAkB,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACpE,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAE9D,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,4BAA4B;YAC5B,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;YACnF,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC7B,CAAC;QAED,MAAM,QAAQ,GACZ,eAAe,KAAK,WAAW,CAAC,IAAI;YACpC,kBAAkB,KAAK,WAAW,CAAC,OAAO;YAC1C,eAAe,KAAK,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAErD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,yEAAyE,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,OAAO,KAAK,WAAW,CAAC,UAAU,aAAa,eAAe,IAAI,kBAAkB,KAAK,eAAe,0CAA0C,CAAC;YAE5Q,gDAAgD;YAChD,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YACzD,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;YAEnF,OAAO;gBACL,QAAQ,EAAE,IAAI;gBACd,OAAO;aACR,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7B,CAAC;IAEO,cAAc,CACpB,SAAiB,EACjB,YAAoB,EACpB,SAAiB;QAEjB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/app/index-status.d.ts

@@ -0,0 +1,29 @@
+import { type IndexPort } from "../domain/index.js";
+import { type IndexWarning, type IndexWriterPort } from "../domain/index-writer.js";
+import { type ContextWatcherStatus } from "./watch.js";
+export interface IndexStatusWatcher {
+    strategy: string;
+    healthy: boolean;
+    pausedForCrawl?: boolean;
+    skippedInvalid: {
+        path: string;
+        reason: string;
+    }[];
+    unidentifiableDeletes: string[];
+}
+export interface IndexStatusPayload {
+    open: boolean;
+    pendingWrites: number;
+    lastWriteAt: string | null;
+    watcher?: IndexStatusWatcher;
+    lastBurstRebuild?: string;
+    warnings: IndexWarning[];
+}
+export interface IndexStatusDeps {
+    indexPort: IndexPort;
+    writer: IndexWriterPort;
+    watcher?: ContextWatcherStatus;
+    lastBurstRebuild?: string | null;
+}
+export declare function buildIndexStatus(deps: IndexStatusDeps): IndexStatusPayload;
+//# sourceMappingURL=index-status.d.ts.map

package/dist/app/index-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-status.d.ts","sourceRoot":"","sources":["../../src/app/index-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnD,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAe1E"}

package/dist/app/index-status.js

@@ -0,0 +1,20 @@
+import {} from "../domain/index.js";
+import {} from "../domain/index-writer.js";
+import {} from "./watch.js";
+export function buildIndexStatus(deps) {
+    const writerStatus = deps.writer.status();
+    const payload = {
+        open: deps.indexPort.isOpen(),
+        pendingWrites: writerStatus.pendingWrites,
+        lastWriteAt: writerStatus.lastWriteAt,
+        warnings: writerStatus.warnings,
+    };
+    if (deps.watcher) {
+        payload.watcher = deps.watcher;
+    }
+    if (deps.lastBurstRebuild) {
+        payload.lastBurstRebuild = deps.lastBurstRebuild;
+    }
+    return payload;
+}
+//# sourceMappingURL=index-status.js.map

package/dist/app/index-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-status.js","sourceRoot":"","sources":["../../src/app/index-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA2C,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAA6B,MAAM,YAAY,CAAC;AA0BvD,MAAM,UAAU,gBAAgB,CAAC,IAAqB;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAC1C,MAAM,OAAO,GAAuB;QAClC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE;QAC7B,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,QAAQ,EAAE,YAAY,CAAC,QAAQ;KAChC,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACnD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/app/init.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { type McpError } from "../errors.js";
+import { type LicensePort } from "../domain/license.js";
+export declare const InitProjectInput: z.ZodObject<{
+    name: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    language?: string | undefined;
+    description?: string | undefined;
+}, {
+    name: string;
+    language?: string | undefined;
+    description?: string | undefined;
+}>;
+export type InitProjectInput = z.infer<typeof InitProjectInput>;
+export interface InitProjectArgs extends InitProjectInput {
+    root: string;
+}
+export declare function initProject(args: InitProjectArgs, licensePort?: LicensePort, hardGate?: boolean): Promise<{
+    success: true;
+} | {
+    success: false;
+    error: McpError;
+}>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/app/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAwB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,EACrB,WAAW,GAAE,WAA4B,EACzC,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAqClE"}

package/dist/app/init.js

@@ -0,0 +1,46 @@
+import { stringify } from "yaml";
+import { z } from "zod";
+import { loadProjectConfig } from "./loadProjectConfig.js";
+import { ensureContextStructure } from "../adapters/fs/structure.js";
+import { ProjectConfig } from "../schemas/project.js";
+import { mcpError, toMcpError } from "../errors.js";
+import { devLicensePort } from "../domain/license.js";
+import { licenseGate } from "./license-gate.js";
+export const InitProjectInput = z.object({
+    name: z.string().min(1, "name is required"),
+    language: z.string().min(1).optional(),
+    description: z.string().optional(),
+});
+export async function initProject(args, licensePort = devLicensePort, hardGate = false) {
+    try {
+        const gate = await licenseGate({
+            tool: "project_init",
+            licensePort,
+            hardGate,
+            mode: "write",
+        });
+        if (gate) {
+            return { success: false, error: gate };
+        }
+        const existing = await loadProjectConfig(args.root);
+        if (existing.kind !== "missing") {
+            return {
+                success: false,
+                error: mcpError("ALREADY_INITIALIZED", "Project is already initialized. Use context tools to manage documents, or fix context.config.yaml if it is invalid."),
+            };
+        }
+        const validated = InitProjectInput.parse(args);
+        const config = {
+            name: validated.name,
+            language: validated.language ?? "en",
+            description: validated.description,
+        };
+        const yaml = stringify(config, { sortMapEntries: true });
+        await ensureContextStructure(args.root, yaml);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: toMcpError(err, "INIT_FAILED") };
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/app/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/app/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAQH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAqB,EACrB,cAA2B,cAAc,EACzC,WAAoB,KAAK;IAEzB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC;YAC7B,IAAI,EAAE,cAAc;YACpB,WAAW;YACX,QAAQ;YACR,IAAI,EAAE,OAAO;SACd,CAAC,CAAC;QACH,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,QAAQ,CACb,qBAAqB,EACrB,qHAAqH,CACtH;aACF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAkB;YAC5B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,IAAI;YACpC,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC,CAAC;QAEF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,sBAAsB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE9C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/app/license-gate.d.ts

@@ -0,0 +1,10 @@
+import { type McpError } from "../errors.js";
+import type { LicensePort } from "../domain/license.js";
+export interface GateOptions {
+    tool: string;
+    licensePort: LicensePort;
+    hardGate?: boolean;
+    mode: "read" | "write";
+}
+export declare function licenseGate(options: GateOptions): Promise<McpError | null>;
+//# sourceMappingURL=license-gate.d.ts.map

package/dist/app/license-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-gate.d.ts","sourceRoot":"","sources":["../../src/app/license-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,sBAAsB,CAAC;AAEtE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CA+BhF"}

package/dist/app/license-gate.js

@@ -0,0 +1,24 @@
+import { mcpError } from "../errors.js";
+export async function licenseGate(options) {
+    const { tool, licensePort, hardGate = false, mode } = options;
+    const state = licensePort.status();
+    if (state === "dev") {
+        return null;
+    }
+    const allowed = isValidOrGrace(state);
+    if (mode === "write") {
+        if (!allowed) {
+            return mcpError("LICENSE_WRITE_BLOCKED", `Write tool blocked by license gate: ${tool}`, { tool });
+        }
+        return null;
+    }
+    // mode === "read"
+    if (hardGate && !allowed) {
+        return mcpError("LICENSE_BLOCKED", `Tool blocked by license gate: ${tool}`, { tool });
+    }
+    return null;
+}
+function isValidOrGrace(state) {
+    return state === "valid" || state === "grace";
+}
+//# sourceMappingURL=license-gate.js.map

package/dist/app/license-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-gate.js","sourceRoot":"","sources":["../../src/app/license-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,MAAM,cAAc,CAAC;AAUvD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAoB;IACpD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,GAAG,KAAK,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;IAEnC,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,QAAQ,CACb,uBAAuB,EACvB,uCAAuC,IAAI,EAAE,EAC7C,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,IAAI,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,QAAQ,CACb,iBAAiB,EACjB,iCAAiC,IAAI,EAAE,EACvC,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,KAAmB;IACzC,OAAO,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,CAAC;AAChD,CAAC"}

package/dist/app/list.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { type McpError } from "../errors.js";
+import { type LicensePort } from "../domain/license.js";
+export interface ContextListItem {
+    id: string;
+    type: string;
+    title?: string;
+    status?: string;
+    path: string;
+    warning?: string;
+}
+export interface ContextListResult {
+    documents: ContextListItem[];
+}
+export declare const ContextListInput: z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<["feature", "business-rule", "decision", "component", "architecture"]>>;
+    status: z.ZodOptional<z.ZodEnum<["draft", "active", "deprecated", "superseded"]>>;
+    path_prefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    status?: "draft" | "active" | "deprecated" | "superseded" | undefined;
+    path_prefix?: string | undefined;
+}, {
+    type?: "feature" | "business-rule" | "decision" | "component" | "architecture" | undefined;
+    status?: "draft" | "active" | "deprecated" | "superseded" | undefined;
+    path_prefix?: string | undefined;
+}>;
+export type ContextListInput = z.infer<typeof ContextListInput>;
+export declare function listContextStore(root: string, input?: ContextListInput, licensePort?: LicensePort, hardGate?: boolean): Promise<{
+    success: true;
+    data: ContextListResult;
+} | {
+    success: false;
+    error: McpError;
+}>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/app/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,EAAc,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,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,iBAAiB;IAChC,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B;AAED,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,gBAAgB,EACxB,WAAW,GAAE,WAA4B,EACzC,QAAQ,GAAE,OAAe,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CA6B3F"}

package/dist/app/list.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { loadProjectConfig, configLoadError } from "./loadProjectConfig.js";
+import { listDocumentFiles, DocumentTypes, } from "../adapters/fs/structure.js";
+import { DocumentStatuses } from "../schemas/document.js";
+import { toMcpError } from "../errors.js";
+import { devLicensePort } from "../domain/license.js";
+import { licenseGate } from "./license-gate.js";
+export const ContextListInput = z.object({
+    type: z.enum(DocumentTypes).optional(),
+    status: z.enum(DocumentStatuses).optional(),
+    path_prefix: z.string().min(1).optional(),
+});
+export async function listContextStore(root, input, licensePort = devLicensePort, hardGate = false) {
+    const gate = await licenseGate({
+        tool: "context_list",
+        licensePort,
+        hardGate,
+        mode: "read",
+    });
+    if (gate) {
+        return { success: false, error: gate };
+    }
+    const config = await loadProjectConfig(root);
+    if (config.kind !== "ok") {
+        return { success: false, error: configLoadError(config) };
+    }
+    try {
+        const filters = input
+            ? {
+                type: input.type,
+                status: input.status,
+                pathPrefix: input.path_prefix,
+            }
+            : undefined;
+        const documents = await listDocumentFiles(root, filters);
+        return { success: true, data: { documents } };
+    }
+    catch (err) {
+        return { success: false, error: toMcpError(err, "LIST_FAILED") };
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/app/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/app/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EACL,iBAAiB,EACjB,aAAa,GAGd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,cAAc,EAAoB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,EAAE;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY,EACZ,KAAwB,EACxB,cAA2B,cAAc,EACzC,WAAoB,KAAK;IAEzB,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC;QAC7B,IAAI,EAAE,cAAc;QACpB,WAAW;QACX,QAAQ;QACR,IAAI,EAAE,MAAM;KACb,CAAC,CAAC;IACH,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAoC,KAAK;YACpD,CAAC,CAAC;gBACE,IAAI,EAAE,KAAK,CAAC,IAAgC;gBAC5C,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,WAAW;aAC9B;YACH,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC;IAChD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/app/loadProjectConfig.d.ts

@@ -0,0 +1,16 @@
+import { ProjectConfig } from "../schemas/project.js";
+import { type McpError } from "../errors.js";
+export type ConfigLoadResult = {
+    kind: "ok";
+    config: ProjectConfig;
+} | {
+    kind: "missing";
+} | {
+    kind: "invalid";
+    error: McpError;
+};
+export declare function configLoadError(result: Extract<ConfigLoadResult, {
+    kind: "missing" | "invalid";
+}>): McpError;
+export declare function loadProjectConfig(root: string): Promise<ConfigLoadResult>;
+//# sourceMappingURL=loadProjectConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadProjectConfig.d.ts","sourceRoot":"","sources":["../../src/app/loadProjectConfig.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEzC,wBAAgB,eAAe,CAC7B,MAAM,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,IAAI,EAAE,SAAS,GAAG,SAAS,CAAA;CAAE,CAAC,GACjE,QAAQ,CAQV;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmC/E"}

package/dist/app/loadProjectConfig.js

@@ -0,0 +1,48 @@
+import { parse } from "yaml";
+import { ProjectConfig } from "../schemas/project.js";
+import { readProjectConfig } from "../adapters/fs/config.js";
+import {} from "../errors.js";
+export function configLoadError(result) {
+    if (result.kind === "missing") {
+        return {
+            code: "PROJECT_NOT_INITIALIZED",
+            message: "Project not initialized. Run project_init first.",
+        };
+    }
+    return result.error;
+}
+export async function loadProjectConfig(root) {
+    const raw = await readProjectConfig(root);
+    if (raw === null) {
+        return { kind: "missing" };
+    }
+    let parsed;
+    try {
+        parsed = parse(raw);
+    }
+    catch (err) {
+        return {
+            kind: "invalid",
+            error: {
+                code: "CONFIG_INVALID",
+                message: `Invalid project config: ${err instanceof Error ? err.message : String(err)}`,
+                details: { field: "config" },
+            },
+        };
+    }
+    const result = ProjectConfig.safeParse(parsed);
+    if (!result.success) {
+        const firstIssue = result.error.issues[0];
+        const field = firstIssue?.path.length ? String(firstIssue.path[0]) : "config";
+        return {
+            kind: "invalid",
+            error: {
+                code: "CONFIG_INVALID",
+                message: `Invalid project config: ${result.error.issues.map((issue) => issue.message).join("; ")}`,
+                details: { field, issues: result.error.issues },
+            },
+        };
+    }
+    return { kind: "ok", config: result.data };
+}
+//# sourceMappingURL=loadProjectConfig.js.map

package/dist/app/loadProjectConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadProjectConfig.js","sourceRoot":"","sources":["../../src/app/loadProjectConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAiB,MAAM,cAAc,CAAC;AAO7C,MAAM,UAAU,eAAe,CAC7B,MAAkE;IAElE,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,yBAAyB;YAC/B,OAAO,EAAE,kDAAkD;SAC5D,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,SAAS;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;gBACtF,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE;aAC7B;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC9E,OAAO;YACL,IAAI,EAAE,SAAS;YACf,KAAK,EAAE;gBACL,IAAI,EAAE,gBAAgB;gBACtB,OAAO,EAAE,2BAA2B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAClG,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE;aAChD;SACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC"}