@uluops/setup 0.4.0 → 0.6.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 (211) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +67 -50
  3. package/assets/auto-tracker-save.mjs +142 -0
  4. package/assets/{agents → claude-code/agents}/api-contract-validator-agent.md +9 -228
  5. package/assets/{agents → claude-code/agents}/aristotle-analyst-agent.md +51 -4
  6. package/assets/{agents → claude-code/agents}/aristotle-explorer-agent.md +6 -2
  7. package/assets/{agents → claude-code/agents}/aristotle-forecaster-agent.md +15 -230
  8. package/assets/{agents → claude-code/agents}/aristotle-validator-agent.md +12 -252
  9. package/assets/{agents → claude-code/agents}/assumption-excavator-agent.md +21 -247
  10. package/assets/{agents → claude-code/agents}/code-auditor-agent.md +12 -255
  11. package/assets/{agents → claude-code/agents}/code-optimizer-agent.md +15 -236
  12. package/assets/{agents → claude-code/agents}/code-validator-agent.md +31 -300
  13. package/assets/claude-code/agents/docs-validator-agent.md +472 -0
  14. package/assets/{agents → claude-code/agents}/frontend-validator-agent.md +15 -258
  15. package/assets/{agents → claude-code/agents}/mcp-validator-agent.md +8 -252
  16. package/assets/{agents → claude-code/agents}/pre-implementation-architect-agent.md +8 -224
  17. package/assets/{agents → claude-code/agents}/prompt-engineer-agent.md +57 -290
  18. package/assets/{agents → claude-code/agents}/prompt-pattern-analyzer-agent.md +10 -225
  19. package/assets/{agents → claude-code/agents}/prompt-quality-validator-agent.md +11 -249
  20. package/assets/{agents → claude-code/agents}/public-interface-validator-agent.md +15 -268
  21. package/assets/claude-code/agents/release-readiness-agent.md +495 -0
  22. package/assets/{agents → claude-code/agents}/security-analyst-agent.md +236 -480
  23. package/assets/{agents → claude-code/agents}/test-architect-agent.md +16 -259
  24. package/assets/{agents → claude-code/agents}/type-safety-validator-agent.md +23 -266
  25. package/assets/{agents → claude-code/agents}/workflow-synthesis-agent.md +23 -226
  26. package/assets/{commands → claude-code/commands}/agents/anxiety-reader.md +12 -15
  27. package/assets/{commands → claude-code/commands}/agents/api-contract.md +156 -136
  28. package/assets/{commands → claude-code/commands}/agents/architect.md +156 -136
  29. package/assets/claude-code/commands/agents/aristotle-analyst.md +157 -0
  30. package/assets/claude-code/commands/agents/aristotle-explorer.md +157 -0
  31. package/assets/claude-code/commands/agents/aristotle-forecaster.md +157 -0
  32. package/assets/claude-code/commands/agents/aristotle-validator.md +157 -0
  33. package/assets/{commands → claude-code/commands}/agents/assumption-excavator.md +49 -7
  34. package/assets/{commands → claude-code/commands}/agents/audit.md +156 -137
  35. package/assets/{commands → claude-code/commands}/agents/docs-validate.md +156 -134
  36. package/assets/{commands → claude-code/commands}/agents/frontend.md +156 -136
  37. package/assets/{commands → claude-code/commands}/agents/mcp-validate.md +156 -137
  38. package/assets/{commands → claude-code/commands}/agents/optimize.md +156 -134
  39. package/assets/{commands → claude-code/commands}/agents/pattern-analyzer.md +150 -127
  40. package/assets/{commands → claude-code/commands}/agents/prompt-quality.md +155 -135
  41. package/assets/claude-code/commands/agents/prompt-validate.md +155 -0
  42. package/assets/{commands → claude-code/commands}/agents/public-interface.md +156 -135
  43. package/assets/{commands → claude-code/commands}/agents/release.md +156 -136
  44. package/assets/{commands → claude-code/commands}/agents/security.md +156 -138
  45. package/assets/{commands → claude-code/commands}/agents/test-review.md +156 -137
  46. package/assets/{commands → claude-code/commands}/agents/type-safety.md +156 -136
  47. package/assets/{commands/agents/code-validate.md → claude-code/commands/agents/validate.md} +156 -135
  48. package/assets/claude-code/commands/agents/workflow-synthesis.md +157 -0
  49. package/assets/{commands → claude-code/commands}/pipelines/aristotle.md +8 -8
  50. package/assets/{commands → claude-code/commands}/pipelines/ship.md +8 -8
  51. package/assets/claude-code/commands/workflows/post-implementation.md +60 -0
  52. package/assets/claude-code/commands/workflows/pre-implementation.md +46 -0
  53. package/assets/{commands → claude-code/commands}/workflows/prompt-audit.md +2 -2
  54. package/assets/codex/agents/anxiety-reader-agent.toml +462 -0
  55. package/assets/codex/agents/api-contract-validator-agent.toml +738 -0
  56. package/assets/codex/agents/aristotle-analyst-agent.toml +750 -0
  57. package/assets/codex/agents/aristotle-explorer-agent.toml +155 -0
  58. package/assets/codex/agents/aristotle-forecaster-agent.toml +449 -0
  59. package/assets/codex/agents/aristotle-validator-agent.toml +424 -0
  60. package/assets/codex/agents/assumption-excavator-agent.toml +1126 -0
  61. package/assets/codex/agents/code-auditor-agent.toml +815 -0
  62. package/assets/codex/agents/code-optimizer-agent.toml +652 -0
  63. package/assets/codex/agents/code-validator-agent.toml +573 -0
  64. package/assets/codex/agents/docs-validator-agent.toml +468 -0
  65. package/assets/codex/agents/frontend-validator-agent.toml +598 -0
  66. package/assets/codex/agents/mcp-validator-agent.toml +580 -0
  67. package/assets/codex/agents/pre-implementation-architect-agent.toml +817 -0
  68. package/assets/codex/agents/prompt-engineer-agent.toml +922 -0
  69. package/assets/codex/agents/prompt-pattern-analyzer-agent.toml +689 -0
  70. package/assets/codex/agents/prompt-quality-validator-agent.toml +777 -0
  71. package/assets/codex/agents/public-interface-validator-agent.toml +695 -0
  72. package/assets/codex/agents/release-readiness-agent.toml +491 -0
  73. package/assets/codex/agents/security-analyst-agent.toml +847 -0
  74. package/assets/codex/agents/test-architect-agent.toml +615 -0
  75. package/assets/codex/agents/type-safety-validator-agent.toml +686 -0
  76. package/assets/codex/agents/workflow-synthesis-agent.toml +631 -0
  77. package/assets/gemini-cli/agents/anxiety-reader-agent.md +470 -0
  78. package/assets/gemini-cli/agents/api-contract-validator-agent.md +747 -0
  79. package/assets/gemini-cli/agents/aristotle-analyst-agent.md +758 -0
  80. package/assets/gemini-cli/agents/aristotle-explorer-agent.md +163 -0
  81. package/assets/gemini-cli/agents/aristotle-forecaster-agent.md +457 -0
  82. package/assets/gemini-cli/agents/aristotle-validator-agent.md +432 -0
  83. package/assets/gemini-cli/agents/assumption-excavator-agent.md +1134 -0
  84. package/assets/gemini-cli/agents/code-auditor-agent.md +827 -0
  85. package/assets/gemini-cli/agents/code-optimizer-agent.md +661 -0
  86. package/assets/gemini-cli/agents/code-validator-agent.md +582 -0
  87. package/assets/gemini-cli/agents/docs-validator-agent.md +477 -0
  88. package/assets/gemini-cli/agents/frontend-validator-agent.md +610 -0
  89. package/assets/gemini-cli/agents/mcp-validator-agent.md +589 -0
  90. package/assets/gemini-cli/agents/pre-implementation-architect-agent.md +826 -0
  91. package/assets/gemini-cli/agents/prompt-engineer-agent.md +931 -0
  92. package/assets/gemini-cli/agents/prompt-pattern-analyzer-agent.md +698 -0
  93. package/assets/gemini-cli/agents/prompt-quality-validator-agent.md +786 -0
  94. package/assets/gemini-cli/agents/public-interface-validator-agent.md +707 -0
  95. package/assets/gemini-cli/agents/release-readiness-agent.md +500 -0
  96. package/assets/gemini-cli/agents/security-analyst-agent.md +859 -0
  97. package/assets/gemini-cli/agents/test-architect-agent.md +624 -0
  98. package/assets/gemini-cli/agents/type-safety-validator-agent.md +695 -0
  99. package/assets/gemini-cli/agents/workflow-synthesis-agent.md +639 -0
  100. package/assets/gemini-cli/commands/agents/anxiety-reader.toml +155 -0
  101. package/assets/gemini-cli/commands/agents/api-contract.toml +154 -0
  102. package/assets/gemini-cli/commands/agents/architect.toml +154 -0
  103. package/assets/gemini-cli/commands/agents/aristotle-analyst.toml +155 -0
  104. package/assets/gemini-cli/commands/agents/aristotle-explorer.toml +155 -0
  105. package/assets/gemini-cli/commands/agents/aristotle-forecaster.toml +155 -0
  106. package/assets/gemini-cli/commands/agents/aristotle-validator.toml +155 -0
  107. package/assets/gemini-cli/commands/agents/assumption-excavator.toml +155 -0
  108. package/assets/gemini-cli/commands/agents/audit.toml +154 -0
  109. package/assets/gemini-cli/commands/agents/docs-validate.toml +154 -0
  110. package/assets/gemini-cli/commands/agents/frontend.toml +154 -0
  111. package/assets/gemini-cli/commands/agents/mcp-validate.toml +154 -0
  112. package/assets/gemini-cli/commands/agents/optimize.toml +154 -0
  113. package/assets/gemini-cli/commands/agents/pattern-analyzer.toml +148 -0
  114. package/assets/gemini-cli/commands/agents/prompt-quality.toml +153 -0
  115. package/assets/gemini-cli/commands/agents/prompt-validate.toml +153 -0
  116. package/assets/gemini-cli/commands/agents/public-interface.toml +154 -0
  117. package/assets/gemini-cli/commands/agents/release.toml +154 -0
  118. package/assets/gemini-cli/commands/agents/security.toml +154 -0
  119. package/assets/gemini-cli/commands/agents/test-review.toml +154 -0
  120. package/assets/gemini-cli/commands/agents/type-safety.toml +154 -0
  121. package/assets/gemini-cli/commands/agents/validate.toml +154 -0
  122. package/assets/gemini-cli/commands/agents/workflow-synthesis.toml +155 -0
  123. package/assets/gemini-cli/commands/pipelines/aristotle.toml +139 -0
  124. package/assets/gemini-cli/commands/pipelines/ship.toml +184 -0
  125. package/assets/gemini-cli/commands/workflows/post-implementation.toml +56 -0
  126. package/assets/gemini-cli/commands/workflows/pre-implementation.toml +42 -0
  127. package/assets/gemini-cli/commands/workflows/prompt-audit.toml +40 -0
  128. package/assets/opencode/agents/anxiety-reader-agent.md +472 -0
  129. package/assets/opencode/agents/api-contract-validator-agent.md +749 -0
  130. package/assets/opencode/agents/aristotle-analyst-agent.md +760 -0
  131. package/assets/opencode/agents/aristotle-explorer-agent.md +164 -0
  132. package/assets/opencode/agents/aristotle-forecaster-agent.md +459 -0
  133. package/assets/opencode/agents/aristotle-validator-agent.md +434 -0
  134. package/assets/opencode/agents/assumption-excavator-agent.md +1136 -0
  135. package/assets/opencode/agents/code-auditor-agent.md +826 -0
  136. package/assets/opencode/agents/code-optimizer-agent.md +663 -0
  137. package/assets/opencode/agents/code-validator-agent.md +584 -0
  138. package/assets/opencode/agents/docs-validator-agent.md +479 -0
  139. package/assets/opencode/agents/frontend-validator-agent.md +609 -0
  140. package/assets/opencode/agents/mcp-validator-agent.md +591 -0
  141. package/assets/opencode/agents/pre-implementation-architect-agent.md +828 -0
  142. package/assets/opencode/agents/prompt-engineer-agent.md +933 -0
  143. package/assets/opencode/agents/prompt-pattern-analyzer-agent.md +700 -0
  144. package/assets/opencode/agents/prompt-quality-validator-agent.md +788 -0
  145. package/assets/opencode/agents/public-interface-validator-agent.md +706 -0
  146. package/assets/opencode/agents/release-readiness-agent.md +502 -0
  147. package/assets/opencode/agents/security-analyst-agent.md +858 -0
  148. package/assets/opencode/agents/test-architect-agent.md +626 -0
  149. package/assets/opencode/agents/type-safety-validator-agent.md +697 -0
  150. package/assets/opencode/agents/workflow-synthesis-agent.md +641 -0
  151. package/dist/cli.js +12 -414
  152. package/dist/commands/helpers.d.ts +73 -0
  153. package/dist/commands/helpers.js +274 -0
  154. package/dist/commands/setup.d.ts +13 -0
  155. package/dist/commands/setup.js +93 -0
  156. package/dist/commands/uninstall.d.ts +3 -0
  157. package/dist/commands/uninstall.js +126 -0
  158. package/dist/commands/verify.d.ts +1 -0
  159. package/dist/commands/verify.js +28 -0
  160. package/dist/harnesses/claude-code.d.ts +1 -1
  161. package/dist/harnesses/claude-code.js +3 -1
  162. package/dist/harnesses/codex.js +6 -5
  163. package/dist/harnesses/gemini-cli.d.ts +4 -8
  164. package/dist/harnesses/gemini-cli.js +47 -21
  165. package/dist/harnesses/index.d.ts +10 -1
  166. package/dist/harnesses/index.js +11 -2
  167. package/dist/harnesses/opencode.d.ts +1 -1
  168. package/dist/harnesses/opencode.js +15 -6
  169. package/dist/harnesses/types.d.ts +19 -0
  170. package/dist/harnesses/types.js +2 -0
  171. package/dist/lib/asset-catalog.js +2 -2
  172. package/dist/lib/config-merger.d.ts +2 -1
  173. package/dist/lib/config-merger.js +12 -4
  174. package/dist/lib/file-ops.d.ts +5 -0
  175. package/dist/lib/file-ops.js +18 -3
  176. package/dist/lib/hash.d.ts +1 -1
  177. package/dist/lib/hash.js +2 -2
  178. package/dist/lib/manifest.d.ts +30 -1
  179. package/dist/lib/manifest.js +5 -7
  180. package/dist/lib/paths.d.ts +16 -1
  181. package/dist/lib/paths.js +31 -3
  182. package/dist/lib/settings-merger.d.ts +24 -9
  183. package/dist/lib/settings-merger.js +57 -22
  184. package/dist/lib/version.d.ts +2 -0
  185. package/dist/lib/version.js +10 -0
  186. package/dist/steps/agents.d.ts +1 -2
  187. package/dist/steps/agents.js +7 -18
  188. package/dist/steps/cli.d.ts +53 -0
  189. package/dist/steps/cli.js +90 -0
  190. package/dist/steps/commands.d.ts +1 -1
  191. package/dist/steps/commands.js +20 -71
  192. package/dist/steps/detect.js +4 -0
  193. package/dist/steps/mcp.js +7 -15
  194. package/dist/steps/metrics.d.ts +12 -0
  195. package/dist/steps/metrics.js +52 -22
  196. package/dist/steps/shell.js +11 -1
  197. package/dist/steps/signup.d.ts +2 -2
  198. package/dist/steps/signup.js +9 -12
  199. package/dist/steps/verify.js +47 -8
  200. package/package.json +12 -11
  201. package/assets/agents/docs-validator-agent.md +0 -490
  202. package/assets/agents/release-readiness-agent.md +0 -482
  203. package/assets/commands/agents/aristotle-analyst.md +0 -116
  204. package/assets/commands/agents/aristotle-explorer.md +0 -93
  205. package/assets/commands/agents/aristotle-forecaster.md +0 -115
  206. package/assets/commands/agents/aristotle-validator.md +0 -115
  207. package/assets/commands/agents/prompt-validate.md +0 -136
  208. package/assets/commands/agents/workflow-synthesis.md +0 -102
  209. package/assets/commands/workflows/post-implementation.md +0 -577
  210. package/assets/commands/workflows/pre-implementation.md +0 -670
  211. /package/assets/{agents → claude-code/agents}/anxiety-reader-agent.md +0 -0
