docs: replace vague provenance prose with recorded facts

This commit is contained in:
Turtle
2026-08-09 15:35:02 +08:00
parent 8c124f84b6
commit 9704749b01
380 changed files with 946 additions and 874 deletions

View File

@@ -95,10 +95,10 @@ describe('gen-persistence-catalog collectLogEvents', () => {
it('extracts a member declaration-merged via the session module', () => {
const events = collectLogEvents(make({
'packages/group/fix/src/types.ts': merge(' /** Merged provenance. */\n \'fix/merged\': { id: string }'),
'packages/group/fix/src/types.ts': merge(' /** Merged event source record. */\n \'fix/merged\': { id: string }'),
}))
expect(events).toHaveLength(1)
expect(events[0]).toMatchObject({ name: 'fix/merged', doc: 'Merged provenance.' })
expect(events[0]).toMatchObject({ name: 'fix/merged', doc: 'Merged event source record.' })
})
it('collapses a newline-separated multi-line payload to a valid one-line fragment', () => {

View File

@@ -417,7 +417,7 @@ describe('Session', () => {
}
})
it('round-trips adapter-default provenance and rejects invalid durable values', () => {
it('round-trips adapter-default markers and rejects invalid durable values', () => {
const valid = {
type: 'request/header',
seq: 0,

View File

@@ -78,8 +78,8 @@ function toolResultEvent(
}
}
describe('foldSurface provenance', () => {
it('accepts absent or valid provenance and complete replacement coverage', () => {
describe('foldSurface source-event references', () => {
it('accepts absent or valid source-event references and complete replacement coverage', () => {
const events = [
provenanceEvent(0, undefined),
provenanceEvent(1, undefined),
@@ -91,7 +91,7 @@ describe('foldSurface provenance', () => {
expect(() => foldSurface(events)).not.toThrow()
})
it('rejects provenance on a non-surface event', () => {
it('rejects source-event references on a non-surface event', () => {
const event = {
type: 'turn/start',
seq: 0,
@@ -102,7 +102,7 @@ describe('foldSurface provenance', () => {
expect(() => foldSurface([event])).toThrow(/cannot carry sourceEventSeqs/)
})
it('accepts explicit empty provenance on an assistant message', () => {
it('accepts an explicit empty source-event list on an assistant message', () => {
const event = {
type: 'assistant/message',
seq: 0,