@neta-art/cohub-cli 6.2.0 → 6.2.2

package/README.md

@@ -285,9 +285,9 @@ overwrites files; it never deletes existing ones.
 
 Confirm before deleting files or directories.
 
-## Works
+## Apps
 
-Publish and manage Work entries from a Space workspace. Public Work URLs require a username and a Space slug.
+Publish and manage Apps from a Space workspace. Public App URLs require a username and a Space slug.
 
 `--file` and `--dir` take paths relative to the Space workspace — the same paths
 `spaces files ls` shows, not your local filesystem. To publish local build
@@ -297,51 +297,51 @@ Space-side path.
 ```bash
 cohub profile update --username <username>
 cohub spaces update <spaceId> --slug <space-slug>
-cohub -s <spaceId> works ls --json
-cohub works get <workId|url|username/space/work> --json
-cohub works stats <workId|url|username/space/work>
-cohub works download <workId|url|username/space/work> --output <path>
-cohub -s <spaceId> works publish demo --file dist/index.html
-cohub -s <spaceId> works publish site --dir dist
-cohub -s <spaceId> works publish app --port 3000
-cohub works publish-version <workId>
-cohub works versions <workId> --json
-cohub works rm <workId> --yes
+cohub -s <spaceId> apps ls --json
+cohub apps get <appId|url|username/space/app> --json
+cohub apps stats <appId|url|username/space/app>
+cohub apps download <appId|url|username/space/app> --output <path>
+cohub -s <spaceId> apps publish demo --file dist/index.html
+cohub -s <spaceId> apps publish site --dir dist
+cohub -s <spaceId> apps publish app --port 3000
+cohub apps publish-version <appId>
+cohub apps versions <appId> --json
+cohub apps rm <appId> --yes
 ```
 
-Resolve a published Work by public identity:
+Resolve a published App by public identity:
 
 ```bash
-cohub works resolve <workSlug> --owner <username> --space-slug <spaceSlug>
+cohub apps resolve <appSlug> --owner <username> --space-slug <spaceSlug>
 ```
 
-Use `--json` for machine-readable output. `works get`, `works stats`, and `works download` also accept `cohub://works/<username>/<space>/<work>` mention URIs. `works stats` reports total, 24-hour, 7-day, and 30-day views with a source breakdown. Download restores newly published file and directory artifacts directly from the CDN with checksum verification. HTML files with companion assets are restored as directory bundles; Board and port Works are not downloadable. The resolve command remains available for explicit slug-based lookup.
+Use `--json` for machine-readable output. `apps get`, `apps stats`, and `apps download` also accept `app://<username>/<space>/<app>` mention URIs. `apps stats` reports total, 24-hour, 7-day, and 30-day views with a source breakdown. Download restores newly published file and directory artifacts directly from the CDN with checksum verification. HTML files with companion assets are restored as directory bundles; Board and port apps are not downloadable. The resolve command remains available for explicit slug-based lookup.
 
-Realtime rooms use a published Work's runtime identity, so they are available
+Realtime rooms use a published App's runtime identity, so they are available
 through `client.app.realtime` in the SDK rather than as CLI commands.
 
 ## Drive the Cohub UI
 
-Show a file or Work preview in the Cohub tab that started the current work, and call
-methods the Work exposes.
+Show a file or App preview in the Cohub tab that started the current session, and call
+methods the App exposes.
 
 ```bash
-cohub desktop open <workId|url|cohub://works/...|username/space/work|file://path>
+cohub desktop open <appId|url|app://...|username/space/app|file://path>
 cohub desktop open file://src/main.ts
-cohub desktop open work://alice/studio/launch
-cohub desktop open <work-or-file> --call selection.get
-cohub desktop open <work> --call board.focus --data '{"nodeId":"n1"}'
-cohub desktop open <work> --call report.build --input payload.json --json
+cohub desktop open app://alice/studio/launch
+cohub desktop open <app-or-file> --call selection.get
+cohub desktop open <app> --call board.focus --data '{"nodeId":"n1"}'
+cohub desktop open <app> --call report.build --input payload.json --json
 ```
 
-`ui preview` accepts `file://` Space-relative paths, `work://` Work references, and
+`ui preview` accepts `file://` Space-relative paths, `app://` App references, and
 legacy bare targets. A bare target checks the current Space for a file first, then
