@agentworkforce/cli 0.15.1 → 0.17.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-05-08
+
+### Added
+
+- **Add optional defaultTier to PersonaSpec**
+
+### Changed
+
+- Agent: consult routingProfiles before defaultTier on no-@<tier>
+
+## [0.16.0] - 2026-05-08
+
+### Added
+
+- **Add --dry-run flag to agentworkforce agent**
+
 ## [0.15.1] - 2026-05-08
 
 ### Added

package/dist/cli.d.ts

@@ -166,6 +166,7 @@ export declare function main(): Promise<void>;
 export interface AgentFlags {
     installInRepo: boolean;
     noLaunchMetadata: boolean;
+    dryRun: boolean;
 }
 export interface CreateFlags extends AgentFlags {
     saveInDirectory?: string;

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 import { spawn, spawnSync } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
-import { appendFileSync, existsSync, mkdirSync, readFileSync, readSync, rmSync, statSync, writeFileSync } from 'node:fs';
-import { constants, homedir } from 'node:os';
+import { appendFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { constants, homedir, tmpdir } from 'node:os';
 import { dirname, isAbsolute, join, resolve as resolvePath } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { HARNESS_VALUES, PERSONA_TAGS, PERSONA_TIERS, listBuiltInPersonas, personaCatalog, resolveSidecar, routingProfiles, useSelection } from '@agentworkforce/workload-router';
+import { HARNESS_VALUES, materializeSkills, PERSONA_TAGS, PERSONA_TIERS, listBuiltInPersonas, personaCatalog, resolveSidecar, routingProfiles, useSelection } from '@agentworkforce/workload-router';
 import { buildInteractiveSpec, detectHarnesses, formatDropWarnings, MissingPersonaInputError, renderPersonaInputs, resolvePersonaInputs, resolveMcpServersLenient, resolveStringMapLenient } from '@agentworkforce/harness-kit';
 import { launchOnMount, readAgentDotfiles } from '@relayfile/local-mount';
 import ora from 'ora';
@@ -34,9 +34,11 @@ Commands:
                         --no-launch-metadata
                                             Same behavior as agent.
   agent [flags] <persona>[@<tier>]
-                      Run a persona. Tier one of: ${PERSONA_TIERS.join(' | ')}
-                      (default: best-value). Drops into an interactive harness
-                      session.
+                      Run a persona. Tier one of: ${PERSONA_TIERS.join(' | ')}.
+                      With no @<tier>, the resolution order is:
+                      routingProfiles.default.intents (built-in personas only)
+                      → persona.defaultTier (when set) → best-value. Drops into
+                      an interactive harness session.
 
                       Flags:
                         --install-in-repo   Disengage the sandbox mount and
@@ -57,6 +59,26 @@ Commands:
                                             Disable launch metadata recording.
                                             Also disabled by
                                             AGENTWORKFORCE_LAUNCH_METADATA=0.
+                        --dry-run           Validate the persona without
+                                            spawning the harness or burning
+                                            tier-model tokens. Three checks:
+                                            (1) sidecar — claudeMd / agentsMd
+                                            filename refs are readable;
+                                            (2) harness spec — permissions /
+                                            mcpServers / harness-settings
+                                            shape is accepted by the harness
+                                            translator; (3) skills — each
+                                            \`skills[].source\` is run through
+                                            its real installer (npx skills
+                                            add / npx prpm install) inside a
+                                            fresh temp dir, with per-skill
+                                            pass/fail reporting. Use this in
+                                            the persona-author loop to catch
+                                            hallucinated skill names and
+                                            malformed config before a persona
+                                            ships. Temp dir is removed on
+                                            success, kept on failure for
+                                            inspection.
   list [flags]        List available personas from the cascade (cwd →
                       configured persona dirs → library). By default shows
                       one row per persona at the recommended tier for its
@@ -212,14 +234,22 @@ function parseSelector(sel) {
     const tierRaw = at === -1 ? undefined : sel.slice(at + 1);
     if (!key)
         die('Missing persona name before "@"');
-    const tier = (tierRaw ?? 'best-value');
-    if (tierRaw !== undefined && !PERSONA_TIERS.includes(tier)) {
+    if (tierRaw !== undefined && !PERSONA_TIERS.includes(tierRaw)) {
         die(`Invalid tier "${tierRaw}". Must be one of: ${PERSONA_TIERS.join(', ')}`);
     }
     const result = resolveSpec(key);
     if ('error' in result)
         die(result.error, false);
     const kind = local.byId.has(key) ? 'local' : 'repo';
+    // Resolution order when no @<tier> is given: routingProfiles default for the
+    // persona's intent (built-ins only — local personas with custom intents miss
+    // the lookup and fall through), then the persona's own defaultTier, then
+    // 'best-value'. Mirrors `resolveShowTarget` and the `list` recommended-tier
+    // filter so all three commands agree on what "no tier" means.
+    const profileRule = kind === 'repo'
+        ? routingProfiles.default.intents[result.intent]
+        : undefined;
+    const tier = (tierRaw ?? profileRule?.tier ?? result.defaultTier ?? 'best-value');
     if (kind === 'local') {
         return { kind, source: local.sources.get(result.id) ?? 'cwd', spec: result, tier };
     }
@@ -677,6 +707,128 @@ export function decideCleanMode(harness, installInRepo = false) {
     }
     return { useClean: false };
 }
+/**
+ * Persona authoring dry-run. Used by persona authors to verify a persona
+ * actually launches before it ships, without spawning the harness or
+ * running the agent's tier model. Three checks, in order:
+ *
+ *   1. Sidecar resolution — `claudeMd` / `agentsMd` filename references
+ *      that point at unreadable files would brick the launch silently
+ *      today (lenient warning); dry-run promotes them to failures.
+ *   2. Interactive spec build — runs `buildInteractiveSpec` on the
+ *      resolved selection. Catches malformed `permissions` patterns,
+ *      `mcpServers` shape errors, and missing required harness fields.
+ *      Pure / no side effects.
+ *   3. Skill install — runs each `skills[].source` through its real
+ *      installer (`npx skills add` / `npx prpm install`) inside a fresh
+ *      temp dir and reports per-skill pass/fail.
+ *
+ * Temp dir is deleted on success so dry-run leaves no trace; on a skill
+ * failure it is left in place and its path printed so the author can
+ * inspect the installer's output. Checks 1 and 2 run before any temp
+ * dir is created so an early failure doesn't litter `/tmp`.
+ */
+function runDryRun(selection) {
+    const inputResolution = resolvePersonaInputs(selection.inputs, selection.inputValues, process.env);
+    const renderedSystemPrompt = renderPersonaInputs(selection.runtime.systemPrompt, inputResolution.values);
+    const renderedClaudeContent = selection.claudeMdContent !== undefined
+        ? renderPersonaInputs(selection.claudeMdContent, inputResolution.values)
+        : undefined;
+    const renderedAgentsContent = selection.agentsMdContent !== undefined
+        ? renderPersonaInputs(selection.agentsMdContent, inputResolution.values)
+        : undefined;
+    const effectiveSelection = {
+        ...selection,
+        runtime: { ...selection.runtime, systemPrompt: renderedSystemPrompt },
+        ...(renderedClaudeContent !== undefined ? { claudeMdContent: renderedClaudeContent } : {}),
+        ...(renderedAgentsContent !== undefined ? { agentsMdContent: renderedAgentsContent } : {})
+    };
+    const { runtime, personaId, tier } = effectiveSelection;
+    process.stderr.write(`→ ${personaId} [${tier}] via ${runtime.harness} (${runtime.model}) [DRY-RUN]\n`);
+    // Check 1: sidecar resolution. A loadSidecarForSelection warning means
+    // the persona points `claudeMd` / `agentsMd` at a file we couldn't
+    // read; the launch path degrades to a warning today, which silently
+    // drops the persona's operating spec. In dry-run that's a failure.
+    const sidecarLookup = loadSidecarForSelection(effectiveSelection);
+    if (sidecarLookup.warning) {
+        process.stderr.write(`✗ sidecar: ${sidecarLookup.warning}\n`);
+        return 1;
+    }
+    process.stderr.write(`✓ sidecar: ${sidecarLookup.sidecar ? sidecarLookup.sidecar.mountFile : '(none)'}\n`);
+    // Check 2: harness-kit translation. buildInteractiveSpec validates
+    // permissions shape, mcpServers shape, and required runtime fields.
+    // We resolve env + mcp leniently (same as the live launch path) so
+    // the spec call sees the same inputs it would at runtime.
+    const callerEnv = { ...process.env, ...inputResolution.values };
+    const envResolution = resolveStringMapLenient(effectiveSelection.env, callerEnv, 'env');
+    const mcpResolution = resolveMcpServersLenient(effectiveSelection.mcpServers, callerEnv);
+    emitDropWarnings(formatDropWarnings(envResolution.dropped, mcpResolution.dropped, mcpResolution.droppedServers));
+    let spec;
+    try {
+        spec = buildInteractiveSpec({
+            harness: runtime.harness,
+            personaId,
+            model: runtime.model,
+            systemPrompt: runtime.systemPrompt,
+            harnessSettings: runtime.harnessSettings,
+            mcpServers: mcpResolution.servers,
+            permissions: effectiveSelection.permissions
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`✗ harness spec: ${msg}\n`);
+        return 1;
+    }
+    for (const w of spec.warnings)
+        process.stderr.write(`warning: ${w}\n`);
+    process.stderr.write(`✓ harness spec: ${spec.bin} (${spec.args.length} args)\n`);
+    // Check 3: skill installs.
+    const plan = materializeSkills(effectiveSelection.skills, runtime.harness);
+    if (plan.installs.length === 0) {
+        process.stderr.write('✓ skills: (none declared)\n');
+        process.stderr.write('✓ dry-run ok\n');
+        return 0;
+    }
+    const tempDir = mkdtempSync(join(tmpdir(), `agentworkforce-dryrun-${personaId}-`));
+    process.stderr.write(`• temp dir: ${tempDir}\n`);
+    process.stderr.write(`• installing ${plan.installs.length} skill(s)\n`);
+    const failures = [];
+    for (const inst of plan.installs) {
+        const [bin, ...args] = inst.installCommand;
+        if (!bin) {
+            process.stderr.write(`  skipped ${inst.skillId}: empty install command\n`);
+            continue;
+        }
+        process.stderr.write(`• ${inst.skillId} (${inst.sourceKind}) → ${inst.packageRef}\n`);
+        const res = spawnSync(bin, args, { stdio: 'inherit', shell: false, cwd: tempDir });
+        const code = subprocessExitCode(res);
+        if (code === 0) {
+            process.stderr.write(`  ✓ ${inst.skillId}\n`);
+        }
+        else {
+            process.stderr.write(`  ✗ ${inst.skillId} (exit ${code})\n`);
+            failures.push({ skillId: inst.skillId, exitCode: code });
+        }
+    }
+    if (failures.length === 0) {
+        try {
+            rmSync(tempDir, { recursive: true, force: true });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`warning: failed to clean up ${tempDir}: ${msg}\n`);
+        }
+        process.stderr.write(`✓ dry-run ok: ${plan.installs.length} skill(s) installed cleanly\n`);
+        return 0;
+    }
+    process.stderr.write(`✗ dry-run failed: ${failures.length} of ${plan.installs.length} skill(s) failed\n`);
+    process.stderr.write(`  inspect ${tempDir} for installer output\n`);
+    for (const f of failures) {
+        process.stderr.write(`  - ${f.skillId} (exit ${f.exitCode})\n`);
+    }
+    return failures[0]?.exitCode || 1;
+}
 async function runInteractive(selection, options) {
     const inputResolution = resolvePersonaInputs(selection.inputs, selection.inputValues, process.env);
     const renderedSystemPrompt = renderPersonaInputs(selection.runtime.systemPrompt, inputResolution.values);
@@ -1368,7 +1520,8 @@ function collectPersonaRows() {
                 intent: spec.intent,
                 tags: spec.tags,
                 description: spec.description,
-                rating: tier
+                rating: tier,
+                defaultTier: spec.defaultTier
             });
         }
     };
@@ -1517,7 +1670,7 @@ function runList(args) {
             return false;
         if (applyRecommended) {
             const rule = recommendedByIntent[r.intent];
-            if (r.rating !== (rule?.tier ?? 'best-value'))
+            if (r.rating !== (rule?.tier ?? r.defaultTier ?? 'best-value'))
                 return false;
         }
         return true;
@@ -1611,7 +1764,7 @@ function resolveShowTarget(selector, all) {
     }
     else {
         const rule = routingProfiles.default.intents[spec.intent];
-        tiers = [rule?.tier ?? 'best-value'];
+        tiers = [rule?.tier ?? spec.defaultTier ?? 'best-value'];
     }
     return { spec, source, tiers, explicitTier };
 }
@@ -1628,6 +1781,9 @@ function formatPersonaShow(spec, source, tiers, tierNote) {
     lines.push(`INTENT       ${spec.intent}`);
     lines.push(`TAGS         ${spec.tags.length ? spec.tags.join(', ') : '(none)'}`);
     lines.push(`DESCRIPTION  ${spec.description}`);
+    if (spec.defaultTier) {
+        lines.push(`DEFAULT TIER ${spec.defaultTier}`);
+    }
     lines.push(`TIERS SHOWN  ${tiers.join(', ')}${tierNote ? `  (${tierNote})` : ''}`);
     lines.push('');
     lines.push('SKILLS');
@@ -1846,6 +2002,10 @@ async function runAgentSelector(selector, flags, inputValues) {
         ...buildSelection(target.spec, target.tier, target.kind),
         ...(inputValues ? { inputValues } : {})
     };
+    if (flags.dryRun) {
+        const code = runDryRun(selection);
+        process.exit(code);
+    }
     const code = await runInteractive(selection, {
         installInRepo: flags.installInRepo,
         noLaunchMetadata: flags.noLaunchMetadata,
@@ -1972,7 +2132,7 @@ async function runPick(args) {
         ...buildCreateInputValues(target),
         TASK_DESCRIPTION: task
     };
-    await runAgentSelector(CREATE_SELECTOR, { installInRepo: false, noLaunchMetadata: false }, inputValues);
+    await runAgentSelector(CREATE_SELECTOR, { installInRepo: false, noLaunchMetadata: false, dryRun: false }, inputValues);
     // runAgentSelector terminates via process.exit; this satisfies TS's
     // reachable-end-point check for the `Promise<never>` return type.
     process.exit(0);
@@ -2033,7 +2193,11 @@ export async function main() {
     await runAgentSelector(selector, flags);
 }
 export function parseAgentArgs(args) {
-    const flags = { installInRepo: false, noLaunchMetadata: false };
+    const flags = {
+        installInRepo: false,
+        noLaunchMetadata: false,
+        dryRun: false
+    };
     const positional = [];
     let seenDoubleDash = false;
     for (const arg of args) {
@@ -2053,6 +2217,10 @@ export function parseAgentArgs(args) {
             flags.noLaunchMetadata = true;
             continue;
         }
+        if (arg === '--dry-run') {
+            flags.dryRun = true;
+            continue;
+        }
         if (arg === '-h' || arg === '--help') {
             process.stdout.write(USAGE);
             process.exit(0);
@@ -2062,7 +2230,12 @@ export function parseAgentArgs(args) {
     return { flags, positional };
 }
 export function parseCreateArgs(args) {
-    const flags = { installInRepo: false, noLaunchMetadata: false, saveDefault: false };
+    const flags = {
+        installInRepo: false,
+        noLaunchMetadata: false,
+        dryRun: false,
+        saveDefault: false
+    };
     let seenDoubleDash = false;
     const positional = [];
     const valueOf = (i, flag) => {