@damian87/omp 0.1.0

package/docs/self-evolve.md

@@ -0,0 +1,22 @@
+# Self-evolve loop
+
+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/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/`
+
+`plugin.json` exposes `.github/skills/` as the active plugin skill root, so anything placed there is auto-loaded as a usable slash command on the next Copilot session. Drafts are written by an LLM from inferred mistake patterns and may misfire; auto-loading them before human review would let a malicious "correction" smuggle in a hostile instruction. Drafts land in `.oh-my-copilot/self-evolve/drafts/` instead — a path Copilot CLI never reads.
+
+## Promoting a draft
+
+Move the draft directory from `.oh-my-copilot/self-evolve/drafts/<slug>/` to `.github/skills/learned-<slug>/`. The frontmatter `name` already matches the new directory name (set to `learned-<slug>` at draft time). Optionally delete the `status: draft` line; the project lint does not require it. On the next Copilot session the skill is loaded as `/learned-<slug>`.
+
+## Pruning
+
+`.oh-my-copilot/self-evolve/log.md` is the source of truth and is committed. Delete or edit lines to reset the counter for a given topic.
+
+## 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.

package/hooks/hooks.json

@@ -0,0 +1,74 @@
+{
+  "SessionStart": [
+    {
+      "matcher": "*",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${OMP_PLUGIN_ROOT:-$OMC_PLUGIN_ROOT}\"/scripts/session-start.mjs",
+          "timeout": 5
+        }
+      ]
+    }
+  ],
+  "UserPromptSubmit": [
+    {
+      "matcher": "*",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${OMP_PLUGIN_ROOT:-$OMC_PLUGIN_ROOT}\"/scripts/prompt-submit.mjs",
+          "timeout": 5
+        }
+      ]
+    }
+  ],
+  "PreToolUse": [
+    {
+      "matcher": "*",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${OMP_PLUGIN_ROOT:-$OMC_PLUGIN_ROOT}\"/scripts/pre-tool-use.mjs",
+          "timeout": 5
+        }
+      ]
+    }
+  ],
+  "PostToolUse": [
+    {
+      "matcher": "*",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${OMP_PLUGIN_ROOT:-$OMC_PLUGIN_ROOT}\"/scripts/post-tool-use.mjs",
+          "timeout": 5
+        }
+      ]
+    }
+  ],
+  "SessionEnd": [
+    {
+      "matcher": "*",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${OMP_PLUGIN_ROOT:-$OMC_PLUGIN_ROOT}\"/scripts/session-end.mjs",
+          "timeout": 5
+        }
+      ]
+    }
+  ],
+  "Error": [
+    {
+      "matcher": "*",
+      "hooks": [
+        {
+          "type": "command",
+          "command": "node \"${OMP_PLUGIN_ROOT:-$OMC_PLUGIN_ROOT}\"/scripts/error.mjs",
+          "timeout": 5
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@damian87/omp",
+  "version": "0.1.0",
+  "description": "GitHub Copilot project skills catalog and Jira handoff tools.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "oh-my-copilot": "dist/src/cli.js",
+    "omp": "dist/src/cli.js",
+    "omcc": "dist/src/cli.js"
+  },
+  "files": [
+    ".github",
+    "LICENSE",
+    "README.md",
+    "catalog",
+    "dist",
+    "docs",
+    "hooks",
+    "plugin.json",
+    "scripts"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check:catalog": "npm run build && node dist/src/cli.js catalog validate",
+    "catalog:list": "npm run build && node dist/src/cli.js catalog list",
+    "project:inspect": "npm run build && node dist/src/cli.js project inspect",
+    "test": "vitest run",
+    "lint:skills": "npm run build && node dist/src/cli.js lint:skills --root .",
+    "sync:dry-run": "npm run build && node dist/src/cli.js sync:dry-run --root .",
+    "jira:dry-run": "npm run build && node dist/src/cli.js jira:dry-run --root .",
+    "omp:version": "npm run build && node dist/src/cli.js version",
+    "omp:list": "npm run build && node dist/src/cli.js list",
+    "omp:setup:dry-run": "npm run build && node dist/src/cli.js setup --dry-run",
+    "omp:doctor": "npm run build && node dist/src/cli.js doctor --skip-copilot"
+  },
+  "keywords": [
+    "copilot",
+    "skills",
+    "agents",
+    "slash-commands"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
+    "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+}

package/plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "oh-my-copilot",
+  "description": "Lite slash-skill workflows for GitHub Copilot.",
+  "version": "0.1.0",
+  "author": { "name": "Damian Borek", "email": "borekdamian@yahoo.pl" },
+  "license": "MIT",
+  "repository": "https://github.com/damian87x/oh-my-copilot",
+  "keywords": ["copilot", "skills", "agents", "slash-commands"],
+  "skills": ".github/skills/",
+  "agents": ".github/agents/",
+  "instructions": ".github/copilot-instructions.md",
+  "hooks": "hooks/hooks.json",
+  "scriptsDir": "scripts/"
+}

package/scripts/error.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readStdin } from "./lib/stdin.mjs";
+
+const HOOK_NAME = "Error";
+
+(async () => {
+  try {
+    const raw = await readStdin();
+    const data = raw ? JSON.parse(raw) : {};
+    const sessionId = data.sessionId ?? data.session_id ?? "unknown";
+    const directory = data.directory ?? process.cwd();
+    const toolName = data.toolName ?? data.tool_name ?? "unknown";
+    const errorMessage = data.error?.message ?? data.message ?? "unknown";
+    const logFile = join(directory, ".omp", "state", "hooks.log");
+    try {
+      mkdirSync(dirname(logFile), { recursive: true });
+      appendFileSync(
+        logFile,
+        `${JSON.stringify({ ts: new Date().toISOString(), hook: HOOK_NAME, sessionId, toolName, errorMessage })}\n`,
+      );
+    } catch {
+      // best effort
+    }
+    console.log(JSON.stringify({ continue: true }));
+  } catch (err) {
+    console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);
+    console.log(JSON.stringify({ continue: true }));
+  }
+})();

package/scripts/lib/hook-output.mjs

@@ -0,0 +1,30 @@
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+
+export function printContinue(hookEventName, additionalContext = "") {
+  const output = additionalContext
+    ? { continue: true, hookSpecificOutput: { hookEventName, additionalContext } }
+    : { continue: true };
+  console.log(JSON.stringify(output));
+}
+
+export function printBlock(reason) {
+  console.log(JSON.stringify({ continue: false, reason }));
+}
+
+export function failOpen() {
+  console.log(JSON.stringify({ continue: true }));
+}
+
+export function appendHookLog(directory, hookName, payload) {
+  const logFile = join(directory, ".omp", "state", "hooks.log");
+  try {
+    mkdirSync(dirname(logFile), { recursive: true });
+    appendFileSync(
+      logFile,
+      `${JSON.stringify({ ts: new Date().toISOString(), hook: hookName, ...payload })}\n`,
+    );
+  } catch {
+    // best effort
+  }
+}

package/scripts/lib/stdin.mjs

@@ -0,0 +1,29 @@
+const DEFAULT_MAX_BYTES = 10 * 1024 * 1024; // 10 MB sanity cap
+
+export function readStdin(maxBytes = DEFAULT_MAX_BYTES) {
+  return new Promise((resolve) => {
+    if (process.stdin.isTTY) {
+      resolve("");
+      return;
+    }
+    let buf = "";
+    let truncated = false;
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk) => {
+      if (truncated) return;
+      buf += chunk;
+      if (buf.length > maxBytes) {
+        truncated = true;
+        buf = buf.slice(0, maxBytes);
+        try { process.stdin.pause(); } catch { /* best effort */ }
+        resolve(buf);
+      }
+    });
+    process.stdin.on("end", () => {
+      if (!truncated) resolve(buf);
+    });
+    process.stdin.on("error", () => {
+      if (!truncated) resolve(buf);
+    });
+  });
+}

package/scripts/post-tool-use.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readStdin } from "./lib/stdin.mjs";
+
+const HOOK_NAME = "PostToolUse";
+
+(async () => {
+  try {
+    const raw = await readStdin();
+    const data = raw ? JSON.parse(raw) : {};
+    const sessionId = data.sessionId ?? data.session_id ?? "unknown";
+    const directory = data.directory ?? process.cwd();
+    const toolName = data.toolName ?? data.tool_name ?? "unknown";
+    const ok = data.toolOutput != null;
+    const logFile = join(directory, ".omp", "state", "hooks.log");
+    try {
+      mkdirSync(dirname(logFile), { recursive: true });
+      appendFileSync(
+        logFile,
+        `${JSON.stringify({ ts: new Date().toISOString(), hook: HOOK_NAME, sessionId, toolName, ok })}\n`,
+      );
+    } catch {
+      // best effort
+    }
+    console.log(JSON.stringify({ continue: true }));
+  } catch (err) {
+    console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);
+    console.log(JSON.stringify({ continue: true }));
+  }
+})();

package/scripts/pre-tool-use.mjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readStdin } from "./lib/stdin.mjs";
+
+const HOOK_NAME = "PreToolUse";
+
+(async () => {
+  try {
+    const raw = await readStdin();
+    const data = raw ? JSON.parse(raw) : {};
+    const sessionId = data.sessionId ?? data.session_id ?? "unknown";
+    const directory = data.directory ?? process.cwd();
+    const toolName = data.toolName ?? data.tool_name ?? "unknown";
+    const logFile = join(directory, ".omp", "state", "hooks.log");
+    try {
+      mkdirSync(dirname(logFile), { recursive: true });
+      appendFileSync(
+        logFile,
+        `${JSON.stringify({ ts: new Date().toISOString(), hook: HOOK_NAME, sessionId, toolName })}\n`,
+      );
+    } catch {
+      // best effort
+    }
+    console.log(JSON.stringify({ continue: true }));
+  } catch (err) {
+    console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);
+    console.log(JSON.stringify({ continue: true }));
+  }
+})();

package/scripts/prompt-submit.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readStdin } from "./lib/stdin.mjs";
+
+const HOOK_NAME = "UserPromptSubmit";
+
+function readModeState(directory, mode) {
+  const p = join(directory, ".omp", "state", `${mode}.json`);
+  if (!existsSync(p)) return undefined;
+  try {
+    return JSON.parse(readFileSync(p, "utf8"));
+  } catch {
+    return undefined;
+  }
+}
+
+function buildContinuationContext(directory) {
+  const ralph = readModeState(directory, "ralph");
+  const ultrawork = readModeState(directory, "ultrawork");
+  const ultraqa = readModeState(directory, "ultraqa");
+  const parts = [];
+  if (ralph?.active)
+    parts.push(
+      `[RALPH ACTIVE: iteration ${ralph.iteration}/${ralph.maxIterations}]\nPrompt: ${ralph.prompt}\nContinue the loop. Report concrete progress.`,
+    );
+  if (ultrawork?.active)
+    parts.push(`[ULTRAWORK ACTIVE]\nObjective: ${ultrawork.objective}\nSustain the objective. Batch parallel tasks.`);
+  if (ultraqa?.active)
+    parts.push(
+      `[ULTRAQA ACTIVE: cycle ${ultraqa.cycleCount}/${ultraqa.maxCycles}]\nGoal: ${ultraqa.goal}\nRun tests → verify → fix. Iterate.`,
+    );
+  return parts.join("\n\n---\n\n");
+}
+
+function appendLog(directory, payload) {
+  const logFile = join(directory, ".omp", "state", "hooks.log");
+  try {
+    mkdirSync(dirname(logFile), { recursive: true });
+    appendFileSync(
+      logFile,
+      `${JSON.stringify({ ts: new Date().toISOString(), hook: HOOK_NAME, ...payload })}\n`,
+    );
+  } catch {
+    // best effort
+  }
+}
+
+(async () => {
+  try {
+    const raw = await readStdin();
+    const data = raw ? JSON.parse(raw) : {};
+    const sessionId = data.sessionId ?? data.session_id ?? "unknown";
+    const directory = data.directory ?? process.cwd();
+    const prompt = data.prompt ?? data.message?.content ?? "";
+    appendLog(directory, { sessionId, promptBytes: String(prompt).length });
+    const additionalContext = buildContinuationContext(directory);
+    const output = additionalContext
+      ? { continue: true, hookSpecificOutput: { hookEventName: HOOK_NAME, additionalContext } }
+      : { continue: true };
+    console.log(JSON.stringify(output));
+  } catch (err) {
+    console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);
+    console.log(JSON.stringify({ continue: true }));
+  }
+})();

package/scripts/session-end.mjs

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readStdin } from "./lib/stdin.mjs";
+
+const HOOK_NAME = "SessionEnd";
+
+(async () => {
+  try {
+    const raw = await readStdin();
+    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");
+    try {
+      mkdirSync(dirname(logFile), { recursive: true });
+      appendFileSync(
+        logFile,
+        `${JSON.stringify({ ts: new Date().toISOString(), hook: HOOK_NAME, sessionId, directory })}\n`,
+      );
+    } catch {
+      // best effort
+    }
+    console.log(JSON.stringify({ continue: true }));
+  } catch (err) {
+    console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);
+    console.log(JSON.stringify({ continue: true }));
+  }
+})();

package/scripts/session-start.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { appendFileSync, mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { readStdin } from "./lib/stdin.mjs";
+
+const HOOK_NAME = "SessionStart";
+
+(async () => {
+  try {
+    const raw = await readStdin();
+    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");
+    mkdirSync(dirname(logFile), { recursive: true });
+    const line = JSON.stringify({
+      ts: new Date().toISOString(),
+      hook: HOOK_NAME,
+      sessionId,
+      directory,
+    });
+    appendFileSync(logFile, `${line}\n`);
+    console.log(
+      JSON.stringify({
+        continue: true,
+        hookSpecificOutput: { hookEventName: HOOK_NAME, additionalContext: "" },
+      }),
+    );
+  } catch (err) {
+    console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);
+    console.log(JSON.stringify({ continue: true }));
+  }
+})();