@agentworkforce/persona-kit 0.19.0

package/dist/env-refs.test.js

@@ -0,0 +1,84 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { MissingEnvRefError, makeEnvRefResolver, makeLenientResolver, resolveStringMap, resolveStringMapLenient } from './env-refs.js';
+test('resolves $VAR references against the provided env', () => {
+    const resolve = makeEnvRefResolver({ FOO: 'hello' });
+    assert.equal(resolve('$FOO', 'x'), 'hello');
+});
+test('passes literal strings through untouched', () => {
+    const resolve = makeEnvRefResolver({ FOO: 'hello' });
+    assert.equal(resolve('plain literal', 'x'), 'plain literal');
+    assert.equal(resolve('Bearer hello-world', 'x'), 'Bearer hello-world');
+});
+test('refuses un-braced partial interpolation — prefix-$VAR stays literal', () => {
+    // Unbraced `$VAR` mid-string is kept as-is so a stray `$` in a JSON value
+    // doesn't get eaten by accident. Use ${VAR} for partial interpolation.
+    const resolve = makeEnvRefResolver({ FOO: 'hello' });
+    assert.equal(resolve('prefix-$FOO', 'x'), 'prefix-$FOO');
+});
+test('resolves braced ${VAR} interpolation anywhere in a string', () => {
+    const resolve = makeEnvRefResolver({ POSTHOG_API_KEY: 'phx_abc' });
+    assert.equal(resolve('Bearer ${POSTHOG_API_KEY}', 'auth'), 'Bearer phx_abc');
+    assert.equal(resolve('${POSTHOG_API_KEY}-suffix', 'x'), 'phx_abc-suffix');
+    assert.equal(resolve('${POSTHOG_API_KEY}', 'x'), 'phx_abc');
+});
+test('interpolates multiple ${VAR} occurrences in the same string', () => {
+    const resolve = makeEnvRefResolver({ A: 'one', B: 'two' });
+    assert.equal(resolve('${A}-${B}-${A}', 'x'), 'one-two-one');
+});
+test('missing ${VAR} inside a longer string errors with the field and var', () => {
+    const resolve = makeEnvRefResolver({ FOO: 'ok' });
+    assert.throws(() => resolve('Bearer ${MISSING_KEY}', 'headers.Authorization'), (err) => err instanceof MissingEnvRefError &&
+        err.ref === 'MISSING_KEY' &&
+        err.referencedBy === 'headers.Authorization');
+});
+test('throws MissingEnvRefError with the referenced name and field', () => {
+    const resolve = makeEnvRefResolver({});
+    assert.throws(() => resolve('$POSTHOG_API_KEY', 'env.POSTHOG_API_KEY'), (err) => err instanceof MissingEnvRefError &&
+        err.ref === 'POSTHOG_API_KEY' &&
+        err.referencedBy === 'env.POSTHOG_API_KEY');
+});
+test('treats empty-string env vars as missing (explicit unset)', () => {
+    const resolve = makeEnvRefResolver({ FOO: '' });
+    assert.throws(() => resolve('$FOO', 'x'), MissingEnvRefError);
+});
+test('resolveStringMap walks every value and reports the originating field', () => {
+    const result = resolveStringMap({ A: '$FOO', B: 'literal' }, { FOO: 'ok' }, 'env');
+    assert.deepEqual(result, { A: 'ok', B: 'literal' });
+    assert.throws(() => resolveStringMap({ X: '$MISSING' }, {}, 'env'), (err) => err instanceof MissingEnvRefError &&
+        err.ref === 'MISSING' &&
+        err.referencedBy === 'env.X');
+});
+test('resolveStringMap returns undefined for undefined input', () => {
+    assert.equal(resolveStringMap(undefined, {}, 'env'), undefined);
+});
+test('lenient resolver reports missing refs instead of throwing', () => {
+    const resolve = makeLenientResolver({ FOO: 'ok' });
+    assert.deepEqual(resolve('$FOO', 'x'), { ok: true, value: 'ok' });
+    assert.deepEqual(resolve('$MISSING', 'env.K'), {
+        ok: false,
+        field: 'env.K',
+        ref: 'MISSING'
+    });
+    assert.deepEqual(resolve('Bearer ${MISSING_KEY}', 'headers.Auth'), {
+        ok: false,
+        field: 'headers.Auth',
+        ref: 'MISSING_KEY'
+    });
+});
+test('resolveStringMapLenient drops missing entries and reports them', () => {
+    const result = resolveStringMapLenient({
+        PRESENT: '$FOO',
+        MISSING: '$NOPE',
+        LITERAL: 'plain',
+        PARTIAL_MISSING: 'Bearer ${NO_KEY}'
+    }, { FOO: 'value' }, 'env');
+    assert.deepEqual(result.value, { PRESENT: 'value', LITERAL: 'plain' });
+    assert.deepEqual(result.dropped.map((d) => `${d.field}:${d.ref}`).sort(), ['env.MISSING:NOPE', 'env.PARTIAL_MISSING:NO_KEY']);
+});
+test('resolveStringMapLenient returns value=undefined when all entries dropped', () => {
+    const result = resolveStringMapLenient({ A: '$MISSING' }, {}, 'env');
+    assert.equal(result.value, undefined);
+    assert.equal(result.dropped.length, 1);
+});
+//# sourceMappingURL=env-refs.test.js.map

