@aviaratech/ai-delivery 0.1.0

package/CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# Contributing to ai-delivery
+
+Use Node 24.21.0 and npm 11.19.0. Work in an isolated checkout. The package
+has no access to a particular organization's GitHub Project, credentials or
+delivery policy; tests use synthetic repositories and do not mutate live issues.
+
+```sh
+npm ci
+npm run checks
+npm run build
+npm pack --dry-run
+```
+
+`checks` runs formatting, native type-aware lint, strict TypeScript, a compiled
+build and all Vitest tests. CI runs these commands on pull requests and `main`
+with a read-only GitHub token. A separate TruffleHog job scans changed Git
+history without access to release credentials. Keep examples synthetic and
+review `npm pack --dry-run` for every packaged file. Never commit credentials,
+host configuration, receipts, logs or repository-specific policy.
+
+The `Publish npm package` workflow is manual, runs only from `main`, and uses
+the `npm-publish` environment. Before enabling it, the repository owner must:
+
+1. Confirm the confidentiality review covers the exact source ref and built
+   archive. Confirm the MIT license and the exact package repository URL.
+2. Protect `main` and the `npm-publish` environment with required reviewers,
+   restricted deployment branches and no self-review. Require both CI jobs.
+3. For a new npm package name, have the package owner establish it with a
+   separately authorized and reviewed initial version before configuring
+   trusted publishing. npm cannot bind a trusted publisher before the package
+   exists. Keep the `0.1.0` release for the protected OIDC workflow; do not add
+   npm credentials to Actions or substitute a token-based workflow.
+4. Register `@aviaratech/ai-delivery` with npm trusted publishing for GitHub
+   organization `aviaratech`, repository `ai-delivery`, workflow filename
+   `release.yml`, and environment name `npm-publish`. Enable direct `npm publish`
+   for that trusted publisher. The npm environment restriction must match the
+   protected GitHub environment in the workflow.
+5. Review the source head, package version, archive inventory and secret scan.
+   Dispatch the release workflow on `main` once. The build job checks and
+   packages without OIDC permission; only the approved publish job receives
+   `id-token: write` and publishes that archived tarball.
+
+npm provenance is generated automatically by trusted publishing only when both
+repository and package are public. A release has not occurred merely because
+the workflow exists; verify npm registry readback after the protected job
+finishes. A failed or ambiguous publish requires registry readback before retrying
+the same version.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aviara Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# ai-delivery
+
+Generic GitHub issue and pull request delivery for repositories that opt in with a source-controlled `ai-delivery.config.json` and a `RepositoryDeliveryPolicy@1` module. The package provides one `ai-delivery` CLI, one stdio MCP server, and thin plugin assets in `plugins/ai-delivery`.
+
+The package contains no repository-specific policy, credential, model, or deployment configuration. A consuming repository owns its issue taxonomy, native Project fields, author and reviewer GitHub App credentials, delivery stages, and phase constraints. The runtime refuses a missing or untracked configuration or policy module.
+
+## Availability and installation
+
+Install the versioned package from npm or a reviewed package archive. The
+consuming repository must run its own configuration and runtime-admission
+procedure before any lifecycle write.
+
+```sh
+node --version # 24.21.0
+npm --version  # 11.19.0
+npm install --save-dev @aviaratech/ai-delivery@0.1.0
+npx ai-delivery --help
+npx ai-delivery --repo-root /absolute/path/to/consumer --identity configured-author info --issue 17
+npx ai-delivery --repo-root /absolute/path/to/consumer --identity configured-author mcp:serve
+```
+
+`info` is a read. `verify`, PR publication, formal review submission and finish
+are lifecycle writes. The CLI and MCP server enforce the same admission and
+identity rules. The [plugin guide](plugins/ai-delivery/README.md) covers host
+installation.
+
+## Configure a consuming repository
+
+Commit `ai-delivery.config.json` at that repository's Git root. It selects the
+repository, its native issue types, Project number, exact Points/Priority field
+IDs and choices, four Project status names, command checks and timeouts, a
+`RepositoryDeliveryPolicy@1` module, and distinct author and reviewer App role
+names. Field IDs and choices must match the consuming repository's live GitHub
+metadata. The parser and policy contract are exported from
+`@aviaratech/ai-delivery`; `src/config/deliveryConfig.test.ts` and
+`src/delivery/delivery.test.ts` contain fully synthetic examples for unrelated
+repositories. Copy their shape, then substitute your own repository's native
+metadata and policy. There is no built-in organization policy or stage list.
+
+The policy module must implement `classifyExactRange` and `validateBoundary`.
+It defines the repository's ordered verification stages, risk and any additional
+publication or merge constraints. Its source is tracked alongside the config;
+source/config/policy drift invalidates prior receipts. Run the consumer's policy
+checks before making lifecycle writes. A missing or untracked module is refused.
+
+Set each role's three configured **environment variable names** to the App ID,
+installation ID and private-key file path on the host. Keep secret values and
+key files out of Git and out of CLI arguments. The author App installation
+requires Contents, Issues, organization Projects and Pull requests **write**
+permissions. The reviewer App installation requires Contents **read** and Pull
+requests **write** permissions. A consuming policy may require additional
+permissions. The roles must resolve to distinct actors. Personal token use is
+an explicit `--personal-auth` author-only mode;
+it is never a fallback. Use a deliberately synthetic test repository for the
+first end-to-end rehearsal; examples here must not be run against a live issue.
+
+Before any CLI or MCP lifecycle write, the consuming installer must place a private `ai-delivery.runtime-admission@1` record at `<git-common-dir>/ai-delivery/runtime-admission.json`. It binds the verified source archive, repository config digest, package version, capability 1, and actual CLI, MCP launcher, and plugin manifest byte hashes and real paths. Both invocation surfaces validate the same record before writes; a missing, stale, or mismatched record refuses the operation. Installation does not create this record automatically. Reinstall or reissue the record after package, config, or launcher changes. Existing rows in the canonical `.issue-cli/worktrees.json` registry remain with their original runtime unless they have an exact immutable `ai-delivery.worktree-owner@1` witness. Do not convert old receipts into new approvals or run old and new writers for the same active issue.
+
+`verify` classifies a clean Git base/head range, runs only the stages selected by the repository policy, and persists content-addressed private checkpoints under the Git common directory. It reuses compatible complete stages and rejects corrupt or stale inputs. The `--admit` flag explicitly admits additional resource classes. Publication creates a draft PR only after exact-head verification; a high-risk policy also requires a prepublication review artifact. Ready promotion and merge require a submitted formal review. Merge checks live blockers, checks, base/head coordinates, and the policy boundary. Repositories may require an exact base/head lease for merge.
+
+For recovery, inspect the original issue/PR, worktree registry and exact source
+head before retrying. A `created-not-started` response includes `safeResume`
+arguments; use those arguments unchanged to resume the known issue. `verify`
+reuses compatible stage checkpoints after interruption. If code, config, policy,
+the selected stage inputs or a checkpoint changes, regenerate the affected
+proof. A stopped or failed publish/finish must be read back before retrying;
+never infer completion from a timed-out command. Task assignment and model
+routing belong to a separate orchestrator, not this CLI.
+
+## Compatibility contract
+
+The MCP input and result contract is `ai-delivery.mcp@1`, exported as `AI_DELIVERY_MCP_CONTRACT_VERSION`. It retains the 13 `issue_*` tool names. Each tool rejects unknown fields at the request boundary. `issue_create` accepts a title with optional body, Issue Type, Points, Priority, taxonomy labels, milestone, parent and blockers; it returns `{body, created: {number, title, url}}`. A linked parent is read back and cleared of Points. `issue_start({issueNumber})` always checks readiness and prepares that existing issue; `develop` gates only preparation of a newly created issue. New starts default to 2 Points. `resumeCreated` requires both `issueNumber` and `develop: true` and never creates a second issue. Immediate creation and development preflights readiness before creation and returns `ai-delivery.issue-start-registration@1` with `status: "started"` or a `created-not-started` failure and exact `safeResume` arguments. The CLI prints that recovery JSON and exits nonzero for `created-not-started`. Scratch starts derive safe names from the request or title and return the branch and worktree path. `repo` on create, start and ready check, or global CLI `--repo`, must match the repository selected by the checkout's validated config; a mismatch fails before a GitHub call.
+
+`issue_update` returns authoritative issue readback; `issue_info` returns current native metadata, parent, blockers, Project state and registered worktree; `issue_ready_check` returns deterministic admission and reasons; `issue_develop` and `issue_worktree_create` return registered worktree rows. `issue_verify` returns classification, aggregate, manifest and publication evidence IDs. `issue_pr_create` returns the PR number, URL and bound publication evidence ID; `issue_pr_info` returns number, state, exact head/base, draft flag and URL. `issue_pr_review` returns an exact-head submitted review receipt, `issue_pr_merge` a durable merge receipt, and `issue_finish` returns the merge SHA and successful issue/cleanup readback. CLI and MCP call the same owners for these tools.
+
+The CLI also exposes native relationship reads (`parent`, `subissues`, `blockers`), registry reads and clean registered PR/standalone cleanup (`worktrees:list`, `worktrees:status`, `worktrees:cleanup`), and PR reads and exact-head App-authorized checkout (`pr:list`, `pr:checks`, `pr:checkout`). A cleaned PR worktree can be reopened when its retained branch still matches the remote head. `migrate:legacy-issues --input-file` produces an offline `ai-delivery.legacy-issue-migration@1` plan without live writes. `metrics velocity --json` reads completed local delivery records and returns `ai-delivery.velocity-report@1` with buckets for configured Points; unknown blocker and review measurements remain null. `finish` can confirm completion after a lost response by matching the exact merge receipts, delivery record and live issue/Project state. Installing the package never migrates active runtime state automatically.
+
+## Contributor checks and release
+
+Use Node 24.21.0 and npm 11.19.0. `npm ci` installs the single committed lockfile; `npm run checks` is the canonical local gate and runs Oxfmt, native Oxlint with `oxlint-tsgolint`, strict TypeScript, a compiled build, and Vitest over the emitted `dist/**/*.test.js` files. The compiled test target preserves CLI child-process and package-file assertions. `npm run build` can be run separately before packing. Tests retain the accepted 25 synthetic lifecycle, identity, receipt, recovery, cleanup, and plugin cases. See [CONTRIBUTING.md](CONTRIBUTING.md) for the local commands and release prerequisites.
+
+The standalone lint config enables native error, promise, unsafe-value, and explicit-type checks. TypeScript uses exact optional properties, checked indexed access, explicit overrides, return/fallthrough, and unused-symbol checks. Tests and review cover the delivery behavior boundary.
+
+Installing the package does not switch an existing consumer. Run `npm run checks`, `npm run build`, and `npm pack --dry-run` before release.

