@damian87/omp 0.8.0 → 0.9.2

package/.github/skills/slack/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: slack
+description: Post an outbound Slack notification — ONLY when the user types the explicit `/slack` slash command. Never auto-trigger from natural-language phrases like "tell Slack" or "notify me on Slack"; those go to the regular chat. One-way (publish only); the v0.8.0 gateway bridge still handles bidirectional DM chat.
+argument-hint: "<message> [--target slack:C…|D…|G…|U…]"
+---
+
+# /slack — outbound Slack notification
+
+Post a single message to Slack and exit. **No conversation; no listener.** The
+v0.8.0 chat bridge (`omp gateway serve` + `@omp-copilot` DM) handles bidirectional
+chat; this skill is for one-shot publishes.
+
+## Activation rules (read first)
+
+- **Activate ONLY** when the user typed the literal slash command `/slack` (with or
+  without arguments). Never auto-activate from natural-language phrases like "tell
+  Slack X", "ping me on Slack", "notify me on Slack" — those are conversational.
+- **Confirm the destination before posting**, every time:
+  - If `--target` is present, echo it back: "Sending to `slack:<ID>` — confirm? (y/N)"
+  - If `--target` is absent AND `SLACK_HOME_CHANNEL` is a channel (`C…`/`G…`):
+    treat as a potential broadcast. Ask: "Post to default channel `<id>` (a channel,
+    not a DM)? (y/N)" — only proceed on explicit `y`.
+  - If `SLACK_HOME_CHANNEL` is a user (`U…`) or DM (`D…`), proceed without
+    confirmation — the user already configured a personal default.
+- If the user types just `/slack` with no message, ask: *"What should I send and where?"*.
+
+## Contract
+
+- Default target = `SLACK_HOME_CHANNEL` from `~/.omp/.env` (set via `omp env init`).
+- Explicit target = `--target slack:<ID>` (ID = `C…`/`G…`/`D…`/`U…`).
+- `U…` targets are auto-resolved to a DM channel (`conversations.open`) before posting.
+- Stateless: each invocation is a fresh REST call to `chat.postMessage`. No daemon. No socket.
+
+## When invoked
+
+Follow the **Activation rules** above. After confirmation passes, post the message.
+
+## How
+
+Run via the omp CLI:
+
+```
+omp gateway notify --text "<message>" [--target slack:<ID>] [--thread-ts <ts>]
+```
+
+That's the only command this skill drives. The flags map 1:1 to user intent:
+
+- No flags after `--text`: post to `SLACK_HOME_CHANNEL`.
+- `--target slack:C0BOQV5434G`: explicit channel.
+- `--target slack:U0123ABCD`: explicit user (auto-DM).
+- `--target slack:C0…:1700.000123` or `--thread-ts 1700.000123`: pin to a thread.
+
+## Output handling
+
+The CLI returns a structured result:
+
+- Success: `posted to <channel> (ts=<ts>[, opened IM])` — relay that.
+- Failure: `notify failed [<CODE>]: <reason>` — surface the code + reason so the user
+  can act. Common codes:
+  - `MISSING_TOKEN` — run `omp env init` to set `SLACK_BOT_TOKEN`.
+  - `MISSING_TARGET` — pass `--target` or run `omp env init` to set `SLACK_HOME_CHANNEL`.
+  - `BAD_TARGET` / `BAD_HOME_CHANNEL` — the ID is malformed; show the user the expected shape.
+  - `OPEN_FAILED` (user-id targets) — bot can't DM that user (likely missing `im:write` scope or user outside workspace).
+  - `POST_FAILED` — Slack returned `ok: false`; the reason field has Slack's own error name (`channel_not_found`, `not_in_channel`, etc.).
+  - `RATE_LIMITED` / `TIMEOUT` / `NETWORK_ERROR` — transient; try again.
+
+## Boundaries
+
+- This skill **never** waits for a reply. For interactive chat, the user opens Slack and DMs `@omp-copilot` (handled by `omp gateway serve`).
+- This skill **never** stores state. There is no routing table, no per-session registration.
+- This skill **does not** start the v0.8.0 inbound bridge. Daemons stay out of scope.
+
+## Example exchanges
+
+User: `/slack the migration just finished cleanly`
+Tool call: `omp gateway notify --text "the migration just finished cleanly"`
+
+User: `/slack tell #releases the build is green --target slack:C0RELEASE9`
+Tool call: `omp gateway notify --text "the build is green" --target slack:C0RELEASE9`
+
+User: `/slack ping U0123ABCD with "deploy needs review"`
+Tool call: `omp gateway notify --text "deploy needs review" --target slack:U0123ABCD`

package/README.md

@@ -53,7 +53,8 @@ That's it.
 - **Team-first orchestration** — parallel tmux panes, each running an independent agent session
 - **Bare-flag bypass** — `omp --madmax` injects `--yolo` so non-interactive runs never block on a permission prompt
 - **Persistent execution** — Ralph, UltraQA, and Ultrawork keep going until the goal is verified
-- **MCP-powered shared state** — workers swap typed messages over an outbox/inbox cursor instead of summarising each other's summaries
+- **File-state coordination** — workers swap typed messages over an outbox/inbox cursor with atomic `O_EXCL` task locks; no broker or daemon to babysit
+- **Chat bridge** — `omp gateway` runs long-lived chat connectors (Slack today, more next) so you can DM Copilot from anywhere
 - **Lifecycle hooks** — `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `SessionEnd`, `Error`
 - **Doctor included** — `omp doctor` verifies plugin manifest, skills discovery, hooks, and the underlying `copilot` CLI in one shot
 
@@ -76,14 +77,14 @@ That's it.
 ### Intelligent Orchestration
 
 - **7 specialized agents** — planner, architect, executor, verifier, code-reviewer, designer, researcher (all `--agent <name>` compatible with Copilot CLI)
-- **19 in-session skills** auto-discovered from `.github/skills/`
+- **22 in-session skills** auto-discovered from `.github/skills/`
 - **Smart pipeline routing** — `/research-codebase` → `/ralplan` → `/team` / `/ralph` / `/ultrawork` → `/code-review` → `/ultraqa`
 
 ### Developer Experience
 
-- **MCP server** ships with `notepad`, `project-memory`, `shared-memory`, `state`, and `trace` tools out of the box
+- **Context & history as CLI subcommands** — `omp state` (key-value with TTL), `omp project-memory` (notes + directives), `omp trace` (per-session timeline + summary), `omp goal` / `omp memory sync` (managed repo context), `omp daily-log`
 - **Lightweight Copilot context** — managed instructions keep only the repo goal plus on-demand memory commands; set `OMP_DISABLE_INSTRUCTIONS_MEMORY=1` to skip writing the managed block entirely
-- **File-state coordination** — outbox JSONL + byte cursor, atomic `O_EXCL` task locks, optimistic CAS on claim
+- **File-state worker coordination** — outbox JSONL + byte cursor, atomic `O_EXCL` task locks, optimistic CAS on claim
 - **Idle nudge** — content-based pane idle detection that pokes stuck workers
 - **Mode-state loops** — single source of truth per loop (Ralph/Ultrawork/UltraQA state files)
 
@@ -115,6 +116,8 @@ These run **inside a Copilot CLI session** after the plugin is installed.
 | `/caveman`              | Ultra-compressed communication mode                       | `/caveman`                                           |
 | `/worktree`             | Git worktree-based parallel branch work                   | `/worktree`                                          |
 | `/schedule`             | Durable local cron job — re-runs a prompt on a schedule, survives reboot | `/schedule "check the PR every 15 min"`   |
+| `/goal`                 | Set/read the repo-level goal injected into the managed Copilot context | `/goal "ship v1.0 of the billing flow"` |
+| `/daily-log`            | Per-day goal + work log surfaced at the start of new sessions | `/daily-log "ratelimit refactor landed"`        |
 
 ---
 
@@ -195,15 +198,22 @@ omp council "<question>" [--models a,b,c] [--context @file] [--json]   # multi-m
 omp comms status | send | recv | ask        # drive a running copilot tmux session
 omp gateway serve [--only slack]            # run chat connectors (today: slack)
 omp gateway status [--json]                 # per-connector readiness (no sockets)
+omp gateway notify --text "<msg>" [--target slack:C…|G…|D…|U… [:thread_ts]] [--thread-ts <ts>] [--json]
+                                            # one-shot outbound Slack post; falls back to SLACK_HOME_CHANNEL
 omp slack serve                             # deprecated alias of `gateway serve --only slack`
 omp slack doctor [--json]                   # deprecated alias of `gateway status --only slack`
 omp env init [--force]                      # write ~/.omp/.env (interactive Slack token setup)
-omp schedule add --id <id> --cron "*/15 * * * *" --prompt "<text>" [--allow-all-tools] [--cwd <dir>] [--model <m>] [--timeout <ms>] [--max-runs N] [--ttl-hours H] [--dry-run]
+omp schedule add --id <id> --cron "*/15 * * * *" --prompt "<text>" [--allow-all-tools] [--cwd <dir>] [--model <m>] [--timeout <ms>] [--max-runs N] [--ttl-hours H] [--notify-target slack:U0123ABCD] [--dry-run]
 omp schedule list                           # registered jobs + OS-install status
 omp schedule status <id>                    # last run + result summary
 omp schedule run-now <id>                   # trigger one run immediately
 omp schedule remove <id>                    # uninstall the OS entry + delete the job
-omp mcp                                     # MCP server over stdio
+omp goal set "<objective>" | read [--json]
+omp memory sync [--json]                    # render goal + directives into copilot-instructions.md
+omp daily-log set-goal "<text>" | add "<text>" | read [--days N] | prune [--keep-days N] [--json]
+omp state write <key> <val> [--ttl <s>] | read | delete | status <key> | list | cleanup [--json]
+omp project-memory read [<id>] | index | add-note "<title>" [--body "<text>"] | add-directive "<rule>" [--json]
+omp trace timeline [<sessionId>] [--limit N] | summary [<sessionId>] | add <sessionId> <event> [<json>] [--json]
 omp catalog list | validate | capability <id>
 omp jira render <plan-file>
 omp jira apply <key-or-plan> --comment|--update|--transition|--link
@@ -214,6 +224,7 @@ Environment overrides:
 - `OMP_PLUGIN_ROOT` — path to the plugin checkout (with `OMC_PLUGIN_ROOT` accepted for back-compat)
 - `OMP_COPILOT_BIN` — alternate `copilot` binary
 - `OMP_BIN` — absolute path to the `omp` wrapper written into OS-scheduler entries (overrides `which omp`)
+- `OMP_SKIP_USER_ENV` — when `1`, skip auto-loading `~/.omp/.env` (useful for hermetic CI runs)
 
 **Scheduled jobs** register a durable per-job entry with the OS scheduler (macOS launchd,
 Linux systemd-user timers, or a managed `crontab` block as a cross-platform fallback) that
@@ -252,43 +263,29 @@ Full Slack-app setup (manifest + scopes) lives in [`docs/slack-setup.md`](docs/s
 
 ## Roadmap
 
-omp is intentionally small today and growing in vertical slices.
+omp grows in vertical slices. Items aren't pinned to specific semver versions — they land when they're ready.
 
-### v0.2 — Notification gateways
+### Already shipped
 
-Telegram, Discord, Slack, and generic webhook integration so long-running modes can ping you when they finish, fail, or stall. Tag with `--telegram` / `--discord` / `--slack` per invocation; configure once with `omp notify add`.
+- **Scheduled tasks** (v0.6.0) — durable local cron: `omp schedule add --id pr-watch --cron "*/15 * * * *" --prompt "…"` plus `/schedule` in-session. Each job registers an OS-scheduler entry (launchd / systemd-user / crontab fallback) that fires a fresh agent session, survives reboot, locks out overlap, and surfaces results at the next session start.
+- **Chat bridge — Slack inbound** (v0.8.0) — `omp gateway` runs long-lived chat connectors that forward messages into a running Copilot tmux session and post replies back. Slack is the first connector (Socket Mode, no public URL). `omp env init` walks you through one-time token setup; tokens live in `~/.omp/.env` (auto-loaded on every invocation). See [`docs/slack-setup.md`](docs/slack-setup.md).
+- **Slack outbound — `omp gateway notify`** — stateless REST `chat.postMessage` from any process (cron `--notify-target`, in-session `/slack <message>`, ad-hoc `omp gateway notify --text "..."`). Default destination from `SLACK_HOME_CHANNEL`; explicit `--target slack:C…/G…/D…/U…` overrides; `U…` auto-resolves to a DM via `conversations.open`.
+- **Weighted-consensus council** — multi-model council with role weights + minority report. Via `omp council` or `/weighted-consensus`.
+- **Suggest** — `omp suggest "<task>"` recommends a slash-skill workflow without launching one.
 
-### v0.3 — Checkpoints + rollback
+### Up next
 
-Auto-snapshot the working tree before any tool-driven file edit. `omp rollback [id]` to revert a checkpoint. A safety net for autonomous loops that go wide before they go right.
+- **More chat connectors** — Telegram, Discord, generic webhook on the same `omp gateway` runtime. One file per connector.
+- **Outbound notifications** — long-running modes ping you when they finish, fail, or stall (`omp notify add` + per-invocation `--telegram`/`--discord`/`--slack` tags).
+- **Checkpoints + rollback** — auto-snapshot the working tree before any tool-driven file edit; `omp rollback [id]` reverts a checkpoint. Safety net for autonomous loops.
+- **Browser tool** — web search / page extraction / full automation (navigate, click, type, screenshot) for research skills that need fresh data instead of training-cutoff guesses.
 
-### v0.4 — Provider advisor (`omp ask`)
+### Later
 
-One command to consult an alternate provider CLI (`claude`, `codex`, `gemini`) and save the response as a markdown artifact under `.omp/artifacts/ask/`. Same surface in-session via `/ask`.
-
-### v0.5 — Scheduled tasks ✅ (shipped)
-
-Durable local cron: `omp schedule add --id pr-watch --cron "*/15 * * * *" --prompt "…"` plus `/schedule` in-session. Each job registers an OS-scheduler entry (launchd / systemd-user / crontab fallback) that fires a fresh agent session, survives reboot, locks out overlap, and surfaces results at the next session start. Follow-ups: natural-language cron parsing, notification-gateway delivery, pause/resume/edit, and an orphan-sweep (`omp schedule gc`).
-
-### v0.6 — Browser tool (MCP)
-
-A first-class browser MCP tool: web search, page extraction, full automation (navigate, click, type, screenshot). For research skills that need fresh data instead of training-cutoff guesses.
-
-### v0.7 — HUD-lite statusline
-
-Live orchestration metrics in the terminal: active mode, current task, worker count, tokens, cache hit rate, last error.
-
-### v0.8 — Provider routing
-
-Fine-grained per-task provider selection — sorting, whitelists, priority ordering, cost-aware fallback. For mixed pipelines that want Opus for planning and Haiku for grunt work without manual model switching.
-
-### v0.9 — Skill learning
-
-Extract repeating patterns from session transcripts into reusable skill files with strict quality gates. Auto-injects into context when relevant triggers fire.
-
-### v1.0 — Pre-built agent templates
-
-One-shot deployable templates for common workflows: research, security audit, design-system migration, content automation. `omp template add <name>` drops a curated skill + agent pair into your project.
+- **HUD-lite statusline** — live orchestration metrics in the terminal: active mode, current task, worker count, tokens, cache hit rate, last error.
+- **Provider routing** — fine-grained per-task provider selection: sorting, whitelists, priority ordering, cost-aware fallback. For mixed pipelines that want Opus for planning and Haiku for grunt work without manual model switching.
+- **Skill learning** — extract repeating patterns from session transcripts into reusable skill files with strict quality gates. Auto-injects into context when relevant triggers fire.
+- **Pre-built agent templates** — one-shot deployable templates for common workflows (research, security audit, design-system migration, content automation). `omp template add <name>` drops a curated skill + agent pair into your project.
 
 ---
 
@@ -298,6 +295,7 @@ One-shot deployable templates for common workflows: research, security audit, de
 - [Copilot distribution](docs/copilot-distribution.md) — project/user skill installs and the case against GitHub App Extensions
 - [Jira adapter](docs/jira.md) — configuration discovery, safe operations, dry-runs, fallback payloads
 - [Self-evolve](docs/self-evolve.md) — extracting reusable skills from session transcripts
+- [Slack setup](docs/slack-setup.md) — Slack app manifest, scopes, Socket-Mode token, `omp gateway serve`
 
 ## Layout
 
@@ -306,7 +304,7 @@ One-shot deployable templates for common workflows: research, security audit, de
 .github/skills/<name>/SKILL.md    # in-session slash skills
 hooks/hooks.json                  # lifecycle hook manifest
 scripts/*.mjs                     # hook implementations
-src/                              # omp CLI, MCP server, team runtime, mode-state loops
+src/                              # omp CLI, team runtime, gateway/comms, schedule, mode-state loops
 ```
 
 Skills follow the [Copilot agent-skills docs](https://docs.github.com/en/copilot) — project skills live in `.github/skills/` and are invoked with `/skill-name`.

package/catalog/capabilities.json

@@ -862,6 +862,52 @@
           "notes": "Use /weighted-consensus from .github/skills/weighted-consensus/SKILL.md."
         }
       }
