# Current priority: Runtime memory management (2026-10-30)

CC places garbage collection and memory lifetime qualification before additional
conversion-import capabilities. Keep PCFC11 development and its familiar
`bash test-pcfc11.sh` workflow independent; no new compiler integration is part
of this sequence. Existing one-wheel PyCForge distribution remains intact.

1. **Registered roots and managed boundaries — 1.3.71.** Retain caller-owned PV
   slots; collect after opted-in completed calls; expose memory/refusal statistics.
   Qualify aliases, cycles, closures, arrays, exceptions, files and allocation
   failures. Preserve ordinary C-call semantics and hard execution budgets.
2. **Generated roots and safe points — 1.3.72.** Opt-in active collection now
   traces local/captured cells, return values and scoped evaluation temporaries.
   Qualify nested calls, loops/comprehensions, unwind paths and allocation faults.
   Collection remains deferred in native callbacks/constructors, expanded calls,
   initialization and active file scopes. Ordinary callers remain unchanged.
3. **Broader active coverage and performance — next.** Trace native helper scratch
   and active file resources before extending safe points there. Measure long-run
   pause distributions and live-graph scaling; choose defaults from that evidence.
4. **Resource contracts and cross-platform qualification.** Keep files/native
   resources deterministic; do not introduce GC-dependent finalizers. Exercise
   supported external compilers, Windows and Linux, realistic long runs and SDK
   ownership contracts. Publish exact limits and measured evidence.
5. **Resume import expansion** after the memory gates above are qualified.

The following material is retained development history; this priority governs
new work. Current contract: specifications/runtime_memory_1_3_72.md.

---

# PyCForge 1.1.2

## 1.1.2 conversion improvements

Built on the supplied 1.1.1 source. Choose **Transpile → Transpile Runtime Values (Preview)** for real runtime Unicode strings, shared mutable lists and class instances, mixed lists and tuples, union/container annotations, nested filtered list comprehensions, and lambdas with captured cells. The default typed converter remains available.

The preview emits self-contained C11 with an explicit arena and checked runtime operations. It converts one document and always identifies its development status. Exact ForgeLens mappings, the established C-IR proof guarantees, complete Python coverage, and native Windows validation are not yet provided by this new backend. Read [the preview contract](specifications/runtime_values_1_1_2.md) for supported forms, memory ownership, type-check boundaries, and remaining work.

The embedded Ting execution runtime is now **0.10.0a21**. PyCForge installs **NumPy 2.3.x and Numba 0.63.x** with PySide6 and supports Python **3.11–3.13**. The existing splash warms real numeric kernels on a background worker while the interface stays responsive.

PyCForge performs Python-to-C source conversion. C-to-assembly belongs to the separate **PlutoAI** project. No 1.2 compiler integration is included.

```bash
python -m pycforge convert example.py --runtime-values --output generated.c
```

The material below describes the preceding default-profile history unless explicitly updated.

---

# PyCForge UI Roadmap

Execution order. Converter semantics and generated C remain unchanged.

This file tracks the bounded UI sequence inherited from the earlier workspace.
The separately reviewed conversion expansion and its trust gates are in
`CONVERSION_ROADMAP.md`.

1. **ForgeLens — shipped in 0.16.1.** Optional, passive Python↔C cross-highlighting from authenticated mappings; blackened-steel workspace; PyCForge brand mark in About; custom Open/Save browsers. Open has a large paged Python preview; Save is tree-and-location only.
2. **Why This C? — next.** Explain selected C through its Python origin, transformation rule, type decision, restrictions, and inserted-helper evidence.
3. **Causal Translation Diff.** Compare immutable conversions and attribute changed C, diagnostics, symbols, and mappings to the responsible Python edits.
4. **Determinism Receipt.** Copy or export source/output hashes, package and converter versions, profile/options, rule/schema identities, and the artifact fingerprint.
5. **Command Palette Expansion.** Extend the existing `Ctrl+Shift+P` palette with bounded symbol, diagnostic, mapping, rule-ID, and history navigation while keeping execution registry-owned.

Validation stays feature-focused during development. The complete suite runs once at the release gate.
