@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/frontmatter-mutation.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Frontmatter mutation handlers — write operations for YAML frontmatter.
+ *
+ * Ported from get-shit-done/bin/lib/frontmatter.cjs.
+ * Provides reconstructFrontmatter (serialization), spliceFrontmatter (replacement),
+ * and query handlers for frontmatter.set, frontmatter.merge, frontmatter.validate.
+ *
+ * @example
+ * ```typescript
+ * import { reconstructFrontmatter, spliceFrontmatter } from './frontmatter-mutation.js';
+ *
+ * const yaml = reconstructFrontmatter({ phase: '10', tags: ['a', 'b'] });
+ * // 'phase: 10\ntags: [a, b]'
+ *
+ * const updated = spliceFrontmatter('---\nold: val\n---\nbody', { new: 'val' });
+ * // '---\nnew: val\n---\nbody'
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+/** Schema definitions for frontmatter validation. */
+export declare const FRONTMATTER_SCHEMAS: Record<string, {
+    required: string[];
+}>;
+/**
+ * Serialize a flat/nested object into YAML frontmatter lines.
+ *
+ * Port of `reconstructFrontmatter` from frontmatter.cjs lines 122-183.
+ * Handles arrays (inline/dash), nested objects (2 levels), and quoting.
+ *
+ * @param obj - Object to serialize
+ * @returns YAML string (without --- delimiters)
+ */
+export declare function reconstructFrontmatter(obj: Record<string, unknown>): string;
+/**
+ * Replace or prepend frontmatter in content.
+ *
+ * Port of `spliceFrontmatter` from frontmatter.cjs lines 186-193.
+ *
+ * @param content - File content with potential existing frontmatter
+ * @param newObj - New frontmatter object to serialize
+ * @returns Content with updated frontmatter
+ */
+export declare function spliceFrontmatter(content: string, newObj: Record<string, unknown>): string;
+/**
+ * Query handler for frontmatter.set command.
+ *
+ * Reads a file, sets a single frontmatter field, writes back with normalization.
+ * Port of `cmdFrontmatterSet` from frontmatter.cjs lines 328-342.
+ *
+ * @param args - args[0]: file path, args[1]: field name, args[2]: value
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { updated: true, field, value }
+ */
+export declare const frontmatterSet: QueryHandler;
+/**
+ * Query handler for frontmatter.merge command.
+ *
+ * Reads a file, merges JSON object into existing frontmatter, writes back.
+ * Port of `cmdFrontmatterMerge` from frontmatter.cjs lines 344-356.
+ *
+ * @param args - `file --data <json>` (gsd-tools) or `[file, jsonString]` (SDK)
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { merged: true, fields: [...] }
+ */
+export declare const frontmatterMerge: QueryHandler;
+/**
+ * Query handler for frontmatter.validate command.
+ *
+ * Reads a file and checks its frontmatter against a known schema.
+ * Port of `cmdFrontmatterValidate` from frontmatter.cjs lines 358-369.
+ *
+ * @param args - args[0]: file path, args[1]: '--schema', args[2]: schema name
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { valid, missing, present, schema }
+ */
+export declare const frontmatterValidate: QueryHandler;
+//# sourceMappingURL=frontmatter-mutation.d.ts.map

package/sdk/dist/query/frontmatter-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-mutation.d.ts","sourceRoot":"","sources":["../../src/query/frontmatter-mutation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,qDAAqD;AACrD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAItE,CAAC;AAIF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CA+C3E;AA4BD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAO1F;AAmBD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,YAiD5B,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAuC9B,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,YA8CjC,CAAC"}

package/sdk/dist/query/frontmatter-mutation.js

@@ -0,0 +1,299 @@
+/**
+ * Frontmatter mutation handlers — write operations for YAML frontmatter.
+ *
+ * Ported from get-shit-done/bin/lib/frontmatter.cjs.
+ * Provides reconstructFrontmatter (serialization), spliceFrontmatter (replacement),
+ * and query handlers for frontmatter.set, frontmatter.merge, frontmatter.validate.
+ *
+ * @example
+ * ```typescript
+ * import { reconstructFrontmatter, spliceFrontmatter } from './frontmatter-mutation.js';
+ *
+ * const yaml = reconstructFrontmatter({ phase: '10', tags: ['a', 'b'] });
+ * // 'phase: 10\ntags: [a, b]'
+ *
+ * const updated = spliceFrontmatter('---\nold: val\n---\nbody', { new: 'val' });
+ * // '---\nnew: val\n---\nbody'
+ * ```
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { GSDError, ErrorClassification } from '../errors.js';
+import { extractFrontmatter } from './frontmatter.js';
+import { normalizeMd, resolveFrontmatterPath } from './helpers.js';
+// ─── FRONTMATTER_SCHEMAS ──────────────────────────────────────────────────
+/** Schema definitions for frontmatter validation. */
+export const 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'] },
+};
+// ─── reconstructFrontmatter ────────────────────────────────────────────────
+/**
+ * Serialize a flat/nested object into YAML frontmatter lines.
+ *
+ * Port of `reconstructFrontmatter` from frontmatter.cjs lines 122-183.
+ * Handles arrays (inline/dash), nested objects (2 levels), and quoting.
+ *
+ * @param obj - Object to serialize
+ * @returns YAML string (without --- delimiters)
+ */
+export function reconstructFrontmatter(obj) {
+    const lines = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === null || value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            serializeArray(lines, key, value, '');
+        }
+        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)) {
+                    serializeArray(lines, subkey, subval, '  ');
+                }
+                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}: ${needsQuoting(sv) ? `"${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');
+}
+/** Serialize an array at the given indent level. */
+function serializeArray(lines, key, arr, indent) {
+    if (arr.length === 0) {
+        lines.push(`${indent}${key}: []`);
+    }
+    else if (arr.every(v => typeof v === 'string') &&
+        arr.length <= 3 &&
+        arr.join(', ').length < 60) {
+        lines.push(`${indent}${key}: [${arr.join(', ')}]`);
+    }
+    else {
+        lines.push(`${indent}${key}:`);
+        for (const item of arr) {
+            const s = String(item);
+            lines.push(`${indent}  - ${typeof item === 'string' && needsQuoting(s) ? `"${s}"` : s}`);
+        }
+    }
+}
+/** Check if a string value needs quoting in YAML. */
+function needsQuoting(s) {
+    return s.includes(':') || s.includes('#');
+}
+// ─── spliceFrontmatter ─────────────────────────────────────────────────────
+/**
+ * Replace or prepend frontmatter in content.
+ *
+ * Port of `spliceFrontmatter` from frontmatter.cjs lines 186-193.
+ *
+ * @param content - File content with potential existing frontmatter
+ * @param newObj - New frontmatter object to serialize
+ * @returns Content with updated frontmatter
+ */
+export function spliceFrontmatter(content, newObj) {
+    const yamlStr = reconstructFrontmatter(newObj);
+    const match = content.match(/^---\r?\n[\s\S]+?\r?\n---/);
+    if (match) {
+        return `---\n${yamlStr}\n---` + content.slice(match[0].length);
+    }
+    return `---\n${yamlStr}\n---\n\n` + content;
+}
+// ─── parseSimpleValue ──────────────────────────────────────────────────────
+/**
+ * Parse a simple CLI value string into a typed value.
+ * Tries JSON.parse first (handles booleans, numbers, arrays, objects).
+ * Falls back to raw string.
+ */
+function parseSimpleValue(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+// ─── frontmatterSet ────────────────────────────────────────────────────────
+/**
+ * Query handler for frontmatter.set command.
+ *
+ * Reads a file, sets a single frontmatter field, writes back with normalization.
+ * Port of `cmdFrontmatterSet` from frontmatter.cjs lines 328-342.
+ *
+ * @param args - args[0]: file path, args[1]: field name, args[2]: value
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { updated: true, field, value }
+ */
+export const frontmatterSet = async (args, projectDir) => {
+    let filePath;
+    let field;
+    let value;
+    const fi = args.indexOf('--field');
+    const vi = args.indexOf('--value');
+    const hasNamedArgs = fi !== -1 || vi !== -1;
+    if (hasNamedArgs) {
+        if (fi === -1 || vi === -1 || !args[fi + 1] || args[vi + 1] === undefined) {
+            throw new GSDError('file, --field, and --value required together', ErrorClassification.Validation);
+        }
+        filePath = args[0];
+        field = args[fi + 1];
+        value = args[vi + 1];
+    }
+    else {
+        filePath = args[0];
+        field = args[1];
+        value = args[2];
+    }
+    if (!filePath || !field || value === undefined) {
+        throw new GSDError('file, field, and value required', ErrorClassification.Validation);
+    }
+    // Path traversal guard: reject null bytes
+    if (filePath.includes('\0')) {
+        throw new GSDError('file path contains null bytes', ErrorClassification.Validation);
+    }
+    // CJS parity (frontmatter.cjs:340/354/369): no project-root prefix check.
+    // Bug #3509 — accept absolute paths outside the project (tmpdirs whose
+    // names include spaces fail the under-project test on macOS).
+    const fullPath = resolveFrontmatterPath(projectDir, filePath);
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf-8');
+    }
+    catch {
+        return { data: { error: 'File not found', path: filePath } };
+    }
+    const fm = extractFrontmatter(content);
+    const parsedValue = parseSimpleValue(value);
+    fm[field] = parsedValue;
+    const newContent = spliceFrontmatter(content, fm);
+    await writeFile(fullPath, normalizeMd(newContent), 'utf-8');
+    return { data: { updated: true, field, value: parsedValue } };
+};
+// ─── frontmatterMerge ──────────────────────────────────────────────────────
+/**
+ * Query handler for frontmatter.merge command.
+ *
+ * Reads a file, merges JSON object into existing frontmatter, writes back.
+ * Port of `cmdFrontmatterMerge` from frontmatter.cjs lines 344-356.
+ *
+ * @param args - `file --data <json>` (gsd-tools) or `[file, jsonString]` (SDK)
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { merged: true, fields: [...] }
+ */
+export const frontmatterMerge = async (args, projectDir) => {
+    const filePath = args[0];
+    const dataIdx = args.indexOf('--data');
+    const jsonString = dataIdx !== -1 ? args[dataIdx + 1] : args[1];
+    if (!filePath || !jsonString) {
+        throw new GSDError('file and data required', ErrorClassification.Validation);
+    }
+    // Path traversal guard: reject null bytes (consistent with frontmatterSet)
+    if (filePath.includes('\0')) {
+        throw new GSDError('file path contains null bytes', ErrorClassification.Validation);
+    }
+    // CJS parity (frontmatter.cjs:340/354/369): no project-root prefix check.
+    // Bug #3509 — accept absolute paths outside the project (tmpdirs whose
+    // names include spaces fail the under-project test on macOS).
+    const fullPath = resolveFrontmatterPath(projectDir, filePath);
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf-8');
+    }
+    catch {
+        return { data: { error: 'File not found', path: filePath } };
+    }
+    let mergeData;
+    try {
+        mergeData = JSON.parse(jsonString);
+    }
+    catch {
+        throw new GSDError('Invalid JSON for merge data', ErrorClassification.Validation);
+    }
+    const fm = extractFrontmatter(content);
+    Object.assign(fm, mergeData);
+    const newContent = spliceFrontmatter(content, fm);
+    await writeFile(fullPath, normalizeMd(newContent), 'utf-8');
+    return { data: { merged: true, fields: Object.keys(mergeData) } };
+};
+// ─── frontmatterValidate ───────────────────────────────────────────────────
+/**
+ * Query handler for frontmatter.validate command.
+ *
+ * Reads a file and checks its frontmatter against a known schema.
+ * Port of `cmdFrontmatterValidate` from frontmatter.cjs lines 358-369.
+ *
+ * @param args - args[0]: file path, args[1]: '--schema', args[2]: schema name
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { valid, missing, present, schema }
+ */
+export const frontmatterValidate = async (args, projectDir) => {
+    const filePath = args[0];
+    // Parse --schema flag from args
+    let schemaName;
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--schema' && args[i + 1]) {
+            schemaName = args[i + 1];
+            break;
+        }
+    }
+    if (!filePath || !schemaName) {
+        throw new GSDError('file and schema required', ErrorClassification.Validation);
+    }
+    // Path traversal guard: reject null bytes (consistent with frontmatterSet)
+    if (filePath.includes('\0')) {
+        throw new GSDError('file path contains null bytes', ErrorClassification.Validation);
+    }
+    const schema = FRONTMATTER_SCHEMAS[schemaName];
+    if (!schema) {
+        throw new GSDError(`Unknown schema: ${schemaName}. Available: ${Object.keys(FRONTMATTER_SCHEMAS).join(', ')}`, ErrorClassification.Validation);
+    }
+    // CJS parity (frontmatter.cjs:340/354/369): no project-root prefix check.
+    // Bug #3509 — accept absolute paths outside the project (tmpdirs whose
+    // names include spaces fail the under-project test on macOS).
+    const fullPath = resolveFrontmatterPath(projectDir, filePath);
+    let content;
+    try {
+        content = await readFile(fullPath, 'utf-8');
+    }
+    catch {
+        return { data: { error: 'File not found', path: filePath } };
+    }
+    const fm = extractFrontmatter(content);
+    const missing = schema.required.filter(f => fm[f] === undefined);
+    const present = schema.required.filter(f => fm[f] !== undefined);
+    return { data: { valid: missing.length === 0, missing, present, schema: schemaName } };
+};
+//# sourceMappingURL=frontmatter-mutation.js.map

