pycforge 1.3.51__tar.gz → 1.3.53__tar.gz

{pycforge-1.3.51 → pycforge-1.3.53}/CHANGELOG.md

@@ -1,3 +1,18 @@
+# PyCForge 1.3.53 — Saved files and project sessions
+
+- Package Python modules from other folders or drives without moving them;
+  save project bundles at the chosen writable destination.
+- Keep an associated project bundle current when Python saves finish with all
+  modules saved, preserving existing checkpoints and write-conflict checks.
+- Treat saved files reopened at startup as the session's saved baseline;
+  retain save prompts for subsequent edits and failed save attempts.
+- End the project session when the last tab is closed, retire pending file
+  restoration, and preserve saved files, bundles and checkpoints unchanged.
+- Distinguish automatic title-control focus from mouse hover and intentional
+  keyboard focus in recovery dialogs and shared window controls.
+- Update installed Help for these file workflows and preserve the README
+  body and four approved images, with its version heading advanced to 1.3.53.
+
 # PyCForge 1.3.51 — Reliable large-workspace editing
 
 - Avoid repeated text-layout settings during buffer attachment and apply the

{pycforge-1.3.51 → pycforge-1.3.53}/MANIFEST.in

@@ -105,6 +105,8 @@ include PyCForge-1.3.48-Verification.txt
 include PyCForge-1.3.49-Verification.txt
 include PyCForge-1.3.50-Verification.txt
 include PyCForge-1.3.51-Verification.txt
+include PyCForge-1.3.52-Verification.txt
+include PyCForge-1.3.53-Verification.txt
 include PyCForge-README-Guidelines.txt
 
 # Distribute only images needed by the application, never review screenshots

{pycforge-1.3.51/pycforge.egg-info → pycforge-1.3.53}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycforge
-Version: 1.3.51
+Version: 1.3.53
 Summary: Deterministic bounded Python-to-C source transpiler
 License-Expression: GPL-3.0-only
 Project-URL: Homepage, https://pypi.org/project/pycforge/
@@ -30,7 +30,7 @@ Dynamic: license-file
 
 <img src="https://res.cloudinary.com/vppzdwxg/image/upload/v1792314783/exec-76eda399-3547-4803-9896-4d57a7dd45cf.png" alt="PyCForge" width="320">
 
-# PyCForge v1.3.51
+# PyCForge v1.3.53
 
 PyCForge is a Python-to-C source transpiler and PySide6 desktop IDE. Edit Python, convert supported programs into readable C11, inspect the generated code, and compile with an optional native C toolchain—all from one workspace. A command-line interface and Python API bring the same conversion capabilities to scripts and other development tools.
 

pycforge-1.3.53/PyCForge-1.3.52-Verification.txt

