@agentworkforce/cli 0.10.0 → 0.12.0

package/dist/launch-metadata.d.ts

@@ -0,0 +1,53 @@
+import type { Harness, PersonaSelection } from '@agentworkforce/workload-router';
+export declare const LAUNCH_METADATA_INTERVAL_MS = 1000;
+export declare const LAUNCH_METADATA_OPT_OUT_ENV = "AGENTWORKFORCE_LAUNCH_METADATA";
+export type LaunchMetadataIngestHarness = 'claude-code' | 'codex' | 'opencode';
+export type LaunchMetadataPendingStampHarness = Harness;
+export interface LaunchMetadataPendingStampOptions {
+    harness: LaunchMetadataPendingStampHarness;
+    cwd: string;
+    enrichment: Record<string, string>;
+    sessionDirHint?: string;
+    spawnStartTs?: string;
+    spawnerPid?: number;
+}
+export interface LaunchMetadataIngestOptions {
+    harness: LaunchMetadataIngestHarness;
+}
+export interface LaunchMetadataBackendLike {
+    writePendingStamp?: (opts: LaunchMetadataPendingStampOptions) => unknown | Promise<unknown>;
+    ingest?: (opts?: LaunchMetadataIngestOptions) => unknown | Promise<unknown>;
+}
+export interface LaunchMetadataStartOptions {
+    selection: Pick<PersonaSelection, 'personaId' | 'tier' | 'runtime'>;
+    personaSpec: unknown;
+    personaSource: string;
+    cwd: string;
+    noLaunchMetadata?: boolean;
+    env?: NodeJS.ProcessEnv;
+    sdk?: LaunchMetadataBackendLike | (() => Promise<LaunchMetadataBackendLike>);
+    intervalMs?: number;
+    now?: () => Date;
+    onWarn?: (message: string) => void;
+}
+export interface LaunchMetadataRun {
+    readonly enabled: boolean;
+    readonly metadata: Record<string, string>;
+    stop(): Promise<void>;
+}
+export declare function shouldRecordLaunchMetadata(input: {
+    noLaunchMetadata?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): boolean;
+export declare function canonicalJson(value: unknown): string;
+export declare function personaVersionHash(personaSpec: unknown): string;
+export declare function personaVersionShort(personaSpec: unknown): string;
+export declare function buildLaunchMetadata(input: {
+    selection: Pick<PersonaSelection, 'personaId' | 'tier'>;
+    personaSpec: unknown;
+    personaSource: string;
+}): Record<string, string>;
+export declare function launchMetadataIngestHarness(harness: Harness): LaunchMetadataIngestHarness;
+export declare function launchMetadataSessionDirHint(harness: Harness): string | undefined;
+export declare function startLaunchMetadataRecording(options: LaunchMetadataStartOptions): Promise<LaunchMetadataRun>;
+//# sourceMappingURL=launch-metadata.d.ts.map

package/dist/launch-metadata.d.ts.map

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

package/dist/launch-metadata.js

@@ -0,0 +1,192 @@
+import { createHash } from 'node:crypto';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import * as launchMetadataBackendSdk from '@relayburn/sdk';
+export const LAUNCH_METADATA_INTERVAL_MS = 1_000;
+export const LAUNCH_METADATA_OPT_OUT_ENV = 'AGENTWORKFORCE_LAUNCH_METADATA';
+const LAUNCH_METADATA_BACKEND_CALL_TIMEOUT_MS = 5_000;
+const NOOP_RUN = Object.freeze({
+    enabled: false,
+    metadata: Object.freeze({}),
+    async stop() {
+        /* no-op */
+    }
+});
+export function shouldRecordLaunchMetadata(input) {
+    if (input.noLaunchMetadata === true)
+        return false;
+    const env = input.env ?? process.env;
+    return env[LAUNCH_METADATA_OPT_OUT_ENV] !== '0';
+}
+export function canonicalJson(value) {
+    return JSON.stringify(canonicalize(value));
+}
+export function personaVersionHash(personaSpec) {
+    return createHash('sha256').update(canonicalJson(personaSpec)).digest('hex');
+}
+export function personaVersionShort(personaSpec) {
+    return personaVersionHash(personaSpec).slice(0, 12);
+}
+export function buildLaunchMetadata(input) {
+    return {
+        agentworkforce: '1',
+        persona: input.selection.personaId,
+        personaTier: input.selection.tier,
+        personaVersion: personaVersionHash(input.personaSpec),
+        personaSource: input.personaSource
+    };
+}
+export function launchMetadataIngestHarness(harness) {
+    return harness === 'claude' ? 'claude-code' : harness;
+}
+export function launchMetadataSessionDirHint(harness) {
+    const home = homedir();
+    switch (harness) {
+        case 'claude':
+            return join(home, '.claude', 'projects');
+        case 'codex':
+            return join(home, '.codex', 'sessions');
+        case 'opencode':
+            return join(home, '.local', 'share', 'opencode', 'storage', 'session');
+        default: {
+            const _exhaustive = harness;
+            return _exhaustive;
+        }
+    }
+}
+export async function startLaunchMetadataRecording(options) {
+    if (!shouldRecordLaunchMetadata(options))
+        return NOOP_RUN;
+    const metadata = buildLaunchMetadata({
+        selection: options.selection,
+        personaSpec: options.personaSpec,
+        personaSource: options.personaSource
+    });
+    const warn = makeOnceWarn(options.onWarn ?? ((msg) => process.stderr.write(`warning: ${msg}\n`)));
+    let sdk;
+    try {
+        sdk = await resolveLaunchMetadataBackend(options.sdk);
+    }
+    catch (err) {
+        warn(`launch metadata recording unavailable: ${errorMessage(err)}`);
+        return disabledRun(metadata);
+    }
+    if (typeof sdk.writePendingStamp !== 'function') {
+        warn('launch metadata recording unavailable: installed metadata backend does not support launcher metadata yet.');
+        return disabledRun(metadata);
+    }
+    if (typeof sdk.ingest !== 'function') {
+        warn('launch metadata recording unavailable: installed metadata backend does not support ingest.');
+        return disabledRun(metadata);
+    }
+    const writePendingStamp = sdk.writePendingStamp.bind(sdk);
+    const ingest = sdk.ingest.bind(sdk);
+    try {
+        await withTimeout(writePendingStamp({
+            harness: options.selection.runtime.harness,
+            cwd: options.cwd,
+            enrichment: metadata,
+            sessionDirHint: launchMetadataSessionDirHint(options.selection.runtime.harness),
+            spawnStartTs: (options.now?.() ?? new Date()).toISOString(),
+            spawnerPid: process.pid
+        }), LAUNCH_METADATA_BACKEND_CALL_TIMEOUT_MS, 'writePendingStamp');
+    }
+    catch (err) {
+        warn(`launch metadata stamp failed: ${errorMessage(err)}`);
+        return disabledRun(metadata);
+    }
+    let stopped = false;
+    let inFlight;
+    let ingestWarned = false;
+    const runIngest = async () => {
+        try {
+            await withTimeout(ingest({ harness: launchMetadataIngestHarness(options.selection.runtime.harness) }), LAUNCH_METADATA_BACKEND_CALL_TIMEOUT_MS, 'ingest');
+        }
+        catch (err) {
+            if (!ingestWarned) {
+                ingestWarned = true;
+                warn(`launch metadata ingest failed: ${errorMessage(err)}`);
+            }
+        }
+    };
+    const tick = () => {
+        if (stopped || inFlight)
+            return;
+        inFlight = runIngest().finally(() => {
+            inFlight = undefined;
+        });
+    };
+    const interval = setInterval(tick, options.intervalMs ?? LAUNCH_METADATA_INTERVAL_MS);
+    interval.unref?.();
+    return {
+        enabled: true,
+        metadata,
+        async stop() {
+            if (stopped)
+                return;
+            stopped = true;
+            clearInterval(interval);
+            if (inFlight)
+                await inFlight;
+            await runIngest();
+        }
+    };
+}
+async function resolveLaunchMetadataBackend(sdk) {
+    if (typeof sdk === 'function')
+        return await sdk();
+    if (sdk)
+        return sdk;
+    return launchMetadataBackendSdk;
+}
+function disabledRun(metadata) {
+    return Object.freeze({
+        enabled: false,
+        metadata,
+        async stop() {
+            /* no-op */
+        }
+    });
+}
+function makeOnceWarn(onWarn) {
+    let warned = false;
+    return (message) => {
+        if (warned)
+            return;
+        warned = true;
+        onWarn(message);
+    };
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+async function withTimeout(value, timeoutMs, label) {
+    let timeout;
+    try {
+        return await Promise.race([
+            Promise.resolve(value),
+            new Promise((_, reject) => {
+                timeout = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);
+                timeout.unref?.();
+            })
+        ]);
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
+function canonicalize(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => canonicalize(item));
+    const out = {};
+    for (const key of Object.keys(value).sort()) {
+        const child = value[key];
+        if (child !== undefined)
+            out[key] = canonicalize(child);
+    }
+    return out;
+}
+//# sourceMappingURL=launch-metadata.js.map

package/dist/launch-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-metadata.js","sourceRoot":"","sources":["../src/launch-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,KAAK,wBAAwB,MAAM,gBAAgB,CAAC;AAE3D,MAAM,CAAC,MAAM,2BAA2B,GAAG,KAAK,CAAC;AACjD,MAAM,CAAC,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAC5E,MAAM,uCAAuC,GAAG,KAAK,CAAC;AA0CtD,MAAM,QAAQ,GAAsB,MAAM,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAA2B;IACrD,KAAK,CAAC,IAAI;QACR,WAAW;IACb,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,0BAA0B,CAAC,KAG1C;IACC,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACrC,OAAO,GAAG,CAAC,2BAA2B,CAAC,KAAK,GAAG,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAoB;IACrD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,WAAoB;IACtD,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAInC;IACC,OAAO;QACL,cAAc,EAAE,GAAG;QACnB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS;QAClC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI;QACjC,cAAc,EAAE,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC;QACrD,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,OAAgB;IAC1D,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAgB;IAC3D,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC3C,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC1C,KAAK,UAAU;YACb,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,OAAO,CAAC;YACnC,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAAmC;IAEnC,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE1D,MAAM,QAAQ,GAAG,mBAAmB,CAAC;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAElG,IAAI,GAA8B,CAAC;IACnC,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,4BAA4B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,0CAA0C,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpE,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QAChD,IAAI,CACF,2GAA2G,CAC5G,CAAC;QACF,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC,4FAA4F,CAAC,CAAC;QACnG,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,WAAW,CACf,iBAAiB,CAAC;YAChB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO;YAC1C,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,QAAQ;YACpB,cAAc,EAAE,4BAA4B,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;YAC/E,YAAY,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;YAC3D,UAAU,EAAE,OAAO,CAAC,GAAG;SACxB,CAAC,EACF,uCAAuC,EACvC,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,iCAAiC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAAmC,CAAC;IACxC,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,WAAW,CACf,MAAM,CAAC,EAAE,OAAO,EAAE,2BAA2B,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,EACnF,uCAAuC,EACvC,QAAQ,CACT,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,YAAY,GAAG,IAAI,CAAC;gBACpB,IAAI,CAAC,kCAAkC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,OAAO,IAAI,QAAQ;YAAE,OAAO;QAChC,QAAQ,GAAG,SAAS,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YAClC,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,IAAI,2BAA2B,CAAC,CAAC;IACtF,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IAEnB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,QAAQ;QACR,KAAK,CAAC,IAAI;YACR,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC;YAC7B,MAAM,SAAS,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,GAAsC;IAEtC,IAAI,OAAO,GAAG,KAAK,UAAU;QAAE,OAAO,MAAM,GAAG,EAAE,CAAC;IAClD,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,OAAO,wBAAgE,CAAC;AAC1E,CAAC;AAED,SAAS,WAAW,CAAC,QAAgC;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,KAAK;QACd,QAAQ;QACR,KAAK,CAAC,IAAI;YACR,WAAW;QACb,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,MAAiC;IACrD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO,CAAC,OAAe,EAAE,EAAE;QACzB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,WAAW,CAAI,KAAqB,EAAE,SAAiB,EAAE,KAAa;IACnF,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC;YACxB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;YACtB,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;gBAC/B,OAAO,GAAG,UAAU,CAClB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,SAAS,IAAI,CAAC,CAAC,EAClE,SAAS,CACV,CAAC;gBACF,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACpB,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,IAAI,OAAO;YAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzE,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvE,MAAM,KAAK,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/launch-metadata.test.d.ts

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

package/dist/launch-metadata.test.d.ts.map

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

package/dist/launch-metadata.test.js

@@ -0,0 +1,152 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { buildLaunchMetadata, canonicalJson, launchMetadataIngestHarness, personaVersionHash, shouldRecordLaunchMetadata, startLaunchMetadataRecording } from './launch-metadata.js';
+function fakeSelection() {
+    return {
+        personaId: 'code-reviewer',
+        tier: 'best',
+        runtime: {
+            harness: 'codex',
+            model: 'openai-codex/gpt-5.3-codex',
+            systemPrompt: 'Review the diff.',
+            harnessSettings: {
+                reasoning: 'high',
+                timeoutSeconds: 1200
+            }
+        }
+    };
+}
+function fakeSpec(overrides = {}) {
+    return {
+        id: 'code-reviewer',
+        intent: 'review',
+        tags: ['review'],
+        description: 'Reviews code.',
+        skills: [],
+        tiers: {
+            best: fakeSelection().runtime,
+            'best-value': {
+                harness: 'opencode',
+                model: 'opencode/gpt-5-nano',
+                systemPrompt: 'Review concisely.',
+                harnessSettings: {
+                    reasoning: 'medium',
+                    timeoutSeconds: 900
+                }
+            },
+            minimum: {
+                harness: 'opencode',
+                model: 'opencode/minimax-m2.5-free',
+                systemPrompt: 'Review blockers.',
+                harnessSettings: {
+                    reasoning: 'low',
+                    timeoutSeconds: 600
+                }
+            }
+        },
+        ...overrides
+    };
+}
+test('personaVersionHash canonicalizes object keys and changes with effective content', () => {
+    assert.equal(canonicalJson({ b: 1, a: { d: 4, c: 3 } }), '{"a":{"c":3,"d":4},"b":1}');
+    const left = {
+        id: 'p',
+        tiers: {
+            best: { model: 'm', harness: 'codex' }
+        },
+        tags: ['review']
+    };
+    const right = {
+        tags: ['review'],
+        tiers: {
+            best: { harness: 'codex', model: 'm' }
+        },
+        id: 'p'
+    };
+    assert.equal(personaVersionHash(left), personaVersionHash(right));
+    assert.notEqual(personaVersionHash(left), personaVersionHash({ ...right, tags: ['testing'] }));
+});
+test('buildLaunchMetadata emits the required AgentWorkforce metadata', () => {
+    const spec = fakeSpec();
+    const metadata = buildLaunchMetadata({
+        selection: fakeSelection(),
+        personaSpec: spec,
+        personaSource: 'dir:1'
+    });
+    assert.deepEqual(metadata, {
+        agentworkforce: '1',
+        persona: 'code-reviewer',
+        personaTier: 'best',
+        personaVersion: personaVersionHash(spec),
+        personaSource: 'dir:1'
+    });
+});
+test('startLaunchMetadataRecording writes a pending stamp and runs periodic plus final ingest', async (t) => {
+    t.mock.timers.enable({ apis: ['setInterval'] });
+    const stamps = [];
+    const ingests = [];
+    const run = await startLaunchMetadataRecording({
+        selection: fakeSelection(),
+        personaSpec: fakeSpec(),
+        personaSource: 'cwd',
+        cwd: '/tmp/project',
+        intervalMs: 5,
+        now: () => new Date('2026-05-08T12:00:00.000Z'),
+        sdk: {
+            writePendingStamp: (opts) => {
+                stamps.push(opts);
+            },
+            ingest: (opts) => {
+                if (opts)
+                    ingests.push(opts);
+            }
+        }
+    });
+    assert.equal(run.enabled, true);
+    t.mock.timers.tick(5);
+    await run.stop();
+    assert.equal(stamps.length, 1);
+    assert.equal(stamps[0]?.harness, 'codex');
+    assert.equal(stamps[0]?.cwd, '/tmp/project');
+    assert.equal(stamps[0]?.spawnStartTs, '2026-05-08T12:00:00.000Z');
+    assert.equal(stamps[0]?.enrichment.persona, 'code-reviewer');
+    assert.ok(ingests.length >= 2, 'expected at least one periodic ingest plus final ingest');
+    assert.deepEqual(ingests.at(-1), { harness: 'codex' });
+});
+test('startLaunchMetadataRecording skips SDK loading and ingest when opted out', async () => {
+    let loads = 0;
+    const run = await startLaunchMetadataRecording({
+        selection: fakeSelection(),
+        personaSpec: fakeSpec(),
+        personaSource: 'library',
+        cwd: '/tmp/project',
+        noLaunchMetadata: true,
+        sdk: async () => {
+            loads += 1;
+            throw new Error('should not load');
+        }
+    });
+    await run.stop();
+    assert.equal(run.enabled, false);
+    assert.equal(loads, 0);
+    assert.equal(shouldRecordLaunchMetadata({ env: { AGENTWORKFORCE_LAUNCH_METADATA: '0' } }), false);
+    const originalEnvValue = process.env.AGENTWORKFORCE_LAUNCH_METADATA;
+    try {
+        process.env.AGENTWORKFORCE_LAUNCH_METADATA = '0';
+        assert.equal(shouldRecordLaunchMetadata({}), false);
+    }
+    finally {
+        if (originalEnvValue === undefined) {
+            delete process.env.AGENTWORKFORCE_LAUNCH_METADATA;
+        }
+        else {
+            process.env.AGENTWORKFORCE_LAUNCH_METADATA = originalEnvValue;
+        }
+    }
+});
+test('launchMetadataIngestHarness maps AgentWorkforce claude to backend claude-code', () => {
+    assert.equal(launchMetadataIngestHarness('claude'), 'claude-code');
+    assert.equal(launchMetadataIngestHarness('codex'), 'codex');
+    assert.equal(launchMetadataIngestHarness('opencode'), 'opencode');
+});
+//# sourceMappingURL=launch-metadata.test.js.map

package/dist/launch-metadata.test.js.map

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

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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"}