codeplain 0.2.20__py3-none-any.whl → 0.3.0__py3-none-any.whl

_version.py

@@ -1 +1 @@
-__version__ = "0.2.20"
+__version__ = "0.3.0"

{codeplain-0.2.20.dist-info → codeplain-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeplain
-Version: 0.2.20
+Version: 0.3.0
 Summary: Transform plain language specifications into working code
 License-File: LICENSE
 Classifier: Environment :: Console
@@ -8,13 +8,13 @@ Classifier: Intended Audience :: Developers
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Code Generators
 Requires-Python: ==3.11
-Requires-Dist: gitpython==3.1.42
+Requires-Dist: gitpython==3.1.50
 Requires-Dist: mistletoe==1.3.0
 Requires-Dist: networkx==3.6.1
 Requires-Dist: python-frontmatter==1.1.0
 Requires-Dist: python-liquid2==0.3.0
-Requires-Dist: pyyaml==6.0.2
-Requires-Dist: requests==2.32.4
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: requests==2.34.0
 Requires-Dist: rich==14.2.0
 Requires-Dist: textual>=7.5.0
 Requires-Dist: tiktoken==0.12.0
@@ -115,7 +115,7 @@ After completing the installation steps above, you can immediately test the syst
 
 ### Documentation
 
-- For more details on the ***plain format, see the [***plain language specification](https://www.plainlang.org/docs/intro/).
+- For more details on the ***plain format, see the [***plain language specification](https://www.plainlang.org/docs/).
 - For step-by-step instructions for creating your first ***plain project see the [Kickstart your ***plain project](docs/starting_a_plain_project_from_scratch.md).
 - For complete CLI documentation and usage examples, see [plain2code CLI documentation](docs/plain2code_cli.md).
 

{codeplain-0.2.20.dist-info → codeplain-0.3.0.dist-info}/RECORD

@@ -1,59 +1,60 @@
-_version.py,sha256=PP1XN3LVw4efHZSwpFDbQRezvRqPg1JqZ--H2vUombw,23
-codeplain_REST_api.py,sha256=s7rgQIgpuwR3_CEpzXJfIHuAokhGDkFgaKMKVVYm-KY,19812
-concept_utils.py,sha256=vwSY4-FmxyqaDBxhntYzqG8t9pXvAWwiULP0DYQI32o,7905
+_version.py,sha256=VrXpHDu3erkzwl_WXrqINBm9xWkcyUy53IQOj042dOs,22
+codeplain_REST_api.py,sha256=Z1WV67_Xtw2li1wQyVnhrqr-Ymu_BWp9AdB4YjImIhw,21258
+concept_utils.py,sha256=VLHur80-XSJTveClLiHb-CMuqsXd8sIQAr0Ehe1Hid0,7930
 diff_utils.py,sha256=AjiQlqo5pRos_8hVXZo5yBurl5BzSrTMGrQv4dCtRCg,1198
 event_bus.py,sha256=g5XLwRfjrvTIcB6urjREuCJzZj5TA93hy8lKXLGXuCE,650
-file_utils.py,sha256=YW2UvO6i-Jv5FNyreI6fNfhbAYDdypgLiGJuPPdrEoc,12474
-git_utils.py,sha256=3tW4B9Pr-HAILs0SjMaaLic0Mq_G1R4HdvKRnKf6uj4,14349
+file_utils.py,sha256=eO_SHwyjJlkwT3wTlIjIEQ3t8y3k0i-fWKAn5_1SMkY,12597
+git_utils.py,sha256=LQQnL5DAFpH5fDBQgUZX2WfjWY4YC5OEGBPIXryTmnY,16896
 hash_key.py,sha256=lMKgKpOhPeC4UpFf9e7eCNK20FEaDsXTCJ8j3eCWidE,837
 memory_management.py,sha256=G42roiUSgX8sqDnkfb7XYtYWZqlOQ3DIpMbi0pcOKZA,6079
-module_renderer.py,sha256=AQKFwggggpugd77jQylI5gSJyLAiM5r035NVDEidbvQ,12582
-plain2code.py,sha256=NwJ0BnbLipFn-wvxpo3S5m-SLeYqOLiGzIlS1bQhOYw,15306
-plain2code_arguments.py,sha256=ILunswU492aDifybU-CDi85vcb01IudupfAX4nwc5EM,14420
+module_renderer.py,sha256=HfxqzwK5nj0EXC2hx5y6IYY3kVeCMJnPRFoqfFLvaF4,6936
+partial_rendering.py,sha256=kZP23kzR__J4ajpo6pmklFpVOoJcaQkgqC5KuLjS--A,7951
+plain2code.py,sha256=BvFbgFihS6pW6T5Hferu5HpyC5SFlEe__iAu1KJy0NY,13368
+plain2code_arguments.py,sha256=l2K7LVjGe230xwk8K0Q9jkbohBu-4hDJYhueFLPsXMc,14502
 plain2code_console.py,sha256=dSkuwUHS0ufUy24y8sloL3uedDDdXPuFDkBaanp1Cug,4820
-plain2code_events.py,sha256=Q6HyXpsARXOOxgcTYw3yQbIu8exHwnLlJTMAf2W_0-o,1395
-plain2code_exceptions.py,sha256=t5bq1ZKGeeezjg52NRkna-ohO57L1DXkVnz1PWshgyI,1576
-plain2code_logger.py,sha256=Oq0cYSnUz80FgUp5MTWDla7lk2j-6U3p0jVc7eNh7fM,3063
-plain2code_nodes.py,sha256=Om624mfb5MB1Z09c0Zqtb9G1gGkUY9x-v2hzAf3A2gw,3818
+plain2code_events.py,sha256=AM8KJS68uiVXRMLt861KaGhs2H4yzujlMB_xiYPfHQc,1478
+plain2code_exceptions.py,sha256=g3wMOnjpQlk2pdKRvVarnuh9BlOsRV2AKm_CoNidmH4,1629
+plain2code_logger.py,sha256=j376mlCTU-EN_mv06rRY2Rp_47CHzEo6b5wvhlmp0fY,3217
+plain2code_nodes.py,sha256=IwjQqJxRSJKgP6eEnkYGy3VQHIyoazgkFxAEkxkjfJ8,4426
 plain2code_read_config.py,sha256=D5CxnmTRjddupecWvstcUm0kIJWWzq5-Zmk6sU0wbIg,2235
 plain2code_state.py,sha256=UN3iD3rfJkGK4QQx4RxueQrCy9ngHqExtzxiSEgrW2E,2117
 plain2code_utils.py,sha256=CLvysMiwChAVaKdqJjkUUlDCQ8dGIFPz1NG7cLbFZuI,2236
-plain_file.py,sha256=cZbr8hRRRgLgnB4Vym0-qi1_-vgG6aPKeBgxLOiPXzA,28392
-plain_modules.py,sha256=6gteJeiK-WvUZDrIt_kJK0MFiptq63rEVpYvV5yYFXc,4881
-plain_spec.py,sha256=BlCKCadkW08mNoWBJm0Ygk22o_bH_qDJVSchiFiUIGw,14051
+plain_file.py,sha256=hiyFdB548sYG9T2NILhGM63dcSgbRzy_y5atX5YabUg,29172
+plain_modules.py,sha256=pC-cFFRmVNfloscqS7uPjaPF0Dw2NFn9fIQNUP2j0ys,14333
+plain_spec.py,sha256=E2Yp2eXMExE7kx7GPQ7v9boHN8XhFUcqprn1DGMaFMs,15669
 system_config.py,sha256=DMyfiq_uzxWH_uXz5vMWNHkcRFPkIA-M8nr64SeVhPo,1350
 config/__init__.py,sha256=beYSsJWmBNHDP5rYmVDouqgEeP3t1lkkepbXJ-oq0F8,37
 config/system_config.yaml,sha256=of5R9vukSohU9AlkGJOcAVQA1UJgxYmDy6islU6iFuE,508
 docs/generate_cli.py,sha256=0FHVhICbM8g7ahdInTNih3hNKpty1wbV5rdGECMJj48,656
 examples/example_hello_world_python/harness_tests/hello_world_display/test_hello_world.py,sha256=dwTowrHiVKKbrDv21v8xJC30Q57AXZkQasdGOO5JsBE,470
 render_machine/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-render_machine/code_renderer.py,sha256=86Hnq1bUpk24oUWWPkwWyNWxx_FB-FOj79cwSrdmMpc,3357
+render_machine/code_renderer.py,sha256=TEHdlEOB-seMGeEo1rg5kaIL3pkub7CnU2X8eZNc8G4,3762
 render_machine/conformance_test_helpers.py,sha256=6Ru7Dh24SLNIKWfz_sP5hE_EmWpvk6nfgN1T1yaCZus,2887
-render_machine/conformance_tests.py,sha256=SHDGMDw--fO4mglEEG5sGecc-uFbG-XNZl017idi-ms,7222
+render_machine/conformance_tests.py,sha256=y7dhmsFgq7LpaeuLDM5nc1_1HoPo0wkPd3JdaRPxA0Y,7229
 render_machine/implementation_code_helpers.py,sha256=LdHNLoKgVtrDaGH2APX8C9vjNjLBUhu2V7OAaJvm4rM,2009
-render_machine/render_context.py,sha256=hwkXlcfVocVgWIaVtx3v8Zq4X2vRLs8LJAUW2M7-Pw8,21876
-render_machine/render_types.py,sha256=9buUCyiM1Y8yth_c5AaalSNHfYOs-sOq0_ctbsJHYuw,7505
-render_machine/render_utils.py,sha256=uTZkThRQXHd9zZ3um2LA1bzlNKES0QUC4vDSJCYTIKk,9371
+render_machine/render_context.py,sha256=gu1_TjWjiHVlpx3qlDLg0PYI58rYX8YY7xFCoBahems,29133
+render_machine/render_types.py,sha256=iqRd9MyrRnXasoA8rvssZbCN66BbVCVXH5uFA8QJVXY,9222
+render_machine/render_utils.py,sha256=LIeFJPCj4uPLhyi-LVOr_oNXEKWvE86qpwnPk9u5Vgg,9451
 render_machine/state_machine_config.py,sha256=1nVddQBnJsbdUYCNK813QnLZH2D4krz0vqHe2K8LDS8,28212
 render_machine/states.py,sha256=niFXqayyA_rezCrlzo0hYeHAruErcPzQVF-BeIBGnL8,1968
 render_machine/triggers.py,sha256=o1N5c9xC7fsKY6ZaWcWBtALT8i1acSSharAXKAqBu8E,1285
-render_machine/actions/analyze_specification_ambiguity.py,sha256=ND2uwF0yREdzg0OaEQtZIk8hoWOzq8KKS7WIBgEzDfM,2824
+render_machine/actions/analyze_specification_ambiguity.py,sha256=SykZAozGvr1jySxbpKCgt11nMpZhOK0sN-J66M42T5Y,2847
 render_machine/actions/base_action.py,sha256=vVzMp-LanrZyq-jamHyWaQxpRl-pLqtTdtiEzUBhfyE,534
 render_machine/actions/commit_conformance_tests_changes.py,sha256=08yxCPCpf5TlrzLPsEh5SJXVVvnLfwdNKSr7BlzlYxo,2589
 render_machine/actions/commit_implementation_code_changes.py,sha256=yi51oAArLCgWcmFbynes-BK2IGnZwA7wygrTJGoL8dY,826
 render_machine/actions/create_dist.py,sha256=xMPPyws7swVkaUSQg3dwMGScCi1BuII9y2C_XSP0N80,1067
 render_machine/actions/exit_with_error.py,sha256=-LkQsFhmV-Nr741APTx38dqu473b6OSiIvKayFFsXxI,1270
 render_machine/actions/finish_functional_requirement.py,sha256=tj9CzuxuHcbR-2-jMLcAM0gOAcbWpMLg9HIiyngI6gU,739
-render_machine/actions/fix_conformance_test.py,sha256=bG4PSvm2Cg9d_8ERMIVtJ7KXrt7EJuoFg7K_x4Cs9Kg,7498
-render_machine/actions/fix_unit_tests.py,sha256=8cx7SbxoODNxNcFkD4jci0w-WDBzDviGx91firgRELg,2555
-render_machine/actions/prepare_repositories.py,sha256=u6SjvMIb-1G4LBVaDuzHUEF1OJ7GAiHySvrdap7SXCg,3163
+render_machine/actions/fix_conformance_test.py,sha256=aYf3j-q7HnZGB9M1qEMpYqLyCUMqWJR9T6VZqn-oWrA,8972
+render_machine/actions/fix_unit_tests.py,sha256=AWrzaLpd-PuIBt_udzaQCRhlGyPIIgMrlzIDum9Xl8E,2409
+render_machine/actions/prepare_repositories.py,sha256=jaRrOGnTR54e8UdaeaX7T73h2rdPJ3IDAQ5mrKHdFgw,3547
 render_machine/actions/prepare_testing_environment.py,sha256=Rvj0LNuQ6anP-3fBr2FmDurt7XrPM-GUREqz3c87jTg,1950
-render_machine/actions/refactor_code.py,sha256=0zAmG_UJqU7Ye4y-F4ZU39djq5ujG44a-heM30G2Z08,2161
-render_machine/actions/render_conformance_tests.py,sha256=OB-_eqo8w6xzRwvUHQA8uLF4BZs7TqUjip-BIT1re8A,8882
+render_machine/actions/refactor_code.py,sha256=slDnx37RLDP4ACiIv0b3u6JTsYPyfyLY-2oXGUM8ko4,1970
+render_machine/actions/render_conformance_tests.py,sha256=J2p_urgayUNtGlmdZ8NWuE1nvDgOQHpir2ESHcAfD6U,9587
 render_machine/actions/render_functional_requirement.py,sha256=tr0SqG25v3PwUCVgrx4eB8-Xh6ibab0H5IK3nMmULlg,3955
 render_machine/actions/run_conformance_tests.py,sha256=WtMSFTYfWFR6bBh3rZ7n5oc7jDDsxnTEdRi-kN1cj4o,4075
 render_machine/actions/run_unit_tests.py,sha256=zCu3yJbJ0JkiB7lZbgBwsVs_qiFtrlyN2T3xf5A_gPg,2176
-render_machine/actions/summarize_conformance_tests.py,sha256=CpXhvtWSUKEj1cjtRycKm6VbXHkkIZRgCzpCge4Fifw,1849
+render_machine/actions/summarize_conformance_tests.py,sha256=Vy1kRK8vyazK_BbsKuz1MLDN_TQWVxxzkwEEm-50byc,1639
 standard_template_library/__init__.py,sha256=LtsHl0c3VV46DUInIqyOw4KKVoxKEMOx8dAZpMXtAXc,43
 standard_template_library/golang-console-app-template.plain,sha256=JOusEjCj7jagnXUzaI-SdIr3hj1wTo2uShK017aNtVM,949
 standard_template_library/python-console-app-template.plain,sha256=HW-REeF8Crk0r_w4-MxnleVHeW6PdOB2C8gO8FDG61g,931
@@ -61,23 +62,27 @@ standard_template_library/typescript-react-app-boilerplate.plain,sha256=6LFxhEOz
 standard_template_library/typescript-react-app-template.plain,sha256=DN5wEJcT8ZqQTf0vFKi9Z1isi9cin2UVNOZb3r28d3M,715
 tests/__init__.py,sha256=Wk73Io62J15BtlLVIzxmASDWaaJkQLevS4BLK5LDAQg,16
 tests/conftest.py,sha256=QZcp08htUlJGgmHDlRWFgsWXZ8o8IBWTD5QqJaUMlU8,790
-tests/test_git_utils.py,sha256=MMHEY92LLKkzCldHAqR5A9CyHDCQgl_-IVReLyDg050,12957
+tests/test_file_utils.py,sha256=-O5zImiFVz9JJ4xi8TbsUwNgPFQoQUOl9Frls4BHCBI,1358
+tests/test_git_utils.py,sha256=h3rWhhs4XVRYqzVzdmj51siF_AYD-GkbZiefK2iGfWo,15614
 tests/test_imports.py,sha256=EWYLUxGunUUdsG9iCiY_tts6T7DIVdhdB_MZlB1LsmU,2081
-tests/test_plainfile.py,sha256=fXuZhk2It-EwrWXuBaWuUdH7HZAOfzAhYwmpJ0ErIro,11007
-tests/test_plainfileparser.py,sha256=lIdAHCZltFB604ECE7OKvQfd3Hfagzy0KMEipUnnzsY,18654
+tests/test_partial_rendering.py,sha256=4xXZhy9yStn0awSw8B-yrJ3kVYyzJrlR-dKwg9ODXMY,11188
+tests/test_plain_modules.py,sha256=9bWsketDnjpCWkCbMZzYvLqT1ojPhLyxxKljPUq42oY,11393
+tests/test_plainfile.py,sha256=wZ_PN4GULPWIpl_AK_r_6jkgtX0Ch8EHmN5IhX7huOE,11027
+tests/test_plainfileparser.py,sha256=iVTAJWxQZbv96uHXe-qvGSgsC9uJk5Tu10Nod3kqflI,18666
 tests/test_plainspec.py,sha256=JrzjJ4VFYDmWTZDq-8WFyt2oMx76IEuO1CAUPQeGOsw,2404
 tests/test_requires.py,sha256=6tnHYaKudxN-RiQjSFoi9nHe_x0ze3QF-f-j67zAE74,1250
 tests/test_resolve_config_file.py,sha256=b87tDOvyzbsnE-QRWbZ97ou7NuyaAgskv-dbYBum31c,2830
 tui/__init__.py,sha256=_fy7FowY0RkWdn4kC7XV2jgvQPCj-2gE8fNUb-Mny0A,60
-tui/components.py,sha256=Zj7Em_8Z06hjfhSB3RuaQHhILBkekRKyuLQ406PeTkc,23915
+tui/components.py,sha256=G6ktJx211WrYmj-1aZL3mFtnBTOE4WRF3hA1LG8J0jU,25810
 tui/models.py,sha256=KMjlWubmPD41GA-BjgiqkaV9v7tLJ0fuWKBDPmZj4JA,1493
-tui/plain2code_tui.py,sha256=NeiuB4juX2sNKcAuv4JNIbgn8WPLWg9WbLCTX-jacZQ,13496
+tui/plain2code_tui.py,sha256=_c8gaEZeFPvr1-uqpQAsacpHd77Ig16x045Q4ihfwuc,13076
+tui/plain_module_render_choice_tui.py,sha256=ZiB7E2mgFN9v0WHZeDfhLvfYURg1IPcQpC5dvHQwzqA,8499
 tui/spinner.py,sha256=Ro6Gd9Przf-whuHqPRY6HwI0T57yJjyNPbhDbigZKZE,2471
-tui/state_handlers.py,sha256=NCAu-Pv2Bc8HG5GHaV47kwZHtbCOh_mBYQAW7DbN0jg,15927
-tui/styles.css,sha256=XrGdtAjyscJL3Rey2gT0rbuRnMnXgePGiAqySKlcezs,6133
-tui/widget_helpers.py,sha256=hQKlURgdSC8RT6QgKPzRhSRAIO1bMoLuM3lz_sCc3FU,5819
-codeplain-0.2.20.dist-info/METADATA,sha256=iW5pYQEWz1D_i9OSv7g6q8uGIfThMF5kD_ygxFmWzqA,4210
-codeplain-0.2.20.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-codeplain-0.2.20.dist-info/entry_points.txt,sha256=oDZkBqu9WhtZApb_K6ia8-fn9aojwmAsgnKELceX5T4,46
-codeplain-0.2.20.dist-info/licenses/LICENSE,sha256=pCeKgQ1mXE5OmNUuKOfOZh1T1vqkeCUxghE7N8qgnzc,11345
-codeplain-0.2.20.dist-info/RECORD,,
+tui/state_handlers.py,sha256=4r_6m5YMcprQtgiTP0De3XFfGAF8VzgaWXHxPweYPbQ,16325
+tui/styles.css,sha256=9vI6V7n7p76i2Dn62KDyOkRYp__d3v2bCzYxO9PWnm8,6685
+tui/widget_helpers.py,sha256=DdXCAJEvFVMgLM2GNBqE-yMtgoNnk7sHG6ehaEV3zdk,6577
+codeplain-0.3.0.dist-info/METADATA,sha256=uosx3aB3OZ_wcwt-YeAFzzVHKHyyMf78k_rqFEp6iSs,4203
+codeplain-0.3.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+codeplain-0.3.0.dist-info/entry_points.txt,sha256=oDZkBqu9WhtZApb_K6ia8-fn9aojwmAsgnKELceX5T4,46
+codeplain-0.3.0.dist-info/licenses/LICENSE,sha256=pCeKgQ1mXE5OmNUuKOfOZh1T1vqkeCUxghE7N8qgnzc,11345
+codeplain-0.3.0.dist-info/RECORD,,

codeplain_REST_api.py

@@ -2,7 +2,7 @@ import time
 from typing import Optional
 
 import requests
-from requests.exceptions import ConnectionError, Timeout
+from requests.exceptions import ConnectionError, RequestException, Timeout
 
 import plain2code_exceptions
 from plain2code_state import RunState
@@ -18,7 +18,7 @@ RETRY_ERROR_CODES = [
 ERROR_CODE_EXCEPTIONS = {
     "FunctionalRequirementTooComplex": plain2code_exceptions.FunctionalRequirementTooComplex,
     "ConflictingRequirements": plain2code_exceptions.ConflictingRequirements,
-    "CreditBalanceTooLow": plain2code_exceptions.RenderingCreditBalanceTooLow,
+    "RenderingCreditBalanceTooLow": plain2code_exceptions.RenderingCreditBalanceTooLow,
     "LLMInternalError": plain2code_exceptions.LLMInternalError,
     "MissingResource": plain2code_exceptions.MissingResource,
     "PlainSyntaxError": plain2code_exceptions.PlainSyntaxError,
@@ -76,9 +76,12 @@ class CodeplainAPI:
             if not silent:
                 self.console.error(f"Max retries ({num_retries}) exceeded. Last error: {error}")
             if is_connection_error:
-                raise plain2code_exceptions.NetworkConnectionError("Failed to connect to API server.")
-            else:
-                raise error
+                raise plain2code_exceptions.NetworkConnectionError(
+                    "Connection error: Failed to connect to API server.\n\nPlease check that your internet connection is working."
+                )
+            if isinstance(error, RequestException):
+                raise Exception(f"Error rendering plain code: {error}\n") from error
+            raise error
 
     def _raise_for_error_code(self, response_json):
         """Raise appropriate exception based on error code in response."""
@@ -86,13 +89,28 @@ class CodeplainAPI:
         if error_code not in ERROR_CODE_EXCEPTIONS:
             return
 
-        exception_class = ERROR_CODE_EXCEPTIONS[error_code]
         message = response_json.get("message", "")
 
-        # FunctionalRequirementTooComplex has an extra parameter
         if error_code == "FunctionalRequirementTooComplex":
-            raise exception_class(message, response_json.get("proposed_breakdown"))
-
+            raise plain2code_exceptions.FunctionalRequirementTooComplex(
+                message, response_json.get("proposed_breakdown")
+            )
+        if error_code == "MissingResource":
+            raise plain2code_exceptions.MissingResource(f"Missing resource: {message}\n")
+        if error_code == "ConflictingRequirements":
+            raise plain2code_exceptions.ConflictingRequirements(f"Conflicting requirements: {message}\n")
+        if error_code == "RenderingCreditBalanceTooLow":
+            raise plain2code_exceptions.RenderingCreditBalanceTooLow(message)
+        if error_code == "LLMInternalError":
+            raise plain2code_exceptions.LLMInternalError(f"LLM internal error: {message}\n")
+        if error_code == "PlainSyntaxError":
+            raise plain2code_exceptions.plain_syntax_error(message or "Unknown error")
+        if error_code == "InternalServerError":
+            raise plain2code_exceptions.InternalServerError(
+                "Internal server error.\n\n"
+                f"Please report the error to support@codeplain.ai with the attached {self.log_file_name} file."
+            )
+        exception_class = ERROR_CODE_EXCEPTIONS[error_code]
         raise exception_class(message)
 
     def post_request(
@@ -118,7 +136,7 @@ class CodeplainAPI:
                     response_json = response.json()
                 except requests.exceptions.JSONDecodeError as e:
                     self.console.debug(f"Failed to decode JSON response: {e}. Response text: {response.text}")
-                    raise
+                    raise Exception(f"Error rendering plain code: Failed to decode API response ({e}).\n") from e
 
                 if response.status_code == requests.codes.bad_request and "error_code" in response_json:
                     self._raise_for_error_code(response_json)
@@ -350,6 +368,7 @@ class CodeplainAPI:
         implementation_fix_count,
         conformance_tests_folder_name,
         current_testing_frid_high_level_implementation_plan: Optional[str],
+        conflicting_requirements_count: int,
         run_state: RunState,
     ):
         endpoint_url = f"{self.api_url}/fix_conformance_tests_issue"
@@ -371,6 +390,7 @@ class CodeplainAPI:
             "implementation_fix_count": implementation_fix_count,
             "conformance_tests_folder_name": conformance_tests_folder_name,
             "current_testing_frid_high_level_implementation_plan": current_testing_frid_high_level_implementation_plan,
+            "conflicting_requirements_count": conflicting_requirements_count,
         }
 
         if acceptance_tests is not None:

concept_utils.py

@@ -206,7 +206,7 @@ def sort_definitions(definitions: list[dict]) -> list[dict]:
             msg += "\n".join(cyclic_definitions)
             msg += "\n"
 
-        raise PlainSyntaxError(msg)
+        raise PlainSyntaxError(f"Plain syntax error: {msg}")
 
     order = list(nx.topological_sort(concept_graph))
     if len(order) > 0:

file_utils.py

@@ -8,6 +8,7 @@ from liquid2.exceptions import UndefinedError
 
 import plain_spec
 from plain2code_console import console
+from plain2code_exceptions import UnsupportedResourceType
 from plain2code_nodes import Plain2CodeIncludeTag, Plain2CodeLoaderMixin
 from plain_modules import CODEPLAIN_MEMORY_SUBFOLDER, CODEPLAIN_METADATA_FOLDER
 
@@ -217,18 +218,12 @@ def open_from(dirs, file_name):
 
         with open(full_file_name, "rb") as f:
             content = f.read()
-            try:
-                content_text = content.decode("utf-8")
-            except UnicodeDecodeError:
-                console.debug(
-                    f"WARNING! Error loading {file_name} ({file_name}). File is not a text file. Skipping it."
-                )
-            return content_text
+        return content.decode("utf-8")
 
     return None
 
 
-def load_linked_resources(template_dirs: list[str], resources_list):
+def load_linked_resources(template_dirs: list[str], resources_list, module_name: str):
     linked_resources = {}
 
     for resource in resources_list:
@@ -236,7 +231,13 @@ def load_linked_resources(template_dirs: list[str], resources_list):
         if file_name in linked_resources:
             continue
 
-        content = open_from(template_dirs, file_name)
+        try:
+            content = open_from(template_dirs, file_name)
+        except UnicodeDecodeError:
+            raise UnsupportedResourceType(
+                f"Referenced resource '{file_name}' in module '{module_name}' is a binary file. "
+                f"Only text files (e.g. .md, .txt, .json, .yaml) can be referenced from a .plain file."
+            )
 
         if content is None:
             raise FileNotFoundError(f"""

git_utils.py

@@ -1,4 +1,5 @@
 import os
+import re
 from configparser import NoOptionError, NoSectionError
 from typing import Optional, Union
 
@@ -60,7 +61,10 @@ def _ensure_git_config(repo: Repo) -> None:
 
 
 def init_git_repo(
-    path_to_repo: Union[str, os.PathLike], module_name: Optional[str] = None, render_id: Optional[str] = None
+    path_to_repo: Union[str, os.PathLike],
+    module_name: Optional[str] = None,
+    render_id: Optional[str] = None,
+    initial_files: Optional[dict[str, str]] = None,
 ) -> Repo:
     """
     Initializes a new git repository in the given path.
@@ -74,6 +78,11 @@ def init_git_repo(
 
     repo = Repo.init(path_to_repo)
     _ensure_git_config(repo)
+
+    if initial_files:
+        file_utils.store_response_files(path_to_repo, initial_files, [])
+        repo.git.add(".")
+
     repo.git.commit(
         "--allow-empty", "-m", _get_full_commit_message(INITIAL_COMMIT_MESSAGE, module_name, None, render_id)
     )
@@ -82,9 +91,18 @@ def init_git_repo(
 
 
 def clone_repo(
-    source_repo_path: str, new_repo_path: str, module_name: Optional[str] = None, render_id: Optional[str] = None
+    source_repo_path: str,
+    new_repo_path: str,
+    module_name: Optional[str] = None,
+    render_id: Optional[str] = None,
+    initial_files: Optional[dict[str, str]] = None,
 ) -> Repo:
     repo = Repo.clone_from(source_repo_path, new_repo_path)
+
+    if initial_files:
+        file_utils.store_response_files(new_repo_path, initial_files, [])
+        repo.git.add(".")
+
     repo.git.commit(
         "--allow-empty", "-m", _get_full_commit_message(INITIAL_COMMIT_MESSAGE, module_name, None, render_id)
     )
@@ -415,3 +433,53 @@ def get_repo_info(repo_path: Union[str, os.PathLike]) -> dict:
     info["remotes"] = remotes
 
     return info
+
+
+def get_last_rendered_functionality(repo_path: Union[str, os.PathLike]) -> tuple[Optional[str], Optional[str]]:
+    if not os.path.exists(repo_path):
+        return None, None
+
+    repo = Repo(repo_path)
+    grep_pattern = FUNCTIONAL_REQUIREMENT_FINISHED_COMMIT_MESSAGE.format(".*")
+    grep_pattern = grep_pattern.replace("[", "\\[").replace("]", "\\]")
+    commit_sha = repo.git.rev_list(repo.active_branch.name, "--grep", grep_pattern, "-n", "1")
+
+    if not commit_sha:
+        # Repo was interrupted during the first functionality, fallback to initial commit and provide only module name
+        grep_pattern = INITIAL_COMMIT_MESSAGE
+        grep_pattern = grep_pattern.replace("[", "\\[").replace("]", "\\]")
+        commit_sha = repo.git.rev_list(repo.active_branch.name, "--grep", grep_pattern, "-n", "1")
+        if not commit_sha:
+            raise InvalidGitRepositoryError("Git repository is in an invalid state. Initial commit could not be found.")
+
+        commit_message = repo.commit(commit_sha).message
+        if isinstance(commit_message, bytes):
+            commit_message = commit_message.decode("utf-8")
+
+        match = re.search(r"Module name:\s*(\S+)\n", commit_message)
+        if not match:
+            raise InvalidGitRepositoryError(
+                "Git repository is in an invalid state. Could not find module name in initial commit."
+            )
+
+        module_name = match.group(1)
+        return module_name, None
+
+    commit_message = repo.commit(commit_sha).message
+    if isinstance(commit_message, bytes):
+        commit_message = commit_message.decode("utf-8")
+
+    match = re.search(r"FRID\):(\S+) fully implemented", commit_message)
+    if not match:
+        raise InvalidGitRepositoryError(
+            "Git repository is in an invalid state. Could not find frid in finished commit."
+        )
+    frid = match.group(1)
+
+    match = re.search(r"Module name:\s*(\S+)\n", commit_message)
+    if not match:
+        raise InvalidGitRepositoryError(
+            "Git repository is in an invalid state. Could not find module name in finished commit."
+        )
+    module_name = match.group(1)
+    return module_name, frid