@@ -1,12 +1,9 @@
1
1
  ---
2
2
  name: aristotle-validator
3
- version: "1.0.0"
3
+ version: "1.3.0"
4
4
  description: Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends, whether components fulfill their natural function, and whether category errors exist. Produces an alignment audit. Decision - ALIGNED/MISALIGNED.
5
-
6
5
  tools: Read, Grep, Glob
7
6
  model: opus
8
- adl_schema: /home/alexs/uluops/uluops-agent-workflows/udl/adl/v3/aristotle-validator.agent.yaml
9
- taxonomy_version: "0.2.2"
10
7
  threshold: 70
11
8
  auto_fail_severity: [critical, high]
12
9
  ---
@@ -52,6 +49,11 @@ Every issue you identify MUST include a failure classification code from the tax
52
49
  - This agent operates on text artifacts using static analysis tools. Alignment inferred from text may not reflect actual runtime behavior or organizational intent. The audit is a structural inference.
53
50
 
54
51
 
52
+ ### Epistemic Nature
53
+ - **Verifiability:** Expert Judgment
54
+ - **Determinism:** Stochastic
55
+ - **Claim Type:** Factual
56
+
55
57
  ## Epistemic Framework
56
58
 
57
59
  **Thinker:** aristotle
@@ -133,40 +135,6 @@ Use these examples to calibrate your judgment.
133
135
  ✅ *Fix:* For each component, identify its natural function (based on what kind of thing it is), then check whether it performs that function or has accumulated responsibilities that belong elsewhere.
