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/constants/systemPromptSections.ts

@@ -0,0 +1,68 @@
+import {
+  clearBetaHeaderLatches,
+  clearSystemPromptSectionState,
+  getSystemPromptSectionCache,
+  setSystemPromptSectionCacheEntry,
+} from '../bootstrap/state.js'
+
+type ComputeFn = () => string | null | Promise<string | null>
+
+type SystemPromptSection = {
+  name: string
+  compute: ComputeFn
+  cacheBreak: boolean
+}
+
+/**
+ * Create a memoized system prompt section.
+ * Computed once, cached until /clear or /compact.
+ */
+export function systemPromptSection(
+  name: string,
+  compute: ComputeFn,
+): SystemPromptSection {
+  return { name, compute, cacheBreak: false }
+}
+
+/**
+ * Create a volatile system prompt section that recomputes every turn.
+ * This WILL break the prompt cache when the value changes.
+ * Requires a reason explaining why cache-breaking is necessary.
+ */
+export function DANGEROUS_uncachedSystemPromptSection(
+  name: string,
+  compute: ComputeFn,
+  _reason: string,
+): SystemPromptSection {
+  return { name, compute, cacheBreak: true }
+}
+
+/**
+ * Resolve all system prompt sections, returning prompt strings.
+ */
+export async function resolveSystemPromptSections(
+  sections: SystemPromptSection[],
+): Promise<(string | null)[]> {
+  const cache = getSystemPromptSectionCache()
+
+  return Promise.all(
+    sections.map(async s => {
+      if (!s.cacheBreak && cache.has(s.name)) {
+        return cache.get(s.name) ?? null
+      }
+      const value = await s.compute()
+      setSystemPromptSectionCacheEntry(s.name, value)
+      return value
+    }),
+  )
+}
+
+/**
+ * Clear all system prompt section state. Called on /clear and /compact.
+ * Also resets beta header latches so a fresh conversation gets fresh
+ * evaluation of AFK/fast-mode/cache-editing headers.
+ */
+export function clearSystemPromptSections(): void {
+  clearSystemPromptSectionState()
+  clearBetaHeaderLatches()
+}