@@ -0,0 +1,102 @@
+PyCForge 1.3.52 — Saving and startup file-read repair
+
+Prepared from CC's current 1.3.51 source distribution.
+
+FAULT AND CORRECTION
+
+The 1.3.51 source reader compared an open handle's os.fstat result with
+Path.stat for the pathname. CPython on Windows can report change time in
+the former's st_ctime_ns and creation time in the latter. A file can therefore
+fail the comparison without changing during the read. The reader is used
+both when reopening saved files and by the pre-save conflict check.
+
+Fault injection reproduced the two reported messages on unchanged data:
+  Startup: The file changed while it was being read. Try again.
+  Save: atomic workspace write failed: <path>
+The save's hidden cause was the same read error. Disk bytes remained unchanged
+and the edited document remained dirty in this reproduction.
+
+The repaired reader compares handle metadata consistently: before reading,
+after reading, and from a second handle opened through the current pathname.
+The original handle stays open while the pathname is checked. Device, file
+identity, size, modification time and change time remain checked. The payload
+length must also match the observed size. This reads the payload once, adds
+one bounded open/fstat/close operation, and keeps the 16 MiB limit and UTF-8,
+NUL-byte and regular-file checks. It adds no dependencies or worker threads.
+
+Atomic writes retain specific WorkspaceIOError messages. Other failures include
+their exception type and reason, so an actual access or replacement problem
+is no longer reported solely as a generic atomic-write failure.
+
+The outside-project message in the second screenshot is a separate folder
+constraint. The verified recovery is Save Python As into the existing working
+folder, followed by Save Project. The recovery test preserves the outside
+original, prior checkpoints and current editor text. The repair does not
+silently relocate files or broaden the project's working folder.
+
+Upstream reference for the Windows timestamp distinction:
+https://github.com/python/cpython/issues/157671
+This source describes the platform behavior; it is not evidence of the Python
+version installed on CC's laptop.
+
+VALIDATION
+
+Linux, Python 3.12.14, PySide6 6.12.0, Qt offscreen. Windows metadata behavior
+was simulated at the os.fstat boundary without changing os.name or pathlib.
+Native Windows and macOS execution were not available. Laptop acceptance is
+still required; these results are not a claim of native Windows certification.
+
+237 focused regression tests and 19 subtests passed. They cover the 31 new
+portability/workflow cases plus existing file I/O, disk conflicts, Python save
+identity, Save All/exit, project archives/history, startup recovery, normal
+startup and file-dialog checks. All passed in one process in 105.18 seconds.
+
+23 Help/distribution-contract tests and 498 subtests passed separately.
+Total in these two final runs: 260 tests and 517 subtests; zero failures/skips.
+This is targeted validation of the affected paths, not a rerun of every
+conversion test. Earlier standalone runs of the new tests overlap this total.
+
+New coverage includes:
+  - Windows-style mismatched pathname/handle ctime on stable files.
+  - Genuine metadata changes during reads and pathname re-resolution.
+  - Same-size replacement with matching timestamps and descriptor cleanup.
+  - UTF-8 BOM, CRLF/CR, empty files, Unicode names and paths with spaces.
+  - Synchronous/asynchronous open-save-reopen and real external-edit conflicts.
+  - Reviewed overwrite, useful read/write failure reasons and preserved data.
+  - Save Python, Save As, Save All and repeated saves of existing files.
+  - Outside-project recovery, project saves and checkpoint retention.
+  - Generated C saving and C-module ZIP export.
+  - Complete application launch twice with persisted files and no false report.
+  - Project save/restart across real process boundaries, with and without a
+    bundle save after adding a module.
+
+The source archive includes the tests and the focused logs under
+evidence/windows_io_1_3_52. The final download report adds checks against the
+built wheel and source archive, installed smoke results, sizes and hashes.
+
+DOCUMENTATION AND SCOPE
+
+The README differs from 1.3.51 only in the top version heading. Its four image
+URLs, ordering, widths, prose and historical labels are preserved. The README
+renderer check passed. AGENTS.md and PyCForge-README-Guidelines.txt are unchanged.
+All 144 converter files are byte-identical to 1.3.51. Runtime dependencies and
+entry points are unchanged. Help adds brief guidance for failed reads/saves
+and the existing outside-project recovery workflow; its rendering was reviewed.
+
+WINDOWS INSTALL AND RETEST
+
+1. If v1.3.51 still has unsaved edits, copy that text to a safe file before
+   closing it. Do not discard unsaved work to install the update.
+2. In the folder containing the downloaded wheel, run:
+   py -m pip install --upgrade .\pycforge-1.3.52-py3-none-any.whl
+3. Launch with py -m pycforge.ide and confirm 1.3.52 in the application.
+4. Confirm the saved Python files reopen. Edit an existing file, Save Python,
+   edit and save it again, then restart and verify the exact saved text.
+5. Test Save Python As and Save All Python. For the outside-project file,
+   Save Python As into the folder named in the project message, then Save Project.
+6. Transpile and save generated C; reopen the saved project and its history.
+
+If a failure remains, retain the complete message or Startup report and the
+output of py --version. No existing source files or settings need deletion.
+
+CC alone publishes releases to PyPI from CC's own computer.

pycforge-1.3.53/PyCForge-1.3.53-Verification.txt

