claude-dev-env 7.7.1 → 8.0.0

package/.agents/skills/session-continuity/continuity.test.mjs

@@ -1,381 +0,0 @@
-import assert from 'node:assert/strict';
-import { createHash } from 'node:crypto';
-import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, unlinkSync, utimesSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { dirname, join } from 'node:path';
-import { spawn, spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
-import test from 'node:test';
-import { continuityHookConfiguration } from '../../../bin/install-session-continuity.mjs';
-
-const sourceDirectory = dirname(fileURLToPath(import.meta.url));
-const potetoText = '---\nname: Poteto Mode\n---\nPOTETO_SOURCE_EXPECTATION: prove the requested result.\n';
-const secondText = 'SECOND_SKILL_EXPECTATION: measure twice before changing files.\n';
-const sha256 = value => createHash('sha256').update(value).digest('hex');
-
-function fixture(t, host) {
-    const root = mkdtempSync(join(tmpdir(), 'continuity contract '));
-    t.after(() => rmSync(root, { recursive: true, force: true }));
-    const skill = join(root, '.agents', 'skills', 'session-continuity');
-    mkdirSync(skill, { recursive: true });
-    for (const file of ['SKILL.md', 'continuity.mjs']) copyFileSync(join(sourceDirectory, file), join(skill, file));
-    const poteto = join(root, '.agents', 'skills', 'pstack', 'poteto-mode', 'SKILL.md');
-    mkdirSync(dirname(poteto), { recursive: true });
-    writeFileSync(poteto, potetoText);
-    const second = join(root, 'second-skill.md');
-    writeFileSync(second, secondText);
-    const script = join(skill, 'continuity.mjs');
-    const configPath = join(root, host === 'claude' ? 'settings.json' : 'hooks.json');
-    writeFileSync(configPath, JSON.stringify({ ...(host === 'cursor' ? { version: 1 } : {}), hooks: continuityHookConfiguration(host, script) }));
-    const env = { ...process.env };
-    delete env.CDE_CONTINUITY_ROOT;
-    delete env.CDE_POTETO_SOURCE;
-    const pathFor = session => join(root, '.agents', 'state', 'session-continuity', host, `${sha256(session)}.json`);
-    const cli = (command, session, data, expectedStatus = 0) => {
-        const result = spawnSync(process.execPath, [script, command, host, session], { input: JSON.stringify(data || {}), encoding: 'utf8', env });
-        assert.equal(result.status, expectedStatus, result.stderr || result.stdout);
-        return expectedStatus ? result.stderr : JSON.parse(result.stdout);
-    };
-    const fire = (event, session, fields = {}) => {
-        const payload = { hook_event_name: event, cwd: root, ...(host === 'cursor' ? { conversation_id: session } : { session_id: session }), ...fields };
-        const config = JSON.parse(readFileSync(configPath, 'utf8'));
-        const groups = config.hooks[event] || [];
-        const matching = groups.filter(group => !group.matcher || new RegExp(group.matcher).test(event === 'SessionStart' ? fields.source : fields.command_name));
-        return matching.flatMap(group => (group.hooks || [group]).map(handler => {
-            const result = spawnSync(handler.command, { shell: true, input: JSON.stringify(payload), encoding: 'utf8', env });
-            assert.equal(result.status, 0, result.stderr);
-            return JSON.parse(result.stdout);
-        }));
-    };
-    const submit = (session, prompt) => fire('UserPromptSubmit', session, { prompt })[0];
-    const read = session => JSON.parse(readFileSync(pathFor(session), 'utf8'));
-    return { root, script, skill, poteto, second, pathFor, cli, fire, submit, read };
-}
-
-for (const host of ['claude', 'codex']) {
-    test(`${host}: configured invocation emits complete instructions, writes and reads back, restores without a path`, t => {
-        const f = fixture(t, host);
-        assert.equal(existsSync(f.pathFor('session-a')), false);
-        const prefix = host === 'codex' ? '$pstack:poteto-mode' : '/pstack:poteto-mode';
-        const prompt = `${prefix} for this entire session\nFinish the sample task. Keep changes local. Use second-skill for this task.`;
-        const output = f.submit('session-a', prompt);
-        assert.ok(output.systemMessage.includes(f.pathFor('session-a')));
-        const context = output.hookSpecificOutput.additionalContext;
-        assert.ok(context.includes(readFileSync(join(f.skill, 'SKILL.md'), 'utf8')));
-        assert.ok(context.includes(potetoText));
-        assert.ok(context.includes('Saved record read from disk:'));
-        let record = f.read('session-a');
-        assert.equal(record.requirements[0].scope, 'session');
-        assert.equal(record.requirements[0].source, f.poteto);
-        assert.equal(record.requirements[0].unavailable, null);
-        f.cli('update', 'session-a', {
-            expected_revision: record.revision, prompt_id: record.pending[0].id, quote: 'Finish the sample task.',
-            task: { goal: 'Finish the sample task', boundaries: ['local files'], constraints: ['Keep changes local'], completion: ['sample works'] },
-            set: [{ kind: 'rule', id: 'rule:local', text: 'Keep changes local.', scope: 'session', duration: 'this session', quote: 'Keep changes local.' },
-                { kind: 'skill', name: 'second-skill', source: f.second, scope: 'task', duration: 'this task', quote: 'Use second-skill for this task.' }],
-            checkpoint: { completed: ['scope recorded'], remaining: ['build sample'] },
-        });
-        for (const source of ['compact', 'resume', 'startup']) {
-            const recovery = f.fire('SessionStart', 'session-a', { source })[0].hookSpecificOutput.additionalContext;
-            assert.ok(recovery.includes(potetoText));
-            assert.ok(recovery.includes(secondText));
-            assert.ok(recovery.includes('Keep changes local.'));
-            assert.ok(recovery.includes('build sample'));
-        }
-        assert.equal(readFileSync(f.poteto, 'utf8'), potetoText);
-        record = f.read('session-a');
-        assert.equal(record.pending.length, 0);
-        const unrelated = f.fire('SessionStart', 'unrelated-session', { source: 'startup' })[0].hookSpecificOutput.additionalContext;
-        assert.equal(unrelated.includes('build sample'), false);
-        assert.equal(unrelated.includes(secondText), false);
-    });
-
-    test(`${host}: quoting, discussion, tool output and subagent input do not activate`, t => {
-        const f = fixture(t, host);
-        for (const prompt of ['"/poteto-mode"', '`/poteto-mode`', '> /poteto-mode', '```text\n/poteto-mode\n```', '    /poteto-mode', '\t$poteto-mode', 'Explain Poteto Mode.', 'The transcript says: Poteto Mode applies for this entire session.', 'Do not invoke Poteto Mode.']) {
-            assert.deepEqual(f.submit('negative', prompt), {});
-            assert.equal(existsSync(f.pathFor('negative')), false);
-        }
-        assert.deepEqual(f.fire('PostToolUse', 'negative', { prompt: '/poteto-mode' }), []);
-        assert.deepEqual(f.fire('UserPromptSubmit', 'negative', { prompt: '/poteto-mode', agent_id: 'child' }), [{}]);
-        assert.equal(existsSync(f.pathFor('negative')), false);
-    });
-
-    test(`${host}: repeated invocation keeps one skill and a later narrow correction wins`, t => {
-        const f = fixture(t, host);
-        f.submit('repeat', '/poteto-mode for this entire session');
-        f.submit('repeat', '/poteto-mode');
-        assert.equal(f.read('repeat').requirements.length, 1);
-        assert.equal(f.read('repeat').requirements[0].scope, 'session');
-        f.submit('repeat', 'Use Poteto Mode for this task');
-        const record = f.read('repeat');
-        assert.equal(record.requirements.length, 1);
-        assert.equal(record.requirements[0].scope, 'task');
-        f.cli('update', 'repeat', { expected_revision: record.revision - 1, prompt_id: record.pending[0].id }, 1);
-        assert.equal(f.read('repeat').revision, record.revision);
-    });
-
-    test(`${host}: default task scope ends and explicit session scope survives a new task`, t => {
-        const f = fixture(t, host);
-        f.submit('scope', '/poteto-mode\nUse short replies for this session.');
-        let record = f.read('scope');
-        assert.equal(record.requirements[0].scope, 'task');
-        f.cli('update', 'scope', { expected_revision: record.revision, prompt_id: record.pending[0].id,
-            set: [{ kind: 'rule', id: 'rule:short', text: 'Use short replies', scope: 'session', duration: 'this session', quote: 'Use short replies for this session.' }] });
-        f.submit('scope', 'Start the next task.');
-        record = f.read('scope');
-        f.cli('update', 'scope', { expected_revision: record.revision, prompt_id: record.pending[0].id, quote: 'Start the next task.', new_task: true,
-            task: { goal: 'next task', boundaries: [], constraints: [], completion: ['verified'] } });
-        const recovery = f.fire('SessionStart', 'scope', { source: 'compact' })[0].hookSpecificOutput.additionalContext;
-        assert.ok(recovery.includes('Use short replies'));
-        assert.equal(recovery.includes(potetoText), false);
-    });
-
-    test(`${host}: source changes are compared and missing sources never use remembered contents`, t => {
-        const f = fixture(t, host);
-        f.submit('source', '/poteto-mode');
-        writeFileSync(f.poteto, potetoText.replace('prove the requested result', 'inspect the current result'));
-        const changed = f.fire('SessionStart', 'source', { source: 'compact' })[0].hookSpecificOutput.additionalContext;
-        assert.ok(changed.includes('CHANGED skill'));
-        assert.ok(changed.includes('before_excerpt'));
-        assert.ok(changed.includes('inspect the current result'));
-        unlinkSync(f.poteto);
-        const missing = f.fire('SessionStart', 'source', { source: 'resume' })[0].hookSpecificOutput.additionalContext;
-        assert.ok(missing.includes('UNAVAILABLE skill'));
-        assert.equal(missing.includes('POTETO_SOURCE_EXPECTATION'), false);
-    });
-
-    test(`${host}: sessions in the same repository never select each other's newer record`, t => {
-        const f = fixture(t, host);
-        f.submit('a', '/poteto-mode for this task');
-        f.submit('b', '/poteto-mode for this entire session');
-        const old = new Date('2000-01-01');
-        utimesSync(f.pathFor('b'), old, old);
-        assert.notEqual(f.pathFor('a'), f.pathFor('b'));
-        assert.equal(f.cli('show', 'a').record.requirements[0].scope, 'task');
-        assert.equal(f.cli('show', 'b').record.requirements[0].scope, 'session');
-        assert.ok(f.fire('SessionStart', 'b', { source: 'resume' })[0].hookSpecificOutput.additionalContext.includes(f.pathFor('b')));
-    });
-
-    test(`${host}: deactivation survives compaction and restart; explicit invocation starts a fresh set`, t => {
-        const f = fixture(t, host);
-        f.submit('off', '/poteto-mode for this entire session');
-        const disabled = f.submit('off', '/session-continuity off');
-        assert.ok(disabled.systemMessage.includes('deactivated'));
-        if (host === 'claude') f.fire('UserPromptExpansion', 'off', { expansion_type: 'slash_command', command_name: 'session-continuity', prompt: '/session-continuity off' });
-        assert.equal(f.read('off').status, 'inactive');
-        assert.deepEqual(f.fire('SessionStart', 'off', { source: 'compact' }), [{}]);
-        assert.deepEqual(f.fire('SessionStart', 'off', { source: 'resume' }), [{}]);
-        assert.deepEqual(f.submit('off', 'Explain Poteto Mode.'), {});
-        f.submit('off', '/poteto-mode');
-        assert.equal(f.read('off').requirements.length, 1);
-        assert.equal(f.read('off').requirements[0].scope, 'task');
-        assert.equal(readFileSync(f.poteto, 'utf8'), potetoText);
-    });
-
-    test(`${host}: explicit handoff binds a fresh id and refuses an existing or deactivated target`, t => {
-        const f = fixture(t, host);
-        f.submit('from', '/poteto-mode for this entire session');
-        f.submit('from', 'Hand off this work to the new session.');
-        const source = f.read('from');
-        const data = { expected_revision: source.revision, prompt_id: source.pending.at(-1).id, quote: 'Hand off this work to the new session.', to_host: host, to_session_id: 'to' };
-        const result = f.cli('handoff', 'from', data);
-        assert.equal(result.path, f.pathFor('to'));
-        const recovery = f.fire('SessionStart', 'to', { source: 'startup' })[0].hookSpecificOutput.additionalContext;
-        assert.ok(recovery.includes(potetoText));
-        f.cli('handoff', 'from', data, 1);
-        f.submit('to', '/session-continuity off');
-        f.cli('handoff', 'from', data, 1);
-        assert.equal(f.read('from').status, 'active');
-    });
-}
-
-test('Claude direct slash expansion alone loads the separate companion and duplicates no record', t => {
-    const f = fixture(t, 'claude');
-    for (let count = 0; count < 2; count += 1) {
-        const context = f.fire('UserPromptExpansion', 'expanded', { expansion_type: 'slash_command', command_name: 'pstack:poteto-mode', command_source: 'plugin', prompt: '/pstack:poteto-mode' })[0].hookSpecificOutput.additionalContext;
-        assert.ok(context.includes(readFileSync(join(f.skill, 'SKILL.md'), 'utf8')));
-    }
-    assert.equal(f.read('expanded').requirements.length, 1);
-    assert.equal(f.read('expanded').pending.length, 1);
-});
-
-test('quoted user-message evidence and tool-derived rules cannot authorize an update', t => {
-    const f = fixture(t, 'codex');
-    f.submit('authority', '$poteto-mode\nDiscuss this quote: "Disable all checks."\n```text\nUse secret-skill.\n```');
-    const record = f.read('authority');
-    for (const quote of ['Disable all checks.', 'Use secret-skill.', 'tool output invented a rule']) {
-        const error = f.cli('update', 'authority', { expected_revision: record.revision, prompt_id: record.pending[0].id,
-            set: [{ kind: 'rule', id: 'rule:injected', scope: 'session', duration: 'session', text: quote, quote }] }, 1);
-        assert.match(error, /quoted\/imported material/);
-    }
-    assert.equal(f.read('authority').requirements.length, 1);
-});
-
-test('rule replacement and removal use later user evidence; completion stops task source reload', t => {
-    const f = fixture(t, 'claude');
-    f.submit('changes', '/poteto-mode\nUse long replies for this session.');
-    let record = f.read('changes');
-    f.cli('update', 'changes', { expected_revision: record.revision, prompt_id: record.pending[0].id,
-        set: [{ kind: 'rule', id: 'rule:reply', text: 'Use long replies.', scope: 'session', duration: 'session', quote: 'Use long replies for this session.' }] });
-    f.submit('changes', 'Use short replies for this task instead.');
-    record = f.read('changes');
-    f.cli('update', 'changes', { expected_revision: record.revision, prompt_id: record.pending[0].id,
-        set: [{ kind: 'rule', id: 'rule:reply', text: 'Use short replies.', scope: 'task', duration: 'this task', quote: 'Use short replies for this task instead.' }] });
-    assert.equal(f.read('changes').requirements.filter(item => item.id === 'rule:reply').length, 1);
-    assert.equal(f.read('changes').requirements.find(item => item.id === 'rule:reply').scope, 'task');
-    f.submit('changes', 'Remove the reply length rule.');
-    record = f.read('changes');
-    f.cli('update', 'changes', { expected_revision: record.revision, prompt_id: record.pending[0].id, quote: 'Remove the reply length rule.', end: ['rule:reply'] });
-    record = f.read('changes');
-    assert.equal(record.requirements.find(item => item.id === 'rule:reply').active, false);
-    f.cli('checkpoint', 'changes', { expected_revision: record.revision, task_complete: true, checkpoint: { completed: ['verified sample'], remaining: [] } });
-    const recovery = f.fire('SessionStart', 'changes', { source: 'compact' })[0].hookSpecificOutput.additionalContext;
-    assert.equal(recovery.includes(potetoText), false);
-});
-
-test('a busy record blocks prompt processing, preserves state, and supports a safe retry', t => {
-    const f = fixture(t, 'claude');
-    f.submit('busy', '/poteto-mode');
-    const before = readFileSync(f.pathFor('busy'), 'utf8');
-    writeFileSync(f.pathFor('busy') + '.lock', 'test-writer');
-    const blocked = f.submit('busy', 'Use short replies for this session.');
-    assert.equal(blocked.decision, 'block');
-    assert.match(blocked.reason, /Record busy/);
-    assert.equal(readFileSync(f.pathFor('busy'), 'utf8'), before);
-    unlinkSync(f.pathFor('busy') + '.lock');
-    f.submit('busy', 'Use short replies for this session.');
-    assert.equal(f.read('busy').pending.length, 2);
-});
-
-test('clear drops a reused host id rather than inheriting an unrelated task', t => {
-    const f = fixture(t, 'claude');
-    f.submit('clear', '/poteto-mode for this entire session\nKeep the sample local.');
-    const before = f.read('clear');
-    f.fire('SessionStart', 'clear', { source: 'clear' });
-    const record = f.read('clear');
-    assert.equal(record.status, 'active');
-    assert.notEqual(record.task.id, before.task.id);
-    assert.deepEqual(record.pending, []);
-    assert.deepEqual(record.requirements.map(entry => entry.id), ['skill:pstack:poteto-mode']);
-    assert.equal(record.requirements[0].automatic, true);
-});
-
-for (const host of ['claude', 'codex']) {
-    test(`${host}: session start and compaction activate Poteto Mode with no explicit invocation`, t => {
-        const f = fixture(t, host);
-        const started = f.fire('SessionStart', 'auto', { source: 'startup' })[0];
-        assert.ok(started.systemMessage.includes(f.pathFor('auto')));
-        assert.ok(started.hookSpecificOutput.additionalContext.includes(potetoText));
-        const record = f.read('auto');
-        assert.equal(record.requirements.length, 1);
-        assert.equal(record.requirements[0].scope, 'session');
-        assert.equal(record.requirements[0].automatic, true);
-        assert.equal(record.requirements[0].source, f.poteto);
-        assert.deepEqual(record.pending, []);
-        for (const source of ['compact', 'resume']) {
-            const later = f.fire('SessionStart', 'auto', { source })[0].hookSpecificOutput.additionalContext;
-            assert.ok(later.includes(potetoText));
-        }
-        assert.equal(f.read('auto').revision, record.revision);
-        f.submit('auto', '/session-continuity off');
-        assert.deepEqual(f.fire('SessionStart', 'auto', { source: 'compact' }), [{}]);
-        assert.deepEqual(f.fire('SessionStart', 'auto', { source: 'startup' }), [{}]);
-    });
-
-    test(`${host}: session start accepts an unrelated display name from the canonical Poteto path`, t => {
-        const f = fixture(t, host);
-        writeFileSync(f.poteto, '---\nname: Concise Session Style\n---\nPOTETO_SOURCE_EXPECTATION: prove the requested result.\n');
-        const started = f.fire('SessionStart', 'unrelated-display-name', { source: 'startup' })[0];
-        assert.ok(started.hookSpecificOutput, started.systemMessage);
-        assert.ok(started.hookSpecificOutput.additionalContext.includes('POTETO_SOURCE_EXPECTATION'));
-    });
-
-    test(`${host}: a missing Poteto source stops automatic activation without writing a record`, t => {
-        const f = fixture(t, host);
-        unlinkSync(f.poteto);
-        const started = f.fire('SessionStart', 'missing-source', { source: 'startup' })[0];
-        assert.match(started.systemMessage, /did not activate Poteto Mode/);
-        assert.equal(existsSync(f.pathFor('missing-source')), false);
-    });
-}
-
-test('cursor: session start injects Poteto Mode and compaction reloads it on the next tool result', t => {
-    const f = fixture(t, 'cursor');
-    const started = f.fire('sessionStart', 'cursor-a', { session_id: 'composer-1', composer_mode: 'agent' })[0];
-    assert.ok(started.additional_context.includes(potetoText));
-    assert.equal(f.read('cursor-a').requirements[0].automatic, true);
-    assert.deepEqual(f.fire('postToolUse', 'cursor-a', { tool_name: 'Shell' }), [{}]);
-    const compacting = f.fire('preCompact', 'cursor-a', { trigger: 'auto' })[0];
-    assert.ok(compacting.user_message.includes('Poteto Mode'));
-    assert.equal(f.read('cursor-a').reload_pending, true);
-    const reloaded = f.fire('postToolUse', 'cursor-a', { tool_name: 'Shell' })[0];
-    assert.ok(reloaded.additional_context.includes(potetoText));
-    assert.ok(reloaded.additional_context.includes(f.pathFor('cursor-a')));
-    assert.equal(f.read('cursor-a').reload_pending, false);
-    assert.deepEqual(f.fire('postToolUse', 'cursor-a', { tool_name: 'Shell' }), [{}]);
-});
-
-test('cursor: a prompt records evidence, never blocks submission, and reloads named skills after a tool result', t => {
-    const f = fixture(t, 'cursor');
-    f.fire('sessionStart', 'cursor-b', { session_id: 'composer-2' });
-    const submitted = f.fire('beforeSubmitPrompt', 'cursor-b', { prompt: 'Finish the sample task.', generation_id: 'gen-1' })[0];
-    assert.equal(submitted.continue, true);
-    assert.equal(f.read('cursor-b').pending.length, 1);
-    const invoked = f.fire('beforeSubmitPrompt', 'cursor-b', { prompt: '/poteto-mode for this entire session', generation_id: 'gen-2' })[0];
-    assert.equal(invoked.continue, true);
-    assert.equal(f.read('cursor-b').reload_pending, true);
-    assert.ok(f.fire('postToolUse', 'cursor-b', { tool_name: 'Read' })[0].additional_context.includes(potetoText));
-    const off = f.fire('beforeSubmitPrompt', 'cursor-b', { prompt: '/session-continuity off', generation_id: 'gen-3' })[0];
-    assert.equal(off.continue, true);
-    assert.equal(f.read('cursor-b').status, 'inactive');
-    assert.deepEqual(f.fire('sessionStart', 'cursor-b', { session_id: 'composer-2' }), [{}]);
-    assert.deepEqual(f.fire('preCompact', 'cursor-b', { trigger: 'manual' }), [{}]);
-});
-
-test('missing host identity and corrupt records produce visible recovery failures', t => {
-    const f = fixture(t, 'codex');
-    const missing = f.fire('UserPromptSubmit', '', { prompt: '$poteto-mode' })[0];
-    assert.equal(missing.decision, 'block');
-    f.submit('corrupt', '$poteto-mode');
-    writeFileSync(f.pathFor('corrupt'), '{bad json');
-    const failure = f.fire('SessionStart', 'corrupt', { source: 'resume' })[0];
-    assert.match(failure.systemMessage, /Session continuity failed/);
-    assert.match(failure.hookSpecificOutput.additionalContext, /Stop dependent work/);
-});
-
-for (const host of ['claude', 'codex']) {
-    test(`${host}: two simultaneous configured callbacks keep distinct session records`, async t => {
-        const f = fixture(t, host);
-        const configuration = continuityHookConfiguration(host, f.script);
-        const command = configuration.UserPromptSubmit[0].hooks[0].command;
-        const fire = (session, scope) => new Promise((resolve, reject) => {
-            const env = { ...process.env };
-            delete env.CDE_CONTINUITY_ROOT;
-            delete env.CDE_POTETO_SOURCE;
-            const child = spawn(command, { shell: true, env });
-            let stdout = '';
-            let stderr = '';
-            child.stdout.on('data', chunk => { stdout += chunk; });
-            child.stderr.on('data', chunk => { stderr += chunk; });
-            child.on('error', reject);
-            child.on('close', code => code ? reject(new Error(stderr)) : resolve(JSON.parse(stdout)));
-            child.stdin.end(JSON.stringify({ hook_event_name: 'UserPromptSubmit', session_id: session, cwd: f.root, prompt: `/poteto-mode for this ${scope}` }));
-        });
-        await Promise.all([fire('parallel-a', 'task'), fire('parallel-b', 'entire session')]);
-        assert.equal(f.read('parallel-a').requirements[0].scope, 'task');
-        assert.equal(f.read('parallel-b').requirements[0].scope, 'session');
-        assert.notEqual(f.pathFor('parallel-a'), f.pathFor('parallel-b'));
-    });
-}
-
-test('a new explicit invocation after task completion starts a distinct task without restoring ended rules', t => {
-    const f = fixture(t, 'claude');
-    f.submit('completed', '/poteto-mode');
-    const before = f.read('completed');
-    f.cli('checkpoint', 'completed', { expected_revision: before.revision, task_complete: true, checkpoint: { completed: ['verified'], remaining: [] } });
-    const output = f.submit('completed', '/poteto-mode');
-    assert.notEqual(f.read('completed').task.id, before.task.id);
-    assert.equal(f.read('completed').task.completed, false);
-    assert.ok(output.hookSpecificOutput.additionalContext.includes(potetoText));
-});

package/bin/install-session-continuity.mjs

@@ -1,131 +0,0 @@
-import { existsSync, readFileSync, realpathSync, renameSync, writeFileSync } from 'node:fs';
-import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const supportedHosts = ['claude', 'codex', 'cursor'];
-
-export function continuityHookConfiguration(host, script) {
-    if (!supportedHosts.includes(host)) throw new Error(`Unsupported host ${host}`);
-    if (/[\r\n"`$%]/.test(script)) throw new Error('Hook script path contains shell expansion characters');
-    const command = `node "${script.replace(/\\/g, '/')}" hook ${host}`;
-    if (host === 'cursor') {
-        return Object.fromEntries(['sessionStart', 'beforeSubmitPrompt', 'preCompact', 'postToolUse'].map(event => [event, [{ command }]]));
-    }
-    const events = host === 'claude' ? ['UserPromptSubmit', 'UserPromptExpansion', 'SessionStart'] : ['UserPromptSubmit', 'SessionStart'];
-    return Object.fromEntries(events.map(event => [event, [{
-        ...(event === 'SessionStart' ? { matcher: host === 'claude' ? 'startup|resume|compact|clear|fork' : 'startup|resume|compact|clear' } : {}),
-        ...(event === 'UserPromptExpansion' ? { matcher: '^(pstack:)?poteto-mode$|^(claude-dev-env:)?session-continuity$' } : {}),
-        hooks: [{ type: 'command', command, timeout: 10 }],
-    }]]));
-}
-
-export function mergeContinuityHooks(existing, host, script) {
-    const additions = continuityHookConfiguration(host, script);
-    const mergedConfiguration = structuredClone(existing);
-    if (host === 'cursor') mergedConfiguration.version = 1;
-    mergedConfiguration.hooks ||= {};
-    for (const [event, groups] of Object.entries(additions)) {
-        const current = mergedConfiguration.hooks[event] || [];
-        const command = host === 'cursor' ? groups[0].command : groups[0].hooks[0].command;
-        for (const entry of current) {
-            for (const hook of entry.hooks || [entry]) {
-                if (hook.command?.includes('/session-continuity/continuity.mjs') && hook.command !== command) {
-                    throw new Error('Another continuity installation owns this host config. Select its profile or remove that installation explicitly.');
-                }
-            }
-        }
-        const kept = current.flatMap(entry => {
-            if (host === 'cursor') return entry.command === command ? [] : [entry];
-            const hooks = (entry.hooks || []).filter(hook => hook.command !== command);
-            return hooks.length ? [{ ...entry, hooks }] : [];
-        });
-        mergedConfiguration.hooks[event] = kept.concat(groups);
-    }
-    return mergedConfiguration;
-}
-
-export const CONTINUITY_SCRIPT_MARKER = '/session-continuity/continuity.mjs';
-
-export function isContinuityHookCommand(command) {
-    return typeof command === 'string' && command.includes(CONTINUITY_SCRIPT_MARKER);
-}
-
-export function continuityScriptPath(roots) {
-    return join(roots.skillsInstallDirectory, 'session-continuity', 'continuity.mjs');
-}
-
-export function continuityHostConfigurationPaths(roots) {
-    return {
-        claude: join(roots.managedRoot, 'settings.json'),
-        codex: join(dirname(roots.codexRulesInstallDirectory), 'hooks.json'),
-        cursor: join(roots.cursorInstallDirectory, 'hooks.json'),
-    };
-}
-
-export function removeContinuityHooks(configuration) {
-    let removedCount = 0;
-    for (const [event, entries] of Object.entries(configuration.hooks || {})) {
-        const kept = entries.flatMap(entry => {
-            if (!entry.hooks) {
-                if (!isContinuityHookCommand(entry.command)) return [entry];
-                removedCount += 1;
-                return [];
-            }
-            const hooks = entry.hooks.filter(hook => !isContinuityHookCommand(hook.command));
-            removedCount += entry.hooks.length - hooks.length;
-            return hooks.length ? [{ ...entry, hooks }] : [];
-        });
-        if (kept.length) configuration.hooks[event] = kept;
-        else delete configuration.hooks[event];
-    }
-    return removedCount;
-}
-
-function continuityConfigurationPlan(host, path, script) {
-    if (!existsSync(dirname(path))) throw new Error(`Host config directory is absent: ${dirname(path)}`);
-    const existing = existsSync(path) ? readFileSync(path, 'utf8') : null;
-    const merged = mergeContinuityHooks(existing ? JSON.parse(existing) : {}, host, script);
-    return { host, path, existing, content: JSON.stringify(merged, null, 2) + '\n' };
-}
-
-function applyContinuityConfigurationPlan(plan) {
-    if (plan.existing === plan.content) return { host: plan.host, path: plan.path, changed: false };
-    if (plan.existing !== null) {
-        const backup = `${plan.path}.before-session-continuity`;
-        if (!existsSync(backup)) writeFileSync(backup, plan.existing, { flag: 'wx', mode: 0o600 });
-    }
-    const current = existsSync(plan.path) ? readFileSync(plan.path, 'utf8') : null;
-    if (current !== plan.existing) throw new Error(`Config changed during setup: ${plan.path}. Rerun setup.`);
-    const temporary = `${plan.path}.continuity-${process.pid}.tmp`;
-    writeFileSync(temporary, plan.content, { flag: 'wx', mode: 0o600 });
-    renameSync(temporary, plan.path);
-    if (readFileSync(plan.path, 'utf8') !== plan.content) throw new Error(`Config read-back mismatch: ${plan.path}`);
-    return { host: plan.host, path: plan.path, changed: true };
-}
-
-export function configureContinuityHosts(roots, selected) {
-    const unsupported = selected.find(host => !supportedHosts.includes(host));
-    if (unsupported) throw new Error(`Unsupported host ${unsupported}`);
-    const script = continuityScriptPath(roots);
-    if (!existsSync(script) || !existsSync(join(dirname(script), 'SKILL.md'))) {
-        throw new Error('Run the full claude-dev-env installer from this checkout first so the companion is in the canonical agents home.');
-    }
-    const paths = continuityHostConfigurationPaths(roots);
-    return selected
-        .map(host => continuityConfigurationPlan(host, paths[host], script))
-        .map(applyContinuityConfigurationPlan);
-}
-
-async function main() {
-    const requested = process.argv.slice(2);
-    const selected = requested.length ? requested : supportedHosts;
-    const { resolveInstallRoot } = await import('./resolve-install-root.mjs');
-    for (const result of configureContinuityHosts(resolveInstallRoot(), selected)) {
-        console.log(`${result.changed ? 'Configured and read back' : 'Already configured'}: ${result.path}`);
-    }
-    console.log('Review and trust the new hooks in each host.');
-}
-
-if (process.argv[1] && resolve(realpathSync(process.argv[1])) === fileURLToPath(import.meta.url)) {
-    main().catch(error => { console.error(error.message); process.exitCode = 1; });
-}

package/bin/install-session-continuity.test.mjs

@@ -1,106 +0,0 @@
-import assert from 'node:assert/strict';
-import test from 'node:test';
-import { mkdirSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import {
-    configureContinuityHosts,
-    continuityHookConfiguration,
-    mergeContinuityHooks,
-    removeContinuityHooks,
-} from './install-session-continuity.mjs';
-
-function installRootFixture() {
-    const root = mkdtempSync(join(tmpdir(), 'continuity-roots-'));
-    const skillsInstallDirectory = join(root, 'agents', 'skills');
-    const companionDirectory = join(skillsInstallDirectory, 'session-continuity');
-    mkdirSync(companionDirectory, { recursive: true });
-    writeFileSync(join(companionDirectory, 'continuity.mjs'), 'export default null;\n');
-    writeFileSync(join(companionDirectory, 'SKILL.md'), '# companion\n');
-    const managedRoot = join(root, 'claude');
-    const codexRulesInstallDirectory = join(root, 'codex', 'rules');
-    const cursorInstallDirectory = join(root, 'cursor');
-    for (const directory of [managedRoot, codexRulesInstallDirectory, cursorInstallDirectory]) {
-        mkdirSync(directory, { recursive: true });
-    }
-    return { managedRoot, skillsInstallDirectory, codexRulesInstallDirectory, cursorInstallDirectory };
-}
-
-test('setup preserves other hooks and settings, is idempotent, and rejects competing profiles', () => {
-    const existing = { permissions: { deny: ['secret'] }, hooks: { SessionStart: [{ hooks: [{ type: 'command', command: 'existing-hook' }] }] } };
-    const script = '/home/jon/.agents/skills/session-continuity/continuity.mjs';
-    const first = mergeContinuityHooks(existing, 'claude', script);
-    assert.deepEqual(mergeContinuityHooks(first, 'claude', script), first);
-    assert.deepEqual(first.permissions, existing.permissions);
-    assert.equal(first.hooks.SessionStart[0].hooks[0].command, 'existing-hook');
-    assert.equal(existing.hooks.SessionStart.length, 1);
-    assert.throws(() => mergeContinuityHooks(first, 'claude', '/other/session-continuity/continuity.mjs'), /Another continuity installation/);
-    assert.throws(() => continuityHookConfiguration('claude', '/path/with$expansion/continuity.mjs'), /expansion/);
-});
-
-test('Cursor setup keeps other hooks, sets the file version, and stays idempotent', () => {
-    const existing = { hooks: { beforeShellExecution: [{ command: 'existing' }] } };
-    const script = '/home/jon/.agents/skills/session-continuity/continuity.mjs';
-    const first = mergeContinuityHooks(existing, 'cursor', script);
-    assert.equal(first.version, 1);
-    assert.equal(first.hooks.beforeShellExecution[0].command, 'existing');
-    assert.deepEqual(mergeContinuityHooks(first, 'cursor', script), first);
-    assert.equal(existing.hooks.beforeShellExecution.length, 1);
-    assert.throws(() => mergeContinuityHooks(first, 'cursor', '/other/session-continuity/continuity.mjs'), /Another continuity installation/);
-});
-
-test('Cursor setup registers only documented context-carrying events', () => {
-    const configuration = continuityHookConfiguration('cursor', '/home/jon/.agents/skills/session-continuity/continuity.mjs');
-    assert.deepEqual(Object.keys(configuration), ['sessionStart', 'beforeSubmitPrompt', 'preCompact', 'postToolUse']);
-    for (const entries of Object.values(configuration)) {
-        assert.equal(entries.length, 1);
-        assert.equal(entries[0].command, 'node "/home/jon/.agents/skills/session-continuity/continuity.mjs" hook cursor');
-    }
-});
-
-for (const host of ['claude', 'codex']) {
-    test(`${host}: setup registers only documented context-loading events`, () => {
-        const configuration = continuityHookConfiguration(host, '/home/jon/.agents/skills/session-continuity/continuity.mjs');
-        const expected = host === 'claude'
-            ? ['UserPromptSubmit', 'UserPromptExpansion', 'SessionStart']
-            : ['UserPromptSubmit', 'SessionStart'];
-        assert.deepEqual(Object.keys(configuration), expected);
-        for (const groups of Object.values(configuration)) {
-            assert.equal(groups.length, 1);
-            assert.equal(groups[0].hooks[0].type, 'command');
-            assert.equal(groups[0].hooks[0].command, `node "/home/jon/.agents/skills/session-continuity/continuity.mjs" hook ${host}`);
-        }
-        assert.equal(new RegExp(configuration.SessionStart[0].matcher).test('compact'), true);
-        if (host === 'claude') {
-            assert.equal(new RegExp(configuration.UserPromptExpansion[0].matcher).test('pstack:poteto-mode'), true);
-            assert.equal(new RegExp(configuration.UserPromptExpansion[0].matcher).test('explain-poteto-mode'), false);
-        }
-    });
-}
-
-test('configureContinuityHosts writes each host config, reads it back, and repeats without a change', () => {
-    const roots = installRootFixture();
-    const settingsPath = join(roots.managedRoot, 'settings.json');
-    writeFileSync(settingsPath, JSON.stringify({ permissions: { deny: ['secret'] } }, null, 2) + '\n');
-    const first = configureContinuityHosts(roots, ['claude', 'codex', 'cursor']);
-    assert.deepEqual(first.map(result => result.changed), [true, true, true]);
-    const written = JSON.parse(readFileSync(settingsPath, 'utf8'));
-    assert.deepEqual(written.permissions.deny, ['secret']);
-    const command = written.hooks.SessionStart[0].hooks[0].command;
-    assert.equal(command.endsWith('session-continuity/continuity.mjs" hook claude'), true);
-    const second = configureContinuityHosts(roots, ['claude', 'codex', 'cursor']);
-    assert.deepEqual(second.map(result => result.changed), [false, false, false]);
-});
-
-test('removeContinuityHooks takes out only the companion registrations', () => {
-    const roots = installRootFixture();
-    configureContinuityHosts(roots, ['claude']);
-    const settingsPath = join(roots.managedRoot, 'settings.json');
-    const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
-    settings.hooks.SessionStart.unshift({ hooks: [{ type: 'command', command: 'python other_hook.py' }] });
-    const removedCount = removeContinuityHooks(settings);
-    assert.equal(removedCount, 3);
-    assert.deepEqual(Object.keys(settings.hooks), ['SessionStart']);
-    assert.equal(settings.hooks.SessionStart.length, 1);
-    assert.equal(settings.hooks.SessionStart[0].hooks[0].command, 'python other_hook.py');
-});