@quolu/lattice 0.52.0 → 0.52.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 (182) hide show
  1. package/LICENSE +147 -147
  2. package/README.ja.md +355 -355
  3. package/README.md +258 -258
  4. package/bin/lattice-mcp.mjs +0 -0
  5. package/bin/lattice-scripted-adapter.mjs +0 -0
  6. package/bin/lattice-scripted-worker.mjs +0 -0
  7. package/bin/lattice-work-order-adapter.mjs +0 -0
  8. package/bin/lattice.mjs +0 -0
  9. package/docs/bridge-setup.md +132 -132
  10. package/docs/schemas/lattice.executor_packet.v1.schema.json +57 -57
  11. package/docs/schemas/lattice.executor_receipt.v1.schema.json +66 -66
  12. package/docs/schemas/lattice.phase_todo_revision.v3.schema.json +360 -360
  13. package/docs/schemas/lattice.plan_create_input.v1.schema.json +56 -56
  14. package/docs/schemas/lattice.plan_create_input.v2.schema.json +72 -72
  15. package/docs/schemas/lattice.plan_create_input.v3.schema.json +81 -81
  16. package/docs/schemas/lattice.plan_create_input.v4.schema.json +85 -85
  17. package/docs/schemas/lattice.run_request.v1.schema.json +238 -238
  18. package/docs/schemas/lattice.runtime_adapter_capabilities.v2.schema.json +55 -55
  19. package/docs/schemas/lattice.runtime_adapter_registration_input.v1.schema.json +78 -78
  20. package/docs/schemas/lattice.runtime_adapter_registration_input.v2.schema.json +86 -86
  21. package/docs/schemas/lattice.todo_extraction.v2.schema.json +298 -298
  22. package/docs/schemas/lattice.todo_extraction.v3.schema.json +146 -146
  23. package/docs/schemas/lattice.todo_revision.v2.schema.json +260 -260
  24. package/docs/schemas/lattice.todo_revision_set.v3.schema.json +363 -363
  25. package/package.json +103 -103
  26. package/sensor/LICENSE +21 -21
  27. package/sensor/NOTICE +19 -19
  28. package/sensor/dist/bin/lattice-sensor.js +9 -9
  29. package/sensor/dist/db/index.js +24 -24
  30. package/sensor/dist/db/migrations.js +41 -41
  31. package/sensor/dist/db/queries.js +164 -164
  32. package/sensor/dist/db/schema.sql +205 -205
  33. package/sensor/dist/directory.js +5 -5
  34. package/sensor/dist/extraction/wasm/tree-sitter-c_sharp.wasm +0 -0
  35. package/sensor/dist/extraction/wasm/tree-sitter-cfml.wasm +0 -0
  36. package/sensor/dist/extraction/wasm/tree-sitter-cfquery.wasm +0 -0
  37. package/sensor/dist/extraction/wasm/tree-sitter-cfscript.wasm +0 -0
  38. package/sensor/dist/extraction/wasm/tree-sitter-cobol.wasm +0 -0
  39. package/sensor/dist/extraction/wasm/tree-sitter-erlang.wasm +0 -0
  40. package/sensor/dist/extraction/wasm/tree-sitter-go.wasm +0 -0
  41. package/sensor/dist/extraction/wasm/tree-sitter-java.wasm +0 -0
  42. package/sensor/dist/extraction/wasm/tree-sitter-javascript.wasm +0 -0
  43. package/sensor/dist/extraction/wasm/tree-sitter-nix.wasm +0 -0
  44. package/sensor/dist/extraction/wasm/tree-sitter-pascal.wasm +0 -0
  45. package/sensor/dist/extraction/wasm/tree-sitter-python.wasm +0 -0
  46. package/sensor/dist/extraction/wasm/tree-sitter-tsx.wasm +0 -0
  47. package/sensor/dist/extraction/wasm/tree-sitter-typescript.wasm +0 -0
  48. package/sensor/dist/extraction/wasm/tree-sitter-vbnet.wasm +0 -0
  49. package/sensor/dist/mcp/liveness-watchdog.js +53 -53
  50. package/sensor/dist/mcp/server-instructions.js +95 -95
  51. package/sensor/package.json +56 -56
  52. package/src/artifact-contracts-v2.mjs +325 -325
  53. package/src/artifact-contracts.mjs +895 -895
  54. package/src/boundary-compiler.mjs +712 -712
  55. package/src/boundary-observation-compiler-v2.mjs +344 -344
  56. package/src/bounded-seam.mjs +230 -230
  57. package/src/bridge-address.mjs +107 -107
  58. package/src/bridge-cli.mjs +297 -297
  59. package/src/bridge-config.mjs +346 -346
  60. package/src/bridge-daemon.mjs +378 -378
  61. package/src/bridge-launch-agent.mjs +323 -323
  62. package/src/bridge-registrar.mjs +102 -102
  63. package/src/bridge-server.mjs +376 -376
  64. package/src/cli-help.mjs +308 -308
  65. package/src/cli-stdio.mjs +40 -40
  66. package/src/control-compiler.mjs +532 -532
  67. package/src/dag-chain.mjs +261 -261
  68. package/src/factory-diagnostics.mjs +188 -188
  69. package/src/hash-chain.mjs +76 -76
  70. package/src/hooks-cli.mjs +1057 -1053
  71. package/src/isolation-runner.mjs +409 -409
  72. package/src/node-version-guard.mjs +44 -44
  73. package/src/project-cli.mjs +697 -697
  74. package/src/project-identity.mjs +130 -130
  75. package/src/rc1-black-box-oracle.mjs +906 -906
  76. package/src/rc1-comparison.mjs +154 -154
  77. package/src/rc1-evidence-bundle.mjs +456 -456
  78. package/src/rc1-v4-campaign.mjs +708 -708
  79. package/src/rc1-v4-transform.mjs +467 -467
  80. package/src/rc1-v5-artifact-set.mjs +855 -855
  81. package/src/rc1-v5-behavior-evidence.mjs +594 -594
  82. package/src/rc1-v5-campaign.mjs +797 -797
  83. package/src/rc1-v5-transform.mjs +421 -421
  84. package/src/rc1-v6-artifact-set.mjs +807 -807
  85. package/src/rc1-v6-behavior-evidence.mjs +273 -273
  86. package/src/rc1-v6-campaign.mjs +623 -623
  87. package/src/rc1-v6-causal-binding.mjs +473 -473
  88. package/src/rc1-v6-measurement.mjs +313 -313
  89. package/src/rc2-artifact-set.mjs +1584 -1584
  90. package/src/rc2-campaign.mjs +1506 -1502
  91. package/src/rc2-delivery-policy-front-end.mjs +1079 -1079
  92. package/src/rc2-delivery-policy-oracle.mjs +134 -134
  93. package/src/rc2-delivery-policy-transform.mjs +1127 -1127
  94. package/src/rc2-rc1-transfer-front-end.mjs +511 -511
  95. package/src/rc3-actual-dogfood.mjs +652 -652
  96. package/src/rc3-dogfood-scaffold.mjs +315 -315
  97. package/src/rc3-scripted-campaign.mjs +1383 -1383
  98. package/src/rc4-stage1-dogfood.mjs +673 -673
  99. package/src/runtime-adapter-registry.mjs +524 -520
  100. package/src/runtime-cli.mjs +4588 -4584
  101. package/src/runtime-contracts.mjs +824 -824
  102. package/src/runtime-control-store.mjs +604 -600
  103. package/src/runtime-controller-protocol.mjs +587 -587
  104. package/src/runtime-decision-verifier.mjs +701 -701
  105. package/src/runtime-diff-observer.mjs +361 -361
  106. package/src/runtime-direct-os-observer.mjs +301 -301
  107. package/src/runtime-driver-state.mjs +166 -162
  108. package/src/runtime-engine.mjs +779 -779
  109. package/src/runtime-errors.mjs +356 -356
  110. package/src/runtime-event-store.mjs +189 -189
  111. package/src/runtime-front-end.mjs +925 -925
  112. package/src/runtime-gate-store.mjs +481 -477
  113. package/src/runtime-hold-recompile.mjs +916 -916
  114. package/src/runtime-io-sentinel.mjs +391 -391
  115. package/src/runtime-lifecycle-lock.mjs +294 -290
  116. package/src/runtime-managed-supervisor.mjs +1490 -1490
  117. package/src/runtime-multi-epoch-store.mjs +838 -834
  118. package/src/runtime-projection.mjs +269 -269
  119. package/src/runtime-pull-intake.mjs +1192 -1188
  120. package/src/runtime-scripted-adapter-controller.mjs +1160 -1156
  121. package/src/runtime-scripted-executor.mjs +163 -163
  122. package/src/runtime-scripted-worktree.mjs +104 -104
  123. package/src/runtime-seam-resolve.mjs +428 -428
  124. package/src/runtime-seam-treatment.mjs +173 -173
  125. package/src/runtime-socket-owner.mjs +125 -125
  126. package/src/runtime-work-order-contracts.mjs +91 -91
  127. package/src/runtime-work-order-controller.mjs +1171 -1167
  128. package/src/runtime-worktree-executor.mjs +199 -199
  129. package/src/schedulability-compiler-v2.mjs +303 -303
  130. package/src/schedulability-verifier-v2.mjs +317 -317
  131. package/src/seam-apply.mjs +549 -549
  132. package/src/seam-commit-shared.mjs +22 -22
  133. package/src/seam-commit-transform.mjs +81 -81
  134. package/src/seam-commit.mjs +18 -18
  135. package/src/seam-cost.mjs +322 -322
  136. package/src/seam-derivation.mjs +188 -188
  137. package/src/seam-gate.mjs +146 -146
  138. package/src/seam-proposal-contracts.mjs +446 -446
  139. package/src/seam-proposal-queries.mjs +521 -521
  140. package/src/seam-proposal.mjs +2011 -2011
  141. package/src/seam-ref.mjs +33 -33
  142. package/src/seam-rewrite.mjs +286 -286
  143. package/src/seam-transform.mjs +554 -554
  144. package/src/seam-verification.mjs +260 -260
  145. package/src/sensor-adapter.mjs +432 -432
  146. package/src/sensor-cli.mjs +139 -139
  147. package/src/sensor-diff.mjs +661 -661
  148. package/src/sensor-node-runtime.mjs +53 -53
  149. package/src/sensor-runtime.mjs +52 -52
  150. package/src/timestamp-contract.mjs +8 -8
  151. package/src/todo-audit-pending.mjs +91 -91
  152. package/src/todo-chain.mjs +178 -178
  153. package/src/todo-cli.mjs +3141 -3126
  154. package/src/todo-contracts.mjs +728 -728
  155. package/src/todo-dashboard-registry.mjs +573 -573
  156. package/src/todo-dispatch-shape.mjs +190 -190
  157. package/src/todo-gantt-html-independence.mjs +239 -239
  158. package/src/todo-gantt-html-shared.mjs +226 -226
  159. package/src/todo-gantt-html-style.mjs +131 -131
  160. package/src/todo-gantt-html.mjs +248 -248
  161. package/src/todo-gantt-layout.mjs +974 -974
  162. package/src/todo-gantt-live.mjs +361 -361
  163. package/src/todo-gantt-nested.mjs +263 -263
  164. package/src/todo-gantt-presentation.mjs +217 -217
  165. package/src/todo-gantt-scope.mjs +123 -123
  166. package/src/todo-gantt-svg.mjs +353 -353
  167. package/src/todo-independence-contracts.mjs +595 -595
  168. package/src/todo-independence-guidance.mjs +322 -322
  169. package/src/todo-independence.mjs +640 -640
  170. package/src/todo-markdown-renderer.mjs +260 -260
  171. package/src/todo-migration.mjs +448 -448
  172. package/src/todo-narrative-anchor.mjs +130 -130
  173. package/src/todo-note-store.mjs +629 -625
  174. package/src/todo-parallel-candidates.mjs +114 -114
  175. package/src/todo-revision.mjs +995 -995
  176. package/src/todo-split.mjs +472 -472
  177. package/src/todo-status.mjs +690 -690
  178. package/src/todo-store-git-transaction.mjs +418 -418
  179. package/src/todo-store.mjs +4322 -4314
  180. package/src/treatment-compiler.mjs +728 -728
  181. package/src/treatment-runner.mjs +656 -656
  182. package/src/witness-scaffold.mjs +180 -180
