@workbench-ai/workbench 0.0.83 → 0.0.85

package/dist/index.js

@@ -908,7 +908,7 @@ async function handleInstall(parsed, io) {
         },
     });
     const fanout = parsed.flags["dry-run"] === true
-        ? skippedFanOut(result.directoryName, result.destination)
+        ? skippedFanOut(result.directoryName, result.destination, result.result === "unchanged" ? "unchanged" : "dry-run")
         : await fanOutSkill(result.directoryName, { skillDir: result.destination });
     const next = installNextCommand(fanout);
     return emitResult("workbench.cli.install.v1", {
@@ -1008,16 +1008,16 @@ async function handleCloudImprove(parsed, io) {
         ...(next ? [`next: ${next}`] : []),
     ].filter(Boolean).join("\n"));
 }
-function skippedFanOut(name, destination) {
+function skippedFanOut(name, destination, reason) {
     return {
         status: "skipped",
         command: manualFanOutCommand(destination, name),
         linkedAgents: [],
-        reason: "dry-run",
+        reason,
     };
 }
 function installNextCommand(fanout) {
-    return fanout.status === "failed" || (fanout.status === "skipped" && fanout.reason !== "dry-run")
+    return fanout.status === "failed" || (fanout.status === "skipped" && fanout.reason !== "dry-run" && fanout.reason !== "unchanged")
         ? fanout.command
         : null;
 }
@@ -1026,11 +1026,20 @@ function formatInstallOutcome(result, dryRun) {
         if (result.result === "unchanged") {
             return `Already installed ${result.directoryName} at ${result.destination} (unchanged; dry run made no changes).`;
         }
+        if (result.previous === "updated") {
+            return `Would update ${result.directoryName} at ${result.destination} (${formatFileCount(result.filesCopied)}).`;
+        }
+        if (result.previous === "overwritten") {
+            return `Would overwrite ${result.directoryName} at ${result.destination} (${formatFileCount(result.filesCopied)}).`;
+        }
         return `Would install ${result.directoryName} to ${result.destination} (${formatFileCount(result.filesCopied)}).`;
     }
     if (result.result === "unchanged") {
         return `Already installed ${result.directoryName} at ${result.destination} (unchanged).`;
     }
+    if (result.previous === "updated") {
+        return `Updated ${result.directoryName} at ${result.destination} (${formatFileCount(result.filesCopied)}).`;
+    }
     const detail = result.previous === "overwritten"
         ? `overwrote existing copy, ${formatFileCount(result.filesCopied)}`
         : formatFileCount(result.filesCopied);
@@ -1051,9 +1060,13 @@ function fanOutToJson(fanout) {
 }
 function formatFanOut(fanout) {
     if (fanout.status === "skipped") {
-        return fanout.reason === "dry-run"
-            ? "fanout: planned"
-            : `fanout skipped: ${fanout.reason ?? "not available"}`;
+        if (fanout.reason === "dry-run") {
+            return "fanout: planned";
+        }
+        if (fanout.reason === "unchanged") {
+            return "fanout: unchanged";
+        }
+        return `fanout skipped: ${fanout.reason ?? "not available"}`;
     }
     if (fanout.status === "failed") {
         return `fanout failed: ${fanout.reason ?? "unknown failure"}`;
@@ -2990,17 +3003,30 @@ function versionHasAncestor(snapshot, versionId, ancestorId) {
     return false;
 }
 function displayRef(id) {
+    return displayRefWithMinLength(id, 8);
+}
+function displayRefWithMinLength(id, minLength) {
     const version = /^v_([0-9a-f]{8,})$/iu.exec(id);
     if (version?.[1]) {
-        return version[1].slice(0, 8);
+        return version[1].slice(0, minLength);
     }
     const separator = id.indexOf("_");
     if (separator > 0 && separator < id.length - 1) {
         const prefix = id.slice(0, separator);
         const suffix = id.slice(separator + 1);
-        return `${prefix}_${suffix.slice(0, 8)}`;
+        return `${prefix}_${suffix.slice(0, minLength)}`;
     }
-    return id.length > 8 ? id.slice(0, 8) : id;
+    return id.length > minLength ? id.slice(0, minLength) : id;
+}
+function displayRefsForIds(ids) {
+    const uniqueIds = [...new Set(ids)];
+    for (let length = 8; length <= 32; length += 1) {
+        const refs = uniqueIds.map((id) => displayRefWithMinLength(id, length));
+        if (new Set(refs).size === refs.length) {
+            return new Map(uniqueIds.map((id, index) => [id, refs[index]]));
+        }
+    }
+    return new Map(uniqueIds.map((id) => [id, id]));
 }
 function shortenCommandRefs(command) {
     return command.replace(/\b(?:v_[0-9a-f]{8,}|(?:run|job|trace|artifact)_[a-z0-9_-]+)/giu, (match) => displayRef(match));
@@ -3167,8 +3193,16 @@ function evidencePathSegment(value) {
     return value.replace(/[^A-Za-z0-9._-]+/gu, "-") || "_";
 }
 function formatRunOrJobEvidence(jobs, details, files) {
-    const jobLines = jobs.length > 0 ? ["Jobs:", ...jobs.map(formatJobEvidenceSummary)] : [];
-    const detailLines = details.map(formatTraceDetail).filter(Boolean);
+    const jobRefs = displayRefsForIds([
+        ...jobs.map((job) => job.id),
+        ...details.flatMap((detail) => detail.executions.flatMap((execution) => execution.jobIds)),
+    ]);
+    const runRefs = displayRefsForIds([
+        ...jobs.map((job) => job.runId),
+        ...details.map((detail) => detail.runId),
+    ]);
+    const jobLines = jobs.length > 0 ? ["Jobs:", ...jobs.map((job) => formatJobEvidenceSummary(job, jobRefs))] : [];
+    const detailLines = details.map((detail) => formatTraceDetail(detail, { jobRefs, runRefs })).filter(Boolean);
     const fileLines = files.length > 0 ? ["Files:", ...files.map((file) => file.path)] : [];
     return [...jobLines, ...detailLines, ...fileLines].join("\n") || "No evidence.";
 }
@@ -3183,9 +3217,9 @@ function jobEvidenceSummary(job) {
         ...(job.error ? { error: job.error } : {}),
     };
 }
-function formatJobEvidenceSummary(job) {
+function formatJobEvidenceSummary(job, refs = new Map()) {
     return [
-        displayRef(job.id),
+        refs.get(job.id) ?? displayRef(job.id),
         `case=${job.caseId}`,
         `sample=${job.sample}`,
         job.status,
@@ -3304,17 +3338,9 @@ function findShowFile(files, requestedPath, objectRef) {
     if (candidates.length === 1) {
         return candidates[0];
     }
-    const equivalentCandidate = singleEquivalentShowFile(candidates);
-    if (equivalentCandidate) {
-        return equivalentCandidate;
-    }
     if (candidates.length === 0 && suffixCandidates.length === 1) {
         return suffixCandidates[0];
     }
-    const equivalentSuffixCandidate = singleEquivalentShowFile(suffixCandidates);
-    if (equivalentSuffixCandidate) {
-        return equivalentSuffixCandidate;
-    }
     throw ambiguousShowPath(objectRef, requestedPath, candidates.length > 0 ? candidates : suffixCandidates);
 }
 function singleEquivalentShowFile(files) {
@@ -3672,11 +3698,11 @@ function traceSummary(trace) {
         files: trace.files.map(fileSummary),
     };
 }
-function formatTraceDetail(detail) {
+function formatTraceDetail(detail, refs = {}) {
     return detail.executions.map((execution) => {
         const sessionLabels = execution.sessions.map((session) => session.label).join(",");
         return [
-            `${execution.id}\trun=${displayRef(detail.runId)}\tjobs=${execution.jobIds.map(displayRef).join(",")}\tstatus=${execution.status}`,
+            `${execution.id}\trun=${refs.runRefs?.get(detail.runId) ?? displayRef(detail.runId)}\tjobs=${execution.jobIds.map((id) => refs.jobRefs?.get(id) ?? displayRef(id)).join(",")}\tstatus=${execution.status}`,
             `events=${execution.trace.events.length}`,
             `spans=${execution.trace.spans.length}`,
             `summaries=${execution.trace.summaries.length}`,

package/dist/install-targets.d.ts

@@ -18,7 +18,7 @@ export interface WorkbenchInstallStoreResult {
     store: StoreKind;
     directoryName: string;
     destination: string;
-    previous: "none" | "overwritten" | "unchanged";
+    previous: "none" | "updated" | "overwritten" | "unchanged";
     filesCopied: number;
     contentHash: string;
     provenancePath: string;

package/dist/install-targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-targets.d.ts","sourceRoot":"","sources":["../src/install-targets.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"install-targets.d.ts","sourceRoot":"","sources":["../src/install-targets.ts"],"names":[],"mappings":"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"}

package/dist/install-targets.js

@@ -13,12 +13,14 @@ export function provenancePathForStore(storeRoot = canonicalSkillsStore()) {
 }
 export async function installSnapshotToStore(options) {
     const skillName = canonicalSkillDirectoryName(options.snapshot);
-    const destination = path.join(canonicalSkillsStore(), skillName);
+    const storeRoot = canonicalSkillsStore();
+    const destination = path.join(storeRoot, skillName);
     const normalizedFiles = options.snapshot.files.map((file) => ({
         ...file,
         path: normalizeInstallSnapshotPath(file.path),
     }));
     const contentHash = contentHashForFiles(normalizedFiles);
+    const provenance = await readProvenanceFile(storeRoot);
     const existingHash = await readExistingTreeHash(destination).catch((error) => {
         const code = error.code;
         if (code === "ENOENT") {
@@ -34,10 +36,16 @@ export async function installSnapshotToStore(options) {
         }
         throw error;
     });
+    const existingRecord = provenance.skills[skillName];
+    const canUpdateExisting = Boolean(existingHash &&
+        existingRecord &&
+        existingHash === existingRecord.contentHash &&
+        existingRecord.handle === options.provenance.handle &&
+        existingRecord.baseUrl === options.provenance.baseUrl);
     const previous = existingHash
-        ? existingHash === contentHash ? "unchanged" : "overwritten"
+        ? existingHash === contentHash ? "unchanged" : canUpdateExisting ? "updated" : "overwritten"
         : "none";
-    if (existingHash && previous !== "unchanged" && !options.overwrite) {
+    if (existingHash && previous === "overwritten" && !options.overwrite) {
         throw new WorkbenchCodedError("install_failed", `Canonical skill already exists: ${destination}`, {
             remediation: "Pass --yes to overwrite the existing canonical store skill.",
             subject: { destination },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbench-ai/workbench",
-  "version": "0.0.83",
+  "version": "0.0.85",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/workbench-ai/workbench.git",
@@ -22,10 +22,10 @@
   "dependencies": {
     "skills": "1.5.11",
     "yaml": "^2.8.2",
-    "@workbench-ai/workbench-core": "0.0.83",
-    "@workbench-ai/workbench-built-in-adapters": "0.0.83",
-    "@workbench-ai/workbench-protocol": "0.0.83",
-    "@workbench-ai/workbench-contract": "0.0.83"
+    "@workbench-ai/workbench-built-in-adapters": "0.0.85",
+    "@workbench-ai/workbench-protocol": "0.0.85",
+    "@workbench-ai/workbench-core": "0.0.85",
+    "@workbench-ai/workbench-contract": "0.0.85"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.2.2",
@@ -36,7 +36,7 @@
     "react-dom": "^19.2.0",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4",
-    "@workbench-ai/workbench-ui": "0.0.83"
+    "@workbench-ai/workbench-ui": "0.0.85"
   },
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.json && chmod 755 dist/workbench.js && node ./scripts/build-dev-open-assets.mjs",