@ixo/decision-oracle 0.2.12 → 0.2.13

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 (57) hide show
  1. package/README.md +2 -1
  2. package/dist/cli/commands/reviewer-note.d.ts +11 -0
  3. package/dist/cli/commands/reviewer-note.d.ts.map +1 -0
  4. package/dist/cli/commands/reviewer-note.js +36 -0
  5. package/dist/cli/commands/reviewer-note.js.map +1 -0
  6. package/dist/cli/index.js +2 -0
  7. package/dist/cli/index.js.map +1 -1
  8. package/dist/cli/lib/usage.d.ts +1 -1
  9. package/dist/cli/lib/usage.d.ts.map +1 -1
  10. package/dist/cli/lib/usage.js +1 -0
  11. package/dist/cli/lib/usage.js.map +1 -1
  12. package/dist/db/schema.d.ts +20 -0
  13. package/dist/db/schema.d.ts.map +1 -1
  14. package/dist/db/schema.js +7 -0
  15. package/dist/db/schema.js.map +1 -1
  16. package/dist/lib/api-lane/retention.d.ts.map +1 -1
  17. package/dist/lib/api-lane/retention.js +5 -1
  18. package/dist/lib/api-lane/retention.js.map +1 -1
  19. package/dist/lib/claim-erase.d.ts.map +1 -1
  20. package/dist/lib/claim-erase.js +5 -1
  21. package/dist/lib/claim-erase.js.map +1 -1
  22. package/dist/lib/redact.d.ts.map +1 -1
  23. package/dist/lib/redact.js +1 -0
  24. package/dist/lib/redact.js.map +1 -1
  25. package/dist/lib/review/reviewer-note-prompt.d.ts +43 -0
  26. package/dist/lib/review/reviewer-note-prompt.d.ts.map +1 -0
  27. package/dist/lib/review/reviewer-note-prompt.js +106 -0
  28. package/dist/lib/review/reviewer-note-prompt.js.map +1 -0
  29. package/dist/lib/review/reviewer-note.d.ts +67 -0
  30. package/dist/lib/review/reviewer-note.d.ts.map +1 -0
  31. package/dist/lib/review/reviewer-note.js +138 -0
  32. package/dist/lib/review/reviewer-note.js.map +1 -0
  33. package/dist/middleware/capability.d.ts +1 -1
  34. package/dist/middleware/capability.d.ts.map +1 -1
  35. package/dist/middleware/capability.js +4 -0
  36. package/dist/middleware/capability.js.map +1 -1
  37. package/dist/oracle.d.ts +1 -0
  38. package/dist/oracle.d.ts.map +1 -1
  39. package/dist/oracle.js +7 -0
  40. package/dist/oracle.js.map +1 -1
  41. package/dist/routes/v1/admin.d.ts.map +1 -1
  42. package/dist/routes/v1/admin.js +59 -0
  43. package/dist/routes/v1/admin.js.map +1 -1
  44. package/dist/routes/v1/claims.js +3 -0
  45. package/dist/routes/v1/claims.js.map +1 -1
  46. package/dist/routes/v1/reviews.js +2 -0
  47. package/dist/routes/v1/reviews.js.map +1 -1
  48. package/dist/workflows/claim-ingest.d.ts.map +1 -1
  49. package/dist/workflows/claim-ingest.js +23 -0
  50. package/dist/workflows/claim-ingest.js.map +1 -1
  51. package/docs/api.md +5 -3
  52. package/docs/guide.md +9 -0
  53. package/migrations/0026_reviewer_note.sql +1 -0
  54. package/migrations/meta/0026_snapshot.json +2983 -0
  55. package/migrations/meta/_journal.json +7 -0
  56. package/package.json +1 -1
  57. package/skills/create-rubric/SKILL.md +7 -0
@@ -183,6 +183,13 @@
183
183
  "when": 1792573809270,
184
184
  "tag": "0025_openhands",
185
185
  "breakpoints": true
186
+ },
187
+ {
188
+ "idx": 26,
189
+ "version": "6",
190
+ "when": 1792581171066,
191
+ "tag": "0026_reviewer_note",
192
+ "breakpoints": true
186
193
  }
187
194
  ]
188
195
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ixo/decision-oracle",
3
- "version": "0.2.12",
3
+ "version": "0.2.13",
4
4
  "license": "Apache-2.0",
5
5
  "description": "Run an IXO evaluation oracle: pull claims, produce facts with your handlers, let the decision engine decide, sign on chain",
6
6
  "keywords": [
@@ -110,6 +110,13 @@ default here is the author's call — ask.
110
110
  approvals only.
111
111
  - Everything a rubric declares under `sources` / `aiChecks` becomes work for whatever oracle is
112
112
  hired: a name declared here is a fact someone has to produce. Don't declare one nobody can answer.
113
+ - **A person reads what an AI check says.** When a claim is held for review, the reviewer sees each
114
+ check's reason beside the answer. Write `aiChecks` instructions so the model reports what it SAW
115
+ in plain words ("the photo shows a cleared pavement on Main St"), not that a rule held ("the
116
+ answer is specific and not placeholder text"). Oracles that turn on `policies.reviewerNote` (on
117
+ by default for Openhands checkers) also give the reviewer a plain-words note of what the answer
118
+ claims and what no check could verify, so a ReviewTask's `prompt` should ask the one question the
119
+ person must decide, in plain words.
113
120
 
114
121
  ## Output contract
115
122