whykit 0.3.1__tar.gz

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 (213) hide show
  1. whykit-0.3.1/.gitignore +46 -0
  2. whykit-0.3.1/CHANGELOG.md +987 -0
  3. whykit-0.3.1/LICENSE +201 -0
  4. whykit-0.3.1/NOTICE +13 -0
  5. whykit-0.3.1/PKG-INFO +162 -0
  6. whykit-0.3.1/README.md +127 -0
  7. whykit-0.3.1/examples/approval/00-context/evidence-register.md +26 -0
  8. whykit-0.3.1/examples/approval/00-context/review-log.md +23 -0
  9. whykit-0.3.1/examples/approval/06-decisions/d-001-bind-approval-to-reviewed-record-bytes.md +65 -0
  10. whykit-0.3.1/examples/approval/06-decisions/d-002-classify-individual-evidence-rows-without-lowering-their-register-floor.md +62 -0
  11. whykit-0.3.1/examples/approval/06-decisions/decision-log.md +20 -0
  12. whykit-0.3.1/examples/approval/AGENTS.md +5 -0
  13. whykit-0.3.1/examples/approval/Home.md +21 -0
  14. whykit-0.3.1/examples/approval/README.md +28 -0
  15. whykit-0.3.1/examples/northline/00-context/README.md +29 -0
  16. whykit-0.3.1/examples/northline/00-context/company.md +73 -0
  17. whykit-0.3.1/examples/northline/00-context/evidence-register.md +49 -0
  18. whykit-0.3.1/examples/northline/00-context/goals.md +47 -0
  19. whykit-0.3.1/examples/northline/00-context/review-log.md +24 -0
  20. whykit-0.3.1/examples/northline/00-context/terminology.md +42 -0
  21. whykit-0.3.1/examples/northline/01-strategy/README.md +25 -0
  22. whykit-0.3.1/examples/northline/01-strategy/icp.md +48 -0
  23. whykit-0.3.1/examples/northline/01-strategy/messaging.md +49 -0
  24. whykit-0.3.1/examples/northline/01-strategy/offer-architecture.md +41 -0
  25. whykit-0.3.1/examples/northline/01-strategy/positioning.md +51 -0
  26. whykit-0.3.1/examples/northline/02-discoverability/README.md +25 -0
  27. whykit-0.3.1/examples/northline/02-discoverability/content-system.md +39 -0
  28. whykit-0.3.1/examples/northline/02-discoverability/search-and-answers.md +43 -0
  29. whykit-0.3.1/examples/northline/03-website/README.md +23 -0
  30. whykit-0.3.1/examples/northline/03-website/information-architecture.md +39 -0
  31. whykit-0.3.1/examples/northline/03-website/page-brief-home.md +68 -0
  32. whykit-0.3.1/examples/northline/04-automation/README.md +22 -0
  33. whykit-0.3.1/examples/northline/04-automation/inbound-demo-routing.md +57 -0
  34. whykit-0.3.1/examples/northline/05-operations/README.md +21 -0
  35. whykit-0.3.1/examples/northline/05-operations/meeting-2026-09-04-pipeline.md +49 -0
  36. whykit-0.3.1/examples/northline/05-operations/qualification.md +37 -0
  37. whykit-0.3.1/examples/northline/06-decisions/README.md +22 -0
  38. whykit-0.3.1/examples/northline/06-decisions/d-001-git-markdown.md +64 -0
  39. whykit-0.3.1/examples/northline/06-decisions/d-002-icp-ops.md +63 -0
  40. whykit-0.3.1/examples/northline/06-decisions/d-003-no-paid.md +62 -0
  41. whykit-0.3.1/examples/northline/06-decisions/d-004-english.md +40 -0
  42. whykit-0.3.1/examples/northline/06-decisions/d-005-product-led-site.md +42 -0
  43. whykit-0.3.1/examples/northline/06-decisions/d-006-no-ai-in-h1.md +40 -0
  44. whykit-0.3.1/examples/northline/06-decisions/d-007-hubspot.md +40 -0
  45. whykit-0.3.1/examples/northline/06-decisions/d-008-discrete.md +47 -0
  46. whykit-0.3.1/examples/northline/06-decisions/d-009-partner-led.md +48 -0
  47. whykit-0.3.1/examples/northline/06-decisions/d-010-direct.md +43 -0
  48. whykit-0.3.1/examples/northline/06-decisions/d-011-direct-with-evidence.md +67 -0
  49. whykit-0.3.1/examples/northline/06-decisions/decision-log.md +32 -0
  50. whykit-0.3.1/examples/northline/07-research/README.md +29 -0
  51. whykit-0.3.1/examples/northline/07-research/competitors/vendor-a.md +51 -0
  52. whykit-0.3.1/examples/northline/07-research/competitors/vendor-b.md +54 -0
  53. whykit-0.3.1/examples/northline/07-research/interviews/example-region-maintenance-lead-2026-06-18.md +51 -0
  54. whykit-0.3.1/examples/northline/07-research/market-dach.md +30 -0
  55. whykit-0.3.1/examples/northline/07-research/sources/ingestion-2026-09-02.md +41 -0
  56. whykit-0.3.1/examples/northline/AGENTS.md +117 -0
  57. whykit-0.3.1/examples/northline/Home.md +68 -0
  58. whykit-0.3.1/examples/northline/INTEROP.md +79 -0
  59. whykit-0.3.1/examples/northline/OBSIDIAN.md +69 -0
  60. whykit-0.3.1/examples/northline/README.md +96 -0
  61. whykit-0.3.1/examples/northline/reports/README.md +20 -0
  62. whykit-0.3.1/examples/northline/reports/organic-baseline-2026-08-01.md +38 -0
  63. whykit-0.3.1/examples/northline/templates/README.md +7 -0
  64. whykit-0.3.1/examples/northline/templates/automation-spec-template.md +70 -0
  65. whykit-0.3.1/examples/northline/templates/decision-record-template.md +65 -0
  66. whykit-0.3.1/examples/northline/templates/document-template.md +55 -0
  67. whykit-0.3.1/examples/northline/templates/experiment-template.md +62 -0
  68. whykit-0.3.1/examples/northline/templates/meeting-note-template.md +47 -0
  69. whykit-0.3.1/examples/northline/templates/page-brief-template.md +63 -0
  70. whykit-0.3.1/examples/northline/templates/research-note-template.md +53 -0
  71. whykit-0.3.1/examples/northline/templates/source-ingestion-template.md +43 -0
  72. whykit-0.3.1/examples/northline/whykit.toml +34 -0
  73. whykit-0.3.1/examples/tiny/.gitignore +17 -0
  74. whykit-0.3.1/examples/tiny/00-context/README.md +17 -0
  75. whykit-0.3.1/examples/tiny/00-context/company.md +52 -0
  76. whykit-0.3.1/examples/tiny/00-context/evidence-register.md +35 -0
  77. whykit-0.3.1/examples/tiny/00-context/goals.md +38 -0
  78. whykit-0.3.1/examples/tiny/00-context/review-log.md +22 -0
  79. whykit-0.3.1/examples/tiny/00-context/terminology.md +34 -0
  80. whykit-0.3.1/examples/tiny/06-decisions/README.md +11 -0
  81. whykit-0.3.1/examples/tiny/06-decisions/d-001-start-with-a-minimal-whykit-vault.md +67 -0
  82. whykit-0.3.1/examples/tiny/06-decisions/d-002-keep-the-ledger-to-evidence-and-decisions.md +73 -0
  83. whykit-0.3.1/examples/tiny/06-decisions/decision-log.md +39 -0
  84. whykit-0.3.1/examples/tiny/AGENTS.md +164 -0
  85. whykit-0.3.1/examples/tiny/Home.md +47 -0
  86. whykit-0.3.1/examples/tiny/INTEROP.md +117 -0
  87. whykit-0.3.1/examples/tiny/OBSIDIAN.md +92 -0
  88. whykit-0.3.1/examples/tiny/README.md +23 -0
  89. whykit-0.3.1/examples/tiny/assets/README.md +6 -0
  90. whykit-0.3.1/examples/tiny/notes/README.md +18 -0
  91. whykit-0.3.1/examples/tiny/reports/README.md +7 -0
  92. whykit-0.3.1/examples/tiny/templates/README.md +7 -0
  93. whykit-0.3.1/examples/tiny/templates/decision-record-template.md +65 -0
  94. whykit-0.3.1/examples/tiny/templates/document-template.md +55 -0
  95. whykit-0.3.1/examples/tiny/templates/research-note-template.md +53 -0
  96. whykit-0.3.1/examples/tiny/templates/source-ingestion-template.md +43 -0
  97. whykit-0.3.1/examples/tiny/whykit.toml +38 -0
  98. whykit-0.3.1/hatch_build.py +63 -0
  99. whykit-0.3.1/pyproject.toml +195 -0
  100. whykit-0.3.1/schemas/adopt-report.schema.json +222 -0
  101. whykit-0.3.1/schemas/backlinks-report.schema.json +61 -0
  102. whykit-0.3.1/schemas/check-report.schema.json +70 -0
  103. whykit-0.3.1/schemas/context-bundle.schema.json +27 -0
  104. whykit-0.3.1/schemas/context-pack.schema.json +29 -0
  105. whykit-0.3.1/schemas/decision-approval-result.schema.json +113 -0
  106. whykit-0.3.1/schemas/decision-record.schema.json +91 -0
  107. whykit-0.3.1/schemas/diff-report.schema.json +632 -0
  108. whykit-0.3.1/schemas/doctor-report.schema.json +55 -0
  109. whykit-0.3.1/schemas/document-frontmatter.schema.json +164 -0
  110. whykit-0.3.1/schemas/error.schema.json +57 -0
  111. whykit-0.3.1/schemas/evidence-entry.schema.json +19 -0
  112. whykit-0.3.1/schemas/evidence-list.schema.json +60 -0
  113. whykit-0.3.1/schemas/evidence-retire-result.schema.json +55 -0
  114. whykit-0.3.1/schemas/explorer-index.schema.json +166 -0
  115. whykit-0.3.1/schemas/graph.schema.json +27 -0
  116. whykit-0.3.1/schemas/history-report.schema.json +56 -0
  117. whykit-0.3.1/schemas/impact-report.schema.json +122 -0
  118. whykit-0.3.1/schemas/init-result.schema.json +33 -0
  119. whykit-0.3.1/schemas/lint-report.schema.json +166 -0
  120. whykit-0.3.1/schemas/lint-sarif.schema.json +276 -0
  121. whykit-0.3.1/schemas/policy.schema.json +70 -0
  122. whykit-0.3.1/schemas/provenance.schema.json +40 -0
  123. whykit-0.3.1/schemas/publication-preview.schema.json +66 -0
  124. whykit-0.3.1/schemas/query-result.schema.json +105 -0
  125. whykit-0.3.1/schemas/record-create.schema.json +49 -0
  126. whykit-0.3.1/schemas/recovery-result.schema.json +12 -0
  127. whykit-0.3.1/schemas/review-event.schema.json +17 -0
  128. whykit-0.3.1/schemas/review-queue.schema.json +65 -0
  129. whykit-0.3.1/schemas/review-record-result.schema.json +73 -0
  130. whykit-0.3.1/schemas/rule-catalog.schema.json +118 -0
  131. whykit-0.3.1/schemas/rule-detail.schema.json +60 -0
  132. whykit-0.3.1/schemas/snapshot-verify.schema.json +87 -0
  133. whykit-0.3.1/schemas/snapshot.schema.json +42 -0
  134. whykit-0.3.1/schemas/status-report.schema.json +176 -0
  135. whykit-0.3.1/schemas/trace-report.schema.json +211 -0
  136. whykit-0.3.1/src/whykit/__init__.py +21 -0
  137. whykit-0.3.1/src/whykit/adopt.py +776 -0
  138. whykit-0.3.1/src/whykit/backlinks.py +106 -0
  139. whykit-0.3.1/src/whykit/check.py +320 -0
  140. whykit-0.3.1/src/whykit/ci_formats.py +283 -0
  141. whykit-0.3.1/src/whykit/cli.py +1719 -0
  142. whykit-0.3.1/src/whykit/completion.py +193 -0
  143. whykit-0.3.1/src/whykit/config.py +233 -0
  144. whykit-0.3.1/src/whykit/console.py +217 -0
  145. whykit-0.3.1/src/whykit/context.py +204 -0
  146. whykit-0.3.1/src/whykit/contract.py +210 -0
  147. whykit-0.3.1/src/whykit/contract_schemas/backlinks-report.schema.json +61 -0
  148. whykit-0.3.1/src/whykit/contract_schemas/context-bundle.schema.json +27 -0
  149. whykit-0.3.1/src/whykit/contract_schemas/context-pack.schema.json +29 -0
  150. whykit-0.3.1/src/whykit/contract_schemas/impact-report.schema.json +122 -0
  151. whykit-0.3.1/src/whykit/contract_schemas/query-result.schema.json +105 -0
  152. whykit-0.3.1/src/whykit/contract_schemas/status-report.schema.json +176 -0
  153. whykit-0.3.1/src/whykit/contract_schemas/trace-report.schema.json +211 -0
  154. whykit-0.3.1/src/whykit/diff.py +823 -0
  155. whykit-0.3.1/src/whykit/evidence.py +178 -0
  156. whykit-0.3.1/src/whykit/explorer_index.py +554 -0
  157. whykit-0.3.1/src/whykit/graph.py +318 -0
  158. whykit-0.3.1/src/whykit/immutability.py +624 -0
  159. whykit-0.3.1/src/whykit/impact.py +272 -0
  160. whykit-0.3.1/src/whykit/init_layout.py +205 -0
  161. whykit-0.3.1/src/whykit/io.py +563 -0
  162. whykit-0.3.1/src/whykit/lint.py +2190 -0
  163. whykit-0.3.1/src/whykit/lsp.py +1241 -0
  164. whykit-0.3.1/src/whykit/markdown_code.py +107 -0
  165. whykit-0.3.1/src/whykit/mcp_server.py +2289 -0
  166. whykit-0.3.1/src/whykit/messages.py +46 -0
  167. whykit-0.3.1/src/whykit/pack.py +294 -0
  168. whykit-0.3.1/src/whykit/parse_cache.py +752 -0
  169. whykit-0.3.1/src/whykit/placeholders.py +84 -0
  170. whykit-0.3.1/src/whykit/promote.py +651 -0
  171. whykit-0.3.1/src/whykit/py.typed +0 -0
  172. whykit-0.3.1/src/whykit/query.py +174 -0
  173. whykit-0.3.1/src/whykit/review.py +527 -0
  174. whykit-0.3.1/src/whykit/rule_policy.py +1063 -0
  175. whykit-0.3.1/src/whykit/rules.py +274 -0
  176. whykit-0.3.1/src/whykit/scaffold.py +784 -0
  177. whykit-0.3.1/src/whykit/sensitivity.py +95 -0
  178. whykit-0.3.1/src/whykit/snapshot.py +319 -0
  179. whykit-0.3.1/src/whykit/status.py +167 -0
  180. whykit-0.3.1/src/whykit/tables.py +120 -0
  181. whykit-0.3.1/src/whykit/template/00-context/README.md +17 -0
  182. whykit-0.3.1/src/whykit/template/00-context/company.md +52 -0
  183. whykit-0.3.1/src/whykit/template/00-context/evidence-register.md +34 -0
  184. whykit-0.3.1/src/whykit/template/00-context/goals.md +38 -0
  185. whykit-0.3.1/src/whykit/template/00-context/review-log.md +22 -0
  186. whykit-0.3.1/src/whykit/template/00-context/terminology.md +34 -0
  187. whykit-0.3.1/src/whykit/template/01-strategy/README.md +7 -0
  188. whykit-0.3.1/src/whykit/template/02-discoverability/README.md +10 -0
  189. whykit-0.3.1/src/whykit/template/03-website/README.md +7 -0
  190. whykit-0.3.1/src/whykit/template/04-automation/README.md +10 -0
  191. whykit-0.3.1/src/whykit/template/05-operations/README.md +19 -0
  192. whykit-0.3.1/src/whykit/template/06-decisions/README.md +11 -0
  193. whykit-0.3.1/src/whykit/template/06-decisions/decision-log.md +38 -0
  194. whykit-0.3.1/src/whykit/template/07-research/README.md +10 -0
  195. whykit-0.3.1/src/whykit/template/AGENTS.md +163 -0
  196. whykit-0.3.1/src/whykit/template/Home.md +57 -0
  197. whykit-0.3.1/src/whykit/template/INTEROP.md +117 -0
  198. whykit-0.3.1/src/whykit/template/OBSIDIAN.md +92 -0
  199. whykit-0.3.1/src/whykit/template/README.md +51 -0
  200. whykit-0.3.1/src/whykit/template/assets/README.md +6 -0
  201. whykit-0.3.1/src/whykit/template/reports/README.md +7 -0
  202. whykit-0.3.1/src/whykit/template/templates/README.md +7 -0
  203. whykit-0.3.1/src/whykit/template/templates/automation-spec-template.md +70 -0
  204. whykit-0.3.1/src/whykit/template/templates/decision-record-template.md +65 -0
  205. whykit-0.3.1/src/whykit/template/templates/document-template.md +55 -0
  206. whykit-0.3.1/src/whykit/template/templates/experiment-template.md +62 -0
  207. whykit-0.3.1/src/whykit/template/templates/meeting-note-template.md +47 -0
  208. whykit-0.3.1/src/whykit/template/templates/page-brief-template.md +63 -0
  209. whykit-0.3.1/src/whykit/template/templates/research-note-template.md +53 -0
  210. whykit-0.3.1/src/whykit/template/templates/source-ingestion-template.md +43 -0
  211. whykit-0.3.1/src/whykit/template/whykit.toml +39 -0
  212. whykit-0.3.1/src/whykit/trace.py +272 -0
  213. whykit-0.3.1/src/whykit/vault_index.py +190 -0
