@warnyin/sdlc 0.1.0 → 0.2.0

package/lib/delta.mjs

@@ -1,160 +1,160 @@
-// Delta-spec grammar (parser keys are frozen English regardless of any
-// UI language):
-//
-//   ## Delta: <capability>
-//   ### ADDED Requirement: <name>
-//   The system SHALL <behavior>.
-//   #### Scenario: <name>
-//   - WHEN <condition>
-//   - THEN <outcome>
-//   ### MODIFIED Requirement: <existing name>   ← full replacement body
-//   ### REMOVED Requirement: <existing name>
-//
-// Requirement heading text is the identity key (OpenSpec convention).
-// `mergeDelta` applies ops mechanically to a living spec; a missing key on
-// MODIFIED/REMOVED is a hard error — never merge silently.
-
-const DELTA_HEAD = /^## Delta:\s*(.+?)\s*$/;
-const OP_HEAD = /^### (ADDED|MODIFIED|REMOVED) Requirement:\s*(.+?)\s*$/;
-const BAD_OP_HEAD = /^### (\w+) Requirement:/;
-const SPEC_REQ_HEAD = /^### Requirement:\s*(.+?)\s*$/;
-
-export function parseDelta(changeText) {
-  const lines = (changeText ?? '').split(/\r?\n/);
-  const deltas = [];
-  const errors = [];
-  let current = null;   // { capability, ops }
-  let currentOp = null; // { op, name, bodyLines }
-
-  const closeOp = () => {
-    if (!currentOp) return;
-    const body = currentOp.bodyLines.join('\n').trim();
-    if (currentOp.op !== 'REMOVED' && body === '') {
-      errors.push(`${currentOp.op} Requirement "${currentOp.name}" has an empty body`);
-    }
-    current.ops.push({ op: currentOp.op, name: currentOp.name, body });
-    currentOp = null;
-  };
-
-  for (const line of lines) {
-    const deltaMatch = line.match(DELTA_HEAD);
-    if (deltaMatch) {
-      closeOp();
-      // Repeated `## Delta: <cap>` blocks merge into one entry — otherwise the
-      // last block would silently overwrite the first at ship time.
-      const existing = deltas.find((d) => d.capability.toLowerCase() === deltaMatch[1].toLowerCase());
-      current = existing ?? { capability: deltaMatch[1], ops: [] };
-      if (!existing) deltas.push(current);
-      continue;
-    }
-    if (/^## /.test(line) && !deltaMatch) {
-      closeOp();
-      current = null; // left the delta section
-      continue;
-    }
-    if (!current) continue;
-
-    const opMatch = line.match(OP_HEAD);
-    if (opMatch) {
-      closeOp();
-      currentOp = { op: opMatch[1], name: opMatch[2], bodyLines: [] };
-      continue;
-    }
-    const badOp = line.match(BAD_OP_HEAD);
-    if (badOp && !opMatch) {
-      errors.push(`Unknown delta operation "${badOp[1]}" (use ADDED, MODIFIED, or REMOVED)`);
-      continue;
-    }
-    if (currentOp) currentOp.bodyLines.push(line);
-  }
-  closeOp();
-
-  for (const d of deltas) {
-    const seen = new Set();
-    for (const op of d.ops) {
-      const key = op.name.toLowerCase();
-      if (seen.has(key)) errors.push(`Duplicate requirement "${op.name}" in Delta: ${d.capability}`);
-      seen.add(key);
-    }
-    if (d.ops.length === 0) errors.push(`Delta: ${d.capability} declares no requirement operations`);
-  }
-
-  return { deltas, errors };
-}
-
-export function parseSpec(specText) {
-  const lines = (specText ?? '').split(/\r?\n/);
-  const requirements = [];
-  const preamble = [];
-  let current = null;
-
-  for (const line of lines) {
-    const reqMatch = line.match(SPEC_REQ_HEAD);
-    if (reqMatch) {
-      current = { name: reqMatch[1], bodyLines: [] };
-      requirements.push(current);
-      continue;
-    }
-    if (current) current.bodyLines.push(line);
-    else preamble.push(line);
-  }
-
-  return {
-    preamble: preamble.join('\n').replace(/\n+$/, ''),
-    requirements: requirements.map((r) => ({
-      name: r.name,
-      body: r.bodyLines.join('\n').trim(),
-    })),
-  };
-}
-
-export function renderSpec({ preamble, requirements }) {
-  const parts = [preamble.replace(/\n+$/, '')];
-  for (const r of requirements) {
-    parts.push(`\n### Requirement: ${r.name}\n${r.body}`);
-  }
-  return parts.join('\n').replace(/\n+$/, '\n');
-}
-
-export function newSpecPreamble(capability) {
-  return [
-    `# Spec: ${capability}`,
-    '',
-    '## Purpose',
-    '<!-- one or two lines; commands grep this header first (progressive disclosure) -->',
-    '',
-    '## Requirements',
-  ].join('\n');
-}
-
-// Apply one capability's ops to a living spec (or null to create it).
-// Returns { ok, content, errors }.
-export function mergeDelta(specText, ops, capability) {
-  const errors = [];
-  const spec = specText == null
-    ? { preamble: newSpecPreamble(capability), requirements: [] }
-    : parseSpec(specText);
-
-  const byName = new Map(spec.requirements.map((r) => [r.name.toLowerCase(), r]));
-
-  for (const { op, name, body } of ops) {
-    const key = name.toLowerCase();
-    const existing = byName.get(key);
-    if (op === 'ADDED') {
-      if (existing) { errors.push(`ADDED Requirement "${name}" already exists in spec "${capability}"`); continue; }
-      const req = { name, body };
-      spec.requirements.push(req);
-      byName.set(key, req);
-    } else if (op === 'MODIFIED') {
-      if (!existing) { errors.push(`MODIFIED Requirement "${name}" not found in spec "${capability}"`); continue; }
-      existing.body = body;
-    } else if (op === 'REMOVED') {
-      if (!existing) { errors.push(`REMOVED Requirement "${name}" not found in spec "${capability}"`); continue; }
-      spec.requirements = spec.requirements.filter((r) => r.name.toLowerCase() !== key);
-      byName.delete(key);
-    }
-  }
-
-  if (errors.length) return { ok: false, content: null, errors };
-  return { ok: true, content: renderSpec(spec), errors: [] };
-}
+// Delta-spec grammar (parser keys are frozen English regardless of any
+// UI language):
+//
+//   ## Delta: <capability>
+//   ### ADDED Requirement: <name>
+//   The system SHALL <behavior>.
+//   #### Scenario: <name>
+//   - WHEN <condition>
+//   - THEN <outcome>
+//   ### MODIFIED Requirement: <existing name>   ← full replacement body
+//   ### REMOVED Requirement: <existing name>
+//
+// Requirement heading text is the identity key (OpenSpec convention).
+// `mergeDelta` applies ops mechanically to a living spec; a missing key on
+// MODIFIED/REMOVED is a hard error — never merge silently.
+
+const DELTA_HEAD = /^## Delta:\s*(.+?)\s*$/;
+const OP_HEAD = /^### (ADDED|MODIFIED|REMOVED) Requirement:\s*(.+?)\s*$/;
+const BAD_OP_HEAD = /^### (\w+) Requirement:/;
+const SPEC_REQ_HEAD = /^### Requirement:\s*(.+?)\s*$/;
+
+export function parseDelta(changeText) {
+  const lines = (changeText ?? '').split(/\r?\n/);
+  const deltas = [];
+  const errors = [];
+  let current = null;   // { capability, ops }
+  let currentOp = null; // { op, name, bodyLines }
+
+  const closeOp = () => {
+    if (!currentOp) return;
+    const body = currentOp.bodyLines.join('\n').trim();
+    if (currentOp.op !== 'REMOVED' && body === '') {
+      errors.push(`${currentOp.op} Requirement "${currentOp.name}" has an empty body`);
+    }
+    current.ops.push({ op: currentOp.op, name: currentOp.name, body });
+    currentOp = null;
+  };
+
+  for (const line of lines) {
+    const deltaMatch = line.match(DELTA_HEAD);
+    if (deltaMatch) {
+      closeOp();
+      // Repeated `## Delta: <cap>` blocks merge into one entry — otherwise the
+      // last block would silently overwrite the first at ship time.
+      const existing = deltas.find((d) => d.capability.toLowerCase() === deltaMatch[1].toLowerCase());
+      current = existing ?? { capability: deltaMatch[1], ops: [] };
+      if (!existing) deltas.push(current);
+      continue;
+    }
+    if (/^## /.test(line) && !deltaMatch) {
+      closeOp();
+      current = null; // left the delta section
+      continue;
+    }
+    if (!current) continue;
+
+    const opMatch = line.match(OP_HEAD);
+    if (opMatch) {
+      closeOp();
+      currentOp = { op: opMatch[1], name: opMatch[2], bodyLines: [] };
+      continue;
+    }
+    const badOp = line.match(BAD_OP_HEAD);
+    if (badOp && !opMatch) {
+      errors.push(`Unknown delta operation "${badOp[1]}" (use ADDED, MODIFIED, or REMOVED)`);
+      continue;
+    }
+    if (currentOp) currentOp.bodyLines.push(line);
+  }
+  closeOp();
+
+  for (const d of deltas) {
+    const seen = new Set();
+    for (const op of d.ops) {
+      const key = op.name.toLowerCase();
+      if (seen.has(key)) errors.push(`Duplicate requirement "${op.name}" in Delta: ${d.capability}`);
+      seen.add(key);
+    }
+    if (d.ops.length === 0) errors.push(`Delta: ${d.capability} declares no requirement operations`);
+  }
+
+  return { deltas, errors };
+}
+
+export function parseSpec(specText) {
+  const lines = (specText ?? '').split(/\r?\n/);
+  const requirements = [];
+  const preamble = [];
+  let current = null;
+
+  for (const line of lines) {
+    const reqMatch = line.match(SPEC_REQ_HEAD);
+    if (reqMatch) {
+      current = { name: reqMatch[1], bodyLines: [] };
+      requirements.push(current);
+      continue;
+    }
+    if (current) current.bodyLines.push(line);
+    else preamble.push(line);
+  }
+
+  return {
+    preamble: preamble.join('\n').replace(/\n+$/, ''),
+    requirements: requirements.map((r) => ({
+      name: r.name,
+      body: r.bodyLines.join('\n').trim(),
+    })),
+  };
+}
+
+export function renderSpec({ preamble, requirements }) {
+  const parts = [preamble.replace(/\n+$/, '')];
+  for (const r of requirements) {
+    parts.push(`\n### Requirement: ${r.name}\n${r.body}`);
+  }
+  return parts.join('\n').replace(/\n+$/, '\n');
+}
+
+export function newSpecPreamble(capability) {
+  return [
+    `# Spec: ${capability}`,
+    '',
+    '## Purpose',
+    '<!-- one or two lines; commands grep this header first (progressive disclosure) -->',
+    '',
+    '## Requirements',
+  ].join('\n');
+}
+
+// Apply one capability's ops to a living spec (or null to create it).
+// Returns { ok, content, errors }.
+export function mergeDelta(specText, ops, capability) {
+  const errors = [];
+  const spec = specText == null
+    ? { preamble: newSpecPreamble(capability), requirements: [] }
+    : parseSpec(specText);
+
+  const byName = new Map(spec.requirements.map((r) => [r.name.toLowerCase(), r]));
+
+  for (const { op, name, body } of ops) {
+    const key = name.toLowerCase();
+    const existing = byName.get(key);
+    if (op === 'ADDED') {
+      if (existing) { errors.push(`ADDED Requirement "${name}" already exists in spec "${capability}"`); continue; }
+      const req = { name, body };
+      spec.requirements.push(req);
+      byName.set(key, req);
+    } else if (op === 'MODIFIED') {
+      if (!existing) { errors.push(`MODIFIED Requirement "${name}" not found in spec "${capability}"`); continue; }
+      existing.body = body;
+    } else if (op === 'REMOVED') {
+      if (!existing) { errors.push(`REMOVED Requirement "${name}" not found in spec "${capability}"`); continue; }
+      spec.requirements = spec.requirements.filter((r) => r.name.toLowerCase() !== key);
+      byName.delete(key);
+    }
+  }
+
+  if (errors.length) return { ok: false, content: null, errors };
+  return { ok: true, content: renderSpec(spec), errors: [] };
+}