@@ -0,0 +1,130 @@
+PyCForge 1.3.53 — Saved files, project bundles and clean sessions
+Prepared 2026-10-21 from CC's 1.3.52 source distribution.
+
+REPORTED FAILURES AND CORRECTIONS
+
+1. Project files outside the original working folder
+   Project capture rejected an otherwise saved Python file solely because its
+   path was outside the original working folder. The same capture is used by
+   Save Project, Save Project As, Save All before exit, and startup history
+   reconnection. This explains why the folder error appeared in several places,
+   including after a project had already been read successfully.
+
+   Bundles now include those source contents without moving the linked files.
+   Files inside the working folder keep their relative layout; files outside
+   it use their filenames in the portable bundle. A different source drive
+   no longer prevents project capture. Choose any writable bundle destination.
+   Portable filename collisions and invalid names remain errors: no file is
+   silently renamed, omitted, or overwritten to hide a collision.
+
+   Startup history reconnection preserves the actual linked paths and saved
+   disk baselines. Restoring a checkpoint preserves an existing external link.
+   Explicit Open Project still creates copies in its chosen new working folder.
+
+2. Repeated save prompts and Save All exit failures
+   Saving Python text could leave the associated project bundle behind it.
+   Both exit and Open Project then treated the bundle difference as unsaved
+   work. Save All could fail on the obsolete folder restriction above.
+
+   When a Python save completes with all tabs saved, the associated project
+   bundle is updated too, preserving existing checkpoints. This applies to
+   Save Python, Save Python As, and Save All Python. Save All on exit also
+   completes when the Python files are already saved outside the working root.
+   It skips rewriting unchanged Python files.
+
+   Saved Python files read at startup establish the session's saved baseline.
+   An older bundle differing from those files does not manufacture a new edit
+   or trigger an exit/project-replacement prompt. Startup does not overwrite
+   that bundle; explicit Save Project can update it. Subsequent edits, changed
+   project settings, and failed save attempts remain subject to save guards.
+   Failed writes and unresolved external conflicts keep the workspace open.
+
+3. Closing all tabs and restarting
+   Closing the final tab now clears the session's linked paths, failed restore
+   entries, active path and project association. It also retires an in-flight
+   startup read so a late result cannot reopen a deliberately closed session.
+   The saved Python files, project bundle and checkpoints are not changed.
+   Empty sessions no longer reconnect stale project links from older releases.
+
+4. Recovery-dialog close highlight
+   Automatic focus was styled identically to hover, so Windows activation
+   could leave the close control highlighted even with the pointer elsewhere.
+   Shared title controls now distinguish automatic focus, actual pointer hover,
+   and deliberate keyboard focus. Keyboard focus has a visible outline; Tab
+   and Space activation remain available. Leave/hide/deactivation clear stale
+   pointer state, and painting checks the current pointer position.
+
+VALIDATION
+
+Environment: Linux, Python 3.12, PySide6/Qt 6.12.0, offscreen Qt rendering.
+Native Windows/macOS execution was not available. CC's Windows acceptance is
+still required, especially native focus/hover behavior and real drive paths.
+
+Six initial regression cases failed against the original 1.3.52 implementation:
+last-tab cleanup, individual/Save All completion before exit/project opening,
+and activation-focus rendering. They pass after the corrections.
+
+Sixteen new workflow cases pass, including:
+- Add two modules, Save As each into another folder, Save Project As elsewhere,
+  reopen the bundle, compare source bytes, and preserve checkpoint history.
+- Save All on exit with two already-saved outside files: one decision, no
+  Python rewrites, successful project save and completed exit.
+- Individual and batch saves followed by exit or Open Project without a prompt.
+- Cancel/save with genuine unsaved edits on exit and project replacement.
+- Older project bundles with newer saved disk contents: no manufactured edits.
+- Empty-session launches across real process boundaries with stale project links.
+- Final-tab closure during a delayed restore, including earlier failed paths.
+- External-link history reconnection and checkpoint restoration.
+- Recovery-control pixels with automatic focus versus intentional keyboard focus.
+
+The broader targeted run exercised 280 tests and 560 subtests. It passed 278
+tests and all 560 subtests; two release assertions still expected 1.3.51, already
+stale in the supplied 1.3.52 source. Those two expected current versions were
+updated to 1.3.53, and the complete 11-test release-contract file passed again.
+Thus all 280 targeted cases have passed on the corrected source. The 11-test
+rerun overlaps the broader run and is not an additional distinct test count.
+This is targeted file/session/UI validation, not a full conversion-suite rerun.
+
+Existing coverage includes delayed and failed saves, edits during saves,
+64-document Save All, external conflicts, guarded project replacement,
+archive validation, startup failures, empty/normal startup, Windows-style
+file-metadata behavior, editor lifecycle, shared window controls, and Help.
+Prior tests that required the old folder restriction or automatic history
+attachment to an empty session now assert the corrected requested behavior.
+
+DOCUMENTATION AND DISTRIBUTION
+
+Installed Help describes file placement, coordinated saves and empty sessions.
+Both revised Help pages and the recovery dialog were rendered and inspected.
+README differs from 1.3.52 only in the top version heading; all four approved
+image URLs, ordering, widths and prose remain unchanged. The README renderer
+check passes. AGENTS.md and PyCForge-README-Guidelines.txt are unchanged.
+All 144 converter files are byte-identical to 1.3.52. Runtime dependencies,
+entry points and archive format are unchanged.
+
+The final downloadable copy of this report adds the exact distribution hashes,
+public-package checks and installed-wheel verification after packaging.
+CC alone publishes PyCForge to PyPI from CC's own computer.
+
+WINDOWS RETEST
+
+Install the downloaded wheel from its folder:
+  py -m pip install --upgrade .\pycforge-1.3.53-py3-none-any.whl
+Launch:
+  py -m pycforge.ide
+
+1. Confirm 1.3.53. Open an existing project, add two modules and Save Python As
+   into chosen folders outside the original working folder. Save Project As
+   into another chosen folder. Confirm it succeeds and preserves those files.
+2. Exit after saving all tabs. Confirm no unnecessary save prompt. Reopen the
+   project and confirm source contents and checkpoint history.
+3. Close every tab, exit and restart. Confirm no tabs, no old file-load notice
+   and no project-save prompt. Previously saved files and bundles remain.
+4. Make a real edit: Cancel must keep it open; Save All must save and exit.
+   Check the recovery dialog's Close control after hover, pointer leave and
+   reactivation. Keyboard Tab focus should show an outline and Space should work.
+
+No existing files or settings need to be deleted to install this update.
+
+Source baseline SHA256:
+94c03d19801d6e5f9a3d229dc93d9081a661ed19304b6c82d87b15802a3324ea

