codeplain 0.4.3.dev65__tar.gz → 0.4.3.dev66__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 (217) hide show
  1. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.gitignore +2 -0
  2. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/PKG-INFO +1 -1
  3. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/codeplain_REST_api.py +12 -0
  4. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/git_utils.py +66 -0
  5. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/module_renderer.py +19 -1
  6. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/partial_rendering.py +34 -10
  7. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code.py +18 -4
  8. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_arguments.py +6 -0
  9. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain_modules.py +69 -0
  10. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/commit_conformance_tests_changes.py +7 -3
  11. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/exit_with_error.py +7 -6
  12. codeplain-0.4.3.dev66/render_machine/actions/finish_functional_requirement.py +33 -0
  13. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/fix_unit_tests.py +19 -0
  14. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/prepare_repositories.py +68 -0
  15. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/render_conformance_tests.py +20 -2
  16. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/render_functional_requirement.py +3 -0
  17. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/render_context.py +63 -17
  18. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/render_types.py +4 -1
  19. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/render_utils.py +6 -0
  20. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/state_machine_config.py +2 -4
  21. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_conformance_fix_conversation.py +1 -0
  22. codeplain-0.4.3.dev66/tests/test_conformance_tests_json_order.py +37 -0
  23. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_fix_unit_tests_action.py +35 -0
  24. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_fix_unit_tests_conformance_context.py +1 -0
  25. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_git_utils.py +26 -0
  26. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_partial_rendering.py +3 -0
  27. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_plain_modules.py +92 -0
  28. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_prepare_repositories_layout.py +2 -1
  29. codeplain-0.4.3.dev66/tests/test_regenerate_checks.py +173 -0
  30. codeplain-0.4.3.dev66/tests/test_regenerate_reset.py +167 -0
  31. codeplain-0.4.3.dev66/tests/test_render_context_conformance_regression.py +198 -0
  32. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_render_stop_reason.py +27 -2
  33. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_terminal_attachment.py +1 -0
  34. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/plain_module_render_choice_tui.py +7 -0
  35. codeplain-0.4.3.dev65/render_machine/actions/finish_functional_requirement.py +0 -21
  36. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.claude/settings.json +0 -0
  37. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.flake8 +0 -0
  38. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/dependabot.yml +0 -0
  39. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/scripts/record-linear-release.cjs +0 -0
  40. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/e2e.yml +0 -0
  41. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/lint-and-test.yml +0 -0
  42. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/lint-powershell.yml +0 -0
  43. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/notify-slack-on-main-merge.yml +0 -0
  44. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/publish-dev-to-pypi.yml +0 -0
  45. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/publish-install-script.yml +0 -0
  46. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.github/workflows/publish-to-pypi.yml +0 -0
  47. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.vscode/launch.json +0 -0
  48. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/.vscode/settings.json +0 -0
  49. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/CLAUDE.md +0 -0
  50. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/CONTRIBUTING.md +0 -0
  51. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/LICENSE +0 -0
  52. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/README.md +0 -0
  53. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/change_detection.py +0 -0
  54. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/cli_output/__init__.py +0 -0
  55. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/cli_output/dry_run.py +0 -0
  56. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/cli_output/render_summary.py +0 -0
  57. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/cli_output/status.py +0 -0
  58. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/concept_utils.py +0 -0
  59. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/config/__init__.py +0 -0
  60. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/config/system_config.yaml +0 -0
  61. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/conformance_fix_journal.py +0 -0
  62. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/diff_utils.py +0 -0
  63. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/docs/generate_cli.py +0 -0
  64. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/docs/plain2code_cli.md +0 -0
  65. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/docs/starting_a_plain_project_from_scratch.md +0 -0
  66. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/event_bus.py +0 -0
  67. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_golang/config.yaml +0 -0
  68. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_golang/harness_tests/hello_world_test.go +0 -0
  69. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_golang/hello_world_golang.plain +0 -0
  70. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_golang/run.sh +0 -0
  71. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_golang/tests/hello_world_golang/display-hello-world.plain +0 -0
  72. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_python/config.yaml +0 -0
  73. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_python/harness_tests/hello_world_display/test_hello_world.py +0 -0
  74. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_python/hello_world_python.plain +0 -0
  75. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_python/run.sh +0 -0
  76. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_python/tests/hello_world_python/display-hello-world.plain +0 -0
  77. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/config.yaml +0 -0
  78. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/harness_tests/hello_world_display/cypress/e2e/hello_world.cy.ts +0 -0
  79. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/harness_tests/hello_world_display/cypress/support/e2e.ts +0 -0
  80. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/harness_tests/hello_world_display/cypress.config.ts +0 -0
  81. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/harness_tests/hello_world_display/package.json +0 -0
  82. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/harness_tests/hello_world_display/tsconfig.json +0 -0
  83. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/hello_world_react.plain +0 -0
  84. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/run.sh +0 -0
  85. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/tests/hello_world_react/display-hello-world.plain +0 -0
  86. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/example_hello_world_react/tests/typescript-react-app-boilerplate/entry-point.plain +0 -0
  87. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/examples/run.sh +0 -0
  88. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/file_utils.py +0 -0
  89. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/git_preflight.py +0 -0
  90. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/install/bash/examples.sh +0 -0
  91. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/install/bash/install.sh +0 -0
  92. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/install/bash/walkthrough.sh +0 -0
  93. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/install/powershell/examples.ps1 +0 -0
  94. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/install/powershell/install.ps1 +0 -0
  95. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/install/powershell/walkthrough.ps1 +0 -0
  96. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/memory_management.py +0 -0
  97. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/metadata_utils.py +0 -0
  98. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/path_resolution.py +0 -0
  99. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_cli.md +0 -0
  100. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_console.py +0 -0
  101. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_events.py +0 -0
  102. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_exceptions.py +0 -0
  103. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_logger.py +0 -0
  104. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_nodes.py +0 -0
  105. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_read_config.py +0 -0
  106. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_state.py +0 -0
  107. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_telemetry.py +0 -0
  108. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain2code_utils.py +0 -0
  109. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain_file.py +0 -0
  110. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/plain_spec.py +0 -0
  111. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/pyproject.toml +0 -0
  112. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/pytest.ini +0 -0
  113. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/__init__.py +0 -0
  114. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/analyze_specification_ambiguity.py +0 -0
  115. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/base_action.py +0 -0
  116. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/commit_implementation_code_changes.py +0 -0
  117. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/create_dist.py +0 -0
  118. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/distill_conformance_test_memory.py +0 -0
  119. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/fix_conformance_test.py +0 -0
  120. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/prepare_testing_environment.py +0 -0
  121. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/refactor_code.py +0 -0
  122. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/run_conformance_tests.py +0 -0
  123. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/run_unit_tests.py +0 -0
  124. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/actions/summarize_conformance_tests.py +0 -0
  125. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/agent_tools.py +0 -0
  126. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/code_renderer.py +0 -0
  127. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/conformance_fix_conversation.py +0 -0
  128. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/conformance_tests.py +0 -0
  129. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/implementation_code_helpers.py +0 -0
  130. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/states.py +0 -0
  131. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/render_machine/triggers.py +0 -0
  132. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/requirements.txt +0 -0
  133. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/resources/codeplain_overview.png +0 -0
  134. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/resources/plain_example.png +0 -0
  135. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/standard_template_library/golang-console-app-template.plain +0 -0
  136. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/standard_template_library/python-console-app-template.plain +0 -0
  137. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/standard_template_library/typescript-react-app-boilerplate.plain +0 -0
  138. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/standard_template_library/typescript-react-app-template.plain +0 -0
  139. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/system_config.py +0 -0
  140. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_conformance_tests_cypress.ps1 +0 -0
  141. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_conformance_tests_cypress.sh +0 -0
  142. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_conformance_tests_golang.ps1 +0 -0
  143. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_conformance_tests_golang.sh +0 -0
  144. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_conformance_tests_python.ps1 +0 -0
  145. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_conformance_tests_python.sh +0 -0
  146. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_flutter.ps1 +0 -0
  147. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_flutter.sh +0 -0
  148. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_golang.ps1 +0 -0
  149. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_golang.sh +0 -0
  150. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_python.ps1 +0 -0
  151. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_python.sh +0 -0
  152. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_react.ps1 +0 -0
  153. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/test_scripts/run_unittests_react.sh +0 -0
  154. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/__init__.py +0 -0
  155. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/conftest.py +0 -0
  156. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/acceptance_tests_warning/main_requiring_acceptance_tests.plain +0 -0
  157. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/acceptance_tests_warning/required_with_acceptance_tests.plain +0 -0
  158. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/acceptance_tests_warning/tests/required_with_acceptance_tests/entry-point.plain +0 -0
  159. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/partial_rendering/pr_code_var.plain +0 -0
  160. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/partial_rendering/pr_implement.plain +0 -0
  161. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/partial_rendering/pr_leaf.plain +0 -0
  162. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/partial_rendering/pr_middle.plain +0 -0
  163. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/partial_rendering/pr_root.plain +0 -0
  164. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/data/partial_rendering/pr_solo.plain +0 -0
  165. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/e2e/Dockerfile +0 -0
  166. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/e2e/conftest.py +0 -0
  167. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/e2e/test_hello_world_python.py +0 -0
  168. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/e2e/test_hello_world_python_windows.py +0 -0
  169. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_acceptance_scenario_rendered_once.py +0 -0
  170. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_acceptance_scenarios_after_a_code_fix.py +0 -0
  171. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_agent_tools.py +0 -0
  172. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_api_client_retries.py +0 -0
  173. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_arg_provenance.py +0 -0
  174. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_background_preparation.py +0 -0
  175. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_change_detection.py +0 -0
  176. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_cli_output.py +0 -0
  177. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_conformance_fix_journal.py +0 -0
  178. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_console_log_styles.py +0 -0
  179. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_dependency_pins.py +0 -0
  180. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_distill_conformance_test_memory.py +0 -0
  181. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_dry_run_link_validation.py +0 -0
  182. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_exit_when_done.py +0 -0
  183. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_file_utils.py +0 -0
  184. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_folder_path_resolution.py +0 -0
  185. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_frid_arguments.py +0 -0
  186. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_functionality_position.py +0 -0
  187. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_functionality_without_scenarios.py +0 -0
  188. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_git_preflight.py +0 -0
  189. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_headless_logging.py +0 -0
  190. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_log_file_name_resolution.py +0 -0
  191. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_logging_config_path_resolution.py +0 -0
  192. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_path_resolution.py +0 -0
  193. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_plain2code.py +0 -0
  194. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_plain2code_state.py +0 -0
  195. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_plain2code_utils.py +0 -0
  196. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_render_finished_report.py +0 -0
  197. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_render_range.py +0 -0
  198. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_resolve_config_file.py +0 -0
  199. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_script_path_resolution.py +0 -0
  200. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_script_timeout_hint.py +0 -0
  201. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_system_config.py +0 -0
  202. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_telemetry.py +0 -0
  203. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_tests_folders.py +0 -0
  204. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_traceability_warnings.py +0 -0
  205. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_tui_components.py +0 -0
  206. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_tui_usage.py +0 -0
  207. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_usage_summary.py +0 -0
  208. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tests/test_user_error_message.py +0 -0
  209. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/__init__.py +0 -0
  210. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/components.py +0 -0
  211. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/models.py +0 -0
  212. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/plain2code_tui.py +0 -0
  213. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/spinner.py +0 -0
  214. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/state_handlers.py +0 -0
  215. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/styles.css +0 -0
  216. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/tui/widget_helpers.py +0 -0
  217. {codeplain-0.4.3.dev65 → codeplain-0.4.3.dev66}/usage_summary.py +0 -0
