Skip to content

docs(specs): multiple daemons and notifications for web and desktop - #371

Closed
futrime wants to merge 1 commit into
mainfrom
docs/specs-multi-daemon-notifications
Closed

futrime wants to merge 1 commit into
mainfrom
docs/specs-multi-daemon-notifications

Conversation

@futrime

@futrime futrime commented Oct 12, 2026

Copy link
Copy Markdown
Member

Summary

Spec changes for the multi-daemon and notification batch (contracts C1–C8 of the plan). These are the only spec edits in the batch.

  • specs/web.md: the API adds notices.py, remote.py, the endpoints and the settings.yaml keys. New Daemons and Notifications sections cover:
    • Local plus SSH daemons, added or imported
    • a remote hmz web --attached run over ssh, auto-installed at this version except while the remote holds running epics, and proxied under /d/<name>/api/
    • the daemon bar and picker
    • showing only the current daemon, which is carried in the address
    • the App/Daemon split in Settings, with a per-page daemon picker and Batch apply
    • per-machine notices, global notifications filtered by kind, the bell and cards, and system notifications
  • specs/runtime/doing.md: Host.status carries pending, ended, epic and task (C3).
  • specs/daemon.md: Daemon.status is the host's status.
  • specs/desktop.md: the page may invoke notify and no other app command. It shows a native notification, and a click focuses the window and opens the address, but only an own-origin hash (C8).
  • specs/cli.md: --attached stdin EOF also covers being reached over ssh.

Test plan

  • uv run --all-extras pre-commit run --all-files: every hook passes except pyright, which fails only on macOS-only/Linux-only attributes in files this PR does not touch
  • uv run pytest tests/unit

🤖 Generated with Claude Code

web: daemons kept in Local's settings (Local plus SSH hosts, added or
imported), reached by running `hmz web --attached` over ssh with the
remote hmz installed at this version unless it holds running epics,
proxied under /d/<name>/api/; the daemon bar and picker; only the
current daemon shown, carried in every address; Settings grouped as
App and Daemon, with a daemon picked per page and Batch apply; notices
per machine and notifications gathered across daemons, filtered by
kind, with a bell, cards and system notifications.

runtime/doing: Host.status carries pending questions, the last end,
and the epic and task. desktop: the page may invoke `notify` alone,
shown as a native notification that opens its own-origin address.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 12, 2026 14:47

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@futrime

futrime commented Oct 12, 2026

Copy link
Copy Markdown
Member Author

Landed together in #385.

@futrime futrime closed this Oct 12, 2026
@futrime
futrime deleted the docs/specs-multi-daemon-notifications branch October 12, 2026 23:55
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.

2 participants