@constraint/cli 0.3.4 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constraint/cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Install, publish, and report Agent Skills with Constraint",
   "type": "module",
   "bin": {

package/skills/constraint-skills/references/commands.md

@@ -49,11 +49,16 @@ constraint skills run complete <run-id> <actual-transcript-path>
 constraint skills run list
 constraint skills run list --team <domain> --user <workos-user-id> --skill <skill>
 constraint skills run get <run-id>
-constraint skills run get <run-id> --raw --output transcript.jsonl
+constraint skills run get <run-id> --raw
 ```
 
 Repeat `--team`, `--user`, or `--skill` to request subsets. Review visibility is permission-controlled.
 
+`run get` never prints a transcript to stdout: it writes the run JSON (or the
+original transcript file with `--raw`) under the system temp directory and
+prints a one-object summary containing the file `path`. Read the file from
+that path. Pass `--output <path>` to choose the destination (single run only).
+
 ## Automation and recovery
 
 Global flags: `--json`, `--quiet`, `--no-color`, `--help`, and `--version`. Installer workflows also accept `--yes`.

package/src/cli.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import os from 'node:os';
 import path from 'node:path';
 import readline from 'node:readline/promises';
 
@@ -35,7 +36,7 @@ import {
   uploadSkill,
 } from './skills.js';
 
-const VERSION = '0.3.4';
+const VERSION = '0.3.6';
 
 const HELP = `Constraint Skills CLI
 
@@ -56,7 +57,7 @@ Usage:
   constraint skills run start <skill> --client <client> --session <session-id>
   constraint skills run complete <run-id> <transcript-path>
   constraint skills run list [--team <team>]... [--user <user>]... [--skill <skill>]...
-  constraint skills run get <run-id>... [--raw] [--output <path>]
+  constraint skills run get <run-id>... [--raw] [--output <path>]  (always writes a file, prints summary + path)
 
 Global options: --json --quiet --no-color --help --version`;
 
@@ -511,23 +512,50 @@ async function runList(args, config, out) {
   out.data(await apiRequest(config, `/skill-runs?${query.toString()}`));
 }
 
+// Run payloads are whole session transcripts — megabytes of JSON that would
+// flood a terminal or an agent's context. runGet therefore always writes to a
+// file and prints only a summary with the path; there is no stdout mode.
+async function runGetDestination(output, runId, extension) {
+  if (output) return path.resolve(output);
+  const directory = path.join(os.tmpdir(), 'constraint', 'runs');
+  await fs.mkdir(directory, { recursive: true });
+  return path.join(directory, `${runId}${extension}`);
+}
+
 async function runGet(args, config, out) {
   const raw = takeFlag(args, '--raw');
   const output = takeOption(args, '--output');
   rejectUnknown(args);
   if (!args.length) throw new Error('Usage: constraint skills run get <run-id>...');
+  if (output && args.length !== 1) throw new Error('--output accepts exactly one run ID');
   if (raw && args.length !== 1) throw new Error('--raw accepts exactly one run ID');
   if (raw) {
     const response = await apiRequest(config, `/skill-runs/${encodeURIComponent(args[0])}/transcript`, { rawResponse: true });
     const content = Buffer.from(await response.arrayBuffer());
-    if (output) await fs.writeFile(path.resolve(output), content);
-    else process.stdout.write(content);
+    const destination = await runGetDestination(output, args[0], '.transcript');
+    await fs.writeFile(destination, content);
+    out.data({ run_id: args[0], bytes: content.length, path: destination });
     return;
   }
-  const runs = await Promise.all(args.map((runId) => apiRequest(config, `/skill-runs/${encodeURIComponent(runId)}`)));
-  const value = runs.length === 1 ? runs[0] : runs;
-  if (output) await fs.writeFile(path.resolve(output), `${JSON.stringify(value, null, 2)}\n`);
-  else out.data(value);
+  const summaries = [];
+  for (const runId of args) {
+    const run = await apiRequest(config, `/skill-runs/${encodeURIComponent(runId)}`);
+    const destination = await runGetDestination(output, runId, '.json');
+    await fs.writeFile(destination, `${JSON.stringify(run, null, 2)}\n`);
+    const events = Array.isArray(run.normalized_events) ? run.normalized_events : [];
+    summaries.push({
+      run_id: run.run_id,
+      skill: run.skill_slug,
+      version: run.skill_version,
+      state: run.state,
+      client: run.client,
+      completed_at: run.completed_at,
+      events: events.length,
+      events_with_text: events.filter((event) => event.content).length,
+      path: destination,
+    });
+  }
+  out.data(summaries.length === 1 ? summaries[0] : summaries);
 }
 
 async function runCommand(args, config, out) {

package/src/config.js

@@ -28,6 +28,9 @@ export async function loadConfig() {
   return {
     apiUrl: (process.env.CONSTRAINT_API_URL || saved.apiUrl || DEFAULT_API_URL).replace(/\/$/, ''),
     agents: Array.isArray(saved.agents) ? saved.agents : Array.isArray(saved.clients) ? saved.clients : [],
+    companion_hashes: saved.companion_hashes && typeof saved.companion_hashes === 'object'
+      ? saved.companion_hashes
+      : {},
   };
 }
 

package/src/setup.js

@@ -42,6 +42,13 @@ async function companionFiles() {
   return readSkillDirectory(path.resolve(here, '..', 'skills', 'constraint-skills'));
 }
 
+export function expectedCompanionHash(config, selected, currentHash) {
+  const direct = config.companion_hashes?.[selected] || null;
+  if (direct) return direct;
+  const recorded = Object.values(config.companion_hashes || {});
+  return currentHash && recorded.includes(currentHash) ? currentHash : null;
+}
+
 async function instructionPlan(selected, paths) {
   let existing = '';
   let mode = 0o644;
@@ -59,7 +66,6 @@ async function skillPlan(selected, paths) {
   const files = await companionFiles();
   const bundledHash = packageDigest(files);
   const config = await loadConfig();
-  const expectedHash = config.companion_hashes?.[selected] || null;
   const target = path.join(paths.skills, 'constraint-skills');
   let currentHash = null;
   try {
@@ -67,6 +73,7 @@ async function skillPlan(selected, paths) {
   } catch (error) {
     if (error && error.code !== 'ENOENT') throw error;
   }
+  const expectedHash = expectedCompanionHash(config, selected, currentHash);
   const action = currentHash === bundledHash
     ? 'current'
     : currentHash === null
@@ -109,8 +116,9 @@ export async function installCompanionSkill(agent) {
   const config = await loadConfig();
   config.companion_hashes ||= {};
   const target = path.join(paths.skills, 'constraint-skills');
+  const plan = await skillPlan(selected, paths);
   const result = await writeSkillDirectory(target, files, {
-    expectedHash: config.companion_hashes[selected] || null,
+    expectedHash: plan.expectedHash,
   });
   config.companion_hashes[selected] = result.hash;
   await recordConfiguredAgent(selected, config);