framework-py 0.1.0.dev3__tar.gz → 0.1.0.dev5__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 (450) hide show
  1. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/PKG-INFO +14 -1
  2. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/README.md +13 -0
  3. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/parity.toml +13 -1
  4. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/pyproject.toml +1 -1
  5. framework_py-0.1.0.dev5/scripts/make_create_fixtures.py +127 -0
  6. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/scripts/sync_assets.py +10 -0
  7. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/__init__.py +7 -0
  8. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/__main__.py +64 -5
  9. framework_py-0.1.0.dev5/src/framework/_agents_md.py +210 -0
  10. framework_py-0.1.0.dev5/src/framework/_artifacts.py +930 -0
  11. framework_py-0.1.0.dev5/src/framework/_assets/adopt/rules.json +161 -0
  12. framework_py-0.1.0.dev5/src/framework/_assets/features/jupyter.json +39 -0
  13. framework_py-0.1.0.dev5/src/framework/_assets/features/quarto.json +18 -0
  14. framework_py-0.1.0.dev5/src/framework/_assets/features/quarto_manuscript.json +35 -0
  15. framework_py-0.1.0.dev5/src/framework/_assets/features/quarto_slides.json +29 -0
  16. framework_py-0.1.0.dev5/src/framework/_assets/features/renv.json +20 -0
  17. framework_py-0.1.0.dev5/src/framework/_assets/features/targets.json +34 -0
  18. framework_py-0.1.0.dev5/src/framework/_assets/features/uv.json +17 -0
  19. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_assets/schema/layer.v1.json +104 -7
  20. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_assets/schema/layers.v1.json +108 -7
  21. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_assets/schema/spec.v1.json +97 -7
  22. framework_py-0.1.0.dev5/src/framework/_assets/sets/packages/tidyverse-analysis.json +42 -0
  23. framework_py-0.1.0.dev5/src/framework/_assets/sets/skills/framework.json +25 -0
  24. framework_py-0.1.0.dev5/src/framework/_assets/sets/skills/ggplot2.json +26 -0
  25. framework_py-0.1.0.dev5/src/framework/_assets/workflows/jupyter.json +14 -0
  26. framework_py-0.1.0.dev5/src/framework/_assets/workflows/quarto.json +14 -0
  27. framework_py-0.1.0.dev5/src/framework/_assets/workflows/scripts.json +18 -0
  28. framework_py-0.1.0.dev5/src/framework/_defaults_cache.py +47 -0
  29. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_paths.py +19 -9
  30. framework_py-0.1.0.dev5/src/framework/adopt.py +365 -0
  31. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/ai.py +25 -24
  32. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/cloud.py +209 -21
  33. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/create.py +395 -18
  34. framework_py-0.1.0.dev5/src/framework/features.py +195 -0
  35. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/hooks.py +69 -7
  36. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/notebooks.py +9 -1
  37. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/outputs.py +6 -1
  38. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/quarto.py +77 -25
  39. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/scaffold.py +50 -3
  40. framework_py-0.1.0.dev5/src/framework/skill_sync.py +469 -0
  41. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/spec/check.py +32 -8
  42. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/spec/merge.py +1 -0
  43. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/spec/resolve.py +80 -6
  44. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/storage.py +154 -11
  45. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/defaults.yml +0 -1
  46. framework_py-0.1.0.dev5/src/framework/templates/skills/framework-data/.framework-skill.json +5 -0
  47. {framework_py-0.1.0.dev3/tests/golden/course/expected/.claude → framework_py-0.1.0.dev5/src/framework/templates}/skills/framework-data/SKILL.md +3 -0
  48. framework_py-0.1.0.dev5/src/framework/templates/skills/framework-outputs/.framework-skill.json +5 -0
  49. {framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/.agents → framework_py-0.1.0.dev5/src/framework/templates}/skills/framework-outputs/SKILL.md +3 -0
  50. framework_py-0.1.0.dev5/src/framework/templates/skills/framework-packages/.framework-skill.json +5 -0
  51. {framework_py-0.1.0.dev3/tests/golden/course/expected/.claude → framework_py-0.1.0.dev5/src/framework/templates}/skills/framework-packages/SKILL.md +3 -0
  52. framework_py-0.1.0.dev5/src/framework/templates/skills/framework-sensitive-data/.framework-skill.json +5 -0
  53. {framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/.claude → framework_py-0.1.0.dev5/src/framework/templates}/skills/framework-sensitive-data/SKILL.md +3 -0
  54. framework_py-0.1.0.dev5/src/framework/templates/skills/framework-workflow/.framework-skill.json +5 -0
  55. {framework_py-0.1.0.dev3/tests/golden/course/expected/.claude → framework_py-0.1.0.dev5/src/framework/templates}/skills/framework-workflow/SKILL.md +3 -0
  56. framework_py-0.1.0.dev5/tests/fixtures/skill-bundle-v1.json +20 -0
  57. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/bare/expected/.framework/spec.json +7 -1
  58. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/bare/expected/settings.yml +4 -1
  59. {framework_py-0.1.0.dev3/src/framework/templates → framework_py-0.1.0.dev5/tests/golden/course/expected/.claude}/skills/framework-data/SKILL.md +3 -0
  60. {framework_py-0.1.0.dev3/tests/golden/files-and-skills → framework_py-0.1.0.dev5/tests/golden/course}/expected/.claude/skills/framework-outputs/SKILL.md +3 -0
  61. {framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/.agents → framework_py-0.1.0.dev5/tests/golden/course/expected/.claude}/skills/framework-packages/SKILL.md +3 -0
  62. {framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/.agents → framework_py-0.1.0.dev5/tests/golden/course/expected/.claude}/skills/framework-workflow/SKILL.md +3 -0
  63. framework_py-0.1.0.dev5/tests/golden/course/expected/.framework/.gitignore +3 -0
  64. framework_py-0.1.0.dev5/tests/golden/course/expected/.framework/skills.lock.json +49 -0
  65. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/.framework/spec.json +8 -1
  66. framework_py-0.1.0.dev5/tests/golden/course/expected/AGENTS.md +68 -0
  67. framework_py-0.1.0.dev5/tests/golden/course/expected/_quarto.yml +17 -0
  68. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/settings.yml +4 -0
  69. framework_py-0.1.0.dev3/tests/golden/course/expected/slides/_quarto.yml → framework_py-0.1.0.dev5/tests/golden/course/expected/slides/_metadata.yml +0 -3
  70. {framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/.agents → framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/.claude}/skills/framework-data/SKILL.md +3 -0
  71. {framework_py-0.1.0.dev3/src/framework/templates → framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/.claude}/skills/framework-outputs/SKILL.md +3 -0
  72. {framework_py-0.1.0.dev3/src/framework/templates → framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/.claude}/skills/framework-packages/SKILL.md +3 -0
  73. {framework_py-0.1.0.dev3/src/framework/templates → framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/.claude}/skills/framework-workflow/SKILL.md +3 -0
  74. framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/.framework/.gitignore +3 -0
  75. framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/.framework/skills.lock.json +49 -0
  76. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/.framework/spec.json +8 -1
  77. framework_py-0.1.0.dev5/tests/golden/files-and-skills/expected/AGENTS.md +69 -0
  78. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/_quarto.yml +1 -0
  79. {framework_py-0.1.0.dev3/tests/golden/project → framework_py-0.1.0.dev5/tests/golden/files-and-skills}/expected/settings/scaffold.yml +1 -0
  80. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings.yml +3 -0
  81. {framework_py-0.1.0.dev3/tests/golden/files-and-skills/expected/.claude → framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/.agents}/skills/framework-data/SKILL.md +3 -0
  82. {framework_py-0.1.0.dev3/tests/golden/course/expected/.claude → framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/.agents}/skills/framework-outputs/SKILL.md +3 -0
  83. {framework_py-0.1.0.dev3/tests/golden/files-and-skills/expected/.claude → framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/.agents}/skills/framework-packages/SKILL.md +3 -0
  84. {framework_py-0.1.0.dev3/tests/golden/files-and-skills/expected/.claude → framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/.agents}/skills/framework-workflow/SKILL.md +3 -0
  85. framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/.framework/.gitignore +3 -0
  86. framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/.framework/skills.lock.json +49 -0
  87. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/.framework/spec.json +8 -1
  88. framework_py-0.1.0.dev5/tests/golden/no-assistants/expected/AGENTS.md +68 -0
  89. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/_quarto.yml +1 -0
  90. {framework_py-0.1.0.dev3/tests/golden/files-and-skills → framework_py-0.1.0.dev5/tests/golden/no-assistants}/expected/settings/scaffold.yml +1 -0
  91. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings.yml +3 -0
  92. framework_py-0.1.0.dev5/tests/golden/presentation/expected/.claude/skills/framework-data/SKILL.md +50 -0
  93. framework_py-0.1.0.dev5/tests/golden/presentation/expected/.claude/skills/framework-outputs/SKILL.md +71 -0
  94. framework_py-0.1.0.dev5/tests/golden/presentation/expected/.claude/skills/framework-packages/SKILL.md +36 -0
  95. framework_py-0.1.0.dev5/tests/golden/presentation/expected/.claude/skills/framework-workflow/SKILL.md +61 -0
  96. framework_py-0.1.0.dev5/tests/golden/presentation/expected/.framework/.gitignore +3 -0
  97. framework_py-0.1.0.dev5/tests/golden/presentation/expected/.framework/skills.lock.json +49 -0
  98. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/.framework/spec.json +8 -1
  99. framework_py-0.1.0.dev5/tests/golden/presentation/expected/AGENTS.md +65 -0
  100. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/settings.yml +4 -0
  101. framework_py-0.1.0.dev5/tests/golden/project/expected/.claude/skills/framework-data/SKILL.md +50 -0
  102. framework_py-0.1.0.dev5/tests/golden/project/expected/.claude/skills/framework-outputs/SKILL.md +71 -0
  103. framework_py-0.1.0.dev5/tests/golden/project/expected/.claude/skills/framework-packages/SKILL.md +36 -0
  104. framework_py-0.1.0.dev5/tests/golden/project/expected/.claude/skills/framework-workflow/SKILL.md +61 -0
  105. framework_py-0.1.0.dev5/tests/golden/project/expected/.framework/.gitignore +3 -0
  106. framework_py-0.1.0.dev5/tests/golden/project/expected/.framework/skills.lock.json +49 -0
  107. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/.framework/spec.json +8 -1
  108. framework_py-0.1.0.dev5/tests/golden/project/expected/AGENTS.md +68 -0
  109. {framework_py-0.1.0.dev3/tests/golden/project-sensitive → framework_py-0.1.0.dev5/tests/golden/project}/expected/_quarto.yml +1 -0
  110. {framework_py-0.1.0.dev3/tests/golden/project-sensitive → framework_py-0.1.0.dev5/tests/golden/project}/expected/settings/scaffold.yml +1 -0
  111. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings.yml +3 -0
  112. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/.claude/skills/framework-data/SKILL.md +50 -0
  113. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/.claude/skills/framework-outputs/SKILL.md +71 -0
  114. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/.claude/skills/framework-packages/SKILL.md +36 -0
  115. {framework_py-0.1.0.dev3/tests/golden/sensitive-facet → framework_py-0.1.0.dev5/tests/golden/project-sensitive}/expected/.claude/skills/framework-sensitive-data/SKILL.md +3 -0
  116. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/.claude/skills/framework-workflow/SKILL.md +61 -0
  117. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/.framework/.gitignore +3 -0
  118. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/.framework/skills.lock.json +60 -0
  119. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/.framework/spec.json +8 -1
  120. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/AGENTS.md +74 -0
  121. framework_py-0.1.0.dev5/tests/golden/project-sensitive/expected/_quarto.yml +17 -0
  122. {framework_py-0.1.0.dev3/tests/golden/no-assistants → framework_py-0.1.0.dev5/tests/golden/project-sensitive}/expected/settings/scaffold.yml +1 -0
  123. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings.yml +3 -0
  124. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/.agents/skills/framework-data/SKILL.md +50 -0
  125. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/.agents/skills/framework-outputs/SKILL.md +71 -0
  126. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/.agents/skills/framework-packages/SKILL.md +36 -0
  127. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/.agents/skills/framework-workflow/SKILL.md +61 -0
  128. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/.framework/.gitignore +3 -0
  129. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/.framework/skills.lock.json +49 -0
  130. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/.framework/spec.json +8 -1
  131. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/AGENTS.md +68 -0
  132. {framework_py-0.1.0.dev3/tests/golden/course → framework_py-0.1.0.dev5/tests/golden/removals-and-assistants}/expected/_quarto.yml +1 -0
  133. framework_py-0.1.0.dev5/tests/golden/removals-and-assistants/expected/settings/scaffold.yml +6 -0
  134. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings.yml +3 -0
  135. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.claude/skills/framework-data/SKILL.md +50 -0
  136. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.claude/skills/framework-outputs/SKILL.md +71 -0
  137. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.claude/skills/framework-packages/SKILL.md +36 -0
  138. {framework_py-0.1.0.dev3/src/framework/templates → framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.claude}/skills/framework-sensitive-data/SKILL.md +3 -0
  139. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.claude/skills/framework-workflow/SKILL.md +61 -0
  140. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.framework/.gitignore +3 -0
  141. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/.framework/skills.lock.json +60 -0
  142. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/.framework/spec.json +8 -1
  143. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/AGENTS.md +71 -0
  144. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/_quarto.yml +17 -0
  145. framework_py-0.1.0.dev5/tests/golden/sensitive-facet/expected/settings/scaffold.yml +6 -0
  146. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings.yml +3 -0
  147. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/shared/NAMESPACE +3 -0
  148. framework_py-0.1.0.dev5/tests/shared/conformance/README.md +123 -0
  149. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/case-insensitive.json +20 -0
  150. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/data-science-template.json +39 -0
  151. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/extra-keys.json +32 -0
  152. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/nested-under-matched.json +24 -0
  153. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/pattern-priority.json +26 -0
  154. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/private-paths.json +41 -0
  155. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/r-analysis.json +28 -0
  156. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/skip-and-depth.json +31 -0
  157. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/stata-folders-in-r.json +30 -0
  158. framework_py-0.1.0.dev5/tests/shared/conformance/adopt/stata.json +26 -0
  159. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/bare-jupyter.json +183 -0
  160. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/bare-quarto.json +154 -0
  161. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/bare-scripts.json +150 -0
  162. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/course-quarto.json +208 -0
  163. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/presentation-quarto.json +195 -0
  164. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-jupyter-both.json +255 -0
  165. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-jupyter-no-agents.json +244 -0
  166. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-jupyter-none.json +254 -0
  167. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-jupyter-rstudio.json +254 -0
  168. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-jupyter.json +255 -0
  169. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-quarto.json +226 -0
  170. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project-scripts.json +221 -0
  171. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project_sensitive-jupyter.json +274 -0
  172. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project_sensitive-quarto.json +245 -0
  173. framework_py-0.1.0.dev5/tests/shared/conformance/create/python/project_sensitive-scripts.json +239 -0
  174. framework_py-0.1.0.dev5/tests/shared/conformance/merge/tools-and-core-files.json +68 -0
  175. framework_py-0.1.0.dev5/tests/test_adopt.py +202 -0
  176. framework_py-0.1.0.dev5/tests/test_artifacts.py +640 -0
  177. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_cloud.py +371 -6
  178. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_conformance.py +28 -1
  179. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_create.py +12 -1
  180. framework_py-0.1.0.dev5/tests/test_features.py +221 -0
  181. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_global_config.py +5 -5
  182. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_hooks.py +34 -1
  183. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_outputs.py +16 -0
  184. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_package.py +1 -1
  185. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_pages.py +1 -1
  186. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_scaffold.py +24 -1
  187. framework_py-0.1.0.dev5/tests/test_skill_sync.py +136 -0
  188. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_storage.py +155 -3
  189. framework_py-0.1.0.dev3/tests/golden/course/expected/AGENTS.md +0 -8
  190. framework_py-0.1.0.dev3/tests/golden/course/expected/assignments/_quarto.yml +0 -16
  191. framework_py-0.1.0.dev3/tests/golden/course/expected/course_docs/_quarto.yml +0 -16
  192. framework_py-0.1.0.dev3/tests/golden/course/expected/modules/_quarto.yml +0 -16
  193. framework_py-0.1.0.dev3/tests/golden/files-and-skills/expected/AGENTS.md +0 -8
  194. framework_py-0.1.0.dev3/tests/golden/files-and-skills/expected/docs/_quarto.yml +0 -16
  195. framework_py-0.1.0.dev3/tests/golden/files-and-skills/expected/notebooks/_quarto.yml +0 -16
  196. framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/AGENTS.md +0 -8
  197. framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/docs/_quarto.yml +0 -16
  198. framework_py-0.1.0.dev3/tests/golden/no-assistants/expected/notebooks/_quarto.yml +0 -16
  199. framework_py-0.1.0.dev3/tests/golden/presentation/expected/.claude/skills/framework-data/SKILL.md +0 -47
  200. framework_py-0.1.0.dev3/tests/golden/presentation/expected/.claude/skills/framework-outputs/SKILL.md +0 -68
  201. framework_py-0.1.0.dev3/tests/golden/presentation/expected/.claude/skills/framework-packages/SKILL.md +0 -33
  202. framework_py-0.1.0.dev3/tests/golden/presentation/expected/.claude/skills/framework-workflow/SKILL.md +0 -58
  203. framework_py-0.1.0.dev3/tests/golden/presentation/expected/AGENTS.md +0 -8
  204. framework_py-0.1.0.dev3/tests/golden/project/expected/.claude/skills/framework-data/SKILL.md +0 -47
  205. framework_py-0.1.0.dev3/tests/golden/project/expected/.claude/skills/framework-outputs/SKILL.md +0 -68
  206. framework_py-0.1.0.dev3/tests/golden/project/expected/.claude/skills/framework-packages/SKILL.md +0 -33
  207. framework_py-0.1.0.dev3/tests/golden/project/expected/.claude/skills/framework-workflow/SKILL.md +0 -58
  208. framework_py-0.1.0.dev3/tests/golden/project/expected/AGENTS.md +0 -8
  209. framework_py-0.1.0.dev3/tests/golden/project/expected/_quarto.yml +0 -16
  210. framework_py-0.1.0.dev3/tests/golden/project/expected/docs/_quarto.yml +0 -16
  211. framework_py-0.1.0.dev3/tests/golden/project/expected/notebooks/_quarto.yml +0 -16
  212. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/.claude/skills/framework-data/SKILL.md +0 -47
  213. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/.claude/skills/framework-outputs/SKILL.md +0 -68
  214. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/.claude/skills/framework-packages/SKILL.md +0 -33
  215. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/.claude/skills/framework-workflow/SKILL.md +0 -58
  216. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/AGENTS.md +0 -10
  217. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/docs/_quarto.yml +0 -16
  218. framework_py-0.1.0.dev3/tests/golden/project-sensitive/expected/notebooks/_quarto.yml +0 -16
  219. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/.agents/skills/framework-data/SKILL.md +0 -47
  220. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/.agents/skills/framework-outputs/SKILL.md +0 -68
  221. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/.agents/skills/framework-packages/SKILL.md +0 -33
  222. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/.agents/skills/framework-workflow/SKILL.md +0 -58
  223. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/AGENTS.md +0 -8
  224. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/_quarto.yml +0 -16
  225. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/docs/_quarto.yml +0 -16
  226. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/notebooks/_quarto.yml +0 -16
  227. framework_py-0.1.0.dev3/tests/golden/removals-and-assistants/expected/settings/scaffold.yml +0 -5
  228. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/.claude/skills/framework-data/SKILL.md +0 -47
  229. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/.claude/skills/framework-outputs/SKILL.md +0 -68
  230. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/.claude/skills/framework-packages/SKILL.md +0 -33
  231. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/.claude/skills/framework-workflow/SKILL.md +0 -58
  232. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/AGENTS.md +0 -10
  233. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/_quarto.yml +0 -16
  234. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/docs/_quarto.yml +0 -16
  235. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/notebooks/_quarto.yml +0 -16
  236. framework_py-0.1.0.dev3/tests/golden/sensitive-facet/expected/settings/scaffold.yml +0 -5
  237. framework_py-0.1.0.dev3/tests/shared/conformance/README.md +0 -34
  238. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/.gitignore +0 -0
  239. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/LICENSE +0 -0
  240. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/scripts/__init__.py +0 -0
  241. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/scripts/build_docs.py +0 -0
  242. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/scripts/check_parity.py +0 -0
  243. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/scripts/make_golden_trees.py +0 -0
  244. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/scripts/make_r_fixtures.R +0 -0
  245. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_assets/hooks/pre-commit +0 -0
  246. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_assets/init.sql +0 -0
  247. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_assets/schema/docs-reference.v1.json +0 -0
  248. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_log.py +0 -0
  249. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_pages.py +0 -0
  250. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_private.py +0 -0
  251. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_secretservice.py +0 -0
  252. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_time.py +0 -0
  253. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_wincred.py +0 -0
  254. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/_yaml.py +0 -0
  255. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/bootstrap.py +0 -0
  256. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/cache.py +0 -0
  257. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/catalog.py +0 -0
  258. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/config_home.py +0 -0
  259. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/connections.py +0 -0
  260. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/console.py +0 -0
  261. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/data.py +0 -0
  262. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/db.py +0 -0
  263. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/dotenv.py +0 -0
  264. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/errors.py +0 -0
  265. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/global_config.py +0 -0
  266. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/integrity.py +0 -0
  267. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/packages.py +0 -0
  268. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/project.py +0 -0
  269. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/py.typed +0 -0
  270. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/scratch.py +0 -0
  271. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/security.py +0 -0
  272. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/settings.py +0 -0
  273. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/spec/__init__.py +0 -0
  274. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/gitignore/course +0 -0
  275. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/gitignore/presentation +0 -0
  276. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/gitignore/project +0 -0
  277. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/gitignore/sensitive +0 -0
  278. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/stubs/notebook-default.ipynb +0 -0
  279. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/stubs/notebook-default.qmd +0 -0
  280. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/stubs/notebook-minimal.qmd +0 -0
  281. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/stubs/notebook-revealjs.qmd +0 -0
  282. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/src/framework/templates/stubs/script-default.py +0 -0
  283. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/__init__.py +0 -0
  284. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/conftest.py +0 -0
  285. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.claude/skills/framework-data/SKILL.md +0 -0
  286. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.claude/skills/framework-outputs/SKILL.md +0 -0
  287. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.claude/skills/framework-packages/SKILL.md +0 -0
  288. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.claude/skills/framework-workflow/SKILL.md +0 -0
  289. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.env +0 -0
  290. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.framework/spec.json +0 -0
  291. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/.gitignore +0 -0
  292. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/AGENTS.md +0 -0
  293. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/CLAUDE.md +0 -0
  294. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/_quarto.yml +0 -0
  295. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/docs/_quarto.yml +0 -0
  296. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/fixture-study.Rproj +0 -0
  297. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/fixture-study.code-workspace +0 -0
  298. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/framework.db +0 -0
  299. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/intermediate/r_clean.csv +0 -0
  300. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/private/ids.csv +0 -0
  301. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/raw/survey.csv +0 -0
  302. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/raw/visits.tsv +0 -0
  303. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/reference/test.dta +0 -0
  304. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/reference/test.sav +0 -0
  305. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/inputs/reference/test.xpt +0 -0
  306. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/notebooks/_quarto.yml +0 -0
  307. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/outputs/cache/r_value.rds +0 -0
  308. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/outputs/tables/r_summary.csv +0 -0
  309. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/scaffold.R +0 -0
  310. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/ai.yml +0 -0
  311. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/author.yml +0 -0
  312. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/connections.yml +0 -0
  313. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/data.yml +0 -0
  314. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/git.yml +0 -0
  315. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/packages.yml +0 -0
  316. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/quarto.yml +0 -0
  317. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings/scaffold.yml +0 -0
  318. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project/settings.yml +0 -0
  319. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/fixtures/r_project.expected.json +0 -0
  320. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/bare/expected/.gitignore +0 -0
  321. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/bare/expected/pyproject.toml +0 -0
  322. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/bare/layers.json +0 -0
  323. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/.env +0 -0
  324. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/.gitignore +0 -0
  325. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/CLAUDE.md +0 -0
  326. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/golden-course.code-workspace +0 -0
  327. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/pyproject.toml +0 -0
  328. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/expected/scaffold.py +0 -0
  329. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/course/layers.json +0 -0
  330. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/.claude/skills/study-protocol/SKILL.md +0 -0
  331. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/.claude/skills/study-protocol/references/consort.md +0 -0
  332. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/.env +0 -0
  333. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/.gitignore +0 -0
  334. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/CLAUDE.md +0 -0
  335. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/README.md +0 -0
  336. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/golden-files-and-skills.code-workspace +0 -0
  337. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/notes.md +0 -0
  338. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/pyproject.toml +0 -0
  339. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/scaffold.py +0 -0
  340. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings/ai.yml +0 -0
  341. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings/author.yml +0 -0
  342. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings/connections.yml +0 -0
  343. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings/data.yml +0 -0
  344. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings/git.yml +0 -0
  345. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/expected/settings/quarto.yml +0 -0
  346. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/files-and-skills/layers.json +0 -0
  347. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/.env +0 -0
  348. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/.gitignore +0 -0
  349. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/golden-no-assistants.code-workspace +0 -0
  350. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/pyproject.toml +0 -0
  351. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/scaffold.py +0 -0
  352. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings/ai.yml +0 -0
  353. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings/author.yml +0 -0
  354. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings/connections.yml +0 -0
  355. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings/data.yml +0 -0
  356. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings/git.yml +0 -0
  357. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/expected/settings/quarto.yml +0 -0
  358. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/no-assistants/layers.json +0 -0
  359. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/.env +0 -0
  360. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/.gitignore +0 -0
  361. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/CLAUDE.md +0 -0
  362. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/_quarto.yml +0 -0
  363. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/golden-presentation.code-workspace +0 -0
  364. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/presentation.qmd +0 -0
  365. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/pyproject.toml +0 -0
  366. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/expected/scaffold.py +0 -0
  367. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/presentation/layers.json +0 -0
  368. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/.env +0 -0
  369. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/.gitignore +0 -0
  370. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/CLAUDE.md +0 -0
  371. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/golden-project.code-workspace +0 -0
  372. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/pyproject.toml +0 -0
  373. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/scaffold.py +0 -0
  374. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings/ai.yml +0 -0
  375. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings/author.yml +0 -0
  376. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings/connections.yml +0 -0
  377. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings/data.yml +0 -0
  378. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings/git.yml +0 -0
  379. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/expected/settings/quarto.yml +0 -0
  380. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project/layers.json +0 -0
  381. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/.claude/settings.json +0 -0
  382. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/.env +0 -0
  383. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/.gitignore +0 -0
  384. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/CLAUDE.md +0 -0
  385. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/golden-project-sensitive.code-workspace +0 -0
  386. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/pyproject.toml +0 -0
  387. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/scaffold.py +0 -0
  388. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings/ai.yml +0 -0
  389. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings/author.yml +0 -0
  390. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings/connections.yml +0 -0
  391. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings/data.yml +0 -0
  392. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings/git.yml +0 -0
  393. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/expected/settings/quarto.yml +0 -0
  394. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/project-sensitive/layers.json +0 -0
  395. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/.env +0 -0
  396. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/.github/copilot-instructions.md +0 -0
  397. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/.gitignore +0 -0
  398. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/golden-removals-and-assistants.code-workspace +0 -0
  399. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/pyproject.toml +0 -0
  400. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/scaffold.py +0 -0
  401. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings/ai.yml +0 -0
  402. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings/author.yml +0 -0
  403. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings/connections.yml +0 -0
  404. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings/data.yml +0 -0
  405. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings/git.yml +0 -0
  406. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/expected/settings/quarto.yml +0 -0
  407. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/removals-and-assistants/layers.json +0 -0
  408. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/.claude/settings.json +0 -0
  409. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/.env +0 -0
  410. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/.gitignore +0 -0
  411. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/CLAUDE.md +0 -0
  412. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/golden-sensitive-facet.code-workspace +0 -0
  413. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/pyproject.toml +0 -0
  414. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/scaffold.py +0 -0
  415. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings/ai.yml +0 -0
  416. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings/author.yml +0 -0
  417. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings/connections.yml +0 -0
  418. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings/data.yml +0 -0
  419. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings/git.yml +0 -0
  420. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/expected/settings/quarto.yml +0 -0
  421. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/golden/sensitive-facet/layers.json +0 -0
  422. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/compose.yml +0 -0
  423. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/mariadb/init.sql +0 -0
  424. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/mysql/init.sql +0 -0
  425. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/postgres/init.sql +0 -0
  426. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/sqlserver/init.sql +0 -0
  427. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/test_cloud_staging.py +0 -0
  428. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/integration/test_servers.py +0 -0
  429. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/shared/conformance/merge/atomic-entries.json +0 -0
  430. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/shared/conformance/merge/conflicts-and-labels.json +0 -0
  431. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/shared/conformance/merge/empty-sections.json +0 -0
  432. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/shared/conformance/merge/gitignore-and-assistants.json +0 -0
  433. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/shared/conformance/merge/maps-and-null-removal.json +0 -0
  434. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_bootstrap.py +0 -0
  435. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_cache.py +0 -0
  436. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_catalog.py +0 -0
  437. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_config_home.py +0 -0
  438. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_connections.py +0 -0
  439. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_data.py +0 -0
  440. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_db.py +0 -0
  441. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_docs_site.py +0 -0
  442. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_dotenv.py +0 -0
  443. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_notebooks.py +0 -0
  444. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_packages.py +0 -0
  445. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_private.py +0 -0
  446. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_r_compat.py +0 -0
  447. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_r_live.py +0 -0
  448. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_secretservice.py +0 -0
  449. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_security.py +0 -0
  450. {framework_py-0.1.0.dev3 → framework_py-0.1.0.dev5}/tests/test_settings.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: framework-py
