@mobiman/vector 1.1.0

package/core/bin/lib/frontmatter.cjs

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * Frontmatter — YAML frontmatter parsing, serialization, and CRUD commands
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRONTMATTER_SCHEMAS = void 0;
+exports.extractFrontmatter = extractFrontmatter;
+exports.reconstructFrontmatter = reconstructFrontmatter;
+exports.spliceFrontmatter = spliceFrontmatter;
+exports.parseMustHavesBlock = parseMustHavesBlock;
+exports.cmdFrontmatterGet = cmdFrontmatterGet;
+exports.cmdFrontmatterSet = cmdFrontmatterSet;
+exports.cmdFrontmatterMerge = cmdFrontmatterMerge;
+exports.cmdFrontmatterValidate = cmdFrontmatterValidate;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const core_cjs_1 = require("./core.cjs");
+function extractFrontmatter(content) {
+    const frontmatter = {};
+    const match = content.match(/^---\n([\s\S]+?)\n---/);
+    if (!match)
+        return frontmatter;
+    const yaml = match[1];
+    const lines = yaml.split('\n');
+    const stack = [{ obj: frontmatter, key: null, indent: -1 }];
+    for (const line of lines) {
+        // Skip empty lines
+        if (line.trim() === '')
+            continue;
+        // Calculate indentation (number of leading spaces)
+        const indentMatch = line.match(/^(\s*)/);
+        const indent = indentMatch ? indentMatch[1].length : 0;
+        // Pop stack back to appropriate level
+        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+            stack.pop();
+        }
+        const current = stack[stack.length - 1];
+        // Check for key: value pattern
+        const keyMatch = line.match(/^(\s*)([a-zA-Z0-9_-]+):\s*(.*)/);
+        if (keyMatch) {
+            const key = keyMatch[2];
+            const value = keyMatch[3].trim();
+            const currentObj = current.obj;
+            if (value === '' || value === '[') {
+                // Key with no value or opening bracket — could be nested object or array
+                // We'll determine based on next lines, for now create placeholder
+                currentObj[key] = value === '[' ? [] : {};
+                current.key = null;
+                // Push new context for potential nested content
+                stack.push({ obj: currentObj[key], key: null, indent });
+            }
+            else if (value.startsWith('[') && value.endsWith(']')) {
+                // Inline array: key: [a, b, c]
+                currentObj[key] = value.slice(1, -1).split(',').map(s => s.trim().replace(/^["']|["']$/g, '')).filter(Boolean);
+                current.key = null;
+            }
+            else {
+                // Simple key: value
+                currentObj[key] = value.replace(/^["']|["']$/g, '');
+                current.key = null;
+            }
+        }
+        else if (line.trim().startsWith('- ')) {
+            // Array item
+            const itemValue = line.trim().slice(2).replace(/^["']|["']$/g, '');
+            // If current context is an empty object, convert to array
+            if (typeof current.obj === 'object' && !Array.isArray(current.obj) && Object.keys(current.obj).length === 0) {
+                // Find the key in parent that points to this object and convert it
+                const parent = stack.length > 1 ? stack[stack.length - 2] : null;
+                if (parent) {
+                    const parentObj = parent.obj;
+                    for (const k of Object.keys(parentObj)) {
+                        if (parentObj[k] === current.obj) {
+                            parentObj[k] = [itemValue];
+                            current.obj = parentObj[k];
+                            break;
+                        }
+                    }
+                }
+            }
+            else if (Array.isArray(current.obj)) {
+                current.obj.push(itemValue);
+            }
+        }
+    }
+    return frontmatter;
+}
+function reconstructFrontmatter(obj) {
+    const lines = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null || value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            if (value.length === 0) {
+                lines.push(`${key}: []`);
+            }
+            else if (value.every(v => typeof v === 'string') && value.length <= 3 && value.join(', ').length < 60) {
+                lines.push(`${key}: [${value.join(', ')}]`);
+            }
+            else {
+                lines.push(`${key}:`);
+                for (const item of value) {
+                    lines.push(`  - ${typeof item === 'string' && (item.includes(':') || item.includes('#')) ? `"${item}"` : item}`);
+                }
+            }
+        }
+        else if (typeof value === 'object') {
+            lines.push(`${key}:`);
+            for (const [subkey, subval] of Object.entries(value)) {
+                if (subval === null || subval === undefined)
+                    continue;
+                if (Array.isArray(subval)) {
+                    if (subval.length === 0) {
+                        lines.push(`  ${subkey}: []`);
+                    }
+                    else if (subval.every(v => typeof v === 'string') && subval.length <= 3 && subval.join(', ').length < 60) {
+                        lines.push(`  ${subkey}: [${subval.join(', ')}]`);
+                    }
+                    else {
+                        lines.push(`  ${subkey}:`);
+                        for (const item of subval) {
+                            lines.push(`    - ${typeof item === 'string' && (item.includes(':') || item.includes('#')) ? `"${item}"` : item}`);
+                        }
+                    }
+                }
+                else if (typeof subval === 'object') {
+                    lines.push(`  ${subkey}:`);
+                    for (const [subsubkey, subsubval] of Object.entries(subval)) {
+                        if (subsubval === null || subsubval === undefined)
+                            continue;
+                        if (Array.isArray(subsubval)) {
+                            if (subsubval.length === 0) {
+                                lines.push(`    ${subsubkey}: []`);
+                            }
+                            else {
+                                lines.push(`    ${subsubkey}:`);
+                                for (const item of subsubval) {
+                                    lines.push(`      - ${item}`);
+                                }
+                            }
+                        }
+                        else {
+                            lines.push(`    ${subsubkey}: ${subsubval}`);
+                        }
+                    }
+                }
+                else {
+                    const sv = String(subval);
+                    lines.push(`  ${subkey}: ${sv.includes(':') || sv.includes('#') ? `"${sv}"` : sv}`);
+                }
+            }
+        }
+        else {
+            const sv = String(value);
+            if (sv.includes(':') || sv.includes('#') || sv.startsWith('[') || sv.startsWith('{')) {
+                lines.push(`${key}: "${sv}"`);
+            }
+            else {
+                lines.push(`${key}: ${sv}`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function spliceFrontmatter(content, newObj) {
+    const yamlStr = reconstructFrontmatter(newObj);
+    const match = content.match(/^---\n[\s\S]+?\n---/);
+    if (match) {
+        return `---\n${yamlStr}\n---` + content.slice(match[0].length);
+    }
+    return `---\n${yamlStr}\n---\n\n` + content;
+}
+function parseMustHavesBlock(content, blockName) {
+    // Extract a specific block from must_haves in raw frontmatter YAML
+    // Handles 3-level nesting: must_haves > artifacts/key_links > [{path, provides, ...}]
+    const fmMatch = content.match(/^---\n([\s\S]+?)\n---/);
+    if (!fmMatch)
+        return [];
+    const yaml = fmMatch[1];
+    // Find the block (e.g., "truths:", "artifacts:", "key_links:")
+    const blockPattern = new RegExp(`^\\s{4}${blockName}:\\s*$`, 'm');
+    const blockStart = yaml.search(blockPattern);
+    if (blockStart === -1)
+        return [];
+    const afterBlock = yaml.slice(blockStart);
+    const blockLines = afterBlock.split('\n').slice(1); // skip the header line
+    const items = [];
+    let current = null;
+    for (const line of blockLines) {
+        // Stop at same or lower indent level (non-continuation)
+        if (line.trim() === '')
+            continue;
+        const indentMatch = line.match(/^(\s*)/);
+        const indent = indentMatch ? indentMatch[1].length : 0;
+        if (indent <= 4 && line.trim() !== '')
+            break; // back to must_haves level or higher
+        if (line.match(/^\s{6}-\s+/)) {
+            // New list item at 6-space indent
+            if (current)
+                items.push(current);
+            current = {};
+            // Check if it's a simple string item
+            const simpleMatch = line.match(/^\s{6}-\s+"?([^"]+)"?\s*$/);
+            if (simpleMatch && !line.includes(':')) {
+                current = simpleMatch[1];
+            }
+            else {
+                // Key-value on same line as dash: "- path: value"
+                const kvMatch = line.match(/^\s{6}-\s+(\w+):\s*"?([^"]*)"?\s*$/);
+                if (kvMatch) {
+                    current = {};
+                    current[kvMatch[1]] = kvMatch[2];
+                }
+            }
+        }
+        else if (current && typeof current === 'object') {
+            const currentObj = current;
+            // Continuation key-value at 8+ space indent
+            const kvMatch = line.match(/^\s{8,}(\w+):\s*"?([^"]*)"?\s*$/);
+            if (kvMatch) {
+                const val = kvMatch[2];
+                // Try to parse as number
+                currentObj[kvMatch[1]] = /^\d+$/.test(val) ? parseInt(val, 10) : val;
+            }
+            // Array items under a key
+            const arrMatch = line.match(/^\s{10,}-\s+"?([^"]+)"?\s*$/);
+            if (arrMatch) {
+                // Find the last key added and convert to array
+                const keys = Object.keys(currentObj);
+                const lastKey = keys[keys.length - 1];
+                if (lastKey && !Array.isArray(currentObj[lastKey])) {
+                    currentObj[lastKey] = currentObj[lastKey] ? [currentObj[lastKey]] : [];
+                }
+                if (lastKey)
+                    currentObj[lastKey].push(arrMatch[1]);
+            }
+        }
+    }
+    if (current)
+        items.push(current);
+    return items;
+}
+// ─── Frontmatter CRUD commands ────────────────────────────────────────────────
+exports.FRONTMATTER_SCHEMAS = {
+    plan: { required: ['phase', 'plan', 'type', 'wave', 'depends_on', 'files_modified', 'autonomous', 'must_haves'] },
+    summary: { required: ['phase', 'plan', 'subsystem', 'tags', 'duration', 'completed'] },
+    verification: { required: ['phase', 'verified', 'status', 'score'] },
+};
+function cmdFrontmatterGet(cwd, filePath, field, raw) {
+    if (!filePath) {
+        (0, core_cjs_1.error)('file path required');
+    }
+    const fullPath = path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(cwd, filePath);
+    const content = (0, core_cjs_1.safeReadFile)(fullPath);
+    if (!content) {
+        (0, core_cjs_1.output)({ error: 'File not found', path: filePath }, raw);
+        return;
+    }
+    const fm = extractFrontmatter(content);
+    if (field) {
+        const value = fm[field];
+        if (value === undefined) {
+            (0, core_cjs_1.output)({ error: 'Field not found', field }, raw);
+            return;
+        }
+        (0, core_cjs_1.output)({ [field]: value }, raw, JSON.stringify(value));
+    }
+    else {
+        (0, core_cjs_1.output)(fm, raw);
+    }
+}
+function cmdFrontmatterSet(cwd, filePath, field, value, raw) {
+    if (!filePath || !field || value === undefined) {
+        (0, core_cjs_1.error)('file, field, and value required');
+    }
+    const fullPath = path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(cwd, filePath);
+    if (!fs_1.default.existsSync(fullPath)) {
+        (0, core_cjs_1.output)({ error: 'File not found', path: filePath }, raw);
+        return;
+    }
+    const content = fs_1.default.readFileSync(fullPath, 'utf-8');
+    const fm = extractFrontmatter(content);
+    let parsedValue;
+    try {
+        parsedValue = JSON.parse(value);
+    }
+    catch {
+        parsedValue = value;
+    }
+    fm[field] = parsedValue;
+    const newContent = spliceFrontmatter(content, fm);
+    fs_1.default.writeFileSync(fullPath, newContent, 'utf-8');
+    (0, core_cjs_1.output)({ updated: true, field, value: parsedValue }, raw, 'true');
+}
+function cmdFrontmatterMerge(cwd, filePath, data, raw) {
+    if (!filePath || !data) {
+        (0, core_cjs_1.error)('file and data required');
+    }
+    const fullPath = path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(cwd, filePath);
+    if (!fs_1.default.existsSync(fullPath)) {
+        (0, core_cjs_1.output)({ error: 'File not found', path: filePath }, raw);
+        return;
+    }
+    const content = fs_1.default.readFileSync(fullPath, 'utf-8');
+    const fm = extractFrontmatter(content);
+    let mergeData;
+    try {
+        mergeData = JSON.parse(data);
+    }
+    catch {
+        (0, core_cjs_1.error)('Invalid JSON for --data');
+        return;
+    }
+    Object.assign(fm, mergeData);
+    const newContent = spliceFrontmatter(content, fm);
+    fs_1.default.writeFileSync(fullPath, newContent, 'utf-8');
+    (0, core_cjs_1.output)({ merged: true, fields: Object.keys(mergeData) }, raw, 'true');
+}
+function cmdFrontmatterValidate(cwd, filePath, schemaName, raw) {
+    if (!filePath || !schemaName) {
+        (0, core_cjs_1.error)('file and schema required');
+    }
+    const schema = exports.FRONTMATTER_SCHEMAS[schemaName];
+    if (!schema) {
+        (0, core_cjs_1.error)(`Unknown schema: ${schemaName}. Available: ${Object.keys(exports.FRONTMATTER_SCHEMAS).join(', ')}`);
+    }
+    const fullPath = path_1.default.isAbsolute(filePath) ? filePath : path_1.default.join(cwd, filePath);
+    const content = (0, core_cjs_1.safeReadFile)(fullPath);
+    if (!content) {
+        (0, core_cjs_1.output)({ error: 'File not found', path: filePath }, raw);
+        return;
+    }
+    const fm = extractFrontmatter(content);
+    const missing = schema.required.filter(f => fm[f] === undefined);
+    const present = schema.required.filter(f => fm[f] !== undefined);
+    (0, core_cjs_1.output)({ valid: missing.length === 0, missing, present, schema: schemaName }, raw, missing.length === 0 ? 'valid' : 'invalid');
+}
+//# sourceMappingURL=frontmatter.cjs.map

package/core/bin/lib/frontmatter.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.cjs","sourceRoot":"","sources":["frontmatter.cts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAWH,gDA4EC;AAED,wDA8DC;AAED,8CAOC;AAED,kDAkEC;AAUD,8CAaC;AAED,8CAYC;AAED,kDAYC;AAED,wDAWC;AAlSD,4CAAoB;AACpB,gDAAwB;AACxB,yCAAyD;AAOzD,SAAgB,kBAAkB,CAAC,OAAe;IAChD,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,WAAW,CAAC;IAE/B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAK/B,MAAM,KAAK,GAAiB,CAAC,EAAE,GAAG,EAAE,WAAsC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAErG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mBAAmB;QACnB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QAEjC,mDAAmD;QACnD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAEvD,sCAAsC;QACtC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YACpE,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAExC,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;QAC9D,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,OAAO,CAAC,GAA8B,CAAC;YAE1D,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;gBAClC,yEAAyE;gBACzE,kEAAkE;gBAClE,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;gBACnB,gDAAgD;gBAChD,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,CAAC,GAAG,CAAwC,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACjG,CAAC;iBAAM,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxD,+BAA+B;gBAC/B,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC/G,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,oBAAoB;gBACpB,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;gBACpD,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,aAAa;YACb,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAEnE,0DAA0D;YAC1D,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5G,mEAAmE;gBACnE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACjE,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,SAAS,GAAG,MAAM,CAAC,GAA8B,CAAC;oBACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;wBACvC,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;4BACjC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;4BAC1B,OAAwD,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC,CAAc,CAAC;4BAC1F,MAAM;wBACR,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,GAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAgB,sBAAsB,CAAC,GAA4B;IACjE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;YAC3B,CAAC;iBAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAK,KAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACtH,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAO,KAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;gBACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;YACtB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;gBAChF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;oBAAE,SAAS;gBACtD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACxB,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,MAAM,CAAC,CAAC;oBAChC,CAAC;yBAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAK,MAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;wBACzH,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,MAAO,MAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClE,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC;wBAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;4BAC1B,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;wBACrH,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACtC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC;oBAC3B,KAAK,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;wBACvF,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS;4BAAE,SAAS;wBAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;4BAC7B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gCAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,CAAC;4BACrC,CAAC;iCAAM,CAAC;gCACN,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,GAAG,CAAC,CAAC;gCAChC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;oCAC7B,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;gCAChC,CAAC;4BACH,CAAC;wBACH,CAAC;6BAAM,CAAC;4BACN,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC;wBAC/C,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,KAAK,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrF,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAgB,iBAAiB,CAAC,OAAe,EAAE,MAA+B;IAChF,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACnD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,QAAQ,OAAO,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,QAAQ,OAAO,WAAW,GAAG,OAAO,CAAC;AAC9C,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAe,EAAE,SAAiB;IACpE,mEAAmE;IACnE,sFAAsF;IACtF,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACvD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,+DAA+D;IAC/D,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,UAAU,SAAS,QAAQ,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,UAAU,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB;IAE3E,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,IAAI,OAAO,GAA4C,IAAI,CAAC;IAE5D,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,wDAAwD;QACxD,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,MAAM,CAAC,qCAAqC;QAEnF,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,kCAAkC;YAClC,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE,CAAC;YACb,qCAAqC;YACrC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC5D,IAAI,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,kDAAkD;gBAClD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;gBACjE,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,GAAG,EAAE,CAAC;oBACZ,OAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,UAAU,GAAG,OAAkC,CAAC;YACtD,4CAA4C;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YAC9D,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACvB,yBAAyB;gBACzB,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACvE,CAAC;YACD,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC3D,IAAI,QAAQ,EAAE,CAAC;gBACb,+CAA+C;gBAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACtC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;oBACnD,UAAU,CAAC,OAAO,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzE,CAAC;gBACD,IAAI,OAAO;oBAAG,UAAU,CAAC,OAAO,CAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEjC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AAEpE,QAAA,mBAAmB,GAA2C;IACzE,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE;IACjH,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE;IACtF,YAAY,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;CACrE,CAAC;AAEF,SAAgB,iBAAiB,CAAC,GAAW,EAAE,QAAuB,EAAE,KAAoB,EAAE,GAAY;IACxG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAAC,IAAA,gBAAK,EAAC,oBAAoB,CAAC,CAAC;IAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,cAAI,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAS,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAC,IAAA,iBAAM,EAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACnF,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAAC,IAAA,iBAAM,EAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QACtF,IAAA,iBAAM,EAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,IAAA,iBAAM,EAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,GAAW,EAAE,QAAuB,EAAE,KAAoB,EAAE,KAAyB,EAAE,GAAY;IACnI,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAAC,IAAA,gBAAK,EAAC,iCAAiC,CAAC,CAAC;IAAC,CAAC;IAC7F,MAAM,QAAQ,GAAG,cAAI,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAS,CAAC,CAAC;IACpF,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAC,IAAA,iBAAM,EAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACnG,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,WAAoB,CAAC;IACzB,IAAI,CAAC;QAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,WAAW,GAAG,KAAK,CAAC;IAAC,CAAC;IACxE,EAAE,CAAC,KAAM,CAAC,GAAG,WAA+B,CAAC;IAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClD,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,IAAA,iBAAM,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,mBAAmB,CAAC,GAAW,EAAE,QAAuB,EAAE,IAAmB,EAAE,GAAY;IACzG,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAAC,IAAA,gBAAK,EAAC,wBAAwB,CAAC,CAAC;IAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,cAAI,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAS,CAAC,CAAC;IACpF,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAC,IAAA,iBAAM,EAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACnG,MAAM,OAAO,GAAG,YAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,SAAkC,CAAC;IACvC,IAAI,CAAC;QAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAK,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,IAAA,gBAAK,EAAC,yBAAyB,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC1F,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAClD,YAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,IAAA,iBAAM,EAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,SAAgB,sBAAsB,CAAC,GAAW,EAAE,QAAuB,EAAE,UAAyB,EAAE,GAAY;IAClH,IAAI,CAAC,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;QAAC,IAAA,gBAAK,EAAC,0BAA0B,CAAC,CAAC;IAAC,CAAC;IACpE,MAAM,MAAM,GAAG,2BAAmB,CAAC,UAAW,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QAAC,IAAA,gBAAK,EAAC,mBAAmB,UAAU,gBAAgB,MAAM,CAAC,IAAI,CAAC,2BAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,CAAC;IACnH,MAAM,QAAQ,GAAG,cAAI,CAAC,UAAU,CAAC,QAAS,CAAC,CAAC,CAAC,CAAC,QAAS,CAAC,CAAC,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAS,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,IAAA,uBAAY,EAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAC,IAAA,iBAAM,EAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IACnF,MAAM,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACjE,IAAA,iBAAM,EAAC,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACjI,CAAC"}

package/core/bin/lib/frontmatter.cts

@@ -0,0 +1,295 @@
+/**
+ * Frontmatter — YAML frontmatter parsing, serialization, and CRUD commands
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { safeReadFile, output, error } from './core.cjs';
+
+// ─── Parsing engine ───────────────────────────────────────────────────────────
+
+type FrontmatterValue = string | string[] | Record<string, unknown> | boolean | number | null;
+type FrontmatterObject = Record<string, FrontmatterValue>;
+
+export function extractFrontmatter(content: string): FrontmatterObject {
+  const frontmatter: FrontmatterObject = {};
+  const match = content.match(/^---\n([\s\S]+?)\n---/);
+  if (!match) return frontmatter;
+
+  const yaml = match[1];
+  const lines = yaml.split('\n');
+
+  // Stack to track nested objects: [{obj, key, indent}]
+  // obj = object to write to, key = current key collecting array items, indent = indentation level
+  type StackFrame = { obj: Record<string, unknown> | unknown[]; key: string | null; indent: number };
+  const stack: StackFrame[] = [{ obj: frontmatter as Record<string, unknown>, key: null, indent: -1 }];
+
+  for (const line of lines) {
+    // Skip empty lines
+    if (line.trim() === '') continue;
+
+    // Calculate indentation (number of leading spaces)
+    const indentMatch = line.match(/^(\s*)/);
+    const indent = indentMatch ? indentMatch[1].length : 0;
+
+    // Pop stack back to appropriate level
+    while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+      stack.pop();
+    }
+
+    const current = stack[stack.length - 1];
+
+    // Check for key: value pattern
+    const keyMatch = line.match(/^(\s*)([a-zA-Z0-9_-]+):\s*(.*)/);
+    if (keyMatch) {
+      const key = keyMatch[2];
+      const value = keyMatch[3].trim();
+      const currentObj = current.obj as Record<string, unknown>;
+
+      if (value === '' || value === '[') {
+        // Key with no value or opening bracket — could be nested object or array
+        // We'll determine based on next lines, for now create placeholder
+        currentObj[key] = value === '[' ? [] : {};
+        current.key = null;
+        // Push new context for potential nested content
+        stack.push({ obj: currentObj[key] as Record<string, unknown> | unknown[], key: null, indent });
+      } else if (value.startsWith('[') && value.endsWith(']')) {
+        // Inline array: key: [a, b, c]
+        currentObj[key] = value.slice(1, -1).split(',').map(s => s.trim().replace(/^["']|["']$/g, '')).filter(Boolean);
+        current.key = null;
+      } else {
+        // Simple key: value
+        currentObj[key] = value.replace(/^["']|["']$/g, '');
+        current.key = null;
+      }
+    } else if (line.trim().startsWith('- ')) {
+      // Array item
+      const itemValue = line.trim().slice(2).replace(/^["']|["']$/g, '');
+
+      // If current context is an empty object, convert to array
+      if (typeof current.obj === 'object' && !Array.isArray(current.obj) && Object.keys(current.obj).length === 0) {
+        // Find the key in parent that points to this object and convert it
+        const parent = stack.length > 1 ? stack[stack.length - 2] : null;
+        if (parent) {
+          const parentObj = parent.obj as Record<string, unknown>;
+          for (const k of Object.keys(parentObj)) {
+            if (parentObj[k] === current.obj) {
+              parentObj[k] = [itemValue];
+              (current as { obj: unknown[] | Record<string, unknown> }).obj = parentObj[k] as unknown[];
+              break;
+            }
+          }
+        }
+      } else if (Array.isArray(current.obj)) {
+        (current.obj as unknown[]).push(itemValue);
+      }
+    }
+  }
+
+  return frontmatter;
+}
+
+export function reconstructFrontmatter(obj: Record<string, unknown>): string {
+  const lines: string[] = [];
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === null || value === undefined) continue;
+    if (Array.isArray(value)) {
+      if (value.length === 0) {
+        lines.push(`${key}: []`);
+      } else if (value.every(v => typeof v === 'string') && value.length <= 3 && (value as string[]).join(', ').length < 60) {
+        lines.push(`${key}: [${(value as string[]).join(', ')}]`);
+      } else {
+        lines.push(`${key}:`);
+        for (const item of value) {
+          lines.push(`  - ${typeof item === 'string' && (item.includes(':') || item.includes('#')) ? `"${item}"` : item}`);
+        }
+      }
+    } else if (typeof value === 'object') {
+      lines.push(`${key}:`);
+      for (const [subkey, subval] of Object.entries(value as Record<string, unknown>)) {
+        if (subval === null || subval === undefined) continue;
+        if (Array.isArray(subval)) {
+          if (subval.length === 0) {
+            lines.push(`  ${subkey}: []`);
+          } else if (subval.every(v => typeof v === 'string') && subval.length <= 3 && (subval as string[]).join(', ').length < 60) {
+            lines.push(`  ${subkey}: [${(subval as string[]).join(', ')}]`);
+          } else {
+            lines.push(`  ${subkey}:`);
+            for (const item of subval) {
+              lines.push(`    - ${typeof item === 'string' && (item.includes(':') || item.includes('#')) ? `"${item}"` : item}`);
+            }
+          }
+        } else if (typeof subval === 'object') {
+          lines.push(`  ${subkey}:`);
+          for (const [subsubkey, subsubval] of Object.entries(subval as Record<string, unknown>)) {
+            if (subsubval === null || subsubval === undefined) continue;
+            if (Array.isArray(subsubval)) {
+              if (subsubval.length === 0) {
+                lines.push(`    ${subsubkey}: []`);
+              } else {
+                lines.push(`    ${subsubkey}:`);
+                for (const item of subsubval) {
+                  lines.push(`      - ${item}`);
+                }
+              }
+            } else {
+              lines.push(`    ${subsubkey}: ${subsubval}`);
+            }
+          }
+        } else {
+          const sv = String(subval);
+          lines.push(`  ${subkey}: ${sv.includes(':') || sv.includes('#') ? `"${sv}"` : sv}`);
+        }
+      }
+    } else {
+      const sv = String(value);
+      if (sv.includes(':') || sv.includes('#') || sv.startsWith('[') || sv.startsWith('{')) {
+        lines.push(`${key}: "${sv}"`);
+      } else {
+        lines.push(`${key}: ${sv}`);
+      }
+    }
+  }
+  return lines.join('\n');
+}
+
+export function spliceFrontmatter(content: string, newObj: Record<string, unknown>): string {
+  const yamlStr = reconstructFrontmatter(newObj);
+  const match = content.match(/^---\n[\s\S]+?\n---/);
+  if (match) {
+    return `---\n${yamlStr}\n---` + content.slice(match[0].length);
+  }
+  return `---\n${yamlStr}\n---\n\n` + content;
+}
+
+export function parseMustHavesBlock(content: string, blockName: string): unknown[] {
+  // Extract a specific block from must_haves in raw frontmatter YAML
+  // Handles 3-level nesting: must_haves > artifacts/key_links > [{path, provides, ...}]
+  const fmMatch = content.match(/^---\n([\s\S]+?)\n---/);
+  if (!fmMatch) return [];
+
+  const yaml = fmMatch[1];
+  // Find the block (e.g., "truths:", "artifacts:", "key_links:")
+  const blockPattern = new RegExp(`^\\s{4}${blockName}:\\s*$`, 'm');
+  const blockStart = yaml.search(blockPattern);
+  if (blockStart === -1) return [];
+
+  const afterBlock = yaml.slice(blockStart);
+  const blockLines = afterBlock.split('\n').slice(1); // skip the header line
+
+  const items: unknown[] = [];
+  let current: Record<string, unknown> | string | null = null;
+
+  for (const line of blockLines) {
+    // Stop at same or lower indent level (non-continuation)
+    if (line.trim() === '') continue;
+    const indentMatch = line.match(/^(\s*)/);
+    const indent = indentMatch ? indentMatch[1].length : 0;
+    if (indent <= 4 && line.trim() !== '') break; // back to must_haves level or higher
+
+    if (line.match(/^\s{6}-\s+/)) {
+      // New list item at 6-space indent
+      if (current) items.push(current);
+      current = {};
+      // Check if it's a simple string item
+      const simpleMatch = line.match(/^\s{6}-\s+"?([^"]+)"?\s*$/);
+      if (simpleMatch && !line.includes(':')) {
+        current = simpleMatch[1];
+      } else {
+        // Key-value on same line as dash: "- path: value"
+        const kvMatch = line.match(/^\s{6}-\s+(\w+):\s*"?([^"]*)"?\s*$/);
+        if (kvMatch) {
+          current = {};
+          (current as Record<string, unknown>)[kvMatch[1]] = kvMatch[2];
+        }
+      }
+    } else if (current && typeof current === 'object') {
+      const currentObj = current as Record<string, unknown>;
+      // Continuation key-value at 8+ space indent
+      const kvMatch = line.match(/^\s{8,}(\w+):\s*"?([^"]*)"?\s*$/);
+      if (kvMatch) {
+        const val = kvMatch[2];
+        // Try to parse as number
+        currentObj[kvMatch[1]] = /^\d+$/.test(val) ? parseInt(val, 10) : val;
+      }
+      // Array items under a key
+      const arrMatch = line.match(/^\s{10,}-\s+"?([^"]+)"?\s*$/);
+      if (arrMatch) {
+        // Find the last key added and convert to array
+        const keys = Object.keys(currentObj);
+        const lastKey = keys[keys.length - 1];
+        if (lastKey && !Array.isArray(currentObj[lastKey])) {
+          currentObj[lastKey] = currentObj[lastKey] ? [currentObj[lastKey]] : [];
+        }
+        if (lastKey) (currentObj[lastKey] as unknown[]).push(arrMatch[1]);
+      }
+    }
+  }
+  if (current) items.push(current);
+
+  return items;
+}
+
+// ─── Frontmatter CRUD commands ────────────────────────────────────────────────
+
+export const FRONTMATTER_SCHEMAS: Record<string, { required: string[] }> = {
+  plan: { required: ['phase', 'plan', 'type', 'wave', 'depends_on', 'files_modified', 'autonomous', 'must_haves'] },
+  summary: { required: ['phase', 'plan', 'subsystem', 'tags', 'duration', 'completed'] },
+  verification: { required: ['phase', 'verified', 'status', 'score'] },
+};
+
+export function cmdFrontmatterGet(cwd: string, filePath: string | null, field: string | null, raw: boolean): void {
+  if (!filePath) { error('file path required'); }
+  const fullPath = path.isAbsolute(filePath!) ? filePath! : path.join(cwd, filePath!);
+  const content = safeReadFile(fullPath);
+  if (!content) { output({ error: 'File not found', path: filePath }, raw); return; }
+  const fm = extractFrontmatter(content);
+  if (field) {
+    const value = fm[field];
+    if (value === undefined) { output({ error: 'Field not found', field }, raw); return; }
+    output({ [field]: value }, raw, JSON.stringify(value));
+  } else {
+    output(fm, raw);
+  }
+}
+
+export function cmdFrontmatterSet(cwd: string, filePath: string | null, field: string | null, value: string | undefined, raw: boolean): void {
+  if (!filePath || !field || value === undefined) { error('file, field, and value required'); }
+  const fullPath = path.isAbsolute(filePath!) ? filePath! : path.join(cwd, filePath!);
+  if (!fs.existsSync(fullPath)) { output({ error: 'File not found', path: filePath }, raw); return; }
+  const content = fs.readFileSync(fullPath, 'utf-8');
+  const fm = extractFrontmatter(content);
+  let parsedValue: unknown;
+  try { parsedValue = JSON.parse(value!); } catch { parsedValue = value; }
+  fm[field!] = parsedValue as FrontmatterValue;
+  const newContent = spliceFrontmatter(content, fm);
+  fs.writeFileSync(fullPath, newContent, 'utf-8');
+  output({ updated: true, field, value: parsedValue }, raw, 'true');
+}
+
+export function cmdFrontmatterMerge(cwd: string, filePath: string | null, data: string | null, raw: boolean): void {
+  if (!filePath || !data) { error('file and data required'); }
+  const fullPath = path.isAbsolute(filePath!) ? filePath! : path.join(cwd, filePath!);
+  if (!fs.existsSync(fullPath)) { output({ error: 'File not found', path: filePath }, raw); return; }
+  const content = fs.readFileSync(fullPath, 'utf-8');
+  const fm = extractFrontmatter(content);
+  let mergeData: Record<string, unknown>;
+  try { mergeData = JSON.parse(data!); } catch { error('Invalid JSON for --data'); return; }
+  Object.assign(fm, mergeData);
+  const newContent = spliceFrontmatter(content, fm);
+  fs.writeFileSync(fullPath, newContent, 'utf-8');
+  output({ merged: true, fields: Object.keys(mergeData) }, raw, 'true');
+}
+
+export function cmdFrontmatterValidate(cwd: string, filePath: string | null, schemaName: string | null, raw: boolean): void {
+  if (!filePath || !schemaName) { error('file and schema required'); }
+  const schema = FRONTMATTER_SCHEMAS[schemaName!];
+  if (!schema) { error(`Unknown schema: ${schemaName}. Available: ${Object.keys(FRONTMATTER_SCHEMAS).join(', ')}`); }
+  const fullPath = path.isAbsolute(filePath!) ? filePath! : path.join(cwd, filePath!);
+  const content = safeReadFile(fullPath);
+  if (!content) { output({ error: 'File not found', path: filePath }, raw); return; }
+  const fm = extractFrontmatter(content);
+  const missing = schema.required.filter(f => fm[f] === undefined);
+  const present = schema.required.filter(f => fm[f] !== undefined);
+  output({ valid: missing.length === 0, missing, present, schema: schemaName }, raw, missing.length === 0 ? 'valid' : 'invalid');
+}