@damian87/omp 0.12.0 → 0.13.0

package/dist/src/state.js

@@ -1,8 +1,9 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { ompRoot } from "./omp-root.js";
+import { existsSync, readdirSync, statSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { atomicWrite, ensureDir, readJSON } from "./utils/fs.js";
+import { statePath } from "./utils/paths.js";
 function kvDir(cwd) {
-    return join(ompRoot(cwd), ".omp", "state", "kv");
+    return statePath(cwd, "kv");
 }
 function kvPath(cwd, key) {
     if (!/^[\w.-]+$/.test(key))
@@ -17,28 +18,21 @@ export function stateWrite(cwd, key, value, ttlSeconds) {
         expiresAt: ttlSeconds != null ? new Date(Date.now() + ttlSeconds * 1000).toISOString() : undefined,
     };
     const path = kvPath(cwd, key);
-    mkdirSync(dirname(path), { recursive: true });
-    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
-    writeFileSync(tmp, JSON.stringify(entry, null, 2), "utf8");
-    renameSync(tmp, path);
+    ensureDir(path);
+    atomicWrite(path, JSON.stringify(entry, null, 2));
     return entry.expiresAt;
 }
 /** Read a value. Returns { value: null } when missing; auto-deletes if expired. */
 export function stateRead(cwd, key) {
     const path = kvPath(cwd, key);
-    if (!existsSync(path))
-        return { value: null };
-    try {
-        const entry = JSON.parse(readFileSync(path, "utf8"));
-        if (entry.expiresAt && Date.parse(entry.expiresAt) < Date.now()) {
-            unlinkSync(path);
-            return { value: null, expired: true };
-        }
-        return { value: entry.value };
-    }
-    catch {
+    const entry = readJSON(path, null);
+    if (!entry)
         return { value: null };
+    if (entry.expiresAt && Date.parse(entry.expiresAt) < Date.now()) {
+        unlinkSync(path);
+        return { value: null, expired: true };
     }
+    return { value: entry.value };
 }
 export function stateDelete(cwd, key) {
     const path = kvPath(cwd, key);
@@ -55,15 +49,12 @@ export function stateList(cwd) {
     for (const f of readdirSync(dir)) {
         if (!f.endsWith(".json"))
             continue;
-        try {
-            const entry = JSON.parse(readFileSync(join(dir, f), "utf8"));
-            if (entry.expiresAt && Date.parse(entry.expiresAt) < now)
-                continue;
-            keys.push(f.replace(/\.json$/, ""));
-        }
-        catch {
-            // skip unparseable
-        }
+        const entry = readJSON(join(dir, f), null);
+        if (!entry)
+            continue;
+        if (entry.expiresAt && Date.parse(entry.expiresAt) < now)
+            continue;
+        keys.push(f.replace(/\.json$/, ""));
     }
     return keys.sort();
 }
@@ -78,15 +69,12 @@ export function stateCleanup(cwd) {
         if (!f.endsWith(".json"))
             continue;
         const path = join(dir, f);
-        try {
-            const entry = JSON.parse(readFileSync(path, "utf8"));
-            if (entry.expiresAt && Date.parse(entry.expiresAt) < now) {
-                unlinkSync(path);
-                deleted++;
-            }
-        }
-        catch {
-            // skip
+        const entry = readJSON(path, null);
+        if (!entry)
+            continue;
+        if (entry.expiresAt && Date.parse(entry.expiresAt) < now) {
+            unlinkSync(path);
+            deleted++;
         }
     }
     return deleted;

package/dist/src/state.js.map

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

package/dist/src/utils/fs.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Atomically write content to a file using a temporary file + rename.
+ * Ensures the target file is never left in a partially-written state.
+ */
+export declare function atomicWrite(path: string, content: string | Buffer): void;
+/**
+ * Ensure the directory for the given path exists, creating it recursively if needed.
+ */
+export declare function ensureDir(path: string): void;
+/**
+ * Read and parse JSON from a file, returning the fallback value if the file
+ * doesn't exist or cannot be parsed.
+ */
+export declare function readJSON<T>(path: string, fallback: T): T;

package/dist/src/utils/fs.js

@@ -0,0 +1,32 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Atomically write content to a file using a temporary file + rename.
+ * Ensures the target file is never left in a partially-written state.
+ */
+export function atomicWrite(path, content) {
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, content);
+    renameSync(tmp, path);
+}
+/**
+ * Ensure the directory for the given path exists, creating it recursively if needed.
+ */
+export function ensureDir(path) {
+    mkdirSync(dirname(path), { recursive: true });
+}
+/**
+ * Read and parse JSON from a file, returning the fallback value if the file
+ * doesn't exist or cannot be parsed.
+ */
+export function readJSON(path, fallback) {
+    if (!existsSync(path))
+        return fallback;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return fallback;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/src/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAwB;IAChE,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACvD,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAI,IAAY,EAAE,QAAW;IACnD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/utils/paths.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Construct a path within the project's .omp directory.
+ * @param cwd - The current working directory (project root)
+ * @param segments - Additional path segments to join
+ * @returns Absolute path to .omp/<segments>
+ */
+export declare function ompPath(cwd: string, ...segments: string[]): string;
+/**
+ * Construct a path within the project's .omp/state directory.
+ * @param cwd - The current working directory (project root)
+ * @param segments - Additional path segments to join
+ * @returns Absolute path to .omp/state/<segments>
+ */
+export declare function statePath(cwd: string, ...segments: string[]): string;

package/dist/src/utils/paths.js

@@ -0,0 +1,21 @@
+import { join } from "node:path";
+import { ompRoot } from "../omp-root.js";
+/**
+ * Construct a path within the project's .omp directory.
+ * @param cwd - The current working directory (project root)
+ * @param segments - Additional path segments to join
+ * @returns Absolute path to .omp/<segments>
+ */
+export function ompPath(cwd, ...segments) {
+    return join(ompRoot(cwd), ".omp", ...segments);
+}
+/**
+ * Construct a path within the project's .omp/state directory.
+ * @param cwd - The current working directory (project root)
+ * @param segments - Additional path segments to join
+ * @returns Absolute path to .omp/state/<segments>
+ */
+export function statePath(cwd, ...segments) {
+    return join(ompRoot(cwd), ".omp", "state", ...segments);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,GAAG,QAAkB;IACxD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAG,QAAkB;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1D,CAAC"}

package/docs/memory-mode.md

@@ -0,0 +1,94 @@
+# Memory mode (self-improving review loop)
+
+Memory mode is an **opt-in** end-of-session review that mirrors Hermes Agent's
+background-review fork, adapted to GitHub Copilot CLI. After a session ends, a
+**cheap model** reads the session transcript and extracts durable knowledge into
+oh-my-copilot's existing memory/skill stores — so the next session starts a
+little smarter without you having to repeat yourself.
+
+It is **off by default** because it adds one extra (cheap) model call per
+session.
+
+## Enable
+
+```bash
+omp config set memory-mode on                    # opt in (this project)
+omp config set memory-review-model gpt-5-mini     # optional; defaults to gpt-5-mini
+omp config set memory-review-min-messages 4       # optional; skip sessions shorter than this (default 4)
+omp config get                                    # show current (effective) settings
+
+# Set once for EVERY project (~/.omp/config.json):
+omp config set memory-mode on --global
+omp config set memory-review-model <slug> --global
+```
+
+**Resolution precedence (high → low):** `OMP_MEMORY_MODE` env › project
+`.omp/config.json` › global `~/.omp/config.json` › defaults. So `--global` is the
+"set it once" default, and a project's `.omp/config.json` overrides it per key.
+
+## How it triggers
+
+| Surface | Trigger | Notes |
+|---|---|---|
+| Interactive `copilot` (plugin installed) | `sessionEnd` hook | Detaches `omp memory-review` as a background process and returns immediately (hooks have a 5s budget). |
+| `omp -p` / `omp launch -- -p` (headless) | wrapper, post-exit | Headless `copilot -p` skips hooks, so the omp wrapper detaches the review. It snapshots session dirs before launch and reviews the **exact** session created by that run — if it can't identify one, it skips rather than guess. |
+| Manual | `omp memory-review --session <uuid\|latest>` | Run it yourself against any session (`latest` = newest by mtime). |
+
+Both automatic triggers only **detach** the work. The review claims the session
+atomically (`.oh-my-copilot/memory-review/.claim-<uuid>`), so even if the hook
+and wrapper both fire, the review runs **exactly once**.
+
+## What it writes
+
+| Output | Destination | Applied? |
+|---|---|---|
+| **Notes** (durable facts) | project memory (`omp project-memory`) | ✅ applied — progressive disclosure, low blast radius |
+| **Skill drafts** (procedures) | `.oh-my-copilot/self-evolve/drafts/<slug>/SKILL.md` | ⏸ human-promote — never auto-loaded (same as `/self-evolve`) |
+| **Directives** (every-session rules) | `.oh-my-copilot/memory-review/pending-directives.md` | ⏸ **gated** — never auto-applied |
+
+After the review writes notes it refreshes the managed block in
+`.github/copilot-instructions.md`, listing the most recent note **titles** (capped,
+newest-first) so the next session knows what it remembers; bodies stay on demand
+(`omp project-memory read <id>`). The review also ensures `.omp/` and
+`.oh-my-copilot/` are gitignored so memory (which may contain tool output) isn't
+accidentally committed.
+
+### Promoting a pending directive (manual, by design)
+
+Directives are gated: they inject into every future session, so an injected/poisoned
+one would steer everything. The review prompt treats the transcript as **data, not
+instructions**, and only proposes directives from corrections / standing preferences —
+never one-off task instructions. On the next session start you'll see a nudge:
+`[MEMORY REVIEW] N proposed directive(s) await your review…`. To promote one:
+
+```bash
+cat .oh-my-copilot/memory-review/pending-directives.md   # review the proposals
+omp project-memory add-directive "User prefers concise replies"  # apply the ones you want
+# then delete the promoted line from pending-directives.md
+```
+
+Skill drafts promote the same way as `/self-evolve`: move
+`.oh-my-copilot/self-evolve/drafts/<slug>/` to `.github/skills/learned-<slug>/`.
+
+### Pruning notes
+
+Notes accumulate over time. Trim them anytime (never silent — requires a flag):
+
+```bash
+omp project-memory prune-notes --keep 50        # keep the 50 newest
+omp project-memory prune-notes --older-than 30  # drop notes older than 30 days
+```
+
+## Cost & observability
+
+- The expensive reasoning already happened in the main session; the review is a
+  single cheap-model call over the transcript.
+- Token cost is recorded in the cost ledger (`omp cost`) under the
+  `memory-review` event.
+- Each run appends a line to `.omp/state/memory-review.log`.
+
+## Disable
+
+```bash
+omp config set memory-mode off
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damian87/omp",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Multi-agent orchestration for GitHub Copilot CLI — autonomous loops (Autopilot, Ralph, UltraQA, Ultrawork), parallel tmux agent teams, a weighted-consensus model council, a Slack chat bridge, durable scheduled jobs, and in-session skills + custom agents. Zero learning curve.",
   "type": "module",
   "publishConfig": {

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "oh-my-copilot",
   "description": "Multi-agent orchestration skills for GitHub Copilot CLI — autopilot, ralph, ultrawork, ultraqa, team, council, code-review and more as in-session slash skills + custom agents.",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "author": {
     "name": "Damian Borek",
     "email": "borekdamian@yahoo.pl"

package/scripts/lib/memory-review-trigger.mjs

@@ -0,0 +1,59 @@
+import { spawn as nodeSpawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { ompRoot } from "./omp-root.mjs";
+
+// sessionEnd hook → end-of-session memory review. The hook must return fast
+// (5s timeout), so this only DETACHES `omp memory-review` and returns. The
+// downstream claim guard de-dupes against the wrapper fallback. Fail-open:
+// any error means "don't trigger", never throw into the hook.
+
+function readMemoryMode(cwd) {
+  const env = process.env.OMP_MEMORY_MODE;
+  if (env === "on") return "on";
+  if (env === "off") return "off";
+  try {
+    const p = join(ompRoot(cwd), ".omp", "config.json");
+    if (!existsSync(p)) return "off";
+    const raw = JSON.parse(readFileSync(p, "utf8"));
+    return raw && raw.memoryMode === "on" ? "on" : "off";
+  } catch {
+    return "off";
+  }
+}
+
+function defaultDistPath() {
+  // scripts/lib/ -> packageRoot/dist/src/cli.js (present in the npm package and
+  // dev builds, but NOT in a plugin installed from GitHub — dist is gitignored).
+  const here = dirname(fileURLToPath(import.meta.url));
+  return join(here, "..", "..", "dist", "src", "cli.js");
+}
+
+/** Decide how to invoke the omp CLI. An explicit cliPath (tests/dev) or a
+ *  bundled dist runs via `node <path>`; otherwise — the normal install, where
+ *  the plugin (from GitHub) has no dist but `omp` is installed globally via npm —
+ *  invoke `omp` from PATH. Exported for testing. */
+export function resolveMemoryReviewInvocation({ sessionId, cwd, cliPath, distPath = defaultDistPath(), exists = existsSync } = {}) {
+  const args = ["memory-review", "--session", sessionId, "--root", cwd];
+  if (cliPath) return { command: process.execPath, args: [cliPath, ...args] };
+  if (exists(distPath)) return { command: process.execPath, args: [distPath, ...args] };
+  return { command: "omp", args }; // plugin-from-GitHub: rely on the global omp CLI
+}
+
+export function triggerMemoryReview(options = {}) {
+  const { cwd, sessionId, spawn = nodeSpawn, cliPath, mode } = options;
+  const resolvedMode = mode ?? readMemoryMode(cwd);
+  if (resolvedMode !== "on") return { triggered: false, reason: "memory-mode off" };
+  if (!sessionId || sessionId === "unknown") return { triggered: false, reason: "no session id" };
+  try {
+    const { command, args } = resolveMemoryReviewInvocation({ sessionId, cwd, cliPath });
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    // Handle async spawn errors so they never surface as unhandled (fail-open).
+    if (child && typeof child.on === "function") child.on("error", () => {});
+    if (child && typeof child.unref === "function") child.unref();
+    return { triggered: true };
+  } catch (err) {
+    return { triggered: false, reason: String(err?.message ?? err) };
+  }
+}

package/scripts/lib/pending-directives.mjs

@@ -0,0 +1,36 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { ompRoot } from "./omp-root.mjs";
+
+// Memory-review writes proposed directives to a GATED pending queue (never
+// auto-applied). Without a nudge that queue is invisible and rots, so the
+// sessionStart hook surfaces a count + how to promote. Promotion stays manual:
+// `omp project-memory add-directive "<rule>"` then remove the line.
+
+function pendingPath(cwd) {
+  return join(ompRoot(cwd), ".oh-my-copilot", "memory-review", "pending-directives.md");
+}
+
+/** Count unchecked ("- [ ]") items in the pending-directives queue. */
+export function countPendingDirectives(cwd) {
+  const p = pendingPath(cwd);
+  if (!existsSync(p)) return 0;
+  try {
+    return readFileSync(p, "utf8")
+      .split("\n")
+      .filter((line) => /^\s*-\s*\[\s*\]\s+\S/.test(line)).length;
+  } catch {
+    return 0;
+  }
+}
+
+/** SessionStart nudge string, or "" when nothing is pending. */
+export function pendingDirectivesNudge(cwd) {
+  const n = countPendingDirectives(cwd);
+  if (n === 0) return "";
+  return (
+    `[MEMORY REVIEW] ${n} proposed directive${n === 1 ? "" : "s"} await your review in ` +
+    `.oh-my-copilot/memory-review/pending-directives.md — promote the ones you want with ` +
+    "`omp project-memory add-directive \"<rule>\"`, then delete the line."
+  );
+}

package/scripts/session-end.mjs

@@ -6,6 +6,7 @@ import { endSession } from "./lib/daily-log.mjs";
 import { ompRoot } from "./lib/omp-root.mjs";
 import { failOpen } from "./lib/hook-output.mjs";
 import { parseHookInput } from "./lib/hook-input.mjs";
+import { triggerMemoryReview } from "./lib/memory-review-trigger.mjs";
 
 const HOOK_NAME = "SessionEnd";
 
@@ -28,6 +29,13 @@ const HOOK_NAME = "SessionEnd";
     // Arm a daily-log nudge for the next session if this one did work but
     // logged nothing. endSession never throws.
     endSession(directory);
+    // Memory mode (opt-in): detach the cheap-model end-of-session review.
+    // Best-effort and non-blocking — never delays the hook return.
+    try {
+      triggerMemoryReview({ cwd: directory, sessionId });
+    } catch {
+      // never block session end on the review trigger
+    }
     failOpen();
   } catch (err) {
     console.error(`[hook ${HOOK_NAME}] failed: ${err?.message ?? err}`);

package/scripts/session-start.mjs

@@ -7,6 +7,7 @@ import { checkForUpdate, formatUpdateNotice } from "./lib/version-check.mjs";
 import { scanScheduleResults } from "./lib/schedule-results.mjs";
 import { readRepoGoal, readTodayGoal, recentEntryStats, startSession } from "./lib/daily-log.mjs";
 import { readDirectives } from "./lib/project-memory.mjs";
+import { pendingDirectivesNudge } from "./lib/pending-directives.mjs";
 import { ompRoot } from "./lib/omp-root.mjs";
 import { parseHookInput } from "./lib/hook-input.mjs";
 
@@ -78,6 +79,9 @@ function buildDailyLogBreadcrumb(directory) {
     }
     const repoGoal = readRepoGoal(directory);
     if (repoGoal) parts.push(`[REPO GOAL] ${repoGoal}`);
+    // Memory-review's gated directive queue is invisible without a nudge.
+    const pendingNudge = pendingDirectivesNudge(directory);
+    if (pendingNudge) parts.push(pendingNudge);
     const breadcrumb = buildDailyLogBreadcrumb(directory);
     if (breadcrumb) parts.push(breadcrumb);
     // Resets the per-session baseline and flushes a nudge when the prior session