ai-spector 0.9.20 → 0.9.21

package/dist/core/docops/layout-classify.js

@@ -0,0 +1,293 @@
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { basename, join } from "node:path";
+import { loadBasicDesignListManifest, loadDocumentsManifest, packageBundleRoot, } from "../config/load.js";
+const FILENAME_WEIGHT = 0.55;
+const HEADING_WEIGHT = 0.45;
+const LANG_CODE = /^[a-z]{2,3}(?:-[a-z]{2})?$/i;
+const LAYER_PREFIX = /^(?:docs\/srs|docs\/basic-design|docs\/detail-design|docs\/dd|docs\/detail_design)\/([^/]+)(?:\/(.+))?$/;
+const DOMAIN_ID_RE = /\b(UC|F|SCR|API)-(\d+)\b/gi;
+const PROTOTYPE_SOURCE_DIRS = ["prototype/src", "prototype", "docs/prototype"];
+const SPA_FRAMEWORKS = ["react", "vue", "@vue/", "next", "nuxt", "svelte"];
+const PROTOTYPE_EXTENSIONS = new Set([".html", ".htm", ".tsx", ".jsx", ".vue"]);
+let srsManifestCache = null;
+let basicDesignManifestCache = null;
+let detailDesignManifestCache = null;
+function readManifestSync(filename) {
+    const raw = readFileSync(join(packageBundleRoot(), filename), "utf8");
+    const manifest = JSON.parse(raw);
+    if (!manifest.templatesDir || !Array.isArray(manifest.documents)) {
+        throw new Error(`Invalid ${filename} in ${packageBundleRoot()}`);
+    }
+    return manifest;
+}
+function firstHeadingFromTemplate(templatesDir, template) {
+    const path = join(packageBundleRoot(), templatesDir, template);
+    try {
+        const content = readFileSync(path, "utf8");
+        for (const line of content.split(/\r?\n/)) {
+            const match = line.match(/^#{1,6}\s+(.+?)\s*$/);
+            if (match) {
+                return match[1].replace(/\{[^}]+\}/g, "").trim();
+            }
+        }
+    }
+    catch {
+        // fall through
+    }
+    return headingFromFilename(template);
+}
+function headingFromFilename(template) {
+    const stem = template.replace(/\.md$/i, "").replace(/-template$/i, "");
+    const parts = stem.split("-").filter((part) => !/^\d+$/.test(part));
+    return parts
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ")
+        .trim();
+}
+function buildManifestEntries(manifest) {
+    return manifest.documents.map((doc) => ({
+        template: doc.template,
+        heading: firstHeadingFromTemplate(manifest.templatesDir, doc.template),
+    }));
+}
+function getManifestEntries(layer) {
+    if (layer === "srs") {
+        if (!srsManifestCache) {
+            srsManifestCache = buildManifestEntries(readManifestSync("documents.json"));
+        }
+        return srsManifestCache;
+    }
+    if (layer === "basic-design") {
+        if (!basicDesignManifestCache) {
+            basicDesignManifestCache = buildManifestEntries(readManifestSync("documents-basic-design.json"));
+        }
+        return basicDesignManifestCache;
+    }
+    if (!detailDesignManifestCache) {
+        detailDesignManifestCache = buildManifestEntries(readManifestSync("documents-detail-design.json"));
+    }
+    return detailDesignManifestCache;
+}
+function normalizeLabel(text) {
+    return text
+        .replace(/^[\d.]+\s*/, "")
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}\s-]/gu, "")
+        .trim()
+        .replace(/\s+/g, "-")
+        .replace(/-+/g, "-");
+}
+function normalizeFilename(name) {
+    return basename(name).replace(/\.md$/i, "").toLowerCase();
+}
+function filenameStem(name) {
+    return normalizeFilename(name).replace(/^\d+-/, "").replace(/-template$/, "");
+}
+function textSimilarity(a, b) {
+    const left = normalizeLabel(a);
+    const right = normalizeLabel(b);
+    if (!left || !right)
+        return 0;
+    if (left === right)
+        return 1;
+    if (left.includes(right) || right.includes(left))
+        return 0.9;
+    const leftTokens = new Set(left.split("-").filter(Boolean));
+    const rightTokens = new Set(right.split("-").filter(Boolean));
+    const union = new Set([...leftTokens, ...rightTokens]);
+    let intersection = 0;
+    for (const token of leftTokens) {
+        if (rightTokens.has(token))
+            intersection += 1;
+    }
+    return union.size === 0 ? 0 : intersection / union.size;
+}
+function firstHeadingText(headings) {
+    const h1 = headings.find((heading) => heading.depth === 1);
+    if (h1)
+        return h1.text.trim();
+    return headings[0]?.text.trim() ?? "";
+}
+function scoreAgainstManifestEntry(file, entry) {
+    const filenameScore = textSimilarity(filenameStem(file.relativePath), filenameStem(entry.template));
+    const headingScore = textSimilarity(firstHeadingText(file.headings), entry.heading);
+    return FILENAME_WEIGHT * filenameScore + HEADING_WEIGHT * headingScore;
+}
+export function scoreBuiltinMatch(file, layer) {
+    const entries = getManifestEntries(layer);
+    let best = 0;
+    for (const entry of entries) {
+        best = Math.max(best, scoreAgainstManifestEntry(file, entry));
+    }
+    return best;
+}
+export function classifyLayer(files, layer) {
+    if (files.length === 0)
+        return "missing";
+    const scores = files.map((file) => scoreBuiltinMatch(file, layer));
+    const alignedCount = scores.filter((score) => score >= 0.6).length;
+    const alignedRatio = alignedCount / files.length;
+    const averageScore = scores.reduce((sum, score) => sum + score, 0) / scores.length;
+    if (alignedRatio >= 0.7)
+        return "builtin-aligned";
+    const hasDomainIds = files.some((file) => {
+        const ids = file.ids ?? (file.content ? extractDomainIds(file.content) : []);
+        return ids.length > 0;
+    });
+    if (hasDomainIds && averageScore < 0.7)
+        return "reshaped";
+    return "reshaped";
+}
+export function detectLanguageLayout(paths) {
+    const normalized = paths.map((path) => path.replace(/\\/g, "/"));
+    const langs = new Set();
+    let flatCount = 0;
+    let langFolderCount = 0;
+    for (const path of normalized) {
+        const match = path.match(LAYER_PREFIX);
+        if (!match)
+            continue;
+        const segment = match[1];
+        const remainder = match[2];
+        if (!remainder) {
+            if (segment.endsWith(".md"))
+                flatCount += 1;
+            continue;
+        }
+        if (LANG_CODE.test(segment)) {
+            langs.add(segment.toLowerCase());
+            langFolderCount += 1;
+        }
+        else if (segment.endsWith(".md")) {
+            flatCount += 1;
+        }
+    }
+    const detected = [...langs].sort();
+    if (langFolderCount > 0 && flatCount > 0) {
+        return { detected, strategy: "mixed" };
+    }
+    if (langFolderCount > 0) {
+        return { detected, strategy: "per-lang-folders" };
+    }
+    return { detected: [], strategy: "flat" };
+}
+export function extractDomainIds(content) {
+    const seen = new Set();
+    const ids = [];
+    for (const match of content.matchAll(DOMAIN_ID_RE)) {
+        const id = `${match[1].toUpperCase()}-${match[2]}`;
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        ids.push(id);
+    }
+    return ids;
+}
+function collectPrototypeFiles(root) {
+    const byRoot = new Map();
+    for (const relDir of PROTOTYPE_SOURCE_DIRS) {
+        const absDir = join(root, relDir);
+        const files = [];
+        walkPrototypeDir(absDir, files);
+        if (files.length > 0)
+            byRoot.set(relDir, files);
+    }
+    return byRoot;
+}
+function walkPrototypeDir(currentDir, files) {
+    let entries;
+    try {
+        entries = readdirSync(currentDir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.name.startsWith("."))
+            continue;
+        const absPath = join(currentDir, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules")
+                continue;
+            walkPrototypeDir(absPath, files);
+            continue;
+        }
+        const ext = entry.name.slice(entry.name.lastIndexOf(".")).toLowerCase();
+        if (PROTOTYPE_EXTENSIONS.has(ext)) {
+            files.push(absPath);
+        }
+    }
+}
+function hasSpaDependency(packageJsonPath) {
+    try {
+        const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+        const deps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        return Object.keys(deps).some((name) => SPA_FRAMEWORKS.some((framework) => framework.endsWith("/") ? name.startsWith(framework) : name === framework));
+    }
+    catch {
+        return false;
+    }
+}
+function classifyPrototypeFiles(filesByRoot, root) {
+    const prototypePkg = join(root, "prototype", "package.json");
+    if (pathExistsSync(prototypePkg) && hasSpaDependency(prototypePkg)) {
+        return "spa";
+    }
+    const allFiles = [...filesByRoot.values()].flat();
+    const hasSpaSource = allFiles.some((file) => {
+        const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
+        return ext === ".tsx" || ext === ".jsx" || ext === ".vue";
+    });
+    if (hasSpaSource)
+        return "spa";
+    const hasHtml = allFiles.some((file) => {
+        const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
+        return ext === ".html" || ext === ".htm";
+    });
+    if (hasHtml) {
+        const canonical = [
+            ...(filesByRoot.get("prototype") ?? []),
+            ...(filesByRoot.get("prototype/src") ?? []),
+        ];
+        const legacy = filesByRoot.get("docs/prototype") ?? [];
+        if (legacy.length > 0 && canonical.length === 0)
+            return "disconnected";
+        return "static-html";
+    }
+    return "missing";
+}
+function pathExistsSync(path) {
+    try {
+        statSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function classifyDataSource(srsMdCount, dataSourceMdCount) {
+    if (dataSourceMdCount === 0)
+        return "absent";
+    if (srsMdCount === 0)
+        return "present";
+    if (dataSourceMdCount >= srsMdCount)
+        return "present";
+    return "partial";
+}
+export async function classifyPrototype(root) {
+    await Promise.all([loadDocumentsManifest(), loadBasicDesignListManifest()]);
+    const filesByRoot = collectPrototypeFiles(root);
+    if (filesByRoot.size === 0)
+        return "missing";
+    return classifyPrototypeFiles(filesByRoot, root);
+}
+/** Reset cached manifest entries — for tests only. */
+export function resetLayoutClassifyCacheForTests() {
+    srsManifestCache = null;
+    basicDesignManifestCache = null;
+    detailDesignManifestCache = null;
+}
+//# sourceMappingURL=layout-classify.js.map

package/dist/core/docops/layout-classify.js.map

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

package/dist/core/docops/layout.d.ts

@@ -0,0 +1,27 @@
+import { type DocopsLangStrategy, type DocopsLayerClass } from "./layout-classify.js";
+declare const LAYER_KEYS: readonly ["srs", "basicDesign", "detailDesign"];
+type LayerKey = (typeof LAYER_KEYS)[number];
+export interface DocopsLayerOnDisk {
+    configuredPath: string | null;
+    roots: Array<{
+        path: string;
+        fileCount: number;
+    }>;
+    languageLayout: DocopsLangStrategy;
+    detectedLanguages: string[];
+    classification: DocopsLayerClass;
+}
+export interface DocopsLayoutProbeResult {
+    probedAt: string;
+    configuredPaths: Partial<Record<LayerKey, string>>;
+    onDisk: Partial<Record<LayerKey, DocopsLayerOnDisk>>;
+    dataSource: {
+        path: string;
+        fileCount: number;
+    } | null;
+    suggestions: string[];
+    agentPrompt: string;
+}
+export declare function probeDocopsLayout(projectRoot?: string): Promise<DocopsLayoutProbeResult>;
+export {};
+//# sourceMappingURL=layout.d.ts.map

package/dist/core/docops/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/core/docops/layout.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,QAAA,MAAM,UAAU,iDAAkD,CAAC;AACnE,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAQ5C,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,cAAc,EAAE,kBAAkB,CAAC;IACnC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,gBAAgB,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrD,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAqID,wBAAsB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA6E9F"}

package/dist/core/docops/layout.js

@@ -0,0 +1,181 @@
+import { readdir } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { findProjectRoot } from "../config/load.js";
+import { pathExists } from "../util/fs.js";
+import { readDocopsConfig } from "./config.js";
+import { classifyDataSource, classifyLayer, classifyPrototype, detectLanguageLayout, } from "./layout-classify.js";
+const LAYER_KEYS = ["srs", "basicDesign", "detailDesign"];
+const DISCOVERY_ALIASES = {
+    srs: ["docs/srs"],
+    basicDesign: ["docs/basic-design", "docs/bd", "docs/basic_design"],
+    detailDesign: ["docs/detail-design", "docs/dd", "docs/detail_design"],
+};
+async function collectMdFiles(absDir) {
+    if (!(await pathExists(absDir)))
+        return [];
+    const results = [];
+    async function walk(current) {
+        let entries;
+        try {
+            entries = await readdir(current, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith("."))
+                continue;
+            const full = join(current, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === "node_modules")
+                    continue;
+                await walk(full);
+                continue;
+            }
+            if (entry.isFile() && entry.name.endsWith(".md")) {
+                results.push(full);
+            }
+        }
+    }
+    await walk(absDir);
+    return results.sort();
+}
+function stripLayerPrefix(layerKey, projectRel) {
+    const prefixes = {
+        srs: /^docs\/srs\//,
+        basicDesign: /^docs\/(?:basic-design|bd|basic_design)\//,
+        detailDesign: /^docs\/(?:detail-design|dd|detail_design)\//,
+    };
+    return projectRel.replace(prefixes[layerKey], "");
+}
+function buildSuggestions(result) {
+    const lines = [];
+    for (const key of LAYER_KEYS) {
+        const layer = result.onDisk[key];
+        const configured = result.configuredPaths[key];
+        if (!layer)
+            continue;
+        const primaryRoot = layer.roots[0];
+        if (!primaryRoot || primaryRoot.fileCount === 0) {
+            if (configured) {
+                lines.push(`No markdown under configured docTypes.${key}.path (${configured}) — add docs or point path at an existing folder.`);
+            }
+            continue;
+        }
+        const topRoot = layer.roots.reduce((a, b) => (b.fileCount > a.fileCount ? b : a));
+        if (configured && topRoot.path !== configured.replace(/\\/g, "/")) {
+            lines.push(`Docs for ${key} found under ${topRoot.path} (${topRoot.fileCount} file(s)) but config says ${configured} — ` +
+                `edit docTypes.${key}.path in .docops/docops.config.json OR move files (prefer editing config).`);
+        }
+        if (layer.languageLayout === "flat") {
+            lines.push(`${key}: files are flat (no per-language subfolders). Recommended: docs/<layer>/{lang}/… or set primaryLanguage in config.`);
+        }
+        if (layer.languageLayout === "mixed") {
+            lines.push(`${key}: mixed flat and per-language folders — normalize layout or document primaryLanguage.`);
+        }
+    }
+    if (lines.length === 0) {
+        lines.push("On-disk layout matches configured paths. Run: npx ai-spector docops check — then docops migrate --repair if contract gaps remain.");
+    }
+    lines.push("See .docops/guide/guides/PROJECT_LAYOUT.md and MIGRATION.md for path conventions.");
+    return lines;
+}
+function buildAgentPrompt(result) {
+    const lines = [
+        "Probe doc layout for this repo (read-only — no file moves).",
+        "",
+        "Configured paths:",
+    ];
+    for (const key of LAYER_KEYS) {
+        const path = result.configuredPaths[key] ?? "(not in config)";
+        lines.push(`- ${key}: ${path}`);
+    }
+    lines.push("", "On disk:");
+    for (const key of LAYER_KEYS) {
+        const layer = result.onDisk[key];
+        if (!layer) {
+            lines.push(`- ${key}: (not scanned)`);
+            continue;
+        }
+        const roots = layer.roots.map((r) => `${r.path} (${r.fileCount})`).join(", ") || "none";
+        lines.push(`- ${key}: ${roots} | languages: ${layer.languageLayout} [${layer.detectedLanguages.join(", ")}] | class: ${layer.classification}`);
+    }
+    if (result.dataSource) {
+        lines.push(`- data-source: ${result.dataSource.path} (${result.dataSource.fileCount} file(s))`);
+    }
+    lines.push("", "Suggestions:");
+    for (const [i, s] of result.suggestions.entries()) {
+        lines.push(`${i + 1}. ${s}`);
+    }
+    lines.push("", "Next: edit .docops/docops.config.json (docTypes.*.path, languages), customize .docops/templates/ if needed, then:", "  npx ai-spector docops migrate --repair", "  npx ai-spector index", "  npx ai-spector docops check --prompt");
+    return lines.join("\n");
+}
+export async function probeDocopsLayout(projectRoot) {
+    const root = projectRoot ?? findProjectRoot();
+    const config = await readDocopsConfig(root);
+    const configuredPaths = {};
+    if (config?.docTypes) {
+        for (const key of LAYER_KEYS) {
+            const path = config.docTypes[key]?.path?.trim();
+            if (path)
+                configuredPaths[key] = path.replace(/\\/g, "/");
+        }
+    }
+    const onDisk = {};
+    let srsMdCount = 0;
+    for (const key of LAYER_KEYS) {
+        const configuredPath = configuredPaths[key] ?? null;
+        const candidates = new Set();
+        if (configuredPath)
+            candidates.add(configuredPath);
+        for (const alias of DISCOVERY_ALIASES[key]) {
+            candidates.add(alias);
+        }
+        const roots = [];
+        const allPaths = [];
+        const classifyFiles = [];
+        for (const rel of candidates) {
+            const abs = join(root, rel);
+            const files = await collectMdFiles(abs);
+            if (files.length > 0) {
+                roots.push({ path: rel.replace(/\\/g, "/"), fileCount: files.length });
+            }
+            for (const absPath of files) {
+                const projectRel = relative(root, absPath).replace(/\\/g, "/");
+                allPaths.push(projectRel);
+                classifyFiles.push({ relativePath: stripLayerPrefix(key, projectRel), headings: [] });
+                if (key === "srs")
+                    srsMdCount += 1;
+            }
+        }
+        roots.sort((a, b) => b.fileCount - a.fileCount);
+        const lang = detectLanguageLayout(allPaths);
+        const layerFolder = key === "srs" ? "srs" : key === "basicDesign" ? "basic-design" : "detail-design";
+        onDisk[key] = {
+            configuredPath,
+            roots,
+            languageLayout: lang.strategy,
+            detectedLanguages: lang.detected,
+            classification: classifyLayer(classifyFiles, layerFolder),
+        };
+    }
+    const dsFiles = await collectMdFiles(join(root, "docs/data-source"));
+    const dataSource = dsFiles.length > 0
+        ? { path: "docs/data-source", fileCount: dsFiles.length }
+        : null;
+    classifyDataSource(srsMdCount, dataSource?.fileCount ?? 0);
+    await classifyPrototype(root);
+    const partial = {
+        probedAt: new Date().toISOString(),
+        configuredPaths,
+        onDisk,
+        dataSource,
+    };
+    const suggestions = buildSuggestions(partial);
+    return {
+        ...partial,
+        suggestions,
+        agentPrompt: buildAgentPrompt({ ...partial, suggestions }),
+    };
+}
+//# sourceMappingURL=layout.js.map

package/dist/core/docops/layout.js.map

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

package/dist/core/docops/migrate.d.ts

@@ -12,6 +12,8 @@ export interface MigrateDocopsResult {
     configPath: string;
     config?: DocopsConfig;
 }
+/** Gap-fill an existing docops contract (config patches + bootstrap files). */
+export declare function repairDocopsContract(projectRoot: string, config: DocopsConfig, actions: string[], dryRun: boolean): Promise<DocopsConfig>;
 export interface MigrateFromDocflowResult {
     migrated: boolean;
     reason?: string;

package/dist/core/docops/migrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/core/docops/migrate.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAmQD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAAC,wBAAwB,CAAC,CAsCnC;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAsF9B"}
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/core/docops/migrate.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAkID,+EAA+E;AAC/E,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,YAAY,CAAC,CAEvB;AA2JD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,OAAO,CAAC,wBAAwB,CAAC,CAsCnC;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,mBAAmB,CAAC,CAsF9B"}

package/dist/core/docops/migrate.js

@@ -4,7 +4,7 @@ import { loadDocflowConfig } from "../config/load.js";
 import { defaultEngineConfig, writeEngineConfig } from "../engine/load.js";
 import { pathExists } from "../util/fs.js";
 import { DOCOPS_CONFIG_REL, LEGACY_DOCFLOW_CONFIG_REL, LEGACY_DOCOPS_PATHS, normalizeDocTypePath, } from "./paths.js";
-import { docopsConfigFromDocflow, inferDocTypesFromTree, readDocopsConfig, writeDocopsConfig, } from "./config.js";
+import { docopsConfigFromDocflow, inferDocTypesFromTree, mergeDocopsDefaults, readDocopsConfig, writeDocopsConfig, } from "./config.js";
 import { applyDocopsBootstrap } from "./bootstrap.js";
 import { bootstrapEntityRegistry } from "./entity-keying.js";
 import { buildDocTypesFromLayers, ensureOptionalDocTypes, LAYER_TEMPLATES_PATH, templateLayerKeys, } from "./layer-defaults.js";
@@ -63,9 +63,31 @@ async function bootstrapDocopsContract(projectRoot, config, docflow, actions, dr
     });
     await copyTemplatesForEnabledDocTypes(projectRoot, config, docflow, actions, dryRun);
 }
