Skip to content

PLANS.md

Latest commit

 

History

History
92 lines (85 loc) · 5.48 KB

PLANS.md

File metadata and controls

92 lines (85 loc) · 5.48 KB
Raw

OpenAlice Implementation Plans

This file indexes active multi-step implementation work. Plans describe how repository truth will change; owner guides under [[docs/README.md]] describe the durable truth after it changes. Git history is the archive.

Plan Contract

  • Create plans/<topic>.md when work spans multiple subsystems, delivery increments, or sessions.

  • Each plan names its status, related issues, owner guides, scope, decisions, ordered checklist, verification, and completion criteria.

  • Update progress in the same commit as the work it describes. Do not mark a step complete before its code and required verification exist.

  • Record material discoveries and changed decisions in the plan. Move stable architectural conclusions into the linked owner guide.

  • Completing a plan is a deletion: remove plans/<topic>.md and its Active bullet in the same change that records acceptance. Do not keep a Completed section, tombstone bullets, or an on-tree plans/archive/. Recover a finished plan from git:

    git log --diff-filter=D --summary -- plans/
git show <deletion-commit>^:plans/<topic>.md

  • Use GitHub issues for externally visible defects and deferred findings; plans may coordinate those issues but do not replace them.

Active

  • [[plans/bun-cli-distribution.md]] — Replaces the expanded Node headless Runtime with a Bun-compiled, multi-process CLI distribution. Direct, npm/Bun, Homebrew, and AUR channels consume one accepted artifact set. The CLI package owns OpenAlice only: Agent Runtime installation and Electron packaging stay outside this plan. The native CLI is public through the separately dispatched v0.91.0-beta.2; stable/beta discovery now uses the OpenAlice CDN manifests. The retained no-domain Railway profile has passed real migration, OpenCode resume, normal restart, hard-kill recovery, and a non-destructive dev-to-pinned-beta2 replacement; disposable empty-Volume and failure-fallback journeys, native PowerShell, and external package-manager activation remain open on focused branches from current dev.
  • [[plans/remote-project-fleet.md]] — Adds a machine-aware Supervisor fleet, remote AliceProject inventory/connection, and safe local-to-SSH project transfer for portable configuration and Workspaces while deliberately excluding native/OpenAlice Session continuation state. The current beta-blocking increment makes the attached browser truthful about remote identity, Agent and Broker Pack capability, scheduled-work blockers, reconnect recovery, and public Session titles. Controller/remote release negotiation and a consented Railway redeploy adapter remain a separate authority increment without background polling or SSH-owned installation.
  • [[plans/auto-prediction-harness.md]] — Auto Prediction Beta conversation Harness is in dev; managed AP/AQ Studio supervision, opaque routing, and embedded product surfaces are implemented. Shared verified/unverified source release management and cross-runtime acceptance remain active.
  • [[plans/antigravity-adapter.md]] — Antigravity (agy) CliAdapter. PATH agy only; never spawn antigravity / gemini. Serial PR from feat/agy-adapter; do not merge until Ame says so.
  • [[plans/agent-runtime-log.md]] — Append-only agent runtime lifecycle log (session.born / started / stopped / rejected / headless turn assets). Occupancy + Office timeline + headless text/tool/completion are in; the floor canvas lives in [[plans/office-floor.md]].
  • [[plans/office-floor.md]] — Office overworld rebuild: one continuous 4:3 top-down tilemap; Harness=functional neighborhood, Workspace=furniture pod, resumeId=employee. Scene graph, top-down placeholders, game chrome, camera, and browser acceptance remain active.
  • [[plans/issue-comment-prompt.md]] — Optional per-Issue commentPrompt template for comment-reply Input Prompts. Omission keeps the historical wrapper; chat desks seed {comment}.
  • [[plans/telegram-connector-issue.md]] — One Issue per Alice Project is the Telegram phone desk: What is the heartbeat prompt, comments are the chat, Connector only transports. Increment 1 bound the desk in Settings. Increment 2 projects comments unless [[no-reply]].
  • [[plans/connector-desk.md]] — Desk specimen is shared; each desk adapter owns its own Issue. Increment 1 generalizes telegramConnector → connectorDesk: <id>. Feishu adapter is a later increment.
  • [[plans/connector-inbox-commands.md]] — Connectors declare inbox and settings capabilities and implement their own slash-command forms. Telegram uses a bounded /inbox summary plus on-demand file pull; Discord/Slack stay placeholders. inboxPush can mute push without touching the phone desk.
  • [[plans/session-presence.md]] — Give product Sessions an in-desk presence (active / archived / deleted) separate from workspace retired, uncap the Ask Alice roster, and make Archive the floor action instead of deleting a coworker. Increment 1 landed in PR #1069; persisted presence remains open.
  • [[plans/shell-first-cli-supervisor.md]] — Delivers a first-class Shell Supervisor TUI, persistent Guardian-owned Runtime lifecycle, standalone headless release bundle, atomic update/rollback, and real N-1 plus PTY acceptance through serial increments. Increments 1–2 and most of 4/6/7 are in dev; remaining work is the TypeScript CLI conversion, logs/Doctor/update UX, config check, registry deletion, authenticity-hardened updates, and release-gate N-1.