cyber-sdd 0.7.0 → 0.7.2

package/skills/manage-ignore/scripts/manage-ignore.mts

@@ -1,297 +0,0 @@
-#!/usr/bin/env node
-// manage-ignore — the concrete curation engine for `.agents/sdd/.sddignore`, the optional
-// gitignore-syntax file `resolve-tracking` consults to decide whether an artifact is tracked or
-// ignored. It reads/writes ONLY `.agents/sdd/.sddignore` — never a spec.md, status, approval, or
-// freeze.
-//
-// Operations:
-//   --list                  print every rule in file order (a missing file prints nothing)
-//   --add <pattern>         validate + append a well-formed gitignore rule (creates the file)
-//   --remove <pattern>      drop a matching rule, preserving the order of the rest (absent = no-op)
-//   --induce <path>         offer a literal-path candidate + a ** generalization (persists nothing)
-//   --preview <pattern>     list the working-tree paths the pattern would ignore / re-track
-//
-// `.sddignore` is gitignore syntax: a plain pattern => ignored, a leading `!` => re-included, `#`
-// comments and blank lines allowed. Order is MEANINGFUL (last-match-wins), so rules are NEVER
-// re-sorted — add appends, remove keeps the surviving order.
-// Pure functions are exported for node:test; running the file directly drives the CLI. No deps
-// (the repo's node-≥23.6 convention).
-
-import { existsSync, mkdirSync, readdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { pathToFileURL } from 'node:url'
-
-const IGNORE_FILE = '.agents/sdd/.sddignore'
-const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', '.turbo', '.next', 'coverage'])
-
-// ── the ignore file (raw-line preserving so order + comments survive CRUD) ──
-
-// Split into lines, dropping the single trailing empty produced by a final newline.
-export function splitLines(text: string): string[] {
-	const lines = text.split('\n')
-	if (lines.length > 0 && lines[lines.length - 1] === '') lines.pop()
-	return lines
-}
-
-export function readIgnoreLines(root: string): string[] {
-	const file = join(root, IGNORE_FILE)
-	if (!existsSync(file)) return []
-	try {
-		return splitLines(readFileSync(file, 'utf8'))
-	} catch {
-		return []
-	}
-}
-
-function writeIgnoreLines(root: string, lines: string[]): void {
-	const file = join(root, IGNORE_FILE)
-	mkdirSync(dirname(file), { recursive: true })
-	writeFileSync(file, lines.length === 0 ? '' : `${lines.join('\n')}\n`)
-}
-
-// A line is a rule when it is not blank and not a `#` comment. `!re-track` rules are rules.
-export function isRuleLine(line: string): boolean {
-	const t = line.trim()
-	return t !== '' && !t.startsWith('#')
-}
-
-// ── list ──
-
-// Every rule in file order; comments and blank lines are omitted (a missing file yields []).
-export function listRules(root: string): string[] {
-	return readIgnoreLines(root)
-		.filter(isRuleLine)
-		.map((l) => l.trim())
-}
-
-// ── validation ──
-
-// True when the bracket expression opened at some `[` is never closed by a later `]`.
-function hasUnclosedBracket(s: string): boolean {
-	let i = 0
-	while (i < s.length) {
-		if (s[i] === '\\') {
-			i += 2
-			continue
-		}
-		if (s[i] === '[') {
-			const close = s.indexOf(']', i + 1)
-			if (close === -1) return true
-			i = close + 1
-			continue
-		}
-		i++
-	}
-	return false
-}
-
-// A well-formed gitignore pattern: non-empty after stripping a leading `!` and surrounding space,
-// not a comment, and with no unclosed `[…]` bracket expression.
-export function isValidPattern(pattern: string): boolean {
-	let s = pattern
-	if (s.startsWith('!')) s = s.slice(1)
-	s = s.replace(/^\s+|\s+$/g, '')
-	if (s === '' || s.startsWith('#')) return false
-	if (hasUnclosedBracket(s)) return false
-	return true
-}
-
-// ── add / remove (CRUD, order-preserving) ──
-
-export type CrudResult =
-	| { ok: true; changed: boolean; rules: string[]; message: string }
-	| { ok: false; reason: string }
-
-// Append a well-formed rule after the existing lines (creating the file when absent). Existing
-// order is preserved; a duplicate is a no-op.
-export function addRule(root: string, pattern: string): CrudResult {
-	const p = pattern.trim()
-	if (!isValidPattern(p)) return { ok: false, reason: 'malformed gitignore pattern' }
-	const lines = readIgnoreLines(root)
-	if (lines.some((l) => l.trim() === p)) {
-		return { ok: true, changed: false, rules: listRules(root), message: 'already present' }
-	}
-	const next = [...lines, p]
-	writeIgnoreLines(root, next)
-	return { ok: true, changed: true, rules: next.filter(isRuleLine).map((l) => l.trim()), message: `added ${p}` }
-}
-
-// Drop every line whose rule text equals the pattern, keeping the order of the rest. Removing an
-// absent rule leaves the file byte-for-byte unchanged.
-export function removeRule(root: string, pattern: string): CrudResult {
-	const p = pattern.trim()
-	const lines = readIgnoreLines(root)
-	const next = lines.filter((l) => l.trim() !== p)
-	if (next.length === lines.length) {
-		return { ok: true, changed: false, rules: listRules(root), message: 'nothing was removed' }
-	}
-	writeIgnoreLines(root, next)
-	return { ok: true, changed: true, rules: next.filter(isRuleLine).map((l) => l.trim()), message: `removed ${p}` }
-}
-
-// ── induce ──
-
-export type InduceResult = { ok: true; candidates: string[] } | { ok: false; reason: string }
-
-// From a sample repo-relative path, offer a literal-path candidate and a `**` generalization that
-// ignores the same basename anywhere in the tree. Persists nothing; refuses a path not under the
-// repo (leading slash or a `..` escape).
-export function inducePatterns(_root: string, samplePath: string): InduceResult {
-	const normalized = samplePath.trim().replace(/\\/g, '/')
-	if (normalized.startsWith('/')) return { ok: false, reason: 'path is not repo-relative (absolute)' }
-	const rel = normalized.replace(/\/+$/g, '')
-	if (rel === '' || /(^|\/)\.\.(\/|$)/.test(rel)) {
-		return { ok: false, reason: 'path is not repo-relative' }
-	}
-	const base = rel.split('/').pop() ?? rel
-	const generalized = `**/${base}`
-	const candidates = generalized === rel ? [rel] : [rel, generalized]
-	return { ok: true, candidates }
-}
-
-// ── preview ──
-
-export type PreviewResult = { ok: true; negated: boolean; matches: string[] } | { ok: false; reason: string }
-
-// Compile one gitignore pattern (already `!`-stripped) to a full-match RegExp. `**` spans
-// separators, `*`/`?` stay within one segment, a leading `/` (or an internal `/`) anchors to the
-// repo root, a trailing `/` marks a dir. Every match also covers the node's descendants.
-export function gitignoreToRegExp(pattern: string): RegExp {
-	let pat = pattern
-	if (pat.endsWith('/')) pat = pat.slice(0, -1) // trailing-slash dir marker
-	let anchored = pat.startsWith('/')
-	if (anchored) pat = pat.slice(1)
-	if (pat.includes('/')) anchored = true // an internal separator anchors to root
-	let body = ''
-	for (let i = 0; i < pat.length; i++) {
-		const c = pat[i]
-		if (c === '*') {
-			if (pat[i + 1] === '*') {
-				i++
-				if (pat[i + 1] === '/') {
-					i++
-					body += '(?:.*/)?' // `**/` spans zero or more directory segments
-				} else {
-					body += '.*' // `**` spans separators
-				}
-			} else {
-				body += '[^/]*' // `*` stays within a segment
-			}
-		} else if (c === '?') {
-			body += '[^/]'
-		} else if (c === '[') {
-			let j = i + 1
-			let cls = '['
-			if (pat[j] === '!') {
-				cls += '^'
-				j++
-			}
-			while (j < pat.length && pat[j] !== ']') {
-				cls += /[\\^\]]/.test(pat[j]) ? `\\${pat[j]}` : pat[j]
-				j++
-			}
-			cls += ']'
-			body += cls
-			i = j
-		} else {
-			body += c.replace(/[.+^${}()|\\]/g, '\\$&')
-		}
-	}
-	const prefix = anchored ? '^' : '^(?:.*/)?' // unanchored patterns match at any depth
-	return new RegExp(`${prefix}${body}(?:/.*)?$`) // also cover everything below the matched node
-}
-
-export function matchesPattern(pattern: string, path: string): boolean {
-	const body = pattern.startsWith('!') ? pattern.slice(1) : pattern
-	return gitignoreToRegExp(body).test(path)
-}
-
-// Every repo-relative path (files and dirs) reachable from the root, skipping SKIP_DIRS.
-function walkTree(root: string): string[] {
-	const out: string[] = []
-	const walk = (rel: string): void => {
-		let entries: import('node:fs').Dirent[]
-		try {
-			entries = readdirSync(join(root, rel), { withFileTypes: true })
-		} catch {
-			return
-		}
-		for (const e of entries) {
-			if (SKIP_DIRS.has(e.name)) continue
-			const child = rel ? `${rel}/${e.name}` : e.name
-			out.push(child)
-			if (e.isDirectory()) walk(child)
-		}
-	}
-	walk('')
-	return out.sort()
-}
-
-// List the working-tree paths a candidate pattern would ignore. For a `!pattern`, the same paths
-// are the ones it would RE-TRACK (re-include). Persists nothing; a malformed pattern is refused.
-export function previewPattern(root: string, pattern: string): PreviewResult {
-	const p = pattern.trim()
-	if (!isValidPattern(p)) return { ok: false, reason: 'malformed gitignore pattern' }
-	const negated = p.startsWith('!')
-	const matches = walkTree(root).filter((path) => matchesPattern(p, path))
-	return { ok: true, negated, matches }
-}
-
-// ── CLI ──
-
-function flag(argv: string[], name: string): string | undefined {
-	const i = argv.indexOf(name)
-	return i === -1 ? undefined : argv[i + 1]
-}
-
-export function main(argv: string[]): number {
-	const root = flag(argv, '--root') ?? '.'
-	const w = (s: string) => process.stdout.write(`${s}\n`)
-
-	if (argv.includes('--list')) {
-		for (const rule of listRules(root)) w(rule)
-		return 0
-	}
-	if (argv.includes('--add')) {
-		const r = addRule(root, flag(argv, '--add') ?? '')
-		w(r.ok ? r.message : `refused: ${r.reason}`)
-		return r.ok ? 0 : 1
-	}
-	if (argv.includes('--remove')) {
-		const r = removeRule(root, flag(argv, '--remove') ?? '')
-		w(r.ok ? r.message : `refused: ${r.reason}`)
-		return r.ok ? 0 : 1
-	}
-	if (argv.includes('--induce')) {
-		const r = inducePatterns(root, flag(argv, '--induce') ?? '')
-		if (!r.ok) {
-			w(`unusable: ${r.reason}`)
-			return 1
-		}
-		w('Candidate ignore patterns:')
-		for (const c of r.candidates) w(`  ${c}`)
-		return 0
-	}
-	if (argv.includes('--preview')) {
-		const r = previewPattern(root, flag(argv, '--preview') ?? '')
-		if (!r.ok) {
-			w(`invalid: ${r.reason}`)
-			return 1
-		}
-		const verb = r.negated ? 're-track' : 'ignore'
-		if (r.matches.length === 0) {
-			w(`This pattern would ${verb} no path.`)
-			return 0
-		}
-		w(`This pattern would ${verb}:`)
-		for (const m of r.matches) w(`  ${m}`)
-		return 0
-	}
-
-	w('usage: manage-ignore --list | --add <p> | --remove <p> | --induce <path> | --preview <p>')
-	return 0
-}
-
-if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
-	process.exit(main(process.argv.slice(2)))
-}