3
- Version: 0.1.0.dev3
3
+ Version: 0.1.0.dev5
4
4
  Summary: Structured data science projects: a data catalog, integrity tracking, caching, outputs, and AI guardrails
5
5
  Project-URL: Homepage, https://framework.pub
6
6
  Project-URL: Source, https://github.com/frameworktools/framework-py
@@ -98,6 +98,19 @@ After cloning a project, prepare it with:
98
98
  uv run python -m framework bootstrap
99
99
  ```
100
100
 
101
+ ## Skill sync
102
+
103
+ Sync a local skill and its companion files with your Framework Cloud account:
104
+
105
+ ```python
106
+ fw.skills_sync(".agents/skills/my-skill", dry_run=True)
107
+ fw.skills_sync(".agents/skills/my-skill")
108
+ ```
109
+
110
+ Local edits create account versions. Edited Framework skills become private
111
+ forks with an exact source version. Concurrent edits stop for reconciliation.
112
+ [Skill sync guide](https://framework.pub/docs/skill-sync).
113
+
101
114
  ## Development
102
115
 
103
116
  ```sh
@@ -51,6 +51,19 @@ After cloning a project, prepare it with:
51
51
  uv run python -m framework bootstrap
52
52
  ```
53
53
 
54
+ ## Skill sync
55
+
56
+ Sync a local skill and its companion files with your Framework Cloud account:
57
+
58
+ ```python
59
+ fw.skills_sync(".agents/skills/my-skill", dry_run=True)
60
+ fw.skills_sync(".agents/skills/my-skill")
61
+ ```
62
+
63
+ Local edits create account versions. Edited Framework skills become private
64
+ forks with an exact source version. Concurrent edits stop for reconciliation.
65
+ [Skill sync guide](https://framework.pub/docs/skill-sync).
66
+
54
67
  ## Development
55
68
 
56
69
  ```sh
