@openplanr/protocol 0.6.0 → 0.6.2

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 (55) hide show
  1. package/lib/dashboard/closed-json-contract.mjs +99 -109
  2. package/lib/dashboard/operate-experience-audit-display-contract.d.mts +128 -153
  3. package/lib/dashboard/operate-experience-audit-display-contract.mjs +530 -585
  4. package/lib/dashboard/operate-experience-display-contract.d.mts +415 -437
  5. package/lib/dashboard/operate-experience-display-contract.mjs +768 -831
  6. package/lib/dashboard/operate-experience-surface-contract.d.mts +143 -148
  7. package/lib/dashboard/operate-experience-surface-contract.mjs +72 -73
  8. package/lib/dashboard/operate-review-contract.d.mts +7 -14
  9. package/lib/dashboard/operate-review-contract.mjs +46 -42
  10. package/lib/dashboard/operate-review-display-workspace-contract.d.mts +2 -5
  11. package/lib/dashboard/operate-review-display-workspace-contract.mjs +158 -104
  12. package/lib/dashboard/operate-review-payload-safety.mjs +4 -2
  13. package/lib/dashboard/operate-review-workspace-projection-v2.d.mts +47 -33
  14. package/lib/protocol/index.d.ts +2647 -543
  15. package/package.json +1 -1
  16. package/registries/commands.json +7 -7
  17. package/registries/skills.json +6 -6
  18. package/src/browser-contracts.d.mts +4 -1
  19. package/src/browser-contracts.mjs +16 -5
  20. package/src/canonical-json.d.mts +3 -1
  21. package/src/canonical-json.mjs +57 -20
  22. package/src/compat/live-evidence-v2.mjs +1604 -485
  23. package/src/compat/operate-experience-live-patch.mjs +67 -15
  24. package/src/compat/operating-planning-contracts.mjs +183 -51
  25. package/src/contracts.d.mts +54 -13
  26. package/src/contracts.mjs +655 -345
  27. package/src/design-contracts.mjs +58 -21
  28. package/src/design-handoff-contracts.d.mts +67 -11
  29. package/src/design-handoff-contracts.mjs +243 -98
  30. package/src/design-publication-contracts.mjs +98 -33
  31. package/src/diagram-authoring-contracts.d.mts +422 -78
  32. package/src/diagram-authoring-contracts.mjs +1697 -326
  33. package/src/diagram-contracts.d.mts +4 -1
  34. package/src/diagram-contracts.mjs +16 -4
  35. package/src/enterprise-contracts.d.mts +211 -46
  36. package/src/enterprise-contracts.mjs +727 -175
  37. package/src/errors.mjs +4 -0
  38. package/src/generated/canonical-registries.mjs +13 -13
  39. package/src/index.d.mts +8 -8
  40. package/src/index.mjs +36 -20
  41. package/src/json-schema.d.mts +21 -6
  42. package/src/json-schema.mjs +66 -18
  43. package/src/planning-contracts.d.mts +8 -2
  44. package/src/planning-contracts.mjs +33 -7
  45. package/src/registries.d.mts +11 -3
  46. package/src/registries.mjs +369 -87
  47. package/src/review-experience-contracts.d.mts +7 -2
  48. package/src/review-experience-contracts.mjs +198 -49
  49. package/src/semver.mjs +5 -1
  50. package/src/skill-source-contracts.d.mts +36 -16
  51. package/src/skill-source-contracts.mjs +25 -6
  52. package/src/task-contracts.d.mts +13 -3
  53. package/src/task-contracts.mjs +181 -40
  54. package/src/workspace-contracts.d.mts +38 -10
  55. package/src/workspace-contracts.mjs +147 -33
@@ -1,8 +1,7 @@
1
1
  import type { JsonValue, ProtocolValidationError } from '../protocol/index.js';
2
2
  import type { OperateReviewWorkspacePayloadV1 } from './operate-review-workspace-projection-v2.mjs';
3
3
 