package/dist/agent.d.ts

@@ -0,0 +1,17 @@
+export { loadDeliveryConfig, parseDeliveryConfig, resolveDeliveryRoleCredentials } from './config/deliveryConfig.js';
+export type { DeliveryConfig, DeliveryRole, LoadedDeliveryConfig } from './config/deliveryConfig.js';
+export { createDeliveryGitHubClients } from './github/client.js';
+export { resolveDeliveryRepo } from './github/repo.js';
+export { AI_DELIVERY_MCP_CONTRACT_VERSION, AI_DELIVERY_MCP_TOOLS, createAiDeliveryMcpServer } from './mcp/index.js';
+export { executeTool } from './dispatch.js';
+export { evaluateAgentReadiness } from './services/agentReadinessService.js';
+export { createIssue, updateIssue, issueInfo, readyCheck, developIssue, listIssueSubissues } from './issue.js';
+export { prInfo, listPrs, prChecks, checkoutPr, publishPr, submitFormalReview, mergePr, finishIssue } from './pr.js';
+export { preparePrWorktree, cleanupNonIssueWorktree } from './worktree.js';
+export { getNativeBlockerRelationships, getNativeBlockingRelationships, replaceBlockedBy, replaceParentIssue, hasNativeSubIssues, } from './github/relationships.js';
+export { normalizeLegacyIssue, planOfflineLegacyIssueMigration } from './services/legacyIssueMigration.js';
+export { buildVelocityReport, getDeliveryRecords, recordMergedDelivery } from './services/deliveryRecordService.js';
+export type { DeliveryRecord, VelocityReport, PointBucketStatistics } from './services/deliveryRecordService.js';
+export { getIssueWorktreeStrict, listWorktreesStrict } from './services/worktreeRegistry.js';
+export { prepareIssueWorktree, prepareStandaloneWorktree } from './worktree.js';
+export { verifyIssue, createIssuePhaseEvidence } from './verification.js';

