sdd-agent-platform 0.4.2 → 0.5.0

package/node_modules/@sdd-agent-platform/core/src/sdd-docs/document-hashes.ts

@@ -1,306 +1,207 @@
-import { createHash } from 'node:crypto';
-
-const TASK_CONTRACT_METADATA_KEYS = [
-  'id',
-  'wave',
-  'depends_on',
-  'acceptance_refs',
-  'plan_refs',
-  'affected_files',
-  'change_surface',
-  'implementation_wave',
-  'validation_batch',
-  'validation_timing',
-  'requires_verify_before_next',
-  'validation',
-  'risk',
-  'required_artifacts',
-  'allowed_agents',
-  'verification_availability',
-  'autonomy',
-  'validation_wave',
-  'review_gate'
-];
-
-const TASK_CONTRACT_SECTION_TITLES = [
-  'Boundary',
-  'Acceptance',
-  'Definition of Done',
-  'Evidence Expectations'
-];
-
-const TOP_LEVEL_CONTRACT_SECTION_TITLES = [
-  'Delivery Map',
-  'Wave Plan',
-  'Implementation Waves',
-  'Validation Waves',
-  'Review Gate',
-  'Review Gates',
-  'Review Gate Declarations',
-  'Phase Gate Checkpoint'
-];
-
-const RUNTIME_METADATA_KEYS = new Set([
-  'accepted_status',
-  'close_status',
-  'created_at',
-  'decision_id',
-  'generated_at',
-  'generatedat',
-  'reviewhash',
-  'run_id',
-  'runtime_decision_id',
-  'targethash',
-  'updated_at'
-]);
-
-export function hashDocumentContent(raw: string): string {
-  return sha256(normalizeLineEndings(raw));
-}
-
-export function hashNormalizedMarkdownContent(raw: string | null): string | null {
-  return raw === null ? null : sha256(normalizeMarkdownContentV1(raw));
-}
-
-export function normalizeMarkdownContentV1(raw: string): string {
-  const withoutBom = raw.charCodeAt(0) === 0xFEFF ? raw.slice(1) : raw;
-  let lines = normalizeLineEndings(withoutBom).split('\n');
-  if (lines[0]?.trim() === '---') {
-    const frontmatterEnd = lines.findIndex((line, index) => index > 0 && line.trim() === '---');
-    if (frontmatterEnd > 0) {
-      const frontmatter = lines.slice(1, frontmatterEnd).filter((line) => !isRuntimeMetadataLine(line));
-      lines = [...(frontmatter.some((line) => line.trim()) ? ['---', ...frontmatter, '---'] : []), ...lines.slice(frontmatterEnd + 1)];
-    }
-  }
-
-  const normalized: string[] = [];
-  let fence: { character: '`' | '~'; length: number } | null = null;
-  let previousBlank = false;
-
-  for (const line of lines) {
-    if (fence) {
-      normalized.push(line);
-      if (isClosingFence(line, fence)) {
-        fence = null;
-      }
-      previousBlank = false;
-      continue;
-    }
-
-    const openingFence = parseOpeningFence(line);
-    if (openingFence) {
-      normalized.push(line);
-      fence = openingFence;
-      previousBlank = false;
-      continue;
-    }
-
-    const withoutTrailingWhitespace = line.replace(/[ \t]+$/g, '');
-    if (isStandaloneHtmlComment(withoutTrailingWhitespace) || isRuntimeMetadataLine(withoutTrailingWhitespace)) {
-      continue;
-    }
-    if (withoutTrailingWhitespace.trim() === '') {
-      if (!previousBlank) {
-        normalized.push('');
-        previousBlank = true;
-      }
-      continue;
-    }
-    normalized.push(withoutTrailingWhitespace);
-    previousBlank = false;
-  }
-
-  while (normalized.length > 0 && normalized[0] === '') {
-    normalized.shift();
-  }
-  while (normalized.length > 0 && normalized[normalized.length - 1] === '') {
-    normalized.pop();
-  }
-  return normalized.length > 0 ? `${normalized.join('\n')}\n` : '';
-}
-
-export function hashSemanticDocument(raw: string | null): string | null {
-  return hashNormalizedMarkdownContent(raw);
-}
-
-export function hashTasksContract(raw: string | null): string | null {
-  if (raw === null) {
-    return null;
-  }
-  return sha256(stableJson({
-    tasks: parseTaskContracts(raw),
-    declarations: TOP_LEVEL_CONTRACT_SECTION_TITLES.map((title) => [title, normalizeSectionText(sectionText(raw, title))]).filter(([, value]) => value !== null)
-  }));
-}
-
-export function documentHashMatches(expected: string, actual: string): boolean {
-  return expected.replace(/^sha256:/, '') === actual;
-}
-
-function parseTaskContracts(raw: string): unknown[] {
-  const fencedBlocks = Array.from(raw.matchAll(/^\s*```sdd-task\s*\r?\n([\s\S]*?)\r?^\s*```\s*$/gm));
-  return fencedBlocks.map((blockMatch, index) => {
-    const block = blockMatch[1] ?? '';
-    const blockStart = blockMatch.index ?? 0;
-    const blockEnd = blockStart + blockMatch[0].length;
-    const nextBlockStart = fencedBlocks[index + 1]?.index ?? raw.length;
-    const section = raw.slice(blockEnd, nextTaskStart(raw, blockEnd, nextBlockStart));
-    const metadata = parseSimpleYamlBlock(block);
-    const heading = nearestTaskHeading(raw.slice(0, blockStart));
-    const id = scalarValue(metadata.id) ?? heading?.id ?? null;
-    return {
-      id,
-      title: heading?.title ?? null,
-      metadata: Object.fromEntries(TASK_CONTRACT_METADATA_KEYS.map((key) => [key, normalizedMetadataValue(metadata[key])])),
-      sections: Object.fromEntries(TASK_CONTRACT_SECTION_TITLES.map((title) => [title, normalizeSectionText(sectionText(section, title))]))
-    };
-  }).sort((left, right) => String((left as { id: string | null }).id ?? '').localeCompare(String((right as { id: string | null }).id ?? '')));
-}
-
-function normalizeLineEndings(raw: string): string {
-  return raw.replace(/\r\n?/g, '\n');
-}
-
-function parseOpeningFence(line: string): { character: '`' | '~'; length: number } | null {
-  const match = line.match(/^\s*(`{3,}|~{3,})/);
-  if (!match) {
-    return null;
-  }
-  const marker = match[1];
-  return { character: marker[0] as '`' | '~', length: marker.length };
-}
-
-function isClosingFence(line: string, fence: { character: '`' | '~'; length: number }): boolean {
-  const escaped = fence.character === '`' ? '`' : '~';
-  const match = line.match(new RegExp(`^\\s*(${escaped}{${fence.length},})\\s*$`));
-  return Boolean(match);
-}
-
-function isStandaloneHtmlComment(line: string): boolean {
-  return /^\s*<!--[\s\S]*?-->\s*$/.test(line);
-}
-
-function isRuntimeMetadataLine(line: string): boolean {
-  const match = line.match(/^\s*(?:-\s*)?([A-Za-z0-9_]+):\s*/);
-  if (!match) {
-    return false;
-  }
-  const key = match[1];
-  const normalizedKey = key.toLowerCase();
-  return /^based_on_.*_hash$/.test(normalizedKey)
-    || RUNTIME_METADATA_KEYS.has(normalizedKey);
-}
-
-function normalizeSectionText(value: string | null): string | null {
-  if (!value) {
-    return null;
-  }
-  return value.replace(/\r\n/g, '\n').split('\n').map((line) => line.trim()).filter((line) => line && !/^<!--.*-->$/.test(line)).join('\n');
-}
-
-function sectionText(raw: string, title: string): string | null {
-  const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  const sectionPattern = `^\\s*#{2,4}\\s+${escaped}\\s*$([\\s\\S]*?)(?=^\\s*#{2,4}\\s+|$(?![\\s\\S]))`;
-  const match = raw.match(new RegExp(sectionPattern, 'im'));
-  const text = match?.[1]?.trim() ?? '';
-  return text.length > 0 ? text : null;
-}
-
-function parseSimpleYamlBlock(raw: string): Record<string, string | string[]> {
-  const result: Record<string, string | string[]> = {};
-  const lines = raw.split(/\r?\n/);
-  let currentListKey: string | null = null;
-
-  for (const line of lines) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) {
-      continue;
-    }
-    if (currentListKey && /^-\s+/.test(trimmed)) {
-      const current = result[currentListKey];
-      const items = Array.isArray(current) ? current : [];
-      items.push(unquoteSimpleYamlValue(trimmed.slice(2).trim()));
-      result[currentListKey] = items;
-      continue;
-    }
-
-    const scalarMatch = trimmed.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (!scalarMatch) {
-      currentListKey = null;
-      continue;
-    }
-    const key = scalarMatch[1];
-    const value = scalarMatch[2].trim();
-    if (value === '') {
-      result[key] = [];
-      currentListKey = key;
-    } else if (value === '[]') {
-      result[key] = [];
-      currentListKey = null;
-    } else if (value.startsWith('[') && value.endsWith(']')) {
-      result[key] = value.slice(1, -1).split(',').map((item) => unquoteSimpleYamlValue(item.trim())).filter(Boolean);
-      currentListKey = null;
-    } else {
-      result[key] = unquoteSimpleYamlValue(value);
-      currentListKey = null;
-    }
-  }
-
-  return result;
-}
-
-function normalizedMetadataValue(value: string | string[] | undefined): string | string[] | null {
-  if (Array.isArray(value)) {
-    return [...value].filter(Boolean).sort();
-  }
-  return value && value !== '[]' ? value : null;
-}
-
-function scalarValue(value: string | string[] | undefined): string | null {
-  return typeof value === 'string' && value.length > 0 ? value : null;
-}
-
-function unquoteSimpleYamlValue(value: string): string {
-  if (value.length >= 2) {
-    const first = value[0];
-    const last = value[value.length - 1];
-    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
-      return value.slice(1, -1);
-    }
-  }
-  return value;
-}
-
-function nearestTaskHeading(prefix: string): { raw: string; id: string | null; title: string | null } | null {
-  const matches = Array.from(prefix.matchAll(/^\s*###\s+(.+)$/gm));
-  const last = matches.at(-1);
-  if (!last) {
-    return null;
-  }
-  const raw = last[1].trim();
-  const parsed = raw.match(/^([^:：\s]+)\s*[:：]\s*(.+)$/);
-  return {
-    raw,
-    id: parsed?.[1]?.trim() ?? null,
-    title: parsed?.[2]?.trim() ?? raw
-  };
-}
-
-function nextTaskStart(raw: string, offset: number, limit = raw.length): number {
-  const next = raw.slice(offset, limit).search(/^\s*###\s+/m);
-  return next < 0 ? limit : offset + next;
-}
-
-function stableJson(value: unknown): string {
-  if (Array.isArray(value)) {
-    return `[${value.map(stableJson).join(',')}]`;
-  }
-  if (value && typeof value === 'object') {
-    return `{${Object.entries(value as Record<string, unknown>).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`).join(',')}}`;
-  }
-  return JSON.stringify(value);
-}
-
-function sha256(value: string): string {
-  return createHash('sha256').update(value, 'utf8').digest('hex');
-}
+import { createHash } from 'node:crypto';
+
+const TASK_CONTRACT_METADATA_KEYS = [
+  'id',
+  'wave',
+  'depends_on',
+  'acceptance_refs',
+  'plan_refs',
+  'affected_files',
+  'change_surface',
+  'implementation_wave',
+  'validation_batch',
+  'validation_timing',
+  'requires_verify_before_next',
+  'validation',
+  'risk',
+  'required_artifacts',
+  'allowed_agents',
+  'verification_availability',
+  'autonomy',
+  'validation_wave',
+  'review_gate'
+];
+
+const TASK_CONTRACT_SECTION_TITLES = [
+  'Boundary',
+  'Acceptance',
+  'Definition of Done',
+  'Evidence Expectations'
+];
+
+const TOP_LEVEL_CONTRACT_SECTION_TITLES = [
+  'Delivery Map',
+  'Wave Plan',
+  'Implementation Waves',
+  'Validation Waves',
+  'Review Gate',
+  'Review Gates',
+  'Review Gate Declarations',
+  'Phase Gate Checkpoint'
+];
+
+export function hashDocumentContent(raw: string): string {
+  return sha256(raw.replace(/\r\n/g, '\n'));
+}
+
+export function hashSemanticDocument(raw: string | null): string | null {
+  return raw === null ? null : sha256(normalizeSemanticMarkdown(raw));
+}
+
+export function hashTasksContract(raw: string | null): string | null {
+  if (raw === null) {
+    return null;
+  }
+  return sha256(stableJson({
+    tasks: parseTaskContracts(raw),
+    declarations: TOP_LEVEL_CONTRACT_SECTION_TITLES.map((title) => [title, normalizeSectionText(sectionText(raw, title))]).filter(([, value]) => value !== null)
+  }));
+}
+
+export function documentHashMatches(expected: string, actual: string): boolean {
+  return expected.replace(/^sha256:/, '') === actual;
+}
+
+function parseTaskContracts(raw: string): unknown[] {
+  const fencedBlocks = Array.from(raw.matchAll(/^\s*```sdd-task\s*\r?\n([\s\S]*?)\r?^\s*```\s*$/gm));
+  return fencedBlocks.map((blockMatch, index) => {
+    const block = blockMatch[1] ?? '';
+    const blockStart = blockMatch.index ?? 0;
+    const blockEnd = blockStart + blockMatch[0].length;
+    const nextBlockStart = fencedBlocks[index + 1]?.index ?? raw.length;
+    const section = raw.slice(blockEnd, nextTaskStart(raw, blockEnd, nextBlockStart));
+    const metadata = parseSimpleYamlBlock(block);
+    const heading = nearestTaskHeading(raw.slice(0, blockStart));
+    const id = scalarValue(metadata.id) ?? heading?.id ?? null;
+    return {
+      id,
+      title: heading?.title ?? null,
+      metadata: Object.fromEntries(TASK_CONTRACT_METADATA_KEYS.map((key) => [key, normalizedMetadataValue(metadata[key])])),
+      sections: Object.fromEntries(TASK_CONTRACT_SECTION_TITLES.map((title) => [title, normalizeSectionText(sectionText(section, title))]))
+    };
+  }).sort((left, right) => String((left as { id: string | null }).id ?? '').localeCompare(String((right as { id: string | null }).id ?? '')));
+}
+
+function normalizeSemanticMarkdown(raw: string): string {
+  return raw
+    .replace(/\r\n/g, '\n')
+    .split('\n')
+    .filter((line) => !/^\s*(created_at|updated_at|generatedAt|generated_at|run_id):/i.test(line))
+    .map((line) => line.trim())
+    .filter(Boolean)
+    .join('\n');
+}
+
+function normalizeSectionText(value: string | null): string | null {
+  if (!value) {
+    return null;
+  }
+  return value.replace(/\r\n/g, '\n').split('\n').map((line) => line.trim()).filter((line) => line && !/^<!--.*-->$/.test(line)).join('\n');
+}
+
+function sectionText(raw: string, title: string): string | null {
+  const escaped = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const sectionPattern = `^\\s*#{2,4}\\s+${escaped}\\s*$([\\s\\S]*?)(?=^\\s*#{2,4}\\s+|$(?![\\s\\S]))`;
+  const match = raw.match(new RegExp(sectionPattern, 'im'));
+  const text = match?.[1]?.trim() ?? '';
+  return text.length > 0 ? text : null;
+}
+
+function parseSimpleYamlBlock(raw: string): Record<string, string | string[]> {
+  const result: Record<string, string | string[]> = {};
+  const lines = raw.split(/\r?\n/);
+  let currentListKey: string | null = null;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) {
+      continue;
+    }
+    if (currentListKey && /^-\s+/.test(trimmed)) {
+      const current = result[currentListKey];
+      const items = Array.isArray(current) ? current : [];
+      items.push(unquoteSimpleYamlValue(trimmed.slice(2).trim()));
+      result[currentListKey] = items;
+      continue;
+    }
+
+    const scalarMatch = trimmed.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+    if (!scalarMatch) {
+      currentListKey = null;
+      continue;
+    }
+    const key = scalarMatch[1];
+    const value = scalarMatch[2].trim();
+    if (value === '') {
+      result[key] = [];
+      currentListKey = key;
+    } else if (value === '[]') {
+      result[key] = [];
+      currentListKey = null;
+    } else if (value.startsWith('[') && value.endsWith(']')) {
+      result[key] = value.slice(1, -1).split(',').map((item) => unquoteSimpleYamlValue(item.trim())).filter(Boolean);
+      currentListKey = null;
+    } else {
+      result[key] = unquoteSimpleYamlValue(value);
+      currentListKey = null;
+    }
+  }
+
+  return result;
+}
+
+function normalizedMetadataValue(value: string | string[] | undefined): string | string[] | null {
+  if (Array.isArray(value)) {
+    return [...value].filter(Boolean).sort();
+  }
+  return value && value !== '[]' ? value : null;
+}
+
+function scalarValue(value: string | string[] | undefined): string | null {
+  return typeof value === 'string' && value.length > 0 ? value : null;
+}
+
+function unquoteSimpleYamlValue(value: string): string {
+  if (value.length >= 2) {
+    const first = value[0];
+    const last = value[value.length - 1];
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+      return value.slice(1, -1);
+    }
+  }
+  return value;
+}
+
+function nearestTaskHeading(prefix: string): { raw: string; id: string | null; title: string | null } | null {
+  const matches = Array.from(prefix.matchAll(/^\s*###\s+(.+)$/gm));
+  const last = matches.at(-1);
+  if (!last) {
+    return null;
+  }
+  const raw = last[1].trim();
+  const parsed = raw.match(/^([^:：\s]+)\s*[:：]\s*(.+)$/);
+  return {
+    raw,
+    id: parsed?.[1]?.trim() ?? null,
+    title: parsed?.[2]?.trim() ?? raw
+  };
+}
+
+function nextTaskStart(raw: string, offset: number, limit = raw.length): number {
+  const next = raw.slice(offset, limit).search(/^\s*###\s+/m);
+  return next < 0 ? limit : offset + next;
+}
+
+function stableJson(value: unknown): string {
+  if (Array.isArray(value)) {
+    return `[${value.map(stableJson).join(',')}]`;
+  }
+  if (value && typeof value === 'object') {
+    return `{${Object.entries(value as Record<string, unknown>).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => `${JSON.stringify(key)}:${stableJson(item)}`).join(',')}}`;
+  }
+  return JSON.stringify(value);
+}
+
+function sha256(value: string): string {
+  return createHash('sha256').update(value, 'utf8').digest('hex');
+}