pycforge 1.0.2__tar.gz → 1.0.5__tar.gz

pycforge-1.0.5/CHANGELOG.md

@@ -0,0 +1,895 @@
+# Changelog
+
+## 1.0.5 — Focused IDE refinement
+
+Reduced all non-editor UI text by one point while preserving the Python and
+generated-C editors at 14 pt and 12 pt. Added restrained glass depth to controls,
+wider squarer scrollbars, slim illuminated state lines for the generated-C and
+Details toolbar toggles, and a gradient-backed Help navigation rail.
+
+Removed the Python indentation-guide overlay and its setting. Function-fold
+layout now synchronizes each shared source view immediately, moves cursors out
+of newly hidden blocks, preserves access to the final function at the scroll
+boundary, and remains stable while Generated C is repeatedly hidden or shown.
+A fresh publishable conversion reveals hidden generated C automatically.
+Transpilation Details returns as a resizable lower inspector opening at 38
+percent of the available workspace instead of replacing the editors.
+
+Replaced runtime SVG resources with 495 packaged PNG assets: 55 established
+glyphs at nine resolutions from 16 through 256 pixels. Ting feedback now has
+wide, labeled previous/next agent controls plus a live graphical Flow Map of the
+source-free evidence fan-out, six current agent decisions, and advisory-only
+fan-in. About now presents a 42-pixel brand mark, a fixed-size surface with a
+titlebar-blended live world UTC clock, converter identities, full workspace
+state topology, and authenticated Ting engine, registry, agent, rule, and test
+telemetry.
+
+Advanced the package to 1.0.5, the workspace contract to 0.8, the action
+registry to 0.6, and the visual system to 0.5. Converter schemas, rules,
+renderer, generated C, and Ting shadow authority remain unchanged at 0.16.0.
+
+Corrected the final physical-Windows dialog review without changing the shared
+hover design. Help, About, Ting Agent Feedback, and Ting Agent Flow Map now
+open and reopen with focus in their content, matching the Open Python dialog.
+Their maximize and close controls therefore illuminate only while genuinely
+hovered or deliberately keyboard-focused instead of retaining a blue or red
+focus line on activation. All other dialogs and converter behavior are
+unchanged.
+
+## 1.0.4 — PyPI publication refresh
+
+Reissued the fully validated 1.0.3 package under a fresh public version for a
+clean PyPI upload. The two README screenshots retain their fixed, versioned
+Cloudinary PNG delivery URLs.
+
+Advanced the package and application version to 1.0.4. Converter behavior,
+generated C, Ting agents and authority, the notification correction, workspace
+behavior, and all UI and dialog presentation remain unchanged from 1.0.3.
+
+## 1.0.3 — Reliable PyPI screenshot delivery
+
+Replaced the two unreliable public README image addresses with fixed,
+versioned Cloudinary PNG delivery URLs. Both remote objects were independently
+retrieved as 1920 × 1080 PNG files and matched the packaged screenshots byte
+for byte before the release was built.
+
+Advanced the package and application version to 1.0.3. The converter, generated
+C, Ting agents and authority, notification fix, workspace, and every other UI
+or dialog behavior remain unchanged from 1.0.2.
+
+## 1.0.2 — Focused presentation and notification polish
+
+Replaced the former release-contract-heavy README with a shorter public guide
+centered on PyCForge's purpose, installation, upgrades, immediate desktop
+launch, principal workspace features, Ting agent integration, built-in Help,
+CLI/API access, and safety boundary. Added current full-workspace and Ting
+feedback screenshots to the source distribution and PyPI description.
+
+Made the top notification banner's SVG close control follow the active
+information, success, warning, or error foreground color. Hover, focus, and
+pressed states retain the same semantic background and border family, so the
+control no longer appears detached from its message. No other workspace or
+dialog presentation was changed.
+
+Advanced the package and application version to 1.0.2. Converter schemas,
+lowering, generated-C behavior, Ting shadow authority, workspace contracts,
+and the authenticated 1.0.1 fixed-set rules remain unchanged.
+
+## 1.0.1 — Fixed sets and professional workspace continuity
+
+Added a fail-closed fixed-set profile to the active Phase 16 base. Direct
+function-local literals of 1–64 unique homogeneous integer, finite-float, or
+Boolean elements lower to read-only automatic C arrays. Exact-representation
+`in` and `not in` evaluate their searched expression once and use bounded
+linear equality. New authenticated membership facts, 1.0.1 rule identities,
+independent validation, conversion summary records, exact diagnostics, and
+positive/negative tests cover declaration and lowering. Unsupported order,
+hash-table, mutation, alias, and escape behavior remains outside the contract.
+
+Added parser-authenticated Python function folding, Fold All and Unfold All
+source controls, and subtle Python-only indent guides. Generated C remains a
+plain immutable inspection surface. Large-source fold discovery now consumes
+the existing authenticated background structure result; Fold All returns to
+the event loop immediately and applies bounded regions only after exact
+document/revision validation. Fold application touches only changed bounded
+block lines, preventing the synchronous parser/block-scan freeze reported on
+Windows.
+
+Removed the desktop shell's synthetic permanent first document. A new window
+may be genuinely empty; the first opened or created Python module becomes
+primary automatically, and every tab—including the first or final restored
+tab—can be closed. Closing the final tab persists an intentionally empty
+restart session. Linked files that remain open at exit still reopen in their
+prior order with the prior active file selected. Added an independent
+**Clear Recent Files** action that never closes tabs, deletes files, or changes
+the restart session. Long main-window titles now elide before the window
+controls, and Find/Replace keeps Previous and Next in one compact group.
+
+Replaced native dialog titlebars with reusable accessible PyCForge frameless
+chrome across Help, About, startup, settings, file browsers, command palette,
+go-to-line, guarded choices, restoration reporting, and Ting feedback. The
+flat titlebar carries the canonical brand mark and an extensible icon-toolbar
+host; resizable dialogs expose system and bounded manual resize paths.
+
+Persisted the ordered set of linked saved Python files and active linked file.
+Startup restores them sequentially under the 64-document ceiling and reports
+every unavailable or unreadable path in a nonblocking selectable dialog.
+Unsaved source text is not serialized.
+
+Added a source-free, read-only Ting feedback terminal after converted and
+rejected decisions. An overview and all six mandatory agent tabs expose exact
+evidence, gaps, bounded matching metrics, and rulepack identities. The shadow
+review has no authority over conversion and does not fabricate compiler or
+differential evidence.
+
+Updated all fourteen classified offline HTML Help pages and navigation search
+metadata needed for the new conversion and workspace features. Advanced the
+package and application identity to 1.0.1 while retaining the documented Phase
+16 base schemas and renderer.
+
+Corrected the 1.0.1 desktop presentation after physical-review feedback.
+Python source now defaults to 14 pt, generated C to 12 pt, Help body text to
+12 pt, and application controls to a 12 pt minimum. Presentation-settings
+schema 3 removes the faulty schema-2 global-font projection and oversized
+restored geometry while preserving compatible session data. Top-level windows
+fit the current monitor work area under Windows display scaling. Function fold
+markers are larger, Fold All and Unfold All are direct Edit-menu actions, the
+Ting/About status buttons are matched and contained, menu-item hover tooltips
+are disabled, and ordinary typing no longer rewrites the persistent status
+message.
+
+Completed a second physical-Windows typography correction without changing
+the editor sizes or Help article typography. Ordinary non-editor controls now
+use the exact menu font, including Help controls, file browsers, inspectors,
+About, startup, and monospaced Ting feedback. The three workspace caption
+bands use a deliberate compact 10 pt hierarchy and the Python header gives
+adaptive space to both module identity and path text. The Open preview is decoupled
+from the 14 pt source editor and uses compact menu-sized page geometry.
+Transpilation Details always starts hidden and opens as a full-height review
+mode instead of compressing the editor. Source/mapping activation returns to
+the editor. Accepted code-font choices use a durable restart mirror; guarded
+Save/Discard focus borders retain bottom clearance; QAction status tips cannot
+enter the status bar. Help, About, and startup rasterize the
+redesigned flat `brand-mark.svg` directly at the final logical size and device
+pixel ratio, eliminating enlarged 24-pixel bitmap intermediates.
+
+## 0.16.3 — Complete in-app Help and workspace usability
+
+Status: PyCForge 0.16.3 package release; active converter, rule-set, renderer,
+runtime-policy, plan, C-IR, artifact, summary, trace, and result-envelope
+contracts remain unchanged from the PyPI 0.16.2 package.
+
+Added a professional, fully offline HTML Help dialog under the new **Help**
+menu and **F1**. Fourteen editable HTML pages are classified through a
+validated catalog, presented with persistent left navigation, and searched as
+one global documentation set. They cover the entire cumulative conversion
+surface, including typed functions, expressions,
+conditionals, scalar scope publication, loops and loop `else`, containers,
+records, direct/keyword calls, explicit module imports, bounded UTF-8 file
+reading and writing, the generated-C file ABI and status codes, CLI/API use,
+diagnostics, safety, limits, shortcuts, and active identities. The installed
+application no longer relies on a PDF or an external repository for user help.
+
+Replaced editor-only font sizing with one persisted 8–32 point workspace text
+size. Direct **View** actions and `Ctrl+=`, `Ctrl+-`, and `Ctrl+0` now resize
+menus, toolbars, dialogs, trees, diagnostics, Python, generated C, previews,
+and Help together. Schema-1 editor preferences migrate into the application-
+wide setting and changes synchronize immediately.
+
+The custom Open/Save dialogs now remember per-mode geometry, columns,
+directory, and—where applicable—the browser/preview splitter and last selected
+Python file. Open never displays a restored preview unless its tree row is
+visibly selected. The first **New Module** reuses a pristine initial `main.py`
+placeholder, eliminating the accidental empty-main diagnostic while retaining
+the converter's deliberate rejection of genuinely empty bundle modules.
+
+Added Undo, Redo, Cut, Copy, and Paste to the main toolbar; enlarged module-tab
+close targets; rebuilt status-bar ownership so left feedback stretches inside
+the bar and right-side controls remain contained; and replaced stylesheet and
+editor-rail gradients/texture backgrounds with a flat blackened-steel palette.
+
+Package metadata now identifies PyPI as the authoritative distribution page.
+The package version advances to 0.16.3 because published PyPI files are
+immutable; the active converter contract remains exactly 0.16.0.
+Workspace, action-registry, and visual-system presentation identities advance
+to `pycforge-workspace/0.7`, `pycforge.action-registry/0.4`, and
+`pycforge.visual-system/0.4`; persisted presentation settings advance to schema
+`2` with bounded schema-1 font migration.
+
+Added six deterministic Ting shadow-review agents for syntax, semantics,
+ownership, lowering, verification, and typed capability/resource binding.
+Their 34 embedded tests run without skips through a read-only source gate.
+Proof-preserving pruning evaluates every registered role while using bounded
+schema and equality indexes inside each rulepack. PyCForge ships only a
+private execution runtime, authenticated registry, and precompiled Compact-IR.
+The runtime retains the bounded `.ting` Compact-IR loader/parser and verifier.
+Only the authoring-side RuleSpec source parser, compiler, writers, builders,
+consoles, reference engine, history subsystem, and command entry points are
+excluded from both public archives and retained separately under compiler
+custody.
+
+Added an accessible branded startup progress dialog driven only by completed
+initialization work. It validates the vector catalogue, all offline Help
+sources, and every packaged `.ting` artifact before constructing the
+workspace. The dialog supports safe-boundary cancellation, presents bounded
+startup errors, performs no network access, and uses the same flat visual
+surface and canonical brand mark as the main window, Help, and About.
+
+## 0.16.2 — Evaluation hardening and motionless editing
+
+Status: PyCForge 0.16.2 package release; active converter contracts,
+generated-C identities, and the 0.16.0 Programmer's Conversion Guide remain
+unchanged.
+
+Repaired the frontend's virtual-EOF coordinate mapping so valid source converts
+without a terminal newline or completely empty final line. The repair maps the
+tokenizer's virtual final position to exact EOF without inserting or
+normalizing text and preserves source bytes, newline records, document identity,
+and authenticated hash. The `clamp` reproduction no longer falls through to
+`PYC9001`.
+
+Made normal typing visually motionless across the toolbar Convert action,
+conversion-status labels, the generated-C stale/last-complete label, and Python
+source breadcrumbs. State updates now occur in place, while progress animation
+is limited to actual conversion work. Corrected Python-editor point-size loading
+so the chosen value survives restart and applies to both current and future
+split source panes.
+
+Added a compact, menu-preserving frameless shell and reduced toolbar and notice
+height without shrinking their established text. Replaced native tree icons
+with PyCForge dark-theme iconography, bounded the Open dialog's initial height,
+and moved Previous/Next navigation above the preview page. Reworked About into
+a wider categorized view with version and contract information, end-of-file and
+current/stale-state explanations, Details and split-view cues, and no
+personal-name text. The existing toolbar action remains the single Show/Hide
+control for Transpilation Details.
+
+Documented fresh and explicit-upgrade commands for both POSIX environments and
+the Windows `py` launcher. Package version 0.16.2 retains the 0.16.0 converter,
+rule-set, renderer, runtime-policy, plan, C IR, generated-artifact, summary, and
+decision-trace identities; workspace and settings identities also remain
+unchanged.
+
+## 0.16.1 — ForgeLens and blackened-steel workspace
+
+Status: PyCForge 0.16.1 release; converter contracts, generated C, and the
+0.16.0 Programmer's Conversion Guide remain unchanged.
+
+Added optional, default-on ForgeLens cross-highlighting from authenticated
+Python↔C mappings. It follows exact focused selections without taking focus or
+switching documents, persists its Editor Settings toggle, clears safely across
+document and lifecycle changes, and fails closed on excessive mapping fanout.
+Position indexing now handles Qt newline normalization, query scans stop as
+soon as their ordered interval cannot match, endpoint storage is compact, and
+unchanged marker projections are not repainted.
+
+Introduced a coordinated blackened brushed-steel workspace with restrained
+focus and selection colors, semantic primary/danger states, coherent menus and
+dialogs, and the PyCForge brand mark in About. Replaced native file pickers
+with bounded custom browsers: Open renders readable Python pages in memory with
+Previous/Next controls, while Save remains preview-free. Hardened dialog error
+recovery, path elision, accessibility descriptions, tree sizing, and preview
+retirement behavior.
+
+Added the concise five-feature UI roadmap and refreshed the public README with
+an immutable, code-rich 1600×1000 workspace screenshot. The complete package
+still uses the active Phase 16 converter identities at 0.16.0.
+
+## 0.16.0 — Scope, loop completion, and bounded UTF-8 file I/O
+
+Status: PyCForge 0.16.0 release; explicit Phase 14A-14D requests and all
+historical 0.15.3 workspace custody remain preserved.
+
+### Selective scalar scope lifetimes
+
+Added immutable, resource-bounded, independently reconstructed
+`fact-table/0.16-scope-lifetimes` proof. Scalar locals first assigned in
+exhaustive conditional branches can now lower to one uninitialized C
+function-entry declaration plus source-ordered branch assignments when every
+reachable continuation proves initialization before use. Nested conditionals
+and the surviving branch after a sibling return are reachability-aware.
+
+The profile remains deliberately selective: loops, containers, records,
+closures, globals/nonlocals, missing branch coverage, read-before-definition,
+unknown or incompatible categories, and malformed or over-budget evidence fail
+closed. Already-supported unrelated constructs remain independent.
+
+### Loop completion and safe `range`
+
+Added exact Python `else` behavior for admitted `while`, positional-`range`,
+and fixed list/tuple/dictionary loops. Natural completion and zero iterations
+run the else suite; only a source `break` owned by that loop suppresses it.
+Nested breaks do not suppress an outer else, `continue` preserves completion,
+and `return` bypasses it. One deterministic Boolean flag is emitted only when
+the loop owns a break, with clears immediately before those exact breaks.
+
+Added a structured pre-addition guard for signed-64 range induction. An update
+that would cross `INT64_MAX` or `INT64_MIN` selects the staged stop value
+instead, preserving exhaustion without undefined C signed overflow.
+
+### Closed bounded UTF-8 file profile
+
+Added one exact direct function-body context profile:
+`with open(path, "r" or "w", encoding="utf-8", newline="") as fresh_handle`
+with one direct read transfer or one direct write of an already-proved string
+name or string literal whose count is discarded. Effectful write expressions
+reject with `PYC3905` because helper-internal open cannot preserve context-entry
+before body-evaluation order.
+Reads default to 1,048,576 bytes, have a hard 16,777,216-byte ceiling, reject
+embedded NUL and non-RFC-3629 UTF-8, close exactly once, and transfer ownership
+only after successful close. Writes use borrowed text, require an exact byte
+count, close exactly once, and propagate failure. Handle aliasing, rebinding,
+escape, post-region use, explicit close, unsupported open shapes, and source
+calls into file-effect functions reject with the `PYC3901`–`PYC3908` family.
+
+Registered helpers are `pycf.file.read_all_utf8_bounded@1.0.0` and
+`pycf.file.write_utf8_exact@1.0.0`, with registry-closed transitive UTF-8
+validation. Generated file-effect entry points receive a hidden final,
+required non-null `int64_t *` status parameter in caller-owned storage. Stable
+codes are 0 success, 1 open, 2 allocation, 3 read, 4 limit, 5 embedded NUL,
+6 invalid UTF-8, 7 close, and 8 write. A successful read returns a unique
+caller-owned `malloc` buffer that the external caller must `free`.
+Every file-effect entry point null-checks its status pointer and then initializes
+it to success before any source-controlled early return or evaluation; helper
+failures overwrite that value with their stable code.
+
+Recorded the external C-string preconditions explicitly: paths must be
+non-null, NUL-terminated valid UTF-8; borrowed write text has the same
+preconditions and no embedded NUL. The helpers do not runtime-validate pointer
+validity, path UTF-8/NUL properties, or hidden write bytes after the first
+terminator. Compile-time path/write literals containing NUL reject with
+`PYC3903`/`PYC3905`; read-content statuses 5 and 6 do not claim input-string
+validation.
+
+### Contracts and custody
+
+Advanced the active converter to `0.16.0` with
+`phase16-scope-loop-file-v0.16.0`, `c-renderer-v0.16.0`,
+`conversion-plan/0.16.0`, `c-ir/0.16.0`, `generated-c/0.16.0`, and matching
+0.16.0 summary/trace identities. The result envelope remains `0.5`. Phase 16
+adds closed structured pointer, cast, conditional-expression, null, and C
+library-intrinsic C IR forms needed by the proved runtime. Historical Phase 14D
+schemas, rendering, diagnostics, output bytes, hashes, rejections, and helper
+manifests remain unchanged under explicit `0.14.3` requests.
+
+Conversion never executes source Python and never opens a path selected by the
+source. PyCForge never compiles, links, loads, or runs generated C. File I/O,
+status writes, allocation, ownership transfer, and caller `free` occur only if
+an external party separately builds and runs the generated C.
+
+The authenticated desktop worker protocol is now
+`pycforge.worker-protocol/0.2`; it preserves the active runtime-policy identity
+and all expanded resource fields across the GUI process boundary. Added a
+reproducible 35-page 0.16.0 Programmer's Conversion Guide with 22 live-converter
+examples, deterministic PDF reconstruction, and release-asset verification.
+
+## 0.15.3 — Workspace usability and PySide6 transition
+
+Status: release candidate; converter semantics remain sealed at `0.14.3`.
+
+Migrated the desktop application from PyQt5/Qt 5 to PySide6/Qt 6 and made
+`PySide6>=6.8,<7` the single required GUI binding. Updated native actions,
+signals, dialogs, input events, high-DPI behavior, CI, packaging checks, and
+clean-install smoke coverage for Qt 6.
+
+Added a bounded, persisted **Edit → Editor Settings…** control for the text
+size of both synchronized Python source views. The setting accepts 8–48 points,
+updates tab stops and editor side areas immediately, survives shared-document
+rebinding, and leaves the generated-C viewer unchanged.
+
+Added undoable Python auto-indentation on Enter. Existing leading whitespace
+is preserved and genuine suite-opening colons add four spaces; colons inside
+strings, comments, and open bracket expressions do not trigger an extra level.
+
+Removed passive source-mapping backgrounds and underlines from generated C.
+Mapping records, the overview rail, activation, and source/output navigation
+remain available, while the generated-C text surface remains read-only and
+explicit-save-only.
+
+Advanced the workspace contract to `pycforge-workspace/0.6`, the action
+registry to `pycforge.action-registry/0.3`, and the visual system to
+`pycforge.visual-system/0.3`. Presentation settings remain schema `1`, the
+worker protocol remains `pycforge.worker-protocol/0.1`, and the complete
+converter subtree remains unchanged at `0.14.3`.
+
+## 0.15.2 — Phase 15C IDE-grade authoring and inspection workspace
+
+Status: promoted and sealed; Phase 15D remains unopened.
+
+Prepared the first public PyPI distribution without changing the
+converter contract. PyQt5 is now a mandatory runtime dependency of the base
+package, so an ordinary `pip install pycforge` installs the desktop application
+and both `pycforge` and `pycforge-workspace` entry points. Removed the obsolete
+`workspace` extra, added PyPI long-description and project metadata, corrected
+the command-line examples, and added clean-build, clean-install, offscreen Qt,
+release-artifact and Trusted Publishing gates.
+
+Established the public source license as `GPL-3.0-only`, compatible with the
+GPL PyPI distribution of PyQt5, and included the complete license text in the
+source and package metadata.
+
+Advanced the package to `0.15.2`, the workspace contract to
+`pycforge-workspace/0.5`, the action registry to
+`pycforge.action-registry/0.2`, and the visual system to
+`pycforge.visual-system/0.2`. The converter remains sealed at `0.14.3`, the
+worker protocol remains `pycforge.worker-protocol/0.1`, and presentation
+settings remain schema `1`.
+
+Added identifier-only document-tab and split-pane session state, with at most
+two synchronized Python source panes. Added bounded undoable source operations
+for line duplication, line movement, indentation, outdentation, and Python
+comment toggling, together with go-to-line, whitespace visibility, and source
+fold controls.
+
+Added cancellable latest-wins source-structure analysis for already-open Python
+text. The normalized outline and breadcrumb projection is parent-linked and
+bounded by symbol count, depth, name length, and source-text budgets. Invalid
+syntax remains inert and cannot retire valid structure for unrelated open
+documents.
+
+Added deterministic literal bundle search across the explicit open
+`SourceBundle`, with immutable path-free requests, exact Python and UTF-16
+positions, bounded previews, a global 5,000-match cap, and stale-generation
+suppression. No host directory or project discovery was introduced.
+
+Added a bounded command palette that projects enabled and visible static
+registry actions without retaining handlers or adding a free-form command
+execution surface. Added payload-free session transpilation history capped at
+64 terminal records.
+
+Expanded the declarative command system to 48 actions, five persistent main
+menus, and eleven context surfaces. Added the Navigate menu, source-authoring
+commands, document-tab, bundle-search, history, text-input, and read-only-text
+contexts while preserving the exact read-only generated-C command allowlist and
+single-owner persistent `QAction` construction.
+
+Expanded the vector catalogue from 41 to 55 safe SVG icons and extended the
+shared workspace stylesheet for document tabs, split views, breadcrumbs,
+outline, bundle-search results, history, and command-palette presentation.
+
+Preserved the Phase 15A spawned-worker model, one-active/one-latest scheduling,
+bounded cancellation, immutable revision and fingerprint authentication,
+stale-result suppression, off-GUI file and search work, and incremental
+generated-C projection. Python remains the only editable code surface.
+
+Recorded current-release real PyQt evidence on the offscreen QPA backend
+using Python 3.12.13, PyQt 5.15.11, Qt build 5.15.14, and Qt runtime 5.15.19.
+One `QApplication` ran 18 focused workspace cases with zero failures, errors,
+or skips. A 250,113-character source constructed the window in 0.054 seconds,
+reached the first event turn in 0.0103 seconds, and produced 110 timer ticks at
+0.01-second intervals during 1.201 seconds of isolated transpilation. Large-file
+mode detached the syntax highlighter while preserving the shared editor buffer;
+shutdown left zero new PyCForge threads and zero worker leaks. A small
+end-to-end workspace conversion completed in 0.408 seconds as supporting
+evidence.
+
+Authenticated, assigned the canonical validation report and release
+fingerprint, and built and validated the Phase 15C milestone source archive,
+pure-Python wheel, handoff, package report, and checksum records. These
+artifacts establish Phase 15C release custody, not the wider Phase 15D
+distribution and platform gate.
+
+PyCForge remains a deterministic Python-to-C source transpiler. It does not
+compile, assemble, link, load, run, execute, debug, profile, deploy, or invoke
+generated C or a C toolchain.
+
+The real offscreen widget evidence is not visible-platform certification.
+Visible Windows 11/Linux rendering, physical display scaling, and
+assistive-technology validation remain Phase 15D gates.
+
+## 0.15.1 — Phase 15B application shell and visual system
+
+Status: implemented and validated within the available supporting scope.
+
+Advanced the workspace contract to `pycforge-workspace/0.4` and introduced the
+import-safe `pycforge.action-registry/0.1`. Every persistent application command
+now has one declarative authority for its stable ID, label, mnemonic, SVG icon,
+shortcut, tooltip, status explanation, accessible name, checkability, tone, and
+allowed surfaces. The Qt adapter creates each persistent `QAction` once and
+shares it across menus, toolbars, context surfaces, and bounded dynamic entries.
+
+Added custom gradient/icon File, Edit, View, and Transpile menus and declared
+context menus for Python source, read-only generated C, the Source Bundle
+navigator, diagnostics, mappings, conversion summary, decision trace, and
+telemetry. The custom presentation remains native-backed by `QMenu` and
+`QAction`, preserving keyboard traversal, mnemonics, shortcut columns, checked
+state, focus return, Escape dismissal, assistive exposure, submenu behavior,
+and screen-edge placement. Generated C uses an explicit read-only command
+allowlist.
+
+Introduced `pycforge.visual-system/0.1` with cohesive semantic graphite
+surfaces, layered gradients, high-contrast text, blue and violet focus accents,
+a restrained warm transpilation accent, and explicit success, warning, error,
+and danger treatments. Expanded professional self-contained SVG iconography
+uses logical dimensions and excludes raster payloads, embedded data, remote
+references, fixed physical sizing, scripts, and font-glyph dependencies.
+
+Added high-DPI and accessibility foundations: high-DPI scaling before
+application construction, logical icon sizing, stable menu accessible names,
+visible tooltips and accessible names for icon-only controls, visible keyboard
+focus, and non-color-only state treatment. The interface has no animation and
+is reduced-motion safe by construction.
+
+Removed the legacy presentation-namespace migration and compatibility surface.
+Current source, settings, menus, toolbars, tests, evidence, and distribution
+use PyCForge identity exclusively. Original pre-migration bytes remain
+authoritative in the authenticated Phase 15A archive.
+
+Preserved all Phase 15A responsiveness and isolation guarantees: spawned
+conversion, one-active/one-latest scheduling, cooperative and hard
+cancellation, immutable revision authentication, stale-result suppression,
+off-GUI file I/O and search, bounded editor projections, incremental generated-C
+population, and exact Save C authority.
+
+Bounded the structured detail inspectors with an iterative cycle-safe
+projection limited to 1,024 nodes, 16 levels, 256 children per container, and
+2,048 characters per value. Corrected scroll-area context placement, made
+uncommitted identity edits immediately stale and unsavable as C, and suppressed
+cancellation-pending diagnostics as non-current.
+
+Hardened release custody around a descriptor-bound, size-bounded source
+snapshot and a validation-subject digest that is checked against the exact
+packaged bytes. Packaging now pins its production environment, compares
+duplicate wheel and normalized-source builds, inspects and smokes the sealed
+wheel payload, rejects noncanonical validation JSON, and durably publishes the
+seven-artifact directory only after the final vocabulary and checksum graph
+passes.
+
+The package is `0.15.1`; the converter remains sealed at `0.14.3`, the worker
+protocol remains `pycforge.worker-protocol/0.1`, and presentation settings
+remain schema `1`. PyCForge remains a deterministic Python-to-C source
+transpiler. No C compiler, linker, loader, runtime execution, debugger,
+terminal, toolchain, project explorer, plugin system, or generated-C editor was
+added.
+
+PyQt5 is unavailable on the validation host, so Phase 15B evidence is
+supporting source, static, headless, registry, icon, and optional-widget
+evidence only. Visible Windows 11/Linux rendering, real display scaling, and
+assistive-technology validation remain Phase 15D gates. Phase 15C and Phase 15D
+remain unopened.
+
+Final discovery runs 750 tests: 734 pass, 16 are expected skips, and none fail.
+Eleven skips require unavailable PyQt5 widgets; five require unavailable older
+optional custody artifacts.
+
+## 0.15.0 — Phase 15A responsiveness and isolation
+
+Status: promoted and sealed.
+
+Replaced workspace in-process conversion with a spawn-only process supervisor.
+The bounded `pycforge.worker-protocol/0.1` uses canonical JSON over byte-only
+connections and validates generation, bundle, transport, request, artifact,
+mapping, and output identities before publication. Scheduling is exactly one
+active plus one replaceable latest pending request.
+
+Added cooperative cancellation with a 750 ms grace, hard termination and
+two-second reclamation, latest-pending start bounds, non-blocking close, and
+recoverable startup, crash, malformed/oversized IPC, broken-pipe, and worker
+resource-exhaustion handling. Canceled, failed, stale, superseded, partial, or
+mismatched work cannot publish C or replace last-known-good C.
+
+Added immutable off-GUI revision/index services with cached UTF-8 and UTF-16
+position facts. Convert and Save C remain disabled until the latest revision
+authenticates. Moved linked-file reads, hashes, observations, and guarded atomic
+writes to bounded daemon workers; an in-flight stale Save C fails before atomic
+replacement.
+
+Added debounced latest-wins literal search with an exact total and a 5,000-range
+projection cap. Added automatic large-file editor mode, bounded syntax/bracket
+work, marker and overview caps, viewport-focused selections, incremental 32 KiB
+generated-C projection, and deferred hidden output/detail work. Source edits
+are coalesced before proportional controller synchronization.
+
+Validated direct-versus-isolated serialized-result equality, hard-cancel and
+failure containment, maximum-envelope revision/search/index behavior, injected
+slow file I/O, and 100 edit/convert/cancel cycles without stale publication,
+deadlock, crash, obsolete pending work, or orphan processes.
+
+Advanced the package to `0.15.0` and workspace contract to
+`pycforge-workspace/0.3`. The complete converter subtree and every converter
+contract remain sealed at `0.14.3`.
+
+PyCForge remains a Python-to-C source transpiler. No compiler, linker, loader,
+generated-C executor, runner, debugger, terminal, toolchain, plugin,
+project-explorer, host-discovery, or generated-C editor was added. Phase 15B,
+15C, and 15D remain unopened; visible Windows 11/Linux PyQt and accessibility
+claims are reserved for Phase 15D.
+
+## 0.14.4 — Hardening Checkpoint E
+
+Status: promoted and sealed.
+
+Completed the roadmap's post-Phase-14 full-subset architecture review,
+deterministic full-supported-subset fuzz and metamorphic gate, and documentation
+and 69-entry feature-matrix reconciliation. No Python construct, C IR shape,
+helper, diagnostic, conversion policy, public converter schema, or generated-C
+style was added or changed.
+
+Separated the package identity (`0.14.4`) from the sealed deterministic
+converter contract identity (`0.14.3`). Golden output, serialized results,
+facts, RulePlans, summaries, traces, telemetry, diagnostics, mappings, and
+fingerprints remain Phase 14D values.
+
+Corrected the active desktop identity to PyCForge across front-facing titles,
+accessibility names, theme exports, and the settings namespace. Added a bounded,
+non-destructive migration for allow-listed predecessor presentation settings
+and retained non-exported compatibility aliases only for sealed historical
+validators.
+
+Established `pycforge-workspace/0.2` and a binding workspace-quality addendum.
+The addendum assigns the requested process-isolated conversion supervisor,
+maximum-input responsiveness, professional IDE-grade authoring and inspection,
+custom gradient/icon main and context menus, accessibility, high-DPI, and real
+Windows 11/Linux PyQt gates to Phase 15. Checkpoint E does not claim those
+future gates or open Phase 15.
+
+PyCForge remains a Python-to-C source transpiler. It does not compile, link,
+load, run, execute, debug, benchmark, or otherwise invoke generated C or a C
+toolchain.
+
+Promotion executes all 69 frozen feature-matrix entries plus the unlisted
+default, with 37 supported witnesses converted and 33 boundary witnesses
+rejected without mismatch. The seeded hardening corpus contains 16 fixed and
+64 generated cases, four per promoted family, and all 80 match the
+authenticated Phase 14D predecessor byte-for-byte.
+
+Final validation discovers 589 tests: 572 pass, 17 are expected skips, and
+zero fail. The focused Checkpoint E set passes 46 of 46, and every cumulative
+source-only audit passes. Reproducible wheel and normalized source-archive
+builds are byte-identical; isolated wheel and extracted-source smokes pass.
+The wheel contains both PyCForge entry points, exactly 17 SVG assets, and no
+native binaries.
+
+## 0.14.3 — Phase 14D exact required keyword-only calls
+
+Status: promoted and sealed.
+
+Added one exact source-only declaration and call profile for required
+keyword-only parameters on already-resolved direct source functions. An admitted
+function may have existing required positional-only and positional-or-keyword
+parameters followed by one or more exactly annotated required keyword-only
+parameters. Every `kw_defaults` entry is null; positional defaults,
+keyword-only defaults, `*args`, and `**kwargs` remain rejected.
+
+Ordinary positional actuals bind only positional-capable formals. Explicit named
+actuals may bind unbound positional-or-keyword or required keyword-only formals.
+Every required formal is covered exactly once with an exact category and
+representation match. Explicit values stage once in Python source order; only
+pure temporary references are arranged in full formal order for the existing
+structured `CCallExpr`. No runtime binder, `TypeError` channel, default
+evaluation, coercion, allocation, ownership transfer, or cleanup model was
+added.
+
+Added complete positive and negative `keyword-only-call-binding-facts` under
+`fact-table/0.14.3` and the helper-free
+`phase14.keyword_only_call.exact_binding@0.14.3` RulePlan. The lowering shape is
+`source-order-actual-temporaries-formal-order-references-v1`. Independent
+validation reconstructs declaration kind, target, name binding, coverage,
+categories, source/formal orders, C parameter order, and exact plan
+correspondence before lowering.
+Required-keyword-only declarations remain in the existing function-signature
+facts without changing the serialized `ParameterFact` shape. Affected existing
+`FunctionDef` RulePlans gain explicit keyword-only parameter and
+C-interface-mode-erasure facts and obligations, and independent validation
+covers admitted declarations even when they have no call site.
+
+No new source diagnostic code is required. `PYC2904` retains missing coverage
+and excess positional arity, `PYC2905` exact representation mismatch, `PYC2910`
+unpacking and excluded call shapes, and `PYC2912` exact name-binding failures.
+Under active 0.14.3 identities `PYC2911` continues to reject defaults,
+defaulted keyword-only parameters, variadics, and keyword-only declarations
+outside the exact required profile; it no longer rejects an otherwise eligible
+required keyword-only declaration solely because `kwonlyargs` is nonempty.
+Historical 0.14.2 diagnostics remain unchanged.
+
+Advanced the active rule set to
+`phase14-required-keyword-only-calls-v0.14.3`, renderer to
+`c-renderer-v0.14.3`, and conversion-plan, C IR, generated-C, summary, and
+decision-trace envelopes to 0.14.3. SourceBundle 0.2, Python IR 0.4, result
+serialization 0.5, target and semantic policies, the helper registry, and all
+container/module/record/numeric/conditional policies remain frozen.
+
+Explicit 0.14.2 and earlier requests retain their exact facts, plans,
+diagnostics, generated-C bytes, and fingerprints. Under active 0.14.3
+identities, sources selecting no Phase 14D declaration or call behavior retain
+Phase 14C generated-C bytes and output fingerprints. Required keyword-only
+support adds no C IR syntax kind, renderer grammar, helper, host discovery, or
+toolchain surface. Generated C remains source-validated only and is not
+compiled, linked, loaded, or executed. Defaults, variadics, unpacking, dynamic
+targets, methods, recursion, exceptions, closures, generators, async behavior,
+and every neighboring Phase 14 family remain excluded. Phase 15 has not
+started.
+
+Promotion passed 539 discovered tests: 524 passed, 15 skipped, and zero failed.
+The skips are exactly 10 for unavailable PyQt5 and five for unavailable older
+custody artifacts. The focused Phase 14D gate passed 65 of 65 tests. Every
+active cumulative audit passed, including the required-keyword-only and
+Phase 14D transition audits.
+
+Two fixed-epoch builds produced the same 340,054-byte
+`pycforge-0.14.3-py3-none-any.whl`, SHA-256
+`c0dd0c0ed79131daa5af815a8a9bb096b9f955c9c617ec0b8eb6a10c69d27b7f`.
+The wheel archive and `RECORD` each account for 132 members: 17 SVG assets and
+zero native-code members. Two normalized source-archive builds were likewise
+byte-identical. The promoted converter subtree SHA-256 is
+`74b32c25e40af3398dd46288941812ce7ad87f0d4b72fec3d3bd786cc1b8f3a8`.
+
+Release validation remained source-only: no gate compiled, linked, loaded, or
+executed generated C. No new actual PyQt5 widget or Windows 11 execution is
+claimed. Historical opening records remain preserved, and Phase 15 has not
+started.
+
+## 0.14.2 — Phase 14C direct exact keyword calls
+
+Status: promoted and sealed.
+
+Added one closed compile-time binding profile for explicit keyword arguments on
+already-resolved direct source-function calls. Calls may use a leading ordinary
+positional prefix followed by one or more explicit named keywords. Every
+required formal is bound exactly once, positional-only formals remain
+positional-only, and actual/formal categories must match exactly. Same-module
+and existing explicit cross-module source-function bindings are eligible;
+dynamic targets, callable values, methods, defaults, keyword-only parameters,
+variadics, `*`/`**` unpacking, recursion, `range` keywords, and record-
+constructor keywords remain excluded.
+
+Added independent keyword-call analysis and reconstruction,
+`keyword-call-binding-facts` under `fact-table/0.14.2`, and the helper-free
+`phase14.keyword_call.exact_binding@0.14.2` RulePlan. Argument values are staged
+left to right and once in Python source order, then pure temporary references
+are arranged in formal ordinal order for the existing structured `CCallExpr`.
+No C IR node kind, renderer grammar, helper, runtime binder, failure channel,
+allocation, ownership transfer, or cleanup model was added.
+
+Added `PYC2912` for exact static name-binding failures: unknown keyword names,
+positional-only names used as keywords, positional/keyword collisions, and
+duplicate keywords. `PYC2910` remains the boundary for `*`/`**`, null keyword
+names, unpacking, and other excluded keyword shapes. Existing target,
+declaration, arity, category, record, `range`, and recursion diagnostics retain
+precedence.
+
+Advanced the active rule set, renderer, conversion plan, C IR, generated-C,
+summary, and trace envelopes to 0.14.2. SourceBundle 0.2, Python IR 0.4, result
+serialization 0.5, all public policies, the helper registry, Phase 14A numeric
+facts/helpers, and Phase 14B `fact-table/0.14.1` conditional facts and RulePlans
+remain unchanged. Explicit 0.14.1 requests retain their historical keyword
+rejection and artifact behavior; active sources selecting no 14C call retain
+predecessor generated-C bytes and output fingerprints.
+
+Promotion authenticated the sealed Phase 14B source archive and wheel, passed
+the cumulative suite and audits including the keyword and Phase 14/14B/14C
+transition audits, sealed deterministic wheel and source-archive builds, and
+passed isolated package validation. All release validation remained source-only;
+generated C was not compiled, linked, loaded, or executed. PyQt5 was unavailable
+in the release environment, so no new widget execution is claimed and sealed
+offscreen-widget evidence remains preserved. Windows 11 execution is not
+claimed. Phase 14D and Phase 15 have not started.
+
+## 0.14.1 — Phase 14B conditional temporary regions
+
+Status: Phase 14B promoted and sealed.
+
+Added exact conditional placement for statement-producing temporaries belonging
+to expressions already supported by the cumulative scalar subset. Boolean
+`and`/`or` expressions now use an initialized Boolean result and flat guarded
+assignments. Later operands of chained comparisons use guarded materialization
+and rolling middle values, preserving left-to-right, exactly-once evaluation
+without eagerly evaluating skipped operands.
+
+Added independent conditional-region analysis and validation,
+`fact-table/0.14.1` conditional facts, two 0.14.1 RulePlan families, and active
+`conversion-plan/0.14.1`, `c-ir/0.14.1`, `generated-c/0.14.1`, summary, trace,
+rule-set, and renderer identities. No Python syntax, primitive operation,
+public policy, helper, runtime failure channel, allocation, ownership, cleanup,
+or C IR node kind was added.
+
+Preserved the sealed Phase 14A numeric policy and helper registry exactly.
+Explicit 0.14.0 configuration retains its historical artifacts and placement
+rejections; active sources that select no conditional region retain predecessor
+generated-C bytes and output fingerprints. General exceptions, heap objects,
+dynamic dispatch, closures, generators, async behavior, context cleanup, and
+the broader class model remain excluded.
+
+## 0.14.0 — Phase 14A bounded integer floor arithmetic
+
+Status: Phase 14A sealed.
+
+Added exact integer `//` and `%` for existing integer-like expressions when
+the divisor is a direct signed integer literal in
+`[-9223372036854775807, -2]` or `[1, 9223372036854775807]`. Zero, negative one,
+`INT64_MIN`, Boolean, floating, dynamic, folded, calculated, and out-of-range
+divisors reject deterministically.
+
+Added separate numeric analysis and lowering, `fact-table/0.14` numeric
+operation facts, the `phase14.numeric.floor_arithmetic` RulePlan family,
+`conversion-plan/0.14`, `c-ir/0.14`, `generated-c/0.14`, and 0.14 summary and
+decision-trace identities. The active numeric policy is
+`phase14-proved-floor-arithmetic-v0.14`.
+
+Activated the frozen `pycf.i64.floor_div@1.0.0` and
+`pycf.i64.floor_mod@1.0.0` Phase 10 assets without changing their registry or
+asset fingerprints. Each occurrence selects exactly one helper, and the
+registry emits each selected helper once. Deterministic signed-64 temporaries
+preserve left-to-right, exactly-once operand evaluation.
+
+The admitted divisor proof excludes C11 division by zero and
+`INT64_MIN / -1`; no runtime failure channel, exception emulation,
+arbitrary-precision runtime, allocation, or cleanup was added. Mathematical
+fixtures close Python floor quotient, divisor-sign remainder, and the division
+identity across the supported sign and boundary cases.
+
+Preserved exact explicit Phase 13 conversion behavior and the unchanged module,
+record, container, workspace, no-host-discovery, and source-only product
+boundaries. Generated C was not compiled, linked, loaded, or executed.
+
+Phase 14A is sealed independently. Broader Phase 14 remains closed pending a
+new decision and explicit approval. Phase 15 has not started.
+
+## 0.13.0 — Phase 13 static records
+
+Status: promoted.
+
+Added a deliberately narrow immutable-record subset expressed with one exact
+top-level Python class shape. Accepted records contain 1–64 ordered `int`,
+`float`, or `bool` fields, an exact structural `__init__`, direct fresh
+function-local positional construction, and direct statically resolved field
+reads.
+
+Added `fact-table/0.13` record definitions, fields, initializers, instances,
+bindings, and accesses; seven record RulePlans; `conversion-plan/0.13`; record
+nodes in `c-ir/0.13`; `generated-c/0.13`; and 0.13 summary and decision-trace
+identities. The active record policy is
+`phase13-immutable-automatic-records-v0.13`.
+
+Record lowering emits deterministic named C `typedef struct` declarations and
+fully initialized `const` aggregates in automatic function storage. Arguments
+are evaluated left to right and once before construction; field reads use
+direct member access. No record helper or runtime is selected.
+
+General methods, inheritance and the broader Python object model remain
+unsupported. Records cannot be mutated, aliased, rebound, copied, escaped,
+passed, returned, stored in containers, imported, or used across modules.
+There is no heap allocation, null state, ownership transfer, or cleanup.
+
+Adversarial hardening added binding-identity constructor resolution,
+read-after-construction and complete fresh-local proofs, dunder-field and
+annotation-builtin collision rejection, correct companion-module diagnostics,
+cooperative record cancellation, exact const/member and field-type C IR
+validation, manifest-bound provenance, and independent serialized record-fact
+cross-validation. Historical `fact-table/0.12` module records retain their
+exact shape; record linkage remains in Phase 13 evidence.
+
+An initial working candidate was abandoned when an external compile-only
+review triggered the declared no-toolchain rollback rule. The release candidate
+was reseeded from a newly authenticated 0.12.2 extraction; the incident remains
+recorded and is not rewritten as passing evidence.
+
+Preserved the Phase 12 function-import profile, Phase 11 containers, Phase 10
+helper registry, source-only product boundary, and PyCForge workspace safety
+model. Explicit historical Phase 12 requests retain their 0.12 identities, and
+class-free Phase 13 conversions preserve predecessor generated-C bytes.
+
+The sealed 0.12.2 predecessor was authenticated before Phase 13 edits. Windows
+11 laptop testing remains planned user feedback after all phases; this release
+does not claim Windows execution. Phase 14 has not started.
+
+## 0.12.2 — PyCForge workspace hardening
+
+Corrected conversion-generation retirement, Save As destination validation,
+unexpected worker failure recovery, visible module identity commits,
+document-reorder controls, Unicode replacement navigation, keyboard access,
+and failure-tolerant versioned presentation settings without changing the
+sealed Phase 12 converter.
+
+## 0.12.1 — PyCForge workspace
+
+Introduced the optional professional PyQt5 workspace over the sealed Phase 12
+converter, including explicit bundle navigation, Python and immutable C
+editors, diagnostics and mappings, stale-output protection, and atomic linked-C
+saving.
+
+## 0.12.0 — Phase 12 explicit module bundles
+
+Introduced the bounded 1–64-document SourceBundle profile, exact compile-time
+direct-function imports, deterministic dependency ordering, and one generated
+C translation unit without host module discovery or runtime initialization.