{pycforge-1.3.51 → pycforge-1.3.53}/README.md

@@ -1,6 +1,6 @@
 <img src="https://res.cloudinary.com/vppzdwxg/image/upload/v1792314783/exec-76eda399-3547-4803-9896-4d57a7dd45cf.png" alt="PyCForge" width="320">
 
-# PyCForge v1.3.51
+# PyCForge v1.3.53
 
 PyCForge is a Python-to-C source transpiler and PySide6 desktop IDE. Edit Python, convert supported programs into readable C11, inspect the generated code, and compile with an optional native C toolchain—all from one workspace. A command-line interface and Python API bring the same conversion capabilities to scripts and other development tools.
 

{pycforge-1.3.51 → pycforge-1.3.53}/RELEASE_NOTES.md

@@ -1,3 +1,18 @@
+# PyCForge 1.3.53 — Saved files and project sessions
+
+- Package Python modules from other folders or drives without moving them;
+  save project bundles at the chosen writable destination.
+- Keep an associated project bundle current when Python saves finish with all
+  modules saved, preserving existing checkpoints and write-conflict checks.
+- Treat saved files reopened at startup as the session's saved baseline;
+  retain save prompts for subsequent edits and failed save attempts.
+- End the project session when the last tab is closed, retire pending file
+  restoration, and preserve saved files, bundles and checkpoints unchanged.
+- Distinguish automatic title-control focus from mouse hover and intentional
+  keyboard focus in recovery dialogs and shared window controls.
+- Update installed Help for these file workflows and preserve the README
+  body and four approved images, with its version heading advanced to 1.3.53.
+
 # PyCForge 1.3.51 — Reliable large-workspace editing
 
 - Avoid repeated text-layout settings during buffer attachment and apply the

pycforge-1.3.53/evidence/filesystem_1_3_53/baseline-regressions.log

@@ -0,0 +1,45 @@
+FFFFFF                                                                   [100%]
+=================================== FAILURES ===================================
+____ test_closing_last_saved_tab_leaves_empty_session_and_preserves_bundle _____
+tests/test_saved_workspace_1_3_53.py:22: in test_closing_last_saved_tab_leaves_empty_session_and_preserves_bundle
+    assert not window._session_setting_values()['workspace/open_paths']
+E   AssertionError: assert not ['/tmp/pytest-of-root/pytest-0/test_closing_last_saved_tab_le0/old-missing.py']
+_ test_completed_python_save_keeps_project_current_without_repeat_prompt[exit-save_source] _
+tests/test_saved_workspace_1_3_53.py:43: in test_completed_python_save_keeps_project_current_without_repeat_prompt
+    assert not window._project_dirty()
+E   assert not True
+E    +  where True = _project_dirty()
+E    +    where _project_dirty = <pycforge.ide.qt.MainWindow(0x33877200, name="PyCForgeMainWindow") at 0x7fb822699fc0>._project_dirty
+_ test_completed_python_save_keeps_project_current_without_repeat_prompt[exit-save_all_sources] _
+tests/test_saved_workspace_1_3_53.py:43: in test_completed_python_save_keeps_project_current_without_repeat_prompt
+    assert not window._project_dirty()
+E   assert not True
+E    +  where True = _project_dirty()
+E    +    where _project_dirty = <pycforge.ide.qt.MainWindow(0x32b58c00, name="PyCForgeMainWindow") at 0x7fb82269c940>._project_dirty
+_ test_completed_python_save_keeps_project_current_without_repeat_prompt[open-save_source] _
+tests/test_saved_workspace_1_3_53.py:43: in test_completed_python_save_keeps_project_current_without_repeat_prompt
+    assert not window._project_dirty()
+E   assert not True
+E    +  where True = _project_dirty()
+E    +    where _project_dirty = <pycforge.ide.qt.MainWindow(0x33e299d0, name="PyCForgeMainWindow") at 0x7fb822993f40>._project_dirty
+_ test_completed_python_save_keeps_project_current_without_repeat_prompt[open-save_all_sources] _
+tests/test_saved_workspace_1_3_53.py:43: in test_completed_python_save_keeps_project_current_without_repeat_prompt
+    assert not window._project_dirty()
+E   assert not True
+E    +  where True = _project_dirty()
+E    +    where _project_dirty = <pycforge.ide.qt.MainWindow(0x338882e0, name="PyCForgeMainWindow") at 0x7fb822716f40>._project_dirty
+________ test_recovery_control_activation_focus_is_not_painted_as_hover ________
+tests/test_saved_workspace_1_3_53.py:80: in test_recovery_control_activation_focus_is_not_painted_as_hover
+    assert [idle.pixelColor(p) for p in points] == [focused.pixelColor(p) for p in points]
+E   assert [PySide6.QtGu...00, 0.000000)] == [PySide6.QtGu...27, 1.000000)]
+E     
+E     At index 0 diff: PySide6.QtGui.QColor.fromRgbF(0.000000, 0.000000, 0.000000, 0.000000) != PySide6.QtGui.QColor.fromRgbF(0.745098, 0.521569, 0.541176, 1.000000)
+E     Use -v to get more diff
+=========================== short test summary info ============================
+FAILED tests/test_saved_workspace_1_3_53.py::test_closing_last_saved_tab_leaves_empty_session_and_preserves_bundle
+FAILED tests/test_saved_workspace_1_3_53.py::test_completed_python_save_keeps_project_current_without_repeat_prompt[exit-save_source]
+FAILED tests/test_saved_workspace_1_3_53.py::test_completed_python_save_keeps_project_current_without_repeat_prompt[exit-save_all_sources]
+FAILED tests/test_saved_workspace_1_3_53.py::test_completed_python_save_keeps_project_current_without_repeat_prompt[open-save_source]
+FAILED tests/test_saved_workspace_1_3_53.py::test_completed_python_save_keeps_project_current_without_repeat_prompt[open-save_all_sources]
+FAILED tests/test_saved_workspace_1_3_53.py::test_recovery_control_activation_focus_is_not_painted_as_hover
+6 failed in 4.52s

