Private
Public Access
0
0

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:
conductor-tier2
2026-06-08 23:42:21 -04:00
parent 5b3c11a0f3
commit 999fdea467
2 changed files with 13 additions and 1 deletions
+12
View File
@@ -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)
---