@damian87/omp 0.7.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"`        |
 
 ---
 
@@ -192,12 +195,25 @@ omp ralph start "<task>" [--max-iterations N]
 omp ultrawork start "<objective>" [--task-count N]
 omp ultraqa start "<goal>" [--max-cycles N]
 omp council "<question>" [--models a,b,c] [--context @file] [--json]   # multi-model council
-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 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] [--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
@@ -208,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
@@ -219,47 +236,56 @@ run results are surfaced automatically at the start of new Copilot sessions. Alw
 `omp schedule remove`, never delete `.omp/state/schedule/` by hand, so the OS entry is
 uninstalled cleanly.
 
----
-
-## Roadmap
-
-omp is intentionally small today and growing in vertical slices.
-
-### v0.2 — Notification gateways
-
-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`.
+### Chat bridge: drive Copilot from Slack
 
-### v0.3 — Checkpoints + rollback
+`omp gateway` runs long-lived chat connectors that forward messages into a running
+Copilot CLI session (via tmux) and post replies back. Today's connector is `slack`
+(WebSocket Socket Mode — no public URL needed); the runtime is generic so future
+connectors (Telegram, Discord, webhooks) drop in as one file each.
 
-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.
-
-### v0.4 — Provider advisor (`omp ask`)
-
-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`.
+```bash
+# 1. a Copilot tmux session is running (any `omp-<digits>` name)
+tmux new-session -d -s omp-9999
 
-### v0.5 — Scheduled tasks ✅ (shipped)
+# 2. interactive setup — explains where to grab each token and writes
+#    ~/.omp/.env (chmod 600). Re-runnable; masks existing values.
+#    `omp` auto-loads ~/.omp/.env every invocation; shell exports still win.
+omp env init
 
-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`).
+# 3. preflight, then run
+omp gateway status              # ready=true means tokens + session look good
+omp gateway serve               # blocks; ^C stops cleanly
+```
 
-### v0.6 — Browser tool (MCP)
+Full Slack-app setup (manifest + scopes) lives in [`docs/slack-setup.md`](docs/slack-setup.md).
 
-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
+## Roadmap
 
-Live orchestration metrics in the terminal: active mode, current task, worker count, tokens, cache hit rate, last error.
+omp grows in vertical slices. Items aren't pinned to specific semver versions — they land when they're ready.
 
-### v0.8 — Provider routing
+### Already shipped
 
-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.
+- **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.9 — Skill learning
+### Up next
 
-Extract repeating patterns from session transcripts into reusable skill files with strict quality gates. Auto-injects into context when relevant triggers fire.
+- **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.
 
-### v1.0 — Pre-built agent templates
+### Later
 
-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.
 
 ---
 
@@ -269,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
 
@@ -277,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
     }
   ]
 }