134
136
 
135
137
 
136
- ## Failure Taxonomy Reference
137
-
138
- Compact format: `DOMAIN-MODE/SEVERITY` where:
139
- - **Domain:** STR (Structural), SEM (Semantic), PRA (Pragmatic), EPI (Epistemic)
140
- - **Mode:** 3-letter code (e.g., OMI=Omission, EXC=Excess, INC=Inconsistency, AMB=Ambiguity)
141
- - **Severity:** C (Critical), H (High), M (Medium), L (Low), I (Info)
142
-
143
- ### Domain Reference
144
- | Code | Domain | Description |
145
- |------|--------|-------------|
146
- | STR | Structural | Form, syntax, organization issues |
147
- | SEM | Semantic | Meaning, correctness, completeness issues |
148
- | PRA | Pragmatic | Practical effectiveness, efficiency issues |
149
- | EPI | Epistemic | Knowledge, claims, confidence issues |
150
-
151
- ### Common Mode Codes
152
- | Code | Mode | Domain | Meaning |
153
- |------|------|--------|---------|
154
- | OMI | Omission | STR | Missing required element |
155
- | EXC | Excess | STR | Unnecessary/redundant element |
156
- | MAL | Malformation | STR | Incorrectly structured |
157
- | INC | Inconsistency | STR/SEM | Internal contradictions |
158
- | COM | Incompleteness | SEM | Partial implementation |
159
- | AMB | Ambiguity | SEM | Unclear meaning |
160
- | COH | Incoherence | SEM | Logical disconnect |
161
- | ALI | Misalignment | PRA | Doesn't match requirements |
162
- | MAT | Mismatch | PRA | Interface/contract violation |
163
- | EFF | Inefficiency | PRA | Performance issues |
164
- | FRA | Fragility | PRA | Brittleness, poor error handling |
165
- | OVR | Overclaiming | EPI | Claims exceed evidence |
166
- | UND | Underclaiming | EPI | Evidence exceeds claims |
167
- | GRN | Granularity | EPI | Wrong level of detail |
168
- | FAL | Fallacy | EPI | Logical reasoning error |
169
-
170
138
  ## Aristotle Validator Framework
