The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
dsh/registry: cover both registry readers on fixture trees
deec775f29b903b
diff --git a/cli/scripts/lib/dshRegistry.mjs b/cli/scripts/lib/dshRegistry.mjsindex b277a0b56..33734fe2f 100644--- a/cli/scripts/lib/dshRegistry.mjs+++ b/cli/scripts/lib/dshRegistry.mjs@@ -52,7 +52,9 @@ function readRegistryDir(root) {} catch { continue }for (const file of files) {if (!file.endsWith('.json')) continue- out.push(JSON.parse(readFileSync(join(ownerDir, file), 'utf8')))+ // Unlike the runtime's dev reader, which skips it, a malformed entry fails the build: say which.+ const path = join(ownerDir, file)+ try { out.push(JSON.parse(readFileSync(path, 'utf8'))) } catch (error) { throw new Error(`${path}: ${error.message}`) }}}return outdiff --git a/cli/src/dsh/registry.spec.ts b/cli/src/dsh/registry.spec.tsnew file mode 100644index 000000000..84d42882d--- /dev/null+++ b/cli/src/dsh/registry.spec.ts@@ -0,0 +1,164 @@+// The registry readers on fixture trees: the runtime's (registry.ts) and the build's+// (scripts/lib/dshRegistry.mjs), held to the same answer; the baked-in registry the release reads; and+// the store ref a branch under test moves the built-in shelf to.+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'+import { mkdirSync, mkdtempSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'+import { tmpdir } from 'node:os'+import { join } from 'node:path'+import { pathToFileURL } from 'node:url'+import { env } from '../config/env.js'+import {+ bundledDshRegistry, HARNESS_MONOREPO, readRegistryDir, readStoreDir, registryEntry, registrySourceUrl,+ resetBundledDshRegistry, storeEntry,+} from './registry.js'++// @ts-expect-error — plain ESM with no declaration file, imported to hold the build to the runtime+const build = await import('../../scripts/lib/dshRegistry.mjs') as {+ storeEntry: typeof storeEntry+ readDshRegistry: (storeDir: string | URL) => unknown[]+}++const write = (path: string, body: string): void => {+ mkdirSync(join(path, '..'), { recursive: true })+ writeFileSync(path, body)+}++describe('storeEntry', () => {+ const cases: Array<[string, Record<string, unknown>, Record<string, unknown>]> = [+ ['a bare agent: tier 0, only what the manifest says', { spec: 1, id: 'autonomous/bare', name: 'Bare', engine: 'claude' }, {}],+ ['a verdict: tier 1', { spec: 1, id: 'autonomous/checked', name: 'Checked', engine: 'codex', verdict: '.harness/verdict.json' }, {}],+ ['a used viewer: tier 2 and its dependency', { spec: 1, id: 'autonomous/cad', name: 'CAD', category: 'CAD', author: 'Autonomous', description: 'd', engine: 'claude', viewer: { use: 'autonomous/cad-viewer' } }, { homepage: 'https://example.com', license: 'MIT' }],+ ['a viewer package: its kind and no engine', { spec: 1, kind: 'viewer', id: 'autonomous/pane', name: 'Pane', viewer: { command: 'v.sh', url: 'http://127.0.0.1:${port}/' } }, { upstream: 'https://example.com/up', screenshots: ['https://example.com/1.png'] }],+ ]+ for (const [what, manifest, facts] of cases) {+ it(`${what}, the same from the build`, () => {+ const entry = storeEntry('store/agents/x', manifest, facts)+ expect(build.storeEntry('store/agents/x', manifest, facts)).toEqual(entry)+ expect(entry).toMatchObject({ id: manifest.id, repo: HARNESS_MONOREPO, ref: 'main', path: 'store/agents/x', verified: true })+ })+ }++ it('says exactly what each case ships', () => {+ const [bare, checked, cad, pane] = cases.map(([, manifest, facts]) => storeEntry('p', manifest, facts))+ expect(bare).toEqual({ id: 'autonomous/bare', name: 'Bare', repo: HARNESS_MONOREPO, ref: 'main', path: 'p', engine: 'claude', tier: 0, verified: true })+ expect(checked.tier).toBe(1)+ expect(cad).toMatchObject({ category: 'CAD', author: 'Autonomous', description: 'd', homepage: 'https://example.com', license: 'MIT', viewerUse: 'autonomous/cad-viewer', tier: 2 })+ expect(pane).toMatchObject({ kind: 'viewer', upstream: 'https://example.com/up', screenshots: ['https://example.com/1.png'], tier: 2 })+ expect(pane).not.toHaveProperty('engine')+ expect(pane).not.toHaveProperty('viewerUse')+ })+})++describe('reading a store tree', () => {+ let store: string+ beforeEach(() => { store = mkdtempSync(join(tmpdir(), 'dsh-store-')) })+ afterEach(() => rmSync(store, { recursive: true, force: true }))++ const fixture = (): void => {+ write(join(store, 'agents', 'typst', 'harness.json'), JSON.stringify({ spec: 1, id: 'autonomous/typst', name: 'Typst', engine: 'claude' }))+ write(join(store, 'agents', 'typst', 'store.json'), JSON.stringify({ license: 'MIT' }))+ write(join(store, 'agents', 'no-facts', 'harness.json'), JSON.stringify({ spec: 1, id: 'autonomous/no-facts', name: 'No facts', engine: 'codex' }))+ write(join(store, 'agents', 'bad-facts', 'harness.json'), JSON.stringify({ spec: 1, id: 'autonomous/bad-facts', name: 'Bad facts', engine: 'codex' }))+ write(join(store, 'agents', 'bad-facts', 'store.json'), '{nope')+ write(join(store, 'agents', 'no-manifest', 'README.md'), '# not a package\n')+ write(join(store, 'agents', 'bad-manifest', 'harness.json'), '{nope')+ // no viewers/ folder at all+ write(join(store, 'registry', 'README.md'), '# entries for packages elsewhere\n')+ write(join(store, 'registry', 'acme', 'thing.json'), JSON.stringify({ id: 'acme/thing', name: 'Thing', repo: 'https://example.com/thing.git', engine: 'claude' }))+ write(join(store, 'registry', 'acme', 'notes.txt'), 'not an entry')+ symlinkSync(join(store, 'nowhere'), join(store, 'registry', 'dangling'))+ }++ it('turns each package folder into its entry, skipping folders with no readable manifest', () => {+ fixture()+ const entries = readStoreDir(store) as Array<Record<string, unknown>>+ expect(entries.map((entry) => entry.id)).toEqual(['autonomous/bad-facts', 'autonomous/no-facts', 'autonomous/typst'])+ expect(entries.find((entry) => entry.id === 'autonomous/typst')).toMatchObject({ license: 'MIT', path: 'store/agents/typst' })+ expect(entries.find((entry) => entry.id === 'autonomous/bad-facts')).not.toHaveProperty('license')+ expect(readStoreDir(join(store, 'missing'))).toEqual([])+ })++ it('reads the outside entries, skipping stray files, links to nothing and malformed JSON', () => {+ fixture()+ write(join(store, 'registry', 'acme', 'broken.json'), '{nope')+ expect(readRegistryDir(join(store, 'registry'))).toEqual([{ id: 'acme/thing', name: 'Thing', repo: 'https://example.com/thing.git', engine: 'claude' }])+ expect(readRegistryDir(join(store, 'missing'))).toEqual([])+ })++ it('the build reads the same tree to the same answer, from a path or a file URL', () => {+ fixture()+ const runtime = [...readStoreDir(store), ...readRegistryDir(join(store, 'registry'))]+ expect(build.readDshRegistry(store)).toEqual(runtime)+ expect(build.readDshRegistry(pathToFileURL(store))).toEqual(runtime)+ expect(build.readDshRegistry(join(store, 'missing'))).toEqual([])+ })++ it('the build refuses a malformed outside entry the runtime skips, naming the file', () => {+ fixture()+ write(join(store, 'registry', 'acme', 'broken.json'), '{nope')+ expect(() => build.readDshRegistry(store)).toThrow(/registry[/\\]acme[/\\]broken\.json/)+ })+})++describe('bundledDshRegistry, as baked into a release', () => {+ const savedRef = env.HARNESS_STORE_REF+ afterEach(() => {+ vi.unstubAllGlobals()+ env.HARNESS_STORE_REF = savedRef+ resetBundledDshRegistry()+ })++ const bake = (entries: unknown[]): void => {+ vi.stubGlobal('__DSH_REGISTRY__', JSON.stringify(entries))+ resetBundledDshRegistry()+ }++ it('keeps valid entries once each, first one wins, sorted by id, and caches the answer', () => {+ env.HARNESS_STORE_REF = undefined+ bake([+ { id: 'zeta/one', name: 'Zeta', repo: 'https://example.com/zeta', engine: 'codex' },+ { id: 'alpha/one', name: 'Alpha', repo: 'https://example.com/alpha', engine: 'claude' },+ { id: 'alpha/one', name: 'Impostor', repo: 'https://example.com/impostor', engine: 'claude' },+ { id: 'no/engine', name: 'Agent without an engine', repo: 'https://example.com/x' },+ { id: 'Bad Id', name: 'Bad', repo: 'https://example.com/x', engine: 'claude' },+ { id: 'pane/viewer', kind: 'viewer', name: 'Pane', repo: 'https://example.com/pane' },+ ])+ const first = bundledDshRegistry()+ expect(first.map((entry) => `${entry.id} ${entry.name}`)).toEqual(['alpha/one Alpha', 'pane/viewer Pane', 'zeta/one Zeta'])+ expect(bundledDshRegistry()).toBe(first)+ expect(registryEntry('zeta/one')?.repo).toBe('https://example.com/zeta')+ expect(registryEntry('nobody/here')).toBeUndefined()+ })++ it('a malformed bake is an empty registry, not a crash', () => {+ vi.stubGlobal('__DSH_REGISTRY__', '{not json')+ resetBundledDshRegistry()+ expect(bundledDshRegistry()).toEqual([])+ expect(bundledDshRegistry()).toEqual([])+ })++ it('HARNESS_STORE_REF moves only the built-in folders of this repository to the branch under test', () => {+ env.HARNESS_STORE_REF = 'store-e2e'+ bake([+ { id: 'autonomous/typst', name: 'Typst', repo: HARNESS_MONOREPO, ref: 'main', path: 'store/agents/typst', engine: 'claude' },+ { id: 'autonomous/dotgit', name: 'Dot git', repo: `${HARNESS_MONOREPO}.git`, ref: 'main', path: 'store/agents/dotgit', engine: 'claude' },+ { id: 'autonomous/whole', name: 'Whole repo', repo: HARNESS_MONOREPO, ref: 'main', engine: 'claude' },+ { id: 'acme/folder', name: 'Elsewhere', repo: 'https://example.com/acme', ref: 'v1', path: 'pkg', engine: 'claude' },+ ])+ expect(Object.fromEntries(bundledDshRegistry().map((entry) => [entry.id, entry.ref]))).toEqual({+ 'autonomous/typst': 'store-e2e',+ 'autonomous/dotgit': 'store-e2e',+ 'autonomous/whole': 'main',+ 'acme/folder': 'v1',+ })+ })+})++describe('registrySourceUrl', () => {+ it('links a folder of a GitHub repo to its tree page, and anything else to the repo', () => {+ expect(registrySourceUrl({ repo: 'https://github.com/acme/mono.git/', path: 'pkgs/a' })).toBe('https://github.com/acme/mono/tree/main/pkgs/a')+ expect(registrySourceUrl({ repo: 'https://github.com/acme/mono', ref: 'v2', path: 'pkgs/a' })).toBe('https://github.com/acme/mono/tree/v2/pkgs/a')+ expect(registrySourceUrl({ repo: 'https://gitlab.example.com/acme/mono', ref: 'v2', path: 'pkgs/a' })).toBe('https://gitlab.example.com/acme/mono')+ expect(registrySourceUrl({ repo: 'https://github.com/acme/mono' })).toBe('https://github.com/acme/mono')+ })+})