package/lib/frontmatter.mjs

@@ -1,59 +1,59 @@
-// Minimal YAML-frontmatter reader (zero-dep). Supports the subset this
-// framework writes: strings, numbers, booleans, inline arrays, and
-// simple `- item` lists. Anything fancier is a validation error upstream.
-
-const FENCE = '---';
-
-export function parseFrontmatter(text) {
-  if (typeof text !== 'string') return { data: {}, body: '' };
-  const lines = text.split(/\r?\n/);
-  if (lines[0]?.trim() !== FENCE) return { data: {}, body: text };
-
-  let end = -1;
-  for (let i = 1; i < lines.length; i++) {
-    if (lines[i].trim() === FENCE) { end = i; break; }
-  }
-  if (end === -1) return { data: {}, body: text };
-
-  const data = {};
-  let currentListKey = null;
-  for (let i = 1; i < end; i++) {
-    const raw = lines[i];
-    if (!raw.trim() || raw.trim().startsWith('#')) continue;
-
-    const listItem = raw.match(/^\s+-\s+(.*)$/);
-    if (listItem && currentListKey) {
-      data[currentListKey].push(coerce(listItem[1].trim()));
-      continue;
-    }
-
-    const kv = raw.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (!kv) continue;
-    const [, key, rawValue] = kv;
-    if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;
-    const value = rawValue.trim();
-    if (value === '') {
-      data[key] = [];
-      currentListKey = key;
-    } else {
-      data[key] = coerce(value);
-      currentListKey = null;
-    }
-  }
-
-  return { data, body: lines.slice(end + 1).join('\n') };
-}
-
-function coerce(value) {
-  if (value.startsWith('[') && value.endsWith(']')) {
-    const inner = value.slice(1, -1).trim();
-    if (!inner) return [];
-    return inner.split(',').map((v) => coerce(v.trim()));
-  }
-  const unquoted = value.replace(/^["']|["']$/g, '');
-  if (unquoted !== value) return unquoted;
-  if (value === 'true') return true;
-  if (value === 'false') return false;
-  if (/^-?\d+(\.\d+)?$/.test(value)) return Number(value);
-  return value;
-}
+// Minimal YAML-frontmatter reader (zero-dep). Supports the subset this
+// framework writes: strings, numbers, booleans, inline arrays, and
+// simple `- item` lists. Anything fancier is a validation error upstream.
+
+const FENCE = '---';
+
+export function parseFrontmatter(text) {
+  if (typeof text !== 'string') return { data: {}, body: '' };
+  const lines = text.split(/\r?\n/);
+  if (lines[0]?.trim() !== FENCE) return { data: {}, body: text };
+
+  let end = -1;
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i].trim() === FENCE) { end = i; break; }
+  }
+  if (end === -1) return { data: {}, body: text };
+
+  const data = {};
+  let currentListKey = null;
+  for (let i = 1; i < end; i++) {
+    const raw = lines[i];
+    if (!raw.trim() || raw.trim().startsWith('#')) continue;
+
+    const listItem = raw.match(/^\s+-\s+(.*)$/);
+    if (listItem && currentListKey) {
+      data[currentListKey].push(coerce(listItem[1].trim()));
+      continue;
+    }
+
+    const kv = raw.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!kv) continue;
+    const [, key, rawValue] = kv;
+    if (key === '__proto__' || key === 'constructor' || key === 'prototype') continue;
+    const value = rawValue.trim();
+    if (value === '') {
+      data[key] = [];
+      currentListKey = key;
+    } else {
+      data[key] = coerce(value);
+      currentListKey = null;
+    }
+  }
+
+  return { data, body: lines.slice(end + 1).join('\n') };
+}
+
+function coerce(value) {
+  if (value.startsWith('[') && value.endsWith(']')) {
+    const inner = value.slice(1, -1).trim();
+    if (!inner) return [];
+    return inner.split(',').map((v) => coerce(v.trim()));
+  }
+  const unquoted = value.replace(/^["']|["']$/g, '');
+  if (unquoted !== value) return unquoted;
+  if (value === 'true') return true;
+  if (value === 'false') return false;
+  if (/^-?\d+(\.\d+)?$/.test(value)) return Number(value);
+  return value;
+}

package/lib/glob.mjs

@@ -1,29 +1,29 @@
-// Tiny glob matcher for steering pathMatch patterns. Supports the subset we
-// document: `**` (any depth), `*` (within a segment), literal text.
-// Paths are compared as POSIX, relative to the project root.
-
-export function globToRegExp(glob) {
-  let re = '';
-  for (let i = 0; i < glob.length; i++) {
-    const c = glob[i];
-    if (c === '*') {
-      if (glob[i + 1] === '*') {
-        // `**/` or trailing `**` — match any depth including nothing
-        if (glob[i + 2] === '/') { re += '(?:[^/]+/)*'; i += 2; }
-        else { re += '.*'; i += 1; }
-      } else {
-        re += '[^/]*';
-      }
-    } else if ('.+^$()[]{}|\\?'.includes(c)) {
-      re += '\\' + c;
-    } else {
-      re += c;
-    }
-  }
-  return new RegExp(`^${re}$`);
-}
-
-export function matchGlob(relPosixPath, patterns) {
-  const list = Array.isArray(patterns) ? patterns : [patterns];
-  return list.some((p) => globToRegExp(String(p)).test(relPosixPath));
-}
+// Tiny glob matcher for steering pathMatch patterns. Supports the subset we
+// document: `**` (any depth), `*` (within a segment), literal text.
+// Paths are compared as POSIX, relative to the project root.
+
+export function globToRegExp(glob) {
+  let re = '';
+  for (let i = 0; i < glob.length; i++) {
+    const c = glob[i];
+    if (c === '*') {
+      if (glob[i + 1] === '*') {
+        // `**/` or trailing `**` — match any depth including nothing
+        if (glob[i + 2] === '/') { re += '(?:[^/]+/)*'; i += 2; }
+        else { re += '.*'; i += 1; }
+      } else {
+        re += '[^/]*';
+      }
+    } else if ('.+^$()[]{}|\\?'.includes(c)) {
+      re += '\\' + c;
+    } else {
+      re += c;
+    }
+  }
+  return new RegExp(`^${re}$`);
+}
+
+export function matchGlob(relPosixPath, patterns) {
+  const list = Array.isArray(patterns) ? patterns : [patterns];
+  return list.some((p) => globToRegExp(String(p)).test(relPosixPath));
+}