wicked-garden 12.27.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 (640) hide show
  1. package/.claude-plugin/archetypes.json +166 -0
  2. package/.claude-plugin/components.json +75 -0
  3. package/.claude-plugin/marketplace.json +15 -0
  4. package/.claude-plugin/plugin.json +174 -0
  5. package/.claude-plugin/specialist.json +48 -0
  6. package/.claude-plugin/stack-registry.json +96 -0
  7. package/AGENTS.md +13 -0
  8. package/CHANGELOG.md +712 -0
  9. package/CONTRIBUTING.md +99 -0
  10. package/ETHOS.md +83 -0
  11. package/LICENSE +21 -0
  12. package/README.md +115 -0
  13. package/WICKED_GARDEN_BUS_EVENTS.md +149 -0
  14. package/agents/agentic/architect.md +449 -0
  15. package/agents/agentic/performance-analyst.md +702 -0
  16. package/agents/agentic/safety-reviewer.md +662 -0
  17. package/agents/crew/implementer.md +163 -0
  18. package/agents/crew/researcher.md +94 -0
  19. package/agents/crew/reviewer.md +184 -0
  20. package/agents/data/data-engineer.md +227 -0
  21. package/agents/engineering/api-documentarian.md +440 -0
  22. package/agents/engineering/migration-engineer.md +301 -0
  23. package/agents/engineering/solution-architect.md +208 -0
  24. package/agents/jam/brainstorm-facilitator.md +297 -0
  25. package/agents/jam/council.md +322 -0
  26. package/agents/jam/quick-facilitator.md +85 -0
  27. package/agents/persona/persona-agent.md +121 -0
  28. package/agents/platform/compliance-officer.md +266 -0
  29. package/agents/platform/privacy-expert.md +496 -0
  30. package/agents/platform/security-engineer.md +287 -0
  31. package/agents/product/a11y-expert.md +323 -0
  32. package/agents/product/requirements-analyst.md +238 -0
  33. package/agents/product/ui-reviewer.md +180 -0
  34. package/agents/product/ux-designer.md +199 -0
  35. package/agents/product/value-strategist.md +269 -0
  36. package/agents/qe/semantic-reviewer.md +78 -0
  37. package/commands/agentic/audit.md +24 -0
  38. package/commands/agentic/design.md +24 -0
  39. package/commands/agentic/frameworks.md +25 -0
  40. package/commands/agentic/review.md +27 -0
  41. package/commands/archetype/build.md +12 -0
  42. package/commands/archetype/decide.md +12 -0
  43. package/commands/archetype/explore.md +12 -0
  44. package/commands/archetype/incident.md +12 -0
  45. package/commands/archetype/migrate.md +12 -0
  46. package/commands/archetype/modernize.md +12 -0
  47. package/commands/archetype/review.md +14 -0
  48. package/commands/archetype/ship.md +12 -0
  49. package/commands/archetype/specify.md +12 -0
  50. package/commands/archetype/triage.md +12 -0
  51. package/commands/compile.md +37 -0
  52. package/commands/data/analyze.md +18 -0
  53. package/commands/data/data.md +21 -0
  54. package/commands/data/ml.md +18 -0
  55. package/commands/data/ontology.md +22 -0
  56. package/commands/data/pipeline.md +17 -0
  57. package/commands/deliberate.md +181 -0
  58. package/commands/engineering/add-field.md +77 -0
  59. package/commands/engineering/apply.md +58 -0
  60. package/commands/engineering/arch.md +26 -0
  61. package/commands/engineering/debug.md +27 -0
  62. package/commands/engineering/docs.md +27 -0
  63. package/commands/engineering/new-generator.md +257 -0
  64. package/commands/engineering/patch-plan.md +59 -0
  65. package/commands/engineering/plan.md +29 -0
  66. package/commands/engineering/remove.md +48 -0
  67. package/commands/engineering/rename.md +44 -0
  68. package/commands/engineering/review.md +32 -0
  69. package/commands/help.md +128 -0
  70. package/commands/install.md +118 -0
  71. package/commands/intent.md +54 -0
  72. package/commands/jam/brainstorm.md +37 -0
  73. package/commands/jam/council.md +49 -0
  74. package/commands/jam/quick.md +21 -0
  75. package/commands/jam/revisit.md +79 -0
  76. package/commands/persona/as.md +136 -0
  77. package/commands/persona/define.md +24 -0
  78. package/commands/persona/list.md +118 -0
  79. package/commands/platform/actions.md +20 -0
  80. package/commands/platform/assert.md +18 -0
  81. package/commands/platform/audit.md +23 -0
  82. package/commands/platform/compliance.md +20 -0
  83. package/commands/platform/gh.md +22 -0
  84. package/commands/platform/health.md +22 -0
  85. package/commands/platform/incident.md +23 -0
  86. package/commands/platform/infra.md +24 -0
  87. package/commands/platform/peer-health.md +103 -0
  88. package/commands/platform/plugin-health.md +58 -0
  89. package/commands/platform/security.md +38 -0
  90. package/commands/platform/toolchain.md +96 -0
  91. package/commands/platform/traces.md +20 -0
  92. package/commands/product/a11y.md +19 -0
  93. package/commands/product/acceptance.md +19 -0
  94. package/commands/product/align.md +20 -0
  95. package/commands/product/analyze.md +23 -0
  96. package/commands/product/elicit.md +19 -0
  97. package/commands/product/listen.md +24 -0
  98. package/commands/product/mockup.md +20 -0
  99. package/commands/product/screenshot.md +19 -0
  100. package/commands/product/strategy.md +40 -0
  101. package/commands/product/synthesize.md +23 -0
  102. package/commands/product/ux-review.md +42 -0
  103. package/commands/product/ux.md +20 -0
  104. package/commands/product/visual-direction.md +34 -0
  105. package/commands/prove.md +47 -0
  106. package/commands/report-issue.md +243 -0
  107. package/commands/reset.md +144 -0
  108. package/commands/search/blast-radius.md +58 -0
  109. package/commands/search/hotspots.md +55 -0
  110. package/commands/search/index.md +38 -0
  111. package/commands/search/lineage.md +47 -0
  112. package/commands/search/service-map.md +79 -0
  113. package/commands/setup.md +363 -0
  114. package/commands/smaht/briefing.md +200 -0
  115. package/commands/smaht/events-import.md +95 -0
  116. package/commands/smaht/state.md +19 -0
  117. package/commands/where-am-i.md +58 -0
  118. package/docs/README.md +32 -0
  119. package/docs/adr/0001-code-relationship-graph-engine.md +116 -0
  120. package/docs/adr/0002-major-cleanup-keep-cut.md +91 -0
  121. package/docs/adr/0003-peers-gate-required-layers-optin.md +41 -0
  122. package/docs/adr/0004-code-graph-moves-to-wicked-brain.md +47 -0
  123. package/docs/brain-chunk-format.md +135 -0
  124. package/docs/compiler.md +95 -0
  125. package/docs/daemon-api.md +70 -0
  126. package/docs/domains.md +197 -0
  127. package/docs/getting-started.md +208 -0
  128. package/docs/plans/2026-06-08-wicked-loom-conduct.md +1337 -0
  129. package/docs/plans/2026-06-08-wicked-loom-contract.md +638 -0
  130. package/docs/plans/2026-06-08-wicked-loom-cutover.md +1300 -0
  131. package/docs/plans/2026-06-08-wicked-loom-expand-compose.md +843 -0
  132. package/docs/plans/2026-06-08-wicked-loom-flow-cutover.md +403 -0
  133. package/docs/plans/2026-06-10-codegraph-to-brain-phase1a-graph-core.md +838 -0
  134. package/docs/plans/2026-06-10-codegraph-to-brain-phase1b-injected-edges.md +44 -0
  135. package/docs/required-peers.md +60 -0
  136. package/docs/specs/2026-06-08-wicked-loom-extraction.md +225 -0
  137. package/docs/specs/2026-06-10-codegraph-to-brain-migration.md +168 -0
  138. package/docs/v11/archetypes.md +231 -0
  139. package/hooks/hooks.json +275 -0
  140. package/hooks/scripts/bootstrap.py +1797 -0
  141. package/hooks/scripts/invoke.py +62 -0
  142. package/hooks/scripts/notification.py +166 -0
  143. package/hooks/scripts/permission_request.py +223 -0
  144. package/hooks/scripts/post_tool.py +1374 -0
  145. package/hooks/scripts/pre_compact.py +272 -0
  146. package/hooks/scripts/pre_tool.py +1278 -0
  147. package/hooks/scripts/prompt_submit.py +1109 -0
  148. package/hooks/scripts/session_end.py +95 -0
  149. package/hooks/scripts/stop.py +624 -0
  150. package/hooks/scripts/subagent_lifecycle.py +464 -0
  151. package/hooks/scripts/subscribers/on_gate_decided.py +84 -0
  152. package/hooks/scripts/task_completed.py +322 -0
  153. package/hooks/scripts/worktree_guard.py +148 -0
  154. package/hooks/subscriptions/on_gate_decided.json +9 -0
  155. package/install.mjs +128 -0
  156. package/package.json +41 -0
  157. package/pyproject.toml +59 -0
  158. package/schemas/README.md +32 -0
  159. package/schemas/assert_contracts.json +37 -0
  160. package/schemas/health_probe.json +46 -0
  161. package/schemas/plugin_status.json +37 -0
  162. package/scripts/_adapters/__init__.py +166 -0
  163. package/scripts/_adapters/jira_adapter.py +18 -0
  164. package/scripts/_adapters/linear_adapter.py +18 -0
  165. package/scripts/_adapters/miro_adapter.py +18 -0
  166. package/scripts/_adapters/notion_adapter.py +18 -0
  167. package/scripts/_agents.py +357 -0
  168. package/scripts/_brain_ingest/__init__.py +2 -0
  169. package/scripts/_brain_ingest/session_fact_extractor.py +341 -0
  170. package/scripts/_brain_port.py +163 -0
  171. package/scripts/_bus.py +1081 -0
  172. package/scripts/_bus_catalog_gen.py +93 -0
  173. package/scripts/_bus_consumers.json +46 -0
  174. package/scripts/_bus_emit.py +43 -0
  175. package/scripts/_capability_registry.py +334 -0
  176. package/scripts/_capability_resolver.py +322 -0
  177. package/scripts/_domain_store.py +559 -0
  178. package/scripts/_event_log_reader.py +154 -0
  179. package/scripts/_event_schema.py +305 -0
  180. package/scripts/_event_store.py +397 -0
  181. package/scripts/_heavy_cadence.py +324 -0
  182. package/scripts/_integration_resolver.py +321 -0
  183. package/scripts/_logger.py +151 -0
  184. package/scripts/_loom.py +482 -0
  185. package/scripts/_paths.py +133 -0
  186. package/scripts/_python.sh +22 -0
  187. package/scripts/_run.py +137 -0
  188. package/scripts/_session.py +502 -0
  189. package/scripts/_validate_registry.py +1042 -0
  190. package/scripts/_wicked_testing_probe.py +277 -0
  191. package/scripts/agentic/analyze_agents.py +391 -0
  192. package/scripts/agentic/detect_framework.py +420 -0
  193. package/scripts/agentic/issue_taxonomy.py +357 -0
  194. package/scripts/agentic/pattern_scorer.py +434 -0
  195. package/scripts/classify/persist.py +169 -0
  196. package/scripts/compiler/compile.py +552 -0
  197. package/scripts/compiler/phase0/VERDICT.md +60 -0
  198. package/scripts/compiler/phase0/detect.py +292 -0
  199. package/scripts/compiler/phase0/emit.py +228 -0
  200. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.bindings.json +30 -0
  201. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.lint-output.txt +17 -0
  202. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.stage/.wg/evidence/failing-tests.txt +4 -0
  203. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.stage/.wg/evidence/honest-tests.txt +2 -0
  204. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.stage/fab-fail.build.md +8 -0
  205. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.stage/fab-missing.build.md +8 -0
  206. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.stage/honest.build.md +8 -0
  207. package/scripts/compiler/phase0/evidence/Enterprise-AISDLC.stage/wg_check_claims.py +174 -0
  208. package/scripts/compiler/phase0/evidence/command_iq.bindings.json +45 -0
  209. package/scripts/compiler/phase0/evidence/command_iq.lint-output.txt +17 -0
  210. package/scripts/compiler/phase0/evidence/command_iq.stage/.projects/evidence-domain/phase-1-clarify/evidence/failing-tests.txt +4 -0
  211. package/scripts/compiler/phase0/evidence/command_iq.stage/.projects/evidence-domain/phase-1-clarify/evidence/honest-tests.txt +3 -0
  212. package/scripts/compiler/phase0/evidence/command_iq.stage/fab-fail.build.md +8 -0
  213. package/scripts/compiler/phase0/evidence/command_iq.stage/fab-missing.build.md +8 -0
  214. package/scripts/compiler/phase0/evidence/command_iq.stage/honest.build.md +8 -0
  215. package/scripts/compiler/phase0/evidence/command_iq.stage/wg_check_claims.py +174 -0
  216. package/scripts/compiler/phase0/evidence/memos.bindings.json +28 -0
  217. package/scripts/compiler/phase0/evidence/memos.lint-output.txt +17 -0
  218. package/scripts/compiler/phase0/evidence/memos.stage/.wg/evidence/failing-tests.txt +4 -0
  219. package/scripts/compiler/phase0/evidence/memos.stage/.wg/evidence/honest-tests.txt +2 -0
  220. package/scripts/compiler/phase0/evidence/memos.stage/fab-fail.build.md +8 -0
  221. package/scripts/compiler/phase0/evidence/memos.stage/fab-missing.build.md +8 -0
  222. package/scripts/compiler/phase0/evidence/memos.stage/honest.build.md +8 -0
  223. package/scripts/compiler/phase0/evidence/memos.stage/wg_check_claims.py +174 -0
  224. package/scripts/compiler/phase0/evidence/verdict.json +104 -0
  225. package/scripts/compiler/phase0/evidence/wicked-bus.bindings.json +29 -0
  226. package/scripts/compiler/phase0/evidence/wicked-bus.lint-output.txt +17 -0
  227. package/scripts/compiler/phase0/evidence/wicked-bus.stage/coverage/failing-tests.txt +4 -0
  228. package/scripts/compiler/phase0/evidence/wicked-bus.stage/coverage/honest-tests.txt +3 -0
  229. package/scripts/compiler/phase0/evidence/wicked-bus.stage/fab-fail.build.md +8 -0
  230. package/scripts/compiler/phase0/evidence/wicked-bus.stage/fab-missing.build.md +8 -0
  231. package/scripts/compiler/phase0/evidence/wicked-bus.stage/honest.build.md +8 -0
  232. package/scripts/compiler/phase0/evidence/wicked-bus.stage/wg_check_claims.py +174 -0
  233. package/scripts/compiler/phase0/evidence/wire-vault-transcript.txt +60 -0
  234. package/scripts/compiler/phase0/run_probe.py +234 -0
  235. package/scripts/compiler/phase0/wire_vault.py +310 -0
  236. package/scripts/crew/__init__.py +0 -0
  237. package/scripts/crew/_task_audit_writer.py +243 -0
  238. package/scripts/crew/_task_reader.py +389 -0
  239. package/scripts/crew/archetypes_v11.py +348 -0
  240. package/scripts/crew/detectors/__init__.py +12 -0
  241. package/scripts/crew/flow_compiler.py +121 -0
  242. package/scripts/crew/phase_manager.py +703 -0
  243. package/scripts/crew/scope_delta.py +264 -0
  244. package/scripts/crew/specialist_resolver.py +218 -0
  245. package/scripts/crew/stack_registry.py +189 -0
  246. package/scripts/data/data_profiler.py +271 -0
  247. package/scripts/data/ontology_recommender.py +231 -0
  248. package/scripts/data/schema_validator.py +267 -0
  249. package/scripts/delivery/drift.py +739 -0
  250. package/scripts/delivery/telemetry.py +614 -0
  251. package/scripts/engineering/patch/codegraph_db.py +125 -0
  252. package/scripts/engineering/patch/generators/__init__.py +56 -0
  253. package/scripts/engineering/patch/generators/base.py +373 -0
  254. package/scripts/engineering/patch/generators/csharp_generator.py +494 -0
  255. package/scripts/engineering/patch/generators/go_generator.py +430 -0
  256. package/scripts/engineering/patch/generators/java_generator.py +928 -0
  257. package/scripts/engineering/patch/generators/jsp_generator.py +454 -0
  258. package/scripts/engineering/patch/generators/kotlin_generator.py +561 -0
  259. package/scripts/engineering/patch/generators/perl_generator.py +510 -0
  260. package/scripts/engineering/patch/generators/php_generator.py +644 -0
  261. package/scripts/engineering/patch/generators/propagation_engine.py +929 -0
  262. package/scripts/engineering/patch/generators/python_generator.py +487 -0
  263. package/scripts/engineering/patch/generators/ruby_generator.py +463 -0
  264. package/scripts/engineering/patch/generators/rust_generator.py +400 -0
  265. package/scripts/engineering/patch/generators/sql_generator.py +594 -0
  266. package/scripts/engineering/patch/generators/typescript_generator.py +439 -0
  267. package/scripts/engineering/patch/patch.py +800 -0
  268. package/scripts/engineering/patch/safety.py +429 -0
  269. package/scripts/jam/__init__.py +0 -0
  270. package/scripts/jam/_bus_consumers.py +271 -0
  271. package/scripts/jam/agentic_cli_registry.py +703 -0
  272. package/scripts/jam/consensus.py +737 -0
  273. package/scripts/jam/detect_clis.py +409 -0
  274. package/scripts/jam/jam.py +283 -0
  275. package/scripts/jam/save_transcript.py +171 -0
  276. package/scripts/loom/__init__.py +22 -0
  277. package/scripts/loom/cli.py +170 -0
  278. package/scripts/loom/compose.py +180 -0
  279. package/scripts/loom/gate.py +120 -0
  280. package/scripts/loom/manifest.py +140 -0
  281. package/scripts/loom/resolve.py +59 -0
  282. package/scripts/persona/__init__.py +0 -0
  283. package/scripts/persona/registry.py +688 -0
  284. package/scripts/platform/guard_pipeline.py +1214 -0
  285. package/scripts/platform/guard_profiles.py +216 -0
  286. package/scripts/platform/observability/assert_contracts.py +434 -0
  287. package/scripts/platform/observability/health_probe.py +915 -0
  288. package/scripts/platform/observability/ops_log_viewer.py +209 -0
  289. package/scripts/platform/prereq_doctor.py +567 -0
  290. package/scripts/qe/conditions_manifest.py +260 -0
  291. package/scripts/qe/content_sanitizer.py +160 -0
  292. package/scripts/qe/coverage_tracker.py +535 -0
  293. package/scripts/qe/discover_scenarios.py +243 -0
  294. package/scripts/qe/evidence_tracker.py +232 -0
  295. package/scripts/qe/prove.py +196 -0
  296. package/scripts/qe/registry_lookup.py +80 -0
  297. package/scripts/qe/registry_store.py +176 -0
  298. package/scripts/qe/semantic_review.py +1005 -0
  299. package/scripts/qe/vault_gate.py +382 -0
  300. package/scripts/qe/verdict_audit.py +175 -0
  301. package/scripts/qe/verdict_schema.py +335 -0
  302. package/scripts/reset.py +220 -0
  303. package/scripts/resolve_path.py +22 -0
  304. package/scripts/sentinel/invariants.py +402 -0
  305. package/scripts/sentinel/pre_push.py +73 -0
  306. package/scripts/setup/__init__.py +1 -0
  307. package/scripts/setup/detect_state.py +114 -0
  308. package/scripts/setup/migrate_legacy.py +67 -0
  309. package/scripts/setup/migrate_v6_projects.py +232 -0
  310. package/scripts/setup/onboarding.py +114 -0
  311. package/scripts/smaht/_bus_consumers.py +98 -0
  312. package/scripts/smaht/adapters/__init__.py +83 -0
  313. package/scripts/smaht/adapters/brain_adapter.py +254 -0
  314. package/scripts/smaht/adapters/context7_adapter.py +438 -0
  315. package/scripts/smaht/adapters/delegation_adapter.py +104 -0
  316. package/scripts/smaht/adapters/domain_adapter.py +206 -0
  317. package/scripts/smaht/adapters/events_adapter.py +231 -0
  318. package/scripts/smaht/adapters/tools_adapter.py +49 -0
  319. package/scripts/smaht/cheatsheet_store.py +236 -0
  320. package/scripts/smaht/context_package.py +386 -0
  321. package/scripts/smaht/knowledge_graph.py +395 -0
  322. package/scripts/smaht/propose_skills.py +856 -0
  323. package/scripts/smaht/test_cheatsheet_store.py +428 -0
  324. package/scripts/statusline.py +151 -0
  325. package/scripts/where_am_i.py +236 -0
  326. package/skills/agentic/agentic-patterns/SKILL.md +91 -0
  327. package/skills/agentic/agentic-patterns/refs/anti-patterns-design.md +283 -0
  328. package/skills/agentic/agentic-patterns/refs/anti-patterns-operational.md +216 -0
  329. package/skills/agentic/agentic-patterns/refs/pattern-catalog.md +329 -0
  330. package/skills/agentic/context-engineering/SKILL.md +142 -0
  331. package/skills/agentic/context-engineering/refs/caching-and-optimization.md +251 -0
  332. package/skills/agentic/context-engineering/refs/compression-techniques.md +171 -0
  333. package/skills/agentic/context-engineering/refs/cost-calculation-budget.md +250 -0
  334. package/skills/agentic/context-engineering/refs/cost-optimization-reporting.md +300 -0
  335. package/skills/agentic/context-engineering/refs/selective-loading.md +179 -0
  336. package/skills/agentic/frameworks/SKILL.md +191 -0
  337. package/skills/agentic/frameworks/refs/framework-profiles-1.md +209 -0
  338. package/skills/agentic/frameworks/refs/framework-profiles-2.md +214 -0
  339. package/skills/agentic/frameworks/refs/migration-patterns-paths.md +267 -0
  340. package/skills/agentic/frameworks/refs/migration-patterns-testing.md +208 -0
  341. package/skills/agentic/refs/audit.md +134 -0
  342. package/skills/agentic/refs/design.md +137 -0
  343. package/skills/agentic/refs/frameworks.md +102 -0
  344. package/skills/agentic/refs/review.md +160 -0
  345. package/skills/agentic/review-methodology/SKILL.md +186 -0
  346. package/skills/agentic/review-methodology/refs/deliverable-templates.md +246 -0
  347. package/skills/agentic/review-methodology/refs/issue-taxonomy-quality-testing.md +277 -0
  348. package/skills/agentic/review-methodology/refs/issue-taxonomy-reliability-safety.md +253 -0
  349. package/skills/agentic/trust-and-safety/SKILL.md +177 -0
  350. package/skills/agentic/trust-and-safety/refs/guardrails-actions.md +246 -0
  351. package/skills/agentic/trust-and-safety/refs/guardrails-input-output.md +238 -0
  352. package/skills/agentic/trust-and-safety/refs/guardrails-resources.md +209 -0
  353. package/skills/agentic/trust-and-safety/refs/safety-checklist-advanced.md +209 -0
  354. package/skills/agentic/trust-and-safety/refs/safety-checklist-core.md +215 -0
  355. package/skills/archetype/SKILL.md +104 -0
  356. package/skills/archetype/refs/build.md +142 -0
  357. package/skills/archetype/refs/decide.md +117 -0
  358. package/skills/archetype/refs/explore.md +66 -0
  359. package/skills/archetype/refs/incident.md +149 -0
  360. package/skills/archetype/refs/migrate.md +170 -0
  361. package/skills/archetype/refs/modernize.md +187 -0
  362. package/skills/archetype/refs/review.md +145 -0
  363. package/skills/archetype/refs/ship.md +117 -0
  364. package/skills/archetype/refs/specify.md +108 -0
  365. package/skills/archetype/refs/triage.md +62 -0
  366. package/skills/classify/SKILL.md +157 -0
  367. package/skills/data/analysis/SKILL.md +125 -0
  368. package/skills/data/analysis/refs/templates.md +170 -0
  369. package/skills/data/data/SKILL.md +118 -0
  370. package/skills/data/data/refs/examples.md +235 -0
  371. package/skills/data/ml/SKILL.md +125 -0
  372. package/skills/data/ml/refs/templates.md +172 -0
  373. package/skills/data/pipeline/SKILL.md +136 -0
  374. package/skills/data/pipeline/refs/templates.md +175 -0
  375. package/skills/data/refs/analyze.md +123 -0
  376. package/skills/data/refs/data.md +95 -0
  377. package/skills/data/refs/ml.md +118 -0
  378. package/skills/data/refs/pipeline.md +92 -0
  379. package/skills/deliberate/SKILL.md +125 -0
  380. package/skills/deliberate/refs/architecture-lens.md +37 -0
  381. package/skills/deliberate/refs/assumptions-lens.md +43 -0
  382. package/skills/deliberate/refs/code-lens.md +38 -0
  383. package/skills/deliberate/refs/content-lens.md +37 -0
  384. package/skills/deliberate/refs/data-lens.md +43 -0
  385. package/skills/deliberate/refs/design-lens.md +37 -0
  386. package/skills/deliberate/refs/opportunity-patterns.md +107 -0
  387. package/skills/deliberate/refs/ops-lens.md +43 -0
  388. package/skills/deliberate/refs/product-lens.md +46 -0
  389. package/skills/deliberate/refs/rethink-framework.md +77 -0
  390. package/skills/deliberate/refs/security-lens.md +47 -0
  391. package/skills/deliberate/refs/testing-lens.md +45 -0
  392. package/skills/deliberate/refs/timing-lens.md +42 -0
  393. package/skills/engineering/architecture/SKILL.md +177 -0
  394. package/skills/engineering/architecture/refs/adr-template.md +268 -0
  395. package/skills/engineering/architecture/refs/architecture-template-deployment.md +176 -0
  396. package/skills/engineering/architecture/refs/architecture-template-design.md +300 -0
  397. package/skills/engineering/architecture/refs/examples-ecommerce-analytics.md +299 -0
  398. package/skills/engineering/architecture/refs/examples-saas-trading.md +291 -0
  399. package/skills/engineering/architecture/refs/patterns-advanced.md +238 -0
  400. package/skills/engineering/architecture/refs/patterns-structural.md +303 -0
  401. package/skills/engineering/backend/SKILL.md +102 -0
  402. package/skills/engineering/backend/refs/checklists.md +146 -0
  403. package/skills/engineering/backend/refs/patterns.md +181 -0
  404. package/skills/engineering/debugging/SKILL.md +99 -0
  405. package/skills/engineering/debugging/refs/patterns.md +248 -0
  406. package/skills/engineering/debugging/refs/process.md +203 -0
  407. package/skills/engineering/docs/SKILL.md +97 -0
  408. package/skills/engineering/engineering/SKILL.md +88 -0
  409. package/skills/engineering/engineering/refs/checklists.md +91 -0
  410. package/skills/engineering/engineering/refs/templates.md +71 -0
  411. package/skills/engineering/frontend/SKILL.md +92 -0
  412. package/skills/engineering/frontend/refs/checklists.md +96 -0
  413. package/skills/engineering/frontend/refs/patterns.md +167 -0
  414. package/skills/engineering/integration/SKILL.md +183 -0
  415. package/skills/engineering/integration/refs/error-handling-best-practices.md +139 -0
  416. package/skills/engineering/integration/refs/error-handling-error-classes-typescript.md +212 -0
  417. package/skills/engineering/integration/refs/error-handling-error-response-format.md +301 -0
  418. package/skills/engineering/integration/refs/error-handling-retry-strategies.md +190 -0
  419. package/skills/engineering/integration/refs/event-schemas-best-practices.md +225 -0
  420. package/skills/engineering/integration/refs/event-schemas-event-naming-conventions.md +303 -0
  421. package/skills/engineering/integration/refs/event-schemas-event-structure.md +288 -0
  422. package/skills/engineering/integration/refs/graphql-best-practices.md +138 -0
  423. package/skills/engineering/integration/refs/graphql-error-handling.md +198 -0
  424. package/skills/engineering/integration/refs/graphql-graphql-basics.md +197 -0
  425. package/skills/engineering/integration/refs/graphql-query-examples.md +226 -0
  426. package/skills/engineering/integration/refs/graphql-schema-design-patterns.md +280 -0
  427. package/skills/engineering/integration/refs/grpc-grpc-overview.md +246 -0
  428. package/skills/engineering/integration/refs/grpc-implementation-examples.md +269 -0
  429. package/skills/engineering/integration/refs/grpc-metadata-headers.md +304 -0
  430. package/skills/engineering/integration/refs/grpc-testing.md +49 -0
  431. package/skills/engineering/integration/refs/openapi-template.yaml +682 -0
  432. package/skills/engineering/integration/refs/resilience-best-practices.md +109 -0
  433. package/skills/engineering/integration/refs/resilience-circuit-breaker-pattern.md +302 -0
  434. package/skills/engineering/integration/refs/resilience-rate-limiting.md +245 -0
  435. package/skills/engineering/integration/refs/resilience-timeout-pattern.md +212 -0
  436. package/skills/engineering/integration/refs/rest-api-fundamentals.md +299 -0
  437. package/skills/engineering/integration/refs/rest-api-responses-security.md +302 -0
  438. package/skills/engineering/integration/refs/versioning-breaking-changes.md +237 -0
  439. package/skills/engineering/integration/refs/versioning-migration-strategies.md +257 -0
  440. package/skills/engineering/integration/refs/versioning-versioning-strategies.md +296 -0
  441. package/skills/engineering/large-scale-migration/SKILL.md +65 -0
  442. package/skills/engineering/patch/SKILL.md +184 -0
  443. package/skills/engineering/refs/arch.md +126 -0
  444. package/skills/engineering/refs/debug.md +142 -0
  445. package/skills/engineering/refs/docs.md +190 -0
  446. package/skills/engineering/refs/plan.md +109 -0
  447. package/skills/engineering/refs/review.md +138 -0
  448. package/skills/engineering/system-design/SKILL.md +154 -0
  449. package/skills/engineering/system-design/refs/anti-patterns-big-ball-of-mud.md +254 -0
  450. package/skills/engineering/system-design/refs/anti-patterns-circular-dependencies.md +241 -0
  451. package/skills/engineering/system-design/refs/anti-patterns-feature-envy.md +168 -0
  452. package/skills/engineering/system-design/refs/anti-patterns-god-object.md +247 -0
  453. package/skills/engineering/system-design/refs/component-template-lifecycle.md +210 -0
  454. package/skills/engineering/system-design/refs/component-template-maintenance.md +219 -0
  455. package/skills/engineering/system-design/refs/component-template-structure.md +276 -0
  456. package/skills/engineering/system-design/refs/dependencies-best-practices.md +260 -0
  457. package/skills/engineering/system-design/refs/dependencies-dependency-principles.md +295 -0
  458. package/skills/engineering/system-design/refs/dependencies-dependency-tracking.md +261 -0
  459. package/skills/engineering/system-design/refs/interface-template-lifecycle.md +211 -0
  460. package/skills/engineering/system-design/refs/interface-template-maintenance.md +212 -0
  461. package/skills/engineering/system-design/refs/interface-template-structure.md +269 -0
  462. package/skills/engineering/system-design/refs/patterns-dependency-injection.md +151 -0
  463. package/skills/engineering/system-design/refs/patterns-facade-pattern.md +257 -0
  464. package/skills/engineering/system-design/refs/patterns-layered-pattern.md +204 -0
  465. package/skills/engineering/system-design/refs/patterns-plugin-architecture.md +229 -0
  466. package/skills/engineering/unit-test-quality/SKILL.md +194 -0
  467. package/skills/ground/SKILL.md +130 -0
  468. package/skills/integration-discovery/SKILL.md +168 -0
  469. package/skills/integration-discovery/refs/capabilities.md +282 -0
  470. package/skills/integration-discovery/refs/cli-detection.md +295 -0
  471. package/skills/integration-discovery/refs/discovery-sources.md +233 -0
  472. package/skills/integration-discovery/refs/task-patterns.md +206 -0
  473. package/skills/jam/SKILL.md +45 -0
  474. package/skills/jam/refs/facilitation-patterns.md +125 -0
  475. package/skills/jam/refs/quick.md +64 -0
  476. package/skills/jam/refs/synthesis-patterns.md +114 -0
  477. package/skills/multi-model/SKILL.md +168 -0
  478. package/skills/multi-model/refs/aichat.md +119 -0
  479. package/skills/multi-model/refs/aider.md +100 -0
  480. package/skills/multi-model/refs/auditability.md +238 -0
  481. package/skills/multi-model/refs/codex.md +169 -0
  482. package/skills/multi-model/refs/context.md +306 -0
  483. package/skills/multi-model/refs/copilot.md +161 -0
  484. package/skills/multi-model/refs/examples.md +224 -0
  485. package/skills/multi-model/refs/gemini.md +185 -0
  486. package/skills/multi-model/refs/goose.md +112 -0
  487. package/skills/multi-model/refs/llm.md +124 -0
  488. package/skills/multi-model/refs/opencode.md +196 -0
  489. package/skills/multi-model/refs/orchestration.md +188 -0
  490. package/skills/multi-model/refs/pi.md +208 -0
  491. package/skills/persona/SKILL.md +144 -0
  492. package/skills/persona/refs/define.md +133 -0
  493. package/skills/platform/actions/refs/actions.md +114 -0
  494. package/skills/platform/audit/SKILL.md +174 -0
  495. package/skills/platform/audit/refs/audit.md +145 -0
  496. package/skills/platform/audit/refs/checklists-evidence-operations.md +144 -0
  497. package/skills/platform/audit/refs/checklists-gdpr-pci-evidence.md +213 -0
  498. package/skills/platform/audit/refs/checklists-soc2-hipaa.md +120 -0
  499. package/skills/platform/audit/refs/frameworks-gdpr-pci.md +225 -0
  500. package/skills/platform/audit/refs/frameworks-soc2-hipaa.md +228 -0
  501. package/skills/platform/compliance/SKILL.md +169 -0
  502. package/skills/platform/compliance/refs/checklists.md +303 -0
  503. package/skills/platform/compliance/refs/compliance.md +117 -0
  504. package/skills/platform/compliance/refs/frameworks.md +282 -0
  505. package/skills/platform/errors/SKILL.md +183 -0
  506. package/skills/platform/errors/refs/patterns.md +271 -0
  507. package/skills/platform/errors/refs/severity.md +264 -0
  508. package/skills/platform/gate-benchmark-rebaseline/SKILL.md +108 -0
  509. package/skills/platform/gh/refs/gh.md +105 -0
  510. package/skills/platform/gh-cli/SKILL.md +120 -0
  511. package/skills/platform/gh-cli/refs/automation.md +63 -0
  512. package/skills/platform/gh-cli/refs/gh-ops.md +103 -0
  513. package/skills/platform/gh-cli/refs/patterns.md +132 -0
  514. package/skills/platform/gh-cli/scripts/gh_ops.py +454 -0
  515. package/skills/platform/github-actions/SKILL.md +159 -0
  516. package/skills/platform/github-actions/refs/security.md +150 -0
  517. package/skills/platform/github-actions/refs/templates.md +230 -0
  518. package/skills/platform/github-actions/refs/troubleshooting.md +174 -0
  519. package/skills/platform/github-actions/scripts/workflow_gen.py +215 -0
  520. package/skills/platform/gitlab-ci/SKILL.md +140 -0
  521. package/skills/platform/gitlab-ci/refs/templates.md +223 -0
  522. package/skills/platform/gitlab-ci/refs/troubleshooting.md +213 -0
  523. package/skills/platform/glab-cli/SKILL.md +133 -0
  524. package/skills/platform/glab-cli/refs/ci-debugging.md +95 -0
  525. package/skills/platform/glab-cli/refs/glab-ops.md +78 -0
  526. package/skills/platform/glab-cli/refs/patterns.md +131 -0
  527. package/skills/platform/glab-cli/scripts/glab_ops.py +313 -0
  528. package/skills/platform/health/SKILL.md +177 -0
  529. package/skills/platform/health/refs/health.md +72 -0
  530. package/skills/platform/health/refs/sources.md +302 -0
  531. package/skills/platform/incident/refs/incident.md +136 -0
  532. package/skills/platform/infra/refs/infra.md +104 -0
  533. package/skills/platform/observability/SKILL.md +128 -0
  534. package/skills/platform/observability/refs/toolchain-discovery.md +243 -0
  535. package/skills/platform/prereq-doctor/SKILL.md +57 -0
  536. package/skills/platform/prereq-doctor/refs/tool-registry.md +58 -0
  537. package/skills/platform/traces/refs/traces.md +101 -0
  538. package/skills/product/acceptance-criteria/SKILL.md +193 -0
  539. package/skills/product/acceptance-criteria/refs/ac-anti-patterns.md +291 -0
  540. package/skills/product/acceptance-criteria/refs/ac-examples.md +277 -0
  541. package/skills/product/accessibility/SKILL.md +197 -0
  542. package/skills/product/accessibility/refs/aria-patterns-basics.md +250 -0
  543. package/skills/product/accessibility/refs/aria-patterns-dynamic.md +187 -0
  544. package/skills/product/accessibility/refs/aria-patterns-interactive.md +246 -0
  545. package/skills/product/accessibility/refs/audit-report-findings.md +248 -0
  546. package/skills/product/accessibility/refs/audit-report-results.md +276 -0
  547. package/skills/product/accessibility/refs/common-violations-html-css.md +270 -0
  548. package/skills/product/accessibility/refs/common-violations-interactive.md +303 -0
  549. package/skills/product/accessibility/refs/keyboard-testing-basics.md +222 -0
  550. package/skills/product/accessibility/refs/keyboard-testing-patterns.md +173 -0
  551. package/skills/product/accessibility/refs/screen-reader-testing-advanced.md +294 -0
  552. package/skills/product/accessibility/refs/screen-reader-testing-commands.md +255 -0
  553. package/skills/product/accessibility/refs/wcag-checklist.md +262 -0
  554. package/skills/product/analyze/SKILL.md +164 -0
  555. package/skills/product/analyze/refs/algorithms.md +238 -0
  556. package/skills/product/analyze/refs/sentiment-patterns.md +180 -0
  557. package/skills/product/imagery/SKILL.md +97 -0
  558. package/skills/product/imagery/alter/SKILL.md +105 -0
  559. package/skills/product/imagery/alter/refs/editing-reference.md +146 -0
  560. package/skills/product/imagery/create/SKILL.md +109 -0
  561. package/skills/product/imagery/create/refs/prompt-engineering.md +112 -0
  562. package/skills/product/imagery/create/refs/provider-reference.md +219 -0
  563. package/skills/product/imagery/review/SKILL.md +101 -0
  564. package/skills/product/imagery/review/refs/analysis-lenses.md +136 -0
  565. package/skills/product/imagery/review/refs/quality-gates.md +153 -0
  566. package/skills/product/imagery/scripts/analyze.sh +23 -0
  567. package/skills/product/imagery/scripts/edit.sh +14 -0
  568. package/skills/product/imagery/scripts/generate.sh +13 -0
  569. package/skills/product/imagery/scripts/provider.py +787 -0
  570. package/skills/product/listen/SKILL.md +175 -0
  571. package/skills/product/listen/refs/channels.md +220 -0
  572. package/skills/product/mockup/SKILL.md +106 -0
  573. package/skills/product/mockup/refs/templates.md +95 -0
  574. package/skills/product/refs/a11y.md +109 -0
  575. package/skills/product/refs/acceptance.md +79 -0
  576. package/skills/product/refs/align.md +67 -0
  577. package/skills/product/refs/analyze.md +77 -0
  578. package/skills/product/refs/elicit.md +67 -0
  579. package/skills/product/refs/listen.md +58 -0
  580. package/skills/product/refs/mockup.md +77 -0
  581. package/skills/product/refs/screenshot.md +59 -0
  582. package/skills/product/refs/strategy.md +77 -0
  583. package/skills/product/refs/synthesize.md +54 -0
  584. package/skills/product/refs/ux-review.md +68 -0
  585. package/skills/product/refs/ux.md +101 -0
  586. package/skills/product/requirements-analysis/SKILL.md +136 -0
  587. package/skills/product/requirements-analysis/refs/requirements-example-auth.md +264 -0
  588. package/skills/product/requirements-analysis/refs/requirements-example-export-integration.md +88 -0
  589. package/skills/product/requirements-analysis/refs/requirements-output-format-template.md +247 -0
  590. package/skills/product/requirements-analysis/refs/user-story-guide.md +296 -0
  591. package/skills/product/requirements-graph/SKILL.md +155 -0
  592. package/skills/product/requirements-graph/refs/examples.md +223 -0
  593. package/skills/product/requirements-graph/refs/schema.md +162 -0
  594. package/skills/product/requirements-migrate/SKILL.md +90 -0
  595. package/skills/product/requirements-navigate/SKILL.md +141 -0
  596. package/skills/product/requirements-navigate/refs/meta-templates.md +141 -0
  597. package/skills/product/screenshot/SKILL.md +147 -0
  598. package/skills/product/strategy/SKILL.md +198 -0
  599. package/skills/product/strategy/refs/frameworks.md +295 -0
  600. package/skills/product/strategy/refs/templates-competitive-market.md +299 -0
  601. package/skills/product/strategy/refs/templates-roi-value.md +207 -0
  602. package/skills/product/synthesize/SKILL.md +116 -0
  603. package/skills/product/synthesize/refs/journey-mapping.md +212 -0
  604. package/skills/product/synthesize/refs/prioritization.md +193 -0
  605. package/skills/product/ux-review/SKILL.md +164 -0
  606. package/skills/product/visual-direction/SKILL.md +137 -0
  607. package/skills/product/visual-review/SKILL.md +131 -0
  608. package/skills/runtime-exec/SKILL.md +138 -0
  609. package/skills/search/codebase-narrator/SKILL.md +131 -0
  610. package/skills/search/codebase-narrator/refs/output-template.md +100 -0
  611. package/skills/smaht/SKILL.md +72 -0
  612. package/skills/smaht/discovery/SKILL.md +65 -0
  613. package/skills/smaht/intent/SKILL.md +89 -0
  614. package/skills/smaht/propose-skills/SKILL.md +142 -0
  615. package/skills/smaht/refs/state.md +76 -0
  616. package/skills/swarm/SKILL.md +132 -0
  617. package/skills/swarm/refs/fan-out.md +104 -0
  618. package/skills/swarm/refs/independent-verification.md +86 -0
  619. package/skills/swarm/refs/receipts-and-evidence.md +69 -0
  620. package/skills/swarm/refs/recon-synthesis.md +87 -0
  621. package/skills/swarm/refs/ship-discipline.md +90 -0
  622. package/skills/wickedizer/SKILL.md +147 -0
  623. package/skills/wickedizer/refs/artifact-types.md +238 -0
  624. package/skills/wickedizer/refs/complexity.md +278 -0
  625. package/skills/wickedizer/refs/de-ai-pass.md +140 -0
  626. package/skills/wickedizer/refs/failure-modes.md +249 -0
  627. package/skills/wickedizer/refs/patterns.md +282 -0
  628. package/skills/wickedizer/refs/review.md +221 -0
  629. package/skills/wickedizer/refs/structure.md +282 -0
  630. package/skills/wickedizer/refs/voice-profile.md +125 -0
  631. package/skills/workflow/SKILL.md +132 -0
  632. package/skills/workflow/refs/archetype-adjustments.md +205 -0
  633. package/skills/workflow/refs/evidence.md +58 -0
  634. package/skills/workflow/refs/integration.md +130 -0
  635. package/skills/workflow/refs/risk-dimension-signals.md +260 -0
  636. package/skills/workflow/refs/scoring-rubric.md +49 -0
  637. package/skills/workflow/refs/signal-keywords.md +176 -0
  638. package/skills/workflow/refs/specialist-routing-rules.md +159 -0
  639. package/skills/worktrees/SKILL.md +87 -0
  640. package/skills/worktrees/refs/recipes.md +96 -0
