@matteeh/osq 0.2.0 → 0.2.2

package/dist/core/trace/scenario-index.js

@@ -0,0 +1,76 @@
+/**
+ * The scenario index: every scenario call, every exported function with its
+ * tags, and every unreadable form, built once from the import graph's files.
+ * Nothing is persisted.
+ */
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+import { scanSource, } from './tag-scan.js';
+function sortedUnique(values) {
+    return [...new Set(values)].sort();
+}
+function testsNaming(calls, capability, name) {
+    return sortedUnique(calls
+        .filter((call) => call.capability === capability && call.name === name)
+        .map((call) => call.file));
+}
+function scenariosInFile(calls, file) {
+    const seen = new Set();
+    const scenarios = [];
+    for (const call of calls) {
+        if (call.file !== file)
+            continue;
+        const key = `${call.capability}\u0000${call.name}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        scenarios.push({ capability: call.capability, name: call.name });
+    }
+    return scenarios.sort((a, b) => a.capability.localeCompare(b.capability) || a.name.localeCompare(b.name));
+}
+function coveringTests(graph, calls, functionFile, name) {
+    return sortedUnique(calls
+        .filter((call) => call.covers === name && graph.importsOf(call.file).includes(functionFile))
+        .map((call) => call.file));
+}
+function covers(graph, calls, testFile, functionFile, name) {
+    if (!graph.importsOf(testFile).includes(functionFile))
+        return false;
+    return calls.some((call) => call.file === testFile && call.covers === name);
+}
+function readSource(projectRoot, file) {
+    try {
+        return readFileSync(path.join(projectRoot, file), 'utf8');
+    }
+    catch {
+        return '';
+    }
+}
+/** Read each of `graph.files` once and index its tags, scenario calls, and unreadable forms. */
+export function buildScenarioIndex(projectRoot, graph) {
+    const files = [...graph.files];
+    const functions = [];
+    const calls = [];
+    const unreadable = [];
+    const scenarioTestFiles = [];
+    for (const file of files) {
+        const scan = scanSource(file, readSource(projectRoot, file));
+        functions.push(...scan.functions);
+        calls.push(...scan.calls);
+        unreadable.push(...scan.unreadable);
+        if (scan.scenarioTestFile)
+            scenarioTestFiles.push(file);
+    }
+    return {
+        files,
+        scenarioTestFiles,
+        functions,
+        calls,
+        unreadable,
+        testsNaming: (capability, name) => testsNaming(calls, capability, name),
+        scenariosInFile: (file) => scenariosInFile(calls, file),
+        coveringTests: (functionFile, name) => coveringTests(graph, calls, functionFile, name),
+        covers: (testFile, functionFile, name) => covers(graph, calls, testFile, functionFile, name),
+    };
+}
+//# sourceMappingURL=scenario-index.js.map

package/dist/core/trace/scenario-index.js.map

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

package/dist/core/trace/scenario-lookup.d.ts

@@ -0,0 +1,14 @@
+import { type DeltaScenario, type ScenarioOutcome } from '../spec/delta.js';
+/** Drop every cached spec and reset the read counter. */
+export declare function clearScenarioLookupCache(): void;
+/** How many spec files have been read since the last cache clear. */
+export declare function scenarioSpecReadCount(): number;
+/** Every scenario of one capability's effective spec, for lint. */
+export declare function effectiveScenarios(openspecRoot: string, changeFolder: string | null, capability: string): readonly DeltaScenario[];
+/**
+ * The outcomes of one scenario, looked up by capability and exact name. Throws
+ * with the exact message when the scenario is missing, duplicated, defined in
+ * disagreeing places, or its delta cannot be merged.
+ */
+export declare function lookupScenario(capability: string, name: string, cwd: string, env: Record<string, string | undefined>): readonly ScenarioOutcome[];
+//# sourceMappingURL=scenario-lookup.d.ts.map

package/dist/core/trace/scenario-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario-lookup.d.ts","sourceRoot":"","sources":["../../../src/core/trace/scenario-lookup.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EAIrB,MAAM,kBAAkB,CAAC;AA6B1B,yDAAyD;AACzD,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAmGD,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,UAAU,EAAE,MAAM,GACjB,SAAS,aAAa,EAAE,CAI1B;AAiED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,SAAS,eAAe,EAAE,CAgB5B"}

package/dist/core/trace/scenario-lookup.js

@@ -0,0 +1,179 @@
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { mergeDelta, parseCapabilitySpec, parseDelta, } from '../spec/delta.js';
+import { isActiveChangeFolderName } from '../status/layout.js';
+const placesCache = new Map();
+let specReads = 0;
+/** Drop every cached spec and reset the read counter. */
+export function clearScenarioLookupCache() {
+    placesCache.clear();
+    specReads = 0;
+}
+/** How many spec files have been read since the last cache clear. */
+export function scenarioSpecReadCount() {
+    return specReads;
+}
+function specFilePath(openspecRoot, capability) {
+    return path.join(openspecRoot, 'specs', capability, 'spec.md');
+}
+function deltaFilePath(changeFolder, capability) {
+    return path.join(changeFolder, 'specs', capability, 'spec.md');
+}
+function relativeToHolder(openspecRoot, filePath) {
+    return path.relative(path.dirname(openspecRoot), filePath);
+}
+function readSpec(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    specReads++;
+    return readFileSync(filePath, 'utf8');
+}
+function scenarioList(spec) {
+    return spec.requirements.flatMap((requirement) => requirement.scenarios);
+}
+/** The living spec as a place list: one entry, or none when it is absent. */
+function livingPlaces(openspecRoot, capability, content) {
+    if (content === null)
+        return [];
+    return [
+        {
+            relativePath: relativeToHolder(openspecRoot, specFilePath(openspecRoot, capability)),
+            scenarios: scenarioList(parseCapabilitySpec(content)),
+        },
+    ];
+}
+/** The living spec merged with one change's delta, when the delta exists. */
+function loadEffectivePlaces(openspecRoot, changeFolder, capability) {
+    const living = readSpec(specFilePath(openspecRoot, capability));
+    if (changeFolder === null)
+        return livingPlaces(openspecRoot, capability, living);
+    const deltaRaw = readSpec(deltaFilePath(changeFolder, capability));
+    if (deltaRaw === null)
+        return livingPlaces(openspecRoot, capability, living);
+    const merged = mergeDelta(living, capability, parseDelta(deltaRaw));
+    return livingPlaces(openspecRoot, capability, merged);
+}
+/** The living spec plus every active change's ADDED/MODIFIED requirements. */
+function loadAllPlaces(openspecRoot, capability) {
+    const places = livingPlaces(openspecRoot, capability, readSpec(specFilePath(openspecRoot, capability)));
+    const changesDir = path.join(openspecRoot, 'changes');
+    if (!existsSync(changesDir))
+        return places;
+    const names = readdirSync(changesDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && isActiveChangeFolderName(entry.name))
+        .map((entry) => entry.name)
+        .sort();
+    for (const name of names) {
+        const filePath = deltaFilePath(path.join(changesDir, name), capability);
+        const raw = readSpec(filePath);
+        if (raw === null)
+            continue;
+        const delta = parseDelta(raw);
+        const relativePath = relativeToHolder(openspecRoot, filePath);
+        for (const requirement of [...delta.added, ...delta.modified]) {
+            if (requirement.scenarios.length > 0) {
+                places.push({ relativePath, scenarios: requirement.scenarios });
+            }
+        }
+    }
+    return places;
+}
+function cachedPlaces(key, produce) {
+    const cached = placesCache.get(key);
+    if (cached !== undefined)
+        return cached;
+    const places = produce();
+    placesCache.set(key, places);
+    return places;
+}
+function effectivePlaces(openspecRoot, changeFolder, capability) {
+    const key = `effective\u0000${openspecRoot}\u0000${changeFolder ?? ''}\u0000${capability}`;
+    return cachedPlaces(key, () => loadEffectivePlaces(openspecRoot, changeFolder, capability));
+}
+function allPlaces(openspecRoot, capability) {
+    const key = `all\u0000${openspecRoot}\u0000\u0000${capability}`;
+    return cachedPlaces(key, () => loadAllPlaces(openspecRoot, capability));
+}
+/** Every scenario of one capability's effective spec, for lint. */
+export function effectiveScenarios(openspecRoot, changeFolder, capability) {
+    const root = path.resolve(openspecRoot);
+    const folder = changeFolder === null ? null : path.resolve(changeFolder);
+    return effectivePlaces(root, folder, capability).flatMap((place) => place.scenarios);
+}
+/** The first scenario name that repeats, in document order, or null. */
+function duplicateScenarioName(places) {
+    for (const place of places) {
+        const seen = new Set();
+        for (const scenario of place.scenarios) {
+            if (seen.has(scenario.name))
+                return scenario.name;
+            seen.add(scenario.name);
+        }
+    }
+    return null;
+}
+function definitionsOf(places, name) {
+    const definitions = [];
+    for (const place of places) {
+        for (const scenario of place.scenarios) {
+            if (scenario.name === name)
+                definitions.push({ place, outcomes: scenario.outcomes });
+        }
+    }
+    return definitions;
+}
+function sameOutcomes(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+function resolveDefinitions(capability, name, definitions) {
+    const first = definitions[0];
+    const conflict = definitions
+        .slice(1)
+        .find((definition) => !sameOutcomes(first.outcomes, definition.outcomes));
+    if (conflict === undefined)
+        return first.outcomes;
+    throw new Error(`The ${capability} scenario "${name}" differs between ${first.place.relativePath} and ` +
+        `${conflict.place.relativePath}; set OSQ_CHANGE to the change folder the test should prove`);
+}
+/** The nearest ancestor of `cwd`, included, that holds `openspec/specs`. */
+function findOpenspecRoot(cwd) {
+    const start = path.resolve(cwd);
+    let dir = start;
+    for (;;) {
+        if (existsSync(path.join(dir, 'openspec', 'specs')))
+            return path.join(dir, 'openspec');
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return path.join(start, 'openspec');
+        dir = parent;
+    }
+}
+function resolveLocation(cwd, env) {
+    const raw = env.OSQ_CHANGE?.trim();
+    if (raw) {
+        const changeFolder = path.resolve(cwd, raw);
+        return { openspecRoot: path.dirname(path.dirname(changeFolder)), changeFolder };
+    }
+    return { openspecRoot: findOpenspecRoot(cwd), changeFolder: null };
+}
+/**
+ * The outcomes of one scenario, looked up by capability and exact name. Throws
+ * with the exact message when the scenario is missing, duplicated, defined in
+ * disagreeing places, or its delta cannot be merged.
+ */
+export function lookupScenario(capability, name, cwd, env) {
+    const location = resolveLocation(cwd, env);
+    const places = location.changeFolder === null
+        ? allPlaces(location.openspecRoot, capability)
+        : effectivePlaces(location.openspecRoot, location.changeFolder, capability);
+    const duplicate = duplicateScenarioName(places);
+    if (duplicate !== null) {
+        throw new Error(`The ${capability} spec has two scenarios named "${duplicate}"`);
+    }
+    const definitions = definitionsOf(places, name);
+    if (definitions.length === 0) {
+        throw new Error(`The ${capability} spec has no scenario "${name}"`);
+    }
+    return resolveDefinitions(capability, name, definitions);
+}
+//# sourceMappingURL=scenario-lookup.js.map

package/dist/core/trace/scenario-lookup.js.map

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

package/dist/core/trace/tag-scan.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The tag and scenario call scanner. It reads one file's text with regular
+ * expressions over lines, never a TypeScript parser, which would be a fifth
+ * runtime dependency.
+ */
+/** One scenario a function serves, from a `@scenario` tag. */
+export interface TaggedScenario {
+    readonly capability: string;
+    readonly name: string;
+}
+/** One exported function the scanner reads, with its tags. */
+export interface ScannedFunction {
+    readonly file: string;
+    readonly line: number;
+    readonly name: string;
+    readonly scenarios: readonly TaggedScenario[];
+    readonly adrs: readonly string[];
+}
+/** One readable `scenario(...)` call in a scenario test file. */
+export interface ScenarioCall {
+    readonly file: string;
+    readonly line: number;
+    readonly capability: string;
+    readonly name: string;
+    readonly covers: string;
+}
+/** A tag or scenario call the scanner cannot read, with its 1-based line. */
+export interface UnreadableForm {
+    readonly file: string;
+    readonly line: number;
+    readonly reason: string;
+    /** The call's literal capability, present only when that much was readable. */
+    readonly capability?: string;
+}
+/** Everything one source file yields. */
+export interface TagScan {
+    readonly scenarioTestFile: boolean;
+    readonly functions: readonly ScannedFunction[];
+    readonly calls: readonly ScenarioCall[];
+    readonly unreadable: readonly UnreadableForm[];
+}
+/** Scan one file's text for exported functions with tags, scenario calls, and unreadable forms. */
+export declare function scanSource(file: string, text: string): TagScan;
+//# sourceMappingURL=tag-scan.d.ts.map

package/dist/core/trace/tag-scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-scan.d.ts","sourceRoot":"","sources":["../../../src/core/trace/tag-scan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,yCAAyC;AACzC,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AAkMD,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ9D"}

package/dist/core/trace/tag-scan.js

@@ -0,0 +1,200 @@
+/**
+ * The tag and scenario call scanner. It reads one file's text with regular
+ * expressions over lines, never a TypeScript parser, which would be a fifth
+ * runtime dependency.
+ */
+const UNATTACHED = 'tag is not attached to an exported function';
+const BAD_TAG = 'tag is not a valid @scenario or @adr';
+const BAD_SCENARIO = '@scenario is not "<capability>: <name>"';
+const BAD_ADR = '@adr has no digits';
+const BAD_CAPABILITY = 'scenario call capability is not a literal';
+const BAD_NAME = 'scenario call name is not a literal';
+const BAD_COVERS = 'scenario call covers is not an identifier';
+const ALIASED_IMPORT = 'scenario is imported under another name';
+const FUNCTION_DECL = /^\s*export\s+(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/;
+const CONST_DECL = /^\s*export\s+const\s+([A-Za-z_$][\w$]*)(?::(?:=>|[^=])*)?\s*=\s*(?:async\s*)?(?:function\b|(?:\([^)]*\)|[A-Za-z_$][\w$]*)\s*=>)/;
+/** The exported function a declaration line names, or null. */
+function declarationName(line) {
+    if (line === undefined)
+        return null;
+    return (FUNCTION_DECL.exec(line) ?? CONST_DECL.exec(line))?.[1] ?? null;
+}
+/** True when a trimmed comment line holds a tag. */
+function isTagLike(trimmed) {
+    const comment = trimmed.startsWith('*') || trimmed.startsWith('//') || trimmed.startsWith('/*');
+    return comment && (trimmed.includes('@scenario') || trimmed.includes('@adr'));
+}
+/** A comment line's text with its markers stripped. */
+function cleanTagText(trimmed) {
+    return trimmed
+        .replace(/^(?:\/\*+|\/\/|\*+)/, '')
+        .replace(/\*\/\s*$/, '')
+        .trim();
+}
+/** One `@scenario` or `@adr` line, or how it is unreadable. */
+function parseTag(text) {
+    if (text.startsWith('@scenario')) {
+        const rest = text.slice('@scenario'.length).trim();
+        const colon = rest.indexOf(':');
+        const capability = colon === -1 ? '' : rest.slice(0, colon).trim();
+        const name = colon === -1 ? '' : rest.slice(colon + 1).trim();
+        if (capability === '' || name === '')
+            return { kind: 'bad', reason: BAD_SCENARIO };
+        return { kind: 'scenario', capability, name };
+    }
+    if (text.startsWith('@adr')) {
+        const rest = text.slice('@adr'.length).trim();
+        if (!/^\d+$/.test(rest))
+            return { kind: 'bad', reason: BAD_ADR };
+        return { kind: 'adr', number: rest };
+    }
+    return { kind: 'bad', reason: BAD_TAG };
+}
+/** Read every comment, attaching tags to the declaration below a doc comment. */
+function collectTags(file, text, unreadable) {
+    const lines = text.split('\n');
+    const tags = new Map();
+    let block = null;
+    for (let index = 0; index < lines.length; index += 1) {
+        const trimmed = (lines[index] ?? '').trim();
+        if (block === null) {
+            if (trimmed.startsWith('/**'))
+                block = { kind: 'doc', tagLines: [] };
+            else if (trimmed.startsWith('/*'))
+                block = { kind: 'plain', tagLines: [] };
+            else if (trimmed.startsWith('//')) {
+                if (isTagLike(trimmed)) {
+                    unreadable.push(unreadableForm(file, index + 1, parseTag(cleanTagText(trimmed))));
+                }
+                continue;
+            }
+            else
+                continue;
+        }
+        if (isTagLike(trimmed))
+            block.tagLines.push({ line: index + 1, text: trimmed });
+        if (!trimmed.includes('*/'))
+            continue;
+        const attached = block.kind === 'doc' && declarationName(lines[index + 1]) !== null;
+        const accumulator = tags.get(index + 2) ?? { scenarios: [], adrs: [] };
+        for (const tagLine of block.tagLines) {
+            const tag = parseTag(cleanTagText(tagLine.text));
+            if (attached && tag.kind === 'scenario') {
+                accumulator.scenarios.push({ capability: tag.capability, name: tag.name });
+            }
+            else if (attached && tag.kind === 'adr') {
+                accumulator.adrs.push(tag.number);
+            }
+            else {
+                unreadable.push(unreadableForm(file, tagLine.line, tag));
+            }
+        }
+        if (attached)
+            tags.set(index + 2, accumulator);
+        block = null;
+    }
+    return tags;
+}
+/** A tag line's unreadable form. */
+function unreadableForm(file, line, tag) {
+    return { file, line, reason: tag.kind === 'bad' ? tag.reason : UNATTACHED };
+}
+/** Every exported function in the documented forms, with the tags attached to it. */
+function scanFunctions(file, text, tags) {
+    const functions = [];
+    const lines = text.split('\n');
+    for (let index = 0; index < lines.length; index += 1) {
+        const name = declarationName(lines[index]);
+        if (name === null)
+            continue;
+        const attached = tags.get(index + 1);
+        functions.push({
+            file,
+            line: index + 1,
+            name,
+            scenarios: attached?.scenarios ?? [],
+            adrs: attached?.adrs ?? [],
+        });
+    }
+    return functions;
+}
+/** The 1-based line of a character offset. */
+function lineOf(text, index) {
+    let line = 1;
+    for (let position = 0; position < index && position < text.length; position += 1) {
+        if (text[position] === '\n')
+            line += 1;
+    }
+    return line;
+}
+const CALL_START = /\bscenario\s*\(/g;
+const READABLE_CALL = /\bscenario\s*\(\s*(['"])((?:[^\\])*?)\1\s*,\s*(['"])((?:[^\\])*?)\3\s*,\s*\{\s*covers\s*:\s*([A-Za-z_$][\w$]*)\s*(?:\}|,)/g;
+const COVERS = /^\s*\{\s*covers\s*:\s*([A-Za-z_$][\w$]*)\s*(?:\}|,)/;
+/** Why a `scenario(` call could not be read, naming the argument that isn't a literal. */
+function callReason(text, start) {
+    const after = text.slice(start);
+    const first = /^\s*(['"])((?:[^\\])*?)\1\s*,\s*/.exec(after);
+    if (first === null)
+        return BAD_CAPABILITY;
+    const rest = after.slice(first[0].length);
+    const second = /^\s*(['"])((?:[^\\])*?)\1\s*,\s*/.exec(rest);
+    if (second === null)
+        return BAD_NAME;
+    return COVERS.test(rest.slice(second[0].length)) ? BAD_TAG : BAD_COVERS;
+}
+/** Read every `scenario(` call, recording the unreadable ones. */
+function scanScenarioCalls(file, text, calls, unreadable) {
+    const readable = new Set();
+    for (const match of text.matchAll(READABLE_CALL)) {
+        const index = match.index ?? 0;
+        readable.add(index);
+        calls.push({
+            file,
+            line: lineOf(text, index),
+            capability: match[2] ?? '',
+            name: match[4] ?? '',
+            covers: match[5] ?? '',
+        });
+    }
+    for (const match of text.matchAll(CALL_START)) {
+        const index = match.index ?? 0;
+        if (readable.has(index))
+            continue;
+        const start = index + match[0].length;
+        const capability = /^\s*(['"])((?:[^\\])*?)\1/.exec(text.slice(start))?.[2];
+        unreadable.push({
+            file,
+            line: lineOf(text, index),
+            reason: callReason(text, start),
+            capability: capability ?? undefined,
+        });
+    }
+}
+const TESTING_IMPORT = /(?:from\s*|require\s*\(\s*|import\s*\(\s*)['"]@matteeh\/osq\/testing['"]/;
+const NAMED_TESTING_IMPORT = /import\s*\{([^}]*)\}\s*from\s*['"]@matteeh\/osq\/testing['"]/g;
+/** True when the file imports the testing helper; record an aliased `scenario` import. */
+function scanTestingImport(file, text, unreadable) {
+    if (!TESTING_IMPORT.test(text))
+        return false;
+    for (const match of text.matchAll(NAMED_TESTING_IMPORT)) {
+        for (const part of (match[1] ?? '').split(',')) {
+            const alias = /^\s*scenario\s+as\s+([A-Za-z_$][\w$]*)\s*$/.exec(part);
+            if (alias !== null && alias[1] !== 'scenario') {
+                unreadable.push({ file, line: lineOf(text, match.index ?? 0), reason: ALIASED_IMPORT });
+            }
+        }
+    }
+    return true;
+}
+/** Scan one file's text for exported functions with tags, scenario calls, and unreadable forms. */
+export function scanSource(file, text) {
+    const calls = [];
+    const unreadable = [];
+    const scenarioTestFile = scanTestingImport(file, text, unreadable);
+    const tags = collectTags(file, text, unreadable);
+    const functions = scanFunctions(file, text, tags);
+    if (scenarioTestFile)
+        scanScenarioCalls(file, text, calls, unreadable);
+    return { scenarioTestFile, functions, calls, unreadable };
+}
+//# sourceMappingURL=tag-scan.js.map

package/dist/core/trace/tag-scan.js.map

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

package/dist/core/vcs/doctor-git.d.ts

@@ -0,0 +1,13 @@
+import type { OsqConfig } from '../foundation/config.js';
+import type { DoctorCheckResult } from '../foundation/doctor.js';
+export interface DoctorGitOptions {
+    /** Override the git binary; tests use an absent path for the missing case. */
+    readonly gitBinary?: string;
+}
+/**
+ * The `git` doctor check, the version-control warnings, and, when a
+ * redirecting variable is set, the `git-env` warning. All pass with a warning
+ * and never change doctor's exit code.
+ */
+export declare function checkGit(projectRoot: string, config: OsqConfig, options?: DoctorGitOptions): Promise<DoctorCheckResult[]>;
+//# sourceMappingURL=doctor-git.d.ts.map

package/dist/core/vcs/doctor-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-git.d.ts","sourceRoot":"","sources":["../../../src/core/vcs/doctor-git.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAuBjE,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAkGD;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAW9B"}