openplanr 3.1.0 → 3.2.0

package/dist/services/ship-checks/hooks.js

@@ -0,0 +1,65 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const HUSKY_BOILERPLATE = /^\.\s+["']?\$\(\s*dirname\s+(?:--\s+)?["']?\$0["']?\s*\)\/_\/husky\.sh["']?$/u;
+const CONTROL_FLOW = /^(?:if|then|elif|else|fi|for|while|until|do|done|case|esac|function)\b|\(\)\s*\{$/u;
+function logicalLines(source) {
+    const lines = [];
+    let pending = null;
+    source.split(/\r?\n/u).forEach((raw, index) => {
+        const continued = raw.endsWith('\\');
+        const piece = continued ? raw.slice(0, -1) : raw;
+        pending =
+            pending === null
+                ? { text: piece, line: index + 1 }
+                : { ...pending, text: `${pending.text.trimEnd()} ${piece.trim()}` };
+        if (!continued) {
+            lines.push(pending);
+            pending = null;
+        }
+    });
+    if (pending !== null)
+        lines.push(pending);
+    return lines;
+}
+/** Husky hook commands read as shell; a hook with control flow stays one entry. */
+export function readHuskyHook(root, hook) {
+    const file = `.husky/${hook}`;
+    const path = join(root, file);
+    if (!existsSync(path))
+        return [];
+    const commands = logicalLines(readFileSync(path, 'utf8'))
+        .map((entry) => ({ ...entry, text: entry.text.trim() }))
+        .filter(({ text }) => text !== '' && !text.startsWith('#') && !HUSKY_BOILERPLATE.test(text));
+    const entry = (command, line, tags) => ({
+        id: `hook:${hook}:${line}`,
+        command,
+        cwd: '.',
+        sources: [{ kind: 'hook', file, line, hook }],
+        tags: ['hook', ...tags],
+        acceptanceIds: [],
+    });
+    if (commands.some(({ text }) => CONTROL_FLOW.test(text))) {
+        const first = commands[0];
+        return first
+            ? [entry(commands.map(({ text }) => text).join('\n'), first.line, ['multi-line'])]
+            : [];
+    }
+    return commands.map(({ text, line }) => entry(text, line, []));
+}
+/** The pre-commit framework's hooks, run as the framework runs them. */
+export function readPreCommitFramework(root) {
+    const file = '.pre-commit-config.yaml';
+    if (!existsSync(join(root, file)))
+        return [];
+    return [
+        {
+            id: 'hook:pre-commit-framework',
+            command: 'pre-commit run --all-files',
+            cwd: '.',
+            sources: [{ kind: 'hook', file, line: null, hook: 'pre-commit' }],
+            tags: ['hook'],
+            acceptanceIds: [],
+        },
+    ];
+}
+//# sourceMappingURL=hooks.js.map

package/dist/services/ship-checks/hooks.js.map

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

package/dist/services/ship-checks/packages.d.ts

@@ -0,0 +1,29 @@
+import type { PackageScript } from './contract.js';
+export type PackageManifest = {
+    name?: string;
+    main?: unknown;
+    exports?: unknown;
+    bin?: unknown;
+    scripts: Record<string, string>;
+    workspaces: string[];
+};
+export declare class ManifestError extends Error {
+}
+/** Reads `<dir>/package.json`; null when absent, ManifestError when unreadable. */
+export declare function readManifest(dir: string): PackageManifest | null;
+export declare function manifestFrom(value: unknown): PackageManifest;
+/** Repo-relative directory of a workspace given by path or package name, or null. */
+export declare function resolveWorkspace(root: string, workspace: string): string | null;
+export declare function toPosix(path: string): string;
+export declare const PACKAGE_MANAGERS: Set<string>;
+export type ScriptCall = PackageScript & {
+    packageDir: string;
+};
+/**
+ * Parses a command that only calls one package script, or returns null.
+ * Bare `pnpm <name>` and `yarn <name>` count only when the target package defines `<name>`.
+ */
+export declare function parseScriptCall(command: string, cwd: string, root: string): ScriptCall | null;
+/** Whether any command segment calls a `build` or `build:*` script or `tsc --build`. */
+export declare function isBuildCommand(command: string): boolean;
+//# sourceMappingURL=packages.d.ts.map

package/dist/services/ship-checks/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../../src/services/ship-checks/packages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,qBAAa,aAAc,SAAQ,KAAK;CAAG;AAE3C,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAUhE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAsB5D;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU/E;AAcD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,eAAO,MAAM,gBAAgB,aAA0C,CAAC;AAqBxE,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA2C7F;AA6BD,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAWvD"}

package/dist/services/ship-checks/packages.js

@@ -0,0 +1,197 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, posix, relative, resolve } from 'node:path';
+export class ManifestError extends Error {
+}
+/** Reads `<dir>/package.json`; null when absent, ManifestError when unreadable. */
+export function readManifest(dir) {
+    const path = join(dir, 'package.json');
+    if (!existsSync(path))
+        return null;
+    let value;
+    try {
+        value = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (cause) {
+        throw new ManifestError(`${path} is not valid JSON`, { cause });
+    }
+    return manifestFrom(value);
+}
+export function manifestFrom(value) {
+    const record = value !== null && typeof value === 'object' ? value : {};
+    const scripts = {};
+    if (record.scripts !== null && typeof record.scripts === 'object') {
+        for (const [name, body] of Object.entries(record.scripts)) {
+            if (typeof body === 'string')
+                scripts[name] = body;
+        }
+    }
+    const declared = Array.isArray(record.workspaces)
+        ? record.workspaces
+        : record.workspaces?.packages;
+    return {
+        name: typeof record.name === 'string' ? record.name : undefined,
+        main: record.main,
+        exports: record.exports,
+        bin: record.bin,
+        scripts,
+        workspaces: Array.isArray(declared)
+            ? declared.filter((entry) => typeof entry === 'string')
+            : [],
+    };
+}
+/** Repo-relative directory of a workspace given by path or package name, or null. */
+export function resolveWorkspace(root, workspace) {
+    const direct = resolve(root, workspace);
+    if (existsSync(join(direct, 'package.json')))
+        return toPosix(relative(root, direct)) || '.';
+    const rootManifest = readManifest(root);
+    for (const pattern of rootManifest?.workspaces ?? []) {
+        for (const dir of expandWorkspacePattern(root, pattern)) {
+            if (readManifest(resolve(root, dir))?.name === workspace)
+                return dir;
+        }
+    }
+    return null;
+}
+function expandWorkspacePattern(root, pattern) {
+    const clean = pattern.replace(/\/+$/u, '');
+    if (!clean.endsWith('/*'))
+        return [clean];
+    const parent = clean.slice(0, -2);
+    const absolute = resolve(root, parent);
+    if (!existsSync(absolute) || !statSync(absolute).isDirectory())
+        return [];
+    return readdirSync(absolute, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => posix.join(parent, entry.name))
+        .sort();
+}
+export function toPosix(path) {
+    return path.split('\\').join('/');
+}
+export const PACKAGE_MANAGERS = new Set(['npm', 'pnpm', 'yarn', 'bun']);
+const WORKSPACE_FLAGS = new Set(['--workspace', '-w', '--filter', '-F']);
+const SHELL_SYNTAX = /[\n;&|<>$`"'()\\]/u;
+const PNPM_BUILTINS = new Set([
+    'add',
+    'install',
+    'i',
+    'exec',
+    'dlx',
+    'update',
+    'remove',
+    'publish',
+    'pack',
+    'why',
+    'list',
+    'ls',
+    'store',
+    'fetch',
+    'rebuild',
+]);
+/**
+ * Parses a command that only calls one package script, or returns null.
+ * Bare `pnpm <name>` and `yarn <name>` count only when the target package defines `<name>`.
+ */
+export function parseScriptCall(command, cwd, root) {
+    const text = command.trim();
+    if (text === '' || SHELL_SYNTAX.test(text))
+        return null;
+    const [manager, ...rest] = text.split(/\s+/u);
+    if (manager === undefined || !PACKAGE_MANAGERS.has(manager))
+        return null;
+    let workspace = null;
+    const words = [];
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index] ?? '';
+        const [flag, inline] = token.split(/=(.*)/su);
+        if (flag !== undefined && WORKSPACE_FLAGS.has(flag)) {
+            if (workspace !== null)
+                return null;
+            workspace = inline ?? rest[++index] ?? null;
+            if (workspace === null)
+                return null;
+        }
+        else if (token.startsWith('-')) {
+            return null;
+        }
+        else {
+            words.push(token);
+        }
+    }
+    if (manager === 'yarn' && words[0] === 'workspace') {
+        if (workspace !== null || words.length < 3)
+            return null;
+        workspace = words[1] ?? null;
+        words.splice(0, 2);
+    }
+    let name;
+    let bare = false;
+    if (words.length === 2 && (words[0] === 'run' || words[0] === 'run-script'))
+        name = words[1];
+    else if (words.length === 1 && manager === 'npm' && (words[0] === 'test' || words[0] === 't'))
+        name = 'test';
+    else if (words.length === 1 && (manager === 'pnpm' || manager === 'yarn')) {
+        name = words[0];
+        bare = true;
+    }
+    if (name === undefined || (manager === 'pnpm' && PNPM_BUILTINS.has(name)))
+        return null;
+    let packageDir = cwd;
+    if (workspace !== null) {
+        const resolved = resolveWorkspace(resolve(root, cwd), workspace);
+        packageDir = posix.normalize(posix.join(cwd, resolved ?? workspace));
+    }
+    if (bare && readManifestQuietly(resolve(root, packageDir))?.scripts[name] === undefined)
+        return null;
+    return { name, workspace, packageDir };
+}
+function readManifestQuietly(dir) {
+    try {
+        return readManifest(dir);
+    }
+    catch (error) {
+        if (error instanceof ManifestError)
+            return null;
+        throw error;
+    }
+}
+/** The script name a package-manager command segment runs, if any. */
+function scriptNameOf(tokens) {
+    const [manager, ...rest] = tokens;
+    if (manager === undefined || !PACKAGE_MANAGERS.has(manager))
+        return null;
+    const words = [];
+    for (let index = 0; index < rest.length; index += 1) {
+        const token = rest[index] ?? '';
+        if (token === '--')
+            break;
+        if (WORKSPACE_FLAGS.has(token))
+            index += 1;
+        else if (!token.startsWith('-'))
+            words.push(token);
+    }
+    if (manager === 'yarn' && words[0] === 'workspace')
+        words.splice(0, 2);
+    if (words[0] === 'run' || words[0] === 'run-script')
+        return words[1] ?? null;
+    return words[0] ?? null;
+}
+const ENV_ASSIGNMENT = /^[A-Za-z_][A-Za-z0-9_]*=/u;
+/** Whether any command segment calls a `build` or `build:*` script or `tsc --build`. */
+export function isBuildCommand(command) {
+    return command
+        .split(/\n|&&|\|\||;|\|/u)
+        .map((segment) => segment.trim().split(/\s+/u).filter(Boolean))
+        .some((tokens) => {
+        while (tokens[0] !== undefined && ENV_ASSIGNMENT.test(tokens[0]))
+            tokens.shift();
+        if (tokens[0] === 'npx' || tokens[0] === 'bunx')
+            tokens.shift();
+        if (tokens[0] === 'tsc')
+            return tokens.includes('-b') || tokens.includes('--build');
+        const name = scriptNameOf(tokens);
+        return name !== null && /^build(?::|$)/u.test(name);
+    });
+}
+//# sourceMappingURL=packages.js.map

package/dist/services/ship-checks/packages.js.map

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

package/dist/services/ship-checks/related-tests.d.ts

@@ -0,0 +1,13 @@
+import type { RelatedTest, ShipDiagnostic } from './contract.js';
+export declare const isCodeFile: (path: string) => boolean;
+export declare const isTestFile: (path: string) => boolean;
+type Name = {
+    name: string;
+    kind: RelatedTest['kind'];
+};
+/** Exported names, CLI command names and route paths on added lines. */
+export declare function namesFromAddedLines(added: ReadonlyMap<string, readonly string[]>): Name[];
+/** Test files mentioning each name; whole words for identifiers, literal text for routes. */
+export declare function findRelatedTests(root: string, names: readonly Name[], files: readonly string[], diagnostics: ShipDiagnostic[]): RelatedTest[];
+export {};
+//# sourceMappingURL=related-tests.d.ts.map

package/dist/services/ship-checks/related-tests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-tests.d.ts","sourceRoot":"","sources":["../../../src/services/ship-checks/related-tests.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAcjE,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OAAoD,CAAC;AAE/F,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OACmD,CAAC;AAE9F,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAExD,wEAAwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,CAiBzF;AAMD,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,cAAc,EAAE,GAC5B,WAAW,EAAE,CAoCf"}

package/dist/services/ship-checks/related-tests.js

@@ -0,0 +1,73 @@
+import { readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { diagnostic } from './contract.js';
+const CODE_FILE = /\.(?:[cm]?[jt]sx?)$/u;
+const TEST_FILE = /(?:^|\/)(?:tests?|__tests__)\/|\.(?:test|spec)\.[^/]+$/u;
+const EXPORT = /^\s*export\s+(?:default\s+)?(?:declare\s+)?(?:abstract\s+)?(?:async\s+)?(?:function\*?|const|let|var|class|interface|type|enum)\s+([A-Za-z_$][\w$]*)/u;
+const COMMAND = /\.command\(\s*['"`]([a-z][\w:-]*)/gu;
+const ROUTE = /\b[A-Za-z_$][\w$]*\.(?:get|post|put|patch|delete|all)\(\s*['"`](\/[^'"`\s]*)['"`]/gu;
+const MAX_NAMES = 50;
+const MAX_FILES = 20;
+const MAX_TEST_BYTES = 1024 * 1024;
+const MIN_NAME_LENGTH = 4;
+export const isCodeFile = (path) => CODE_FILE.test(path) && !isTestFile(path);
+const TEST_SOURCE = /\.(?:[cm]?[jt]sx?|py|go|rs|rb|java|kt|cs|php|swift)$/u;
+export const isTestFile = (path) => TEST_FILE.test(path) && TEST_SOURCE.test(path) && !path.split('/').includes('node_modules');
+/** Exported names, CLI command names and route paths on added lines. */
+export function namesFromAddedLines(added) {
+    const names = new Map();
+    const add = (name, kind) => {
+        if (name.length >= MIN_NAME_LENGTH && !names.has(`${kind}:${name}`))
+            names.set(`${kind}:${name}`, { name, kind });
+    };
+    for (const lines of added.values()) {
+        for (const line of lines) {
+            const exported = EXPORT.exec(line)?.[1];
+            if (exported)
+                add(exported, 'export');
+            for (const match of line.matchAll(COMMAND))
+                add(match[1] ?? '', 'command');
+            for (const match of line.matchAll(ROUTE))
+                add(match[1] ?? '', 'route');
+        }
+    }
+    return [...names.values()].sort((left, right) => left.name.localeCompare(right.name) || left.kind.localeCompare(right.kind));
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\/]/gu, '\\$&');
+}
+/** Test files mentioning each name; whole words for identifiers, literal text for routes. */
+export function findRelatedTests(root, names, files, diagnostics) {
+    if (names.length === 0)
+        return [];
+    const tests = files.filter(isTestFile).sort();
+    const contents = new Map();
+    for (const path of tests) {
+        const absolute = join(root, path);
+        const stats = statSync(absolute, { throwIfNoEntry: false });
+        if (stats?.isFile() && stats.size <= MAX_TEST_BYTES)
+            contents.set(path, readFileSync(absolute, 'utf8'));
+    }
+    const related = [];
+    let truncated = false;
+    for (const { name, kind } of names) {
+        const pattern = kind === 'route'
+            ? new RegExp(escapeRegExp(name), 'u')
+            : new RegExp(`(?<![\\w$])${escapeRegExp(name)}(?![\\w$])`, 'u');
+        const matches = [...contents].filter(([, text]) => pattern.test(text)).map(([path]) => path);
+        if (matches.length === 0)
+            continue;
+        if (related.length === MAX_NAMES) {
+            truncated = true;
+            break;
+        }
+        if (matches.length > MAX_FILES)
+            truncated = true;
+        related.push({ name, kind, files: matches.slice(0, MAX_FILES) });
+    }
+    if (truncated) {
+        diagnostics.push(diagnostic('RELATED_TESTS_TRUNCATED', 'info', `Related tests are capped at ${MAX_NAMES} names and ${MAX_FILES} files per name.`));
+    }
+    return related;
+}
+//# sourceMappingURL=related-tests.js.map

package/dist/services/ship-checks/related-tests.js.map

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

package/dist/services/ship-checks/scope.d.ts

@@ -0,0 +1,8 @@
+import type { CheckCandidate, ShipCheck } from './contract.js';
+import type { PackageManifest } from './packages.js';
+/**
+ * Classifies a check as tracked-only when the command, its package script body, or a local
+ * script file either of them runs (one level) reads git's tracked or staged files.
+ */
+export declare function classifyScope(root: string, check: CheckCandidate, packageDir: string, manifest: PackageManifest | null): ShipCheck;
+//# sourceMappingURL=scope.d.ts.map

package/dist/services/ship-checks/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/services/ship-checks/scope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAc,SAAS,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA4BrD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,eAAe,GAAG,IAAI,GAC/B,SAAS,CAkBX"}

package/dist/services/ship-checks/scope.js

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { join, posix } from 'node:path';
+const MARKERS = [
+    [/\blint-staged\b/u, 'runs lint-staged, which sees only staged files'],
+    [/\bls-files\b/u, 'reads git ls-files, which lists only tracked files'],
+    [/--cached\b|--staged\b/u, 'reads the git index (--cached or --staged)'],
+];
+const SCRIPT_FILE = /^(?:node|tsx|bash|sh|zsh)$/u;
+const MAX_SCRIPT_BYTES = 1024 * 1024;
+function marker(text) {
+    return MARKERS.find(([pattern]) => pattern.test(text))?.[1] ?? null;
+}
+/** Local script files a command runs directly, as repo-relative paths. */
+function scriptFiles(command, cwd) {
+    const files = [];
+    for (const segment of command.split(/\n|&&|\|\||;|\|/u)) {
+        const tokens = segment.trim().split(/\s+/u);
+        const index = tokens.findIndex((token) => SCRIPT_FILE.test(token));
+        const candidate = index >= 0 ? tokens.slice(index + 1).find((token) => !token.startsWith('-')) : tokens[0];
+        if (candidate && /^\.{0,2}\/?[\w./-]+\.(?:[cm]?[jt]s|sh)$/u.test(candidate))
+            files.push(posix.normalize(posix.join(cwd, candidate)));
+    }
+    return files;
+}
+/**
+ * Classifies a check as tracked-only when the command, its package script body, or a local
+ * script file either of them runs (one level) reads git's tracked or staged files.
+ */
+export function classifyScope(root, check, packageDir, manifest) {
+    const texts = [[check.command, 'the command']];
+    const body = check.script ? manifest?.scripts[check.script.name] : undefined;
+    if (body !== undefined && check.script)
+        texts.push([body, `script "${check.script.name}"`]);
+    for (const [text, origin] of [...texts]) {
+        const base = origin === 'the command' ? check.cwd : packageDir;
+        for (const file of scriptFiles(text, base)) {
+            const path = join(root, file);
+            const stats = existsSync(path) ? statSync(path) : null;
+            if (stats?.isFile() && stats.size <= MAX_SCRIPT_BYTES)
+                texts.push([readFileSync(path, 'utf8'), `${file} (run by ${origin})`]);
+        }
+    }
+    for (const [text, origin] of texts) {
+        const reason = marker(text);
+        if (reason !== null)
+            return withScope(check, 'tracked-only', `${origin} ${reason}`);
+    }
+    return withScope(check, 'worktree');
+}
+function withScope(check, scope, scopeReason) {
+    const { id, command, cwd, sources, tags, script, condition, shell, acceptanceIds } = check;
+    return {
+        id,
+        command,
+        cwd,
+        sources,
+        tags,
+        scope,
+        ...(scopeReason === undefined ? {} : { scopeReason }),
+        ...(script === undefined ? {} : { script }),
+        ...(condition === undefined ? {} : { condition }),
+        ...(shell === undefined ? {} : { shell }),
+        acceptanceIds,
+    };
+}
+//# sourceMappingURL=scope.js.map

package/dist/services/ship-checks/scope.js.map

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

package/dist/services/ship-checks/task-requirements.d.ts

@@ -0,0 +1,14 @@
+import type { CheckCandidate, ShipRequirement } from './contract.js';
+export type TaskRequirements = {
+    checks: CheckCandidate[];
+    requirements: ShipRequirement[];
+    acceptance: string[];
+};
+/** Whether text is a command: its first word, after env and runner prefixes, is a known runner. */
+export declare function isCommand(text: string, bins: ReadonlySet<string>, prose: boolean): boolean;
+/**
+ * Every Test Requirements line yields at least one entry: each command it holds becomes a
+ * check, and any remaining prose becomes a requirement.
+ */
+export declare function readTaskRequirements(root: string, taskFile: string, relativePath: string): TaskRequirements;
+//# sourceMappingURL=task-requirements.d.ts.map

package/dist/services/ship-checks/task-requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-requirements.d.ts","sourceRoot":"","sources":["../../../src/services/ship-checks/task-requirements.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AA4CrE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAeF,mGAAmG;AACnG,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAc1F;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAyDlB"}