sdkfit 0.5.0__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 (620) hide show
  1. sdkfit-0.5.0/.claude/skills/prd-generator/SKILL.md +96 -0
  2. sdkfit-0.5.0/.claude/skills/prd-interview/SKILL.md +102 -0
  3. sdkfit-0.5.0/.claude/skills/tech-plan/SKILL.md +78 -0
  4. sdkfit-0.5.0/.claude/skills/tenon-begin/SKILL.md +55 -0
  5. sdkfit-0.5.0/.claude/skills/tenon-begin/references/proposals.md +49 -0
  6. sdkfit-0.5.0/.claude/skills/tenon-begin-fast/SKILL.md +93 -0
  7. sdkfit-0.5.0/.claude/skills/tenon-begin-fast/references/gather-context.md +56 -0
  8. sdkfit-0.5.0/.claude/skills/tenon-end/SKILL.md +39 -0
  9. sdkfit-0.5.0/.claude/skills/tenon-end-fast/SKILL.md +58 -0
  10. sdkfit-0.5.0/.claude/skills/tenon-next/SKILL.md +78 -0
  11. sdkfit-0.5.0/.claude/skills/tenon-report/SKILL.md +77 -0
  12. sdkfit-0.5.0/.claude/skills/tenon-worktrees/SKILL.md +92 -0
  13. sdkfit-0.5.0/.dockerignore +12 -0
  14. sdkfit-0.5.0/.env.example +23 -0
  15. sdkfit-0.5.0/.github/workflows/ci.yml +41 -0
  16. sdkfit-0.5.0/.github/workflows/release.yml +91 -0
  17. sdkfit-0.5.0/.gitignore +33 -0
  18. sdkfit-0.5.0/CHANGELOG.md +138 -0
  19. sdkfit-0.5.0/CLAUDE.md +161 -0
  20. sdkfit-0.5.0/Caddyfile +4 -0
  21. sdkfit-0.5.0/Dockerfile +42 -0
  22. sdkfit-0.5.0/LICENSE +201 -0
  23. sdkfit-0.5.0/PKG-INFO +18 -0
  24. sdkfit-0.5.0/README.md +449 -0
  25. sdkfit-0.5.0/VISION.md +77 -0
  26. sdkfit-0.5.0/bundles/README.md +20 -0
  27. sdkfit-0.5.0/deploy/k8s/bundles-pvc.yaml +13 -0
  28. sdkfit-0.5.0/deploy/k8s/configmap.example.yaml +13 -0
  29. sdkfit-0.5.0/deploy/k8s/deployment.yaml +141 -0
  30. sdkfit-0.5.0/deploy/k8s/hpa.yaml +20 -0
  31. sdkfit-0.5.0/deploy/k8s/ingress.yaml +28 -0
  32. sdkfit-0.5.0/deploy/k8s/kustomization.yaml +10 -0
  33. sdkfit-0.5.0/deploy/k8s/postgres.yaml +76 -0
  34. sdkfit-0.5.0/deploy/k8s/secret.example.yaml +28 -0
  35. sdkfit-0.5.0/deploy/k8s/service.yaml +18 -0
  36. sdkfit-0.5.0/docker-compose.yml +56 -0
  37. sdkfit-0.5.0/docs/RELEASE.md +123 -0
  38. sdkfit-0.5.0/docs/ROADMAP.md +75 -0
  39. sdkfit-0.5.0/docs/benchmark/README.md +59 -0
  40. sdkfit-0.5.0/docs/benchmark/corpus.jsonl +2 -0
  41. sdkfit-0.5.0/docs/launch/DEMO.md +56 -0
  42. sdkfit-0.5.0/docs/launch/FAQ.md +43 -0
  43. sdkfit-0.5.0/docs/launch/FIRST_COMMENT.md +34 -0
  44. sdkfit-0.5.0/docs/launch/GALLERY.md +49 -0
  45. sdkfit-0.5.0/docs/launch/LAUNCH.md +107 -0
  46. sdkfit-0.5.0/docs/launch/NAME_CHECK.md +34 -0
  47. sdkfit-0.5.0/docs/planning/_card/issue.md +23 -0
  48. sdkfit-0.5.0/docs/planning/ci-release/ci-workflow/plan_20261114.md +17 -0
  49. sdkfit-0.5.0/docs/planning/ci-release/ci-workflow/spec.md +27 -0
  50. sdkfit-0.5.0/docs/planning/ci-release/prd.md +140 -0
  51. sdkfit-0.5.0/docs/planning/ci-release/release-workflow/plan_20261114.md +17 -0
  52. sdkfit-0.5.0/docs/planning/ci-release/release-workflow/spec.md +33 -0
  53. sdkfit-0.5.0/docs/planning/cli/cli-config/plan_20261105.md +111 -0
  54. sdkfit-0.5.0/docs/planning/cli/cli-config/spec.md +71 -0
  55. sdkfit-0.5.0/docs/planning/cli/cli-report/plan_20261105.md +125 -0
  56. sdkfit-0.5.0/docs/planning/cli/cli-report/spec.md +88 -0
  57. sdkfit-0.5.0/docs/planning/cli/cli-run/plan_20261105.md +151 -0
  58. sdkfit-0.5.0/docs/planning/cli/cli-run/spec.md +93 -0
  59. sdkfit-0.5.0/docs/planning/cli/prd.md +245 -0
  60. sdkfit-0.5.0/docs/planning/cloud-deploy/cloud-docs/plan_20261116.md +20 -0
  61. sdkfit-0.5.0/docs/planning/cloud-deploy/cloud-docs/spec.md +33 -0
  62. sdkfit-0.5.0/docs/planning/cloud-deploy/k8s-manifests/plan_20261116.md +26 -0
  63. sdkfit-0.5.0/docs/planning/cloud-deploy/k8s-manifests/spec.md +42 -0
  64. sdkfit-0.5.0/docs/planning/cloud-deploy/postgres-cli/plan_20261116.md +27 -0
  65. sdkfit-0.5.0/docs/planning/cloud-deploy/postgres-cli/spec.md +33 -0
  66. sdkfit-0.5.0/docs/planning/cloud-deploy/postgres-store/plan_20261116.md +27 -0
  67. sdkfit-0.5.0/docs/planning/cloud-deploy/postgres-store/spec.md +45 -0
  68. sdkfit-0.5.0/docs/planning/cloud-deploy/prd.md +174 -0
  69. sdkfit-0.5.0/docs/planning/corpus/corpus-cli/plan_20261107.md +90 -0
  70. sdkfit-0.5.0/docs/planning/corpus/corpus-cli/spec.md +60 -0
  71. sdkfit-0.5.0/docs/planning/corpus/corpus-record/plan_20261107.md +94 -0
  72. sdkfit-0.5.0/docs/planning/corpus/corpus-record/spec.md +65 -0
  73. sdkfit-0.5.0/docs/planning/corpus/corpus-report/plan_20261107.md +88 -0
  74. sdkfit-0.5.0/docs/planning/corpus/corpus-report/spec.md +52 -0
  75. sdkfit-0.5.0/docs/planning/corpus/prd.md +227 -0
  76. sdkfit-0.5.0/docs/planning/cross-file/cross-csharp/plan_20261115.md +19 -0
  77. sdkfit-0.5.0/docs/planning/cross-file/cross-csharp/spec.md +27 -0
  78. sdkfit-0.5.0/docs/planning/cross-file/cross-go/plan_20261115.md +18 -0
  79. sdkfit-0.5.0/docs/planning/cross-file/cross-go/spec.md +29 -0
  80. sdkfit-0.5.0/docs/planning/cross-file/cross-python/plan_20261115.md +19 -0
  81. sdkfit-0.5.0/docs/planning/cross-file/cross-python/spec.md +36 -0
  82. sdkfit-0.5.0/docs/planning/cross-file/cross-rust/plan_20261115.md +19 -0
  83. sdkfit-0.5.0/docs/planning/cross-file/cross-rust/spec.md +33 -0
  84. sdkfit-0.5.0/docs/planning/cross-file/cross-ts/plan_20261115.md +19 -0
  85. sdkfit-0.5.0/docs/planning/cross-file/cross-ts/spec.md +32 -0
  86. sdkfit-0.5.0/docs/planning/cross-file/prd.md +188 -0
  87. sdkfit-0.5.0/docs/planning/github-app/app-cli/plan_20261108.md +81 -0
  88. sdkfit-0.5.0/docs/planning/github-app/app-cli/spec.md +57 -0
  89. sdkfit-0.5.0/docs/planning/github-app/app-remote/plan_20261108.md +82 -0
  90. sdkfit-0.5.0/docs/planning/github-app/app-remote/spec.md +62 -0
  91. sdkfit-0.5.0/docs/planning/github-app/app-token/plan_20261108.md +91 -0
  92. sdkfit-0.5.0/docs/planning/github-app/app-token/spec.md +64 -0
  93. sdkfit-0.5.0/docs/planning/github-app/prd.md +236 -0
  94. sdkfit-0.5.0/docs/planning/launch-readiness/image-publish/plan_20261116.md +19 -0
  95. sdkfit-0.5.0/docs/planning/launch-readiness/image-publish/spec.md +31 -0
  96. sdkfit-0.5.0/docs/planning/launch-readiness/launch-demo/plan_20261116.md +19 -0
  97. sdkfit-0.5.0/docs/planning/launch-readiness/launch-demo/spec.md +30 -0
  98. sdkfit-0.5.0/docs/planning/launch-readiness/launch-kit/plan_20261116.md +25 -0
  99. sdkfit-0.5.0/docs/planning/launch-readiness/launch-kit/spec.md +39 -0
  100. sdkfit-0.5.0/docs/planning/launch-readiness/prd.md +162 -0
  101. sdkfit-0.5.0/docs/planning/launch-readiness/pypi-publish/plan_20261116.md +19 -0
  102. sdkfit-0.5.0/docs/planning/launch-readiness/pypi-publish/spec.md +30 -0
  103. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/evidence.md +131 -0
  104. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/identity-copies/plan_20261031.md +45 -0
  105. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/identity-copies/spec.md +47 -0
  106. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/memoized-resolution/plan_20261031.md +62 -0
  107. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/memoized-resolution/spec.md +60 -0
  108. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/prd.md +136 -0
  109. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/real-spec-evidence/plan_20261031.md +56 -0
  110. sdkfit-0.5.0/docs/planning/lazy-ref-resolution/real-spec-evidence/spec.md +51 -0
  111. sdkfit-0.5.0/docs/planning/locator-csharp/csharp-integration/plan_20261111.md +88 -0
  112. sdkfit-0.5.0/docs/planning/locator-csharp/csharp-integration/spec.md +56 -0
  113. sdkfit-0.5.0/docs/planning/locator-csharp/csharp-locate/plan_20261111.md +105 -0
  114. sdkfit-0.5.0/docs/planning/locator-csharp/csharp-locate/spec.md +83 -0
  115. sdkfit-0.5.0/docs/planning/locator-csharp/prd.md +214 -0
  116. sdkfit-0.5.0/docs/planning/locator-go/go-integration/plan_20261110.md +88 -0
  117. sdkfit-0.5.0/docs/planning/locator-go/go-integration/spec.md +57 -0
  118. sdkfit-0.5.0/docs/planning/locator-go/go-locate/plan_20261110.md +107 -0
  119. sdkfit-0.5.0/docs/planning/locator-go/go-locate/spec.md +83 -0
  120. sdkfit-0.5.0/docs/planning/locator-go/prd.md +213 -0
  121. sdkfit-0.5.0/docs/planning/locator-rust/prd.md +209 -0
  122. sdkfit-0.5.0/docs/planning/locator-rust/rust-integration/plan_20261110.md +87 -0
  123. sdkfit-0.5.0/docs/planning/locator-rust/rust-integration/spec.md +54 -0
  124. sdkfit-0.5.0/docs/planning/locator-rust/rust-locate/plan_20261110.md +103 -0
  125. sdkfit-0.5.0/docs/planning/locator-rust/rust-locate/spec.md +79 -0
  126. sdkfit-0.5.0/docs/planning/m0-3-first-real-case/evidence.md +242 -0
  127. sdkfit-0.5.0/docs/planning/m0-3-first-real-case/gate-run/plan_20261102.md +232 -0
  128. sdkfit-0.5.0/docs/planning/m0-3-first-real-case/gate-run/spec.md +67 -0
  129. sdkfit-0.5.0/docs/planning/m0-3-first-real-case/prd.md +164 -0
  130. sdkfit-0.5.0/docs/planning/m0-3-real-case/evidence.md +174 -0
  131. sdkfit-0.5.0/docs/planning/m0-3-real-case/gate-evidence/plan_20261031.md +163 -0
  132. sdkfit-0.5.0/docs/planning/m0-3-real-case/gate-evidence/spec.md +40 -0
  133. sdkfit-0.5.0/docs/planning/m0-3-real-case/mock-assertion-scan/plan_20261031.md +120 -0
  134. sdkfit-0.5.0/docs/planning/m0-3-real-case/mock-assertion-scan/spec.md +43 -0
  135. sdkfit-0.5.0/docs/planning/m0-3-real-case/prd.md +220 -0
  136. sdkfit-0.5.0/docs/planning/m0-3-real-case/real-case-pin/plan_20261031.md +118 -0
  137. sdkfit-0.5.0/docs/planning/m0-3-real-case/real-case-pin/spec.md +41 -0
  138. sdkfit-0.5.0/docs/planning/mcp-diffs/mcp-diff/plan_20261106.md +119 -0
  139. sdkfit-0.5.0/docs/planning/mcp-diffs/mcp-diff/spec.md +68 -0
  140. sdkfit-0.5.0/docs/planning/mcp-diffs/mcp-ingest/plan_20261106.md +101 -0
  141. sdkfit-0.5.0/docs/planning/mcp-diffs/mcp-ingest/spec.md +62 -0
  142. sdkfit-0.5.0/docs/planning/mcp-diffs/prd.md +212 -0
  143. sdkfit-0.5.0/docs/planning/mcp-locator/mcp-cli/plan_20261107.md +91 -0
  144. sdkfit-0.5.0/docs/planning/mcp-locator/mcp-cli/spec.md +63 -0
  145. sdkfit-0.5.0/docs/planning/mcp-locator/mcp-locate/plan_20261107.md +98 -0
  146. sdkfit-0.5.0/docs/planning/mcp-locator/mcp-locate/spec.md +73 -0
  147. sdkfit-0.5.0/docs/planning/mcp-locator/mcp-scan/plan_20261107.md +99 -0
  148. sdkfit-0.5.0/docs/planning/mcp-locator/mcp-scan/spec.md +61 -0
  149. sdkfit-0.5.0/docs/planning/mcp-locator/prd.md +230 -0
  150. sdkfit-0.5.0/docs/planning/mcp-probe/prd.md +254 -0
  151. sdkfit-0.5.0/docs/planning/mcp-probe/probe-cli/plan_20261107.md +83 -0
  152. sdkfit-0.5.0/docs/planning/mcp-probe/probe-cli/spec.md +59 -0
  153. sdkfit-0.5.0/docs/planning/mcp-probe/probe-client/plan_20261107.md +97 -0
  154. sdkfit-0.5.0/docs/planning/mcp-probe/probe-client/spec.md +67 -0
  155. sdkfit-0.5.0/docs/planning/mcp-probe/probe-run/plan_20261107.md +102 -0
  156. sdkfit-0.5.0/docs/planning/mcp-probe/probe-run/spec.md +72 -0
  157. sdkfit-0.5.0/docs/planning/openapi-differ/change-record/plan_20261025.md +75 -0
  158. sdkfit-0.5.0/docs/planning/openapi-differ/change-record/spec.md +48 -0
  159. sdkfit-0.5.0/docs/planning/openapi-differ/diff-core/plan_20261025.md +85 -0
  160. sdkfit-0.5.0/docs/planning/openapi-differ/diff-core/spec.md +68 -0
  161. sdkfit-0.5.0/docs/planning/openapi-differ/prd.md +174 -0
  162. sdkfit-0.5.0/docs/planning/openapi-differ/rename-inference/plan_20261025.md +64 -0
  163. sdkfit-0.5.0/docs/planning/openapi-differ/rename-inference/spec.md +54 -0
  164. sdkfit-0.5.0/docs/planning/openapi-differ/spec-ingest/plan_20261025.md +63 -0
  165. sdkfit-0.5.0/docs/planning/openapi-differ/spec-ingest/spec.md +47 -0
  166. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-csharp/plan_20261114.md +25 -0
  167. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-csharp/spec.md +25 -0
  168. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-docs/plan_20261114.md +21 -0
  169. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-docs/spec.md +24 -0
  170. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-python-ts/plan_20261114.md +26 -0
  171. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-python-ts/spec.md +30 -0
  172. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-rust-go/plan_20261114.md +26 -0
  173. sdkfit-0.5.0/docs/planning/parameter-inference/parameters-rust-go/spec.md +31 -0
  174. sdkfit-0.5.0/docs/planning/parameter-inference/prd.md +170 -0
  175. sdkfit-0.5.0/docs/planning/patch-proposer/diff-render/plan_20261029.md +105 -0
  176. sdkfit-0.5.0/docs/planning/patch-proposer/diff-render/spec.md +72 -0
  177. sdkfit-0.5.0/docs/planning/patch-proposer/prd.md +190 -0
  178. sdkfit-0.5.0/docs/planning/patch-proposer/proposal-result/plan_20261029.md +67 -0
  179. sdkfit-0.5.0/docs/planning/patch-proposer/proposal-result/spec.md +54 -0
  180. sdkfit-0.5.0/docs/planning/patch-proposer/rename-rule/plan_20261029.md +66 -0
  181. sdkfit-0.5.0/docs/planning/patch-proposer/rename-rule/spec.md +63 -0
  182. sdkfit-0.5.0/docs/planning/pr-writer/pr-render/plan_20261105.md +144 -0
  183. sdkfit-0.5.0/docs/planning/pr-writer/pr-render/spec.md +91 -0
  184. sdkfit-0.5.0/docs/planning/pr-writer/pr-result/plan_20261105.md +116 -0
  185. sdkfit-0.5.0/docs/planning/pr-writer/pr-result/spec.md +59 -0
  186. sdkfit-0.5.0/docs/planning/pr-writer/pr-write/plan_20261105.md +168 -0
  187. sdkfit-0.5.0/docs/planning/pr-writer/pr-write/spec.md +101 -0
  188. sdkfit-0.5.0/docs/planning/pr-writer/prd.md +300 -0
  189. sdkfit-0.5.0/docs/planning/proof-ladder/prd.md +276 -0
  190. sdkfit-0.5.0/docs/planning/proof-ladder/proof-cli/plan_20261105.md +106 -0
  191. sdkfit-0.5.0/docs/planning/proof-ladder/proof-cli/spec.md +66 -0
  192. sdkfit-0.5.0/docs/planning/proof-ladder/proof-plan/plan_20261105.md +115 -0
  193. sdkfit-0.5.0/docs/planning/proof-ladder/proof-plan/spec.md +73 -0
  194. sdkfit-0.5.0/docs/planning/proof-ladder/proof-pr/plan_20261105.md +100 -0
  195. sdkfit-0.5.0/docs/planning/proof-ladder/proof-pr/spec.md +69 -0
  196. sdkfit-0.5.0/docs/planning/proof-ladder/proof-result/plan_20261105.md +104 -0
  197. sdkfit-0.5.0/docs/planning/proof-ladder/proof-result/spec.md +69 -0
  198. sdkfit-0.5.0/docs/planning/proof-runner/prd.md +182 -0
  199. sdkfit-0.5.0/docs/planning/proof-runner/proof-result/plan_20261029.md +56 -0
  200. sdkfit-0.5.0/docs/planning/proof-runner/proof-result/spec.md +54 -0
  201. sdkfit-0.5.0/docs/planning/proof-runner/run-proof/plan_20261029.md +97 -0
  202. sdkfit-0.5.0/docs/planning/proof-runner/run-proof/spec.md +73 -0
  203. sdkfit-0.5.0/docs/planning/proof-runner/working-copy/plan_20261029.md +66 -0
  204. sdkfit-0.5.0/docs/planning/proof-runner/working-copy/spec.md +56 -0
  205. sdkfit-0.5.0/docs/planning/provider-bundle/prd.md +225 -0
  206. sdkfit-0.5.0/docs/planning/provider-bundle/provider-bundle/plan_20261108.md +88 -0
  207. sdkfit-0.5.0/docs/planning/provider-bundle/provider-bundle/spec.md +63 -0
  208. sdkfit-0.5.0/docs/planning/provider-bundle/provider-cli/plan_20261108.md +94 -0
  209. sdkfit-0.5.0/docs/planning/provider-bundle/provider-cli/spec.md +64 -0
  210. sdkfit-0.5.0/docs/planning/provider-fanout/prd.md +206 -0
  211. sdkfit-0.5.0/docs/planning/provider-fanout/provider-fanout/plan_20261109.md +97 -0
  212. sdkfit-0.5.0/docs/planning/provider-fanout/provider-fanout/spec.md +79 -0
  213. sdkfit-0.5.0/docs/planning/provider-fanout/provider-repos/plan_20261109.md +75 -0
  214. sdkfit-0.5.0/docs/planning/provider-fanout/provider-repos/spec.md +54 -0
  215. sdkfit-0.5.0/docs/planning/provider-installed/installed-discovery/plan_20261110.md +92 -0
  216. sdkfit-0.5.0/docs/planning/provider-installed/installed-discovery/spec.md +66 -0
  217. sdkfit-0.5.0/docs/planning/provider-installed/installed-fanout/plan_20261110.md +96 -0
  218. sdkfit-0.5.0/docs/planning/provider-installed/installed-fanout/spec.md +73 -0
  219. sdkfit-0.5.0/docs/planning/provider-installed/prd.md +201 -0
  220. sdkfit-0.5.0/docs/planning/provider-service/prd.md +242 -0
  221. sdkfit-0.5.0/docs/planning/provider-service/service-api/plan_20261111.md +103 -0
  222. sdkfit-0.5.0/docs/planning/provider-service/service-api/spec.md +93 -0
  223. sdkfit-0.5.0/docs/planning/provider-service/service-store/plan_20261111.md +81 -0
  224. sdkfit-0.5.0/docs/planning/provider-service/service-store/spec.md +68 -0
  225. sdkfit-0.5.0/docs/planning/python-call-site-locator/ambiguity-policy/plan_20261028.md +180 -0
  226. sdkfit-0.5.0/docs/planning/python-call-site-locator/ambiguity-policy/spec.md +94 -0
  227. sdkfit-0.5.0/docs/planning/python-call-site-locator/locate-result/plan_20261028.md +108 -0
  228. sdkfit-0.5.0/docs/planning/python-call-site-locator/locate-result/spec.md +60 -0
  229. sdkfit-0.5.0/docs/planning/python-call-site-locator/prd.md +257 -0
  230. sdkfit-0.5.0/docs/planning/python-call-site-locator/python-scan/plan_20261028.md +203 -0
  231. sdkfit-0.5.0/docs/planning/python-call-site-locator/python-scan/spec.md +87 -0
  232. sdkfit-0.5.0/docs/planning/python-call-site-locator/symbol-contract/plan_20261028.md +124 -0
  233. sdkfit-0.5.0/docs/planning/python-call-site-locator/symbol-contract/spec.md +76 -0
  234. sdkfit-0.5.0/docs/planning/real-spec-readability/composition-skip/plan_20261030.md +80 -0
  235. sdkfit-0.5.0/docs/planning/real-spec-readability/composition-skip/spec.md +61 -0
  236. sdkfit-0.5.0/docs/planning/real-spec-readability/cycle-tolerance/plan_20261030.md +76 -0
  237. sdkfit-0.5.0/docs/planning/real-spec-readability/cycle-tolerance/spec.md +50 -0
  238. sdkfit-0.5.0/docs/planning/real-spec-readability/evidence.md +110 -0
  239. sdkfit-0.5.0/docs/planning/real-spec-readability/prd.md +148 -0
  240. sdkfit-0.5.0/docs/planning/real-spec-readability/unanalyzed-contract/plan_20261030.md +54 -0
  241. sdkfit-0.5.0/docs/planning/real-spec-readability/unanalyzed-contract/spec.md +46 -0
  242. sdkfit-0.5.0/docs/planning/receiver-inference/inference-csharp/plan_20261114.md +25 -0
  243. sdkfit-0.5.0/docs/planning/receiver-inference/inference-csharp/spec.md +29 -0
  244. sdkfit-0.5.0/docs/planning/receiver-inference/inference-docs/plan_20261114.md +22 -0
  245. sdkfit-0.5.0/docs/planning/receiver-inference/inference-docs/spec.md +26 -0
  246. sdkfit-0.5.0/docs/planning/receiver-inference/inference-python-ts/plan_20261114.md +26 -0
  247. sdkfit-0.5.0/docs/planning/receiver-inference/inference-python-ts/spec.md +34 -0
  248. sdkfit-0.5.0/docs/planning/receiver-inference/inference-rust-go/plan_20261114.md +26 -0
  249. sdkfit-0.5.0/docs/planning/receiver-inference/inference-rust-go/spec.md +34 -0
  250. sdkfit-0.5.0/docs/planning/receiver-inference/prd.md +173 -0
  251. sdkfit-0.5.0/docs/planning/receiver-tracking/go-receivers/plan_20261112.md +69 -0
  252. sdkfit-0.5.0/docs/planning/receiver-tracking/go-receivers/spec.md +58 -0
  253. sdkfit-0.5.0/docs/planning/receiver-tracking/prd.md +208 -0
  254. sdkfit-0.5.0/docs/planning/receiver-tracking/receiver-config/plan_20261112.md +69 -0
  255. sdkfit-0.5.0/docs/planning/receiver-tracking/receiver-config/spec.md +54 -0
  256. sdkfit-0.5.0/docs/planning/receiver-tracking/rust-receivers/plan_20261112.md +69 -0
  257. sdkfit-0.5.0/docs/planning/receiver-tracking/rust-receivers/spec.md +57 -0
  258. sdkfit-0.5.0/docs/planning/receivers-rest/csharp-receivers/plan_20261112.md +41 -0
  259. sdkfit-0.5.0/docs/planning/receivers-rest/csharp-receivers/spec.md +38 -0
  260. sdkfit-0.5.0/docs/planning/receivers-rest/prd.md +183 -0
  261. sdkfit-0.5.0/docs/planning/receivers-rest/python-receivers/plan_20261112.md +41 -0
  262. sdkfit-0.5.0/docs/planning/receivers-rest/python-receivers/spec.md +37 -0
  263. sdkfit-0.5.0/docs/planning/receivers-rest/receiver-config-all/plan_20261112.md +51 -0
  264. sdkfit-0.5.0/docs/planning/receivers-rest/receiver-config-all/spec.md +35 -0
  265. sdkfit-0.5.0/docs/planning/receivers-rest/ts-receivers/plan_20261112.md +41 -0
  266. sdkfit-0.5.0/docs/planning/receivers-rest/ts-receivers/spec.md +36 -0
  267. sdkfit-0.5.0/docs/planning/release-v0.1.0/prd.md +120 -0
  268. sdkfit-0.5.0/docs/planning/release-v0.1.0/release-examples/plan_20261113.md +26 -0
  269. sdkfit-0.5.0/docs/planning/release-v0.1.0/release-examples/spec.md +35 -0
  270. sdkfit-0.5.0/docs/planning/release-v0.1.0/release-version/plan_20261113.md +33 -0
  271. sdkfit-0.5.0/docs/planning/release-v0.1.0/release-version/spec.md +32 -0
  272. sdkfit-0.5.0/docs/planning/rename-sdkfit/prd.md +121 -0
  273. sdkfit-0.5.0/docs/planning/rename-sdkfit/rename-code/plan_20261116.md +26 -0
  274. sdkfit-0.5.0/docs/planning/rename-sdkfit/rename-code/spec.md +28 -0
  275. sdkfit-0.5.0/docs/planning/rename-sdkfit/rename-docs/plan_20261116.md +19 -0
  276. sdkfit-0.5.0/docs/planning/rename-sdkfit/rename-docs/spec.md +32 -0
  277. sdkfit-0.5.0/docs/planning/rename-sdkfit/rename-ops/plan_20261116.md +20 -0
  278. sdkfit-0.5.0/docs/planning/rename-sdkfit/rename-ops/spec.md +27 -0
  279. sdkfit-0.5.0/docs/planning/service-deploy/prd.md +149 -0
  280. sdkfit-0.5.0/docs/planning/service-deploy/service-deploy/plan_20261112.md +58 -0
  281. sdkfit-0.5.0/docs/planning/service-deploy/service-deploy/spec.md +44 -0
  282. sdkfit-0.5.0/docs/planning/service-deploy/service-readiness/plan_20261112.md +40 -0
  283. sdkfit-0.5.0/docs/planning/service-deploy/service-readiness/spec.md +27 -0
  284. sdkfit-0.5.0/docs/planning/service-resilience/prd.md +186 -0
  285. sdkfit-0.5.0/docs/planning/service-resilience/resilience-service/plan_20261112.md +36 -0
  286. sdkfit-0.5.0/docs/planning/service-resilience/resilience-service/spec.md +50 -0
  287. sdkfit-0.5.0/docs/planning/service-resilience/resilience-store/plan_20261112.md +28 -0
  288. sdkfit-0.5.0/docs/planning/service-resilience/resilience-store/spec.md +48 -0
  289. sdkfit-0.5.0/docs/planning/stripe-real-case/evidence.md +82 -0
  290. sdkfit-0.5.0/docs/planning/stripe-real-case/prd.md +120 -0
  291. sdkfit-0.5.0/docs/planning/typescript-locator/prd.md +298 -0
  292. sdkfit-0.5.0/docs/planning/typescript-locator/ts-cli/plan_20261105.md +99 -0
  293. sdkfit-0.5.0/docs/planning/typescript-locator/ts-cli/spec.md +67 -0
  294. sdkfit-0.5.0/docs/planning/typescript-locator/ts-locate/plan_20261105.md +102 -0
  295. sdkfit-0.5.0/docs/planning/typescript-locator/ts-locate/spec.md +72 -0
  296. sdkfit-0.5.0/docs/planning/typescript-locator/ts-scan/plan_20261105.md +155 -0
  297. sdkfit-0.5.0/docs/planning/typescript-locator/ts-scan/spec.md +94 -0
  298. sdkfit-0.5.0/docs/planning/webhook-runs/prd.md +174 -0
  299. sdkfit-0.5.0/docs/planning/webhook-runs/webhook-trigger-api/plan_20261114.md +26 -0
  300. sdkfit-0.5.0/docs/planning/webhook-runs/webhook-trigger-api/spec.md +40 -0
  301. sdkfit-0.5.0/docs/planning/webhook-runs/webhook-trigger-config/plan_20261114.md +27 -0
  302. sdkfit-0.5.0/docs/planning/webhook-runs/webhook-trigger-config/spec.md +38 -0
  303. sdkfit-0.5.0/docs/technical/ARCHITECTURE.md +278 -0
  304. sdkfit-0.5.0/docs/technical/CAPABILITY_ROADMAP.md +489 -0
  305. sdkfit-0.5.0/docs/technical/CLOUD.md +207 -0
  306. sdkfit-0.5.0/docs/technical/DEPLOYMENT.md +251 -0
  307. sdkfit-0.5.0/examples/README.md +47 -0
  308. sdkfit-0.5.0/examples/launch-demo/README.md +18 -0
  309. sdkfit-0.5.0/examples/launch-demo/bundle.json +13 -0
  310. sdkfit-0.5.0/examples/launch-demo/new.yaml +8 -0
  311. sdkfit-0.5.0/examples/launch-demo/old.yaml +8 -0
  312. sdkfit-0.5.0/examples/launch-demo/repo/acme/__init__.py +0 -0
  313. sdkfit-0.5.0/examples/launch-demo/repo/acme/billing.py +7 -0
  314. sdkfit-0.5.0/examples/launch-demo/repo/acme/client.py +11 -0
  315. sdkfit-0.5.0/examples/quickstart/bundle.json +13 -0
  316. sdkfit-0.5.0/examples/quickstart/new.yaml +8 -0
  317. sdkfit-0.5.0/examples/quickstart/old.yaml +8 -0
  318. sdkfit-0.5.0/pyproject.toml +44 -0
  319. sdkfit-0.5.0/scripts/launch_demo.sh +37 -0
  320. sdkfit-0.5.0/scripts/release_check.sh +22 -0
  321. sdkfit-0.5.0/secrets/.gitkeep +0 -0
  322. sdkfit-0.5.0/src/sdkfit/__init__.py +0 -0
  323. sdkfit-0.5.0/src/sdkfit/__main__.py +3 -0
  324. sdkfit-0.5.0/src/sdkfit/cli/__init__.py +42 -0
  325. sdkfit-0.5.0/src/sdkfit/cli/config.py +323 -0
  326. sdkfit-0.5.0/src/sdkfit/cli/main.py +1144 -0
  327. sdkfit-0.5.0/src/sdkfit/cli/report.py +479 -0
  328. sdkfit-0.5.0/src/sdkfit/corpus/__init__.py +23 -0
  329. sdkfit-0.5.0/src/sdkfit/corpus/record.py +110 -0
  330. sdkfit-0.5.0/src/sdkfit/corpus/report.py +161 -0
  331. sdkfit-0.5.0/src/sdkfit/corpus/store.py +94 -0
  332. sdkfit-0.5.0/src/sdkfit/detect/__init__.py +31 -0
  333. sdkfit-0.5.0/src/sdkfit/detect/diff.py +708 -0
  334. sdkfit-0.5.0/src/sdkfit/detect/ingest.py +169 -0
  335. sdkfit-0.5.0/src/sdkfit/detect/mcp_diff.py +284 -0
  336. sdkfit-0.5.0/src/sdkfit/detect/mcp_ingest.py +92 -0
  337. sdkfit-0.5.0/src/sdkfit/detect/record.py +198 -0
  338. sdkfit-0.5.0/src/sdkfit/detect/rename.py +115 -0
  339. sdkfit-0.5.0/src/sdkfit/locate/__init__.py +61 -0
  340. sdkfit-0.5.0/src/sdkfit/locate/config.py +22 -0
  341. sdkfit-0.5.0/src/sdkfit/locate/csharp_config.py +39 -0
  342. sdkfit-0.5.0/src/sdkfit/locate/csharp_locate.py +28 -0
  343. sdkfit-0.5.0/src/sdkfit/locate/csharp_scan.py +597 -0
  344. sdkfit-0.5.0/src/sdkfit/locate/go_config.py +53 -0
  345. sdkfit-0.5.0/src/sdkfit/locate/go_locate.py +28 -0
  346. sdkfit-0.5.0/src/sdkfit/locate/go_scan.py +588 -0
  347. sdkfit-0.5.0/src/sdkfit/locate/mcp_config.py +19 -0
  348. sdkfit-0.5.0/src/sdkfit/locate/mcp_locate.py +221 -0
  349. sdkfit-0.5.0/src/sdkfit/locate/mcp_scan.py +368 -0
  350. sdkfit-0.5.0/src/sdkfit/locate/query.py +231 -0
  351. sdkfit-0.5.0/src/sdkfit/locate/resolve.py +309 -0
  352. sdkfit-0.5.0/src/sdkfit/locate/result.py +165 -0
  353. sdkfit-0.5.0/src/sdkfit/locate/rust_config.py +40 -0
  354. sdkfit-0.5.0/src/sdkfit/locate/rust_locate.py +25 -0
  355. sdkfit-0.5.0/src/sdkfit/locate/rust_scan.py +724 -0
  356. sdkfit-0.5.0/src/sdkfit/locate/scan.py +897 -0
  357. sdkfit-0.5.0/src/sdkfit/locate/ts_config.py +40 -0
  358. sdkfit-0.5.0/src/sdkfit/locate/ts_locate.py +25 -0
  359. sdkfit-0.5.0/src/sdkfit/locate/ts_scan.py +1130 -0
  360. sdkfit-0.5.0/src/sdkfit/pr/__init__.py +29 -0
  361. sdkfit-0.5.0/src/sdkfit/pr/api.py +116 -0
  362. sdkfit-0.5.0/src/sdkfit/pr/app.py +110 -0
  363. sdkfit-0.5.0/src/sdkfit/pr/github_app.py +147 -0
  364. sdkfit-0.5.0/src/sdkfit/pr/installed.py +139 -0
  365. sdkfit-0.5.0/src/sdkfit/pr/remote.py +169 -0
  366. sdkfit-0.5.0/src/sdkfit/pr/render.py +257 -0
  367. sdkfit-0.5.0/src/sdkfit/pr/result.py +117 -0
  368. sdkfit-0.5.0/src/sdkfit/pr/write.py +273 -0
  369. sdkfit-0.5.0/src/sdkfit/probe/__init__.py +30 -0
  370. sdkfit-0.5.0/src/sdkfit/probe/agent.py +102 -0
  371. sdkfit-0.5.0/src/sdkfit/probe/client.py +291 -0
  372. sdkfit-0.5.0/src/sdkfit/probe/report.py +181 -0
  373. sdkfit-0.5.0/src/sdkfit/probe/run.py +156 -0
  374. sdkfit-0.5.0/src/sdkfit/probe/tasks.py +77 -0
  375. sdkfit-0.5.0/src/sdkfit/propose/__init__.py +13 -0
  376. sdkfit-0.5.0/src/sdkfit/propose/render.py +231 -0
  377. sdkfit-0.5.0/src/sdkfit/propose/result.py +137 -0
  378. sdkfit-0.5.0/src/sdkfit/propose/rules.py +76 -0
  379. sdkfit-0.5.0/src/sdkfit/prove/__init__.py +32 -0
  380. sdkfit-0.5.0/src/sdkfit/prove/copy.py +99 -0
  381. sdkfit-0.5.0/src/sdkfit/prove/plan.py +27 -0
  382. sdkfit-0.5.0/src/sdkfit/prove/result.py +177 -0
  383. sdkfit-0.5.0/src/sdkfit/prove/run.py +237 -0
  384. sdkfit-0.5.0/src/sdkfit/provider/__init__.py +6 -0
  385. sdkfit-0.5.0/src/sdkfit/provider/bundle.py +178 -0
  386. sdkfit-0.5.0/src/sdkfit/provider/repos.py +22 -0
  387. sdkfit-0.5.0/src/sdkfit/service/__init__.py +5 -0
  388. sdkfit-0.5.0/src/sdkfit/service/api.py +329 -0
  389. sdkfit-0.5.0/src/sdkfit/service/http.py +63 -0
  390. sdkfit-0.5.0/src/sdkfit/service/postgres.py +331 -0
  391. sdkfit-0.5.0/src/sdkfit/service/runner.py +127 -0
  392. sdkfit-0.5.0/src/sdkfit/service/store.py +448 -0
  393. sdkfit-0.5.0/src/sdkfit/service/triggers.py +59 -0
  394. sdkfit-0.5.0/src/sdkfit/service/worker.py +88 -0
  395. sdkfit-0.5.0/tests/cli/__init__.py +0 -0
  396. sdkfit-0.5.0/tests/cli/conftest.py +393 -0
  397. sdkfit-0.5.0/tests/cli/test_config.py +1073 -0
  398. sdkfit-0.5.0/tests/cli/test_main.py +5565 -0
  399. sdkfit-0.5.0/tests/cli/test_report.py +1121 -0
  400. sdkfit-0.5.0/tests/corpus/__init__.py +0 -0
  401. sdkfit-0.5.0/tests/corpus/test_record.py +348 -0
  402. sdkfit-0.5.0/tests/corpus/test_report.py +268 -0
  403. sdkfit-0.5.0/tests/corpus/test_store.py +254 -0
  404. sdkfit-0.5.0/tests/detect/test_copies.py +123 -0
  405. sdkfit-0.5.0/tests/detect/test_cycles.py +133 -0
  406. sdkfit-0.5.0/tests/detect/test_dag.py +94 -0
  407. sdkfit-0.5.0/tests/detect/test_diff_composition.py +239 -0
  408. sdkfit-0.5.0/tests/detect/test_diff_params.py +211 -0
  409. sdkfit-0.5.0/tests/detect/test_diff_paths.py +128 -0
  410. sdkfit-0.5.0/tests/detect/test_diff_schemas.py +274 -0
  411. sdkfit-0.5.0/tests/detect/test_ingest.py +228 -0
  412. sdkfit-0.5.0/tests/detect/test_mcp_diff.py +787 -0
  413. sdkfit-0.5.0/tests/detect/test_mcp_ingest.py +286 -0
  414. sdkfit-0.5.0/tests/detect/test_real_twilio_specs.py +45 -0
  415. sdkfit-0.5.0/tests/detect/test_record.py +309 -0
  416. sdkfit-0.5.0/tests/detect/test_rename.py +323 -0
  417. sdkfit-0.5.0/tests/detect/test_unanalyzed.py +51 -0
  418. sdkfit-0.5.0/tests/fixtures/mcp/probe_agent.py +81 -0
  419. sdkfit-0.5.0/tests/fixtures/mcp/probe_server.py +197 -0
  420. sdkfit-0.5.0/tests/fixtures/mcp/probe_tasks.json +19 -0
  421. sdkfit-0.5.0/tests/fixtures/mcp/tools-additional-v1.json +13 -0
  422. sdkfit-0.5.0/tests/fixtures/mcp/tools-additional-v2.json +14 -0
  423. sdkfit-0.5.0/tests/fixtures/mcp/tools-amount-v1.json +15 -0
  424. sdkfit-0.5.0/tests/fixtures/mcp/tools-amount-v2.json +15 -0
  425. sdkfit-0.5.0/tests/fixtures/mcp/tools-array.json +31 -0
  426. sdkfit-0.5.0/tests/fixtures/mcp/tools-composition-v1.json +23 -0
  427. sdkfit-0.5.0/tests/fixtures/mcp/tools-composition-v2.json +23 -0
  428. sdkfit-0.5.0/tests/fixtures/mcp/tools-input-v1.json +17 -0
  429. sdkfit-0.5.0/tests/fixtures/mcp/tools-input-v2.json +18 -0
  430. sdkfit-0.5.0/tests/fixtures/mcp/tools-nested-v1.json +30 -0
  431. sdkfit-0.5.0/tests/fixtures/mcp/tools-nested-v2.json +29 -0
  432. sdkfit-0.5.0/tests/fixtures/mcp/tools-output-v1.json +16 -0
  433. sdkfit-0.5.0/tests/fixtures/mcp/tools-output-v2.json +17 -0
  434. sdkfit-0.5.0/tests/fixtures/mcp/tools-ref-cycle-added.json +28 -0
  435. sdkfit-0.5.0/tests/fixtures/mcp/tools-ref-cycle.json +21 -0
  436. sdkfit-0.5.0/tests/fixtures/mcp/tools-ref-external.json +11 -0
  437. sdkfit-0.5.0/tests/fixtures/mcp/tools-ref.json +17 -0
  438. sdkfit-0.5.0/tests/fixtures/mcp/tools-rename-v1.json +16 -0
  439. sdkfit-0.5.0/tests/fixtures/mcp/tools-rename-v2.json +16 -0
  440. sdkfit-0.5.0/tests/fixtures/mcp/tools-v1.json +35 -0
  441. sdkfit-0.5.0/tests/fixtures/mcp/tools-v2.json +38 -0
  442. sdkfit-0.5.0/tests/fixtures/repos/conftest.py +2 -0
  443. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/.github/workflow.yml +1 -0
  444. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/.gitignore +12 -0
  445. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/keep.py +1 -0
  446. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/link.py +1 -0
  447. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/node_modules/x.js +1 -0
  448. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/sub/.hidden/secret.py +1 -0
  449. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/sub/keep.py +1 -0
  450. sdkfit-0.5.0/tests/fixtures/repos/copy-dot/venv/pyvenv.cfg +1 -0
  451. sdkfit-0.5.0/tests/fixtures/repos/csharp-basic/Billing.csproj +14 -0
  452. sdkfit-0.5.0/tests/fixtures/repos/csharp-basic/Program.cs +14 -0
  453. sdkfit-0.5.0/tests/fixtures/repos/go-basic/go.mod +5 -0
  454. sdkfit-0.5.0/tests/fixtures/repos/go-basic/main.go +11 -0
  455. sdkfit-0.5.0/tests/fixtures/repos/mcp-alias/app.py +9 -0
  456. sdkfit-0.5.0/tests/fixtures/repos/mcp-basic/broken.py +5 -0
  457. sdkfit-0.5.0/tests/fixtures/repos/mcp-basic/client.py +11 -0
  458. sdkfit-0.5.0/tests/fixtures/repos/mcp-basic/helper.py +5 -0
  459. sdkfit-0.5.0/tests/fixtures/repos/mcp-basic/unrelated.py +7 -0
  460. sdkfit-0.5.0/tests/fixtures/repos/mcp-cli/app.py +8 -0
  461. sdkfit-0.5.0/tests/fixtures/repos/mcp-cli/sdkfit.toml +3 -0
  462. sdkfit-0.5.0/tests/fixtures/repos/mcp-decoy/app.py +12 -0
  463. sdkfit-0.5.0/tests/fixtures/repos/mcp-dynamic/app.py +14 -0
  464. sdkfit-0.5.0/tests/fixtures/repos/proof-basic/acme/__init__.py +0 -0
  465. sdkfit-0.5.0/tests/fixtures/repos/proof-basic/acme/billing.py +7 -0
  466. sdkfit-0.5.0/tests/fixtures/repos/proof-basic/acme/client.py +11 -0
  467. sdkfit-0.5.0/tests/fixtures/repos/real-stripe-template/LICENSE +21 -0
  468. sdkfit-0.5.0/tests/fixtures/repos/real-stripe-template/PROVENANCE.md +17 -0
  469. sdkfit-0.5.0/tests/fixtures/repos/real-stripe-template/app/router/v1/payment.py +83 -0
  470. sdkfit-0.5.0/tests/fixtures/repos/real-stripe-template/tests/test_payment.py +82 -0
  471. sdkfit-0.5.0/tests/fixtures/repos/rust-basic/Cargo.toml +8 -0
  472. sdkfit-0.5.0/tests/fixtures/repos/rust-basic/src/lib.rs +10 -0
  473. sdkfit-0.5.0/tests/fixtures/repos/sdk-basic/acme/__init__.py +0 -0
  474. sdkfit-0.5.0/tests/fixtures/repos/sdk-basic/acme/billing.py +6 -0
  475. sdkfit-0.5.0/tests/fixtures/repos/sdk-basic/acme/broken.py +7 -0
  476. sdkfit-0.5.0/tests/fixtures/repos/sdk-basic/acme/reporting.py +3 -0
  477. sdkfit-0.5.0/tests/fixtures/repos/sdk-basic/acme/unrelated.py +5 -0
  478. sdkfit-0.5.0/tests/fixtures/repos/sdk-decoy/acme/__init__.py +0 -0
  479. sdkfit-0.5.0/tests/fixtures/repos/sdk-decoy/acme/mixed.py +11 -0
  480. sdkfit-0.5.0/tests/fixtures/repos/sdk-dynamic/acme/__init__.py +0 -0
  481. sdkfit-0.5.0/tests/fixtures/repos/sdk-dynamic/acme/flows.py +22 -0
  482. sdkfit-0.5.0/tests/fixtures/repos/sdk-mock-assert/app.py +5 -0
  483. sdkfit-0.5.0/tests/fixtures/repos/sdk-mock-assert/tests/test_app.py +7 -0
  484. sdkfit-0.5.0/tests/fixtures/repos/sdk-multiple/acme/__init__.py +0 -0
  485. sdkfit-0.5.0/tests/fixtures/repos/sdk-multiple/acme/clients.py +6 -0
  486. sdkfit-0.5.0/tests/fixtures/repos/sdk-src-layout/src/acme/__init__.py +0 -0
  487. sdkfit-0.5.0/tests/fixtures/repos/sdk-src-layout/src/acme/app.py +4 -0
  488. sdkfit-0.5.0/tests/fixtures/repos/sdk-stripe-checkout/shop/checkout.py +9 -0
  489. sdkfit-0.5.0/tests/fixtures/repos/sdk-unicode/acme/__init__.py +0 -0
  490. sdkfit-0.5.0/tests/fixtures/repos/sdk-unicode/acme/unicode_demo.py +4 -0
  491. sdkfit-0.5.0/tests/fixtures/repos/ts-alias/src/aliases.ts +22 -0
  492. sdkfit-0.5.0/tests/fixtures/repos/ts-attribute/src/charge.ts +5 -0
  493. sdkfit-0.5.0/tests/fixtures/repos/ts-cjs/app.cjs +3 -0
  494. sdkfit-0.5.0/tests/fixtures/repos/ts-cjs/lib/client.cjs +3 -0
  495. sdkfit-0.5.0/tests/fixtures/repos/ts-cjs/lib/import-equals.cts +3 -0
  496. sdkfit-0.5.0/tests/fixtures/repos/ts-cjs/lib/named.cjs +5 -0
  497. sdkfit-0.5.0/tests/fixtures/repos/ts-decoy/src/format.ts +3 -0
  498. sdkfit-0.5.0/tests/fixtures/repos/ts-decoy/src/sdk.ts +8 -0
  499. sdkfit-0.5.0/tests/fixtures/repos/ts-decoy/src/unrelated.ts +1 -0
  500. sdkfit-0.5.0/tests/fixtures/repos/ts-dynamic/src/flows.ts +16 -0
  501. sdkfit-0.5.0/tests/fixtures/repos/ts-dynamic-import/src/sdk.ts +5 -0
  502. sdkfit-0.5.0/tests/fixtures/repos/ts-js/app.mjs +5 -0
  503. sdkfit-0.5.0/tests/fixtures/repos/ts-js/component.jsx +5 -0
  504. sdkfit-0.5.0/tests/fixtures/repos/ts-js/lib/util.js +3 -0
  505. sdkfit-0.5.0/tests/fixtures/repos/ts-multiple/src/clients.ts +6 -0
  506. sdkfit-0.5.0/tests/fixtures/repos/ts-no-sdk/src/app.ts +3 -0
  507. sdkfit-0.5.0/tests/fixtures/repos/ts-quoted/src/billing.ts +5 -0
  508. sdkfit-0.5.0/tests/fixtures/repos/ts-sdk-basic/node_modules/evil.ts +5 -0
  509. sdkfit-0.5.0/tests/fixtures/repos/ts-sdk-basic/src/billing.ts +6 -0
  510. sdkfit-0.5.0/tests/fixtures/repos/ts-sdk-basic/src/broken.ts +5 -0
  511. sdkfit-0.5.0/tests/fixtures/repos/ts-sdk-basic/src/reporting.ts +3 -0
  512. sdkfit-0.5.0/tests/fixtures/repos/ts-sdk-basic/src/unrelated.ts +5 -0
  513. sdkfit-0.5.0/tests/fixtures/repos/ts-tsx/src/app.tsx +7 -0
  514. sdkfit-0.5.0/tests/fixtures/repos/ts-unicode/src/app.ts +4 -0
  515. sdkfit-0.5.0/tests/fixtures/sdkfit.toml +8 -0
  516. sdkfit-0.5.0/tests/fixtures/specs/bad-version.yaml +5 -0
  517. sdkfit-0.5.0/tests/fixtures/specs/components-new.yaml +14 -0
  518. sdkfit-0.5.0/tests/fixtures/specs/components-old.yaml +14 -0
  519. sdkfit-0.5.0/tests/fixtures/specs/composition-allof-new.yaml +25 -0
  520. sdkfit-0.5.0/tests/fixtures/specs/composition-allof-old.yaml +26 -0
  521. sdkfit-0.5.0/tests/fixtures/specs/composition-discriminator.yaml +25 -0
  522. sdkfit-0.5.0/tests/fixtures/specs/composition-oneof-new.yaml +15 -0
  523. sdkfit-0.5.0/tests/fixtures/specs/composition-oneof-old.yaml +17 -0
  524. sdkfit-0.5.0/tests/fixtures/specs/composition-skip-new.yaml +19 -0
  525. sdkfit-0.5.0/tests/fixtures/specs/composition-skip-old.yaml +19 -0
  526. sdkfit-0.5.0/tests/fixtures/specs/cycle-new.yaml +10 -0
  527. sdkfit-0.5.0/tests/fixtures/specs/cycle-old.yaml +10 -0
  528. sdkfit-0.5.0/tests/fixtures/specs/cycle-two.yaml +13 -0
  529. sdkfit-0.5.0/tests/fixtures/specs/dag-new.yaml +161 -0
  530. sdkfit-0.5.0/tests/fixtures/specs/dag-old.yaml +161 -0
  531. sdkfit-0.5.0/tests/fixtures/specs/empty.yaml +0 -0
  532. sdkfit-0.5.0/tests/fixtures/specs/minimal-3.0.yaml +11 -0
  533. sdkfit-0.5.0/tests/fixtures/specs/minimal-3.1.json +19 -0
  534. sdkfit-0.5.0/tests/fixtures/specs/not-a-spec.yaml +1 -0
  535. sdkfit-0.5.0/tests/fixtures/specs/nullable-3.0.yaml +21 -0
  536. sdkfit-0.5.0/tests/fixtures/specs/nullable-3.1.yaml +20 -0
  537. sdkfit-0.5.0/tests/fixtures/specs/params-new.yaml +52 -0
  538. sdkfit-0.5.0/tests/fixtures/specs/params-old.yaml +52 -0
  539. sdkfit-0.5.0/tests/fixtures/specs/paths-new.yaml +29 -0
  540. sdkfit-0.5.0/tests/fixtures/specs/paths-old.yaml +33 -0
  541. sdkfit-0.5.0/tests/fixtures/specs/ref-chain.yaml +25 -0
  542. sdkfit-0.5.0/tests/fixtures/specs/ref-cycle.yaml +11 -0
  543. sdkfit-0.5.0/tests/fixtures/specs/ref-external.yaml +14 -0
  544. sdkfit-0.5.0/tests/fixtures/specs/ref-missing.yaml +9 -0
  545. sdkfit-0.5.0/tests/fixtures/specs/refs-new.yaml +37 -0
  546. sdkfit-0.5.0/tests/fixtures/specs/refs-old.yaml +37 -0
  547. sdkfit-0.5.0/tests/fixtures/specs/schemas-new.yaml +65 -0
  548. sdkfit-0.5.0/tests/fixtures/specs/schemas-old.yaml +63 -0
  549. sdkfit-0.5.0/tests/fixtures/specs/swagger-2.0.yaml +10 -0
  550. sdkfit-0.5.0/tests/fixtures/specs/twilio-lookups-2.0.0.json +1010 -0
  551. sdkfit-0.5.0/tests/fixtures/specs/twilio-lookups-2.10.0.json +3190 -0
  552. sdkfit-0.5.0/tests/fixtures/specs/unparseable.yaml +2 -0
  553. sdkfit-0.5.0/tests/locate/test_config.py +76 -0
  554. sdkfit-0.5.0/tests/locate/test_cross_file_helper.py +83 -0
  555. sdkfit-0.5.0/tests/locate/test_csharp_config.py +110 -0
  556. sdkfit-0.5.0/tests/locate/test_csharp_locate.py +571 -0
  557. sdkfit-0.5.0/tests/locate/test_csharp_scan.py +2659 -0
  558. sdkfit-0.5.0/tests/locate/test_go_config.py +120 -0
  559. sdkfit-0.5.0/tests/locate/test_go_locate.py +494 -0
  560. sdkfit-0.5.0/tests/locate/test_go_scan.py +1809 -0
  561. sdkfit-0.5.0/tests/locate/test_locate.py +651 -0
  562. sdkfit-0.5.0/tests/locate/test_mcp_locate.py +586 -0
  563. sdkfit-0.5.0/tests/locate/test_mcp_scan.py +300 -0
  564. sdkfit-0.5.0/tests/locate/test_parameter_helper.py +72 -0
  565. sdkfit-0.5.0/tests/locate/test_query.py +704 -0
  566. sdkfit-0.5.0/tests/locate/test_real_stripe_template.py +92 -0
  567. sdkfit-0.5.0/tests/locate/test_resolve.py +549 -0
  568. sdkfit-0.5.0/tests/locate/test_result.py +328 -0
  569. sdkfit-0.5.0/tests/locate/test_rust_config.py +93 -0
  570. sdkfit-0.5.0/tests/locate/test_rust_locate.py +441 -0
  571. sdkfit-0.5.0/tests/locate/test_rust_scan.py +1924 -0
  572. sdkfit-0.5.0/tests/locate/test_scan.py +1496 -0
  573. sdkfit-0.5.0/tests/locate/test_stripe_shape.py +76 -0
  574. sdkfit-0.5.0/tests/locate/test_ts_config.py +176 -0
  575. sdkfit-0.5.0/tests/locate/test_ts_locate.py +609 -0
  576. sdkfit-0.5.0/tests/locate/test_ts_scan.py +1867 -0
  577. sdkfit-0.5.0/tests/locate/test_typed_helper.py +79 -0
  578. sdkfit-0.5.0/tests/pr/__init__.py +0 -0
  579. sdkfit-0.5.0/tests/pr/conftest.py +184 -0
  580. sdkfit-0.5.0/tests/pr/test_app_remote.py +352 -0
  581. sdkfit-0.5.0/tests/pr/test_app_token.py +313 -0
  582. sdkfit-0.5.0/tests/pr/test_installed.py +387 -0
  583. sdkfit-0.5.0/tests/pr/test_remote.py +253 -0
  584. sdkfit-0.5.0/tests/pr/test_render.py +829 -0
  585. sdkfit-0.5.0/tests/pr/test_result.py +362 -0
  586. sdkfit-0.5.0/tests/pr/test_write.py +791 -0
  587. sdkfit-0.5.0/tests/probe/__init__.py +0 -0
  588. sdkfit-0.5.0/tests/probe/test_agent.py +130 -0
  589. sdkfit-0.5.0/tests/probe/test_client.py +229 -0
  590. sdkfit-0.5.0/tests/probe/test_run.py +430 -0
  591. sdkfit-0.5.0/tests/probe/test_tasks.py +155 -0
  592. sdkfit-0.5.0/tests/propose/__init__.py +0 -0
  593. sdkfit-0.5.0/tests/propose/test_propose.py +381 -0
  594. sdkfit-0.5.0/tests/propose/test_render.py +209 -0
  595. sdkfit-0.5.0/tests/propose/test_result.py +369 -0
  596. sdkfit-0.5.0/tests/propose/test_rules.py +189 -0
  597. sdkfit-0.5.0/tests/propose/test_seam.py +105 -0
  598. sdkfit-0.5.0/tests/prove/__init__.py +0 -0
  599. sdkfit-0.5.0/tests/prove/test_copy.py +236 -0
  600. sdkfit-0.5.0/tests/prove/test_plan.py +576 -0
  601. sdkfit-0.5.0/tests/prove/test_prove.py +377 -0
  602. sdkfit-0.5.0/tests/prove/test_result.py +594 -0
  603. sdkfit-0.5.0/tests/prove/test_run.py +121 -0
  604. sdkfit-0.5.0/tests/provider/test_bundle.py +606 -0
  605. sdkfit-0.5.0/tests/provider/test_repos.py +132 -0
  606. sdkfit-0.5.0/tests/service/test_api.py +886 -0
  607. sdkfit-0.5.0/tests/service/test_deploy.py +216 -0
  608. sdkfit-0.5.0/tests/service/test_http.py +60 -0
  609. sdkfit-0.5.0/tests/service/test_postgres.py +469 -0
  610. sdkfit-0.5.0/tests/service/test_runner.py +306 -0
  611. sdkfit-0.5.0/tests/service/test_service.py +140 -0
  612. sdkfit-0.5.0/tests/service/test_store.py +918 -0
  613. sdkfit-0.5.0/tests/service/test_triggers.py +79 -0
  614. sdkfit-0.5.0/tests/service/test_worker.py +291 -0
  615. sdkfit-0.5.0/tests/test_brand.py +53 -0
  616. sdkfit-0.5.0/tests/test_ci.py +145 -0
  617. sdkfit-0.5.0/tests/test_k8s.py +220 -0
  618. sdkfit-0.5.0/tests/test_launch.py +79 -0
  619. sdkfit-0.5.0/tests/test_release.py +124 -0
  620. sdkfit-0.5.0/uv.lock +573 -0
