@agentworkforce/cli 0.11.0 → 0.13.0

package/dist/persona-picker.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Compact projection of a persona used for picker prompts. The model only
+ * needs enough to reason about intent fit — full systemPrompts would inflate
+ * the prompt without improving quality.
+ */
+export interface PickCandidate {
+    id: string;
+    intent: string;
+    tags: readonly string[];
+    description: string;
+}
+export type PickConfidence = 'high' | 'medium' | 'low';
+export type PickResult = {
+    kind: 'match';
+    personaId: string;
+    confidence: 'high' | 'medium';
+    reason: string;
+} | {
+    kind: 'no-match';
+    reason: string;
+} | {
+    kind: 'picker-unavailable';
+    message: string;
+};
+/**
+ * Test seam describing one round-trip to the picker subprocess. Returning a
+ * structured shape keeps tests free of real `spawnSync` calls while preserving
+ * the stdout/stderr/status surface the parser exercises.
+ */
+export interface PickerSubprocessRequest {
+    bin: string;
+    args: readonly string[];
+    systemPrompt: string;
+    userPrompt: string;
+    timeoutMs: number;
+}
+export interface PickerSubprocessResult {
+    status: 'ok' | 'enoent' | 'error';
+    stdout: string;
+    stderr: string;
+    errorMessage?: string;
+}
+export type PickerRunner = (req: PickerSubprocessRequest) => PickerSubprocessResult;
+export interface PickPersonaOptions {
+    claudeBin?: string;
+    model?: string;
+    timeoutMs?: number;
+    runner?: PickerRunner;
+}
+export declare function buildUserPrompt(task: string, candidates: readonly PickCandidate[]): string;
+interface PickerJsonResponse {
+    persona: string | null;
+    confidence: PickConfidence;
+    reason: string;
+}
+/**
+ * Parse the model's text output. Accepts either a bare JSON object or the
+ * Claude CLI `--output-format json` envelope `{type, result, ...}` whose
+ * `result` field carries the model text. Returns undefined when the output
+ * cannot be coerced to the expected shape — callers translate that into a
+ * `no-match` result.
+ */
+export declare function parsePickerOutput(stdout: string): PickerJsonResponse | undefined;
+export declare function pickPersona(task: string, candidates: readonly PickCandidate[], opts?: PickPersonaOptions): PickResult;
+export {};
+//# sourceMappingURL=persona-picker.d.ts.map

package/dist/persona-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-picker.d.ts","sourceRoot":"","sources":["../src/persona-picker.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEvD,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,uBAAuB,KAAK,sBAAsB,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAoBD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAQ1F;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CA0BhF;AA4BD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,IAAI,GAAE,kBAAuB,GAC5B,UAAU,CA+DZ"}

package/dist/persona-picker.js

@@ -0,0 +1,152 @@
+import { spawnSync } from 'node:child_process';
+const DEFAULT_BIN = 'claude';
+// Use the dated model id rather than the `claude-haiku-4-5` alias so the
+// subprocess survives any future change in the Claude CLI's alias resolver.
+// The alias works today but the dated id is strictly more robust.
+const DEFAULT_MODEL = 'claude-haiku-4-5-20251001';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const SYSTEM_PROMPT = `You pick the single best persona for a user task from a fixed catalog.
+
+Rules:
+- Read the task and the candidate list.
+- Choose the persona whose intent and description most directly match the task.
+- If no persona is a clear fit, set "persona" to null with confidence "low".
+- Output ONE JSON object on a single line. No prose, no code fences, no commentary.
+
+Output schema:
+{"persona": "<id from the candidate list, or null>", "confidence": "high" | "medium" | "low", "reason": "<one short sentence>"}`;
+export function buildUserPrompt(task, candidates) {
+    const compact = candidates.map((c) => ({
+        id: c.id,
+        intent: c.intent,
+        tags: [...c.tags],
+        description: c.description
+    }));
+    return `Task:\n${task.trim()}\n\nCandidates (JSON):\n${JSON.stringify(compact)}`;
+}
+function isPickerJsonResponse(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    if (v.persona !== null && typeof v.persona !== 'string')
+        return false;
+    if (v.confidence !== 'high' && v.confidence !== 'medium' && v.confidence !== 'low')
+        return false;
+    if (typeof v.reason !== 'string')
+        return false;
+    return true;
+}
+/**
+ * Parse the model's text output. Accepts either a bare JSON object or the
+ * Claude CLI `--output-format json` envelope `{type, result, ...}` whose
+ * `result` field carries the model text. Returns undefined when the output
+ * cannot be coerced to the expected shape — callers translate that into a
+ * `no-match` result.
+ */
+export function parsePickerOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (!trimmed)
+        return undefined;
+    let candidate;
+    try {
+        candidate = JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+    if (typeof candidate === 'object' &&
+        candidate !== null &&
+        'result' in candidate &&
+        typeof candidate.result === 'string') {
+        const inner = candidate.result.trim();
+        try {
+            candidate = JSON.parse(inner);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return isPickerJsonResponse(candidate) ? candidate : undefined;
+}
+function defaultRunner(req) {
+    const opts = {
+        encoding: 'utf8',
+        timeout: req.timeoutMs
+    };
+    const child = spawnSync(req.bin, [...req.args], opts);
+    if (child.error) {
+        const err = child.error;
+        if (err.code === 'ENOENT') {
+            return { status: 'enoent', stdout: '', stderr: '', errorMessage: err.message };
+        }
+        return {
+            status: 'error',
+            stdout: typeof child.stdout === 'string' ? child.stdout : '',
+            stderr: typeof child.stderr === 'string' ? child.stderr : '',
+            errorMessage: err.message
+        };
+    }
+    const stdout = typeof child.stdout === 'string' ? child.stdout : '';
+    const stderr = typeof child.stderr === 'string' ? child.stderr : '';
+    if (typeof child.status === 'number' && child.status !== 0) {
+        return { status: 'error', stdout, stderr, errorMessage: `exit ${child.status}` };
+    }
+    return { status: 'ok', stdout, stderr };
+}
+export function pickPersona(task, candidates, opts = {}) {
+    if (!task.trim()) {
+        return { kind: 'no-match', reason: 'empty task description' };
+    }
+    if (candidates.length === 0) {
+        return { kind: 'no-match', reason: 'no candidates available' };
+    }
+    const bin = opts.claudeBin ?? DEFAULT_BIN;
+    const model = opts.model ?? DEFAULT_MODEL;
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const runner = opts.runner ?? defaultRunner;
+    const userPrompt = buildUserPrompt(task, candidates);
+    const args = [
+        '-p',
+        '--model',
+        model,
+        '--output-format',
+        'json',
+        '--system-prompt',
+        SYSTEM_PROMPT,
+        userPrompt
+    ];
+    const result = runner({ bin, args, systemPrompt: SYSTEM_PROMPT, userPrompt, timeoutMs });
+    if (result.status === 'enoent') {
+        return {
+            kind: 'picker-unavailable',
+            message: `\`${bin}\` not found on PATH. Install Claude Code (https://docs.claude.com/en/docs/claude-code) or run \`agentworkforce harness check\` to verify.`
+        };
+    }
+    if (result.status === 'error') {
+        return {
+            kind: 'picker-unavailable',
+            message: `picker subprocess failed: ${result.errorMessage ?? 'unknown error'}${result.stderr ? `\n${result.stderr.trim()}` : ''}`
+        };
+    }
+    const parsed = parsePickerOutput(result.stdout);
+    if (!parsed) {
+        return { kind: 'no-match', reason: 'picker returned no parseable response' };
+    }
+    if (parsed.persona === null || parsed.confidence === 'low') {
+        return { kind: 'no-match', reason: parsed.reason || 'low confidence' };
+    }
+    const known = new Set(candidates.map((c) => c.id));
+    if (!known.has(parsed.persona)) {
+        return {
+            kind: 'no-match',
+            reason: `picker returned unknown persona id "${parsed.persona}"`
+        };
+    }
+    return {
+        kind: 'match',
+        personaId: parsed.persona,
+        confidence: parsed.confidence,
+        reason: parsed.reason
+    };
+}
+//# sourceMappingURL=persona-picker.js.map

package/dist/persona-picker.js.map

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

package/dist/persona-picker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persona-picker.test.d.ts.map

package/dist/persona-picker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-picker.test.d.ts","sourceRoot":"","sources":["../src/persona-picker.test.ts"],"names":[],"mappings":""}

package/dist/persona-picker.test.js

@@ -0,0 +1,184 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { buildUserPrompt, parsePickerOutput, pickPersona } from './persona-picker.js';
+const SAMPLE_CANDIDATES = [
+    {
+        id: 'code-reviewer',
+        intent: 'review',
+        tags: ['review'],
+        description: 'Reviews PRs.'
+    },
+    {
+        id: 'debugger',
+        intent: 'debugging',
+        tags: ['debugging'],
+        description: 'Roots out bugs.'
+    }
+];
+function fakeRunner(result) {
+    const calls = [];
+    return {
+        calls,
+        runner(req) {
+            calls.push(req);
+            return result;
+        }
+    };
+}
+test('buildUserPrompt: includes the task and a JSON candidate list', () => {
+    const prompt = buildUserPrompt('fix the login bug', SAMPLE_CANDIDATES);
+    assert.match(prompt, /Task:\nfix the login bug/);
+    assert.match(prompt, /"id":"code-reviewer"/);
+    assert.match(prompt, /"id":"debugger"/);
+});
+test('parsePickerOutput: parses a bare JSON response object', () => {
+    const out = '{"persona":"code-reviewer","confidence":"high","reason":"PR review"}';
+    assert.deepEqual(parsePickerOutput(out), {
+        persona: 'code-reviewer',
+        confidence: 'high',
+        reason: 'PR review'
+    });
+});
+test('parsePickerOutput: unwraps the Claude CLI {result: "<json>"} envelope', () => {
+    const inner = JSON.stringify({
+        persona: 'debugger',
+        confidence: 'medium',
+        reason: 'looks like a bug hunt'
+    });
+    const envelope = JSON.stringify({
+        type: 'result',
+        subtype: 'success',
+        is_error: false,
+        result: inner
+    });
+    assert.deepEqual(parsePickerOutput(envelope), {
+        persona: 'debugger',
+        confidence: 'medium',
+        reason: 'looks like a bug hunt'
+    });
+});
+test('parsePickerOutput: returns undefined on non-JSON', () => {
+    assert.equal(parsePickerOutput('not json'), undefined);
+    assert.equal(parsePickerOutput(''), undefined);
+    assert.equal(parsePickerOutput('   \n  '), undefined);
+});
+test('parsePickerOutput: returns undefined on shape mismatch', () => {
+    assert.equal(parsePickerOutput('{"persona":42,"confidence":"high","reason":"x"}'), undefined);
+    assert.equal(parsePickerOutput('{"persona":"x","confidence":"sky-high","reason":"x"}'), undefined);
+    assert.equal(parsePickerOutput('{"persona":"x","confidence":"high"}'), undefined);
+});
+test('pickPersona: well-formed match propagates id, confidence, reason', () => {
+    const { runner, calls } = fakeRunner({
+        status: 'ok',
+        stdout: '{"persona":"code-reviewer","confidence":"high","reason":"PR review fits"}',
+        stderr: ''
+    });
+    const result = pickPersona('review my PR', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'match');
+    if (result.kind === 'match') {
+        assert.equal(result.personaId, 'code-reviewer');
+        assert.equal(result.confidence, 'high');
+        assert.equal(result.reason, 'PR review fits');
+    }
+    assert.equal(calls.length, 1);
+    assert.equal(calls[0].bin, 'claude');
+    assert.ok(calls[0].args.includes('-p'));
+    assert.ok(calls[0].args.includes('--output-format'));
+});
+test('pickPersona: persona=null collapses to no-match', () => {
+    const { runner } = fakeRunner({
+        status: 'ok',
+        stdout: '{"persona":null,"confidence":"low","reason":"none fit"}',
+        stderr: ''
+    });
+    const result = pickPersona('xyzzy', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'no-match');
+});
+test('pickPersona: low confidence collapses to no-match even with a persona id', () => {
+    const { runner } = fakeRunner({
+        status: 'ok',
+        stdout: '{"persona":"code-reviewer","confidence":"low","reason":"weak match"}',
+        stderr: ''
+    });
+    const result = pickPersona('something', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'no-match');
+});
+test('pickPersona: unknown persona id from model is rejected as no-match', () => {
+    const { runner } = fakeRunner({
+        status: 'ok',
+        stdout: '{"persona":"made-up-persona","confidence":"high","reason":"hallucinated"}',
+        stderr: ''
+    });
+    const result = pickPersona('do work', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'no-match');
+    if (result.kind === 'no-match') {
+        assert.match(result.reason, /unknown persona id/);
+    }
+});
+test('pickPersona: ENOENT from subprocess maps to picker-unavailable', () => {
+    const { runner } = fakeRunner({
+        status: 'enoent',
+        stdout: '',
+        stderr: '',
+        errorMessage: 'spawn claude ENOENT'
+    });
+    const result = pickPersona('do work', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'picker-unavailable');
+    if (result.kind === 'picker-unavailable') {
+        assert.match(result.message, /not found on PATH/);
+    }
+});
+test('pickPersona: non-zero exit maps to picker-unavailable with stderr', () => {
+    const { runner } = fakeRunner({
+        status: 'error',
+        stdout: '',
+        stderr: 'rate limited',
+        errorMessage: 'exit 1'
+    });
+    const result = pickPersona('do work', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'picker-unavailable');
+    if (result.kind === 'picker-unavailable') {
+        assert.match(result.message, /rate limited/);
+    }
+});
+test('pickPersona: unparseable stdout collapses to no-match', () => {
+    const { runner } = fakeRunner({
+        status: 'ok',
+        stdout: 'I refuse to answer in JSON.',
+        stderr: ''
+    });
+    const result = pickPersona('do work', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'no-match');
+    if (result.kind === 'no-match') {
+        assert.match(result.reason, /no parseable response/);
+    }
+});
+test('pickPersona: empty task short-circuits to no-match without invoking runner', () => {
+    const { runner, calls } = fakeRunner({ status: 'ok', stdout: '', stderr: '' });
+    const result = pickPersona('   ', SAMPLE_CANDIDATES, { runner });
+    assert.equal(result.kind, 'no-match');
+    assert.equal(calls.length, 0);
+});
+test('pickPersona: empty candidates short-circuits to no-match', () => {
+    const { runner, calls } = fakeRunner({ status: 'ok', stdout: '', stderr: '' });
+    const result = pickPersona('do work', [], { runner });
+    assert.equal(result.kind, 'no-match');
+    assert.equal(calls.length, 0);
+});
+test('pickPersona: respects custom claudeBin and model in args', () => {
+    const { runner, calls } = fakeRunner({
+        status: 'ok',
+        stdout: '{"persona":"debugger","confidence":"medium","reason":"x"}',
+        stderr: ''
+    });
+    pickPersona('hunt a bug', SAMPLE_CANDIDATES, {
+        runner,
+        claudeBin: '/custom/claude',
+        model: 'claude-opus-4-7'
+    });
+    assert.equal(calls[0].bin, '/custom/claude');
+    const modelIdx = calls[0].args.indexOf('--model');
+    assert.notEqual(modelIdx, -1);
+    assert.equal(calls[0].args[modelIdx + 1], 'claude-opus-4-7');
+});
+//# sourceMappingURL=persona-picker.test.js.map

package/dist/persona-picker.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentworkforce/cli",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "private": false,
   "type": "module",
   "files": [
@@ -13,8 +13,8 @@
     "@relayburn/sdk": "^2.3.0",
     "@relayfile/local-mount": "^0.6.1",
     "ora": "^9.4.0",
-    "@agentworkforce/harness-kit": "0.11.0",
-    "@agentworkforce/workload-router": "0.11.0"
+    "@agentworkforce/harness-kit": "0.13.0",
+    "@agentworkforce/workload-router": "0.13.0"
   },
   "repository": {
     "type": "git",