package/sdk/dist/query/frontmatter-mutation.js.map

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

package/sdk/dist/query/frontmatter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Frontmatter parser and query handler.
+ *
+ * Ported from get-shit-done/bin/lib/frontmatter.cjs and state.cjs.
+ * Provides YAML frontmatter extraction from .planning/ artifacts.
+ *
+ * @example
+ * ```typescript
+ * import { extractFrontmatter, frontmatterGet } from './frontmatter.js';
+ *
+ * const fm = extractFrontmatter('---\nphase: 10\nplan: 01\n---\nbody');
+ * // { phase: '10', plan: '01' }
+ *
+ * const result = await frontmatterGet(['STATE.md'], '/project');
+ * // { data: { gsd_state_version: '1.0', milestone: 'v3.0', ... } }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Quote-aware CSV splitting for inline YAML arrays.
+ *
+ * Handles both single and double quotes, preserving commas inside quotes.
+ *
+ * @param body - The content inside brackets, e.g. 'a, "b, c", d'
+ * @returns Array of trimmed values
+ */
+export declare function splitInlineArray(body: string): string[];
+/**
+ * First leading frontmatter block only — parity with `get-shit-done/bin/lib/frontmatter.cjs`
+ * `extractFrontmatter` (used by `summary-extract` and `history-digest` in gsd-tools.cjs).
+ */
+export declare function extractFrontmatterLeading(content: string): Record<string, unknown>;
+/**
+ * Parse YAML frontmatter from file content.
+ *
+ * Full stack-based parser supporting:
+ * - Simple key: value pairs
+ * - Nested objects via indentation
+ * - Inline arrays: key: [a, b, c]
+ * - Dash arrays with auto-conversion from empty objects
+ * - CRLF line endings
+ * - Quoted value stripping
+ *
+ * Anchored at the start of the file — only the leading `---...---` block is
+ * considered canonical frontmatter. Body `---` separators and embedded YAML
+ * examples inside fenced code blocks are never picked up.
+ *
+ * @param content - File content potentially containing frontmatter
+ * @returns Parsed frontmatter as a record, or empty object if none found
+ */
+export declare function extractFrontmatter(content: string): Record<string, unknown>;
+/**
+ * Strip all frontmatter blocks from the start of content.
+ *
+ * Handles CRLF line endings and multiple stacked blocks (corruption recovery).
+ * Greedy: keeps stripping ---...--- blocks separated by optional whitespace.
+ *
+ * @param content - File content with potential frontmatter
+ * @returns Content with frontmatter removed
+ */
+export declare function stripFrontmatter(content: string): string;
+/**
+ * Result of parsing a must_haves block from frontmatter.
+ */
+export interface MustHavesBlockResult {
+    items: unknown[];
+    warnings: string[];
+}
+/**
+ * Parse a named block from must_haves in raw frontmatter YAML.
+ *
+ * Port of `parseMustHavesBlock` from `get-shit-done/bin/lib/frontmatter.cjs` lines 195-301.
+ * Handles 3-level nesting: `must_haves > blockName > [{key: value, ...}]`.
+ * Supports simple string items, structured objects with key-value pairs,
+ * and nested arrays within items.
+ *
+ * @param content - File content with frontmatter
+ * @param blockName - Block name under must_haves (e.g. 'artifacts', 'key_links', 'truths')
+ * @returns Structured result with items array and warnings
+ */
+export declare function parseMustHavesBlock(content: string, blockName: string): MustHavesBlockResult;
+/**
+ * Query handler for frontmatter.get command.
+ *
+ * Reads a file, extracts frontmatter, and optionally returns a single field.
+ * Rejects null bytes in path (security: path traversal guard).
+ *
+ * @param args - args[0]: file path, args[1]: optional field name
+ * @param projectDir - Project root directory
+ * @returns QueryResult with parsed frontmatter or single field value
+ */
+export declare const frontmatterGet: QueryHandler;
+//# sourceMappingURL=frontmatter.d.ts.map

package/sdk/dist/query/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/query/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BvD;AAiGD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIlF;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE3E;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD;AAID;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CA0G5F;AAID;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,YAwC5B,CAAC"}