@@ -27,6 +27,10 @@ note = "R exports it only so S3 methods dispatch"
27
27
  python = "project_register"
28
28
  status = "renamed"
29
29
 
30
+ [functions.adopt]
31
+ python = "adopt"
32
+ status = "ported"
33
+
30
34
  [functions.ai_generate_context]
31
35
  status = "deprecated"
32
36
  note = "Replaced by the AGENTS.md stub in 2.0"
@@ -522,6 +526,10 @@ status = "ported"
522
526
  python = "storage_test"
523
527
  status = "ported"
524
528
 
529
+ [functions.structure_import]
530
+ python = "structure_import"
531
+ status = "ported"
532
+
525
533
  [functions.stubs_list]
526
534
  python = "stubs_list"
527
535
  status = "ported"
@@ -549,4 +557,8 @@ status = "folded"
549
557
 
550
558
  # Python functions with no R counterpart.
551
559
  [python_only]
552
- names = ["framework_template_path"]
560
+ names = ["framework_template_path", "tools_available"]
561
+
562
+ [functions.skills_sync]
563
+ python = "skills_sync"
564
+ status = "ported"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "framework-py"
3
- version = "0.1.0.dev3"
3
+ version = "0.1.0.dev5"
4
4
  description = "Structured data science projects: a data catalog, integrity tracking, caching, outputs, and AI guardrails"