+    },
+    {
+      "id": "slack",
+      "name": "slack",
+      "title": "Slack Notification",
+      "category": "notify",
+      "summary": "Post an outbound Slack notification from inside a Copilot session.",
+      "notes": "Thin in-session wrapper over `omp gateway notify`. Stateless REST call. v0.8.0 inbound chat bridge unchanged.",
+      "defaultCommand": "slack",
+      "phase1": true,
+      "sourceSkill": "slack",
+      "providers": {
+        "copilot": "supported"
+      },
+      "support": {
+        "copilot": "native"
+      },
+      "providerSupport": {
+        "copilot": {
+          "state": "native",
+          "notes": "Use /slack from .github/skills/slack/SKILL.md."
+        }
+      }
+    },
+    {
+      "id": "notify.slack",
+      "name": "notify.slack",
+      "title": "Slack Notification",
+      "category": "notify",
+      "summary": "Alias capability id for `slack`.",
+      "notes": "Same skill as `slack`.",
+      "defaultCommand": "slack",
+      "phase1": true,
+      "sourceSkill": "slack",
+      "providers": {
+        "copilot": "supported"
+      },
+      "support": {
+        "copilot": "native"
+      },
+      "providerSupport": {
+        "copilot": {
+          "state": "native",
+          "notes": "Use /slack from .github/skills/slack/SKILL.md."
+        }
+      }
     }
   ]
 }