4
- export const OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN:
5
- 'openplanr:operate-review-display-workspace:1.0.0';
4
+ export const OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN: 'openplanr:operate-review-display-workspace:1.0.0';
6
5
 
7
6
  export type OperateReviewDisplayWorkspaceIntegrityV1 = Readonly<{
8
7
  algorithm: 'sha-256-jcs';
@@ -49,6 +48,4 @@ export function issueOperateReviewDisplayWorkspaceV1(
49
48
  payload: OperateReviewWorkspacePayloadV1,
50
49
  ): OperateReviewDisplayWorkspaceV1;
51
50
 
52
- export const OPERATE_REVIEW_DISPLAY_WORKSPACE_SCHEMA_V1: Readonly<
53
- Record<string, JsonValue>
54
- >;
51
+ export const OPERATE_REVIEW_DISPLAY_WORKSPACE_SCHEMA_V1: Readonly<Record<string, JsonValue>>;
@@ -1,5 +1,4 @@
1
1
  import { validateJson } from '../../src/json-schema.mjs';
2
- import { assertOperateReviewWorkspacePayloadSafeV1 } from './operate-review-payload-safety.mjs';
3
2
  import {
4
3
  contentHash,
5
4
  deepFreeze,
@@ -10,15 +9,16 @@ import {
10
9
  } from './closed-json-contract.mjs';
11
10
  import {
12
11
  OPERATE_ALLOWED_ACTION_SCHEMA_REVIEW_SLICE as allowedActionSchema,
13
- OPERATE_EXPERIENCE_VIEW_SCHEMA_REVIEW_SLICE as experienceViewSchema,
14
- OPERATE_REVIEW_DISPLAY_WORKSPACE_SCHEMA_REVIEW_SLICE as reviewWorkspaceSchema,
15
12
  OPERATING_ASSIGNMENT_SCHEMA_REVIEW_SLICE as assignmentSchema,
16
13
  OPERATING_EVIDENCE_RESOLUTION_SCHEMA_REVIEW_SLICE as evidenceResolutionSchema,
14
+ OPERATE_EXPERIENCE_VIEW_SCHEMA_REVIEW_SLICE as experienceViewSchema,
17
15
  OPERATING_REVIEW_READ_SCHEMA_REVIEW_SLICE as reviewReadSchema,
18
16
  OPERATING_REVIEW_RECEIPT_SCHEMA_REVIEW_SLICE as reviewReceiptSchema,
19
17
  OPERATING_REVIEW_SCHEMA_REVIEW_SLICE as reviewSchema,
18
+ OPERATE_REVIEW_DISPLAY_WORKSPACE_SCHEMA_REVIEW_SLICE as reviewWorkspaceSchema,
20
19
  OPERATING_TRACE_MATRIX_SCHEMA_REVIEW_SLICE as traceMatrixSchema,
21
20
  } from './generated/operate-review-schema-data.mjs';
21
+ import { assertOperateReviewWorkspacePayloadSafeV1 } from './operate-review-payload-safety.mjs';
22
22
 
23
23
  export const OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN =
24
24
  'openplanr:operate-review-display-workspace:1.0.0';
@@ -58,7 +58,13 @@ function resolveSchemaRef(reference) {
58
58
  }
59
59
 
60
60
  function invalid() {
61
- return [{ path: '$', rule: 'closedContract', detail: 'does not satisfy the closed Review display workspace contract' }];
61
+ return [
62
+ {
63
+ path: '$',
64
+ rule: 'closedContract',
65
+ detail: 'does not satisfy the closed Review display workspace contract',
66
+ },
67
+ ];
62
68
  }
63
69
 
64
70
  function unique(records, field) {
@@ -67,75 +73,114 @@ function unique(records, field) {
67
73
 
68
74
  function exactExpected(payload, expected) {
69
75
  if (!expected) return true;
70
- return payload.actorId === expected.actorId
71
- && payload.scopeId === expected.scopeId
72
- && payload.domainId === expected.domainId
73
- && payload.domainVersion === expected.domainVersion
74
- && payload.cycleId === expected.cycleId
75
- && payload.reviewId === expected.reviewId
76
- && payload.sourceArtifactKind === expected.sourceArtifactKind
77
- && payload.sourceArtifactHash === expected.sourceArtifactHash
78
- && payload.sourceViewHash === expected.sourceViewHash
79
- && exactEventHead(payload.sourceEventHead, expected.sourceEventHead)
80
- && exactEventHead(payload.sourceReadEventHead, expected.sourceReadEventHead);
76
+ return (
77
+ payload.actorId === expected.actorId &&
78
+ payload.scopeId === expected.scopeId &&
79
+ payload.domainId === expected.domainId &&
80
+ payload.domainVersion === expected.domainVersion &&
81
+ payload.cycleId === expected.cycleId &&
82
+ payload.reviewId === expected.reviewId &&
83
+ payload.sourceArtifactKind === expected.sourceArtifactKind &&
84
+ payload.sourceArtifactHash === expected.sourceArtifactHash &&
85
+ payload.sourceViewHash === expected.sourceViewHash &&
86
+ exactEventHead(payload.sourceEventHead, expected.sourceEventHead) &&
87
+ exactEventHead(payload.sourceReadEventHead, expected.sourceReadEventHead)
88
+ );
81
89
  }
82
90
 
83
91
  function validSummary(summary) {
84
- const stageStates = ['complete', 'current', 'available', 'waiting', 'blocked', 'failed', 'skipped', 'uncertain', 'revisited'];
85
- if (summary.stages.total !== summary.stages.cycles * 7
86
- || summary.stages.byStage.length !== 7
87
- || new Set(summary.stages.byStage.map(({ id }) => id)).size !== 7
88
- || stageStates.some((state) => summary.stages[state] !== summary.stages.byStage.reduce((total, stage) => total + stage[state], 0))
89
- || summary.seats.terminal !== summary.seats.validated + summary.seats.rejected + summary.seats.failed + summary.seats.abandoned
90
- || summary.seats.total !== summary.seats.terminal + summary.seats.active + summary.seats.pending
91
- || summary.evidence.total !== summary.evidence.available + summary.evidence.restricted
92
- || summary.evidence.total !== summary.evidence.current + summary.evidence.historical + summary.evidence.stale
93
- || summary.evidence.linked > summary.evidence.total
94
- || summary.proof.linkedEvidence !== summary.evidence.linked
95
- || summary.proof.restrictedEvidence !== summary.evidence.restricted
96
- || summary.proof.resolvedClaims !== summary.claims.supported + summary.claims.contradicted
97
- || summary.proof.unresolvedClaims !== summary.claims.uncertain + summary.claims.unknown + summary.claims.restricted
98
- || summary.claims.total !== summary.proof.resolvedClaims + summary.proof.unresolvedClaims
99
- || summary.verification.total !== summary.verification.verified + summary.verification.unverified
100
- + summary.verification.notRequired + summary.verification.insufficientEvidence
101
- || summary.proof.verifiedOutcomes !== summary.verification.verified
102
- || summary.proof.unverifiedOutcomes !== summary.verification.unverified + summary.verification.insufficientEvidence
103
- || summary.omissions.total !== summary.omissions.restricted + summary.omissions.absent) {
92
+ const stageStates = [
93
+ 'complete',
94
+ 'current',
95
+ 'available',
96
+ 'waiting',
97
+ 'blocked',
98
+ 'failed',
99
+ 'skipped',
100
+ 'uncertain',
101
+ 'revisited',
102
+ ];
103
+ if (
104
+ summary.stages.total !== summary.stages.cycles * 7 ||
105
+ summary.stages.byStage.length !== 7 ||
106
+ new Set(summary.stages.byStage.map(({ id }) => id)).size !== 7 ||
107
+ stageStates.some(
108
+ (state) =>
109
+ summary.stages[state] !==
110
+ summary.stages.byStage.reduce((total, stage) => total + stage[state], 0),
111
+ ) ||
112
+ summary.seats.terminal !==
113
+ summary.seats.validated +
114
+ summary.seats.rejected +
115
+ summary.seats.failed +
116
+ summary.seats.abandoned ||
117
+ summary.seats.total !== summary.seats.terminal + summary.seats.active + summary.seats.pending ||
118
+ summary.evidence.total !== summary.evidence.available + summary.evidence.restricted ||
119
+ summary.evidence.total !==
120
+ summary.evidence.current + summary.evidence.historical + summary.evidence.stale ||
121
+ summary.evidence.linked > summary.evidence.total ||
122
+ summary.proof.linkedEvidence !== summary.evidence.linked ||
123
+ summary.proof.restrictedEvidence !== summary.evidence.restricted ||
124
+ summary.proof.resolvedClaims !== summary.claims.supported + summary.claims.contradicted ||
125
+ summary.proof.unresolvedClaims !==
126
+ summary.claims.uncertain + summary.claims.unknown + summary.claims.restricted ||
127
+ summary.claims.total !== summary.proof.resolvedClaims + summary.proof.unresolvedClaims ||
128
+ summary.verification.total !==
129
+ summary.verification.verified +
130
+ summary.verification.unverified +
131
+ summary.verification.notRequired +
132
+ summary.verification.insufficientEvidence ||
133
+ summary.proof.verifiedOutcomes !== summary.verification.verified ||
134
+ summary.proof.unverifiedOutcomes !==
135
+ summary.verification.unverified + summary.verification.insufficientEvidence ||
136
+ summary.omissions.total !== summary.omissions.restricted + summary.omissions.absent
137
+ ) {
104
138
  return false;
105
139
  }
106
140
  return true;
107
141
  }
108
142
 
109
143
  function validChoice(choice, payload) {
110
- return choice.choiceHash === jcsHash(choice.submitArguments)
111
- && choice.submitArguments.reviewId === payload.reviewId
112
- && choice.submitArguments.cycleId === payload.cycleId
113
- && choice.submitArguments.actor.actorId === payload.actorId
114
- && exactJson(choice.submitArguments.scope, {
144
+ return (
145
+ choice.choiceHash === jcsHash(choice.submitArguments) &&
146
+ choice.submitArguments.reviewId === payload.reviewId &&
147
+ choice.submitArguments.cycleId === payload.cycleId &&
148
+ choice.submitArguments.actor.actorId === payload.actorId &&
149
+ exactJson(choice.submitArguments.scope, {
115
150
  scopeId: payload.scopeId,
116
151
  domainId: payload.domainId,
117
152
  domainVersion: payload.domainVersion,
118
- })
119
- && exactJson(choice.requiredDispositions, choice.submitArguments.workDispositions)
120
- && choice.reversibility === 'immutable-review-event';
153
+ }) &&
154
+ exactJson(choice.requiredDispositions, choice.submitArguments.workDispositions) &&
155
+ choice.reversibility === 'immutable-review-event'
156
+ );
121
157
  }
122
158
 
123
159
  function validCapability(payload) {
124
160
  const { capability, choices } = payload.data;
125
- if (!capability.available) return capability.actions.length === 0 && payload.mutationEnabled === false;
126
- if (payload.sourceArtifactKind !== 'operating-review-read'
127
- || payload.status !== 'ready'
128
- || payload.mutationEnabled !== true
129
- || capability.actions.length !== choices.length) return false;
130
- const choiceByArguments = new Map(choices.map((choice) => [jcsHash(choice.submitArguments), choice]));
161
+ if (!capability.available)
162
+ return capability.actions.length === 0 && payload.mutationEnabled === false;
163
+ if (
164
+ payload.sourceArtifactKind !== 'operating-review-read' ||
165
+ payload.status !== 'ready' ||
166
+ payload.mutationEnabled !== true ||
167
+ capability.actions.length !== choices.length
168
+ )
169
+ return false;
170
+ const choiceByArguments = new Map(
171
+ choices.map((choice) => [jcsHash(choice.submitArguments), choice]),
172
+ );
131
173
  if (choiceByArguments.size !== choices.length) return false;
132
174
  const matched = new Set();
133
175
  for (const action of capability.actions) {
134
176
  const digest = jcsHash(action.action.arguments);
135
- if (action.subjectId !== payload.reviewId
136
- || action.action.tool !== 'operate.review.submit'
137
- || action.action.effect !== 'project-write'
138
- || !choiceByArguments.has(digest)) return false;
177
+ if (
178
+ action.subjectId !== payload.reviewId ||
179
+ action.action.tool !== 'operate.review.submit' ||
180
+ action.action.effect !== 'project-write' ||
181
+ !choiceByArguments.has(digest)
182
+ )
183
+ return false;
139
184
  matched.add(digest);
140
185
  }
141
186
  return matched.size === choices.length;
@@ -144,58 +189,65 @@ function validCapability(payload) {
144
189
  function validTerminalDisposition(payload) {
145
190
  const disposition = payload.data.terminalDisposition;
146
191
  if (payload.sourceArtifactKind === 'operating-review-read') {
147
- return disposition === null
148
- && payload.data.review.state === 'pending'
149
- && payload.data.review.disposition === null
150
- && payload.data.choices.length > 0
151
- && exactEventHead(payload.sourceReadEventHead, payload.sourceEventHead);
192
+ return (
193
+ disposition === null &&
194
+ payload.data.review.state === 'pending' &&
195
+ payload.data.review.disposition === null &&
196
+ payload.data.choices.length > 0 &&
197
+ exactEventHead(payload.sourceReadEventHead, payload.sourceEventHead)
198
+ );
152
199
  }
153
- return payload.status === 'terminal'
154
- && payload.reasonCodes.includes('REVIEW_TERMINAL')
155
- && payload.mutationEnabled === false
156
- && payload.data.choices.length === 0
157
- && payload.data.capability.available === false
158
- && payload.data.capability.actions.length === 0
159
- && payload.data.capability.reason.code === 'REVIEW_TERMINAL'
160
- && disposition !== null
161
- && disposition.decision === payload.data.review.state
162
- && payload.data.review.disposition === disposition.decision
163
- && exactJson(payload.data.review.workDispositions, disposition.appliedWorkDispositions)
164
- && exactEventHead(disposition.readEventHead, payload.sourceReadEventHead)
165
- && exactEventHead(disposition.eventHead, payload.sourceEventHead);
200
+ return (
201
+ payload.status === 'terminal' &&
202
+ payload.reasonCodes.includes('REVIEW_TERMINAL') &&
203
+ payload.mutationEnabled === false &&
204
+ payload.data.choices.length === 0 &&
205
+ payload.data.capability.available === false &&
206
+ payload.data.capability.actions.length === 0 &&
207
+ payload.data.capability.reason.code === 'REVIEW_TERMINAL' &&
208
+ disposition !== null &&
209
+ disposition.decision === payload.data.review.state &&
210
+ payload.data.review.disposition === disposition.decision &&
211
+ exactJson(payload.data.review.workDispositions, disposition.appliedWorkDispositions) &&
212
+ exactEventHead(disposition.readEventHead, payload.sourceReadEventHead) &&
213
+ exactEventHead(disposition.eventHead, payload.sourceEventHead)
214
+ );
166
215
  }
167
216
 
168
217
  function validWorkspaceSemantics(value, expected) {
169
218
  const { payload, integrity } = value;
170
219
  const { data } = payload;
171
- if (integrity.domain !== OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN
172
- || integrity.sourceArtifactKind !== payload.sourceArtifactKind
173
- || integrity.sourceViewHash !== payload.sourceViewHash
174
- || integrity.sourceArtifactHash !== payload.sourceArtifactHash
175
- || data.review.reviewId !== payload.reviewId
176
- || data.review.cycleId !== payload.cycleId
177
- || data.policyBinding.ownerActorId !== data.review.ownerActorId
178
- || data.policyBinding.actorMatchesOwner !== (payload.actorId === data.review.ownerActorId)
179
- || data.policyBinding.actorMatchesOwner !== true
180
- || !exactEventHead(data.truthSummary.sourceEventHead, payload.sourceEventHead)
181
- || data.truthSummary.sourceViewHash !== payload.sourceViewHash
182
- || data.executiveSummary.decisionCount !== data.recommendation.items.length
183
- || data.executiveSummary.findingCount !== data.findings.length
184
- || data.executiveSummary.dissentCount !== data.dissent.length
185
- || data.executiveSummary.gapCount !== data.gaps.length
186
- || data.executiveSummary.uncertaintyCount !== data.uncertainty.length
187
- || !unique(data.choices, 'choiceId')
188
- || !unique(data.findings, 'findingId')
189
- || !unique(data.dissent, 'localDissentId')
190
- || !unique(data.uncertainty, 'uncertaintyId')
191
- || !unique(data.gaps, 'absenceId')
192
- || !unique(data.claims, 'claimId')
193
- || !unique(data.evidence, 'evidenceRefId')
194
- || data.choices.some((choice) => !validChoice(choice, payload))
195
- || !validCapability(payload)
196
- || !validTerminalDisposition(payload)
197
- || !validSummary(data.truthSummary)
198
- || !exactExpected(payload, expected)) return false;
220
+ if (
221
+ integrity.domain !== OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN ||
222
+ integrity.sourceArtifactKind !== payload.sourceArtifactKind ||
223
+ integrity.sourceViewHash !== payload.sourceViewHash ||
224
+ integrity.sourceArtifactHash !== payload.sourceArtifactHash ||
225
+ data.review.reviewId !== payload.reviewId ||
226
+ data.review.cycleId !== payload.cycleId ||
227
+ data.policyBinding.ownerActorId !== data.review.ownerActorId ||
228
+ data.policyBinding.actorMatchesOwner !== (payload.actorId === data.review.ownerActorId) ||
229
+ data.policyBinding.actorMatchesOwner !== true ||
230
+ !exactEventHead(data.truthSummary.sourceEventHead, payload.sourceEventHead) ||
231
+ data.truthSummary.sourceViewHash !== payload.sourceViewHash ||
232
+ data.executiveSummary.decisionCount !== data.recommendation.items.length ||
233
+ data.executiveSummary.findingCount !== data.findings.length ||
234
+ data.executiveSummary.dissentCount !== data.dissent.length ||
235
+ data.executiveSummary.gapCount !== data.gaps.length ||
236
+ data.executiveSummary.uncertaintyCount !== data.uncertainty.length ||
237
+ !unique(data.choices, 'choiceId') ||
238
+ !unique(data.findings, 'findingId') ||
239
+ !unique(data.dissent, 'localDissentId') ||
240
+ !unique(data.uncertainty, 'uncertaintyId') ||
241
+ !unique(data.gaps, 'absenceId') ||
242
+ !unique(data.claims, 'claimId') ||
243
+ !unique(data.evidence, 'evidenceRefId') ||
244
+ data.choices.some((choice) => !validChoice(choice, payload)) ||
245
+ !validCapability(payload) ||
246
+ !validTerminalDisposition(payload) ||
247
+ !validSummary(data.truthSummary) ||
248
+ !exactExpected(payload, expected)
249
+ )
250
+ return false;
199
251
  try {
200
252
  assertOperateReviewWorkspacePayloadSafeV1(payload);
201
253
  } catch {
@@ -214,10 +266,10 @@ export function validateOperateReviewDisplayWorkspaceV1(value, expected) {
214
266
  if (errors.length > 0 || !validWorkspaceSemantics(clone, expected)) {
215
267
  return errors.length > 0 ? errors : invalid();
216
268
  }
217
- return clone.integrity.contentHash === contentHash(
218
- clone.payload,
219
- OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN,
220
- ) ? [] : invalid();
269
+ return clone.integrity.contentHash ===
270
+ contentHash(clone.payload, OPERATE_REVIEW_DISPLAY_WORKSPACE_DOMAIN)
271
+ ? []
272
+ : invalid();
221
273
  } catch {
222
274
  return invalid();
223
275
  }
@@ -225,7 +277,9 @@ export function validateOperateReviewDisplayWorkspaceV1(value, expected) {
225
277
 
226
278
  export function assertOperateReviewDisplayWorkspaceV1(value, expected) {
227
279
  if (validateOperateReviewDisplayWorkspaceV1(value, expected).length > 0) {
228
- const error = new TypeError('The Review display workspace does not satisfy its closed integrity contract.');
280
+ const error = new TypeError(
281
+ 'The Review display workspace does not satisfy its closed integrity contract.',
282
+ );
229
283
  error.code = 'E_OPERATE_REVIEW_DISPLAY_INVALID';
230
284
  throw error;
231
285
  }
@@ -1,5 +1,7 @@
1
- const PRIVATE_PATH = /(?:\bfile:\/\/|(?:^|[\s"'(=])\/(?:Users|home|private|tmp|var|Volumes|etc|opt|root|srv)\/|\b[A-Za-z]:\\(?:Users|Documents and Settings|Windows|ProgramData)\\)/u;
2
- const SECRET_BODY = /(?:-----BEGIN [A-Z ]*PRIVATE KEY-----|\b(?:api[_-]?key|access[_-]?token|refresh[_-]?token|password|passwd|authorization|client[_-]?secret)\s*[:=]\s*[^\s,;]+|\bBearer\s+[A-Za-z0-9._~+\/-]{12,})/iu;
1
+ const PRIVATE_PATH =
2
+ /(?:\bfile:\/\/|(?:^|[\s"'(=])\/(?:Users|home|private|tmp|var|Volumes|etc|opt|root|srv)\/|\b[A-Za-z]:\\(?:Users|Documents and Settings|Windows|ProgramData)\\)/u;
3
+ const SECRET_BODY =
4
+ /(?:-----BEGIN [A-Z ]*PRIVATE KEY-----|\b(?:api[_-]?key|access[_-]?token|refresh[_-]?token|password|passwd|authorization|client[_-]?secret)\s*[:=]\s*[^\s,;]+|\bBearer\s+[A-Za-z0-9._~+\/-]{12,})/iu;
3
5
 
4
6
  function unsafeReviewWorkspaceError(path, reason) {
5
7
  const error = new Error('Review workspace contains unsafe display text.');
@@ -2,19 +2,17 @@ import type {
2
2
  OperateAllowedActionV2,
3
3
  OperateExperienceAccessLevelV1,
4
4
  OperateExperienceClaimV1,
5
- OperateExperienceEvidenceV1,
6
5
  OperateExperienceEventHeadV1,
6
+ OperateExperienceEvidenceV1,
7
7
  OperateExperienceViewV1,
8
8
  OperatingReviewReadV2,
9
9
  OperatingReviewReceiptV2,
10
10
  OperatingReviewV2,
11
- OperatingWorkDispositionV2,
12
11
  OperatingTraceMatrixV2,
12
+ OperatingWorkDispositionV2,
13
13
  } from '../protocol/index.js';
14
14
 
15
- export type OperateReviewWorkspaceSourceV1 =
16
- | OperatingReviewReadV2
17
- | OperatingReviewReceiptV2;
15
+ export type OperateReviewWorkspaceSourceV1 = OperatingReviewReadV2 | OperatingReviewReceiptV2;
18
16
 
19
17
  export type OperateSharedTruthEventHeadV1 =
20
18
  | Readonly<{ sequence: 0; hash: null }>
@@ -37,18 +35,20 @@ export type OperateSharedTruthSummaryV1 = Readonly<{
37
35
  skipped: number;
38
36
  uncertain: number;
39
37
  revisited: number;
40
- byStage: ReadonlyArray<Readonly<{
41
- id: 'observe' | 'understand' | 'decide' | 'govern' | 'act' | 'verify' | 'learn';
42
- complete: number;
43
- current: number;
44
- available: number;
45
- waiting: number;
46
- blocked: number;
47
- failed: number;
48
- skipped: number;
49
- uncertain: number;
50
- revisited: number;
51
- }>>;
38
+ byStage: ReadonlyArray<
39
+ Readonly<{
40
+ id: 'observe' | 'understand' | 'decide' | 'govern' | 'act' | 'verify' | 'learn';
41
+ complete: number;
42
+ current: number;
43
+ available: number;
44
+ waiting: number;
45
+ blocked: number;
46
+ failed: number;
47
+ skipped: number;
48
+ uncertain: number;
49
+ revisited: number;
50
+ }>
51
+ >;
52
52
  }>;
53
53
  proof: Readonly<{
54
54
  status: 'verified' | 'unverified' | 'partial' | 'not-required';
@@ -159,27 +159,39 @@ export type OperateReviewWorkspacePayloadV1 = Readonly<{
159
159
  uncertaintyCount: number;
160
160
  }>;
161
161
  recommendation:
162
- | Readonly<{ status: 'available'; items: ReadonlyArray<OperatingReviewReadV2['decisions'][number]>; absence: null }>
163
- | Readonly<{ status: 'absent'; items: readonly []; absence: Readonly<{ code: string; message: string }> }>;
162
+ | Readonly<{
163
+ status: 'available';
164
+ items: ReadonlyArray<OperatingReviewReadV2['decisions'][number]>;
165
+ absence: null;
166
+ }>
167
+ | Readonly<{
168
+ status: 'absent';
169
+ items: readonly [];
170
+ absence: Readonly<{ code: string; message: string }>;
171
+ }>;
164
172
  choices: readonly OperateReviewDisplayChoiceV1[];
165
173
  findings: ReadonlyArray<OperatingReviewReadV2['findings'][number]>;
166
174
  dissent: ReadonlyArray<OperatingReviewReadV2['dissent'][number]>;
167
- uncertainty: ReadonlyArray<Readonly<{
168
- uncertaintyId: string;
169
- sourceKind: 'decision' | 'claim' | 'evidence' | 'gap';
170
- sourceId: string;
171
- statement: string;
172
- }>>;
175
+ uncertainty: ReadonlyArray<
176
+ Readonly<{
177
+ uncertaintyId: string;
178
+ sourceKind: 'decision' | 'claim' | 'evidence' | 'gap';
179
+ sourceId: string;
180
+ statement: string;
181
+ }>
182
+ >;
173
183
  gaps: ReadonlyArray<OperatingReviewReadV2['gaps'][number]>;
174
184
  claims: readonly OperateExperienceClaimV1[];
175
185
  evidence: readonly OperateExperienceEvidenceV1[];
176
- omissions: ReadonlyArray<Readonly<{
177
- kind: 'restricted' | 'absent';
178
- subject: 'evidence' | 'claim' | 'seat' | 'source';
179
- count: number;
180
- subjectIds: readonly string[];
181
- reasonCode: string;
182
- }>>;
186
+ omissions: ReadonlyArray<
187
+ Readonly<{
188
+ kind: 'restricted' | 'absent';
189
+ subject: 'evidence' | 'claim' | 'seat' | 'source';
190
+ count: number;
191
+ subjectIds: readonly string[];
192
+ reasonCode: string;
193
+ }>
194
+ >;
183
195
  traceMatrix: OperatingTraceMatrixV2 | null;
184
196
  truthSummary: OperateSharedTruthSummaryV1;
185
197
  terminalDisposition: null | Readonly<{
@@ -195,7 +207,9 @@ export type OperateReviewWorkspacePayloadV1 = Readonly<{
195
207
  capability:
196
208
  | Readonly<{
197
209
  available: true;
198
- actions: ReadonlyArray<Readonly<{ subjectId: string; action: OperateAllowedActionV2<'operate.review.submit'> }>>;
210
+ actions: ReadonlyArray<
211
+ Readonly<{ subjectId: string; action: OperateAllowedActionV2<'operate.review.submit'> }>
212
+ >;
199
213
  reason: null;
200
214
  }>
201
215
  | Readonly<{