@@ -1,146 +1,146 @@
1
- {
2
- "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "$id": "https://github.com/kitepon-rgb/Lattice/blob/main/docs/schemas/lattice.todo_extraction.v3.schema.json",
4
- "title": "lattice.todo_extraction.v3",
5
- "description": "AI-authored ToDo migration artifact. Every task carries a non-blank Markdown design_memo. If no plan exists, write NO_PLAN explicitly.",
6
- "$comment": "あなたがこのToDoに対して、何も考えていないならば、設計メモに `NO_PLAN` と書いてください。Runtime validation also enforces UTF-8 byte bounds, exact keys, strict sort order, referential integrity, disposition consistency, and the canonical self-digest.",
7
- "type": "object",
8
- "additionalProperties": false,
9
- "required": [
10
- "schema", "project_id", "plan_key", "plan_version", "actor", "recorded_at",
11
- "tasks", "hard_dependencies", "joins", "extraction_digest"
12
- ],
13
- "properties": {
14
- "schema": { "const": "lattice.todo_extraction.v3" },
15
- "project_id": { "$ref": "#/$defs/identifier" },
16
- "plan_key": { "$ref": "#/$defs/identifier" },
17
- "plan_version": { "$ref": "#/$defs/identifier" },
18
- "actor": { "$ref": "#/$defs/actor" },
19
- "recorded_at": { "$ref": "#/$defs/strictTimestamp" },
20
- "tasks": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "$ref": "#/$defs/task" } },
21
- "hard_dependencies": {
22
- "type": "array", "maxItems": 2048,
23
- "items": {
24
- "type": "object", "additionalProperties": false, "required": ["from", "to"],
25
- "properties": { "from": { "$ref": "#/$defs/nodeRef" }, "to": { "$ref": "#/$defs/nodeRef" } }
26
- }
27
- },
28
- "joins": {
29
- "type": "array", "maxItems": 128,
30
- "items": {
31
- "type": "object", "additionalProperties": false, "required": ["id", "after", "before"],
32
- "properties": {
33
- "id": { "$ref": "#/$defs/identifier" },
34
- "after": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "$ref": "#/$defs/nodeRef" } },
35
- "before": { "$ref": "#/$defs/nodeRef" }
36
- }
37
- }
38
- },
39
- "extraction_digest": { "$ref": "#/$defs/digest" }
40
- },
41
- "$defs": {
42
- "identifier": { "type": "string", "pattern": "^[0-9A-Za-z](?:[0-9A-Za-z._-]{0,127})$" },
43
- "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
44
- "repoRef": {
45
- "type": "string", "minLength": 1, "maxLength": 1024,
46
- "pattern": "^(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\\\)(?!.*[\\u0000-\\u001f\\u007f])[^/]+(?:/[^/]+)*$"
47
- },
48
- "text": { "type": "string", "minLength": 1, "maxLength": 16384 },
49
- "designMemo": {
50
- "type": "string", "minLength": 1, "maxLength": 16384, "pattern": "\\S",
51
- "description": "Markdown design memo. Use the literal NO_PLAN only when no plan exists."
52
- },
53
- "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
54
- "strictTimestamp": {
55
- "type": "string",
56
- "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
57
- },
58
- "actor": {
59
- "type": "object", "additionalProperties": false, "required": ["host", "session", "agent"],
60
- "properties": {
61
- "host": { "$ref": "#/$defs/identifier" },
62
- "session": { "$ref": "#/$defs/identifier" },
63
- "agent": { "$ref": "#/$defs/identifier" }
64
- }
65
- },
66
- "nodeRef": {
67
- "type": "object", "additionalProperties": false, "required": ["project_id", "plan_key", "task_id"],
68
- "properties": {
69
- "project_id": { "$ref": "#/$defs/identifier" },
70
- "plan_key": { "$ref": "#/$defs/identifier" },
71
- "task_id": { "$ref": "#/$defs/identifier" },
72
- "expected_topology_digest": { "$ref": "#/$defs/digest" }
73
- }
74
- },
75
- "sourceLocation": {
76
- "type": "object", "additionalProperties": false,
77
- "required": ["origin_plan_ref", "origin_line", "source_commit", "heading_path", "markdown_depth", "parent_task_id", "checkbox_state"],
78
- "properties": {
79
- "origin_plan_ref": { "$ref": "#/$defs/repoRef" },
80
- "origin_line": { "type": "integer", "minimum": 1 },
81
- "source_commit": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" },
82
- "heading_path": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
83
- "markdown_depth": { "type": "integer", "minimum": 0, "maximum": 64 },
84
- "parent_task_id": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/identifier" }] },
85
- "checkbox_state": { "enum": ["checked", "unchecked", "absent", "ambiguous"] }
86
- }
87
- },
88
- "migrationContext": {
89
- "type": "object", "additionalProperties": false,
90
- "required": ["external_canonical_ref", "carry_over_ref", "h_required", "condition", "evidence_refs", "notes"],
91
- "properties": {
92
- "external_canonical_ref": { "$ref": "#/$defs/nullableText" },
93
- "carry_over_ref": { "$ref": "#/$defs/nullableText" },
94
- "h_required": { "type": "boolean" },
95
- "condition": { "$ref": "#/$defs/nullableText" },
96
- "evidence_refs": { "type": "array", "maxItems": 64, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } },
97
- "notes": { "type": "array", "maxItems": 64, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } }
98
- }
99
- },
100
- "historicalStart": {
101
- "type": "object", "additionalProperties": false, "required": ["start_mode", "status", "started_at"],
102
- "properties": {
103
- "start_mode": { "const": "historical_import" }, "status": { "const": "in-progress" },
104
- "started_at": { "oneOf": [{ "const": "unknown_requires_evidence" }, { "$ref": "#/$defs/strictTimestamp" }] }
105
- }
106
- },
107
- "historicalCompletion": {
108
- "type": "object", "additionalProperties": false, "required": ["done_mode", "completed_at"],
109
- "properties": {
110
- "done_mode": { "const": "historical_import" },
111
- "completed_at": { "oneOf": [{ "const": "unknown_requires_evidence" }, { "$ref": "#/$defs/strictTimestamp" }] }
112
- }
113
- },
114
- "task": {
115
- "type": "object", "additionalProperties": false,
116
- "required": [
117
- "task_id", "title", "lane", "design_memo", "narrative_ref", "compile_binding",
118
- "disposition", "start", "completion", "source", "migration_context"
119
- ],
120
- "properties": {
121
- "task_id": { "$ref": "#/$defs/identifier" },
122
- "title": { "$ref": "#/$defs/text" },
123
- "lane": { "$ref": "#/$defs/identifier" },
124
- "design_memo": { "$ref": "#/$defs/designMemo" },
125
- "narrative_ref": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/repoRef" }] },
126
- "compile_binding": { "type": "null" },
127
- "disposition": { "enum": ["register_pending", "register_in_progress", "register_done", "exclude_superseded", "exclude_compatibility_record", "unknown_requires_evidence"] },
128
- "start": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historicalStart" }] },
129
- "completion": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historicalCompletion" }] },
130
- "source": { "$ref": "#/$defs/sourceLocation" },
131
- "migration_context": { "$ref": "#/$defs/migrationContext" }
132
- },
133
- "allOf": [
134
- {
135
- "if": { "properties": { "disposition": { "const": "register_in_progress" } }, "required": ["disposition"] },
136
- "then": { "properties": { "start": { "$ref": "#/$defs/historicalStart" }, "completion": { "type": "null" } } },
137
- "else": {
138
- "if": { "properties": { "disposition": { "const": "register_done" } }, "required": ["disposition"] },
139
- "then": { "properties": { "start": { "type": "null" }, "completion": { "$ref": "#/$defs/historicalCompletion" } } },
140
- "else": { "properties": { "start": { "type": "null" }, "completion": { "type": "null" } } }
141
- }
142
- }
143
- ]
144
- }
145
- }
146
- }
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://github.com/kitepon-rgb/Lattice/blob/main/docs/schemas/lattice.todo_extraction.v3.schema.json",
4
+ "title": "lattice.todo_extraction.v3",
5
+ "description": "AI-authored ToDo migration artifact. Every task carries a non-blank Markdown design_memo. If no plan exists, write NO_PLAN explicitly.",
6
+ "$comment": "あなたがこのToDoに対して、何も考えていないならば、設計メモに `NO_PLAN` と書いてください。Runtime validation also enforces UTF-8 byte bounds, exact keys, strict sort order, referential integrity, disposition consistency, and the canonical self-digest.",
7
+ "type": "object",
8
+ "additionalProperties": false,
9
+ "required": [
10
+ "schema", "project_id", "plan_key", "plan_version", "actor", "recorded_at",
11
+ "tasks", "hard_dependencies", "joins", "extraction_digest"
12
+ ],
13
+ "properties": {
14
+ "schema": { "const": "lattice.todo_extraction.v3" },
15
+ "project_id": { "$ref": "#/$defs/identifier" },
16
+ "plan_key": { "$ref": "#/$defs/identifier" },
17
+ "plan_version": { "$ref": "#/$defs/identifier" },
18
+ "actor": { "$ref": "#/$defs/actor" },
19
+ "recorded_at": { "$ref": "#/$defs/strictTimestamp" },
20
+ "tasks": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "$ref": "#/$defs/task" } },
21
+ "hard_dependencies": {
22
+ "type": "array", "maxItems": 2048,
23
+ "items": {
24
+ "type": "object", "additionalProperties": false, "required": ["from", "to"],
25
+ "properties": { "from": { "$ref": "#/$defs/nodeRef" }, "to": { "$ref": "#/$defs/nodeRef" } }
26
+ }
27
+ },
28
+ "joins": {
29
+ "type": "array", "maxItems": 128,
30
+ "items": {
31
+ "type": "object", "additionalProperties": false, "required": ["id", "after", "before"],
32
+ "properties": {
33
+ "id": { "$ref": "#/$defs/identifier" },
34
+ "after": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "$ref": "#/$defs/nodeRef" } },
35
+ "before": { "$ref": "#/$defs/nodeRef" }
36
+ }
37
+ }
38
+ },
39
+ "extraction_digest": { "$ref": "#/$defs/digest" }
40
+ },
41
+ "$defs": {
42
+ "identifier": { "type": "string", "pattern": "^[0-9A-Za-z](?:[0-9A-Za-z._-]{0,127})$" },
43
+ "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
44
+ "repoRef": {
45
+ "type": "string", "minLength": 1, "maxLength": 1024,
46
+ "pattern": "^(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\\\)(?!.*[\\u0000-\\u001f\\u007f])[^/]+(?:/[^/]+)*$"
47
+ },
48
+ "text": { "type": "string", "minLength": 1, "maxLength": 16384 },
49
+ "designMemo": {
50
+ "type": "string", "minLength": 1, "maxLength": 16384, "pattern": "\\S",
51
+ "description": "Markdown design memo. Use the literal NO_PLAN only when no plan exists."
52
+ },
53
+ "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
54
+ "strictTimestamp": {
55
+ "type": "string",
56
+ "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
57
+ },
58
+ "actor": {
59
+ "type": "object", "additionalProperties": false, "required": ["host", "session", "agent"],
60
+ "properties": {
61
+ "host": { "$ref": "#/$defs/identifier" },
62
+ "session": { "$ref": "#/$defs/identifier" },
63
+ "agent": { "$ref": "#/$defs/identifier" }
64
+ }
65
+ },
66
+ "nodeRef": {
67
+ "type": "object", "additionalProperties": false, "required": ["project_id", "plan_key", "task_id"],
68
+ "properties": {
69
+ "project_id": { "$ref": "#/$defs/identifier" },
70
+ "plan_key": { "$ref": "#/$defs/identifier" },
71
+ "task_id": { "$ref": "#/$defs/identifier" },
72
+ "expected_topology_digest": { "$ref": "#/$defs/digest" }
73
+ }
74
+ },
75
+ "sourceLocation": {
76
+ "type": "object", "additionalProperties": false,
77
+ "required": ["origin_plan_ref", "origin_line", "source_commit", "heading_path", "markdown_depth", "parent_task_id", "checkbox_state"],
78
+ "properties": {
79
+ "origin_plan_ref": { "$ref": "#/$defs/repoRef" },
80
+ "origin_line": { "type": "integer", "minimum": 1 },
81
+ "source_commit": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" },
82
+ "heading_path": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
83
+ "markdown_depth": { "type": "integer", "minimum": 0, "maximum": 64 },
84
+ "parent_task_id": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/identifier" }] },
85
+ "checkbox_state": { "enum": ["checked", "unchecked", "absent", "ambiguous"] }
86
+ }
87
+ },
88
+ "migrationContext": {
89
+ "type": "object", "additionalProperties": false,
90
+ "required": ["external_canonical_ref", "carry_over_ref", "h_required", "condition", "evidence_refs", "notes"],
91
+ "properties": {
92
+ "external_canonical_ref": { "$ref": "#/$defs/nullableText" },
93
+ "carry_over_ref": { "$ref": "#/$defs/nullableText" },
94
+ "h_required": { "type": "boolean" },
95
+ "condition": { "$ref": "#/$defs/nullableText" },
96
+ "evidence_refs": { "type": "array", "maxItems": 64, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } },
97
+ "notes": { "type": "array", "maxItems": 64, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } }
98
+ }
99
+ },
100
+ "historicalStart": {
101
+ "type": "object", "additionalProperties": false, "required": ["start_mode", "status", "started_at"],
102
+ "properties": {
103
+ "start_mode": { "const": "historical_import" }, "status": { "const": "in-progress" },
104
+ "started_at": { "oneOf": [{ "const": "unknown_requires_evidence" }, { "$ref": "#/$defs/strictTimestamp" }] }
105
+ }
106
+ },
107
+ "historicalCompletion": {
108
+ "type": "object", "additionalProperties": false, "required": ["done_mode", "completed_at"],
109
+ "properties": {
110
+ "done_mode": { "const": "historical_import" },
111
+ "completed_at": { "oneOf": [{ "const": "unknown_requires_evidence" }, { "$ref": "#/$defs/strictTimestamp" }] }
112
+ }
113
+ },
114
+ "task": {
115
+ "type": "object", "additionalProperties": false,
116
+ "required": [
117
+ "task_id", "title", "lane", "design_memo", "narrative_ref", "compile_binding",
118
+ "disposition", "start", "completion", "source", "migration_context"
119
+ ],
120
+ "properties": {
121
+ "task_id": { "$ref": "#/$defs/identifier" },
122
+ "title": { "$ref": "#/$defs/text" },
123
+ "lane": { "$ref": "#/$defs/identifier" },
124
+ "design_memo": { "$ref": "#/$defs/designMemo" },
125
+ "narrative_ref": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/repoRef" }] },
126
+ "compile_binding": { "type": "null" },
127
+ "disposition": { "enum": ["register_pending", "register_in_progress", "register_done", "exclude_superseded", "exclude_compatibility_record", "unknown_requires_evidence"] },
128
+ "start": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historicalStart" }] },
129
+ "completion": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historicalCompletion" }] },
130
+ "source": { "$ref": "#/$defs/sourceLocation" },
131
+ "migration_context": { "$ref": "#/$defs/migrationContext" }
132
+ },
133
+ "allOf": [
134
+ {
135
+ "if": { "properties": { "disposition": { "const": "register_in_progress" } }, "required": ["disposition"] },
136
+ "then": { "properties": { "start": { "$ref": "#/$defs/historicalStart" }, "completion": { "type": "null" } } },
137
+ "else": {
138
+ "if": { "properties": { "disposition": { "const": "register_done" } }, "required": ["disposition"] },
139
+ "then": { "properties": { "start": { "type": "null" }, "completion": { "$ref": "#/$defs/historicalCompletion" } } },
140
+ "else": { "properties": { "start": { "type": "null" }, "completion": { "type": "null" } } }
141
+ }
142
+ }
143
+ ]
144
+ }
145
+ }
146
+ }