@cleocode/contracts 2026.4.69 → 2026.4.72

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/dist/__tests__/acceptance-gate.test.d.ts +14 -0
  2. package/dist/__tests__/acceptance-gate.test.d.ts.map +1 -0
  3. package/dist/__tests__/acceptance-gate.test.js +642 -0
  4. package/dist/__tests__/acceptance-gate.test.js.map +1 -0
  5. package/dist/__tests__/attachment.test.d.ts +17 -0
  6. package/dist/__tests__/attachment.test.d.ts.map +1 -0
  7. package/dist/__tests__/attachment.test.js +505 -0
  8. package/dist/__tests__/attachment.test.js.map +1 -0
  9. package/dist/__tests__/evidence-record.test.d.ts +14 -0
  10. package/dist/__tests__/evidence-record.test.d.ts.map +1 -0
  11. package/dist/__tests__/evidence-record.test.js +362 -0
  12. package/dist/__tests__/evidence-record.test.js.map +1 -0
  13. package/dist/__tests__/invariants.test.d.ts +19 -0
  14. package/dist/__tests__/invariants.test.d.ts.map +1 -0
  15. package/dist/__tests__/invariants.test.js +351 -0
  16. package/dist/__tests__/invariants.test.js.map +1 -0
  17. package/dist/acceptance-gate-schema.d.ts +701 -0
  18. package/dist/acceptance-gate-schema.d.ts.map +1 -0
  19. package/dist/acceptance-gate-schema.js +303 -0
  20. package/dist/acceptance-gate-schema.js.map +1 -0
  21. package/dist/acceptance-gate.d.ts +350 -0
  22. package/dist/acceptance-gate.d.ts.map +1 -0
  23. package/dist/acceptance-gate.js +22 -0
  24. package/dist/acceptance-gate.js.map +1 -0
  25. package/dist/attachment-schema.d.ts +243 -0
  26. package/dist/attachment-schema.d.ts.map +1 -0
  27. package/dist/attachment-schema.js +200 -0
  28. package/dist/attachment-schema.js.map +1 -0
  29. package/dist/attachment.d.ts +224 -0
  30. package/dist/attachment.d.ts.map +1 -0
  31. package/dist/attachment.js +21 -0
  32. package/dist/attachment.js.map +1 -0
  33. package/dist/evidence-record-schema.d.ts +202 -0
  34. package/dist/evidence-record-schema.d.ts.map +1 -0
  35. package/dist/evidence-record-schema.js +130 -0
  36. package/dist/evidence-record-schema.js.map +1 -0
  37. package/dist/evidence-record.d.ts +167 -0
  38. package/dist/evidence-record.d.ts.map +1 -0
  39. package/dist/evidence-record.js +21 -0
  40. package/dist/evidence-record.js.map +1 -0
  41. package/dist/index.d.ts +12 -1
  42. package/dist/index.d.ts.map +1 -1
  43. package/dist/index.js +6 -0
  44. package/dist/index.js.map +1 -1
  45. package/dist/task-evidence.d.ts +251 -0
  46. package/dist/task-evidence.d.ts.map +1 -0
  47. package/dist/task-evidence.js +89 -0
  48. package/dist/task-evidence.js.map +1 -0
  49. package/dist/task.d.ts +23 -4
  50. package/dist/task.d.ts.map +1 -1
  51. package/package.json +8 -2
  52. package/schemas/acceptance-gate.schema.json +9 -0
  53. package/schemas/attachment.schema.json +9 -0
  54. package/schemas/gate-result-details.schema.json +9 -0
  55. package/schemas/gate-result.schema.json +9 -0
  56. package/schemas/manifest-v1.json +176 -0
  57. package/schemas/task-evidence.schema.json +9 -0
  58. package/schemas/task.schema.json +9 -0
  59. package/src/__tests__/acceptance-gate.test.ts +736 -0
  60. package/src/__tests__/attachment.test.ts +601 -0
  61. package/src/__tests__/evidence-record.test.ts +412 -0
  62. package/src/__tests__/invariants.test.ts +445 -0
  63. package/src/acceptance-gate-schema.ts +347 -0
  64. package/src/acceptance-gate.ts +370 -0
  65. package/src/attachment-schema.ts +223 -0
  66. package/src/attachment.ts +245 -0
  67. package/src/evidence-record-schema.ts +158 -0
  68. package/src/evidence-record.ts +182 -0
  69. package/src/index.ts +114 -1
  70. package/src/task-evidence.ts +239 -0
  71. package/src/task.ts +24 -4