@@ -0,0 +1,292 @@
1
+ #!/usr/bin/env python3
2
+ """Phase-0 detection probe — repo root -> bindings.json.
3
+
4
+ Falsification question: can ONE repo-agnostic detector infer a repo's
5
+ test-invocation, evidence sink, claims surface, and risk surfaces well
6
+ enough to drive an emitted enforcement lint, WITHOUT hand-correction,
7
+ across structurally different repos?
8
+
9
+ Every binding records {value, source, confidence} so the verdict can
10
+ distinguish "detected unaided" from "fell back to a proposed default".
11
+ Stdlib-only.
12
+ """
13
+ from __future__ import annotations
14
+
15
+ import json
16
+ import re
17
+ import sys
18
+ from pathlib import Path
19
+
20
+ DETECTED = "detected" # inferred from a real repo signal
21
+ DEFAULT = "proposed-default" # emitted convention; repo had none
22
+
23
+
24
+ def _read_json(p: Path) -> dict:
25
+ try:
26
+ return json.loads(p.read_text())
27
+ except Exception:
28
+ return {}
29
+
30
+
31
+ def _pkg_manager(root: Path) -> str:
32
+ if (root / "pnpm-lock.yaml").exists():
33
+ return "pnpm"
34
+ if (root / "yarn.lock").exists():
35
+ return "yarn"
36
+ return "npm"
37
+
38
+
39
+ def _detect_test_command(root: Path) -> dict:
40
+ # node
41
+ pkg = root / "package.json"
42
+ if pkg.exists():
43
+ data = _read_json(pkg)
44
+ scripts = data.get("scripts", {}) or {}
45
+ pm = _pkg_manager(root)
46
+ monorepo = bool(data.get("workspaces")) or (root / "pnpm-workspace.yaml").exists()
47
+ if scripts.get("test"):
48
+ run = "test" if pm == "npm" else "test"
49
+ cmd = f"{pm} {('run ' if pm=='npm' else '')}{run}".strip()
50
+ # npm needs `npm test`; pnpm/yarn `pnpm test`
51
+ cmd = f"{pm} test"
52
+ return {"value": cmd, "source": DETECTED, "confidence": 0.9,
53
+ "ecosystem": "node", "monorepo": monorepo,
54
+ "declared_script": scripts["test"]}
55
+ return {"value": f"{pm} test", "source": DEFAULT, "confidence": 0.3,
56
+ "ecosystem": "node", "monorepo": monorepo,
57
+ "note": "package.json has no scripts.test"}
58
+
59
+ # rust
60
+ if (root / "Cargo.toml").exists():
61
+ return {"value": "cargo test", "source": DETECTED, "confidence": 0.9,
62
+ "ecosystem": "rust"}
63
+
64
+ # go
65
+ if (root / "go.mod").exists():
66
+ return {"value": "go test ./...", "source": DETECTED, "confidence": 0.9,
67
+ "ecosystem": "go"}
68
+
69
+ # python — the ambiguous case: Makefile test target vs pytest vs pyproject
70
+ has_pyproject = (root / "pyproject.toml").exists()
71
+ has_setup = (root / "setup.py").exists() or (root / "setup.cfg").exists()
72
+ tests_dir = ("tests" if (root / "tests").is_dir()
73
+ else "test" if (root / "test").is_dir() else None)
74
+ has_tests_dir = tests_dir is not None
75
+ # Scope pytest to the tests dir when one exists. Bare `pytest` collects
76
+ # from the repo root and trips over stray test-like files elsewhere in the
77
+ # tree (a real failure mode found dogfooding the garden: scripts/**/test_*.py
78
+ # with broken imports → exit 2). Scoped collection matches how repos
79
+ # actually run their suite (`pytest tests/`).
80
+ _pytest = "python3 -m pytest" + (f" {tests_dir}" if tests_dir else "")
81
+ make = root / "Makefile"
82
+ make_test = False
83
+ if make.exists():
84
+ try:
85
+ make_test = bool(re.search(r"(?m)^test:", make.read_text()))
86
+ except Exception:
87
+ make_test = False
88
+ pytest_cfg = False
89
+ if has_pyproject:
90
+ try:
91
+ txt = (root / "pyproject.toml").read_text()
92
+ pytest_cfg = "[tool.pytest" in txt
93
+ except Exception:
94
+ pass
95
+ if (root / "pytest.ini").exists():
96
+ pytest_cfg = True
97
+
98
+ if has_pyproject or has_setup or has_tests_dir:
99
+ # Priority: declared Makefile target (explicit author intent) >
100
+ # ecosystem default pytest. Confidence drops when both exist
101
+ # (genuine ambiguity the detector must flag, not silently pick).
102
+ if make_test and (pytest_cfg or has_tests_dir):
103
+ return {"value": _pytest, "source": DETECTED,
104
+ "confidence": 0.55, "ecosystem": "python",
105
+ "ambiguity": "Makefile `test:` target AND pytest config both present",
106
+ "alt": "make test"}
107
+ if make_test:
108
+ return {"value": "make test", "source": DETECTED, "confidence": 0.8,
109
+ "ecosystem": "python"}
110
+ return {"value": _pytest, "source": DETECTED,
111
+ "confidence": 0.8 if (pytest_cfg or has_tests_dir) else 0.5,
112
+ "ecosystem": "python"}
113
+
114
+ return {"value": None, "source": DEFAULT, "confidence": 0.0,
115
+ "ecosystem": "unknown", "note": "no recognized test ecosystem"}
116
+
117
+
118
+ def _detect_evidence_sink(root: Path) -> dict:
119
+ # existing convention?
120
+ candidates = []
121
+ for p in root.rglob("evidence"):
122
+ if p.is_dir() and ".git" not in p.parts and "node_modules" not in p.parts:
123
+ candidates.append(p.relative_to(root).as_posix())
124
+ if len(candidates) >= 5:
125
+ break
126
+ if candidates:
127
+ # pick the shallowest existing evidence dir
128
+ candidates.sort(key=lambda s: s.count("/"))
129
+ return {"value": candidates[0], "source": DETECTED, "confidence": 0.8,
130
+ "others": candidates[1:]}
131
+ for d in ("test-results", "coverage", "reports"):
132
+ if (root / d).is_dir():
133
+ return {"value": d, "source": DETECTED, "confidence": 0.5}
134
+ return {"value": ".wg/evidence", "source": DEFAULT, "confidence": 0.3,
135
+ "note": "no existing evidence convention; proposing default"}
136
+
137
+
138
+ def _detect_claims_surface(root: Path) -> dict:
139
+ # structured claims doc? (frontmatter `claims:` block, command_iq build.md shape)
140
+ search_roots = [root / ".projects", root / "docs", root]
141
+ hits = []
142
+ for sr in search_roots:
143
+ if not sr.exists():
144
+ continue
145
+ for md in sr.rglob("*.md"):
146
+ if "node_modules" in md.parts or ".git" in md.parts:
147
+ continue
148
+ try:
149
+ head = md.read_text(errors="ignore")[:2000]
150
+ except Exception:
151
+ continue
152
+ if re.search(r"(?m)^claims:\s*$", head):
153
+ hits.append(md.relative_to(root).as_posix())
154
+ if len(hits) >= 5:
155
+ break
156
+ if hits:
157
+ break
158
+ if hits:
159
+ return {"value": "frontmatter", "glob": hits, "source": DETECTED,
160
+ "confidence": 0.85}
161
+ return {"value": "commit-msg", "source": DEFAULT, "confidence": 0.4,
162
+ "note": "no structured claims doc; default to commit-message scanning"}
163
+
164
+
165
+ def _detect_risk_surfaces(root: Path) -> dict:
166
+ # explicit surface table? (a markdown with a Surface|Skill dispatch table)
167
+ for md in (root / "CLAUDE.md", root / "AGENTS.md"):
168
+ if md.exists():
169
+ try:
170
+ txt = md.read_text(errors="ignore")
171
+ except Exception:
172
+ txt = ""
173
+ if re.search(r"Surface\b.*\bSkill", txt) or "surface-skill" in txt:
174
+ rows = re.findall(r"(?m)^\|\s*`?([a-z][\w/.-]+)`?\s*\|", txt)
175
+ return {"value": sorted(set(rows))[:20], "source": DETECTED,
176
+ "confidence": 0.7, "from": md.name}
177
+ # else: derive candidate surfaces from code module dirs
178
+ surfaces = []
179
+ for base in ("src", "packages", "lib"):
180
+ b = root / base
181
+ if b.is_dir():
182
+ for sub in sorted(b.iterdir()):
183
+ if sub.is_dir() and not sub.name.startswith("."):
184
+ surfaces.append(f"{base}/{sub.name}")
185
+ if surfaces:
186
+ break
187
+ if surfaces:
188
+ return {"value": surfaces[:20], "source": DETECTED, "confidence": 0.4,
189
+ "note": "derived from top-level module dirs; no explicit surface map"}
190
+ return {"value": [], "source": DEFAULT, "confidence": 0.0,
191
+ "note": "no module structure detected"}
192
+
193
+
194
+ def _node_script_cmd(root: Path, script: str) -> str | None:
195
+ """Return the run-command for a package.json script, or None if absent."""
196
+ pkg = root / "package.json"
197
+ if not pkg.exists():
198
+ return None
199
+ scripts = (_read_json(pkg).get("scripts") or {})
200
+ if script not in scripts:
201
+ return None
202
+ pm = _pkg_manager(root)
203
+ return f"npm run {script}" if pm == "npm" else f"{pm} {script}"
204
+
205
+
206
+ def _detect_lint_command(root: Path) -> dict:
207
+ """Detect a lint/static-check command. Omitted (value=None) when none —
208
+ pinning a non-existent linter would make the gate fail forever."""
209
+ # node — only if the repo declares a lint script (don't assume eslint).
210
+ cmd = _node_script_cmd(root, "lint")
211
+ if cmd:
212
+ return {"value": cmd, "source": DETECTED, "confidence": 0.9, "ecosystem": "node"}
213
+ if (root / "package.json").exists():
214
+ return {"value": None, "source": DEFAULT, "confidence": 0.0, "ecosystem": "node"}
215
+
216
+ # go — `go vet` is standard and always runnable for a module, no config.
217
+ if (root / "go.mod").exists():
218
+ return {"value": "go vet ./...", "source": DETECTED, "confidence": 0.85, "ecosystem": "go"}
219
+
220
+ # rust — clippy ships with the toolchain.
221
+ if (root / "Cargo.toml").exists():
222
+ return {"value": "cargo clippy", "source": DETECTED, "confidence": 0.7, "ecosystem": "rust"}
223
+
224
+ # python — ruff > flake8 > Makefile lint target. Only if configured.
225
+ if (root / "pyproject.toml").exists():
226
+ try:
227
+ txt = (root / "pyproject.toml").read_text()
228
+ except Exception:
229
+ txt = ""
230
+ if "[tool.ruff" in txt:
231
+ return {"value": "ruff check .", "source": DETECTED, "confidence": 0.85, "ecosystem": "python"}
232
+ if (root / "ruff.toml").exists() or (root / ".ruff.toml").exists():
233
+ return {"value": "ruff check .", "source": DETECTED, "confidence": 0.85, "ecosystem": "python"}
234
+ if (root / ".flake8").exists():
235
+ return {"value": "flake8", "source": DETECTED, "confidence": 0.8, "ecosystem": "python"}
236
+ make = root / "Makefile"
237
+ if make.exists():
238
+ try:
239
+ if re.search(r"(?m)^lint:", make.read_text()):
240
+ return {"value": "make lint", "source": DETECTED, "confidence": 0.75, "ecosystem": "python"}
241
+ except Exception:
242
+ pass
243
+
244
+ return {"value": None, "source": DEFAULT, "confidence": 0.0,
245
+ "note": "no lint command detected"}
246
+
247
+
248
+ def _detect_build_command(root: Path) -> dict:
249
+ """Detect a build/compile command. Omitted when none (e.g. most pure-Python
250
+ libs don't have a build step)."""
251
+ cmd = _node_script_cmd(root, "build")
252
+ if cmd:
253
+ return {"value": cmd, "source": DETECTED, "confidence": 0.9, "ecosystem": "node"}
254
+ if (root / "package.json").exists():
255
+ return {"value": None, "source": DEFAULT, "confidence": 0.0, "ecosystem": "node"}
256
+
257
+ if (root / "go.mod").exists():
258
+ return {"value": "go build ./...", "source": DETECTED, "confidence": 0.85, "ecosystem": "go"}
259
+ if (root / "Cargo.toml").exists():
260
+ return {"value": "cargo build", "source": DETECTED, "confidence": 0.85, "ecosystem": "rust"}
261
+
262
+ make = root / "Makefile"
263
+ if make.exists():
264
+ try:
265
+ if re.search(r"(?m)^build:", make.read_text()):
266
+ return {"value": "make build", "source": DETECTED, "confidence": 0.7, "ecosystem": "make"}
267
+ except Exception:
268
+ pass
269
+
270
+ return {"value": None, "source": DEFAULT, "confidence": 0.0,
271
+ "note": "no build command detected"}
272
+
273
+
274
+ def detect(repo_root: str) -> dict:
275
+ root = Path(repo_root).resolve()
276
+ return {
277
+ "repo": root.name,
278
+ "root": str(root),
279
+ "test_command": _detect_test_command(root),
280
+ "lint_command": _detect_lint_command(root),
281
+ "build_command": _detect_build_command(root),
282
+ "evidence_sink": _detect_evidence_sink(root),
283
+ "claims_surface": _detect_claims_surface(root),
284
+ "risk_surfaces": _detect_risk_surfaces(root),
285
+ }
286
+
287
+
288
+ if __name__ == "__main__":
289
+ if len(sys.argv) != 2:
290
+ print("usage: detect.py <repo_root>", file=sys.stderr)
291
+ sys.exit(2)
292
+ print(json.dumps(detect(sys.argv[1]), indent=2))
@@ -0,0 +1,228 @@
1
+ #!/usr/bin/env python3
2
+ """Phase-0 emitter — bindings.json -> a repo-native `wg_check_claims.py` lint.
3
+
4
+ This is the "compile" step under test: the SAME emitter, parameterized
5
+ only by detected bindings, must produce a lint that works in each repo
6
+ with no hand edits. The bindings are baked in as constants at the top of
7
+ the emitted file — that is the repo-specific "compiled" surface; the
8
+ checking logic below it is generic.
9
+
10
+ Stdlib-only. The emitted file is also stdlib-only so it can live in any
11
+ repo's pre-commit/CI with zero deps.
12
+ """
13
+ from __future__ import annotations
14
+
15
+ import json
16
+ import sys
17
+ from pathlib import Path
18
+
19
+ TEMPLATE = '''#!/usr/bin/env python3
20
+ """wg_check_claims.py — EMITTED by wicked-garden phase-0 compiler.
21
+
22
+ Repo-native claim->evidence enforcement. Compiled bindings for THIS repo
23
+ are the constants directly below; everything under them is generic.
24
+
25
+ A claim that asserts success ("tests pass", "N/N pass", "done", "clean")
26
+ must point to an evidence artifact that exists, is non-empty, carries a
27
+ success signal, and is not dominated by a failure signal. A claim whose
28
+ evidence is missing / empty / contradictory is a fabricated claim and
29
+ fails the lint.
30
+ """
31
+ from __future__ import annotations
32
+
33
+ import re
34
+ import sys
35
+ from pathlib import Path
36
+
37
+ # ---- COMPILED BINDINGS (repo-specific; emitted, not hand-written) ----
38
+ REPO = {repo!r}
39
+ TEST_COMMAND = {test_command!r}
40
+ EVIDENCE_SINK = {evidence_sink!r}
41
+ CLAIMS_MODE = {claims_mode!r} # "frontmatter" | "commit-msg"
42
+ CLAIMS_GLOB = {claims_glob!r} # list of frontmatter docs (if mode=frontmatter)
43
+ # ----------------------------------------------------------------------
44
+
45
+ PASS_LANG = re.compile(
46
+ r"\\b(tests?\\s+pass|passing|all\\s+green|\\d+\\s*/\\s*\\d+\\s+(?:tests?\\s+)?pass"
47
+ r"|exit\\s*0|typecheck[- ]?clean|build[- ]?clean|\\bclean\\b|\\bdone\\b"
48
+ r"|complete|fixed|merged)",
49
+ re.IGNORECASE,
50
+ )
51
+ SUCCESS_SIG = re.compile(
52
+ r"(\\bpass(?:ed|ing)?\\b|\\bok\\b|\\u2713|\\bexit\\s*(?:code\\s*)?0\\b"
53
+ r"|\\b\\d+\\s+passed\\b|test files\\s+\\d+\\s+passed|no\\s+violations)",
54
+ re.IGNORECASE,
55
+ )
56
+ # A nonzero-failure token DOMINATES a success claim even when partial
57
+ # "passed" counts are also present. "0 failed" must NOT trigger; bare
58
+ # lowercase "fail" in prose must NOT trigger (only uppercase FAIL token).
59
+ HARD_FAIL = re.compile(
60
+ r"([1-9]\\d*\\s+(?:failed|errors?|failures?)"
61
+ r"|(?-i:\\bFAIL\\b|\\u2717)"
62
+ r"|exit\\s*(?:code\\s*)?[1-9]"
63
+ r"|no test files found"
64
+ r"|\\btraceback\\b"
65
+ r"|failures?\\s*=\\s*[1-9])",
66
+ re.IGNORECASE,
67
+ )
68
+
69
+
70
+ def _resolve_evidence(repo_root: Path, slug: str) -> Path | None:
71
+ sink = repo_root / EVIDENCE_SINK
72
+ cands = [sink / slug, sink / (slug + ".txt"), sink / (slug + ".md"),
73
+ repo_root / slug]
74
+ # also: evidence dir co-located next to the claims doc (common shape)
75
+ for c in cands:
76
+ if c.exists() and c.is_file():
77
+ return c
78
+ # last resort: glob the sink for the slug
79
+ if sink.is_dir():
80
+ for p in sink.rglob(slug + "*"):
81
+ if p.is_file():
82
+ return p
83
+ return None
84
+
85
+
86
+ def _parse_frontmatter_claims(text: str):
87
+ """Return list of {{id,text,evidence}} from a `claims:` frontmatter block."""
88
+ if not text.startswith("---"):
89
+ return []
90
+ end = text.find("\\n---", 3)
91
+ fm = text[3:end] if end != -1 else text
92
+ lines = fm.splitlines()
93
+ claims, cur, in_block = [], None, False
94
+ for ln in lines:
95
+ if re.match(r"^claims:\\s*$", ln):
96
+ in_block = True
97
+ continue
98
+ if in_block:
99
+ if re.match(r"^\\S", ln): # next top-level key ends the block
100
+ break
101
+ m_id = re.match(r"^\\s*-\\s*id:\\s*(.+)$", ln)
102
+ if m_id:
103
+ if cur:
104
+ claims.append(cur)
105
+ cur = {{"id": m_id.group(1).strip(), "text": "", "evidence": ""}}
106
+ continue
107
+ m_ev = re.match(r"^\\s*evidence:\\s*(.+)$", ln)
108
+ if m_ev and cur is not None:
109
+ cur["evidence"] = m_ev.group(1).strip().strip('"\\'')
110
+ continue
111
+ m_tx = re.match(r"^\\s*text:\\s*(.+)$", ln)
112
+ if m_tx and cur is not None:
113
+ cur["text"] = m_tx.group(1).strip().strip('"\\'')
114
+ continue
115
+ if cur:
116
+ claims.append(cur)
117
+ return claims
118
+
119
+
120
+ def _evaluate(repo_root: Path, claims, source_label: str):
121
+ violations = []
122
+ checked = 0
123
+ for c in claims:
124
+ text = c.get("text", "")
125
+ if not PASS_LANG.search(text):
126
+ continue # not a success-claim; nothing to back
127
+ checked += 1
128
+ slug = c.get("evidence", "").strip()
129
+ if not slug:
130
+ violations.append((c.get("id", "?"), "success claim has NO evidence pointer", text))
131
+ continue
132
+ ev = _resolve_evidence(repo_root, slug)
133
+ if ev is None:
134
+ violations.append((c.get("id", "?"), f"evidence '{{slug}}' not found under {{EVIDENCE_SINK}}/", text))
135
+ continue
136
+ body = ev.read_text(errors="ignore")
137
+ if not body.strip():
138
+ violations.append((c.get("id", "?"), f"evidence '{{slug}}' is empty", text))
139
+ continue
140
+ has_pass = bool(SUCCESS_SIG.search(body))
141
+ has_fail = bool(HARD_FAIL.search(body))
142
+ if has_fail:
143
+ violations.append((c.get("id", "?"), f"evidence '{{slug}}' shows FAILURE, claim asserts success", text))
144
+ elif not has_pass:
145
+ violations.append((c.get("id", "?"), f"evidence '{{slug}}' has no success signal", text))
146
+ return checked, violations
147
+
148
+
149
+ def main(argv):
150
+ repo_root = Path(".").resolve()
151
+ docs = []
152
+ args = list(argv)
153
+ while args:
154
+ a = args.pop(0)
155
+ if a == "--repo-root":
156
+ repo_root = Path(args.pop(0)).resolve()
157
+ elif a == "--claims-file":
158
+ docs.append(Path(args.pop(0)))
159
+ else:
160
+ docs.append(Path(a))
161
+
162
+ if not docs:
163
+ if CLAIMS_MODE == "frontmatter" and CLAIMS_GLOB:
164
+ docs = [repo_root / g for g in CLAIMS_GLOB]
165
+ else:
166
+ print("wg_check_claims: commit-msg mode requires a claims source; "
167
+ "pass --claims-file <doc>", file=sys.stderr)
168
+ return 0
169
+
170
+ total_checked, all_v = 0, []
171
+ for d in docs:
172
+ if not d.exists():
173
+ continue
174
+ text = d.read_text(errors="ignore")
175
+ claims = _parse_frontmatter_claims(text)
176
+ checked, v = _evaluate(repo_root, claims, d.name)
177
+ total_checked += checked
178
+ all_v.extend((d.name, *row) for row in v)
179
+
180
+ if all_v:
181
+ print(f"wg_check_claims: FAIL ({{len(all_v)}} unbacked claim(s)) in {{REPO}}")
182
+ for doc, cid, why, text in all_v:
183
+ print(f" [{{doc}}] claim {{cid}}: {{why}}")
184
+ print(f" claim text: {{text[:100]}}")
185
+ print(f" test_command for re-verification: {{TEST_COMMAND}}")
186
+ return 1
187
+ print(f"wg_check_claims: PASS ({{total_checked}} success-claim(s) all evidence-backed) in {{REPO}}")
188
+ return 0
189
+
190
+
191
+ if __name__ == "__main__":
192
+ sys.exit(main(sys.argv[1:]))
193
+ '''
194
+
195
+
196
+ def render_lint(bindings: dict) -> str:
197
+ """Render the claims-vs-evidence lint source for a repo's bindings.
198
+
199
+ Single source of the lint logic — both the phase-0 ``emit()`` and the
200
+ ``compile`` emit stage (which writes it as ``.wicked/claims_lint.py``)
201
+ render through here. Stdlib-only output.
202
+ """
203
+ tc = bindings["test_command"]
204
+ es = bindings["evidence_sink"]
205
+ cs = bindings["claims_surface"]
206
+ return TEMPLATE.format(
207
+ repo=bindings["repo"],
208
+ test_command=tc.get("value") or "(none-detected)",
209
+ evidence_sink=es.get("value") or ".wg/evidence",
210
+ claims_mode=cs.get("value"),
211
+ claims_glob=cs.get("glob", []),
212
+ )
213
+
214
+
215
+ def emit(bindings: dict, out_dir: str) -> str:
216
+ out = Path(out_dir)
217
+ out.mkdir(parents=True, exist_ok=True)
218
+ target = out / "wg_check_claims.py"
219
+ target.write_text(render_lint(bindings))
220
+ return str(target)
221
+
222
+
223
+ if __name__ == "__main__":
224
+ if len(sys.argv) != 3:
225
+ print("usage: emit.py <bindings.json> <out_dir>", file=sys.stderr)
226
+ sys.exit(2)
227
+ b = json.loads(Path(sys.argv[1]).read_text())
228
+ print(emit(b, sys.argv[2]))
@@ -0,0 +1,30 @@
1
+ {
2
+ "repo": "Enterprise-AISDLC",
3
+ "root": "/Users/michael.parcewski/Projects/Enterprise-AISDLC",
4
+ "test_command": {
5
+ "value": "python3 -m pytest",
6
+ "source": "detected",
7
+ "confidence": 0.55,
8
+ "ecosystem": "python",
9
+ "ambiguity": "Makefile `test:` target AND pytest config both present",
10
+ "alt": "make test"
11
+ },
12
+ "evidence_sink": {
13
+ "value": ".wg/evidence",
14
+ "source": "proposed-default",
15
+ "confidence": 0.3,
16
+ "note": "no existing evidence convention; proposing default"
17
+ },
18
+ "claims_surface": {
19
+ "value": "commit-msg",
20
+ "source": "proposed-default",
21
+ "confidence": 0.4,
22
+ "note": "no structured claims doc; default to commit-message scanning"
23
+ },
24
+ "risk_surfaces": {
25
+ "value": [],
26
+ "source": "proposed-default",
27
+ "confidence": 0.0,
28
+ "note": "no module structure detected"
29
+ }
30
+ }
@@ -0,0 +1,17 @@
1
+ $ emitted lint (test_command=python3 -m pytest)
2
+
3
+ --- honest (expect exit 0) -> rc=0 ---
4
+ wg_check_claims: PASS (1 success-claim(s) all evidence-backed) in Enterprise-AISDLC
5
+
6
+ --- fabricated/missing (expect exit 1) -> rc=1 ---
7
+ wg_check_claims: FAIL (1 unbacked claim(s)) in Enterprise-AISDLC
8
+ [fab-missing.build.md] claim c-fab-missing: evidence 'tests-that-were-never-run' not found under .wg/evidence/
9
+ claim text: all tests pass, build clean, ready to merge
10
+ test_command for re-verification: python3 -m pytest
11
+
12
+ --- fabricated/failure (expect exit 1) -> rc=1 ---
13
+ wg_check_claims: FAIL (1 unbacked claim(s)) in Enterprise-AISDLC
14
+ [fab-fail.build.md] claim c-fab-fail: evidence 'failing-tests' shows FAILURE, claim asserts success
15
+ claim text: tests pass — all green
16
+ test_command for re-verification: python3 -m pytest
17
+
@@ -0,0 +1,4 @@
1
+ FAIL src/foo.test
2
+ 2 failed | 1 passed
3
+ Error: expected 2 received 3
4
+ exit code 1
@@ -0,0 +1,8 @@
1
+ ---
2
+ phase: build
3
+ claims:
4
+ - id: c-fab-fail
5
+ evidence: failing-tests
6
+ text: "tests pass — all green"
7
+ ---
8
+ # fabricated: evidence actually shows failure
@@ -0,0 +1,8 @@
1
+ ---
2
+ phase: build
3
+ claims:
4
+ - id: c-fab-missing
5
+ evidence: tests-that-were-never-run
6
+ text: "all tests pass, build clean, ready to merge"
7
+ ---
8
+ # fabricated: evidence file does not exist
@@ -0,0 +1,8 @@
1
+ ---
2
+ phase: build
3
+ claims:
4
+ - id: c-honest
5
+ evidence: honest-tests
6
+ text: "tests pass: 1/1 passing, exit 0"
7
+ ---
8
+ # honest