@@ -30,3 +30,5 @@ dist
30
30
 
31
31
  .coverage
32
32
  logging_config.yaml
33
+
34
+ .claude/worktrees/
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: codeplain
3
- Version: 0.4.3.dev65
3
+ Version: 0.4.3.dev66
4
4
  Summary: Transform plain language specifications into working code
5
5
  License-File: LICENSE
6
6
  Classifier: Environment :: Console
@@ -286,6 +286,9 @@ class CodeplainAPI:
286
286
  required_modules: dict,
287
287
  include_unittests: bool,
288
288
  run_state: RunState,
289
+ is_regeneration: bool = False,
290
+ old_functional_requirement_text: Optional[str] = None,
291
+ code_functional_requirements: Optional[list] = None,
289
292
  ) -> dict[str, str]:
290
293
  """
291
294
  Renders the content of a functionality based on the provided ID,
@@ -325,8 +328,15 @@ class CodeplainAPI:
325
328
  "module_name": module_name,
326
329
  "required_modules": required_modules,
327
330
  "include_unittests": include_unittests,
331
+ "is_regeneration": is_regeneration,
328
332
  }
329
333
 
334
+ if old_functional_requirement_text is not None:
335
+ payload["old_functional_requirement_text"] = old_functional_requirement_text
336
+
337
+ if code_functional_requirements is not None:
338
+ payload["code_functional_requirements"] = code_functional_requirements
339
+
330
340
  return self.post_request(endpoint_url, headers, payload, run_state)
331
341
 
332
342
  def distill_conformance_test_memory(
@@ -385,6 +395,7 @@ class CodeplainAPI:
385
395
  conformance_tests_folder_name,
386
396
  conformance_tests_json,
387
397
  run_state: RunState,
398
+ is_regeneration: bool = False,
388
399
  ):
389
400
  endpoint_url = f"{self.api_url}/render_conformance_tests"
390
401
  headers = {"X-API-Key": self.api_key, "Content-Type": "application/json"}
@@ -400,6 +411,7 @@ class CodeplainAPI:
400
411
  "required_modules": required_modules,
401
412
  "conformance_tests_folder_name": conformance_tests_folder_name,
402
413
  "conformance_tests_json": conformance_tests_json,
414
+ "is_regeneration": is_regeneration,
403
415
  }
404
416
 
405
417
  response = self.post_request(endpoint_url, headers, payload, run_state)
@@ -17,6 +17,7 @@ CONFORMANCE_TESTS_PASSED_COMMIT_MESSAGE = (
17
17
  # Following messages are used as checkpoints in the git history
18
18
  # Changing them will break backwards compatibility so change them with care
19
19
  FUNCTIONAL_REQUIREMENT_FINISHED_COMMIT_MESSAGE = "[Codeplain] functionality ID (FRID):{} fully implemented"
20
+ FUNCTIONAL_REQUIREMENT_REGENERATED_COMMIT_MESSAGE = "[Codeplain] functionality ID (FRID):{} fully regenerated"
20
21
  INITIAL_COMMIT_MESSAGE = "[Codeplain] Initial module commit"
21
22
  BASE_FOLDER_COMMIT_MESSAGE = "[Codeplain] Initialize build with Base Folder content"
22
23
 
@@ -332,6 +333,67 @@ def has_commit_for_frid(repo_path: Union[str, os.PathLike], frid: str, module_na
332
333
  return bool(_get_commit_with_frid(Repo(repo_path), frid, module_name))
333
334
 
334
335
 
336
+ def get_frids_regenerated_after_frid(repo_path: Union[str, os.PathLike], frid: str, module_name: str) -> list[str]:
337
+ """The functionalities regenerated after the "fully implemented" commit of `frid`.
338
+
339
+ A reset to that commit removes these regenerations.
340
+ """
341
+ repo = Repo(repo_path)
342
+ commit = _get_commit_with_frid(repo, frid, module_name)
343
+ if not commit:
344
+ return []
345
+
346
+ escaped_module_message = _escape_exact_grep_line(MODULE_NAME_MESSAGE.format(module_name))
347
+ subjects = repo.git.log(f"{commit}..HEAD", "--grep", escaped_module_message, "--format=%s").splitlines()
348
+ regenerated_pattern = re.compile(
349
+ re.escape(FUNCTIONAL_REQUIREMENT_REGENERATED_COMMIT_MESSAGE).replace(re.escape("{}"), "(.+)")
350
+ )
351
+ return [match.group(1) for subject in subjects if (match := regenerated_pattern.fullmatch(subject))]
352
+
353
+
354
+ def _get_last_commit_with_message(repo: Repo, message_template: str, module_name: str) -> str:
355
+ # The "{}" in the template matches any functionality ID.
356
+ escaped_message = _escape_exact_grep_line(message_template).replace("{}", ".*")
357
+ escaped_module_message = _escape_exact_grep_line(MODULE_NAME_MESSAGE.format(module_name))
358
+ return repo.git.rev_list(
359
+ repo.active_branch.name,
360
+ "--grep",
361
+ escaped_message,
362
+ "--grep",
363
+ escaped_module_message,
364
+ "--all-match",
365
+ "-n",
366
+ "1",
367
+ )
368
+
369
+
370
+ def revert_to_last_finished_commit(repo_path: Union[str, os.PathLike], module_name: str) -> Repo:
371
+ """Reset the repo to the newest "fully implemented" or "fully regenerated" commit of `module_name`.
372
+
373
+ The commits and the changes after that commit come from a render that did not finish.
374
+ """
375
+ repo = Repo(repo_path)
376
+ commits = [
377
+ commit
378
+ for commit in (
379
+ _get_last_commit_with_message(repo, FUNCTIONAL_REQUIREMENT_FINISHED_COMMIT_MESSAGE, module_name),
380
+ _get_last_commit_with_message(repo, FUNCTIONAL_REQUIREMENT_REGENERATED_COMMIT_MESSAGE, module_name),
381
+ )
382
+ if commit
383
+ ]
384
+ if not commits:
385
+ raise InvalidGitRepositoryError("Git repository is in an invalid state. No finished functionality was found.")
386
+
387
+ commit = (
388
+ commits[-1]
389
+ if len(commits) == 2 and repo.is_ancestor(repo.commit(commits[0]), repo.commit(commits[1]))
390
+ else commits[0]
391
+ )
392
+ repo.git.reset("--hard", commit)
393
+ repo.git.clean("-xdf")
394
+ return repo
395
+
396
+
335
397
  def _get_base_folder_commit(repo: Repo) -> str:
336
398
  """Finds commit related to copy of the base folder."""
337
399
  return _get_commit_with_message(repo, BASE_FOLDER_COMMIT_MESSAGE)
@@ -448,6 +510,10 @@ def get_last_rendered_functionality(repo_path: Union[str, os.PathLike]) -> tuple
448
510
  return None, None
449
511
 
450
512
  repo = Repo(repo_path)
513
+
514
+ # Only a "fully implemented" commit marks how far the module is rendered. A "fully regenerated"
515
+ # commit sits on top of that frontier, because a single functionality was rendered again in place.
516
+ # Treating it as the frontier would report the regenerated frid as the last rendered one.
451
517
  grep_pattern = FUNCTIONAL_REQUIREMENT_FINISHED_COMMIT_MESSAGE.format(".*")
452
518
  grep_pattern = grep_pattern.replace("[", "\\[").replace("]", "\\]")
453
519
  commit_sha = repo.git.rev_list(repo.active_branch.name, "--grep", grep_pattern, "-n", "1")
@@ -26,6 +26,7 @@ class ModuleRenderer:
26
26
  event_bus: EventBus,
27
27
  stop_event: threading.Event | None = None,
28
28
  enter_pause_event: threading.Event | None = None,
29
+ is_regenerate: bool = False,
29
30
  ):
30
31
  self.codeplainAPI = codeplainAPI
31
32
  self.plain_module = plain_module
@@ -36,12 +37,14 @@ class ModuleRenderer:
36
37
  self.event_bus = event_bus
37
38
  self.stop_event = stop_event
38
39
  self.enter_pause_event = enter_pause_event
40
+ self.is_regenerate = is_regenerate
39
41
 
40
42
  def _build_render_context_for_module(
41
43
  self,
42
44
  plain_module: PlainModule,
43
45
  memory_manager: MemoryManager,
44
46
  render_range: list[str] | None,
47
+ is_regenerate: bool,
45
48
  ) -> RenderContext:
46
49
  return RenderContext(
47
50
  self.codeplainAPI,
@@ -63,6 +66,7 @@ class ModuleRenderer:
63
66
  test_script_timeout=self.args.test_script_timeout,
64
67
  stop_event=self.stop_event,
65
68
  enter_pause_event=self.enter_pause_event,
69
+ is_regenerate=is_regenerate,
66
70
  )
67
71
 
68
72
  def _render_module(
@@ -86,7 +90,12 @@ class ModuleRenderer:
86
90
  render_range = self.render_choice.render_range
87
91
 
88
92
  if render_range is not None:
93
+ if self.is_regenerate:
94
+ plain_module.ensure_frid_can_be_regenerated(render_range[0], self.args.render_conformance_tests)
89
95
  plain_module.ensure_previous_frid_commits_exist(render_range, self.args.render_conformance_tests)
96
+ # A regeneration does not reset the code, so only the other renders can remove one.
97
+ if not self.is_regenerate:
98
+ plain_module.ensure_render_from_keeps_regenerations(render_range[0])
90
99
 
91
100
  has_any_required_module_changed = False
92
101
  if not self.args.render_machine_graph and plain_module.required_modules and not is_render_choice_module:
@@ -121,10 +130,15 @@ class ModuleRenderer:
121
130
  self.codeplainAPI,
122
131
  plain_module.module_memory_folder,
123
132
  )
133
+ # Only the module that owns the target functionality is being regenerated. Required modules
134
+ # are rendered in full, so they must not take the regenerate path.
135
+ is_regenerate = self.is_regenerate and render_range is not None
136
+
124
137
  render_context = self._build_render_context_for_module(
125
138
  plain_module,
126
139
  memory_manager,
127
140
  render_range,
141
+ is_regenerate,
128
142
  )
129
143
 
130
144
  code_renderer = CodeRenderer(render_context)
@@ -139,7 +153,11 @@ class ModuleRenderer:
139
153
  code_renderer.render_context.event_bus.publish(RenderFailed(error_message=error_message))
140
154
  return False, True
141
155
 
142
- plain_module.save_module_metadata()
156
+ # save_module_metadata records "the whole module matches the current spec". After a
157
+ # regenerate only one functionality was rendered, and FinishFunctionalRequirement already
158
+ # updated its metadata entry, so writing the whole baseline would claim too much.
159
+ if not is_regenerate:
160
+ plain_module.save_module_metadata()
143
161
 
144
162
  self.loaded_modules.append(plain_module)
145
163
 
@@ -234,6 +234,26 @@ def change_is_only_future_work(
234
234
  return frids.index(partial_start.frid) > frids.index(plain_module_render_state.last_render_frid)
235
235
 
236
236
 
237
+ def _keep_regenerations(choice: RenderChoice) -> RenderChoice:
238
+ """Start the choice at an earlier regenerated functionality when its render would remove that regeneration.
239
+
240
+ The render resets the code to the functionality before its start. That reset removes a regeneration
241
+ made after it, so the render must start at the regenerated functionality. This renders again the
242
+ functionalities after it, so the user must confirm the choice.
243
+ """
244
+ assert choice.module is not None and choice.render_range is not None
245
+ regenerated_frid = choice.module.get_regenerated_frid_removed_by_render_from(choice.render_range[0])
246
+ if regenerated_frid is None:
247
+ return choice
248
+ return RenderChoice(
249
+ module=choice.module,
250
+ render_range=plain_spec.get_render_range_from(regenerated_frid, choice.module.plain_source),
251
+ choice_type="render_from_regenerated",
252
+ wipe_later_modules=choice.wipe_later_modules,
253
+ is_destructive=True,
254
+ )
255
+
256
+
237
257
  def _resume_render_choice(
238
258
  plain_module: PlainModule,
239
259
  plain_module_render_state: PlainModuleRenderState,
@@ -258,10 +278,12 @@ def _resume_render_choice(
258
278
 
259
279
  next_frid, next_module = plain_module.get_next_frid(pr.last_render_frid, pr.last_render_module.module_name)
260
280
  render_range = plain_spec.get_render_range_from(next_frid, next_module.plain_source)
261
- return RenderChoice(
262
- module=next_module,
263
- render_range=render_range,
264
- choice_type="continue_from_frid",
281
+ return _keep_regenerations(
282
+ RenderChoice(
283
+ module=next_module,
284
+ render_range=render_range,
285
+ choice_type="continue_from_frid",
286
+ )
265
287
  )
266
288
 
267
289
  next_module = plain_module.get_next_module(pr.last_render_module.module_name) or pr.last_render_module
@@ -323,12 +345,14 @@ def get_render_choices(
323
345
  # module's earlier (unchanged) functionalities.
324
346
  render_range = plain_spec.get_render_range_from(partial_start.frid, partial_start.module.plain_source)
325
347
  render_choices.append(
326
- RenderChoice(
327
- module=partial_start.module,
328
- render_range=render_range,
329
- choice_type="render_from_change",
330
- wipe_later_modules=len(all_affected_modules) > 1,
331
- is_destructive=True,
348
+ _keep_regenerations(
349
+ RenderChoice(
350
+ module=partial_start.module,
351
+ render_range=render_range,
352
+ choice_type="render_from_change",
353
+ wipe_later_modules=len(all_affected_modules) > 1,
354
+ is_destructive=True,
355
+ )
332
356
  )
333
357
  )
334
358
 
@@ -339,10 +339,23 @@ def render( # noqa: C901
339
339
  event_bus: EventBus,
340
340
  default_log_level: str = "INFO",
341
341
  ):
342
- # Compute render range from either --render-range or --render-from
342
+ # Compute render range from either --render-range, --render-from, or --regenerate
343
343
  render_range = None
344
- if args.render_range or args.render_from:
345
- render_range = plain_spec.compute_render_range(args, plain_module.plain_source)
344
+ is_regenerate = False
345
+ if args.render_range or args.render_from or args.regenerate:
346
+ if args.regenerate:
347
+ frids = list(plain_spec.get_frids(plain_module.plain_source))
348
+ if args.regenerate not in frids:
349
+ raise InvalidFridArgument(
350
+ f"Cannot regenerate functionality {args.regenerate} because module {plain_module.module_name} "
351
+ f"has no such functionality. Its functionalities are: {', '.join(frids)}."
352
+ )
353
+ render_range = plain_spec.get_render_range(
354
+ args.regenerate + "," + args.regenerate, plain_module.plain_source
355
+ )
356
+ is_regenerate = True
357
+ else:
358
+ render_range = plain_spec.compute_render_range(args, plain_module.plain_source)
346
359
 
347
360
  run_state.user_email = _check_connection(codeplainAPI)
348
361
 
@@ -369,7 +382,7 @@ def render( # noqa: C901
369
382
  module.reconcile_metadata_with_git()
370
383
 
371
384
  render_choice = None
372
- if render_range is None:
385
+ if render_range is None and not is_regenerate:
373
386
  plain_module_render_state = get_plain_module_render_state(plain_module, args.render_conformance_tests)
374
387
  if plain_module_render_state is not None:
375
388
  render_choices = get_render_choices(plain_module, plain_module_render_state, args.force_render)
@@ -418,6 +431,7 @@ def render( # noqa: C901
418
431
  event_bus,
419
432
  stop_event=stop_event,
420
433
  enter_pause_event=enter_pause_event,
434
+ is_regenerate=is_regenerate,
421
435
  )
422
436
 
423
437
  render_error: list[Exception] = []
@@ -346,6 +346,12 @@ def create_parser():
346
346
  help="Continue generation starting from this specific functionality (e.g. `add-task`). "
347
347
  "The functionality with this ID will be included in the output. The functionality ID must match one of the functionalities in your plain file.",
348
348
  )
349
+ render_range_group.add_argument(
350
+ "--regenerate",
351
+ type=frid_string,
352
+ help="Regenerate a single already-rendered functionality (e.g. `add-task`). "
353
+ "The functionality ID must match one of the functionalities in your plain file.",
354
+ )
349
355
 
350
356
  _add_arg(
351
357
  parser,
@@ -374,6 +374,11 @@ class PlainModule:
374
374
  functionalities.append(functionality)
375
375
  metadata[MODULE_FUNCTIONALITIES] = functionalities
376
376
 
377
+ # source_hash claims the code implements the whole spec, so only stamp it when that is
378
+ # true. Regenerating one functionality leaves the other functionalities as they were.
379
+ if self._metadata_matches_spec(metadata):
380
+ metadata["source_hash"] = self.get_module_source_hash()
381
+
377
382
  metadata_utils.write_metadata(self.module_metadata_path(), metadata)
378
383
 
379
384
  def _unique_chain(self) -> list[tuple[str, dict]]:
@@ -393,6 +398,13 @@ class PlainModule:
393
398
  chain.append((module.module_name, module.plain_source))
394
399
  return chain
395
400
 
401
+ def _metadata_matches_spec(self, metadata: dict) -> bool:
402
+ """Whether the given metadata already describes the module's current spec."""
403
+ if metadata.get(MODULE_FUNCTIONALITIES) != self._get_module_functional_requirements():
404
+ return False
405
+
406
+ return metadata.get("non_functional_source_hash") == self.get_module_non_functional_source_hash()
407
+
396
408
  def get_module_source_hash(self) -> str:
