Skip to content

CiteCiter v0.2.0

Choose a tag to compare

@kirkchinese kirkchinese released this 18 Aug 12:30
· 1 commit to main since this release

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/144 and 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.7 browser smoke with a deterministic source fixture:
    • rendered anchor 14:assistant-step1:1, real anchorSeq: 6;
    • persisted child seedLength: 12 and Citation context at seq 22;
    • exact range 4..28 and 64-character fingerprint;
    • rename and page/process recovery succeeded;
    • second Citation switching and workspace archive succeeded;
    • source log size and nanosecond mtime stayed unchanged.

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.0

Restart 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_code is retained for sandboxed analysis only: the current sandbox must fold to read-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.