pycforge-1.3.53/evidence/filesystem_1_3_53/new-flows-final.log

@@ -0,0 +1,2 @@
+................                                                         [100%]
+16 passed in 20.66s

pycforge-1.3.53/evidence/filesystem_1_3_53/verified-final.log

@@ -0,0 +1,25 @@
+........................................................................ [ 25%]
+........................................................................ [ 51%]
+........................................................................ [ 77%]
+...............................................FF...............                         [100%]
+=================================== FAILURES ===================================
+_ ReleaseContract0163Tests.test_metadata_points_only_to_the_pypi_distribution __
+tests/test_release_contract_0_16_3.py:107: in test_metadata_points_only_to_the_pypi_distribution
+    self.assertEqual(project["version"], "1.3.51")
+E   AssertionError: '1.3.53' != '1.3.51'
+E   - 1.3.53
+E   ?      ^
+E   + 1.3.51
+E   ?      ^
+___ ReleaseContract0163Tests.test_package_advances_only_workspace_contracts ____
+tests/test_release_contract_0_16_3.py:54: in test_package_advances_only_workspace_contracts
+    self.assertEqual(__version__, "1.3.51")
+E   AssertionError: '1.3.53' != '1.3.51'
+E   - 1.3.53
+E   ?      ^
+E   + 1.3.51
+E   ?      ^
+=========================== short test summary info ============================
+FAILED tests/test_release_contract_0_16_3.py::ReleaseContract0163Tests::test_metadata_points_only_to_the_pypi_distribution
+FAILED tests/test_release_contract_0_16_3.py::ReleaseContract0163Tests::test_package_advances_only_workspace_contracts
+2 failed, 278 passed, 560 subtests passed in 157.79s (0:02:37)

pycforge-1.3.53/evidence/filesystem_1_3_53/version-contract-final.log

@@ -0,0 +1,2 @@
+...........                                                              [100%]
+11 passed in 0.84s

pycforge-1.3.53/evidence/windows_io_1_3_52/baseline-reproduction.txt

@@ -0,0 +1,5 @@
+startup read WorkspaceIOError The file changed while it was being read. Try again.
+save WorkspaceIOError atomic workspace write failed: /tmp/tmprx8obpma/ofr1.py
+caused by: WorkspaceIOError('The file changed while it was being read. Try again.')
+disk preserved: True
+editor still dirty: True

pycforge-1.3.53/evidence/windows_io_1_3_52/focused-regressions.txt

@@ -0,0 +1,5 @@
+........................................................................ [ 30%]
+........................................................................ [ 60%]
+........................................................................ [ 91%]
+.....................                                 [100%]
+237 passed, 19 subtests passed in 105.18s (0:01:45)

pycforge-1.3.53/evidence/windows_io_1_3_52/help-and-packaging-tests.txt

@@ -0,0 +1,3 @@
+............ [ 52%]
+...........                                                        [100%]
+23 passed, 498 subtests passed in 1.25s

pycforge-1.3.53/evidence/windows_io_1_3_52/readme-render.txt