package/skills/manage-scenario-bridge/scripts/manage-scenario-bridge.bundle.mjs

@@ -1,237 +0,0 @@
-#!/usr/bin/env node
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { pathToFileURL } from "node:url";
-//#region skills/spec-gate/vendor/gherkin-cli.mjs
-var TokenType;
-(function(TokenType) {
-	TokenType[TokenType["None"] = 0] = "None";
-	TokenType[TokenType["EOF"] = 1] = "EOF";
-	TokenType[TokenType["Empty"] = 2] = "Empty";
-	TokenType[TokenType["Comment"] = 3] = "Comment";
-	TokenType[TokenType["TagLine"] = 4] = "TagLine";
-	TokenType[TokenType["FeatureLine"] = 5] = "FeatureLine";
-	TokenType[TokenType["RuleLine"] = 6] = "RuleLine";
-	TokenType[TokenType["BackgroundLine"] = 7] = "BackgroundLine";
-	TokenType[TokenType["ScenarioLine"] = 8] = "ScenarioLine";
-	TokenType[TokenType["ExamplesLine"] = 9] = "ExamplesLine";
-	TokenType[TokenType["StepLine"] = 10] = "StepLine";
-	TokenType[TokenType["DocStringSeparator"] = 11] = "DocStringSeparator";
-	TokenType[TokenType["TableRow"] = 12] = "TableRow";
-	TokenType[TokenType["Language"] = 13] = "Language";
-	TokenType[TokenType["Other"] = 14] = "Other";
-})(TokenType || (TokenType = {}));
-var RuleType;
-(function(RuleType) {
-	RuleType[RuleType["None"] = 0] = "None";
-	RuleType[RuleType["_EOF"] = 1] = "_EOF";
-	RuleType[RuleType["_Empty"] = 2] = "_Empty";
-	RuleType[RuleType["_Comment"] = 3] = "_Comment";
-	RuleType[RuleType["_TagLine"] = 4] = "_TagLine";
-	RuleType[RuleType["_FeatureLine"] = 5] = "_FeatureLine";
-	RuleType[RuleType["_RuleLine"] = 6] = "_RuleLine";
-	RuleType[RuleType["_BackgroundLine"] = 7] = "_BackgroundLine";
-	RuleType[RuleType["_ScenarioLine"] = 8] = "_ScenarioLine";
-	RuleType[RuleType["_ExamplesLine"] = 9] = "_ExamplesLine";
-	RuleType[RuleType["_StepLine"] = 10] = "_StepLine";
-	RuleType[RuleType["_DocStringSeparator"] = 11] = "_DocStringSeparator";
-	RuleType[RuleType["_TableRow"] = 12] = "_TableRow";
-	RuleType[RuleType["_Language"] = 13] = "_Language";
-	RuleType[RuleType["_Other"] = 14] = "_Other";
-	RuleType[RuleType["GherkinDocument"] = 15] = "GherkinDocument";
-	RuleType[RuleType["Feature"] = 16] = "Feature";
-	RuleType[RuleType["FeatureHeader"] = 17] = "FeatureHeader";
-	RuleType[RuleType["Rule"] = 18] = "Rule";
-	RuleType[RuleType["RuleHeader"] = 19] = "RuleHeader";
-	RuleType[RuleType["Background"] = 20] = "Background";
-	RuleType[RuleType["ScenarioDefinition"] = 21] = "ScenarioDefinition";
-	RuleType[RuleType["Scenario"] = 22] = "Scenario";
-	RuleType[RuleType["ExamplesDefinition"] = 23] = "ExamplesDefinition";
-	RuleType[RuleType["Examples"] = 24] = "Examples";
-	RuleType[RuleType["ExamplesTable"] = 25] = "ExamplesTable";
-	RuleType[RuleType["Step"] = 26] = "Step";
-	RuleType[RuleType["StepArg"] = 27] = "StepArg";
-	RuleType[RuleType["DataTable"] = 28] = "DataTable";
-	RuleType[RuleType["DocString"] = 29] = "DocString";
-	RuleType[RuleType["Tags"] = 30] = "Tags";
-	RuleType[RuleType["DescriptionHelper"] = 31] = "DescriptionHelper";
-	RuleType[RuleType["Description"] = 32] = "Description";
-})(RuleType || (RuleType = {}));
-var AttachmentContentEncoding;
-(function(AttachmentContentEncoding) {
-	AttachmentContentEncoding["IDENTITY"] = "IDENTITY";
-	AttachmentContentEncoding["BASE64"] = "BASE64";
-})(AttachmentContentEncoding || (AttachmentContentEncoding = {}));
-var HookType;
-(function(HookType) {
-	HookType["BEFORE_TEST_RUN"] = "BEFORE_TEST_RUN";
-	HookType["AFTER_TEST_RUN"] = "AFTER_TEST_RUN";
-	HookType["BEFORE_TEST_CASE"] = "BEFORE_TEST_CASE";
-	HookType["AFTER_TEST_CASE"] = "AFTER_TEST_CASE";
-	HookType["BEFORE_TEST_STEP"] = "BEFORE_TEST_STEP";
-	HookType["AFTER_TEST_STEP"] = "AFTER_TEST_STEP";
-})(HookType || (HookType = {}));
-var PickleStepType;
-(function(PickleStepType) {
-	PickleStepType["UNKNOWN"] = "Unknown";
-	PickleStepType["CONTEXT"] = "Context";
-	PickleStepType["ACTION"] = "Action";
-	PickleStepType["OUTCOME"] = "Outcome";
-})(PickleStepType || (PickleStepType = {}));
-var SourceMediaType;
-(function(SourceMediaType) {
-	SourceMediaType["TEXT_X_CUCUMBER_GHERKIN_PLAIN"] = "text/x.cucumber.gherkin+plain";
-	SourceMediaType["TEXT_X_CUCUMBER_GHERKIN_MARKDOWN"] = "text/x.cucumber.gherkin+markdown";
-})(SourceMediaType || (SourceMediaType = {}));
-var StepDefinitionPatternType;
-(function(StepDefinitionPatternType) {
-	StepDefinitionPatternType["CUCUMBER_EXPRESSION"] = "CUCUMBER_EXPRESSION";
-	StepDefinitionPatternType["REGULAR_EXPRESSION"] = "REGULAR_EXPRESSION";
-})(StepDefinitionPatternType || (StepDefinitionPatternType = {}));
-var StepKeywordType;
-(function(StepKeywordType) {
-	StepKeywordType["UNKNOWN"] = "Unknown";
-	StepKeywordType["CONTEXT"] = "Context";
-	StepKeywordType["ACTION"] = "Action";
-	StepKeywordType["OUTCOME"] = "Outcome";
-	StepKeywordType["CONJUNCTION"] = "Conjunction";
-})(StepKeywordType || (StepKeywordType = {}));
-var TestStepResultStatus;
-(function(TestStepResultStatus) {
-	TestStepResultStatus["UNKNOWN"] = "UNKNOWN";
-	TestStepResultStatus["PASSED"] = "PASSED";
-	TestStepResultStatus["SKIPPED"] = "SKIPPED";
-	TestStepResultStatus["PENDING"] = "PENDING";
-	TestStepResultStatus["UNDEFINED"] = "UNDEFINED";
-	TestStepResultStatus["AMBIGUOUS"] = "AMBIGUOUS";
-	TestStepResultStatus["FAILED"] = "FAILED";
-})(TestStepResultStatus || (TestStepResultStatus = {}));
-var KeywordPrefix;
-(function(KeywordPrefix) {
-	KeywordPrefix["BULLET"] = "^(\\s*[*+-]\\s*)";
-	KeywordPrefix["HEADER"] = "^(#{1,6}\\s)";
-})(KeywordPrefix || (KeywordPrefix = {}));
-StepKeywordType.UNKNOWN, PickleStepType.UNKNOWN, StepKeywordType.CONTEXT, PickleStepType.CONTEXT, StepKeywordType.ACTION, PickleStepType.ACTION, StepKeywordType.OUTCOME, PickleStepType.OUTCOME, StepKeywordType.CONJUNCTION;
-//#endregion
-//#region skills/verify-scenarios/scripts/verify-scenarios.mts
-function parseSourcesToml(text) {
-	const out = [];
-	const blocks = text.split(/(?=^\s*\[\[source\]\]\s*$)/m).filter((b) => /^\s*\[\[source\]\]\s*$/m.test(b));
-	for (const block of blocks) {
-		const body = block.replace(/^\s*\[\[source\]\]\s*$/m, "");
-		const fields = {};
-		for (const m of body.matchAll(/^\s*([A-Za-z_][\w-]*)\s*=\s*(?:"([^"]*)"|'([^']*)')\s*$/gm)) fields[m[1]] = m[2] ?? m[3] ?? "";
-		if (!fields.adapter || !fields.reportPath) continue;
-		out.push({
-			adapter: fields.adapter,
-			command: fields.command,
-			reportPath: fields.reportPath
-		});
-	}
-	return out;
-}
-if (process.argv[1] && false);
-//#endregion
-//#region skills/manage-scenario-bridge/scripts/manage-scenario-bridge.mts
-const CONFIG_REL_PATH = ".agents/sdd/scenario-bridge.toml";
-function configPath(projectPath) {
-	return join(projectPath, CONFIG_REL_PATH);
-}
-function listSources(projectPath) {
-	const file = configPath(projectPath);
-	if (!existsSync(file)) return [];
-	try {
-		return parseSourcesToml(readFileSync(file, "utf8"));
-	} catch {
-		return [];
-	}
-}
-function renderBlock(source) {
-	return [
-		"[[source]]",
-		`adapter    = "${source.adapter}"`,
-		...source.command !== void 0 ? [`command    = "${source.command}"`] : [],
-		`reportPath = "${source.reportPath}"`
-	].join("\n");
-}
-function validateInput(input) {
-	if (!input.adapter || !input.reportPath) return {
-		ok: false,
-		reason: "a source needs both adapter and reportPath"
-	};
-	return {
-		ok: true,
-		adapter: input.adapter,
-		command: input.command,
-		reportPath: input.reportPath
-	};
-}
-function scaffoldSource(projectPath, input) {
-	const valid = validateInput(input);
-	if (!valid.ok) return valid;
-	const file = configPath(projectPath);
-	if (existsSync(file)) return {
-		ok: false,
-		reason: "scenario-bridge.toml already exists; use add to append a source"
-	};
-	mkdirSync(dirname(file), { recursive: true });
-	writeFileSync(file, `${renderBlock(valid)}\n`);
-	const sources = listSources(projectPath);
-	return {
-		ok: true,
-		message: `scaffolded ${file}`,
-		sources
-	};
-}
-function addSource(projectPath, input) {
-	const valid = validateInput(input);
-	if (!valid.ok) return valid;
-	const file = configPath(projectPath);
-	if (!existsSync(file)) return {
-		ok: false,
-		reason: "scenario-bridge.toml does not exist yet; use scaffold to create it first"
-	};
-	const existing = readFileSync(file, "utf8");
-	const sep = existing.endsWith("\n") ? "" : "\n";
-	writeFileSync(file, `${existing}${sep}\n${renderBlock(valid)}\n`);
-	const sources = listSources(projectPath);
-	return {
-		ok: true,
-		message: `added a source to ${file}`,
-		sources
-	};
-}
-function flag(argv, name) {
-	const i = argv.indexOf(name);
-	return i === -1 ? void 0 : argv[i + 1];
-}
-function inputFromArgv(argv) {
-	return {
-		adapter: flag(argv, "--adapter"),
-		command: flag(argv, "--command"),
-		reportPath: flag(argv, "--report-path")
-	};
-}
-function main(argv) {
-	const projectPath = flag(argv, "--project-path") ?? ".";
-	const w = (s) => process.stdout.write(`${s}\n`);
-	if (argv.includes("--list")) {
-		for (const s of listSources(projectPath)) w(`${s.adapter}${s.command ? ` (${s.command})` : ""} -> ${s.reportPath}`);
-		return 0;
-	}
-	if (argv.includes("--scaffold")) {
-		const r = scaffoldSource(projectPath, inputFromArgv(argv));
-		w(r.ok ? r.message : `refused: ${r.reason}`);
-		return r.ok ? 0 : 1;
-	}
-	if (argv.includes("--add")) {
-		const r = addSource(projectPath, inputFromArgv(argv));
-		w(r.ok ? r.message : `refused: ${r.reason}`);
-		return r.ok ? 0 : 1;
-	}
-	w("usage: manage-scenario-bridge --project-path <dir> --list | --scaffold --adapter <a> [--command <c>] --report-path <p> | --add --adapter <a> [--command <c>] --report-path <p>");
-	return 0;
-}
-if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) process.exit(main(process.argv.slice(2)));
-//#endregion
-export { addSource, configPath, listSources, main, scaffoldSource };