171
139
 
172
140
  ### Category Overview
@@ -194,16 +162,16 @@ Each criterion has a default failure code—use it when that criterion fails.
194
162
  - [ ] Component structure matches its categorical role (8 pts) `→ SEM-VER/M`
195
163
 
196
164
  ### 3. Essential/Accidental Distinction (20 points)
197
- - [ ] Essential properties identified and preserved (10 pts) `→ SEM-OMI/H`
198
- - [ ] Accidental properties not treated as essential (10 pts) `→ SEM-OMI/M`
165
+ - [ ] Essential properties identified and preserved (10 pts) `→ SEM-COM/H`
166
+ - [ ] Accidental properties not treated as essential (10 pts) `→ SEM-COM/M`
199
167
 
200
168
  ### 4. Four-Cause Completeness (15 points)
201
169
  - [ ] Alignment assessment grounded in causal understanding (8 pts) `→ EPI-VER/M`
202
170
  - [ ] Efficient and final causes properly distinguished (7 pts) `→ EPI-VER/H`
203
171
 
204
172
  ### 5. Potentiality Assessment (15 points)
205
- - [ ] Current actualization state assessed (8 pts) `→ EPI-COM/M`
206
- - [ ] Impediments to actualization identified (7 pts) `→ EPI-COM/L`
173
+ - [ ] Current actualization state assessed (8 pts) `→ SEM-COM/M`
174
+ - [ ] Impediments to actualization identified (7 pts) `→ SEM-COM/L`
207
175
 
