@integrity-labs/agt-cli 0.28.62 → 0.28.63

package/dist/bin/agt.js

@@ -37,7 +37,7 @@ import {
   success,
   table,
   warn
-} from "../chunk-QQGXIZVB.js";
+} from "../chunk-5H3EMCNV.js";
 import {
   CHANNEL_REGISTRY,
   DEPLOYMENT_TEMPLATES,
@@ -4777,7 +4777,7 @@ import { execFileSync, execSync } from "child_process";
 import { existsSync as existsSync10, realpathSync as realpathSync2 } from "fs";
 import chalk18 from "chalk";
 import ora16 from "ora";
-var cliVersion = true ? "0.28.62" : "dev";
+var cliVersion = true ? "0.28.63" : "dev";
 async function fetchLatestVersion() {
   const host2 = getHost();
   if (!host2) return null;
@@ -5791,7 +5791,7 @@ function handleError(err) {
 }
 
 // src/bin/agt.ts
-var cliVersion2 = true ? "0.28.62" : "dev";
+var cliVersion2 = true ? "0.28.63" : "dev";
 var program = new Command();
 program.name("agt").description("Augmented CLI \u2014 agent provisioning and management").version(cliVersion2).option("--json", "Emit machine-readable JSON output (suppress spinners and colors)").option("--skip-update-check", "Skip the automatic update check on startup");
 program.hook("preAction", async (thisCommand, actionCommand) => {

package/dist/{chunk-QQGXIZVB.js → chunk-5H3EMCNV.js}

@@ -7347,7 +7347,7 @@ function requireHost() {
 }
 
 // src/lib/api-client.ts
-var agtCliVersion = true ? "0.28.62" : "dev";
+var agtCliVersion = true ? "0.28.63" : "dev";
 var lastConfigHash = null;
 function setConfigHash(hash) {
   lastConfigHash = hash && hash.length > 0 ? hash : null;
@@ -8643,4 +8643,4 @@ export {
   managerInstallSystemUnitCommand,
   managerUninstallSystemUnitCommand
 };
-//# sourceMappingURL=chunk-QQGXIZVB.js.map
+//# sourceMappingURL=chunk-5H3EMCNV.js.map

package/dist/lib/manager-worker.js

@@ -27,7 +27,7 @@ import {
   requireHost,
   safeWriteJsonAtomic,
   setConfigHash
-} from "../chunk-QQGXIZVB.js";
+} from "../chunk-5H3EMCNV.js";
 import {
   getProjectDir as getProjectDir2,
   getReadyTasks,
@@ -1060,6 +1060,8 @@ function formatStatusMessage(events, windowMs) {
 var DEFAULT_WINDOW_MS2 = 6e5;
 var DEFAULT_MIN_TRANSITIONS = 4;
 var DEFAULT_MIN_DISTINCT = 2;
+var DEFAULT_LONG_WINDOW_MS = 36e5;
+var DEFAULT_LONG_MIN_TRANSITIONS = 4;
 function readEnvNumber2(name, fallback) {
   const raw = process.env[name];
   if (!raw) return fallback;
@@ -1073,6 +1075,8 @@ var McpFlapDampener = class {
   windowMs;
   minTransitions;
   minDistinct;
+  longWindowMs;
+  longMinTransitions;
   now;
   history = /* @__PURE__ */ new Map();
   flapping = /* @__PURE__ */ new Set();
@@ -1080,6 +1084,8 @@ var McpFlapDampener = class {
     this.windowMs = opts.windowMs ?? readEnvNumber2("AGT_MCP_FLAP_WINDOW_MS", DEFAULT_WINDOW_MS2);
     this.minTransitions = opts.minTransitions ?? readEnvNumber2("AGT_MCP_FLAP_MIN_TRANSITIONS", DEFAULT_MIN_TRANSITIONS);
     this.minDistinct = opts.minDistinct ?? readEnvNumber2("AGT_MCP_FLAP_MIN_DISTINCT", DEFAULT_MIN_DISTINCT);
+    this.longWindowMs = opts.longWindowMs ?? readEnvNumber2("AGT_MCP_FLAP_LONG_WINDOW_MS", DEFAULT_LONG_WINDOW_MS);
+    this.longMinTransitions = opts.longMinTransitions ?? readEnvNumber2("AGT_MCP_FLAP_LONG_MIN_TRANSITIONS", DEFAULT_LONG_MIN_TRANSITIONS);
     this.now = opts.now ?? Date.now;
     if (!Number.isFinite(this.windowMs) || this.windowMs < 1e3) {
       throw new Error("mcp-flap-dampener windowMs must be a finite number >= 1000");
@@ -1090,6 +1096,12 @@ var McpFlapDampener = class {
     if (!Number.isFinite(this.minDistinct) || this.minDistinct < 2) {
       throw new Error("mcp-flap-dampener minDistinct must be a finite number >= 2");
     }
+    if (!Number.isFinite(this.longWindowMs) || this.longWindowMs < this.windowMs) {
+      throw new Error("mcp-flap-dampener longWindowMs must be a finite number >= windowMs");
+    }
+    if (!Number.isFinite(this.longMinTransitions) || this.longMinTransitions < 2) {
+      throw new Error("mcp-flap-dampener longMinTransitions must be a finite number >= 2");
+    }
   }
   key(codeName, channel) {
     return `${codeName}\0${channel}`;
@@ -1103,34 +1115,58 @@ var McpFlapDampener = class {
   record(codeName, channel, signature) {
     const k = this.key(codeName, channel);
     const at = this.now();
-    const cutoff = at - this.windowMs;
+    const cutoff = at - this.longWindowMs;
     const prior = (this.history.get(k) ?? []).filter((o) => o.at >= cutoff);
     prior.push({ sig: signature, at });
     this.history.set(k, prior);
-    let transitions = 0;
-    for (let i = 1; i < prior.length; i++) {
-      if (prior[i].sig !== prior[i - 1].sig) transitions++;
-    }
-    const distinctStates = new Set(prior.map((o) => o.sig)).size;
-    const revisited = prior.slice(0, -1).some((o, i) => o.sig === signature && i !== prior.length - 2);
+    const fast = this.windowMetrics(prior, at - this.windowMs);
+    const slow = this.windowMetrics(prior, at - this.longWindowMs);
+    const fastOsc = fast.transitions >= this.minTransitions && fast.distinctStates >= this.minDistinct && fast.revisited;
+    const slowOsc = slow.transitions >= this.longMinTransitions && slow.distinctStates >= this.minDistinct && slow.revisited;
+    const oscillating = fastOsc || slowOsc;
+    const tier = fastOsc ? "fast" : slowOsc ? "slow" : null;
     const transitionNow = prior.length >= 2 && prior[prior.length - 1].sig !== prior[prior.length - 2].sig;
-    const oscillating = transitions >= this.minTransitions && distinctStates >= this.minDistinct && revisited;
     const wasFlapping = this.flapping.has(k);
     let onset = false;
     if (wasFlapping) {
-      if (!transitionNow) this.flapping.delete(k);
+      if (!transitionNow) {
+        this.flapping.delete(k);
+        this.history.set(k, [{ sig: signature, at }]);
+      }
     } else if (transitionNow && oscillating) {
       this.flapping.add(k);
       onset = true;
     }
+    const reported = tier === "slow" ? slow : fast;
     return {
       flapping: this.flapping.has(k),
-      distinctStates,
-      transitions,
+      distinctStates: reported.distinctStates,
+      transitions: reported.transitions,
       windowCount: prior.length,
-      onset
+      onset,
+      tier,
+      longTransitions: slow.transitions,
+      longDistinctStates: slow.distinctStates
     };
   }
+  /**
+   * Transitions / distinct signatures / revisit flag for the observations that
+   * fall inside `[windowStart, now]`. The latest observation (the one just
+   * recorded) is always in-window. A revisit = the latest signature appears
+   * earlier in the sub-window but NOT as the immediately-preceding observation,
+   * so strictly-monotonic growth (A→B→C→D) never counts as a revisit.
+   */
+  windowMetrics(prior, windowStart) {
+    const inWin = prior.filter((o) => o.at >= windowStart);
+    let transitions = 0;
+    for (let i = 1; i < inWin.length; i++) {
+      if (inWin[i].sig !== inWin[i - 1].sig) transitions++;
+    }
+    const distinctStates = new Set(inWin.map((o) => o.sig)).size;
+    const latest = inWin[inWin.length - 1];
+    const revisited = latest ? inWin.slice(0, -1).some((o, i) => o.sig === latest.sig && i !== inWin.length - 2) : false;
+    return { transitions, distinctStates, revisited };
+  }
   /** True if (codeName, channel) is currently dampened. */
   isFlapping(codeName, channel) {
     return this.flapping.has(this.key(codeName, channel));
@@ -6582,7 +6618,7 @@ function checkMcpConfigDriftAndScheduleRestart(codeName, projectDir) {
         );
       } else if (flapSuppressed) {
         log(
-          `[mcp-flap-dampener] .mcp.json membership drift for '${codeName}' [${decision.addedOrRemoved.join(", ")}] held \u2014 managed-MCP set is flapping, adopting baseline WITHOUT restart until it settles (ENG-6123)`
+          `[mcp-flap-dampener] .mcp.json membership drift for '${codeName}' [${decision.addedOrRemoved.join(", ")}] held \u2014 managed-MCP set is flapping, adopting baseline WITHOUT restart until it settles (ENG-6123, ENG-6512)`
         );
       } else if (decision.restart) {
         clearPresenceReaperStateForKeys(codeName, new Set(decision.addedOrRemoved));
@@ -6698,7 +6734,7 @@ var cachedMaintenanceWindow = null;
 var lastVersionCheckAt = 0;
 var VERSION_CHECK_INTERVAL_MS = 5 * 60 * 1e3;
 var lastResponsivenessProbeAt = 0;
-var agtCliVersion = true ? "0.28.62" : "dev";
+var agtCliVersion = true ? "0.28.63" : "dev";
 function resolveBrewPath(execFileSync4) {
   try {
     const out = execFileSync4("which", ["brew"], { timeout: 5e3 }).toString().trim();
@@ -9314,7 +9350,7 @@ async function processAgent(agent, agentStates) {
       const intFlap = mcpFlapDampener.record(agent.code_name, FLAP_CHANNEL_INTEGRATIONS, intMembership);
       if (intFlap.onset) {
         log(
-          `[mcp-flap-dampener] integration set for '${agent.code_name}' is FLAPPING (${intFlap.transitions} transitions / ${intFlap.distinctStates} states in window) \u2014 suppressing integration-update notices until it settles (ENG-6123)`
+          `[mcp-flap-dampener] integration set for '${agent.code_name}' is FLAPPING (${intFlap.tier} tier: ${intFlap.transitions} transitions / ${intFlap.distinctStates} states in window) \u2014 suppressing integration-update notices until it settles (ENG-6123, ENG-6512)`
         );
         recordConfigChurnEvent(agent.agent_id, agent.code_name, FLAP_CHANNEL_INTEGRATIONS, intMembership);
       }
@@ -9403,7 +9439,7 @@ async function processAgent(agent, agentStates) {
         const mcpFlap = mcpFlapDampener.record(agent.code_name, FLAP_CHANNEL_MANAGED_MCP, mcpMembership);
         if (mcpFlap.onset) {
           log(
-            `[mcp-flap-dampener] managed-MCP set for '${agent.code_name}' is FLAPPING (${mcpFlap.transitions} transitions / ${mcpFlap.distinctStates} states in window) \u2014 suppressing mcp-update notice + restart until it settles (ENG-6123)`
+            `[mcp-flap-dampener] managed-MCP set for '${agent.code_name}' is FLAPPING (${mcpFlap.tier} tier: ${mcpFlap.transitions} transitions / ${mcpFlap.distinctStates} states in window) \u2014 suppressing mcp-update notice + restart until it settles (ENG-6123, ENG-6512)`
           );
           recordConfigChurnEvent(agent.agent_id, agent.code_name, FLAP_CHANNEL_MANAGED_MCP, mcpMembership);
         }