-falls back to the same Work references as `works get`. Showing a preview is
+falls back to the same App references as `apps get`. Showing a preview is
 idempotent: repeating it re-activates the same tab and refreshes any launch state
-carried by the reference. With `--call`, the command waits for the Work to announce readiness, invokes the method,
-and waits for the Work to complete the same UI command with `client.ui.reportResult()`.
+carried by the reference. With `--call`, the command waits for the App to announce readiness, invokes the method,
+and waits for the App to complete the same UI command with `client.ui.reportResult()`.
 
-Work authors decide what is callable by registering handlers inside the Work:
+App authors decide what is callable by registering handlers inside the App:
 
 ```ts
 client.app.surface.handle("image.open", async (input, { commandId }) => {
@@ -349,7 +349,7 @@ client.app.surface.handle("image.open", async (input, { commandId }) => {
 });
 ```
 
-A Work answers only a Cohub app origin, so a third-party site that embeds it
+An App answers only a Cohub app origin, so a third-party site that embeds it
 cannot invoke these methods.
 
 Retrying with the same `--command-id` re-delivers the command rather than
@@ -361,7 +361,7 @@ Delivery is at-least-once. Deduplication lives in the receiving tab's memory, so
 retry that spans a page reload can run a `--call` method a second time. Prefer
 methods that are safe to repeat.
 
-Commands reach only the frontend instance that originated the current work,
+Commands reach only the frontend instance that originated the current session,
 resolved from request provenance (`X-Cohub-Source-Client`, propagated into the
 Sandbox as `COHUB_SOURCE_CLIENT_ID`). They cannot target another user's browser,
 and offer no DOM access or script evaluation. Pass `--client` to address a
@@ -414,7 +414,7 @@ Confirm before enabling, disabling, or deleting recurring scheduled prompts.
 
 Confirm before:
 
-- deleting files, directories, or Works
+- deleting files, directories, or Apps
 - creating scheduled or recurring prompts with side effects
 - enabling, disabling, or deleting recurring scheduled prompts
 - changing access policies, member roles, or membership

package/dist/bootstrap.js

@@ -1,35 +1,19 @@
 #!/usr/bin/env node
-import { relaunchCli } from "./launcher.js";
-import { ensureCliSelfUpdated } from "./self-update.js";
+import { ensureCliSelfUpdated, SELF_UPDATE_WORKER_ENV, startCliSelfUpdate } from "./self-update.js";
 const argv = process.argv.slice(2);
 const isVersionRequest = argv.some((arg) => arg === "-v" || arg === "--version");
-let shouldRelaunch = false;
-try {
-    if (!isVersionRequest) {
-        shouldRelaunch = await ensureCliSelfUpdated() !== "current";
-    }
-}
-catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(`cohub self-update failed: ${message}\n`);
-    process.stderr.write("run with --version to skip self-update\n");
-    process.exit(1);
-}
-if (shouldRelaunch) {
-    const entrypoint = process.argv[1];
-    if (!entrypoint) {
-        process.stderr.write("cohub failed to locate its updated entrypoint\n");
-        process.exit(1);
-    }
+if (process.env[SELF_UPDATE_WORKER_ENV] === "1") {
     try {
-        process.exitCode = await relaunchCli(entrypoint, argv);
+        await ensureCliSelfUpdated();
     }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        process.stderr.write(`cohub failed to launch the updated CLI: ${message}\n`);
-        process.exitCode = 1;
+    catch {
+        // Self-update is best effort and must never affect the foreground command.
     }
+    process.exit(0);
 }
-else {
-    await import("./index.js");
+if (!isVersionRequest) {
+    const entrypoint = process.argv[1];
+    if (entrypoint)
+        process.once("exit", () => startCliSelfUpdate(entrypoint));
 }
+await import("./index.js");

package/dist/commands/run.js

@@ -161,11 +161,12 @@ function parseRunResult(detail) {
                 exitCode: typeof terminationRecord.exitCode === "number" ? terminationRecord.exitCode : null,
                 ...(typeof terminationRecord.timeoutSecs === "number" ? { timeoutSecs: terminationRecord.timeoutSecs } : {}),
                 ...(typeof terminationRecord.message === "string" ? { message: terminationRecord.message } : {}),
+                ...(typeof terminationRecord.outputTruncated === "boolean" ? { outputTruncated: terminationRecord.outputTruncated } : {}),
             }
             : undefined,
         durationMs: typeof result?.durationMs === "number" ? result.durationMs : 0,
         output: typeof result?.output === "string" ? result.output : "",
-        truncated: Boolean(result?.truncated),
+        truncated: Boolean(result?.truncated) || Boolean(result?.outputTruncated) || Boolean(terminationRecord?.outputTruncated),
     };
 }
 function writeOutput(output) {

package/dist/self-update.d.ts

@@ -1,3 +1,6 @@
+export declare const SELF_UPDATE_WORKER_ENV = "COHUB_CLI_SELF_UPDATE_WORKER";
 export type CliSelfUpdateResult = "current" | "updated" | "updated-by-peer";
 export declare function resolveSelfUpdateResult(beforeVersion: string | undefined, afterVersion: string | undefined, updatedByPeer: boolean): CliSelfUpdateResult;
+export declare const isCliSelfUpdateDue: () => boolean;
+export declare function startCliSelfUpdate(entrypoint: string): void;
 export declare function ensureCliSelfUpdated(): Promise<CliSelfUpdateResult>;

package/dist/self-update.js

@@ -3,6 +3,7 @@ import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 const PACKAGE_NAME = "@neta-art/cohub-cli";
+export const SELF_UPDATE_WORKER_ENV = "COHUB_CLI_SELF_UPDATE_WORKER";
 const DEFAULT_INTERVAL_MS = 6 * 60 * 60 * 1000;
 const DEFAULT_TIMEOUT_MS = 60_000;
 const LOCK_STALE_MS = 5 * 60 * 1000;
@@ -55,7 +56,7 @@ export function resolveSelfUpdateResult(beforeVersion, afterVersion, updatedByPe
         return "current";
     return updatedByPeer ? "updated-by-peer" : "updated";
 }
-const isDue = () => {
+export const isCliSelfUpdateDue = () => {
     const state = readState();
     if (!state.lastUpdatedAt)
         return true;
@@ -127,10 +128,21 @@ const runNpmUpdate = (timeoutMs) => {
         });
     });
 };
+export function startCliSelfUpdate(entrypoint) {
+    if (process.env.COHUB_CLI_AUTO_UPDATE === "0" || !isCliSelfUpdateDue())
+        return;
+    const worker = spawn(process.execPath, [entrypoint], {
+        detached: true,
+        env: { ...process.env, [SELF_UPDATE_WORKER_ENV]: "1" },
+        stdio: "ignore",
+    });
+    worker.on("error", () => undefined);
+    worker.unref();
+}
 export async function ensureCliSelfUpdated() {
     if (process.env.COHUB_CLI_AUTO_UPDATE === "0")
         return "current";
-    if (!isDue())
+    if (!isCliSelfUpdateDue())
         return "current";
     const beforeVersion = readInstalledVersion();
     const timeoutMs = getTimeoutMs();
@@ -141,7 +153,7 @@ export async function ensureCliSelfUpdated() {
     try {
         // Another process may have completed the update while this process was
         // waiting for the lock.
-        if (!isDue()) {
+        if (!isCliSelfUpdateDue()) {
             return resolveSelfUpdateResult(beforeVersion, readInstalledVersion(), true);
         }
         await runNpmUpdate(timeoutMs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "6.2.0",
+  "version": "6.2.2",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "license": "Apache-2.0",
@@ -15,21 +15,21 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@neta-art/generation": "^0.1.22",
+    "@neta-art/generation": "^0.1.23",
     "commander": "^15.0.0",
-    "pixi.js": "^8.19.0",
-    "sharp": "^0.35.3",
-    "@neta-art/cohub": "8.5.0"
+    "pixi.js": "^8.20.1",
+    "sharp": "^0.35.4",
+    "@neta-art/cohub": "8.5.1"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.4.0",
     "typescript": "^7.0.2"
   },
   "optionalDependencies": {
-    "@napi-rs/canvas": "^1.0.2"
+    "@napi-rs/canvas": "^1.0.8"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",