package/dist/env-refs.test.js.map

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

package/dist/execute.d.ts

@@ -0,0 +1,47 @@
+import { type ApplyPersonaMountOptions } from './mount.js';
+import type { PersonaSpawnPlan } from './plan.js';
+export interface ExecutionHandle {
+    /** The cwd the harness should be spawned in (mount root if mounted). */
+    readonly cwd: string;
+    /**
+     * Reverse every side effect in LIFO order. Idempotent; safe to call twice.
+     * Best-effort: a failure inside one disposer does not prevent the others
+     * from running.
+     */
+    dispose(): Promise<void>;
+}
+export interface ExecuteOptions {
+    /** Working directory for skill installs and sidecar writes. */
+    cwd: string;
+    /**
+     * Whether to remove `.claude/skills/` and friends when `dispose()` runs.
+     * Default true — leaving someone's repo with a half-installed skills dir
+     * after a one-shot spawn is the bigger surprise.
+     */
+    cleanupSkillsOnDispose?: boolean;
+    /**
+     * Mount-specific options forwarded to {@link applyPersonaMount} when the
+     * plan carries a {@link PersonaSpawnPlan.mount} policy. Required in that
+     * case — the executor cannot guess a mountDir.
+     */
+    mount?: Omit<ApplyPersonaMountOptions, 'cwd'>;
+}
+/**
+ * Run the plan's side effects in deterministic order with abort-on-failure.
+ * After this returns successfully, the harness can be spawned at
+ * `handle.cwd` with `plan.cli` + `plan.args` and `plan.env`.
+ *
+ * Order:
+ *   1. {@link applyPersonaMount} — mount policy first; everything else
+ *      writes into the resulting cwd.
+ *   2. {@link runSkillInstalls} — install before sidecars/configFiles so a
+ *      failing skill doesn't strand a half-written sidecar on disk.
+ *   3. {@link writePersonaSidecars} — claudeMd / agentsMd to disk with
+ *      restore tracking.
+ *   4. {@link materializePersonaConfigFiles} — opencode.json and friends.
+ *
+ * If any step throws, prior steps' handles are disposed in LIFO order
+ * before the original error propagates. Callers never see partial state.
+ */
+export declare function executePersonaSpawnPlan(plan: PersonaSpawnPlan, options: ExecuteOptions): Promise<ExecutionHandle>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAE9B,MAAM,YAAY,CAAC;AAOpB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;CAC/C;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CA4C1B"}

package/dist/execute.js