@@ -0,0 +1,167 @@
1
+ /**
2
+ * EvidenceRecord discriminated union — typed proof artifacts produced by IVTR agents.
3
+ *
4
+ * Each variant represents a specific kind of evidence that an IVTR-phase agent
5
+ * (implement, validate, test) can emit. All variants share a common set of
6
+ * provenance fields (`agentIdentity`, `attachmentSha256`, `ranAt`, `durationMs`)
7
+ * so that evidence rows can be queried, correlated, and archived uniformly.
8
+ *
9
+ * Five kinds are defined:
10
+ * - `impl-diff` — a code change produced by an implement-phase agent
11
+ * - `validate-spec-check` — a spec-requirements check by a validate-phase agent
12
+ * - `test-output` — the output of a test command run by a test-phase agent
13
+ * - `lint-report` — a static-analysis run (biome, tsc, etc.)
14
+ * - `command-output` — a generic CLI command invocation with exit code
15
+ *
16
+ * @epic T810
17
+ * @task T816
18
+ * @see {@link EvidenceRecordKind} for all discriminant values
19
+ */
20
+ /**
21
+ * Evidence that an implement-phase agent produced a code diff.
22
+ *
23
+ * `filesChanged` lists the relative paths of every modified file.
24
+ * `attachmentSha256` is the SHA-256 hex digest of the serialised diff attachment.
25
+ */
26
+ export interface ImplDiffRecord {
27
+ kind: 'impl-diff';
28
+ /** RCASD lifecycle phase that produced this record. */
29
+ phase: 'implement';
30
+ /** Identity string of the agent that ran this action (e.g. `"T816-worker"`). */
31
+ agentIdentity: string;
32
+ /** SHA-256 hex digest (64 chars) of the attached diff blob. */
33
+ attachmentSha256: string;
34
+ /** Relative paths of every file the diff touches. */
35
+ filesChanged: string[];
36
+ /** Net lines added across all changed files. */
37
+ linesAdded: number;
38
+ /** Net lines removed across all changed files. */
39
+ linesRemoved: number;
40
+ /** ISO 8601 timestamp at which the diff was captured. */
41
+ ranAt: string;
42
+ /** Wall-clock duration of the implement action in milliseconds. */
43
+ durationMs: number;
44
+ }
45
+ /**
46
+ * Evidence that a validate-phase agent checked one or more REQ-IDs against
47
+ * the implementation and recorded a pass/fail verdict.
48
+ */
49
+ export interface ValidateSpecCheckRecord {
50
+ kind: 'validate-spec-check';
51
+ /** RCASD lifecycle phase that produced this record. */
52
+ phase: 'validate';
53
+ /** Identity string of the agent that ran this action. */
54
+ agentIdentity: string;
55
+ /** SHA-256 hex digest (64 chars) of the spec-check report attachment. */
56
+ attachmentSha256: string;
57
+ /** REQ-IDs checked in this run (e.g. `["IVTR-01", "IVTR-02"]`). */
58
+ reqIdsChecked: string[];
59
+ /** `true` when all checked REQ-IDs passed; `false` if any failed. */
60
+ passed: boolean;
61
+ /** Human-readable summary of results per REQ-ID. */
62
+ details: string;
63
+ /** ISO 8601 timestamp at which the check ran. */
64
+ ranAt: string;
65
+ /** Wall-clock duration of the validation check in milliseconds. */
66
+ durationMs: number;
67
+ }
68
+ /**
69
+ * Evidence that a test-phase agent ran a test command and recorded counts.
70
+ */
71
+ export interface TestOutputRecord {
72
+ kind: 'test-output';
73
+ /** RCASD lifecycle phase that produced this record. */
74
+ phase: 'test';
75
+ /** Identity string of the agent that ran this action. */
76
+ agentIdentity: string;
77
+ /** SHA-256 hex digest (64 chars) of the test-output attachment. */
78
+ attachmentSha256: string;
79
+ /** The full test command that was executed (e.g. `"pnpm --filter @cleocode/contracts run test"`). */
80
+ command: string;
81
+ /** Exit code returned by the test command. */
82
+ exitCode: number;
83
+ /** Number of individual test cases that passed. */
84
+ testsPassed: number;
85
+ /** Number of individual test cases that failed. */
86
+ testsFailed: number;
87
+ /** ISO 8601 timestamp at which the test command started. */
88
+ ranAt: string;
89
+ /** Wall-clock duration of the full test run in milliseconds. */
90
+ durationMs: number;
91
+ }
92
+ /**
93
+ * Evidence that a lint / static-analysis tool was run.
94
+ *
95
+ * The `phase` field is `'implement' | 'test'` because lint is commonly run
96
+ * after a code change (implement) or as part of a test suite (test).
97
+ */
98
+ export interface LintReportRecord {
99
+ kind: 'lint-report';
100
+ /** RCASD lifecycle phase that produced this record. */
101
+ phase: 'implement' | 'test';
102
+ /** Identity string of the agent that ran this action. */
103
+ agentIdentity: string;
104
+ /** SHA-256 hex digest (64 chars) of the lint-output attachment. */
105
+ attachmentSha256: string;
106
+ /** Name of the lint tool that was invoked (e.g. `"biome"`, `"tsc"`). */
107
+ tool: string;
108
+ /** `true` when the lint run produced zero errors. */
109
+ passed: boolean;
110
+ /** Number of warnings emitted (may be > 0 even when `passed` is `true`). */
111
+ warnings: number;
112
+ /** Number of errors emitted. Non-zero means `passed` is `false`. */
113
+ errors: number;
114
+ /** ISO 8601 timestamp at which the lint tool was invoked. */
115
+ ranAt: string;
116
+ /** Wall-clock duration of the lint run in milliseconds. */
117
+ durationMs: number;
118
+ }
119
+ /**
120
+ * Evidence that an agent ran an arbitrary CLI command and recorded its exit code.
121
+ *
122
+ * Use this as the catch-all when none of the other variants fit.
123
+ */
124
+ export interface CommandOutputRecord {
125
+ kind: 'command-output';
126
+ /** RCASD lifecycle phase that produced this record. */
127
+ phase: 'implement' | 'validate' | 'test';
128
+ /** Identity string of the agent that ran this action. */
129
+ agentIdentity: string;
130
+ /** SHA-256 hex digest (64 chars) of the command-output attachment. */
131
+ attachmentSha256: string;
132
+ /** The CLI command that was executed. */
133
+ cmd: string;
134
+ /** Exit code returned by the command. */
135
+ exitCode: number;
136
+ /** ISO 8601 timestamp at which the command was invoked. */
137
+ ranAt: string;
138
+ /** Wall-clock duration of the command in milliseconds. */
139
+ durationMs: number;
140
+ }
141
+ /**
142
+ * A typed evidence record produced by an IVTR-phase agent.
143
+ *
144
+ * The `kind` discriminant selects the variant. All variants carry
145
+ * `agentIdentity`, `attachmentSha256`, `ranAt`, and `durationMs` for
146
+ * uniform provenance tracking.
147
+ *
148
+ * @example
149
+ * ```ts
150
+ * const rec: EvidenceRecord = {
151
+ * kind: 'test-output',
152
+ * phase: 'test',
153
+ * agentIdentity: 'T816-worker',
154
+ * attachmentSha256: 'a'.repeat(64),
155
+ * command: 'pnpm --filter @cleocode/contracts run test',
156
+ * exitCode: 0,
157
+ * testsPassed: 10,
158
+ * testsFailed: 0,
159
+ * ranAt: '2026-04-16T00:00:00.000Z',
160
+ * durationMs: 1234,
161
+ * };
162
+ * ```
163
+ */
164
+ export type EvidenceRecord = ImplDiffRecord | ValidateSpecCheckRecord | TestOutputRecord | LintReportRecord | CommandOutputRecord;
165
+ /** All valid `kind` discriminants for {@link EvidenceRecord}. */
166
+ export type EvidenceRecordKind = EvidenceRecord['kind'];
167
+ //# sourceMappingURL=evidence-record.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evidence-record.d.ts","sourceRoot":"","sources":["../src/evidence-record.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * EvidenceRecord discriminated union — typed proof artifacts produced by IVTR agents.
3
+ *
4
+ * Each variant represents a specific kind of evidence that an IVTR-phase agent
5
+ * (implement, validate, test) can emit. All variants share a common set of
6
+ * provenance fields (`agentIdentity`, `attachmentSha256`, `ranAt`, `durationMs`)
7
+ * so that evidence rows can be queried, correlated, and archived uniformly.
8
+ *
9
+ * Five kinds are defined:
10
+ * - `impl-diff` — a code change produced by an implement-phase agent
11
+ * - `validate-spec-check` — a spec-requirements check by a validate-phase agent
12
+ * - `test-output` — the output of a test command run by a test-phase agent
13
+ * - `lint-report` — a static-analysis run (biome, tsc, etc.)
14
+ * - `command-output` — a generic CLI command invocation with exit code
15
+ *
16
+ * @epic T810
17
+ * @task T816
18
+ * @see {@link EvidenceRecordKind} for all discriminant values
19
+ */
20
+ export {};
21
+ //# sourceMappingURL=evidence-record.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evidence-record.js","sourceRoot":"","sources":["../src/evidence-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}
package/dist/index.d.ts CHANGED
@@ -5,9 +5,15 @@
5
5
  * All domain types (Task, Session, DataAccessor, etc.) are defined here.
