openplanr 3.1.1 → 3.2.0

package/dist/services/ship-checks/task-requirements.js

@@ -0,0 +1,145 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const RUNNERS = new Set([
+    'npm',
+    'npx',
+    'pnpm',
+    'yarn',
+    'bun',
+    'bunx',
+    'node',
+    'deno',
+    'tsx',
+    'tsc',
+    'vitest',
+    'jest',
+    'playwright',
+    'biome',
+    'eslint',
+    'prettier',
+    'cargo',
+    'go',
+    'make',
+    'just',
+    'pytest',
+    'python',
+    'python3',
+    'dotnet',
+    'mvn',
+    'gradle',
+    './gradlew',
+    'pre-commit',
+]);
+// Runner names that are also common English words never count on a bare prose line.
+const AMBIGUOUS = new Set(['make', 'go', 'just', 'node', 'python', 'python3']);
+const PREFIXES = [
+    ['pnpm', 'exec'],
+    ['pnpm', 'dlx'],
+    ['bun', 'x'],
+    ['npx'],
+    ['bunx'],
+];
+const ACCEPTANCE = /\b(?:[A-Z][A-Z0-9]*-\d+\.)?AC-\d+\b/gu;
+const ENV_ASSIGNMENT = /^[A-Za-z_][A-Za-z0-9_]*=\S*$/u;
+function section(markdown, heading) {
+    const lines = markdown.split(/\r?\n/u);
+    const start = lines.findIndex((line) => line.trim() === `## ${heading}`);
+    if (start < 0)
+        return null;
+    const end = lines.findIndex((line, index) => index > start && /^##?\s/u.test(line));
+    return { body: lines.slice(start + 1, end < 0 ? undefined : end).join('\n'), line: start + 2 };
+}
+function binaries(root) {
+    const dir = join(root, 'node_modules/.bin');
+    return existsSync(dir) ? new Set(readdirSync(dir)) : new Set();
+}
+/** Whether text is a command: its first word, after env and runner prefixes, is a known runner. */
+export function isCommand(text, bins, prose) {
+    const tokens = text.trim().split(/\s+/u).filter(Boolean);
+    while (tokens[0] !== undefined && ENV_ASSIGNMENT.test(tokens[0]))
+        tokens.shift();
+    for (const prefix of PREFIXES) {
+        if (prefix.every((word, index) => tokens[index] === word) && tokens.length > prefix.length) {
+            tokens.splice(0, prefix.length);
+            while (tokens[0]?.startsWith('-'))
+                tokens.shift();
+            break;
+        }
+    }
+    const head = tokens[0];
+    if (head === undefined)
+        return false;
+    if (prose && AMBIGUOUS.has(head))
+        return false;
+    return RUNNERS.has(head) || bins.has(head);
+}
+const LIST_MARKER = /^(?:[-*+]|\d+[.)])\s+(?:\[[ xX]\]\s+)?/u;
+/**
+ * Every Test Requirements line yields at least one entry: each command it holds becomes a
+ * check, and any remaining prose becomes a requirement.
+ */
+export function readTaskRequirements(root, taskFile, relativePath) {
+    const markdown = readFileSync(taskFile, 'utf8');
+    const found = section(markdown, 'Test Requirements');
+    const result = { checks: [], requirements: [], acceptance: [] };
+    if (found === null)
+        return result;
+    const bins = binaries(root);
+    const acceptance = new Set();
+    let fenced = false;
+    found.body.split('\n').forEach((raw, index) => {
+        const line = found.line + index;
+        const trimmed = raw.trim();
+        if (/^(?:```|~~~)/u.test(trimmed)) {
+            fenced = !fenced;
+            return;
+        }
+        if (trimmed === '')
+            return;
+        const ids = [...new Set(trimmed.match(ACCEPTANCE) ?? [])];
+        for (const id of ids)
+            acceptance.add(id);
+        const commands = [];
+        let prose = trimmed.replace(LIST_MARKER, '');
+        if (fenced) {
+            if (!trimmed.startsWith('#'))
+                commands.push(trimmed);
+            prose = '';
+        }
+        else {
+            prose = prose.replace(/`([^`\n]+)`/gu, (whole, span) => {
+                if (!isCommand(span, bins, false))
+                    return whole;
+                commands.push(span.trim());
+                return '';
+            });
+            if (commands.length === 0 && isCommand(prose, bins, true) && !/[.:]$/u.test(prose)) {
+                commands.push(prose);
+                prose = '';
+            }
+        }
+        commands.forEach((command, position) => {
+            result.checks.push({
+                id: `task:${line}${commands.length > 1 ? `:${position + 1}` : ''}`,
+                command,
+                cwd: '.',
+                sources: [{ kind: 'task', file: relativePath, line }],
+                tags: ['task'],
+                acceptanceIds: ids,
+            });
+        });
+        const remaining = prose
+            .replace(ACCEPTANCE, '')
+            .replace(/[\s:;,.()\-–—]+/gu, ' ')
+            .trim();
+        if (remaining !== '')
+            result.requirements.push({
+                kind: 'prose',
+                text: trimmed.replace(LIST_MARKER, ''),
+                acceptanceIds: ids,
+            });
+    });
+    result.acceptance = [...acceptance];
+    return result;
+}
+//# sourceMappingURL=task-requirements.js.map

package/dist/services/ship-checks/task-requirements.js.map

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

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

@@ -0,0 +1,21 @@
+import type { CheckCandidate, ShipDiagnostic } from './contract.js';
+export type WorkflowTriggers = {
+    pullRequest: boolean;
+    mergeGroup: boolean;
+    push: boolean;
+    pullRequestPaths: string[] | null;
+    pullRequestPathsIgnore: string[] | null;
+    names: string[];
+};
+export type ParsedWorkflow = {
+    file: string;
+    triggers: WorkflowTriggers;
+    checks: CheckCandidate[];
+    /** Diagnostics that apply only when a tier includes this workflow. */
+    notes: ShipDiagnostic[];
+};
+/** Whether the workflow's pull-request-side triggers fire for the changed paths. */
+export declare function firesForChange(triggers: WorkflowTriggers, paths: readonly string[]): boolean;
+/** Parses every GitHub Actions workflow; invalid files become error diagnostics. */
+export declare function readWorkflows(root: string, diagnostics: ShipDiagnostic[]): ParsedWorkflow[];
+//# sourceMappingURL=workflows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/services/ship-checks/workflows.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,sBAAsB,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,sEAAsE;IACtE,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAyCF,oFAAoF;AACpF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAY5F;AAgKD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAuB3F"}

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

@@ -0,0 +1,208 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { basename, join, posix } from 'node:path';
+import { isMap, isScalar, LineCounter, parseDocument } from 'yaml';
+import { diagnostic } from './contract.js';
+import { matchesFilterList } from './glob.js';
+const WORKFLOW_DIR = '.github/workflows';
+const INSTALL = /^(?:npm (?:ci|install|i)|yarn|yarn install(?: .*)?|pnpm (?:install|i)(?: .*)?|bun install(?: .*)?)$/u;
+const MATRIX_REF = /\$\{\{\s*matrix\.([\w-]+)\s*\}\}/gu;
+const OTHER_CI_FILES = [
+    '.gitlab-ci.yml',
+    '.circleci/config.yml',
+    'azure-pipelines.yml',
+    'Jenkinsfile',
+    '.travis.yml',
+    'bitbucket-pipelines.yml',
+];
+const record = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+const text = (value) => typeof value === 'string'
+    ? value
+    : typeof value === 'number' || typeof value === 'boolean'
+        ? String(value)
+        : undefined;
+const stringList = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : null;
+function readTriggers(on) {
+    const names = typeof on === 'string' ? [on] : Array.isArray(on) ? on.map(String) : Object.keys(record(on));
+    const pullRequest = record(record(on).pull_request);
+    return {
+        pullRequest: names.includes('pull_request'),
+        mergeGroup: names.includes('merge_group'),
+        push: names.includes('push'),
+        pullRequestPaths: stringList(pullRequest.paths),
+        pullRequestPathsIgnore: stringList(pullRequest['paths-ignore']),
+        names: [...names].sort(),
+    };
+}
+/** Whether the workflow's pull-request-side triggers fire for the changed paths. */
+export function firesForChange(triggers, paths) {
+    if (triggers.mergeGroup)
+        return true;
+    if (!triggers.pullRequest)
+        return false;
+    if (triggers.pullRequestPaths !== null) {
+        const include = triggers.pullRequestPaths;
+        return paths.some((path) => matchesFilterList(path, include));
+    }
+    if (triggers.pullRequestPathsIgnore !== null) {
+        const ignore = triggers.pullRequestPathsIgnore;
+        return paths.some((path) => !matchesFilterList(path, ignore));
+    }
+    return true;
+}
+/** Static matrix combinations for the referenced keys, or null when they cannot be derived. */
+function matrixCombinations(strategy, keys) {
+    if (keys.length === 0)
+        return [{}];
+    const matrix = record(record(strategy).matrix);
+    const axes = Object.keys(matrix).filter((key) => key !== 'include' && key !== 'exclude');
+    const include = matrix.include;
+    if (matrix.exclude !== undefined)
+        return null;
+    if (include !== undefined && axes.length > 0)
+        return null;
+    if (include !== undefined) {
+        if (!Array.isArray(include))
+            return null;
+        const seen = new Set();
+        const combinations = [];
+        for (const entry of include) {
+            const values = record(entry);
+            const combination = {};
+            for (const key of keys) {
+                const value = text(values[key]);
+                if (value === undefined)
+                    return null;
+                combination[key] = value;
+            }
+            const id = JSON.stringify(combination);
+            if (!seen.has(id)) {
+                seen.add(id);
+                combinations.push(combination);
+            }
+        }
+        return combinations;
+    }
+    let combinations = [{}];
+    for (const key of keys) {
+        const values = matrix[key];
+        if (!Array.isArray(values))
+            return null;
+        const scalars = values.map(text);
+        if (scalars.some((value) => value === undefined))
+            return null;
+        combinations = combinations.flatMap((combination) => scalars.map((value) => ({ ...combination, [key]: value })));
+    }
+    return combinations;
+}
+function substitute(value, combination) {
+    return value.replace(MATRIX_REF, (whole, key) => combination[key] ?? whole);
+}
+function normalizeCwd(value) {
+    if (value === undefined || value.trim() === '')
+        return '.';
+    const normalized = posix.normalize(value.trim().replace(/^\.\/+/u, ''));
+    return normalized === '' ? '.' : normalized.replace(/\/+$/u, '');
+}
+function runLine(document, counter, path) {
+    const node = document.getIn(path, true);
+    const range = isScalar(node) ? node.range : null;
+    return range ? counter.linePos(range[0]).line : null;
+}
+function parseWorkflow(root, name, diagnostics) {
+    const file = `${WORKFLOW_DIR}/${name}`;
+    const counter = new LineCounter();
+    const document = parseDocument(readFileSync(join(root, file), 'utf8'), { lineCounter: counter });
+    if (document.errors.length > 0) {
+        const first = document.errors[0];
+        diagnostics.push(diagnostic('WORKFLOW_INVALID', 'error', `${file} is not valid YAML: ${first?.message ?? 'parse error'}`, file));
+        return null;
+    }
+    const workflow = record(document.toJS());
+    const jobsNode = document.get('jobs', true);
+    if (!isMap(jobsNode)) {
+        diagnostics.push(diagnostic('WORKFLOW_INVALID', 'error', `${file} has no jobs map.`, file));
+        return null;
+    }
+    const workflowDefaults = record(record(workflow.defaults).run);
+    const jobs = record(workflow.jobs);
+    const checks = [];
+    const notes = [];
+    for (const jobId of jobsNode.items.map((pair) => String(isScalar(pair.key) ? pair.key.value : pair.key))) {
+        const job = record(jobs[jobId]);
+        if (typeof job.uses === 'string') {
+            notes.push(diagnostic('REUSABLE_WORKFLOW_SKIPPED', 'warning', `${file} job ${jobId} calls the reusable workflow ${job.uses}, which is not followed.`, file));
+            continue;
+        }
+        const jobDefaults = record(record(job.defaults).run);
+        const needsServices = job.services !== undefined || job.container !== undefined;
+        const steps = Array.isArray(job.steps) ? job.steps : [];
+        steps.forEach((value, index) => {
+            const step = record(value);
+            const run = text(step.run);
+            if (run === undefined)
+                return;
+            const command = run.replace(/\n+$/u, '');
+            if (INSTALL.test(command.trim()))
+                return;
+            const stepLabel = text(step.name) ?? text(step.id) ?? `step ${index + 1}`;
+            const rawCwd = text(step['working-directory']) ??
+                text(jobDefaults['working-directory']) ??
+                text(workflowDefaults['working-directory']);
+            const keys = [
+                ...new Set([...`${command}\n${rawCwd ?? ''}`.matchAll(MATRIX_REF)].map((match) => match[1] ?? '')),
+            ];
+            const combinations = matrixCombinations(job.strategy, keys) ?? [{}];
+            const condition = text(step.if) ?? text(job.if);
+            const shell = text(step.shell) ?? text(jobDefaults.shell) ?? text(workflowDefaults.shell);
+            const line = runLine(document, counter, ['jobs', jobId, 'steps', index, 'run']);
+            for (const combination of combinations) {
+                const expanded = substitute(command, combination);
+                const cwd = substitute(rawCwd ?? '', combination);
+                const tags = ['ci'];
+                if (expanded.includes('\n'))
+                    tags.push('multi-line');
+                if (/\$\{\{/u.test(`${expanded}\n${cwd}`))
+                    tags.push('needs-review');
+                if (condition !== undefined)
+                    tags.push('conditional');
+                if (needsServices)
+                    tags.push('needs-services');
+                const suffix = Object.entries(combination)
+                    .map(([key, entry]) => `[${key}=${entry}]`)
+                    .join('');
+                checks.push({
+                    id: `ci:${name}:${jobId}:${text(step.id) ?? index + 1}${suffix}`,
+                    command: expanded,
+                    cwd: normalizeCwd(cwd),
+                    sources: [{ kind: 'ci', file, line, job: jobId, step: stepLabel }],
+                    tags,
+                    ...(condition === undefined ? {} : { condition }),
+                    ...(shell === undefined ? {} : { shell }),
+                    acceptanceIds: [],
+                });
+            }
+        });
+    }
+    return { file, triggers: readTriggers(workflow.on), checks, notes };
+}
+/** Parses every GitHub Actions workflow; invalid files become error diagnostics. */
+export function readWorkflows(root, diagnostics) {
+    for (const other of OTHER_CI_FILES) {
+        if (existsSync(join(root, other))) {
+            diagnostics.push(diagnostic('CI_SYSTEM_UNSUPPORTED', 'warning', `${other} is not read; only GitHub Actions workflows are parsed.`, other));
+        }
+    }
+    let names;
+    try {
+        names = readdirSync(join(root, WORKFLOW_DIR))
+            .filter((name) => /\.ya?ml$/u.test(name))
+            .sort();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    return names.flatMap((name) => parseWorkflow(root, basename(name), diagnostics) ?? []);
+}
+//# sourceMappingURL=workflows.js.map

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

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

package/dist/services/template-service.d.ts

@@ -1,4 +1,6 @@
 /** Compile and render a Handlebars template, checking the override directory first. */
 export declare function renderTemplate(templatePath: string, data: Record<string, unknown>, // Template data is inherently untyped
 overrideDir?: string): Promise<string>;
+/** Whether `overrideDir` holds its own copy of `templatePath`. */
+export declare function hasTemplateOverride(templatePath: string, overrideDir?: string): Promise<boolean>;
 //# sourceMappingURL=template-service.d.ts.map

package/dist/services/template-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../src/services/template-service.ts"],"names":[],"mappings":"AAiCA,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,sCAAsC;AACrE,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB"}
+{"version":3,"file":"template-service.d.ts","sourceRoot":"","sources":["../../src/services/template-service.ts"],"names":[],"mappings":"AAiCA,uFAAuF;AACvF,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,sCAAsC;AACrE,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,kEAAkE;AAClE,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/dist/services/template-service.js

@@ -33,6 +33,10 @@ overrideDir) {
     }
     return compiled(data);
 }
+/** Whether `overrideDir` holds its own copy of `templatePath`. */
+export async function hasTemplateOverride(templatePath, overrideDir) {
+    return overrideDir ? fileExists(path.join(overrideDir, templatePath)) : false;
+}
 async function resolveTemplatePath(templatePath, overrideDir) {
     if (overrideDir) {
         const overrideFull = path.join(overrideDir, templatePath);

package/dist/services/template-service.js.map

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

package/dist/utils/slugify.d.ts

@@ -1,9 +1,2 @@
-/**
- * Convert text to a URL/filename-safe slug.
- *
- * `maxLength` caps the slug (default 80) so filenames stay well under
- * the OS limit (255 chars) even after the ID prefix and `.md` extension.
- * The slug is trimmed at the last whole word boundary to avoid cut-off words.
- */
-export declare function slugify(text: string, maxLength?: number): string;
+export { slugify } from '../../lib/backlog-item.mjs';
 //# sourceMappingURL=slugify.d.ts.map

package/dist/utils/slugify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAK,GAAG,MAAM,CAmB5D"}
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/utils/slugify.js

@@ -1,26 +1,2 @@
-/**
- * Convert text to a URL/filename-safe slug.
- *
- * `maxLength` caps the slug (default 80) so filenames stay well under
- * the OS limit (255 chars) even after the ID prefix and `.md` extension.
- * The slug is trimmed at the last whole word boundary to avoid cut-off words.
- */
-export function slugify(text, maxLength = 80) {
-    let slug = text
-        .toLowerCase()
-        .trim()
-        .replace(/[^\w\s-]/g, '')
-        .replace(/[\s_]+/g, '-')
-        .replace(/-+/g, '-')
-        .replace(/^-+|-+$/g, '');
-    if (slug.length > maxLength) {
-        slug = slug.slice(0, maxLength);
-        // Trim at last whole-word boundary to avoid cut-off words
-        const lastDash = slug.lastIndexOf('-');
-        if (lastDash > 0) {
-            slug = slug.slice(0, lastDash);
-        }
-    }
-    return slug;
-}
+export { slugify } from '../../lib/backlog-item.mjs';
 //# sourceMappingURL=slugify.js.map

package/dist/utils/slugify.js.map

@@ -1 +1 @@
-{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,SAAS,GAAG,EAAE;IAClD,IAAI,IAAI,GAAG,IAAI;SACZ,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE3B,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QAC5B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAChC,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/utils/slugify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC"}

package/docs/CLI.md

@@ -694,6 +694,50 @@ Cursor uses Composer handoff with sequential fallback.
 
 ---
 
+### `openplanr ship checks`
+
+List the checks a change needs for a tier, without running them. Sources are the
+GitHub Actions workflows, husky (`.husky/pre-commit`, `.husky/pre-push`) and
+pre-commit hooks, package scripts, and the task's `## Test Requirements`.
+
+```bash
+openplanr ship checks --task .planr/tasks/T-012-parser.md --json
+openplanr ship checks --tier push --json
+```
+
+| Option          | Description                                                    | Default                                   |
+| --------------- | -------------------------------------------------------------- | ----------------------------------------- |
+| `--task <path>` | Task file whose Test Requirements to include                   | none                                      |
+| `--tier <tier>` | `task`, `story`, `push` or `planning`                          | `planning` for a `.planr`-only change, else `task` |
+| `--base <ref>`  | Compare against the merge base with this ref                   | `origin/HEAD`, then `main`                |
+| `--json`        | Print the `openplanr-ship-checks` result (schema `1.0.0`)      | `false`                                   |
+
+**Tiers:**
+
+- `planning`: `openplanr spec sync --dry-run` and `openplanr sync --dry-run`, tagged
+  `report-only` because both exit 0 when they report problems.
+- `task`: Test Requirements commands, pre-commit hooks, and the CI build when the
+  change touches a package entry point, a build script, a `tsconfig*.json` or a
+  bundler config. Without a task command, the `test`, `typecheck` and `lint`
+  scripts are listed as `fallback`.
+- `story`: `task` plus every `run` step of the pull-request and merge-queue
+  workflows whose path filters match the change.
+- `push`: `story` without path filters, plus push workflows and pre-push hooks.
+
+Each CI step is kept verbatim with its `cwd` (step, then job, then workflow
+`working-directory`). Install steps and `uses` steps are skipped. A static matrix
+is expanded; other `${{ }}` expressions are tagged `needs-review`. A check is
+`tracked-only` when its command, its package script, or a script file either one
+runs directly mentions `lint-staged`, `ls-files`, `--cached` or `--staged`;
+deeper calls are not followed. `relatedTests` lists test files that mention a
+name the change exports, a `.command()` name, or a route path.
+
+`complete` is `false` when any diagnostic is an `error`, for example a workflow
+that fails to parse: the listed checks are then not the full CI set. The command
+exits 1 for an unknown tier, a missing `--task` file or a directory outside git.
+
+---
+
 ### `openplanr sync`
 
 Validate and repair cross-references across all artifacts.
@@ -1286,6 +1330,9 @@ For semantic decomposition, invoke the installed `planr:plan` skill. After revie
     "backlog": "BL",
     "sprint": "SPRINT"
   },
-  "createdAt": "2026-03-26"
+  "createdAt": "2026-03-26",
+  "findings": { "unattended": "report" }
 }
 ```
+
+`findings.unattended` decides what Ship and Investigate do with findings outside the task when nobody can answer: `report` (the default) lists them, `file` files each one as a backlog item. Settings OpenPlanr doesn't know are kept when it saves the file.

package/lib/backlog-item.d.mts

@@ -0,0 +1,49 @@
+/** Normalised fields of one backlog item. */
+export interface BacklogFields {
+  readonly title: string;
+  readonly priority: string;
+  readonly tags: readonly string[];
+  readonly description: string;
+  readonly acceptanceCriteria?: string | readonly string[];
+  readonly notes?: string;
+  readonly epicId?: string;
+}
+
+/** One open backlog item; `path` is project-relative. */
+export interface OpenBacklogItem {
+  readonly id: string;
+  readonly title: string;
+  readonly status: string;
+  readonly path: string;
+}
+
+/** The command that installs the OpenPlanr CLI. */
+export declare const CLI_INSTALL_COMMAND: 'npm install -g openplanr';
+/** The one-time line shown after filing without the CLI. */
+export declare const CLI_HINT: string;
+
+/** Reserves the next `PREFIX-NNN` in `dir`, one past the highest file or reservation; never reissues a removed ID. */
+export declare function reserveNextId(dir: string, prefix: string): Promise<string>;
+/** Converts text to a filename-safe slug of at most `maxLength` characters, cut at a word boundary. */
+export declare function slugify(text: string, maxLength?: number): string;
+/** Normalises raw input; throws when the title is empty. */
+export declare function backlogFields(input: Record<string, unknown>): BacklogFields;
+/** Renders the default backlog item Markdown. */
+export declare function renderBacklogItem(id: string, fields: BacklogFields, date: string): string;
+/** Reserves an ID and writes the item into `backlogDir`. */
+export declare function writeBacklogItem(
+  backlogDir: string,
+  prefix: string,
+  fields: BacklogFields,
+  date: string,
+): Promise<{ id: string; filePath: string }>;
+/** Creates an item in the backlog folder configured by `<projectDir>/.planr/config.json`. */
+export declare function createBacklogItem(
+  projectDir: string,
+  input: Record<string, unknown>,
+  date?: string,
+): Promise<{ id: string; title: string; artifactPath: string }>;
+/** Lists backlog items whose status is not `closed` or `done`. */
+export declare function listOpenBacklog(projectDir: string): Promise<OpenBacklogItem[]>;
+/** Returns the install hint and records it in `.planr/config.json`, or null once it has been shown in this project. */
+export declare function takeCliHint(projectDir: string): Promise<string | null>;