@@ -0,0 +1,15 @@
+{
+  "banner_elements": 2,
+  "banner_width": 320,
+  "engine_banner_width": 640,
+  "image_sources": [
+    "https://res.cloudinary.com/vppzdwxg/image/upload/v1792314783/exec-76eda399-3547-4803-9896-4d57a7dd45cf.png",
+    "https://res.cloudinary.com/vppzdwxg/image/upload/v1792313873/pycforge-1.3.39-main.png",
+    "https://res.cloudinary.com/vppzdwxg/image/upload/v1792313993/pycforge-1.3.39-ting-evidence.png",
+    "https://res.cloudinary.com/vppzdwxg/image/upload/v1792420349/exec-7284d6da-a28b-4732-8980-a015c99067c6.png"
+  ],
+  "navigation_links": 0,
+  "passed": true,
+  "rendered_html_bytes": 34477,
+  "screenshot_elements": 2
+}

pycforge-1.3.53/evidence/windows_io_1_3_52/repair.patch

@@ -0,0 +1,90 @@
+--- a/README.md
++++ b/README.md
+@@ -1,6 +1,6 @@
+ <img src="https://res.cloudinary.com/vppzdwxg/image/upload/v1792314783/exec-76eda399-3547-4803-9896-4d57a7dd45cf.png" alt="PyCForge" width="320">
+ 
+-# PyCForge v1.3.51
++# PyCForge v1.3.52
+ 
+ PyCForge is a Python-to-C source transpiler and PySide6 desktop IDE. Edit Python, convert supported programs into readable C11, inspect the generated code, and compile with an optional native C toolchain—all from one workspace. A command-line interface and Python API bring the same conversion capabilities to scripts and other development tools.
+ 
+--- a/pycforge/_version.py
++++ b/pycforge/_version.py
+@@ -1 +1 @@
+-__version__ = "1.3.51"
++__version__ = "1.3.52"
+--- a/pycforge/ide/disk_files.py
++++ b/pycforge/ide/disk_files.py
+@@ -59,10 +59,22 @@
+                 raise WorkspaceIOError('workspace input exceeds the 16 MiB read limit')
+             payload = handle.read(MAX_WORKSPACE_READ_BYTES + 1)
+             after = os.fstat(handle.fileno())
+-        if len(payload) > MAX_WORKSPACE_READ_BYTES:
+-            raise WorkspaceIOError('workspace input exceeds the 16 MiB read limit')
+-        if _stamp(before) != _stamp(after) or _stamp(after) != _stamp(source.stat()):
+-            raise WorkspaceIOError('The file changed while it was being read. Try again.')
++            if len(payload) > MAX_WORKSPACE_READ_BYTES:
++                raise WorkspaceIOError('workspace input exceeds the 16 MiB read limit')
++            if _stamp(before) != _stamp(after) or len(payload) != after.st_size:
++                raise WorkspaceIOError('The file changed while it was being read. Try again.')
++            # Compare handle metadata with handle metadata. On Windows, stat(path)
++            # can report creation time as ctime while fstat(fd) reports change time.
++            # Keep the original handle open while reopening the path so replacement
++            # detection retains file identity and every timestamp check.
++            current = os.open(source, os.O_RDONLY | getattr(os, 'O_BINARY', 0)
++                              | getattr(os, 'O_NONBLOCK', 0))
++            try:
++                rebound = os.fstat(current)
++            finally:
++                os.close(current)
++            if not stat.S_ISREG(rebound.st_mode) or _stamp(after) != _stamp(rebound):
++                raise WorkspaceIOError('The file changed while it was being read. Try again.')
+         text = payload.decode('utf-8-sig').replace('\r\n', '\n').replace('\r', '\n')
+         if '\0' in text:
+             raise WorkspaceIOError('workspace input contains NUL bytes; the file was left unchanged')
+--- a/pycforge/ide/io_service.py
++++ b/pycforge/ide/io_service.py
+@@ -182,11 +182,12 @@
+                 raise StaleWorkspaceWrite("linked-file destination changed before publication")
+             os.replace(temporary, destination)
+             temporary = None
+-        except StaleWorkspaceWrite:
++        except WorkspaceIOError:
+             raise
+         except Exception as exc:
+             raise WorkspaceIOError(
+-                f"atomic workspace write failed: {destination}"
++                f"atomic workspace write failed: {destination}\n"
++                f"{type(exc).__name__}: {exc}"
+             ) from exc
+         finally:
+             if temporary is not None:
+--- a/pycforge/ide/resources/help/workspace.html
++++ b/pycforge/ide/resources/help/workspace.html
+@@ -28,6 +28,7 @@
+ <h2 id="startup">Opening the workspace</h2>
+ <p>The startup progress dialog checks application resources and offline Help, prepares Ting review files, and compiles NumPy/Numba numerical routines in memory on a background worker. Saved numerical caches are not required. Cancel prevents the workspace from opening; preparation stops at a safe boundary.</p>
+ <p>Recoverable problems appear in a <strong>Startup report</strong> after the workspace opens. A warning icon and a selectable, read-only report use the same matte graphite theme as the workspace. It lists affected settings or files and explains the action taken. Use <strong>Copy report</strong> to retain the details. Invalid preferences use defaults. An unreadable or damaged settings store is left in place, with preferences held only for the current session. A failure in required application files or dependencies prevents launch and displays an error; reinstall from a complete release if those files are damaged.</p>
++<p>Files that could not be reopened retain their saved paths for a later startup attempt. After correcting the reported problem, restart normally or use <strong>Open Python</strong> to reopen them. A failed restoration does not delete or rewrite your Python files.</p>
+ <p>For a clean start, run <code>pycforge-workspace --safe-mode</code> or <code>python -m pycforge.ide --safe-mode</code>. This opens an empty workspace with default preferences, without reading or updating the saved settings or previous file list. Restart normally to use them again. Safe start still checks required application resources.</p>
+ <h2 id="authoring">Open, edit, and convert</h2>
+ <ol>
+@@ -45,6 +46,7 @@
+ <p>PyCForge compares a Python file with the disk version last opened or successfully saved before replacing it. If another editor or program changes or removes that file, saving opens a side-by-side comparison and keeps your local text. A <strong>disk conflict</strong> marker stays on the module tab while the observed difference remains. Monitoring continues while you edit or while source analysis is pending.</p>
+ <p><strong>Keep Editing</strong> cancels the save. <strong>Reload from Disk</strong> discards the local edits and loads the current disk contents. <strong>Save As…</strong> writes to another location and links the tab to that location. <strong>Overwrite Disk</strong> replaces the disk version shown in the comparison; if it changes again before replacement, another decision is required. For a deleted file, <strong>Recreate File</strong> is available and Reload is disabled. The comparison displays up to 64,000 characters per side; saving uses the full editor text.</p>
+ <p>An unresolved conflict or a reload stops Save All and prevents automatic exit. Files already saved remain saved. Save As to an existing destination also requires a conflict decision. Byte changes such as an external newline-format change are checked; a timestamp-only change does not cause a conflict. Unreadable, invalid UTF-8, or oversized disk files are preserved and reported. The check is optimistic; it does not lock out an unrelated program that writes at exactly the same time as the final replacement.</p>
++<p>If a save fails, your edits remain in the editor and the error includes the underlying read or write problem when available. Correct that problem and retry, or use <strong>Save Python As</strong> to save a copy in another writable location. A module outside an open project's working folder must be copied into that folder before <strong>Save Project</strong>; see <a href="projects.html">Projects and checkpoints</a>.</p>
+ <p>Closing the workspace offers <strong>Save All</strong>, <strong>Discard</strong>, or <strong>Cancel</strong> when modules are unsaved. Closing during a save waits without freezing the editor. A cancelled or failed save leaves the workspace open. Edits made during saving remain unsaved and prevent automatic closure.</p>
+ <p>Both Python editor panes and Generated C use normal scrollbars, shown when their content needs scrolling. The Python overview marker rail is no longer displayed. Diagnostic selections stay inside the text viewport; the final line remains reachable, including with horizontal scrolling and folded functions. Find, source mapping navigation, and ForgeLens highlighting remain available. Generated C is read-only in the workspace. Make changes in Python and convert again. You can close any module tab, including the last one; the workspace may be empty.</p>
+ <p>Closing a tab removes that module from the Source Bundle; it does not delete the Python file on disk. After closing the last tab, choose <strong>Open Python</strong> or <strong>New Module</strong> to continue. Save or discard any modified source when prompted. Generated C can remain visible while you close tabs.</p>
+--- a/pyproject.toml
++++ b/pyproject.toml
+@@ -4,7 +4,7 @@
+ 
+ [project]
+ name = "pycforge"
+-version = "1.3.51"
++version = "1.3.52"
+ description = "Deterministic bounded Python-to-C source transpiler"
+ readme = "README.md"
+ requires-python = ">=3.11,<3.14"

