pycforge 1.3.43__tar.gz → 1.3.44__tar.gz

{pycforge-1.3.43 → pycforge-1.3.44}/CURRENT_STATE.md

@@ -1,3 +1,14 @@
+# PyCForge 1.3.44 — Crucible release documentation
+
+- Package the complete application as 1.3.44, including metadata, startup,
+  workspace and About versions, and every generated HTML Help footer.
+- Publish the corrected README with its existing section order and examples,
+  current Typed conversion coverage, 29 Help pages and recent conversion fixes.
+- Retain exactly four external images: the PyCForge banner, two UI screenshots,
+  and the approved Crucible engine banner directly below the bug tracker.
+- Preserve the conversion engine, dependencies, icons and practical HTML Help.
+- See PyCForge-1.3.44-Verification.txt for the exact release checks and hashes.
+
 # PyCForge 1.3.43 — Immutable Typed record locals
 
 - Support fresh record aliases, exact initialized local class annotations,
@@ -6,7 +17,12 @@
   identity observations, redeclaration and collection aliases.
 - Retain explicit historical profiles and replay local declaration proofs.
 - Align the Classes & Functions copy action to the left title-bar slot.
-- Extend practical HTML Help; preserve README.md byte-for-byte.
+- Extend practical HTML Help without development-cycle status.
+- Refresh the existing README's conversion coverage and recent bug fixes;
+  retain its section order, feature focus, examples and contact information.
+- Introduce the Crucible engine banner below the bug tracker. Keep exactly
+  four external image URLs: the main banner, two UI screenshots and Crucible.
+- Rebuild the same 1.3.43 wheel and source archive for the user's own upload.
 - See specifications/record_locals_1_3_43.md and
   PyCForge-1.3.43-Verification.txt for scope and verification.
 

{pycforge-1.3.43 → pycforge-1.3.44}/MANIFEST.in

@@ -96,6 +96,7 @@ include PyCForge-1.3.41-Verification.txt
 
 include PyCForge-1.3.42-Verification.txt
 include PyCForge-1.3.43-Verification.txt
+include PyCForge-1.3.44-Verification.txt
 
 # Distribute only images needed by the application, never review screenshots
 # or design masters. Keep these exclusions after all graft/include directives.

