@squadrules/mcp 5.4.1 → 5.5.0

package/dist/cli/render.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Human-first renderers for CLI data-command output (pretty + text), plus the
+ * next-call hint.
+ *
+ * `pretty` is the default on a TTY: a compact, readable rendering on stdout. `text`
+ * is a minimal, script-friendly rendering. JSON mode bypasses these and prints the
+ * canonical response object. The next-call hint (the shell command to run next) is
+ * printed on stderr in pretty mode only — JSON mode keeps the structured `next_call`
+ * in the body, so the two never mix text into JSON.
+ */
+import type { ActivateOutput } from '../tools/activate_schema.js';
+import type { ForwardOutput } from '../tools/forward_schema.js';
+import type { RewardOutput } from '../tools/reward_schema.js';
+import type { TuneOutput } from '../tools/tune_schema.js';
+import type { DeleteOutput } from '../tools/delete_schema.js';
+import type { TrainOutput } from '../tools/train_schema.js';
+import type { SpacesOutput } from './backend/action-backend.js';
+/**
+ * Build the short "run this next" hint for pretty mode. Returns null when the response
+ * carries no actionable next step (for example a terminal reward).
+ */
+export declare function nextCallHint(response: unknown): string | null;
+export declare function renderActivatePretty(out: ActivateOutput): string;
+export declare function renderActivateText(out: ActivateOutput): string;
+export declare function renderForwardPretty(out: ForwardOutput): string;
+export declare function renderForwardText(out: ForwardOutput): string;
+export declare function renderRewardPretty(out: RewardOutput): string;
+export declare function renderRewardText(out: RewardOutput): string;
+export declare function renderTunePretty(out: TuneOutput): string;
+export declare function renderTuneText(out: TuneOutput): string;
+export declare function renderDeletePretty(out: DeleteOutput): string;
+export declare function renderDeleteText(out: DeleteOutput): string;
+export declare function renderSpacesPretty(out: SpacesOutput): string;
+export declare function renderSpacesText(out: SpacesOutput): string;
+export declare function renderTrainPretty(out: TrainOutput): string;
+export declare function renderTrainText(out: TrainOutput): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/cli/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/cli/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AA0ChE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAS7D;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAkBhE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAE9D;AAMD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAgB9D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE5D;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAO5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE1D;AAMD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAMxD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEtD;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAM5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE1D;AAMD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAW5D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAI1D;AAMD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAO1D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAExD"}

package/dist/cli/render.js