package/skills/manage-scenario-bridge/scripts/manage-scenario-bridge.mts

@@ -1,159 +0,0 @@
-#!/usr/bin/env node
-// manage-scenario-bridge — the concrete curation engine for `<project-path>/.agents/sdd/scenario-bridge.toml`,
-// the one-time per-project wiring the verify-scenarios bridge and the impl-judge step-0 consumption
-// both read. It reads/writes ONLY that one project's scenario-bridge.toml — never a spec.md, status,
-// approval, or a freeze; it never runs the bridge or a test.
-//
-// Operations:
-//   --list                                        print every configured [[source]] block in order
-//   --scaffold --adapter <a> [--command <c>] --report-path <p>
-//                                                  create the config with one source block; refused
-//                                                  when the file already exists
-//   --add --adapter <a> [--command <c>] --report-path <p>
-//                                                  append a source block to an existing config;
-//                                                  refused when the file does not exist
-//
-// Every read/write is resolved beneath --project-path (a colocated project's project-path is its own
-// repo root, so the config lands at the familiar .agents/sdd/scenario-bridge.toml there).
-//
-// Reuses the verify-scenarios bridge's own SourceConfig/parseSourcesToml shape — never diverge the
-// format the reader (verify-scenarios) and the writer (this engine) agree on.
-//
-// Pure functions are exported for node:test; running the file directly drives the CLI. No deps (the
-// repo's node-≥23.6 convention).
-
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
-import { pathToFileURL } from 'node:url'
-import { parseSourcesToml, type SourceConfig } from '../../verify-scenarios/scripts/verify-scenarios.mts'
-
-export type { SourceConfig }
-
-const CONFIG_REL_PATH = '.agents/sdd/scenario-bridge.toml'
-
-export function configPath(projectPath: string): string {
-	return join(projectPath, CONFIG_REL_PATH)
-}
-
-// ── list ──
-
-// Every configured source in file order; a missing config lists nothing without error.
-export function listSources(projectPath: string): SourceConfig[] {
-	const file = configPath(projectPath)
-	if (!existsSync(file)) return []
-	try {
-		return parseSourcesToml(readFileSync(file, 'utf8'))
-	} catch {
-		return []
-	}
-}
-
-// ── render one [[source]] block ──
-
-function renderBlock(source: { adapter: string; command?: string; reportPath: string }): string {
-	const lines = [
-		'[[source]]',
-		`adapter    = "${source.adapter}"`,
-		...(source.command !== undefined ? [`command    = "${source.command}"`] : []),
-		`reportPath = "${source.reportPath}"`,
-	]
-	return lines.join('\n')
-}
-
-// ── scaffold / add ──
-
-export interface NewSourceInput {
-	adapter?: string
-	command?: string
-	reportPath?: string
-}
-
-export type MutateResult = { ok: true; message: string; sources: SourceConfig[] } | { ok: false; reason: string }
-
-function validateInput(
-	input: NewSourceInput,
-): { ok: true; adapter: string; command?: string; reportPath: string } | { ok: false; reason: string } {
-	if (!input.adapter || !input.reportPath) {
-		return { ok: false, reason: 'a source needs both adapter and reportPath' }
-	}
-	return { ok: true, adapter: input.adapter, command: input.command, reportPath: input.reportPath }
-}
-
-// Creates <project-path>/.agents/sdd/scenario-bridge.toml with one [[source]] block. Refuses when the
-// file already exists (use `add` instead) or when adapter/reportPath is missing — no source block is
-// written in the refused case.
-export function scaffoldSource(projectPath: string, input: NewSourceInput): MutateResult {
-	const valid = validateInput(input)
-	if (!valid.ok) return valid
-	const file = configPath(projectPath)
-	if (existsSync(file)) {
-		return { ok: false, reason: 'scenario-bridge.toml already exists; use add to append a source' }
-	}
-	mkdirSync(dirname(file), { recursive: true })
-	writeFileSync(file, `${renderBlock(valid)}\n`)
-	const sources = listSources(projectPath)
-	return { ok: true, message: `scaffolded ${file}`, sources }
-}
-
-// Appends a [[source]] block to an existing config, leaving the existing sources untouched. Refuses
-// when the config does not exist yet (names scaffold as the entry point) or when adapter/reportPath
-// is missing.
-export function addSource(projectPath: string, input: NewSourceInput): MutateResult {
-	const valid = validateInput(input)
-	if (!valid.ok) return valid
-	const file = configPath(projectPath)
-	if (!existsSync(file)) {
-		return { ok: false, reason: 'scenario-bridge.toml does not exist yet; use scaffold to create it first' }
-	}
-	const existing = readFileSync(file, 'utf8')
-	const sep = existing.endsWith('\n') ? '' : '\n'
-	writeFileSync(file, `${existing}${sep}\n${renderBlock(valid)}\n`)
-	const sources = listSources(projectPath)
-	return { ok: true, message: `added a source to ${file}`, sources }
-}
-
-// ── CLI ──
-
-function flag(argv: string[], name: string): string | undefined {
-	const i = argv.indexOf(name)
-	return i === -1 ? undefined : argv[i + 1]
-}
-
-function inputFromArgv(argv: string[]): NewSourceInput {
-	return {
-		adapter: flag(argv, '--adapter'),
-		command: flag(argv, '--command'),
-		reportPath: flag(argv, '--report-path'),
-	}
-}
-
-export function main(argv: string[]): number {
-	const projectPath = flag(argv, '--project-path') ?? '.'
-	const w = (s: string) => process.stdout.write(`${s}\n`)
-
-	if (argv.includes('--list')) {
-		for (const s of listSources(projectPath)) {
-			w(`${s.adapter}${s.command ? ` (${s.command})` : ''} -> ${s.reportPath}`)
-		}
-		return 0
-	}
-	if (argv.includes('--scaffold')) {
-		const r = scaffoldSource(projectPath, inputFromArgv(argv))
-		w(r.ok ? r.message : `refused: ${r.reason}`)
-		return r.ok ? 0 : 1
-	}
-	if (argv.includes('--add')) {
-		const r = addSource(projectPath, inputFromArgv(argv))
-		w(r.ok ? r.message : `refused: ${r.reason}`)
-		return r.ok ? 0 : 1
-	}
-
-	w(
-		'usage: manage-scenario-bridge --project-path <dir> --list | --scaffold --adapter <a> [--command <c>] --report-path <p> | --add --adapter <a> [--command <c>] --report-path <p>',
-	)
-	return 0
-}
-
-if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
-	process.exit(main(process.argv.slice(2)))
-}