{pycforge-1.3.43/pycforge.egg-info → pycforge-1.3.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pycforge
-Version: 1.3.43
+Version: 1.3.44
 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.40
+# PyCForge v1.3.44
 
 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.
 
@@ -47,7 +47,7 @@ Choose **Typed** conversion for annotated functions and direct C interfaces, or
 - **Work across files:** supply up to 64 Python modules, keep their source together, and generate C from the selected primary document and its supplied dependencies.
 - **Keep a project together:** save open Python modules in a portable `.pcfproj` bundle, preview it before opening, and compare or restore named checkpoints.
 - **Stay in control:** cancel background conversions, see when edits make generated output stale, and choose where to save the C result.
-- **Make the workspace yours:** saved layouts, independent Python and C text sizes, keyboard commands, and 28 searchable offline Help pages.
+- **Make the workspace yours:** saved layouts, independent Python and C text sizes, keyboard commands, and 29 searchable offline Help pages.
 - **Build from the IDE:** select PCFC11, GCC/MinGW-w64, Clang/Apple Clang, MSVC, or Clang-cl and create object files or executables with build logs, diagnostics, cancellation, and a copyable report. Each compiler family remembers its settings.
 
 ## Install and open
@@ -78,11 +78,11 @@ Select **Transpile → Typed** or **Transpile → Runtime**, then click **Transp
 
 | Feature | Typed conversion | Runtime conversion |
 | --- | --- | --- |
-| Functions | Annotated scalar parameters and results, scalar locals, direct calls, and required keyword arguments; positional immutable-record parameters, factory results, forwarding, and returns. | Function values, defaults, positional-only and keyword-only parameters, variadic and expanded calls, decorators, bound methods, nested functions, and captured lambdas. |
+| Functions | Annotated scalar parameters and results, scalar locals, direct calls, and required keyword arguments; positional immutable-record parameters, inline constructors, factory results, forwarding, and returns. | Function values, defaults, positional-only and keyword-only parameters, variadic and expanded calls, decorators, bound methods, nested functions, and captured lambdas. |
 | Text | String length, comparison, search, membership, prefix/suffix checks, and documented constant-text operations. | Constructed Unicode strings, concatenation/repetition, indexing/slicing, trimming, case conversion, split/join/replace, and formatting; `rsplit`, `splitlines`, `partition`/`rpartition`, `removeprefix`/`removesuffix`, `center`, `ljust`/`rjust`, `zfill`, and `expandtabs`. |
-| Lists and tuples | Fixed local homogeneous containers, literal indexing, and iteration. | Mixed and nested values, dynamic indexing, slice assignment/deletion, starred packing/unpacking, and shared containers passed into or returned from functions. |
+| Lists and tuples | Fixed local homogeneous scalar or record containers, literal indexing, and ordered iteration. | Mixed and nested values, dynamic indexing, slice assignment/deletion, starred packing/unpacking, and shared containers passed into or returned from functions. |
 | Dictionaries and sets | Fixed local dictionaries and numeric/Boolean set membership. | Ordered mutable dictionaries, merging, live views, mutable sets, frozen sets, set algebra, and supported hashable keys/elements. |
-| Classes | Immutable records with 1–64 `int`/`float`/`bool` fields and exact class types; parameters and returns across supplied Python modules become C structs passed by value. | Declared mutable fields, constructors, single and multiple inheritance, C3 method ordering, cooperative `super()`, overrides, and shared object identity. |
+| Classes | Exact immutable records with 1–64 scalar or nested record fields; local aliases and initialized class annotations; field reads from constructors and factory results. Parameters and returns across supplied modules become C structs passed by value. | Declared mutable fields, constructors, single and multiple inheritance, C3 method ordering, cooperative `super()`, overrides, and shared object identity. |
 | Numbers | Documented scalar arithmetic and integer floor division/remainder. | Checked 64-bit integer arithmetic, floating floor division/remainder, powers, modular powers, bitwise operations, and shifts. |
 | Branches and loops | Conditions, integer ranges, fixed-container loops, break/continue, and loop else. | Conditions, sequence/range/dictionary/view and supported iterator loops, short-circuit values, break/continue, and loop else. |
 | Comprehensions | Use the supported explicit loops. | List, dictionary, and set comprehensions with multiple generators, filters, dependent iterables, and fixed or starred unpacking. |
@@ -90,7 +90,7 @@ Select **Transpile → Typed** or **Transpile → Runtime**, then click **Transp
 | Multiple files | Up to 64 supplied modules with direct function and immutable-record imports, aliases, and record-only companions. | Up to 64 supplied modules with function/class/constant imports, aliases, re-exports, and separate namespaces. |
 | UTF-8 files | Bounded read/write entry points for C callers. | Connected read/process/write workflows across functions and modules, line iteration, sized reads, append, exclusive creation, `tell`/bounded `seek`, `r+`/`w+`/`a+`/`x+` update modes, and automatic handle cleanup. |
 | C integration | Direct scalar and record-value interfaces; optional separate `.c`/`.h` pairs per module, shared type declarations, and an ABI manifest; documented file ownership rules. | Generated value routines and a caller-owned memory context for strings, containers, objects, and closures. |
-| Memory lifetime | Scalar-field records use inline value copies without heap allocation; documented ownership rules apply to file buffers. | Context-owned values, with optional explicit `pv_collect` between completed calls using C-supplied roots; no active calls or open files during collection. |
+| Memory lifetime | Scalar and nested records use inline C value copies without heap allocation; fixed record collections use local arrays. Documented ownership rules apply to file buffers. | Context-owned values, with optional explicit `pv_collect` between completed calls using C-supplied roots; no active calls or open files during collection. |
 
 ### Text, collections, and everyday operations
 
@@ -102,7 +102,9 @@ Everyday operations include `sum`, `min`, `max`, `abs`, `round`, `any`, `all`, s
 
 ### Functions, objects, and annotations
 
-Typed mode accepts immutable records with scalar fields as positional function parameters and return values. A record factory can initialize a fresh local, and record-returning calls can be forwarded or nested as arguments. Import the record class directly from its defining supplied module, with an optional alias, to use it in constructors and annotations across modules; structurally identical classes remain distinct types. Construct a record in a fresh local before returning it. Record mutation, alias assignments, inline constructor arguments/returns, record keyword calls, defaults, and recursive record calls remain outside the supported forms. Generated C copies the complete struct by value; the HTML Help includes factory, consumer, and external C caller examples.
+Typed mode accepts immutable records with `int`/`float`/`bool` fields and nested records as positional function parameters and return values. Constructors and record-returning calls can appear directly in arguments and returns; fields can be read from their results or through nested records. Fresh locals support record aliases, exact initialized class annotations, chained assignment, and flat tuple/list-literal unpacking. Fixed local lists and tuples hold 1–64 records of one exact class, with literal indexing and ordered loops. Import a record class directly from its defining supplied module, with an optional alias, to use it across modules; structurally identical classes remain distinct types.
+
+Generated C copies the complete record by value, including nested fields. Layouts are acyclic, with up to eight record levels and 256 expanded scalar fields per record; fixed record collections allow up to 4096 scalar fields in total. Local record bindings belong directly in the function body and must use fresh names. Mutation, identity and whole-record equality checks, record keyword calls, defaults, and recursive record calls remain outside the supported forms. The HTML Help includes complete factory, nested-record, local-binding, collection, and external C caller examples, with the exact supported forms and limits.
 
 Runtime mode supports first-class functions, ordinary bound methods, nested functions, and lambdas that capture surrounding variables or default values. Closures can update enclosing bindings through `nonlocal`. Function and method decorators can retain state and forward `*args` and `**kwargs`.
 
@@ -139,7 +141,7 @@ Jedi provides offline completion, parameter hints, definition navigation, and na
 - **Find and replace precisely:** regular expressions, replacement within a captured selection, and reviewed replacement across open documents with **Ctrl+Shift+H**.
 - **Rename with review:** **F2** previews changes to statically resolved names in the current Python document before you apply them. Review dynamic references, string-based keyword names, and callers in other files separately.
 - **Format with undo:** **Alt+Shift+F** formats the document; **Ctrl+K, Ctrl+F** formats a selection while preserving unselected lines. Formatting preserves the Python syntax tree.
-- **Browse and copy definitions:** right-click the Python gutter to open **Classes & Functions**. A panel with a short progress bar covers the tree while definitions load, then disappears when the tree is ready. Double-click or press Enter to jump to a definition; the title-bar **Copy** icon copies its complete source, including decorators and indentation, without moving either editor view.
+- **Browse and copy definitions:** right-click the Python gutter to open **Classes & Functions**. A panel with a short progress bar covers the tree while definitions load, then disappears when the tree is ready. Double-click or press Enter to jump to a definition; the left-side title-bar **Copy** icon copies its complete source, including decorators and indentation, without moving either editor view.
 
 Completion and formatting are available independently of conversion coverage. Background analysis uses cached results, cancellation, and process deadlines; edits invalidate stale results. Cross-file replacement keeps undo history for each open document. Save edited buffers explicitly. Help explains the navigator's source-size limits and the boundaries of document-local rename.
 
@@ -219,7 +221,7 @@ The in-app API guide also explains Runtime requests, source bundles, conversion
 
 ## Help and supported boundaries
 
-Press **F1** or choose **Help → PyCForge Help…** for 28 searchable offline pages covering the editor, conversion tables, examples, diagnostics, Ting, shortcuts, and C integration. Separate references describe Typed and Runtime behavior, including a multi-file read/process/write example. Selected **PyCForge caveats** boxes explain practical conversion details beside relevant examples.
+Press **F1** or choose **Help → PyCForge Help…** for 29 searchable offline pages covering the editor, conversion tables, examples, diagnostics, Ting, shortcuts, and C integration. Separate references describe Typed and Runtime behavior, including a multi-file read/process/write example. Selected **PyCForge caveats** boxes explain practical conversion details beside relevant examples.
 
 PyCForge converts the documented Python forms. Integers use signed 64-bit values; generated Runtime values belong to a memory context. Destroying the context releases them, or C callers can explicitly collect unreachable values at documented idle boundaries while retaining live roots. Collection is not automatic inside Python loops and does not reset resource budgets. Exact ForgeLens mappings and generated-C structural checks cover Typed and Runtime conversion; they do not replace compilation and behavior testing.
 
@@ -243,5 +245,13 @@ Confirmed conversion issues and the release containing each fix. Regression test
 | 1.3.32 F03 · Zip consumption | Non-strict `zip` could skip later left-to-right partial consumption after an empty result. Each `next` call now retries its inputs in order. | 1.3.32 |
 | 1.3.32 F04 · File iterator rewind | `enumerate` and `zip` over files could remain exhausted after EOF and rewind. They now resume from the same open file after `seek(0)`. | 1.3.32 |
 | 1.3.32 F05 · Dictionary input pairs | `dict` and `dict.update` could consume too little of an invalid pair iterable. Pair validation now consumes the complete bounded inner iterable before checking its length, preserving earlier successful updates. | 1.3.32 |
+| Private record fields | External `__field` reads could generate C even though Python raises `AttributeError`. Typed conversion now rejects name-mangled record fields before lowering. | 1.3.42 |
+| Nested record imports | Nested field annotations could refer to imports declared after the class definition. Those imports must now precede the class, matching Python's name availability. | 1.3.42 |
+| Async-only diagnostics | Async-only input could be reported as having no function. Conversion now identifies the unsupported definition and explains that an eligible synchronous function is required. | 1.3.42 |
+| Record declaration validation | Conflicting record annotations could be lost during scalar normalization. Original record declarations are now checked before normalization, and invalid redeclarations are rejected. | 1.3.43 |
+
+<img src="https://res.cloudinary.com/vppzdwxg/image/upload/v1792420349/exec-7284d6da-a28b-4732-8980-a015c99067c6.png" alt="Crucible — a py to c conversion engine" width="640">
+
+**Crucible powers PyCForge's Typed and Runtime conversion.** Its conversion pipeline combines deterministic C generation, source-mapped diagnostics, and explicit checks on supported Python forms. Regression coverage includes Python-versus-C execution, multi-module programs, and separately compiled C interfaces. The practical HTML Help documents how to use that scope and where its boundaries lie.
 
 Contact Robert Cecil `rcttcr5@icloud.com` for request or security assistance

{pycforge-1.3.43 → pycforge-1.3.44}/PYPI_RELEASE.md

@@ -1,3 +1,40 @@
+# PyCForge 1.3.44 — Current release files
+
+Upload this complete verified pair together:
+
+- `pycforge-1.3.44-py3-none-any.whl`
+- `pycforge-1.3.44.tar.gz`
+
+Both package versions and the README heading are 1.3.44. The README contains
+current conversion coverage and the approved Crucible banner below the bug
+tracker, with exactly four external image links. Version displays throughout
+the installed application derive from the same package version.
+
+Use the file hashes in `PyCForge-1.3.44-Verification.txt` to identify this pair.
+Run `python -m twine check --strict` on these two files before upload.
+Publication is handled separately by the user. Earlier versioned entries below
+are retained as historical release and review records.
+
+# PyCForge 1.3.43 — Previous release preparation
+
+The release remains version 1.3.43. Use the final rebuilt pair together:
+
+- `pycforge-1.3.43-py3-none-any.whl`
+- `pycforge-1.3.43.tar.gz`
+
+The README retains its established structure and updates current conversion
+coverage, recent fixes, and the Crucible engine banner. Its only external links
+are the PyCForge banner, two UI screenshots, and Crucible. No banner or screenshot
+files are bundled. Application code, practical HTML Help and dependencies are
+unchanged from the reviewed 1.3.43 build.
+
+Use `PyCForge-1.3.43-Verification.txt` for the recorded verification scope and
+platform limits. Check the final pair with `python -m twine check --strict`
+and `python -m tools.verify_public_distribution` before selecting files for
+upload. Publication is performed separately by the user; this preparation
+does not upload to PyPI. The older versioned entries below describe their
+original releases and retain the detailed review and upload procedure.
+
 # PyCForge 1.3.4 — Classes & Functions loading panel
 
 - Cover the complete tree area, including its header, with a themed panel while definitions are parsed and tree rows are populated.

{pycforge-1.3.43 → pycforge-1.3.44}/PyCForge-1.3.43-Verification.txt

@@ -1,5 +1,6 @@
 PyCForge 1.3.43 — Immutable Typed record locals
-Review build, 2026-10-19. Based on the reviewed 1.3.42 source archive.
+Release preparation, 2026-10-19. Version remains 1.3.43 for the user's upload.
+Conversion upgrades are based on the reviewed 1.3.42 source archive.
 
 CONVERSION
 Typed conversion accepts fresh local record aliases, initialized exact class
@@ -40,12 +41,30 @@ diagnostic guidance are synchronized. All 79 documented Python examples convert
 (30 Typed, 49 Runtime). All 29 Help pages pass their loading, navigation and source
 checks. No development-cycle status was added to HTML Help.
 
-README.md is byte-for-byte unchanged, including the approved heading, prose,
-examples, contact details, banner URL and two screenshot URLs. Its SHA256 is:
-a54bf91aadb61d72cdfd37aa4aa27ae74255428d5c41a5e3951ef7a8cece713c
+README.md retains its established section order, feature focus, code examples,
+contact information, main banner and two accurately labeled 1.3.39 screenshots.
+The heading now matches 1.3.43; Typed coverage includes constructor expressions,
+nested records, fixed record collections and local record bindings. Both Help
+counts now say 29. The navigator description identifies the left-side Copy icon.
+
+The approved Crucible banner appears directly below the conversion bug tracker,
+before a concise engine description and the unchanged contact line. Exactly four
+external image URLs remain, with no navigation or mailto links. PyPI Markdown
+rendering preserves the main banner's 320-pixel width and Crucible's 640-pixel
+width. The public Crucible PNG returned HTTP 200 and matches the approved image.
+The footer was visually checked using a local Qt rendering of the sanitized HTML.
+
+The tracker now records the 1.3.42 private-field name-mangling correction,
+definition-time import validation for nested record annotations, and the
+async-only diagnostic correction. It also records the conflicting record
+declaration defect found and fixed during development of the 1.3.43 feature;
+this does not imply that defect was present in an earlier published release.
+
+Final README SHA256:
+dbbdab3fd648870e694b93d4056cc83769a8700dfebd8183f729017e3a7abf7f
 The Runtime backend is byte-for-byte unchanged.
 
-VERIFICATION
+CONVERSION-UPGRADE VERIFICATION
 - 37 new tests cover local values, imported annotations, invalid neighbors,
   historical rejection, proof tampering, deterministic exports, evaluation order
   and conflicting scalar redeclarations.
@@ -63,13 +82,37 @@ VERIFICATION
 - Installed wheel: 137 tests and 466 subtests passed, including the new records,
   structured-record regression, navigator and HTML Help. Tests imported the
   installed package explicitly. Counts overlap and are not a distinct-test total.
-- The wheel and source archive pass strict twine checks and the public archive
-  verifier. README rendering retains the approved banner and two screenshots.
-  Only required application icons are packaged; no review screenshots or design
-  images are included.
+- The preceding review-build wheel and source archive passed strict twine checks
+  and the public archive verifier with the then-frozen three-image README.
+  Those review-build results remain historical evidence; the final README and
+  rebuilt release files are checked separately below.
+
+FINAL RELEASE PREPARATION
+- Focused release regression: 133 tests and 482 subtests passed. This covers
+  public distribution policy, presentation, release metadata, all HTML Help,
+  structured records and local record bindings, including every new tracker row.
+- The README's section sequence and fenced code examples match the prior
+  review build exactly. The four-image order and banner placement pass both
+  source checks and the actual PyPI Markdown renderer.
+- All 884 application source files remain byte-identical to the preceding
+  1.3.43 review build, including all 29 HTML Help pages. No development-cycle
+  status was introduced into HTML Help.
+- All 878 installed application files match the final wheel, source and prior
+  review wheel. Only wheel METADATA and RECORD change, reflecting the README.
+  Installed Typed record-local and Runtime conversions pass.
+- Installed metadata, Qt application version, workspace titles, startup title
+  and label, About badge, and every Help footer agree on 1.3.43.
+- The final wheel and source archive pass strict twine validation and the public
+  distribution verifier. Each contains exactly 504 required icon assets and
+  no banner, screenshot or other nonessential image files. The README is embedded
+  identically in the wheel metadata and source distribution.
+
+Final preparation evidence is under evidence/release_readme_1_3_43/. Final
+archive hashes are appended to the accompanying report after packaging.
 
 Evidence is under evidence/record_locals_1_3_43/ in the source archive. This is a
 focused verification result, not a claim that the entire repository suite ran.
 Validation used Linux, Python 3.12, GCC and Qt offscreen. Native Windows UI and
 compiler acceptance remain for the user's laptop review. No PyPI publication,
-MISRA compliance claim, engine rename or additional install dependency was made.
+MISRA compliance claim or additional install dependency was made. Crucible is
+the public engine name; package names, APIs and installed commands are unchanged.

pycforge-1.3.44/PyCForge-1.3.44-Verification.txt

@@ -0,0 +1,70 @@
+PyCForge 1.3.44 — Complete release and corrected README
+Prepared 2026-10-19 for the user's own PyPI upload.
+
+RELEASE IDENTITY
+The wheel, source distribution, project metadata and imported package version
+are 1.3.44. Installed Qt application version, empty/open workspace titles,
+startup title and label, About badge and every Help footer all report 1.3.44.
+Historical release notes, test fixture names and bug-fix versions retain their
+original identities.
+
+README
+The README heading is PyCForge v1.3.44. Its established section order, code
+examples, feature focus, main banner, two UI screenshots and contact details
+are preserved. Coverage reflects constructor expressions, nested records,
+fixed record collections and exact immutable local record bindings. Help
+counts are 29, and the navigator description identifies the left-side Copy icon.
+
+Exactly four external image URLs appear, in this order:
+1. PyCForge banner at the top, 320-pixel display width.
+2. Existing PyCForge workspace screenshot.
+3. Existing Ting evidence screenshot.
+4. Approved Crucible engine banner directly below the conversion bug tracker,
+   640-pixel display width, with the subtitle a py to c conversion engine.
+
+The tracker includes the private-field correction, nested annotation import
+validation and async-only diagnostic fix from 1.3.42, plus the conflicting
+record declaration correction from 1.3.43. The HTML Help remains a practical
+coding reference without development-cycle status.
+
+The actual PyPI Markdown renderer verifies all four images and their order,
+banner widths and absence of extra navigation/mailto links. The README is
+byte-identical in the source tree, wheel METADATA, source README and source
+PKG-INFO. Final README SHA256:
+4cb2dba4d7703f7029f3cff5539f3d11e73780439faaff6e6e3a5092b9a6f308
+
+PRESERVATION
+All 884 application source files match the corrected 1.3.43 build except
+pycforge/_version.py. Conversion behavior, Typed/Runtime contracts, application
+dependencies, icon assets and all 29 HTML Help pages are preserved. The default
+Typed profile remains typed-record-locals-v1.6 / c-renderer-v1.6.
+
+VERIFICATION
+- Release and version checks: 126 tests and 680 subtests passed after the
+  snapshot correction described below. Five checks requiring an unavailable
+  sealed Phase 14D predecessor archive were skipped; their reasons are recorded.
+- The initial run passed 125 tests and failed one obsolete active-profile
+  serialization fingerprint assertion. Both the active and historical result
+  payloads were independently compared with the reviewed 1.3.43 source and
+  were identical. The active expected fingerprint was synchronized with that
+  verified v1.6 result; the historical fingerprint and generated-C checks were
+  preserved. The complete affected test then passed.
+- All 878 installed application files match the wheel and source byte for byte.
+  Installed Typed record-local conversion and Runtime conversion both pass.
+- Installed version checks cover metadata, Qt application version, workspace,
+  startup, About, and every Help footer.
+- Both release archives pass strict twine checks and the public distribution
+  verifier, including matching README metadata, dependencies, entry points,
+  source payloads, licenses and required resources.
+- Each archive contains exactly 504 required application icons. No banners,
+  screenshots or other nonessential image files are packaged.
+
+Evidence is under evidence/release_1_3_44/ in the source archive. Prior conversion
+regression evidence is retained under its original versioned directories.
+These are focused release checks, not a claim of a complete repository-suite
+pass. Verification used Linux, Python 3.12, GCC and Qt offscreen; a new native
+Windows or macOS run was not performed. No PyPI upload was performed.
+
+Upload the two files named pycforge-1.3.44-py3-none-any.whl and
+pycforge-1.3.44.tar.gz together. Their final SHA256 values are appended to the
+accompanying verification report after archive construction.

{pycforge-1.3.43 → pycforge-1.3.44}/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.40
+# PyCForge v1.3.44
 
 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.
 
@@ -17,7 +17,7 @@ Choose **Typed** conversion for annotated functions and direct C interfaces, or
 - **Work across files:** supply up to 64 Python modules, keep their source together, and generate C from the selected primary document and its supplied dependencies.
 - **Keep a project together:** save open Python modules in a portable `.pcfproj` bundle, preview it before opening, and compare or restore named checkpoints.
 - **Stay in control:** cancel background conversions, see when edits make generated output stale, and choose where to save the C result.
-- **Make the workspace yours:** saved layouts, independent Python and C text sizes, keyboard commands, and 28 searchable offline Help pages.
+- **Make the workspace yours:** saved layouts, independent Python and C text sizes, keyboard commands, and 29 searchable offline Help pages.
 - **Build from the IDE:** select PCFC11, GCC/MinGW-w64, Clang/Apple Clang, MSVC, or Clang-cl and create object files or executables with build logs, diagnostics, cancellation, and a copyable report. Each compiler family remembers its settings.
 
 ## Install and open
@@ -48,11 +48,11 @@ Select **Transpile → Typed** or **Transpile → Runtime**, then click **Transp
 
 | Feature | Typed conversion | Runtime conversion |
 | --- | --- | --- |
-| Functions | Annotated scalar parameters and results, scalar locals, direct calls, and required keyword arguments; positional immutable-record parameters, factory results, forwarding, and returns. | Function values, defaults, positional-only and keyword-only parameters, variadic and expanded calls, decorators, bound methods, nested functions, and captured lambdas. |
+| Functions | Annotated scalar parameters and results, scalar locals, direct calls, and required keyword arguments; positional immutable-record parameters, inline constructors, factory results, forwarding, and returns. | Function values, defaults, positional-only and keyword-only parameters, variadic and expanded calls, decorators, bound methods, nested functions, and captured lambdas. |
 | Text | String length, comparison, search, membership, prefix/suffix checks, and documented constant-text operations. | Constructed Unicode strings, concatenation/repetition, indexing/slicing, trimming, case conversion, split/join/replace, and formatting; `rsplit`, `splitlines`, `partition`/`rpartition`, `removeprefix`/`removesuffix`, `center`, `ljust`/`rjust`, `zfill`, and `expandtabs`. |
-| Lists and tuples | Fixed local homogeneous containers, literal indexing, and iteration. | Mixed and nested values, dynamic indexing, slice assignment/deletion, starred packing/unpacking, and shared containers passed into or returned from functions. |
+| Lists and tuples | Fixed local homogeneous scalar or record containers, literal indexing, and ordered iteration. | Mixed and nested values, dynamic indexing, slice assignment/deletion, starred packing/unpacking, and shared containers passed into or returned from functions. |
 | Dictionaries and sets | Fixed local dictionaries and numeric/Boolean set membership. | Ordered mutable dictionaries, merging, live views, mutable sets, frozen sets, set algebra, and supported hashable keys/elements. |
-| Classes | Immutable records with 1–64 `int`/`float`/`bool` fields and exact class types; parameters and returns across supplied Python modules become C structs passed by value. | Declared mutable fields, constructors, single and multiple inheritance, C3 method ordering, cooperative `super()`, overrides, and shared object identity. |
+| Classes | Exact immutable records with 1–64 scalar or nested record fields; local aliases and initialized class annotations; field reads from constructors and factory results. Parameters and returns across supplied modules become C structs passed by value. | Declared mutable fields, constructors, single and multiple inheritance, C3 method ordering, cooperative `super()`, overrides, and shared object identity. |
 | Numbers | Documented scalar arithmetic and integer floor division/remainder. | Checked 64-bit integer arithmetic, floating floor division/remainder, powers, modular powers, bitwise operations, and shifts. |
 | Branches and loops | Conditions, integer ranges, fixed-container loops, break/continue, and loop else. | Conditions, sequence/range/dictionary/view and supported iterator loops, short-circuit values, break/continue, and loop else. |
 | Comprehensions | Use the supported explicit loops. | List, dictionary, and set comprehensions with multiple generators, filters, dependent iterables, and fixed or starred unpacking. |
@@ -60,7 +60,7 @@ Select **Transpile → Typed** or **Transpile → Runtime**, then click **Transp
 | Multiple files | Up to 64 supplied modules with direct function and immutable-record imports, aliases, and record-only companions. | Up to 64 supplied modules with function/class/constant imports, aliases, re-exports, and separate namespaces. |
 | UTF-8 files | Bounded read/write entry points for C callers. | Connected read/process/write workflows across functions and modules, line iteration, sized reads, append, exclusive creation, `tell`/bounded `seek`, `r+`/`w+`/`a+`/`x+` update modes, and automatic handle cleanup. |
 | C integration | Direct scalar and record-value interfaces; optional separate `.c`/`.h` pairs per module, shared type declarations, and an ABI manifest; documented file ownership rules. | Generated value routines and a caller-owned memory context for strings, containers, objects, and closures. |
-| Memory lifetime | Scalar-field records use inline value copies without heap allocation; documented ownership rules apply to file buffers. | Context-owned values, with optional explicit `pv_collect` between completed calls using C-supplied roots; no active calls or open files during collection. |
+| Memory lifetime | Scalar and nested records use inline C value copies without heap allocation; fixed record collections use local arrays. Documented ownership rules apply to file buffers. | Context-owned values, with optional explicit `pv_collect` between completed calls using C-supplied roots; no active calls or open files during collection. |
 
 ### Text, collections, and everyday operations
 
@@ -72,7 +72,9 @@ Everyday operations include `sum`, `min`, `max`, `abs`, `round`, `any`, `all`, s
 
 ### Functions, objects, and annotations
 
-Typed mode accepts immutable records with scalar fields as positional function parameters and return values. A record factory can initialize a fresh local, and record-returning calls can be forwarded or nested as arguments. Import the record class directly from its defining supplied module, with an optional alias, to use it in constructors and annotations across modules; structurally identical classes remain distinct types. Construct a record in a fresh local before returning it. Record mutation, alias assignments, inline constructor arguments/returns, record keyword calls, defaults, and recursive record calls remain outside the supported forms. Generated C copies the complete struct by value; the HTML Help includes factory, consumer, and external C caller examples.
+Typed mode accepts immutable records with `int`/`float`/`bool` fields and nested records as positional function parameters and return values. Constructors and record-returning calls can appear directly in arguments and returns; fields can be read from their results or through nested records. Fresh locals support record aliases, exact initialized class annotations, chained assignment, and flat tuple/list-literal unpacking. Fixed local lists and tuples hold 1–64 records of one exact class, with literal indexing and ordered loops. Import a record class directly from its defining supplied module, with an optional alias, to use it across modules; structurally identical classes remain distinct types.
+
+Generated C copies the complete record by value, including nested fields. Layouts are acyclic, with up to eight record levels and 256 expanded scalar fields per record; fixed record collections allow up to 4096 scalar fields in total. Local record bindings belong directly in the function body and must use fresh names. Mutation, identity and whole-record equality checks, record keyword calls, defaults, and recursive record calls remain outside the supported forms. The HTML Help includes complete factory, nested-record, local-binding, collection, and external C caller examples, with the exact supported forms and limits.
 
 Runtime mode supports first-class functions, ordinary bound methods, nested functions, and lambdas that capture surrounding variables or default values. Closures can update enclosing bindings through `nonlocal`. Function and method decorators can retain state and forward `*args` and `**kwargs`.
 
@@ -109,7 +111,7 @@ Jedi provides offline completion, parameter hints, definition navigation, and na
 - **Find and replace precisely:** regular expressions, replacement within a captured selection, and reviewed replacement across open documents with **Ctrl+Shift+H**.
 - **Rename with review:** **F2** previews changes to statically resolved names in the current Python document before you apply them. Review dynamic references, string-based keyword names, and callers in other files separately.
 - **Format with undo:** **Alt+Shift+F** formats the document; **Ctrl+K, Ctrl+F** formats a selection while preserving unselected lines. Formatting preserves the Python syntax tree.
-- **Browse and copy definitions:** right-click the Python gutter to open **Classes & Functions**. A panel with a short progress bar covers the tree while definitions load, then disappears when the tree is ready. Double-click or press Enter to jump to a definition; the title-bar **Copy** icon copies its complete source, including decorators and indentation, without moving either editor view.
+- **Browse and copy definitions:** right-click the Python gutter to open **Classes & Functions**. A panel with a short progress bar covers the tree while definitions load, then disappears when the tree is ready. Double-click or press Enter to jump to a definition; the left-side title-bar **Copy** icon copies its complete source, including decorators and indentation, without moving either editor view.
 
 Completion and formatting are available independently of conversion coverage. Background analysis uses cached results, cancellation, and process deadlines; edits invalidate stale results. Cross-file replacement keeps undo history for each open document. Save edited buffers explicitly. Help explains the navigator's source-size limits and the boundaries of document-local rename.
 
@@ -189,7 +191,7 @@ The in-app API guide also explains Runtime requests, source bundles, conversion
 
 ## Help and supported boundaries
 
-Press **F1** or choose **Help → PyCForge Help…** for 28 searchable offline pages covering the editor, conversion tables, examples, diagnostics, Ting, shortcuts, and C integration. Separate references describe Typed and Runtime behavior, including a multi-file read/process/write example. Selected **PyCForge caveats** boxes explain practical conversion details beside relevant examples.
+Press **F1** or choose **Help → PyCForge Help…** for 29 searchable offline pages covering the editor, conversion tables, examples, diagnostics, Ting, shortcuts, and C integration. Separate references describe Typed and Runtime behavior, including a multi-file read/process/write example. Selected **PyCForge caveats** boxes explain practical conversion details beside relevant examples.
 
 PyCForge converts the documented Python forms. Integers use signed 64-bit values; generated Runtime values belong to a memory context. Destroying the context releases them, or C callers can explicitly collect unreachable values at documented idle boundaries while retaining live roots. Collection is not automatic inside Python loops and does not reset resource budgets. Exact ForgeLens mappings and generated-C structural checks cover Typed and Runtime conversion; they do not replace compilation and behavior testing.
 
@@ -213,5 +215,13 @@ Confirmed conversion issues and the release containing each fix. Regression test
 | 1.3.32 F03 · Zip consumption | Non-strict `zip` could skip later left-to-right partial consumption after an empty result. Each `next` call now retries its inputs in order. | 1.3.32 |
 | 1.3.32 F04 · File iterator rewind | `enumerate` and `zip` over files could remain exhausted after EOF and rewind. They now resume from the same open file after `seek(0)`. | 1.3.32 |
 | 1.3.32 F05 · Dictionary input pairs | `dict` and `dict.update` could consume too little of an invalid pair iterable. Pair validation now consumes the complete bounded inner iterable before checking its length, preserving earlier successful updates. | 1.3.32 |
+| Private record fields | External `__field` reads could generate C even though Python raises `AttributeError`. Typed conversion now rejects name-mangled record fields before lowering. | 1.3.42 |
+| Nested record imports | Nested field annotations could refer to imports declared after the class definition. Those imports must now precede the class, matching Python's name availability. | 1.3.42 |
+| Async-only diagnostics | Async-only input could be reported as having no function. Conversion now identifies the unsupported definition and explains that an eligible synchronous function is required. | 1.3.42 |
+| Record declaration validation | Conflicting record annotations could be lost during scalar normalization. Original record declarations are now checked before normalization, and invalid redeclarations are rejected. | 1.3.43 |
+
+<img src="https://res.cloudinary.com/vppzdwxg/image/upload/v1792420349/exec-7284d6da-a28b-4732-8980-a015c99067c6.png" alt="Crucible — a py to c conversion engine" width="640">
+
+**Crucible powers PyCForge's Typed and Runtime conversion.** Its conversion pipeline combines deterministic C generation, source-mapped diagnostics, and explicit checks on supported Python forms. Regression coverage includes Python-versus-C execution, multi-module programs, and separately compiled C interfaces. The practical HTML Help documents how to use that scope and where its boundaries lie.
 
 Contact Robert Cecil `rcttcr5@icloud.com` for request or security assistance

{pycforge-1.3.43 → pycforge-1.3.44}/RELEASE_NOTES.md

@@ -1,3 +1,14 @@
+# PyCForge 1.3.44 — Crucible release documentation
+
+- Package the complete application as 1.3.44, including metadata, startup,
+  workspace and About versions, and every generated HTML Help footer.
+- Publish the corrected README with its existing section order and examples,
+  current Typed conversion coverage, 29 Help pages and recent conversion fixes.
+- Retain exactly four external images: the PyCForge banner, two UI screenshots,
+  and the approved Crucible engine banner directly below the bug tracker.
+- Preserve the conversion engine, dependencies, icons and practical HTML Help.
+- See PyCForge-1.3.44-Verification.txt for the exact release checks and hashes.
+
 # PyCForge 1.3.43 — Immutable Typed record locals
 
 - Support fresh record aliases, exact initialized local class annotations,
@@ -6,7 +17,12 @@
   identity observations, redeclaration and collection aliases.
 - Retain explicit historical profiles and replay local declaration proofs.
 - Align the Classes & Functions copy action to the left title-bar slot.
-- Extend practical HTML Help; preserve README.md byte-for-byte.
+- Extend practical HTML Help without development-cycle status.
+- Refresh the existing README's conversion coverage and recent bug fixes;
+  retain its section order, feature focus, examples and contact information.
+- Introduce the Crucible engine banner below the bug tracker. Keep exactly
+  four external image URLs: the main banner, two UI screenshots and Crucible.
+- Rebuild the same 1.3.43 wheel and source archive for the user's own upload.
 - See specifications/record_locals_1_3_43.md and
   PyCForge-1.3.43-Verification.txt for scope and verification.
 

pycforge-1.3.44/evidence/release_1_3_44/contract-followup.log

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

pycforge-1.3.44/evidence/release_1_3_44/contract-snapshot-review.json

@@ -0,0 +1,9 @@
+{
+  "passed": true,
+  "result_payloads_identical_to_reviewed_1_3_43": true,
+  "sha256": {
+    "active": "62df9e9436e1ff9c395778d9a02fcec54375582f762037dea043933d47092067",
+    "historical": "bb1efa5c8562058c7939d2db7af77a6ab9e5825d9d77b8a045f645fb7a6c154d"
+  },
+  "reason": "Current active-profile snapshot was stale before the 1.3.44 version update; generated C and historical-profile output are unchanged."
+}

pycforge-1.3.44/evidence/release_1_3_44/installed-package.json

@@ -0,0 +1,7 @@
+{
+  "passed": true,
+  "version": "1.3.44",
+  "application_files_equal_in_source_wheel_install": 878,
+  "wheel_readme_equals_source": true,
+  "typed_record_and_runtime_smoke": "passed"
+}

pycforge-1.3.44/evidence/release_1_3_44/installed-versions.json

@@ -0,0 +1,15 @@
+{
+  "passed": true,
+  "version": "1.3.44",
+  "installed_from": "/workspace/scratch/b4dab6fbe6e4/installed-1.3.44/pycforge/__init__.py",
+  "checked": [
+    "distribution metadata",
+    "Qt application version",
+    "empty and open workspace titles",
+    "startup title and label",
+    "About badge and package",
+    "every Help page footer"
+  ],
+  "removed": "AboutModeBadge",
+  "platform": "Linux Qt offscreen"
+}

pycforge-1.3.44/evidence/release_1_3_44/preservation.json

@@ -0,0 +1,11 @@
+{
+  "passed": true,
+  "version": "1.3.44",
+  "application_files": 884,
+  "changed_application_files": [
+    "pycforge/_version.py"
+  ],
+  "readme_matches_corrected_1_3_43_except_heading": true,
+  "readme_sha256": "4cb2dba4d7703f7029f3cff5539f3d11e73780439faaff6e6e3a5092b9a6f308",
+  "html_help_pages_unchanged": 29
+}

pycforge-1.3.44/evidence/release_1_3_44/readme-render.json

@@ -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": 34239,
+  "screenshot_elements": 2
+}

