Skip to content

v0.3.5 companion presence and visible memory#105

Open
FanyinLiu wants to merge 45 commits into
mainfrom
codex/m6-presence-state-contract
Open

v0.3.5 companion presence and visible memory#105
FanyinLiu wants to merge 45 commits into
mainfrom
codex/m6-presence-state-contract

Conversation

@FanyinLiu

@FanyinLiu FanyinLiu commented Jun 20, 2026

Copy link
Copy Markdown
Owner

v0.3.5 Theme

Visible memory, readable companion presence.

This PR is intentionally about making Nexus feel more like a desktop companion, not expanding it into a Codex-style work agent. Users should remember v0.3.5 as the release where Nexus starts showing what it remembers and what state the desktop companion is in.

What users will notice

  • Settings home now shows the v0.3.5 release spotlight immediately, so users do not have to hunt through About / Help to learn what changed.
  • The root README, English release notes, Chinese release notes, CHANGELOG, and in-app spotlight now tell the same human-facing story: visible memory plus readable companion presence.
  • The spotlight has direct actions to Memory and Companion Profile, letting users inspect the two headline upgrades without starting chat, voice, network, migration, or automation work.
  • Companion Profile now includes a desktop state preview for idle, thinking, listening, speaking, waiting, error, and offline.
  • The desktop pet state is readable across status dot, accessible label, Sprite fallback, and Live2D listening/speaking inputs.
  • The companion now has lightweight CSS motion tokens for breathing, thinking, listening, speaking, and waiting, without adding background work or dependencies.
  • Known stage directions like (eyes brightened), (blush), and (nod) can drive avatar cues while ordinary notes and Markdown links remain untouched.

Engineering summary

  • Add a pure companion activity resolver for idle, thinking, listening, speaking, waiting, error, and offline states.
  • Bind pet status, Sprite fallback, Live2D inputs, and Companion Profile preview to the shared state contract.
  • Sync the v0.3.5 in-app spotlight, release notes, README snippets, roadmap, and changelog around the memorable theme: visible memory plus readable desktop companion states.
  • Cut the v0.3.5 presence/spotlight entries from Unreleased into the [0.3.5] changelog section, leaving Unreleased explicitly empty for later work.
  • Add docs/RELEASE-CANDIDATE-v0.3.5-HANDOFF.md plus a focused guard so the final merge/tag handoff keeps the memorable upgrade, evidence, residual risks, rollback path, and companion-not-agent boundary explicit.
  • Share the release spotlight action renderer between Settings home and About / Help so both entry points stay aligned as the release candidate evolves.
  • Guard the README/release-note/changelog/handoff theme with tests/release-spotlight.test.ts, so the 0.3.5 message cannot drift back to a memory-only, unreleased, or task-agent story unnoticed.
  • Align docs/RELEASING.md Stage B with the actual packaged smoke gate and make npm run distribution:audit fail if npm run package:dir:smoke or the quick-mode packaged-smoke skip note drops out of the release checklist.
  • Add an Electron visual smoke gate that launches the built completed-onboarding pet view, rejects onboarding-overlay false positives, confirms idle/breathe presence, and saves a nonblank screenshot/report under output/presence-smoke/.
  • Keep the PR scoped: no new dependencies, IPC channels, storage writes, migrations, permissions, automation tools, or renderer access to secrets.

Validation

  • npm run lint
  • npm run i18n:audit — 2242 keys, 0 missing/extra/duplicate across zh-CN, zh-TW, en-US, ja, ko.
  • npx tsc -b --pretty false
  • npm run build
  • npm test — 1966 passed.
  • npm run distribution:audit — includes the packaged smoke release-doc and quick-mode guard.
  • node scripts/prerelease-check.mjs v0.3.5 --only=B --quick — verify:release and bundle checks passed; output explicitly states packaged smoke is skipped in quick mode.
  • node scripts/prerelease-check.mjs v0.3.5 --skip=A --quick — tag-safe branch preflight passed stages B-F: 22 blocker checks, 0 warnings, 0 failures. Stage A intentionally waits for merge to main because it verifies HEAD === origin/main and tag absence.
  • npm run release:trust:audit — 7 OK, 2 expected warnings for unsigned macOS/Windows release posture.
  • npm run package:dir:smoke — builds, packages a local dir app, launches packaged Nexus, and exits after renderer load.
  • npm run pet:presence-smoke — runs build, launches the Electron pet view, and writes output/presence-smoke/pet-presence-smoke.png plus JSON evidence.
  • Focused pet activity test: node --experimental-strip-types --test tests/pet-activity-state.test.ts
  • Focused release spotlight test: node --experimental-strip-types --test tests/release-spotlight.test.ts — 5 passed, including README/release-note/changelog theme alignment and the v0.3.5 release handoff guard.
  • Whitespace gate: git diff --check
  • GitHub CI: Windows, macOS, and Ubuntu all passed on latest head e87d9dc.

Release wording

Use this for the human-facing 0.3.5 headline:

Nexus v0.3.5 makes the companion easier to read and remember: memory is visible, and the desktop avatar now shows whether it is idle, thinking, listening, speaking, waiting, offline, or in trouble.

@FanyinLiu FanyinLiu changed the title M6 Slice 1: Desktop presence state contract M6: Desktop presence state and micro-motion Jun 20, 2026
@FanyinLiu FanyinLiu changed the title M6: Desktop presence state and micro-motion M6: Desktop presence, micro-motion, and avatar cues Jun 20, 2026
@FanyinLiu FanyinLiu changed the title M6: Desktop presence, micro-motion, and avatar cues M6: Desktop presence, avatar cues, and visual smoke Jun 20, 2026
@FanyinLiu FanyinLiu changed the title M6: Desktop presence, avatar cues, and visual smoke Companion presence, avatar cues, and release spotlight Jun 20, 2026
@FanyinLiu FanyinLiu changed the title Companion presence, avatar cues, and release spotlight Companion presence, state preview, and release spotlight Jun 20, 2026
@FanyinLiu FanyinLiu changed the title Companion presence, state preview, and release spotlight v0.3.5 companion presence and visible memory Jun 20, 2026
@FanyinLiu
FanyinLiu marked this pull request as ready for review June 20, 2026 03:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant