open-wiki-spec 0.1.0

package/dist/core/migrate/migrate.js

@@ -0,0 +1,149 @@
+/**
+ * Migration orchestrator: coordinates scanning, conversion, and writing
+ * to migrate an OpenSpec project to open-wiki-spec format.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { scanOpenSpec, findOpenSpecDir } from './scanner.js';
+import { convertAllSpecs } from './spec-converter.js';
+import { convertAllChanges } from './change-converter.js';
+import { convertConfigToSource } from './source-converter.js';
+import { inferSystems, convertSystems, buildSystemRefMap, buildFeatureRefMap, } from './system-inferrer.js';
+import { initVault } from '../../cli/init/init-engine.js';
+/**
+ * Plan a migration from OpenSpec to open-wiki-spec.
+ * Does not write any files - just produces a plan.
+ */
+export function planMigration(options) {
+    const projectPath = path.resolve(options.projectPath ?? '.');
+    const openspecPath = options.openspecDir
+        ? path.resolve(options.openspecDir)
+        : findOpenSpecDir(projectPath) ?? '';
+    if (!openspecPath || !fs.existsSync(openspecPath)) {
+        throw new Error(`OpenSpec directory not found. Specify with --openspec-dir or ensure openspec/ exists in ${projectPath}`);
+    }
+    const wikiPath = path.join(projectPath, 'wiki');
+    // Step 1: Scan
+    const scan = scanOpenSpec(openspecPath);
+    const scanStep = {
+        name: 'Scan OpenSpec',
+        description: `Found ${scan.specs.length} specs, ${scan.activeChanges.length} active changes, ${scan.archivedChanges.length} archived changes`,
+        outputs: [],
+        warnings: [...scan.warnings],
+    };
+    // Step 2: Generate source note from config context
+    const sourceOutputs = [];
+    if (scan.config?.context) {
+        sourceOutputs.push(convertConfigToSource(scan.config.context, scan.config));
+    }
+    const sourceStep = {
+        name: 'Generate Source Notes',
+        description: sourceOutputs.length > 0
+            ? `Generated ${sourceOutputs.length} source note from config.yaml context`
+            : 'No config context found, skipping source generation',
+        outputs: sourceOutputs,
+        warnings: [],
+    };
+    // Step 3: Infer systems
+    const systems = inferSystems(scan.specs);
+    const systemRefMap = buildSystemRefMap(systems);
+    const systemOutputs = convertSystems(systems);
+    const systemStep = {
+        name: 'Infer Systems',
+        description: `Inferred ${systems.length} systems from capability domains`,
+        outputs: systemOutputs,
+        warnings: [],
+    };
+    // Step 4: Convert specs to features
+    const featureRefMap = buildFeatureRefMap(scan.specs.map(s => s.capability));
+    const { results: featureOutputs, warnings: featureWarnings } = convertAllSpecs(scan.specs, systemRefMap);
+    const featureStep = {
+        name: 'Convert Specs to Features',
+        description: `Converted ${featureOutputs.length} specs to Feature notes`,
+        outputs: featureOutputs,
+        warnings: featureWarnings,
+    };
+    // Step 5: Convert active changes
+    const { results: activeChangeOutputs, warnings: activeChangeWarnings } = convertAllChanges(scan.activeChanges, featureRefMap, systemRefMap);
+    const activeChangeStep = {
+        name: 'Convert Active Changes',
+        description: `Converted ${scan.activeChanges.length} active changes`,
+        outputs: activeChangeOutputs,
+        warnings: activeChangeWarnings,
+    };
+    // Step 6: Convert archived changes (optional)
+    const steps = [scanStep, sourceStep, systemStep, featureStep, activeChangeStep];
+    if (!options.skipArchive) {
+        const { results: archiveOutputs, warnings: archiveWarnings } = convertAllChanges(scan.archivedChanges, featureRefMap, systemRefMap);
+        const archiveStep = {
+            name: 'Convert Archived Changes',
+            description: `Converted ${scan.archivedChanges.length} archived changes`,
+            outputs: archiveOutputs,
+            warnings: archiveWarnings,
+        };
+        steps.push(archiveStep);
+    }
+    // Count totals
+    const totalFiles = steps.reduce((sum, s) => sum + s.outputs.length, 0);
+    const totalWarnings = steps.reduce((sum, s) => sum + s.warnings.length, 0);
+    return {
+        openspecPath,
+        wikiPath,
+        steps,
+        totalFiles,
+        totalWarnings,
+    };
+}
+/**
+ * Execute a migration plan: init vault structure and write all files.
+ */
+export async function executeMigration(plan, dryRun = false) {
+    const filesWritten = [];
+    const filesSkipped = [];
+    const errors = [];
+    if (!dryRun) {
+        // Initialize vault structure (creates directories and meta files)
+        try {
+            await initVault({ path: path.dirname(plan.wikiPath) });
+        }
+        catch (err) {
+            errors.push(`Failed to init vault: ${err.message}`);
+        }
+        // Write all outputs
+        for (const step of plan.steps) {
+            for (const output of step.outputs) {
+                const fullPath = path.join(path.dirname(plan.wikiPath), output.targetPath);
+                try {
+                    if (fs.existsSync(fullPath)) {
+                        filesSkipped.push(output.targetPath);
+                        continue;
+                    }
+                    const dir = path.dirname(fullPath);
+                    if (!fs.existsSync(dir)) {
+                        fs.mkdirSync(dir, { recursive: true });
+                    }
+                    fs.writeFileSync(fullPath, output.content, 'utf-8');
+                    filesWritten.push(output.targetPath);
+                }
+                catch (err) {
+                    errors.push(`Failed to write ${output.targetPath}: ${err.message}`);
+                }
+            }
+        }
+    }
+    return {
+        plan,
+        filesWritten,
+        filesSkipped,
+        dryRun,
+        errors,
+    };
+}
+/**
+ * Run the full migration: plan and execute.
+ */
+export async function migrate(options) {
+    const plan = planMigration(options);
+    return executeMigration(plan, options.dryRun);
+}
+//# sourceMappingURL=migrate.js.map