@@ -0,0 +1,179 @@
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function shellQuote(value) {
+    return `'${value}'`;
+}
+// ---------------------------------------------------------------------------
+// next-call hint (stderr, pretty mode)
+// ---------------------------------------------------------------------------
+function forwardSnippetFromNextCall(nextCall) {
+    const kind = nextCall['kind'];
+    const args = nextCall['args'];
+    if (!isObject(args) || typeof args['uri'] !== 'string')
+        return null;
+    if (kind === 'forward') {
+        const solution = isObject(args['solution_template']) ? args['solution_template'] : {};
+        return `squadrules forward ${shellQuote(args['uri'])} --solution ${shellQuote(JSON.stringify(solution))}`;
+    }
+    if (kind === 'reward') {
+        return `squadrules reward ${shellQuote(args['uri'])} success 'completed'`;
+    }
+    return null;
+}
+function forwardSnippetFromChoices(response) {
+    if (!Array.isArray(response['choices']))
+        return null;
+    for (const choice of response['choices']) {
+        if (!isObject(choice))
+            continue;
+        const first = choice['forward_first_call'];
+        if (isObject(first) && typeof first['uri'] === 'string') {
+            return `squadrules forward ${shellQuote(first['uri'])}`;
+        }
+    }
+    return null;
+}
+/**
+ * Build the short "run this next" hint for pretty mode. Returns null when the response
+ * carries no actionable next step (for example a terminal reward).
+ */
+export function nextCallHint(response) {
+    if (!isObject(response))
+        return null;
+    if (isObject(response['next_call'])) {
+        const snippet = forwardSnippetFromNextCall(response['next_call']);
+        return snippet ? `next: ${snippet}` : null;
+    }
+    const fromChoices = forwardSnippetFromChoices(response);
+    if (fromChoices)
+        return `next: ${fromChoices}`;
+    return null;
+}
+// ---------------------------------------------------------------------------
+// activate
+// ---------------------------------------------------------------------------
+export function renderActivatePretty(out) {
+    const lines = [`activate: ${JSON.stringify(out.query)}`];
+    if (out.message)
+        lines.push(out.message);
+    const choices = out.choices ?? [];
+    if (choices.length === 0) {
+        lines.push('', 'No matching adapters.');
+        return lines.join('\n');
+    }
+    lines.push('', `Choices (${choices.length}):`);
+    choices.forEach((choice, index) => {
+        const score = typeof choice.activation_score === 'number' ? ` score ${choice.activation_score.toFixed(2)}` : '';
+        const space = choice.space_name ? ` [${choice.space_name}]` : '';
+        lines.push(`  ${index + 1}. (${choice.role}) ${choice.label}${score}${space}`);
+        lines.push(`     ${choice.uri}`);
+        if (choice.next_action)
+            lines.push(`     do: ${choice.next_action}`);
+    });
+    return lines.join('\n');
+}
+export function renderActivateText(out) {
+    return (out.choices ?? []).map((choice) => choice.uri).join('\n');
+}
+// ---------------------------------------------------------------------------
+// forward
+// ---------------------------------------------------------------------------
+export function renderForwardPretty(out) {
+    const lines = [];
+    const heading = out.current_layer_label ?? out.context_adapter_name ?? 'forward';
+    lines.push(`forward: ${heading}`);
+    if (out.adapter_layer_index && out.adapter_layer_count) {
+        lines.push(`step ${out.adapter_layer_index}/${out.adapter_layer_count}`);
+    }
+    const contractType = out.contract?.type ?? 'n/a';
+    const contractDesc = out.contract?.description ? ` — ${out.contract.description}` : '';
+    lines.push(`contract: ${contractType}${contractDesc}`);
+    if (out.message)
+        lines.push(out.message);
+    if (out.current_layer?.content) {
+        lines.push('', out.current_layer.content.trim());
+    }
+    if (out.next_action)
+        lines.push('', `do: ${out.next_action}`);
+    return lines.join('\n');
+}
+export function renderForwardText(out) {
+    return out.next_action ?? '';
+}
+// ---------------------------------------------------------------------------
+// reward
+// ---------------------------------------------------------------------------
+export function renderRewardPretty(out) {
+    const lines = [`reward: rated ${out.total_rated}, failed ${out.total_failed}`];
+    for (const row of out.results ?? []) {
+        const score = typeof row.score === 'number' ? ` score ${row.score.toFixed(2)}` : '';
+        lines.push(`  ${row.uri} → ${row.outcome}${score} (${row.evaluation_label})`);
+    }
+    return lines.join('\n');
+}
+export function renderRewardText(out) {
+    return `rated ${out.total_rated} failed ${out.total_failed}`;
+}
+// ---------------------------------------------------------------------------
+// tune
+// ---------------------------------------------------------------------------
+export function renderTunePretty(out) {
+    const lines = [`tune: updated ${out.total_updated}, failed ${out.total_failed}`];
+    for (const row of out.results ?? []) {
+        lines.push(`  ${row.uri} → ${row.status}: ${row.message}`);
+    }
+    return lines.join('\n');
+}
+export function renderTuneText(out) {
+    return `updated ${out.total_updated} failed ${out.total_failed}`;
+}
+// ---------------------------------------------------------------------------
+// delete
+// ---------------------------------------------------------------------------
+export function renderDeletePretty(out) {
+    const lines = [`delete: deleted ${out.total_deleted}, failed ${out.total_failed}`];
+    for (const row of out.results ?? []) {
+        lines.push(`  ${row.uri} → ${row.status}: ${row.message}`);
+    }
+    return lines.join('\n');
+}
+export function renderDeleteText(out) {
+    return `deleted ${out.total_deleted} failed ${out.total_failed}`;
+}
+// ---------------------------------------------------------------------------
+// spaces
+// ---------------------------------------------------------------------------
+export function renderSpacesPretty(out) {
+    const spaces = out.spaces ?? [];
+    if (spaces.length === 0)
+        return 'spaces: (none)';
+    const lines = [`spaces (${spaces.length}):`];
+    for (const space of spaces) {
+        lines.push(`  ${space.name} (${space.type}): ${space.adapter_count} adapters`);
+        for (const adapter of space.adapters ?? []) {
+            lines.push(`    - ${adapter.title} (${adapter.layer_count} layers) ${adapter.uri}`);
+        }
+    }
+    return lines.join('\n');
+}
+export function renderSpacesText(out) {
+    return (out.spaces ?? [])
+        .map((space) => `${space.name}\t${space.type}\t${space.adapter_count}`)
+        .join('\n');
+}
+// ---------------------------------------------------------------------------
+// train
+// ---------------------------------------------------------------------------
+export function renderTrainPretty(out) {
+    const items = out.items ?? [];
+    const lines = [`train: ${out.status} ${items.length} item(s)`];
+    for (const item of items) {
+        lines.push(`  ${item.label} → ${item.uri}`);
+    }
+    return lines.join('\n');
+}
+export function renderTrainText(out) {
+    return (out.items ?? []).map((item) => item.uri).join('\n');
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/render.js.map

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

package/dist/cli/resolve-timeout.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shared resolution of the global `--timeout` / `--retries` options.
+ *
+ * A leaf module (no imports beyond commander types) so both the data-path client factory and
+ * the http-only auth commands (login/token, which use raw `fetch`) resolve the same values —
+ * precedence CLI flag > env var > default — without an import cycle through api-client/login.
+ */
+import type { Command } from 'commander';
+export declare const DEFAULT_TIMEOUT_MS = 15000;
+/** Resolve request timeout in ms from `--timeout <seconds>` then `SQUADRULES_TIMEOUT_MS`; undefined if unset. */
+export declare function resolveTimeoutMs(program: Command): number | undefined;
+/** Resolve max retries from `--retries <n>` then `SQUADRULES_RETRIES`; undefined if unset. */
+export declare function resolveMaxRetries(program: Command): number | undefined;
+/** Timeout in ms with a concrete default, for callers that need a number (auth fetches). */
+export declare function resolveTimeoutMsOrDefault(program: Command): number;
+//# sourceMappingURL=resolve-timeout.d.ts.map

package/dist/cli/resolve-timeout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-timeout.d.ts","sourceRoot":"","sources":["../../src/cli/resolve-timeout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAMzC,iHAAiH;AACjH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAarE;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAatE;AAED,4FAA4F;AAC5F,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAElE"}

package/dist/cli/resolve-timeout.js

@@ -0,0 +1,43 @@
+export const DEFAULT_TIMEOUT_MS = 15_000;
+function globals(program) {
+    return (program.optsWithGlobals?.() ?? program.opts());
+}
+/** Resolve request timeout in ms from `--timeout <seconds>` then `SQUADRULES_TIMEOUT_MS`; undefined if unset. */
+export function resolveTimeoutMs(program) {
+    const g = globals(program);
+    const rawTimeout = g['timeout'];
+    if (rawTimeout !== undefined) {
+        const sec = Number(rawTimeout);
+        if (Number.isFinite(sec) && sec > 0)
+            return sec * 1000;
+    }
+    const envTimeout = process.env['SQUADRULES_TIMEOUT_MS'];
+    if (envTimeout) {
+        const ms = Number(envTimeout);
+        if (Number.isFinite(ms) && ms > 0)
+            return ms;
+    }
+    return undefined;
+}
+/** Resolve max retries from `--retries <n>` then `SQUADRULES_RETRIES`; undefined if unset. */
+export function resolveMaxRetries(program) {
+    const g = globals(program);
+    const rawRetries = g['retries'];
+    if (rawRetries !== undefined) {
+        const n = Number(rawRetries);
+        if (Number.isFinite(n) && n >= 0)
+            return n;
+    }
+    const envRetries = process.env['SQUADRULES_RETRIES'];
+    if (envRetries) {
+        const n = Number(envRetries);
+        if (Number.isFinite(n) && n >= 0)
+            return n;
+    }
+    return undefined;
+}
+/** Timeout in ms with a concrete default, for callers that need a number (auth fetches). */
+export function resolveTimeoutMsOrDefault(program) {
+    return resolveTimeoutMs(program) ?? DEFAULT_TIMEOUT_MS;
+}
+//# sourceMappingURL=resolve-timeout.js.map

package/dist/cli/resolve-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-timeout.js","sourceRoot":"","sources":["../../src/cli/resolve-timeout.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,SAAS,OAAO,CAAC,OAAgB;IAC/B,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE,CAA4B,CAAC;AACpF,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,CAAuB,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,GAAG,GAAG,IAAI,CAAC;IACzD,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,iBAAiB,CAAC,OAAgB;IAChD,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,UAAU,GAAG,CAAC,CAAC,SAAS,CAAuB,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO,gBAAgB,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC;AACzD,CAAC"}

package/dist/cli/skill-zip-local-write.d.ts

@@ -9,12 +9,14 @@
  */
 export declare function safeZipBasenameFromRemoteHint(name: string | undefined): string | null;
 /**
- * Output path: explicit `--zip-out` (user-controlled), else `cwd/<sanitized remote basename or default>`.
+ * Output path: explicit `--zip-out` (user-controlled, resolved against cwd), else
+ * `<baseDir>/<sanitized remote basename or default>`. `baseDir` defaults to cwd; `export`
+ * passes its `--out` directory so skill_zip lands beside the other written artifacts.
  */
 export declare function resolveSkillZipOutputPath(zipOut: string | undefined, hints: {
-    downloadBasename?: string;
-    refBasename?: string;
-}): string;
+    downloadBasename?: string | undefined;
+    refBasename?: string | undefined;
+}, baseDir?: string): string;
 /** Reject non-ZIP payloads and oversized downloads before writing bytes from the network to disk. */
 export declare function assertSkillZipBufferAllowedForDiskWrite(data: Buffer): void;
 /** Write validated ZIP bytes after export (download_ref GET or inline base64 decode). */

