---
id: 10518
title: Remove manual wake subscription sequence from agent startup
state: CLOSED
labels:
  - documentation
  - enhancement
  - developer-experience
  - ai
assignees:
  - neo-gemini-pro
createdAt: '2026-04-30T08:19:00Z'
updatedAt: '2026-04-30T08:52:24Z'
githubUrl: 'https://github.com/neomjs/neo/issues/10518'
author: neo-gemini-pro
commentsCount: 0
parentIssue: null
subIssues: []
subIssuesCompleted: 0
subIssuesTotal: 0
blockedBy: []
blocking: []
closedAt: '2026-04-30T08:52:24Z'
---
# Remove manual wake subscription sequence from agent startup

**Context**
The A2A Wake Substrate stability checks have introduced an auto-subscription mechanism for the bridge daemon using SQL idempotency checks within the Memory Core.

**The Problem**
Current startup documentation or scripts might still instruct developers/agents to manually subscribe to wake events when starting a new session. This creates unnecessary cognitive load and adds redundant steps to the session initiation flow.

**The Architectural Reality**
The `memory-core` MCP server automatically executes `WakeSubscriptionService.bootstrap()` on initialization (`Server.initAsync`). This process is self-healing, utilizing raw SQL queries to ensure `status: 'existing'` and prevents duplicate subscriptions across restarts. The `bridge-daemon` dynamically polls the graph log and does not require explicit manual subscription setup.

**The Fix**
Audit `.agents/AGENTS_STARTUP.md`, other `.agents/skills/*` guides, and `package.json` to remove instructions for manually subscribing to wake events.

**Acceptance Criteria**
- Remove any steps mandating manual `manage_wake_subscription` or `bootstrap` tool usage from agent startup guides.
- Ensure any onboarding guides reflect the automated nature of the wake substrate.

**Out of Scope**
- Modifying the underlying `bridge-daemon.mjs` logic or `WakeSubscriptionService.mjs` implementation.
- Refactoring `memory-core` initialization.

**Avoided Traps**
- Do not remove the `mcp_neo-mjs-memory-core_manage_wake_subscription` tool from the MCP server entirely, as it may still be needed for debugging or advanced custom subscription scenarios.

**Related**
- PR #10510
- #10437

**Origin Session ID**
Origin Session ID: 0a897c00-bbdb-4e05-9012-93fc0c9c26f0

**Handoff Retrieval Hints**
Retrieval Hint: "remove manual wake subscription"

## Timeline

- 2026-04-30T08:19:02Z @neo-gemini-pro added the `documentation` label
- 2026-04-30T08:19:02Z @neo-gemini-pro added the `enhancement` label
- 2026-04-30T08:19:02Z @neo-gemini-pro added the `developer-experience` label
- 2026-04-30T08:19:02Z @neo-gemini-pro added the `ai` label
- 2026-04-30T08:29:35Z @neo-gemini-pro assigned to @neo-gemini-pro
- 2026-04-30T08:31:20Z @neo-gemini-pro cross-referenced by PR #10519
- 2026-04-30T08:44:04Z @neo-gemini-pro referenced in commit `341885f` - "docs(startup): clarify wake-subscription bootstrap (#10518)"
- 2026-04-30T08:48:16Z @neo-gemini-pro referenced in commit `90f1c5c` - "revert(docs): remove wake bootstrap note to lower cognitive load (#10518)"
- 2026-04-30T08:52:24Z @tobiu referenced in commit `6b93a8e` - "docs(ai): remove manual wake subscription sequence and simplify ticket-intake (#10518) (#10519)

* docs(ai): remove manual wake subscription sequence and simplify ticket-intake (#10518)

* docs(startup): clarify wake-subscription bootstrap (#10518)

* revert(docs): remove wake bootstrap note to lower cognitive load (#10518)

---------

Co-authored-by: tobiu <tobiasuhlig78@gmail.com>"
- 2026-04-30T08:52:24Z @tobiu closed this issue
- 2026-04-30T09:13:01Z @neo-gpt cross-referenced by #10439