package/catalog/skills-general.json

@@ -502,6 +502,32 @@
       },
       "projection": "project-skill",
       "phase1": true
+    },
+    {
+      "name": "slack",
+      "capabilityId": "slack",
+      "capabilityIds": [
+        "slack",
+        "notify.slack"
+      ],
+      "source": ".github/skills/slack/SKILL.md",
+      "sourcePath": ".github/skills/slack/SKILL.md",
+      "canonicalPath": ".github/skills/slack/SKILL.md",
+      "description": "Post an outbound Slack notification from inside a Copilot session.",
+      "summary": "Post an outbound Slack notification from inside a Copilot session.",
+      "support": "project-skill",
+      "aliases": [],
+      "slashCommands": [
+        "slack"
+      ],
+      "projections": {
+        "copilot": {
+          "command": "/slack",
+          "state": "supported"
+        }
+      },
+      "projection": "project-skill",
+      "phase1": true
     }
   ]
 }

package/dist/src/cli.js

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 import { realpathSync } from "node:fs";
+import { join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { findCapability, loadCatalogBundle, validateCatalogBundle } from "./catalog.js";
 import { findRegisteredCommand, registeredCommandHelpLines } from "./commands/registry.js";
 import { loadOmpEnv } from "./env/dotenv.js";
-import { inspectProject } from "./project.js";
+import { ompRoot } from "./omp-root.js";
+import { inspectProject, packageRootFromImportMeta } from "./project.js";
 function hasFlag(args, flag) {
     return args.includes(flag);
 }
@@ -24,7 +26,7 @@ function printResult(result, json) {
     }
 }
 function help() {
-    return `oh-my-copilot\n\nRun \`omp\` with no arguments to launch copilot (permissions bypass OFF).\nUse \`omp help\` to show this list.\n\nCommands:\n  (no args)                                     launch copilot (bypass OFF by default)\n  version [--json]\n  list [--json]\n  setup [--dry-run] [--scope project|user] [--plugin-root <dir>] [--json]\n  doctor [--json] [--copilot-bin <path>] [--skip-copilot]\n  launch -- <args...>\n  --madmax [args...]                          (bare-flag launch with permissions bypass; alias of --yolo)\n  team <N:role> "<task>" [--name <name>] [--json]\n  team status <name> [--json]\n  team shutdown <name> [--json]\n  team api claim-task --input '<json>' [--json]\n  team api transition-task-status --input '<json>' [--json]\n  team api send-message --input '<json>' [--json]\n  team api broadcast --input '<json>' [--json]\n  team api mailbox-list --input '<json>' [--json]\n  team api mailbox-mark-delivered --input '<json>' [--json]\n  council "<question>" [--models a,b,c|m:role:weight] [--context <text|@file>] [--rubric <text|@file>] [--synth <model>] [--probe] [--timeout <ms>] [--synth-timeout <ms>] [--min-survivors <n>] [--max-concurrency <n>] [--tmp-dir <dir>] [--json]\n  comms status [--session <name>] [--json]      (is copilot on + online? auto-discovers session)\n  comms send --text "<prompt>" [--force] [--session <name>] [--json]\n  comms recv [--wait] [--lines <n>] [--timeout <ms>] [--session <name>] [--json]\n  comms ask --text "<prompt>" [--force] [--lines <n>] [--timeout <ms>] [--session <name>] [--json]\n  gateway serve [--only <name>[,<name>]]        (run all configured connectors; today: slack)\n  gateway status [--json] [--only <name>[,...]] (per-connector readiness; no sockets opened)\n  gateway doctor [--json] [--only <name>[,...]] (alias for 'gateway status')\n  slack serve                                   (deprecated alias for 'gateway serve --only slack')\n  slack doctor [--json]                         (deprecated alias for 'gateway status --only slack')\n  env init [--force]                            (interactive: write ~/.omp/.env with Slack tokens)\n                                                non-interactive: set OMP_INIT_BOT_TOKEN/OMP_INIT_APP_TOKEN\n                                                (env vars preferred over --bot-token/--app-token flags)\n  (--session is optional when exactly one omp-<digits> tmux session is running)\n${registeredCommandHelpLines().join("\n")}\n  ralph start "<task>" [--max-iterations <n>] [--session-id <id>] [--json]\n  ralph status [--json]\n  ralph tick [--json]\n  ralph cancel [--json]\n  ultrawork start "<objective>" [--task-count <n>] [--summary <s>] [--json]\n  ultrawork status [--json]\n  ultrawork cancel [--json]\n  ultraqa start "<goal>" [--max-cycles <n>] [--json]\n  ultraqa cycle pass|fail|pending [--json]\n  ultraqa status [--json]\n  ultraqa cancel [--json]\n  schedule add --id <id> --cron "<expr>" --prompt "<text>" [--bin copilot] [--model <m>] [--cwd <dir>] [--timeout <ms>] [--max-runs <n>] [--ttl-hours <h>] [--allow-all-tools] [--dry-run] [--json]\n  schedule list [--json]\n  schedule status <id> [--json]\n  schedule run-now <id> [--json]\n  schedule remove <id> [--json]\n  goal set "<objective>" [--json]\n  goal read [--json]\n  memory sync [--json]                          (render goal+directives into copilot-instructions.md)\n  daily-log set-goal "<text>" [--json]\n  daily-log add "<text>" [--json]\n  daily-log read [--days <n>] [--json]\n  daily-log prune [--keep-days <n>] [--json]\n  state write <key> <val> [--ttl <s>] | read|delete|status <key> | list | cleanup [--json]\n  project-memory read [<id>] | index | add-note "<title>" [--body "<text>"] | add-directive "<rule>" [--json]\n  trace timeline [<sessionId>] [--limit <n>] | summary [<sessionId>] | add <sessionId> <event> [<json>] [--json]\n  catalog list [--json]\n  catalog validate [--json]\n  catalog capability <id> [--json]\n  project inspect [--json]\n  skill install <skill-dir> [--root <repo>] [--scope project|user] [--dry-run] [--json]\n  lint:skills [--root <repo>]\n  sync:dry-run [--root <repo>]\n  jira:dry-run [--root <repo>]\n  jira render <plan-file> [--root <repo>] [--json]\n  jira apply <ticket-key-or-plan-file> --comment|--update|--transition|--link [--dry-run] [--json]\n`;
+    return `oh-my-copilot\n\nRun \`omp\` with no arguments to launch copilot (permissions bypass OFF).\nUse \`omp help\` to show this list.\n\nCommands:\n  (no args)                                     launch copilot (bypass OFF by default)\n  version [--json]\n  list [--json]\n  setup [--dry-run] [--scope project|user] [--plugin-root <dir>] [--json]\n  doctor [--json] [--copilot-bin <path>] [--skip-copilot]\n  launch -- <args...>\n  --madmax [args...]                          (bare-flag launch with permissions bypass; alias of --yolo)\n  team <N:role> "<task>" [--name <name>] [--json]\n  team status <name> [--json]\n  team shutdown <name> [--json]\n  team api claim-task --input '<json>' [--json]\n  team api transition-task-status --input '<json>' [--json]\n  team api send-message --input '<json>' [--json]\n  team api broadcast --input '<json>' [--json]\n  team api mailbox-list --input '<json>' [--json]\n  team api mailbox-mark-delivered --input '<json>' [--json]\n  council "<question>" [--models a,b,c|m:role:weight] [--context <text|@file>] [--rubric <text|@file>] [--synth <model>] [--probe] [--timeout <ms>] [--synth-timeout <ms>] [--min-survivors <n>] [--max-concurrency <n>] [--tmp-dir <dir>] [--json]\n  comms status [--session <name>] [--json]      (is copilot on + online? auto-discovers session)\n  comms send --text "<prompt>" [--force] [--session <name>] [--json]\n  comms recv [--wait] [--lines <n>] [--timeout <ms>] [--session <name>] [--json]\n  comms ask --text "<prompt>" [--force] [--lines <n>] [--timeout <ms>] [--session <name>] [--json]\n  gateway serve [--only <name>[,<name>]]        (run all configured connectors; today: slack)\n  gateway status [--json] [--only <name>[,...]] (per-connector readiness; no sockets opened)\n  gateway doctor [--json] [--only <name>[,...]] (alias for 'gateway status')\n  gateway notify --text "<msg>" [--target slack:C\\|D\\|G\\|U... [:thread_ts]] [--thread-ts <ts>] [--json]\n                                                (one-shot outbound Slack post; falls back to SLACK_HOME_CHANNEL)\n  slack serve                                   (deprecated alias for 'gateway serve --only slack')\n  slack doctor [--json]                         (deprecated alias for 'gateway status --only slack')\n  env init [--force]                            (interactive: write ~/.omp/.env with Slack tokens + optional SLACK_HOME_CHANNEL)\n                                                non-interactive: set OMP_INIT_BOT_TOKEN/OMP_INIT_APP_TOKEN/OMP_INIT_HOME_CHANNEL\n                                                (env vars preferred over --bot-token/--app-token/--home-channel flags)\n  (--session is optional when exactly one omp-<digits> tmux session is running)\n${registeredCommandHelpLines().join("\n")}\n  ralph start "<task>" [--max-iterations <n>] [--session-id <id>] [--json]\n  ralph status [--json]\n  ralph tick [--json]\n  ralph cancel [--json]\n  ultrawork start "<objective>" [--task-count <n>] [--summary <s>] [--json]\n  ultrawork status [--json]\n  ultrawork cancel [--json]\n  ultraqa start "<goal>" [--max-cycles <n>] [--json]\n  ultraqa cycle pass|fail|pending [--json]\n  ultraqa status [--json]\n  ultraqa cancel [--json]\n  schedule add --id <id> --cron "<expr>" --prompt "<text>" [--bin copilot] [--model <m>] [--cwd <dir>] [--timeout <ms>] [--max-runs <n>] [--ttl-hours <h>] [--allow-all-tools] [--notify-target slack:<ID>] [--dry-run] [--json]\n  schedule list [--json]\n  schedule status <id> [--json]\n  schedule run-now <id> [--json]\n  schedule remove <id> [--json]\n  goal set "<objective>" [--json]\n  goal read [--json]\n  memory sync [--json]                          (render goal+directives into copilot-instructions.md)\n  daily-log set-goal "<text>" [--json]\n  daily-log add "<text>" [--json]\n  daily-log read [--days <n>] [--json]\n  daily-log prune [--keep-days <n>] [--json]\n  state write <key> <val> [--ttl <s>] | read|delete|status <key> | list | cleanup [--json]\n  project-memory read [<id>] | index | add-note "<title>" [--body "<text>"] | add-directive "<rule>" [--json]\n  trace timeline [<sessionId>] [--limit <n>] | summary [<sessionId>] | add <sessionId> <event> [<json>] [--json]\n  catalog list [--json]\n  catalog validate [--json]\n  catalog capability <id> [--json]\n  project inspect [--json]\n  skill install <skill-dir> [--root <repo>] [--scope project|user] [--dry-run] [--json]\n  lint:skills [--root <repo>]\n  sync:dry-run [--root <repo>]\n  jira:dry-run [--root <repo>]\n  jira render <plan-file> [--root <repo>] [--json]\n  jira apply <ticket-key-or-plan-file> --comment|--update|--transition|--link [--dry-run] [--json]\n`;
 }
 async function resolveExistingInputPath(value) {
     const { existsSync } = await import("node:fs");
@@ -47,7 +49,17 @@ export async function runCli(argv = process.argv.slice(2)) {
     if (group === "version" || group === "--version" || group === "-v") {
         const { getVersionInfo, formatVersionInfo } = await import("./copilot/version.js");
         const info = getVersionInfo({ importMetaUrl: import.meta.url });
-        return json ? { ok: true, output: info } : { ok: true, message: formatVersionInfo(info) };
+        const versionCheckUrl = pathToFileURL(join(packageRootFromImportMeta(import.meta.url), "scripts", "lib", "version-check.mjs")).href;
+        const { checkForUpdate, formatUpdateNotice } = (await import(versionCheckUrl));
+        const cwd = flagValue(argv, "--root") ?? process.cwd();
+        const update = await checkForUpdate({ stateDir: join(ompRoot(cwd), ".omp", "state") });
+        if (json) {
+            return { ok: true, output: { ...info, update } };
+        }
+        const message = update
+            ? `${formatVersionInfo(info)}\n\n${formatUpdateNotice(update.current, update.latest)}`
+            : formatVersionInfo(info);
+        return { ok: true, message };
     }
     // Auto-load ~/.omp/.env so subcommands that read process.env (slack tokens,
     // OMP_*, COPILOT_TMUX_SESSION, etc.) work from any cwd without `source .env`.
@@ -717,10 +729,12 @@ async function handleEnvCommand(argv, json) {
     const appEnv = process.env.OMP_INIT_APP_TOKEN;
     const sessionEnv = process.env.OMP_INIT_SESSION;
     const usersEnv = process.env.OMP_INIT_USERS;
+    const homeChannelEnv = process.env.OMP_INIT_HOME_CHANNEL;
     const botFlag = flagValue(argv, "--bot-token");
     const appFlag = flagValue(argv, "--app-token");
     const sessionFlag = flagValue(argv, "--session");
     const usersFlag = flagValue(argv, "--users");
+    const homeChannelFlag = flagValue(argv, "--home-channel");
     if ((botFlag !== undefined || appFlag !== undefined) && process.env.OMP_INIT_NO_WARN !== "1") {
         console.error("warning: --bot-token/--app-token leak via shell history and `ps`. " +
             "Prefer OMP_INIT_BOT_TOKEN / OMP_INIT_APP_TOKEN env vars (set OMP_INIT_NO_WARN=1 to silence).");
@@ -729,10 +743,15 @@ async function handleEnvCommand(argv, json) {
     const appToken = appEnv ?? appFlag;
     const session = sessionEnv ?? sessionFlag;
     const users = usersEnv ?? usersFlag;
+    const homeChannel = homeChannelEnv ?? homeChannelFlag;
     // Non-interactive when stdin isn't a TTY OR when any answer is already
     // supplied (via env or flag). Partial answers are allowed; missing required
     // ones will be rejected by runEnvInit's validator.
-    const anyAnswer = botToken !== undefined || appToken !== undefined || session !== undefined || users !== undefined;
+    const anyAnswer = botToken !== undefined ||
+        appToken !== undefined ||
+        session !== undefined ||
+        users !== undefined ||
+        homeChannel !== undefined;
     const force = hasFlag(argv, "--force");
     let result;
     if (anyAnswer || !process.stdin.isTTY) {
@@ -751,6 +770,7 @@ async function handleEnvCommand(argv, json) {
                 slackAppToken: appToken ?? "",
                 copilotTmuxSession: session ?? "",
                 slackAllowedUsers: users ?? "",
+                slackHomeChannel: homeChannel ?? "",
             },
         });
     }
@@ -876,12 +896,36 @@ async function handleGatewayCommand(argv, json) {
         ];
         return { ok: ready, exitCode: ready ? 0 : 1, message: lines.join("\n") };
     }
+    if (command === "notify") {
+        const text = flagValue(argv, "--text");
+        if (!text || !text.trim()) {
+            return { ok: false, exitCode: 1, message: 'gateway notify requires --text "<message>"' };
+        }
+        const target = flagValue(argv, "--target");
+        const threadTs = flagValue(argv, "--thread-ts");
+        const { notify } = await import("./gateway/notify.js");
+        const result = await notify({ text, target, threadTs });
+        if (json) {
+            return {
+                ok: result.ok,
+                exitCode: result.ok ? 0 : 1,
+                output: result,
+            };
+        }
+        return {
+            ok: result.ok,
+            exitCode: result.ok ? 0 : 1,
+            message: result.ok
+                ? `posted to ${result.channel} (ts=${result.ts}${result.openedIm ? ", opened IM" : ""})`
+                : `notify failed [${result.code}]: ${result.reason}`,
+        };
+    }
     // Silence the unused warning emitted when no command path is hit.
     void getGatewayStatus;
     return {
         ok: false,
         exitCode: 1,
-        message: "Unknown gateway subcommand. Try: gateway serve | status | doctor",
+        message: "Unknown gateway subcommand. Try: gateway serve | status | doctor | notify --text \"...\"",
     };
 }
 const TEAM_SPEC_RE = /^(\d+):([\w-]+)$/;
@@ -1168,6 +1212,14 @@ async function handleScheduleCommand(argv, json) {
         catch (err) {
             return { ok: false, exitCode: 1, message: String(err instanceof Error ? err.message : err) };
         }
+        const notifyTarget = flagValue(argv, "--notify-target");
+        if (notifyTarget) {
+            const { parseTarget } = await import("./gateway/target-parser.js");
+            const parsed = parseTarget(notifyTarget);
+            if (!parsed.ok) {
+                return { ok: false, exitCode: 1, message: `--notify-target: ${parsed.error}` };
+            }
+        }
         const result = mod.addScheduleJob(cwd, {
             id,
             cron,
@@ -1180,6 +1232,7 @@ async function handleScheduleCommand(argv, json) {
             ttlHours,
             allowAllTools: hasFlag(argv, "--allow-all-tools"),
             dryRun: hasFlag(argv, "--dry-run"),
+            notifyTarget,
         });
         return json
             ? { ok: result.ok, exitCode: result.ok ? 0 : 1, output: result }