okstra 0.231.1 → 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 (126) hide show
  1. package/README.md +12 -0
  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 +127 -0
  20. package/docs/architecture.md +7 -0
  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/profiles/_coding-conventions-preflight.md +41 -6
  43. package/runtime/python/okstra_ctl/agent/invocation.py +121 -36
  44. package/runtime/python/okstra_ctl/agent/prompt_cli/cli.py +6 -0
  45. package/runtime/python/okstra_ctl/agent/prompt_cli/materialize.py +30 -4
  46. package/runtime/python/okstra_ctl/agent/standalone.py +3 -0
  47. package/runtime/python/okstra_ctl/analysis_packet.py +2 -19
  48. package/runtime/python/okstra_ctl/attempt_evidence.py +10 -0
  49. package/runtime/python/okstra_ctl/code_review_census.py +71 -7
  50. package/runtime/python/okstra_ctl/code_review_coverage.py +4 -274
  51. package/runtime/python/okstra_ctl/code_review_integrity.py +154 -0
  52. package/runtime/python/okstra_ctl/code_review_invocation.py +212 -0
  53. package/runtime/python/okstra_ctl/code_review_scope.py +36 -9
  54. package/runtime/python/okstra_ctl/code_review_target.py +85 -11
  55. package/runtime/python/okstra_ctl/consumers.py +12 -9
  56. package/runtime/python/okstra_ctl/design_review.py +207 -0
  57. package/runtime/python/okstra_ctl/design_review_evidence.py +297 -0
  58. package/runtime/python/okstra_ctl/doctor.py +8 -25
  59. package/runtime/python/okstra_ctl/doyouknow/__init__.py +9 -0
  60. package/runtime/python/okstra_ctl/doyouknow/cli.py +91 -0
  61. package/runtime/python/okstra_ctl/doyouknow/config.py +58 -0
  62. package/runtime/python/okstra_ctl/doyouknow/contracts.py +184 -0
  63. package/runtime/python/okstra_ctl/doyouknow/identity.py +22 -0
  64. package/runtime/python/okstra_ctl/doyouknow/paths.py +22 -0
  65. package/runtime/python/okstra_ctl/doyouknow/pending.py +72 -0
  66. package/runtime/python/okstra_ctl/doyouknow/registration.py +260 -0
  67. package/runtime/python/okstra_ctl/doyouknow/source_contracts.py +128 -0
  68. package/runtime/python/okstra_ctl/doyouknow/source_store.py +172 -0
  69. package/runtime/python/okstra_ctl/doyouknow/sources/io.py +36 -0
  70. package/runtime/python/okstra_ctl/doyouknow/sources/manager.py +261 -0
  71. package/runtime/python/okstra_ctl/doyouknow/sources/memory.py +179 -0
  72. package/runtime/python/okstra_ctl/doyouknow/sources/task.py +95 -0
  73. package/runtime/python/okstra_ctl/doyouknow/store.py +260 -0
  74. package/runtime/python/okstra_ctl/doyouknow/sync.py +58 -0
  75. package/runtime/python/okstra_ctl/execution_mutation_audit.py +18 -2
  76. package/runtime/python/okstra_ctl/file_size_cap.py +3 -4
  77. package/runtime/python/okstra_ctl/json_boundary.py +21 -2
  78. package/runtime/python/okstra_ctl/jsonl.py +21 -0
  79. package/runtime/python/okstra_ctl/manager_cli.py +26 -0
  80. package/runtime/python/okstra_ctl/manager_registration.py +29 -0
  81. package/runtime/python/okstra_ctl/manager_sync.py +3 -22
  82. package/runtime/python/okstra_ctl/model_io/renderers.py +13 -2
  83. package/runtime/python/okstra_ctl/model_io_cli.py +7 -1
  84. package/runtime/python/okstra_ctl/phases/final_verification/validation.py +20 -0
  85. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-deliverable.md +10 -0
  86. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-diff-review.md +19 -6
  87. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-self-check.md +5 -3
  88. package/runtime/python/okstra_ctl/phases/implementation/instructions/_implementation-verifier.md +38 -10
  89. package/runtime/python/okstra_ctl/phases/implementation/report_assets/implementation.template.html +13 -0
  90. package/runtime/python/okstra_ctl/phases/implementation/spec.md +25 -0
  91. package/runtime/python/okstra_ctl/phases/implementation/validation.py +6 -0
  92. package/runtime/python/okstra_ctl/phases/implementation_planning/authoring.py +4 -0
  93. package/runtime/python/okstra_ctl/phases/implementation_planning/profile.md +1 -1
  94. package/runtime/python/okstra_ctl/report_assembly.py +15 -0
  95. package/runtime/python/okstra_ctl/report_narrative.py +3 -0
  96. package/runtime/python/okstra_ctl/report_synthesis_packet.py +11 -2
  97. package/runtime/python/okstra_ctl/review_policy.py +359 -0
  98. package/runtime/python/okstra_ctl/review_verdicts.py +291 -0
  99. package/runtime/python/okstra_ctl/run.py +24 -1
  100. package/runtime/python/okstra_ctl/stage_done.py +11 -0
  101. package/runtime/python/okstra_ctl/standalone_review_audit.py +28 -0
  102. package/runtime/python/okstra_ctl/verification_generation.py +23 -1
  103. package/runtime/python/okstra_ctl/verification_input_types.py +15 -1
  104. package/runtime/python/okstra_ctl/verification_inputs.py +28 -6
  105. package/runtime/python/okstra_ctl/verification_invocation.py +7 -1
  106. package/runtime/python/okstra_ctl/verification_target.py +2 -0
  107. package/runtime/python/okstra_ctl/worker_prompt_headers.py +24 -9
  108. package/runtime/python/okstra_ctl/worker_runner.py +66 -10
  109. package/runtime/python/okstra_ctl/write_policy.py +34 -1
  110. package/runtime/python/okstra_project/__init__.py +2 -0
  111. package/runtime/python/okstra_project/dirs.py +18 -0
  112. package/runtime/python/okstra_project/state.py +25 -20
  113. package/runtime/schemas/doyouknow-config-v1.schema.json +20 -0
  114. package/runtime/schemas/doyouknow-v1.schema.json +65 -0
  115. package/runtime/schemas/final-report-v2.0.schema.json +157 -0
  116. package/runtime/schemas/final-report-v3.0.schema.json +157 -0
  117. package/runtime/schemas/memory-entry-contract-v1.json +11 -0
  118. package/runtime/schemas/record-secret-patterns.json +41 -0
  119. package/runtime/skills/okstra-code-review/SKILL.md +71 -123
  120. package/runtime/skills/okstra-code-review/references/census-rules.md +29 -105
  121. package/runtime/skills/okstra-code-review/references/review-calibration.md +34 -54
  122. package/runtime/skills/okstra-manager/SKILL.md +7 -0
  123. package/runtime/skills/okstra-memory/SKILL.md +7 -0
  124. package/runtime/templates/implementation-worker-preamble.md +4 -9
  125. package/runtime/templates/worker-prompt-preamble.md +4 -12
  126. package/runtime/validators/validate-run.py +14 -2
@@ -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
+ }