docs([issue-2073]): rewrite four shipped feature docs from plan-tense to verified current-state#2080
Merged
Conversation
… to verified current-state digital-twin.md, openclaw-operator-chat.md, post.md, and writers-room.md described shipped features but still read as pre-build plans (Planned Phases, Proposed capabilities, phased roadmaps). Each is rewritten as current-state documentation with claims verified against the code: - digital-twin: imports are Goodreads/Spotify/Letterboxd/iCal (no Last.fm); multi-modal capture is pasted-transcript/image only; style comparison is qualitative; one active persona overlays the base twin - openclaw: documents the shipped 5-endpoint surface, file/env config, and degradation; keeps the honest proposed-but-unbuilt list - post: adds the undocumented Cognitive domain, Morse training, drill cache + consent flow, training log, adaptive difficulty; corrects drill-type ids and the component inventory - writers-room: PG-primary storage via store.js (#1017), CD bridge replaced the never-built render-plans, story bible + storyboard surfaces, live-director budgets, federation; keeps the Synchronized Review mapping-model section that syncedReview.js cites soul-system/digital-twin/identity-system now cross-link with a note on which angle each covers.
…aw file config accepts the full key set
…ons; fix apiOpenClaw.js filename case
…e route validates internally
…es; cognitive drills are untimed
…ltered, format persists Markdown
…; scene images sync via media collection
…plit persona route rows
# Conflicts: # .changelog/NEXT.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #2073.
Four feature docs described shipped features but still read as pre-build plans/specs. Each is rewritten as current-state documentation with every claim verified against the code (via parallel research agents + a three-reviewer series loop):
docs/features/digital-twin.md— "Planned Phases" reconciled into feature sections. Corrections: imports are Goodreads/Spotify/Letterboxd/iCal (no Last.fm); multi-modal capture is pasted-transcript/image only (no live voice/video); style comparison is qualitative; one active persona overlays the base twin; feedback weight adjustments are advisory-only (recorded, not yet consumed); all four test suites run per-persona; persona routes split accurately (no GET by id). An honest "Not Built" section records the unshipped roadmap ideas.docs/features/openclaw-operator-chat.md— proposal sections (Proposed capabilities / Open questions / Recommended design decisions / Initial deliverables) trimmed into a living doc covering the shipped 5-endpoint surface, file/env config (full key set), and graceful degradation. Keeps the honest proposed-but-unbuilt list (POST /sessions,/jobs,/subagents,/context/compose).docs/features/post.md— "Existing vs New (M55)" spec framing removed. Adds the undocumented Cognitive domain, Morse training (training-log only), drill cache + consent flow, training log, adaptive difficulty, spaced repetition. Corrections: drill-type ids (doubling-chain,pun-wordplay), memory drills aren't launched in scored sessions, full-vs-quick session composition, cognitive drills are untimed, session score is an unweighted mean, real component inventory.docs/features/writers-room.md— implementation plan (PR feat(creative-director): autonomous long-form video projects + media job queue #191 baseline, Phases 0–5) converted to current-state: PostgreSQL-primary storage viastore.js(Migrate Writers Room metadata to PostgreSQL (.md bodies stay file-backed) #1017) with file-primary draft bodies, CD bridge (render-plans were never built), story bible, storyboard suite (incl. Adapt's auto-queued renders), live-director budgets, federation record kinds vs sync categories. The "Synchronized Review Surface" section thatsyncedReview.jscites is preserved and now describes the actual derive-on-read mapping model.Also:
soul-system.md/digital-twin.md/identity-system.mdnow cross-link with a note on which angle each covers (document workflow vs quantitative modeling vs identity architecture) — the issue's optional consideration, done as cross-linking rather than consolidation.Test plan
planIds.test.jsand the writersRoom services only reference the doc in comments/string literals; nothing depends on its content).