6
6
  * Implementation packages (@cleocode/core, @cleocode/cleo) import from here.
7
7
  */
8
+ export type { AcceptanceGate, AcceptanceGateKind, AcceptanceGateResult, CommandGate, FileAssertion, FileGate, GateBase, GateResultDetails, HttpGate, LintGate, ManualGate, TestGate, } from './acceptance-gate.js';
9
+ export type { AcceptanceArrayInput, AcceptanceGateResultInput, AcceptanceGateSchemaInput, AcceptanceItemInput, FileAssertionInput, GateResultDetailsInput, } from './acceptance-gate-schema.js';
10
+ export { acceptanceArraySchema, acceptanceGateResultSchema, acceptanceGateSchema, acceptanceItemSchema, commandGateSchema, fileAssertionSchema, fileGateSchema, gateBaseSchema, gateResultDetailsSchema, httpGateSchema, lintGateSchema, manualGateSchema, testGateSchema, } from './acceptance-gate-schema.js';
8
11
  export type { AdapterHealthStatus, CLEOProviderAdapter } from './adapter.js';
9
12
  export type { AgentCredential, AgentListFilter, AgentRegistryAPI, AgentWithProjectOverride, ProjectAgentRef, TransportConfig, } from './agent-registry.js';
10
13
  export type { ArchiveCycleTimesReport, ArchiveDailyTrend, ArchivedTask, ArchiveLabelEntry, ArchiveMetadata, ArchiveMonthlyTrend, ArchivePhaseEntry, ArchivePriorityEntry, ArchiveReportType, ArchiveStatsEnvelope, ArchiveSummaryReport, ArchiveTrendsReport, CycleTimeDistribution, CycleTimePercentiles, } from './archive.js';
14
+ export type { Attachment, AttachmentKind, AttachmentMetadata, AttachmentRef, BlobAttachment, LlmsTxtAttachment, LlmtxtDocAttachment, LocalFileAttachment, UrlAttachment, } from './attachment.js';
15
+ export type { AttachmentMetadataSchemaInput, AttachmentRefSchemaInput, AttachmentSchemaInput, } from './attachment-schema.js';
16
+ export { attachmentMetadataSchema, attachmentRefSchema, attachmentSchema, blobAttachmentSchema, llmsTxtAttachmentSchema, llmtxtDocAttachmentSchema, localFileAttachmentSchema, urlAttachmentSchema, } from './attachment-schema.js';
11
17
  export type { BackupDatabaseEntry, BackupGlobalFileEntry, BackupIntegrity, BackupJsonEntry, BackupManifest, BackupMetadata, BackupScope, } from './backup-manifest.js';
12
18
  export type { BrainCognitiveType, BrainEntryRef, BrainEntrySummary, BrainMemoryTier, BrainSourceConfidence, ContradictionDetail, SupersededEntry, } from './brain.js';
13
19
  export type { AdapterCapabilities } from './capabilities.js';
@@ -19,6 +25,9 @@ export type { ArchiveFields, ArchiveFile, DataAccessor, DataAccessorAgentInstanc
19
25
  export type { DependencyCategory, DependencyCheckResult, DependencyReport, DependencySpec, } from './dependency.js';
20
26
  export type { AdapterManifest, DetectionPattern } from './discovery.js';
21
27
  export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
28
+ export type { CommandOutputRecord, EvidenceRecord, EvidenceRecordKind, ImplDiffRecord, LintReportRecord, TestOutputRecord, ValidateSpecCheckRecord, } from './evidence-record.js';
29
+ export type { CommandOutputRecordInput, EvidenceRecordInput, ImplDiffRecordInput, LintReportRecordInput, TestOutputRecordInput, ValidateSpecCheckRecordInput, } from './evidence-record-schema.js';
30
+ export { commandOutputRecordSchema, evidenceRecordSchema, implDiffRecordSchema, lintReportRecordSchema, testOutputRecordSchema, validateSpecCheckRecordSchema, } from './evidence-record-schema.js';
22
31
  export { ExitCode, getExitCodeName, isErrorCode, isNoChangeCode, isRecoverableCode, isSuccessCode, } from './exit-codes.js';
23
32
  export type { AdminAPI, AgentCapacity, AgentHealthStatus, AgentInstanceRow, AgentInstanceStatus, AgentsAPI, AgentType, BlastRadius, BlastRadiusSeverity, BrainObservationType, CleoInitOptions, DuplicateStrategy, HybridSearchOptions, ImpactedTask, ImpactReport, ImportParams, IntelligenceAPI, LifecycleAPI, MemoryAPI, NexusAPI, OrchestrationAPI, RegisterAgentOptions, ReleaseAPI, SessionsAPI, StickyAPI, SyncAPI, TaskStartResult, TasksAPI, } from './facade.js';
24
33
  export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, BRAIN_OBSERVATION_TYPES, } from './facade.js';
@@ -38,7 +47,9 @@ export { SessionView } from './session.js';
38
47
  export type { AdapterSpawnProvider, SpawnContext, SpawnResult } from './spawn.js';
39
48
  export type { CAAMPSpawnOptions, CAAMPSpawnResult, CLEOSpawnAdapter, CLEOSpawnContext, CLEOSpawnResult, Provider, SpawnStatus, TokenResolution, } from './spawn-types.js';
40
49
  export { ADR_STATUSES, type AdrStatus, type EntityType, GATE_STATUSES, type GateStatus, isValidStatus, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, MANIFEST_STATUSES, type ManifestStatus, PIPELINE_STATUS_ICONS, type PipelineStatus, SESSION_STATUSES, type SessionStatus, STAGE_STATUS_ICONS, STATUS_REGISTRY, type StageStatus, TASK_STATUS_SYMBOLS_ASCII, TASK_STATUS_SYMBOLS_UNICODE, TASK_STATUSES, type TaskStatus, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES, TERMINAL_TASK_STATUSES, } from './status-registry.js';
41
- export type { CancelledTask, CompletedTask, EpicLifecycle, FileMeta, Phase, PhaseStatus, PhaseTransition, ProjectMeta, Release, ReleaseStatus, SessionNote, Task, TaskCreate, TaskOrigin, TaskPriority, TaskProvenance, TaskRelation, TaskSize, TaskType, TaskVerification, TaskWorkState, VerificationAgent, VerificationFailure, VerificationGate, } from './task.js';
50
+ export type { AcceptanceItem, CancelledTask, CompletedTask, EpicLifecycle, FileMeta, Phase, PhaseStatus, PhaseTransition, ProjectMeta, Release, ReleaseStatus, SessionNote, Task, TaskCreate, TaskOrigin, TaskPriority, TaskProvenance, TaskRelation, TaskSize, TaskType, TaskVerification, TaskWorkState, VerificationAgent, VerificationFailure, VerificationGate, } from './task.js';
51
+ export type { CommandOutputEvidence, FileEvidence, LogEvidence, ScreenshotEvidence, TaskEvidence, TaskEvidenceInput, TaskEvidenceKind, TestOutputEvidence, } from './task-evidence.js';
52
+ export { commandOutputEvidenceSchema, fileEvidenceSchema, logEvidenceSchema, screenshotEvidenceSchema, taskEvidenceSchema, testOutputEvidenceSchema, } from './task-evidence.js';
42
53
  export type { MinimalTaskRecord, TaskRecord, TaskRecordRelation, ValidationHistoryEntry, } from './task-record.js';
43
54
  export type { ConflictPolicy, ExternalLinkType, ExternalTask, ExternalTaskLink, ExternalTaskProvider, ExternalTaskStatus, ReconcileAction, ReconcileActionType, ReconcileOptions, ReconcileResult, SyncDirection, } from './task-sync.js';
44
55
  export type { TesseraInstantiationInput, TesseraTemplate, TesseraVariable, } from './tessera.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE7E,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE7D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,OAAO,EACP,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,wBAAwB,EACxB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAE1E,YAAY,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,SAAS,EACT,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1F,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,aAAa,EACb,eAAe,EACf,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,QAAQ,EACR,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,OAAO,EACP,eAAe,EACf,WAAW,GACZ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElF,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,YAAY,EACZ,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,aAAa,EACb,KAAK,UAAU,EACf,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,cAAc,EAEnB,qBAAqB,EACrB,KAAK,cAAc,EACnB,gBAAgB,EAChB,KAAK,aAAa,EAClB,kBAAkB,EAClB,eAAe,EACf,KAAK,WAAW,EAChB,yBAAyB,EACzB,2BAA2B,EAE3B,aAAa,EAEb,KAAK,UAAU,EACf,0BAA0B,EAC1B,uBAAuB,EAEvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,QAAQ,EACR,KAAK,EACL,WAAW,EACX,eAAe,EACf,WAAW,EACX,OAAO,EACP,aAAa,EACb,WAAW,EACX,IAAI,EACJ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,wBAAwB,EACxB,SAAS,EACT,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,UAAU,EACV,eAAe,EACf,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,SAAS,GACV,MAAM,iBAAiB,CAAC"}
package/dist/index.js CHANGED
@@ -5,8 +5,13 @@
5
5
  * All domain types (Task, Session, DataAccessor, etc.) are defined here.
6
6
  * Implementation packages (@cleocode/core, @cleocode/cleo) import from here.
7
7
  */
8
+ // === Acceptance Gate Zod Schemas (runtime validation) ===
9
+ export { acceptanceArraySchema, acceptanceGateResultSchema, acceptanceGateSchema, acceptanceItemSchema, commandGateSchema, fileAssertionSchema, fileGateSchema, gateBaseSchema, gateResultDetailsSchema, httpGateSchema, lintGateSchema, manualGateSchema, testGateSchema, } from './acceptance-gate-schema.js';
10
+ export { attachmentMetadataSchema, attachmentRefSchema, attachmentSchema, blobAttachmentSchema, llmsTxtAttachmentSchema, llmtxtDocAttachmentSchema, localFileAttachmentSchema, urlAttachmentSchema, } from './attachment-schema.js';
8
11
  // === Error Utilities ===
9
12
  export { createErrorResult, createSuccessResult, formatError, getErrorMessage, isErrorResult, isErrorType, normalizeError, } from './errors.js';
13
+ // === Evidence Record Zod Schemas (runtime validation) ===
14
+ export { commandOutputRecordSchema, evidenceRecordSchema, implDiffRecordSchema, lintReportRecordSchema, testOutputRecordSchema, validateSpecCheckRecordSchema, } from './evidence-record-schema.js';
10
15
  // === Exit Codes ===
11
16
  export { ExitCode, getExitCodeName, isErrorCode, isNoChangeCode, isRecoverableCode, isSuccessCode, } from './exit-codes.js';
12
17
  // === Facade API Interfaces ===
@@ -27,5 +32,6 @@ PIPELINE_STATUS_ICONS, SESSION_STATUSES, STAGE_STATUS_ICONS, STATUS_REGISTRY, TA
27
32
  TASK_STATUSES, TERMINAL_PIPELINE_STATUSES, TERMINAL_STAGE_STATUSES,
28
33
  // Terminal state sets
29
34
  TERMINAL_TASK_STATUSES, } from './status-registry.js';
35
+ export { commandOutputEvidenceSchema, fileEvidenceSchema, logEvidenceSchema, screenshotEvidenceSchema, taskEvidenceSchema, testOutputEvidenceSchema, } from './task-evidence.js';
30
36
  // === WASM SDK (Rust crate bindings) ===
