@damian87/omp 0.1.0 → 0.2.0

package/README.md

@@ -1,5 +1,7 @@
 # oh-my-copilot
 
+[![npm version](https://img.shields.io/npm/v/@damian87/omp.svg)](https://www.npmjs.com/package/@damian87/omp)
+[![npm downloads](https://img.shields.io/npm/dm/@damian87/omp.svg)](https://www.npmjs.com/package/@damian87/omp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 
 **Multi-agent orchestration for GitHub Copilot CLI. Zero learning curve.**
@@ -10,25 +12,27 @@ _Don't relearn Copilot. Just use omp._
 
 ---
 
+> Now on npm as [`@damian87/omp`](https://www.npmjs.com/package/@damian87/omp). One command and you're running.
+
 ## Quick Start
 
 **Step 1: Install**
 
-Two commands install all 17 omp skills as a Copilot CLI plugin:
+The shell CLI (`omp`):
 
 ```bash
-copilot plugin marketplace add damian87x/oh-my-copilot
-copilot plugin install oh-my-copilot@oh-my-copilot
+npm i -g @damian87/omp
 ```
 
-Requires Copilot CLI v1.0.48+. After install, `/omp-autopilot`, `/ralplan`, `/code-review`, `/create-skill`, `/self-evolve`, and the rest are available inside any Copilot session.
-
-If you prefer the npm path for the local runtime:
+And the in-session skills, as a Copilot CLI plugin:
 
 ```bash
-npm i -g @damian87/omp
+copilot plugin marketplace add damian87x/oh-my-copilot
+copilot plugin install oh-my-copilot@oh-my-copilot
 ```
 
+Requires Copilot CLI v1.0.48+. After install, `omp --madmax` works from any shell, and `/omp-autopilot`, `/ralplan`, `/code-review`, `/create-skill`, `/self-evolve`, and the rest are available inside any Copilot session.
+
 **Step 2: Build something**
 
 ```bash
@@ -46,7 +50,7 @@ That's it.
 ## Why oh-my-copilot?
 
 - **Zero configuration** — works out of the box with sane defaults
-- **Team-first orchestration** — staged pipelines on a shared task list
+- **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
@@ -72,8 +76,8 @@ That's it.
 ### Intelligent Orchestration
 
 - **7 specialized agents** — planner, architect, executor, verifier, code-reviewer, designer, researcher (all `--agent <name>` compatible with Copilot CLI)
-- **17 in-session skills** auto-discovered from `.github/skills/`
-- **Smart pipeline routing** — `/codebase-research` → `/ralplan` → `/team` / `/ralph` / `/ultrawork` → `/code-review` → `/ultraqa`
+- **18 in-session skills** auto-discovered from `.github/skills/`
+- **Smart pipeline routing** — `/research-codebase` → `/ralplan` → `/team` / `/ralph` / `/ultrawork` → `/code-review` → `/ultraqa`
 
 ### Developer Experience
 
@@ -95,9 +99,9 @@ These run **inside a Copilot CLI session** after the plugin is installed.
 | `/ultrawork`            | Maximum parallelism                                       | `/ultrawork "fix all type errors"`                   |
 | `/ultraqa`              | QA cycling until goal met                                 | `/ultraqa "build green, tests pass"`                 |
 | `/ralplan`              | Consensus planning                                        | `/ralplan "plan this feature"`                       |
-| `/team`                 | Coordinated multi-agent task list                         | `/team 3:executor "ship the migration"`              |
+| `/team`                 | Parallel tmux agent panes                                 | `/team`                                              |
 | `/code-review`          | Diff-focused reviewer                                     | `/code-review`                                       |
-| `/codebase-research`    | Map an area of the codebase                               | `/codebase-research "auth middleware"`               |
+| `/research-codebase`    | Map an area of the codebase                               | `/research-codebase "auth middleware"`               |
 | `/debug`                | Disciplined diagnose-reproduce-fix loop                   | `/debug "flaky integration test"`                    |
 | `/tdd`                  | Red-green-refactor cycle                                  | `/tdd "add pagination to /users"`                    |
 | `/verify`               | Exercise a change end-to-end                              | `/verify`                                            |
@@ -107,6 +111,7 @@ These run **inside a Copilot CLI session** after the plugin is installed.
 | `/prototype`            | Throwaway prototype to flesh out a design                 | `/prototype "state shape"`                           |
 | `/grill-me`             | Stress-test a plan with Socratic questions                | `/grill-me`                                          |
 | `/caveman`              | Ultra-compressed communication mode                       | `/caveman`                                           |
+| `/worktree`             | Git worktree-based parallel branch work                   | `/worktree`                                          |
 
 ---
 
@@ -207,8 +212,17 @@ Skills follow the [Copilot agent-skills docs](https://docs.github.com/en/copilot
 ```bash
 npm install
 npm run build
-npm test                                       # 137 tests
+npm link                                       # makes `omp` point to your local checkout
+npm test
 npm run lint:skills
 npm run sync:dry-run
-npx tsx src/cli.ts skill install .github/skills/create-skill --dry-run
+```
+
+After `npm link`, the global `omp` command runs your local build. Any changes you make are reflected after `npm run build`.
+
+To unlink and revert to the published package:
+
+```bash
+npm unlink -g @damian87/omp
+npm i -g @damian87/omp
 ```

package/catalog/capabilities.json

@@ -13,15 +13,15 @@
   ],
   "capabilities": [
     {
-      "id": "codebase-research",
-      "name": "codebase-research",
+      "id": "research-codebase",
+      "name": "research-codebase",
       "title": "Codebase research",
       "category": "research",
-      "summary": "Read repo evidence before planning or asking.",
-      "notes": "Lite slash project skill; no bundled scripts or external runtime requirement.",
-      "defaultCommand": "codebase-research",
+      "summary": "Comprehensive codebase research with progressive disclosure and tiered effort.",
+      "notes": "Progressive disclosure skill with reference/ folder; scales effort to task complexity.",
+      "defaultCommand": "research-codebase",
       "phase1": true,
-      "sourceSkill": "codebase-research",
+      "sourceSkill": "research-codebase",
       "providers": {
         "copilot": "supported"
       },
@@ -31,7 +31,7 @@
       "providerSupport": {
         "copilot": {
           "state": "native",
-          "notes": "Use /codebase-research from .github/skills/codebase-research/SKILL.md."
+          "notes": "Use /research-codebase from .github/skills/research-codebase/SKILL.md."
         }
       }
     },
@@ -40,11 +40,11 @@
       "name": "research.codebase",
       "title": "Codebase research",
       "category": "research",
-      "summary": "Read repo evidence before planning or asking.",
-      "notes": "Lite slash project skill; no bundled scripts or external runtime requirement.",
-      "defaultCommand": "codebase-research",
+      "summary": "Comprehensive codebase research with progressive disclosure and tiered effort.",
+      "notes": "Alias for research-codebase capability.",
+      "defaultCommand": "research-codebase",
       "phase1": true,
-      "sourceSkill": "codebase-research",
+      "sourceSkill": "research-codebase",
       "providers": {
         "copilot": "supported"
       },
@@ -54,7 +54,7 @@
       "providerSupport": {
         "copilot": {
           "state": "native",
-          "notes": "Use /codebase-research from .github/skills/codebase-research/SKILL.md."
+          "notes": "Use /research-codebase from .github/skills/research-codebase/SKILL.md."
         }
       }
     },
@@ -724,6 +724,98 @@
           "notes": "Use /self-evolve from .github/skills/self-evolve/SKILL.md."
         }
       }
+    },
+    {
+      "id": "worktree",
+      "name": "worktree",
+      "title": "Worktree",
+      "category": "workflow",
+      "summary": "Git worktree-based parallel branch work.",
+      "notes": "Guides worktree setup for tickets and PR reviews.",
+      "defaultCommand": "worktree",
+      "phase1": true,
+      "sourceSkill": "worktree",
+      "providers": {
+        "copilot": "supported"
+      },
+      "support": {
+        "copilot": "native"
+      },
+      "providerSupport": {
+        "copilot": {
+          "state": "native",
+          "notes": "Use /worktree from .github/skills/worktree/SKILL.md."
+        }
+      }
+    },
+    {
+      "id": "workflow.worktree",
+      "name": "workflow.worktree",
+      "title": "Worktree workflow",
+      "category": "workflow",
+      "summary": "Git worktree-based parallel branch work.",
+      "notes": "Alias for worktree capability.",
+      "defaultCommand": "worktree",
+      "phase1": true,
+      "sourceSkill": "worktree",
+      "providers": {
+        "copilot": "supported"
+      },
+      "support": {
+        "copilot": "native"
+      },
+      "providerSupport": {
+        "copilot": {
+          "state": "native",
+          "notes": "Use /worktree from .github/skills/worktree/SKILL.md."
+        }
+      }
+    },
+    {
+      "id": "create-skill",
+      "name": "create-skill",
+      "title": "Skill authoring guide",
+      "category": "meta",
+      "summary": "Guide for creating effective skills following best practices.",
+      "notes": "Helps create or update skills that extend agent capabilities.",
+      "defaultCommand": "create-skill",
+      "phase1": true,
+      "sourceSkill": "create-skill",
+      "providers": {
+        "copilot": "supported"
+      },
+      "support": {
+        "copilot": "native"
+      },
+      "providerSupport": {
+        "copilot": {
+          "state": "native",
+          "notes": "Use /create-skill from .github/skills/create-skill/SKILL.md."
+        }
+      }
+    },
+    {
+      "id": "meta.skill-authoring",
+      "name": "meta.skill-authoring",
+      "title": "Skill authoring",
+      "category": "meta",
+      "summary": "Guide for creating effective skills.",
+      "notes": "Alias for create-skill capability.",
+      "defaultCommand": "create-skill",
+      "phase1": true,
+      "sourceSkill": "create-skill",
+      "providers": {
+        "copilot": "supported"
+      },
+      "support": {
+        "copilot": "native"
+      },
+      "providerSupport": {
+        "copilot": {
+          "state": "native",
+          "notes": "Use /create-skill from .github/skills/create-skill/SKILL.md."
+        }
+      }
     }
   ]
 }

package/catalog/skills-general.json

@@ -4,25 +4,25 @@
   "commandPrefix": "/",
   "skills": [
     {
-      "name": "codebase-research",
-      "capabilityId": "codebase-research",
+      "name": "research-codebase",
+      "capabilityId": "research-codebase",
       "capabilityIds": [
-        "codebase-research",
+        "research-codebase",
         "research.codebase"
       ],
-      "source": ".github/skills/codebase-research/SKILL.md",
-      "sourcePath": ".github/skills/codebase-research/SKILL.md",
-      "canonicalPath": ".github/skills/codebase-research/SKILL.md",
-      "description": "Read repo evidence before planning or asking.",
-      "summary": "Read repo evidence before planning or asking.",
+      "source": ".github/skills/research-codebase/SKILL.md",
+      "sourcePath": ".github/skills/research-codebase/SKILL.md",
+      "canonicalPath": ".github/skills/research-codebase/SKILL.md",
+      "description": "Comprehensive codebase research with progressive disclosure and tiered effort.",
+      "summary": "Comprehensive codebase research with progressive disclosure and tiered effort.",
       "support": "project-skill",
       "aliases": [],
       "slashCommands": [
-        "codebase-research"
+        "research-codebase"
       ],
       "projections": {
         "copilot": {
-          "command": "/codebase-research",
+          "command": "/research-codebase",
           "state": "supported"
         }
       },
@@ -422,6 +422,58 @@
       },
       "projection": "project-skill",
       "phase1": true
+    },
+    {
+      "name": "worktree",
+      "capabilityId": "worktree",
+      "capabilityIds": [
+        "worktree",
+        "workflow.worktree"
+      ],
+      "source": ".github/skills/worktree/SKILL.md",
+      "sourcePath": ".github/skills/worktree/SKILL.md",
+      "canonicalPath": ".github/skills/worktree/SKILL.md",
+      "description": "Git worktree-based parallel branch work.",
+      "summary": "Git worktree-based parallel branch work.",
+      "support": "project-skill",
+      "aliases": [],
+      "slashCommands": [
+        "worktree"
+      ],
+      "projections": {
+        "copilot": {
+          "command": "/worktree",
+          "state": "supported"
+        }
+      },
+      "projection": "project-skill",
+      "phase1": true
+    },
+    {
+      "name": "create-skill",
+      "capabilityId": "create-skill",
+      "capabilityIds": [
+        "create-skill",
+        "meta.skill-authoring"
+      ],
+      "source": ".github/skills/create-skill/SKILL.md",
+      "sourcePath": ".github/skills/create-skill/SKILL.md",
+      "canonicalPath": ".github/skills/create-skill/SKILL.md",
+      "description": "Guide for creating effective skills following best practices.",
+      "summary": "Guide for creating effective skills following best practices.",
+      "support": "project-skill",
+      "aliases": [],
+      "slashCommands": [
+        "create-skill"
+      ],
+      "projections": {
+        "copilot": {
+          "command": "/create-skill",
+          "state": "supported"
+        }
+      },
+      "projection": "project-skill",
+      "phase1": true
     }
   ]
 }

package/dist/src/copilot/launch.js

@@ -1,4 +1,4 @@
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 const MADMAX_FLAG = "--madmax";
 const COPILOT_BYPASS_FLAG = "--yolo";
 export function normalizeCopilotLaunchArgs(args) {
@@ -36,14 +36,49 @@ export function resolveCopilotBin(override) {
         return fromEnv;
     return "copilot";
 }
+function isInsideTmux() {
+    return !!process.env.TMUX;
+}
+function tmuxAvailable() {
+    const r = spawnSync("tmux", ["-V"], { encoding: "utf8", timeout: 3000 });
+    return r.status === 0;
+}
 export async function launchCopilot(options) {
     const bin = resolveCopilotBin(options.bin);
     const args = normalizeCopilotLaunchArgs(options.args);
+    const cwd = options.cwd ?? process.cwd();
+    // If not already inside tmux and tmux is available, wrap in a tmux session
+    if (!isInsideTmux() && tmuxAvailable()) {
+        const sessionName = `omp-${Date.now()}`;
+        const copilotCmd = [bin, ...args].map(shellEscape).join(" ");
+        return new Promise((resolveFn) => {
+            let settled = false;
+            const child = spawn("tmux", ["new-session", "-s", sessionName, "-c", cwd, copilotCmd], {
+                stdio: "inherit",
+                cwd,
+                env: options.env ?? process.env,
+            });
+            child.on("error", () => {
+                if (settled)
+                    return;
+                settled = true;
+                resolveFn({ ok: false, exitCode: 127, bin });
+            });
+            child.on("close", (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                const exitCode = typeof code === "number" ? code : 1;
+                resolveFn({ ok: exitCode === 0, exitCode, bin });
+            });
+        });
+    }
+    // Already inside tmux or tmux not available — launch directly
     return new Promise((resolveFn) => {
         let settled = false;
         const child = spawn(bin, args, {
             stdio: "inherit",
-            cwd: options.cwd ?? process.cwd(),
+            cwd,
             env: options.env ?? process.env,
         });
         child.on("error", () => {
@@ -61,4 +96,9 @@ export async function launchCopilot(options) {
         });
     });
 }
+function shellEscape(s) {
+    if (/^[a-zA-Z0-9_./:=-]+$/.test(s))
+        return s;
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
 //# sourceMappingURL=launch.js.map

package/dist/src/copilot/launch.js.map

@@ -1 +1 @@
-{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/copilot/launch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../src/copilot/launch.ts"],"names":[],"mappings":"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"}

package/docs/general-skills.md

@@ -6,14 +6,14 @@ The canonical skill source is the repo-local `.github/skills` directory. This is
 
 | Skill | Capability IDs | Purpose |
 | --- | --- | --- |
-| `/codebase-research` | `codebase-research`, `research.codebase` | Read repo evidence before planning or asking. |
+| `/research-codebase` | `research-codebase`, `research.codebase` | Comprehensive codebase research with tiered effort. |
 | `/grill-me` | `grill-me`, `planning.challenge` | Ask one sharp clarification question when ambiguity remains. |
 | `/ralplan` | `ralplan`, `planning.consensus` | Produce implementation-ready plan, tests, and risks. |
-| `/team` | `team`, `execution.parallel` | Split approved work into parallel lanes. |
+| `/team` | `team`, `execution.parallel` | Split approved work into parallel tmux panes running interactive agents. |
 | `/ralph` | `ralph`, `execution.single-owner` | Single-owner execute-fix-verify loop. |
 | `/ultrawork` | `ultrawork`, `execution.parallel` | Batch many independent small tasks. |
 | `/ultraqa` | `ultraqa`, `qa.behavioral` | Adversarial behavior and regression QA. |
-| `/omc-autopilot` | `omc-autopilot`, `execution.autonomous` | Lightweight end-to-end flow across the other skills. (Renamed from `/autopilot` to avoid Copilot CLI built-in collision.) |
+| `/omp-autopilot` | `omp-autopilot`, `execution.autonomous` | Lightweight end-to-end flow across the other skills. (Renamed from `/autopilot` to avoid Copilot CLI built-in collision.) |
 | `/code-review` | `code-review`, `review.independent` | Review completed changes before merge or handoff. |
 | `/verify` | `verify`, `verification.evidence` | Prove completion claims with evidence. |
 | `/jira-ticket` | `jira-ticket`, `tracker.ticket` | Render Jira create/comment/safe-update payloads. |
@@ -21,6 +21,7 @@ The canonical skill source is the repo-local `.github/skills` directory. This is
 | `/caveman` | `caveman`, `communication.compact` | Ultra-compact response mode. |
 | `/debug` | `debug`, `debug.systematic` | Reproduce, diagnose, fix, and regression-test bugs. |
 | `/tdd` | `tdd`, `testing.tdd` | Red-green-refactor for behavior changes. |
+| `/worktree` | `worktree`, `workflow.worktree` | Git worktree-based parallel branch work. |
 
 ## Repo-local layout
 
@@ -52,7 +53,7 @@ It does not imply a durable execution runtime. Phase 1 execution skills such as
 ## Phase 1 flow
 
 ```text
-/codebase-research
+/research-codebase
   -> /grill-me when unclear or risky
   -> /ralplan
   -> /team if lanes are independent, otherwise /ralph or /ultrawork

package/docs/self-evolve.md

@@ -2,7 +2,7 @@
 
 A two-file mechanism that turns repeated user corrections into draft project skills.
 
-- `AGENTS.md` instructs the agent to invoke `/self-evolve` before ending a session.
+- `.github/copilot-instructions.md` ships with the plugin and instructs the agent to invoke `/self-evolve` before ending a session — so the trigger fires in every project where the plugin is active, not only inside this repo.
 - `.github/skills/self-evolve/SKILL.md` is the loop itself: log corrections to `.oh-my-copilot/self-evolve/log.md`, count repeats per topic, and when a topic recurs three times draft `.oh-my-copilot/self-evolve/drafts/<slug>/SKILL.md` with `status: draft`.
 
 ## Why drafts live outside `.github/skills/`
@@ -19,4 +19,4 @@ Move the draft directory from `.oh-my-copilot/self-evolve/drafts/<slug>/` to `.g
 
 ## Why agent-driven, not a CLI
 
-Copilot CLI exposes no user-installable hook surface. The cheapest reliable trigger is the agent itself: `AGENTS.md` is loaded into every session, and the instruction there ensures `/self-evolve` runs at wrap-up without any binary, dependency, or shell modification.
+Copilot CLI exposes no user-installable hook surface. The cheapest reliable trigger is the agent itself: `.github/copilot-instructions.md` is loaded into every session where the plugin is active, and the instruction there ensures `/self-evolve` runs at wrap-up without any binary, dependency, or shell modification.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damian87/omp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "GitHub Copilot project skills catalog and Jira handoff tools.",
   "type": "module",
   "publishConfig": {

package/scripts/lib/version-check.mjs

@@ -0,0 +1,82 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const CACHE_TTL_MS = 6 * 60 * 60 * 1000;
+const FETCH_TIMEOUT_MS = 2000;
+const PACKAGE_NAME = "@damian87/omp";
+
+export function isNewer(latest, current) {
+  if (!latest || !current) return false;
+  const [a = 0, b = 0, c = 0] = String(latest).split(".").map((n) => Number.parseInt(n, 10));
+  const [x = 0, y = 0, z = 0] = String(current).split(".").map((n) => Number.parseInt(n, 10));
+  if ([a, b, c, x, y, z].some(Number.isNaN)) return false;
+  if (a !== x) return a > x;
+  if (b !== y) return b > y;
+  return c > z;
+}
+
+export function formatUpdateNotice(current, latest) {
+  return `[OMP UPDATE AVAILABLE]\n\nA new version of ${PACKAGE_NAME} is available: v${latest} (current: v${current})\nTo update, run: npm i -g ${PACKAGE_NAME}@latest`;
+}
+
+export function readCurrentVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = join(here, "..", "..", "package.json");
+    return JSON.parse(readFileSync(pkgPath, "utf8")).version ?? null;
+  } catch {
+    return null;
+  }
+}
+
+async function fetchLatestVersion() {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: controller.signal,
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return typeof data?.version === "string" ? data.version : null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export async function checkForUpdate({ stateDir, now = Date.now(), fetchLatest = fetchLatestVersion } = {}) {
+  const current = readCurrentVersion();
+  if (!current || !stateDir) return null;
+
+  const cachePath = join(stateDir, "version-check.json");
+  let latest = null;
+
+  if (existsSync(cachePath)) {
+    try {
+      const cache = JSON.parse(readFileSync(cachePath, "utf8"));
+      if (cache?.checkedAt && now - cache.checkedAt < CACHE_TTL_MS && typeof cache.latest === "string") {
+        latest = cache.latest;
+      }
+    } catch {
+      // ignore corrupt cache
+    }
+  }
+
+  if (!latest) {
+    latest = await fetchLatest();
+    if (latest) {
+      try {
+        mkdirSync(stateDir, { recursive: true });
+        writeFileSync(cachePath, JSON.stringify({ checkedAt: now, latest }));
+      } catch {
+        // best-effort cache write
+      }
+    }
+  }
+
+  if (!latest || !isNewer(latest, current)) return null;
+  return { current, latest };
+}

package/scripts/session-start.mjs

@@ -2,6 +2,7 @@
 import { appendFileSync, mkdirSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { readStdin } from "./lib/stdin.mjs";
+import { checkForUpdate, formatUpdateNotice } from "./lib/version-check.mjs";
 
 const HOOK_NAME = "SessionStart";
 
@@ -11,7 +12,8 @@ const HOOK_NAME = "SessionStart";
     const data = raw ? JSON.parse(raw) : {};
     const sessionId = data.sessionId ?? data.session_id ?? "unknown";
     const directory = data.directory ?? process.cwd();
-    const logFile = join(directory, ".omp", "state", "hooks.log");
+    const stateDir = join(directory, ".omp", "state");
+    const logFile = join(stateDir, "hooks.log");
     mkdirSync(dirname(logFile), { recursive: true });
     const line = JSON.stringify({
       ts: new Date().toISOString(),
@@ -20,10 +22,14 @@ const HOOK_NAME = "SessionStart";
       directory,
     });
     appendFileSync(logFile, `${line}\n`);
+
+    const update = await checkForUpdate({ stateDir });
+    const additionalContext = update ? formatUpdateNotice(update.current, update.latest) : "";
+
     console.log(
       JSON.stringify({
         continue: true,
-        hookSpecificOutput: { hookEventName: HOOK_NAME, additionalContext: "" },
+        hookSpecificOutput: { hookEventName: HOOK_NAME, additionalContext },
       }),
     );
   } catch (err) {

package/.github/skills/codebase-research/SKILL.md

@@ -1,20 +0,0 @@
----
-name: codebase-research
-description: Read the repo first, map evidence, and return the smallest useful implementation context. Use with /codebase-research before planning or asking when repo facts matter.
----
-
-# Codebase Research
-
-Use `/codebase-research` before planning or asking when repo facts matter.
-
-Do:
-- Find relevant files, symbols, tests, docs, and existing patterns.
-- Separate evidence from inference.
-- Name the likely change surface and risks.
-- Ask nothing if the repo can answer it.
-
-Output:
-- `Evidence` — file paths and facts.
-- `Likely path` — what should change.
-- `Unknowns` — blockers only.
-- `Next skill` — usually `/grill-me`, `/ralplan`, `/debug`, or `/tdd`.