pycforge-1.3.44/evidence/release_1_3_44/release-tests.log

@@ -0,0 +1,66 @@
+.........................sss.s.s... [ 26%]
+..............................................................F.................................                                                      [100%]
+=================================== FAILURES ===================================
+_ CheckpointEVersioningTests.test_phase16_advances_while_explicit_phase14d_output_stays_frozen _
+
+self = <test_checkpoint_e_versioning.CheckpointEVersioningTests testMethod=test_phase16_advances_while_explicit_phase14d_output_stays_frozen>
+
+    def test_phase16_advances_while_explicit_phase14d_output_stays_frozen(self) -> None:
+        self.assertEqual(__version__, "1.3.44")
+        self.assertEqual(CONVERTER_CONTRACT_VERSION, "0.16.0")
+        self.assertEqual(WORKSPACE_CONTRACT_VERSION, "pycforge-workspace/0.8")
+    
+        active = PythonToCConverter().convert(
+            ConversionRequest.from_source(CHECKPOINT_SOURCE),
+            observation=ObservationOptions("Full", True),
+        )
+    
+        self.assertEqual(active.status.value, "Converted")
+        self.assertEqual(active.stage_artifact.schema_version, "0.16.0")
+        self.assertEqual(active.stage_artifact.payload["schema_version"], GENERATED_C_SCHEMA)
+        self.assertEqual(active.stage_artifact.payload["c_ir_schema"], C_IR_SCHEMA)
+        self.assertEqual(
+            active.conversion_summary["schema_version"],
+            CONVERSION_SUMMARY_SCHEMA,
+        )
+        self.assertEqual(active.decision_trace["schema_version"], DECISION_TRACE_SCHEMA)
+        self.assertEqual(active.decision_trace["converter_version"], "0.16.0")
+        self.assertEqual(
+            active.output_fingerprint.value,
+            "685607a0916efeeef5300966bc30e5a9c5b9ad21c3929b7b681db2c8fe050418",
+        )
+        self.assertEqual(
+            hashlib.sha256(active.generated_c.encode("utf-8")).hexdigest(),
+            "5c85b6ca4b6ff59f2c6c073df4967db17ef64a5c8d1eda926e528cc45c20eb84",
+        )
+        active_tables = {
+            item["table_id"] for item in active.stage_artifact.payload["fact_tables"]
+        }
+        self.assertTrue(
+            {
+                "scope-lifetime-facts",
+                "loop-completion-facts",
+                "file-session-facts",
+                "file-operation-facts",
+                "file-cleanup-facts",
+                "file-failure-facts",
+                "file-ownership-facts",
+            }.issubset(active_tables)
+        )
+        active_serialized = json.dumps(
+            result_to_dict(active),
+            sort_keys=True,
+            separators=(",", ":"),
+        ).encode("utf-8")
+>       self.assertEqual(
+            hashlib.sha256(active_serialized).hexdigest(),
+            "d88a2f5a2fd099594bcf66ddfe248a7790a7ccf23107f41ba451f4e49d521385",
+        )
+E       AssertionError: '62df9e9436e1ff9c395778d9a02fcec54375582f762037dea043933d47092067' != 'd88a2f5a2fd099594bcf66ddfe248a7790a7ccf23107f41ba451f4e49d521385'
+E       - 62df9e9436e1ff9c395778d9a02fcec54375582f762037dea043933d47092067
+E       + d88a2f5a2fd099594bcf66ddfe248a7790a7ccf23107f41ba451f4e49d521385
+
+tests/test_checkpoint_e_versioning.py:85: AssertionError
+=========================== short test summary info ============================
+FAILED tests/test_checkpoint_e_versioning.py::CheckpointEVersioningTests::test_phase16_advances_while_explicit_phase14d_output_stays_frozen
+1 failed, 125 passed, 5 skipped, 680 subtests passed in 14.03s