focused-spec 0.1.0

package/dist/parser.js

@@ -0,0 +1,64 @@
+const ID = /^- \*\*ID\*\*: `([^`]+)`$/u;
+const EVIDENCE = /^- \*\*EVIDENCE\*\*: `([^`]+)`$/u;
+const WHEN = /^- \*\*WHEN\*\*/u;
+const THEN = /^- \*\*THEN\*\*/u;
+const REQUIREMENT = /^### Requirement: (.+)$/u;
+const SCENARIO = /^#### Scenario: (.+)$/u;
+const MALFORMED_SCENARIO = /^(?:#{1,3}|#{5,}) Scenario:/u;
+const OPERATION = /^## (ADDED|MODIFIED|REMOVED|RENAMED) Requirements$/u;
+export const STABLE_ID = /^[a-z0-9]+(?:[.-][a-z0-9]+)*$/u;
+export function parseFocusedSpecDocument(path, source) {
+    const lines = source.split('\n');
+    const scenarios = [];
+    const malformedScenarioHeadings = [];
+    let operation = 'CURRENT';
+    let requirement;
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? '';
+        const operationMatch = OPERATION.exec(line);
+        if (operationMatch?.[1] !== undefined)
+            operation = operationMatch[1];
+        const requirementMatch = REQUIREMENT.exec(line);
+        if (requirementMatch?.[1] !== undefined)
+            requirement = requirementMatch[1];
+        if (MALFORMED_SCENARIO.test(line))
+            malformedScenarioHeadings.push(index + 1);
+        const scenarioMatch = SCENARIO.exec(line);
+        if (scenarioMatch?.[1] === undefined)
+            continue;
+        const body = [];
+        for (let cursor = index + 1; cursor < lines.length; cursor += 1) {
+            const candidate = lines[cursor] ?? '';
+            if (SCENARIO.test(candidate) || REQUIREMENT.test(candidate) || candidate.startsWith('## '))
+                break;
+            body.push(candidate);
+        }
+        scenarios.push({
+            path,
+            line: index + 1,
+            name: scenarioMatch[1],
+            ...(requirement === undefined ? {} : { requirement }),
+            operation,
+            ids: body.flatMap(value => ID.exec(value)?.[1] ?? []),
+            evidence: body.flatMap(value => EVIDENCE.exec(value)?.[1] ?? []),
+            whenCount: body.filter(value => WHEN.test(value)).length,
+            thenCount: body.filter(value => THEN.test(value)).length,
+        });
+    }
+    return { path, scenarios, malformedScenarioHeadings };
+}
+export function parseEvidenceReference(raw) {
+    const planned = raw.startsWith('planned:');
+    const value = planned ? raw.slice('planned:'.length) : raw;
+    const separator = value.indexOf('::');
+    if (separator <= 0 || separator === value.length - 2) {
+        return { error: 'expected [planned:]<runner-id>::<selector>' };
+    }
+    return {
+        raw,
+        planned,
+        runnerId: value.slice(0, separator),
+        selector: value.slice(separator + 2),
+    };
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"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"}

package/dist/planner.d.ts

@@ -0,0 +1,9 @@
+import type { ExecutionPlan, FocusedSpecConfig, SpecDocument, Violation } from './model.js';
+export interface PlanOptions {
+    readonly scenarioId?: string;
+}
+export interface PlanOutput {
+    readonly plan?: ExecutionPlan;
+    readonly violations: readonly Violation[];
+}
+export declare function planEvidence(projectRoot: string, config: FocusedSpecConfig, documents: readonly SpecDocument[], options?: PlanOptions): Promise<PlanOutput>;

package/dist/planner.js

@@ -0,0 +1,100 @@
+import { parseEvidenceReference } from './parser.js';
+import { resolveRunnerTargets } from './runner-client.js';
+export async function planEvidence(projectRoot, config, documents, options = {}) {
+    const uses = [];
+    const scenarioUses = new Map();
+    for (const document of documents) {
+        for (const scenario of document.scenarios) {
+            const scenarioId = scenario.ids[0];
+            if (scenarioId === undefined || (options.scenarioId !== undefined && scenarioId !== options.scenarioId))
+                continue;
+            const selected = [];
+            for (const raw of scenario.evidence) {
+                const reference = parseEvidenceReference(raw);
+                if ('error' in reference || reference.planned)
+                    continue;
+                const use = { raw, runnerId: reference.runnerId, selector: reference.selector, path: scenario.path, line: scenario.line, scenarioId };
+                uses.push(use);
+                selected.push(use);
+            }
+            if (selected.length > 0)
+                scenarioUses.set(scenarioId, selected);
+        }
+    }
+    if (options.scenarioId !== undefined && !scenarioUses.has(options.scenarioId)) {
+        return { violations: [{ path: options.scenarioId, message: `selected scenario has no executable evidence: ${options.scenarioId}` }] };
+    }
+    const byRunner = new Map();
+    for (const use of uses)
+        byRunner.set(use.runnerId, [...(byRunner.get(use.runnerId) ?? []), use]);
+    const violations = [];
+    const targetsByRunnerSelector = new Map();
+    for (const [runnerId, runnerUses] of [...byRunner].sort(([left], [right]) => left.localeCompare(right))) {
+        const runnerConfig = config.runners[runnerId];
+        if (runnerConfig === undefined)
+            continue;
+        const selectors = [...new Set(runnerUses.map(use => use.selector))].sort();
+        try {
+            const resolved = await resolveRunnerTargets(projectRoot, runnerId, runnerConfig, selectors);
+            for (const error of resolved.errors) {
+                for (const use of runnerUses.filter(candidate => candidate.selector === error.selector)) {
+                    violations.push({ path: use.path, line: use.line, scenarioId: use.scenarioId, message: `unresolved evidence ${use.raw}: ${error.message}` });
+                }
+            }
+            for (const target of resolved.targets) {
+                const references = [...new Set(runnerUses.filter(use => use.selector === target.selector).map(use => use.raw))];
+                const key = `${runnerId}\u0000${target.targetId}`;
+                const prior = targetsByRunnerSelector.get(`${runnerId}\u0000${target.selector}`);
+                if (prior !== undefined && prior.key !== key) {
+                    violations.push({ path: runnerId, message: `runner ${runnerId} resolved selector ${target.selector} inconsistently` });
+                    continue;
+                }
+                targetsByRunnerSelector.set(`${runnerId}\u0000${target.selector}`, {
+                    key,
+                    runnerId,
+                    config: runnerConfig,
+                    target,
+                    references,
+                });
+            }
+        }
+        catch (error) {
+            violations.push({ path: runnerId, message: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    if (violations.length > 0)
+        return { violations };
+    const targetsByKey = new Map();
+    for (const target of targetsByRunnerSelector.values()) {
+        const existing = targetsByKey.get(target.key);
+        if (existing === undefined)
+            targetsByKey.set(target.key, target);
+        else
+            targetsByKey.set(target.key, {
+                ...existing,
+                references: [...new Set([...existing.references, ...target.references])].sort(),
+            });
+    }
+    const scenarios = [];
+    for (const [id, selectedUses] of scenarioUses) {
+        const evidence = selectedUses.map(use => {
+            const target = targetsByRunnerSelector.get(`${use.runnerId}\u0000${use.selector}`);
+            if (target === undefined)
+                throw new Error(`planner lost resolved evidence ${use.raw}`);
+            return { key: target.key, reference: use.raw };
+        });
+        scenarios.push({ id, evidence });
+    }
+    scenarios.sort((left, right) => left.id.localeCompare(right.id));
+    const targets = [...targetsByKey.values()].sort((left, right) => left.key.localeCompare(right.key));
+    const grouped = new Map();
+    for (const target of targets)
+        grouped.set(target.runnerId, [...(grouped.get(target.runnerId) ?? []), target]);
+    const groups = [...grouped].sort(([left], [right]) => left.localeCompare(right)).map(([runnerId, runnerTargets]) => ({
+        runnerId,
+        config: config.runners[runnerId],
+        targets: runnerTargets,
+    }));
+    return { violations: [], plan: { projectRoot, scenarios, targets, groups } };
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAoBzD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,WAAmB,EACnB,MAAyB,EACzB,SAAkC,EAClC,UAAuB,EAAE;IAEzB,MAAM,IAAI,GAAkB,EAAE,CAAA;IAC9B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAA;IACrD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;YAClC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC;gBAAE,SAAQ;YACjH,MAAM,QAAQ,GAAkB,EAAE,CAAA;YAClC,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBACpC,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;gBAC7C,IAAI,OAAO,IAAI,SAAS,IAAI,SAAS,CAAC,OAAO;oBAAE,SAAQ;gBACvD,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,CAAA;gBACrI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACd,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACpB,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;gBAAE,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QACjE,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,iDAAiD,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAA;IACvI,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;IACjD,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IAEhG,MAAM,UAAU,GAAgB,EAAE,CAAA;IAClC,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAyB,CAAA;IAChE,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACxG,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC7C,IAAI,YAAY,KAAK,SAAS;YAAE,SAAQ;QACxC,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAC1E,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC,CAAA;YAC3F,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACpC,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACxF,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,uBAAuB,GAAG,CAAC,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;gBAC9I,CAAC;YACH,CAAC;YACD,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACtC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;gBAC/G,MAAM,GAAG,GAAG,GAAG,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAA;gBACjD,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,CAAC,GAAG,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;gBAChF,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;oBAC7C,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,QAAQ,sBAAsB,MAAM,CAAC,QAAQ,iBAAiB,EAAE,CAAC,CAAA;oBACtH,SAAQ;gBACV,CAAC;gBACD,uBAAuB,CAAC,GAAG,CAAC,GAAG,QAAQ,SAAS,MAAM,CAAC,QAAQ,EAAE,EAAE;oBACjE,GAAG;oBACH,QAAQ;oBACR,MAAM,EAAE,YAAY;oBACpB,MAAM;oBACN,UAAU;iBACX,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACtG,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAA;IAEhD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAA;IACrD,KAAK,MAAM,MAAM,IAAI,uBAAuB,CAAC,MAAM,EAAE,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC7C,IAAI,QAAQ,KAAK,SAAS;YAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;;YAC3D,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE;gBAChC,GAAG,QAAQ;gBACX,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;aAChF,CAAC,CAAA;IACJ,CAAC;IAED,MAAM,SAAS,GAAsB,EAAE,CAAA;IACvC,KAAK,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACtC,MAAM,MAAM,GAAG,uBAAuB,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,SAAS,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;YAClF,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAA;YACtF,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,GAAG,EAAE,CAAA;QAChD,CAAC,CAAC,CAAA;QACF,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IAClC,CAAC;IACD,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;IAEhE,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACnG,MAAM,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAA;IAClD,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7G,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;QACnH,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAA+C;QAC9E,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC,CAAA;IAEH,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAA;AAC9E,CAAC"}

package/dist/runner-api.d.ts

@@ -0,0 +1,50 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | {
+    readonly [key: string]: JsonValue;
+} | readonly JsonValue[];
+export interface RunnerContext {
+    readonly projectRoot: string;
+    readonly cwd: string;
+    readonly runnerId: string;
+    readonly options: JsonValue;
+    readonly signal: AbortSignal;
+}
+export interface ResolveRequest extends RunnerContext {
+    readonly selectors: readonly string[];
+}
+export interface SourceLocation {
+    readonly path: string;
+    readonly line?: number;
+}
+export interface ResolvedTarget {
+    readonly selector: string;
+    readonly targetId: string;
+    readonly displayName: string;
+    readonly source?: SourceLocation;
+    readonly data?: JsonValue;
+}
+export interface ResolveError {
+    readonly selector: string;
+    readonly message: string;
+}
+export interface ResolveResponse {
+    readonly targets: readonly ResolvedTarget[];
+    readonly errors: readonly ResolveError[];
+}
+export interface RunRequest extends RunnerContext {
+    readonly targets: readonly ResolvedTarget[];
+}
+export type TargetStatus = 'pass' | 'fail' | 'skip';
+export interface TargetResult {
+    readonly targetId: string;
+    readonly status: TargetStatus;
+    readonly diagnostic?: string;
+}
+export interface RunResponse {
+    readonly results: readonly TargetResult[];
+}
+export interface RunnerPlugin {
+    readonly apiVersion: 1;
+    resolve(request: ResolveRequest): Promise<ResolveResponse>;
+    run(request: RunRequest): Promise<RunResponse>;
+}

package/dist/runner-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner-api.js.map

package/dist/runner-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-api.js","sourceRoot":"","sources":["../src/runner-api.ts"],"names":[],"mappings":""}

package/dist/runner-client.d.ts

@@ -0,0 +1,4 @@
+import type { RunnerConfig } from './model.js';
+import type { ResolveResponse, ResolvedTarget, RunResponse } from './runner-api.js';
+export declare function resolveRunnerTargets(projectRoot: string, runnerId: string, config: RunnerConfig, selectors: readonly string[]): Promise<ResolveResponse>;
+export declare function runRunnerTargets(projectRoot: string, runnerId: string, config: RunnerConfig, targets: readonly ResolvedTarget[]): Promise<RunResponse>;

package/dist/runner-client.js

@@ -0,0 +1,193 @@
+import { fork } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { access } from 'node:fs/promises';
+import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isJsonValue } from './config.js';
+const DEFAULT_TIMEOUT_MS = 120_000;
+const MODULE_EXTENSIONS = new Set(['.js', '.mjs', '.ts', '.mts']);
+const OUTPUT_LIMIT = 16_384;
+function inside(root, path) {
+    const value = relative(resolve(root), resolve(path));
+    return value === '' || (!value.startsWith(`..${sep}`) && value !== '..' && !isAbsolute(value));
+}
+function text(value) {
+    return typeof value === 'string' && value.length > 0;
+}
+function boundedAppend(current, chunk) {
+    const next = current + String(chunk);
+    return next.length <= OUTPUT_LIMIT ? next : next.slice(next.length - OUTPUT_LIMIT);
+}
+async function runnerPaths(projectRoot, config) {
+    if (isAbsolute(config.module))
+        throw new Error('runner module must be project-relative');
+    const modulePath = resolve(projectRoot, config.module);
+    if (!inside(projectRoot, modulePath))
+        throw new Error('runner module must stay inside project root');
+    if (!MODULE_EXTENSIONS.has(extname(modulePath)))
+        throw new Error('runner module must be .ts, .mts, .js, or .mjs');
+    await access(modulePath);
+    if (config.cwd !== undefined && isAbsolute(config.cwd))
+        throw new Error('runner cwd must be project-relative');
+    const cwd = resolve(projectRoot, config.cwd ?? '.');
+    if (!inside(projectRoot, cwd))
+        throw new Error('runner cwd must stay inside project root');
+    await access(cwd);
+    return { modulePath, cwd };
+}
+async function invokeHost(projectRoot, runnerId, config, payload) {
+    const { modulePath, cwd } = await runnerPaths(projectRoot, config);
+    const compiledHost = fileURLToPath(new URL('./runner-host.js', import.meta.url));
+    const sourceHost = fileURLToPath(new URL('./runner-host.ts', import.meta.url));
+    const hostPath = existsSync(compiledHost) ? compiledHost : sourceHost;
+    const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const child = fork(hostPath, [], {
+        cwd: projectRoot,
+        execArgv: [],
+        stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
+    });
+    const { promise, resolve: resolvePromise, reject: rejectPromise } = Promise.withResolvers();
+    let settled = false;
+    let output = '';
+    child.stdout?.on('data', chunk => { output = boundedAppend(output, chunk); });
+    child.stderr?.on('data', chunk => { output = boundedAppend(output, chunk); });
+    const timer = setTimeout(() => {
+        if (settled)
+            return;
+        settled = true;
+        child.kill('SIGKILL');
+        rejectPromise(new Error(`runner ${runnerId} timed out after ${timeoutMs}ms${output === '' ? '' : `\n${output}`}`));
+    }, timeoutMs + 1_000);
+    child.once('message', message => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        child.kill();
+        const response = message;
+        if (!response.ok) {
+            rejectPromise(new Error(`runner ${runnerId} failed: ${response.error ?? 'unknown error'}${output === '' ? '' : `\n${output}`}`));
+            return;
+        }
+        resolvePromise(response.value);
+    });
+    child.once('error', error => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        rejectPromise(error);
+    });
+    child.once('exit', code => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        rejectPromise(new Error(`runner ${runnerId} exited before responding with code ${String(code)}${output === '' ? '' : `\n${output}`}`));
+    });
+    child.send({
+        ...payload,
+        modulePath,
+        projectRoot,
+        cwd,
+        runnerId,
+        options: config.options ?? null,
+        timeoutMs,
+    });
+    return promise;
+}
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function validateTarget(projectRoot, value) {
+    const target = record(value);
+    if (target === undefined || !text(target.selector) || !text(target.targetId) || !text(target.displayName)) {
+        throw new Error('runner returned an invalid resolved target');
+    }
+    let source;
+    if (target.source !== undefined) {
+        const location = record(target.source);
+        if (location === undefined || !text(location.path) || isAbsolute(location.path))
+            throw new Error('runner returned an invalid source path');
+        const absolute = resolve(projectRoot, location.path);
+        if (!inside(projectRoot, absolute))
+            throw new Error('runner source path must stay inside project root');
+        if (location.line !== undefined && (!Number.isInteger(location.line) || location.line <= 0)) {
+            throw new Error('runner source line must be a positive integer');
+        }
+        source = { path: location.path, ...(location.line === undefined ? {} : { line: location.line }) };
+    }
+    if (target.data !== undefined && !isJsonValue(target.data))
+        throw new Error('runner target data must be JSON-compatible');
+    return {
+        selector: target.selector,
+        targetId: target.targetId,
+        displayName: target.displayName,
+        ...(source === undefined ? {} : { source }),
+        ...(target.data === undefined ? {} : { data: target.data }),
+    };
+}
+export async function resolveRunnerTargets(projectRoot, runnerId, config, selectors) {
+    const value = record(await invokeHost(projectRoot, runnerId, config, { operation: 'resolve', selectors }));
+    if (value === undefined || !Array.isArray(value.targets) || !Array.isArray(value.errors)) {
+        throw new Error(`runner ${runnerId} returned an invalid resolve response`);
+    }
+    const targets = value.targets.map(item => validateTarget(projectRoot, item));
+    const errors = value.errors.map(item => {
+        const error = record(item);
+        if (error === undefined || !text(error.selector) || !text(error.message))
+            throw new Error(`runner ${runnerId} returned an invalid resolve error`);
+        return { selector: error.selector, message: error.message };
+    });
+    const requested = new Set(selectors);
+    const outcomes = new Map();
+    for (const target of targets) {
+        if (!requested.has(target.selector))
+            throw new Error(`runner ${runnerId} returned unknown selector ${target.selector}`);
+        outcomes.set(target.selector, (outcomes.get(target.selector) ?? 0) + 1);
+    }
+    for (const error of errors) {
+        if (!requested.has(error.selector))
+            throw new Error(`runner ${runnerId} returned unknown selector ${error.selector}`);
+        outcomes.set(error.selector, (outcomes.get(error.selector) ?? 0) + 1);
+    }
+    for (const selector of selectors) {
+        const count = outcomes.get(selector) ?? 0;
+        if (count !== 1)
+            throw new Error(`runner ${runnerId} must return exactly one resolution outcome for ${selector}; received ${count}`);
+    }
+    return { targets, errors };
+}
+export async function runRunnerTargets(projectRoot, runnerId, config, targets) {
+    const value = record(await invokeHost(projectRoot, runnerId, config, { operation: 'run', targets }));
+    if (value === undefined || !Array.isArray(value.results))
+        throw new Error(`runner ${runnerId} returned an invalid run response`);
+    const requested = new Set(targets.map(target => target.targetId));
+    const seen = new Set();
+    const results = value.results.map(item => {
+        const result = record(item);
+        if (result === undefined || !text(result.targetId) || (result.status !== 'pass' && result.status !== 'fail' && result.status !== 'skip')) {
+            throw new Error(`runner ${runnerId} returned an invalid target result`);
+        }
+        if (!requested.has(result.targetId))
+            throw new Error(`runner ${runnerId} returned unknown target ${result.targetId}`);
+        if (seen.has(result.targetId))
+            throw new Error(`runner ${runnerId} returned duplicate target ${result.targetId}`);
+        if (result.diagnostic !== undefined && typeof result.diagnostic !== 'string')
+            throw new Error(`runner ${runnerId} returned an invalid diagnostic`);
+        seen.add(result.targetId);
+        return {
+            targetId: result.targetId,
+            status: result.status,
+            ...(result.diagnostic === undefined ? {} : { diagnostic: result.diagnostic }),
+        };
+    });
+    for (const target of targets) {
+        if (!seen.has(target.targetId))
+            throw new Error(`runner ${runnerId} did not return target ${target.targetId}`);
+    }
+    return { results };
+}
+//# sourceMappingURL=runner-client.js.map

package/dist/runner-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-client.js","sourceRoot":"","sources":["../src/runner-client.ts"],"names":[],"mappings":"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"}

package/dist/runner-host.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runner-host.js

@@ -0,0 +1,34 @@
+import { pathToFileURL } from 'node:url';
+let handled = false;
+process.on('message', async (message) => {
+    if (handled)
+        return;
+    handled = true;
+    const request = message;
+    try {
+        // The module path is selected by the repository configuration, so a static import cannot represent it.
+        const loaded = await import(pathToFileURL(request.modulePath).href);
+        const plugin = loaded.default;
+        if (plugin === undefined || plugin.apiVersion !== 1 || typeof plugin.resolve !== 'function' || typeof plugin.run !== 'function') {
+            throw new Error('runner module must default-export a RunnerPlugin with apiVersion 1');
+        }
+        const context = {
+            projectRoot: request.projectRoot,
+            cwd: request.cwd,
+            runnerId: request.runnerId,
+            options: request.options,
+            signal: AbortSignal.timeout(request.timeoutMs),
+        };
+        const value = request.operation === 'resolve'
+            ? await plugin.resolve({ ...context, selectors: request.selectors })
+            : await plugin.run({ ...context, targets: request.targets });
+        process.send?.({ ok: true, value }, () => process.disconnect());
+    }
+    catch (error) {
+        process.send?.({
+            ok: false,
+            error: error instanceof Error ? error.stack ?? error.message : String(error),
+        }, () => process.disconnect());
+    }
+});
+//# sourceMappingURL=runner-host.js.map

package/dist/runner-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner-host.js","sourceRoot":"","sources":["../src/runner-host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AA8BxC,IAAI,OAAO,GAAG,KAAK,CAAA;AACnB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;IACpC,IAAI,OAAO;QAAE,OAAM;IACnB,OAAO,GAAG,IAAI,CAAA;IACd,MAAM,OAAO,GAAG,OAAsB,CAAA;IACtC,IAAI,CAAC;QACH,uGAAuG;QACvG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAA;QACnE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAmC,CAAA;QACzD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;YAChI,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;QACvF,CAAC;QACD,MAAM,OAAO,GAAG;YACd,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;SAC/C,CAAA;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS;YAC3C,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;YACpE,CAAC,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QAC9D,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAyB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACxF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;YACb,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACtD,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IACvD,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/sources.d.ts

@@ -0,0 +1,5 @@
+import type { FocusedSpecConfig, SpecDocument, Violation } from './model.js';
+export declare function loadCurrentDocuments(projectRoot: string, config: FocusedSpecConfig): Promise<SpecDocument[]>;
+export declare function loadChangeDocuments(projectRoot: string, config: FocusedSpecConfig, changeName: string): Promise<SpecDocument[]>;
+export declare function loadActiveChanges(projectRoot: string, config: FocusedSpecConfig): Promise<ReadonlyMap<string, readonly SpecDocument[]>>;
+export declare function validateSourceSelection(config: FocusedSpecConfig, changeName: string | undefined): Violation[];

package/dist/sources.js

@@ -0,0 +1,64 @@
+import { readFile } from 'node:fs/promises';
+import { relative } from 'node:path';
+import fg from 'fast-glob';
+import { parseFocusedSpecDocument } from './parser.js';
+function portable(path) {
+    return path.split('\\').join('/');
+}
+async function documents(projectRoot, patterns) {
+    const paths = await fg([...patterns], {
+        absolute: true,
+        cwd: projectRoot,
+        onlyFiles: true,
+        unique: true,
+    });
+    paths.sort();
+    return Promise.all(paths.map(async (path) => parseFocusedSpecDocument(portable(relative(projectRoot, path)), await readFile(path, 'utf8'))));
+}
+function openSpecRoot(config) {
+    if (config.specifications.source !== 'openspec')
+        throw new Error('OpenSpec source required');
+    return config.specifications.root ?? 'openspec';
+}
+export async function loadCurrentDocuments(projectRoot, config) {
+    if (config.specifications.source === 'files')
+        return documents(projectRoot, config.specifications.paths);
+    return documents(projectRoot, [`${openSpecRoot(config)}/specs/**/spec.md`]);
+}
+export async function loadChangeDocuments(projectRoot, config, changeName) {
+    if (config.specifications.source !== 'openspec')
+        return [];
+    return documents(projectRoot, [`${openSpecRoot(config)}/changes/${changeName}/specs/**/spec.md`]);
+}
+export async function loadActiveChanges(projectRoot, config) {
+    if (config.specifications.source !== 'openspec')
+        return new Map();
+    const root = openSpecRoot(config);
+    const paths = await fg([`${root}/changes/*/specs/**/spec.md`, `!${root}/changes/archive/**`], {
+        absolute: true,
+        cwd: projectRoot,
+        onlyFiles: true,
+        unique: true,
+    });
+    const groups = new Map();
+    for (const path of paths.sort()) {
+        const rel = portable(relative(projectRoot, path));
+        const prefix = `${portable(root)}/changes/`;
+        const changeName = rel.slice(prefix.length).split('/')[0];
+        if (changeName === undefined || changeName === '')
+            continue;
+        groups.set(changeName, [...(groups.get(changeName) ?? []), path]);
+    }
+    const result = new Map();
+    for (const [name, changePaths] of groups) {
+        result.set(name, await Promise.all(changePaths.map(async (path) => parseFocusedSpecDocument(portable(relative(projectRoot, path)), await readFile(path, 'utf8')))));
+    }
+    return result;
+}
+export function validateSourceSelection(config, changeName) {
+    if (changeName !== undefined && config.specifications.source !== 'openspec') {
+        return [{ path: '.focused-spec/config.yaml', message: '--change requires specifications.source: openspec' }];
+    }
+    return [];
+}
+//# sourceMappingURL=sources.js.map

package/dist/sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sources.js","sourceRoot":"","sources":["../src/sources.ts"],"names":[],"mappings":"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"}

package/dist/validate.d.ts

@@ -0,0 +1,19 @@
+import type { FocusedSpecConfig, Scenario, SpecDocument, Violation } from './model.js';
+interface DocumentValidation {
+    readonly violations: readonly Violation[];
+    readonly identifiers: ReadonlyMap<string, Scenario>;
+}
+export declare function validateDocuments(documents: readonly SpecDocument[], config: FocusedSpecConfig, options: {
+    readonly allowPlanned: boolean;
+}): DocumentValidation;
+export interface ValidationOptions {
+    readonly changeName?: string;
+    readonly strict?: boolean;
+}
+export interface ValidationOutput {
+    readonly violations: readonly Violation[];
+    readonly targetDocuments: readonly SpecDocument[];
+    readonly resolutionDocuments: readonly SpecDocument[];
+}
+export declare function validateFocusedSpecs(projectRoot: string, config: FocusedSpecConfig, options?: ValidationOptions): Promise<ValidationOutput>;
+export {};