@consiliency/contract 0.0.1 → 0.2.0
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.
- package/README.md +44 -4
- package/conformance/vectors/adoption-absent-ungoverned.json +16 -0
- package/conformance/vectors/adoption-adopted-governed.json +18 -0
- package/conformance/vectors/adoption-declared-false-ungoverned.json +17 -0
- package/conformance/vectors/adoption-partial-scope.json +18 -0
- package/conformance/vectors/canonical-html-contract-loaded.json +15 -0
- package/conformance/vectors/coordination-announce-intent-does-not-lease.json +38 -0
- package/conformance/vectors/coordination-done-does-not-release-lease.json +38 -0
- package/conformance/vectors/coordination-handoff-does-not-transfer-holder.json +38 -0
- package/conformance/vectors/coordination-message-does-not-mutate-lease.json +38 -0
- package/conformance/vectors/doc-label-foreign-governed-false.json +19 -0
- package/conformance/vectors/doc-label-present-nonconforming.json +19 -0
- package/conformance/vectors/edge-label-unmanaged-cross-repo.json +30 -0
- package/conformance/vectors/governed-set-undeclared-ungoverned.json +18 -0
- package/conformance/vectors/ignore-set-nested-path-any-depth.json +19 -0
- package/conformance/vectors/ignore-set-scratch-never-governed.json +19 -0
- package/conformance/vectors/interface-invalid-host-path.json +26 -0
- package/conformance/vectors/interface-valid-realized-and-promised.json +36 -0
- package/conformance/vectors/lease-acquire.json +35 -0
- package/conformance/vectors/lease-event-carries-lease.json +28 -0
- package/conformance/vectors/lease-expire.json +25 -0
- package/conformance/vectors/lease-expiry-boundary.json +25 -0
- package/conformance/vectors/lease-hard-degrades-to-soft.json +35 -0
- package/conformance/vectors/lease-hard-mode-atomic.json +35 -0
- package/conformance/vectors/lease-release.json +26 -0
- package/conformance/vectors/lease-renew.json +36 -0
- package/conformance/vectors/loop-gate-invalid-blocking-default.json +15 -0
- package/conformance/vectors/loop-gate-missing-doc-warns.json +16 -0
- package/conformance/vectors/manifest-invalid-absolute-path.json +20 -0
- package/conformance/vectors/manifest-invalid-certified-maturity.json +20 -0
- package/conformance/vectors/manifest-invalid-path-and-ref.json +20 -0
- package/conformance/vectors/manifest-invalid-unknown-archetype.json +18 -0
- package/conformance/vectors/manifest-valid-baseline-only.json +20 -0
- package/conformance/vectors/manifest-valid-product.json +21 -0
- package/conformance/vectors/version-skew-compatible.json +15 -0
- package/conformance/vectors/version-skew-incompatible-warns.json +15 -0
- package/core/canonical-html/contract-v1.json +459 -0
- package/core/canonical-html/provenance.json +22 -0
- package/core/contract.json +55 -0
- package/core/registries/archetypes.json +62 -0
- package/core/registries/default-ignore-set.json +30 -0
- package/core/registries/document-classes.json +33 -0
- package/core/registries/maturity-labels.json +48 -0
- package/core/registries/required-documents.json +74 -0
- package/core/schemas/canonical-html-v1.schema.json +15 -0
- package/core/schemas/contract-version-status.schema.json +26 -0
- package/core/schemas/coordination-channel-protocol.schema.json +53 -0
- package/core/schemas/coordination-scenario.schema.json +67 -0
- package/core/schemas/decision.schema.json +31 -0
- package/core/schemas/governance-scope-scenario.schema.json +62 -0
- package/core/schemas/interface-declaration.schema.json +69 -0
- package/core/schemas/lease-event.schema.json +17 -0
- package/core/schemas/lease-store-protocol.schema.json +117 -0
- package/core/schemas/lease.schema.json +42 -0
- package/core/schemas/loop-gate-protocol.schema.json +25 -0
- package/core/schemas/loop-gate-scenario.schema.json +25 -0
- package/core/schemas/manifest.schema.json +140 -0
- package/core/schemas/version-skew-protocol.schema.json +32 -0
- package/core/schemas/version-skew-scenario.schema.json +13 -0
- package/package.json +8 -2
- package/src/index.d.ts +7 -1
- package/src/index.js +47 -7
|
@@ -0,0 +1,459 @@
|
|
|
1
|
+
{
|
|
2
|
+
"contract_id": "canonicalHtmlContract.v1",
|
|
3
|
+
"version": 1,
|
|
4
|
+
"phase": "HTMLCONTRACT",
|
|
5
|
+
"summary": "HTML-first canonical specification contract for governed-pipeline durable intent documents.",
|
|
6
|
+
"schemas": {
|
|
7
|
+
"canonical_html": "canonical_html.v1",
|
|
8
|
+
"document_identity": "doc_identity.v1",
|
|
9
|
+
"document_type_catalog": "doc_type_catalog.v1",
|
|
10
|
+
"json_projection_boundary": "json_projection_boundary.v1",
|
|
11
|
+
"c4_mermaid_source": "canonical_c4_mermaid_source.v1",
|
|
12
|
+
"c4_diagram_role": "c4_diagram_role.v1",
|
|
13
|
+
"c4_source_digest": "c4_source_digest.v1",
|
|
14
|
+
"c4_source_posture": "c4_source_posture.v1",
|
|
15
|
+
"repo_canonical_profile": "repo_canonical_profile.v1"
|
|
16
|
+
},
|
|
17
|
+
"dialect": {
|
|
18
|
+
"schema": "canonical_html.v1",
|
|
19
|
+
"content_type": "text/html; charset=utf-8",
|
|
20
|
+
"allowed_tags": [
|
|
21
|
+
"html",
|
|
22
|
+
"head",
|
|
23
|
+
"title",
|
|
24
|
+
"meta",
|
|
25
|
+
"body",
|
|
26
|
+
"main",
|
|
27
|
+
"section",
|
|
28
|
+
"article",
|
|
29
|
+
"header",
|
|
30
|
+
"footer",
|
|
31
|
+
"nav",
|
|
32
|
+
"h1",
|
|
33
|
+
"h2",
|
|
34
|
+
"h3",
|
|
35
|
+
"p",
|
|
36
|
+
"a",
|
|
37
|
+
"ul",
|
|
38
|
+
"ol",
|
|
39
|
+
"li",
|
|
40
|
+
"table",
|
|
41
|
+
"thead",
|
|
42
|
+
"tbody",
|
|
43
|
+
"tr",
|
|
44
|
+
"th",
|
|
45
|
+
"td",
|
|
46
|
+
"code",
|
|
47
|
+
"pre",
|
|
48
|
+
"blockquote",
|
|
49
|
+
"strong",
|
|
50
|
+
"em",
|
|
51
|
+
"span",
|
|
52
|
+
"dl",
|
|
53
|
+
"dt",
|
|
54
|
+
"dd",
|
|
55
|
+
"time",
|
|
56
|
+
"data"
|
|
57
|
+
],
|
|
58
|
+
"allowed_attributes": [
|
|
59
|
+
"id",
|
|
60
|
+
"class",
|
|
61
|
+
"href",
|
|
62
|
+
"rel",
|
|
63
|
+
"aria-label",
|
|
64
|
+
"role",
|
|
65
|
+
"data-*",
|
|
66
|
+
"datetime",
|
|
67
|
+
"title",
|
|
68
|
+
"scope",
|
|
69
|
+
"colspan",
|
|
70
|
+
"rowspan"
|
|
71
|
+
],
|
|
72
|
+
"metadata_block": {
|
|
73
|
+
"required_selector": "section#document-metadata[data-schema=\"doc_identity.v1\"]",
|
|
74
|
+
"placement": "first child of main"
|
|
75
|
+
},
|
|
76
|
+
"link_shapes": {
|
|
77
|
+
"evidence": {
|
|
78
|
+
"rel": "evidence",
|
|
79
|
+
"allowed_href_prefixes": [
|
|
80
|
+
".pipeline/",
|
|
81
|
+
"specs/",
|
|
82
|
+
"docs/",
|
|
83
|
+
"packages/",
|
|
84
|
+
"sha256:"
|
|
85
|
+
]
|
|
86
|
+
},
|
|
87
|
+
"task": {
|
|
88
|
+
"rel": "task",
|
|
89
|
+
"allowed_href_prefixes": [
|
|
90
|
+
"#task-",
|
|
91
|
+
".pipeline/tasks/",
|
|
92
|
+
"packages/pipeline-runtime/test/fixtures/"
|
|
93
|
+
]
|
|
94
|
+
},
|
|
95
|
+
"adr": {
|
|
96
|
+
"data-ref-kind": "adr"
|
|
97
|
+
},
|
|
98
|
+
"c4": {
|
|
99
|
+
"data-ref-kind": "c4"
|
|
100
|
+
}
|
|
101
|
+
},
|
|
102
|
+
"forbidden": [
|
|
103
|
+
"scripts",
|
|
104
|
+
"inline_event_handlers",
|
|
105
|
+
"untrusted_remote_resources",
|
|
106
|
+
"uncontrolled_styles",
|
|
107
|
+
"raw_secrets",
|
|
108
|
+
"credentials",
|
|
109
|
+
"provider_payloads",
|
|
110
|
+
"raw_private_evidence",
|
|
111
|
+
"raw_portal_state",
|
|
112
|
+
"local_env_values",
|
|
113
|
+
"host_absolute_paths",
|
|
114
|
+
"agent_board.* authority"
|
|
115
|
+
]
|
|
116
|
+
},
|
|
117
|
+
"c4_mermaid_source": {
|
|
118
|
+
"schema": "canonical_c4_mermaid_source.v1",
|
|
119
|
+
"roles": ["context", "container", "component"],
|
|
120
|
+
"role_anchor_map": {
|
|
121
|
+
"context": "system-context",
|
|
122
|
+
"container": "containers",
|
|
123
|
+
"component": "components"
|
|
124
|
+
},
|
|
125
|
+
"source_fields": {
|
|
126
|
+
"context": "c4_context_mermaid",
|
|
127
|
+
"container": "c4_container_mermaid",
|
|
128
|
+
"component": "c4_component_mermaid"
|
|
129
|
+
},
|
|
130
|
+
"source_origins": [
|
|
131
|
+
"synthesis_field",
|
|
132
|
+
"legacy_markdown_mermaid_fence",
|
|
133
|
+
"standalone_mermaid_file",
|
|
134
|
+
"canonical_html_inert_code_block",
|
|
135
|
+
"metadata_sidecar_ref"
|
|
136
|
+
],
|
|
137
|
+
"digest": {
|
|
138
|
+
"schema": "c4_source_digest.v1",
|
|
139
|
+
"algorithm": "sha256",
|
|
140
|
+
"format": "sha256:<64 lowercase hex>",
|
|
141
|
+
"input": "normalized UTF-8 Mermaid source bytes with LF line endings"
|
|
142
|
+
},
|
|
143
|
+
"html_code_block": {
|
|
144
|
+
"tag_path": "pre > code",
|
|
145
|
+
"allowed_data_attributes": {
|
|
146
|
+
"data-diagram-format": "mermaid",
|
|
147
|
+
"data-diagram-role": ["context", "container", "component"],
|
|
148
|
+
"data-source-digest": "sha256:<64 lowercase hex>",
|
|
149
|
+
"data-source-origin": ["synthesis_field", "legacy_markdown_mermaid_fence", "standalone_mermaid_file", "canonical_html_inert_code_block", "metadata_sidecar_ref"]
|
|
150
|
+
},
|
|
151
|
+
"inert_display_content": true,
|
|
152
|
+
"allows_mermaid_runtime_execution": false
|
|
153
|
+
},
|
|
154
|
+
"postures": [
|
|
155
|
+
"verified",
|
|
156
|
+
"missing_source",
|
|
157
|
+
"malformed_source",
|
|
158
|
+
"intentionally_empty",
|
|
159
|
+
"stale_digest",
|
|
160
|
+
"unsafe_content"
|
|
161
|
+
],
|
|
162
|
+
"sidecar_relationship": {
|
|
163
|
+
"schema": "metadata_sidecar_ref",
|
|
164
|
+
"fields": ["document_id", "canonical_path", "section_anchor", "diagram_role", "source_ref", "source_digest", "metadata_only"]
|
|
165
|
+
},
|
|
166
|
+
"non_goals": [
|
|
167
|
+
"Mermaid renderer implementation",
|
|
168
|
+
"HTML writer behavior",
|
|
169
|
+
"Lint execution behavior",
|
|
170
|
+
"Raw rendered SVG authority",
|
|
171
|
+
"Raw rendered canvas authority",
|
|
172
|
+
"Portal source-truth authority"
|
|
173
|
+
]
|
|
174
|
+
},
|
|
175
|
+
"document_identity": {
|
|
176
|
+
"schema": "doc_identity.v1",
|
|
177
|
+
"required_fields": [
|
|
178
|
+
"document_id",
|
|
179
|
+
"document_type",
|
|
180
|
+
"schema_version",
|
|
181
|
+
"source_role",
|
|
182
|
+
"content_type",
|
|
183
|
+
"canonical_path",
|
|
184
|
+
"digest",
|
|
185
|
+
"title",
|
|
186
|
+
"status",
|
|
187
|
+
"lifecycle_state",
|
|
188
|
+
"generated_at"
|
|
189
|
+
],
|
|
190
|
+
"stable_across_path_moves": [
|
|
191
|
+
"document_id",
|
|
192
|
+
"document_type",
|
|
193
|
+
"schema_version",
|
|
194
|
+
"source_role",
|
|
195
|
+
"content_type",
|
|
196
|
+
"title"
|
|
197
|
+
],
|
|
198
|
+
"recomputed_on_content_change": [
|
|
199
|
+
"digest"
|
|
200
|
+
],
|
|
201
|
+
"path_move_fields": [
|
|
202
|
+
"canonical_path"
|
|
203
|
+
],
|
|
204
|
+
"generated_timestamp_semantics": "Fixtures use deterministic timestamps; runtime artifacts may use run timestamps only when stable digests and provenance are also present."
|
|
205
|
+
},
|
|
206
|
+
"document_type_catalog": {
|
|
207
|
+
"schema": "doc_type_catalog.v1",
|
|
208
|
+
"families": [
|
|
209
|
+
{
|
|
210
|
+
"document_type": "prd",
|
|
211
|
+
"required_anchors": ["document-metadata", "problem", "goals", "requirements", "acceptance"]
|
|
212
|
+
},
|
|
213
|
+
{
|
|
214
|
+
"document_type": "rfc",
|
|
215
|
+
"required_anchors": ["document-metadata", "context", "proposal", "alternatives", "decision"]
|
|
216
|
+
},
|
|
217
|
+
{
|
|
218
|
+
"document_type": "adr",
|
|
219
|
+
"required_anchors": ["document-metadata", "context", "decision", "consequences", "status"]
|
|
220
|
+
},
|
|
221
|
+
{
|
|
222
|
+
"document_type": "c4_architecture",
|
|
223
|
+
"required_anchors": ["document-metadata", "system-context", "containers", "components", "relationships"]
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
"document_type": "roadmap",
|
|
227
|
+
"required_anchors": ["document-metadata", "north-star", "phases", "dependencies", "exit-criteria"]
|
|
228
|
+
},
|
|
229
|
+
{
|
|
230
|
+
"document_type": "phase_plan",
|
|
231
|
+
"required_anchors": ["document-metadata", "scope", "interfaces", "lanes", "verification"]
|
|
232
|
+
},
|
|
233
|
+
{
|
|
234
|
+
"document_type": "task_catalog",
|
|
235
|
+
"required_anchors": ["document-metadata", "task-index", "dependencies", "acceptance", "audiences"]
|
|
236
|
+
},
|
|
237
|
+
{
|
|
238
|
+
"document_type": "test_plan",
|
|
239
|
+
"required_anchors": ["document-metadata", "scope", "test-matrix", "fixtures", "exit-criteria"]
|
|
240
|
+
},
|
|
241
|
+
{
|
|
242
|
+
"document_type": "risk_register",
|
|
243
|
+
"required_anchors": ["document-metadata", "risks", "mitigations", "owners", "review-cadence"]
|
|
244
|
+
},
|
|
245
|
+
{
|
|
246
|
+
"document_type": "release_readiness",
|
|
247
|
+
"required_anchors": ["document-metadata", "release-scope", "gates", "evidence", "decision"]
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
"document_type": "governance_registry",
|
|
251
|
+
"required_anchors": ["document-metadata", "governance-scope", "owners", "policies", "ratification"]
|
|
252
|
+
},
|
|
253
|
+
{
|
|
254
|
+
"document_type": "ratification_record",
|
|
255
|
+
"required_anchors": ["document-metadata", "proposal", "votes", "decision", "audit-citations"]
|
|
256
|
+
},
|
|
257
|
+
{
|
|
258
|
+
"document_type": "audit_status",
|
|
259
|
+
"required_anchors": ["document-metadata", "audit-scope", "findings", "status", "next-review"]
|
|
260
|
+
},
|
|
261
|
+
{
|
|
262
|
+
"document_type": "runbook",
|
|
263
|
+
"required_anchors": ["document-metadata", "purpose", "procedures", "rollback", "contacts"]
|
|
264
|
+
},
|
|
265
|
+
{
|
|
266
|
+
"document_type": "executive_brief",
|
|
267
|
+
"required_anchors": ["document-metadata", "summary", "status", "risks", "next-actions"]
|
|
268
|
+
}
|
|
269
|
+
]
|
|
270
|
+
},
|
|
271
|
+
"required_projection_facts": {
|
|
272
|
+
"schema": "json_projection_boundary.v1",
|
|
273
|
+
"json_or_jsonl_authoritative": [
|
|
274
|
+
"lint_results",
|
|
275
|
+
"task_indexes",
|
|
276
|
+
"votes",
|
|
277
|
+
"ratification_records",
|
|
278
|
+
"audit_events",
|
|
279
|
+
"runtime_ledger_entries",
|
|
280
|
+
"evidence_citations",
|
|
281
|
+
"portal_projection_envelopes",
|
|
282
|
+
"mutable_run_state"
|
|
283
|
+
],
|
|
284
|
+
"rule": "These facts may be cited from HTML but are not rehydrated from rendered HTML bodies on every downstream read."
|
|
285
|
+
},
|
|
286
|
+
"repo_canonical_profile": {
|
|
287
|
+
"schema": "repo_canonical_profile.v1",
|
|
288
|
+
"required_fields": [
|
|
289
|
+
"schema",
|
|
290
|
+
"repo_id",
|
|
291
|
+
"adoption_mode",
|
|
292
|
+
"source_roots",
|
|
293
|
+
"generated_exclusions",
|
|
294
|
+
"protected_source_roles",
|
|
295
|
+
"canonical_document_families",
|
|
296
|
+
"c4_source_roles",
|
|
297
|
+
"task_source_roles",
|
|
298
|
+
"process_source_roles",
|
|
299
|
+
"display_eligibility",
|
|
300
|
+
"provenance",
|
|
301
|
+
"digest",
|
|
302
|
+
"metadata_only"
|
|
303
|
+
],
|
|
304
|
+
"adoption_modes": [
|
|
305
|
+
"governed_pipeline_canonical",
|
|
306
|
+
"brownfield_native_source",
|
|
307
|
+
"dotfiles_native_source",
|
|
308
|
+
"metadata_projection_only"
|
|
309
|
+
],
|
|
310
|
+
"source_root_roles": [
|
|
311
|
+
"active_canonical_source",
|
|
312
|
+
"unmanaged_native_input",
|
|
313
|
+
"generated_mirror",
|
|
314
|
+
"adoption_manifest",
|
|
315
|
+
"task_source_doc",
|
|
316
|
+
"process_source_doc",
|
|
317
|
+
"c4_source_doc",
|
|
318
|
+
"phase_loop_process_evidence"
|
|
319
|
+
],
|
|
320
|
+
"protected_source_roles": [
|
|
321
|
+
"raw_secret",
|
|
322
|
+
"credential",
|
|
323
|
+
"provider_payload",
|
|
324
|
+
"raw_private_evidence",
|
|
325
|
+
"raw_portal_state",
|
|
326
|
+
"ignored_local_state",
|
|
327
|
+
"host_absolute_path",
|
|
328
|
+
"generated_mirror",
|
|
329
|
+
"rendered_output",
|
|
330
|
+
"sibling_repo_mutation"
|
|
331
|
+
],
|
|
332
|
+
"canonical_document_families": [
|
|
333
|
+
"prd",
|
|
334
|
+
"rfc",
|
|
335
|
+
"adr",
|
|
336
|
+
"c4_architecture",
|
|
337
|
+
"roadmap",
|
|
338
|
+
"phase_plan",
|
|
339
|
+
"task_catalog",
|
|
340
|
+
"test_plan",
|
|
341
|
+
"risk_register",
|
|
342
|
+
"release_readiness",
|
|
343
|
+
"governance_registry",
|
|
344
|
+
"ratification_record",
|
|
345
|
+
"audit_status",
|
|
346
|
+
"runbook",
|
|
347
|
+
"executive_brief"
|
|
348
|
+
],
|
|
349
|
+
"c4_source_roles": [
|
|
350
|
+
"canonical_html_inert_code_block",
|
|
351
|
+
"metadata_sidecar_ref",
|
|
352
|
+
"standalone_mermaid_file",
|
|
353
|
+
"legacy_markdown_mermaid_fence"
|
|
354
|
+
],
|
|
355
|
+
"task_source_roles": [
|
|
356
|
+
"canonical_task_catalog",
|
|
357
|
+
"task_projection_index",
|
|
358
|
+
"task_evidence_ref",
|
|
359
|
+
"portal_task_audience_ref"
|
|
360
|
+
],
|
|
361
|
+
"process_source_roles": [
|
|
362
|
+
"phase_loop_closeout",
|
|
363
|
+
"phase_loop_runner_state",
|
|
364
|
+
"phase_loop_event_summary",
|
|
365
|
+
"portal_process_ref"
|
|
366
|
+
],
|
|
367
|
+
"generated_exclusions": [
|
|
368
|
+
".dev-skills/",
|
|
369
|
+
".phase-loop/runs/",
|
|
370
|
+
"caches",
|
|
371
|
+
"credentials",
|
|
372
|
+
"raw_provider_transcripts",
|
|
373
|
+
"raw_logs",
|
|
374
|
+
"ignored_files",
|
|
375
|
+
"raw_portal_state",
|
|
376
|
+
"generated_mirrors",
|
|
377
|
+
"rendered_html",
|
|
378
|
+
"rendered_mermaid",
|
|
379
|
+
"sanitized_viewer_caches",
|
|
380
|
+
"dashboard_summaries"
|
|
381
|
+
],
|
|
382
|
+
"display_eligibility": {
|
|
383
|
+
"rendered_html_is_display_derivative": true,
|
|
384
|
+
"rendered_mermaid_is_display_derivative": true,
|
|
385
|
+
"sanitized_viewer_cache_is_display_derivative": true,
|
|
386
|
+
"dashboard_summary_is_display_derivative": true,
|
|
387
|
+
"requires_explicit_canonical_mark": true
|
|
388
|
+
},
|
|
389
|
+
"authority_denials": {
|
|
390
|
+
"raw_secrets_are_canonical": false,
|
|
391
|
+
"credentials_are_canonical": false,
|
|
392
|
+
"provider_payloads_are_canonical": false,
|
|
393
|
+
"raw_private_evidence_is_canonical": false,
|
|
394
|
+
"raw_portal_state_is_canonical": false,
|
|
395
|
+
"ignored_local_state_is_canonical": false,
|
|
396
|
+
"host_absolute_paths_are_canonical": false,
|
|
397
|
+
"generated_dev_skills_mirrors_are_canonical": false,
|
|
398
|
+
"rendered_svg_is_source_truth": false,
|
|
399
|
+
"rendered_canvas_is_source_truth": false,
|
|
400
|
+
"sibling_repo_mutation_authority": false
|
|
401
|
+
},
|
|
402
|
+
"fixture_root": "packages/pipeline-runtime/test/fixtures/canonical-html-contract/gpxcontract/",
|
|
403
|
+
"metadata_only": true
|
|
404
|
+
},
|
|
405
|
+
"redaction": {
|
|
406
|
+
"metadata_only_sidecars": true,
|
|
407
|
+
"reject_keys_matching": [
|
|
408
|
+
"secret",
|
|
409
|
+
"token",
|
|
410
|
+
"password",
|
|
411
|
+
"credential",
|
|
412
|
+
"private_key",
|
|
413
|
+
"api_key",
|
|
414
|
+
"authorization",
|
|
415
|
+
"env_values",
|
|
416
|
+
"raw_logs",
|
|
417
|
+
"raw_evidence_text",
|
|
418
|
+
"raw_portal_state",
|
|
419
|
+
"provider_payloads"
|
|
420
|
+
],
|
|
421
|
+
"reject_values_matching": [
|
|
422
|
+
"Bearer <token>",
|
|
423
|
+
"secret=<value>",
|
|
424
|
+
"token=<value>",
|
|
425
|
+
"password=<value>",
|
|
426
|
+
"authorization=<value>"
|
|
427
|
+
],
|
|
428
|
+
"reject_host_absolute_paths": true,
|
|
429
|
+
"allow_sha256_citations": true
|
|
430
|
+
},
|
|
431
|
+
"legacy_markdown_compatibility": {
|
|
432
|
+
"legacy_readers_remain_supported": true,
|
|
433
|
+
"markdown_removal_allowed_in_this_phase": false,
|
|
434
|
+
"deprecation_owner_phase": "HTMLSOAK",
|
|
435
|
+
"compatibility_window_schema": "legacy_markdown_compat_window.v1",
|
|
436
|
+
"deprecation_plan_schema": "markdown_deprecation_plan.v1",
|
|
437
|
+
"deprecation_plan_ref": "docs/canonical-html-deprecation-plan.md",
|
|
438
|
+
"markdown_compatibility_mode": "explicit_legacy_import_export"
|
|
439
|
+
},
|
|
440
|
+
"portal_projection_ref": {
|
|
441
|
+
"contract_id": "portalProjectionContract.v1",
|
|
442
|
+
"schema": "portal_projection.v2",
|
|
443
|
+
"path": "specs/contracts/portal-projection-contract-v1.json",
|
|
444
|
+
"metadata_only": true
|
|
445
|
+
},
|
|
446
|
+
"non_goals": [
|
|
447
|
+
"HTML emitter implementation",
|
|
448
|
+
"Sanitizer implementation",
|
|
449
|
+
"Linter implementation",
|
|
450
|
+
"Artifact server behavior",
|
|
451
|
+
"Portal ingestion behavior",
|
|
452
|
+
"Portal DB migrations",
|
|
453
|
+
"Sibling-repo mutation",
|
|
454
|
+
"Markdown removal",
|
|
455
|
+
"Raw canonical HTML storage in Portal",
|
|
456
|
+
"Rendered HTML authority",
|
|
457
|
+
"Rendered Mermaid authority"
|
|
458
|
+
]
|
|
459
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "consiliency.canonical_html_provenance.v1",
|
|
3
|
+
"contract_id": "canonicalHtmlContract.v1",
|
|
4
|
+
"source": {
|
|
5
|
+
"repo": "Consiliency/governed-pipeline",
|
|
6
|
+
"commit": "d36e4cdf16afd8fffe336f276f7bfb034148b20a",
|
|
7
|
+
"path": "specs/contracts/canonical-html-contract-v1.json",
|
|
8
|
+
"sha256": "3c0c11b7be8b2301409c47416269dd5579fac90f6e7a4e9ca9c3caef50bd2e28"
|
|
9
|
+
},
|
|
10
|
+
"packaged": {
|
|
11
|
+
"path": "core/canonical-html/contract-v1.json",
|
|
12
|
+
"sha256": "3c0c11b7be8b2301409c47416269dd5579fac90f6e7a4e9ca9c3caef50bd2e28"
|
|
13
|
+
},
|
|
14
|
+
"publishability_review": {
|
|
15
|
+
"status": "metadata-only-public-contract",
|
|
16
|
+
"host_absolute_paths_allowed": false,
|
|
17
|
+
"private_spec_payload_allowed": false,
|
|
18
|
+
"raw_portal_state_allowed": false,
|
|
19
|
+
"provider_payload_allowed": false
|
|
20
|
+
},
|
|
21
|
+
"phase0_drift_rule": "Existing governed-pipeline and spec-adjacent copies remain in place during Phase 0; consumers compare their vendored bytes against this packaged sha256."
|
|
22
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
{
|
|
2
|
+
"contract_id": "consiliency.contract.v1",
|
|
3
|
+
"contract_version": "0.2.0",
|
|
4
|
+
"package_names": {
|
|
5
|
+
"npm": "@consiliency/contract",
|
|
6
|
+
"pypi": "consiliency-contract"
|
|
7
|
+
},
|
|
8
|
+
"summary": "Normative Consiliency Phase-0 L0 contract data for .consiliency layout, document requirements, interface declarations, loop gates, canonical_html.v1, version skew, adoption + governance-scoping (CS-0.12), and lease + inbox coordination (CS-0.10b).",
|
|
9
|
+
"phase_posture": {
|
|
10
|
+
"phase": "CS-0.12",
|
|
11
|
+
"content_phases": ["CS-0.2", "CS-0.10b", "CS-0.12"],
|
|
12
|
+
"level": "L0",
|
|
13
|
+
"default_gate_severity": "warn",
|
|
14
|
+
"certified_claims_allowed": false,
|
|
15
|
+
"private_spec_changes_allowed": false
|
|
16
|
+
},
|
|
17
|
+
"schemas": {
|
|
18
|
+
"decision": "core/schemas/decision.schema.json",
|
|
19
|
+
"manifest": "core/schemas/manifest.schema.json",
|
|
20
|
+
"contract_version_status": "core/schemas/contract-version-status.schema.json",
|
|
21
|
+
"interface_declaration": "core/schemas/interface-declaration.schema.json",
|
|
22
|
+
"loop_gate_protocol": "core/schemas/loop-gate-protocol.schema.json",
|
|
23
|
+
"loop_gate_scenario": "core/schemas/loop-gate-scenario.schema.json",
|
|
24
|
+
"version_skew_protocol": "core/schemas/version-skew-protocol.schema.json",
|
|
25
|
+
"version_skew_scenario": "core/schemas/version-skew-scenario.schema.json",
|
|
26
|
+
"canonical_html_v1": "core/schemas/canonical-html-v1.schema.json",
|
|
27
|
+
"governance_scope_scenario": "core/schemas/governance-scope-scenario.schema.json",
|
|
28
|
+
"lease": "core/schemas/lease.schema.json",
|
|
29
|
+
"lease_event": "core/schemas/lease-event.schema.json",
|
|
30
|
+
"lease_store_protocol": "core/schemas/lease-store-protocol.schema.json",
|
|
31
|
+
"coordination_channel_protocol": "core/schemas/coordination-channel-protocol.schema.json",
|
|
32
|
+
"coordination_scenario": "core/schemas/coordination-scenario.schema.json"
|
|
33
|
+
},
|
|
34
|
+
"registries": {
|
|
35
|
+
"document_classes": "core/registries/document-classes.json",
|
|
36
|
+
"archetypes": "core/registries/archetypes.json",
|
|
37
|
+
"required_documents": "core/registries/required-documents.json",
|
|
38
|
+
"maturity_labels": "core/registries/maturity-labels.json",
|
|
39
|
+
"default_ignore_set": "core/registries/default-ignore-set.json"
|
|
40
|
+
},
|
|
41
|
+
"protocols": {
|
|
42
|
+
"loop_gate": "core/schemas/loop-gate-protocol.schema.json",
|
|
43
|
+
"version_skew": "core/schemas/version-skew-protocol.schema.json",
|
|
44
|
+
"lease_store": "core/schemas/lease-store-protocol.schema.json",
|
|
45
|
+
"coordination_channel": "core/schemas/coordination-channel-protocol.schema.json"
|
|
46
|
+
},
|
|
47
|
+
"canonical_html": {
|
|
48
|
+
"contract": "core/canonical-html/contract-v1.json",
|
|
49
|
+
"provenance": "core/canonical-html/provenance.json"
|
|
50
|
+
},
|
|
51
|
+
"conformance": {
|
|
52
|
+
"vector_root": "conformance/vectors",
|
|
53
|
+
"decision_schema": "core/schemas/decision.schema.json"
|
|
54
|
+
}
|
|
55
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "consiliency.archetypes.v1",
|
|
3
|
+
"baseline_only": {
|
|
4
|
+
"id": "baseline-only",
|
|
5
|
+
"legal_declaration": true,
|
|
6
|
+
"description": "The repo owes only universal baseline artifacts."
|
|
7
|
+
},
|
|
8
|
+
"archetypes": [
|
|
9
|
+
{
|
|
10
|
+
"id": "product",
|
|
11
|
+
"description": "Shipped user-facing product, app, or SaaS."
|
|
12
|
+
},
|
|
13
|
+
{
|
|
14
|
+
"id": "service",
|
|
15
|
+
"description": "Running backend service."
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"id": "library",
|
|
19
|
+
"description": "Package or library imported by other software."
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"id": "infra",
|
|
23
|
+
"description": "Infrastructure or IaC module."
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"id": "tooling-meta",
|
|
27
|
+
"description": "Tooling, configuration, or meta repository that configures other repos."
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"id": "experiment",
|
|
31
|
+
"description": "Research or experiment repo that is not a shipped product."
|
|
32
|
+
},
|
|
33
|
+
{
|
|
34
|
+
"id": "document",
|
|
35
|
+
"description": "Repository whose deliverable is a document corpus."
|
|
36
|
+
}
|
|
37
|
+
],
|
|
38
|
+
"modifiers": [
|
|
39
|
+
{
|
|
40
|
+
"id": "data-bearing",
|
|
41
|
+
"description": "Handles or defines data needing privacy, retention, deletion, or inventory docs."
|
|
42
|
+
},
|
|
43
|
+
{
|
|
44
|
+
"id": "public",
|
|
45
|
+
"description": "Public or open-source surface."
|
|
46
|
+
},
|
|
47
|
+
{
|
|
48
|
+
"id": "regulated",
|
|
49
|
+
"description": "Requires compliance or audit controls."
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"id": "user-facing",
|
|
53
|
+
"description": "Direct user-facing surface."
|
|
54
|
+
}
|
|
55
|
+
],
|
|
56
|
+
"composition_order": {
|
|
57
|
+
"baseline": "first",
|
|
58
|
+
"archetypes": "registry order",
|
|
59
|
+
"modifiers": "registry order",
|
|
60
|
+
"duplicate_policy": "byte-identical rows are de-duplicated; conflicting rows fail conformance"
|
|
61
|
+
}
|
|
62
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "consiliency.default_ignore_set.v1",
|
|
3
|
+
"summary": "The shipped default set of tool, harness, and scratch namespaces that contract ingestion must never touch. These are ungoverned by construction: they are never candidates for the governed set even if a governed_set selector would otherwise match them.",
|
|
4
|
+
"namespaces": [
|
|
5
|
+
".git/",
|
|
6
|
+
".phase-loop/",
|
|
7
|
+
".pipeline/",
|
|
8
|
+
".claude/",
|
|
9
|
+
".codex/",
|
|
10
|
+
".opencode/",
|
|
11
|
+
".gemini/",
|
|
12
|
+
".pi/",
|
|
13
|
+
".agents/",
|
|
14
|
+
".cursor/",
|
|
15
|
+
"node_modules/",
|
|
16
|
+
".venv/",
|
|
17
|
+
"scratch/",
|
|
18
|
+
"**/*.wip.md",
|
|
19
|
+
"**/transcripts/",
|
|
20
|
+
"**/*.transcript/"
|
|
21
|
+
],
|
|
22
|
+
"matching": {
|
|
23
|
+
"bare_dir_matches_at_any_depth": true,
|
|
24
|
+
"metachar_entries_are_globs": true,
|
|
25
|
+
"rule": "An entry with no glob metacharacter that ends in '/' (a bare directory name, e.g. '.claude/') matches that directory at ANY depth, so both '.claude/x.md' and 'tools/.claude/x.md' are ignored. An entry containing a glob metacharacter ('*', '?', '[') is a glob evaluated against the repo-relative path (e.g. '**/*.wip.md')."
|
|
26
|
+
},
|
|
27
|
+
"precedence": "ignore-set-overrides-governed-set",
|
|
28
|
+
"extensible_per_repo": true,
|
|
29
|
+
"rule": "A path matching any ignore-set namespace is ungoverned regardless of adoption or governed_set declarations. The ignore-set is the safety floor: it wins over the allowlist so scratchpads and other-harness docs (Claude, Codex, OpenCode, Gemini/Antigravity, PI, Cursor, and the .agents shared root) are never governed or ingested."
|
|
30
|
+
}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema": "consiliency.document_classes.v1",
|
|
3
|
+
"classes": [
|
|
4
|
+
{
|
|
5
|
+
"id": "intent-ground",
|
|
6
|
+
"role": "Human-authored artifact that grounds S after ratification."
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"id": "intent-plan",
|
|
10
|
+
"role": "Human-authored sequencing or priority artifact that does not ground S."
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
"id": "proj-S",
|
|
14
|
+
"role": "Projection from certified S; Phase 0 may only declare a stub or future target."
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"id": "proj-code",
|
|
18
|
+
"role": "Projection from code facts E(C)."
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"id": "ops-fact",
|
|
22
|
+
"role": "Runtime, operational, deployment, or verification fact."
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"id": "static",
|
|
26
|
+
"role": "Constant policy or static project artifact."
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"id": "index",
|
|
30
|
+
"role": "Catalog, registry, or pointer artifact."
|
|
31
|
+
}
|
|
32
|
+
]
|
|
33
|
+
}
|