package/dist/core/migrate/migrate.js.map

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

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

@@ -0,0 +1,10 @@
+import type { ScanResult } from './types.js';
+/**
+ * Scan an OpenSpec directory and return all discovered artifacts.
+ */
+export declare function scanOpenSpec(openspecPath: string): ScanResult;
+/**
+ * Auto-detect the openspec/ directory from a project root.
+ */
+export declare function findOpenSpecDir(projectPath: string): string | null;
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/scanner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EAKX,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAmB7D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE"}

package/dist/core/migrate/scanner.js

@@ -0,0 +1,188 @@
+/**
+ * Scanner for OpenSpec directory structure.
+ * Reads and catalogs all specs, changes, and config from an openspec/ directory.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+/**
+ * Scan an OpenSpec directory and return all discovered artifacts.
+ */
+export function scanOpenSpec(openspecPath) {
+    const warnings = [];
+    if (!fs.existsSync(openspecPath)) {
+        throw new Error(`OpenSpec directory not found: ${openspecPath}`);
+    }
+    const config = readConfig(openspecPath, warnings);
+    const specs = scanSpecs(openspecPath, warnings);
+    const { activeChanges, archivedChanges } = scanChanges(openspecPath, warnings);
+    return {
+        openspecPath,
+        config,
+        specs,
+        activeChanges,
+        archivedChanges,
+        warnings,
+    };
+}
+/**
+ * Auto-detect the openspec/ directory from a project root.
+ */
+export function findOpenSpecDir(projectPath) {
+    const candidate = path.join(projectPath, 'openspec');
+    if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+        return candidate;
+    }
+    return null;
+}
+function readConfig(openspecPath, warnings) {
+    const configPath = path.join(openspecPath, 'config.yaml');
+    if (!fs.existsSync(configPath)) {
+        warnings.push('No config.yaml found in OpenSpec directory');
+        return null;
+    }
+    try {
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const data = parseYaml(raw);
+        if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+            warnings.push('config.yaml does not contain a valid YAML object');
+            return null;
+        }
+        return data;
+    }
+    catch (err) {
+        warnings.push(`Failed to parse config.yaml: ${err.message}`);
+        return null;
+    }
+}
+function scanSpecs(openspecPath, warnings) {
+    const specsDir = path.join(openspecPath, 'specs');
+    if (!fs.existsSync(specsDir)) {
+        warnings.push('No specs/ directory found');
+        return [];
+    }
+    const specs = [];
+    const entries = fs.readdirSync(specsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const specFile = path.join(specsDir, entry.name, 'spec.md');
+        if (!fs.existsSync(specFile)) {
+            warnings.push(`Spec directory ${entry.name}/ has no spec.md`);
+            continue;
+        }
+        try {
+            const content = fs.readFileSync(specFile, 'utf-8');
+            specs.push({
+                capability: entry.name,
+                specPath: path.join('specs', entry.name, 'spec.md'),
+                content,
+            });
+        }
+        catch (err) {
+            warnings.push(`Failed to read ${specFile}: ${err.message}`);
+        }
+    }
+    return specs;
+}
+function scanChanges(openspecPath, warnings) {
+    const changesDir = path.join(openspecPath, 'changes');
+    if (!fs.existsSync(changesDir)) {
+        warnings.push('No changes/ directory found');
+        return { activeChanges: [], archivedChanges: [] };
+    }
+    const activeChanges = [];
+    const archivedChanges = [];
+    // Scan active changes
+    const entries = fs.readdirSync(changesDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name === 'archive')
+            continue;
+        const change = scanSingleChange(path.join(changesDir, entry.name), entry.name, false, warnings);
+        if (change)
+            activeChanges.push(change);
+    }
+    // Scan archived changes
+    const archiveDir = path.join(changesDir, 'archive');
+    if (fs.existsSync(archiveDir)) {
+        const archiveEntries = fs.readdirSync(archiveDir, { withFileTypes: true });
+        for (const entry of archiveEntries) {
+            if (!entry.isDirectory())
+                continue;
+            const change = scanSingleChange(path.join(archiveDir, entry.name), entry.name, true, warnings);
+            if (change)
+                archivedChanges.push(change);
+        }
+    }
+    return { activeChanges, archivedChanges };
+}
+function scanSingleChange(changePath, name, archived, warnings) {
+    const proposal = readFileOrNull(path.join(changePath, 'proposal.md'));
+    const design = readFileOrNull(path.join(changePath, 'design.md'));
+    const tasks = readFileOrNull(path.join(changePath, 'tasks.md'));
+    const metadata = readChangeMetadata(path.join(changePath, '.openspec.yaml'), warnings);
+    if (!proposal) {
+        warnings.push(`Change ${name} has no proposal.md, skipping`);
+        return null;
+    }
+    // Scan delta specs
+    const deltaSpecs = [];
+    const specsDir = path.join(changePath, 'specs');
+    if (fs.existsSync(specsDir)) {
+        const specEntries = fs.readdirSync(specsDir, { withFileTypes: true });
+        for (const entry of specEntries) {
+            if (!entry.isDirectory())
+                continue;
+            const specFile = path.join(specsDir, entry.name, 'spec.md');
+            if (fs.existsSync(specFile)) {
+                try {
+                    deltaSpecs.push({
+                        capability: entry.name,
+                        content: fs.readFileSync(specFile, 'utf-8'),
+                    });
+                }
+                catch {
+                    warnings.push(`Failed to read delta spec ${entry.name}/spec.md in change ${name}`);
+                }
+            }
+        }
+    }
+    return {
+        name,
+        dirPath: changePath,
+        proposal,
+        design,
+        tasks,
+        metadata,
+        deltaSpecs,
+        archived,
+    };
+}
+function readFileOrNull(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return null;
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function readChangeMetadata(filePath, warnings) {
+    const raw = readFileOrNull(filePath);
+    if (!raw)
+        return null;
+    try {
+        const data = parseYaml(raw);
+        if (typeof data !== 'object' || data === null)
+            return null;
+        return data;
+    }
+    catch (err) {
+        warnings.push(`Failed to parse .openspec.yaml: ${err.message}`);
+        return null;
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/core/migrate/scanner.js.map

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

package/dist/core/migrate/source-converter.d.ts

@@ -0,0 +1,6 @@
+import type { OpenSpecConfig, ConversionResult } from './types.js';
+/**
+ * Convert the config.yaml context field into a Source note.
+ */
+export declare function convertConfigToSource(context: string, config: OpenSpecConfig): ConversionResult;
+//# sourceMappingURL=source-converter.d.ts.map

package/dist/core/migrate/source-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-converter.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/source-converter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,GACrB,gBAAgB,CAmClB"}

package/dist/core/migrate/source-converter.js

@@ -0,0 +1,63 @@
+/**
+ * Converts OpenSpec config.yaml context into an open-wiki-spec Source note.
+ * Rich config contexts (project architecture, stack, conventions) become
+ * project-context Source notes for reference.
+ */
+import * as path from 'node:path';
+/**
+ * Convert the config.yaml context field into a Source note.
+ */
+export function convertConfigToSource(context, config) {
+    const id = 'project-context';
+    const rulesBlock = config.rules ? formatRules(config.rules) : '';
+    const content = `---
+type: source
+id: ${id}
+status: active
+source_type: other
+tags:
+  - source
+  - migrated
+  - project-context
+---
+
+# Source: Project Context
+
+## Summary
+
+Project context and conventions migrated from OpenSpec config.yaml.
+
+## Key Points
+
+${context.trim()}
+
+${rulesBlock ? `## OpenSpec Rules\n\n${rulesBlock}` : ''}
+
+## Related Notes
+`;
+    return {
+        targetPath: path.join('wiki', '01-sources', `${id}.md`),
+        content,
+        sourceDescription: 'openspec/config.yaml (context field)',
+    };
+}
+function formatRules(rules) {
+    const lines = [];
+    for (const [key, value] of Object.entries(rules)) {
+        lines.push(`### ${key}`);
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                lines.push(`- ${item}`);
+            }
+        }
+        else if (typeof value === 'string') {
+            lines.push(value);
+        }
+        else {
+            lines.push(String(value));
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=source-converter.js.map

package/dist/core/migrate/source-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-converter.js","sourceRoot":"","sources":["../../../src/core/migrate/source-converter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,MAAsB;IAEtB,MAAM,EAAE,GAAG,iBAAiB,CAAC;IAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,MAAM,OAAO,GAAG;;MAEZ,EAAE;;;;;;;;;;;;;;;;;EAiBN,OAAO,CAAC,IAAI,EAAE;;EAEd,UAAU,CAAC,CAAC,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;;;CAGvD,CAAC;IAEA,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC;QACvD,OAAO;QACP,iBAAiB,EAAE,sCAAsC;KAC1D,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAA8B;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/core/migrate/spec-converter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Converts OpenSpec spec.md files into open-wiki-spec Feature notes.
+ */
+import type { ScannedSpec, ConversionResult } from './types.js';
+/**
+ * Convert a single OpenSpec spec into a Feature note.
+ */
+export declare function convertSpec(spec: ScannedSpec, systemRef: string): ConversionResult;
+/**
+ * Convert all specs into Feature notes.
+ */
+export declare function convertAllSpecs(specs: ScannedSpec[], systemRefs: Map<string, string>): {
+    results: ConversionResult[];
+    warnings: string[];
+};
+//# sourceMappingURL=spec-converter.d.ts.map

package/dist/core/migrate/spec-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-converter.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/spec-converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAShE;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAuBlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B;IAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAcrD"}

package/dist/core/migrate/spec-converter.js

@@ -0,0 +1,157 @@
+import * as path from 'node:path';
+const REQUIREMENT_HEADING_RE = /^###\s+Requirement:\s*(.+)$/;
+const SCENARIO_HEADING_RE = /^####\s+Scenario:\s*(.+)$/;
+const PURPOSE_SECTION_RE = /^##\s+Purpose$/m;
+const REQUIREMENTS_SECTION_RE = /^##\s+Requirements$/m;
+const WHY_SECTION_RE = /^##\s+Why$/m;
+/**
+ * Convert a single OpenSpec spec into a Feature note.
+ */
+export function convertSpec(spec, systemRef) {
+    const id = spec.capability;
+    const title = formatTitle(spec.capability);
+    const purpose = extractPurpose(spec.content);
+    const requirementsBlock = extractRequirementsBlock(spec.content);
+    const constraints = extractConstraints(spec.content);
+    const knownGaps = extractKnownGaps(spec.content);
+    const content = buildFeatureNote({
+        id,
+        title,
+        systemRef,
+        purpose,
+        requirementsBlock,
+        constraints,
+        knownGaps,
+    });
+    return {
+        targetPath: path.join('wiki', '03-features', `${id}.md`),
+        content,
+        sourceDescription: `openspec/specs/${spec.capability}/spec.md`,
+    };
+}
+/**
+ * Convert all specs into Feature notes.
+ */
+export function convertAllSpecs(specs, systemRefs) {
+    const results = [];
+    const warnings = [];
+    for (const spec of specs) {
+        const systemRef = systemRefs.get(spec.capability) ?? 'default-system';
+        try {
+            results.push(convertSpec(spec, systemRef));
+        }
+        catch (err) {
+            warnings.push(`Failed to convert spec ${spec.capability}: ${err.message}`);
+        }
+    }
+    return { results, warnings };
+}
+function buildFeatureNote(opts) {
+    return `---
+type: feature
+id: ${opts.id}
+status: active
+systems:
+  - "${opts.systemRef}"
+sources:
+  - "[[Source: Project Context]]"
+decisions: []
+changes: []
+tags:
+  - feature
+  - migrated
+---
+
+# Feature: ${opts.title}
+
+## Purpose
+
+${opts.purpose || '<!-- Migrated from OpenSpec - purpose not specified -->'}
+
+## Current Behavior
+
+<!-- Migrated from OpenSpec spec. See requirements below for current behavior. -->
+
+## Constraints
+
+${opts.constraints || '<!-- No constraints specified in original spec -->'}
+
+## Known Gaps
+
+${opts.knownGaps || '<!-- No known gaps specified in original spec -->'}
+
+## Requirements
+
+${opts.requirementsBlock || '<!-- No requirements found in original spec -->'}
+
+## Related Notes
+`;
+}
+/**
+ * Extract the Purpose section content from an OpenSpec spec.
+ */
+function extractPurpose(content) {
+    const match = content.match(PURPOSE_SECTION_RE);
+    if (!match) {
+        // Try extracting from first paragraph after H1
+        const h1End = content.indexOf('\n## ');
+        if (h1End === -1)
+            return '';
+        const h1Match = content.match(/^#\s+.+\n+([\s\S]*?)(?=\n##\s)/);
+        if (h1Match)
+            return h1Match[1].trim();
+        return '';
+    }
+    const startIdx = match.index + match[0].length;
+    const nextSection = content.indexOf('\n## ', startIdx);
+    const sectionContent = nextSection === -1
+        ? content.slice(startIdx)
+        : content.slice(startIdx, nextSection);
+    return sectionContent.trim();
+}
+/**
+ * Extract the Requirements block preserving its markdown structure.
+ */
+function extractRequirementsBlock(content) {
+    const match = content.match(REQUIREMENTS_SECTION_RE);
+    if (!match)
+        return '';
+    const startIdx = match.index + match[0].length;
+    // Find next H2 that is NOT a requirement sub-section (i.e., at ## level)
+    const remaining = content.slice(startIdx);
+    const nextH2 = remaining.match(/\n## (?!Requirements)/);
+    const block = nextH2 ? remaining.slice(0, nextH2.index) : remaining;
+    return block.trim();
+}
+/**
+ * Extract constraints from spec content (if any section matches).
+ */
+function extractConstraints(content) {
+    const match = content.match(/^##\s+Constraints$/m);
+    if (!match)
+        return '';
+    const startIdx = match.index + match[0].length;
+    const nextSection = content.indexOf('\n## ', startIdx);
+    return (nextSection === -1 ? content.slice(startIdx) : content.slice(startIdx, nextSection)).trim();
+}
+/**
+ * Extract known gaps from spec content.
+ */
+function extractKnownGaps(content) {
+    const match = content.match(/^##\s+Known\s+Gaps$/m);
+    if (!match)
+        return '';
+    const startIdx = match.index + match[0].length;
+    const nextSection = content.indexOf('\n## ', startIdx);
+    return (nextSection === -1 ? content.slice(startIdx) : content.slice(startIdx, nextSection)).trim();
+}
+/**
+ * Convert kebab-case capability name to a readable title.
+ */
+function formatTitle(capability) {
+    return capability
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=spec-converter.js.map

package/dist/core/migrate/spec-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-converter.js","sourceRoot":"","sources":["../../../src/core/migrate/spec-converter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAC7D,MAAM,mBAAmB,GAAG,2BAA2B,CAAC;AACxD,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAC7C,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AACvD,MAAM,cAAc,GAAG,aAAa,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAiB,EAAE,SAAiB;IAC9D,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;IAC3B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjD,MAAM,OAAO,GAAG,gBAAgB,CAAC;QAC/B,EAAE;QACF,KAAK;QACL,SAAS;QACT,OAAO;QACP,iBAAiB;QACjB,WAAW;QACX,SAAS;KACV,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC;QACxD,OAAO;QACP,iBAAiB,EAAE,kBAAkB,IAAI,CAAC,UAAU,UAAU;KAC/D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAoB,EACpB,UAA+B;IAE/B,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC;QACtE,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,UAAU,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CAAC,IAQzB;IACC,OAAO;;MAEH,IAAI,CAAC,EAAE;;;OAGN,IAAI,CAAC,SAAS;;;;;;;;;;aAUR,IAAI,CAAC,KAAK;;;;EAIrB,IAAI,CAAC,OAAO,IAAI,yDAAyD;;;;;;;;EAQzE,IAAI,CAAC,WAAW,IAAI,oDAAoD;;;;EAIxE,IAAI,CAAC,SAAS,IAAI,mDAAmD;;;;EAIrE,IAAI,CAAC,iBAAiB,IAAI,iDAAiD;;;CAG5E,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,OAAe;IACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,+CAA+C;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAChE,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,WAAW,KAAK,CAAC,CAAC;QACvC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QACzB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEzC,OAAO,cAAc,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IAEtB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,yEAAyE;IACzE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,KAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAErE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,OAAO,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtG,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,OAAO,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtG,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,UAAkB;IACrC,OAAO,UAAU;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/core/migrate/system-inferrer.d.ts

@@ -0,0 +1,23 @@
+import type { ScannedSpec, ConversionResult } from './types.js';
+export interface InferredSystem {
+    id: string;
+    title: string;
+    capabilities: string[];
+}
+/**
+ * Infer systems from a list of specs by grouping capabilities by domain prefix.
+ */
+export declare function inferSystems(specs: ScannedSpec[]): InferredSystem[];
+/**
+ * Build a mapping from capability name to system wikilink ref.
+ */
+export declare function buildSystemRefMap(systems: InferredSystem[]): Map<string, string>;
+/**
+ * Build a mapping from capability name to feature wikilink ref.
+ */
+export declare function buildFeatureRefMap(capabilities: string[]): Map<string, string>;
+/**
+ * Convert inferred systems into System note ConversionResults.
+ */
+export declare function convertSystems(systems: InferredSystem[]): ConversionResult[];
+//# sourceMappingURL=system-inferrer.d.ts.map