@@ -0,0 +1,96 @@
1
+ ---
2
+ name: prd-generator
3
+ description: Generate, critique, and refine PRDs, spec files, and roadmaps for initiative-level planning. Use to pressure-test and strengthen a PRD before planning. Triggers on "prd-generator", "prd generator".
4
+ tags:
5
+ - documentation
6
+ - planning
7
+ metadata:
8
+ status: trial
9
+ ---
10
+
11
+ # PRD Generator
12
+
13
+ ## Philosophy
14
+
15
+ Framework-neutral. Present multiple applicable frameworks with tradeoffs, let the user choose.
16
+ Default to **critical feedback over validation**.
17
+
18
+ ## Context
19
+
20
+ In the `tenon-begin-fast` pipeline this is Phase 4: refine and self-critique the `prd.md` that
21
+ `prd-interview` produced, then surface gaps before the review gate.
22
+
23
+ ## Capabilities
24
+
25
+ | Capability | Trigger Phrases | Output |
26
+ |-----------|----------------|--------|
27
+ | **Critique PRDs/Specs** | "review my PRD", "what's missing" | Structured critique with severity ratings |
28
+ | **Generate PRDs** | "write a PRD for" | Complete PRD document |
29
+ | **Coach on Frameworks** | "how should I prioritize" | Framework comparison |
30
+ | **Review Roadmaps** | "review my roadmap" | Prioritization analysis |
31
+
32
+ ## Workflow 1: Critique PRDs/Specs
33
+
34
+ Read the full document first. Score each dimension 🔴/🟡/🟢:
35
+
36
+ 1. **Problem Definition**
37
+ 2. **User Understanding**
38
+ 3. **Success Metrics**
39
+ 4. **Scope Clarity**
40
+ 5. **Edge Cases & Risks**
41
+ 6. **Stakeholder Alignment**
42
+ 7. **Feasibility Signal**
43
+ 8. **Proof Honesty** *(Tenon-specific)* — Does the work keep the user's own checks as the only
44
+ thing that decides the proof level? Is `UNVERIFIED` used honestly when no acceptable proof
45
+ ran? Does any PR state the level it actually reached, never implying "verified" when it only
46
+ type-checked?
47
+
48
+ Identify the top 3 gaps. End with ONE pointed question the author probably hasn't considered.
49
+
50
+ ## Workflow 2: Generate PRDs
51
+
52
+ Gather inputs. Select depth (Lightweight Brief / Standard PRD / Full Spec). Problem Statement →
53
+ Goals & Success Metrics → Users & Scenarios → Requirements → Technical Considerations (incl.
54
+ proof-contract impact) → Risks & Mitigations → Out of Scope.
55
+
56
+ Always include explicit assumptions, open questions, a Risks & Mitigations section. Reference
57
+ `R1`..`R8` and the capability (`T1`..`T11`).
58
+
59
+ Self-critique with Workflow 1 against your own output.
60
+
61
+ ## Workflow 3: Coach on Frameworks
62
+
63
+ RICE, ICE, MoSCoW, Kano, Weighted Scoring, Cost of Delay/WSJF; JTBD, Opportunity Solution Trees;
64
+ Porter's Five Forces, Wardley Mapping; TAM/SAM/SOM, Fermi estimation.
65
+
66
+ ## Workflow 4: Review Roadmaps & Prioritization
67
+
68
+ | Approach | Optimizes For | Tradeoff |
69
+ |----------|--------------|----------|
70
+ | **Impact-first** | Maximum outcome per unit time | May defer foundational work |
71
+ | **De-risk first** | Reduce uncertainty early | Slower visible progress |
72
+ | **Quick wins first** | Momentum | May delay strategic bets |
73
+ | **Dependencies-first** | Unblock parallel work | Front-loads less exciting work |
74
+
75
+ ## Visual-First Preview
76
+
77
+ ```
78
+ PRD: {slug}
79
+ ├─ Problem ........... {one line}
80
+ ├─ Goals/Metrics ..... {one line}
81
+ ├─ Users/Scenarios ... {one line}
82
+ ├─ Requirements ...... must:{n} should:{n} nice:{n}
83
+ ├─ Technical ......... {proof-contract impact in a phrase}
84
+ ├─ Risks ............. {top risk}
85
+ └─ Out of scope ...... {one line}
86
+ ```
87
+
88
+ ## Anti-Patterns (Never Do These)
89
+
90
+ 1. Never just validate.
91
+ 2. Never prescribe a single framework.
92
+ 3. Never generate a PRD without flagging its own gaps.
93
+ 4. Never give generic advice.
94
+ 5. Never skip the hard question.
95
+ 6. **Never wave through a PR that claims "verified" without stating the proof level it actually
96
+ reached** — a model-proposed patch presented as fixed with no check run is a 🔴.
@@ -0,0 +1,102 @@
1
+ ---
2
+ name: prd-interview
3
+ description: Conduct a collaborative product requirements interview between PM and engineering. Use when turning a brief or feature idea into a structured PRD and aspect-level specs through guided discovery and pressure-testing. Triggers on "prd interview", "requirements interview", "prd-interview".
4
+ tags:
5
+ - documentation
6
+ - planning
7
+ metadata:
8
+ status: trial
9
+ ---
10
+
11
+ # PRD Interview
12
+
13
+ Conduct a structured product requirements interview to turn a brief or feature idea into a complete PRD.
14
+ This is a collaborative exercise — the PM hat brings product context, the engineering hat brings technical reality.
15
+ Challenge assumptions. Pressure-test scope. Document what survives.
16
+
17
+ Do not create files until the Document phase.
18
+ If the tool supports a read-only or plan mode, switch to it now.
19
+
20
+ ## Context
21
+
22
+ This skill is the first step in the brief-to-code pipeline (it's Phase 3 of `tenon-begin-fast`).
23
+ Output is a structured PRD plus aspect-level specs that feed directly into `tech-plan`.
24
+
25
+ **Tenon guardrail:** before documenting, sanity-check the work against `CLAUDE.md`. The moat is
26
+ detecting a change from a machine-readable source, locating the affected calls, and **proving**
27
+ the fix against a check the user trusts. It is **not** a model drafting a plausible patch and
28
+ calling it done. If requirements drift toward "the model wrote it, so it's fixed," flag it in the
29
+ interview, not after.
30
+
31
+ ## Discover & Challenge
32
+
33
+ Read the user's input. Read key files: Tenon is **greenfield** — today that means
34
+ `docs/technical/CAPABILITY_ROADMAP.md` (T1..T11), `docs/technical/ARCHITECTURE.md`, and
35
+ `docs/ROADMAP.md`, plus `src/tenon/` once it exists.
36
+
37
+ Then pressure-test. Do not soften these.
38
+
39
+ - "What happens if we don't build this?"
40
+ - "Imagine this launched 6 months ago and failed. What went wrong?"
41
+ - "What are we choosing NOT to build if we build this?"
42
+
43
+ Fill remaining gaps with focused questions, 2-3 at a time:
44
+
45
+ - **Users & Problem**: Who has this problem? Cost of the status quo?
46
+ - **Success**: How measured? Target numbers?
47
+ - **Scope**: Explicitly out of scope?
48
+ - **Requirements**: Must/should/nice?
49
+ - **Technical Fit**: Which capability (`T1`..`T11`) and phase? Dependencies built?
50
+ - **Proof impact**: Does this keep the user's own checks as the only thing that decides the
51
+ proof level? Is the PR honest about which level it reached? What's the `UNVERIFIED` path when
52
+ no acceptable proof can run?
53
+
54
+ **Stop when** the problem is clear, success metrics are measurable, must-haves have testable
55
+ criteria, out-of-scope is explicit, and major technical risks are identified.
56
+
57
+ ## Confirm
58
+
59
+ Summarize and confirm the feature slug (kebab-case, e.g. `openapi-differ`). Do not name the
60
+ slug `<type>-<id>`.
61
+
62
+ ## Document
63
+
64
+ **Filename:** `prd.md`
65
+ **Location:** `docs/planning/{slug}/`.
66
+
67
+ ```
68
+ docs/planning/{slug}/
69
+ ├── prd.md
70
+ ├── {aspect}/
71
+ │ ├── spec.md
72
+ │ ├── plan_YYYYMMDD.md
73
+ │ └── ...
74
+ └── ...
75
+ ```
76
+
77
+ ### PRD structure
78
+
79
+ - **Problem Statement**, **Goals & Success Metrics**, **User Personas & Scenarios** (Tenon ICP:
80
+ developers whose integrations break silently, teams who want proof before merging a migration),
81
+ **Requirements** (must/should/nice), **Technical Considerations** (name the `T`-capability, the
82
+ proof contract impact), **Risks & Open Questions** (reference `R1`..`R8`), **Out of Scope**.
83
+
84
+ Include when relevant: Change-Record Schema, Proof Contract, PR Format, Non-Functional Requirements.
85
+
86
+ After writing, surface open questions. Offer to continue into aspect decomposition.
87
+
88
+ ## Aspect Decomposition Mode
89
+
90
+ 1. Propose aspect candidates, each with a one-line boundary.
91
+ 2. Confirm aspect names (`kebab-case`).
92
+ 3. Write or update `docs/planning/{slug}/{aspect}/spec.md`.
93
+
94
+ Each `spec.md`: problem slice, in-scope requirements, out-of-scope boundaries, acceptance
95
+ criteria (testable), dependencies/sequencing, open questions/risks.
96
+
97
+ ## Edge Cases
98
+
99
+ - **Update existing PRD**: Read, ask what changed, update in place.
100
+ - **User says "just write it"**: Write from what you have, flag gaps, include one challenge question.
101
+ - **No brief exists**: Run full discovery from conversation.
102
+ - **Greenfield with no code to read**: Ground in the roadmap/design docs; say plainly no implementation exists yet.
@@ -0,0 +1,78 @@
1
+ ---
2
+ name: tech-plan
3
+ description: Create a phased technical implementation plan from planning artifacts in docs/planning (PRD + aspect spec). Use after prd-interview when ready to execute a specific aspect. Triggers on "tech plan", "implementation plan", "plan from PRD".
4
+ tags:
5
+ - planning
6
+ - documentation
7
+ metadata:
8
+ status: trial
9
+ ---
10
+
11
+ Create a phased technical implementation plan from planning artifacts under `docs/planning/{slug}/`.
12
+ This is Phase 5 of `tenon-begin-fast` — the plan it produces is executed in Phase 6 through the agents team under strict TDD.
13
+
14
+ If artifacts are in context, use them directly. Otherwise, search `docs/planning/*/prd.md` and
15
+ `docs/planning/*/*/spec.md`.
16
+
17
+ Tenon is **greenfield**: today the authoritative reading is `docs/technical/CAPABILITY_ROADMAP.md`
18
+ (T1..T11), `docs/technical/ARCHITECTURE.md`, and `docs/ROADMAP.md`; the engine lives under
19
+ `src/tenon/` once it exists.
20
+
21
+ ## Handoff Contract
22
+
23
+ - **Feature requirements source:** `docs/planning/{slug}/prd.md`
24
+ - **Aspect requirements source (preferred):** `docs/planning/{slug}/{aspect}/spec.md`
25
+ - **Plan output (required):** `docs/planning/{slug}/{aspect}/plan_YYYYMMDD.md`
26
+
27
+ ## Deliverables
28
+
29
+ ### 1. Project Setup Checklist
30
+
31
+ Directory/module structure under `src/tenon/`, `tests/`. Dependencies via `uv add`.
32
+ **Greenfield:** scaffold `pyproject.toml`/`uv.lock`/`src/` as part of the plan's first phase if
33
+ they don't exist — test-first still holds.
34
+
35
+ ### 2. Implementation Phases
36
+
37
+ Goal, Prerequisites, Files to create/modify, Validation (`uv run pytest <path>`), Commit message.
38
+
39
+ ### 3. File-by-File Build Order
40
+
41
+ Filepath, one-line purpose, key exports, dependencies.
42
+
43
+ ### 4. Testing Strategy
44
+
45
+ Unit tests mapped to phases, written first. **Start from the capability's acceptance intent** in
46
+ `CAPABILITY_ROADMAP.md` and the aspect `spec.md`. Tests are deterministic, **no network, no real
47
+ model call, no live API call** — any proposer or MCP probe sits behind an injectable seam with
48
+ recorded fixtures in CI.
49
+
50
+ ### 5. Environment & Determinism
51
+
52
+ Env vars (BYOK stays in `.env`, never committed). `uv sync`. A proof level must be
53
+ reconstructible from the recorded run alone.
54
+
55
+ ### 6. Edge Cases & Error Handling
56
+
57
+ Name the explicit `UNVERIFIED` cause for anything that fails to evaluate
58
+ (`NO_MACHINE_READABLE_CHANGE`, `AMBIGUOUS_CALL_SITE`, `NO_TESTS_FOUND`, `TESTS_FAILED_BEFORE`,
59
+ `PATCH_DID_NOT_APPLY`, `REQUIRED_LEVEL_UNREACHED`). A harness failure never silently becomes a
60
+ stronger proof level than it earned.
61
+
62
+ ### 7. Agent Execution Notes
63
+
64
+ Checkpoints for human review, iteration-prone areas, where the agent should ask for clarification.
65
+
66
+ ## Guidelines
67
+
68
+ - Be extremely explicit. Prefer small, testable increments.
69
+ - Don't plan work that lets a model's proposed patch stand in for a passed check — flag it
70
+ against `CLAUDE.md`'s wedge.
71
+ - Respect the build order: T2 needs T1; T3-T5 need T1+T2; T6-T8 widen reach; T10 needs T4-T9.
72
+
73
+ ## Edge Cases
74
+
75
+ - **Greenfield vs. existing codebase**: full setup for greenfield.
76
+ - **No aspect spec exists yet**: derive candidates, ask the user to choose, draft `spec.md`.
77
+ - **Incomplete PRD**: flag it, recommend `prd-interview`.
78
+ - **PRD with flagged gaps**: note in the plan, recommend resolution before the affected phase.
@@ -0,0 +1,55 @@
1
+ ---
2
+ name: tenon-begin
3
+ description: Use when starting work on a Tenon unit of work (a GitHub issue id or an inline brief) and you need stakeholder proposals (technical + non-technical PDFs with diagrams) before planning. Triggers on "tenon-begin", "tb", "tb bug 12", "tb feat openapi-differ", "begin full".
4
+ arguments: "type id"
5
+ ---
6
+
7
+ # Tenon Begin (Full Track)
8
+
9
+ ## Overview
10
+
11
+ Same pipeline as `tenon-begin-fast`, plus a **proposal phase**: diagrams and two
12
+ review PDFs for stakeholders, then an approval gate, then planning.
13
+
14
+ **Invocation:** `tb <type> <id>`.
15
+
16
+ ## Pipeline
17
+
18
+ **REQUIRED SUB-SKILL:** Use `tenon-begin-fast` for the base pipeline.
19
+
20
+ Run its **Phase 0 → Phase 4 and the ⛔ PRD review gate exactly as written.**
21
+
22
+ ### Phase A — Proposals (diagrams → PDFs)
23
+
24
+ See `references/proposals.md`.
25
+
26
+ 1. **Diagram** — `excalidraw`, saved to `docs/planning/{slug}/diagrams/*.excalidraw`.
27
+ 2. **Export** — `excalidraw-to-svg`.
28
+ 3. **Write two proposals** in `docs/planning/{slug}/proposals/`.
29
+ 4. **PDF** — `md-to-pdf`.
30
+
31
+ ### ⛔ Approval gate — STOP
32
+
33
+ ### Final phases — Plan & implement
34
+
35
+ Run `tenon-begin-fast`'s **Phase 5** then **Phase 6**.
36
+
37
+ ## Artifact layout
38
+
39
+ ```
40
+ docs/planning/
41
+ ├── _card/issue.md
42
+ ├── {slug}/prd.md
43
+ ├── {slug}/diagrams/*.excalidraw|.svg
44
+ ├── {slug}/proposals/<type>-<id>-technical-proposal.{md,pdf}
45
+ ├── {slug}/proposals/<type>-<id>-non-technical-proposal.{md,pdf}
46
+ └── {slug}/{aspect}/plan_*.md
47
+ ```
48
+
49
+ ## Common mistakes
50
+
51
+ | Mistake | Fix |
52
+ |---|---|
53
+ | Writing proposals before the PRD is approved | Phase A starts only after the first ⛔ gate |
54
+ | One proposal for both audiences | Always two |
55
+ | Overstating what a PR proves | State the proof level it actually reached, never more |
@@ -0,0 +1,49 @@
1
+ # Phase A — Diagrams & proposal PDFs
2
+
3
+ ## 1. Diagrams (`excalidraw`)
4
+
5
+ Typical set for Tenon:
6
+
7
+ | Diagram | When to include |
8
+ |---|---|
9
+ | System / architecture | Almost always — where the change lives in detect → locate → propose → prove → PR |
10
+ | Data flow | A spec diff moves to a change record to a located call site |
11
+ | Sequence | Change detection, patch proposal, proof run, PR |
12
+ | State machine | A proof-level transition (`TESTS_PASSED`/`CHARACTERIZED`/`REPLAYED`/`TYPES_BUILD_ONLY`/`UNVERIFIED`) |
13
+
14
+ **Every text element must set `fontFamily: 2` (Helvetica).**
15
+
16
+ **Diagram the proof contract honestly.** Never draw a model's proposed patch as
17
+ already "verified" — only a passed check does that.
18
+
19
+ ## 2. Export to SVG (`excalidraw-to-svg`)
20
+
21
+ ## 3. Write the two proposals
22
+
23
+ ### `<type>-<id>-technical-proposal.md`
24
+
25
+ Summary, current state, proposed design, data/interface changes (change-record
26
+ schema, proof contract, PR format), risks/trade-offs, effort/sequencing
27
+ (reference the `T`-capability), open questions.
28
+
29
+ ### `<type>-<id>-non-technical-proposal.md`
30
+
31
+ The problem in plain language, what we'll do, why it matters (developers whose
32
+ integrations silently break), what changes for users, timeline, risks. Don't
33
+ imply a PR is safe beyond the proof level it reached.
34
+
35
+ ## 4. Convert to PDF (`md-to-pdf`)
36
+
37
+ ```bash
38
+ cd docs/planning/{slug}/proposals
39
+ PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
40
+ md-to-pdf <type>-<id>-technical-proposal.md --basedir ..
41
+ PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" \
42
+ md-to-pdf <type>-<id>-non-technical-proposal.md --basedir ..
43
+ ```
44
+
45
+ Verify: `pdftoppm -png -r 70 -f 1 -l 1 <type>-<id>-technical-proposal.pdf /tmp/check`
46
+
47
+ ## 5. Approval gate
48
+
49
+ Present both PDFs and stop.
@@ -0,0 +1,93 @@
1
+ ---
2
+ name: tenon-begin-fast
3
+ description: Use when starting work on a Tenon unit of work (a GitHub issue id or an inline brief) and you want the fast path straight to an implementation plan. Triggers on "tenon-begin-fast", "tbf", "tbf bug 12", "tbf feat openapi-differ", "begin fast".
4
+ arguments: "type id"
5
+ ---
6
+
7
+ # Tenon Begin (Fast Track)
8
+
9
+ ## Overview
10
+
11
+ Turn a single unit of work into shipped, test-driven code. The fast track is:
12
+ **isolate → gather → dig → PRD → plan → implement (TDD).** No proposal/diagram
13
+ deliverables (use `tenon-begin` / `tb` when you need those).
14
+
15
+ **Two non-negotiables:** always work through the agents team; implementation is
16
+ always test-first via `superpowers:test-driven-development`.
17
+
18
+ **Invocation:** `tbf <type> <id>` — e.g. `tbf bug 12`, `tbf feat openapi-differ`.
19
+
20
+ - `type` ∈ `bug | feat | feature | task | chore`.
21
+ - `id` = a GitHub issue number or a short descriptive slug.
22
+ - Owner is `aliz`.
23
+
24
+ ## Task source: GitHub issue, tolerate absence
25
+
26
+ The repo exists on GitHub but likely has no issues filed yet. Expect the fallback inline-brief path.
27
+
28
+ ## Pipeline
29
+
30
+ ### Phase 0 — Isolate in a worktree
31
+
32
+ **REQUIRED SUB-SKILL:** `tenon-worktrees`. Branch `<type>/<id>/aliz`, worktree dir
33
+ `.claude/worktrees/<type>-<id>`, created from `origin/master` (fall back to local
34
+ `master` if the remote ref isn't fetched).
35
+
36
+ ### Phase 1 — Gather context
37
+
38
+ Save a raw dump to `docs/planning/_card/issue.md`. If no issue, write the brief.
39
+
40
+ ### Phase 2 — Deep dig
41
+
42
+ - Map the relevant code paths. Tenon is **greenfield** — today that means
43
+ `docs/technical/CAPABILITY_ROADMAP.md` (T1..T11), `docs/technical/ARCHITECTURE.md`,
44
+ `docs/ROADMAP.md`. Once the engine exists it lives under `src/tenon/`.
45
+ - Honor `CLAUDE.md`: a model may *propose* a patch; only running the user's checks
46
+ decides the proof level. No "verified" PR without the level it actually reached.
47
+ Tenon never touches `master`, never merges.
48
+ - Place the work in the pipeline (T1 detect, T2 locate, T3 propose, T4 prove, T5
49
+ PR, T6 TS/JS locator, T7 proof ladder, T8 MCP/probe, T9 benchmark, T10 provider
50
+ layer, T11 more languages).
51
+
52
+ ### Phase 3 — Requirements interview
53
+
54
+ **REQUIRED SUB-SKILL:** `prd-interview`. Confirm a descriptive kebab-case slug.
55
+
56
+ ### Phase 4 — Generate & self-critique the PRD
57
+
58
+ **REQUIRED SUB-SKILL:** `prd-generator`.
59
+
60
+ ### ⛔ Review gate — STOP
61
+
62
+ ### Phase 5 — Implementation plan
63
+
64
+ **REQUIRED SUB-SKILL:** `tech-plan`.
65
+
66
+ ### Phase 6 — Implement (TDD, agents team)
67
+
68
+ **REQUIRED SUB-SKILL:** `superpowers:test-driven-development`,
69
+ `superpowers:subagent-driven-development`.
70
+
71
+ - `uv run pytest` after each task. Any model proposer sits behind an injectable
72
+ seam with recorded fixtures in CI — no real model call, no live API call.
73
+ - Commit per task on `<type>/<id>/aliz`.
74
+
75
+ ## Artifact layout
76
+
77
+ ```
78
+ docs/planning/
79
+ ├── _card/issue.md
80
+ ├── {slug}/prd.md
81
+ └── {slug}/{aspect}/plan_*.md
82
+ ```
83
+
84
+ ## Common mistakes
85
+
86
+ | Mistake | Fix |
87
+ |---|---|
88
+ | Working in the primary checkout | Create the Phase 0 worktree first |
89
+ | Branching from anything but `master` | Tenon's base branch is `master`; prefer `origin/master` |
90
+ | Treating a missing `pyproject.toml` as fatal | Greenfield — scaffold it, test-first |
91
+ | Skipping the review gate | PRD must be approved before tech-plan |
92
+ | Letting a model's patch stand in as proof | Stop and flag — only the proof runner decides |
93
+ | Opening a PR against `master` directly, or merging it | Never — Tenon proposes, humans merge |
@@ -0,0 +1,56 @@
1
+ # Gathering context with `gh` (tolerate absence)
2
+
3
+ Goal: dump the issue, its linked issues/PRs, and comments into
4
+ `docs/planning/_card/issue.md` inside the worktree.
5
+
6
+ ## Prerequisites
7
+
8
+ - GitHub CLI authenticated: `gh auth status`.
9
+ - Repo: `haqaliz/tenon` — the repo exists on GitHub, but likely has no issues filed
10
+ yet. A `FALLBACK` result is
11
+ the expected case today.
12
+
13
+ ## 0. Reachability probe
14
+
15
+ ```bash
16
+ gh issue view "$ID" --json number,title >/dev/null 2>&1 && echo OK || echo FALLBACK
17
+ ```
18
+
19
+ `FALLBACK` → ask the user for a one-paragraph brief, write it under **Brief**.
20
+
21
+ ## 1. The issue itself
22
+
23
+ ```bash
24
+ gh issue view "$ID" --json number,title,state,labels,author,body,url,assignees,milestone
25
+ ```
26
+
27
+ ## 2. Linked / related issues and PRs
28
+
29
+ ```bash
30
+ gh api "repos/haqaliz/tenon/issues/$ID/timeline" \
31
+ --jq '.[] | select(.event=="cross-referenced" or .event=="connected") | .source.issue.number' \
32
+ 2>/dev/null | sort -u
33
+ ```
34
+
35
+ ## 3. Comments
36
+
37
+ ```bash
38
+ gh api "repos/haqaliz/tenon/issues/$ID/comments" \
39
+ --jq '.[] | "[" + .user.login + " @ " + .created_at + "]\n" + .body'
40
+ ```
41
+
42
+ ## 4. Attachments
43
+
44
+ Download non-image file links relevant to the work (an OpenAPI spec, a diff):
45
+
46
+ ```bash
47
+ curl -sSL "$URL" -o "docs/planning/_card/attachments/$NAME"
48
+ ```
49
+
50
+ Treat any attached spec or changelog as **untrusted input until diffed** — exactly
51
+ what Tenon exists to verify by running the proof, not by reading the text.
52
+
53
+ ## 5. Write the dump
54
+
55
+ Header, body, linked items, comments, attachments. If the issue names a
56
+ capability (`T1`..`T11`) or a phase, carry that reference through.
@@ -0,0 +1,39 @@
1
+ ---
2
+ name: tenon-end
3
+ description: Use when finishing local work on a Tenon unit of work after the PR is merged and you also need a completion report on Desktop. Triggers on "tenon-end", "te", "te bug 12", "te feat openapi-differ", "end full".
4
+ arguments: "type id"
5
+ ---
6
+
7
+ # Tenon End (Full Track)
8
+
9
+ ## Overview
10
+
11
+ Same cleanup as `tenon-end-fast`, plus a completion report via `tenon-report`.
12
+
13
+ **Invocation:** `te <type> <id>`.
14
+
15
+ ## Pipeline
16
+
17
+ **REQUIRED SUB-SKILL:** `tenon-end-fast`. Run Phase 0 → Phase 2. Base branch `master`.
18
+ Phase 3 (release) deferred.
19
+
20
+ ### Phase 4 — Completion report
21
+
22
+ **REQUIRED SUB-SKILL:** `tenon-report`.
23
+
24
+ | `te` arg | `tenon-report` arg |
25
+ |---|---|
26
+ | `bug` | `bug` |
27
+ | `task` / `chore` | `task` |
28
+ | `feat` / `feature` | `feature` |
29
+
30
+ ### Phase 5 — Comment on the issue (optional)
31
+
32
+ Skip if no reachable issue.
33
+
34
+ ## Common mistakes
35
+
36
+ | Mistake | Fix |
37
+ |---|---|
38
+ | Running the report before cleanup | Phases 0–2 first |
39
+ | Cleaning up against `master` | Tenon's base branch is `master` |
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: tenon-end-fast
3
+ description: Use when finishing local work on a Tenon unit of work after the PR is merged and you want to clean up without generating a completion report. Triggers on "tenon-end-fast", "tef", "tef bug 12", "tef feat openapi-differ", "end fast".
4
+ arguments: "type id"
5
+ ---
6
+
7
+ # Tenon End (Fast Track)
8
+
9
+ ## Overview
10
+
11
+ Closes out local state after the PR merged: **master → pull → remove worktree →
12
+ delete branch**, with release deferred. No report (use `tenon-end` / `te` for that).
13
+
14
+ **Invocation:** `tef <type> <id>`.
15
+
16
+ Tenon's base branch is **`master`**.
17
+
18
+ ## Pipeline
19
+
20
+ ### Phase 0 — Safety check
21
+
22
+ - Worktree clean: `git -C <worktree> status --porcelain` empty.
23
+ - Branch merged; `git branch -d` refuses otherwise — don't bypass with `-D` without OK.
24
+
25
+ ### Phase 1 — Main, pulled
26
+
27
+ ```bash
28
+ PRIMARY=$(git worktree list | head -1 | awk '{print $1}')
29
+ git -C "$PRIMARY" checkout master
30
+ git -C "$PRIMARY" pull --ff-only origin master
31
+ ```
32
+
33
+ ### Phase 2 — Remove worktree, delete branch
34
+
35
+ ```bash
36
+ git -C "$PRIMARY" worktree remove ".claude/worktrees/<type>-<id>"
37
+ git -C "$PRIMARY" branch -d "<type>/<id>/aliz"
38
+ ```
39
+
40
+ ### Phase 3 — Release (DEFERRED)
41
+
42
+ **Tenon has no release machinery yet.** Cleanup ends at Phase 2. When it lands:
43
+ `feat` → minor, `bug`/`chore`/`task` → patch; CI green before tagging; tag and
44
+ push to trigger the workflow; verify each channel before calling it done.
45
+ Release identity: **haqaliz**. PyPI name: `tenon` taken, `tenonhq` free when checked.
46
+
47
+ ### Phase 4 — Comment on the issue (optional)
48
+
49
+ Ask first, draft, confirm, then `gh issue comment`.
50
+
51
+ ## Common mistakes
52
+
53
+ | Mistake | Fix |
54
+ |---|---|
55
+ | Checking out / pulling `master` | Tenon's base branch is `master` |
56
+ | Using `git pull` | Use `--ff-only` |
57
+ | Forcing branch delete | Only after explicit user OK |
58
+ | Cutting a release | Deferred |