31
37
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwHH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA6E9B,yCAAyC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA+CrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AA2FhC,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,GACf,MAAM,aAAa,CAAC;AAmBrB,2DAA2D;AAC3D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA+BzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAUnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAG7C,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAgCtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAwC9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAiD5B,yCAAyC"}
@@ -0,0 +1,251 @@
1
+ /**
2
+ * TaskEvidence discriminated union — typed evidence references for verification records.
3
+ *
4
+ * Replaces free-text evidence fields in verification records with structured,
5
+ * kind-specific evidence artifacts. Each variant carries a SHA-256 attachment
6
+ * reference, a timestamp, and optional description.
7
+ *
8
+ * Five evidence kinds are supported:
9
+ * - `file` — a file artifact (source file, output artifact, config)
10
+ * - `log` — a log stream captured from a process
11
+ * - `screenshot` — a visual capture (PNG/JPEG/WEBP)
12
+ * - `test-output` — structured test-runner output
13
+ * - `command-output` — raw stdout/stderr from a shell command
14
+ *
15
+ * @epic T760
16
+ * @task T801
17
+ * @see {@link AcceptanceGateResult} — `evidence` field
18
+ */
19
+ import { z } from 'zod';
20
+ /**
21
+ * Evidence for a file artifact produced or inspected during verification.
22
+ *
23
+ * The `sha256` is the content hash of the file at capture time, used to
24
+ * look up the blob in the attachment store.
25
+ */
26
+ export interface FileEvidence {
27
+ kind: 'file';
28
+ /** SHA-256 hex digest of the file at capture time (attachment ref). */
29
+ sha256: string;
30
+ /** ISO 8601 timestamp when evidence was captured. */
31
+ timestamp: string;
32
+ /** Path to the file, relative to the project root. */
33
+ path: string;
34
+ /** IANA MIME type of the file (e.g. `"text/typescript"`, `"application/pdf"`). */
35
+ mime?: string;
36
+ /** Optional human-readable note about this evidence artifact. */
37
+ description?: string;
38
+ }
39
+ /**
40
+ * Evidence for a log stream captured from a running process.
41
+ *
42
+ * The `sha256` is the content hash of the captured log text.
43
+ */
44
+ export interface LogEvidence {
45
+ kind: 'log';
46
+ /** SHA-256 hex digest of the captured log content. */
47
+ sha256: string;
48
+ /** ISO 8601 timestamp when evidence was captured. */
49
+ timestamp: string;
50
+ /**
51
+ * Source process name or description (e.g. `"pnpm test"`, `"node server.js"`).
52
+ */
53
+ source: string;
54
+ /** Optional human-readable note about this log artifact. */
55
+ description?: string;
56
+ }
57
+ /**
58
+ * Evidence for a screenshot or visual capture taken during verification.
59
+ *
60
+ * Used for manual gates and UI smoke tests. The `sha256` references the
61
+ * image blob in the attachment store.
62
+ */
63
+ export interface ScreenshotEvidence {
64
+ kind: 'screenshot';
65
+ /** SHA-256 hex digest of the image file. */
66
+ sha256: string;
67
+ /** ISO 8601 timestamp when evidence was captured. */
68
+ timestamp: string;
69
+ /**
70
+ * MIME type of the image.
71
+ *
72
+ * @defaultValue "image/png"
73
+ */
74
+ mime?: 'image/png' | 'image/jpeg' | 'image/webp';
75
+ /** Optional human-readable note (e.g. `"dark mode toggle on macOS Chrome"`). */
76
+ description?: string;
77
+ }
78
+ /**
79
+ * Evidence for structured test-runner output.
80
+ *
81
+ * Carries the summary metrics from the test run alongside the SHA-256
82
+ * reference to the full output blob.
83
+ */
84
+ export interface TestOutputEvidence {
85
+ kind: 'test-output';
86
+ /** SHA-256 hex digest of the full test-runner output. */
87
+ sha256: string;
88
+ /** ISO 8601 timestamp when evidence was captured. */
89
+ timestamp: string;
90
+ /** Number of tests that passed. */
91
+ passed: number;
92
+ /** Number of tests that failed. */
93
+ failed: number;
94
+ /** Number of tests skipped or pending. */
95
+ skipped: number;
96
+ /** Exit code of the test process. */
97
+ exitCode: number;
98
+ /** Optional human-readable note about the test run. */
99
+ description?: string;
100
+ }
101
+ /**
102
+ * Evidence for raw stdout/stderr output from a shell command.
103
+ *
104
+ * The `sha256` references the full output blob in the attachment store.
105
+ */
106
+ export interface CommandOutputEvidence {
107
+ kind: 'command-output';
108
+ /** SHA-256 hex digest of the full command output. */
109
+ sha256: string;
110
+ /** ISO 8601 timestamp when evidence was captured. */
111
+ timestamp: string;
112
+ /** The command that was run (e.g. `"pnpm run build"`). */
113
+ cmd: string;
114
+ /** Exit code of the command process. */
115
+ exitCode: number;
116
+ /** Optional human-readable note about the command run. */
117
+ description?: string;
118
+ }
119
+ /**
120
+ * A typed evidence artifact attached to a verification record.
121
+ *
122
+ * Replaces the bare `evidence?: string` field on {@link AcceptanceGateResult}
123
+ * with structured, kind-specific references backed by the attachment store.
124
+ *
125
+ * The `kind` field is the discriminant. All variants carry `sha256` (the
126
+ * attachment store ref), `timestamp`, and optional `description`.
127
+ *
128
+ * @example
129
+ * ```ts
130
+ * const ev: TaskEvidence = {
131
+ * kind: 'test-output',
132
+ * sha256: 'a1b2c3...ff',
133
+ * timestamp: '2026-04-15T10:00:00.000Z',
134
+ * passed: 42,
135
+ * failed: 0,
136
+ * skipped: 2,
137
+ * exitCode: 0,
138
+ * };
139
+ * ```
140
+ */
141
+ export type TaskEvidence = FileEvidence | LogEvidence | ScreenshotEvidence | TestOutputEvidence | CommandOutputEvidence;
142
+ /** All valid `kind` discriminants for `TaskEvidence`. */
143
+ export type TaskEvidenceKind = TaskEvidence['kind'];
144
+ /** Zod schema for {@link FileEvidence}. */
145
+ export declare const fileEvidenceSchema: z.ZodObject<{
146
+ kind: z.ZodLiteral<"file">;
147
+ sha256: z.ZodString;
148
+ timestamp: z.ZodString;
149
+ path: z.ZodString;
150
+ mime: z.ZodOptional<z.ZodString>;
151
+ description: z.ZodOptional<z.ZodString>;
152
+ }, z.core.$strip>;
153
+ /** Zod schema for {@link LogEvidence}. */
154
+ export declare const logEvidenceSchema: z.ZodObject<{
155
+ kind: z.ZodLiteral<"log">;
156
+ sha256: z.ZodString;
157
+ timestamp: z.ZodString;
158
+ source: z.ZodString;
159
+ description: z.ZodOptional<z.ZodString>;
160
+ }, z.core.$strip>;
161
+ /** Zod schema for {@link ScreenshotEvidence}. */
162
+ export declare const screenshotEvidenceSchema: z.ZodObject<{
163
+ kind: z.ZodLiteral<"screenshot">;
164
+ sha256: z.ZodString;
165
+ timestamp: z.ZodString;
166
+ mime: z.ZodOptional<z.ZodEnum<{
167
+ "image/png": "image/png";
168
+ "image/jpeg": "image/jpeg";
169
+ "image/webp": "image/webp";
170
+ }>>;
171
+ description: z.ZodOptional<z.ZodString>;
172
+ }, z.core.$strip>;
173
+ /** Zod schema for {@link TestOutputEvidence}. */
174
+ export declare const testOutputEvidenceSchema: z.ZodObject<{
175
+ kind: z.ZodLiteral<"test-output">;
176
+ sha256: z.ZodString;
177
+ timestamp: z.ZodString;
178
+ passed: z.ZodNumber;
179
+ failed: z.ZodNumber;
180
+ skipped: z.ZodNumber;
181
+ exitCode: z.ZodNumber;
182
+ description: z.ZodOptional<z.ZodString>;
183
+ }, z.core.$strip>;
184
+ /** Zod schema for {@link CommandOutputEvidence}. */
185
+ export declare const commandOutputEvidenceSchema: z.ZodObject<{
186
+ kind: z.ZodLiteral<"command-output">;
187
+ sha256: z.ZodString;
188
+ timestamp: z.ZodString;
189
+ cmd: z.ZodString;
190
+ exitCode: z.ZodNumber;
191
+ description: z.ZodOptional<z.ZodString>;
192
+ }, z.core.$strip>;
193
+ /**
194
+ * Zod discriminated-union schema for {@link TaskEvidence}.
195
+ *
196
+ * Uses `z.discriminatedUnion('kind', [...])` for O(1) variant lookup.
197
+ *
198
+ * @example
199
+ * ```ts
200
+ * const ev = taskEvidenceSchema.parse({
201
+ * kind: 'command-output',
202
+ * sha256: 'a'.repeat(64),
203
+ * timestamp: '2026-04-15T10:00:00.000Z',
204
+ * cmd: 'pnpm run build',
205
+ * exitCode: 0,
206
+ * });
207
+ * ```
208
+ */
209
+ export declare const taskEvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
210
+ kind: z.ZodLiteral<"file">;
211
+ sha256: z.ZodString;
212
+ timestamp: z.ZodString;
213
+ path: z.ZodString;
214
+ mime: z.ZodOptional<z.ZodString>;
215
+ description: z.ZodOptional<z.ZodString>;
216
+ }, z.core.$strip>, z.ZodObject<{
217
+ kind: z.ZodLiteral<"log">;
218
+ sha256: z.ZodString;
219
+ timestamp: z.ZodString;
220
+ source: z.ZodString;
221
+ description: z.ZodOptional<z.ZodString>;
222
+ }, z.core.$strip>, z.ZodObject<{
223
+ kind: z.ZodLiteral<"screenshot">;
224
+ sha256: z.ZodString;
225
+ timestamp: z.ZodString;
226
+ mime: z.ZodOptional<z.ZodEnum<{
227
+ "image/png": "image/png";
228
+ "image/jpeg": "image/jpeg";
229
+ "image/webp": "image/webp";
230
+ }>>;
231
+ description: z.ZodOptional<z.ZodString>;
232
+ }, z.core.$strip>, z.ZodObject<{
233
+ kind: z.ZodLiteral<"test-output">;
234
+ sha256: z.ZodString;
235
+ timestamp: z.ZodString;
236
+ passed: z.ZodNumber;
237
+ failed: z.ZodNumber;
238
+ skipped: z.ZodNumber;
239
+ exitCode: z.ZodNumber;
240
+ description: z.ZodOptional<z.ZodString>;
241
+ }, z.core.$strip>, z.ZodObject<{
242
+ kind: z.ZodLiteral<"command-output">;
243
+ sha256: z.ZodString;
244
+ timestamp: z.ZodString;
245
+ cmd: z.ZodString;
246
+ exitCode: z.ZodNumber;
247
+ description: z.ZodOptional<z.ZodString>;
248
+ }, z.core.$strip>], "kind">;
249
+ /** Inferred TypeScript type from {@link taskEvidenceSchema}. */
250
+ export type TaskEvidenceInput = z.input<typeof taskEvidenceSchema>;
251
+ //# sourceMappingURL=task-evidence.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-evidence.d.ts","sourceRoot":"","sources":["../src/task-evidence.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * TaskEvidence discriminated union — typed evidence references for verification records.
3
+ *
4
+ * Replaces free-text evidence fields in verification records with structured,
5
+ * kind-specific evidence artifacts. Each variant carries a SHA-256 attachment
6
+ * reference, a timestamp, and optional description.
7
+ *
8
+ * Five evidence kinds are supported:
9
+ * - `file` — a file artifact (source file, output artifact, config)
10
+ * - `log` — a log stream captured from a process
11
+ * - `screenshot` — a visual capture (PNG/JPEG/WEBP)
12
+ * - `test-output` — structured test-runner output
13
+ * - `command-output` — raw stdout/stderr from a shell command
14
+ *
15
+ * @epic T760
16
+ * @task T801
17
+ * @see {@link AcceptanceGateResult} — `evidence` field
18
+ */
19
+ import { z } from 'zod';
20
+ // ─── Zod schemas ─────────────────────────────────────────────────────────────
21
+ /** Zod schema for {@link FileEvidence}. */
22
+ export const fileEvidenceSchema = z.object({
23
+ kind: z.literal('file'),
24
+ sha256: z.string().length(64),
25
+ timestamp: z.string().datetime(),
26
+ path: z.string().min(1),
27
+ mime: z.string().optional(),
28
+ description: z.string().optional(),
29
+ });
30
+ /** Zod schema for {@link LogEvidence}. */
31
+ export const logEvidenceSchema = z.object({
32
+ kind: z.literal('log'),
33
+ sha256: z.string().length(64),
34
+ timestamp: z.string().datetime(),
35
+ source: z.string().min(1),
36
+ description: z.string().optional(),
37
+ });
38
+ /** Zod schema for {@link ScreenshotEvidence}. */
39
+ export const screenshotEvidenceSchema = z.object({
40
+ kind: z.literal('screenshot'),
41
+ sha256: z.string().length(64),
42
+ timestamp: z.string().datetime(),
43
+ mime: z.enum(['image/png', 'image/jpeg', 'image/webp']).optional(),
44
+ description: z.string().optional(),
45
+ });
46
+ /** Zod schema for {@link TestOutputEvidence}. */
47
+ export const testOutputEvidenceSchema = z.object({
48
+ kind: z.literal('test-output'),
49
+ sha256: z.string().length(64),
50
+ timestamp: z.string().datetime(),
51
+ passed: z.number().int().nonnegative(),
52
+ failed: z.number().int().nonnegative(),
53
+ skipped: z.number().int().nonnegative(),
54
+ exitCode: z.number().int(),
55
+ description: z.string().optional(),
56
+ });
57
+ /** Zod schema for {@link CommandOutputEvidence}. */
58
+ export const commandOutputEvidenceSchema = z.object({
59
+ kind: z.literal('command-output'),
60
+ sha256: z.string().length(64),
61
+ timestamp: z.string().datetime(),
62
+ cmd: z.string().min(1),
63
+ exitCode: z.number().int(),
64
+ description: z.string().optional(),
65
+ });
66
+ /**
67
+ * Zod discriminated-union schema for {@link TaskEvidence}.
68
+ *
69
+ * Uses `z.discriminatedUnion('kind', [...])` for O(1) variant lookup.
70
+ *
71
+ * @example
72
+ * ```ts
73
+ * const ev = taskEvidenceSchema.parse({
74
+ * kind: 'command-output',
75
+ * sha256: 'a'.repeat(64),
76
+ * timestamp: '2026-04-15T10:00:00.000Z',
77
+ * cmd: 'pnpm run build',
78
+ * exitCode: 0,
79
+ * });
80
+ * ```
81
+ */
82
+ export const taskEvidenceSchema = z.discriminatedUnion('kind', [
83
+ fileEvidenceSchema,
84
+ logEvidenceSchema,
85
+ screenshotEvidenceSchema,
86
+ testOutputEvidenceSchema,
87
+ commandOutputEvidenceSchema,
88
+ ]);
89
+ //# sourceMappingURL=task-evidence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-evidence.js","sourceRoot":"","sources":["../src/task-evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8IxB,gFAAgF;AAEhF,2CAA2C;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,0CAA0C;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC7D,kBAAkB;IAClB,iBAAiB;IACjB,wBAAwB;IACxB,wBAAwB;IACxB,2BAA2B;CAC5B,CAAC,CAAC"}