asdf

Squash the current repository state back into one baseline commit while
preserving the README reframing and repository contents.

Constraint: User explicitly requested a single squashed commit with subject "asdf"
Confidence: high
Scope-risk: broad
Reversibility: clean
Directive: This commit intentionally rewrites published history; coordinate before future force-pushes
Tested: git status clean; local history rewritten to one commit; force-pushed main to origin and instructkr
Not-tested: Fresh clone verification after push

src/utils/statusNoticeHelpers.ts

@@ -0,0 +1,20 @@
+import { roughTokenCountEstimation } from '../services/tokenEstimation.js'
+import type { AgentDefinitionsResult } from '../tools/AgentTool/loadAgentsDir.js'
+
+export const AGENT_DESCRIPTIONS_THRESHOLD = 15_000
+
+/**
+ * Calculate cumulative token estimate for agent descriptions
+ */
+export function getAgentDescriptionsTotalTokens(
+  agentDefinitions?: AgentDefinitionsResult,
+): number {
+  if (!agentDefinitions) return 0
+
+  return agentDefinitions.activeAgents
+    .filter(a => a.source !== 'built-in')
+    .reduce((total, agent) => {
+      const description = `${agent.agentType}: ${agent.whenToUse}`
+      return total + roughTokenCountEstimation(description)
+    }, 0)
+}