397
409
  return plain_spec.get_hash_value([self.plain_source] + self.resources_list)
398
410
 
@@ -580,6 +592,63 @@ class PlainModule:
580
592
  f" codeplain {self.module_name}{plain_file.PLAIN_SOURCE_FILE_EXTENSION} --render-from {frid}"
581
593
  )
582
594
 
595
+ def ensure_frid_can_be_regenerated(self, frid: str, render_conformance_tests: bool) -> None:
596
+ """Stop a regeneration of a functionality that was never fully rendered.
597
+
598
+ Only a rendered functionality can be generated again. This check runs before the required
599
+ modules are rendered, so a regeneration that cannot run uses no credits.
600
+
601
+ A module rendered without conformance tests has no conformance tests folder. A regeneration
602
+ with conformance tests would fail when it commits the new tests, and the earlier
603
+ functionalities would have no tests for the regression pass.
604
+ """
605
+ if not os.path.exists(self.module_build_folder) or not git_utils.has_commit_for_frid(
606
+ self.module_build_folder, frid, self.module_name
607
+ ):
608
+ raise MissingPreviousFunctionalitiesError(
609
+ f"Cannot regenerate functionality {frid} because it has not been fully rendered yet. "
610
+ f"Please render all functionalities first by running:\n"
611
+ f" codeplain {self.module_name}{plain_file.PLAIN_SOURCE_FILE_EXTENSION}"
612
+ )
613
+
614
+ if render_conformance_tests and not os.path.exists(self.module_conformance_tests_folder):
615
+ raise MissingPreviousFunctionalitiesError(
616
+ f"Cannot regenerate functionality {frid} because module {self.module_name} was rendered "
617
+ f"without conformance tests. Render the module again with conformance tests:\n"
618
+ f" codeplain {self.module_name}{plain_file.PLAIN_SOURCE_FILE_EXTENSION}"
619
+ )
620
+
621
+ def get_regenerated_frid_removed_by_render_from(self, start_frid: str) -> str | None:
622
+ """The earliest functionality before `start_frid` whose regeneration a render from `start_frid` removes.
623
+
624
+ A render from `start_frid` resets the code to the "fully implemented" commit of the functionality
625
+ before it. A regeneration made after that commit is removed by the reset. The functionalities from
626
+ `start_frid` on render again, so only a regeneration of an earlier functionality is lost.
627
+ """
628
+ previous_frid = plain_spec.get_previous_frid(self.plain_source, start_frid)
629
+ if previous_frid is None or not os.path.exists(self.module_build_folder):
630
+ return None
631
+
632
+ regenerated_frids = git_utils.get_frids_regenerated_after_frid(
633
+ self.module_build_folder, previous_frid, self.module_name
634
+ )
635
+ for frid in plain_spec.get_frids_before(self.plain_source, start_frid):
636
+ if frid in regenerated_frids:
637
+ return frid
638
+ return None
639
+
640
+ def ensure_render_from_keeps_regenerations(self, start_frid: str) -> None:
641
+ """Stop a render from `start_frid` that would remove the regeneration of an earlier functionality."""
642
+ regenerated_frid = self.get_regenerated_frid_removed_by_render_from(start_frid)
643
+ if regenerated_frid is None:
644
+ return
645
+ raise MissingPreviousFunctionalitiesError(
646
+ f"Cannot render from functionality {start_frid} of module {self.module_name}. "
647
+ f"Functionality {regenerated_frid} was regenerated, and a render from functionality {start_frid} "
648
+ f"would remove that regeneration. Render from functionality {regenerated_frid} instead:\n"
649
+ f" codeplain {self.module_name}{plain_file.PLAIN_SOURCE_FILE_EXTENSION} --render-from {regenerated_frid}"
650
+ )
651
+
583
652
  def ensure_previous_frid_commits_exist(self, render_range: list[str], render_conformance_tests: bool) -> None:
