opendevbrowser 0.0.20 → 0.0.22

package/README.md

@@ -99,20 +99,29 @@ cd <public-repo-root>
 npm pack
 
 WORKDIR=$(mktemp -d /tmp/opendevbrowser-first-run-XXXXXX)
+ISOLATED_ROOT=$(mktemp -d /tmp/opendevbrowser-first-run-isolated-XXXXXX)
+export HOME="$ISOLATED_ROOT/home"
+export OPENCODE_CONFIG_DIR="$ISOLATED_ROOT/opencode-config"
+export OPENCODE_CACHE_DIR="$ISOLATED_ROOT/opencode-cache"
+export CODEX_HOME="$ISOLATED_ROOT/codex-home"
+export CLAUDECODE_HOME="$ISOLATED_ROOT/claudecode-home"
+export AMP_CLI_HOME="$ISOLATED_ROOT/ampcli-home"
 cd "$WORKDIR"
 npm init -y
-npm install <public-repo-root>/opendevbrowser-0.0.20.tgz
+npm install <public-repo-root>/opendevbrowser-0.0.21.tgz
 npx --no-install opendevbrowser --help
 npx --no-install opendevbrowser help
 ```
 
 Published npm consumer proof is tracked separately in [docs/RELEASE_RUNBOOK.md](docs/RELEASE_RUNBOOK.md) through `scripts/registry-consumer-smoke.mjs`.
 
+Set `OPDEVBROWSER_SKIP_POSTINSTALL_SKILL_SYNC=1` before `npm install` only if you need a packaging smoke test that avoids the install-time managed-skill refresh entirely.
+
 See [docs/FIRST_RUN_ONBOARDING.md](docs/FIRST_RUN_ONBOARDING.md) for the full onboarding checklist, [docs/DEPENDENCIES.md](docs/DEPENDENCIES.md) for runtime inventory, and [docs/SURFACE_REFERENCE.md](docs/SURFACE_REFERENCE.md) for the live CLI and tool surface.
 
 Successful installs reconcile daemon auto-start on supported platforms so the relay is available on login. If the current CLI entrypoint lives under a transient temp-root path such as a first-run `/tmp` or `/private/tmp` workspace, OpenDevBrowser refuses to persist that path as auto-start. Rerun `opendevbrowser daemon install`, or `npx --no-install opendevbrowser daemon install` from a persistent local package install, from a stable install location if you want login auto-start; remove it later with `opendevbrowser daemon uninstall`.
 
-Bundled skills sync to **OpenCode, Codex, ClaudeCode, and AmpCLI** targets during install. Use `--skills-global` for user-wide installs or `--skills-local` for project-local installs; see [docs/CLI.md](docs/CLI.md) for exact target paths.
+Bundled skills sync to **OpenCode, Codex, ClaudeCode, and AmpCLI** targets during install. `npx opendevbrowser` manages global or project-local targets according to the selected skills mode, and package installation (`npm install -g`, local tarball install, or equivalent) best-effort syncs the canonical bundled packs into the managed global targets during package `postinstall`. See [docs/CLI.md](docs/CLI.md) for exact target paths.
 
 ### CLI + Extension (No OpenCode)
 
@@ -265,12 +274,12 @@ Start every surface check from generated help when you need the current public l
 
 ## Recent Features
 
-### v0.0.20 (Current release cycle)
+### v0.0.21 (Current release cycle)
 
-- **Operator review and inspection are now first-class surfaces** with dedicated `review`, `review-desktop`, `session-inspector audit`, `session-inspector plan`, and `status-capabilities` entry points across the CLI and tool layers.
-- **Inspire Design is now a first-class workflow surface** with provider contracts, capture lanes, parity coverage, and release-facing docs instead of partial workflow wiring.
-- **Help-led discoverability is stronger** because the generated help surface now carries canonical next-step guidance and release-facing metadata for the new operator and workflow lanes.
-- **Live audit and release harnesses are more honest under load** because env-limited classification, foreign relay ownership handling, desktop observation capture, and shopping follow-up classification were tightened instead of being reported as ambiguous failures.
+- **Workflow success handoffs are now first-class across the main workflow lanes** with explicit follow-through metadata for research, shopping, product-video, and Inspire Design instead of generic success text.
+- **Macro execution reports blocker truthfully** because `macro-resolve --execute` now preserves blocked execution wording when runtime blocker metadata survives the run.
+- **Release validation is more stable under extension mode** because the live harnesses reuse healthy relay ownership and the product-video follow-through or timeout teardown paths no longer drift into false failures.
+- **Help and docs now treat Inspire Design's canvas handoff as the reference workflow contract** for operator next-step guidance.
 
 ### v0.0.16
 
@@ -478,8 +487,9 @@ OpenDevBrowser includes **9 OpenDevBrowser-specific skill packs**. Install, upda
 
 Installer note:
 - `--skills-global` and `--skills-local` sync the 9 canonical `opendevbrowser-*` packs into managed global or project-local agent directories.
+- Managed installs write a target-level ownership marker, so later update and uninstall only act on CLI-managed skill targets or older config installs that already contain canonical packs.
 - Reinstall and update refresh drifted managed copies and leave matching packs unchanged.
-- Uninstall removes managed canonical packs and only prunes legacy `research` or `shopping` leftovers when those directories are empty and clearly obsolete.
+- Uninstall removes managed canonical packs, retires repo-owned legacy alias directories that match shipped content, and leaves unrelated directories untouched.
 
 Skills are discovered from (priority order):
 1. `.opencode/skill/` (project)

package/dist/chunk-3ILXPKSJ.js

@@ -0,0 +1,86 @@
+// src/utils/package-assets.ts
+import * as fs from "fs";
+import * as path from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_NAME = "opendevbrowser";
+var SKILLS_DIR_NAME = "skills";
+var cachedPackageRoot = null;
+function findPackageRoot(startDir) {
+  let current = startDir;
+  while (true) {
+    const pkgPath = path.join(current, "package.json");
+    if (fs.existsSync(pkgPath)) {
+      try {
+        const parsed = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        if (parsed.name === PACKAGE_NAME) {
+          return current;
+        }
+      } catch {
+      }
+    }
+    const parent = path.dirname(current);
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  return null;
+}
+function getPackageRoot() {
+  if (cachedPackageRoot) {
+    return cachedPackageRoot;
+  }
+  const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+  const packageRoot = findPackageRoot(moduleDir);
+  if (!packageRoot) {
+    throw new Error(`Unable to locate ${PACKAGE_NAME} package root.`);
+  }
+  cachedPackageRoot = packageRoot;
+  return cachedPackageRoot;
+}
+function findBundledSkillsDir() {
+  try {
+    const skillsDir = path.join(getPackageRoot(), SKILLS_DIR_NAME);
+    return fs.existsSync(skillsDir) ? skillsDir : null;
+  } catch {
+    return null;
+  }
+}
+function getBundledSkillsDir() {
+  const skillsDir = findBundledSkillsDir();
+  if (!skillsDir) {
+    throw new Error(`Bundled skills directory not found in ${PACKAGE_NAME} package.`);
+  }
+  return skillsDir;
+}
+
+// src/skills/bundled-skill-directories.ts
+var bundledSkillDirectories = [
+  { name: "opendevbrowser-best-practices" },
+  { name: "opendevbrowser-continuity-ledger" },
+  { name: "opendevbrowser-data-extraction" },
+  { name: "opendevbrowser-design-agent" },
+  { name: "opendevbrowser-form-testing" },
+  { name: "opendevbrowser-login-automation" },
+  { name: "opendevbrowser-product-presentation-asset" },
+  { name: "opendevbrowser-research" },
+  { name: "opendevbrowser-shopping" }
+];
+var bundledSkillDirectoryByName = new Map(
+  bundledSkillDirectories.map((entry) => [entry.name, entry])
+);
+function listBundledSkillDirectories() {
+  return [...bundledSkillDirectories];
+}
+function isBundledSkillName(name) {
+  return bundledSkillDirectoryByName.has(name);
+}
+
+export {
+  getPackageRoot,
+  findBundledSkillsDir,
+  getBundledSkillsDir,
+  listBundledSkillDirectories,
+  isBundledSkillName
+};
+//# sourceMappingURL=chunk-3ILXPKSJ.js.map

package/dist/chunk-3ILXPKSJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/package-assets.ts","../src/skills/bundled-skill-directories.ts"],"sourcesContent":["import * as fs from \"fs\";\nimport * as path from \"path\";\nimport { fileURLToPath } from \"url\";\n\nconst PACKAGE_NAME = \"opendevbrowser\";\nconst SKILLS_DIR_NAME = \"skills\";\n\nlet cachedPackageRoot: string | null = null;\n\nfunction findPackageRoot(startDir: string): string | null {\n  let current = startDir;\n\n  while (true) {\n    const pkgPath = path.join(current, \"package.json\");\n    if (fs.existsSync(pkgPath)) {\n      try {\n        const parsed = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\")) as { name?: string };\n        if (parsed.name === PACKAGE_NAME) {\n          return current;\n        }\n      } catch {\n        void 0;\n      }\n    }\n\n    const parent = path.dirname(current);\n    if (parent === current) {\n      break;\n    }\n    current = parent;\n  }\n\n  return null;\n}\n\nexport function getPackageRoot(): string {\n  if (cachedPackageRoot) {\n    return cachedPackageRoot;\n  }\n  const moduleDir = path.dirname(fileURLToPath(import.meta.url));\n  const packageRoot = findPackageRoot(moduleDir);\n  if (!packageRoot) {\n    throw new Error(`Unable to locate ${PACKAGE_NAME} package root.`);\n  }\n  cachedPackageRoot = packageRoot;\n  return cachedPackageRoot;\n}\n\nexport function findBundledSkillsDir(): string | null {\n  try {\n    const skillsDir = path.join(getPackageRoot(), SKILLS_DIR_NAME);\n    return fs.existsSync(skillsDir) ? skillsDir : null;\n  } catch {\n    return null;\n  }\n}\n\nexport function getBundledSkillsDir(): string {\n  const skillsDir = findBundledSkillsDir();\n  if (!skillsDir) {\n    throw new Error(`Bundled skills directory not found in ${PACKAGE_NAME} package.`);\n  }\n  return skillsDir;\n}\n","export interface BundledSkillDirectory {\n  name: string;\n}\n\nexport const bundledSkillDirectories: BundledSkillDirectory[] = [\n  { name: \"opendevbrowser-best-practices\" },\n  { name: \"opendevbrowser-continuity-ledger\" },\n  { name: \"opendevbrowser-data-extraction\" },\n  { name: \"opendevbrowser-design-agent\" },\n  { name: \"opendevbrowser-form-testing\" },\n  { name: \"opendevbrowser-login-automation\" },\n  { name: \"opendevbrowser-product-presentation-asset\" },\n  { name: \"opendevbrowser-research\" },\n  { name: \"opendevbrowser-shopping\" }\n];\n\nconst bundledSkillDirectoryByName = new Map(\n  bundledSkillDirectories.map((entry) => [entry.name, entry] as const)\n);\n\nexport function listBundledSkillDirectories(): BundledSkillDirectory[] {\n  return [...bundledSkillDirectories];\n}\n\nexport function getBundledSkillDirectory(name: string): BundledSkillDirectory | null {\n  return bundledSkillDirectoryByName.get(name) ?? null;\n}\n\nexport function isBundledSkillName(name: string): boolean {\n  return bundledSkillDirectoryByName.has(name);\n}\n"],"mappings":";AAAA,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,qBAAqB;AAE9B,IAAM,eAAe;AACrB,IAAM,kBAAkB;AAExB,IAAI,oBAAmC;AAEvC,SAAS,gBAAgB,UAAiC;AACxD,MAAI,UAAU;AAEd,SAAO,MAAM;AACX,UAAM,UAAe,UAAK,SAAS,cAAc;AACjD,QAAO,cAAW,OAAO,GAAG;AAC1B,UAAI;AACF,cAAM,SAAS,KAAK,MAAS,gBAAa,SAAS,OAAO,CAAC;AAC3D,YAAI,OAAO,SAAS,cAAc;AAChC,iBAAO;AAAA,QACT;AAAA,MACF,QAAQ;AAAA,MAER;AAAA,IACF;AAEA,UAAM,SAAc,aAAQ,OAAO;AACnC,QAAI,WAAW,SAAS;AACtB;AAAA,IACF;AACA,cAAU;AAAA,EACZ;AAEA,SAAO;AACT;AAEO,SAAS,iBAAyB;AACvC,MAAI,mBAAmB;AACrB,WAAO;AAAA,EACT;AACA,QAAM,YAAiB,aAAQ,cAAc,YAAY,GAAG,CAAC;AAC7D,QAAM,cAAc,gBAAgB,SAAS;AAC7C,MAAI,CAAC,aAAa;AAChB,UAAM,IAAI,MAAM,oBAAoB,YAAY,gBAAgB;AAAA,EAClE;AACA,sBAAoB;AACpB,SAAO;AACT;AAEO,SAAS,uBAAsC;AACpD,MAAI;AACF,UAAM,YAAiB,UAAK,eAAe,GAAG,eAAe;AAC7D,WAAU,cAAW,SAAS,IAAI,YAAY;AAAA,EAChD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEO,SAAS,sBAA8B;AAC5C,QAAM,YAAY,qBAAqB;AACvC,MAAI,CAAC,WAAW;AACd,UAAM,IAAI,MAAM,yCAAyC,YAAY,WAAW;AAAA,EAClF;AACA,SAAO;AACT;;;AC3DO,IAAM,0BAAmD;AAAA,EAC9D,EAAE,MAAM,gCAAgC;AAAA,EACxC,EAAE,MAAM,mCAAmC;AAAA,EAC3C,EAAE,MAAM,iCAAiC;AAAA,EACzC,EAAE,MAAM,8BAA8B;AAAA,EACtC,EAAE,MAAM,8BAA8B;AAAA,EACtC,EAAE,MAAM,kCAAkC;AAAA,EAC1C,EAAE,MAAM,4CAA4C;AAAA,EACpD,EAAE,MAAM,0BAA0B;AAAA,EAClC,EAAE,MAAM,0BAA0B;AACpC;AAEA,IAAM,8BAA8B,IAAI;AAAA,EACtC,wBAAwB,IAAI,CAAC,UAAU,CAAC,MAAM,MAAM,KAAK,CAAU;AACrE;AAEO,SAAS,8BAAuD;AACrE,SAAO,CAAC,GAAG,uBAAuB;AACpC;AAMO,SAAS,mBAAmB,MAAuB;AACxD,SAAO,4BAA4B,IAAI,IAAI;AAC7C;","names":[]}

package/dist/{chunk-LMNFPJRI.js → chunk-OGE5KJ4X.js}

@@ -1,6 +1,6 @@
 import {
   SkillLoader
-} from "./chunk-3VA6XR25.js";
+} from "./chunk-STGGGVYT.js";
 import {
   writeFileAtomic
 } from "./chunk-TBUCZX4A.js";
@@ -27,7 +27,7 @@ import {
   runResearchWorkflow,
   runShoppingWorkflow,
   toSnippet
-} from "./chunk-C6QUKABT.js";
+} from "./chunk-ZE2E7ZGH.js";
 import {
   ProviderRuntimeError
 } from "./chunk-FUSXMW3G.js";
@@ -31811,7 +31811,7 @@ var DAEMON_STATUS_RETRY_OPTIONS = {
   retryDelayMs: 250
 };
 var DAEMON_RESTART_STATUS_TIMEOUT_MS = 5e3;
-var DAEMON_RESTART_POLL_ATTEMPTS = 20;
+var DAEMON_RESTART_READY_TIMEOUT_MS = 15e3;
 var DAEMON_RESTART_POLL_DELAY_MS = 250;
 var cachedClientState;
 var getClientStateFilePath = () => {
@@ -32172,18 +32172,19 @@ var restartDaemonConnection = async (connection) => {
   child.unref();
 };
 var waitForCurrentDaemonStatus = async (connection) => {
-  for (let attempt = 1; attempt <= DAEMON_RESTART_POLL_ATTEMPTS; attempt += 1) {
+  const deadline = Date.now() + DAEMON_RESTART_READY_TIMEOUT_MS;
+  while (true) {
     const status = await fetchDaemonStatus(connection.port, connection.token, {
       timeoutMs: DAEMON_RESTART_STATUS_TIMEOUT_MS
     });
     if (status?.ok && isCurrentDaemonFingerprint(status.fingerprint)) {
       return status;
     }
-    if (attempt < DAEMON_RESTART_POLL_ATTEMPTS) {
-      await sleep3(DAEMON_RESTART_POLL_DELAY_MS);
+    if (Date.now() >= deadline) {
+      return null;
     }
+    await sleep3(DAEMON_RESTART_POLL_DELAY_MS);
   }
-  return null;
 };
 var resolveMetadataConnection = async (metadataConnection, configuredConnection) => {
   const status = await fetchDaemonStatus(
@@ -32294,6 +32295,7 @@ var onboarding_metadata_default = {
   skillTopic: "quick start",
   validatedSkillTopic: "validated capability lanes",
   designSkillName: "opendevbrowser-design-agent",
+  designSkillTopic: "canvas-contract",
   localOnlyToolNames: [
     "opendevbrowser_prompting_guide",
     "opendevbrowser_skill_list",
@@ -32440,7 +32442,7 @@ var buildAnnotateResult = async (payload) => {
 // src/public-surface/generated-manifest.ts
 var PUBLIC_SURFACE_MANIFEST = {
   "schemaVersion": "2026-04-04",
-  "generatedAt": "2026-04-17T01:10:55.127Z",
+  "generatedAt": "2026-04-20T04:16:59.279Z",
   "cli": {
     "groups": [
       {
@@ -32635,10 +32637,13 @@ var PUBLIC_SURFACE_MANIFEST = {
       {
         "name": "update",
         "description": "Clear cached plugin and refresh managed skill packs",
-        "usage": "npx opendevbrowser update [--global|--local]",
+        "usage": "npx opendevbrowser update [--global|--local] [--skills-global|--skills-local|--no-skills]",
         "flags": [
           "--global",
-          "--local"
+          "--local",
+          "--skills-global",
+          "--skills-local",
+          "--no-skills"
         ],
         "groupId": "install_lifecycle",
         "groupTitle": "Install & Lifecycle",
@@ -32647,10 +32652,11 @@ var PUBLIC_SURFACE_MANIFEST = {
       {
         "name": "uninstall",
         "description": "Remove plugin from config and clean managed skill packs",
-        "usage": "npx opendevbrowser uninstall [--global|--local] [--no-prompt] [--quiet]",
+        "usage": "npx opendevbrowser uninstall [--global|--local] [--no-skills] [--no-prompt] [--quiet]",
         "flags": [
           "--global",
           "--local",
+          "--no-skills",
           "--no-prompt",
           "--quiet"
         ],
@@ -35013,4 +35019,4 @@ export {
   TOOL_SURFACE_ENTRIES
 };
 /* v8 ignore next -- @preserve */
-//# sourceMappingURL=chunk-LMNFPJRI.js.map
+//# sourceMappingURL=chunk-OGE5KJ4X.js.map