package/dist/agent.js

@@ -0,0 +1,16 @@
+export { loadDeliveryConfig, parseDeliveryConfig, resolveDeliveryRoleCredentials } from './config/deliveryConfig.js';
+export { createDeliveryGitHubClients } from './github/client.js';
+export { resolveDeliveryRepo } from './github/repo.js';
+export { AI_DELIVERY_MCP_CONTRACT_VERSION, AI_DELIVERY_MCP_TOOLS, createAiDeliveryMcpServer } from './mcp/index.js';
+export { executeTool } from './dispatch.js';
+export { evaluateAgentReadiness } from './services/agentReadinessService.js';
+export { createIssue, updateIssue, issueInfo, readyCheck, developIssue, listIssueSubissues } from './issue.js';
+export { prInfo, listPrs, prChecks, checkoutPr, publishPr, submitFormalReview, mergePr, finishIssue } from './pr.js';
+export { preparePrWorktree, cleanupNonIssueWorktree } from './worktree.js';
+export { getNativeBlockerRelationships, getNativeBlockingRelationships, replaceBlockedBy, replaceParentIssue, hasNativeSubIssues, } from './github/relationships.js';
+export { normalizeLegacyIssue, planOfflineLegacyIssueMigration } from './services/legacyIssueMigration.js';
+export { buildVelocityReport, getDeliveryRecords, recordMergedDelivery } from './services/deliveryRecordService.js';
+export { getIssueWorktreeStrict, listWorktreesStrict } from './services/worktreeRegistry.js';
+export { prepareIssueWorktree, prepareStandaloneWorktree } from './worktree.js';
+export { verifyIssue, createIssuePhaseEvidence } from './verification.js';
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AAErH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gCAAgC,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACpH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACrH,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,EAC9B,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,+BAA+B,EAAE,MAAM,oCAAoC,CAAC;AAC3G,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEpH,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,314 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from 'node:fs';
+import { Command } from 'commander';
+import { printCommandResult } from './cliResult.js';
+import { loadDeliveryConfig } from './config/deliveryConfig.js';
+import { contextFor, executeTool } from './dispatch.js';
+import { git, gitExitCode, primaryGitRoot } from './git.js';
+import { listIssueSubissues } from './issue.js';
+import { checkoutPr, listPrs, prChecks } from './pr.js';
+import { serveAiDeliveryMcp } from './mcp/index.js';
+import { planOfflineLegacyIssueMigration } from './services/legacyIssueMigration.js';
+import { assertDeliveryRuntimeAdmitted } from './services/deliveryAdmission.js';
+import { buildVelocityReport, getDeliveryRecords } from './services/deliveryRecordService.js';
+import { listWorktreesStrict } from './services/worktreeRegistry.js';
+import { cleanupNonIssueWorktree } from './worktree.js';
+const program = new Command();
+program
+    .name('ai-delivery')
+    .description('Generic GitHub issue and pull request delivery')
+    .version('0.1.0')
+    .option('--identity <name>', 'Configured author or reviewer identity')
+    .option('--personal-auth', 'Explicit personal-token author mode')
+    .option('--repo <owner/name>', 'Repository selector; must match the configured checkout')
+    .option('--repo-root <path>', 'Target Git repository root', process.cwd());
+function execution() {
+    const options = program.opts();
+    const identity = options.identity ?? process.env.AI_DELIVERY_IDENTITY;
+    return {
+        repoRoot: options.repoRoot,
+        ...(identity === undefined ? {} : { identity }),
+        personalAuth: options.personalAuth === true,
+        ...(options.repo === undefined ? {} : { repo: options.repo }),
+    };
+}
+function int(value) {
+    return value === undefined ? undefined : Number(value);
+}
+function list(value) {
+    return value === undefined
+        ? undefined
+        : value
+            .split(',')
+            .map((part) => part.trim())
+            .filter(Boolean);
+}
+function ints(value) {
+    return list(value)?.map(Number);
+}
+function body(value, file) {
+    if (value !== undefined && file !== undefined)
+        throw new Error('Pass either --body or --body-file.');
+    return file === undefined ? value : readFileSync(file, 'utf8');
+}
+function run(name, input) {
+    return executeTool(name, input, execution()).then((value) => printCommandResult(name, value));
+}
+function print(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}
+program
+    .command('create')
+    .requiredOption('--title <title>')
+    .option('--body <markdown>')
+    .option('--body-file <path>')
+    .option('--type <type>')
+    .option('--points <number>')
+    .option('--priority <priority>')
+    .option('--labels <labels>')
+    .option('--blocked-by <numbers>')
+    .option('--milestone <number>')
+    .option('--parent <number>')
+    .action(async (o) => run('issue_create', {
+    title: o.title,
+    body: body(o.body, o.bodyFile),
+    issueType: o.type,
+    points: int(o.points),
+    priority: o.priority,
+    labels: list(o.labels),
+    blockedBy: ints(o.blockedBy),
+    milestone: int(o.milestone),
+    parentIssueNumber: int(o.parent),
+}));
+program
+    .command('start')
+    .option('--issue <number>')
+    .option('--request <text>')
+    .option('--title <title>')
+    .option('--body <markdown>')
+    .option('--body-file <path>')
+    .option('--type <type>')
+    .option('--points <number>')
+    .option('--priority <priority>')
+    .option('--labels <labels>')
+    .option('--blocked-by <numbers>')
+    .option('--milestone <number>')
+    .option('--parent <number>')
+    .option('--branch <branch>')
+    .option('--scratch')
+    .option('--develop')
+    .option('--resume-created')
+    .action(async (o) => run('issue_start', {
+    issueNumber: int(o.issue),
+    request: o.request,
+    title: o.title,
+    body: body(o.body, o.bodyFile),
+    issueType: o.type,
+    points: int(o.points),
+    priority: o.priority,
+    labels: list(o.labels),
+    blockedBy: ints(o.blockedBy),
+    milestone: int(o.milestone),
+    parentIssueNumber: int(o.parent),
+    branch: o.branch,
+    scratch: o.scratch === true,
+    develop: o.develop === true,
+    resumeCreated: o.resumeCreated === true,
+}));
+program
+    .command('update')
+    .requiredOption('--issue <number>')
+    .option('--title <title>')
+    .option('--body <markdown>')
+    .option('--body-file <path>')
+    .option('--type <type>')
+    .option('--points <number>')
+    .option('--priority <priority>')
+    .option('--labels <labels>')
+    .option('--blocked-by <numbers>')
+    .option('--milestone <number>')
+    .option('--parent <number>')
+    .option('--state <state>')
+    .action(async (o) => run('issue_update', {
+    issueNumber: int(o.issue),
+    title: o.title,
+    body: body(o.body, o.bodyFile),
+    issueType: o.type,
+    points: int(o.points),
+    priority: o.priority,
+    labels: list(o.labels),
+    blockedBy: ints(o.blockedBy),
+    milestone: int(o.milestone),
+    parentIssueNumber: int(o.parent),
+    state: o.state,
+}));
+program
+    .command('info')
+    .requiredOption('--issue <number>')
+    .option('--cached')
+    .action(async (o) => run('issue_info', { issueNumber: int(o.issue), cached: o.cached === true }));
+program
+    .command('ready:check')
+    .requiredOption('--issue <number>')
+    .action(async (o) => run('issue_ready_check', { issueNumber: int(o.issue) }));
+for (const field of ['parent', 'blockers']) {
+    program
+        .command(field)
+        .requiredOption('--issue <number>')
+        .action(async (o) => {
+        const info = (await executeTool('issue_info', { issueNumber: int(o.issue) }, execution()));
+        print(field === 'parent'
+            ? { issueNumber: int(o.issue), parentIssueNumber: info.parentIssueNumber }
+            : { issueNumber: int(o.issue), blockedBy: info.blockedBy });
+    });
+}
+program
+    .command('subissues')
+    .requiredOption('--issue <number>')
+    .action(async (o) => {
+    const context = await contextFor(execution(), 'subissues');
+    print({ issueNumber: int(o.issue), subissues: await listIssueSubissues(context, Number(o.issue)) });
+});
+program
+    .command('develop')
+    .requiredOption('--issue <number>')
+    .option('--assignee <login>')
+    .action(async (o) => run('issue_develop', { issueNumber: int(o.issue), assignee: o.assignee }));
+program
+    .command('verify')
+    .requiredOption('--issue <number>')
+    .option('--admit <classes>')
+    .option('--prepublication-review <path>')
+    .action(async (o) => run('issue_verify', {
+    issueNumber: int(o.issue),
+    admit: list(o.admit),
+    prepublicationReview: o.prepublicationReview,
+}));
+program
+    .command('pr:create')
+    .requiredOption('--issue <number>')
+    .option('--title <title>')
+    .option('--body-file <path>')
+    .option('--ready')
+    .option('--dry-run')
+    .action(async (o) => run('issue_pr_create', {
+    issueNumber: int(o.issue),
+    title: o.title,
+    body: body(undefined, o.bodyFile),
+    draft: o.ready !== true,
+    dryRun: o.dryRun === true,
+}));
+program
+    .command('pr:info')
+    .option('--issue <number>')
+    .option('--pr <number>')
+    .action(async (o) => run('issue_pr_info', { issueNumber: int(o.issue), prNumber: int(o.pr) }));
+program
+    .command('pr:list')
+    .option('--state <state>', 'open, closed or all', 'open')
+    .action(async (o) => {
+    if (!['open', 'closed', 'all'].includes(o.state))
+        throw new Error('Invalid PR state.');
+    const context = await contextFor(execution(), 'pr:list');
+    print(await listPrs(context, o.state));
+});
+program
+    .command('pr:checks')
+    .requiredOption('--pr <number>')
+    .action(async (o) => {
+    const context = await contextFor(execution(), 'pr:checks');
+    print(await prChecks(context, Number(o.pr)));
+});
+program
+    .command('pr:checkout')
+    .requiredOption('--pr <number>')
+    .action(async (o) => {
+    assertDeliveryRuntimeAdmitted(execution());
+    const context = await contextFor(execution(), 'pr:checkout');
+    print(await checkoutPr(context, Number(o.pr)));
+});
+program
+    .command('pr:review')
+    .requiredOption('--issue <number>')
+    .requiredOption('--pr <number>')
+    .requiredOption('--artifact <path>')
+    .option('--dry-run')
+    .action(async (o) => run('issue_pr_review', {
+    issueNumber: int(o.issue),
+    prNumber: int(o.pr),
+    artifact: readFileSync(o.artifact, 'utf8'),
+    dryRun: o.dryRun === true,
+}));
+for (const [command, tool] of [
+    ['pr:merge', 'issue_pr_merge'],
+    ['finish', 'issue_finish'],
+]) {
+    program
+        .command(command)
+        .requiredOption('--issue <number>')
+        .requiredOption('--pr <number>')
+        .option('--strategy <method>')
+        .option('--dry-run')
+        .action(async (o) => run(tool, {
+        issueNumber: int(o.issue),
+        prNumber: int(o.pr),
+        strategy: o.strategy,
+        dryRun: o.dryRun === true,
+    }));
+}
+program
+    .command('worktree:create')
+    .requiredOption('--name <name>')
+    .requiredOption('--branch <branch>')
+    .action(async (o) => run('issue_worktree_create', o));
+program.command('worktrees:list').action(() => print(listWorktreesStrict(primaryGitRoot(execution().repoRoot))));
+program.command('worktrees:status').action(() => {
+    const root = primaryGitRoot(execution().repoRoot);
+    print(listWorktreesStrict(root).map((row) => {
+        const present = existsSync(row.path) && gitExitCode(row.path, 'rev-parse', '--is-inside-work-tree') === 0;
+        return {
+            ...row,
+            present,
+            observedBranch: present ? git(row.path, 'branch', '--show-current') : null,
+            clean: present ? git(row.path, 'status', '--porcelain', '--untracked-files=all') === '' : null,
+        };
+    }));
+});
+program
+    .command('worktrees:cleanup')
+    .option('--pr <number>')
+    .option('--name <name>')
+    .action(async (o) => {
+    assertDeliveryRuntimeAdmitted(execution());
+    const context = await contextFor(execution(), 'worktrees:cleanup');
+    await cleanupNonIssueWorktree({
+        repoRoot: context.root,
+        ...(o.pr === undefined ? {} : { prNumber: Number(o.pr) }),
+        ...(o.name === undefined ? {} : { name: o.name }),
+    });
+    print({ cleaned: true, ...(o.pr === undefined ? { name: o.name } : { prNumber: Number(o.pr) }) });
+});
+program
+    .command('migrate:legacy-issues')
+    .requiredOption('--input-file <path>', 'Offline legacy issue inventory JSON')
+    .action((o) => {
+    const report = planOfflineLegacyIssueMigration(JSON.parse(readFileSync(o.inputFile, 'utf8')));
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+});
+program
+    .command('metrics')
+    .description('Report bounded terminal delivery metrics')
+    .command('velocity')
+    .option('--json', 'Print the canonical JSON report')
+    .action(() => {
+    const root = primaryGitRoot(execution().repoRoot);
+    const config = loadDeliveryConfig(root).config;
+    const report = buildVelocityReport(getDeliveryRecords(root), new Date(), config.native.points.values.map(Number));
+    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+});
+program.command('mcp:serve').action(async () => serveAiDeliveryMcp(execution()));
+program.parseAsync(process.argv).catch((error) => {
+    process.stderr.write(`ai-delivery: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/cliResult.d.ts

@@ -0,0 +1,2 @@
+/** Keep a recoverable start failure machine-readable while signalling shell failure. */
+export declare function printCommandResult(command: string, value: unknown): void;

package/dist/cliResult.js

@@ -0,0 +1,12 @@
+/** Keep a recoverable start failure machine-readable while signalling shell failure. */
+export function printCommandResult(command, value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+    if (command === 'issue_start' &&
+        typeof value === 'object' &&
+        value !== null &&
+        'status' in value &&
+        value.status === 'created-not-started') {
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=cliResult.js.map

package/dist/cliResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliResult.js","sourceRoot":"","sources":["../src/cliResult.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,KAAc;IAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5D,IACE,OAAO,KAAK,aAAa;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,QAAQ,IAAI,KAAK;QACjB,KAAK,CAAC,MAAM,KAAK,qBAAqB,EACtC,CAAC;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cliResult.test.d.ts

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

package/dist/cliResult.test.js

@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict';
+import { spawnSync } from 'node:child_process';
+import { join } from 'node:path';
+import { test } from 'vitest';
+import { pathToFileURL } from 'node:url';
+test('CLI preserves recoverable start JSON and exits nonzero after creation failure', () => {
+    const helper = pathToFileURL(join(process.cwd(), 'dist', 'cliResult.js')).href;
+    const failure = {
+        schemaVersion: 'ai-delivery.issue-start-registration@1',
+        status: 'created-not-started',
+        createdIssue: { number: 17 },
+    };
+    const code = `import { printCommandResult } from ${JSON.stringify(helper)};` +
+        `printCommandResult('issue_start', ${JSON.stringify(failure)});`;
+    const result = spawnSync(process.execPath, ['--input-type=module', '-e', code], { encoding: 'utf8' });
+    assert.equal(result.status, 1);
+    assert.deepEqual(JSON.parse(result.stdout), failure);
+    assert.equal(result.stderr, '');
+    const ordinary = spawnSync(process.execPath, [
+        '--input-type=module',
+        '-e',
+        `import { printCommandResult } from ${JSON.stringify(helper)};` +
+            `printCommandResult('issue_start', {status:'started'});`,
+    ], { encoding: 'utf8' });
+    assert.equal(ordinary.status, 0);
+    const parsed = JSON.parse(ordinary.stdout);
+    assert.ok(parsed !== null && typeof parsed === 'object' && 'status' in parsed);
+    assert.equal(parsed.status, 'started');
+});
+//# sourceMappingURL=cliResult.test.js.map

package/dist/cliResult.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliResult.test.js","sourceRoot":"","sources":["../src/cliResult.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,IAAI,CAAC,+EAA+E,EAAE,GAAG,EAAE;IACzF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,MAAM,OAAO,GAAG;QACd,aAAa,EAAE,wCAAwC;QACvD,MAAM,EAAE,qBAAqB;QAC7B,YAAY,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;KAC7B,CAAC;IACF,MAAM,IAAI,GACR,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG;QAC/D,qCAAqC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACtG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/B,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEhC,MAAM,QAAQ,GAAG,SAAS,CACxB,OAAO,CAAC,QAAQ,EAChB;QACE,qBAAqB;QACrB,IAAI;QACJ,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG;YAC7D,wDAAwD;KAC3D,EACD,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrB,CAAC;IACF,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,QAAQ,IAAI,MAAM,CAAC,CAAC;IAC/E,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC"}