cyber-sdd 0.7.0 → 0.7.2

package/skills/discover-plans/scripts/discover-plans.mts

@@ -1,215 +0,0 @@
-#!/usr/bin/env node
-// discover-plans — intake/plan-discovery's concrete frontmatter engine. Scans the SDD
-// plan directory (.agents/plans) for *.plan.md mission briefs, parses each plan's
-// frontmatter (name + the todos tally by status) plus the lead line of its `## NEXT`
-// resume anchor, and emits a TOON list of the unretired / resumable missions.
-//
-// Recognition is location-bounded AND shape-confirmed:
-//   - a file named `<cr-ref>.plan.md` sitting directly under <root>/.agents/plans/ is a
-//     mission brief. A present plan brief is by definition UNRETIRED — the doctrine loop's
-//     plan-retirement deletes a plan once its CR is done/merged AND distilled — so every
-//     plan the scan finds is a resumable mission.
-//   - shape: the file must carry a frontmatter block (the basic plan template intake
-//     scaffolds). A `*.plan.md` with no frontmatter is skipped (a stray, not a brief).
-// Sibling files in the same directory that are NOT `*.plan.md` (a combat log `*.log.jsonl`,
-// a loose `*.md`) are never plan briefs and are ignored.
-//
-// Pure functions are exported for node:test; running the file directly drives the CLI.
-// No dependencies (the repo's node-≥23.6 / no-deps convention). --format json for a flat
-// array; default output is TOON (the token-efficient tabular form the gateway scans).
-
-import { existsSync, readdirSync, readFileSync, realpathSync } from 'node:fs'
-import { join } from 'node:path'
-import { pathToFileURL } from 'node:url'
-
-export const TODO_STATUSES = new Set(['pending', 'in_progress', 'completed'])
-
-/** The default mission dispatch status — the meaning of an absent top-level `status`. */
-export const DEFAULT_PLAN_STATUS = 'active'
-
-export interface PlanRecord {
-	/** The CR ref — the plan's filename without the `.plan.md` suffix. */
-	cr: string
-	/** Frontmatter `name`, or '' when absent. */
-	name: string
-	/** Total todos in the brief. */
-	total: number
-	/** Todos with status `completed`. */
-	completed: number
-	/** Todos with status `in_progress`. */
-	inProgress: number
-	/** The mission dispatch flag — the top-level `status` (`active` when unset). */
-	status: string
-	/** The lead line of the `## NEXT` resume anchor, or '' when there is none. */
-	next: string
-}
-
-export interface PlanFrontmatter {
-	name: string
-	/** The mission dispatch flag — the top-level `status` (`active` when unset). */
-	status: string
-	total: number
-	completed: number
-	inProgress: number
-	pending: number
-}
-
-// ── Frontmatter parse (a minimal YAML subset — only the plan-brief schema) ──
-// Extracts the leading `---` … `---` block and reads `name` plus the `todos:` list's tally
-// by `status`. Returns null when there is no frontmatter block at all (a stray file).
-export function parsePlanFrontmatter(text: string): PlanFrontmatter | null {
-	const m = /^---\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/.exec(text)
-	if (!m) return null
-	const fm: PlanFrontmatter = {
-		name: '',
-		status: DEFAULT_PLAN_STATUS,
-		total: 0,
-		completed: 0,
-		inProgress: 0,
-		pending: 0,
-	}
-	let inTodos = false // currently inside the top-level `todos:` block
-	for (const raw of m[1].split('\n')) {
-		const line = raw.replace(/\r$/, '')
-		if (line.trim() === '' || line.trim().startsWith('#')) continue
-		const indent = line.length - line.trimStart().length
-		const trimmed = line.trim()
-		if (indent === 0) {
-			inTodos = false
-			const [key, ...rest] = trimmed.split(':')
-			const value = rest.join(':').trim()
-			if (key === 'name') fm.name = unquote(value)
-			// The top-level `status` is the plan's dispatch flag (distinct from a todo's
-			// `status`, which sits indented inside `todos:`). An empty value stays the default.
-			else if (key === 'status') {
-				const v = unquote(value)
-				if (v !== '') fm.status = v
-			} else if (key === 'todos') inTodos = true // value is empty; the list follows, indented
-			continue
-		}
-		// Inside the todos list — count each item's status. A list item's keys sit at
-		// indent ≥ 2 (`- id:` / `status:`); the status line is `status: <value>`.
-		if (inTodos) {
-			const sm = /^(?:-\s+)?status:\s*(.+)$/.exec(trimmed)
-			if (sm) {
-				const status = unquote(sm[1].trim())
-				fm.total++
-				if (status === 'completed') fm.completed++
-				else if (status === 'in_progress') fm.inProgress++
-				else if (status === 'pending') fm.pending++
-			}
-		}
-	}
-	return fm
-}
-
-function unquote(v: string): string {
-	return v.replace(/^["']|["']$/g, '')
-}
-
-// ── The `## NEXT` resume anchor lead ──
-// Find the `## NEXT` section (the resume anchor pause-mission writes) and return its first
-// content line — the next concrete action — trimmed of markdown bullet/emphasis markers and
-// capped. Returns '' when there is no NEXT section or it is empty. Body read is bounded to
-// this one section; the rest of the body is never parsed.
-export function nextLead(text: string): string {
-	const lines = text.split('\n')
-	let i = lines.findIndex((l) => /^##\s+NEXT\b/i.test(l.trim()))
-	if (i === -1) return ''
-	for (i += 1; i < lines.length; i++) {
-		const l = lines[i].replace(/\r$/, '').trim()
-		if (l === '') continue
-		if (l.startsWith('#')) return '' // hit the next heading with no content between
-		const cleaned = l
-			.replace(/^[-*]\s+/, '')
-			.replace(/\*\*/g, '')
-			.trim()
-		return cleaned.length > 200 ? `${cleaned.slice(0, 197)}...` : cleaned
-	}
-	return ''
-}
-
-// ── Scan ──
-// List the plan-brief filenames (relative names) directly under <root>/.agents/plans. Only
-// files ending `.plan.md` are briefs; a missing plans dir yields the empty set.
-function discoverPlanFiles(root: string): string[] {
-	const dir = join(root, '.agents', 'plans')
-	if (!existsSync(dir)) return []
-	let entries: import('node:fs').Dirent[]
-	try {
-		entries = readdirSync(dir, { withFileTypes: true })
-	} catch {
-		return []
-	}
-	return entries
-		.filter((e) => e.isFile() && e.name.endsWith('.plan.md'))
-		.map((e) => e.name)
-		.sort()
-}
-
-// ── Collect ──
-// The list of resumable missions: every plan brief carrying a frontmatter block, keyed by
-// its CR ref, with its todo tally and NEXT lead. Sorted by cr ref for stable output.
-export function collectPlans(root: string): PlanRecord[] {
-	const out: PlanRecord[] = []
-	for (const name of discoverPlanFiles(root)) {
-		let text: string
-		try {
-			text = readFileSync(join(root, '.agents', 'plans', name), 'utf8')
-		} catch {
-			continue
-		}
-		const fm = parsePlanFrontmatter(text)
-		if (!fm) continue // no frontmatter — a stray, not a brief
-		out.push({
-			cr: name.replace(/\.plan\.md$/, ''),
-			name: fm.name,
-			total: fm.total,
-			completed: fm.completed,
-			inProgress: fm.inProgress,
-			status: fm.status,
-			next: nextLead(text),
-		})
-	}
-	return out.sort((a, b) => (a.cr < b.cr ? -1 : a.cr > b.cr ? 1 : 0))
-}
-
-// ── Filter ──
-// Narrow a plan set to one dispatch status — the opt-in selector the gateway's dispatch loop
-// uses to build the approved queue. Records already carry a concrete `status` (unset → the
-// default `active`), so a filter to `active` includes the unset briefs and a value no brief
-// carries (an off-enum or simply-absent status) yields the empty set.
-export function filterByStatus(plans: PlanRecord[], status: string): PlanRecord[] {
-	return plans.filter((p) => p.status === status)
-}
-
-// ── Output ──
-const COLUMNS = ['cr', 'name', 'total', 'completed', 'inProgress', 'status', 'next'] as const
-
-// Quote a TOON field only when it carries the delimiter, a quote, or edge whitespace.
-function toonField(v: string): string {
-	if (v === '' || /[",]/.test(v) || v !== v.trim()) return `"${v.replace(/"/g, '""')}"`
-	return v
-}
-
-export function toToon(plans: PlanRecord[]): string {
-	const header = `plans[${plans.length}]{${COLUMNS.join(',')}}:`
-	const rows = plans.map((p) => `  ${COLUMNS.map((c) => toonField(String(p[c]))).join(',')}`)
-	return [header, ...rows].join('\n')
-}
-
-export function main(argv: string[]): number {
-	const root = argv.includes('--root') ? (argv[argv.indexOf('--root') + 1] ?? '.') : '.'
-	const format = argv.includes('--format') ? argv[argv.indexOf('--format') + 1] : 'toon'
-	const statusFilter = argv.includes('--status') ? argv[argv.indexOf('--status') + 1] : undefined
-	let plans = collectPlans(root)
-	// Opt-in: `--status <value>` narrows to the dispatch queue; absent, no status filter is applied.
-	if (statusFilter !== undefined) plans = filterByStatus(plans, statusFilter)
-	const out = format === 'json' ? JSON.stringify(plans, null, 2) : toToon(plans)
-	process.stdout.write(`${out}\n`)
-	return 0
-}
-
-if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
-	process.exit(main(process.argv.slice(2)))
-}

package/skills/discover-specs/scripts/discover-specs.bundle.mjs

@@ -1,319 +0,0 @@
-#!/usr/bin/env node
-import { existsSync, readFileSync, readdirSync, realpathSync } from "node:fs";
-import { join } from "node:path";
-import { pathToFileURL } from "node:url";
-//#region skills/discover-specs/scripts/discover-specs.mts
-const LIFECYCLE_STATUSES = /* @__PURE__ */ new Set([
-	"draft",
-	"approved",
-	"implemented",
-	"deprecated"
-]);
-const ROOT_PROJECT_NAME = "repo";
-const SKIP_DIRS = /* @__PURE__ */ new Set([
-	"node_modules",
-	".git",
-	"dist",
-	".turbo",
-	".next",
-	"coverage"
-]);
-/**
-* A directory that is itself a checkout is a DIFFERENT repository's tree, not part of this corpus.
-*
-* A name blocklist cannot express this: it can only say "this is called X", never "this is a
-* boundary". `SKIP_DIRS` already holds `.git`, so the walk skipped the METADATA directory while
-* descending straight into the checkout that directory marks — one level off from where the guard
-* was needed. Agent-harness worktree isolation checks this repo out inside itself, and the scan then
-* found the whole corpus once per worktree: 38 spec files where 10 exist, and every corpus-wide
-* guard silently auditing a tree nobody has.
-*
-* `.git` is a DIRECTORY in a clone and a FILE in a worktree or submodule, so both forms count.
-*/
-function isNestedCheckout(abs) {
-	return existsSync(join(abs, ".git"));
-}
-const ANCHORS_CONFIG = ".agents/sdd/spec-anchors.toml";
-function parseFrontmatter(text) {
-	const m = /^---\r?\n([\s\S]*?)\r?\n---\s*(?:\r?\n|$)/.exec(text);
-	if (!m) return null;
-	const fm = { approval: {} };
-	let gate = null;
-	for (const raw of m[1].split("\n")) {
-		const line = raw.replace(/\r$/, "");
-		if (line.trim() === "" || line.trim().startsWith("#")) continue;
-		const indent = line.length - line.trimStart().length;
-		const [key, ...rest] = line.trim().split(":");
-		const value = rest.join(":").trim();
-		if (indent === 0) {
-			gate = null;
-			if (key === "status") fm.status = unquote(value);
-			else if (key === "project-path") fm.projectPath = unquote(value);
-			else if (key === "name") fm.name = unquote(value);
-			else if (key === "approval") gate = null;
-		} else if (indent === 2 && value === "" && insideApproval(m[1], line)) gate = key;
-		else if (indent >= 4 && key === "verdict" && gate) fm.approval[gate] = unquote(value);
-	}
-	return fm;
-}
-function insideApproval(block, line) {
-	const lines = block.split("\n");
-	const idx = lines.indexOf(line);
-	for (let i = idx - 1; i >= 0; i--) {
-		const l = lines[i].replace(/\r$/, "");
-		if (l.trim() === "" || l.trim().startsWith("#")) continue;
-		if (l.length - l.trimStart().length === 0) return l.trim().replace(/:.*$/, "") === "approval";
-	}
-	return false;
-}
-function unquote(v) {
-	return v.replace(/^["']|["']$/g, "");
-}
-function classifyLocation(relPath) {
-	const p = relPath.replace(/\\/g, "/");
-	if (p === ".agents/spec/spec.md") return {
-		pattern: "root-single",
-		locationDir: ""
-	};
-	const multi = /^\.agents\/specs\/([^/]+)\/spec\.md$/.exec(p);
-	if (multi) return {
-		pattern: "root-multi",
-		locationDir: multi[1]
-	};
-	const nested = /^(.+)\/\.agents\/spec\/spec\.md$/.exec(p);
-	if (nested) return {
-		pattern: "nested",
-		locationDir: nested[1]
-	};
-	return null;
-}
-function deriveName(loc, fm) {
-	if (fm.name) return {
-		name: fm.name,
-		nameSource: "declared"
-	};
-	if (loc.pattern === "root-single") return {
-		name: ROOT_PROJECT_NAME,
-		nameSource: "derived"
-	};
-	if (loc.pattern === "root-multi") return {
-		name: loc.locationDir,
-		nameSource: "derived"
-	};
-	if (loc.pattern === "extra" && loc.capturedName) return {
-		name: loc.capturedName,
-		nameSource: "derived"
-	};
-	return {
-		name: loc.locationDir.split("/").pop() ?? loc.locationDir,
-		nameSource: "guessed"
-	};
-}
-function discoverSpecFiles(root) {
-	const found = [];
-	const walk = (relDir) => {
-		let entries;
-		try {
-			entries = readdirSync(join(root, relDir), { withFileTypes: true });
-		} catch {
-			return;
-		}
-		for (const e of entries) {
-			if (!e.isDirectory() || SKIP_DIRS.has(e.name)) continue;
-			const childRel = relDir ? `${relDir}/${e.name}` : e.name;
-			if (isNestedCheckout(join(root, childRel))) continue;
-			if (e.name === ".agents") {
-				probeAgents(root, childRel, found);
-				continue;
-			}
-			walk(childRel);
-		}
-	};
-	walk("");
-	return found;
-}
-function probeAgents(root, agentsRel, found) {
-	const single = `${agentsRel}/spec/spec.md`;
-	if (existsSync(join(root, single))) found.push(single);
-	if (agentsRel === ".agents") {
-		const specsDir = join(root, ".agents", "specs");
-		let projects;
-		try {
-			projects = readdirSync(specsDir, { withFileTypes: true });
-		} catch {
-			projects = [];
-		}
-		for (const p of projects) {
-			if (!p.isDirectory()) continue;
-			const rel = `.agents/specs/${p.name}/spec.md`;
-			if (existsSync(join(root, rel))) found.push(rel);
-		}
-	}
-}
-function parseAnchorsToml(text) {
-	const m = /(^|\n)\s*anchors\s*=\s*\[([\s\S]*?)\]/.exec(text);
-	if (!m) return [];
-	const out = [];
-	for (const q of m[2].matchAll(/"([^"]*)"|'([^']*)'/g)) out.push((q[1] ?? q[2]).trim());
-	return out.filter((s) => s !== "");
-}
-function readAnchors(root) {
-	const file = join(root, ANCHORS_CONFIG);
-	if (!existsSync(file)) return [];
-	try {
-		return parseAnchorsToml(readFileSync(file, "utf8"));
-	} catch {
-		process.stderr.write(`discover-specs: ignoring unreadable ${ANCHORS_CONFIG}\n`);
-		return [];
-	}
-}
-function collectDescendants(root, startDir) {
-	const out = [startDir];
-	let entries;
-	try {
-		entries = readdirSync(join(root, startDir), { withFileTypes: true });
-	} catch {
-		return out;
-	}
-	for (const e of entries) {
-		if (!e.isDirectory() || SKIP_DIRS.has(e.name)) continue;
-		const childRel = startDir ? `${startDir}/${e.name}` : e.name;
-		if (isNestedCheckout(join(root, childRel))) continue;
-		out.push(...collectDescendants(root, childRel));
-	}
-	return out;
-}
-function expandAnchor(root, pattern) {
-	const segs = pattern.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "").split("/").filter(Boolean);
-	let frontier = [{ dir: "" }];
-	for (const seg of segs) {
-		const next = [];
-		if (seg === "**") {
-			for (const node of frontier) for (const dir of collectDescendants(root, node.dir)) next.push({
-				dir,
-				capturedName: node.capturedName
-			});
-			frontier = next;
-			continue;
-		}
-		const isGlob = seg === "*" || seg === "<project>";
-		for (const node of frontier) if (isGlob) {
-			let entries;
-			try {
-				entries = readdirSync(join(root, node.dir), { withFileTypes: true });
-			} catch {
-				continue;
-			}
-			for (const e of entries) {
-				if (!e.isDirectory() || SKIP_DIRS.has(e.name)) continue;
-				const childRel = node.dir ? `${node.dir}/${e.name}` : e.name;
-				if (isNestedCheckout(join(root, childRel))) continue;
-				next.push({
-					dir: childRel,
-					capturedName: seg === "<project>" ? e.name : node.capturedName
-				});
-			}
-		} else next.push({
-			dir: node.dir ? `${node.dir}/${seg}` : seg,
-			capturedName: node.capturedName
-		});
-		frontier = next;
-	}
-	const out = [];
-	for (const node of frontier) {
-		const rel = node.dir ? `${node.dir}/spec.md` : "spec.md";
-		if (existsSync(join(root, rel))) out.push({
-			rel,
-			capturedName: node.capturedName
-		});
-	}
-	return out;
-}
-function recordFor(root, rel, loc) {
-	let fm;
-	try {
-		fm = parseFrontmatter(readFileSync(join(root, rel), "utf8"));
-	} catch {
-		return null;
-	}
-	if (!fm?.status || !LIFECYCLE_STATUSES.has(fm.status)) return null;
-	const { name, nameSource } = deriveName(loc, fm);
-	return {
-		path: rel.replace(/\/spec\.md$/, ""),
-		name,
-		nameSource,
-		status: fm.status,
-		projectPath: fm.projectPath ?? "",
-		approvals: Object.entries(fm.approval).map(([gate, verdict]) => `${gate}:${verdict}`).join(";")
-	};
-}
-function collectSpecs(root) {
-	const out = [];
-	const seen = /* @__PURE__ */ new Set();
-	for (const rel of discoverSpecFiles(root)) {
-		const loc = classifyLocation(rel);
-		if (!loc) continue;
-		const rec = recordFor(root, rel, loc);
-		if (rec) {
-			out.push(rec);
-			seen.add(rel);
-		}
-	}
-	for (const pattern of readAnchors(root)) for (const { rel, capturedName } of expandAnchor(root, pattern)) {
-		if (seen.has(rel)) continue;
-		const rec = recordFor(root, rel, {
-			pattern: "extra",
-			locationDir: rel.replace(/\/spec\.md$/, ""),
-			capturedName
-		});
-		if (rec) {
-			out.push(rec);
-			seen.add(rel);
-		}
-	}
-	return out.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
-}
-function resolveByName(specs, name) {
-	const want = name.trim().toLowerCase();
-	const hits = specs.filter((s) => s.name.toLowerCase() === want);
-	if (hits.length === 0) return { kind: "none" };
-	if (hits.length === 1) return {
-		kind: "match",
-		spec: hits[0]
-	};
-	return {
-		kind: "ambiguous",
-		candidates: hits
-	};
-}
-const COLUMNS = [
-	"path",
-	"name",
-	"nameSource",
-	"status",
-	"projectPath",
-	"approvals"
-];
-function toonField(v) {
-	if (v === "" || /[",]/.test(v) || v !== v.trim()) return `"${v.replace(/"/g, "\"\"")}"`;
-	return v;
-}
-function toToon(specs) {
-	return [`specs[${specs.length}]{${COLUMNS.join(",")}}:`, ...specs.map((s) => `  ${COLUMNS.map((c) => toonField(s[c])).join(",")}`)].join("\n");
-}
-function main(argv) {
-	const root = argv.includes("--root") ? argv[argv.indexOf("--root") + 1] ?? "." : ".";
-	const format = argv.includes("--format") ? argv[argv.indexOf("--format") + 1] : "toon";
-	let specs = collectSpecs(root);
-	if (argv.includes("--resolve")) {
-		const name = argv[argv.indexOf("--resolve") + 1] ?? "";
-		const r = resolveByName(specs, name);
-		specs = r.kind === "match" ? [r.spec] : r.kind === "ambiguous" ? r.candidates : [];
-	}
-	const out = format === "json" ? JSON.stringify(specs, null, 2) : toToon(specs);
-	process.stdout.write(`${out}\n`);
-	return 0;
-}
-if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) process.exit(main(process.argv.slice(2)));
-//#endregion
-export { LIFECYCLE_STATUSES, classifyLocation, collectSpecs, deriveName, discoverSpecFiles, expandAnchor, main, parseAnchorsToml, parseFrontmatter, readAnchors, resolveByName, toToon };