okstra 0.231.0 → 0.232.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.
Files changed (143) hide show
  1. package/README.md +15 -3
  2. package/dist/cli-registry.mjs +6 -0
  3. package/dist/cli-registry.mjs.map +1 -1
  4. package/dist/commands/memory/memory.mjs +9 -55
  5. package/dist/commands/memory/memory.mjs.map +1 -1
  6. package/dist/lib/memory-auto-register.d.mts +1 -0
  7. package/dist/lib/memory-auto-register.mjs +113 -0
  8. package/dist/lib/memory-auto-register.mjs.map +1 -0
  9. package/dist/lib/memory-entry-contract.d.mts +12 -0
  10. package/dist/lib/memory-entry-contract.mjs +46 -0
  11. package/dist/lib/memory-entry-contract.mjs.map +1 -0
  12. package/dist/lib/python-helper.d.mts +1 -1
  13. package/dist/lib/python-helper.mjs +3 -2
  14. package/dist/lib/python-helper.mjs.map +1 -1
  15. package/dist/lib/record-secrets.d.mts +1 -0
  16. package/dist/lib/record-secrets.mjs +28 -0
  17. package/dist/lib/record-secrets.mjs.map +1 -0
  18. package/dist/lib/types.d.mts +2 -1
  19. package/docs/architecture/storage-model.md +129 -2
  20. package/docs/architecture.md +11 -2
  21. package/docs/cli.md +234 -0
  22. package/docs/project-structure-overview.md +2 -1
  23. package/package.json +1 -1
  24. package/runtime/BUILD.json +2 -2
  25. package/runtime/agents/common.json +8 -8
  26. package/runtime/agents/roles/verifier.json +2 -4
  27. package/runtime/bin/okstra-provider-exec.py +10 -4
  28. package/runtime/prompts/coding-preflight/architectures/hexagonal.md +23 -30
  29. package/runtime/prompts/coding-preflight/authoring-checks.md +17 -0
  30. package/runtime/prompts/coding-preflight/clean-code.md +85 -281
  31. package/runtime/prompts/coding-preflight/frameworks/node-server.md +2 -3
  32. package/runtime/prompts/coding-preflight/languages/java.md +3 -5
  33. package/runtime/prompts/coding-preflight/languages/javascript-typescript.md +5 -12
  34. package/runtime/prompts/coding-preflight/languages/kotlin.md +2 -4
  35. package/runtime/prompts/coding-preflight/languages/python.md +2 -7
  36. package/runtime/prompts/coding-preflight/languages/rust.md +2 -8
  37. package/runtime/prompts/coding-preflight/languages/sql.md +2 -4
  38. package/runtime/prompts/coding-preflight/overview.md +25 -38
  39. package/runtime/prompts/coding-preflight/review-rules.json +30 -0
  40. package/runtime/prompts/duties/code-reviewer.json +15 -18
  41. package/runtime/prompts/duties/implementation-verifier.json +1 -0
  42. package/runtime/prompts/lead/convergence.md +3 -3
  43. package/runtime/prompts/lead/okstra-lead-contract.md +2 -2
  44. package/runtime/prompts/lead/report-writer.md +1 -1
  45. package/runtime/prompts/lead/team-contract.md +1 -1
  46. package/runtime/prompts/profiles/_clarification-recommendation.md +3 -2
  47. package/runtime/prompts/profiles/_coding-conventions-preflight.md +41 -6
  48. package/runtime/python/okstra_ctl/agent/invocation.py +121 -36
  49. package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +6 -0
  50. package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +30 -4
  51. package/runtime/python/okstra_ctl/agent/standalone.py +3 -0
  52. package/runtime/python/okstra_ctl/analysis_packet.py +2 -19
  53. package/runtime/python/okstra_ctl/approval_decisions.py +16 -0
  54. package/runtime/python/okstra_ctl/attempt_evidence.py +10 -0
  55. package/runtime/python/okstra_ctl/business_flow/invocation.py +35 -3
  56. package/runtime/python/okstra_ctl/code_review_census.py +71 -7
  57. package/runtime/python/okstra_ctl/code_review_coverage.py +4 -274
  58. package/runtime/python/okstra_ctl/code_review_integrity.py +154 -0
  59. package/runtime/python/okstra_ctl/code_review_invocation.py +212 -0
  60. package/runtime/python/okstra_ctl/code_review_scope.py +36 -9
  61. package/runtime/python/okstra_ctl/code_review_target.py +85 -11
  62. package/runtime/python/okstra_ctl/consumers.py +12 -9
  63. package/runtime/python/okstra_ctl/convergence.py +112 -20
  64. package/runtime/python/okstra_ctl/convergence_engine.py +1 -0
  65. package/runtime/python/okstra_ctl/convergence_provenance.py +27 -11
  66. package/runtime/python/okstra_ctl/correction_round.py +6 -1
  67. package/runtime/python/okstra_ctl/design_review.py +207 -0
  68. package/runtime/python/okstra_ctl/design_review_evidence.py +297 -0
  69. package/runtime/python/okstra_ctl/dispatch_checkpoints.py +28 -5
  70. package/runtime/python/okstra_ctl/dispatch_core.py +3 -11
  71. package/runtime/python/okstra_ctl/doctor.py +8 -25
  72. package/runtime/python/okstra_ctl/doyouknow/__init__.py +9 -0
  73. package/runtime/python/okstra_ctl/doyouknow/cli.py +91 -0
  74. package/runtime/python/okstra_ctl/doyouknow/config.py +58 -0
  75. package/runtime/python/okstra_ctl/doyouknow/contracts.py +184 -0
  76. package/runtime/python/okstra_ctl/doyouknow/identity.py +22 -0
  77. package/runtime/python/okstra_ctl/doyouknow/paths.py +22 -0
  78. package/runtime/python/okstra_ctl/doyouknow/pending.py +72 -0
  79. package/runtime/python/okstra_ctl/doyouknow/registration.py +260 -0
  80. package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +128 -0
  81. package/runtime/python/okstra_ctl/doyouknow/source_store.py +172 -0
  82. package/runtime/python/okstra_ctl/doyouknow/sources/io.py +36 -0
  83. package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +261 -0
  84. package/runtime/python/okstra_ctl/doyouknow/sources/memory.py +179 -0
  85. package/runtime/python/okstra_ctl/doyouknow/sources/task.py +95 -0
  86. package/runtime/python/okstra_ctl/doyouknow/store.py +260 -0
  87. package/runtime/python/okstra_ctl/doyouknow/sync.py +58 -0
  88. package/runtime/python/okstra_ctl/execution_mutation_audit.py +18 -2
  89. package/runtime/python/okstra_ctl/file_size_cap.py +3 -4
  90. package/runtime/python/okstra_ctl/json_boundary.py +21 -2
  91. package/runtime/python/okstra_ctl/jsonl.py +21 -0
  92. package/runtime/python/okstra_ctl/manager_cli.py +26 -0
  93. package/runtime/python/okstra_ctl/manager_registration.py +29 -0
  94. package/runtime/python/okstra_ctl/manager_sync.py +3 -22
  95. package/runtime/python/okstra_ctl/model_io/renderers.py +13 -2
  96. package/runtime/python/okstra_ctl/model_io_cli.py +7 -1
  97. package/runtime/python/okstra_ctl/phases/final_verification/validation.py +20 -0
  98. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-deliverable.md +12 -2
  99. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +19 -6
  100. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +5 -3
  101. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-verifier.md +39 -11
  102. package/runtime/python/okstra_ctl/phases/implementation/report_assets/implementation.template.html +13 -0
  103. package/runtime/python/okstra_ctl/phases/implementation/spec.md +26 -1
  104. package/runtime/python/okstra_ctl/phases/implementation/validation.py +86 -2
  105. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +4 -0
  106. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +1 -1
  107. package/runtime/python/okstra_ctl/report_assembly.py +15 -0
  108. package/runtime/python/okstra_ctl/report_narrative.py +3 -0
  109. package/runtime/python/okstra_ctl/report_prose_keys.py +7 -0
  110. package/runtime/python/okstra_ctl/report_synthesis_packet.py +19 -2
  111. package/runtime/python/okstra_ctl/review_policy.py +359 -0
  112. package/runtime/python/okstra_ctl/review_verdicts.py +291 -0
  113. package/runtime/python/okstra_ctl/run.py +24 -1
  114. package/runtime/python/okstra_ctl/stage_done.py +11 -0
  115. package/runtime/python/okstra_ctl/standalone_review_audit.py +28 -0
  116. package/runtime/python/okstra_ctl/team.py +3 -1
  117. package/runtime/python/okstra_ctl/verification_generation.py +23 -1
  118. package/runtime/python/okstra_ctl/verification_input_types.py +15 -1
  119. package/runtime/python/okstra_ctl/verification_inputs.py +28 -6
  120. package/runtime/python/okstra_ctl/verification_invocation.py +7 -1
  121. package/runtime/python/okstra_ctl/verification_target.py +2 -0
  122. package/runtime/python/okstra_ctl/worker_dispatch.py +3 -1
  123. package/runtime/python/okstra_ctl/worker_prompt_headers.py +24 -9
  124. package/runtime/python/okstra_ctl/worker_runner.py +66 -10
  125. package/runtime/python/okstra_ctl/wrapper_status.py +16 -0
  126. package/runtime/python/okstra_ctl/write_policy.py +34 -1
  127. package/runtime/python/okstra_project/__init__.py +2 -0
  128. package/runtime/python/okstra_project/dirs.py +18 -0
  129. package/runtime/python/okstra_project/state.py +25 -20
  130. package/runtime/schemas/doyouknow-config-v1.schema.json +20 -0
  131. package/runtime/schemas/doyouknow-v1.schema.json +65 -0
  132. package/runtime/schemas/final-report-v2.0.schema.json +157 -0
  133. package/runtime/schemas/final-report-v3.0.schema.json +157 -0
  134. package/runtime/schemas/memory-entry-contract-v1.json +11 -0
  135. package/runtime/schemas/record-secret-patterns.json +41 -0
  136. package/runtime/skills/okstra-code-review/SKILL.md +71 -123
  137. package/runtime/skills/okstra-code-review/references/census-rules.md +29 -105
  138. package/runtime/skills/okstra-code-review/references/review-calibration.md +34 -54
  139. package/runtime/skills/okstra-manager/SKILL.md +7 -0
  140. package/runtime/skills/okstra-memory/SKILL.md +7 -0
  141. package/runtime/templates/implementation-worker-preamble.md +4 -9
  142. package/runtime/templates/worker-prompt-preamble.md +4 -12
  143. package/runtime/validators/validate-run.py +17 -8
