import { describe, expect, it } from 'vitest' import { extendArchiveManifest, gitBlobHash, parseArchiveManifest, renderArchiveManifest, validateArchiveArtifacts, validateArchiveManifestExtension, type ArchiveManifest, } from './archived-agent-notes.ts' import { isArchivedAgentNotePath } from './repo-files.ts' function fixture(): Map { const base = '2026-07-26-example' const source = Buffer.from(`# Agent Note: Example\n\nStatus: implemented\nArchived: 2026-07-26\n\nEnglish | [中文](${base}.zh.md)\n\n## Problem\n\nExample.\n`) const zh = Buffer.from(`# Agent Note: 示例\n\nStatus: implemented\nArchived: 2026-07-26\n\n[English](${base}.md) | 中文\n\n## 问题\n\n示例。\n`) const meta = Buffer.from(`${base}.md: ${gitBlobHash(source)}\n${base}.zh.md: ${gitBlobHash(zh)}\n`) return new Map([ [`process/${base}.md`, source], [`process/${base}.zh.md`, zh], [`process/${base}.i18n.yaml`, meta], ]) } describe('archived Agent Notes', () => { it('recognizes archived paths with POSIX and Windows separators', () => { expect(isArchivedAgentNotePath('.agents/notes/archived/process/example.md')).toBe(true) expect(isArchivedAgentNotePath('.agents\\notes\\archived\\process\\example.md')).toBe(true) expect(isArchivedAgentNotePath('.agents/notes/implemented/process/example.md')).toBe(false) }) it('accepts one complete implemented triplet with matching archive metadata', () => { expect(validateArchiveArtifacts(fixture())).toEqual([]) }) it('rejects incomplete triplets and invalid archive headers', () => { const artifacts = fixture() artifacts.delete('process/2026-07-26-example.i18n.yaml') artifacts.set( 'process/2026-07-26-example.md', Buffer.from('# Agent Note: Example\n\nStatus: proposed\nArchived: yesterday\n'), ) expect(validateArchiveArtifacts(artifacts).join('\n')).toMatch(/incomplete archived triplet/) }) it('extends the manifest without permitting a sealed change or removal', () => { const artifacts = fixture() const empty: ArchiveManifest = { version: 1, files: {} } const first = extendArchiveManifest(empty, artifacts) expect(first.errors).toEqual([]) expect(first.added).toHaveLength(3) const sealed: ArchiveManifest = { version: 1, files: first.files } const changed = new Map(artifacts) changed.set('process/2026-07-26-example.md', Buffer.from('changed')) expect(extendArchiveManifest(sealed, changed).errors).toEqual([ 'process/2026-07-26-example.md: sealed content hash changed', ]) changed.delete('process/2026-07-26-example.zh.md') expect(extendArchiveManifest(sealed, changed).errors).toContain( 'process/2026-07-26-example.zh.md: sealed artifact is missing', ) }) it('rejects replacing manifest seals alongside changed archive content', () => { const artifacts = fixture() const initial = extendArchiveManifest({ version: 1, files: {} }, artifacts) const baseline: ArchiveManifest = { version: 1, files: initial.files } const path = 'process/2026-07-26-example.md' const changedArtifacts = new Map(artifacts) changedArtifacts.set(path, Buffer.from('changed')) const replacement = extendArchiveManifest({ version: 1, files: {} }, changedArtifacts) const current: ArchiveManifest = { version: 1, files: replacement.files } expect(extendArchiveManifest(current, changedArtifacts).errors).toEqual([]) expect(validateArchiveManifestExtension(baseline, current)).toEqual([ `${path}: sealed manifest hash changed`, ]) const removed: ArchiveManifest = { version: 1, files: Object.fromEntries(Object.entries(current.files).filter(([candidate]) => candidate !== path)), } expect(validateArchiveManifestExtension(baseline, removed)).toContain( `${path}: sealed manifest entry is missing`, ) }) it('round-trips the deterministic manifest schema', () => { const content = renderArchiveManifest({ 'process/z.md': `sha256:${'a'.repeat(64)}` }) expect(parseArchiveManifest(content)).toEqual({ version: 1, files: { 'process/z.md': `sha256:${'a'.repeat(64)}` }, }) }) })