pycforge-1.3.53/pycforge/_version.py

@@ -0,0 +1 @@
+__version__ = "1.3.53"

{pycforge-1.3.51 → pycforge-1.3.53}/pycforge/ide/controller_io.py

@@ -7,6 +7,7 @@ import os
 import re
 from hashlib import sha256
 from time import monotonic
+from threading import Event
 
 from .io_service import FileRead, StaleWorkspaceWrite, WorkspaceIOService
 from .model import WorkspaceDocument
@@ -113,6 +114,7 @@ class AsyncIOControllerMixin:
         make_active: bool = True,
         is_primary: bool = False,
         read_deadline: float | None = None,
+        read_cancelled: Event | None = None,
     ) -> Future[WorkspaceDocument]:
         source_path = Path(path)
         with self._lock:
@@ -126,6 +128,8 @@ class AsyncIOControllerMixin:
                 with self._lock:
                     if self._closed:
                         raise RuntimeError("workspace controller is closed")
+                    if read_cancelled is not None and read_cancelled.is_set():
+                        raise RuntimeError("File restoration was cancelled.")
                     if (
                         document_id is not None
                         and self.snapshot.revision_generation

{pycforge-1.3.51 → pycforge-1.3.53}/pycforge/ide/disk_files.py

@@ -59,10 +59,22 @@ def read_source_file(path) -> FileRead:
                 raise WorkspaceIOError('workspace input exceeds the 16 MiB read limit')
             payload = handle.read(MAX_WORKSPACE_READ_BYTES + 1)
             after = os.fstat(handle.fileno())
-        if len(payload) > MAX_WORKSPACE_READ_BYTES:
-            raise WorkspaceIOError('workspace input exceeds the 16 MiB read limit')
-        if _stamp(before) != _stamp(after) or _stamp(after) != _stamp(source.stat()):
-            raise WorkspaceIOError('The file changed while it was being read. Try again.')
+            if len(payload) > MAX_WORKSPACE_READ_BYTES:
+                raise WorkspaceIOError('workspace input exceeds the 16 MiB read limit')
+            if _stamp(before) != _stamp(after) or len(payload) != after.st_size:
+                raise WorkspaceIOError('The file changed while it was being read. Try again.')
+            # Compare handle metadata with handle metadata. On Windows, stat(path)
+            # can report creation time as ctime while fstat(fd) reports change time.
+            # Keep the original handle open while reopening the path so replacement
+            # detection retains file identity and every timestamp check.
+            current = os.open(source, os.O_RDONLY | getattr(os, 'O_BINARY', 0)
+                              | getattr(os, 'O_NONBLOCK', 0))
+            try:
+                rebound = os.fstat(current)
+            finally:
+                os.close(current)
+            if not stat.S_ISREG(rebound.st_mode) or _stamp(after) != _stamp(rebound):
+                raise WorkspaceIOError('The file changed while it was being read. Try again.')
         text = payload.decode('utf-8-sig').replace('\r\n', '\n').replace('\r', '\n')
         if '\0' in text:
             raise WorkspaceIOError('workspace input contains NUL bytes; the file was left unchanged')

{pycforge-1.3.51 → pycforge-1.3.53}/pycforge/ide/io_service.py

@@ -182,11 +182,12 @@ class WorkspaceIOService:
                 raise StaleWorkspaceWrite("linked-file destination changed before publication")
             os.replace(temporary, destination)
             temporary = None
-        except StaleWorkspaceWrite:
+        except WorkspaceIOError:
             raise
         except Exception as exc:
             raise WorkspaceIOError(
-                f"atomic workspace write failed: {destination}"
+                f"atomic workspace write failed: {destination}\n"
+                f"{type(exc).__name__}: {exc}"
             ) from exc
         finally:
             if temporary is not None:

{pycforge-1.3.51 → pycforge-1.3.53}/pycforge/ide/project_model.py

@@ -137,7 +137,9 @@ def project_root(documents) -> Path | None:
     try:
         return Path(os.path.commonpath(paths))
     except ValueError:
-        raise ValueError('Project modules must be on the same drive.') from None
+        # A bundle embeds source text; linked files need not share a drive.
+        # Keep one anchor for relative layout and package the others by name.
+        return paths[0]
 
 
 def capture_project(snapshot, root: Path | None = None) -> ProjectState:
@@ -149,10 +151,7 @@ def capture_project(snapshot, root: Path | None = None) -> ProjectState:
             try:
                 relative = Path(item.path).absolute().relative_to(root.absolute()).as_posix()
             except ValueError:
-                raise ValueError(
-                    f'{Path(item.path).name} is outside the project folder "{root}". '
-                    'Use Save Python As to save it inside that folder first.'
-                ) from None
+                relative = Path(item.path).name
         files.append(ProjectFile(relative, item.module_id, item.logical_name, item.text, item.is_primary))
         if item.document_id == snapshot.active_document_id:
             active = relative

{pycforge-1.3.51 → pycforge-1.3.53}/pycforge/ide/project_workspace.py

@@ -14,7 +14,10 @@ def documents_for_project(state, current, root, *, opening=False):
     documents = []
     for item in state.files:
         old = previous.get(item.relative_path)
-        path = str(Path(root) / item.relative_path) if root else (old.path if old else None)
+        # Checkpoint restores keep existing linked-file locations, including
+        # files outside the working folder. Explicit Open Project creates new
+        # copies under its chosen folder instead.
+        path = old.path if old is not None else (str(Path(root) / item.relative_path) if root else None)
         dirty = False if opening else (old.dirty if old and old.text == item.text else True)
         documents.append(WorkspaceDocument(item.document_id, item.module_id, item.logical_name,
             item.text, path, item.primary, dirty,