@yemi33/minions 0.1.2034 → 0.1.2035

package/engine/queries.js

@@ -1944,6 +1944,17 @@ function resetProjectGitStatusCache() {
  *     directly, and the 10 s TTL covers CLI-driven control-file edits.
  *   - `engine/state.json` — surfaced via `getEngineState()` but changes
  *     only on engine startup / reconcile. Negligible benefit.
+ *   - `engine/metrics.json` — surfaced via `getMetrics()` but written by
+ *     `trackEngineUsage()` / `trackAgentMetric()` / the engine tick itself
+ *     (~10 s batched flush plus every per-agent metric event). Like
+ *     `log.json` and `control.json`, its mtime advances at noise-floor
+ *     cadence — every engine tick (~60 s) plus several per-agent writes
+ *     in between, so with multiple agents active it bumps every few
+ *     seconds and busts the ETag cache on /api/status before steady-state
+ *     304s can engage (W-mphejzct00065d8c). The engine-page metrics tile
+ *     is not the hot path and the 10 s `FAST_STATE_TTL` is plenty for
+ *     metric freshness; mutating handlers that need immediate metrics
+ *     visibility should call `invalidateStatusCache()` directly.
  *   - `engine/cooldowns.json`, `engine/pr-links.json`, `engine/pending-
  *     rebases.json`, `agents/<id>/managed-spawn.json` — not in the
  *     `/api/status` payload.
@@ -1965,11 +1976,15 @@ function resetProjectGitStatusCache() {
 function getStatusFastStateMtimePaths(config) {
   const projects = getProjects(config || getConfig());
   const files = [
-    // Engine-level state surfaced by getDispatchQueue / getMetrics.
-    // `control.json` and `log.json` are intentionally omitted — see the
-    // "Files intentionally NOT tracked" section above (W-mpg8aapw001d7e0c).
+    // Engine-level state surfaced by getDispatchQueue. `control.json`,
+    // `log.json`, and `metrics.json` are intentionally omitted — see the
+    // "Files intentionally NOT tracked" section above
+    // (W-mpg8aapw001d7e0c, W-mphejzct00065d8c). dispatch.json stays
+    // tracked because the home + engine sidebar activity dots and
+    // renderDispatch() consume dispatch transitions at sub-FAST_STATE_TTL
+    // cadence (active → completed flips must light up within one SPA
+    // poll, not wait up to 10 s for the periodic SSE backstop).
     DISPATCH_PATH,
-    path.join(ENGINE_DIR, 'metrics.json'),
     // Watches surfaced by watchesMod.getWatches() (W-mpftp7na000td0f4 fix).
     path.join(ENGINE_DIR, 'watches.json'),
     // Central work-items.json surfaced by getWorkItems().

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.2034",
+  "version": "0.1.2035",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"