ds-harness-remote-fast/packages/plugin/tests/harness-version.test.ts

247 lines
11 KiB
TypeScript

import { describe, expect, it } from 'vitest'
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
import { tmpdir } from 'node:os'
import { join } from 'node:path'
import {
harnessSessionGeneration,
normalizeHarnessVersion,
readHarnessDistributionVersion,
} from '../src/harness-version.js'
describe('Harness version discovery', () => {
it('rejects malformed reported versions', () => {
expect(normalizeHarnessVersion(' ')).toBeUndefined()
expect(normalizeHarnessVersion('0.1.0\ninvalid')).toBeUndefined()
})
it('separates the v0.1.5 Session V3 wire from the v0.1.2 profile', () => {
expect(harnessSessionGeneration('0.1.2-rc.1')).toBe('legacy')
expect(harnessSessionGeneration('dsh-v0.1.5-alpha.1')).toBe('v3')
expect(harnessSessionGeneration('0.1.5-rc.1')).toBe('v3')
expect(harnessSessionGeneration('0.1.7-rc.1')).toBe('v3')
expect(harnessSessionGeneration('0.2.0-rc.1')).toBe('v3')
for (const version of ['0.2.0-rc.2', '0.2.1-alpha.1', '0.2.1-rc.1', 'dsh-v0.2.1-rc.1', '0.2.1', '0.2.2-rc.1']) {
expect(harnessSessionGeneration(version), version).toBe('v3')
}
expect(harnessSessionGeneration('dsh-v0.2.0-rc.1')).toBe('v3')
expect(harnessSessionGeneration('0.3.0')).toBe('legacy')
expect(harnessSessionGeneration('1.0.0')).toBe('legacy')
expect(harnessSessionGeneration(undefined)).toBe('legacy')
})
})
describe('Harness distribution version discovery', () => {
async function fakeInstall(root: string, version: string) {
const pkgDir = join(root, 'node_modules', '@deepseek-ai', 'dsh')
await mkdir(pkgDir, { recursive: true })
await writeFile(join(pkgDir, 'package.json'), JSON.stringify({ name: '@deepseek-ai/dsh', version }))
return pkgDir
}
const context = (root: string) => ({
cwd: root,
execPath: join(root, 'node.exe'),
globalRoots: [root],
// Keep discovery hermetic: never inherit DSHM_CORE_DIR from the host and ignore external module scope.
env: {} as NodeJS.ProcessEnv,
moduleScope: null,
})
it('reads the version from an absolute CLI entrypoint', async () => {
const root = await mkdtemp(join(tmpdir(), 'dsh-version-'))
try {
const pkgDir = await fakeInstall(root, '0.2.2-rc.9')
await mkdir(join(pkgDir, 'lib'), { recursive: true })
const entry = join(pkgDir, 'lib', 'bin.js')
await writeFile(entry, '')
await expect(readHarnessDistributionVersion(entry, context(root))).resolves.toBe('0.2.2-rc.9')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('recovers the version from cwd and npm roots when argv[1] is empty or relative', async () => {
const root = await mkdtemp(join(tmpdir(), 'dsh-version-'))
try {
await fakeInstall(root, '0.2.3-rc.1')
await expect(readHarnessDistributionVersion('', context(root))).resolves.toBe('0.2.3-rc.1')
await expect(readHarnessDistributionVersion('relative/entry.js', context(root))).resolves.toBe('0.2.3-rc.1')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('returns undefined only when no Harness manifest is discoverable', async () => {
const root = await mkdtemp(join(tmpdir(), 'dsh-version-'))
try {
const pkgDir = join(root, 'node_modules', '@deepseek-ai', 'dsh')
await mkdir(pkgDir, { recursive: true })
await writeFile(join(pkgDir, 'package.json'), JSON.stringify({ name: 'some-other-package', version: '9.9.9' }))
await expect(readHarnessDistributionVersion('', context(root))).resolves.toBeUndefined()
} finally { await rm(root, { recursive: true, force: true }) }
})
})
describe('Harness version discovery on in-process DSHM hosts', () => {
async function fakeCoreInstall(coreDir: string, version: string) {
const pkgDir = join(coreDir, 'node_modules', '@deepseek-ai', 'dsh')
await mkdir(pkgDir, { recursive: true })
await writeFile(join(pkgDir, 'package.json'), JSON.stringify({ name: '@deepseek-ai/dsh', version }))
return pkgDir
}
/**
* HarmonyOS host application: `main.js` calls runProfile in-process, so the
* executable, the working directory and the global npm roots hold no Harness
* install at all.
*/
const hostContext = (appDir: string, env?: NodeJS.ProcessEnv) => ({
cwd: appDir,
execPath: join(appDir, 'main.exe'),
globalRoots: [] as string[],
env,
moduleScope: null,
})
it('discovers the version through DSHM_CORE_DIR and selects Session V3', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
try {
const coreDir = join(root, 'core')
await fakeCoreInstall(coreDir, '0.2.2-rc.1')
const version = await readHarnessDistributionVersion('', hostContext(join(root, 'app'), { DSHM_CORE_DIR: coreDir }))
expect(version).toBe('0.2.2-rc.1')
expect(harnessSessionGeneration(version)).toBe('v3')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('discovers the version through injectable moduleScope', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-scope-'))
try {
await fakeCoreInstall(root, '0.2.2-rc.1')
const fakeEntry = join(root, 'entry.js')
await writeFile(fakeEntry, '')
const version = await readHarnessDistributionVersion('', {
cwd: tmpdir(),
execPath: '',
globalRoots: [],
env: {},
moduleScope: fakeEntry,
})
expect(version).toBe('0.2.2-rc.1')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('trims surrounding whitespace in DSHM_CORE_DIR', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
try {
const coreDir = join(root, 'core')
await fakeCoreInstall(coreDir, '0.2.2-rc.1')
await expect(
readHarnessDistributionVersion('', hostContext(join(root, 'app'), { DSHM_CORE_DIR: ` ${coreDir} ` })),
).resolves.toBe('0.2.2-rc.1')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('accepts a DSHM_CORE_DIR that is itself the Harness package root', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
try {
const coreDir = join(root, 'core')
await mkdir(coreDir, { recursive: true })
await writeFile(join(coreDir, 'package.json'), JSON.stringify({ name: '@deepseek-ai/dsh', version: '0.2.2' }))
await expect(
readHarnessDistributionVersion('', hostContext(join(root, 'app'), { DSHM_CORE_DIR: coreDir })),
).resolves.toBe('0.2.2')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('resolves relative DSHM_CORE_DIR against context cwd', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
try {
const coreDir = join(root, 'app', 'embedded-core')
await fakeCoreInstall(coreDir, '0.2.2-rc.1')
await expect(
readHarnessDistributionVersion('', hostContext(join(root, 'app'), { DSHM_CORE_DIR: './embedded-core' })),
).resolves.toBe('0.2.2-rc.1')
} finally { await rm(root, { recursive: true, force: true }) }
})
it('reads DSHM_CORE_DIR from process.env when no lookup context is supplied', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
const previous = process.env.DSHM_CORE_DIR
try {
const coreDir = join(root, 'core')
await fakeCoreInstall(coreDir, '0.2.2-rc.1')
process.env.DSHM_CORE_DIR = coreDir
await expect(readHarnessDistributionVersion('', { moduleScope: null })).resolves.toBe('0.2.2-rc.1')
} finally {
if (previous === undefined) delete process.env.DSHM_CORE_DIR
else process.env.DSHM_CORE_DIR = previous
await rm(root, { recursive: true, force: true })
}
})
it('falls back to process.env when context has no env property', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
const previous = process.env.DSHM_CORE_DIR
try {
const coreDir = join(root, 'core')
await fakeCoreInstall(coreDir, '0.2.2-rc.1')
process.env.DSHM_CORE_DIR = coreDir
const appDir = join(root, 'app')
const contextWithoutEnv = {
cwd: appDir,
execPath: join(appDir, 'main.exe'),
globalRoots: [] as string[],
moduleScope: null,
}
await expect(readHarnessDistributionVersion('', contextWithoutEnv)).resolves.toBe('0.2.2-rc.1')
} finally {
if (previous === undefined) delete process.env.DSHM_CORE_DIR
else process.env.DSHM_CORE_DIR = previous
await rm(root, { recursive: true, force: true })
}
})
it('falls back safely when DSHM_CORE_DIR is unset, blank, or not a Harness install', async () => {
const root = await mkdtemp(join(tmpdir(), 'dshm-version-'))
try {
const appDir = join(root, 'app')
const cases: Array<{ label: string; env: NodeJS.ProcessEnv }> = [
{ label: 'unset-env', env: {} },
{ label: 'empty-string', env: { DSHM_CORE_DIR: '' } },
{ label: 'whitespace-only', env: { DSHM_CORE_DIR: ' ' } },
{ label: 'absent-directory', env: { DSHM_CORE_DIR: join(root, 'absent-core') } },
]
for (const item of cases) {
await expect(readHarnessDistributionVersion('', hostContext(appDir, item.env)), item.label).resolves.toBeUndefined()
}
// Foreign manifest inside core package root must be rejected
const impostorRoot = join(root, 'impostor-root')
await mkdir(impostorRoot, { recursive: true })
await writeFile(join(impostorRoot, 'package.json'), JSON.stringify({ name: 'not-the-harness', version: '0.2.2-rc.1' }))
await expect(
readHarnessDistributionVersion('', hostContext(appDir, { DSHM_CORE_DIR: impostorRoot })),
).resolves.toBeUndefined()
// Foreign manifest inside node_modules/@deepseek-ai/dsh must also be rejected
const impostorModule = join(root, 'impostor-module')
const impostorPkg = join(impostorModule, 'node_modules', '@deepseek-ai', 'dsh')
await mkdir(impostorPkg, { recursive: true })
await writeFile(join(impostorPkg, 'package.json'), JSON.stringify({ name: 'not-dsh', version: '0.2.2-rc.1' }))
await expect(
readHarnessDistributionVersion('', hostContext(appDir, { DSHM_CORE_DIR: impostorModule })),
).resolves.toBeUndefined()
// Malformed package.json (non-JSON, missing version, non-string version) must fall back gracefully
const malformedModule = join(root, 'malformed-module')
const malformedPkg = join(malformedModule, 'node_modules', '@deepseek-ai', 'dsh')
await mkdir(malformedPkg, { recursive: true })
await writeFile(join(malformedPkg, 'package.json'), '{ broken json')
await expect(
readHarnessDistributionVersion('', hostContext(appDir, { DSHM_CORE_DIR: malformedModule })),
).resolves.toBeUndefined()
await writeFile(join(malformedPkg, 'package.json'), JSON.stringify({ name: '@deepseek-ai/dsh', version: 12345 }))
await expect(
readHarnessDistributionVersion('', hostContext(appDir, { DSHM_CORE_DIR: malformedModule })),
).resolves.toBeUndefined()
} finally { await rm(root, { recursive: true, force: true }) }
})
})