@usepowerplant/cli 0.4.12 → 0.4.13

package/README.md

@@ -1,3 +1,9 @@
+<!--
+This file is the public npm page of @usepowerplant/cli. Write only what a
+customer needs. Team procedures go in RELEASING.md, which npm does not publish.
+Rule: docs/client-engineering-rules.md, "Releases".
+-->
+
 # @usepowerplant/cli
 
 Set up a machine for [Powerplant](https://powerplant.sh): enroll it into
@@ -19,7 +25,7 @@ re-run at any time — finished steps are skipped with a note:
 1. **Enroll this machine.** Your browser opens so you can approve the
    machine into your org. On macOS, the credential is encrypted in a local
    file with its key in Keychain; other platforms use a file only your user
-   can read. See [credential storage and reset](../../README.md#quick-staging-reset).
+   can read.
 2. **Install the background service.** The sync service watches your local
    coding-agent sessions (Claude Code, Codex, and Cursor) and uploads the
    ones in scope. If recent sessions name repositories under a macOS-protected
@@ -119,8 +125,10 @@ powerplant update
 That reinstalls `@usepowerplant/cli` with whichever package manager put it
 on this machine (npm, pnpm, bun, or yarn), so the copy that is running is the
 copy that gets replaced, then restarts the background sync onto the new
-version. Running the manager's own global install yourself works too: the
-service notices the new version on disk and restarts itself within moments.
+version. When this machine already has the newest version available to it,
+`update` says so and changes nothing. Running the manager's own global
+install yourself works too: the service notices the new version on disk and
+restarts itself within moments.
 When the install can't be replaced this way (a folder only an administrator
 can write, or a layout the CLI doesn't recognise), `update` says why and
 prints the command to run instead. `powerplant status` tells you when a
@@ -144,134 +152,17 @@ The one exception is a registry that does not serve the release yet (npm's
 cache can lag a publish by a few minutes): the sync tries that release
 again on its next hourly checks, up to three times, and the menu says so.
 
+Powerplant offers your machine a release only after the team has tested
+it, so the version it offers can be older than the newest version listed on
+npm. Powerplant never offers or automatically installs a version older
+than the one you have.
+
 Powerplant also publishes the oldest version it still supports. When yours
 is older, `powerplant status`, `powerplant doctor`, the menu bar app, and
 the sync service log all say so and point you at `powerplant update`. Nothing
 stops working on that notice — an unsupported version keeps syncing, but
 it is no longer tested or fixed, so update when you see it.
 
-### How a release reaches production
-
-The same CLI package serves every environment. Staging, development, and
-agent installs follow npm's `next` tag; enrolled production installs follow
-the exact version promoted through the production API. Fresh installs
-without a tag resolve npm's `latest`. Use a separate staging install below
-to test `next` while keeping your production install on its promoted version.
-
-1. **Release.** The "Release CLI to next" workflow (GitHub Actions,
-   manual) builds the CLI, signs and notarizes the menu bar app into the
-   package, and publishes to the `next` tag. Staging, development, and
-   agent installs with automatic updates enabled check at boot and hourly
-   while the service is running. Sleeping machines, disabled updates, and
-   failed installs can leave a machine behind. Verify the installed staging
-   version and exercise sync and the menu actions you changed before
-   promoting; elapsed time alone is not evidence of testing. Promote only
-   after the workflow's "Wait until npm serves the release" step is green:
-   npm's CDN caches the package document for about five minutes after a
-   publish, and a production machine that checks inside that window gets
-   "no matching version" and waits an hour to try again.
-2. **Promote.** From a repo checkout with npm package access and `gh`
-   signed in, name the version you tested:
-
-   ```bash
-   pnpm cli:promote:release 0.5.0
-   ```
-
-   Or, if `next` still points at that tested version:
-
-   ```bash
-   pnpm cli:promote:release
-   ```
-
-   Omitting the version resolves `next` when the command runs.
-   The script moves npm's `latest` from your terminal, with your security
-   key in the browser (npm requires a live second factor for every
-   dist-tag move, so no CI credential can do this half), then dispatches
-   the Promote CLI workflow, which verifies the tag and points production
-   machines at the same artifact. The script watches the workflow; confirm
-   the pointer write succeeded before calling the promotion complete.
-   If the tag moved but that write failed, fresh installs are ahead of
-   enrolled machines. Re-dispatch **the same version**, then check that run:
-
-   ```bash
-   gh workflow run promote-cli.yml -f version=0.5.0
-   ```
-
-   A failed Slack announcement after a successful pointer write does not
-   undo promotion. Read the failed step before retrying.
-3. **Adopt.** Running production services with automatic updates enabled
-   check for the promoted version at boot and hourly. Other users can
-   update from the menu bar or `powerplant update`; `powerplant status`
-   reports the available version. Until something is promoted, production
-   sees no update target, only the supported-version floor.
-
-Promoting an older version is the brake: production holds there, `latest`
-moves back for new installs, and no enrolled machine ever downgrades. A
-bad release is undone by a new release and a new promotion.
-
-### Staging beside production on one Mac
-
-Use production for day-to-day team work. Staging is for testing enrollment,
-onboarding, and releases. See the [internal machine setup guide](../../README.md#set-up-your-machine)
-for access and data boundaries: running sync in both environments uploads
-and processes eligible sessions twice.
-
-A machine has one global `powerplant` by default, and the background sync
-for each environment runs whatever copy `init` was run from. To try
-releases on staging while production keeps the promoted version, give
-staging its own copy under its own npm prefix and set it up from there:
-
-```bash
-npm install -g --prefix ~/.powerplant-staging @usepowerplant/cli@next
-~/.powerplant-staging/bin/powerplant init --env staging
-```
-
-`init --env staging` registers its own MCP entry, `powerplant-staging`, in each
-selected agent, beside the production `powerplant` entry. Agents see its tools
-as `mcp__powerplant-staging__*`. A CLI older than this change registered
-staging as `powerplant`: if that entry still points at staging, run a bare
-`powerplant connect` from your production install once to restore it. Include
-`--env staging` on every staging command.
-
-The `@next` pin matters: a bare install resolves `latest`, the production
-channel, so the new staging copy would start on the promoted release and
-test nothing until its first update.
-
-The staging daemon runs that copy and updates it in place (the updater
-pins npm to the prefix the running copy lives under), so
-`~/.powerplant-staging` follows the `next` channel while the production
-install follows the promoted one. Run staging commands through that path,
-`~/.powerplant-staging/bin/powerplant status --env staging`.
-Use `~/.powerplant-staging/bin/powerplant update --env staging` to update
-now, then `~/.powerplant-staging/bin/powerplant doctor --env staging` to
-check the installed version, service, and install location.
-
-### Menu bar apps during release testing
-
-The npm package, including `@next`, contains **Powerplant.app**, the
-production app. Only production `init` installs it and the production
-service refreshes it after CLI updates. Staging `init` does neither.
-
-Run **Powerplant Staging.app** separately, alongside production. Its icon
-has an "S", and it uses the CLI at `~/.powerplant-staging/bin/powerplant`
-when present. Follow the menu bar app's [local build instructions](../../apps/menubar/README.md#development)
-or [signed release instructions](../../apps/menubar/README.md#release).
-Rebuild or replace that staging app when testing native app changes;
-updating the staging CLI does not update it. This tests the staging variant,
-not the exact signed production bundle embedded in the npm package.
-
-### Web and API promotion is separate
-
-Merges to `main` deploy to staging automatically. The
-[Promote to Production workflow](../../.github/workflows/promote.yml) can
-promote the live staging API commit after its E2E check passes, with the
-production schema and web build from that commit. Automatic runs happen
-on CI completion and an hourly catch-up during weekdays, 09:00 to before
-16:00 America/Vancouver, unless `AUTO_PROMOTE_PAUSED=true`. A manual
-workflow dispatch can promote outside that window. Staging does not wait
-indefinitely for manual QA. This workflow does not promote the CLI;
-`pnpm cli:promote:release` does not deploy the web or API.
-
 ### Moving from @powerplant-sh/cli
 
 Releases up to 0.2.1 were published as `@powerplant-sh/cli`. That package

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7d73a97a-938c-5f0f-8b6b-c4076b82abad")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="66f773d5-e0b2-5538-a184-3ee15c3a469a")}catch(e){}}();
 const __cliNodeMajor = Number(process.versions.node.split('.')[0]);
 if (__cliNodeMajor < 20) {
   console.error(`powerplant needs Node 20 or newer — this is Node ${process.versions.node}.`);
@@ -85883,11 +85883,11 @@ import path12 from "node:path";
 import { existsSync as existsSync6, lstatSync as lstatSync4 } from "node:fs";
 import path11 from "node:path";
 
-// ../../apps/collector/src/codexTranscriptHints.ts
+// ../../apps/collector/src/codexTranscriptDiscovery.ts
 import { createHash } from "node:crypto";
 import { closeSync, lstatSync, openSync, readSync, readdirSync, realpathSync } from "node:fs";
 import path2 from "node:path";
-var hintSchema = external_exports.object({
+var transcriptDiscoveryRecordSchema = external_exports.object({
   sessionId: external_exports.string().regex(/^[a-zA-Z0-9_-]{1,200}$/),
   transcriptPath: external_exports.string().max(4096).nullable()
 });
@@ -85900,7 +85900,7 @@ function codexTranscriptRecordPath(home, sessionId) {
     `${createHash("sha256").update(sessionId).digest("hex")}.json`
   );
 }
-function readCodexTranscriptHints(home, roots) {
+function readCodexTranscriptDiscoveryRecords(home, roots) {
   const dir = codexTranscriptRecordsDir(home);
   let files;
   try {
@@ -85912,9 +85912,9 @@ function readCodexTranscriptHints(home, roots) {
   for (const file2 of files) {
     if (!/^[a-f0-9]{64}\.json$/.test(file2)) continue;
     try {
-      const hintPath = path2.join(dir, file2);
-      if (!lstatSync(hintPath).isFile()) continue;
-      const fd = openSync(hintPath, "r");
+      const recordPath = path2.join(dir, file2);
+      if (!lstatSync(recordPath).isFile()) continue;
+      const fd = openSync(recordPath, "r");
       let text;
       try {
         const buffer = Buffer.alloc(32 * 1024 + 1);
@@ -85924,10 +85924,10 @@ function readCodexTranscriptHints(home, roots) {
       } finally {
         closeSync(fd);
       }
-      const hint = hintSchema.parse(JSON.parse(text));
-      if (file2 !== `${createHash("sha256").update(hint.sessionId).digest("hex")}.json`) continue;
-      if (hint.transcriptPath === null || !path2.isAbsolute(hint.transcriptPath)) continue;
-      const rolloutPath = path2.normalize(hint.transcriptPath);
+      const record2 = transcriptDiscoveryRecordSchema.parse(JSON.parse(text));
+      if (file2 !== `${createHash("sha256").update(record2.sessionId).digest("hex")}.json`) continue;
+      if (record2.transcriptPath === null || !path2.isAbsolute(record2.transcriptPath)) continue;
+      const rolloutPath = path2.normalize(record2.transcriptPath);
       if (path2.extname(rolloutPath) !== ".jsonl") continue;
       const rootIndex = roots.findIndex((root2) => {
         const relative2 = path2.relative(root2, rolloutPath);
@@ -85937,7 +85937,7 @@ function readCodexTranscriptHints(home, roots) {
       const root = roots[rootIndex];
       if (realpathSync(rolloutPath) !== path2.join(realpathSync(root), path2.relative(root, rolloutPath)))
         continue;
-      result.push({ rolloutPath, sessionId: hint.sessionId, archived: rootIndex === 1 });
+      result.push({ rolloutPath, sessionId: record2.sessionId, archived: rootIndex === 1 });
     } catch {
     }
   }
@@ -85950,7 +85950,7 @@ import { createHmac } from "node:crypto";
 // ../../apps/collector/src/http.ts
 var import_undici = __toESM(require_undici(), 1);
 var CLI_VERSION_HEADER = "x-powerplant-cli-version";
-var cliVersion = true ? "0.4.12" : "0.0.0-checkout";
+var cliVersion = true ? "0.4.13" : "0.0.0-checkout";
 function cliVersionHeaders() {
   return { [CLI_VERSION_HEADER]: cliVersion, "user-agent": `powerplant-cli/${cliVersion}` };
 }
@@ -86257,7 +86257,7 @@ function bindDiagnosticEnrollment(diagnostic, token) {
   passEnrollments.set(diagnostic, token);
 }
 
-// ../../apps/collector/src/codexCli.ts
+// ../../apps/collector/src/codexSessions.ts
 import { closeSync as closeSync3, mkdirSync as mkdirSync2, openSync as openSync3, renameSync, rmSync as rmSync2, utimesSync, writeSync } from "node:fs";
 import os6 from "node:os";
 import path5 from "node:path";
@@ -86697,13 +86697,17 @@ function isPathWithinScopes(resolved, scopePaths) {
   );
 }
 
-// ../../apps/collector/src/codexCli.ts
+// ../../apps/collector/src/codexSessions.ts
 function parseCodexRollout(text, sharedUsage) {
   let meta3 = null;
+  let initialEvent;
+  let records = 0;
   let model;
   const timestamps = [];
   const usage = sharedUsage ?? createCodexUsageReader();
   for (const line of parseJsonl(text)) {
+    records += 1;
+    if (records === 2 && meta3 !== null) initialEvent = line;
     if (typeof line.timestamp === "string") timestamps.push(line.timestamp);
     usage.pushRecord(line);
     const payload = line.payload;
@@ -86719,8 +86723,10 @@ function parseCodexRollout(text, sharedUsage) {
   if (meta3 === null && timestamps.length === 0) return null;
   const git = meta3?.git ?? null;
   const sessionId = meta3?.id ?? meta3?.session_id;
+  const facts = meta3 === null ? {} : harnessSessionFacts("codex", { ...meta3, initialEvent });
   return {
-    kind: meta3 !== null && isSidecarThread(meta3) ? "subagent" : "session",
+    kind: facts.subagent ? "subagent" : "session",
+    ...facts.standaloneReview && { standaloneReview: true },
     ...typeof sessionId === "string" && sessionId !== "" && { sessionId },
     startedAt: timestamps[0],
     endedAt: timestamps[timestamps.length - 1],
@@ -86756,6 +86762,7 @@ function foldRolloutPages(pages, usage) {
   const repoFullName = first("repoFullName");
   return {
     kind: pages[0].kind,
+    ...pages[0].standaloneReview && { standaloneReview: true },
     ...sessionId !== void 0 && { sessionId },
     ...startedAt !== void 0 && { startedAt },
     ...endedAt !== void 0 && { endedAt },
@@ -86777,21 +86784,21 @@ function rolloutIdentity(rolloutPath) {
   if (!conventional) return { threadId: name, page: false };
   return { threadId: threadId2.toLowerCase(), page: pageId !== void 0 };
 }
-function codexSpoolDir(home) {
+function codexMergedTranscriptsDir(home) {
   return path5.join(home, ".config", "powerplant", "codex");
 }
-function mergedSpoolIsFresh(spoolPath, mtimeMs) {
-  const existing = statIfExists(spoolPath);
+function mergedTranscriptIsFresh(mergedTranscriptPath, mtimeMs) {
+  const existing = statIfExists(mergedTranscriptPath);
   return existing !== null && Math.abs(existing.mtimeMs - mtimeMs) < 1;
 }
-var MergedSpoolWriter = class {
-  constructor(spoolPath) {
-    this.spoolPath = spoolPath;
-    mkdirSync2(path5.dirname(spoolPath), { recursive: true, mode: 448 });
-    this.tmpPath = `${spoolPath}.${process.pid}.tmp`;
+var MergedTranscriptWriter = class {
+  constructor(mergedTranscriptPath) {
+    this.mergedTranscriptPath = mergedTranscriptPath;
+    mkdirSync2(path5.dirname(mergedTranscriptPath), { recursive: true, mode: 448 });
+    this.tmpPath = `${mergedTranscriptPath}.${process.pid}.tmp`;
     this.fd = openSync3(this.tmpPath, "w", 384);
   }
-  spoolPath;
+  mergedTranscriptPath;
   tmpPath;
   fd;
   bytes = 0;
@@ -86805,7 +86812,7 @@ var MergedSpoolWriter = class {
   finish(mtimeMs) {
     this.close();
     utimesSync(this.tmpPath, mtimeMs / 1e3, mtimeMs / 1e3);
-    renameSync(this.tmpPath, this.spoolPath);
+    renameSync(this.tmpPath, this.mergedTranscriptPath);
     return this.bytes;
   }
   abandon() {
@@ -86875,7 +86882,7 @@ async function collectCodexSessions(options = {}) {
   const now = options.now ?? Date.now();
   const capture = options.capture ?? captureEverythingUnresolved;
   const maxBytes = options.maxTranscriptBytes ?? MAX_TRANSCRIPT_FILE_BYTES;
-  const spoolDir = options.spoolDir ?? codexSpoolDir(options.homeDir ?? os6.homedir());
+  const mergedTranscriptsDir = options.mergedTranscriptsDir ?? codexMergedTranscriptsDir(options.homeDir ?? os6.homedir());
   const items = [];
   const candidates = [];
   const unreadable = [];
@@ -86886,12 +86893,12 @@ async function collectCodexSessions(options = {}) {
   let largestMergedBytes = 0;
   const externalIdOf = (rolloutPath) => path5.basename(rolloutPath, ".jsonl");
   const files = /* @__PURE__ */ new Map();
-  const observe = async (paths, archived, hintSessionId) => {
+  const observe = async (paths, archived, discoverySessionId) => {
     for (const rolloutPath of paths) {
       const known = files.get(rolloutPath);
       if (known !== void 0) {
-        if (hintSessionId === void 0) delete known.hintSessionIds;
-        else known.hintSessionIds?.push(hintSessionId);
+        if (discoverySessionId === void 0) delete known.discoverySessionIds;
+        else known.discoverySessionIds?.push(discoverySessionId);
         continue;
       }
       await yieldToEventLoop();
@@ -86904,15 +86911,15 @@ async function collectCodexSessions(options = {}) {
         mtimeMs: stat.mtimeMs,
         changedMs: Math.max(stat.mtimeMs, stat.ctimeMs),
         sizeBytes: stat.size,
-        ...hintSessionId !== void 0 && { hintSessionIds: [hintSessionId] }
+        ...discoverySessionId !== void 0 && { discoverySessionIds: [discoverySessionId] }
       });
     }
   };
   const archiveDir = codexArchivedSessionsDir(sessionsDir);
-  const hintHome = options.homeDir ?? (options.codexDir === void 0 ? os6.homedir() : void 0);
-  if (hintHome !== void 0) {
-    for (const hint of readCodexTranscriptHints(hintHome, [sessionsDir, archiveDir])) {
-      await observe([hint.rolloutPath], hint.archived, hint.sessionId);
+  const discoveryHome = options.homeDir ?? (options.codexDir === void 0 ? os6.homedir() : void 0);
+  if (discoveryHome !== void 0) {
+    for (const record2 of readCodexTranscriptDiscoveryRecords(discoveryHome, [sessionsDir, archiveDir])) {
+      await observe([record2.rolloutPath], record2.archived, record2.sessionId);
     }
   }
   await observe(rolloutFiles(sessionsDir), false);
@@ -86927,17 +86934,17 @@ async function collectCodexSessions(options = {}) {
     const stored = dedupeStoreCopies(observed);
     let externalId = externalIdOf((stored.find((file2) => !file2.identity.page) ?? stored[0]).rolloutPath);
     try {
-      const spoolPath = stored.length > 1 ? path5.join(spoolDir, `${threadId2}.jsonl`) : void 0;
+      const mergedTranscriptPath = stored.length > 1 ? path5.join(mergedTranscriptsDir, `${threadId2}.jsonl`) : void 0;
       const changedMs = Math.max(...stored.map((file2) => file2.changedMs));
       if (options.sinceMs !== void 0 && changedMs < options.sinceMs) {
-        const neverMerged = spoolPath !== void 0 && !options.locationsOnly && statIfExists(spoolPath) === null;
+        const neverMerged = mergedTranscriptPath !== void 0 && !options.locationsOnly && statIfExists(mergedTranscriptPath) === null;
         if (!neverMerged) continue;
       }
       await yieldToEventLoop();
       const named = stored.filter((file2) => {
-        if (file2.hintSessionIds === void 0) return true;
+        if (file2.discoverySessionIds === void 0) return true;
         const { sessionId } = rolloutLocation(file2.rolloutPath);
-        return sessionId !== void 0 && file2.hintSessionIds.includes(sessionId);
+        return sessionId !== void 0 && file2.discoverySessionIds.includes(sessionId);
       });
       if (named.length === 0) continue;
       const threadFiles = named.length > 1 ? orderPages(named) : named;
@@ -86967,7 +86974,7 @@ async function collectCodexSessions(options = {}) {
       const thread = {
         externalId,
         files: threadFiles,
-        ...threadFiles.length > 1 && spoolPath !== void 0 && { spoolPath },
+        ...threadFiles.length > 1 && mergedTranscriptPath !== void 0 && { mergedTranscriptPath },
         mtimeMs,
         archived: threadFiles.every((file2) => file2.archived)
       };
@@ -87017,8 +87024,8 @@ async function collectCodexSessions(options = {}) {
     const { thread, cwd, decision } = candidate;
     let writer;
     try {
-      const rewrite = thread.spoolPath !== void 0 && !mergedSpoolIsFresh(thread.spoolPath, thread.mtimeMs);
-      if (thread.spoolPath !== void 0 && rewrite) writer = new MergedSpoolWriter(thread.spoolPath);
+      const rewrite = thread.mergedTranscriptPath !== void 0 && !mergedTranscriptIsFresh(thread.mergedTranscriptPath, thread.mtimeMs);
+      if (thread.mergedTranscriptPath !== void 0 && rewrite) writer = new MergedTranscriptWriter(thread.mergedTranscriptPath);
       const pages = [];
       const usage = createCodexUsageReader();
       let vanished = false;
@@ -87039,11 +87046,11 @@ async function collectCodexSessions(options = {}) {
         continue;
       }
       const summary = foldRolloutPages(pages, usage.finish());
-      let transcriptPath = thread.files[0].rolloutPath;
-      if (thread.spoolPath !== void 0) {
-        const mergedBytes = writer ? writer.finish(thread.mtimeMs) : statIfExists(thread.spoolPath)?.size ?? 0;
+      let transcriptUploadSourcePath = thread.files[0].rolloutPath;
+      if (thread.mergedTranscriptPath !== void 0) {
+        const mergedBytes = writer ? writer.finish(thread.mtimeMs) : statIfExists(thread.mergedTranscriptPath)?.size ?? 0;
         writer = void 0;
-        transcriptPath = thread.spoolPath;
+        transcriptUploadSourcePath = thread.mergedTranscriptPath;
         mergedThreads += 1;
         largestMergedBytes = Math.max(largestMergedBytes, mergedBytes);
       }
@@ -87052,13 +87059,14 @@ async function collectCodexSessions(options = {}) {
       const title = summary.sessionId ? threadNames.get(summary.sessionId) : void 0;
       items.push({
         mtimeMs: thread.mtimeMs,
-        transcriptPath,
+        transcriptPath: transcriptUploadSourcePath,
         ...cwd && { cwd },
         item: {
           source: "codex",
           externalId: thread.externalId,
           status: now - thread.mtimeMs < ACTIVE_GRACE_MS ? "active" : "inactive",
           archived: thread.archived,
+          ...summary.standaloneReview && { automation: true },
           ...summary.startedAt && { startedAt: summary.startedAt },
           ...summary.endedAt && { endedAt: summary.endedAt },
           ...summary.model && { model: summary.model },
@@ -87219,7 +87227,7 @@ function defaultCursorUserDir(home) {
 function cursorGlobalStorageDir(home) {
   return path6.join(defaultCursorUserDir(home), "globalStorage");
 }
-function cursorSpoolDir(home) {
+function cursorExtractedTranscriptsDir(home) {
   return path6.join(home, ".config", "powerplant", "cursor");
 }
 var emptyResult = () => ({
@@ -87275,7 +87283,7 @@ var cachedMetaSchema = external_exports.object({
   model: external_exports.string().optional(),
   ...cursorTranscriptMetaDisclosureSchema.shape
 });
-function spoolFileName(composerId) {
+function extractedTranscriptFileName(composerId) {
   const sanitized = composerId.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 80);
   const hash2 = createHash2("sha256").update(composerId).digest("hex").slice(0, 8);
   return `${sanitized}-${hash2}.jsonl`;
@@ -87338,7 +87346,7 @@ function toolFilePathOf(args) {
   }
   return void 0;
 }
-var SPOOL_META_RESERVE_BYTES = 64 * 1024;
+var EXTRACTED_TRANSCRIPT_META_RESERVE_BYTES = 64 * 1024;
 var BUBBLE_FIELDS_SHARED = ["_v", "type", "bubbleId", "serverBubbleId", "text", "createdAt"];
 var USER_BUBBLE_FIELDS = /* @__PURE__ */ new Set([...BUBBLE_FIELDS_SHARED, "context"]);
 var ASSISTANT_BUBBLE_FIELDS = /* @__PURE__ */ new Set([
@@ -87582,7 +87590,7 @@ function extractTranscript(db, composerId, maxBytes) {
   const spine = Array.isArray(data?.fullConversationHeadersOnly) ? data.fullConversationHeadersOnly : [];
   if (spine.length === 0) return null;
   const recorder = createOmissionRecorder();
-  const budget = maxBytes - SPOOL_META_RESERVE_BYTES;
+  const budget = maxBytes - EXTRACTED_TRANSCRIPT_META_RESERVE_BYTES;
   const serialized = [];
   const modelCounts = /* @__PURE__ */ new Map();
   let bytes = 0;
@@ -87663,7 +87671,7 @@ async function collectCursorSessions(options = {}) {
       collectCursorTranscriptFiles(options, (id) => {
         if (knownIds.has(id)) return true;
         return db?.prepare("select composerId from composerHeaders where composerId = ?").get(id) != null;
-      }, result, options.spoolDir ?? cursorSpoolDir(options.homeDir ?? os7.homedir()), spoolFileName);
+      }, result, options.extractedTranscriptsDir ?? cursorExtractedTranscriptsDir(options.homeDir ?? os7.homedir()), extractedTranscriptFileName);
     }
   } finally {
     try {
@@ -87677,9 +87685,9 @@ async function collectCursorSessions(options = {}) {
 function collectFromStore(db, userDir, options, result, knownIds) {
   const now = options.now ?? Date.now();
   const capture = options.capture ?? captureEverythingUnresolved;
-  const spoolDir = options.spoolDir ?? cursorSpoolDir(options.homeDir ?? os7.homedir());
+  const extractedTranscriptsDir = options.extractedTranscriptsDir ?? cursorExtractedTranscriptsDir(options.homeDir ?? os7.homedir());
   const maxBytes = options.maxTranscriptBytes ?? MAX_TRANSCRIPT_FILE_BYTES;
-  let spoolDirReady = false;
+  let extractedTranscriptsDirReady = false;
   const columns = new Set(
     db.prepare("pragma table_info(composerHeaders)").all().map((row) => isRecord2(row) ? row.name : void 0)
   );
@@ -87729,15 +87737,15 @@ function collectFromStore(db, userDir, options, result, knownIds) {
         });
         continue;
       }
-      const spoolPath = path6.join(spoolDir, spoolFileName(raw.composerId));
-      const spoolStat = statIfExists(spoolPath);
+      const transcriptUploadSourcePath = path6.join(extractedTranscriptsDir, extractedTranscriptFileName(raw.composerId));
+      const extractedTranscriptStat = statIfExists(transcriptUploadSourcePath);
       let model;
-      const sourceUnchanged = spoolStat !== null && Math.abs(spoolStat.mtimeMs - lastUpdatedAt) < 1;
-      if (sourceUnchanged && spoolStat.size > maxBytes) {
+      const sourceUnchanged = extractedTranscriptStat !== null && Math.abs(extractedTranscriptStat.mtimeMs - lastUpdatedAt) < 1;
+      if (sourceUnchanged && extractedTranscriptStat.size > maxBytes) {
         result.skippedTooLarge += 1;
         continue;
       }
-      const cached3 = sourceUnchanged ? readFirstRecord(spoolPath, () => true) : null;
+      const cached3 = sourceUnchanged ? readFirstRecord(transcriptUploadSourcePath, () => true) : null;
       const cachedMeta = cachedMetaSchema.safeParse(cached3);
       const preparationCurrent = cachedMeta.success && cachedMeta.data.composerId === raw.composerId;
       let omissions;
@@ -87770,15 +87778,15 @@ function collectFromStore(db, userDir, options, result, knownIds) {
           ...counted && { omissions: transcript.omissions },
           ...unhandled.length > 0 && { unhandled }
         };
-        if (!spoolDirReady) {
-          mkdirSync3(spoolDir, { recursive: true, mode: 448 });
-          chmodSync2(spoolDir, 448);
-          spoolDirReady = true;
+        if (!extractedTranscriptsDirReady) {
+          mkdirSync3(extractedTranscriptsDir, { recursive: true, mode: 448 });
+          chmodSync2(extractedTranscriptsDir, 448);
+          extractedTranscriptsDirReady = true;
         }
         const body = [JSON.stringify(meta3), ...transcript.serialized, ""].join("\n");
-        if (spoolStat !== null) chmodSync2(spoolPath, 384);
-        writeFileSync2(spoolPath, body, { encoding: "utf8", mode: 384 });
-        utimesSync2(spoolPath, new Date(lastUpdatedAt), new Date(lastUpdatedAt));
+        if (extractedTranscriptStat !== null) chmodSync2(transcriptUploadSourcePath, 384);
+        writeFileSync2(transcriptUploadSourcePath, body, { encoding: "utf8", mode: 384 });
+        utimesSync2(transcriptUploadSourcePath, new Date(lastUpdatedAt), new Date(lastUpdatedAt));
       }
       if (hasCaptureGaps(omissions)) result.partiallyInterpreted += 1;
       for (const observation of unhandledObservations(unhandled, raw.composerId)) {
@@ -87797,7 +87805,7 @@ function collectFromStore(db, userDir, options, result, knownIds) {
       const startBranch = facts.branches[0];
       result.sessions.push({
         mtimeMs: lastUpdatedAt,
-        transcriptPath: spoolPath,
+        transcriptPath: transcriptUploadSourcePath,
         ...cwd && { cwd },
         item: {
           source: "cursor",
@@ -87931,7 +87939,7 @@ function parseCursorTranscriptFile(text) {
   if (!lines.some((line) => CONTENT_LINE_TYPES2.has(line.type))) return null;
   return { lines, omissions: recorder.omissions(), unhandled: recorder.unhandled() };
 }
-function spoolBody(metaFor, lines, maxBytes) {
+function extractedTranscriptBody(metaFor, lines, maxBytes) {
   for (const keepPayloads of [true, false]) {
     const payloadsDropped = keepPayloads ? 0 : lines.filter((line) => line.type === "unsupported" && line.payload !== void 0).length;
     const records = [
@@ -87950,7 +87958,7 @@ function spoolBody(metaFor, lines, maxBytes) {
   }
   return null;
 }
-var spoolMetaSchema = external_exports.object({
+var extractedTranscriptMetaSchema = external_exports.object({
   type: external_exports.literal("meta"),
   format: external_exports.literal("cursor-local-transcript"),
   version: external_exports.literal(1),
@@ -87962,7 +87970,7 @@ var spoolMetaSchema = external_exports.object({
   model: external_exports.string().optional(),
   ...cursorTranscriptMetaDisclosureSchema.shape
 });
-var hintSchema2 = external_exports.object({
+var transcriptDiscoveryRecordSchema2 = external_exports.object({
   sessionId: external_exports.string().regex(/^[a-zA-Z0-9_-]{1,200}$/),
   transcriptPath: external_exports.string().max(4096).nullable(),
   workspaceRoots: external_exports.array(external_exports.string().max(4096)).max(8),
@@ -87994,15 +88002,15 @@ function cursorTranscriptRecordPath(home, sessionId) {
     `${createHash3("sha256").update(sessionId).digest("hex")}.json`
   );
 }
-function collectCursorTranscriptFiles(options, isDatabaseSession, result, databaseSpoolDir, spoolName) {
+function collectCursorTranscriptFiles(options, isDatabaseSession, result, databaseExtractedTranscriptsDir, extractedTranscriptFileName2) {
   const home = options.homeDir ?? os8.homedir();
-  const hintsDir = cursorTranscriptRecordsDir(home);
-  if (!existsSync3(hintsDir)) return;
+  const recordsDir = cursorTranscriptRecordsDir(home);
+  if (!existsSync3(recordsDir)) return;
   const maxBytes = options.maxTranscriptBytes ?? MAX_TRANSCRIPT_FILE_BYTES;
-  const spoolDir = path7.join(databaseSpoolDir, "native");
+  const nativeExtractedTranscriptsDir = path7.join(databaseExtractedTranscriptsDir, "native");
   let files;
   try {
-    files = readdirSync3(hintsDir);
+    files = readdirSync3(recordsDir);
   } catch {
     result.skippedUnreadable++;
     return;
@@ -88010,15 +88018,15 @@ function collectCursorTranscriptFiles(options, isDatabaseSession, result, databa
   for (const file2 of files) {
     if (!/^[a-f0-9]{64}\.json$/.test(file2)) continue;
     try {
-      const hintPath = path7.join(hintsDir, file2);
-      if (!lstatSync2(hintPath).isFile()) continue;
-      const text = readBounded(hintPath, 40 * 1024);
-      const hint = hintSchema2.parse(text === null ? null : JSON.parse(text));
-      if (file2 !== `${createHash3("sha256").update(hint.sessionId).digest("hex")}.json`) continue;
-      if (isDatabaseSession(hint.sessionId) || existsSync3(path7.join(databaseSpoolDir, spoolName(hint.sessionId))))
+      const recordPath = path7.join(recordsDir, file2);
+      if (!lstatSync2(recordPath).isFile()) continue;
+      const text = readBounded(recordPath, 40 * 1024);
+      const record2 = transcriptDiscoveryRecordSchema2.parse(text === null ? null : JSON.parse(text));
+      if (file2 !== `${createHash3("sha256").update(record2.sessionId).digest("hex")}.json`) continue;
+      if (isDatabaseSession(record2.sessionId) || existsSync3(path7.join(databaseExtractedTranscriptsDir, extractedTranscriptFileName2(record2.sessionId))))
         continue;
-      if (hint.transcriptPath === null || hint.workspaceRoots.length !== 1) continue;
-      const cwd = hint.workspaceRoots[0];
+      if (record2.transcriptPath === null || record2.workspaceRoots.length !== 1) continue;
+      const cwd = record2.workspaceRoots[0];
       if (!path7.isAbsolute(cwd)) continue;
       const decision = captureDecision(cwd, options.capture ?? captureEverythingUnresolved);
       if (!decision.capture) {
@@ -88028,14 +88036,14 @@ function collectCursorTranscriptFiles(options, isDatabaseSession, result, databa
       const projects = path7.join(home, ".cursor", "projects");
       const project = cwd.replace(/[^a-zA-Z0-9]/g, "-").replace(/^-+/, "");
       const base = path7.join(projects, project, "agent-transcripts");
-      const basename2 = `${hint.sessionId}.jsonl`;
-      const allowed = [path7.join(base, basename2), path7.join(base, hint.sessionId, basename2)];
-      if (!allowed.includes(hint.transcriptPath)) {
+      const basename2 = `${record2.sessionId}.jsonl`;
+      const allowed = [path7.join(base, basename2), path7.join(base, record2.sessionId, basename2)];
+      if (!allowed.includes(record2.transcriptPath)) {
         result.skippedUnreadable++;
         continue;
       }
-      const stat = lstatSync2(hint.transcriptPath);
-      if (!stat.isFile() || realpathSync2(hint.transcriptPath) !== path7.join(realpathSync2(projects), path7.relative(projects, hint.transcriptPath))) {
+      const stat = lstatSync2(record2.transcriptPath);
+      if (!stat.isFile() || realpathSync2(record2.transcriptPath) !== path7.join(realpathSync2(projects), path7.relative(projects, record2.transcriptPath))) {
         result.skippedUnreadable++;
         continue;
       }
@@ -88046,7 +88054,7 @@ function collectCursorTranscriptFiles(options, isDatabaseSession, result, databa
       }
       const common = {
         source: "cursor",
-        externalId: hint.sessionId,
+        externalId: record2.sessionId,
         status: (options.now ?? Date.now()) - stat.mtimeMs < ACTIVE_GRACE_MS ? "active" : "inactive",
         ...decision.repoFullName && { repoFullName: decision.repoFullName },
         capturedVia: decision.via
@@ -88055,15 +88063,15 @@ function collectCursorTranscriptFiles(options, isDatabaseSession, result, databa
         result.sessions.push({
           cwd,
           mtimeMs: stat.mtimeMs,
-          transcriptPath: hint.transcriptPath,
+          transcriptPath: record2.transcriptPath,
           item: common
         });
         continue;
       }
-      const spool = path7.join(spoolDir, spoolName(hint.sessionId));
-      const spoolStat = statIfExists(spool);
-      const cached3 = spoolStat !== null && spoolStat.size <= maxBytes && Math.abs(spoolStat.mtimeMs - stat.mtimeMs) < 1 ? spoolMetaSchema.safeParse(readFirstRecord(spool, () => true)) : null;
-      const fresh = cached3?.success && cached3.data.composerId === hint.sessionId && cached3.data.workspacePath === cwd && cached3.data.nativeSourceSize === stat.size && cached3.data.model === hint.model;
+      const transcriptUploadSourcePath = path7.join(nativeExtractedTranscriptsDir, extractedTranscriptFileName2(record2.sessionId));
+      const extractedTranscriptStat = statIfExists(transcriptUploadSourcePath);
+      const cached3 = extractedTranscriptStat !== null && extractedTranscriptStat.size <= maxBytes && Math.abs(extractedTranscriptStat.mtimeMs - stat.mtimeMs) < 1 ? extractedTranscriptMetaSchema.safeParse(readFirstRecord(transcriptUploadSourcePath, () => true)) : null;
+      const fresh = cached3?.success && cached3.data.composerId === record2.sessionId && cached3.data.workspacePath === cwd && cached3.data.nativeSourceSize === stat.size && cached3.data.model === record2.model;
       let title;
       let omissions;
       let unhandled = [];
@@ -88072,7 +88080,7 @@ function collectCursorTranscriptFiles(options, isDatabaseSession, result, databa
         omissions = cached3.data.omissions;
         unhandled = cached3.data.unhandled ?? [];
       } else {
-        const raw = readBounded(hint.transcriptPath, maxBytes);
+        const raw = readBounded(record2.transcriptPath, maxBytes);
         if (raw === null) {
           result.skippedTooLarge++;
           continue;
@@ -88093,40 +88101,40 @@ function collectCursorTranscriptFiles(options, isDatabaseSession, result, databa
             format: "cursor-local-transcript",
             version: 1,
             preparationVersion: CURSOR_TRANSCRIPT_PREPARATION_VERSION,
-            composerId: hint.sessionId,
+            composerId: record2.sessionId,
             workspacePath: cwd,
             nativeSourceSize: stat.size,
             ...title !== void 0 && { name: title },
-            ...hint.model && { model: hint.model },
+            ...record2.model && { model: record2.model },
             ...Object.keys(written).length > 0 && { omissions: written },
             ...prepared.unhandled.length > 0 && { unhandled: prepared.unhandled }
           };
         };
-        const body = spoolBody(metaFor, prepared.lines, maxBytes);
+        const body = extractedTranscriptBody(metaFor, prepared.lines, maxBytes);
         if (body === null) {
           result.skippedTooLarge++;
           continue;
         }
-        mkdirSync4(spoolDir, { recursive: true, mode: 448 });
-        if (spoolStat !== null) chmodSync3(spool, 384);
-        writeFileSync3(spool, body, { mode: 384 });
-        utimesSync3(spool, stat.atime, stat.mtime);
+        mkdirSync4(nativeExtractedTranscriptsDir, { recursive: true, mode: 448 });
+        if (extractedTranscriptStat !== null) chmodSync3(transcriptUploadSourcePath, 384);
+        writeFileSync3(transcriptUploadSourcePath, body, { mode: 384 });
+        utimesSync3(transcriptUploadSourcePath, stat.atime, stat.mtime);
         omissions = Object.keys(written).length > 0 ? written : void 0;
         unhandled = prepared.unhandled;
       }
       if (hasCaptureGaps(omissions)) result.partiallyInterpreted++;
-      for (const observation of unhandledObservations(unhandled, hint.sessionId)) {
+      for (const observation of unhandledObservations(unhandled, record2.sessionId)) {
         observeStructure(options.onStructureDiagnostic, observation);
       }
       result.sessions.push({
         cwd,
         mtimeMs: stat.mtimeMs,
-        transcriptPath: spool,
+        transcriptPath: transcriptUploadSourcePath,
         item: {
           ...common,
           endedAt: stat.mtime.toISOString(),
           repoDir: path7.basename(cwd),
-          ...hint.model && { model: hint.model },
+          ...record2.model && { model: record2.model },
           ...title !== void 0 && { title }
         }
       });
@@ -88290,7 +88298,7 @@ function observedSessionEnd(entry, mtimeMs) {
   return entry.at;
 }
 
-// ../../apps/collector/src/providerHooks.ts
+// ../../apps/collector/src/harnessHooks.ts
 import {
   existsSync as existsSync5,
   lstatSync as lstatSync3,
@@ -88306,26 +88314,39 @@ var SESSION_CHANGE_HOOK = "powerplant-session-change.mjs";
 var CODEX_TRANSCRIPT_HOOK = "powerplant-codex-transcript.mjs";
 var CURSOR_TRANSCRIPT_HOOK = "powerplant-cursor-transcript.mjs";
 var SESSION_CHANGE_FILENAME = "session-change";
+var SUPPORTED_HOOK_HARNESSES = ["codex-local", "cursor-local"];
 var jsonObject = external_exports.record(external_exports.string(), external_exports.json());
-function providerEvents(provider) {
-  return provider === "cursor" ? ["sessionStart", "sessionEnd", "stop"] : ["SessionStart", "SessionEnd", "Stop"];
+function nativeHarnessName(harness) {
+  switch (harness) {
+    case "codex-local":
+      return "codex";
+    case "cursor-local":
+      return "cursor";
+    default:
+      throw new Error(`unsupported hook harness: ${String(harness)}`);
+  }
 }
-function providerConfigPath(provider, home) {
-  return path10.join(home, `.${provider}`, "hooks.json");
+function harnessEvents(harness) {
+  return nativeHarnessName(harness) === "cursor" ? ["sessionStart", "sessionEnd", "stop"] : ["SessionStart", "SessionEnd", "Stop"];
+}
+function harnessHookConfigPath(harness, home) {
+  const nativeName = nativeHarnessName(harness);
+  return path10.join(home, `.${nativeName}`, "hooks.json");
 }
 var UNUSABLE_CONFIG = "hooks.json contains invalid JSON or an unsupported hook structure";
 var NON_REGULAR_CONFIG = "hooks.json is not a regular file; configure the hook manually";
-function providerHookCommands(provider, text) {
+function harnessHookCommands(harness, text) {
   try {
+    const nativeName = nativeHarnessName(harness);
     const settings = jsonObject.parse(text === null ? {} : JSON.parse(text));
-    if (provider === "cursor" && settings.version !== void 0 && settings.version !== 1) {
+    if (nativeName === "cursor" && settings.version !== void 0 && settings.version !== 1) {
       return { kind: "unusable", reason: "Unsupported Cursor hooks version" };
     }
     const hooks = jsonObject.parse(settings.hooks === void 0 ? {} : settings.hooks);
     const commands = [];
-    for (const event of providerEvents(provider)) {
+    for (const event of harnessEvents(harness)) {
       const entries = external_exports.array(jsonObject).parse(hooks[event] === void 0 ? [] : hooks[event]);
-      const handlers2 = provider === "cursor" ? entries : entries.flatMap((entry) => external_exports.array(jsonObject).parse(entry.hooks));
+      const handlers2 = nativeName === "cursor" ? entries : entries.flatMap((entry) => external_exports.array(jsonObject).parse(entry.hooks));
       const ours = handlers2.filter(isOurHook);
       if (ours.length === 0) return { kind: "missing" };
       for (const hook of ours) {
@@ -88341,20 +88362,21 @@ function isOurHook(hook) {
   const command = hook.command;
   return typeof command === "string" && [SESSION_CHANGE_HOOK, CODEX_TRANSCRIPT_HOOK, CURSOR_TRANSCRIPT_HOOK].some((script) => command.endsWith(`/${script}'`) || command.endsWith(`/${script}"`));
 }
-function mergeProviderHooks(provider, text, command) {
+function mergeHarnessHooks(harness, text, command) {
   try {
+    const nativeName = nativeHarnessName(harness);
     const settings = jsonObject.parse(text === null ? {} : JSON.parse(text));
-    if (provider === "cursor" && settings.version !== void 0 && settings.version !== 1) {
+    if (nativeName === "cursor" && settings.version !== void 0 && settings.version !== 1) {
       return { action: "skip", reason: "Unsupported Cursor hooks version" };
     }
     const hooks = jsonObject.parse(settings.hooks === void 0 ? {} : settings.hooks);
-    for (const event of providerEvents(provider)) {
+    for (const event of harnessEvents(harness)) {
       const entries = external_exports.array(jsonObject).parse(hooks[event] === void 0 ? [] : hooks[event]);
-      const handler = provider === "cursor" ? { command, timeout: 2 } : { type: "command", command, timeout: 2 };
-      const ours = provider === "cursor" ? handler : { hooks: [handler] };
+      const handler = nativeName === "cursor" ? { command, timeout: 2 } : { type: "command", command, timeout: 2 };
+      const ours = nativeName === "cursor" ? handler : { hooks: [handler] };
       const kept = [];
       for (const entry of entries) {
-        if (provider === "cursor") {
+        if (nativeName === "cursor") {
           if (!isOurHook(entry)) kept.push(entry);
           continue;
         }
@@ -88365,7 +88387,7 @@ function mergeProviderHooks(provider, text, command) {
       }
       hooks[event] = [...kept, ours];
     }
-    const next = { ...settings, ...provider === "cursor" ? { version: 1 } : {}, hooks };
+    const next = { ...settings, ...nativeName === "cursor" ? { version: 1 } : {}, hooks };
     if (JSON.stringify(next) === JSON.stringify(settings)) return { action: "unchanged" };
     return { action: "write", text: `${JSON.stringify(next, null, 2)}
 ` };
@@ -88376,42 +88398,47 @@ function mergeProviderHooks(provider, text, command) {
 function shellQuote2(value) {
   return `'${value.replaceAll("'", "'\\''")}'`;
 }
-function installProviderHook(provider, home) {
-  const configDir = path10.join(home, `.${provider}`);
-  if (!existsSync5(configDir)) return { provider, settings: "absent" };
-  const configPath = providerConfigPath(provider, home);
+function installHarnessHook(harness, home) {
+  const nativeName = nativeHarnessName(harness);
+  const configDir = path10.join(home, `.${nativeName}`);
+  if (!existsSync5(configDir)) return { provider: nativeName, settings: "absent" };
+  const configPath = harnessHookConfigPath(harness, home);
   let original = null;
   let mode = 384;
   try {
     const stat = lstatSync3(configPath);
-    if (!stat.isFile()) return { provider, settings: "skip", detail: NON_REGULAR_CONFIG };
+    if (!stat.isFile()) {
+      return { provider: nativeName, settings: "skip", detail: NON_REGULAR_CONFIG };
+    }
     mode = stat.mode & 511;
     original = readFileSync6(configPath, "utf8");
   } catch (error63) {
     if (!(error63 instanceof Error && "code" in error63 && error63.code === "ENOENT")) throw error63;
   }
   const hookDir = path10.join(home, ".config", "powerplant", "hooks");
-  const script = provider === "cursor" ? CURSOR_TRANSCRIPT_HOOK : CODEX_TRANSCRIPT_HOOK;
+  const script = nativeName === "cursor" ? CURSOR_TRANSCRIPT_HOOK : CODEX_TRANSCRIPT_HOOK;
   const scriptPath = path10.join(hookDir, script);
-  const merged = mergeProviderHooks(
-    provider,
+  const merged = mergeHarnessHooks(
+    harness,
     original,
     `${shellQuote2(process.execPath)} ${shellQuote2(scriptPath)}`
   );
-  if (merged.action === "skip") return { provider, settings: "skip", detail: merged.reason };
+  if (merged.action === "skip") {
+    return { provider: nativeName, settings: "skip", detail: merged.reason };
+  }
   mkdirSync6(hookDir, { recursive: true });
   writeAtomic(scriptPath, readFileSync6(hookSourcePath(script), "utf8"), 448);
   if (merged.action === "write") {
     const current = existsSync5(configPath) ? readFileSync6(configPath, "utf8") : null;
     if (current !== original)
       return {
-        provider,
+        provider: nativeName,
         settings: "skip",
         detail: "hooks.json changed during installation; restart the collector to retry"
       };
     writeAtomic(configPath, merged.text, mode);
   }
-  return { provider, settings: merged.action };
+  return { provider: nativeName, settings: merged.action };
 }
 function writeAtomic(file2, text, mode) {
   const temporary = `${file2}.${randomUUID()}.tmp`;
@@ -88422,13 +88449,13 @@ function writeAtomic(file2, text, mode) {
     rmSync4(temporary, { force: true });
   }
 }
-function installProviderHooks(home) {
-  return ["codex", "cursor"].map((provider) => {
+function installHarnessHooks(home) {
+  return SUPPORTED_HOOK_HARNESSES.map((harness) => {
     try {
-      return installProviderHook(provider, home);
+      return installHarnessHook(harness, home);
     } catch (error63) {
       return {
-        provider,
+        provider: nativeHarnessName(harness),
         settings: "skip",
         detail: error63 instanceof Error ? error63.message : String(error63)
       };
@@ -88440,7 +88467,7 @@ function installProviderHooks(home) {
 var HOOK_OBSERVATION_GRACE_MS = 2 * 6e4;
 var hookHealthSchema = external_exports.object({
   harness: hookHarnessSchema,
-  /** What this daemon's boot-time install did (installCollectorHooks / installProviderHooks). */
+  /** What this daemon's boot-time install did (installCollectorHooks / installHarnessHooks). */
   install: hookInstallOutcomeSchema,
   /** unverified: no in-scope session started since the install has been
    * judged yet. firing: one carried a hook record. silent: one had none. */
@@ -88469,7 +88496,10 @@ var HARNESS_NAMES = {
   cursor: "Cursor"
 };
 function configPathOf(harness, home) {
-  return harness === "claude" ? claudeSettingsPath(home) : providerConfigPath(harness, home);
+  return harness === "claude" ? claudeSettingsPath(home) : harnessHookConfigPath(localHookHarness(harness), home);
+}
+function localHookHarness(harness) {
+  return harness === "codex" ? "codex-local" : "cursor-local";
 }
 function commandPaths(command) {
   const paths = [];
@@ -88504,7 +88534,7 @@ function inspectHookConfig(harness, home) {
       detail: error63 instanceof Error ? error63.message : String(error63)
     };
   }
-  const read = harness === "claude" ? collectorHookCommands(text) : providerHookCommands(harness, text);
+  const read = harness === "claude" ? collectorHookCommands(text) : harnessHookCommands(localHookHarness(harness), text);
   if (read.kind === "unusable") return { kind: "config-unusable", configPath, detail: read.reason };
   if (read.kind === "missing") return { kind: "entries-missing", configPath };
   for (const command of read.commands) {
@@ -89406,7 +89436,7 @@ async function uploadPreviewRegistration(apiUrl, machineToken, registration) {
 function encodeRawTranscript(text) {
   return gzipSync(redactJsonl(text));
 }
-async function uploadRawSessions(apiUrl, machineToken, collected, readTranscript = (p) => readFileSync9(p, "utf8"), shipped, progress) {
+async function uploadRawSessions(apiUrl, machineToken, transcriptUploadSources, readTranscript = (p) => readFileSync9(p, "utf8"), shipped, progress) {
   const summary = {
     uploaded: 0,
     skippedTooLarge: 0,
@@ -89417,18 +89447,19 @@ async function uploadRawSessions(apiUrl, machineToken, collected, readTranscript
   };
   const initiallyShipped = new Map(shipped);
   let rateLimited;
-  for (const session of collected) {
+  for (const session of transcriptUploadSources) {
     summary.uploaded += await progress?.beforeUpload?.() ?? 0;
-    const acknowledged = shipped?.get(session.transcriptPath);
-    if (acknowledged === session.mtimeMs || acknowledged !== void 0 && acknowledged !== initiallyShipped.get(session.transcriptPath)) {
+    const transcriptUploadSourcePath = session.transcriptPath;
+    const acknowledged = shipped?.get(transcriptUploadSourcePath);
+    if (acknowledged === session.mtimeMs || acknowledged !== void 0 && acknowledged !== initiallyShipped.get(transcriptUploadSourcePath)) {
       summary.skippedUnchanged += 1;
       continue;
     }
     try {
-      const body = encodeRawTranscript(readTranscript(session.transcriptPath));
+      const body = encodeRawTranscript(readTranscript(transcriptUploadSourcePath));
       if (body.byteLength > MAX_RAW_UPLOAD_BYTES) {
         summary.skippedTooLarge += 1;
-        shipped?.set(session.transcriptPath, session.mtimeMs);
+        shipped?.set(transcriptUploadSourcePath, session.mtimeMs);
         continue;
       }
       const query = `source=${session.item.source}&externalId=${encodeURIComponent(session.item.externalId)}`;
@@ -89461,7 +89492,7 @@ async function uploadRawSessions(apiUrl, machineToken, collected, readTranscript
       }
       summary.uploaded += 1;
       progress?.onUploaded?.();
-      shipped?.set(session.transcriptPath, session.mtimeMs);
+      shipped?.set(transcriptUploadSourcePath, session.mtimeMs);
     } catch (error63) {
       if (error63 instanceof RateLimitedError) rateLimited ??= error63;
       summary.failed.push(
@@ -91332,7 +91363,7 @@ function startWatch(config2, homeDir, runtime = { version: "checkout" }) {
     );
     reportCollectorError(error63, "watch-hook-install");
   }
-  for (const hook of installProviderHooks(home)) {
+  for (const hook of installHarnessHooks(home)) {
     hookInstalls[hook.provider] = hook.settings;
     if (hook.settings === "absent") continue;
     if (hook.settings === "skip") {
@@ -93378,7 +93409,7 @@ import { accessSync, constants as constants2, readFileSync as readFileSync12 } f
 import path25 from "node:path";
 
 // src/version.ts
-var CLI_VERSION = true ? "0.4.12" : "0.0.0-checkout";
+var CLI_VERSION = true ? "0.4.13" : "0.0.0-checkout";
 var CLI_RELEASE_BUILD = true ? true : false;
 var CLI_PACKAGE_NAME = "@usepowerplant/cli";
 
@@ -93498,7 +93529,13 @@ function realInspectEnvironment() {
 
 // src/update.ts
 var updateProgressSchema = external_exports.object({
-  state: external_exports.enum(["installing", "failed"]),
+  /** "up-to-date": the last run installed nothing, because this build is
+   * already at or past the release. That record is kept only so the menu
+   * bar app that started the run can stop showing "Updating CLI…"
+   * (menu.ts cliUpToDateAt); to every other reader it is no update at all.
+   * A CLI from before this state rejects the record, which it reads as no
+   * record. */
+  state: external_exports.enum(["installing", "failed", "up-to-date"]),
   /** The release aimed at; null when the registry couldn't be asked (its latest). */
   target: external_exports.string().nullable(),
   startedAt: external_exports.string(),
@@ -93538,7 +93575,7 @@ function readUpdateProgress(readTextFile, file2 = updateProgressPath()) {
   }
 }
 function updateProgressView(progress, cliVersion2, now) {
-  if (progress === null) return { kind: "none" };
+  if (progress === null || progress.state === "up-to-date") return { kind: "none" };
   const reached = progress.target === null ? null : compareReleaseVersions(cliVersion2, progress.target);
   if (reached === 0 || reached === 1) return { kind: "none" };
   if (progress.state === "failed") {
@@ -93571,13 +93608,29 @@ async function runUpdate(deps) {
   const reserved = running?.state === "installing" ? running.target : null;
   const attempts = (release2) => running?.target === release2 && running.attempts !== void 0 ? { attempts: running.attempts } : {};
   deps.writeProgress({ state: "installing", target: reserved, startedAt, pid: deps.pid, ...attempts(reserved) });
-  const target = await deps.resolveTarget() ?? reserved;
+  const resolved = await deps.resolveTarget();
+  if (resolved !== null) deps.recordAvailableVersion(resolved);
+  const target = resolved ?? reserved;
   if (target === null && deps.targetRequired) {
     deps.clearProgress();
     throw new ExpectedCliError(
       "No release is promoted for production right now (or the API couldn't be reached), so there is nothing to update to. Production machines only install the promoted release."
     );
   }
+  const reached = target === null ? null : compareReleaseVersions(deps.cliVersion, target);
+  if (reached === 0 || reached === 1) {
+    deps.writeProgress({
+      state: "up-to-date",
+      target,
+      startedAt,
+      pid: deps.pid,
+      finishedAt: new Date(deps.now()).toISOString()
+    });
+    deps.log(
+      reached === 0 ? `Already up to date (v${deps.cliVersion}).` : `Already on v${deps.cliVersion}, newer than the available release (v${target}). Nothing was installed.`
+    );
+    return;
+  }
   deps.writeProgress({ state: "installing", target, startedAt, pid: deps.pid, ...attempts(target) });
   const { bin, args } = updateCommand(manager, target, inspection.prefix, deps.channel);
   deps.log(`Updating ${CLI_PACKAGE_NAME}${target === null ? "" : ` to ${target}`} via ${manager}\u2026`);
@@ -94422,6 +94475,7 @@ function renderMenu(i) {
         logPath: updateLogPath()
       }
     },
+    ...i.update.progress?.state === "up-to-date" && { cliUpToDateAt: i.update.progress.finishedAt },
     ...i.desktopDiagnostic && { desktopDiagnostic: i.desktopDiagnostic },
     appEnv: i.config.appEnv,
     cliVersion: i.cliVersion,
@@ -94725,14 +94779,17 @@ async function cachedLatestVersion(options) {
     }
   }
   const version2 = await options.fetchLatest();
+  writeVersionCache({ ...options, version: version2 });
+  return version2;
+}
+function writeVersionCache(options) {
   try {
     options.writeTextFile(
       options.cacheFile,
-      JSON.stringify({ checkedAt: new Date(options.now).toISOString(), version: version2 })
+      JSON.stringify({ checkedAt: new Date(options.now).toISOString(), version: options.version })
     );
   } catch {
   }
-  return version2;
 }
 
 // src/liveTerminalSessions.ts
@@ -96111,7 +96168,14 @@ The access you granted these agents stays on your Powerplant account until you r
       }
       await runUpdate({
         inspection,
+        cliVersion: CLI_VERSION,
         resolveTarget: () => fetchAvailableVersion(config2, loadCredentialsSafely(config2).credentials),
+        recordAvailableVersion: (version2) => writeVersionCache({
+          now: Date.now(),
+          cacheFile: versionCachePath(void 0, releaseSource(config2.appEnv)),
+          writeTextFile: realWriteTextFile,
+          version: version2
+        }),
         channel: releaseSource(config2.appEnv) === "npm" ? "next" : "latest",
         targetRequired: releaseSource(config2.appEnv) === "promoted",
         claimsReservation: process.env[UPDATE_CHILD_ENV] === "1",
@@ -96398,4 +96462,4 @@ undici/lib/web/websocket/frame.js:
   (*! ws. MIT License. Einar Otto Stangvik <einaros@gmail.com> *)
 */
 
-//# debugId=7d73a97a-938c-5f0f-8b6b-c4076b82abad
+//# debugId=66f773d5-e0b2-5538-a184-3ee15c3a469a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usepowerplant/cli",
-  "version": "0.4.12",
+  "version": "0.4.13",
   "publishConfig": {
     "access": "public"
   },