CiteCiter v0.2.0
CiteCiter v0.2.0
Positioning release
CiteCiter is now a learning companion grounded in an exact point of a DSH conversation, not a one-shot selection explainer.
Select a completed assistant passage, ask a custom question, and continue in a durable Citation Thread. The Thread is isolated from the source session, recovers after refresh/restart, and can be switched, renamed, or archived.
Highlights
- External Host+Client Cordis package; no DSH-core patch and no custom agent loop.
- Exact completed-node fork from the real snapshot
anchorSeq. - SHA-256 Citation identity over source, anchor, UTF-16 range, selected text, and bounded surrounding evidence.
- Four model-input layers: scoped system Tutor, exact inherited history, durable untrusted Citation Context, and genuine user questions.
- Custom first question and real multi-turn follow-ups.
- Persistent launcher, parent-grouped picker, projection recovery, rename, switch, and workspace archive.
- Fail-closed read-only admission plus durable
command/done/preset settlement, Host lineage/fingerprint validation, strict Agent-scoped Typert Remote, and read-only tool execution guard. - Child-only transcript from
SessionHeader.seedLength; parent log remains untouched. - Existing conservative Markdown/KaTeX/code/SVG/HTML rendering and Cordis teardown guarantees retained.
Evidence
- Six-case, same-model A/B/C evaluation: four-layer variant C scored
138/144and led evidence discipline (23) and follow-up consistency (24). - Focused suite: 28 passing tests covering durable command settlement, creation order, exact question payloads, follow-ups, identity, completed-boundary validation, UTF-16 ranges, recovery, transcript boundary, archive, teardown, Typert, and rich-content safety.
- Fresh DSH
0.1.0-rc.7browser smoke with a deterministic source fixture:- rendered anchor
14:assistant-step1:1, realanchorSeq: 6; - persisted child
seedLength: 12and Citation context at seq22; - exact range
4..28and 64-character fingerprint; - rename and page/process recovery succeeded;
- second Citation switching and workspace archive succeeded;
- source log size and nanosecond mtime stayed unchanged.
- rendered anchor
The disposable smoke profile intentionally has no model credential. Its normal provider error occurs only after the read-only switch, strict Remote preparation, durable Citation Context, and genuine user message have all succeeded. Real model quality evidence is recorded separately in experiments/model-input-layering/.
Upgrade notes
dsh plugin --profile web add @kirkchinese/dsh-citeciter@0.2.0Restart DSH Web after installing or upgrading. v0.2 adds Host code plus ./typert and ./remote exports; replacing only lib/client.js is not sufficient.
The v0.1 one-shot prompt/state model is replaced. Existing v0.1 explanation children do not contain the v0.2 Citation projection and therefore do not appear in the new Thread launcher.
Known limitations
- Completed assistant flows only; no cross-message/cross-block selections.
- No unarchive UI or archived-session deduplication.
- Conservative fixed tool allowlist.
run_codeis retained for sandboxed analysis only: the current sandbox must fold toread-only, and every nested tool dispatch still crosses the authoritative guard. - No settings UI, complete localization framework, mobile-specific layout, or cross-platform browser CI.
- DSH remains prerelease software; later APIs may require adaptation.