docs(c11-interop): cross-reference SSDL digest in See Also
The SSDL digest (docs/reports/computational_shapes_ssdl_digest_20260608.md, 504 lines, 30KB) is the theoretical foundation for the chunkification pattern. Per the digest's Technique 5 "Assume-away (Xar)" in §2.2 and the "Xar-style chunked arrays" recommendation in §5.2, the chunkification track is a *direct application* of the SSDL's "assume as much as possible" lens (§4). This commit adds the SSDL digest to the See Also of the v1+v2 C11-Python interop assessment (front-matter Cross-references line). The same cross-reference is also being added to: - conductor/tracks/chunkification_optimization_20260608_PLACEHOLDER/spec.md (in a new §6.1 "SSDL alignment" subsection) - conductor/tracks/manual_ux_validation_20260608_PLACEHOLDER/spec.md (in §5 Architectural Reference + §6 See Also + a new §2.6 "SSDL cross-reference" section that distinguishes GUI ASCII vocabulary from SSDL vocabulary) No code modified. Cross-reference only. Also: small update to conductor/tracks.md to add the 2 new tracks (manual_ux_validation_20260608_PLACEHOLDER as Active; chunkification_optimization_20260608_PLACEHOLDER as Backlog/Contingency).
This commit is contained in:
@@ -30,6 +30,8 @@ Tracks that are unblocked and ready to start. Ordered by **dependency** (blocked
|
||||
| 12 | — | [Zhipu AI (GLM) Provider Integration](#track-zhipu-ai-glm-provider-integration) | spec TBD | (none — independent) |
|
||||
| 13 | — | [AI Provider Caching Optimization](#track-ai-provider-caching-optimization) | spec TBD | (none — independent) |
|
||||
| 14 | — | [Manual UX Validation & Review](#track-manual-ux-validation--review) | spec TBD | (none — independent) |
|
||||
| 14a | — | [Manual UX Validation — ASCII-Sketch Workflow](#track-manual-ux-validation--ascii-sketch-workflow-new-2026-06-08) | spec ✓, plan ✓, ready to start | (none — independent; NEW 2026-06-08) |
|
||||
| 14b | — | [Chunkification Optimization (Contingency)](#track-chunkification-optimization-new-2026-06-08-contingency) | spec ✓ (contingency), no plan | hard constraint surface (deferred) |
|
||||
| 15 | — | [GenCpp Dogfood Feedback Loop](#track-gencpp-dogfood-feedback-loop) | spec TBD | (none — independent; oldest pending track) |
|
||||
| 16 | — | [Code Path Audit](#track-code-path-audit) | spec TBD | (none — investigation track) |
|
||||
| 17 | — | [GUI Architecture Refinement](#track-gui-architecture-refinement) | (no spec.md) | (TBD) |
|
||||
@@ -517,6 +519,16 @@ User review surfaced five outstanding UI issues, each previously attempted witho
|
||||
#### Track: Manual UX Validation & Review
|
||||
*Link: [./tracks/manual_ux_validation_20260302/](./tracks/manual_ux_validation_20260302/)*
|
||||
|
||||
#### Track: Manual UX Validation — ASCII-Sketch Workflow (NEW 2026-06-08)
|
||||
*Link: [./tracks/manual_ux_validation_20260608_PLACEHOLDER/](./tracks/manual_ux_validation_20260608_PLACEHOLDER/), Spec: [./tracks/manual_ux_validation_20260608_PLACEHOLDER/spec.md](./tracks/manual_ux_validation_20260608_PLACEHOLDER/spec.md), Plan: [./tracks/manual_ux_validation_20260608_PLACEHOLDER/plan.md](./tracks/manual_ux_validation_20260608_PLACEHOLDER/plan.md)*
|
||||
*Goal: Promote the ASCII-sketch UX ideation workflow (`docs/reports/ascii_sketch_ux_workflow_20260608.md`, 340 lines) to a real track. Resolves 5 open questions (vocabulary preference, comparison policy, storage location, tooling, frequency), then executes the workflow on the first target: the per-entry rendering of the Discussion Hub at `src/gui_2.py:3770 render_discussion_entry`. The 23-op matrix A1-A7 in `docs/guide_discussions.md` is the source of truth; the SSDL digest (`docs/reports/computational_shapes_ssdl_digest_20260608.md`, 504 lines) informs the *internal refactoring* decisions. Complements the broader 20260302 track. 4 phases, 21 tasks, TDD-style for Phase 3. User-confirmed worth doing.*
|
||||
*Status: Active; Phase 1 (5 open questions to the user) is the current phase.*
|
||||
|
||||
#### Track: Chunkification Optimization (NEW 2026-06-08, CONTINGENCY)
|
||||
*Link: [./tracks/chunkification_optimization_20260608_PLACEHOLDER/](./tracks/chunkification_optimization_20260608_PLACEHOLDER/), Spec: [./tracks/chunkification_optimization_20260608_PLACEHOLDER/spec.md](./tracks/chunkification_optimization_20260608_PLACEHOLDER/spec.md)*
|
||||
*Goal: Contingency document only. Activates ONLY when a hard constraint surfaces that no existing Python package can solve AND the target is hot enough to justify the C11 build cost. Per user (verbatim): "only worth it if I reach a hard constraint that I cannot solve with an existing python package." The 2 cited candidates (markdown parsing into aggregate markdown, context snapshot processing) are NOT currently bottlenecks per `src/aggregate.py:380-454` (pure-Python string concat, zero third-party markdown deps in `pyproject.toml:6-27`) and `src/history.py:1-141` (bounded ~500KB at 100-snapshot capacity, debounced). First fix if they become bottlenecks: add `markdown-it-py` OR switch to `pickle`/`msgspec` — NOT C11. The shape when activated: subprocess-launch C11 binary with request/response blob wire format (NOT stateful C extension). The SSDL digest's Technique 5 "Assume-away (Xar)" in §2.2 + "Xar-style chunked arrays" recommendation in §5.2 pre-support this track.*
|
||||
*Status: Deferred. Promotes to active track when (if) the first hard constraint surfaces.*
|
||||
|
||||
#### Track: Context First Message Fix
|
||||
*Link: [./tracks/context_first_message_fix_20260604/](./tracks/context_first_message_fix_20260604/)*
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
**Author:** Tier 1 Orchestrator (synthesis + technical assessment)
|
||||
**Date:** 2026-06-08
|
||||
**Status:** Honest tractable-vs-not verdict, no code proposed
|
||||
**Cross-references:** `docs/reports/session_synthesis_20260608.md` §8.2, `docs/ideation/ed_chunk_data_structures_20260523.md`, `docs/transcripts/i-h95QIGchY_assuming_as_much_as_possible_andrewreece.txt` §56:42
|
||||
**Cross-references:** `docs/reports/session_synthesis_20260608.md` §8.2, `docs/ideation/ed_chunk_data_structures_20260523.md`, `docs/transcripts/i-h95QIGchY_assuming_as_much_as_possible_andrewreece.txt` §56:42, `docs/reports/computational_shapes_ssdl_digest_20260608.md` (the SSDL digest; the theoretical foundation for the chunkification pattern — Technique 5 "Assume-away (Xar)" in §2.2 is the explicit pre-support for the chunk-arrays recommendation in §5.2)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user