# Track state for chunkification_optimization_20260608_PLACEHOLDER
# Contingency document — does NOT produce code or implementation tasks
# Promoted to active track when the activation criteria in metadata.json are met

[meta]
track_id = "chunkification_optimization_20260608_PLACEHOLDER"
name = "Chunkification Optimization (C11 Pipeline Contingency)"
status = "deferred"  # contingency only; no implementation
current_phase = 0  # 0 = not started; will become 1 when promoted to active
last_updated = "2026-06-08"

[blocked_by]
# Contingency: cannot start until these are true
hard_constraint_profiling_evidence = "Profiling must show a real bottleneck that no existing Python package can solve"
user_approval_for_activation = "User must explicitly say 'activate this track' before any code is written"

[blocks]
# Contingency: this track blocks nothing (it's a future option, not a dependency)
# No entries.

[user_corrections_log]
# Two user-corrections shaped the v2 framing of this contingency

2026-06-08_1 = "v1 framing (stateful C extension) revised to v2 (request/response blob pipeline). User: 'the python would have to define the payload in a simple text or binary format as the request and then the extension pipeline in C11 would do the ops and provide the output in another binary or text blob/s.' This is the SUBPROCESS model, not a stateful CPython C extension."
2026-06-08_2 = "v1 'build it now' revised to 'build only when hard constraint surfaces'. User: 'only worth it if I reach a hard constraint that I cannot solve with an existing python package.' The 2 cited targets (markdown parsing, snapshot processing) are not currently bottlenecks per src/aggregate.py:380-454 and src/history.py:1-141."

[tasks]
# Contingency: no implementation tasks until activation
# When activated, copy the activation plan from spec.md §2 into a new plan.md

t_contingency_01 = { status = "completed", commit_sha = "", description = "Write 1-page contingency spec.md (this file's parent)" }
t_contingency_02 = { status = "completed", commit_sha = "", description = "Write metadata.json with activation criteria + shape_when_activated" }
t_contingency_03 = { status = "completed", commit_sha = "", description = "Write state.toml with deferred status + user_corrections_log" }
t_contingency_04 = { status = "completed", commit_sha = "", description = "Write index.md" }
t_contingency_05 = { status = "pending",  commit_sha = "", description = "Add entry to conductor/tracks.md (post-commit, in 'Contingency / Future' section)" }

# Activation-gated tasks (do not start without explicit user approval):
t_activate_01 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Profile target code path; confirm hard constraint" }
t_activate_02 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Try existing Python packages first (markdown-it-py / pickle / msgspec / etc.)" }
t_activate_03 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] If existing packages don't work, define wire format (text v1, binary v2)" }
t_activate_04 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Write C11 pipeline binary in duffle.h style" }
t_activate_05 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Write Python subprocess wrapper" }
t_activate_06 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Write tests in tests/test_chunka_c11.py" }
t_activate_07 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Build + deploy (uv + pyproject.toml hook)" }
t_activate_08 = { status = "pending", commit_sha = "", description = "[ACTIVATION-GATED] Profile: confirm C11 path is faster than Python baseline" }

[verification]
# Contingency verification is artifact presence only

spec_md_exists = true
metadata_json_exists = true
state_toml_exists = true
index_md_exists = true

# Activation criteria documented
activation_criteria_documented = true

# Current targets analyzed and found NOT to be bottlenecks
markdown_target_analyzed = true  # src/aggregate.py:380-454; pyproject.toml:6-27
snapshot_target_analyzed = true  # src/history.py:1-141

# v1 + v2 corrections recorded
v1_stateful_c_extension_revised = true
v2_request_response_pipeline_adopted = true

# No code modified
no_code_modified = true

[status]
# Contingency only; "deferred" means the track is documented but not in active work
status = "deferred (contingency documented; will activate when hard constraint surfaces)"