5
5
  readme = "README.md"
6
6
  license = "MIT"
@@ -0,0 +1,127 @@
1
+ """Generate the create/python/ conformance cases for the R repository.
2
+
3
+ R holds the one copy of the conformance fixtures, and every engine pins it.
4
+ Write the cases to a folder outside the R repository and hand them to its
5
+ maintainers, who copy them into ``inst/conformance/create/python/``.
6
+ Each case records the layers it was resolved from (for reference), the
7
+ resolved spec (the input to creation), and ``expected.paths``: every file and
8
+ folder that creating the spec writes, folders ending in ``/``, ``.git/`` left
9
+ out, sorted by byte value. The format is described in R's
10
+ ``inst/conformance/README.md``.
11
+
12
+ uv run python scripts/make_create_fixtures.py --to DIR
13
+ """
14
+
15
+ from __future__ import annotations
16
+
17
+ import argparse
18
+ import json
19
+ import sys
20
+ import tempfile
21
+ from pathlib import Path
22
+ from typing import Any
23
+
24
+ ROOT = Path(__file__).resolve().parent.parent
25
+ NAME = "Fixture Study"
26
+ AUTHOR = {"name": "Ada Analyst", "email": "ada@example.org", "affiliation": ""}
27
+
28
+ # id -> (structure, workflow, choices, description)
29
+ CASES: dict[str, tuple[str, str, dict[str, Any], str]] = {}
30
+
31
+
32
+ def _case(
33
+ structure: str,
34
+ workflow: str,
35
+ description: str,
36
+ *,
37
+ suffix: str = "",
38
+ ide: str = "vscode",
39
+ agents: bool = True,
40
+ ) -> None:
41
+ choices: dict[str, Any] = {"git": {"use_git": False}, "scaffold": {"ide": ide}}
42
+ if not agents:
43
+ choices["ai"] = {"enabled": False}
44
+ CASES[f"{structure}-{workflow}{suffix}"] = (structure, workflow, choices, description)
45
+
46
+
47
+ _case("project", "jupyter", "Standard structure, Jupyter workflow: Jupyter and Quarto on.")
48
+ _case("project", "quarto", "Standard structure, Quarto workflow, VS Code, agents on.")
49
+ _case("project", "scripts", "Standard structure, Scripts only: no Quarto or Jupyter files.")
50
+ _case("project", "jupyter", "Editor rstudio: no editor files.", suffix="-rstudio", ide="rstudio")
51
+ _case("project", "jupyter", "Editor both: a .code-workspace.", suffix="-both", ide="both")
52
+ _case("project", "jupyter", "Editor none: no editor files.", suffix="-none", ide="none")
53
+ _case(
54
+ "project",
55
+ "jupyter",
56
+ "AI agents off: no AGENTS.md, stubs, or skills.",
57
+ suffix="-no-agents",
58
+ agents=False,
59
+ )
60
+ for _workflow in ("jupyter", "quarto", "scripts"):
61
+ _case(
62
+ "project_sensitive",
63
+ _workflow,
64
+ f"Privacy Sensitive structure, {_workflow.capitalize()} workflow, with agent guards.",
65
+ )
66
+ _case("bare", _workflow, f"Bare structure with the {_workflow.capitalize()} workflow.")
67
+ _case("presentation", "quarto", "Presentation structure, Quarto workflow.")
68
+ _case("course", "quarto", "Course structure, Quarto workflow.")
69
+
70
+
71
+ def created_paths(spec: dict[str, Any]) -> list[str]:
72
+ from framework.create import project_create
73
+
74
+ with tempfile.TemporaryDirectory() as temp:
75
+ target = Path(temp) / "project"
76
+ project_create(spec, target)
77
+ paths = [
78
+ f"{p.relative_to(target).as_posix()}/"
79
+ if p.is_dir()
80
+ else p.relative_to(target).as_posix()
81
+ for p in target.rglob("*")
82
+ if p.relative_to(target).parts[0] != ".git"
83
+ ]
84
+ return sorted(paths, key=lambda path: path.encode("utf-8"))
85
+
86
+
87
+ def build(
88
+ structure: str, workflow: str, choices: dict[str, Any], description: str
89
+ ) -> dict[str, Any]:
90
+ from framework.features import workflow_layers
91
+ from framework.spec.resolve import spec_resolve
92
+
93
+ layers = [
94
+ {"kind": "base", "key": structure, "layer": {"type": structure, "language": "python"}},
95
+ *workflow_layers(workflow),
96
+ {"kind": "project", "key": "choices", "layer": choices},
97
+ ]
98
+ spec = spec_resolve(layers, NAME, AUTHOR).spec
99
+ return {
100
+ "description": description,
101
+ "language": "python",
102
+ "layers": layers,
103
+ "spec": spec,
104
+ "expected": {"paths": created_paths(spec)},
105
+ }
106
+
107
+
108
+ def main() -> int:
109
+ parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
110
+ parser.add_argument("--to", type=Path, required=True, help="the folder to write the cases to")
111
+ args = parser.parse_args()
112
+ sys.path.insert(0, str(ROOT / "src"))
113
+ from framework._log import logger
114
+
115
+ logger.disabled = True
116
+ args.to.mkdir(parents=True, exist_ok=True)
117
+ for old in args.to.glob("*.json"):
118
+ old.unlink()
119
+ for case_id, case in CASES.items():
120
+ text = json.dumps(build(*case), indent=2, ensure_ascii=False) + "\n"
121
+ (args.to / f"{case_id}.json").write_text(text, encoding="utf-8")
122
+ print(f"Wrote {len(CASES)} cases to {args.to}")
123
+ return 0
124
+
125
+
126
+ if __name__ == "__main__":
127
+ raise SystemExit(main())
@@ -32,8 +32,18 @@ ASSETS: dict[str, str] = {
32
32
  "inst/schema/docs-site.md": "docs",
33
33
  "inst/templates/init.sql": "src/framework/_assets",
34
34
  "inst/hooks/pre-commit": "src/framework/_assets/hooks",
35
+ # Framework's tools and its skill and package sets, canonical in R.
36
+ "inst/features/*.json": "src/framework/_assets/features",
37
+ "inst/sets/skills/*.json": "src/framework/_assets/sets/skills",
38
+ "inst/sets/packages/*.json": "src/framework/_assets/sets/packages",
39
+ # Workflows: how notebooks are written (quarto, jupyter, or scripts).
40
+ "inst/workflows/*.json": "src/framework/_assets/workflows",
41
+ # How adopt() maps an existing project's folders to directory keys.
42
+ "inst/adopt/rules.json": "src/framework/_assets/adopt",
35
43
  "inst/conformance/README.md": "tests/shared/conformance",
36
44
  "inst/conformance/merge/*.json": "tests/shared/conformance/merge",
45
+ "inst/conformance/create/python/*.json": "tests/shared/conformance/create/python",
46
+ "inst/conformance/adopt/*.json": "tests/shared/conformance/adopt",
37
47
  "NAMESPACE": "tests/shared",
38
48
  # The servers for tests/integration, with the seed script for each.
39
49
  "tests/integration/compose.yml": "tests/integration",
@@ -10,6 +10,7 @@ from __future__ import annotations
10
10
  from importlib.metadata import PackageNotFoundError, version
11
11
 
12
12
  from framework._time import now
13
+ from framework.adopt import adopt, structure_import
13
14
  from framework.ai import ai_skills_update
14
15
  from framework.bootstrap import BootstrapResult, bootstrap
15
16
  from framework.cache import (
@@ -69,6 +70,7 @@ from framework.errors import (
69
70
  SettingsError,
70
71
  UnsupportedFormatError,
71
72
  )
73
+ from framework.features import tools_available
72
74
  from framework.global_config import (
73
75
  configure_global,
74
76
  framework_template_path,
@@ -118,6 +120,7 @@ from framework.scaffold import project_info, scaffold, status
118
120
  from framework.scratch import scratch_capture, scratch_clean
119
121
  from framework.security import AuditResult, git_security_audit
120
122
  from framework.settings import settings, settings_read, settings_write
123
+ from framework.skill_sync import skills_sync
121
124
  from framework.spec.check import spec_check
122
125
  from framework.spec.merge import SpecError
123
126
  from framework.spec.resolve import ResolvedSpec, spec_resolve
@@ -155,6 +158,7 @@ __all__ = [
155
158
  "SpecError",
156
159
  "UnsupportedFormatError",
157
160
  "__version__",
161
+ "adopt",
158
162
  "ai_skills_update",
159
163
  "bootstrap",
160
164
  "cache",
@@ -239,12 +243,15 @@ __all__ = [
239
243
  "settings",
240
244
  "settings_read",
241
245
  "settings_write",
246
+ "skills_sync",
242
247
  "spec_check",
243
248
  "spec_resolve",
244
249
  "status",
245
250
  "storage_test",
251
+ "structure_import",
246
252
  "stubs_list",
247
253
  "stubs_path",
248
254
  "stubs_publish",
255
+ "tools_available",
249
256
  "write_framework_template",
250
257
  ]
@@ -1,7 +1,10 @@
1
1
  """Command-line entry points: ``python -m framework``.
2
2
 
3
3
  python -m framework create --from-layers FILE --path DIR [--interactive]
4
- python -m framework create --name NAME --path DIR [--type TYPE] [--interactive]
4
+ python -m framework create --name NAME --path DIR [--type TYPE] [--workflow ID]
5
+ [--tool ID[=false]]... [--skill-set ID]... [--package-set ID]... [--interactive]
6
+ [--offline]
7
+ python -m framework adopt [--path DIR] [--yes]
5
8
  python -m framework bootstrap [--path DIR] [--interactive] [--no-packages]
6
9
  python -m framework hook pre-commit
7
10
 
@@ -34,6 +37,24 @@ def _parser() -> argparse.ArgumentParser:
34
37
  choices=["project", "project_sensitive", "course", "presentation", "bare"],
35
38
  help="project type, with --name (default: bare, or asked with --interactive)",
36
39
  )
40
+ create.add_argument(
41
+ "--workflow",
42
+ choices=["jupyter", "quarto", "scripts"],
43
+ help="with --name, how notebooks are written (default: jupyter for project types)",
44
+ )
45
+ create.add_argument(
46
+ "--tool",
47
+ action="append",
48
+ default=[],
49
+ metavar="ID[=false]",
50
+ help="with --name, turn a tool on, or off with =false (repeatable)",
51
+ )
52
+ create.add_argument(
53
+ "--skill-set", action="append", default=[], metavar="ID", help="add a skill set"
54
+ )
55
+ create.add_argument(
56
+ "--package-set", action="append", default=[], metavar="ID", help="add a package set"
57
+ )
37
58
  create.add_argument(
38
59
  "--interactive",
39
60
  action="store_true",
@@ -45,6 +66,16 @@ def _parser() -> argparse.ArgumentParser:
45
66
  ),
46
67
  )
47
68
 
69
+ create.add_argument(
70
+ "--offline",
71
+ action="store_true",
72
+ help="with --name, build from Framework's built-in defaults without Framework Cloud",
73
+ )
74
+
75
+ adopt = commands.add_parser("adopt", help="make an existing folder a Framework project")
76
+ adopt.add_argument("--path", default=".", help="the project folder (default: .)")
77
+ adopt.add_argument("--yes", action="store_true", help="accept the proposed folders")
78
+
48
79
  bootstrap = commands.add_parser("bootstrap", help="prepare a cloned project")
49
80
  bootstrap.add_argument("--path", default=".", help="the project folder (default: .)")
50
81
  bootstrap.add_argument("--interactive", action="store_true", help="ask for empty .env values")
@@ -64,10 +95,24 @@ def main(argv: Sequence[str] | None = None) -> int:
64
95
  from framework.hooks import hook_run
65
96
 
66
97
  return hook_run(args.name)
67
- if args.command == "create" and args.from_layers and args.type:
68
- parser.error("--type can only be used with --name")
98
+ name_only = args.command == "create" and (
99
+ args.type
100
+ or args.workflow
101
+ or args.tool
102
+ or args.skill_set
103
+ or args.package_set
104
+ or args.offline
105
+ )
106
+ if name_only and args.from_layers:
107
+ parser.error(
108
+ "--type, --workflow, --tool, --skill-set, --package-set, and --offline need --name"
109
+ )
69
110
  try:
70
- if args.command == "bootstrap":
111
+ if args.command == "adopt":
112
+ from framework.adopt import adopt
113
+
114
+ path = adopt(args.path, yes=args.yes)
115
+ elif args.command == "bootstrap":
71
116
  from framework.bootstrap import bootstrap
72
117
 
73
118
  path = bootstrap(
@@ -82,7 +127,21 @@ def main(argv: Sequence[str] | None = None) -> int:
82
127
  else:
83
128
  from framework.create import new
84
129
 
85
- path = new(args.name, args.path, args.type, interactive=args.interactive)
130
+ tools = {}
131
+ for tool in args.tool:
132
+ name, _, value = tool.partition("=")
133
+ tools[name] = value.lower() not in ("false", "no", "0", "off")
134
+ path = new(
135
+ args.name,
136
+ args.path,
137
+ args.type,
138
+ workflow=args.workflow,
139
+ tools=tools,
140
+ package_sets=args.package_set,
141
+ skill_sets=args.skill_set,
142
+ interactive=args.interactive,
143
+ offline=args.offline,
144
+ )
86
145
  except FrameworkError as error:
87
146
  print(f"Error: {error}", file=sys.stderr)
88
147
  return 1
@@ -0,0 +1,210 @@
1
+ """The AGENTS.md guide a new project gets, generated from its spec.
2
+
3
+ The sections follow R's AGENTS.md, with Python's functions. Headings marked
4
+ ``<!-- @framework:regenerate -->`` describe the settings. The others are the
5
+ user's to edit.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ from typing import Any
11
+
12
+ REGENERATE = "<!-- @framework:regenerate -->"
13
+
14
+ SKILL_DESCRIPTIONS = {
15
+ "framework-workflow": "scaffold() initialization, critical rules, creating notebooks/scripts",
16
+ "framework-data": "reading and saving data (data_read/data_save are mandatory)",
17
+ "framework-packages": "adding and managing Python packages (package_add, never pip install)",
18
+ "framework-outputs": "results, caching, database queries, publishing",
19
+ "framework-sensitive-data": "PII/PHI handling and private/public directory rules",
20
+ }
21
+
22
+ _PURPOSES = {
23
+ "inputs_raw": "Raw data (immutable)",
24
+ "inputs_intermediate": "Intermediate/cleaned data",
25
+ "inputs_final": "Analysis-ready data",
26
+ "outputs_tables": "Output tables",
27
+ "outputs_figures": "Output figures",
28
+ "outputs_models": "Saved models",
29
+ "outputs_reports": "Reports",
30
+ "inputs_private_raw": "Private raw data (PII/PHI)",
31
+ "inputs_public_raw": "Public raw data",
32
+ "inputs_private_intermediate": "Private intermediate",
33
+ "inputs_public_intermediate": "Public intermediate",
34
+ "inputs_private_final": "Private analysis-ready",
35
+ "inputs_public_final": "Public analysis-ready",
36
+ "outputs_private_tables": "Private tables",
37
+ "outputs_public_tables": "Public tables",
38
+ "outputs_private_figures": "Private figures",
39
+ "outputs_public_figures": "Public figures",
40
+ "data": "Data files",
41
+ "outputs": "Output files",
42
+ }
43
+
44
+
45
+ def _header(name: str) -> str:
46
+ return (
47
+ f"# {name}\n\n"
48
+ "This file provides guidance to AI assistants working with this Framework project.\n"
49
+ "It is the canonical context file; detailed workflow instructions live in the\n"
50
+ "skills listed below. Edit the sections without regeneration markers freely -\n"
51
+ "they won't be overwritten.\n"
52
+ )
53
+
54
+
55
+ def _skills(skills: list[str], skills_dir: str) -> str:
56
+ rows = [
57
+ f"| `{skill}` | {SKILL_DESCRIPTIONS.get(skill, '')} | `{skills_dir}/{skill}/SKILL.md` |"
58
+ for skill in skills
59
+ ]
60
+ return "\n".join(
61
+ [
62
+ "## Skills",
63
+ "",
64
+ "Detailed instructions live in skill files, loaded on demand. Claude Code discovers",
65
+ "them automatically; other agents should read the relevant SKILL.md before working",
66
+ "on a matching task.",
67
+ "",
68
+ "| Skill | Covers | Path |",
69
+ "|-------|--------|------|",
70
+ *rows,
71
+ ]
72
+ )
73
+
74
+
75
+ def _environment(spec: dict[str, Any]) -> str:
76
+ scaffold = spec.get("scaffold") or {}
77
+ functions = (spec.get("directories") or {}).get("functions") or "functions"
78
+ steps = [
79
+ "1. **Finds the project root** and loads `.env` and the settings (it does not change "
80
+ "the working directory)",
81
+ "2. **Creates framework.db** if needed and records the scaffold time",
82
+ f"3. **Puts `{functions}/` on the import path**, so its modules import directly",
83
+ "4. **Runs `scaffold.py`** from the project root, if there is one",
84
+ ]
85
+ rules = [
86
+ "**DO NOT** run `pip install` or `uv add` yourself. Add packages with "
87
+ '`fw.package_add("name")`, which records them in pyproject.toml.',
88
+ "",
89
+ f"**DO NOT** copy helpers between notebooks. Put them in `{functions}/` and import them.",
90
+ ]
91
+ seed = scaffold.get("seed")
92
+ if scaffold.get("seed_on_scaffold"):
93
+ steps.append(f"5. **Sets the random seed to {seed}** for reproducibility")
94
+ rules += [
95
+ "",
96
+ f"**DO NOT** reseed after scaffold(). The seed is already set to {seed}.",
97
+ "If you need a different seed for a specific operation, document why.",
98
+ ]
99
+ return "\n".join(
100
+ [
101
+ f"## Framework Environment {REGENERATE}",
102
+ "",
103
+ "This project uses Framework for reproducible data analysis. **Every notebook and "
104
+ "script",
105
+ "MUST begin with `import framework as fw` and `fw.scaffold()`**, which initializes "
106
+ "the environment.",
107
+ "",
108
+ "### What scaffold() Does",
109
+ "",
110
+ *steps,
111
+ "",
112
+ "### CRITICAL RULES",
113
+ "",
114
+ *rules,
115
+ ]
116
+ )
117
+
118
+
119
+ def _packages(spec: dict[str, Any]) -> str:
120
+ names = list((spec.get("packages") or {}).get("default_packages") or {})
121
+ lines = [f"## Installed Packages {REGENERATE}", ""]
122
+ if names:
123
+ lines += [f"**Dependencies** (in pyproject.toml): framework-py, {', '.join(names)}", ""]
124
+ else:
125
+ lines += ["**Dependencies** (in pyproject.toml): framework-py", ""]
126
+ lines.append('Add packages with `fw.package_add("name")`.')
127
+ return "\n".join(lines)
128
+
129
+
130
+ def _data(spec: dict[str, Any]) -> str:
131
+ directories = spec.get("directories") or {}
132
+ rows = [
133
+ f"| {purpose} | `{directories[key]}/` |"
134
+ for key, purpose in (
135
+ (key, _PURPOSES[key]) for key in directories if key in _PURPOSES and directories[key]
136
+ )
137
+ ]
138
+ table = (
139
+ ["| Purpose | Directory |", "|---------|-----------|", *rows]
140
+ if rows
141
+ else ["This project has no data folders configured yet."]
142
+ )
143
+ return "\n".join(
144
+ [
145
+ f"## Data Management {REGENERATE}",
146
+ "",
147
+ "**All data I/O MUST use `fw.data_read()` and `fw.data_save()`** - see the",
148
+ "`framework-data` skill for the full rules. This project's data directories:",
149
+ "",
150
+ *table,
151
+ ]
152
+ )
153
+
154
+
155
+ def _type_section(spec: dict[str, Any]) -> str:
156
+ # Sensitive data is a setting, whatever structure the project uses
157
+ if (spec.get("security") or {}).get("sensitive"):
158
+ return (
159
+ "## Privacy Requirements\n\n"
160
+ "**This is a privacy-sensitive project.** Before ANY data operation, output, or\n"
161
+ "commit, follow the `framework-sensitive-data` skill. Never commit or publish\n"
162
+ "anything under a `private/` directory."
163
+ )
164
+ if spec.get("type") == "course":
165
+ return (
166
+ "## Course Structure\n\n"
167
+ "This is a teaching/course project. Lecture slides, assignments, modules, course\n"
168
+ "documents, data, and readings each have their own folder (see settings.yml).\n\n"
169
+ "### Creating Course Materials\n\n"
170
+ "```python\n"
171
+ 'fw.make_revealjs("lecture-01-intro", dir="slides")\n'
172
+ 'fw.make_notebook("hw-01-basics", dir="assignments")\n'
173
+ "```"
174
+ )
175
+ if spec.get("type") == "presentation":
176
+ return (
177
+ "## Presentation Workflow\n\n"
178
+ "This is a presentation project with minimal structure. Edit `presentation.qmd`\n"
179
+ "for your slides and render it with `quarto render presentation.qmd`.\n\n"
180
+ "```python\n"
181
+ 'fw.make_revealjs("backup-slides")\n'
182
+ "```"
183
+ )
184
+ return (
185
+ "## Workflow Guidelines\n\n"
186
+ "Follow the standard Framework workflow (see the `framework-workflow` skill):\n"
187
+ "import with `fw.data_read()`, clean and save with `fw.data_save()`, analyze from\n"
188
+ "final datasets, export with `fw.save_table()`, `fw.save_figure()`, or `fw.save_model()`."
189
+ )
190
+
191
+
192
+ def agents_md(spec: dict[str, Any], skills_dir: str, restricted_notice: str | None) -> str:
193
+ """The full AGENTS.md for a new project.
194
+
195
+ ``restricted_notice`` names the folders agents must stay out of. It goes
196
+ right after the header in sensitive projects.
197
+ """
198
+ sections = [_header(spec["name"])]
199
+ if restricted_notice:
200
+ sections.append(restricted_notice)
201
+ sections += [
202
+ _skills(list(spec.get("skills") or {}), skills_dir),
203
+ _environment(spec),
204
+ _packages(spec),
205
+ _data(spec),
206
+ _type_section(spec),
207
+ "## Project Notes\n\n*Add your project-specific notes, conventions, and documentation "
208
+ "here.*",
209
+ ]
210
+ return "\n\n".join(section.rstrip("\n") for section in sections) + "\n"