/** Profile patch edits preserve user-authored syntax and are idempotent. */ import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises' import { join } from 'node:path' import { tmpdir } from 'node:os' import { expect, it, onTestFinished } from 'vitest' import { applyEntryPatches } from '@deepseek-ai/cordis-plugin-include' import { initProfile, loadOptionalPatches, type ProfileContext } from '@deepseek-ai/dsh-app-boot' import { prepareBundleConfiguration, writePluginEnabled } from '../src/patch.ts' const TOOL = { id: 'tool', name: 'package' } it('prepares durable activation settings while preserving prior fields, expressions and comments', async () => { const profile = await fixture('# personal\n- id: runtime\n config:\n timeout: 42\n command: !!js process.execPath\n- id: locale\n config: { preference: zh }\n', [ { id: 'runtime', name: 'runtime-package', config: { executionMode: 'per-call' } }, { id: 'presets', name: 'preset-package', config: { default: 'standard' } }, { id: 'locale', name: 'locale-package' }, ]) const before = await readFile(profile.patchPath, 'utf8') const input = { runtime: { executionMode: 'persistent-in-memory' }, presets: { selectedDefault: 'ptc' } } const prepared = await prepareBundleConfiguration(profile, input) expect(await readFile(profile.patchPath, 'utf8')).toBe(before) expect(prepared).toContain('# personal') expect(prepared).toContain('!!js process.execPath') if (prepared === undefined) throw new Error('Expected changed enablement settings') await writeFile(profile.patchPath, prepared) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([ { id: 'runtime', config: { timeout: 42, command: { __jsExpr: 'process.execPath' }, executionMode: 'persistent-in-memory' } }, { id: 'locale', config: { preference: 'zh' } }, { id: 'presets', name: 'preset-package', config: { default: 'standard', selectedDefault: 'ptc' } }, ]) expect(await prepareBundleConfiguration(profile, input)).toBeUndefined() }) it('accepts unrelated launch overrides when the requested field has the intended effective value', async () => { const profile = await fixture('[]\n', [{ id: 'runtime', name: 'runtime-package', config: { timeout: 42 } }]) const launch = { ...profile, overlays: [{ id: 'runtime', config: { executionMode: 'persistent-in-memory', timeout: 10 } }] } const prepared = await prepareBundleConfiguration(launch, { runtime: { executionMode: 'persistent-in-memory' } }) if (prepared === undefined) throw new Error('Expected saved runtime configuration') await writeFile(profile.patchPath, prepared) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([ { id: 'runtime', name: 'runtime-package', config: { timeout: 42, executionMode: 'persistent-in-memory' } }, ]) }) it('refuses a whole-config expression without evaluating it or replacing the user patch', async () => { const before = '- id: runtime\n config: !!js "(() => { throw new Error(\'must not evaluate\') })()"\n' const profile = await fixture(before, [{ id: 'runtime', name: 'runtime-package' }]) await expect(prepareBundleConfiguration(profile, { runtime: { executionMode: 'persistent-in-memory' } })) .rejects.toThrow('Bundle enablement cannot edit the whole-config expression for "runtime"; use a literal config mapping') expect(await readFile(profile.patchPath, 'utf8')).toBe(before) }) it('replaces a target field expression while preserving unrelated expressions', async () => { const profile = await fixture('- id: runtime\n config:\n executionMode: !!js process.env.MODE\n timeout: !!js process.env.TIMEOUT\n', [ { id: 'runtime', name: 'runtime-package' }, ]) const prepared = await prepareBundleConfiguration(profile, { runtime: { executionMode: 'persistent-in-memory' } }) expect(prepared).toContain('executionMode: persistent-in-memory') expect(prepared).toContain('timeout: !!js process.env.TIMEOUT') expect(prepared).not.toContain('process.env.MODE') }) it('retains configuration anchors referenced by other entries', async () => { const profile = await fixture('- id: runtime\n config: &runtimeConfig\n timeout: &timeout 30000\n- id: other\n config:\n timeout: *timeout\n inherited: *runtimeConfig\n', [ { id: 'runtime', name: 'runtime-package' }, { id: 'other', name: 'other-package' }, ]) const prepared = await prepareBundleConfiguration(profile, { runtime: { executionMode: 'persistent-in-memory' } }) if (prepared === undefined) throw new Error('Expected activation settings') await writeFile(profile.patchPath, prepared) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([ { id: 'runtime', config: { timeout: 30000 } }, { id: 'other', config: { timeout: 30000, inherited: { timeout: 30000 } } }, { id: 'runtime', name: 'runtime-package', config: { timeout: 30000, executionMode: 'persistent-in-memory' } }, ]) expect(await prepareBundleConfiguration(profile, { runtime: { executionMode: 'persistent-in-memory' } })).toBeUndefined() }) it.each(['runtime-package', 'retired-runtime'])('keeps name-qualified activation overrides for %s', async (name) => { const profile = await fixture(`- id: runtime\n name: ${name}\n config: { timeout: 42 }\n`, [ { id: 'runtime', name: 'runtime-package', config: { timeout: 10 } }, ]) const prepared = await prepareBundleConfiguration(profile, { runtime: { executionMode: 'persistent-in-memory' } }) if (prepared === undefined) throw new Error('Expected activation settings') await writeFile(profile.patchPath, prepared) const patch = { id: 'runtime', name: 'runtime-package', config: { timeout: name === 'runtime-package' ? 42 : 10, executionMode: 'persistent-in-memory', } } expect(loadOptionalPatches('test', profile.patchPath)).toEqual(name === 'runtime-package' ? [patch] : [ { id: 'runtime', name, config: { timeout: 42 } }, patch, ]) }) it('refuses invalid activation settings, absent entries and higher-layer overrides before writing', async () => { const profile = await fixture('[]\n', [{ id: 'runtime', name: 'runtime-package', config: {} }]) for (const input of [[], { runtime: false }, { absent: { mode: 'new' } }]) { await expect(prepareBundleConfiguration(profile, input)).rejects.toThrow() expect(await readFile(profile.patchPath, 'utf8')).toBe('[]\n') } await writeFile(join(profile.home, 'cordis.patch.yml'), '- id: runtime\n config: { executionMode: per-call }\n') await expect(prepareBundleConfiguration(profile, { runtime: { executionMode: 'persistent-in-memory' } })).rejects.toThrow('overridden') expect(await readFile(profile.patchPath, 'utf8')).toBe('[]\n') }) /** Create a profile whose patch file holds `text` (none when omitted) and whose one selected bundle inserts `rows`. */ async function fixture(text?: string, rows: object[] = []): Promise { const home = await mkdtemp(join(tmpdir(), 'manager-patch-')) onTestFinished(() => rm(home, { recursive: true, force: true })) const dir = join(home, 'profile') const installAnchor = join(home, 'package.json') await writeFile(installAnchor, '{"name":"installation","dependencies":{}}') initProfile(dir, ['bundle']) const bundle = join(dir, 'node_modules', 'bundle') await mkdir(bundle, { recursive: true }) await writeFile(join(bundle, 'package.json'), JSON.stringify({ name: 'bundle', version: '1.0.0', dsh: { bundle: { patch: './cordis.patch.yml' } } })) await writeFile(join(bundle, 'cordis.patch.yml'), JSON.stringify([{ insert: rows }])) const patchPath = join(dir, 'cordis.patch.yml') await (text === undefined ? rm(patchPath) : writeFile(patchPath, text)) return { name: 'test', dir, patchPath, installAnchor, cwd: home, home, startedBundles: ['bundle'], overlays: [], telemetryDisabledEnv: undefined } } it('preserves comments, expressions, unrelated configuration and the last override', async () => { const profile = await fixture('# personal configuration\n- id: tool\n config:\n value: !!js process.platform\n- id: tool\n disabled: false # availability\n') expect(await writePluginEnabled(profile, 'tool', 'package', false)).toBe(true) const text = await readFile(profile.patchPath, 'utf8') expect(text).toContain('# personal configuration') expect(text).toContain('!!js process.platform') expect(text).toContain('# availability') expect(loadOptionalPatches('test', profile.patchPath)).toEqual([ { id: 'tool', config: { value: { __jsExpr: 'process.platform' } } }, { id: 'tool', disabled: true }, ]) expect(await writePluginEnabled(profile, 'tool', 'package', false)).toBe(false) expect(await readFile(profile.patchPath, 'utf8')).toBe(text) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) }) it('creates a missing patch file and appends after insertions', async () => { const profile = await fixture() await writePluginEnabled(profile, 'tool', 'package', false) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([{ id: 'tool', disabled: true }]) await writeFile(profile.patchPath, '- insert:\n - id: tool\n name: package\n') await writePluginEnabled(profile, 'tool', 'package', false) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([ { insert: [{ id: 'tool', name: 'package' }] }, { id: 'tool', disabled: true }, ]) }) it.each(['- id: [broken', 'mapping: true\n'])('refuses malformed documents without overwriting %s', async (text) => { const profile = await fixture(text) await expect(writePluginEnabled(profile, 'tool', 'package', true)).rejects.toThrow() expect(await readFile(profile.patchPath, 'utf8')).toBe(text) }) it('retains name-asserting overrides and appends an unambiguous switch', async () => { const profile = await fixture('- id: tool\n name: another-package\n disabled: false\n') await writePluginEnabled(profile, 'tool', 'package', false) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([ { id: 'tool', name: 'another-package', disabled: false }, { id: 'tool', disabled: true }, ]) expect(await writePluginEnabled(profile, 'tool', 'package', false)).toBe(false) }) it('reports read failures without replacing a directory with configuration', async () => { const profile = await fixture() await mkdir(profile.patchPath) await expect(writePluginEnabled(profile, 'tool', 'package', true)).rejects.toThrow() }) it('updates the last matching named override and leaves mismatched names untouched', async () => { const profile = await fixture('- id: tool\n disabled: true\n- id: tool\n name: package\n config:\n value: !!js process.platform\n disabled: true # availability\n- id: tool\n name: another-package\n disabled: true\n') expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) const text = await readFile(profile.patchPath, 'utf8') expect(text).toContain('!!js process.platform') expect(text).toContain('# availability') const patches = loadOptionalPatches('test', profile.patchPath) expect(patches).toEqual([ { id: 'tool', disabled: true }, { id: 'tool', name: 'package', config: { value: { __jsExpr: 'process.platform' } }, disabled: false }, { id: 'tool', name: 'another-package', disabled: true }, ]) expect(applyEntryPatches([{ id: 'tool', name: 'package' }], patches, () => {})) .toMatchObject([{ id: 'tool', name: 'package', disabled: false }]) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(false) expect(await readFile(profile.patchPath, 'utf8')).toBe(text) expect(await writePluginEnabled(profile, 'tool', 'package', false)).toBe(true) expect(loadOptionalPatches('test', profile.patchPath)).toHaveLength(3) }) it('removes or omits a plain switch that restates the bundle layers', async () => { const profile = await fixture('# personal configuration\n- id: other\n disabled: true\n- id: tool\n disabled: true\n', [TOOL]) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) expect(await readFile(profile.patchPath, 'utf8')).toBe('# personal configuration\n- id: other\n disabled: true\n') expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(false) expect(await readFile(profile.patchPath, 'utf8')).toBe('# personal configuration\n- id: other\n disabled: true\n') expect(await writePluginEnabled(profile, 'tool', 'package', false)).toBe(true) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([{ id: 'other', disabled: true }, { id: 'tool', disabled: true }]) }) it('keeps a switch that carries other settings or differs from the bundle layers', async () => { const profile = await fixture('- id: tool\n config: { value: 1 }\n disabled: true\n', [TOOL]) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([{ id: 'tool', config: { value: 1 }, disabled: false }]) const plain = await fixture('- id: tool\n disabled: true\n', [{ ...TOOL, disabled: true }]) expect(await writePluginEnabled(plain, 'tool', 'package', true)).toBe(true) expect(loadOptionalPatches('test', plain.patchPath)).toEqual([{ id: 'tool', disabled: false }]) }) it('keeps the comment above a removed switch and prunes a switch the composition already implies', async () => { const profile = await fixture('# header\n- id: tool\n disabled: false\n# other\n- id: other\n disabled: true\n', [TOOL]) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) expect(await readFile(profile.patchPath, 'utf8')).toBe('# header\n# other\n- id: other\n disabled: true\n') const first = await fixture('# header\n- id: tool\n disabled: true\n- id: other\n disabled: true\n', [TOOL]) expect(await writePluginEnabled(first, 'tool', 'package', true)).toBe(true) expect(await readFile(first.patchPath, 'utf8')).toBe('# header\n- id: other\n disabled: true\n') const only = await fixture('# header\n- id: tool\n disabled: true\n', [TOOL]) expect(await writePluginEnabled(only, 'tool', 'package', true)).toBe(true) expect(loadOptionalPatches('test', only.patchPath)).toEqual([]) expect(await readFile(only.patchPath, 'utf8')).toBe('# header\n[]\n') const last = await fixture('- id: other\n disabled: true\n# about tool\n- id: tool\n disabled: true\n', [TOOL]) expect(await writePluginEnabled(last, 'tool', 'package', true)).toBe(true) expect(await readFile(last.patchPath, 'utf8')).toBe('- id: other\n disabled: true\n\n# about tool\n') const lastWithTail = await fixture('- id: other\n disabled: true\n# about tool\n- id: tool\n disabled: true\n# tail\n', [TOOL]) expect(await writePluginEnabled(lastWithTail, 'tool', 'package', true)).toBe(true) expect(await readFile(lastWithTail.patchPath, 'utf8')).toBe('- id: other\n disabled: true\n\n# about tool\n# tail\n') const trailing = await fixture('- id: tool\n disabled: true # removed\n# tail\n', [TOOL]) expect(await writePluginEnabled(trailing, 'tool', 'package', true)).toBe(true) expect(loadOptionalPatches('test', trailing.patchPath)).toEqual([]) expect(await readFile(trailing.patchPath, 'utf8')).toContain('# tail') const both = await fixture('# header\n- id: tool\n disabled: true\n# tail\n', [TOOL]) expect(await writePluginEnabled(both, 'tool', 'package', true)).toBe(true) expect(await readFile(both.patchPath, 'utf8')).toBe('# header\n[]\n\n# tail\n') }) it('treats insertions in the profile patch as part of the inherited composition', async () => { const profile = await fixture('- insert:\n - id: tool\n name: package\n') expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(false) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([{ insert: [{ id: 'tool', name: 'package' }] }]) }) it.each([ ['a value', '- id: &plugin tool\n disabled: true\n- id: other\n config: { target: *plugin }\n', { target: 'tool' }], ['the entry', '- &plugin { id: tool, disabled: true }\n- id: other\n config: { target: *plugin }\n', { target: { id: 'tool', disabled: false } }], ['a key', '- id: tool\n &key disabled: true\n- id: other\n config: { *key : 1 }\n', { disabled: 1 }], ])('keeps a switch whose anchor on %s other entries reference', async (_, text, config) => { const profile = await fixture(text, [TOOL]) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([{ id: 'tool', disabled: false }, { id: 'other', config }]) }) it('keeps a switch whose value is an alias', async () => { const profile = await fixture('- id: other\n config: { flag: &flag true }\n- id: tool\n disabled: *flag\n', [TOOL]) expect(await writePluginEnabled(profile, 'tool', 'package', true)).toBe(true) expect(loadOptionalPatches('test', profile.patchPath)).toEqual([{ id: 'other', config: { flag: true } }, { id: 'tool', disabled: false }]) })