@pebblehouse/odin-cli 0.19.0 → 0.20.0

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command24 } from "commander";
+import { Command as Command25 } from "commander";
 
 // src/auth/login.ts
 import open from "open";
@@ -759,7 +759,7 @@ plansCmd.command("create <slug> <title>").description("Create a plan").option("-
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-plansCmd.command("update <slug> <id>").description("Update a plan").option("--title <title>", "New title").option("--description <description>", "New description").option("--status <status>", "Plan status (active|done|archived)").option("--bet-id <uuid>", "Link plan to a bet").option("--task-id <uuid>", "Link plan to a task").option("--clear-bet", "Clear the bet link").option("--clear-task", "Clear the task link").action(async (slug, id, opts) => {
+plansCmd.command("update <slug> <id>").description("Update a plan").option("--title <title>", "New title").option("--description <description>", "New description").option("--status <status>", "Plan status (active|done|archived)").option("--bet-id <uuid>", "Link plan to a bet").option("--task-id <uuid>", "Link plan to a task").option("--clear-bet", "Clear the bet link").option("--clear-task", "Clear the task link").option("--pr-url <url>", "Bind the plan's pull request URL (claim-guarded on bet-linked plans)").option("--claim-id <id>", "Held delivery claim id").option("--claim-generation <n>", "Held claim generation").option("--skills-version <v>", "odin-skills version").action(async (slug, id, opts) => {
   if (opts.betId && opts.clearBet) {
     process.stderr.write("Cannot combine --bet-id with --clear-bet\n");
     process.exit(1);
@@ -776,6 +776,11 @@ plansCmd.command("update <slug> <id>").description("Update a plan").option("--ti
   else if (opts.clearBet) body.bet_id = null;
   if (opts.taskId) body.task_id = opts.taskId;
   else if (opts.clearTask) body.task_id = null;
+  if (opts.prUrl) body.pr_url = opts.prUrl;
+  Object.assign(body, {
+    ...opts.claimId ? { claim_id: opts.claimId, claim_generation: Number(opts.claimGeneration) } : {},
+    ...opts.skillsVersion ? { skills_version: opts.skillsVersion } : {}
+  });
   const res = await apiRequest(`/pebbles/${slug}/plans/${id}`, {
     method: "PUT",
     body
@@ -802,12 +807,16 @@ plansCmd.command("add-phase <slug> <planId> <title>").description("Add a phase t
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
 });
-plansCmd.command("update-phase <slug> <planId> <phaseId>").description("Update a phase").option("--title <title>", "Phase title").option("--status <status>", "Phase status (pending|in_progress|done|skipped)").option("--notes <notes>", "Phase notes").option("--description <description>", "Phase description").action(async (slug, planId, phaseId, opts) => {
+plansCmd.command("update-phase <slug> <planId> <phaseId>").description("Update a phase").option("--title <title>", "Phase title").option("--status <status>", "Phase status (pending|in_progress|done|skipped)").option("--notes <notes>", "Phase notes").option("--description <description>", "Phase description").option("--claim-id <id>", "Held delivery claim id").option("--claim-generation <n>", "Held claim generation").option("--skills-version <v>", "odin-skills version").action(async (slug, planId, phaseId, opts) => {
   const body = {};
   if (opts.title) body.title = opts.title;
   if (opts.status) body.status = opts.status;
   if (opts.notes) body.notes = opts.notes;
   if (opts.description) body.description = opts.description;
+  Object.assign(body, {
+    ...opts.claimId ? { claim_id: opts.claimId, claim_generation: Number(opts.claimGeneration) } : {},
+    ...opts.skillsVersion ? { skills_version: opts.skillsVersion } : {}
+  });
   const res = await apiRequest(`/pebbles/${slug}/plans/${planId}/phases/${phaseId}`, {
     method: "PUT",
     body
@@ -1276,7 +1285,7 @@ betsCmd.command("delete <slug> <id>").description("Delete a bet").action(async (
   if (res.error) process.exit(1);
 });
 betsCmd.addCommand(depsCmd);
-betsCmd.command("transition <slug> <id>").description("Apply a guarded lifecycle operation (never a raw status write)").requiredOption("--op <operation>", "start_shaping | approve_ready | handoff | complete | return_to_shaping | archive | correct_stage | open_blocker | resolve_blocker | set_queued | clear_queued").requiredOption("--expected-revision <n>", "lifecycle_revision from `odin bets get`").option("--to <stage>", `Target stage for handoff/correct_stage (${STAGE_HELP})`).option("--reason <text>", "Reason (required for return loops, skips and return_to_shaping)").option("--note <text>", "Optional correction/resolution note").option("--actor <label>", "Persona slug or handle recorded on the event", "cli").option("--actor-kind <kind>", "human | persona", "human").option("--idempotency-key <key>", "Reuse the same key when retrying after a timeout").option("--payload <json>", "Extra payload JSON merged last (check_token/exceptions, category, blocker_id, owner_persona\u2026)").action(async (slug, id, opts) => {
+betsCmd.command("transition <slug> <id>").description("Apply a guarded lifecycle operation (never a raw status write)").requiredOption("--op <operation>", "start_shaping | approve_ready | handoff | complete | return_to_shaping | archive | correct_stage | open_blocker | resolve_blocker | set_queued | clear_queued").requiredOption("--expected-revision <n>", "lifecycle_revision from `odin bets get`").option("--to <stage>", `Target stage for handoff/correct_stage (${STAGE_HELP})`).option("--reason <text>", "Reason (required for return loops, skips and return_to_shaping)").option("--note <text>", "Optional correction/resolution note").option("--actor <label>", "Persona slug or handle recorded on the event", "cli").option("--actor-kind <kind>", "human | persona", "human").option("--idempotency-key <key>", "Reuse the same key when retrying after a timeout").option("--payload <json>", "Extra payload JSON merged last (check_token/exceptions, category, blocker_id, owner_persona\u2026)").option("--claim-id <id>", "Held delivery claim id").option("--claim-generation <n>", "Held claim generation").option("--skills-version <v>", "odin-skills version").action(async (slug, id, opts) => {
   let extra = {};
   if (opts.payload) {
     try {
@@ -1287,7 +1296,16 @@ betsCmd.command("transition <slug> <id>").description("Apply a guarded lifecycle
     }
   }
   const payload = { ...opts.to ? { to_stage: opts.to } : {}, ...opts.reason ? { reason: opts.reason } : {}, ...opts.note ? { note: opts.note } : {}, ...extra };
-  const body = { operation: opts.op, expected_revision: Number(opts.expectedRevision), idempotency_key: opts.idempotencyKey ?? randomUUID(), actor_label: opts.actor, actor_kind: opts.actorKind, payload };
+  const body = {
+    operation: opts.op,
+    expected_revision: Number(opts.expectedRevision),
+    idempotency_key: opts.idempotencyKey ?? randomUUID(),
+    actor_label: opts.actor,
+    actor_kind: opts.actorKind,
+    payload,
+    ...opts.claimId ? { claim_id: opts.claimId, claim_generation: Number(opts.claimGeneration) } : {},
+    ...opts.skillsVersion ? { skills_version: opts.skillsVersion } : {}
+  };
   const res = await apiRequest(`/pebbles/${slug}/bets/${id}/lifecycle`, { method: "POST", body });
   process.stdout.write(JSON.stringify(res) + "\n");
   if (res.error) process.exit(1);
@@ -1308,9 +1326,32 @@ betsCmd.command("lifecycle-contract").description("Stages, transition matrix, Re
   if (res.error) process.exit(1);
 });
 
-// src/commands/tickets.ts
+// src/commands/delivery.ts
 import { Command as Command15 } from "commander";
-var ticketsCmd = new Command15("tickets").description("Resolve human-readable ticket IDs");
+var deliveryCmd = new Command15("delivery").description("Delivery admission: claim, validate, release (DELIVERY-ADMISSION-REFERENCE.md)");
+var out = (res, okWhen) => {
+  process.stdout.write(JSON.stringify(res) + "\n");
+  if (res.error || !okWhen(res.data)) process.exit(1);
+};
+deliveryCmd.command("claim <slug>").option("--bet <id>").requiredOption("--persona <slug>").requiredOption("--attempt-id <id>").option("--host <host>").action(async (slug, o) => {
+  const res = await apiRequest(`/pebbles/${slug}/delivery/claim`, {
+    method: "POST",
+    body: { ...o.bet ? { bet_id: o.bet } : {}, persona: o.persona, attempt_id: o.attemptId, ...o.host ? { host: o.host } : {} }
+  });
+  out(res, (d) => ["granted", "no_work", "resource_wait"].includes(d?.outcome));
+});
+deliveryCmd.command("validate <slug> <betId>").requiredOption("--claim-id <id>").requiredOption("--claim-generation <n>").action(async (slug, betId, o) => {
+  const res = await apiRequest(`/pebbles/${slug}/delivery/validate`, { method: "POST", body: { bet_id: betId, claim_id: o.claimId, claim_generation: Number(o.claimGeneration) } });
+  out(res, (d) => d?.valid === true);
+});
+deliveryCmd.command("release <slug>").requiredOption("--claim-id <id>").requiredOption("--claim-generation <n>").option("--scope <scope>", "claim | migration", "claim").option("--actor <label>", "persona slug", "cli").action(async (slug, o) => {
+  const res = await apiRequest(`/pebbles/${slug}/delivery/release`, { method: "POST", body: { claim_id: o.claimId, claim_generation: Number(o.claimGeneration), scope: o.scope, actor_label: o.actor } });
+  out(res, (d) => d?.ok === true);
+});
+
+// src/commands/tickets.ts
+import { Command as Command16 } from "commander";
+var ticketsCmd = new Command16("tickets").description("Resolve human-readable ticket IDs");
 ticketsCmd.command("resolve <key>").description("Resolve a ticket key (e.g. ODIN-12, RATE-36A) to its bet or task, with historical candidates").action(async (key) => {
   const res = await apiRequest(`/tickets/${encodeURIComponent(key.trim().toUpperCase())}`);
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -1323,9 +1364,9 @@ ticketsCmd.command("resolve <key>").description("Resolve a ticket key (e.g. ODIN
 });
 
 // src/commands/bet-comments.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 import { readFileSync as readFileSync11 } from "fs";
-var betCommentsCmd = new Command16("bet-comments").description("Manage bet comments");
+var betCommentsCmd = new Command17("bet-comments").description("Manage bet comments");
 betCommentsCmd.command("list <slug> <betId>").description("List comments for a bet (oldest first)").action(async (slug, betId) => {
   const res = await apiRequest(`/pebbles/${slug}/bets/${betId}/comments`);
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -1352,9 +1393,9 @@ betCommentsCmd.command("create <slug> <betId> [body]").description("Post a comme
 });
 
 // src/commands/tasks.ts
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 import { readFileSync as readFileSync12 } from "fs";
-var tasksCmd = new Command17("tasks").description("Manage tasks");
+var tasksCmd = new Command18("tasks").description("Manage tasks");
 withListFlags(
   tasksCmd.command("list <slug>").description("List tasks for a pebble").option("--status <status>", "Filter by status").option("--bet <bet-id>", "Filter by bet ID")
 ).action(async (slug, opts) => {
@@ -1415,7 +1456,7 @@ tasksCmd.command("delete <slug> <id>").description("Delete a task").action(async
 });
 
 // src/commands/roadmaps.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 import { readFileSync as readFileSync14 } from "fs";
 
 // src/resolve-pebble.ts
@@ -1438,7 +1479,7 @@ function resolvePebbleSlug(explicit, cwd = process.cwd()) {
 }
 
 // src/commands/roadmaps.ts
-var roadmapsCmd = new Command18("roadmaps").description("Manage roadmaps");
+var roadmapsCmd = new Command19("roadmaps").description("Manage roadmaps");
 roadmapsCmd.command("list <slug>").description("List roadmaps for a pebble").option("--status <status>", "Filter by status").option("--all", "Include child roadmaps (default: top-level only)").action(async (slug, opts) => {
   const params = { nesting: opts.all ? "all" : "top" };
   if (opts.status) params.status = opts.status;
@@ -1524,11 +1565,11 @@ clientDraftCmd.command("save <roadmap-id>").description("Save the draft; --file
 });
 
 // src/commands/persona-runs.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 import { readFileSync as readFileSync15 } from "fs";
 import { join as join3 } from "path";
 import { homedir as homedir2 } from "os";
-var personaRunsCmd = new Command19("persona-runs").description(
+var personaRunsCmd = new Command20("persona-runs").description(
   "Manage per-persona per-session token usage rows"
 );
 personaRunsCmd.command("list <slug>").description("List persona runs for a pebble").option("--bet-id <id>", "Filter by bet_id").option("--plan-id <id>", "Filter by plan_id").option("--persona <name>", "Filter by persona name").option("--limit <n>", "Max rows", "50").action(async (slug, opts) => {
@@ -1625,9 +1666,9 @@ personaRunsCmd.command("capture").description("Read marker + transcript, compute
 });
 
 // src/commands/blog.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 import { readFileSync as readFileSync16 } from "fs";
-var blogCmd = new Command20("blog").description("Manage blog posts");
+var blogCmd = new Command21("blog").description("Manage blog posts");
 blogCmd.command("list <slug>").description("List blog posts for a pebble").option("--status <status>", "Filter by status (draft, review, scheduled, published, archived)").option("--tag <tag>", "Filter by tag").option("--page <page>", "Page number", "1").option("--per-page <perPage>", "Results per page", "20").action(async (slug, opts) => {
   const params = {};
   if (opts.status) params.status = opts.status;
@@ -1692,8 +1733,8 @@ blogCmd.command("delete <slug> <id>").description("Delete a blog post").action(a
 });
 
 // src/commands/api-keys.ts
-import { Command as Command21 } from "commander";
-var apiKeysCmd = new Command21("api-keys").description("Manage API keys for server-to-server access");
+import { Command as Command22 } from "commander";
+var apiKeysCmd = new Command22("api-keys").description("Manage API keys for server-to-server access");
 apiKeysCmd.command("list <slug>").description("List API keys for a pebble").action(async (slug) => {
   const res = await apiRequest(`/pebbles/${slug}/api-keys`);
   process.stdout.write(JSON.stringify(res) + "\n");
@@ -1735,7 +1776,7 @@ apiKeysCmd.command("delete <slug> <id>").description("Permanently delete an API
 });
 
 // src/commands/pebble/index.ts
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 
 // src/commands/pebble/provisioner.ts
 async function runProvisioner(ctx, steps) {
@@ -2148,7 +2189,7 @@ Hand off: /odin:eng-manager bet:${bet.data.id}
 }
 
 // src/commands/pebble/index.ts
-var pebbleCmd = new Command22("pebble").description(
+var pebbleCmd = new Command23("pebble").description(
   "Provision and initialize pebbles (eng-infra, run-once)"
 );
 pebbleCmd.command("new <name>").description("Provision a new pebble from pebble-template (day-one)").option("--run", "Hand off to eng-manager on the init bet").option("--dir <path>", "Parent dir to clone into").option("--dry-run", "Print the plan; mutate nothing").action(async (name, opts) => {
@@ -2169,7 +2210,7 @@ pebbleCmd.command("provision <provider> <slug>").description("Run one provider s
 });
 
 // src/commands/create/index.ts
-import { Command as Command23 } from "commander";
+import { Command as Command24 } from "commander";
 
 // src/commands/create/topology.ts
 var ENVS = ["prd", "stg", "dev"];
@@ -2269,9 +2310,9 @@ var tokensStep = {
     const supabaseAccessToken = await io.secret(
       "Supabase Access Token (TF_VAR_SUPABASE_ACCESS_TOKEN):"
     );
-    const out = { vercelApiToken, vercelToken, supabaseAccessToken };
-    if (vercelTeamId) out.vercelTeamId = vercelTeamId;
-    return out;
+    const out2 = { vercelApiToken, vercelToken, supabaseAccessToken };
+    if (vercelTeamId) out2.vercelTeamId = vercelTeamId;
+    return out2;
   }
 };
 var vercelStep2 = {
@@ -2595,17 +2636,17 @@ var ENV_KEY_MAP = {
   SUPABASE_DB_PASSWORD: "supabaseDbPassword"
 };
 function capturedFromDoppler(prd, stg) {
-  const out = {};
+  const out2 = {};
   for (const [dopplerKey, capKey] of Object.entries(SHARED_KEY_MAP)) {
-    if (prd[dopplerKey]) out[capKey] = prd[dopplerKey];
+    if (prd[dopplerKey]) out2[capKey] = prd[dopplerKey];
   }
-  if (prd.TF_VAR_APP_DOMAIN) out.appDomain = prd.TF_VAR_APP_DOMAIN.replace(/^app\./, "");
+  if (prd.TF_VAR_APP_DOMAIN) out2.appDomain = prd.TF_VAR_APP_DOMAIN.replace(/^app\./, "");
   for (const [env, cfg] of [["prd", prd], ["stg", stg]]) {
     for (const [dopplerKey, capKey] of Object.entries(ENV_KEY_MAP)) {
-      if (cfg[dopplerKey]) out[`${env}_${capKey}`] = cfg[dopplerKey];
+      if (cfg[dopplerKey]) out2[`${env}_${capKey}`] = cfg[dopplerKey];
     }
   }
-  return out;
+  return out2;
 }
 function assembleInputs(ctx) {
   const c = ctx.captured;
@@ -2634,13 +2675,13 @@ function assembleInputs(ctx) {
 }
 
 // src/commands/create/index.ts
-var createCmd = new Command23("create").description(
+var createCmd = new Command24("create").description(
   "Create and provision a new project end to end"
 );
 createCmd.command("project [name]").description("Guided self-serve project + parallel-env provisioning").option("--dry-run", "Print the plan; mutate nothing").action(
   async (name, opts) => process.exit(await runCreate(name, { dryRun: opts.dryRun }))
 );
-var setupCmd = new Command23("setup").description("Alias for `create project`").arguments("[name]").option("--dry-run", "Print the plan; mutate nothing").action(
+var setupCmd = new Command24("setup").description("Alias for `create project`").arguments("[name]").option("--dry-run", "Print the plan; mutate nothing").action(
   async (name, opts) => process.exit(await runCreate(name, { dryRun: opts.dryRun }))
 );
 
@@ -2667,7 +2708,7 @@ ${RESET}
   ${DIM}${cwd}${RESET}
 `);
 }
-var program = new Command24();
+var program = new Command25();
 program.name("odin").description("CLI for Odin \u2014 the knowledge backbone for Pebble House").version(VERSION);
 program.command("login").description("Authenticate with Odin via browser").option("--device", "Use the device-code flow (for headless or remote machines)").action(async (options) => {
   printBanner();
@@ -2696,6 +2737,7 @@ program.addCommand(rulesCmd);
 program.addCommand(briefsCmd);
 program.addCommand(blueprintsCmd);
 program.addCommand(betsCmd);
+program.addCommand(deliveryCmd);
 program.addCommand(ticketsCmd);
 program.addCommand(betCommentsCmd);
 program.addCommand(tasksCmd);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pebblehouse/odin-cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "type": "module",
   "description": "CLI for Odin — the knowledge backbone for Pebble House",
   "bin": {