cleargate 0.14.0 → 0.15.0

package/dist/templates/cleargate-planning/.cleargate/scripts/collision_surface.sh

@@ -1,114 +0,0 @@
-#!/usr/bin/env bash
-# collision_surface.sh — STORY-033-03 (EPIC-033)
-#
-# Standalone fork of parse_surface_paths() from file_surface_diff.sh:158-189.
-# FIXES the single-column bug: the original reads only cols[2]; this fork scans
-# ALL columns to detect file paths regardless of which column they appear in.
-#
-# Usage: collision_surface.sh <story-file>
-#   Emits one file path per line, deduped, backticks stripped, comma-split cells split.
-#   Exit 0 always.
-#
-# FAIL-SAFE CONTRACT (BUG-033): when ZERO paths are parseable from the §3.1 table
-#   (no table, prose-only table, or only slash-free/extension-less tokens), this
-#   script emits EMPTY stdout AND a `[collision_surface] WARN:` line on STDERR.
-#   The wave-compatibility predicate (architect-synth) MUST treat an empty surface
-#   as "cannot prove disjointness" → fail-safe-serialize, NEVER as
-#   "empty ∩ empty = ∅ ⇒ disjoint". Empty stdout is a SERIALIZE signal, not a
-#   parallelize signal. Over-serialization is the safe failure direction.
-#
-# Used by architect-synth to compute the five-clause wave-compatibility predicate.
-# Do NOT modify file_surface_diff.sh — this is a deliberate standalone fork.
-
-set -euo pipefail
-
-STORY_FILE="${1:-}"
-
-if [[ -z "${STORY_FILE}" ]]; then
-  echo "[collision_surface] ERROR: No story file argument provided." >&2
-  echo "[collision_surface] Usage: $0 <story-file>" >&2
-  exit 1
-fi
-
-if [[ ! -f "${STORY_FILE}" ]]; then
-  echo "[collision_surface] ERROR: Story file not found: ${STORY_FILE}" >&2
-  exit 1
-fi
-
-# ---- Parse §3.1 file surface table (multi-column fix) -----------------------
-#
-# CHANGE vs file_surface_diff.sh:158-189:
-#   Original: val=cols[2]  — reads only the second column (the "Value" column).
-#   Fork:     iterate cols[1..n] — checks every column for path-like tokens.
-#
-# Non-path skip list (tightened to avoid false matches with col-1 labels):
-#   "Yes", "No", "Yes/No", "N/A", and any prefix of "Yes/No —"
-#
-# Path-shape guard (looks_like_path): a token is a path IFF it contains "/" OR ends
-# in a known file extension. This catches both slash-bearing paths (a/b.ts) AND
-# bare filenames the prior slash-only guard missed (package.json, schema.sql), while
-# still rejecting label cells like "Primary File (new)" or prose like "Some details.".
-# BUG-033: the guard now matches the documented contract — the prior code was
-# slash-only despite the comment claiming "/ OR known extension".
-#
-# Over-serialization is the safe failure direction — a token we cannot classify as a
-# path is dropped, so the story trends toward an empty surface → fail-safe-serialize.
-
-parse_surface_paths() {
-  local story_file="$1"
-  awk '
-    # A token is a path IFF it contains "/" OR ends in a known file extension.
-    function looks_like_path(s) {
-      return (s ~ /\//) || \
-             (s ~ /\.(ts|tsx|cts|mts|js|jsx|cjs|mjs|json|jsonc|sh|bash|md|sql|svelte|vue|css|scss|sass|less|ya?ml|toml|ini|env|txt|prisma|html|htm|py|rs|go|rb|java|kt)$/)
-    }
-    /^### 3\.1/ { in_section=1; next }
-    in_section && /^### / { in_section=0; next }
-    in_section && /^\|/ {
-      line=$0
-      gsub(/^\||\|$/, "", line)
-      n=split(line, cols, "|")
-      # Scan ALL columns (fix: was only cols[2])
-      for (c=1; c<=n; c++) {
-        val=cols[c]
-        # Trim whitespace
-        gsub(/^[[:space:]]+|[[:space:]]+$/, "", val)
-        # Strip backticks
-        gsub(/`/, "", val)
-        # Skip known non-path cells (exact and prefix matches)
-        if (val == "Yes") continue
-        if (val == "No") continue
-        if (val == "Yes/No") continue
-        if (val == "N/A") continue
-        if (val == "Item") continue
-        if (val == "Value") continue
-        if (val == "") continue
-        # Skip cells starting with "Yes/No —" (partial answers)
-        if (substr(val, 1, 8) == "Yes/No -") continue
-        # Handle multiple paths separated by ", "; guard each split token.
-        npaths=split(val, paths, ", ")
-        for (i=1; i<=npaths; i++) {
-          p=paths[i]
-          gsub(/^[[:space:]]+|[[:space:]]+$/, "", p)
-          if (p != "" && looks_like_path(p)) print p
-        }
-      }
-    }
-  ' "${story_file}"
-}
-
-# Collect paths and deduplicate (portable bash 3.2 compat — no mapfile, no declare -A on macOS)
-# FLASHCARD #bash #macos: no mapfile on macOS bash 3.2 — use while-read loop
-# FLASHCARD #bash #macos: no associative arrays (declare -A) on macOS bash 3.2 — use awk for dedup
-SURFACE="$(parse_surface_paths "${STORY_FILE}" | awk '!seen[$0]++')"
-
-if [[ -z "${SURFACE}" ]]; then
-  # BUG-033 fail-safe signal. ZERO parseable paths = the disjointness predicate CANNOT
-  # prove this story is collision-free, so it must NOT be co-waved. stdout stays empty
-  # (the caller reads "no proven surface"); the predicate fail-safe-serializes on empty.
-  echo "[collision_surface] WARN: no parseable file surface in ${STORY_FILE} — downstream MUST fail-safe-serialize (empty surface is NOT 'disjoint')." >&2
-  exit 0
-fi
-
-printf '%s\n' "${SURFACE}"
-exit 0

package/dist/templates/cleargate-planning/.cleargate/scripts/constants.mjs

@@ -1,62 +0,0 @@
-/**
- * ClearGate Execution Phase — Constants
- *
- * state.json v3 Schema (STORY-070-01: execution_mode retired — single always-enforced behavior):
- *
- * {
- *   "schema_version": 3,          // integer, mandatory
- *   "sprint_id": "S-NN",          // string
- *   "sprint_status": "Active",    // string
- *   "stories": {
- *     "STORY-NNN-NN": {
- *       "state": "Ready to Bounce",  // one of VALID_STATES
- *       "qa_bounces": 0,             // integer 0..BOUNCE_CAP
- *       "arch_bounces": 0,           // integer 0..BOUNCE_CAP
- *       "worktree": null,            // string|null — path to worktree checkout
- *       "updated_at": "<ISO-8601>",  // string
- *       "notes": "",                 // string
- *       "lane": "standard",          // default "standard"
- *       "lane_assigned_by": "architect" | "human-override" | "migration-default",
- *       "lane_demoted_at": "<ISO-8601>" | null,
- *       "lane_demotion_reason": string | null
- *     }
- *   },
- *   "last_action": "<string>",    // human-readable last operation
- *   "updated_at": "<ISO-8601>"    // string
- * }
- *
- * Break-glass env var: CLEARGATE_ADVISORY=1 downgrades gate failures to warnings.
- */
-
-export const SCHEMA_VERSION = 3;
-
-export const BOUNCE_CAP = 3;
-
-export const VALID_STATES = [
-  'Ready to Bounce',
-  'Bouncing',
-  'QA Passed',
-  'Architect Passed',
-  'Sprint Review',
-  'Done',
-  'Escalated',
-  'Parking Lot',
-];
-
-export const TERMINAL_STATES = ['Done', 'Escalated', 'Parking Lot'];
-
-/**
- * Canonical state-machine transitions table.
- * Key: current state. Value: array of allowed next states.
- * Terminal states have empty arrays (no transitions out).
- */
-export const STATE_TRANSITIONS = {
-  'Ready to Bounce':   ['Bouncing', 'Parking Lot'],
-  'Bouncing':          ['QA Passed', 'Ready to Bounce', 'Escalated', 'Parking Lot'],
-  'QA Passed':         ['Architect Passed', 'Ready to Bounce', 'Escalated', 'Parking Lot'],
-  'Architect Passed':  ['Sprint Review', 'Ready to Bounce', 'Escalated', 'Parking Lot'],
-  'Sprint Review':     ['Done', 'Ready to Bounce', 'Escalated', 'Parking Lot'],
-  'Done':              [],
-  'Escalated':         [],
-  'Parking Lot':       [],
-};

package/dist/templates/cleargate-planning/.cleargate/scripts/dedupe_frontmatter.mjs

@@ -1,219 +0,0 @@
-#!/usr/bin/env node
-/**
- * dedupe_frontmatter.mjs — BUG-025
- *
- * One-shot corpus dedupe pass: scan every .md file under
- * .cleargate/delivery/pending-sync/ and .cleargate/delivery/archive/.
- * For any file whose YAML frontmatter contains duplicate top-level keys,
- * keep the LAST occurrence of each key (closest to the body — this is what
- * the stamp hook writes most recently) and rewrite the file.
- *
- * Idempotent: re-running produces zero diff when no duplicates remain.
- *
- * Usage:
- *   node .cleargate/scripts/dedupe_frontmatter.mjs [--dry-run] [<dir>]
- *
- *   --dry-run   Print which files would be rewritten without writing.
- *   <dir>       Walk only this directory instead of the canonical corpus dirs.
- *               Used by integration tests targeting a tmpdir.
- */
-
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import * as url from 'node:url';
-
-const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
-const REPO_ROOT = path.resolve(__dirname, '..', '..');
-
-const args = process.argv.slice(2);
-const DRY_RUN = args.includes('--dry-run');
-const DIR_ARG = args.find((a) => !a.startsWith('--'));
-
-const PENDING_SYNC = path.join(REPO_ROOT, '.cleargate', 'delivery', 'pending-sync');
-const ARCHIVE = path.join(REPO_ROOT, '.cleargate', 'delivery', 'archive');
-
-/**
- * Collect all .md files in a flat directory (non-recursive — delivery dirs are flat).
- */
-function collectMd(dir) {
-  let entries;
-  try {
-    entries = fs.readdirSync(dir, { withFileTypes: true });
-  } catch {
-    return [];
-  }
-  return entries
-    .filter((e) => e.isFile() && e.name.endsWith('.md'))
-    .map((e) => path.join(dir, e.name));
-}
-
-/**
- * Parse a raw markdown string into:
- *   fmLines  — the lines between the opening and closing `---` delimiters
- *   closeIdx — index of the closing `---` line (in the full `lines` array)
- *   lines    — all lines of the file
- *
- * Returns null if the file has no valid frontmatter.
- */
-function parseFmLines(raw) {
-  const lines = raw.split('\n');
-  if (lines[0] !== '---') return null;
-  let closeIdx = -1;
-  for (let i = 1; i < lines.length; i++) {
-    if (lines[i] === '---') {
-      closeIdx = i;
-      break;
-    }
-  }
-  if (closeIdx === -1) return null;
-  return { lines, closeIdx, fmLines: lines.slice(1, closeIdx) };
-}
-
-/**
- * Given the frontmatter lines, detect duplicate top-level keys.
- * Returns a Map from key → array of line-indices (within fmLines) where it appears.
- * Only entries with ≥2 occurrences indicate duplicates.
- *
- * A "top-level key" is a line that starts with a non-space character followed by
- * `:<space>` or `:<end-of-line>`. Multi-line values (YAML scalars, blocks) that
- * contain `:` on continuation lines are NOT top-level keys (they start with space/tab).
- */
-function findDuplicateKeys(fmLines) {
-  /** @type {Map<string, number[]>} */
-  const keyMap = new Map();
-  for (let i = 0; i < fmLines.length; i++) {
-    const line = fmLines[i];
-    // Top-level key: starts at column 0, has `:` after a word character sequence
-    const m = line.match(/^([A-Za-z_][A-Za-z0-9_]*):/);
-    if (m) {
-      const key = m[1];
-      if (!keyMap.has(key)) {
-        keyMap.set(key, []);
-      }
-      keyMap.get(key).push(i);
-    }
-  }
-  // Return only keys with duplicates
-  /** @type {Map<string, number[]>} */
-  const dupes = new Map();
-  for (const [k, indices] of keyMap) {
-    if (indices.length > 1) {
-      dupes.set(k, indices);
-    }
-  }
-  return dupes;
-}
-
-/**
- * Deduplicate frontmatter lines: for each duplicate key, keep the LAST occurrence
- * and discard all earlier ones (including their potential multi-line values).
- *
- * Multi-line value detection: lines that follow a key line and start with
- * whitespace (` ` or `\t`) belong to the preceding key's value.
- *
- * Returns the deduplicated fmLines array (may be the same reference if no changes).
- */
-function dedupeLines(fmLines, dupes) {
-  if (dupes.size === 0) return fmLines;
-
-  // Build a set of fmLine indices to DROP (all but the last occurrence of each dup key,
-  // including their continuation lines).
-  /** @type {Set<number>} */
-  const dropSet = new Set();
-
-  for (const [, indices] of dupes) {
-    // Keep last occurrence; drop all earlier ones (+ their continuations)
-    const toRemove = indices.slice(0, -1); // all but last
-    for (const startIdx of toRemove) {
-      dropSet.add(startIdx);
-      // Mark continuation lines (indent-starting lines following a key line)
-      let j = startIdx + 1;
-      while (j < fmLines.length && /^[ \t]/.test(fmLines[j])) {
-        dropSet.add(j);
-        j++;
-      }
-    }
-  }
-
-  return fmLines.filter((_, i) => !dropSet.has(i));
-}
-
-/**
- * Atomic write: write to a .tmp file then rename over the target.
- */
-function writeAtomic(filePath, content) {
-  const tmpPath = `${filePath}.tmp.${Date.now()}`;
-  fs.writeFileSync(tmpPath, content, 'utf8');
-  fs.renameSync(tmpPath, filePath);
-}
-
-// ── Main ──────────────────────────────────────────────────────────────────────
-
-const files = DIR_ARG
-  ? collectMd(path.resolve(DIR_ARG))
-  : [...collectMd(PENDING_SYNC), ...collectMd(ARCHIVE)];
-
-let rewritten = 0;
-let skipped = 0;
-let errors = 0;
-
-for (const filePath of files) {
-  let raw;
-  try {
-    raw = fs.readFileSync(filePath, 'utf8');
-  } catch (e) {
-    console.error(`error reading ${filePath}: ${e.message}`);
-    errors++;
-    continue;
-  }
-
-  const parsed = parseFmLines(raw);
-  if (!parsed) {
-    skipped++;
-    continue;
-  }
-
-  const { lines, closeIdx, fmLines } = parsed;
-  const dupes = findDuplicateKeys(fmLines);
-
-  if (dupes.size === 0) {
-    skipped++;
-    continue;
-  }
-
-  const relPath = path.relative(REPO_ROOT, filePath);
-  const dupeSummary = Array.from(dupes.keys()).join(', ');
-
-  if (DRY_RUN) {
-    console.log(`would-rewrite: ${relPath} (duplicate keys: ${dupeSummary})`);
-    rewritten++;
-    continue;
-  }
-
-  // Build the new file content: deduplicated frontmatter + rest unchanged
-  const cleanedFmLines = dedupeLines(fmLines, dupes);
-  const newLines = [
-    lines[0],            // opening ---
-    ...cleanedFmLines,
-    lines[closeIdx],     // closing ---
-    ...lines.slice(closeIdx + 1),
-  ];
-  const newContent = newLines.join('\n');
-
-  // Verify the result is actually different (guard against no-op edge cases)
-  if (newContent === raw) {
-    skipped++;
-    continue;
-  }
-
-  writeAtomic(filePath, newContent);
-  console.log(`rewritten: ${relPath} (removed duplicate keys: ${dupeSummary})`);
-  rewritten++;
-}
-
-console.log(
-  `\nDedupe complete: ${rewritten} ${DRY_RUN ? 'would-rewrite' : 'rewritten'}, ${skipped} skipped, ${errors} errors.`,
-);
-if (errors > 0) {
-  process.exit(1);
-}