@tryarcanist/cli 0.1.169 → 0.1.170

package/README.md

@@ -363,6 +363,9 @@ arcanist tokens create --scope read --expires-in-days 30 --json
 arcanist tokens create --scope read --idempotency-key 1f0e6f1a-...
 ```
 
+JSON mode returns `{ok, token, id, scope}`.
+The plaintext token is shown only once.
+Use `--idempotency-key <uuid>` when manually retrying a token create whose first response may have been lost; duplicate keys return `duplicate_request` rather than replaying the raw token.
 Read-scoped tokens cannot create write-scoped tokens; the server enforces that and returns 403.
 
 ### `arcanist tokens revoke <id>`

package/dist/index.js

@@ -4191,7 +4191,7 @@ async function waitForBuild(config, businessId, buildId, options) {
     if (options.follow) {
       const logs = await apiFetch(config, buildLogsPath(businessId, buildId, { afterSequence }));
       if (logs.logs.length > 0) {
-        if (options.json) writeJson({ ok: true, logs: logs.logs });
+        if (options.json) writeJson({ type: "logs", logs: logs.logs });
         else printLogs(logs.logs);
         afterSequence = logs.logs[logs.logs.length - 1].sequence;
       }
@@ -4341,15 +4341,18 @@ async function sandboxBuildCommand(sourceRepoArg, options = {}, command) {
     }
     throw err;
   }
-  emit(command, options, payload, (buildPayload) => printBuildRequest(buildPayload.buildRequest));
-  if (!options.wait && !options.follow) return;
   const json = isJson(command, options);
+  if (!(json && options.follow)) {
+    emit(command, options, payload, (buildPayload) => printBuildRequest(buildPayload.buildRequest));
+  }
+  if (!options.wait && !options.follow) return;
   const finalBuild = await waitForBuild(config, businessId, payload.buildRequest.id, {
     follow: options.follow,
     pollIntervalMs: parsePollInterval2(options.pollInterval),
     json
   });
-  if (json) writeJson({ ok: true, buildRequest: finalBuild });
+  if (json)
+    writeJson(options.follow ? { type: "build", buildRequest: finalBuild } : { ok: true, buildRequest: finalBuild });
   else printTerminalBuildSummary(finalBuild);
   if (finalBuild.status !== "completed") {
     process.exitCode = 1;
@@ -4461,8 +4464,10 @@ async function sandboxLogsCommand(buildId, options = {}, command) {
       config,
       buildLogsPath(businessId, buildId, { afterSequence, limit })
     );
-    if (isJson(command, options)) writeJson(payload);
-    else printLogs(payload.logs);
+    if (payload.logs.length > 0 || !options.follow) {
+      if (isJson(command, options)) writeJson(options.follow ? { type: "logs", logs: payload.logs } : payload);
+      else printLogs(payload.logs);
+    }
     if (!options.follow) return;
     if (payload.logs.length > 0) afterSequence = payload.logs[payload.logs.length - 1].sequence;
     await sleep(parsePollInterval2(options.pollInterval));
@@ -5096,10 +5101,27 @@ Examples:
 var sandbox = program.command("sandbox").description("Sandbox layer commands");
 sandbox.command("init").description("Create sandbox layer source files").action((options, command) => sandboxInitCommand(options, command));
 sandbox.command("validate").description("Validate local sandbox layer source files").option("--manifest <path>", "Manifest path", ".arcanist/sandbox.yaml").action((options, command) => sandboxValidateCommand(options, command));
-sandbox.command("build").description("Build a repo-sourced sandbox layer").argument("[source-repo]", "Source repository owner/name; defaults to current git remote").option("--manifest <path>", "Manifest path", ".arcanist/sandbox.yaml").option("--ref <ref>", "Git ref to build").option("--target-repo <repo>", "Target repository owner/name for resource-profile coverage").option("--business <id>", "Business ID; defaults to authenticated user's business").option("--wait", "Wait for the build to finish").option("--follow", "Follow logs while waiting").option("--poll-interval <ms>", "Polling interval in milliseconds").option("--idempotency-key <uuid>", "Request idempotency key for safe manual retries").action((sourceRepo, options, command) => sandboxBuildCommand(sourceRepo, options, command));
+sandbox.command("build").description("Build a repo-sourced sandbox layer").argument("[source-repo]", "Source repository owner/name; defaults to current git remote").option("--manifest <path>", "Manifest path", ".arcanist/sandbox.yaml").option("--ref <ref>", "Git ref to build").option("--target-repo <repo>", "Target repository owner/name for resource-profile coverage").option("--business <id>", "Business ID; defaults to authenticated user's business").option("--wait", "Wait for the build to finish").option("--follow", "Follow logs while waiting").option("--poll-interval <ms>", "Polling interval in milliseconds").option("--idempotency-key <uuid>", "Request idempotency key for safe manual retries").addHelpText(
+  "after",
+  `
+JSON:
+  Without --wait and --follow, --json prints one object: {ok, buildRequest}
+  With --wait and without --follow, --json prints two objects: initial {ok, buildRequest} then terminal {ok, buildRequest}
+  With --follow, --json emits NDJSON:
+    {type:"logs", logs:[...]}
+    {type:"build", buildRequest:{...}}
+`
+).action((sourceRepo, options, command) => sandboxBuildCommand(sourceRepo, options, command));
 sandbox.command("status").description("Show sandbox layer status").argument("[repo]", "Repository owner/name; defaults to current git remote").option("--business <id>", "Business ID; defaults to authenticated user's business").action((repo, options, command) => sandboxStatusCommand(repo, options, command));
 sandbox.command("history").description("Show sandbox layer build history").argument("[source-repo]", "Source repository owner/name; defaults to current git remote").option("--business <id>", "Business ID; defaults to authenticated user's business").option("--target-repo <repo>", "Target repository owner/name for resource-profile coverage").option("--status <status>", "Filter by build status").option("--limit <n>", "Maximum builds to return").action((sourceRepo, options, command) => sandboxHistoryCommand(sourceRepo, options, command));
-sandbox.command("logs").description("Print sandbox layer build logs").argument("<build-id>", "Build ID").option("--business <id>", "Business ID; defaults to authenticated user's business").option("--follow", "Follow logs").option("--after-sequence <n>", "Return logs after this sequence").option("--limit <n>", "Maximum log chunks to return").option("--poll-interval <ms>", "Polling interval in milliseconds").action((buildId, options, command) => sandboxLogsCommand(buildId, options, command));
+sandbox.command("logs").description("Print sandbox layer build logs").argument("<build-id>", "Build ID").option("--business <id>", "Business ID; defaults to authenticated user's business").option("--follow", "Follow logs").option("--after-sequence <n>", "Return logs after this sequence").option("--limit <n>", "Maximum log chunks to return").option("--poll-interval <ms>", "Polling interval in milliseconds").addHelpText(
+  "after",
+  `
+JSON:
+  Without --follow, --json prints one object: {ok, logs}
+  With --follow, --json emits NDJSON lines for non-empty batches: {type:"logs", logs:[...]}
+`
+).action((buildId, options, command) => sandboxLogsCommand(buildId, options, command));
 sandbox.command("rebuild-stale").description("Create stale sandbox template rebuild campaigns").option("--business <id>", "Business ID to scan; defaults to authenticated user's business").option("--all", "Scan all businesses").option("--dry-run", "Preview stale rebuilds without queueing provider builds").option("--yes", "Start a rebuild campaign").option("--follow", "Follow campaign progress").action((options, command) => sandboxRebuildStaleCommand(options, command));
 var sandboxAssign = sandbox.command("assign").description("Assign sandbox layer sources");
 sandboxAssign.command("default").description("Set the business default sandbox layer source").argument("<source-repo>", "Source repository owner/name").option("--manifest <path>", "Manifest path", ".arcanist/sandbox.yaml").option("--business <id>", "Business ID; defaults to authenticated user's business").action((sourceRepo, options, command) => sandboxAssignDefaultCommand(sourceRepo, options, command));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryarcanist/cli",
-  "version": "0.1.169",
+  "version": "0.1.170",
   "description": "CLI for Arcanist — create and manage coding agent sessions",
   "type": "module",
   "bin": {