id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027)

Follow-up from the capability taxonomy v0 investigation (#2027, record: doc/2026-10-29T14-05-00Z_investigation_capability_taxonomy/, PR #2337).

Goal

Formalise text-only mode as the main presentation mode for agents and scripts: a text/1 contract plus a required text projection for every WorldSurface variant.

Why

parse_surface already accepts non-screen documents as legacy UTF-8 text, so text works today by accident. Agents and scripts are the primary consumers, text is what CI can assert without a renderer, and it is the degradation target every other surface needs.

Scope

Text(TextSurface) variant (kind: text) — UTF-8 lines, no escapes, no cursor addressing, no redraw, append semantics.
Width-aware wrapping, default 80, capped like MAX_SCREEN_WIDTH.
A text projection for Screen (existing render_ansi with colour stripped), Form, Media and Map, so no surface can exist without one.
Contract documentation in world_presentation.rs header and pkgs/id/ARCHITECTURE.md if it describes surfaces.

Acceptance

kind: text parses and round-trips; a surface without a text projection is rejected at the type level or by a test.
A test renders one program's Screen and Text documents and asserts the text projection is line-oriented and escape-free.
Legacy plain-string documents stay valid.

Out of scope

A styling/theme system, cursor animation, terminal detection heuristics.

Acceptance criteria

kind: text (Text/TextSurface) parses and round-trips: UTF-8 lines, no escapes, no cursor addressing, append semantics, width-aware wrapping (default 80, capped like MAX_SCREEN_WIDTH)
Every WorldSurface variant (Screen, Form, Media, Map) has a text projection; a surface without one is rejected at the type level or by a test
A test renders one program's Screen and Text documents and asserts the text projection is line-oriented and escape-free
Legacy plain-string documents stay valid; contract documented in the world_presentation.rs header (and pkgs/id/ARCHITECTURE.md if it describes surfaces)

CODE-1184

Intake review

Related: parent investigation #2027 (record: PR #2337); siblings #2338-#2345 are the other taxonomy follow-ups

Notes: Filed 2026-10-29T14:04Z from #2027. Still live: no open or merged PR implements it. Text works today only by accident (parse_surface legacy UTF-8 path); this makes it the main mode for agents/scripts and the degradation target for all other surfaces.

Risks: If Form/Media/Map land before their text projections, surfaces exist that CI and agents cannot assert on — sequence this before or with #2340/#2342.

Suggested approach: Add the Text variant + Screen projection via the existing render_ansi (colour stripped) first, then the remaining projections with the line-oriented test.

🤖 Agent note · filed

Agent: fleet monitor (repo-fleet-monitor)
Session / ID: repo-fleet-monitor run 2026-10-29T14:30Z (09:30 CDT)
Found via: monitor reconciliation
Task: Duty 2 intake enrichment — acceptance criteria appended (original body preserved verbatim above it), labels normalized, meta/enriched applied. Still-live check this pass: no merged PR or fix commit explicitly resolving this issue was found; where a queue triage task owns verification, it is named in the notes.
Expectation: see the effort label; done = the appended acceptance criteria are met.
Links: this issue

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), OpenChamber scheduled lane
Session / ID: queue task 5771
Found via: queue claim
Task: Implement text/1 deterministic projections for the current WorldSurface variants while preserving legacy Screen UTF-8 behavior.
Expectation: effort m; done = projection behavior and focused tests passing, with any PR/CI state recorded.
Links: id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 · parent id: investigate: capability-based specialization — forms, location, media across web, ESP32/MQTT, and text/audio modes #2027; no existing PR found

agent-note:v1
state: triaged (coverage pass)
Coverage pass 2026-11-03: reviewed in the fleet-wide per-issue pass (drift / overlap / already-handled / stale / blockers / ordering). Verdict: still live; queued in repo-health-code-pilot as triage at priority 40 (priority/normal). If this is already handled at current main, the triage closes it with evidence; if it needs splitting, the triage files the split.
Found via: coverage pass 2026-11-03

🤖 Agent note · handed off

Agent: queue worker (repo-worker-code), lane code-h
Session / ID: task 7923
Found via: queue claim
Task: Triage issue id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 — handed off to the opencode execution lane; the laptop claimant launches the bound opencode session, which drives task 7923 to its terminal state.
Expectation: m — triage at current main with evidence: fix path scoped, or closed with evidence if already handled/superseded.
Links: issue id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 (OPEN, verified fresh 2026-11-03T18:03Z; no held/user-owned/do-not labels)

🤖 Agent note · picked up

Agent: queue worker (repo-worker-code), OpenChamber scheduled lane
Session / ID: queue task 7923
Found via: queue claim
Task: Revalidate issue id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 against current main and record the live implementation path or blockers.
Expectation: Triage at current main with evidence; keep id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 open if required future surface variants are not implemented.
Links: issue id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339; prior first-slice PR id: text/1 foundation — TextSurface + exhaustive WorldSurface text projection (#2339 first slice) #4840 (merged)

🤖 Agent note · done — triage verdict: CONFIRMED LIVE; keep #2339 OPEN

Agent: queue worker (repo-worker-code), OpenChamber scheduled lane
Session / ID: queue task 7923
Checked fresh: 2026-11-04; current main ece818d; id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 OPEN; PR id: text/1 foundation — TextSurface + exhaustive WorldSurface text projection (#2339 first slice) #4840 MERGED; no open PR implements id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339.

Findings

The first slice is already on main: PR id: text/1 foundation — TextSurface + exhaustive WorldSurface text projection (#2339 first slice) #4840 added TextSurface (kind: text) parsing/round-trip, bounded wrapping, and the exhaustive WorldSurface::text_projection().
At pkgs/id/crates/id-core/src/world_presentation.rs:41-59, WorldSurface currently has only Screen and Text; text_projection() handles both exhaustively. There are no Form, Media, or Map variants on current main, so the full projection acceptance is not yet met and cannot be completed independently of those surfaces.
Fresh sibling state: id: form.* capability + Form surface — structured input without program-supplied HTML (#2027) #2340 (Form) OPEN; id: media.* — typed media artifacts by default, one bounded raw stream for realtime (#2027) #2342 (Media) OPEN and queue/blocked. Add each projection in the same change that introduces its surface; retain id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339 until all required variants, including Map when introduced, have projections. Existing follow-ups cover Form/Media, so no duplicate task was created.
PR fix(id): state the one-grapheme overhang in world text wrapping (#4877) #4907 is open and Drew-authored for id(text/1): TextSurface wrap emits a line wider than the requested width when one grapheme is wider than the width #4877's one-grapheme wrapping contract; it does not implement id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339. I did not modify it.

No code change is appropriate for this triage; #2339 stays open by design.

Navigation Menu

Repository navigation

id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339

Goal

Why

Scope

Acceptance

Out of scope

Acceptance criteria

Intake review

21 remaining items

Findings

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

id: text/1 presentation contract — text-only as the main mode, with a text projection for every surface (#2027) #2339

Description

Goal

Why

Scope

Acceptance

Out of scope

Acceptance criteria

Activity

developing-today commented on Oct 29, 2026

dezren39 commented on Oct 29, 2026

Intake review

dezren39 commented on Nov 1, 2026

21 remaining items

developing-today commented on Nov 3, 2026

dezren39 commented on Nov 3, 2026

dezren39 commented on Nov 4, 2026

dezren39 commented on Nov 4, 2026

Findings

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions