@ngockhoale/ukit 3.1.9 → 3.3.0

package/template_project/.claude/ukit/runtime/self-improve-trigger.mjs

@@ -0,0 +1,98 @@
+// self-improve-trigger.mjs — fire-and-forget launcher for `ukit self-improve`.
+//
+// Called from every engine's natural lifecycle point:
+//   * Claude Code  — SessionEnd  (session-episode.sh)
+//   * omp          — session_stop (same script via ukit-bridge.js)
+//   * Codex        — route-task.mjs, the helperCommand Codex runs per task
+//                    (Codex has no hook lifecycle)
+//
+// Contract:
+//   * NEVER blocks the caller: the CLI runs detached (own process group,
+//     stdio ignored, unref'd); this module returns in a few ms.
+//   * NEVER throws; every failure is a silent no-op — self-improvement is
+//     background work and must not add noise to a user's session.
+//   * Cheap gates first: config opt-out (learning.selfImprove.enabled:false),
+//     the pass's own rate-limit stamp, and the CLI locator. The locator
+//     (.ukit/storage/cli.json, written by `ukit install`) holds absolute
+//     node + bin paths, so GUI-launched hosts without nvm on PATH still work;
+//     without it there is no trusted CLI to launch and the trigger no-ops.
+//
+// CLI: node self-improve-trigger.mjs [projectRoot]
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+export const MIN_INTERVAL_MS = 10 * 60 * 1000;
+
+function readJson(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+// The locator is a project file: never trust it blindly. `bin` must be the
+// `bin/ukit` of a directory whose package.json names @ngockhoale/ukit, and
+// `node` must be a node executable — a committed/forged cli.json cannot turn
+// the trigger into an arbitrary-binary launcher.
+export function resolveCliLocator(projectRoot) {
+  const locator = readJson(path.join(projectRoot, '.ukit', 'storage', 'cli.json'));
+  if (!locator || typeof locator.node !== 'string' || typeof locator.bin !== 'string') return null;
+  if (!/^node(\.exe)?$/i.test(path.basename(locator.node))) return null;
+  if (path.basename(locator.bin) !== 'ukit' || path.basename(path.dirname(locator.bin)) !== 'bin') return null;
+  const pkg = readJson(path.join(path.dirname(locator.bin), '..', 'package.json'));
+  if (pkg?.name !== '@ngockhoale/ukit') return null;
+  if (!fs.existsSync(locator.node) || !fs.existsSync(locator.bin)) return null;
+  return { node: locator.node, bin: locator.bin };
+}
+
+export function selfImproveDue(projectRoot, now = Date.now()) {
+  const config = readJson(path.join(projectRoot, '.ukit', 'storage', 'config.json'));
+  if (config?.learning?.selfImprove?.enabled === false) return false;
+  const stamp = readJson(path.join(projectRoot, '.ukit', 'storage', 'learning', 'self-improve.json'));
+  const lastRunAt = Date.parse(stamp?.lastRunAt ?? '');
+  return !(Number.isFinite(lastRunAt) && now - lastRunAt < MIN_INTERVAL_MS);
+}
+
+// Returns true when a pass was launched.
+export function triggerSelfImprove({ projectRoot, now = Date.now(), spawnImpl = spawn } = {}) {
+  try {
+    if (typeof projectRoot !== 'string' || projectRoot.length === 0) return false;
+    const root = path.resolve(projectRoot);
+    if (!selfImproveDue(root, now)) return false;
+    const cli = resolveCliLocator(root);
+    if (!cli) return false;
+    const env = { ...process.env };
+    // Hook self-deadlines must not leak into a background pass.
+    delete env.UKIT_HOOK_DEADLINE_MS;
+    const child = spawnImpl(cli.node, [cli.bin, 'self-improve', '--if-due', '--quiet'], {
+      cwd: root,
+      env,
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+    });
+    child.on?.('error', () => {});
+    child.unref?.();
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function isMainModule() {
+  try {
+    const self = fs.realpathSync(fileURLToPath(import.meta.url));
+    const invoked = process.argv[1] ? fs.realpathSync(process.argv[1]) : '';
+    return self === invoked;
+  } catch {
+    return false;
+  }
+}
+
+if (isMainModule()) {
+  triggerSelfImprove({ projectRoot: process.argv[2] || process.env.CLAUDE_PROJECT_DIR || process.cwd() });
+}

package/template_project/ukit/storage/config.json

@@ -85,16 +85,16 @@
   },
   "routing": {
     "routeSchema": {
-      "stage": "off"
+      "stage": "default"
     },
     "rigor": {
-      "stage": "shadow"
+      "stage": "default"
     },
     "fastPath": {
-      "stage": "shadow"
+      "stage": "default"
     },
     "escalation": {
-      "stage": "shadow"
+      "stage": "default"
     }
   },
   "decisionPlane": {
@@ -316,7 +316,20 @@
     },
     "recall": {
       "maxRecords": 8
-    }
+    },
+    "eligibility": {
+      "stage": "default"
+    },
+    "writer": {
+      "stage": "default"
+    },
+    "index": {
+      "stage": "default"
+    },
+    "decision": {
+      "stage": "default"
+    },
+    "killSwitch": false
   },
   "memory": {
     "enabled": true,
@@ -346,31 +359,69 @@
     },
     "tuning": {
       "enabled": true,
-      "applyMode": "manual"
+      "applyMode": "auto"
+    },
+    "selfImprove": {
+      "enabled": true
     },
     "candidates": {
-      "stage": "shadow",
+      "stage": "default",
       "minOccurrences": 3
     },
     "overlays": {
-      "stage": "off"
+      "stage": "default"
     }
   },
   "continuity": {
     "resumableRun": {
-      "stage": "off"
+      "stage": "default"
     }
   },
   "experiments": {
     "deliberation": {
-      "enabled": false
+      "enabled": true
     },
     "dynamicWorkflow": {
-      "enabled": false,
+      "enabled": true,
       "maxAttemptsPerFailure": 2,
       "noProgressCap": 3
     }
   },
