@aviaratech/ai-delivery 0.3.21 → 0.3.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aviaratech/ai-delivery",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "private": false,
   "description": "Generic GitHub issue and pull request delivery CLI and MCP server",
   "homepage": "https://github.com/aviaratech/ai-delivery#readme",
@@ -46,11 +46,11 @@
     "access": "public"
   },
   "scripts": {
-    "format": "oxfmt src package.json tsconfig.json tsconfig.build.json vitest.config.ts .oxlintrc.json .oxfmtrc.json",
-    "format:check": "oxfmt --check src package.json tsconfig.json tsconfig.build.json vitest.config.ts .oxlintrc.json .oxfmtrc.json",
+    "format": "oxfmt src scripts package.json tsconfig.json tsconfig.build.json vitest.config.ts .oxlintrc.json .oxfmtrc.json",
+    "format:check": "oxfmt --check src scripts package.json tsconfig.json tsconfig.build.json vitest.config.ts .oxlintrc.json .oxfmtrc.json",
     "lint": "oxlint",
     "typecheck": "tsc -p tsconfig.json",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-plugin.mjs",
     "postbuild": "node -e \"require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
     "test": "npm run build && vitest run",
     "checks": "npm run format:check && npm run lint && npm run typecheck && npm test"

package/plugins/ai-delivery/.claude-plugin/plugin.json

@@ -1,6 +1,11 @@
 {
   "name": "ai-delivery",
+  "version": "0.3.23",
   "description": "GitHub issue and pull request delivery tools for prepared worktrees and evidence-based handoff.",
+  "author": { "name": "AviaraTech", "url": "https://github.com/aviaratech" },
+  "homepage": "https://github.com/aviaratech/ai-delivery#readme",
+  "repository": "https://github.com/aviaratech/ai-delivery",
+  "license": "MIT",
   "deliveryCapabilityVersion": 2,
-  "packageVersion": "0.3.21"
+  "packageVersion": "0.3.23"
 }

package/plugins/ai-delivery/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/plugins/ai-delivery/README.md

@@ -1,5 +1,7 @@
 # ai-delivery plugin
 
-Thin host plugin for `@aviaratech/ai-delivery`. The launcher starts the installed package's `mcp:serve` command over stdio. MCP schemas, GitHub operations, worktree handling, and delivery logic remain in the package.
+Self-contained host plugin for `@aviaratech/ai-delivery`. Its built launcher starts the package's existing `mcp:serve` command in the adjacent `runtime` directory, which includes the built CLI and runtime dependencies. It can start from a native plugin root without a parent npm installation, source build or postinstall. The root contains portable `plugin.json` / `mcp.json` and the preserved Claude-compatible `.claude-plugin/plugin.json` / `.mcp.json`. Package, CLI, MCP server and native manifest versions agree; application and bundled dependency notices accompany the launcher. MCP schemas, GitHub operations, worktree handling and delivery logic retain their existing owners in the package.
 
-The bundled skills cover issue intake, prepared worktree development, and pull request handoff. Install the package with its `plugins/ai-delivery` directory available to the host plugin loader. Point the host at `plugins/ai-delivery/dist/mcp-launcher.js` from the verified package installation, set the consuming repository's selected author and reviewer credential environment outside source control, and use the public `runtime:stage` / `runtime:admit` setup operations described in the [package guide](../../README.md) before a lifecycle write. Stage returns the actual bundled launcher path without switching host references; admission is a separate explicit final write that rechecks the reviewed archive, consumer source/configuration, configured actors and installed bytes. The existing consumer installer owns host activation and rollback. Restart the host after installation so it loads the new launcher. A read-only `issue_info` call can confirm repository selection; `issue_pr_create` with `dryRun: true` reports effective actors and rule visibility before publication. Keep one active writer per issue and preserve its original worktree owner when upgrading.
+The bundled skills cover issue intake, prepared worktree development, and pull request handoff. Use `ai-delivery plugin install --host codex --scope user --version <published-version>` or select `--host claude-code` with a native `user`, `project`, or `local` scope. The same command group provides `doctor`, explicit-version `update`, `rollback` to the recorded previous version, and `remove`, with `--dry-run` and `--json` on each. The [package guide](../../README.md) describes managed version retention, read-only diagnostics, and data preservation. Restart the host after changing its plugin selection.
+
+Set the consuming repository's selected author and reviewer credential environment outside source control, and use the public `runtime:stage` / `runtime:admit` setup operations before a lifecycle write. Stage can bind the exact native plugin root using `--native-plugin-root`; use the path the host actually loads, which may differ from its reported cache path. Admission remains a separate explicit final write that rechecks the reviewed archive, consumer source/configuration, configured actors and installed bytes. A read-only `issue_info` call can confirm repository selection; `issue_pr_create` with `dryRun: true` reports effective actors and rule visibility before publication. Keep one active writer per issue and preserve its original worktree owner when upgrading.

package/plugins/ai-delivery/dist/mcp-launcher.js

@@ -1,22 +1,33 @@
 import { spawn } from 'node:child_process';
+import { realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-const packageEntry = import.meta.resolve('@aviaratech/ai-delivery');
-if (!packageEntry.startsWith('file:')) {
-  throw new Error('Cannot resolve the installed @aviaratech/ai-delivery package to a file');
+const pluginRoot = realpathSync(fileURLToPath(new URL('../', import.meta.url)));
+let cliEntry = join(pluginRoot, 'runtime', 'dist', 'cli.js');
+try {
+  // Preserve the existing npm runtime only for this exact package-local root.
+  // An ambient parent installation can never replace a copied plugin's runtime.
+  const packageEntry = fileURLToPath(import.meta.resolve('@aviaratech/ai-delivery'));
+  const packageRoot = dirname(dirname(packageEntry));
+  if (realpathSync(join(packageRoot, 'plugins', 'ai-delivery')) === pluginRoot)
+    cliEntry = join(packageRoot, 'dist', 'cli.js');
+} catch {
+  // A native cache needs only its own released, bundled runtime.
 }
-
-const cliEntry = fileURLToPath(new URL('./cli.js', packageEntry));
-const child = spawn(process.execPath, [cliEntry, 'mcp:serve'], {
+const child = spawn(process.execPath, [realpathSync(cliEntry), 'mcp:serve'], {
   env: process.env,
   stdio: 'inherit',
 });
-
+for (const signal of ['SIGINT', 'SIGTERM']) {
+  process.on(signal, () => {
+    child.kill(signal);
+  });
+}
 child.on('error', (error) => {
   process.stderr.write(`Unable to start ai-delivery MCP server: ${error.message}\n`);
   process.exitCode = 1;
 });
-
 child.on('close', (code, signal) => {
   process.exitCode = code ?? (signal ? 1 : 0);
 });

package/plugins/ai-delivery/mcp.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
+  "mcpServers": {
+    "ai-delivery": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["${PLUGIN_ROOT}/dist/mcp-launcher.js"]
+    }
+  }
+}

package/plugins/ai-delivery/plugin.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "ai-delivery",
+  "version": "0.3.23",
+  "description": "GitHub issue and pull request delivery tools for prepared worktrees and evidence-based handoff.",
+  "author": { "name": "AviaraTech", "url": "https://github.com/aviaratech" },
+  "homepage": "https://github.com/aviaratech/ai-delivery#readme",
+  "repository": "https://github.com/aviaratech/ai-delivery",
+  "license": "MIT"
+}