opencode-swarm 7.107.3 → 7.107.4

package/dist/cli/{index-cyzzdbvw.js → index-gyzxeza3.js}

@@ -1,10 +1,13 @@
 // @bun
+import {
+  getGlobalEventBus
+} from "./index-c8s9a3zh.js";
 import {
   detectStraySwarmDirs,
   readDoctorArtifact,
   removeStraySwarmDir,
   runConfigDoctor
-} from "./index-esg1554h.js";
+} from "./index-wvxhynxq.js";
 import {
   MAX_TRANSIENT_RETRIES,
   PlanSchema,
@@ -44,13 +47,22 @@ import {
   savePlan,
   transientBackoff,
   validateProjectRoot
-} from "./index-kzfkggjx.js";
+} from "./index-9b7a6agd.js";
+import {
+  buildOpenSpecProjectionSync,
+  detectSpeckit,
+  loadSddStatusSync,
+  readEffectiveSpecSync,
+  resolveSpeckitProjection,
+  validateSpeckit,
+  writeProjectedSpecSync
+} from "./index-91j1sqzm.js";
 import {
   _internals as _internals2,
   _internals1 as _internals3,
   isCommandAvailable,
   tool
-} from "./index-8w4d325g.js";
+} from "./index-xg18az81.js";
 import {
   CURATOR_INIT_PROMPT,
   CURATOR_PHASE_PROMPT,
@@ -69,33 +81,42 @@ import {
   getCanonicalAgentRole,
   resolveExternalSkillsConfig,
   stripKnownSwarmPrefix
-} from "./index-2560cctg.js";
+} from "./index-pchpahdf.js";
 import {
   DEFAULT_SKILL_MIN_CONFIDENCE,
   DEFAULT_SKILL_MIN_CONFIRMATIONS,
   appendRejectedSkillEdit,
   appendSkillChangelog,
-  appendUnactionable,
   autoApplyProposals,
-  effectiveRetrievalOutcomes,
   evaluateSkillChange,
   generateSkills,
   listSkills,
   parseDraftFrontmatter,
-  quarantineEntry,
-  readKnowledgeCounterRollups,
-  readKnowledgeEvents,
   regenerateSkill,
-  resolveKnowledgeEventsPath,
-  resolveUnactionablePath,
-  restoreEntry,
   retireOrMarkStale,
   retireSkill,
-  selectCandidateEntries,
+  selectCandidateEntries
+} from "./index-bpgqbwmf.js";
+import {
+  appendUnactionable,
+  quarantineEntry,
+  resolveUnactionablePath,
+  restoreEntry,
+  unarchiveEntry,
   validateActionability,
   validateActionableFields,
   validateLesson
-} from "./index-9wstcavp.js";
+} from "./index-dfdg4ws5.js";
+import {
+  readRecentEscalations
+} from "./index-bq8kd9r9.js";
+import {
+  effectiveRetrievalOutcomes,
+  readKnowledgeCounterRollups,
+  readKnowledgeEvents,
+  recordKnowledgeEvent,
+  resolveKnowledgeEventsPath
+} from "./index-kxm3bdjh.js";
 import {
   appendKnowledge,
   appendRejectedLesson,
@@ -107,36 +128,31 @@ import {
   findNearDuplicate,
   getArchivedKnowledgeIds,
   inferTags,
-  isLinked,
   normalize,
   readKnowledge,
-  readLinkPointer,
   readRejectedLessons,
   readRetractionRecords,
-  removeLinkPointer,
   resolveHiveKnowledgePath,
   resolveHiveRejectedPath,
-  resolveKnowledgeStoreDir,
-  resolveLinkDir,
   resolveSwarmKnowledgePath,
   rewriteKnowledge,
-  sanitizeLinkId,
   transactFile,
-  transactKnowledge,
-  writeLinkPointer
-} from "./index-f7nma02k.js";
+  transactKnowledge
+} from "./index-xmarctsf.js";
 import {
-  getGlobalEventBus
-} from "./index-c8s9a3zh.js";
+  isLinked,
+  readLinkPointer,
+  removeLinkPointer,
+  resolveKnowledgeStoreDir,
+  resolveLinkDir,
+  sanitizeLinkId,
+  writeLinkPointer
+} from "./index-n1sptn1w.js";
 import {
-  buildOpenSpecProjectionSync,
-  detectSpeckit,
-  loadSddStatusSync,
-  readEffectiveSpecSync,
-  resolveSpeckitProjection,
-  validateSpeckit,
-  writeProjectedSpecSync
-} from "./index-91j1sqzm.js";
+  KNOWLEDGE_SCHEMA_VERSION,
+  OUTCOME_BLOCK_THRESHOLD,
+  isActiveStatus
+} from "./index-bfwt3abw.js";
 import {
   SandboxCapabilityProbe,
   _internals,
@@ -154,7 +170,7 @@ import {
   listActive,
   subscribe,
   unsubscribe
-} from "./index-hkpw4wwa.js";
+} from "./index-4r5z8sgw.js";
 import {
   readSwarmFileAsync,
   safeHook,
@@ -169,13 +185,13 @@ import {
   log,
   warn
 } from "./index-zgwm4ryv.js";
+import {
+  exports_external
+} from "./index-293f68mj.js";
 import {
   require_proper_lockfile,
   tryAcquireLock
 } from "./index-3naa2ajc.js";
-import {
-  exports_external
-} from "./index-293f68mj.js";
 import {
   bunSpawn,
   bunWrite
@@ -7916,15 +7932,15 @@ var _internals8 = {
   executePostMortemActions,
   repairPostMortemActions,
   loadDefaultKnowledgeConfig: async () => {
-    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-vw2ffhe9.js");
+    const { KnowledgeConfigSchema: KnowledgeConfigSchema2 } = await import("./schema-x0ekqzvs.js");
     return KnowledgeConfigSchema2.parse({});
   },
   applyCuratorKnowledgeUpdates: async (directory, recommendations, knowledgeConfig) => {
-    const { applyCuratorKnowledgeUpdates } = await import("./curator-1nr4qszq.js");
+    const { applyCuratorKnowledgeUpdates } = await import("./curator-rb05fjjk.js");
     return applyCuratorKnowledgeUpdates(directory, recommendations, knowledgeConfig);
   },
   checkHivePromotions: async (entries, knowledgeConfig) => {
-    const { checkHivePromotions } = await import("./hive-promoter-j4e6rfa6.js");
+    const { checkHivePromotions } = await import("./hive-promoter-34bdmw1w.js");
     return checkHivePromotions(entries, knowledgeConfig);
   },
   applyProposalTriage: async (directory, triage) => {
@@ -7933,7 +7949,7 @@ var _internals8 = {
       activateProposal,
       listSkills: listSkills2,
       sanitizeSlug
-    } = await import("./skill-generator-y6mmq8n5.js");
+    } = await import("./skill-generator-x83re96d.js");
     const result = {
       approved: [],
       rejected: [],
@@ -7988,34 +8004,6 @@ import { randomUUID as randomUUID5 } from "crypto";
 import * as fs5 from "fs";
 import * as path15 from "path";
 
-// src/hooks/knowledge-escalator.ts
-var ESCALATION_DISPLAY_WINDOW_DAYS = 7;
-async function readRecentEscalations(directory, windowDays = ESCALATION_DISPLAY_WINDOW_DAYS, now = new Date) {
-  try {
-    const cutoff = now.getTime() - windowDays * 24 * 60 * 60 * 1000;
-    const events = await readKnowledgeEvents(directory);
-    const out = [];
-    for (const e of events) {
-      if (e.type !== "escalation")
-        continue;
-      const t = Date.parse(e.timestamp);
-      if (Number.isNaN(t) || t < cutoff)
-        continue;
-      out.push({
-        entry_id: e.entry_id,
-        from: e.from,
-        to: e.to,
-        reason: e.reason,
-        at: e.timestamp
-      });
-    }
-    out.sort((a, b) => a.at < b.at ? 1 : a.at > b.at ? -1 : 0);
-    return out;
-  } catch {
-    return [];
-  }
-}
-
 // src/services/learning-metrics.ts
 var SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
 var THIRTY_DAYS_MS = 30 * 24 * 60 * 60 * 1000;
@@ -9331,7 +9319,7 @@ async function applySkillUsageFeedback(directory, options) {
       delta: Math.max(-VIOLATION_DECAY, Math.min(COMPLIANCE_BOOST, netDelta))
     }));
     if (clampedDeltas.length > 0) {
-      await bumpKnowledgeConfidenceBatch(directory, clampedDeltas);
+      await bumpKnowledgeConfidenceBatch(directory, clampedDeltas, options?.floorOptions);
       appendFeedbackAppliedMarker(directory, processedEntryIds);
     }
   } catch (err) {
@@ -10129,7 +10117,7 @@ async function runCuratorPhase(directory, phase, agentsDispatched, config, knowl
     }
     if (config.skill_generation_enabled === true && skillCandidates.length > 0) {
       try {
-        const skillModule = await import("./skill-generator-y6mmq8n5.js");
+        const skillModule = await import("./skill-generator-x83re96d.js");
         for (const cand of skillCandidates) {
           if (cand.confidence < (config.min_skill_confidence ?? DEFAULT_SKILL_MIN_CONFIDENCE)) {
             continue;
@@ -10297,9 +10285,11 @@ async function applyCuratorKnowledgeUpdates(directory, recommendations, knowledg
   const knowledgePath = resolveSwarmKnowledgePath(directory);
   const appliedIds = new Set;
   const foundIds = new Set;
+  const contradictedEntries = [];
   await transactKnowledge(knowledgePath, (entries) => {
     appliedIds.clear();
     foundIds.clear();
+    contradictedEntries.length = 0;
     let txApplied = 0;
     let modified = false;
     for (const e of entries)
@@ -10319,19 +10309,29 @@ async function applyCuratorKnowledgeUpdates(directory, recommendations, knowledg
             confidence: Math.min(1, (entry.confidence ?? 0) + 0.1),
             updated_at: new Date().toISOString()
           };
-        case "archive":
+        case "archive": {
+          if (entry.status === "archived") {
+            return entry;
+          }
           appliedIds.add(entry.id);
           txApplied++;
           modified = true;
           return {
             ...entry,
             status: "archived",
+            archived_from: entry.status,
+            archived_at: new Date().toISOString(),
             updated_at: new Date().toISOString()
           };
+        }
         case "flag_contradiction":
           appliedIds.add(entry.id);
           txApplied++;
           modified = true;
+          contradictedEntries.push({
+            id: entry.id,
+            reason: (rec.reason ?? "").slice(0, 200)
+          });
           return {
             ...entry,
             tags: [
@@ -10373,6 +10373,27 @@ async function applyCuratorKnowledgeUpdates(directory, recommendations, knowledg
     applied += txApplied;
     return modified ? updatedEntries : null;
   });
+  for (const { id, reason } of contradictedEntries) {
+    try {
+      await recordKnowledgeEvent(directory, {
+        type: "contradicted",
+        knowledge_id: id,
+        trace_id: `curator-${randomUUID5()}`,
+        session_id: "curator",
+        agent: "curator",
+        reason: `flag_contradiction: ${reason}`,
+        evidence: { summary: reason }
+      });
+    } catch {}
+  }
+  if (contradictedEntries.length > 0 && knowledgeConfig.contradiction_threshold_action === "quarantine") {
+    const { maybeQuarantineOnContradiction } = await import("./knowledge-escalator-3sgwrgy9.js");
+    for (const { id } of contradictedEntries) {
+      try {
+        await maybeQuarantineOnContradiction(directory, id, knowledgeConfig.contradiction_quarantine_threshold, knowledgeConfig.contradiction_quarantine_window_days);
+      } catch {}
+    }
+  }
   for (const rec of validRecommendations) {
     if (rec.entry_id !== undefined && !appliedIds.has(rec.entry_id)) {
       if (!foundIds.has(rec.entry_id)) {
@@ -10495,7 +10516,7 @@ function isHiveEligible(entry, autoPromoteDays) {
   return false;
 }
 function isActiveForHivePromotion(entry) {
-  return !["archived", "quarantined", "quarantined_unactionable"].includes(entry.status);
+  return isActiveStatus(entry.status);
 }
 function countDistinctProjects(confirmedBy) {
   const projectNames = new Set;
@@ -10934,13 +10955,8 @@ async function rebuildSynonymMap(directory, entries, maxPairs = DEFAULT_MAX_PAIR
 init_logger();
 
 // src/hooks/knowledge-reinforcement.ts
-var INACTIVE_STATUSES = new Set([
-  "archived",
-  "quarantined",
-  "quarantined_unactionable"
-]);
 function isActiveSwarmKnowledgeEntry(entry) {
-  return !INACTIVE_STATUSES.has(entry.status);
+  return isActiveStatus(entry.status);
 }
 function findActiveSwarmNearDuplicate(lesson, entries, threshold) {
   return findNearDuplicate(lesson, entries.filter(isActiveSwarmKnowledgeEntry), threshold);
@@ -12764,10 +12780,13 @@ async function curateAndStoreSwarm(lessons, projectName, phaseInfo, directory, c
   }
   if (!options?.skipAutoPromotion) {
     await _internals14.runAutoPromotion(directory, config);
+    if (phaseInfo.phase_number > 0) {
+      await _internals14.runAutoDemotion(directory, config, phaseInfo.phase_number);
+    }
   }
   return { stored, reinforced, skipped, rejected, quarantined };
 }
-var OUTCOME_PROMOTION_BLOCK = -0.3;
+var OUTCOME_PROMOTION_BLOCK = OUTCOME_BLOCK_THRESHOLD;
 async function runAutoPromotion(directory, config) {
   const knowledgePath = resolveSwarmKnowledgePath(directory);
   const entries = await readKnowledge(knowledgePath) ?? [];
@@ -12802,6 +12821,42 @@ async function runAutoPromotion(directory, config) {
     await rewriteKnowledge(knowledgePath, entries);
   }
 }
+async function runAutoDemotion(directory, config, phaseNumber) {
+  const knowledgePath = resolveSwarmKnowledgePath(directory);
+  const entries = await readKnowledge(knowledgePath) ?? [];
+  const counterRollups = await readKnowledgeCounterRollups(directory);
+  let changed = false;
+  for (const entry of entries) {
+    if (entry.status !== "promoted")
+      continue;
+    if (entry.last_demotion_phase === phaseNumber)
+      continue;
+    const signal = computeOutcomeSignal(effectiveRetrievalOutcomes(entry.retrieval_outcomes, counterRollups.get(entry.id)));
+    const threshold = config.promoted_demotion_signal_threshold;
+    const minPhases = config.promoted_demotion_min_negative_phases;
+    const prevCount = entry.recent_negative_phase_count ?? 0;
+    const next = signal <= threshold ? prevCount + 1 : 0;
+    const counterChanged = next !== prevCount;
+    const willDemote = next >= minPhases;
+    if (!counterChanged && !willDemote) {
+      entry.last_demotion_phase = phaseNumber;
+      continue;
+    }
+    entry.recent_negative_phase_count = next;
+    entry.last_demotion_phase = phaseNumber;
+    if (willDemote) {
+      entry.status = "established";
+      entry.hive_eligible = false;
+      entry.confidence_floor_demoted = false;
+      entry.recent_negative_phase_count = 0;
+    }
+    entry.updated_at = new Date().toISOString();
+    changed = true;
+  }
+  if (changed) {
+    await rewriteKnowledge(knowledgePath, entries);
+  }
+}
 function createKnowledgeCuratorHook(directory, config, options = {}) {
   const handler = async (input, output) => {
     pruneSeenRetroSections();
@@ -12881,6 +12936,7 @@ var _internals14 = {
   isWriteToEvidenceFile,
   curateAndStoreSwarm,
   runAutoPromotion,
+  runAutoDemotion,
   createKnowledgeCuratorHook,
   seenRetroSections,
   recordSeenRetroSection,
@@ -15104,7 +15160,7 @@ async function runFinalizeStage(ctx) {
     }
   }
   try {
-    const { CuratorConfigSchema: CCS } = await import("./schema-vw2ffhe9.js");
+    const { CuratorConfigSchema: CCS } = await import("./schema-x0ekqzvs.js");
     const { config: pmLoadedConfig } = _internals18.loadPluginConfigWithMeta(ctx.directory);
     const curatorCfg = CCS.parse(pmLoadedConfig.curator ?? {});
     if (curatorCfg.enabled && curatorCfg.postmortem_enabled) {
@@ -17209,9 +17265,9 @@ var _internals22 = {
   readSwarmFileAsync,
   loadCuratorDeps: async () => {
     const [{ CuratorConfigSchema }, curator, { createCuratorLLMDelegate: createCuratorLLMDelegate2 }] = await Promise.all([
-      import("./schema-vw2ffhe9.js"),
-      import("./curator-1nr4qszq.js"),
-      import("./curator-llm-factory-x9tk7e6m.js")
+      import("./schema-x0ekqzvs.js"),
+      import("./curator-rb05fjjk.js"),
+      import("./curator-llm-factory-abw56kg0.js")
     ]);
     return { CuratorConfigSchema, curator, createCuratorLLMDelegate: createCuratorLLMDelegate2 };
   }
@@ -17707,7 +17763,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "opencode-swarm",
-  version: "7.107.3",
+  version: "7.107.4",
   description: "Architect-centric agentic swarm plugin for OpenCode - hub-and-spoke orchestration with SME consultation, code generation, and QA review",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -19151,7 +19207,7 @@ async function handleDoctorCommand(directory, args) {
   const result = runConfigDoctor(config, directory);
   let output;
   if (enableAutoFix && result.hasAutoFixableIssues) {
-    const { runConfigDoctorWithFixes } = await import("./config-doctor-cntnpyvj.js");
+    const { runConfigDoctorWithFixes } = await import("./config-doctor-kdq3vae4.js");
     const fixResult = await runConfigDoctorWithFixes(directory, config, true);
     output = formatDoctorMarkdown(fixResult.result);
   } else {
@@ -19964,7 +20020,7 @@ async function handleEvidenceCommand(directory, args) {
   return formatTaskEvidenceMarkdown(evidenceData);
 }
 async function handleEvidenceSummaryCommand(directory) {
-  const { buildEvidenceSummary } = await import("./evidence-summary-service-9r28ds8t.js");
+  const { buildEvidenceSummary } = await import("./evidence-summary-service-nwdfnbz1.js");
   const artifact = await buildEvidenceSummary(directory);
   if (!artifact) {
     return "No plan found. Run `/swarm plan` to check plan status.";
@@ -21482,11 +21538,6 @@ import { existsSync as existsSync27, readFileSync as readFileSync16 } from "fs";
 import { mkdir as mkdir10, readFile as readFile13, writeFile as writeFile12 } from "fs/promises";
 import * as os11 from "os";
 import * as path44 from "path";
-
-// src/hooks/knowledge-types.ts
-var KNOWLEDGE_SCHEMA_VERSION = 2;
-
-// src/hooks/knowledge-migrator.ts
 async function migrateKnowledgeToExternal(_directory, _config) {
   const externalSentinelPath = path44.join(_directory, ".swarm", ".knowledge-external-migrated");
   const contextPath = path44.join(_directory, ".swarm", "context.md");
@@ -21957,10 +22008,23 @@ async function handleKnowledgeRestoreCommand(directory, args) {
     return "Invalid entry ID. IDs must be 1-64 characters: letters, digits, hyphens, underscores only.";
   }
   try {
+    const swarmEntries = await readKnowledge(resolveSwarmKnowledgePath(directory));
+    const swarmResolved = resolveEntryByPrefix(swarmEntries, inputId);
+    if ("entry" in swarmResolved && swarmResolved.entry.status === "archived") {
+      const fullId2 = swarmResolved.entry.id;
+      const result = await unarchiveEntry(directory, fullId2);
+      if (result.restored) {
+        return `\u2705 Archived entry ${fullId2} restored to '${result.restored_to}'.`;
+      }
+      return `\u274C Entry ${fullId2} could not be unarchived${result.reason ? ` (${result.reason})` : ""}.`;
+    }
     const quarantinePath = join38(resolveKnowledgeStoreDir(directory), "knowledge-quarantined.jsonl");
     const entries = await readKnowledge(quarantinePath);
     const resolved = resolveEntryByPrefix(entries, inputId);
     if ("error" in resolved) {
+      if ("entry" in swarmResolved) {
+        return `\u274C Entry ${swarmResolved.entry.id} is neither archived nor quarantined (status: '${swarmResolved.entry.status}'). Only archived or quarantined entries can be restored.`;
+      }
       return `\u274C ${resolved.error}`;
     }
     const fullId = resolved.entry.id;
@@ -24181,6 +24245,14 @@ function getAdditionalLinterCommand(linter, mode, cwd) {
       const base = useBundle ? ["bundle", "exec", "rubocop"] : ["rubocop"];
       return mode === "fix" ? [...base, "-A"] : base;
     }
+    case "phpstan":
+      return [phpVendorBin(cwd, "phpstan"), "analyse"];
+    case "pint":
+      return mode === "fix" ? [phpVendorBin(cwd, "pint")] : [phpVendorBin(cwd, "pint"), "--test"];
+    case "php-cs-fixer":
+      return mode === "fix" ? [phpVendorBin(cwd, "php-cs-fixer"), "fix"] : [phpVendorBin(cwd, "php-cs-fixer"), "fix", "--dry-run", "--diff"];
+    case "phpcs":
+      return [phpVendorBin(cwd, "phpcs")];
   }
 }
 function detectRuff(cwd) {
@@ -24202,22 +24274,59 @@ function detectClippy(cwd) {
 function detectGolangciLint(cwd) {
   return fs18.existsSync(path50.join(cwd, "go.mod")) && isCommandAvailable("golangci-lint");
 }
+function readTextFileSafe(filePath) {
+  try {
+    return fs18.readFileSync(filePath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+function phpVendorBin(_cwd, name) {
+  const fileName = process.platform === "win32" ? `${name}.bat` : name;
+  return path50.join("vendor", "bin", fileName);
+}
+function phpVendorBinExists(cwd, name) {
+  const local = path50.join(cwd, "vendor", "bin", name);
+  const localWin = path50.join(cwd, "vendor", "bin", `${name}.bat`);
+  return fs18.existsSync(local) || fs18.existsSync(localWin);
+}
 function detectCheckstyle(cwd) {
   const hasMaven = fs18.existsSync(path50.join(cwd, "pom.xml"));
-  const hasGradle = fs18.existsSync(path50.join(cwd, "build.gradle")) || fs18.existsSync(path50.join(cwd, "build.gradle.kts"));
-  const hasBinary = hasMaven && isCommandAvailable("mvn") || hasGradle && (fs18.existsSync(path50.join(cwd, "gradlew")) || isCommandAvailable("gradle"));
-  return (hasMaven || hasGradle) && hasBinary;
+  const gradleFiles = ["build.gradle", "build.gradle.kts"].map((file) => path50.join(cwd, file)).filter((file) => fs18.existsSync(file));
+  const hasGradleCheckstyleSignal = fs18.existsSync(path50.join(cwd, "checkstyle.xml")) || fs18.existsSync(path50.join(cwd, "config", "checkstyle", "checkstyle.xml")) || gradleFiles.some((file) => /\bcheckstyle\b/i.test(readTextFileSafe(file)));
+  const hasBinary = hasMaven && isCommandAvailable("mvn") || hasGradleCheckstyleSignal && (fs18.existsSync(path50.join(cwd, "gradlew")) || isCommandAvailable("gradle"));
+  return (hasMaven || hasGradleCheckstyleSignal) && hasBinary;
+}
+function hasRootKotlinFile(cwd) {
+  try {
+    return fs18.readdirSync(cwd).some((f) => f.endsWith(".kt") || f.endsWith(".kts"));
+  } catch {
+    return false;
+  }
+}
+function buildGradleHasKotlinSignal(cwd) {
+  const content = readTextFileSafe(path50.join(cwd, "build.gradle"));
+  return /\b(kotlin|org\.jetbrains\.kotlin|ktlint)\b/i.test(content);
 }
 function detectKtlint(cwd) {
-  const hasKotlin = fs18.existsSync(path50.join(cwd, "build.gradle.kts")) || fs18.existsSync(path50.join(cwd, "build.gradle")) || (() => {
-    try {
-      return fs18.readdirSync(cwd).some((f) => f.endsWith(".kt") || f.endsWith(".kts"));
-    } catch {
-      return false;
-    }
-  })();
+  const hasKotlin = fs18.existsSync(path50.join(cwd, "build.gradle.kts")) || fs18.existsSync(path50.join(cwd, "build.gradle")) && buildGradleHasKotlinSignal(cwd) || hasRootKotlinFile(cwd);
   return hasKotlin && isCommandAvailable("ktlint");
 }
+function detectPhpLinter(cwd) {
+  if ((fs18.existsSync(path50.join(cwd, "phpstan.neon")) || fs18.existsSync(path50.join(cwd, "phpstan.neon.dist"))) && phpVendorBinExists(cwd, "phpstan")) {
+    return "phpstan";
+  }
+  if (fs18.existsSync(path50.join(cwd, "pint.json")) && phpVendorBinExists(cwd, "pint")) {
+    return "pint";
+  }
+  if (fs18.existsSync(path50.join(cwd, ".php-cs-fixer.php")) && phpVendorBinExists(cwd, "php-cs-fixer")) {
+    return "php-cs-fixer";
+  }
+  if (fs18.existsSync(path50.join(cwd, "phpcs.xml")) && phpVendorBinExists(cwd, "phpcs")) {
+    return "phpcs";
+  }
+  return null;
+}
 function detectDotnetFormat(cwd) {
   try {
     const files = fs18.readdirSync(cwd);
@@ -24261,10 +24370,13 @@ function detectAdditionalLinter(cwd) {
     return "clippy";
   if (detectGolangciLint(cwd))
     return "golangci-lint";
-  if (detectCheckstyle(cwd))
-    return "checkstyle";
+  const phpLinter = detectPhpLinter(cwd);
+  if (phpLinter)
+    return phpLinter;
   if (detectKtlint(cwd))
     return "ktlint";
+  if (detectCheckstyle(cwd))
+    return "checkstyle";
   if (detectDotnetFormat(cwd))
     return "dotnet-format";
   if (detectCppcheck(cwd))
@@ -25222,9 +25334,68 @@ async function runSecretscan(directory) {
     return errorResult;
   }
 }
+async function runSecretscanOnFiles(files, directory) {
+  try {
+    const findings = [];
+    let filesScanned = 0;
+    let skippedFiles = 0;
+    for (const file of files) {
+      if (typeof file !== "string") {
+        skippedFiles++;
+        continue;
+      }
+      const resolvedPath = path51.isAbsolute(file) ? path51.resolve(file) : path51.resolve(directory, file);
+      if (!isPathWithinScope(resolvedPath, directory)) {
+        skippedFiles++;
+        continue;
+      }
+      const ext = path51.extname(resolvedPath).toLowerCase();
+      if (DEFAULT_EXCLUDE_EXTENSIONS.has(ext)) {
+        skippedFiles++;
+        continue;
+      }
+      if (!fs19.existsSync(resolvedPath)) {
+        skippedFiles++;
+        continue;
+      }
+      const fileFindings = scanFileForSecrets(resolvedPath);
+      filesScanned++;
+      findings.push(...fileFindings);
+      if (findings.length >= MAX_FINDINGS) {
+        findings.length = MAX_FINDINGS;
+        break;
+      }
+    }
+    findings.sort((a, b) => {
+      if (a.path < b.path)
+        return -1;
+      if (a.path > b.path)
+        return 1;
+      return a.line - b.line;
+    });
+    return {
+      scan_dir: directory,
+      findings,
+      count: findings.length,
+      files_scanned: filesScanned,
+      skipped_files: skippedFiles
+    };
+  } catch (e) {
+    return {
+      error: e instanceof Error ? `scan failed: ${e.message}` : "scan failed: unknown error",
+      scan_dir: directory,
+      findings: [],
+      count: 0,
+      files_scanned: 0,
+      skipped_files: 0
+    };
+  }
+}
 var _internals41 = {
   secretscan,
-  runSecretscan
+  runSecretscan,
+  runSecretscanOnFiles,
+  SECRET_PATTERNS: SECRET_PATTERNS2
 };
 
 // src/tools/test-runner.ts
@@ -26401,14 +26572,19 @@ var DISPATCH_FRAMEWORK_MAP = {
   "dart-test": "dart-test",
   rspec: "rspec",
   minitest: "minitest",
+  pest: "pest",
+  phpunit: "phpunit",
+  "php-artisan": "php-artisan",
   "bun:test": "bun",
   "xcodebuild-test": "swift-test",
   "flutter test": "dart-test",
-  "dart test": "dart-test"
+  "dart test": "dart-test",
+  Pest: "pest",
+  PHPUnit: "phpunit"
 };
 async function detectTestFrameworkViaDispatch(cwd) {
   try {
-    const { pickBackend } = await import("./dispatch-e4ejrsz8.js");
+    const { pickBackend } = await import("./dispatch-anmxxhen.js");
     const backend = await pickBackend(cwd);
     if (!backend?.selectTestFramework)
       return "none";
@@ -26424,7 +26600,7 @@ async function buildTestCommandViaDispatch(framework, scope, files, coverage, ba
   if (framework === "none")
     return null;
   try {
-    const { pickBackend } = await import("./dispatch-e4ejrsz8.js");
+    const { pickBackend } = await import("./dispatch-anmxxhen.js");
     const backend = await pickBackend(baseDir);
     if (backend?.buildTestCommand) {
       const cmd = backend.buildTestCommand(framework, files, baseDir, {
@@ -26444,7 +26620,7 @@ async function parseTestOutputViaDispatch(framework, output, baseDir) {
   if (framework === "none")
     return null;
   try {
-    const { pickBackend } = await import("./dispatch-e4ejrsz8.js");
+    const { pickBackend } = await import("./dispatch-anmxxhen.js");
     const backend = await pickBackend(baseDir);
     if (!backend?.parseTestOutput)
       return null;
@@ -26535,6 +26711,9 @@ async function detectTestFramework(cwd) {
       return "pester";
     }
   } catch {}
+  const phpFramework = detectPhpTest(baseDir);
+  if (phpFramework)
+    return phpFramework;
   if (detectGoTest(baseDir))
     return "go-test";
   if (detectJavaMaven(baseDir))
@@ -26555,6 +26734,17 @@ async function detectTestFramework(cwd) {
     return "minitest";
   return "none";
 }
+function detectPhpTest(cwd) {
+  if (fs23.existsSync(path55.join(cwd, "artisan")) && fs23.existsSync(path55.join(cwd, "composer.json"))) {
+    return "php-artisan";
+  }
+  if (fs23.existsSync(path55.join(cwd, "Pest.php")))
+    return "pest";
+  if (fs23.existsSync(path55.join(cwd, "phpunit.xml")) || fs23.existsSync(path55.join(cwd, "phpunit.xml.dist"))) {
+    return "phpunit";
+  }
+  return null;
+}
 var COMPOUND_TEST_EXTENSIONS = [
   ".test.ts",
   ".test.tsx",
@@ -26608,6 +26798,12 @@ function buildLanguageSpecificTestNames(nameWithoutExt, ext) {
         `${nameWithoutExt}Tests.kt`,
         `Test${nameWithoutExt}.kt`
       ];
+    case ".php":
+      return [
+        `${nameWithoutExt}Test.php`,
+        `${nameWithoutExt}Tests.php`,
+        `Test${nameWithoutExt}.php`
+      ];
     case ".ps1":
       return [`${nameWithoutExt}.Tests.ps1`, `${nameWithoutExt}.tests.ps1`];
     default:
@@ -26648,6 +26844,8 @@ function isLanguageSpecificTestFile(basename11) {
     return true;
   if (lower.endsWith(".kt") && (/^Test[A-Z]/.test(basename11) || lower.endsWith("test.kt") || lower.endsWith("tests.kt")))
     return true;
+  if (lower.endsWith(".php") && (/^Test[A-Z]/.test(basename11) || basename11.endsWith("Test.php") || basename11.endsWith("Tests.php")))
+    return true;
   if (lower.endsWith(".tests.ps1"))
     return true;
   return false;
@@ -26945,10 +27143,31 @@ function buildTestCommand(framework, scope, files, coverage, baseDir, bail) {
         "-e",
         'Dir.glob("test/**/*_test.rb").sort.each { |f| require_relative f }'
       ];
+    case "pest": {
+      const args = [phpVendorBin2("pest")];
+      if (scope !== "all" && files.length > 0)
+        args.push(...files);
+      return args;
+    }
+    case "phpunit": {
+      const args = [phpVendorBin2("phpunit")];
+      if (scope !== "all" && files.length > 0)
+        args.push(...files);
+      return args;
+    }
+    case "php-artisan": {
+      const args = ["php", "artisan", "test"];
+      if (scope !== "all" && files.length > 0)
+        args.push(...files);
+      return args;
+    }
     default:
       return null;
   }
 }
+function phpVendorBin2(name) {
+  return path55.join("vendor", "bin", process.platform === "win32" ? `${name}.bat` : name);
+}
 function mapFrameworkStatusToResult(status) {
   if (typeof status !== "string")
     return null;
@@ -27272,6 +27491,24 @@ function parseTestOutput(framework, output) {
       }
       break;
     }
+    case "pest":
+    case "phpunit":
+    case "php-artisan": {
+      const phpunitMatch = output.match(/Tests:\s*(\d+),\s*Assertions:\s*\d+(?:,\s*Failures:\s*(\d+))?(?:,\s*Errors:\s*(\d+))?(?:,\s*Skipped:\s*(\d+))?/);
+      const okMatch = output.match(/OK\s*\((\d+)\s+tests?/);
+      if (phpunitMatch) {
+        totals.total = parseInt(phpunitMatch[1], 10);
+        const failures = phpunitMatch[2] ? parseInt(phpunitMatch[2], 10) : 0;
+        const errors = phpunitMatch[3] ? parseInt(phpunitMatch[3], 10) : 0;
+        totals.skipped = phpunitMatch[4] ? parseInt(phpunitMatch[4], 10) : 0;
+        totals.failed = failures + errors;
+        totals.passed = totals.total - totals.failed - totals.skipped;
+      } else if (okMatch) {
+        totals.total = parseInt(okMatch[1], 10);
+        totals.passed = totals.total;
+      }
+      break;
+    }
     default:
       break;
   }
@@ -27492,6 +27729,7 @@ var SOURCE_EXTENSIONS = new Set([
   ".hpp",
   ".cc",
   ".cxx",
+  ".php",
   ".swift",
   ".dart",
   ".rb",
@@ -32049,7 +32287,7 @@ function buildDetailedHelp(commandName, entry) {
 async function handleHelpCommand(ctx) {
   const targetCommand = ctx.args.join(" ");
   if (!targetCommand) {
-    const { buildHelpText } = await import("./index-502f6np6.js");
+    const { buildHelpText } = await import("./index-19vxtwa6.js");
     return buildHelpText();
   }
   const tokens = targetCommand.split(/\s+/);
@@ -32058,7 +32296,7 @@ async function handleHelpCommand(ctx) {
     return _internals49.buildDetailedHelp(resolved.key, resolved.entry);
   }
   const similar = _internals49.findSimilarCommands(targetCommand);
-  const { buildHelpText: fullHelp } = await import("./index-502f6np6.js");
+  const { buildHelpText: fullHelp } = await import("./index-19vxtwa6.js");
   if (similar.length > 0) {
     return `Command '/swarm ${targetCommand}' not found.
 
@@ -32191,7 +32429,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail explain": {
     handler: async (ctx) => {
-      const { handleGuardrailExplain } = await import("./guardrail-explain-etdrhd4d.js");
+      const { handleGuardrailExplain } = await import("./guardrail-explain-dayy7zw4.js");
       return handleGuardrailExplain(ctx.directory, ctx.args);
     },
     description: "Dry-run: show what the guardrails would do to a command or write target (executes nothing)",
@@ -32201,7 +32439,7 @@ var COMMAND_REGISTRY = {
   },
   "guardrail-log": {
     handler: async (ctx) => {
-      const { handleGuardrailLog } = await import("./guardrail-log-2rns4g6d.js");
+      const { handleGuardrailLog } = await import("./guardrail-log-fjypsmek.js");
       return handleGuardrailLog(ctx.directory, ctx.args);
     },
     description: "Read the guardrail decision log (use --blocks-only for blocks)",
@@ -32803,9 +33041,9 @@ Subcommands:
   },
   "knowledge restore": {
     handler: (ctx) => handleKnowledgeRestoreCommand(ctx.directory, ctx.args),
-    description: "Restore a quarantined knowledge entry <id>",
+    description: "Restore a quarantined or archived knowledge entry <id>",
     subcommandOf: "knowledge",
-    details: "Restores a quarantined knowledge entry back to the active knowledge store by ID. Validates entry ID format (1-64 alphanumeric/hyphen/underscore). Entry must currently be in quarantine state.",
+    details: "Restores a quarantined or archived knowledge entry back to the active knowledge store by ID. Dispatches by current status: an 'archived' entry is restored to its pre-archive status; a 'quarantined' entry is restored from the quarantine sidecar. Validates entry ID format (1-64 alphanumeric/hyphen/underscore).",
     args: "<entry-id>",
     category: "utility"
   },
@@ -37127,7 +37365,7 @@ function hasActiveEpicMode(sessionID) {
 async function rehydratePrSubscriptions(sessionID, directory) {
   const map = new Map;
   try {
-    const { listActive: listActive2 } = await import("./pr-subscriptions-0dpn4epk.js");
+    const { listActive: listActive2 } = await import("./pr-subscriptions-bpvazmsw.js");
     const records = await listActive2(directory);
     for (const record of records) {
       if (record.sessionID !== sessionID)