+async function syncDocopsConfigSchema(projectRoot, config, actions, dryRun) {
+    const merged = mergeDocopsDefaults(config);
+    const withOptional = {
+        ...merged,
+        docTypes: ensureOptionalDocTypes(merged.docTypes ?? {}),
+    };
+    const before = JSON.stringify(mergeDocopsDefaults(config));
+    const after = JSON.stringify(withOptional);
+    if (before === after) {
+        return config;
+    }
+    actions.push(`${dryRun ? "would sync" : "sync"} ${DOCOPS_CONFIG_REL} to latest contract defaults`);
+    if (!dryRun) {
+        await writeDocopsConfig(projectRoot, withOptional);
+    }
+    return withOptional;
+}
+/** Gap-fill an existing docops contract (config patches + bootstrap files). */
+export async function repairDocopsContract(projectRoot, config, actions, dryRun) {
+    return repairDocopsGaps(projectRoot, config, actions, dryRun);
+}
 async function repairDocopsGaps(projectRoot, config, actions, dryRun) {
     await copyLegacyArtifacts(projectRoot, actions, dryRun);
-    const withPaths = await patchCanonicalDocTypePaths(projectRoot, config, actions, dryRun);
+    const synced = await syncDocopsConfigSchema(projectRoot, config, actions, dryRun);
+    const withPaths = await patchCanonicalDocTypePaths(projectRoot, synced, actions, dryRun);
     const withOptional = await patchMissingOptionalDocTypes(projectRoot, withPaths, actions, dryRun);
     const next = await patchMissingTemplatesPaths(projectRoot, withOptional, actions, dryRun);
     const docflow = await loadDocflowIfPresent(projectRoot);