+  "decisionRuntime": {
+    "contract": {
+      "stage": "shadow"
+    },
+    "supervisor": {
+      "stage": "shadow"
+    },
+    "scheduler": {
+      "stage": "shadow"
+    },
+    "vm": {
+      "stage": "shadow"
+    },
+    "adapters": {
+      "stage": "shadow"
+    },
+    "context": {
+      "stage": "shadow"
+    },
+    "completion": {
+      "stage": "shadow"
+    },
+    "quality": {
+      "stage": "shadow"
+    },
+    "promotion": {
+      "stage": "shadow"
+    },
+    "resourcePolicy": {
+      "stage": "shadow"
+    },
+    "diagnostics": {
+      "stage": "default"
+    }
+  },
   "safePatch": {
     "enabled": true,
     "strictSharedRisk": true,
@@ -600,15 +651,15 @@
       },
       "tu_ghi_episode_ket_thuc_session": {
         "field": "learning.episodes.autoWrite",
-        "mac_dinh": false,
-        "y_nghia": "N\u1ebfu true, hook SessionEnd t\u1ef1 ghi episode v\u00e0o memory v2 khi k\u1ebft th\u00fac session (c\u1ea7n `ukit` c\u00f3 tr\u00ean PATH). M\u1eb7c \u0111\u1ecbnh t\u1eaft \u0111\u1ec3 tr\u00e1nh ghi memory khi user ch\u01b0a mu\u1ed1n.",
-        "khi_nao_bat": "Ch\u1ec9 b\u1eadt khi anh mu\u1ed1n UKit t\u1ef1 l\u01b0u episode m\u1ed7i session; d\u1eef li\u1ec7u v\u1eabn n\u1eb1m local trong .ukit/storage."
+        "mac_dinh": true,
+        "y_nghia": "B\u1eadt m\u1eb7c \u0111\u1ecbnh: UKit t\u1ef1 ghi episode v\u00e0o memory v2 cho m\u1ed7i session \u0111\u00e3 k\u1ebft th\u00fac (hook SessionEnd/session_stop + chu k\u1ef3 self-improve qu\u00e9t exec-ledger, ch\u1ea1y \u0111\u01b0\u1ee3c c\u1ea3 tr\u00ean Codex). D\u1eef li\u1ec7u n\u1eb1m local trong .ukit/storage.",
+        "khi_nao_bat": "Ch\u1ec9 t\u1eaft (false) khi kh\u00f4ng mu\u1ed1n UKit l\u01b0u episode."
       },
       "tat_goi_y_tuning": {
         "field": "learning.tuning.applyMode",
-        "mac_dinh": "manual",
-        "y_nghia": "manual = UKit ch\u1ec9 t\u00ednh v\u00e0 l\u01b0u g\u1ee3i \u00fd tuning v\u00e0o .ukit/storage/learning/suggestions.json, KH\u00d4NG bao gi\u1edd t\u1ef1 s\u1eeda weights/threshold. off = t\u1eaft lu\u00f4n vi\u1ec7c t\u00ednh g\u1ee3i \u00fd.",
-        "khuyen_nghi": "Gi\u1eef manual. Kh\u00f4ng c\u00f3 ch\u1ebf \u0111\u1ed9 auto-apply \u2014 m\u1ecdi thay \u0111\u1ed5i weights/threshold \u0111\u1ec1u do ng\u01b0\u1eddi d\u00f9ng t\u1ef1 s\u1eeda."
+        "mac_dinh": "auto",
+        "y_nghia": "auto (m\u1eb7c \u0111\u1ecbnh) = chu k\u1ef3 self-improve t\u1ef1 \u00e1p d\u1ee5ng thay \u0111\u1ed5i tuning t\u1eebng b\u01b0\u1edbc nh\u1ecf, c\u00f3 gi\u1edbi h\u1ea1n (retriever weights, escalation.debugLoopThreshold) v\u00e0o .ukit/storage/learning/tuned.json. manual = ch\u1ec9 ghi g\u1ee3i \u00fd v\u00e0o suggestions.json. off = kh\u00f4ng t\u00ednh.",
+        "khuyen_nghi": "Gi\u1eef auto. Rollback: xo\u00e1 .ukit/storage/learning/tuned.json ho\u1eb7c \u0111\u1eb7t manual."
       }
     },
     "version": "Phi\u00ean b\u1ea3n config runtime \u0111i k\u00e8m package UKit.",