584
653
  """
585
654
  Ensure that all FRID commits before the render_range exist.
@@ -10,9 +10,8 @@ class CommitConformanceTestsChanges(BaseAction):
10
10
  SUCCESSFUL_OUTCOME_IMPLEMENTATION_NOT_UPDATED = "conformance_tests_changes_committed_implementation_not_updated"
11
11
  SUCCESSFUL_OUTCOME_IMPLEMENTATION_UPDATED = "conformance_tests_changes_committed_implementation_updated"
12
12
 
13
- def __init__(self, implementation_code_commit_message: str, conformance_tests_commit_message: str):
13
+ def __init__(self, implementation_code_commit_message: str):
14
14
  self.implementation_code_commit_message = implementation_code_commit_message
15
- self.conformance_tests_commit_message = conformance_tests_commit_message
16
15
 
17
16
  def execute(self, render_context: RenderContext, _previous_action_payload: Any | None):
18
17
  implementation_updated = False
@@ -26,8 +25,13 @@ class CommitConformanceTestsChanges(BaseAction):
26
25
  )
27
26
  implementation_updated = True
28
27
 
28
+ conformance_tests_commit_message = (
29
+ git_utils.FUNCTIONAL_REQUIREMENT_REGENERATED_COMMIT_MESSAGE
30
+ if render_context.is_regenerate
31
+ else git_utils.FUNCTIONAL_REQUIREMENT_FINISHED_COMMIT_MESSAGE
32
+ )
29
33
  functional_requirement_text = render_context.frid_context.specifications[plain_spec.FUNCTIONAL_REQUIREMENTS][-1]
30
- templated_functional_requirement_finished_commit_msg = self.conformance_tests_commit_message.format(
34
+ templated_functional_requirement_finished_commit_msg = conformance_tests_commit_message.format(
31
35
  render_context.frid_context.frid
32
36
  )
33
37
  formatted_conformance_commit_msg = (
@@ -18,13 +18,14 @@ class ExitWithError(BaseAction):
18
18
  render_context.last_error_message = error_message
19
19
  console.error(error_message)
20
20
 
21
- render_context.codeplain_api.fail_functional_requirement(
22
- render_context.frid_context.frid,
23
- module_name=render_context.module_name,
24
- run_state=render_context.run_state,
25
- )
26
-
21
+ # A render can fail before any functionality is started, for example when a regeneration is
22
+ # not possible. There is then no functionality to report as failed.
27
23
  if render_context.frid_context is not None:
24
+ render_context.codeplain_api.fail_functional_requirement(
25
+ render_context.frid_context.frid,
26
+ module_name=render_context.module_name,
27
+ run_state=render_context.run_state,
28
+ )
28
29
  console.info(
29
30
  f"To continue rendering from the last successfully rendered functionality, "
30
31
  f"provide the --render-from {render_context.frid_context.frid} flag."
@@ -0,0 +1,33 @@
1
+ from typing import Any
2
+
3
+ import git_utils
4
+ from render_machine.actions.base_action import BaseAction
5
+ from render_machine.render_context import RenderContext
6
+
7
+
8
+ class FinishFunctionalRequirement(BaseAction):
9
+ SUCCESSFUL_OUTCOME = "functional_requirement_finished"
10
+
11
+ def execute(self, render_context: RenderContext, _previous_action_payload: Any | None):
12
+ render_context.plain_module.update_frid_in_module_metadata(render_context.frid_context.frid)
13
+
14
+ commit_message = (
15
+ git_utils.FUNCTIONAL_REQUIREMENT_REGENERATED_COMMIT_MESSAGE
16
+ if render_context.is_regenerate
17
+ else git_utils.FUNCTIONAL_REQUIREMENT_FINISHED_COMMIT_MESSAGE
18
+ )
19
+ git_utils.add_all_files_and_commit(
20
+ render_context.build_folder,
21
+ commit_message.format(render_context.frid_context.frid),
22
+ render_context.module_name,
23
+ render_context.frid_context.frid,
24
+ render_context.run_state.render_id,
25
+ )
26
+
27
+ render_context.codeplain_api.finish_functional_requirement(
28
+ render_context.frid_context.frid,
29
+ module_name=render_context.module_name,
30
+ run_state=render_context.run_state,
31
+ )
32
+
33
+ return self.SUCCESSFUL_OUTCOME, None
@@ -246,8 +246,27 @@ class FixUnitTests(BaseAction):
246
246
  )
247
247
  if current:
248
248
  sections.append(f"### Module: {render_context.module_name} (Currently Being Implemented)\n{current[-1]}")
249
+ later = FixUnitTests._functionalities_after_regenerated_one(render_context)
250
+ if later:
251
+ sections.append(
252
+ f"### Module: {render_context.module_name} (Already Implemented, for context)\n" + "\n".join(later)
253
+ )
249
254
  return "\n\n".join(sections)
250
255
 
256
+ @staticmethod
257
+ def _functionalities_after_regenerated_one(render_context: RenderContext) -> list[str]:
258
+ """The specs of the functionalities after the regenerated one, as their code implements them.
259
+
260
+ A regeneration renders one functionality again, and the functionalities after it keep their
261
+ code. Without their specs, the agent can change their code to agree with a wrong unit test.
262
+ """
263
+ if not render_context.is_regenerate:
264
+ return []
265
+ stored = render_context.plain_module.load_module_metadata()["functionalities"]
266
+ stored_frids = [functionality["id"] for functionality in stored]
267
+ position = stored_frids.index(render_context.frid_context.frid)
268
+ return [functionality["markdown"] for functionality in stored[position + 1 :]]
269
+
251
270
  @staticmethod
252
271
  def _read_script(script: str | None) -> str:
253
272
  if not script:
@@ -7,12 +7,17 @@ from memory_management import MemoryManager
7
7
  from plain2code_console import console
8
8
  from render_machine.actions.base_action import BaseAction
9
9
  from render_machine.render_context import RenderContext
10
+ from render_machine.render_types import RenderError
10
11
 
11
12
 
12
13
  class PrepareRepositories(BaseAction):
13
14
  SUCCESSFUL_OUTCOME = "repositories_prepared"
15
+ REGENERATE_NOT_POSSIBLE_OUTCOME = "regenerate_not_possible"
14
16
 
15
17
  def execute(self, render_context: RenderContext, _previous_action_payload: Any | None):
18
+ if render_context.is_regenerate:
19
+ return self._prepare_regenerate(render_context)
20
+
16
21
  if render_context.render_range is not None and render_context.render_range[0] != plain_spec.get_first_frid(
17
22
  render_context.plain_source_tree
18
23
  ):
@@ -87,3 +92,66 @@ class PrepareRepositories(BaseAction):
87
92
  )
88
93
 
89
94
  return self.SUCCESSFUL_OUTCOME, None
95
+
96
+ def _regenerate_not_possible(self, render_context: RenderContext, error_message: str):
97
+ # The error goes back as the outcome, so the state machine runs ExitWithError, which logs it.
98
+ # Dispatching the error from inside this action would end the render before that step runs,
99
+ # and the user would see no reason.
100
+ render_context.last_error_message = error_message
101
+ return self.REGENERATE_NOT_POSSIBLE_OUTCOME, RenderError.encode(message=error_message).to_payload()
102
+
103
+ def _prepare_regenerate(self, render_context: RenderContext):
104
+ frid = render_context.render_range[0]
105
+
106
+ if not git_utils.has_commit_for_frid(render_context.build_folder, frid, render_context.module_name):
107
+ return self._regenerate_not_possible(
108
+ render_context,
109
+ f"Cannot regenerate functionality {frid} because it has not been fully rendered yet. "
110
+ f"Please render all functionalities first by running: "
111
+ f"codeplain {render_context.module_name}.plain",
112
+ )
113
+
114
+ render_context.starting_frid = frid
115
+
116
+ module_metadata = render_context.plain_module.load_module_metadata()
117
+ if not module_metadata or "functionalities" not in module_metadata:
118
+ return self._regenerate_not_possible(
119
+ render_context,
120
+ "module_metadata.json is missing or incomplete. Please re-render the module from the beginning.",
121
+ )
122
+
123
+ stored_functionalities = module_metadata["functionalities"]
124
+ old_functionality = next((stored for stored in stored_functionalities if stored["id"] == frid), None)
125
+ if old_functionality is None:
126
+ return self._regenerate_not_possible(
127
+ render_context,
128
+ f"module_metadata.json holds no functionality {frid}. "
129
+ "Please re-render the module from the beginning.",
130
+ )
131
+
132
+ render_context.old_frid_spec = old_functionality["markdown"]
133
+ # The specs the code on disk currently implements (code-truth). Sent to the API so the
134
+ # regeneration prompt shows the old spec for any changed-but-not-yet-regenerated FR,
135
+ # keeping specs and code in sync.
136
+ render_context.code_functional_requirements = [stored["markdown"] for stored in stored_functionalities]
137
+
138
+ # An interrupted regeneration leaves its commits and changes on top of the last finished
139
+ # functionality. Remove them, so that this regeneration starts from finished code and tests.
140
+ git_utils.revert_to_last_finished_commit(render_context.build_folder, render_context.module_name)
141
+ if render_context.render_conformance_tests:
142
+ git_utils.revert_to_last_finished_commit(
143
+ render_context.conformance_tests.get_module_conformance_tests_folder(render_context.module_name),
144
+ render_context.module_name,
145
+ )
146
+ conformance_tests_json = render_context.conformance_tests.get_conformance_tests_json(
147
+ render_context.module_name
148
+ )
149
+ if frid in conformance_tests_json:
150
+ old_folder = conformance_tests_json[frid]["folder_name"]
151
+ file_utils.delete_folder(old_folder)
152
+ del conformance_tests_json[frid]
153
+ render_context.conformance_tests.dump_conformance_tests_json(
154
+ render_context.module_name, conformance_tests_json
155
+ )
156
+
157
+ return self.SUCCESSFUL_OUTCOME, None