package/dist/cli/skill-zip-local-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-zip-local-write.d.ts","sourceRoot":"","sources":["../../src/cli/skill-zip-local-write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASrF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACzD,MAAM,CASR;AAED,qGAAqG;AACrG,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc1E;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGpF"}
+{"version":3,"file":"skill-zip-local-write.d.ts","sourceRoot":"","sources":["../../src/cli/skill-zip-local-write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASrF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAClF,OAAO,GAAE,MAAsB,GAC9B,MAAM,CASR;AAED,qGAAqG;AACrG,wBAAgB,uCAAuC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAc1E;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGpF"}

package/dist/cli/skill-zip-local-write.js

@@ -36,16 +36,18 @@ export function safeZipBasenameFromRemoteHint(name) {
     return base;
 }
 /**
- * Output path: explicit `--zip-out` (user-controlled), else `cwd/<sanitized remote basename or default>`.
+ * Output path: explicit `--zip-out` (user-controlled, resolved against cwd), else
+ * `<baseDir>/<sanitized remote basename or default>`. `baseDir` defaults to cwd; `export`
+ * passes its `--out` directory so skill_zip lands beside the other written artifacts.
  */
-export function resolveSkillZipOutputPath(zipOut, hints) {
+export function resolveSkillZipOutputPath(zipOut, hints, baseDir = process.cwd()) {
     if (zipOut !== undefined && zipOut.trim().length > 0) {
         return path.resolve(process.cwd(), zipOut.trim());
     }
     const remote = safeZipBasenameFromRemoteHint(hints.downloadBasename) ??
         safeZipBasenameFromRemoteHint(hints.refBasename);
     const base = remote ?? DEFAULT_EXPORT_SKILL_ZIP_FILENAME;
-    return path.join(process.cwd(), base);
+    return path.join(baseDir, base);
 }
 /** Reject non-ZIP payloads and oversized downloads before writing bytes from the network to disk. */
 export function assertSkillZipBufferAllowedForDiskWrite(data) {

package/dist/cli/skill-zip-local-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-zip-local-write.js","sourceRoot":"","sources":["../../src/cli/skill-zip-local-write.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill-zip-local-write.js","sourceRoot":"","sources":["../../src/cli/skill-zip-local-write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAErF,MAAM,2BAA2B,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,SAAS,gBAAgB,CAAC,GAAuB,EAAE,QAAgB;IACjE,IAAI,GAAG,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACpE,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpD,CAAC;AAED,SAAS,wBAAwB;IAC/B,OAAO,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAChH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAwB;IACpE,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,CAAC,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA0B,EAC1B,KAAkF,EAClF,UAAkB,OAAO,CAAC,GAAG,EAAE;IAE/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GACV,6BAA6B,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACrD,6BAA6B,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,IAAI,iCAAiC,CAAC;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,uCAAuC,CAAC,IAAY;IAClE,MAAM,GAAG,GAAG,wBAAwB,EAAE,CAAC;IACvC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,mDAAmD,GAAG,yEAAyE,CAChI,CAAC;IACJ,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAChD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,2BAA2B,CAAC,UAAkB,EAAE,MAAc;IAC5E,uCAAuC,CAAC,MAAM,CAAC,CAAC;IAChD,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli/train-batch.d.ts

@@ -0,0 +1,20 @@
+import type { ResolvedFormat } from './format.js';
+import type { ActionBackend, TrainRawOptions } from './backend/action-backend.js';
+export declare function readUtf8RegularFile(absPath: string): string;
+/** The subset of `train` flags the directory batch path consumes. */
+export interface TrainBatchFlags {
+    recursive?: boolean;
+    allowSensitiveUpload?: boolean;
+    force?: boolean;
+    model?: string;
+    adapter?: string;
+    artifactName?: string;
+    mime?: string;
+    relativePath?: string;
+}
+/**
+ * Train every `.md` file under `abs` (recursively when `--recursive`), attaching sibling artifacts.
+ * Emits the batch manifest through the uniform output model. Artifact flags are single-file-only.
+ */
+export declare function runTrainBatch(backend: ActionBackend, abs: string, flags: TrainBatchFlags, trainOptions: TrainRawOptions, format: ResolvedFormat): Promise<void>;
+//# sourceMappingURL=train-batch.d.ts.map

package/dist/cli/train-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"train-batch.d.ts","sourceRoot":"","sources":["../../src/cli/train-batch.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AA6ClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU3D;AAkDD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,EACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,eAAe,EAC7B,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,IAAI,CAAC,CAsFf"}

package/dist/cli/train-batch.js

@@ -0,0 +1,168 @@
+/**
+ * Directory-batch `train` support (extracted from cli-train.ts to keep that command file small).
+ *
+ * A directory batch is machine-facing: it never dumps adapter/content bytes to stdout, prints a
+ * compact per-item summary, and `--format json` emits a manifest of what was stored. Each `.md`
+ * file is trained as an adapter and any sibling artifacts are attached to it.
+ */
+import { closeSync, fstatSync, openSync, readdirSync, readFileSync } from 'fs';
+import { join, relative, resolve } from 'path';
+import { emitResult, writeError } from './output.js';
+import { readMarkdownUploadFromFile } from './upload-guards.js';
+import { inferArtifactMimeFromName } from '../tools/artifact-mime.js';
+/** Directory batch skips `README.md` (human docs); single-file `train path/to/README.md` still works. */
+function isReadmeMarkdownFileName(name) {
+    return /^readme\.md$/i.test(name);
+}
+function listSkillFiles(dir, recursive) {
+    const base = resolve(dir);
+    const out = [];
+    const processDir = (current) => {
+        const mdPaths = [];
+        const artifactEntries = [];
+        for (const ent of readdirSync(current, { withFileTypes: true })) {
+            if (ent.isDirectory()) {
+                if (recursive)
+                    processDir(join(current, ent.name));
+            }
+            else if (ent.isFile()) {
+                const full = join(current, ent.name);
+                if (ent.name.endsWith('.md') && !isReadmeMarkdownFileName(ent.name)) {
+                    mdPaths.push(full);
+                }
+                else {
+                    const mime = inferArtifactMimeFromName(ent.name);
+                    if (mime)
+                        artifactEntries.push({ absPath: full, name: ent.name, mime });
+                }
+            }
+        }
+        for (const mdPath of mdPaths) {
+            out.push({ mdPath, artifacts: artifactEntries });
+        }
+    };
+    processDir(base);
+    return out.sort((a, b) => relative(base, a.mdPath).localeCompare(relative(base, b.mdPath)));
+}
+export function readUtf8RegularFile(absPath) {
+    const fd = openSync(absPath, 'r');
+    try {
+        if (!fstatSync(fd).isFile()) {
+            throw Object.assign(new Error('Path is not a regular file'), { code: 'ENOTREG' });
+        }
+        return readFileSync(fd, 'utf8');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+function renderBatchPretty(manifest) {
+    const lines = [
+        `train batch: ${manifest.root}`,
+        `  ${manifest.ok} ok, ${manifest.failed} failed (of ${manifest.total})`
+    ];
+    for (const row of manifest.results) {
+        if (row.ok) {
+            lines.push(`  ok  ${row.path}${row.adapter_uri ? ` → ${row.adapter_uri}` : ''}`);
+        }
+        else {
+            lines.push(`  ERR ${row.path}: ${row.error ?? 'unknown error'}`);
+        }
+    }
+    return lines.join('\n');
+}
+function renderBatchText(manifest) {
+    return manifest.results
+        .map((row) => `${row.ok ? 'ok' : 'err'}\t${row.path}\t${row.ok ? row.adapter_uri ?? '' : row.error ?? ''}`)
+        .join('\n');
+}
+/**
+ * Train every `.md` file under `abs` (recursively when `--recursive`), attaching sibling artifacts.
+ * Emits the batch manifest through the uniform output model. Artifact flags are single-file-only.
+ */
+export async function runTrainBatch(backend, abs, flags, trainOptions, format) {
+    if (typeof flags.adapter === 'string' ||
+        typeof flags.artifactName === 'string' ||
+        typeof flags.mime === 'string' ||
+        typeof flags.relativePath === 'string') {
+        writeError('Artifact flags (--adapter/--artifact-name/--mime/--relative-path) are only supported for single-file train');
+        process.exit(1);
+        return;
+    }
+    const files = listSkillFiles(abs, Boolean(flags.recursive));
+    if (files.length === 0) {
+        writeError('No .md files found in directory');
+        process.exit(1);
+        return;
+    }
+    const results = [];
+    for (const entry of files) {
+        const fp = entry.mdPath;
+        const rel = relative(abs, fp).replace(/\\/g, '/');
+        try {
+            const markdown = readMarkdownUploadFromFile(fp, 'train', Boolean(flags.allowSensitiveUpload));
+            const response = await backend.train(markdown, trainOptions);
+            const adapterUriValue = response.items[0]?.adapter_uri;
+            const resultEntry = {
+                path: rel,
+                ok: true,
+                status: response.status,
+                ...(adapterUriValue ? { adapter_uri: adapterUriValue } : {}),
+                items: response.items
+            };
+            if (entry.artifacts.length > 0) {
+                const model = flags.model?.trim();
+                const adapterUri = resultEntry.adapter_uri;
+                const artifactResults = [];
+                for (const af of entry.artifacts) {
+                    const afRel = relative(abs, af.absPath).replace(/\\/g, '/');
+                    if (!model) {
+                        writeError(`artifact_skipped: ${afRel} — add --model <id> to upload artifacts`);
+                        continue;
+                    }
+                    if (!adapterUri) {
+                        writeError(`artifact_skipped: ${afRel} — adapter_uri missing (add slug to frontmatter or use --force)`);
+                        continue;
+                    }
+                    try {
+                        const content = readUtf8RegularFile(af.absPath);
+                        const ar = await backend.trainJson({
+                            llm_model_id: model,
+                            content,
+                            force_update: Boolean(flags.force),
+                            mime: af.mime,
+                            artifact_name: af.name,
+                            adapter_uri: adapterUri,
+                            relative_path: afRel,
+                            ...(trainOptions.space ? { space: trainOptions.space } : {})
+                        });
+                        artifactResults.push({ path: afRel, ok: true, status: ar.status, items: ar.items });
+                    }
+                    catch (e) {
+                        artifactResults.push({ path: afRel, ok: false, error: e instanceof Error ? e.message : String(e) });
+                    }
+                }
+                if (artifactResults.length > 0)
+                    resultEntry.artifacts = artifactResults;
+            }
+            results.push(resultEntry);
+        }
+        catch (e) {
+            results.push({
+                path: rel,
+                ok: false,
+                error: e instanceof Error ? e.message : String(e)
+            });
+        }
+    }
+    const manifest = {
+        batch: true,
+        root: abs,
+        total: results.length,
+        ok: results.filter((r) => r.ok).length,
+        failed: results.filter((r) => !r.ok).length,
+        results
+    };
+    emitResult(format, manifest, { pretty: renderBatchPretty, text: renderBatchText });
+}
+//# sourceMappingURL=train-batch.js.map

package/dist/cli/train-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"train-batch.js","sourceRoot":"","sources":["../../src/cli/train-batch.ts"],"names":[],"mappings":"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"}

package/dist/embed-docs/mem/README.md

@@ -49,6 +49,16 @@ create-new-protocol (Author) → forward(squadrules://adapter/critic-loop) → c
 | [protocol-linking-guide.md](protocol-linking-guide.md) | `protocol-linking-guide` | Layers vs chains, `activate` vs `forward` + slug, chaining back/forward, multi-layer conductor vs extension URI, chain-root collapsing, MCP argument validation |
 | [critic-loop-guide.md](critic-loop-guide.md) | `critic-loop-guide` | Critic-loop integration rules, mutation gates, solution check vs critic decision table |
 
+## Redirect tombstones
+
+Retired slugs kept as thin one-layer redirects so stored adapters that still
+reference them resolve instead of dangling (see ADR 0012):
+
+| File | Slug | Redirects to |
+|------|------|--------------|
+| [phase-critic.md](phase-critic.md) | `phase-critic` | `critic-loop` |
+| [phase-critic-guide.md](phase-critic-guide.md) | `phase-critic-guide` | `critic-loop-guide` |
+
 ## Cross-Protocol Linking
 
 ### Layers vs chains

package/dist/embed-docs/mem/adapter-migration.md

@@ -1,5 +1,5 @@
 ---
-version: "5.4.1"
+version: "5.5.0"
 slug: adapter-migration
 title: Adapter Migration Protocol
 ---

package/dist/embed-docs/mem/bulk-insert-adapters-via-cli.md

@@ -1,6 +1,6 @@
 ---
 slug: bulk-insert-adapters-via-cli
-version: "5.4.1"
+version: "5.5.0"
 title: Bulk Insert Adapters via SQUADRULES CLI
 ---
 

package/dist/embed-docs/mem/challenge-type-guide.md

@@ -1,5 +1,5 @@
 ---
-version: "5.4.1"
+version: "5.5.0"
 slug: challenge-type-guide
 title: Challenge Type Selection Guide
 ---

package/dist/embed-docs/mem/create-new-protocol.md

@@ -1,6 +1,6 @@
 ---
 slug: create-new-protocol
-version: "5.4.1"
+version: "5.5.0"
 title: Create / Review / Refactor SQUADRULES Protocol
 ---
 

package/dist/embed-docs/mem/critic-loop-guide.md

@@ -1,5 +1,5 @@
 ---
-version: "5.4.1"
+version: "5.5.0"
 slug: critic-loop-guide
 title: Critic Loop Integration and Mutation Gate Guide
 ---