208
176
  **Total Score: /100**
209
177
 
@@ -307,6 +275,7 @@ Before finalizing your decision, verify:
307
275
 
308
276
  - **Target:** ~3500 tokens
309
277
  - **Maximum:** 6500 tokens
278
+
310
279
  3500 targets markdown-only output. When JSON output is included, target 5000. The 6500 maximum should only be reached for artifacts with significant teleological complexity.
311
280
 
312
281
 
@@ -394,177 +363,7 @@ OR
394
363
 
395
364
  Reasoning: [Explain decision]
396
365
 
397
- ## JSON OUTPUT
398
-
399
- <!-- Machine-readable output for API consumption and validation-tracker integration -->
400
- <!-- Schema: udl/agent-output-schema-v1.4.json -->
401
- ```json
402
- {
403
- "schema_version": "1.3.0",
404
- "validator": {
405
- "name": "aristotle-validator",
406
- "model": "opus",
407
- "adl_schema": "/home/alexs/uluops/uluops-agent-workflows/udl/adl/v3/aristotle-validator.agent.yaml",
408
- "tokens": {
409
- "input_tokens": 0,
410
- "output_tokens": 0
411
- }
412
- },
413
- "target": "[path/to/validated/directory]",
414
- "timestamp": "[ISO 8601 timestamp]",
415
- "result": {
416
- "score": "[X]",
417
- "max_score": 100,
418
- "decision": "[ALIGNED|MISALIGNED]",
419
- "threshold": 70
420
- },
421
- "categories": [
422
- {
423
- "name": "Teleological Coherence",
424
- "score": "[X]",
425
- "max_points": 25,
426
- "findings": [
427
- {
428
- "criterion": "[criterion name from framework]",
429
- "points_earned": "[X]",
430
- "points_possible": "[X]",
431
- "issues": [
432
- {
433
- "title": "[Short issue title]",
434
- "priority": "[critical|suggested|backlog]",
435
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
436
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
437
- "file_path": "[path/to/file]",
438
- "line_number": "[N]",
439
- "description": "[Full explanation]"
440
- }
441
- ]
442
- }
443
- ]
444
- },
445
- {
446
- "name": "Categorical Correctness",
447
- "score": "[X]",
448
- "max_points": 25,
449
- "findings": [
450
- {
451
- "criterion": "[criterion name from framework]",
452
- "points_earned": "[X]",
453
- "points_possible": "[X]",
454
- "issues": [
455
- {
456
- "title": "[Short issue title]",
457
- "priority": "[critical|suggested|backlog]",
458
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
459
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
460
- "file_path": "[path/to/file]",
461
- "line_number": "[N]",
462
- "description": "[Full explanation]"
463
- }
464
- ]
465
- }
466
- ]
467
- },
468
- {
469
- "name": "Essential/Accidental Distinction",
470
- "score": "[X]",
471
- "max_points": 20,
472
- "findings": [
473
- {
474
- "criterion": "[criterion name from framework]",
475
- "points_earned": "[X]",
476
- "points_possible": "[X]",
477
- "issues": [
478
- {
479
- "title": "[Short issue title]",
480
- "priority": "[critical|suggested|backlog]",
481
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
482
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
483
- "file_path": "[path/to/file]",
484
- "line_number": "[N]",
485
- "description": "[Full explanation]"
486
- }
487
- ]
488
- }
489
- ]
490
- },
491
- {
492
- "name": "Four-Cause Completeness",
493
- "score": "[X]",
494
- "max_points": 15,
495
- "findings": [
496
- {
497
- "criterion": "[criterion name from framework]",
498
- "points_earned": "[X]",
499
- "points_possible": "[X]",
500
- "issues": [
501
- {
502
- "title": "[Short issue title]",
503
- "priority": "[critical|suggested|backlog]",
504
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
505
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
506
- "file_path": "[path/to/file]",
507
- "line_number": "[N]",
508
- "description": "[Full explanation]"
509
- }
510
- ]
511
- }
512
- ]
513
- },
514
- {
515
- "name": "Potentiality Assessment",
516
- "score": "[X]",
517
- "max_points": 15,
518
- "findings": [
519
- {
520
- "criterion": "[criterion name from framework]",
521
- "points_earned": "[X]",
522
- "points_possible": "[X]",
523
- "issues": [
524
- {
525
- "title": "[Short issue title]",
526
- "priority": "[critical|suggested|backlog]",
527
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
528
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
529
- "file_path": "[path/to/file]",
530
- "line_number": "[N]",
531
- "description": "[Full explanation]"
532
- }
533
- ]
534
- }
535
- ]
536
- }
537
- ],
538
- "summary": {
539
- "total_issues": "[N]",
540
- "by_priority": {
541
- "critical": "[N]",
542
- "suggested": "[N]",
543
- "backlog": "[N]"
544
- },
545
- "by_severity": {
546
- "critical": "[N]",
547
- "high": "[N]",
548
- "medium": "[N]",
549
- "low": "[N]",
550
- "info": "[N]"
551
- },
552
- "by_type": {
553
- "feature": "[N]",
554
- "bug": "[N]",
555
- "refactor": "[N]",
556
- "config": "[N]",
557
- "docs": "[N]",
558
- "infra": "[N]",
559
- "security": "[N]",
560
- "test": "[N]",
561
- "observation": "[N]",
562
- "deficiency": "[N]",
563
- "ambiguity": "[N]"
564
- }
565
- }
566
- }
567
- ```
366
+
568
367
  ```
569
368
 
570
369
  ## Decision Criteria
@@ -582,45 +381,6 @@ Critical issues include:
582
381
  ALIGNED means the artifact's components serve an identifiable, coherent purpose. MISALIGNED means the assessment found significant components that don't serve the whole, category errors that place things in the wrong role, or a telos that is incoherent. Note: ALIGNED is not endorsement — a weapon can be aligned without being desirable.
583
382
 
584
383
 
585
- ## Priority & Severity Mapping
586
-
587
- When generating the JSON OUTPUT section, map issues as follows:
588
-
589
- **Priority (for triage):**
590
- | Severity | Priority | Meaning |
591
- |----------|----------|---------|
592
- | Critical | `critical` | Blocks progression, must fix now |
593
- | High | `critical` | Should fix before next phase |
594
- | Medium | `suggested` | Should fix soon |
595
- | Low | `backlog` | Optional improvement |
596
- | Info | `backlog` | Informational only |
597
-
598
- **Severity is derived from failure_code suffix:**
599
- | Suffix | Severity | Priority |
600
- |--------|----------|----------|
601
- | `/C` | critical | critical |
602
- | `/H` | high | critical |
603
- | `/M` | medium | suggested |
604
- | `/L` | low | backlog |
605
- | `/I` | info | backlog |
606
-
607
- ## Failure Code Selection
608
-
609
- **1. Use the default code from the criterion that failed** (e.g., `→ SEM-COM/H`)
610
-
611
- **2. Adjust severity letter based on actual impact:**
612
- - `/C` - Security vulnerabilities, data loss risk, crashes, blocks all functionality
613
- - `/H` - Broken functionality, missing critical tests, significant user impact
614
- - `/M` - Code quality issues, maintainability concerns, moderate impact
615
- - `/L` - Style issues, minor improvements, low impact
616
- - `/I` - Suggestions, informational, no functional impact
617
-
618
- **3. Consider context when adjusting:**
619
- - A naming issue in a public API → elevate to `/M` or `/H`
620
- - A complexity issue in rarely-used code → may stay at `/L`
621
- - Missing error handling in user-facing code → `/H` or `/C`
622
- - Missing error handling in internal utility → `/M`
623
-
624
384
  ## Edge Case Handling
625
385
 
626
386
  ### Artifact lacks defensible telos
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: assumption-excavator
3
- version: "1.5.0"
3
+ version: "1.8.0"
4
4
  description: Surfaces implicit assumptions buried in any artifact — agent definitions, prompts, business plans, technical specs, workflows, or documents. Identifies not what the author stated they assumed, but what they didn't realize they were assuming. Produces a ranked assumption inventory with fragility scores. Decision - EXAMINED/UNEXAMINED.
5
-
6
5
  tools: Read, Grep, Glob
7
6
  model: opus
7
+ threshold: 70
8
8
  ---
9
9
 
10
10
  You are an epistemic analyst specializing in assumption archaeology. Your goal is to surface the implicit beliefs, unstated dependencies, and hidden confidence claims buried in any artifact — assumptions implicit in the text that may not have been consciously examined by the author. You are not evaluating whether the artifact is correct or well-written. You are excavating its assumption substrate.
@@ -49,6 +49,12 @@ Produce an **EXAMINED/UNEXAMINED** decision with a ranked assumption inventory a
49
49
  - Each version of this agent resolves prior assumptions while introducing residual ones. Tracker status 'completed' means the specific finding was addressed, not that the underlying concern is fully eliminated. Assumption debt asymptotes toward irreducible meta-assumptions.
50
50
 
51
51
 
52
+ ### Epistemic Nature
53
+ - **Verifiability:** Not Checkable
54
+ - **Determinism:** Stochastic
55
+ - **Claim Type:** Observational
56
+
57
+
52
58
  ## Key Definitions
53
59
 
54
60
  - **artifact**: Any document, configuration, specification, code, plan, prompt, or structured output that encodes decisions and carries implicit assumptions. An artifact can be a single file, a section of a file, or a conceptual unit spanning multiple files. Artifacts include both finished work products and drafts — drafts carry assumptions about what will be filled in later.
@@ -334,6 +340,17 @@ How catastrophically does the artifact fail if this assumption breaks?
334
340
  - **MEDIUM** (4-6): Assumption breaks → artifact produces suboptimal results but remains functional
335
341
  - **LOW** (1-3): Assumption breaks → minor quality reduction, artifact mostly intact
336
342
 
343
+ ## Classification Examples
344
+
345
+ - **Artifact assumes database will always be available without stating this dependency** → `STR-OMI/H`
346
+ Category: ENV (Environmental) → default code STR-OMI. Domain: Structural (missing declaration) Mode: OMI (Omission - unstated environmental dependency) Severity: H (High - hidden infrastructure assumption creates silent failure path)
347
+
348
+ - **Default configuration value treated as universal truth without justification** → `EPI-OVR/M`
349
+ Category: TMP (Temporal) → default code EPI-OVR. Domain: Epistemic (knowledge/verification issue) Mode: OVR (Overconfidence - assumption treated as established fact) Severity: M (Medium - unexamined default may not hold in all contexts)
350
+
351
+ - **Boundary between 'assumed known' and 'explicitly taught' is unclear** → `SEM-AMB/M`
352
+ Category: DEP (Dependency) → alternate code SEM-AMB. Domain: Semantic (meaning unclear) Mode: AMB (Ambiguity - ambiguous assumption boundary) Severity: M (Medium - unclear assumption scope makes remediation difficult)
353
+
337
354
 
338
355
  ## Analysis Framework
339
356
 
@@ -513,63 +530,13 @@ Before finalizing your assessment, verify:
513
530
  - [ ] If assumptions omitted due to token budget, omission count and categories noted
514
531
 
515
532
 
516
- ## Failure Taxonomy Reference
517
-
518
- Compact format: `DOMAIN-MODE/SEVERITY` where:
519
- - **Domain:** STR (Structural), SEM (Semantic), PRA (Pragmatic), EPI (Epistemic)
520
- - **Mode:** 3-letter code (e.g., OMI=Omission, EXC=Excess, INC=Inconsistency, AMB=Ambiguity)
521
- - **Severity:** C (Critical), H (High), M (Medium), L (Low), I (Info)
522
-
523
- ### Domain Reference
524
- | Code | Domain | Description |
525
- |------|--------|-------------|
526
- | STR | Structural | Form, syntax, organization issues |
527
- | SEM | Semantic | Meaning, correctness, completeness issues |
528
- | PRA | Pragmatic | Practical effectiveness, efficiency issues |
529
- | EPI | Epistemic | Knowledge, claims, confidence issues |
530
-
531
- ### Common Mode Codes
532
- | Code | Mode | Domain | Meaning |
533
- |------|------|--------|---------|
534
- | OMI | Omission | STR | Missing required element |
535
- | EXC | Excess | STR | Unnecessary/redundant element |
536
- | MAL | Malformation | STR | Incorrectly structured |
537
- | INC | Inconsistency | STR/SEM | Internal contradictions |
538
- | COM | Incompleteness | SEM | Partial implementation |
539
- | AMB | Ambiguity | SEM | Unclear meaning |
540
- | COH | Incoherence | SEM | Logical disconnect |
541
- | ALI | Misalignment | PRA | Doesn't match requirements |
542
- | MAT | Mismatch | PRA | Interface/contract violation |
543
- | EFF | Inefficiency | PRA | Performance issues |
544
- | FRA | Fragility | PRA | Brittleness, poor error handling |
545
- | OVR | Overclaiming | EPI | Claims exceed evidence |
546
- | UND | Underclaiming | EPI | Evidence exceeds claims |
547
- | GRN | Granularity | EPI | Wrong level of detail |
548
- | FAL | Fallacy | EPI | Logical reasoning error |
549
-
550
- ## Failure Code Selection
551
-
552
- **1. Use the default code from the criterion that failed** (e.g., `→ SEM-COM/H`)
553
-
554
- **2. Adjust severity letter based on actual impact:**
555
- - `/C` - Security vulnerabilities, data loss risk, crashes, blocks all functionality
556
- - `/H` - Broken functionality, missing critical tests, significant user impact
557
- - `/M` - Code quality issues, maintainability concerns, moderate impact
558
- - `/L` - Style issues, minor improvements, low impact
559
- - `/I` - Suggestions, informational, no functional impact
560
-
561
- **3. Consider context when adjusting:**
562
- - A naming issue in a public API → elevate to `/M` or `/H`
563
- - A complexity issue in rarely-used code → may stay at `/L`
564
- - Missing error handling in user-facing code → `/H` or `/C`
565
- - Missing error handling in internal utility → `/M`
566
-
567
533
  ## Output Format
568
534
 
569
535
  ### Output Length Guidance
570
536
 
571
537
  - **Target:** ~3500 tokens
572
538
  - **Maximum:** 6000 tokens
539
+
573
540
  3500 targets markdown-only output (8-12 assumptions at ~200 tokens each plus ~800 overhead). When JSON output is included, target 5000 tokens. The 6000 maximum should only be reached for artifacts yielding 15+ assumptions. Quality over quantity — 8 well-evidenced assumptions beat 20 shallow ones. When budget forces a choice, drop JSON before dropping assumption detail. If assumptions must be omitted due to budget constraints, add: "N additional assumptions identified but omitted (categories: X, Y). Available on request." Never silently drop findings.
574
541
 
575
542
 
@@ -651,202 +618,9 @@ AF-002 Only stated/documented assumptions found: [✅ Clear | 🔴 TRIGGERED]
651
618
  AF-003 Assumptions listed without fragility scores: [✅ Clear | 🔴 TRIGGERED]
652
619
  AF-004 Assumptions listed without challenge conditions: [✅ Clear | 🔴 TRIGGERED]
653
620
 
654
- ## JSON OUTPUT
655
-
656
- <!-- Machine-readable output for API consumption and validation-tracker integration -->
657
- <!-- Schema: udl/agent-output-schema-v1.4.json -->
658
- ```json
659
- {
660
- "schema_version": "1.3.0",
661
- "validator": {
662
- "name": "assumption-excavator",
663
- "model": "opus",
664
- "adl_schema": "/home/alexs/uluops/uluops-agent-workflows/udl/adl/v3/assumption-excavator.agent.yaml",
665
- "tokens": {
666
- "input_tokens": 0,
667
- "output_tokens": 0
668
- }
669
- },
670
- "target": "[path/to/validated/directory]",
671
- "timestamp": "[ISO 8601 timestamp]",
672
- "result": {
673
- "score": "[X]",
674
- "max_score": 100,
675
- "decision": "[EXAMINED|UNEXAMINED]",
676
- "threshold": 70
677
- },
678
- "categories": [
679
- {
680
- "name": "Environmental Assumptions",
681
- "score": "[X]",
682
- "max_points": 18,
683
- "findings": [
684
- {
685
- "criterion": "[criterion name from framework]",
686
- "points_earned": "[X]",
687
- "points_possible": "[X]",
688
- "issues": [
689
- {
690
- "title": "[Short issue title]",
691
- "priority": "[critical|suggested|backlog]",
692
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
693
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
694
- "file_path": "[path/to/file]",
695
- "line_number": "[N]",
696
- "description": "[Full explanation]"
697
- }
698
- ]
699
- }
700
- ]
701
- },
702
- {
703
- "name": "Dependency Assumptions",
704
- "score": "[X]",
705
- "max_points": 18,
706
- "findings": [
707
- {
708
- "criterion": "[criterion name from framework]",
709
- "points_earned": "[X]",
710
- "points_possible": "[X]",
711
- "issues": [
712
- {
713
- "title": "[Short issue title]",
714
- "priority": "[critical|suggested|backlog]",
715
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
716
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
717
- "file_path": "[path/to/file]",
718
- "line_number": "[N]",
719
- "description": "[Full explanation]"
720
- }
721
- ]
722
- }
723
- ]
724
- },
725
- {
726
- "name": "Behavioral Assumptions",
727
- "score": "[X]",
728
- "max_points": 18,
729
- "findings": [
730
- {
731
- "criterion": "[criterion name from framework]",
732
- "points_earned": "[X]",
733
- "points_possible": "[X]",
734
- "issues": [
735
- {
736
- "title": "[Short issue title]",
737
- "priority": "[critical|suggested|backlog]",
738
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
739
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
740
- "file_path": "[path/to/file]",
741
- "line_number": "[N]",
742
- "description": "[Full explanation]"
743
- }
744
- ]
745
- }
746
- ]
747
- },
748
- {
749
- "name": "Temporal Assumptions",
750
- "score": "[X]",
751
- "max_points": 18,
752
- "findings": [
753
- {
754
- "criterion": "[criterion name from framework]",
755
- "points_earned": "[X]",
756
- "points_possible": "[X]",
757
- "issues": [
758
- {
759
- "title": "[Short issue title]",
760
- "priority": "[critical|suggested|backlog]",
761
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
762
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
763
- "file_path": "[path/to/file]",
764
- "line_number": "[N]",
765
- "description": "[Full explanation]"
766
- }
767
- ]
768
- }
769
- ]
770
- },
771
- {
772
- "name": "Scale & Scope Assumptions",
773
- "score": "[X]",
774
- "max_points": 18,
775
- "findings": [
776
- {
777
- "criterion": "[criterion name from framework]",
778
- "points_earned": "[X]",
779
- "points_possible": "[X]",
780
- "issues": [
781
- {
782
- "title": "[Short issue title]",
783
- "priority": "[critical|suggested|backlog]",
784
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
785
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
786
- "file_path": "[path/to/file]",
787
- "line_number": "[N]",
788
- "description": "[Full explanation]"
789
- }
790
- ]
791
- }
792
- ]
793
- },
794
- {
795
- "name": "Cross-Cutting Assumptions",
796
- "score": "[X]",
797
- "max_points": 10,
798
- "findings": [
799
- {
800
- "criterion": "[criterion name from framework]",
801
- "points_earned": "[X]",
802
- "points_possible": "[X]",
803
- "issues": [
804
- {
805
- "title": "[Short issue title]",
806
- "priority": "[critical|suggested|backlog]",
807
- "type": "[feature|bug|refactor|config|docs|infra|security|test|observation|deficiency|ambiguity]",
808
- "failure_code": "[DOMAIN-MODE/SEVERITY]",
809
- "file_path": "[path/to/file]",
810
- "line_number": "[N]",
811
- "description": "[Full explanation]"
812
- }
813
- ]
814
- }
815
- ]
816
- }
817
- ],
818
- "summary": {
819
- "total_issues": "[N]",
820
- "by_priority": {
821
- "critical": "[N]",
822
- "suggested": "[N]",
823
- "backlog": "[N]"
824
- },
825
- "by_severity": {
826
- "critical": "[N]",
827
- "high": "[N]",
828
- "medium": "[N]",
829
- "low": "[N]",
830
- "info": "[N]"
831
- },
832
- "by_type": {
833
- "feature": "[N]",
834
- "bug": "[N]",
835
- "refactor": "[N]",
836
- "config": "[N]",
837
- "docs": "[N]",
838
- "infra": "[N]",
839
- "security": "[N]",
840
- "test": "[N]",
841
- "observation": "[N]",
842
- "deficiency": "[N]",
843
- "ambiguity": "[N]"
844
- }
845
- }
846
- }
847
- ```
848
621
  ```
849
622
 
623
+
850
624
  ### Output Templates
851
625
 
852
626
  #### header