@genvidtech/c3-domain-manager 0.0.1 → 0.6.1

package/dist/mcp/server.js

@@ -0,0 +1,519 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { ReadWriteLock, ExpectedChanges, exposeDocs, loadProjectConfig, isMcpError, mcpContent, paginatedContent, withMcpErrors, READ_ONLY, REGENERATE, MUTATE } from "@genvidtech/mcp-utils";
+import { formatDomainConfig } from "../domain/formatting.js";
+import { DomainConfigSchema } from "../domain/types.js";
+import { collectGlossary, findCollisions, formatGlossaryReport } from "../domain/glossary.js";
+import { validateBoundaries, formatBoundaryReport } from "../domain/relationships.js";
+import { validateEditorStrictness, formatEditorStrictnessReport } from "../domain/editorValidation.js";
+import { computeHealth, formatHealthReport } from "../domain/health.js";
+import { generateContextMap } from "../domain/contextMap.js";
+import { listUncategorized, listStaleOverrides, collectValidDomainNames, validateOverrideKeys, validateOverrideValues, } from "../domain/domainAnalysis.js";
+import { generateDomainIndex, computeDomainData } from "../domain/domainGenerator.js";
+import { resolveLocations } from "../adapters/locations.js";
+let PROJECT_ROOT = process.cwd();
+let EXTRACTED_DIR = path.join(PROJECT_ROOT, "extracted");
+let CONFIG_PATH = path.join(PROJECT_ROOT, "domain-config.json");
+let CONFIG_DIR = path.dirname(CONFIG_PATH);
+let CONFIG_FILENAME = path.basename(CONFIG_PATH);
+let CONFIG_WATCH_KEY = CONFIG_PATH.replace(/\\/g, "/");
+let EXTRACTED_EPHEMERAL = false;
+const server = new McpServer({ name: "c3-domain-manager", version: "1.0.0" }, { capabilities: { logging: {}, resources: {} } });
+const __pkgDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+exposeDocs(server, __pkgDir);
+// ── Server State ─────────────────────────────────────────────────────────────
+let txId = 0;
+let domainDirty = false;
+let suppressWatcherDepth = 0;
+const rwlock = new ReadWriteLock();
+const expectedChanges = new ExpectedChanges();
+let domainConfigCache = null;
+let domainDataCache = null;
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function emitLog(level, message) {
+    server.sendLoggingMessage({ level, logger: "c3-domain-manager", data: message }).catch(() => { });
+}
+function isWithinDir(fullPath, dir) {
+    return fullPath.startsWith(dir + path.sep) || fullPath === dir;
+}
+function readExtracted(relPath) {
+    const fullPath = path.resolve(path.join(EXTRACTED_DIR, relPath));
+    if (!isWithinDir(fullPath, EXTRACTED_DIR))
+        return null;
+    if (!fs.existsSync(fullPath))
+        return null;
+    return fs.readFileSync(fullPath, "utf-8");
+}
+function notFound(tool, hint) {
+    return {
+        content: [{ type: "text", text: `${tool}: ${hint}` }],
+        isError: true,
+    };
+}
+const STALE_WARNING_LINE = "[Warning: domain index may be stale — run regenerate to refresh]";
+const STALE_WARNING = "\n\n" + STALE_WARNING_LINE;
+function appendStaleWarning(text) {
+    return domainDirty ? text + STALE_WARNING : text;
+}
+// Footer for paginatedContent on index reads: the stale warning rides as a
+// trailing footer line (omitted entirely when the index is fresh).
+function staleFooter() {
+    return domainDirty ? () => STALE_WARNING_LINE : undefined;
+}
+const PAGINATION_PARAMS = {
+    offset: z.number().int().min(1).optional().describe("Start line (1-based). Omit to start from beginning."),
+    limit: z.number().int().min(1).optional().describe("Max lines to return. Omit to return all."),
+};
+// ── Domain Config Cache ───────────────────────────────────────────────────────
+async function loadDomainConfig() {
+    if (!domainConfigCache) {
+        const cfg = await loadProjectConfig(CONFIG_DIR, CONFIG_FILENAME, DomainConfigSchema);
+        if (isMcpError(cfg))
+            return cfg; // do NOT cache transient errors
+        domainConfigCache = cfg;
+    }
+    return domainConfigCache;
+}
+async function getDomainData() {
+    if (!domainDataCache) {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        domainDataCache = computeDomainData(PROJECT_ROOT, config);
+    }
+    return domainDataCache;
+}
+function writeDomainConfig(config) {
+    suppressWatcherDepth++;
+    try {
+        expectedChanges.add(CONFIG_WATCH_KEY);
+        fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, "\t") + "\n", "utf-8");
+    }
+    finally {
+        suppressWatcherDepth--;
+    }
+    // Caching the mutated object without re-validation is safe: the lenient
+    // .passthrough() schema still accepts it, and we own the mutation.
+    domainConfigCache = config;
+    txId++;
+    domainDirty = true;
+    emitLog("info", `domain-config.json updated (txId → ${txId})`);
+}
+// onError hook for the mutate tools: a write that throws (e.g. a failed
+// fs.writeFileSync) leaves txId un-bumped while the on-disk file may have
+// changed — and the watcher swallows its own event via expectedChanges — so the
+// client would never learn to reconcile. Bumping txId here forces a re-read.
+function onWriteError(err) {
+    txId++;
+    emitLog("error", `domain-config.json write failed (txId → ${txId}): ${err instanceof Error ? err.message : String(err)}`);
+}
+// ── Tools ─────────────────────────────────────────────────────────────────────
+server.registerTool("read-domain-index", {
+    title: "Read Domain Index",
+    description: "Read the domain index for a feature area. Without a domain, returns the master index listing all domains. With a domain name (e.g. 'Authentication'), returns that domain's detail page with functions, cross-domain dependencies, and include graphs.",
+    annotations: READ_ONLY,
+    inputSchema: {
+        domain: z.string().optional().describe("Domain name (e.g. 'Authentication'). Omit for master index."),
+        ...PAGINATION_PARAMS,
+    },
+}, async ({ domain, offset, limit }) => rwlock.read(async () => {
+    const relPath = domain
+        ? `domain-index/${domain}.md`
+        : "domain-index/index.md";
+    const text = readExtracted(relPath);
+    if (text === null) {
+        const indexText = readExtracted("domain-index/index.md");
+        const hint = domain
+            ? `No domain index found for '${domain}'. Available domains:\n${indexText ?? "(index not found)"}`
+            : "domain-index/index.md not found. Run 'npm run generate-domain' to generate it.";
+        return notFound("read-domain-index", hint);
+    }
+    return paginatedContent(text, { offset, limit }, staleFooter());
+}));
+server.registerTool("read-domain-config", {
+    title: "Read Domain Config",
+    description: "Read the raw domain-config.json structure. Returns domains, shared subdomains, and overrides " +
+        "in a formatted text view. Use 'section' to filter to a specific part.",
+    annotations: READ_ONLY,
+    inputSchema: {
+        section: z.enum(["domains", "sharedSubdomains", "overrides", "all"]).default("all")
+            .describe("Which section to return (default: all)"),
+    },
+}, async ({ section }) => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const text = formatDomainConfig(config, section);
+        return { content: [{ type: "text", text }] };
+    }
+    catch (e) {
+        return notFound("read-domain-config", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("list-uncategorized", {
+    title: "List Uncategorized Files",
+    description: "List project files (eventSheets, layouts, scripts) not covered by any domain mapping or override in domain-config.json. Useful for maintaining domain coverage.",
+    annotations: READ_ONLY,
+    inputSchema: {},
+}, async () => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const uncategorized = listUncategorized(PROJECT_ROOT, config);
+        if (uncategorized.length === 0) {
+            return { content: [{ type: "text", text: "All files are categorized." }] };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${uncategorized.length} uncategorized files:\n${uncategorized.join("\n")}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return notFound("list-uncategorized", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("list-stale-overrides", {
+    title: "List Stale Overrides",
+    description: "List override entries in domain-config.json that point to files that no longer exist on disk. These should be removed to keep the domain config clean.",
+    annotations: READ_ONLY,
+    inputSchema: {},
+}, async () => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const stale = listStaleOverrides(PROJECT_ROOT, config);
+        if (stale.length === 0) {
+            return { content: [{ type: "text", text: "No stale overrides found." }] };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${stale.length} stale overrides:\n${stale.join("\n")}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return notFound("list-stale-overrides", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("set-overrides", {
+    title: "Set Domain Overrides",
+    description: "Add or update overrides in domain-config.json. Each override maps a file path " +
+        "(e.g. 'eventSheets/Foo.json') to a domain or subdomain name. The domain must exist in the config.",
+    annotations: MUTATE,
+    inputSchema: {
+        overrides: z.record(z.string(), z.string())
+            .describe("File path → domain/subdomain name"),
+        txId: z.number().optional()
+            .describe("Expected txId for optimistic concurrency — rejected if stale"),
+    },
+}, async ({ overrides: newOverrides, txId: expectedTxId }) => rwlock.write(withMcpErrors(async () => {
+    if (expectedTxId !== undefined && expectedTxId !== txId) {
+        return {
+            content: [{ type: "text", text: `State changed: expected txId ${expectedTxId}, got ${txId}. Re-read state and retry.` }],
+            isError: true,
+        };
+    }
+    const config = await loadDomainConfig();
+    if (isMcpError(config))
+        return config;
+    const validNames = collectValidDomainNames(config);
+    const keyErrors = validateOverrideKeys(Object.keys(newOverrides));
+    const valueErrors = validateOverrideValues(newOverrides, validNames);
+    const errors = [...keyErrors, ...valueErrors];
+    if (errors.length > 0) {
+        return {
+            content: [{ type: "text", text: `Validation failed:\n${errors.join("\n")}` }],
+            isError: true,
+        };
+    }
+    if (!config.overrides)
+        config.overrides = {};
+    const added = [];
+    const updated = [];
+    for (const [filePath, domain] of Object.entries(newOverrides)) {
+        if (filePath in config.overrides) {
+            updated.push(`${filePath}: ${config.overrides[filePath]} → ${domain}`);
+        }
+        else {
+            added.push(`${filePath} → ${domain}`);
+        }
+        config.overrides[filePath] = domain;
+    }
+    writeDomainConfig(config);
+    const parts = [];
+    if (added.length > 0)
+        parts.push(`Added ${added.length}:\n${added.join("\n")}`);
+    if (updated.length > 0)
+        parts.push(`Updated ${updated.length}:\n${updated.join("\n")}`);
+    return mcpContent(parts.join("\n\n"), `txId: ${txId}`);
+}, { onError: onWriteError })));
+server.registerTool("remove-overrides", {
+    title: "Remove Domain Overrides",
+    description: "Remove overrides from domain-config.json by file path. " +
+        "Non-existent keys are silently ignored. Use after list-stale-overrides to clean up.",
+    annotations: MUTATE,
+    inputSchema: {
+        paths: z.array(z.string())
+            .describe("File paths to remove from overrides"),
+        txId: z.number().optional()
+            .describe("Expected txId for optimistic concurrency — rejected if stale"),
+    },
+}, async ({ paths, txId: expectedTxId }) => rwlock.write(withMcpErrors(async () => {
+    if (expectedTxId !== undefined && expectedTxId !== txId) {
+        return {
+            content: [{ type: "text", text: `State changed: expected txId ${expectedTxId}, got ${txId}. Re-read state and retry.` }],
+            isError: true,
+        };
+    }
+    const config = await loadDomainConfig();
+    if (isMcpError(config))
+        return config;
+    if (!config.overrides || Object.keys(config.overrides).length === 0) {
+        return { content: [{ type: "text", text: "No overrides to remove." }] };
+    }
+    const removed = [];
+    for (const p of paths) {
+        if (p in config.overrides) {
+            removed.push(`${p} (was: ${config.overrides[p]})`);
+            delete config.overrides[p];
+        }
+    }
+    if (removed.length === 0) {
+        return { content: [{ type: "text", text: "None of the specified paths were in overrides." }] };
+    }
+    writeDomainConfig(config);
+    return mcpContent(`Removed ${removed.length}:\n${removed.join("\n")}`, `txId: ${txId}`);
+}, { onError: onWriteError })));
+server.registerTool("regenerate", {
+    title: "Regenerate Domain Index",
+    description: "Run the domain index generator and update extracted/domain-index/. Clears the domainDirty flag. Use after external edits to domain-config.json or source files, or when domainDirty is true.",
+    annotations: REGENERATE,
+    inputSchema: {},
+}, async () => rwlock.write(async () => {
+    const lines = [];
+    const log = (...args) => lines.push(args.map(String).join(" "));
+    try {
+        suppressWatcherDepth++;
+        try {
+            await generateDomainIndex(PROJECT_ROOT, EXTRACTED_DIR, CONFIG_DIR, CONFIG_FILENAME, log);
+        }
+        finally {
+            suppressWatcherDepth--;
+        }
+        // Populate domain data cache
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        domainDataCache = computeDomainData(PROJECT_ROOT, config);
+        domainDirty = false;
+        return {
+            content: [{ type: "text", text: lines.join("\n") }],
+        };
+    }
+    catch (e) {
+        return {
+            content: [{ type: "text", text: `Error: ${e instanceof Error ? e.message : String(e)}` }],
+            isError: true,
+        };
+    }
+}));
+server.registerTool("get-state", {
+    title: "Get Server State",
+    description: "Returns the current server state: txId (incremented on domain-config.json changes) and domainDirty (true if domain-config.json or source files changed since last regeneration).",
+    annotations: READ_ONLY,
+    inputSchema: {},
+}, async () => rwlock.read(async () => {
+    return {
+        content: [{ type: "text", text: `txId: ${txId}\ndomainDirty: ${domainDirty}` }],
+    };
+}));
+server.registerTool("glossary-check", {
+    title: "Check Glossary Collisions",
+    description: "Check for glossary term collisions across domains. Reports terms that appear in multiple domains with different definitions.",
+    annotations: READ_ONLY,
+    inputSchema: {},
+}, async () => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const entries = collectGlossary(config);
+        const collisions = findCollisions(entries);
+        const report = formatGlossaryReport(collisions);
+        return { content: [{ type: "text", text: report }] };
+    }
+    catch (e) {
+        return notFound("glossary-check", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("validate-boundaries", {
+    title: "Validate Domain Boundaries",
+    description: "Validate domain boundaries by checking for undeclared cross-domain dependencies, stale relationship declarations, and forbidden dependency patterns (e.g., supporting domains depending on core domains).",
+    annotations: READ_ONLY,
+    inputSchema: {
+        domain: z.string().optional().describe("Filter violations to a specific domain"),
+    },
+}, async ({ domain }) => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const data = await getDomainData();
+        if (isMcpError(data))
+            return data;
+        const { domains } = data;
+        const report = validateBoundaries(domains, config, domain);
+        const text = formatBoundaryReport(report);
+        return { content: [{ type: "text", text: appendStaleWarning(text) }] };
+    }
+    catch (e) {
+        return notFound("validate-boundaries", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("validate-editor", {
+    title: "Validate Editor Strictness",
+    description: "Report event sheets the C3 editor would reject on import (editor-strictness validation). Flags variable events missing a comment and group events missing a description — fields the C3 editor loader requires but the lenient parse types allow to be absent. Validates sheets fresh from disk, so its result is independent of domain-index staleness.",
+    annotations: READ_ONLY,
+    inputSchema: {},
+}, async () => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const report = validateEditorStrictness(PROJECT_ROOT, config);
+        // No appendStaleWarning: this diagnostic re-walks sheets fresh and never
+        // reads the cached domain index, so the index-staleness warning would mislead.
+        return { content: [{ type: "text", text: formatEditorStrictnessReport(report) }] };
+    }
+    catch (e) {
+        return notFound("validate-editor", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("domain-health", {
+    title: "Domain Health Metrics",
+    description: "Compute coupling and instability metrics for domains. Ca = afferent coupling (incoming dependencies), Ce = efferent coupling (outgoing dependencies), Instability = Ce/(Ca+Ce).",
+    annotations: READ_ONLY,
+    inputSchema: {
+        domain: z.string().optional().describe("Compute metrics for a specific domain only"),
+    },
+}, async ({ domain: domainFilter }) => rwlock.read(async () => {
+    try {
+        const data = await getDomainData();
+        if (isMcpError(data))
+            return data;
+        const { domains } = data;
+        let targetDomains = domains;
+        if (domainFilter) {
+            targetDomains = domains.filter(d => d.name === domainFilter);
+            if (targetDomains.length === 0) {
+                return notFound("domain-health", `Domain '${domainFilter}' not found`);
+            }
+        }
+        const results = targetDomains.map(d => ({ name: d.name, ...computeHealth(d) }));
+        const text = formatHealthReport(results);
+        return { content: [{ type: "text", text: appendStaleWarning(text) }] };
+    }
+    catch (e) {
+        return notFound("domain-health", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+server.registerTool("context-map", {
+    title: "Generate Context Map",
+    description: "Generate a context map showing relationships between domains. Supports text and mermaid output formats. Use 'domain' parameter to focus on a single domain's neighborhood.",
+    annotations: READ_ONLY,
+    inputSchema: {
+        format: z.enum(["text", "mermaid"]).describe("Output format"),
+        domain: z.string().optional().describe("Focus on this domain's 1-hop neighborhood"),
+        includeObserved: z.boolean().optional().default(true).describe("Include observed (undeclared) dependencies"),
+    },
+}, async ({ format, domain, includeObserved }) => rwlock.read(async () => {
+    try {
+        const config = await loadDomainConfig();
+        if (isMcpError(config))
+            return config;
+        const data = await getDomainData();
+        if (isMcpError(data))
+            return data;
+        const { domains } = data;
+        const text = generateContextMap(domains, config, { format, domain, includeObserved });
+        return { content: [{ type: "text", text: appendStaleWarning(text) }] };
+    }
+    catch (e) {
+        return notFound("context-map", `Error: ${e instanceof Error ? e.message : String(e)}`);
+    }
+}));
+// ── File Watcher ─────────────────────────────────────────────────────────────
+function setupWatcher() {
+    if (!fs.existsSync(CONFIG_PATH))
+        return;
+    fs.watch(CONFIG_PATH, () => {
+        if (suppressWatcherDepth > 0)
+            return;
+        if (expectedChanges.consume(CONFIG_WATCH_KEY))
+            return;
+        txId++;
+        domainDirty = true;
+        domainConfigCache = null;
+        domainDataCache = null;
+        emitLog("warning", `External change detected: domain-config.json (txId → ${txId})`);
+    });
+    // Periodically purge expired entries from expectedChanges
+    setInterval(() => expectedChanges.purgeExpired(), 30_000).unref();
+}
+// ── Start ─────────────────────────────────────────────────────────────────────
+export async function startServer(loc = resolveLocations({}, process.cwd())) {
+    PROJECT_ROOT = loc.projectRoot;
+    EXTRACTED_DIR = loc.extractedDir;
+    CONFIG_PATH = loc.configPath;
+    CONFIG_DIR = loc.configDir;
+    CONFIG_FILENAME = loc.configFileName;
+    CONFIG_WATCH_KEY = loc.configWatchKey;
+    EXTRACTED_EPHEMERAL = loc.extractedEphemeral;
+    const domainIndexPath = path.join(EXTRACTED_DIR, "domain-index");
+    if (!fs.existsSync(domainIndexPath)) {
+        console.error(`[c3-domain-manager] domain-index not found — auto-generating...`);
+        try {
+            const log = (...args) => console.error(`[c3-domain-manager]   ${args.map(String).join(" ")}`);
+            await generateDomainIndex(PROJECT_ROOT, EXTRACTED_DIR, CONFIG_DIR, CONFIG_FILENAME, log);
+            console.error(`[c3-domain-manager] Auto-generation complete`);
+        }
+        catch (e) {
+            console.error(`[c3-domain-manager] Warning: auto-generation failed — ${e instanceof Error ? e.message : String(e)}`);
+            console.error(`[c3-domain-manager] Run 'npx c3-domain-manager generate' manually to generate domain index`);
+        }
+    }
+    console.error(`[c3-domain-manager] Starting server in ${PROJECT_ROOT}`);
+    console.error(`[c3-domain-manager] config: ${CONFIG_PATH}${EXTRACTED_EPHEMERAL ? " | extracted: ephemeral" : ""}`);
+    // Graceful shutdown
+    function shutdown() {
+        console.error("[c3-domain-manager] Shutting down...");
+        server.close().catch(() => { });
+        if (EXTRACTED_EPHEMERAL) {
+            try {
+                fs.rmSync(EXTRACTED_DIR, { recursive: true, force: true });
+            }
+            catch { /* best-effort */ }
+        }
+        process.exit(0);
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    setupWatcher();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/docs/TOC.md

@@ -0,0 +1,27 @@
+# Documentation Index
+
+<!--
+Genvid plugin skills consult this index to find your project's docs.
+Each entry should be a one-line description.
+-->
+
+## Project context
+
+- `domain-architecture.md` — the domain model concepts and the full `domain-config.json` schema
+
+## Operations
+
+- `releasing.md` — how to cut a new release (version bump, tag convention, OIDC publish via `publish.yml`)
+
+## Decision Records
+
+Architecture Decision Records, numbered chronologically by when the decision was made.
+
+- `decisions/0001-adopt-c3source-extractors.md` — retire local `extraction.ts`; consume c3source 1.1.0 `extractFunctions`/`extractIncludes` (issue #5)
+- `decisions/0002-configurable-locations-adapters-seam.md` — make the config path and extracted-output dir overridable via a pure `src/adapters/locations.ts` resolution seam (issue #7)
+- `decisions/0003-adopt-loadprojectconfig-schema-first.md` — adopt mcp-utils 0.3.0 `loadProjectConfig`; make `DomainConfig` schema-first via `DomainConfigSchema` (issue #9)
+- `decisions/0004-adopt-mcp-utils-0.4.0-helpers.md` — adopt mcp-utils 0.4.0 `mcpContent`/`paginatedContent`/`withMcpErrors` + annotation constants; harden mutate writes (issue #11)
+- `decisions/0005-validateforeditor-read-side-diagnostic.md` — adopt c3source 1.4.0 `validateForEditor` as a read-side diagnostic, reframing #12's "before write-out" premise (issue #13)
+- `decisions/0006-event-variable-reference-coupling.md` — add event-variable references as a second cross-domain coupling source aggregated under union semantics (issue #14)
+- `decisions/0007-project-dir-resolverootfolder.md` — add `--project-dir` via mcp-utils 0.5.0 `resolveRootFolder` instead of hand-rolling root discovery (issue #16)
+- `decisions/0008-adopt-openproject-option-a.md` — adopt `C3Project`/`openProject` for C3 file discovery in place of hardcoded section-folder joins (Option A: local-open in pure functions; issue #19)

package/docs/decisions/0001-adopt-c3source-extractors.md

@@ -0,0 +1,67 @@
+# ADR 0001: Adopt `@genvid/c3source` 1.1.0 event-tree extractors; retire local `extraction.ts`
+
+**Status:** Accepted
+**Date:** 2026-06-02
+**Issue:** #5 — adopt upstream extractors once c3source 1.1.0 ships them
+
+> Recovered retroactively (2026-06-30) from commit `1fe2638` and the
+> CLAUDE.md "When bumping `@genvidtech/c3source`" guidance. Numbered first
+> because it is the earliest architectural decision in the project's history.
+
+---
+
+## Context
+
+`c3-domain-manager` needs the exported function signatures and the include
+edges out of each parsed event sheet. Originally this lived in a local
+`src/domain/extraction.ts` that walked the C3 event tree by hand — stringly-typed
+`eventType` checks and `as` casts over the raw event JSON — because the upstream
+`@genvid/c3source` package did not yet expose typed extractors.
+
+c3source 1.1.0 landed both upstream requests this had been waiting on: a typed
+`extractFunctions(sheet)` over the `EventSheetEvent` union (upstream #23) and
+`extractIncludes(sheet)` (upstream #24). c3source owns the Construct 3 platform
+facts, so its typed extractors are authoritative where our hand-rolled walk was a
+fragile re-derivation. Per the standing CLAUDE.md guidance ("when bumping
+c3source, check whether new exports supersede local C3-parsing logic"), the bump
+triggered an evaluation of whether to retire the local walk.
+
+## Decision
+
+**Delete `src/domain/extraction.ts` and consume c3source's typed extractors
+directly.** `domainGenerator.ts` calls `extractFunctions` / `extractIncludes`
+and maps the typed output onto our local types:
+
+- `extractFunctionDefs(sheet, sheetName)` is retained as one small exported
+  seam that maps c3source's `ExtractedFunction` → our `FunctionDef`
+  (param-string formatting, `sourceSheet`, and the custom-ACE
+  `objectClass`/`aceName` fields).
+- Includes become `extractIncludes(sheet).map(r => r.includeSheet)`.
+- `types.ts` re-exports c3source's `FunctionParameter` instead of defining a
+  byte-identical local copy.
+
+## Alternatives Considered
+
+**Keep the hand-rolled walk.** Rejected: it duplicates platform knowledge that
+c3source now owns and maintains, and the stringly-typed checks would silently rot
+as the C3 event schema evolves. The typed extractors eliminate the `as` casts.
+
+**Wrap c3source's extractors behind a local abstraction layer.** Rejected as
+premature — only the thin `extractFunctionDefs` mapping seam is needed to bridge
+to our `FunctionDef`; a broader abstraction would add indirection without a
+second consumer to justify it.
+
+## Consequences
+
+- The local event-tree walk is gone; c3source is now the single source of truth
+  for function and include extraction. This is the pattern later decisions follow
+  (see [[0005-validateforeditor-read-side-diagnostic]] and
+  [[0008-adopt-openproject-option-a]]): a c3source release ships a primitive that
+  retires a hand-rolled equivalent here.
+- Behaviour-preserving: the full suite (130 tests at the time) stayed green and
+  generated output was unchanged.
+- Removing the exported `extraction.ts` symbols is a public-API change. At 0.x a
+  breaking removal takes a **minor** bump, so this shipped as 0.1.3 → 0.2.0
+  (clarified in the release docs at the same time).
+- `extractFunctionDefs` remains the one seam to maintain when c3source's
+  `ExtractedFunction` shape changes.