@m-kopa/launchpad-cli 0.34.1 → 0.36.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html);
 pre-1.0 minor bumps may carry breaking changes per ADR 0005.
 
+## 0.36.0 — 2026-06-18
+
+Feature (sp-rpt9kd, ADR 0029): **`launchpad bug` / `launchpad feature`** — file a
+bug report or feature request straight from the CLI.
+
+- Lands as a Linear issue in the team's dedicated inbox (the AIOps
+  "Launchpad - Bugs/Features" project), tagged `kind:bug`/`kind:feature`,
+  attributed to you. Bot-brokered — the CLI never holds a Linear credential.
+- Non-interactive (`--title`/`--message` or a positional message) so the AI can
+  drive it; a TTY prompts for what's missing. `--json` returns `{ identifier, url }`.
+- **Seat-independent acknowledgement** (you get a reference even without a Linear
+  seat), **duplicate collapsing**, and **fail-soft** (prints your report back if
+  the tracker is unreachable).
+- A small, fixed, non-sensitive context is attached (CLI version, OS, last command
+  **name + exit code — never its arguments**, app slug). Server-side rate-limiting
+  + cross-reporter dedupe guard against floods.
+
+> Requires the portal-bot deploy that ships `POST /reports` + the `ReportRateLimit`
+> DO migration; until then the verbs fail soft.
+
 ## 0.34.1 — 2026-06-18
 
 Fix (sp-pvf8r2, Bundle A): `launchpad watch` now shows the **real** provisioning

package/dist/cli.js

@@ -19,7 +19,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/version.ts
-var CLI_VERSION = "0.34.1";
+var CLI_VERSION = "0.36.0";
 
 // src/config.ts
 import * as os from "node:os";
@@ -11304,6 +11304,7 @@ var BUNDLED_SKILLS = [
   "launchpad-status",
   "launchpad-destroy",
   "launchpad-identity",
+  "launchpad-report",
   "marquee-share"
 ];
 function isBundleManaged(name) {
@@ -12924,6 +12925,179 @@ var emitTelemetryCommand = {
   }
 };
 
