feat: introduce Forever Mode (Sisyphus, Confucius, and Bicameral Voice)

- Sisyphus: auto-resume timer with schedule_work tool - Confucius: built-in sub-agent for knowledge consolidation before compression - Hippocampus: in-memory short-term memory via background micro-consolidation - Bicameral Voice: proactive knowledge alignment on user input - Archive compression mode for long-running sessions - Onboarding dialog for first-time Forever Mode setup - Refresh system instruction per turn so hippocampus reaches the model
2026-05-14 13:53:02 -07:00 · 2026-03-02 16:39:05 -08:00
parent 0d69f9f7fa
commit 2ed06d69dd
54 changed files with 3351 additions and 677 deletions
@@ -0,0 +1,112 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type { Config } from '../config/config.js';
+import type { LocalAgentDefinition } from './types.js';
+
+const CONFUCIUS_SYSTEM_PROMPT = `
+# Task: Self-Reflection & Knowledge Solidification (Confucius Mode)
+
+As an autonomous agent, your goal is to consolidate short-term memory into
+durable, auto-loaded context.
+
+**CRITICAL CONSTRAINT:** Only \`GEMINI.md\` is automatically loaded into every
+conversation's context. Files in \`.gemini/knowledge/\` are NOT auto-loaded — the
+model must explicitly \`read_file\` them, which is unreliable. Therefore you MUST
+prioritize writing essential knowledge directly into \`GEMINI.md\`.
+
+## 吾日三省吾身 (I reflect on myself three times a day)
+
+1. **Review Mission & Objectives:** Read \`GEMINI.md\` to ground yourself in the
+   current high-level goals.
+2. **Analyze Recent Activity:** Review the input context provided to you. This
+   contains short-term memory (hippocampus) entries — factual takeaways from
+   recent agent activity.
+3. **Knowledge Retrieval:** Read the current contents of \`.gemini/knowledge/\` if
+   it exists.
+4. **Environment Cleanup:** Identify and delete temporary files, experimental
+   drafts, or non-deterministic artifacts. A lean workspace is a productive
+   workspace.
+
+## 知之为知之，不知为不知，是知也 (To know what you know and what you do not know, that is true knowledge)
+
+1. **Knowledge Solidification (知之为知之):**
+   - **\`GEMINI.md\` is the primary target.** Update it with critical project
+     facts, rules, architectural decisions, and lessons learned. This is the
+     ONLY file guaranteed to appear in every future context.
+   - **Keep \`GEMINI.md\` concise.** Every word consumes context tokens.
+     Ruthlessly edit for brevity. Remove stale details. Preserve existing
+     frontmatter.
+   - **\`.gemini/knowledge/\` is secondary storage** for reusable scripts,
+     detailed docs, or reference material too verbose for \`GEMINI.md\`. Add a
+     brief pointer in \`GEMINI.md\` so the model knows to read it when relevant.
+   - **Automated:** Solidify verified, repeatable knowledge (build commands,
+     test patterns, env setup) as scripts in \`.gemini/knowledge/\`.
+   - **Indexed:** Document every script in \`.gemini/knowledge/README.md\`.
+2. **Acknowledge Limitations (不知为不知):**
+   - Document known anti-patterns, flaky approaches, or persistent failures in
+     \`GEMINI.md\` to avoid repeating mistakes.
+   - **Self-Correction:** For persistent failures, add a "Lesson Learned" entry
+     directly in \`GEMINI.md\` under a dedicated section.
+     - **Format:** Ultra-brief. "**[Topic]** Tried X, fails because Y. Must do Z
+       instead."
+     - **Deduplicate:** Check for existing entries before adding. Update rather
+       than duplicate.
+
+## Version Control
+
+- After updating your knowledge base, commit changes to version control.
+- If \`.gemini\` is not a git repo, run \`git init\` inside it first.
+- Run \`git add . && git commit -m "chore(memory): update"\` inside \`.gemini\`. Do
+  not commit the main project.
+
+Your reflection should be thorough, honest, and efficient.
+`.trim();
+
+/**
+ * Built-in agent for knowledge consolidation in Forever Mode.
+ * Consolidates short-term memory (hippocampus) into durable long-term
+ * knowledge (GEMINI.md) before context compression occurs.
+ */
+export const ConfuciusAgent = (config: Config): LocalAgentDefinition => ({
+  kind: 'local',
+  name: 'confucius',
+  displayName: 'Confucius',
+  description:
+    'Trigger a self-reflection cycle to consolidate short-term memory into long-term knowledge. Use this when you have accumulated significant learnings, or before a context compression to preserve important knowledge.',
+  inputConfig: {
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'The task for the agent.',
+        },
+      },
+      required: [],
+    },
+  },
+  modelConfig: {
+    model: config.getActiveModel(),
+  },
+  toolConfig: {
+    tools: [
+      'read_file',
+      'write_file',
+      'list_directory',
+      'run_shell_command',
+      'grep_search',
+    ],
+  },
+  promptConfig: {
+    systemPrompt: CONFUCIUS_SYSTEM_PROMPT,
+    query: '${query}',
+  },
+  runConfig: {
+    maxTimeMinutes: 15,
+    maxTurns: 30,
+  },
+});