akm-cli 0.10.261012-beta → 0.10.261014-beta

package/dist/output/text/workflow-format.js

@@ -12,7 +12,7 @@
 export function formatWorkflowListPlain(result) {
     const runs = Array.isArray(result.runs) ? result.runs : [];
     if (runs.length === 0) {
-        return "No workflow runs in the current working scope. Start one with `akm workflow run workflows/<name>` or author one with `akm workflow create <name>`.";
+        return "No workflow runs. Start one with `akm workflow run workflows/<name>` or author one with `akm workflow create <name>`.";
     }
     return runs
         .map((run) => {
@@ -35,7 +35,7 @@ const CHILD_STATUS_GLYPHS = {
     failed: "✗",
 };
 /**
- * Render one `children:` tree node (P3b, spec §4.5) plus its own children,
+ * Render one `children:` tree node plus its own children,
  * recursively, indenting two spaces per level. Order is SPAWN order (the
  * envelope's own array order) — the tree is structural, never severity-sorted.
  */
@@ -56,6 +56,40 @@ function renderChildNode(child, depth, lines) {
     for (const grandchild of nested)
         renderChildNode(grandchild, depth + 1, lines);
 }
+/**
+ * The `show` orchestration projection as text lines: the exec argv (JSON, so
+ * word boundaries survive), cwd, env refs and the bundle-qualified ref each
+ * token resolved to. Shared by `workflow plan` steps and `status --units`.
+ */
+function renderOrchestrationLines(value, prefix) {
+    if (typeof value !== "object" || value === null)
+        return [];
+    const orchestration = value;
+    const lines = [];
+    const exec = typeof orchestration.exec === "object" && orchestration.exec !== null
+        ? orchestration.exec
+        : undefined;
+    if (exec) {
+        if (Array.isArray(exec.command))
+            lines.push(`${prefix}argv: ${JSON.stringify(exec.command)}`);
+        if (typeof exec.cwd === "string")
+            lines.push(`${prefix}cwd: ${exec.cwd}`);
+    }
+    if (Array.isArray(orchestration.env) && orchestration.env.length > 0) {
+        lines.push(`${prefix}env: ${orchestration.env.join(", ")}`);
+    }
+    const refs = Array.isArray(orchestration.refs) ? orchestration.refs : [];
+    for (const ref of refs) {
+        const written = ref.in === "argv" || ref.in === "cwd" ? `\${${String(ref.ref)}}` : String(ref.ref);
+        lines.push(`${prefix}ref: ${written} -> ${String(ref.resolved)} (${String(ref.in)})`);
+    }
+    const unresolved = Array.isArray(orchestration.unresolved)
+        ? orchestration.unresolved
+        : [];
+    for (const ref of unresolved)
+        lines.push(`${prefix}ref: ${String(ref.ref)} -> not found (${String(ref.in)})`);
+    return lines;
+}
 export function formatWorkflowStatusPlain(result) {
     const run = typeof result.run === "object" && result.run !== null ? result.run : undefined;
     const workflow = typeof result.workflow === "object" && result.workflow !== null
@@ -84,10 +118,9 @@ export function formatWorkflowStatusPlain(result) {
             }
         }
     }
-    // The parent-child status tree (P3b, spec §4.5): renders ONLY when
+    // The parent-child status tree: renders ONLY when
     // `children` is a non-empty array, immediately after `steps:` and before
-    // `units:`. Absent for a childless run — byte-identical to pre-P3b text
-    // (row B-33, PRESERVE).
+    // `units:`. Absent for a childless run, whose text is unchanged.
     const children = Array.isArray(result.children) ? result.children : undefined;
     if (children && children.length > 0) {
         lines.push("children:");
@@ -111,6 +144,7 @@ export function formatWorkflowStatusPlain(result) {
             if (typeof unit.failureReason === "string" && unit.failureReason.trim()) {
                 lines.push(`    failure_reason: ${unit.failureReason}`);
             }
+            lines.push(...renderOrchestrationLines(unit.orchestration, "    "));
             if (typeof unit.diagnostic === "string" && unit.diagnostic.trim()) {
                 const diagLines = unit.diagnostic.split("\n");
                 lines.push(`    diagnostic: ${diagLines[0]}`);
@@ -147,12 +181,6 @@ export function formatWorkflowRunPlain(result) {
     if (!run)
         return null;
     const lines = [];
-    // #919: `workflow run <ref>` silently resuming an existing active run (the
-    // #485 concurrency guard) is now announced up front, with the escape hatch.
-    if (result.resumed === true) {
-        lines.push(`resuming existing run ${String(run.id ?? "unknown")} for ${String(run.workflowRef ?? "this ref")}; ` +
-            `pass --new to start a fresh run`);
-    }
     lines.push(`run: ${String(run.id ?? "unknown")}`, `status: ${String(run.status ?? "unknown")}`);
     // Creation-time notices (e.g. the implicit engine fallback) must survive the
     // text renderer: JSON/YAML pass them through, and dropping them here would
@@ -231,11 +259,11 @@ function formatInputBindingsList(bindings) {
         .join(", ");
 }
 /**
- * One `akm workflow plan` step line (P3b, spec §4.6), plus its child-workflow
+ * One `akm workflow plan` step line, plus its child-workflow
  * expansion's own steps, recursively, indented one level per composition
  * boundary. A child step also carries the child's `planHash` on the step
  * line itself, and (when present) a `with:` line for the step's own
- * `inputBindings[]` — §4.6's worked example.
+ * `inputBindings[]`.
  */
 function renderPlanStepLines(step, ordinal, lines, prefix = "  ") {
     const stepId = typeof step.stepId === "string" ? step.stepId : "unknown";
@@ -252,6 +280,7 @@ function renderPlanStepLines(step, ordinal, lines, prefix = "  ") {
     if (inputBindings.length > 0) {
         lines.push(`${detailPrefix}with: ${formatInputBindingsList(inputBindings)}`);
     }
+    lines.push(...renderOrchestrationLines(step.orchestration, detailPrefix));
     if (via === "child") {
         const childSteps = Array.isArray(expansion.steps) ? expansion.steps : [];
         for (const [index, childStep] of childSteps.entries()) {
@@ -260,9 +289,9 @@ function renderPlanStepLines(step, ordinal, lines, prefix = "  ") {
     }
 }
 /**
- * `akm workflow plan <ref>` text mode (P3b, spec §4.6): a human summary of
+ * `akm workflow plan <ref>` text mode: a human summary of
  * the same compile+freeze data `--format json` returns — never a resolved
- * env/secret value (B-52, B-53).
+ * env/secret value.
  */
 export function formatWorkflowPlanPlain(result) {
     if (typeof result.ref !== "string")

package/dist/output/text.js

@@ -76,7 +76,7 @@ const BUILT_IN_TEXT_FORMATTERS = [
 registerTextFormatters(BUILT_IN_TEXT_FORMATTERS);
 // ── JSONL output (unchanged — not part of the formatPlain dispatch) ───────────
 export function outputJsonl(command, shaped) {
-    if (command === "search" || command === "registry-search") {
+    if (command === "search") {
         const r = shaped;
         const hits = Array.isArray(r.hits) ? r.hits : [];
         for (const hit of hits) {

package/dist/registry/providers/skills-sh.js

@@ -23,12 +23,7 @@ class SkillsShProvider {
         try {
             const entries = await this.fetchSkills(options.query, options.limit);
             const limited = entries.slice(0, options.limit);
-            const hits = this.mapToHits(limited);
-            let assetHits;
-            if (options.includeAssets) {
-                assetHits = this.mapToAssetHits(limited);
-            }
-            return { hits, assetHits };
+            return { hits: this.mapToHits(limited) };
         }
         catch (err) {
             return {
@@ -97,28 +92,6 @@ class SkillsShProvider {
             };
         });
     }
-    mapToAssetHits(entries) {
-        if (entries.length === 0)
-            return undefined;
-        const registryName = this.config.name ?? "skills.sh";
-        const maxInstalls = Math.max(...entries.map((e) => e.installs), 1);
-        const hits = entries.map((entry) => {
-            const segments = entry.source.split("/");
-            const owner = segments[0] ?? "";
-            const repo = segments[1] ?? "";
-            const ownerRepo = owner && repo ? `${owner}/${repo}` : entry.source;
-            return {
-                type: "registry-asset",
-                assetType: "skill",
-                assetName: entry.name,
-                stash: { id: `skills-sh:${entry.id}`, name: entry.name },
-                registryName,
-                action: `akm bundle add github:${ownerRepo}`,
-                score: Math.round((entry.installs / maxInstalls) * 1000) / 1000,
-            };
-        });
-        return hits.length > 0 ? hits : undefined;
-    }
     // ── DB cache key ────────────────────────────────────────────────────────
     queryDbCacheKey(query, limit) {
         const hash = md5Hex(`${this.config.url}\0${query.trim().toLowerCase()}\0${String(limit)}`);

package/dist/registry/providers/static-index.js

@@ -28,13 +28,7 @@ class StaticIndexProvider {
         const warnings = [];
         const bundles = await this.loadBundles(warnings);
         const hits = scoreBundles(bundles, options.query, options.limit);
-        let assetHits;
-        if (options.includeAssets) {
-            const scored = scoreAssets(bundles, options.query, options.limit);
-            if (scored.length > 0)
-                assetHits = scored;
-        }
-        return { hits, assetHits, warnings: warnings.length > 0 ? warnings : undefined };
+        return { hits, warnings: warnings.length > 0 ? warnings : undefined };
     }
     // ── Internals ───────────────────────────────────────────────────────────
     async loadBundles(warnings) {
@@ -226,70 +220,6 @@ function parseAssetEntry(raw) {
         estimatedTokens: typeof obj.estimatedTokens === "number" ? obj.estimatedTokens : undefined,
     };
 }
-// ── Asset-level scoring ─────────────────────────────────────────────────────
-function scoreAssets(stashes, query, limit) {
-    const tokens = query.toLowerCase().split(/\s+/).filter(Boolean);
-    if (tokens.length === 0)
-        return [];
-    const scored = [];
-    for (const { stash, registryName } of stashes) {
-        if (!stash.assets || stash.assets.length === 0)
-            continue;
-        const installRef = buildInstallRef(stash.source, stash.ref, "registry");
-        for (const asset of stash.assets) {
-            const score = scoreAsset(asset, tokens);
-            if (score > 0) {
-                scored.push({
-                    hit: {
-                        type: "registry-asset",
-                        assetType: asset.type,
-                        assetName: asset.name,
-                        description: asset.description,
-                        estimatedTokens: asset.estimatedTokens,
-                        stash: { id: stash.id, name: stash.name },
-                        registryName,
-                        action: `akm bundle add ${installRef}`,
-                        score: Math.round(score * 1000) / 1000,
-                    },
-                    score,
-                });
-            }
-        }
-    }
-    scored.sort((a, b) => b.score - a.score);
-    return scored.slice(0, limit).map(({ hit }) => hit);
-}
-function scoreAsset(asset, tokens) {
-    let score = 0;
-    const nameLower = asset.name.toLowerCase();
-    const descLower = (asset.description ?? "").toLowerCase();
-    const tagsLower = (asset.tags ?? []).map((t) => t.toLowerCase());
-    const typeLower = asset.type.toLowerCase();
-    for (const token of tokens) {
-        if (nameLower === token) {
-            score += 1.0;
-        }
-        else if (nameLower.includes(token)) {
-            score += 0.6;
-        }
-        if (typeLower === token) {
-            score += 0.4;
-        }
-        else if (typeLower.includes(token)) {
-            score += 0.2;
-        }
-        if (tagsLower.some((tag) => tag === token)) {
-            score += 0.5;
-        }
-        else if (tagsLower.some((tag) => tag.includes(token))) {
-            score += 0.25;
-        }
-        if (descLower.includes(token)) {
-            score += 0.2;
-        }
-    }
-    return tokens.length > 0 ? score / tokens.length : 0;
-}
 // ── Utilities ───────────────────────────────────────────────────────────────
 function asSource(value) {
     if (value === "npm" || value === "github" || value === "git" || value === "local")

package/dist/runtime.js

@@ -170,7 +170,8 @@ function endWriteStream(out) {
 }
 /**
  * Stream a `Response` body to `filePath` enforcing an explicit max-bytes cap
- * and an overall body-read deadline.
+ * and an overall body-read deadline, or with `stallTimeoutMs` a limit on the
+ * time without bytes instead (a slow body finishes, a stopped one fails).
  *
  * Refuses before reading when `Content-Length` exceeds the cap; otherwise
  * streams chunk-by-chunk, aborting with {@link ResponseTooLargeError} the
@@ -203,7 +204,10 @@ export async function writeResponseToFileCapped(filePath, res, options) {
     let total = 0;
     try {
         while (true) {
-            const { done, value } = await readChunkWithDeadline(reader, deadlineAt, options?.signal, url, bodyTimeoutMs);
+            // With `stallTimeoutMs` the deadline moves with every read: the body may take as long as bytes keep coming.
+            const readBy = options?.stallTimeoutMs ? Date.now() + options.stallTimeoutMs : deadlineAt;
+            const limitMs = options?.stallTimeoutMs ?? bodyTimeoutMs;
+            const { done, value } = await readChunkWithDeadline(reader, readBy, options?.signal, url, limitMs);
             if (done)
                 break;
             if (!value)