+// src/commands/report.ts
+import { createInterface as createInterface6 } from "node:readline/promises";
+import { platform } from "node:os";
+
+// src/report/breadcrumb.ts
+import { writeFileSync as writeFileSync10, readFileSync as readFileSync22, mkdirSync as mkdirSync6 } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { join as join17, dirname as dirname11 } from "node:path";
+function breadcrumbPath() {
+  return join17(homedir6(), ".launchpad", "last-run.json");
+}
+function writeBreadcrumb(verb, exit) {
+  try {
+    const p = breadcrumbPath();
+    mkdirSync6(dirname11(p), { recursive: true });
+    writeFileSync10(p, JSON.stringify({ verb, exit, ts: Date.now() }), "utf8");
+  } catch {}
+}
+function readBreadcrumb() {
+  try {
+    const raw = JSON.parse(readFileSync22(breadcrumbPath(), "utf8"));
+    if (typeof raw !== "object" || raw === null)
+      return null;
+    const r = raw;
+    if (typeof r.verb !== "string")
+      return null;
+    const exit = typeof r.exit === "number" && Number.isFinite(r.exit) ? Math.trunc(r.exit) : 0;
+    return { verb: r.verb, exit };
+  } catch {
+    return null;
+  }
+}
+
+// src/commands/report.ts
+function realDeps2() {
+  return {
+    loadConfig,
+    apiJson,
+    isTty: () => process.stdout.isTTY === true && process.stdin.isTTY === true,
+    prompt: async (question) => {
+      const rl = createInterface6({ input: process.stdin, output: process.stdout });
+      try {
+        return (await rl.question(question)).trim();
+      } finally {
+        rl.close();
+      }
+    },
+    cliVersion: CLI_VERSION,
+    os: platform(),
+    cwd: () => process.cwd(),
+    readBreadcrumb
+  };
+}
+function parseArgs15(args) {
+  let title;
+  let message;
+  let positional;
+  let json = false;
+  for (let i = 0;i < args.length; i++) {
+    const a = args[i];
+    if (a === "--json")
+      json = true;
+    else if (a === "--title") {
+      const v = args[i + 1];
+      if (v !== undefined && !v.startsWith("-")) {
+        title = v;
+        i++;
+      }
+    } else if (a === "--message" || a === "-m") {
+      const v = args[i + 1];
+      if (v !== undefined && !v.startsWith("-")) {
+        message = v;
+        i++;
+      }
+    } else if (a !== undefined && !a.startsWith("-") && positional === undefined) {
+      positional = a;
+    }
+  }
+  return { title, message, positional, json };
+}
+var NOUN = { bug: "bug report", feature: "feature request" };
+async function runReport(kind, args, io, deps) {
+  const verb = kind;
+  const parsed = parseArgs15(args);
+  let message = parsed.message ?? parsed.positional ?? "";
+  let title = parsed.title ?? "";
+  if (message === "" && deps.isTty()) {
+    title = title || await deps.prompt(`${NOUN[kind]} — title: `);
+    message = await deps.prompt("description: ");
+  }
+  if (title === "")
+    title = deriveTitle(message);
+  if (title === "" && message === "") {
+    io.err(`usage: launchpad ${verb} "<description>" [--title <t>] [--json]`);
+    return 64;
+  }
+  const ctx = buildContext(deps);
+  try {
+    const cfg = deps.loadConfig();
+    const resp = await deps.apiJson(cfg, {
+      method: "POST",
+      path: "/reports",
+      jsonBody: { kind, title, message, context: ctx },
+      nonThrowingStatuses: [400, 429, 502, 503]
+    });
+    if (parsed.json) {
+      io.out(JSON.stringify(resp));
+      return resp.identifier !== undefined ? 0 : 1;
+    }
+    if (resp.identifier !== undefined) {
+      if (resp.duplicate === true) {
+        io.out(`✓ Already reported as ${resp.identifier} — thanks, no need to file again.`);
+      } else {
+        io.out(`✓ Filed your ${NOUN[kind]} as ${resp.identifier}.`);
+        io.out("  The team is notified — no further action needed.");
+        if (resp.url)
+          io.out(`  ${resp.url}`);
+      }
+      return 0;
+    }
+    if (resp.error === "rate_limited") {
+      io.err(`launchpad ${verb}: ${resp.message ?? "rate limited"} (retry in ~${resp.retryAfterSec ?? 60}s).`);
+      return 1;
+    }
+    if (resp.error === "bad_request") {
+      io.err(`launchpad ${verb}: ${resp.message ?? "invalid report"}.`);
+      return 64;
+    }
+    return failSoft(verb, kind, title, message, io);
+  } catch (e) {
+    if (e instanceof UnauthenticatedError) {
+      io.err(`${e.message}`);
+      return 1;
+    }
+    return failSoft(verb, kind, title, message, io);
+  }
+}
+function failSoft(verb, kind, title, message, io) {
+  io.err(`launchpad ${verb}: couldn't reach the tracker — your ${NOUN[kind]} was NOT filed.`);
+  io.err("Here it is to paste manually:");
+  io.err(`  Title: ${title}`);
+  if (message)
+    io.err(`  ${message}`);
+  return 1;
+}
+function deriveTitle(message) {
+  const firstLine = message.split(`
+`)[0]?.trim() ?? "";
+  return firstLine.length > 80 ? `${firstLine.slice(0, 77)}…` : firstLine;
+}
+function buildContext(deps) {
+  const ctx = {
+    cliVersion: deps.cliVersion,
+    os: deps.os
+  };
+  const crumb = deps.readBreadcrumb();
+  if (crumb) {
+    ctx.lastVerb = crumb.verb;
+    ctx.lastExit = String(crumb.exit);
+  }
+  const slug = inferSlugFromCwd(deps.cwd());
+  if (slug)
+    ctx.appSlug = slug;
+  return ctx;
+}
+function makeReportCommand(kind, deps = realDeps2()) {
+  return {
+    name: kind,
+    summary: kind === "bug" ? "file a bug report (lands in the team's Linear inbox)" : "file a feature request (lands in the team's Linear inbox)",
+    run: (args, io) => runReport(kind, args, io, deps)
+  };
+}
+
 // src/dispatcher.ts
 var COMMANDS = [
   loginCommand,
@@ -12954,6 +13128,8 @@ var COMMANDS = [
   secretsCommand,
   grantEditorCommand,
   revokeEditorCommand,
+  makeReportCommand("bug"),
+  makeReportCommand("feature"),
   refreshUpdateCacheCommand,
   emitTelemetryCommand
 ];
@@ -12975,7 +13151,11 @@ async function dispatch(argv, io, commands = COMMANDS) {
     io.err("Run `launchpad --help` for the list of available commands.");
     return 64;
   }
-  return cmd.run(rest, io);
+  const code = await cmd.run(rest, io);
+  if (!cmd.hidden && verb !== "bug" && verb !== "feature") {
+    writeBreadcrumb(verb, code);
+  }
+  return code;
 }
 function printHelp6(io, commands) {
   io.out("launchpad — manage Launchpad-deployed apps from the command line.");

package/dist/commands/report.d.ts

@@ -0,0 +1,17 @@
+import { readBreadcrumb } from "../report/breadcrumb.js";
+import type { CliConfig } from "../config.js";
+import type { ApiRequestOptions } from "../http/api-client.js";
+import type { Command } from "../dispatcher.js";
+export type ReportKind = "bug" | "feature";
+export interface ReportDeps {
+    readonly loadConfig: () => CliConfig;
+    readonly apiJson: <T>(cfg: CliConfig, opts: ApiRequestOptions) => Promise<T>;
+    readonly isTty: () => boolean;
+    readonly prompt: (question: string) => Promise<string>;
+    readonly cliVersion: string;
+    readonly os: string;
+    readonly cwd: () => string;
+    readonly readBreadcrumb: typeof readBreadcrumb;
+}
+export declare function makeReportCommand(kind: ReportKind, deps?: ReportDeps): Command;
+//# sourceMappingURL=report.d.ts.map

package/dist/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/commands/report.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AAEjE,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,cAAc,CAAC;CAChD;AA0KD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,GAAE,UAAuB,GAAG,OAAO,CAS1F"}

package/dist/commands/skills.d.ts

@@ -5,7 +5,7 @@ import type { Command } from "../dispatcher.js";
  * "bundled list matches the skills dir" test in `tests/skills-command.test.ts`
  * enforces this so a newly-added skill dir can't silently go un-installed.
  */
-export declare const BUNDLED_SKILLS: readonly ["launchpad-onboard", "launchpad-deploy", "launchpad-deploy-status", "launchpad-content-pr", "launchpad-status", "launchpad-destroy", "launchpad-identity", "marquee-share"];
+export declare const BUNDLED_SKILLS: readonly ["launchpad-onboard", "launchpad-deploy", "launchpad-deploy-status", "launchpad-content-pr", "launchpad-status", "launchpad-destroy", "launchpad-identity", "launchpad-report", "marquee-share"];
 export declare const skillsCommand: Command;
 interface InstallEnv {
     readonly bundleDir: string;

package/dist/commands/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AASjE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,uLAajB,CAAC;AAcX,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC;AA2CF,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAQ9C"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAS,OAAO,EAAY,MAAM,kBAAkB,CAAC;AASjE;;;;;GAKG;AACH,eAAO,MAAM,cAAc,2MAcjB,CAAC;AAcX,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC;AA2CF,UAAU,UAAU;IAClB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAQ9C"}

package/dist/dispatcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAqDA,MAAM,WAAW,KAAK;IACpB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAmCtC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,KAAK,EACT,QAAQ,GAAE,SAAS,OAAO,EAAa,GACtC,OAAO,CAAC,QAAQ,CAAC,CAmBnB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAyBvE"}
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAuDA,MAAM,WAAW,KAAK;IACpB,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAqCtC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,EAAE,EAAE,KAAK,EACT,QAAQ,GAAE,SAAS,OAAO,EAAa,GACtC,OAAO,CAAC,QAAQ,CAAC,CA0BnB;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAyBvE"}

package/dist/report/breadcrumb.d.ts

@@ -0,0 +1,9 @@
+export interface Breadcrumb {
+    readonly verb: string;
+    readonly exit: number;
+}
+/** Record the verb + exit code. Best-effort; never throws. */
+export declare function writeBreadcrumb(verb: string, exit: number): void;
+/** Read the last breadcrumb, or null. Best-effort; never throws. */
+export declare function readBreadcrumb(): Breadcrumb | null;
+//# sourceMappingURL=breadcrumb.d.ts.map

package/dist/report/breadcrumb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../src/report/breadcrumb.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAMD,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQhE;AAED,oEAAoE;AACpE,wBAAgB,cAAc,IAAI,UAAU,GAAG,IAAI,CAYlD"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.34.1";
+export declare const CLI_VERSION = "0.36.0";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@m-kopa/launchpad-cli",
-  "version": "0.34.1",
-  "description": "Launchpad CLI — clone / deploy / review / merge against Launchpad-managed apps. Talks to the portal-bot endpoints (SCOPE-M-760 / T4).",
+  "version": "0.36.0",
+  "description": "Launchpad CLI \u2014 clone / deploy / review / merge against Launchpad-managed apps. Talks to the portal-bot endpoints (SCOPE-M-760 / T4).",
   "type": "module",
   "bin": {
     "launchpad": "./dist/cli.js"

package/skills/launchpad-content-pr/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-content-pr
 description: Push a content change to a Launchpad app via `launchpad deploy` and verify it shipped via `launchpad status`. Covers the post-first-deploy iteration loop (edit → deploy → verify) — subsequent deploys commit directly to the app repo's main and the Pages build runs asynchronously, so verification is its own step. Use when someone says "push a content change", "ship an update", "/launchpad-content-pr", "verify my deploy", or after `/launchpad-deploy` reports `done` and they want to follow up with an edit.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-deploy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-deploy
 description: Walk a Launchpad user through deploying an app from their local working directory (Model A — `launchpad init` + `launchpad deploy`). Wraps the CLI verbs end-to-end: detects the app shape, scaffolds `launchpad.yaml`, resolves the allowed Entra group via `launchpad groups`, bundles the CWD via `launchpad deploy`, and watches the rollout via `launchpad status`. Use when someone says "deploy a new app", "ship my app to Launchpad", "/launchpad-deploy", "I have an app locally — get it on Launchpad", or any variant. Resume/abandon for legacy in-flight provisioning is at the bottom.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-deploy-status/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-deploy-status
 description: Show the current provisioning stage + failure reason for a Launchpad app via `launchpad status` (Model A drift + deployment_verified) and `launchpad apps` (lifecycle bucket), or watch provisioning live with `launchpad watch`. Renders the M-892 stage trace for in-flight provisioning, and is the canonical home for `launchpad recover` (repair a terminal-failed app record that is actually live). Use when someone says "what's the status of demo-X", "/launchpad-deploy-status", "is my deploy stuck", "watch my deploy go live", "watch provisioning", "my app says failed but it's serving", or after `/launchpad-deploy` reports a non-`done` terminal stage.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-destroy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-destroy
 description: Tear down a Launchpad app end-to-end via `launchpad destroy` — Cloudflare Pages project, edge-auth wiring (gateway KV/audience entries, or the Access app for `auth: access` apps), custom hostname, platform-repo TF, and the app repo (archive-renamed). Owner-only verb with a two-step destructive confirmation. Use when someone says "destroy this app", "/launchpad-destroy", "tear down `<slug>`", "delete the app", or asks to clean up a smoke-test / orphan / retired app.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-identity/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-identity
 description: Teach an app author how to use the signed-in user's identity inside a Launchpad app — read the gateway-forwarded X-Launchpad-User-Assertion in a Pages Function, VERIFY it with @m-kopa/platform-auth (fail-closed), and show who's logged in (sub/email/name). Use when someone says "who is logged in", "show the current user", "get the user's email in my app", "auth in my launchpad app", "read the user identity", "/launchpad-identity", or is wiring up an /api/me for a gateway-fronted app.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-onboard/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-onboard
 description: One-time setup for the Launchpad CLI + Claude Code skill bundle. Verifies the `launchpad` CLI is installed and current, runs `launchpad whoami` to confirm the session is fresh, and checks the bundled skills are installed and in lock-step with the CLI. Idempotent — safe to re-run any time. Use when someone says "set me up for Launchpad", "I just got a new machine and want to use Launchpad", "/launchpad-onboard", or any of the other launchpad-* skills fails on a prereq check.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->

package/skills/launchpad-report/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: launchpad-report
+description: File a bug report or feature request to the Launchpad team's tracker from the CLI. Use when someone reports something broken, hits an error in a launchpad command, or wishes a feature existed — e.g. "this is broken", "report a bug", "can you file that", "I wish launchpad could…", "/launchpad-bug", "/launchpad-feature". Always confirm and show exactly what you'll send before filing; never file silently.
+version: 0.36.0
+---
+
+<!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->
+## Shell contract — read this first
+
+Every fenced `bash` block below MUST be sent to the `Bash` tool **verbatim**.
+Do not rewrite into PowerShell, cmd, zsh-isms, or "equivalent" forms.
+
+- macOS / Linux: the `Bash` tool runs system bash.
+- Windows: the `Bash` tool runs Git for Windows (MSYS) bash. `$HOME`,
+  forward slashes, `test -f`, `command -v`, heredocs, and `[[ … ]]` all
+  work. There is no reason to translate to `Test-Path`, `$env:USERPROFILE`,
+  `Get-Content`, `Where-Object`, `Get-ChildItem`, or backslash paths —
+  doing so will fail with `/usr/bin/bash: syntax error`.
+
+If a step genuinely needs OS branching, branch *inside* bash:
+
+```bash
+case "$(uname -s)" in
+  Darwin)               : ;;
+  Linux)                : ;;
+  MINGW*|MSYS*|CYGWIN*) : ;;
+esac
+```
+<!-- END shell-contract -->
+
+## What this does
+
+`launchpad bug` and `launchpad feature` file a report straight into the team's
+Linear inbox (bot-brokered — no credentials needed locally). Use them when the
+user reports a problem or wishes for a feature.
+
+## Rules (read first)
+
+1. **Never file silently.** Before running the command, show the user the exact
+   title + description you're about to send and ask them to confirm. The CLI
+   attaches a little non-sensitive context automatically (CLI version, OS, last
+   command name + exit code, app slug) — you don't add it.
+2. **Don't paste secrets.** Put only the user's description in `--message`. Never
+   include tokens, secret values, or full command lines with arguments.
+3. **Don't double-file.** One report per issue per conversation. If you already
+   filed it (or the CLI says it's a duplicate), tell the user the reference rather
+   than filing again.
+
+## How to file
+
+Pick the verb by intent — a defect is a `bug`, a wish is a `feature`:
+
+```bash
+launchpad bug --title "watch hangs after a failed deploy" \
+  --message "After a failed deploy, launchpad watch never exits." --json
+```
+
+```bash
+launchpad feature --title "pin a default region" \
+  --message "Allow a default region in launchpad.yaml so I don't pass --region." --json
+```
+
+`--json` returns `{ "identifier": "AIO-…", "url": "…" }`. Report the `identifier`
+back to the user as confirmation (they may not have a Linear seat to open the URL).
+
+## Handling the result
+
+- **Success** → tell the user: "Filed as `AIO-…` — the team's notified."
+- **Duplicate** (`"duplicate": true`) → "That's already tracked as `AIO-…`."
+- **Failure / non-zero exit** → the CLI prints the report back; offer it to the
+  user to file manually. Do not retry in a loop.

package/skills/launchpad-status/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: launchpad-status
 description: Show whether a Launchpad app's local launchpad.yaml matches what's deployed, and read the deployed manifest. Wraps `launchpad pull` (fetch deployed YAML) and `launchpad status` (drift report). Use when someone says "is my app in sync", "what's deployed", "show drift", "/launchpad-status", "/launchpad-pull", or after `launchpad deploy` to verify the change landed.
-version: 0.34.1
+version: 0.36.0
 ---
 
 <!-- BEGIN shell-contract (managed by scripts/sync-skill-contract.sh — edit skills/_partials/shell-contract.md) -->