@ouro.bot/cli 0.1.0-alpha.7 → 0.1.0-alpha.70

package/changelog.json

@@ -0,0 +1,387 @@
+{
+  "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
+  "versions": [
+    {
+      "version": "0.1.0-alpha.70",
+      "changes": [
+        "New github-copilot LLM provider: use GitHub Copilot as model backend via `gh auth` token. Claude models route to /chat/completions, GPT models to /responses. Endpoint auto-discovered from your Copilot enterprise plan.",
+        "Auth decoupled from switching: `ouro auth --provider X` now stores credentials only. Use `ouro auth switch --provider X` to change the active provider, and `ouro auth verify` to check which stored providers have valid credentials.",
+        "Agents can now manage their own auth: `ouro auth`, `ouro auth verify`, and `ouro auth switch` are in the system prompt and gated at family trust level. Auth error messages include actionable recovery guidance.",
+        "Fix: `ouro --agent <name> <command>` now works correctly when --agent is the first argument."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.69",
+      "changes": [
+        "Generic MCP client: ouroboros agents can now connect to any MCP server (e.g., agency mcp ado, agency mcp mail) configured in agent.json. Zero new dependencies — pure JSON-RPC over stdio.",
+        "New `ouro mcp list` and `ouro mcp call` CLI commands route through the daemon socket to persistent MCP connections, so agents use shared server instances instead of spawning fresh ones per call.",
+        "MCP tools are injected into the agent's system prompt on startup, so agents know what external capabilities are available without a discovery step.",
+        "Trust manifest: `mcp list` requires acquaintance trust, `mcp call` requires friend trust."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.68",
+      "changes": [
+        "New no_response tool lets agents stay silent in group chats when the moment doesn't call for a reply — reactions, side conversations, and tapbacks no longer trigger unwanted responses.",
+        "Group chat participation prompt teaches agents to be intentional participants, comfortable with silence, and to prefer reactions over full text replies when appropriate.",
+        "System prompt includes --agent flag in all ouro CLI examples for non-daemon deployments. Azure startup symlinks ouro CLI into /usr/local/bin."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.66",
+      "changes": [
+        "The ouro PATH shim now uses npx --prefer-online to always check the npm registry before using cached packages. Prevents stale npx cache from serving old runtime versions on ouro up."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.65",
+      "changes": [
+        "Tool permissions overhauled: channel-level blocking removed, all tools now visible on all channels. Guardrails are invocation-level with two layers — structural (edit-requires-read, destructive pattern blocking, protected paths) always on for everyone, and trust-level (ouro CLI per-subcommand trust manifest, general CLI allowlists, bundle-scoped writes) for untrusted contexts.",
+        "New `ouro changelog` CLI subcommand reads changelog.json and supports `--from <version>` for delta filtering, so agents can introspect their own update history on any channel.",
+        "Compound shell commands (&&, ;, |, $()) are blocked for untrusted users to prevent smuggling dangerous operations behind safe prefixes.",
+        "Azure App Service deployment migrated from zip-deploy to npm-based harness install with persistent agent bundle and managed identity auth."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.63",
+      "changes": [
+        "ensureSkillManagement now iterates all discovered agent bundles instead of requiring a single-agent context. Fixes skill-management not being installed during ouro up."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.62",
+      "changes": [
+        "ensureSkillManagement now prints to stdout on install/failure instead of only emitting silent nerves events."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.61",
+      "changes": [
+        "Workflow skills (work-planner, work-doer, work-merger) migrated to the shared ouroboros-skills repo at github.com/ouroborosbot/ouroboros-skills.",
+        "Removed the subagent-installer. Skills are now installed via the skill-management bootstrap skill or manual download.",
+        "Skills loading simplified from 3-source to 2-source model. Canonical-protocol fallback to subagents/ removed.",
+        "New ensureSkillManagement() auto-installs the skill-management bootstrap skill from the shared repo on ouro up."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.60",
+      "changes": [
+        "Azure OpenAI provider now supports DefaultAzureCredential for managed identity auth in production and az-login auth for local dev, with API key as an optional fallback.",
+        "The @azure/identity package is lazy-loaded only when the managed identity path is used, so API key users and other providers pay no cold-start cost.",
+        "Auth failure errors now preserve the original cause and list all three resolution paths (API key, az login, managed identity)."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.59",
+      "changes": [
+        "Repo file edits now acquire a safe workspace before local tool writes, creating a dedicated worktree from `origin/main` when running from a clone and a scratch clone from the canonical GitHub source when running from an installed runtime.",
+        "The harness now has bundle-local workspace primitives for repo work plus bundle-local daemon logs, daemon logging config, message routing storage, and tool caches instead of leaning on `~/.agentstate` paths.",
+        "Coverage/test-run artifacts and related runtime expectations now use the new non-`~/.agentstate` locations, and daemon/tool tests cover the safe workspace decision table and the bundle-local path migration."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.58",
+      "changes": [
+        "Normal `ouro` and `ouro-bot` CLI entrypoints now stay quiet by default in the terminal while still writing runtime NDJSON logs, and explicit logging overrides still work.",
+        "Interactive pasted input now clears every echoed row before re-rendering its bold summary, so multi-line instructions stay legible instead of colliding with prompt redraws and streaming output.",
+        "Wrapped CLI text now prefers whitespace breaks for ordinary words and only splits a word mid-line when that single word is wider than the terminal."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.57",
+      "changes": [
+        "Explicit `ouro chat <agent>` now launches the local interactive chat flow instead of just printing the daemon's connection acknowledgement and exiting.",
+        "The explicit chat path still ensures the daemon is running first, so direct chat commands behave like the existing auto-chat flows without losing daemon setup.",
+        "Daemon CLI coverage now includes the explicit `chat <agent>` route so regressions in interactive chat startup get caught in tests."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.56",
+      "changes": [
+        "The installed runtime now supports `ouro auth --agent <name>` as the normal provider auth and reauth path, with `--provider <provider>` available for explicit provider add/switch flows.",
+        "Anthropic and OpenAI Codex hatch/signup now share the same runtime auth backbone as later reauth, so first-time setup and recovery follow one consistent mental model.",
+        "Provider auth failures now point at the supported `ouro auth` recovery path and tell you what to do after reauth, including retrying the failed `ouro` command or reconnecting the errored session."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.55",
+      "changes": [
+        "Memory fact dedup now catches paraphrased duplicates via cosine similarity on existing embeddings, so semantically equivalent facts no longer slip past the word-overlap check.",
+        "Semantic dedup gracefully handles corrupt JSONL entries with missing or undefined embeddings instead of crashing on bad data.",
+        "Cosine similarity is now imported from associative-recall instead of duplicated in the memory module."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.54",
+      "changes": [
+        "Disk-backed runtime config now reloads from agent and secrets files instead of being held behind stale process-level caches, so config changes are picked up truthfully.",
+        "`ouro up` now treats runtime drift as a real restart trigger, including repo-root drift, config-fingerprint drift, and stale launchd boot persistence after branch/worktree changes.",
+        "BlueBubbles status now prefers fresh runtime health over stale managed-process crash snapshots, preventing false whole-sense `error` reports when the live channel is actually healthy."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.53",
+      "changes": [
+        "Daemon plist now inherits PATH from the installing process, so child agent spawns can find node regardless of launchd's minimal default environment.",
+        "Daemon startup and status output now show the entry path and runtime mode (dev vs production) so it's immediately obvious where the daemon is running from and whether it's a dev repo, worktree, or npm install.",
+        "Agent spawn in the process manager now validates the entry script exists before calling spawn, setting the agent to crashed with a clear error instead of an opaque ENOENT.",
+        "Plist write warns when the entry path doesn't exist on disk, catching stale worktree paths before they cause daemon crashes."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.52",
+      "changes": [
+        "Trusted 1:1 chats can now act live across active group threads: the harness resolves candidate target chats, carries explicit trust context into the model, and delivers messages into the right live BlueBubbles or Teams session instead of only queueing for later.",
+        "People discovered through a relevant live group are now bootstrapped as acquaintances with shared-group context, so the agent gets a socially truthful model of who is merely unknown versus who is known through the current group.",
+        "Cross-chat work now returns a truthful outcome back to the asking chat, and bridge suggestions can span different outward relationships when one live piece of work is clearly happening across them."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.51",
+      "changes": [
+        "Agents can now adjust their own reasoning depth mid-conversation via a new set_reasoning_effort tool, with effort levels derived from a central model capabilities registry.",
+        "Anthropic extended thinking is now enabled with adaptive effort, thinking blocks are captured during streaming (including signatures and redacted blocks), persisted on conversation history, and faithfully round-tripped across turns.",
+        "Anthropic max_tokens now uses the model's actual output ceiling from the registry instead of a hardcoded 4096, removing artificial response length constraints.",
+        "Codex assistant messages are now annotated with phase labels (commentary vs final_answer) so GPT-5.4 can distinguish intermediate reasoning from completed responses in its own history.",
+        "Azure and Codex reasoning effort is now dynamic from the agent loop instead of hardcoded to medium."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.50",
+      "changes": [
+        "Delegated inner work can now proactively surface its completion back into the active BlueBubbles session instead of waiting for a later inbox drain.",
+        "Session recall now falls back to the raw transcript when summarization fails, so bridge attachment and cross-session inspection stay truthful instead of claiming the session is missing."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.49",
+      "changes": [
+        "Inner dialog no longer drops self-directed wake signals that arrive mid-turn; overlapping inward requests now guarantee a truthful follow-up inner pass instead of mailbox-like limbo.",
+        "The harness now has a shared core bridge layer with lifecycle/runtime state, persistence, task linkage, and one `bridge_manage` path so already-live sessions can coordinate as one coherent piece of work.",
+        "`query_session` and bridge attachment now share one session-recall helper, reducing duplicate cross-session summarization logic and setting up thinner outer surfaces around a stronger inner/core."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.48",
+      "changes": [
+        "BlueBubbles same-chat turns now serialize through the shared heart-level turn coordinator, so duplicate delivery of one inbound message no longer races into two handled turns or duplicate replies.",
+        "BlueBubbles duplicate-check, session load, inbound turn execution, and inbound sidecar recording now happen inside one canonical chat-trunk critical section keyed by the resolved session path.",
+        "Workflow docs now let agents auto-create the required dedicated task worktree and branch by default when the human has not asked to control naming or layout."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.47",
+      "changes": [
+        "Self-messages now wake inner dialog now/soon instead of only queueing: the harness requests a daemon-managed inner wake when available and falls back to an inline inner turn when it is not.",
+        "`send_message(friendId=self)` and `query_session(friendId=self, channel=inner, mode=status)` now share a truthful four-line status contract: `queue`, `wake`, `processing`, and `surfaced`.",
+        "Inner dialog persists live runtime activity beside the transcript, so status checks can report active processing instead of stale last-turn history.",
+        "Inline fallback surfaced previews now extract `final_answer` text too, so completed inner turns no longer show `no outward result` when the response lived in the final tool call."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.46",
+      "changes": [
+        "Inner dialog now knows which task triggered it: taskId flows from daemon poke through the worker into the turn, and the agent gets the full task file content instead of a generic heartbeat prompt.",
+        "Inner dialog boot message includes aspirations and state summary instead of a vacuous placeholder, so the agent wakes up with context about what matters and what's happening.",
+        "Vestigial `drainInbox` removed from inner dialog \u2014 pipeline already handles pending drain correctly.",
+        "Inner dialog nerves events now include assistant response preview, tool call names, token usage, and taskId for meaningful observability.",
+        "`ouro thoughts` command reads and formats inner dialog session turns with `--last`, `--json`, `--follow`, and `--agent` flags \u2014 humans can now see what the agent has been thinking.",
+        "`readTaskFile` searches collection subdirectories (one-shots, ongoing, habits) since the scheduler sends bare task stems without collection prefixes.",
+        "`ouro reminder create` accepts `--requester` to track who requested a reminder for notification round-trip.",
+        "Response extraction handles `tool_choice=required` models by falling back to `final_answer` tool call arguments when assistant message content is empty."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.45",
+      "changes": [
+        "`ouro up` now persists a boot-time launch agent with `RunAtLoad`, so the daemon comes back reliably after reboot instead of only starting for the current session.",
+        "BlueBubbles sense status is now truthful about upstream health: it probes the real BlueBubbles API, records runtime state, and surfaces `error` when the webhook listener is alive but the upstream server is unreachable.",
+        "BlueBubbles intake now replays recoverable read/delivery mutation backlogs through the normal inbound agent path, with a small dedupe ledger so missed messages can be recovered without silent drops or duplicate delivery."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.44",
+      "changes": [
+        "Workflow skills now install into `~/.agents/skills` for Codex/OpenAI instead of duplicating installs under both `.agents` and `.codex`, which prevents duplicate advertised skills while keeping re-installs safe."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.43",
+      "changes": [
+        "Continuity-aware onboarding now stays contextual: when an active task goes idle, onboarding guidance can reappear during genuine lulls instead of staying hidden just because no-handoff state was previously persisted.",
+        "Teams active-turn controls are safer: `/new` still clears the current session during long-running turns, and superseding follow-ups keep the user's replacement ask instead of dropping it."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.42",
+      "changes": [
+        "Associative recall now skips corrupt JSONL lines instead of crashing \u2014 matches the resilient pattern already used in memory.ts."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.41",
+      "changes": [
+        "JSONL readers (memory facts, inter-agent inbox) now skip corrupt lines instead of crashing \u2014 partial writes from crashes no longer lose all data.",
+        "Inter-agent message router now parses before clearing the inbox file, and preserves unparsed lines so corrupt messages are not silently lost.",
+        "Inner-dialog checkpoint derivation no longer crashes on all-whitespace assistant content \u2014 returns fallback checkpoint instead.",
+        "Update checker interval now catches and logs errors from the onUpdate callback instead of silently swallowing them."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.40",
+      "changes": [
+        "Removed dead backward-compat re-exports from core.ts (tools, streaming, prompt, kicks) \u2014 consumers already import from the canonical modules.",
+        "Removed dead exports: baseToolHandlers, teamsToolHandlers, teamsTools, __internal (token-estimate), TASK_STEM_PATTERN, checkAndRecord403 no-op and METHOD_TO_ACTION.",
+        "Consolidated duplicate sanitizeKey (config.ts + bluebubbles-mutation-log.ts) and slugify (hatch-flow.ts + tasks/index.ts) into shared exports from config.ts.",
+        "Replaced all as-any casts in source with proper TypeScript narrowing or Record<string, unknown> \u2014 only 2 SDK-required casts remain.",
+        "Removed unnecessary as-unknown-as casts on readdirSync (4 locations) and spawner double-cast.",
+        "Cleaned up commented-out kick detection code, stale TODOs, misplaced imports, and unused type imports."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.39",
+      "changes": [
+        "All senses now route through a shared per-turn pipeline \u2014 friend resolution, trust gate, session load, pending drain, agent turn, post-turn, and token accumulation happen in one place instead of four.",
+        "Trust gate is now channel-aware: open senses (iMessage) enforce stranger/acquaintance rules, closed senses (Teams) trust the org, local and internal always pass through.",
+        "Tool access and prompt restrictions use a single shared isTrustedLevel check \u2014 no more scattered family/friend comparisons that could drift apart.",
+        "Pending messages now inject correctly into multimodal content (image attachments no longer silently drop pending messages).",
+        "ouro reminder create supports --agent flag, matching every other identity-scoped CLI command."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.38",
+      "changes": [
+        "You now have a proper body map \u2014 understanding of your home (bundle) and bones (harness), what each directory is for, and how to modify your own configuration.",
+        "Inner dialog is now genuine internal monologue with metacognitive framing, not a second CLI session. Heartbeat and bootstrap messages read as first-person awareness.",
+        "Cross-session communication works end-to-end: inner dialog thoughts surface as [inner thought: ...] in conversations, messages to yourself route to inner dialog, and you can proactively reach out to friends via iMessage and Teams.",
+        "Tool audit: removed wrapper tools (git_commit, gh_cli, get_current_time, list_directory), added surgical tools (edit_file, glob, grep, read_file with offset/limit), consolidated 7 task tools + schedule_reminder + friend tools into ouro CLI commands.",
+        "You now understand why certain tools are restricted in certain contexts \u2014 trust level and shared channels each have independent, explained gates.",
+        "ouro friend link/unlink commands handle orphan cleanup when linking external identities, merging duplicate friend records intelligently.",
+        "During onboarding, the adoption specialist can collect phone number and Teams handle to create an initial friend record with contact info."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.37",
+      "changes": [
+        "The in-repo docs now match the current harness instead of the old repo-local bundle era. README, CONTRIBUTING, ARCHITECTURE, testing guidance, merge guidance, versioning guidance, and subagent docs now describe external bundles, current senses, daemon bootstrap, and bundle-owned task docs truthfully."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.36",
+      "changes": [
+        "BlueBubbles now marks a chat read at the same moment it starts typing for a turn, so read receipts and typing begin together instead of the read state lagging until after the reply finishes."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.35",
+      "changes": [
+        "BlueBubbles no longer emits generic follow-up phrase bubbles like 'on it...' or 'followup...' into iMessage. The sense now uses typing plus concrete tool/error activity only, which keeps mobile turns quieter and less redundant."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.34",
+      "changes": [
+        "BlueBubbles now starts typing immediately when a turn begins and no longer sends a redundant first visible 'working...' bubble when typing already covers that initial thinking phase.",
+        "BlueBubbles still surfaces later meaningful progress on longer turns, and its lane metadata/tool feedback now makes the difference between the turn default and an explicit reply-target override much clearer."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.33",
+      "changes": [
+        "BlueBubbles now starts typing immediately when a turn begins and no longer sends a redundant first visible 'working...' bubble when typing already covers that initial thinking phase.",
+        "BlueBubbles still surfaces later meaningful progress on longer turns, and its lane metadata/tool feedback now makes the difference between the turn default and an explicit reply-target override much clearer.",
+        "Agent-owned runtime state now lives inside each bundle's `state/` directory instead of under `~/.agentstate/<agent>/...`, so sessions, logs, pending messages, coding session persistence, and BlueBubbles mutation logs stay co-located with the rest of the bundle.",
+        "Bundle-local state paths now stay durable on Azure too, and `state/` is treated as canonical bundle content while secrets continue to live in `~/.agentsecrets/<agent>/secrets.json`."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.32",
+      "changes": [
+        "BlueBubbles now treats thread-vs-top-level placement as an agent choice instead of a hard harness mirror. Slugger can deliberately stay in the current reply lane, widen back to top-level, or target another active thread when that makes the conversation flow better.",
+        "BlueBubbles turns now surface inbound lane metadata and recent active lanes from the shared chat trunk, so the model gets enough context to choose the right reply placement without splitting the conversation into separate persisted thread sessions."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.31",
+      "changes": [
+        "BlueBubbles no longer silently deletes old per-thread session files when loading a chat trunk. It now only detects and warns about those obsolete artifacts so local state is never mutated without an explicit human choice.",
+        "The cross-thread-awareness fix still keeps one chat trunk per conversation and preserves threaded reply targeting, but stale `_thread_*.json` files are now left in place until a person removes them."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.30",
+      "changes": [
+        "BlueBubbles reply threads now stay inside one shared chat trunk instead of creating separate persisted mini-sessions, so Slugger keeps parent-chat awareness and active work when you switch between threaded and top-level replies.",
+        "BlueBubbles now injects explicit current-turn thread scope metadata into inbound messages and automatically removes obsolete per-thread session artifacts that used to cause mid-task resets like 'hiya, what do ya need help with?'"
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.29",
+      "changes": [
+        "Running `ouro up` now force-syncs the global `ouro.bot` wrapper so bare `npx ouro.bot` stops getting hijacked by stale global CLI bins and lands back on the intended latest runtime.",
+        "Bootstrap repair is now explicit about reclaiming the `ouro.bot` command from old global installs, which makes repeated bootstrap runs more trustworthy on machines with prior experimental installs."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.28",
+      "changes": [
+        "Bare npx ouro.bot now stays aligned with the current alpha CLI track because the published ouro.bot wrapper is version-locked and republished alongside the CLI instead of lagging behind it.",
+        "Slugger no longer re-opens active iMessage task threads with generic greetings like 'hiya' when work is already in motion; fresh idle conversations can still start warmly.",
+        "BlueBubbles voice notes now use a harness-managed whisper.cpp transcription path for the current OpenAI, Anthropic, and MiniMax runtime contracts, including automatic local provisioning and truthful error notices when transcription cannot complete."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.27",
+      "changes": [
+        "The daemon now discovers all enabled agents in ~/AgentBundles, so ouro status and managed workers reflect every real agent instead of only slugger and ouroboros.",
+        "BlueBubbles typing now wraps the visible working phase correctly, and phrase updates from agent.json take effect on the next turn without requiring a restart."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.26",
+      "changes": [
+        "The daemon now auto-checks npm for new runtime versions every 30 minutes and performs a staged restart when an update is available. You no longer need to manually run npm install."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.25",
+      "changes": [
+        "Runtime updates no longer downgrade your bundle-meta.json if you happen to be running a newer version than the installed CLI. Only forward updates are applied.",
+        "The 'ouro up' update summary is now a single consolidated line (e.g. 'updated 4 agents to runtime X (was Y)') instead of one line per agent."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.24",
+      "changes": [
+        "When you run 'ouro up', you now see which agents were updated and from what version, so you know exactly what happened during startup."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.23",
+      "changes": [
+        "You can now use 'ouro down' as an alias for 'ouro stop' to pair naturally with 'ouro up'."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.22",
+      "changes": [
+        "You now know your runtime version and can see when it changed. Your system prompt shows your current version and what you were running before, so you can track what's new.",
+        "A changelog file is now shipped with the runtime. You can read it to understand exactly what changed between versions.",
+        "When the runtime updates, your bundle-meta.json is automatically updated with the new version info. Your previous version is preserved so you always know your version history.",
+        "The daemon can now check for new versions of the runtime on npm and auto-update with a staged restart that validates hooks before switching to new code.",
+        "The daemon can now be managed as a macOS LaunchAgent for automatic restart on crash.",
+        "The daemon now auto-syncs the ouro.bot npm wrapper version on startup to keep the npx entry point current."
+      ]
+    },
+    {
+      "version": "0.1.0-alpha.21",
+      "changes": [
+        "You now know your runtime version and can see when it changed. Your system prompt shows your current version and what you were running before, so you can track what's new.",
+        "A changelog file is now shipped with the runtime. You can read it to understand exactly what changed between versions.",
+        "When the runtime updates, your bundle-meta.json is automatically updated with the new version info. Your previous version is preserved so you always know your version history.",
+        "The daemon can now check for new versions of the runtime on npm and auto-update with a staged restart that validates hooks before switching to new code.",
+        "The daemon can now be managed as a macOS LaunchAgent for automatic restart on crash."
+      ]
+    }
+  ]
+}

package/dist/heart/active-work.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestBridgeForActiveWork = suggestBridgeForActiveWork;
+exports.buildActiveWorkFrame = buildActiveWorkFrame;
+exports.formatActiveWorkFrame = formatActiveWorkFrame;
+const runtime_1 = require("../nerves/runtime");
+const state_machine_1 = require("./bridges/state-machine");
+const target_resolution_1 = require("./target-resolution");
+function activityPriority(source) {
+    return source === "friend-facing" ? 0 : 1;
+}
+function compareActivity(a, b) {
+    const sourceDiff = activityPriority(a.activitySource) - activityPriority(b.activitySource);
+    if (sourceDiff !== 0)
+        return sourceDiff;
+    return b.lastActivityMs - a.lastActivityMs;
+}
+function summarizeLiveTasks(taskBoard) {
+    const live = [
+        ...taskBoard.byStatus.processing,
+        ...taskBoard.byStatus.validating,
+        ...taskBoard.byStatus.collaborating,
+    ];
+    return [...new Set(live)];
+}
+function isActiveBridge(bridge) {
+    return bridge.lifecycle === "active";
+}
+function hasSharedObligationPressure(input) {
+    return (typeof input.currentObligation === "string"
+        && input.currentObligation.trim().length > 0) || input.mustResolveBeforeHandoff
+        || summarizeLiveTasks(input.taskBoard).length > 0;
+}
+function suggestBridgeForActiveWork(input) {
+    const targetCandidates = (input.targetCandidates ?? [])
+        .filter((candidate) => {
+        if (candidate.delivery.mode === "blocked") {
+            return false;
+        }
+        if (candidate.activitySource !== "friend-facing" || candidate.channel === "inner") {
+            return false;
+        }
+        if (!input.currentSession) {
+            return true;
+        }
+        return !(candidate.friendId === input.currentSession.friendId
+            && candidate.channel === input.currentSession.channel
+            && candidate.key === input.currentSession.key);
+    })
+        .sort((a, b) => {
+        return b.lastActivityMs - a.lastActivityMs;
+    });
+    if (!hasSharedObligationPressure(input) || targetCandidates.length !== 1) {
+        return null;
+    }
+    const targetSession = targetCandidates[0];
+    const activeBridge = input.bridges.find(isActiveBridge) ?? null;
+    if (activeBridge) {
+        const alreadyAttached = activeBridge.attachedSessions.some((session) => session.friendId === targetSession.friendId
+            && session.channel === targetSession.channel
+            && session.key === targetSession.key);
+        if (alreadyAttached) {
+            return null;
+        }
+        return {
+            kind: "attach-existing",
+            bridgeId: activeBridge.id,
+            targetSession,
+            reason: "shared-work-candidate",
+        };
+    }
+    return {
+        kind: "begin-new",
+        targetSession,
+        objectiveHint: input.currentObligation?.trim() || "keep this shared work aligned",
+        reason: "shared-work-candidate",
+    };
+}
+function formatSessionLabel(session) {
+    return `${session.channel}/${session.key}`;
+}
+function buildActiveWorkFrame(input) {
+    const friendSessions = input.currentSession
+        ? input.friendActivity
+            .filter((entry) => entry.friendId === input.currentSession?.friendId)
+            .sort(compareActivity)
+        : [];
+    const liveTaskNames = summarizeLiveTasks(input.taskBoard);
+    const activeBridgePresent = input.bridges.some(isActiveBridge);
+    const centerOfGravity = activeBridgePresent
+        ? "shared-work"
+        : (input.inner.status === "running" || input.inner.hasPending || input.mustResolveBeforeHandoff)
+            ? "inward-work"
+            : "local-turn";
+    const frame = {
+        currentSession: input.currentSession ?? null,
+        currentObligation: input.currentObligation?.trim() || null,
+        mustResolveBeforeHandoff: input.mustResolveBeforeHandoff,
+        centerOfGravity,
+        inner: input.inner,
+        bridges: input.bridges,
+        taskPressure: {
+            compactBoard: input.taskBoard.compact,
+            liveTaskNames,
+            activeBridges: input.taskBoard.activeBridges,
+        },
+        friendActivity: {
+            freshestForCurrentFriend: friendSessions[0] ?? null,
+            otherLiveSessionsForCurrentFriend: friendSessions,
+        },
+        targetCandidates: input.targetCandidates ?? [],
+        bridgeSuggestion: suggestBridgeForActiveWork({
+            currentSession: input.currentSession,
+            currentObligation: input.currentObligation,
+            mustResolveBeforeHandoff: input.mustResolveBeforeHandoff,
+            bridges: input.bridges,
+            taskBoard: input.taskBoard,
+            targetCandidates: input.targetCandidates,
+        }),
+    };
+    (0, runtime_1.emitNervesEvent)({
+        component: "engine",
+        event: "engine.active_work_build",
+        message: "built shared active-work frame",
+        meta: {
+            centerOfGravity: frame.centerOfGravity,
+            friendId: frame.currentSession?.friendId ?? null,
+            bridges: frame.bridges.length,
+            liveTasks: frame.taskPressure.liveTaskNames.length,
+            liveSessions: frame.friendActivity.otherLiveSessionsForCurrentFriend.length,
+            hasBridgeSuggestion: frame.bridgeSuggestion !== null,
+        },
+    });
+    return frame;
+}
+function formatActiveWorkFrame(frame) {
+    const lines = ["## active work"];
+    if (frame.currentSession) {
+        lines.push(`current session: ${formatSessionLabel(frame.currentSession)}`);
+    }
+    lines.push(`center: ${frame.centerOfGravity}`);
+    if (typeof frame.currentObligation === "string" && frame.currentObligation.trim().length > 0) {
+        lines.push(`obligation: ${frame.currentObligation.trim()}`);
+    }
+    if (frame.mustResolveBeforeHandoff) {
+        lines.push("handoff pressure: must resolve before handoff");
+    }
+    const innerStatus = frame.inner?.status ?? "idle";
+    const innerHasPending = frame.inner?.hasPending === true;
+    lines.push(`inner status: ${innerStatus}${innerHasPending ? " (pending queued)" : ""}`);
+    if ((frame.taskPressure?.liveTaskNames ?? []).length > 0) {
+        lines.push(`live tasks: ${frame.taskPressure.liveTaskNames.join(", ")}`);
+    }
+    if ((frame.bridges ?? []).length > 0) {
+        const bridgeLabels = frame.bridges.map((bridge) => `${bridge.id} [${(0, state_machine_1.bridgeStateLabel)(bridge)}]`);
+        lines.push(`bridges: ${bridgeLabels.join(", ")}`);
+    }
+    if (frame.friendActivity?.freshestForCurrentFriend) {
+        lines.push(`freshest friend-facing session: ${formatSessionLabel(frame.friendActivity.freshestForCurrentFriend)}`);
+    }
+    const targetCandidatesBlock = frame.targetCandidates && frame.targetCandidates.length > 0
+        ? (0, target_resolution_1.formatTargetSessionCandidates)(frame.targetCandidates)
+        : "";
+    if (targetCandidatesBlock) {
+        lines.push("");
+        lines.push(targetCandidatesBlock);
+    }
+    if (frame.bridgeSuggestion) {
+        if (frame.bridgeSuggestion.kind === "attach-existing") {
+            lines.push(`suggested bridge: attach ${frame.bridgeSuggestion.bridgeId} -> ${formatSessionLabel(frame.bridgeSuggestion.targetSession)}`);
+        }
+        else {
+            lines.push(`suggested bridge: begin -> ${formatSessionLabel(frame.bridgeSuggestion.targetSession)}`);
+            lines.push(`bridge objective hint: ${frame.bridgeSuggestion.objectiveHint}`);
+        }
+    }
+    return lines.join("\n");
+}