@@ -0,0 +1,68 @@
+import { applyPersonaMount } from './mount.js';
+import { materializePersonaConfigFiles } from './config-files.js';
+import { writePersonaSidecars } from './sidecars.js';
+import { runSkillInstalls } from './skill-runner.js';
+async function disposeAll(handles) {
+    for (let i = handles.length - 1; i >= 0; i -= 1) {
+        try {
+            await handles[i].dispose();
+        }
+        catch {
+            // Best-effort — keep going so the remaining handles get a chance.
+        }
+    }
+}
+/**
+ * Run the plan's side effects in deterministic order with abort-on-failure.
+ * After this returns successfully, the harness can be spawned at
+ * `handle.cwd` with `plan.cli` + `plan.args` and `plan.env`.
+ *
+ * Order:
+ *   1. {@link applyPersonaMount} — mount policy first; everything else
+ *      writes into the resulting cwd.
+ *   2. {@link runSkillInstalls} — install before sidecars/configFiles so a
+ *      failing skill doesn't strand a half-written sidecar on disk.
+ *   3. {@link writePersonaSidecars} — claudeMd / agentsMd to disk with
+ *      restore tracking.
+ *   4. {@link materializePersonaConfigFiles} — opencode.json and friends.
+ *
+ * If any step throws, prior steps' handles are disposed in LIFO order
+ * before the original error propagates. Callers never see partial state.
+ */
+export async function executePersonaSpawnPlan(plan, options) {
+    const handles = [];
+    let mountHandle;
+    try {
+        mountHandle = await applyPersonaMount(plan.mount, {
+            cwd: options.cwd,
+            personaId: plan.persona.personaId,
+            ...(options.mount ?? {})
+        });
+        handles.push(mountHandle);
+        const childCwd = mountHandle.cwd;
+        const skillsHandle = await runSkillInstalls(plan.skills, {
+            cwd: childCwd,
+            cleanupOnDispose: options.cleanupSkillsOnDispose ?? true
+        });
+        handles.push(skillsHandle);
+        const sidecarHandle = await writePersonaSidecars(plan.sidecars, { cwd: childCwd });
+        handles.push(sidecarHandle);
+        const configHandle = await materializePersonaConfigFiles(plan.configFiles, { cwd: childCwd });
+        handles.push(configHandle);
+        let disposed = false;
+        return {
+            cwd: childCwd,
+            async dispose() {
+                if (disposed)
+                    return;
+                disposed = true;
+                await disposeAll(handles);
+            }
+        };
+    }
+    catch (err) {
+        await disposeAll(handles);
+        throw err;
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../src/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,6BAA6B,EAE9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAA6B,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAA4B,MAAM,mBAAmB,CAAC;AAmC/E,KAAK,UAAU,UAAU,CAAC,OAA4B;IACpD,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;QACpE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAsB,EACtB,OAAuB;IAEvB,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,WAA2C,CAAC;IAChD,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE;YAChD,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE1B,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC;QAEjC,MAAM,YAAY,GAAwB,MAAM,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE;YAC5E,GAAG,EAAE,QAAQ;YACb,gBAAgB,EAAE,OAAO,CAAC,sBAAsB,IAAI,IAAI;SACzD,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE3B,MAAM,aAAa,GAAyB,MAAM,oBAAoB,CACpE,IAAI,CAAC,QAAQ,EACb,EAAE,GAAG,EAAE,QAAQ,EAAE,CAClB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAE5B,MAAM,YAAY,GAA6B,MAAM,6BAA6B,CAChF,IAAI,CAAC,WAAW,EAChB,EAAE,GAAG,EAAE,QAAQ,EAAE,CAClB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAE3B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,OAAO;YACL,GAAG,EAAE,QAAQ;YACb,KAAK,CAAC,OAAO;gBACX,IAAI,QAAQ;oBAAE,OAAO;gBACrB,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1B,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/execute.test.d.ts

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

package/dist/execute.test.d.ts.map

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

package/dist/execute.test.js

@@ -0,0 +1,255 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { buildPersonaSpawnPlan } from './plan.js';
+import { executePersonaSpawnPlan } from './execute.js';
+import { writePersonaSidecars } from './sidecars.js';
+import { materializePersonaConfigFiles } from './config-files.js';
+import { runSkillInstalls } from './skill-runner.js';
+const cleanEnv = Object.freeze({});
+function persona(over = {}) {
+    return {
+        personaId: 'p',
+        tier: 'best-value',
+        runtime: {
+            harness: 'claude',
+            model: 'anthropic/claude-3-5-sonnet',
+            systemPrompt: 'be helpful',
+            harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+        },
+        skills: [],
+        rationale: 'test',
+        ...over
+    };
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function withTmpDir(fn) {
+    const dir = await mkdtemp(join(tmpdir(), 'persona-kit-test-'));
+    try {
+        return await fn(dir);
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+test('writePersonaSidecars overwrite + dispose restores empty target', async () => {
+    await withTmpDir(async (dir) => {
+        const handle = await writePersonaSidecars([{ filename: 'CLAUDE.md', contents: 'persona body', mode: 'overwrite' }], { cwd: dir });
+        const target = join(dir, 'CLAUDE.md');
+        assert.equal(await readFile(target, 'utf8'), 'persona body');
+        await handle.dispose();
+        assert.equal(await exists(target), false);
+        // Idempotent
+        await handle.dispose();
+    });
+});
+test('writePersonaSidecars resolves sourcePath at write time', async () => {
+    await withTmpDir(async (dir) => {
+        const sourcePath = join(dir, 'source.md');
+        await writeFile(sourcePath, 'persona body from disk', 'utf8');
+        const handle = await writePersonaSidecars([{ filename: 'CLAUDE.md', sourcePath, mode: 'overwrite' }], { cwd: dir });
+        assert.equal(await readFile(join(dir, 'CLAUDE.md'), 'utf8'), 'persona body from disk');
+        await handle.dispose();
+    });
+});
+test('writePersonaSidecars rejects unsafe filenames', async () => {
+    await withTmpDir(async (dir) => {
+        await assert.rejects(writePersonaSidecars([
+            {
+                filename: '../escape.md',
+                contents: 'x',
+                mode: 'overwrite'
+            }
+        ], { cwd: dir }), /must be a basename/);
+        await assert.rejects(writePersonaSidecars([
+            {
+                filename: '/abs.md',
+                contents: 'x',
+                mode: 'overwrite'
+            }
+        ], { cwd: dir }), /must be relative/);
+    });
+});
+test('writePersonaSidecars extend joins existing content with delimiter', async () => {
+    await withTmpDir(async (dir) => {
+        const target = join(dir, 'AGENTS.md');
+        await writeFile(target, 'existing body', 'utf8');
+        const handle = await writePersonaSidecars([{ filename: 'AGENTS.md', contents: 'persona body', mode: 'extend' }], { cwd: dir });
+        assert.equal(await readFile(target, 'utf8'), 'existing body\n\n---\n\npersona body');
+        await handle.dispose();
+        assert.equal(await readFile(target, 'utf8'), 'existing body');
+    });
+});
+test('materializePersonaConfigFiles writes nested paths and restores them', async () => {
+    await withTmpDir(async (dir) => {
+        const handle = await materializePersonaConfigFiles([{ path: '.opencode/agents.json', contents: '{}' }], { cwd: dir });
+        assert.equal(await readFile(join(dir, '.opencode/agents.json'), 'utf8'), '{}');
+        await handle.dispose();
+        assert.equal(await exists(join(dir, '.opencode/agents.json')), false);
+    });
+});
+test('materializePersonaConfigFiles rejects unsafe paths before writing', async () => {
+    await withTmpDir(async (dir) => {
+        await assert.rejects(materializePersonaConfigFiles([{ path: '../escape', contents: 'x' }], { cwd: dir }), /must not contain ".." segments/);
+        await assert.rejects(materializePersonaConfigFiles([{ path: '/abs', contents: 'x' }], { cwd: dir }), /must be relative/);
+    });
+});
+test('runSkillInstalls rejects cleanup paths that escape cwd', async () => {
+    await withTmpDir(async (dir) => {
+        const plan = {
+            harness: 'claude',
+            installs: [
+                {
+                    skillId: 's',
+                    source: 'x/y',
+                    sourceKind: 'prpm',
+                    packageRef: 'x/y',
+                    harness: 'claude',
+                    installCommand: [process.execPath, '-e', 'process.exit(0)'],
+                    installedDir: '.claude/skills/y',
+                    installedManifest: '.claude/skills/y/SKILL.md',
+                    cleanupPaths: ['../escape']
+                }
+            ]
+        };
+        const handle = await runSkillInstalls(plan, { cwd: dir });
+        await assert.rejects(handle.dispose(), /must stay within cwd/);
+    });
+});
+test('runSkillInstalls scaffolds the session install root and disposes it', async () => {
+    await withTmpDir(async (dir) => {
+        const sessionRoot = join(dir, 'session');
+        const plan = {
+            harness: 'claude',
+            installs: [],
+            sessionInstallRoot: sessionRoot
+        };
+        const handle = await runSkillInstalls(plan, { cwd: dir });
+        assert.ok(await exists(join(sessionRoot, '.claude-plugin', 'plugin.json')));
+        await handle.dispose();
+        assert.equal(await exists(sessionRoot), false);
+    });
+});
+test('runSkillInstalls spawns the chained install command for a non-session plan', async () => {
+    await withTmpDir(async (dir) => {
+        // Non-session mode runs `install.installCommand` verbatim — use a
+        // harmless `true` so the spawn path is exercised without network or
+        // disk side effects. cleanupPaths is empty so dispose is a no-op.
+        const plan = {
+            harness: 'claude',
+            installs: [
+                {
+                    skillId: 'noop',
+                    source: 'noop/noop',
+                    sourceKind: 'prpm',
+                    packageRef: 'noop/noop',
+                    harness: 'claude',
+                    installCommand: [process.execPath, '-e', 'process.exit(0)'],
+                    installedDir: '.claude/skills/noop',
+                    installedManifest: '.claude/skills/noop/SKILL.md',
+                    cleanupPaths: []
+                }
+            ]
+        };
+        const handle = await runSkillInstalls(plan, { cwd: dir });
+        await handle.dispose();
+    });
+});
+test('runSkillInstalls surfaces a non-zero install with SkillInstallError', async () => {
+    await withTmpDir(async (dir) => {
+        const plan = {
+            harness: 'claude',
+            installs: [
+                {
+                    skillId: 'fail',
+                    source: 'fail/fail',
+                    sourceKind: 'prpm',
+                    packageRef: 'fail/fail',
+                    harness: 'claude',
+                    installCommand: [process.execPath, '-e', 'process.exit(17)'],
+                    installedDir: '.claude/skills/fail',
+                    installedManifest: '.claude/skills/fail/SKILL.md',
+                    cleanupPaths: []
+                }
+            ]
+        };
+        await assert.rejects(runSkillInstalls(plan, { cwd: dir }), (err) => {
+            assert.equal(err.name, 'SkillInstallError');
+            assert.equal(err.exitCode, 17);
+            return true;
+        });
+    });
+});
+test('executePersonaSpawnPlan happy path orders side effects and disposes them in LIFO', async () => {
+    await withTmpDir(async (dir) => {
+        const plan = buildPersonaSpawnPlan(persona({
+            personaId: 'sample',
+            runtime: {
+                harness: 'opencode',
+                model: 'anthropic/claude-3-5-sonnet',
+                systemPrompt: 'opencode prompt',
+                harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+            },
+            agentsMdContent: '# persona agents',
+            agentsMdMode: 'overwrite'
+        }), { processEnv: cleanEnv });
+        assert.ok(plan.configFiles.some((f) => f.path.endsWith('opencode.json')));
+        assert.equal(plan.sidecars[0]?.filename, 'AGENTS.md');
+        const handle = await executePersonaSpawnPlan(plan, { cwd: dir });
+        assert.equal(handle.cwd, dir);
+        assert.equal(await readFile(join(dir, 'AGENTS.md'), 'utf8'), '# persona agents');
+        assert.equal(await exists(join(dir, 'opencode.json')), true);
+        await handle.dispose();
+        assert.equal(await exists(join(dir, 'AGENTS.md')), false);
+        assert.equal(await exists(join(dir, 'opencode.json')), false);
+        // Idempotent
+        await handle.dispose();
+    });
+});
+test('executePersonaSpawnPlan empty-skills path is a no-op for skills', async () => {
+    await withTmpDir(async (dir) => {
+        const plan = buildPersonaSpawnPlan(persona(), { processEnv: cleanEnv });
+        assert.equal(plan.skills.installs.length, 0);
+        const handle = await executePersonaSpawnPlan(plan, { cwd: dir });
+        assert.equal(handle.cwd, dir);
+        await handle.dispose();
+    });
+});
+test('executePersonaSpawnPlan disposes prior handles when a later step fails', async () => {
+    await withTmpDir(async (dir) => {
+        // Pre-create a stub at AGENTS.md so we can verify it gets restored after a
+        // later failing step. Then synthesize a plan whose configFile path is unsafe
+        // — it should reject after the sidecar step has already written to disk.
+        const target = join(dir, 'AGENTS.md');
+        await writeFile(target, 'previous content', 'utf8');
+        const plan = buildPersonaSpawnPlan(persona({
+            personaId: 'sample',
+            runtime: {
+                harness: 'opencode',
+                model: 'anthropic/claude-3-5-sonnet',
+                systemPrompt: 'opencode prompt',
+                harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 }
+            },
+            agentsMdContent: '# persona agents',
+            agentsMdMode: 'overwrite'
+        }), { processEnv: cleanEnv });
+        // Inject an unsafe configFile to force materializePersonaConfigFiles to throw
+        // after the sidecar has been written. The executor must then restore the
+        // sidecar's prior content before the error propagates.
+        plan.configFiles.push({ path: '../escape.json', contents: 'x' });
+        await assert.rejects(executePersonaSpawnPlan(plan, { cwd: dir }), /must not contain/);
+        // Sidecar must be restored to its original content.
+        assert.equal(await readFile(target, 'utf8'), 'previous content');
+    });
+});
+//# sourceMappingURL=execute.test.js.map

package/dist/execute.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { BUILT_IN_PERSONA_INTENTS, CODEX_APPROVAL_POLICIES, CODEX_SANDBOX_MODES, HARNESS_SKILL_TARGETS, HARNESS_VALUES, PERMISSION_MODES, PERSONA_INTENTS, PERSONA_TAGS, PERSONA_TIERS, SIDECAR_MD_MODES, SKILL_SOURCE_KINDS } from './constants.js';
+export type { CodexApprovalPolicy, CodexSandboxMode, Harness, HarnessSettings, HarnessSkillTarget, McpServerSpec, PermissionMode, PersonaContext, PersonaInputSpec, PersonaInstallContext, PersonaIntent, PersonaMount, PersonaPermissions, PersonaRuntime, PersonaSelection, PersonaSkill, PersonaSpec, PersonaTag, PersonaTier, SidecarMdMode, SkillInstall, SkillMaterializationOptions, SkillMaterializationPlan, SkillSourceKind } from './types.js';
+export { assertInputName, assertSidecarPath, deepFreeze, INPUT_NAME_RE, isHarness, isIntent, isObject, isSidecarMode, isTag, isTier, parseHarnessSettings, parseInputs, parseMcpServers, parseMount, parsePermissions, parsePersonaSpec, parseRuntime, parseSkills, parseStringList, parseStringMap, parseTags, resolveSidecar, sidecarSelectionFields } from './parse.js';
+export { buildCleanupArtifacts, buildInstallArtifacts, materializeSkills, materializeSkillsFor, resolveSkillSource } from './skills.js';
+export { MissingEnvRefError, makeEnvRefResolver, makeLenientResolver, resolveStringMap, resolveStringMapLenient, type DroppedRef, type EnvRefResolver, type LenientResult } from './env-refs.js';
+export { formatDropWarnings, resolveMcpServersLenient, type DroppedMcpServer, type McpResolution } from './mcp.js';
+export { MissingPersonaInputError, renderPersonaInputs, resolvePersonaInputs, type PersonaInputResolution, type PersonaInputValues } from './inputs.js';
+export { buildInteractiveSpec, buildNonInteractiveSpec, type BuildInteractiveSpecInput, type InteractiveConfigFile, type InteractiveSpec, type NonInteractiveSpec } from './interactive-spec.js';
+export { detectHarness, detectHarnesses, type HarnessAvailability } from './detect.js';
+export { buildPersonaSpawnPlan, type PersonaSpawnPlan, type PlanOptions, type ResolvedInputBinding, type ResolvedMountPolicy, type ResolvedPersona, type ResolvedSidecarWrite } from './plan.js';
+export { executePersonaSpawnPlan, type ExecuteOptions, type ExecutionHandle } from './execute.js';
+export { applyPersonaMount, type ApplyPersonaMountOptions, type PersonaMountHandle } from './mount.js';
+export { writePersonaSidecars, type PersonaSidecarHandle } from './sidecars.js';
+export { assertSafeRelativePath, materializePersonaConfigFiles, type PersonaConfigFilesHandle } from './config-files.js';
+export { runSkillInstalls, SkillInstallError, type PersonaSkillsHandle, type RunSkillInstallsOptions } from './skill-runner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,2BAA2B,EAC3B,wBAAwB,EACxB,eAAe,EAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,KAAK,EACL,MAAM,EACN,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,cAAc,EACd,SAAS,EACT,cAAc,EACd,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,aAAa,EACb,eAAe,EACf,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+// Constants
+export { BUILT_IN_PERSONA_INTENTS, CODEX_APPROVAL_POLICIES, CODEX_SANDBOX_MODES, HARNESS_SKILL_TARGETS, HARNESS_VALUES, PERMISSION_MODES, PERSONA_INTENTS, PERSONA_TAGS, PERSONA_TIERS, SIDECAR_MD_MODES, SKILL_SOURCE_KINDS } from './constants.js';
+// Parsers + sidecar resolver
+export { assertInputName, assertSidecarPath, deepFreeze, INPUT_NAME_RE, isHarness, isIntent, isObject, isSidecarMode, isTag, isTier, parseHarnessSettings, parseInputs, parseMcpServers, parseMount, parsePermissions, parsePersonaSpec, parseRuntime, parseSkills, parseStringList, parseStringMap, parseTags, resolveSidecar, sidecarSelectionFields } from './parse.js';
+// Skill materialization
+export { buildCleanupArtifacts, buildInstallArtifacts, materializeSkills, materializeSkillsFor, resolveSkillSource } from './skills.js';
+// Env-ref resolution
+export { MissingEnvRefError, makeEnvRefResolver, makeLenientResolver, resolveStringMap, resolveStringMapLenient } from './env-refs.js';
+// MCP resolution
+export { formatDropWarnings, resolveMcpServersLenient } from './mcp.js';
+// Persona inputs
+export { MissingPersonaInputError, renderPersonaInputs, resolvePersonaInputs } from './inputs.js';
+// Interactive harness spec
+export { buildInteractiveSpec, buildNonInteractiveSpec } from './interactive-spec.js';
+// Harness detection
+export { detectHarness, detectHarnesses } from './detect.js';
+// Plan builder + plan types
+export { buildPersonaSpawnPlan } from './plan.js';
+// Side-effecting orchestration
+export { executePersonaSpawnPlan } from './execute.js';
+// Piecewise side-effect helpers (advanced orchestration)
+export { applyPersonaMount } from './mount.js';
+export { writePersonaSidecars } from './sidecars.js';
+export { assertSafeRelativePath, materializePersonaConfigFiles } from './config-files.js';
+export { runSkillInstalls, SkillInstallError } from './skill-runner.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY;AACZ,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AA8BxB,6BAA6B;AAC7B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,KAAK,EACL,MAAM,EACN,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,cAAc,EACd,SAAS,EACT,cAAc,EACd,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,wBAAwB;AACxB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EAIxB,MAAM,eAAe,CAAC;AAEvB,iBAAiB;AACjB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EAGzB,MAAM,UAAU,CAAC;AAElB,iBAAiB;AACjB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EAGrB,MAAM,aAAa,CAAC;AAErB,2BAA2B;AAC3B,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EAKxB,MAAM,uBAAuB,CAAC;AAE/B,oBAAoB;AACpB,OAAO,EACL,aAAa,EACb,eAAe,EAEhB,MAAM,aAAa,CAAC;AAErB,4BAA4B;AAC5B,OAAO,EACL,qBAAqB,EAOtB,MAAM,WAAW,CAAC;AAEnB,+BAA+B;AAC/B,OAAO,EACL,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAEtB,yDAAyD;AACzD,OAAO,EACL,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EAErB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAE9B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,mBAAmB,CAAC"}

package/dist/index.test.d.ts

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

package/dist/index.test.d.ts.map

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