@@ -6,7 +6,7 @@ import json
6
6
  import re
7
7
  import subprocess
8
8
  from collections.abc import Iterator, Mapping, Sequence
9
- from dataclasses import dataclass
9
+ from dataclasses import dataclass, replace
10
10
  from pathlib import Path, PurePosixPath
11
11
  from typing import Any, Literal
12
12
 
@@ -85,6 +85,39 @@ def build_write_policy(
85
85
  return policy
86
86
 
87
87
 
88
+ def build_standalone_review_write_contract(
89
+ project_root: Path, prompt_path: Path, metadata_path: Path,
90
+ metadata: Mapping[str, Any],
91
+ ) -> tuple[WritePolicy, WriteEnforcement]:
92
+ root = project_root.resolve()
93
+ artifacts = root / ".okstra/agent-invocations/code-review"
94
+ if prompt_path.resolve().parent != artifacts.resolve():
95
+ raise WritePolicyError("code-review prompt is outside its invocation directory")
96
+ stem = prompt_path.name.removesuffix(".prompt.md")
97
+ duty = root / str(metadata["contractSource"]["dutyRootPath"])
98
+ preserved = {
99
+ prompt_path.resolve().relative_to(root).as_posix(),
100
+ metadata_path.resolve().relative_to(root).as_posix(),
101
+ (artifacts / f"{stem}.review-policy.json").relative_to(root).as_posix(),
102
+ (artifacts / f"{stem}.review-source.json").relative_to(root).as_posix(),
103
+ (artifacts / f"{stem}.review-audit.json").relative_to(root).as_posix(),
104
+ *(path.relative_to(root).as_posix() for path in duty.rglob("*")
105
+ if path.is_file() or path.is_symlink()),
106
+ *(str(source["path"]) for source in metadata["instruction"]["sourcePaths"]
107
+ if source["kind"] == "project"),
108
+ }
109
+ policy = build_write_policy(
110
+ {"role": "verifier", "projectRoot": str(root),
111
+ "artifactPaths": [artifacts.relative_to(root).as_posix()],
112
+ "preservedPaths": sorted(preserved)},
113
+ {"workerWriteCapability": {"maxBoundaryPrecision": "none"}}, None,
114
+ )
115
+ enforcement = derive_write_enforcement(policy, "none", role="verifier")
116
+ return policy, replace(enforcement, unobserved_write_surfaces=(
117
+ *enforcement.unobserved_write_surfaces, "other-git-refs", "shared-git-object-store",
118
+ ))
119
+
120
+
88
121
  def _role_qa_artifact_paths(role: str, task_root: Path | None) -> tuple[Path, ...]:
89
122
  """The task `qa/` writes a role's own contract makes mandatory.
90
123
 
@@ -38,6 +38,7 @@ from .state import (
38
38
  resolve_task_id,
39
39
  resolve_task_identity,
40
40
  resolve_task_reference,
41
+ resolve_task_root_read_only,
41
42
  slugify,
42
43
  task_read_side_snapshot,
43
44
  )
@@ -66,6 +67,7 @@ __all__ = [
66
67
  "resolve_task_id",
67
68
  "resolve_task_identity",
68
69
  "resolve_task_reference",
70
+ "resolve_task_root_read_only",
69
71
  "slugify",
70
72
  "task_read_side_snapshot",
71
73
  "tasks_root",
@@ -85,6 +85,24 @@ def okstra_home() -> Path:
85
85
  return home
86
86
 
87
87
 
88
+ def contained_relative_path(ref: str, root: Path) -> str | None:
89
+ """Callers supply a resolved root for shared reference identity.
90
+
91
+ Unknown home names can be prose tokens such as ``~200``; the ``None``
92
+ result keeps those tokens from aborting source material processing.
93
+ Readers and writers share this interpretation so they name the same file.
94
+ """
95
+ try:
96
+ candidate = Path(ref).expanduser()
97
+ except RuntimeError:
98
+ return None
99
+ path = (candidate if candidate.is_absolute() else root / candidate).resolve()
100
+ try:
101
+ return path.relative_to(root).as_posix()
102
+ except ValueError:
103
+ return None
104
+
105
+
88
106
  def okstra_root(project_root: Path) -> Path:
89
107
  """`<project_root>/.okstra` 절대 path."""
90
108
  return Path(project_root) / OKSTRA_RELATIVE
@@ -206,6 +206,27 @@ def parse_task_key(task_key: str) -> tuple[str, str, str]:
206
206
  return parts[0], parts[1], parts[2]
207
207
 
208
208
 
209
+ def resolve_task_root_read_only(
210
+ project_root: Path, task_key: str, *, catalog: list[dict] | None = None,
211
+ ) -> Path | None:
212
+ project_root = Path(project_root)
213
+ _, task_group, task_id = parse_task_key(task_key)
214
+ requested_key = task_key.lower()
215
+ entries = read_task_catalog(project_root) if catalog is None else catalog
216
+ for entry in entries:
217
+ entry_key = entry.get("taskKey") or ""
218
+ if not isinstance(entry_key, str) or entry_key.lower() != requested_key:
219
+ continue
220
+ relative_path = entry.get("taskRootPath") or entry.get("taskRoot") or ""
221
+ if not isinstance(relative_path, str) or not relative_path:
222
+ continue
223
+ candidate = project_root / relative_path if not Path(relative_path).is_absolute() else Path(relative_path)
224
+ if candidate.is_dir():
225
+ return candidate
226
+ slug_path = project_root / TASKS_RELATIVE / slugify(task_group) / slugify(task_id)
227
+ return slug_path if slug_path.is_dir() else None
228
+
229
+
209
230
  def find_task_root(project_root: Path, task_key: str) -> Optional[Path]:
210
231
  """task-key 로 task root 디렉터리를 해석한다.
211
232
 
@@ -215,26 +236,10 @@ def find_task_root(project_root: Path, task_key: str) -> Optional[Path]:
215
236
 
216
237
  어느 쪽도 디렉터리로 존재하지 않으면 None.
217
238
  """
218
- project_root = Path(project_root)
219
- _, task_group, task_id = parse_task_key(task_key)
220
- requested_ci = task_key.lower()
221
-
222
- for entry in read_task_catalog(project_root):
223
- entry_key = entry.get("taskKey") or ""
224
- if not isinstance(entry_key, str) or entry_key.lower() != requested_ci:
225
- continue
226
- rel = entry.get("taskRootPath") or entry.get("taskRoot") or ""
227
- if isinstance(rel, str) and rel:
228
- abs_path = project_root / rel if not Path(rel).is_absolute() else Path(rel)
229
- if abs_path.is_dir():
230
- _reconcile_task_root_best_effort(project_root, abs_path)
231
- return abs_path
232
-
233
- slug_path = project_root / TASKS_RELATIVE / slugify(task_group) / slugify(task_id)
234
- if slug_path.is_dir():
235
- _reconcile_task_root_best_effort(project_root, slug_path)
236
- return slug_path
237
- return None
239
+ task_root = resolve_task_root_read_only(project_root, task_key)
240
+ if task_root is not None:
241
+ _reconcile_task_root_best_effort(Path(project_root), task_root)
242
+ return task_root
238
243
 
239
244
 
240
245
  def resolve_task_id(
@@ -0,0 +1,20 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "additionalProperties": false,
5
+ "required": ["schemaVersion", "autoRegister", "scope", "sources", "includeProjects", "excludeProjects", "includeGroups", "excludeGroups"],
6
+ "properties": {
7
+ "schemaVersion": {"type": "integer", "const": 1},
8
+ "autoRegister": {"type": "boolean"},
9
+ "scope": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/text"}]},
10
+ "sources": {"type": "array", "uniqueItems": true, "items": {"enum": ["memory", "manager", "task"]}},
11
+ "includeProjects": {"$ref": "#/$defs/names"},
12
+ "excludeProjects": {"$ref": "#/$defs/names"},
13
+ "includeGroups": {"$ref": "#/$defs/names"},
14
+ "excludeGroups": {"$ref": "#/$defs/names"}
15
+ },
16
+ "$defs": {
17
+ "text": {"type": "string", "minLength": 1, "pattern": "\\S"},
18
+ "names": {"type": "array", "maxItems": 1000, "uniqueItems": true, "items": {"$ref": "#/$defs/text"}}
19
+ }
20
+ }
@@ -0,0 +1,65 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "type": "object",
4
+ "additionalProperties": false,
5
+ "required": ["schemaVersion", "scope", "recordKey", "requestId", "expectedPreviousRevision", "source", "record", "nodes", "relations"],
6
+ "properties": {
7
+ "schemaVersion": {"const": 1},
8
+ "scope": {"$ref": "#/$defs/text"},
9
+ "recordKey": {"$ref": "#/$defs/text"},
10
+ "requestId": {"$ref": "#/$defs/text"},
11
+ "expectedPreviousRevision": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/text"}]},
12
+ "source": {
13
+ "type": "object",
14
+ "additionalProperties": false,
15
+ "required": ["kind", "id", "revision", "locator"],
16
+ "properties": {
17
+ "kind": {"$ref": "#/$defs/text"},
18
+ "id": {"$ref": "#/$defs/text"},
19
+ "revision": {"$ref": "#/$defs/text"},
20
+ "locator": {"$ref": "#/$defs/text"}
21
+ }
22
+ },
23
+ "record": {
24
+ "type": "object",
25
+ "additionalProperties": false,
26
+ "required": ["title", "summary"],
27
+ "properties": {
28
+ "title": {"$ref": "#/$defs/text"},
29
+ "summary": {"$ref": "#/$defs/text"},
30
+ "body": {"type": "string"},
31
+ "type": {"enum": ["context", "work", "decision", "investigation", "verification", "follow-up"]}
32
+ }
33
+ },
34
+ "nodes": {"type": "array", "items": {"$ref": "#/$defs/node"}, "uniqueItems": true, "maxItems": 1000},
35
+ "relations": {"type": "array", "items": {"$ref": "#/$defs/relation"}, "uniqueItems": true, "maxItems": 4000}
36
+ },
37
+ "$defs": {
38
+ "text": {"type": "string", "minLength": 1, "pattern": "\\S"},
39
+ "node": {
40
+ "type": "object",
41
+ "additionalProperties": false,
42
+ "required": ["key", "kind", "scope", "title"],
43
+ "properties": {
44
+ "key": {"$ref": "#/$defs/text"},
45
+ "ref": {"$ref": "#/$defs/text"},
46
+ "kind": {"enum": ["concept", "flow", "entity", "project", "repository", "commit", "ticket", "task", "artifact", "record"]},
47
+ "scope": {"$ref": "#/$defs/text"},
48
+ "title": {"$ref": "#/$defs/text"}
49
+ }
50
+ },
51
+ "relation": {
52
+ "type": "object",
53
+ "additionalProperties": false,
54
+ "required": ["from", "to", "kind", "reason", "evidence", "standing"],
55
+ "properties": {
56
+ "from": {"$ref": "#/$defs/text"},
57
+ "to": {"$ref": "#/$defs/text"},
58
+ "kind": {"$ref": "#/$defs/text"},
59
+ "reason": {"$ref": "#/$defs/text"},
60
+ "evidence": {"type": "array", "items": {"$ref": "#/$defs/text"}, "minItems": 1},
61
+ "standing": {"enum": ["observed", "user-stated", "candidate"]}
62
+ }
63
+ }
64
+ }
65
+ }
@@ -9883,6 +9883,10 @@
9883
9883
  "not-run"
9884
9884
  ]
9885
9885
  },
9886
+ "designReview": {
9887
+ "$ref": "#/$defs/DesignReviewRecord",
9888
+ "description": "Assembly-owned independent design-review evidence from the current sealed verifier result."
9889
+ },
9886
9890
  "readOnlyCommandLog": {
9887
9891
  "type": "string"
9888
9892
  },
@@ -10591,6 +10595,159 @@
10591
10595
  "minimum": 1
10592
10596
  }
10593
10597
  }
10598
+ },
10599
+ "DesignReviewRecord": {
10600
+ "type": "object",
10601
+ "additionalProperties": false,
10602
+ "required": [
10603
+ "collection",
10604
+ "generationNumber",
10605
+ "verdict"
10606
+ ],
10607
+ "properties": {
10608
+ "collection": {
10609
+ "enum": [
10610
+ "complete",
10611
+ "incomplete"
10612
+ ]
10613
+ },
10614
+ "generationNumber": {
10615
+ "type": "integer",
10616
+ "minimum": 1
10617
+ },
10618
+ "verdict": {
10619
+ "enum": [
10620
+ "PASS",
10621
+ "CONCERNS",
10622
+ "FAIL",
10623
+ "not-run"
10624
+ ]
10625
+ },
10626
+ "reason": {
10627
+ "type": "string"
10628
+ },
10629
+ "head": {
10630
+ "type": "string"
10631
+ },
10632
+ "base": {
10633
+ "type": "string"
10634
+ },
10635
+ "policyDigest": {
10636
+ "type": "string"
10637
+ },
10638
+ "censusDigest": {
10639
+ "type": "string"
10640
+ },
10641
+ "invocationRef": {
10642
+ "type": "string"
10643
+ },
10644
+ "resultPath": {
10645
+ "type": "string"
10646
+ },
10647
+ "resultDigest": {
10648
+ "type": "string"
10649
+ },
10650
+ "scope": {
10651
+ "type": "string"
10652
+ },
10653
+ "generation": {
10654
+ "type": "object",
10655
+ "required": [
10656
+ "path",
10657
+ "digest"
10658
+ ],
10659
+ "additionalProperties": false,
10660
+ "properties": {
10661
+ "path": {
10662
+ "type": "string"
10663
+ },
10664
+ "digest": {
10665
+ "type": "string"
10666
+ }
10667
+ }
10668
+ },
10669
+ "attempt": {
10670
+ "type": "integer",
10671
+ "minimum": 1
10672
+ },
10673
+ "expectedCells": {
10674
+ "type": "integer",
10675
+ "minimum": 0
10676
+ },
10677
+ "coveredCells": {
10678
+ "type": "integer",
10679
+ "minimum": 0
10680
+ },
10681
+ "missing": {
10682
+ "type": "object",
10683
+ "additionalProperties": {
10684
+ "type": "string"
10685
+ }
10686
+ },
10687
+ "unknown": {
10688
+ "type": "array",
10689
+ "items": {
10690
+ "type": "string"
10691
+ }
10692
+ },
10693
+ "blockingFindings": {
10694
+ "type": "array",
10695
+ "items": {
10696
+ "type": "string"
10697
+ }
10698
+ },
10699
+ "findings": {
10700
+ "type": "array",
10701
+ "items": {
10702
+ "type": "object",
10703
+ "additionalProperties": {
10704
+ "type": "string"
10705
+ }
10706
+ }
10707
+ },
10708
+ "carry": {
10709
+ "type": "array",
10710
+ "items": {
10711
+ "type": "object",
10712
+ "additionalProperties": {
10713
+ "type": "string"
10714
+ }
10715
+ }
10716
+ },
10717
+ "history": {
10718
+ "type": "array",
10719
+ "items": {
10720
+ "$ref": "#/$defs/DesignReviewRecord"
10721
+ }
10722
+ }
10723
+ },
10724
+ "if": {
10725
+ "properties": {
10726
+ "collection": {
10727
+ "const": "complete"
10728
+ }
10729
+ }
10730
+ },
10731
+ "then": {
10732
+ "required": [
10733
+ "head",
10734
+ "base",
10735
+ "policyDigest",
10736
+ "censusDigest",
10737
+ "generation",
10738
+ "invocationRef",
10739
+ "attempt",
10740
+ "resultPath",
10741
+ "resultDigest",
10742
+ "expectedCells",
10743
+ "coveredCells",
10744
+ "missing",
10745
+ "unknown",
10746
+ "findings",
10747
+ "blockingFindings",
10748
+ "scope"
10749
+ ]
10750
+ }
10594
10751
  }
10595
10752
  }
10596
10753
  }
@@ -10216,6 +10216,10 @@
10216
10216
  "not-run"
10217
10217
  ]
10218
10218
  },
10219
+ "designReview": {
10220
+ "$ref": "#/$defs/DesignReviewRecord",
10221
+ "description": "Assembly-owned independent design-review evidence from the current sealed verifier result."
10222
+ },
10219
10223
  "readOnlyCommandLog": {
10220
10224
  "type": "string"
10221
10225
  },
@@ -11296,6 +11300,159 @@
11296
11300
  "minimum": 1
11297
11301
  }
11298
11302
  }
11303
+ },
11304
+ "DesignReviewRecord": {
11305
+ "type": "object",
11306
+ "additionalProperties": false,
11307
+ "required": [
11308
+ "collection",
11309
+ "generationNumber",
11310
+ "verdict"
11311
+ ],
11312
+ "properties": {
11313
+ "collection": {
11314
+ "enum": [
11315
+ "complete",
11316
+ "incomplete"
11317
+ ]
11318
+ },
11319
+ "generationNumber": {
11320
+ "type": "integer",
11321
+ "minimum": 1
11322
+ },
11323
+ "verdict": {
11324
+ "enum": [
11325
+ "PASS",
11326
+ "CONCERNS",
11327
+ "FAIL",
11328
+ "not-run"
11329
+ ]
11330
+ },
11331
+ "reason": {
11332
+ "type": "string"
11333
+ },
11334
+ "head": {
11335
+ "type": "string"
11336
+ },
11337
+ "base": {
11338
+ "type": "string"
11339
+ },
11340
+ "policyDigest": {
11341
+ "type": "string"
11342
+ },
11343
+ "censusDigest": {
11344
+ "type": "string"
11345
+ },
11346
+ "invocationRef": {
11347
+ "type": "string"
11348
+ },
11349
+ "resultPath": {
11350
+ "type": "string"
11351
+ },
11352
+ "resultDigest": {
11353
+ "type": "string"
11354
+ },
11355
+ "scope": {
11356
+ "type": "string"
11357
+ },
11358
+ "generation": {
11359
+ "type": "object",
11360
+ "required": [
11361
+ "path",
11362
+ "digest"
11363
+ ],
11364
+ "additionalProperties": false,
11365
+ "properties": {
11366
+ "path": {
11367
+ "type": "string"
11368
+ },
11369
+ "digest": {
11370
+ "type": "string"
11371
+ }
11372
+ }
11373
+ },
11374
+ "attempt": {
11375
+ "type": "integer",
11376
+ "minimum": 1
11377
+ },
11378
+ "expectedCells": {
11379
+ "type": "integer",
11380
+ "minimum": 0
11381
+ },
11382
+ "coveredCells": {
11383
+ "type": "integer",
11384
+ "minimum": 0
11385
+ },
11386
+ "missing": {
11387
+ "type": "object",
11388
+ "additionalProperties": {
11389
+ "type": "string"
11390
+ }
11391
+ },
11392
+ "unknown": {
11393
+ "type": "array",
11394
+ "items": {
11395
+ "type": "string"
11396
+ }
11397
+ },
11398
+ "blockingFindings": {
11399
+ "type": "array",
11400
+ "items": {
11401
+ "type": "string"
11402
+ }
11403
+ },
11404
+ "findings": {
11405
+ "type": "array",
11406
+ "items": {
11407
+ "type": "object",
11408
+ "additionalProperties": {
11409
+ "type": "string"
11410
+ }
11411
+ }
11412
+ },
11413
+ "carry": {
11414
+ "type": "array",
11415
+ "items": {
11416
+ "type": "object",
11417
+ "additionalProperties": {
11418
+ "type": "string"
11419
+ }
11420
+ }
11421
+ },
11422
+ "history": {
11423
+ "type": "array",
11424
+ "items": {
11425
+ "$ref": "#/$defs/DesignReviewRecord"
11426
+ }
11427
+ }
11428
+ },
11429
+ "if": {
11430
+ "properties": {
11431
+ "collection": {
11432
+ "const": "complete"
11433
+ }
11434
+ }
11435
+ },
11436
+ "then": {
11437
+ "required": [
11438
+ "head",
11439
+ "base",
11440
+ "policyDigest",
11441
+ "censusDigest",
11442
+ "generation",
11443
+ "invocationRef",
11444
+ "attempt",
11445
+ "resultPath",
11446
+ "resultDigest",
11447
+ "expectedCells",
11448
+ "coveredCells",
11449
+ "missing",
11450
+ "unknown",
11451
+ "findings",
11452
+ "blockingFindings",
11453
+ "scope"
11454
+ ]
11455
+ }
11299
11456
  }
11300
11457
  }
11301
11458
  }
@@ -0,0 +1,11 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "requiredStrings": ["id", "title", "type", "projectGroup", "source", "createdAt", "path"],
4
+ "stringArrays": ["tags", "relatedProjects"],
5
+ "nullableStrings": ["archivedAt"],
6
+ "optionalStrings": ["sourceKey"],
7
+ "enums": {
8
+ "type": ["context", "decision", "preference", "requirement", "person", "project-hint", "follow-up"],
9
+ "status": ["active", "archived"]
10
+ }
11
+ }
@@ -0,0 +1,41 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "patterns": [
4
+ {
5
+ "pattern": "-----BEGIN (?:RSA |EC |OPENSSH |DSA |PGP )?PRIVATE KEY-----",
6
+ "label": "private key block"
7
+ },
8
+ {
9
+ "pattern": "\\bAKIA[0-9A-Z]{16}\\b",
10
+ "label": "AWS access key id"
11
+ },
12
+ {
13
+ "pattern": "\\bASIA[0-9A-Z]{16}\\b",
14
+ "label": "AWS temporary access key id"
15
+ },
16
+ {
17
+ "pattern": "\\bgh[posru]_[A-Za-z0-9]{36,}\\b",
18
+ "label": "GitHub token"
19
+ },
20
+ {
21
+ "pattern": "\\bgithub_pat_[A-Za-z0-9_]{60,}\\b",
22
+ "label": "GitHub fine-grained token"
23
+ },
24
+ {
25
+ "pattern": "\\bxox[baprs]-[A-Za-z0-9-]{10,}\\b",
26
+ "label": "Slack token"
27
+ },
28
+ {
29
+ "pattern": "\\bAIza[0-9A-Za-z_-]{35}\\b",
30
+ "label": "Google API key"
31
+ },
32
+ {
33
+ "pattern": "\\bsk-[A-Za-z0-9]{20,}\\b",
34
+ "label": "OpenAI-style secret key"
35
+ },
36
+ {
37
+ "pattern": "(?<![A-Za-z0-9_-])(?=[A-Za-z0-9_-]*\\.[A-Za-z0-9_-]{8,}\\.[A-Za-z0-9_-]{8,})(?:[A-Za-z0-9_-]*-)?eyJ[A-Za-z0-9_-]{8,}\\.",
38
+ "label": "JWT"
39
+ }
40
+ ]
41
+ }