@playcraft/cli 0.1.27 → 0.1.29

package/dist/project-skills/builtin-import.js

@@ -1,225 +0,0 @@
-import { createHash, randomUUID } from 'node:crypto';
-import { lstat, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-import { canonicalProjectSkillsJson, declarationDigest, dependencyDigest, extractBundleArchive, readProjectSkillSource, readProjectSkillsLockFile, validateProjectSkillsSnapshot, PROJECT_SKILLS_DECLARATION_PATH, PROJECT_SKILLS_LOCK_PATH, } from '@playcraft/common/project-skills';
-import { LEGACY_VIDEO_SOURCE_HASHES } from '@playcraft/common/cloud-workspace/runtime';
-import { projectSkillsCache } from './local-store.js';
-export const IMPORTABLE_BUILTIN_SKILLS = ['playcraft-video-understanding', 'playcraft-replica-validation'];
-export const platformSkillRef = (name) => `remix/${name}`;
-const hash = (value) => createHash('sha256').update(canonicalProjectSkillsJson(value)).digest('hex');
-async function safeDirectory(root, path) {
-    let current = root;
-    for (const part of path.split('/')) {
-        current = join(current, part);
-        await mkdir(current, { mode: 0o755 }).catch(error => { if (error.code !== 'EEXIST')
-            throw error; });
-        const stat = await lstat(current);
-        if (!stat.isDirectory() || stat.isSymbolicLink())
-            throw new Error('workspace_skills_invalid');
-    }
-    return current;
-}
-/** Selects published platform revisions once; neither directory contents nor names authorize a replacement. */
-export async function selectPlatformSkillSnapshot(names, access) {
-    if (!names.length || new Set(names).size !== names.length
-        || names.some(name => !IMPORTABLE_BUILTIN_SKILLS.includes(name)))
-        throw new Error('workspace_skills_builtin_unknown');
-    if (!access)
-        throw new Error('workspace_skills_platform_required');
-    const requested = names.map(platformSkillRef);
-    const response = await access.resolve(requested);
-    const snapshot = validateProjectSkillsSnapshot(response?.declaration, response?.lock);
-    if (snapshot.declaration.entries.length !== names.length || snapshot.lock.entries.length !== names.length)
-        throw new Error('workspace_skills_invalid');
-    for (const name of names) {
-        const entry = snapshot.declaration.entries.find(item => item.entryKey === name);
-        const locked = snapshot.lock.entries.find(item => item.entryKey === name);
-        if (!entry || !locked || entry.source.kind !== 'registry' || entry.source.skillRef !== platformSkillRef(name)
-            || entry.surface !== 'sandbox-agent' || !entry.enabled || locked.revision.kind !== 'release'
-            || locked.dependencies.length !== 0 || locked.dependencyLockHash !== dependencyDigest([], []))
-            throw new Error('workspace_skills_invalid');
-    }
-    const artifacts = await Promise.all(snapshot.lock.entries.map(async (entry) => {
-        const archive = await access.loadArtifact(entry);
-        if (archive.length > 80 * 1024 * 1024 || createHash('sha256').update(archive).digest('hex') !== entry.revision.artifactHash)
-            throw new Error('workspace_skills_digest_mismatch');
-        const extracted = extractBundleArchive(archive);
-        if (extracted.issues.length || !extracted.files.some(file => file.path === 'SKILL.md'))
-            throw new Error('workspace_skills_invalid_bundle');
-        return { artifactHash: entry.revision.artifactHash, archive };
-    }));
-    return { ...snapshot, artifacts };
-}
-async function commitSnapshot(directory, snapshot, originalDeclaration, staged) {
-    const declarationPath = join(directory, PROJECT_SKILLS_DECLARATION_PATH);
-    const pending = [];
-    for (const [path, value] of [[PROJECT_SKILLS_DECLARATION_PATH, snapshot.declaration], [PROJECT_SKILLS_LOCK_PATH, snapshot.lock]]) {
-        const temporary = `${join(directory, path)}.${randomUUID()}.tmp`;
-        staged.push(temporary);
-        await writeFile(temporary, `${canonicalProjectSkillsJson(value)}\n`, { flag: 'wx', mode: 0o644 });
-        pending.push(temporary);
-    }
-    await rename(pending[0], declarationPath);
-    try {
-        await rename(pending[1], join(directory, PROJECT_SKILLS_LOCK_PATH));
-    }
-    catch (error) {
-        // The old lock still exists. Restore its exact declaration before releasing the writer lease.
-        const restore = `${declarationPath}.${randomUUID()}.tmp`;
-        staged.push(restore);
-        await writeFile(restore, originalDeclaration, { flag: 'wx', mode: 0o644 });
-        await rename(restore, declarationPath);
-        throw error;
-    }
-}
-async function cacheArtifacts(cache, selected) {
-    await mkdir(cache, { recursive: true, mode: 0o700 });
-    for (const artifact of selected.artifacts) {
-        const path = join(cache, `${artifact.artifactHash}.tar.gz`);
-        try {
-            await writeFile(path, artifact.archive, { flag: 'wx', mode: 0o600 });
-        }
-        catch (error) {
-            if (error.code !== 'EEXIST' || !(await readFile(path)).equals(artifact.archive))
-                throw error;
-        }
-    }
-}
-/** Explicit imports keep prior locks and unsynced repository sources byte-for-byte. */
-export async function importBuiltinProjectSkills(directory, options, cache = projectSkillsCache(), access, selected, enabled = false) {
-    if (!options.names.length || new Set(options.names).size !== options.names.length
-        || options.names.some(name => !IMPORTABLE_BUILTIN_SKILLS.includes(name)))
-        throw new Error('workspace_skills_builtin_unknown');
-    const management = await safeDirectory(directory, '.playcraft');
-    const lease = join(management, 'skills-write.lock');
-    await writeFile(lease, `${process.pid}\n`, { flag: 'wx', mode: 0o600 });
-    const staged = [];
-    try {
-        const declarationPath = join(directory, PROJECT_SKILLS_DECLARATION_PATH);
-        const declarationStat = await lstat(declarationPath);
-        if (!declarationStat.isFile() || declarationStat.isSymbolicLink() || declarationStat.size > 1024 * 1024)
-            throw new Error('workspace_skills_invalid');
-        const originalDeclaration = await readFile(declarationPath);
-        const previous = validateProjectSkillsSnapshot(originalDeclaration.toString('utf8'), await readProjectSkillsLockFile(directory));
-        if (options.expectedDeclarationHash !== previous.lock.declarationHash || options.expectedLockHash !== hash(previous.lock))
-            throw new Error('skills_revision_conflict');
-        const next = structuredClone(previous);
-        const unchanged = [], missing = [];
-        for (const name of options.names) {
-            const existing = previous.declaration.entries.find(entry => entry.source.kind === 'registry' && entry.source.skillRef === platformSkillRef(name));
-            if (existing) {
-                unchanged.push(existing.entryKey);
-                continue;
-            }
-            if (previous.declaration.entries.some(entry => entry.entryKey === name || entry.source.kind === 'repository' && basename(entry.source.root) === name))
-                throw new Error('workspace_skills_builtin_conflict');
-            for (const sourceRoot of ['.agents/skills', '.claude/skills', '.opencode/skills', '.opencode/skill']) {
-                if (await lstat(join(directory, sourceRoot, name)).then(() => true, error => { if (error.code === 'ENOENT')
-                    return false; throw error; }))
-                    throw new Error('workspace_skills_builtin_conflict');
-            }
-            missing.push(name);
-        }
-        const imported = [];
-        if (missing.length) {
-            const resolved = selected ?? await selectPlatformSkillSnapshot(missing, access);
-            await cacheArtifacts(cache, resolved);
-            for (const name of missing) {
-                const entry = resolved.declaration.entries.find(item => item.entryKey === name);
-                const locked = resolved.lock.entries.find(item => item.entryKey === name);
-                if (!entry || !locked)
-                    throw new Error('workspace_skills_invalid');
-                next.declaration.entries.push({ ...entry, enabled });
-                next.lock.entries.push(locked);
-                imported.push(name);
-            }
-            next.lock.declarationHash = declarationDigest(next.declaration);
-            validateProjectSkillsSnapshot(next.declaration, next.lock);
-            await commitSnapshot(directory, next, originalDeclaration, staged);
-        }
-        return { ...next, imported, unchanged, lockHash: hash(next.lock) };
-    }
-    finally {
-        for (const path of staged)
-            await rm(path, { force: true });
-        await rm(lease, { force: true });
-    }
-}
-/** Only original bundled sources qualify; changed or forked skills require a separate explicit user decision. */
-export async function migrateVideoProjectSkills(directory, options, cache, access) {
-    const management = await safeDirectory(directory, '.playcraft');
-    const lease = join(management, 'skills-write.lock');
-    await writeFile(lease, `${process.pid}\n`, { flag: 'wx', mode: 0o600 });
-    const moved = [];
-    const staged = [];
-    let committed = false;
-    try {
-        const declarationPath = join(directory, PROJECT_SKILLS_DECLARATION_PATH);
-        const declarationStat = await lstat(declarationPath);
-        if (!declarationStat.isFile() || declarationStat.isSymbolicLink() || declarationStat.size > 1024 * 1024)
-            throw new Error('workspace_skills_invalid');
-        const originalDeclaration = await readFile(declarationPath);
-        const previous = validateProjectSkillsSnapshot(originalDeclaration.toString('utf8'), await readProjectSkillsLockFile(directory));
-        const oldLockHash = hash(previous.lock);
-        if (options.expectedDeclarationHash !== previous.lock.declarationHash || options.expectedLockHash !== oldLockHash)
-            throw new Error('skills_revision_conflict');
-        if (!options.entryKeys.length || options.entryKeys.length > 2 || new Set(options.entryKeys).size !== options.entryKeys.length)
-            throw new Error('workspace_skills_builtin_unknown');
-        const replacements = [];
-        for (const key of options.entryKeys) {
-            const entry = previous.declaration.entries.find(item => item.entryKey === key);
-            const locked = previous.lock.entries.find(item => item.entryKey === key);
-            if (!entry || !locked || entry.source.kind !== 'repository' || locked.revision.kind !== 'source'
-                || entry.surface !== 'sandbox-agent' || entry.projectFiles?.length || locked.dependencies.length
-                || previous.lock.entries.some(item => item.entryKey !== key && item.dependencies.includes(key)))
-                throw new Error('workspace_skills_builtin_conflict');
-            const name = basename(entry.source.root);
-            const known = LEGACY_VIDEO_SOURCE_HASHES[name];
-            if (!known || locked.sourceTreeHash !== known || (await readProjectSkillSource(directory, entry)).sourceTreeHash !== known
-                || previous.declaration.entries.some(item => item.entryKey !== key && (item.entryKey === name || item.source.kind === 'registry' && item.source.skillRef === platformSkillRef(name))))
-                throw new Error('workspace_skills_builtin_conflict');
-            replacements.push({ entry, name });
-        }
-        const selected = await selectPlatformSkillSnapshot(replacements.map(item => item.name), access);
-        await cacheArtifacts(cache, selected);
-        const next = structuredClone(previous);
-        for (const { entry, name } of replacements) {
-            const replacement = selected.declaration.entries.find(item => item.entryKey === name);
-            const locked = selected.lock.entries.find(item => item.entryKey === name);
-            next.declaration.entries[next.declaration.entries.findIndex(item => item.entryKey === entry.entryKey)] = { ...replacement, entryKey: entry.entryKey, enabled: entry.enabled };
-            next.lock.entries[next.lock.entries.findIndex(item => item.entryKey === entry.entryKey)] = { ...locked, entryKey: entry.entryKey };
-        }
-        for (const locked of next.lock.entries)
-            locked.dependencyLockHash = dependencyDigest(next.lock.entries, locked.dependencies);
-        next.lock.declarationHash = declarationDigest(next.declaration);
-        validateProjectSkillsSnapshot(next.declaration, next.lock);
-        const history = await safeDirectory(directory, `.playcraft/skill-migrations/${oldLockHash}`);
-        const receipt = { schemaVersion: 'playcraft.skill-migration.v1', previous, next, entryKeys: options.entryKeys };
-        const historyFile = join(history, 'migration.json');
-        try {
-            await writeFile(historyFile, `${canonicalProjectSkillsJson(receipt)}\n`, { flag: 'wx', mode: 0o644 });
-        }
-        catch (error) {
-            if (error.code !== 'EEXIST' || await readFile(historyFile, 'utf8') !== `${canonicalProjectSkillsJson(receipt)}\n`)
-                throw error;
-        }
-        for (const { entry } of replacements) {
-            if (entry.source.kind !== 'repository')
-                throw new Error('workspace_skills_invalid');
-            const from = join(directory, entry.source.root), to = join(history, entry.entryKey);
-            await rename(from, to);
-            moved.push({ from, to });
-        }
-        await commitSnapshot(directory, next, originalDeclaration, staged);
-        committed = true;
-        return { ...next, migrated: options.entryKeys, history: `.playcraft/skill-migrations/${oldLockHash}/migration.json`, lockHash: hash(next.lock) };
-    }
-    finally {
-        if (!committed)
-            for (const item of moved.reverse())
-                await rename(item.to, item.from).catch(() => undefined);
-        for (const path of staged)
-            await rm(path, { force: true });
-        await rm(lease, { force: true });
-    }
-}

package/dist/project-skills/commands.js

@@ -1,77 +0,0 @@
-import { verifyLocalProjectSkills } from './validation.js';
-export { verifyLocalProjectSkills } from './validation.js';
-import { downloadLocalProjectSkillArtifacts } from './remote-cache.js';
-import { resolve } from 'node:path';
-import { inspectProjectSkills, } from '@playcraft/common/project-skills';
-import { syncLocalProjectSkills, enableLocalProjectSkill, installFrozenProjectSkills, explainLocalProjectSkills } from './local-store.js';
-import { runLocalProjectSkills, localProjectSkillUsage } from './local-run.js';
-import { projectSkillsMessage as t } from './messages.js';
-import { reconcileLocalProjectSkills } from './reconcile.js';
-import { importBuiltinProjectSkills } from './builtin-import.js';
-export async function inspectLocalProjectSkills(directory) {
-    const inventory = await inspectProjectSkills(directory);
-    // Report metadata only; never print complete skill bytes or project test data.
-    return { declaration: inventory.declaration, discovered: inventory.discovered, issues: inventory.issues,
-        sources: inventory.sources.map((source) => ({ entryKey: source.entryKey, root: source.root,
-            sourceTreeHash: source.sourceTreeHash, files: source.files.map((file) => file.path) })) };
-}
-export function registerProjectSkillsCommands(skills) {
-    const project = skills.command('project').description(t('description'));
-    const output = async (action) => {
-        try {
-            process.stdout.write(`${JSON.stringify(await action(), null, 2)}\n`);
-        }
-        catch (error) {
-            process.stderr.write(`${t('failed')}: ${error instanceof Error && error.message === 'workspace_skills_platform_required' ? t('platformRequired') : error instanceof Error ? error.message : String(error)}\n`);
-            process.exitCode = 1;
-        }
-    };
-    project.command('run <prompt>').description(t('run')).requiredOption('--model <provider/model>', t('model'))
-        .option('--dir <path>', t('directory'), '.').action((prompt, options) => output(async () => {
-        const result = await runLocalProjectSkills(resolve(options.dir), { prompt, model: options.model });
-        if (result.exitCode !== 0)
-            process.exitCode = result.exitCode;
-        return result;
-    }));
-    project.command('usage').description(t('usage')).option('--dir <path>', t('directory'), '.')
-        .action((options) => output(() => localProjectSkillUsage(resolve(options.dir))));
-    project.command('sync').description(t('sync')).option('--dir <path>', t('directory'), '.')
-        .action((options) => output(() => syncLocalProjectSkills(resolve(options.dir))));
-    project.command('import-builtins <names...>').description(t('importBuiltins')).option('--dir <path>', t('directory'), '.')
-        .requiredOption('--expected-declaration-hash <hash>', t('expectedDeclarationHash'))
-        .requiredOption('--expected-lock-hash <hash>', t('expectedLockHash'))
-        .action((names, options) => output(() => importBuiltinProjectSkills(resolve(options.dir), { ...options, names })));
-    project.command('reconcile').description(t('reconcile')).option('--dir <path>', t('directory'), '.')
-        .action((options) => output(() => reconcileLocalProjectSkills(resolve(options.dir), { write: true })));
-    project.command('install').description(t('install')).requiredOption('--frozen', t('frozen')).option('--dir <path>', t('directory'), '.')
-        .option('--online', t('online')).action((options) => output(async () => {
-        const directory = resolve(options.dir);
-        if (options.online)
-            await downloadLocalProjectSkillArtifacts(directory);
-        return installFrozenProjectSkills(directory);
-    }));
-    for (const enabled of [true, false])
-        project.command(enabled ? 'enable <entryKey>' : 'disable <entryKey>')
-            .description(t(enabled ? 'enable' : 'disable')).option('--dir <path>', t('directory'), '.')
-            .action((entryKey, options) => output(() => enableLocalProjectSkill(resolve(options.dir), entryKey, enabled)));
-    project.command('explain').description(t('explain')).option('--dir <path>', t('directory'), '.')
-        .action((options) => output(() => explainLocalProjectSkills(resolve(options.dir))));
-    project.command('inspect').description(t('inspect')).option('--dir <path>', t('directory'), '.')
-        .action(async (options) => {
-        const result = await inspectLocalProjectSkills(resolve(options.dir));
-        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-        if (result.issues.length)
-            process.exitCode = 1;
-    });
-    project.command('verify').description(t('verify')).option('--dir <path>', t('directory'), '.')
-        .option('--json', t('json')).action(async (options) => {
-        try {
-            const result = await verifyLocalProjectSkills(resolve(options.dir));
-            process.stdout.write(`${options.json ? JSON.stringify(result) : t('verified')}\n`);
-        }
-        catch (error) {
-            process.stderr.write(`${t('failed')}: ${error instanceof Error ? error.message : String(error)}\n`);
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/project-skills/lifecycle.js

@@ -1,28 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { readProjectSkillsLockFile } from '@playcraft/common/project-skills';
-import { syncLocalProjectSkills, readLocalProjectSkillSnapshot, installFrozenProjectSkills } from './local-store.js';
-import { verifyLocalProjectSkills } from './validation.js';
-import { projectSkillsMessage as t } from './messages.js';
-/** Existing formats keep their legacy consumer; format 3 never silently downgrades. */
-export async function prepareLocalSkillLifecycle(directory, action, cache) {
-    const raw = await readProjectSkillsLockFile(directory);
-    const managed = raw !== null && JSON.parse(raw).lockVersion === 3;
-    if (!managed && process.env.PROJECT_SKILLS_ADOPTION_ENABLED !== 'true')
-        return { managed: false };
-    if (raw !== null && !managed)
-        return { managed: false, legacy: true };
-    if (action === 'create' || action === 'push' || !managed)
-        await syncLocalProjectSkills(directory, cache);
-    await verifyLocalProjectSkills(directory);
-    const snapshot = await readLocalProjectSkillSnapshot(directory);
-    if (action === 'push') {
-        const paths = ['.playcraft/skills.json', '.playcraft/skills.lock.json', ...snapshot.declaration.entries.flatMap(entry => entry.source.kind === 'repository' ? [entry.source.root, ...(entry.projectFiles ?? [])] : [])];
-        const status = spawnSync('git', ['status', '--porcelain', '--', ...paths], { cwd: directory, encoding: 'utf8' });
-        if (status.status !== 0 || status.stdout.trim())
-            throw new Error(t('commitRequired'));
-    }
-    // Source-only checkouts work offline. Registry packages remain exact and require an authorized cache fill.
-    if (!snapshot.lock.entries.some(entry => entry.revision.kind === 'release'))
-        await installFrozenProjectSkills(directory, cache);
-    return { managed: true, declarationHash: snapshot.lock.declarationHash };
-}

package/dist/project-skills/local-run.js

@@ -1,112 +0,0 @@
-import { spawn, execFileSync } from 'node:child_process';
-import { createHash, randomUUID } from 'node:crypto';
-import { createRequire } from 'node:module';
-import { readFile, writeFile, mkdir, readdir, realpath } from 'node:fs/promises';
-import { join } from 'node:path';
-import { pathToFileURL } from 'node:url';
-import { createInterface } from 'node:readline';
-import { effectiveProjectSkills, readManagedSkillEvidence } from '@playcraft/common/project-skills';
-import { installFrozenProjectSkills, readLocalProjectSkillSnapshot, projectSkillsCache } from './local-store.js';
-import { verifyLocalProjectSkills } from './validation.js';
-import { projectSkillsMessage as t } from './messages.js';
-const require = createRequire(import.meta.url);
-export async function localProjectSkillUsage(directory, cache = projectSkillsCache()) {
-    const root = join(cache, 'usage', createHash('sha256').update(await realpath(directory)).digest('hex'));
-    let files;
-    try {
-        files = await readdir(root);
-    }
-    catch (error) {
-        if (error.code === 'ENOENT')
-            return [];
-        throw error;
-    }
-    return Promise.all(files.filter(file => /^[a-f0-9-]+\.json$/.test(file)).sort().map(async (file) => JSON.parse(await readFile(join(root, file), 'utf8'))));
-}
-/** Local evidence is explicitly client-reported; it never acts as a server evaluation or access grant. */
-export async function runLocalProjectSkills(directory, options, cache = projectSkillsCache()) {
-    if (execFileSync('opencode', ['--version'], { encoding: 'utf8', timeout: 10000 }).trim() !== '1.18.31')
-        throw new Error(t('runner'));
-    const cwd = await realpath(directory);
-    await verifyLocalProjectSkills(cwd);
-    const snapshot = await readLocalProjectSkillSnapshot(cwd);
-    const installed = await installFrozenProjectSkills(cwd, cache);
-    const runId = randomUUID(), runtimeRoot = join(installed.generation, '.runtime');
-    const home = join(runtimeRoot, 'home');
-    await mkdir(home, { recursive: true, mode: 0o700 });
-    const entries = await Promise.all(effectiveProjectSkills(snapshot.declaration, snapshot.lock, 'sandbox-agent').map(async (entry) => {
-        const bodyFile = join(installed.generation, entry.entryKey, 'SKILL.md');
-        return { name: entry.entryKey, skillRef: entry.revision.skillRef, revisionId: entry.revision.kind === 'source' ? entry.revision.sourceRevision : entry.revision.version,
-            artifactHash: entry.revision.artifactHash, bodyFile, bodyHash: createHash('sha256').update(await readFile(bodyFile)).digest('hex'), description: entry.revision.skillRef };
-    }));
-    await writeFile(join(runtimeRoot, 'manifest.json'), JSON.stringify({ schemaVersion: 1, runtimeId: runId, lockId: snapshot.lock.declarationHash, entries }), { mode: 0o400 });
-    await writeFile(join(runtimeRoot, 'opencode.json'), JSON.stringify({ model: options.model,
-        plugin: [pathToFileURL(require.resolve('@playcraft/common/project-skills/runtime-plugin')).href] }), { mode: 0o400 });
-    const usageRoot = join(cache, 'usage', createHash('sha256').update(cwd).digest('hex'));
-    await mkdir(usageRoot, { recursive: true, mode: 0o700 });
-    const evidence = new Map();
-    const report = { schemaVersion: 1, runId, declarationHash: snapshot.lock.declarationHash, provenance: 'local-client-reported',
-        runnerVersion: '1.18.31', model: options.model, startedAt: new Date().toISOString(), status: 'running', collectionStatus: 'collecting', loaded: [] };
-    const reportPath = join(usageRoot, `${runId}.json`);
-    await writeFile(reportPath, JSON.stringify(report), { mode: 0o600 });
-    const environment = { ...process.env, HOME: home, XDG_CONFIG_HOME: join(home, '.config'), XDG_DATA_HOME: join(home, '.local/share'), XDG_STATE_HOME: join(home, '.local/state'), XDG_CACHE_HOME: join(home, '.cache'),
-        OPENCODE_CONFIG: join(runtimeRoot, 'opencode.json'), OPENCODE_CONFIG_DIR: join(runtimeRoot, 'config'),
-        OPENCODE_DISABLE_PROJECT_CONFIG: 'true', OPENCODE_DISABLE_CLAUDE_CODE: 'true', OPENCODE_DISABLE_DEFAULT_PLUGINS: 'true', OPENCODE_DISABLE_AUTOUPDATE: 'true',
-        PLAYCRAFT_SKILL_RUNTIME_FILE: join(runtimeRoot, 'manifest.json') };
-    delete environment.PLAYCRAFT_SKILL_RUNTIME_ROOT;
-    delete environment.OPENCODE_CONFIG_CONTENT;
-    let child;
-    let cancelled = false, killTimer;
-    const cancel = () => {
-        cancelled = true;
-        child?.kill('SIGTERM');
-        killTimer ??= setTimeout(() => child?.kill('SIGKILL'), 5000);
-        killTimer.unref();
-    };
-    process.once('SIGINT', cancel);
-    process.once('SIGTERM', cancel);
-    try {
-        child = spawn('opencode', ['run', '--format', 'json', '--model', options.model, '--', options.prompt], { cwd, env: environment, stdio: ['ignore', 'pipe', 'inherit'] });
-        // Resolve spawn failures so an early error cannot become an unhandled rejection while reading stdout.
-        const finished = new Promise(resolve => {
-            child.once('error', error => resolve({ code: 1, error }));
-            child.once('close', code => resolve({ code: code ?? 1 }));
-        });
-        const lines = createInterface({ input: child.stdout });
-        let partial = false;
-        for await (const line of lines) {
-            try {
-                const event = JSON.parse(line);
-                const parsed = readManagedSkillEvidence(event);
-                if (parsed?.runtimeId === runId && parsed.lockId === report.declarationHash && entries.some(entry => entry.revisionId === parsed.skillVersionId && entry.artifactHash === parsed.artifactHash && entry.bodyHash === parsed.bodyHash)) {
-                    evidence.set(parsed.dedupeKey, parsed);
-                    report.loaded = [...evidence.values()];
-                    await writeFile(reportPath, JSON.stringify(report), { mode: 0o600 });
-                }
-                if (event.type === 'text' && typeof event.part?.text === 'string')
-                    process.stderr.write(event.part.text);
-            }
-            catch {
-                partial = true;
-            }
-        }
-        const result = await finished;
-        if (result.error)
-            throw result.error;
-        const code = cancelled ? 130 : result.code;
-        report.status = cancelled ? 'cancelled' : code === 0 ? 'completed' : 'failed';
-        report.collectionStatus = code === 0 && !partial ? 'complete' : 'partial';
-        return { ...report, reportPath, exitCode: code };
-    }
-    finally {
-        if (killTimer)
-            clearTimeout(killTimer);
-        process.removeListener('SIGINT', cancel);
-        process.removeListener('SIGTERM', cancel);
-        if (report.status === 'running') {
-            report.status = 'failed';
-            report.collectionStatus = 'partial';
-        }
-        await writeFile(reportPath, JSON.stringify(report), { mode: 0o600 });
-    }
-}