whykit-0.3.1/.gitignore ADDED
@@ -0,0 +1,46 @@
1
+ # Local staging for raw platform exports, before normalization.
2
+ # Never commit raw exports — normalize them into a workstream first.
3
+ .import-staging/
4
+
5
+ # Secrets. This repository holds knowledge and tooling, never credentials.
6
+ .env
7
+ *.key
8
+ *.pem
9
+
10
+ # OS and editor noise
11
+ .DS_Store
12
+ Thumbs.db
13
+ .obsidian/workspace.json
14
+ .obsidian/workspace-mobile.json
15
+
16
+ # Python
17
+ __pycache__/
18
+ *.pyc
19
+ .venv/
20
+ venv/
21
+ build/
22
+ dist/
23
+ dist-rebuild/
24
+ *.egg-info/
25
+ .coverage
26
+ .coverage.*
27
+ htmlcov/
28
+ .mypy_cache/
29
+ .pytest_cache/
30
+ .ruff_cache/
31
+
32
+ # Local vault machine artifacts (snapshots, scratch). Keep out of git.
33
+ .whykit/
34
+ .ci-snapshot.json
35
+ **/.ci-snapshot.json
36
+
37
+ # Explorer build artifacts
38
+ apps/explorer/node_modules/
39
+ apps/explorer/dist/
40
+ apps/explorer/dist-single/
41
+ apps/explorer/src/generated/vault.json
42
+ apps/explorer/src/generated/bodies.json
43
+ apps/explorer/src/generated/findings.json
44
+ apps/explorer/e2e/.build/
45
+ apps/explorer/test-results/
46
+ apps/explorer/playwright-report/