pantheon-opencode 1.6.0-beta.14 → 1.6.0-beta.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/AGENTS.global.md +8 -10
  2. package/AGENTS.md +1 -1
  3. package/CHANGELOG.md +62 -3
  4. package/README.md +155 -24
  5. package/README.pt-BR.md +14 -14
  6. package/package.json +3 -3
  7. package/plugin.json +1 -1
  8. package/pyproject.toml +1 -1
  9. package/scripts/_pantheon_paths.py +24 -0
  10. package/scripts/doctor.mjs +7 -2
  11. package/scripts/install-mcp.mjs +1 -1
  12. package/scripts/mcp_persistence.py +1260 -1017
  13. package/scripts/memory_mcp.py +12 -843
  14. package/scripts/test-opencode-v2-sandbox.sh +2 -115
  15. package/skills-lock.json +3 -3
  16. package/src/agents/aphrodite.md +11 -10
  17. package/src/agents/apollo.md +1 -2
  18. package/src/agents/athena.md +13 -13
  19. package/src/agents/demeter.md +10 -7
  20. package/src/agents/gaia.md +0 -1
  21. package/src/agents/hephaestus.md +4 -3
  22. package/src/agents/hermes.md +10 -9
  23. package/src/agents/iris.md +0 -1
  24. package/src/agents/mnemosyne.md +3 -2
  25. package/src/agents/nyx.md +4 -4
  26. package/src/agents/prometheus.md +12 -11
  27. package/src/agents/zeus.md +27 -2
  28. package/src/instructions/agent-return-format.instructions.md +7 -9
  29. package/src/instructions/zeus-council-synthesis.instructions.md +2 -2
  30. package/src/instructions/zeus-memory-operations.instructions.md +9 -1
  31. package/src/instructions/zeus-timeout-retry.instructions.md +8 -1
  32. package/src/mcp/_pantheon_paths.py +24 -0
  33. package/src/mcp/mcp_codemap_module.py +86 -18
  34. package/src/mcp/mcp_persistence.py +1260 -1017
  35. package/src/mcp/memory_mcp.py +101 -57
  36. package/src/pantheon/goal-loop.ts +11 -8
  37. package/src/pantheon/task-result-guard.ts +50 -14
  38. package/src/pantheon/v2-execute-after.ts +135 -24
  39. package/src/pantheon/v2-tools.ts +10 -1
  40. package/src/plugin-v2.ts +6 -4
  41. package/src/plugin.ts +3 -2
  42. package/src/plugins/tui/dist/tui-v2.js +2 -2
  43. package/src/plugins/tui/dist/tui.js +1 -1
  44. package/src/plugins/tui/package-lock.json +2 -2
  45. package/src/plugins/tui/package.json +1 -1
  46. package/src/routing.yml +4 -4
  47. package/src/skills/codemap/SKILL.md +1 -1
  48. package/src/skills/memory-bank/SKILL.md +17 -13
  49. package/src/skills/session-goal/SKILL.md +12 -22
  50. package/scripts/probe-context-rehydrate.mjs +0 -263
@@ -4,7 +4,7 @@
4
4
  *
5
5
  * V1 (`src/plugin.ts`) wires a single `tool.execute.after` handler that runs,
6
6
  * in order:
7
- * 1. task-result-guard — an empty native `task()` result becomes an explicit
7
+ * 1. task-result-guard — an empty child-dispatch result becomes an explicit
8
8
  * error so the parent LLM cannot read silence as success;
9
9
  * 2. context-sandbox — oversized read/grep/glob/webfetch output is truncated
10
10
  * with a marker + metadata;
@@ -40,7 +40,11 @@ import {
40
40
  DEFAULT_CONFIG as SANDBOX_DEFAULT_CONFIG,
41
41
  } from './context-sandbox.ts'
42
42
  import { createReadEnhancer } from './hashline/read-enhancer.ts'
43
- import { createTaskResultGuard } from './task-result-guard.ts'
43
+ import {
44
+ createTaskResultGuard,
45
+ HOST_EMPTY_RESULT_TEXT,
46
+ isChildDispatchTool,
47
+ } from './task-result-guard.ts'
44
48
 
45
49
  /** The `Tool.Result` fields this adapter reads and writes back. */
46
50
  export interface V2ToolResult {
@@ -69,22 +73,41 @@ export interface V2ExecuteAfterOptions {
69
73
  }
70
74
 
71
75
  /** Which `Tool.Result` field carries the (mutable) text this adapter enhances. */
72
- type TextField = 'output' | 'content' | 'content-array'
76
+ type TextField = 'output' | 'content' | 'content-array' | 'child-output-envelope'
73
77
 
74
78
  /**
75
79
  * Extract the mutable text from a `Tool.Result`.
76
80
  *
77
- * Preference order mirrors what a session renders: a declared string `output`
78
- * first, then a string `content`, then the concatenation of `content` text
79
- * parts. A `content` array containing non-text (file) parts is deliberately NOT
80
- * enhanced — replacing it would corrupt the structured payload, so it is
81
- * reported as unextractable and the whole event becomes a no-op.
81
+ * Prefer non-empty `output`, then `content`, and use an empty `output` only as
82
+ * a fallback. A content array containing non-text (file) parts is deliberately
83
+ * not enhanced because replacing it would corrupt the structured payload.
82
84
  *
83
85
  * @returns `{ text, field }` or `null` when there is nothing to enhance.
84
86
  */
85
- function extractText(result: V2ToolResult): { text: string; field: TextField } | null {
86
- if (typeof result.output === 'string') return { text: result.output, field: 'output' }
87
- if (typeof result.content === 'string') return { text: result.content, field: 'content' }
87
+ function extractText(
88
+ result: V2ToolResult,
89
+ tool: string,
90
+ ): { text: string; field: TextField } | null {
91
+ // OpenCode 2.0.30's native `subagent` result wraps the effective output in
92
+ // result.output.output, while result.content also carries a display wrapper.
93
+ // Prefer that child-only envelope over the non-empty wrapper text, otherwise
94
+ // the exact host empty-result sentinel is hidden from the task guard.
95
+ const childOutput =
96
+ isChildDispatchTool(tool) &&
97
+ result.output !== null &&
98
+ typeof result.output === 'object' &&
99
+ !Array.isArray(result.output)
100
+ ? (result.output as { output?: unknown }).output
101
+ : undefined
102
+ if (typeof childOutput === 'string' && childOutput.trim() !== '') {
103
+ return { text: childOutput, field: 'child-output-envelope' }
104
+ }
105
+ if (typeof result.output === 'string' && result.output.trim() !== '') {
106
+ return { text: result.output, field: 'output' }
107
+ }
108
+ if (typeof result.content === 'string' && result.content.trim() !== '') {
109
+ return { text: result.content, field: 'content' }
110
+ }
88
111
  if (Array.isArray(result.content)) {
89
112
  const parts = result.content
90
113
  const allText = parts.every(
@@ -94,22 +117,98 @@ function extractText(result: V2ToolResult): { text: string; field: TextField } |
94
117
  const text = parts
95
118
  .map((part) => (typeof part === 'string' ? part : ((part as { text?: string }).text ?? '')))
96
119
  .join('\n')
97
- return { text, field: 'content-array' }
120
+ if (text.trim() !== '') return { text, field: 'content-array' }
121
+ }
122
+ if (typeof result.output === 'string') return { text: result.output, field: 'output' }
123
+ if (typeof childOutput === 'string') {
124
+ return { text: childOutput, field: 'child-output-envelope' }
98
125
  }
99
126
  return null
100
127
  }
101
128
 
102
- /**
103
- * Write enhanced text back into the SAME field it came from, preserving the
104
- * result's other fields.
105
- */
106
- function writeText(result: V2ToolResult, field: TextField, text: string): void {
129
+ /** Whether content includes an attachment or meaningful object-form text. */
130
+ function hasMeaningfulStructuredContent(content: unknown): boolean {
131
+ if (Array.isArray(content)) {
132
+ return content.some((part) => {
133
+ if (typeof part === 'string') return false
134
+ return (
135
+ part === null || typeof part !== 'object' || (part as { type?: unknown }).type !== 'text'
136
+ )
137
+ })
138
+ }
139
+
140
+ if (content !== null && typeof content === 'object') {
141
+ const part = content as { type?: unknown; text?: unknown }
142
+ return part.type === 'text'
143
+ ? typeof part.text === 'string' && part.text.trim() !== ''
144
+ : Object.keys(content).length > 0
145
+ }
146
+
147
+ return false
148
+ }
149
+
150
+ /** Keep the duplicate child content view synchronized without changing attachments. */
151
+ function rewriteChildContentMirror(
152
+ content: unknown,
153
+ originalText: string,
154
+ replacement: string,
155
+ ): unknown {
156
+ const isHostPlaceholder = originalText.trim() === HOST_EMPTY_RESULT_TEXT
157
+ const matches = (value: unknown): value is string =>
158
+ typeof value === 'string' &&
159
+ (isHostPlaceholder
160
+ ? value.includes(HOST_EMPTY_RESULT_TEXT)
161
+ : originalText.trim() === '' && value.trim() === '')
162
+
163
+ if (typeof content === 'string') return matches(content) ? replacement : content
164
+ if (Array.isArray(content)) {
165
+ return content.map((part) => {
166
+ if (typeof part === 'string') return matches(part) ? replacement : part
167
+ if (
168
+ part !== null &&
169
+ typeof part === 'object' &&
170
+ (part as { type?: unknown }).type === 'text' &&
171
+ matches((part as { text?: unknown }).text)
172
+ ) {
173
+ return { ...part, text: replacement }
174
+ }
175
+ return part
176
+ })
177
+ }
178
+ if (
179
+ content !== null &&
180
+ typeof content === 'object' &&
181
+ (content as { type?: unknown }).type === 'text' &&
182
+ matches((content as { text?: unknown }).text)
183
+ ) {
184
+ return { ...content, text: replacement }
185
+ }
186
+ return content
187
+ }
188
+
189
+ /** Write enhanced text back into its original result field. */
190
+ function writeText(
191
+ result: V2ToolResult,
192
+ field: TextField,
193
+ text: string,
194
+ originalText: string,
195
+ tool: string,
196
+ ): void {
107
197
  if (field === 'output') {
108
198
  result.output = text
109
199
  } else if (field === 'content') {
110
200
  result.content = text
111
- } else {
201
+ } else if (field === 'content-array') {
112
202
  result.content = [{ type: 'text', text }]
203
+ } else {
204
+ const envelope = result.output as { output?: unknown }
205
+ envelope.output = text
206
+ }
207
+ // Native subagent results expose both an output envelope and display content.
208
+ // Keep the parent-visible text aligned, replacing only blank text or text
209
+ // containing the exact known host sentinel; all non-text parts are preserved.
210
+ if (isChildDispatchTool(tool) && field !== 'content' && field !== 'content-array') {
211
+ result.content = rewriteChildContentMirror(result.content, originalText, text)
113
212
  }
114
213
  }
115
214
 
@@ -141,11 +240,23 @@ export function createV2ExecuteAfter(
141
240
  const sessionID = typeof payload.sessionID === 'string' ? payload.sessionID : ''
142
241
  const callID = typeof payload.id === 'string' ? payload.id : ''
143
242
 
144
- const extracted = extractText(result as V2ToolResult)
145
- // A `task` result may carry no text at all — that IS the empty-result
146
- // failure the guard exists to surface, so synthesize an empty string and
147
- // let the guard replace it. Other tools with no text are a no-op.
148
- if (extracted === null && tool !== 'task') return
243
+ const extracted = extractText(result as V2ToolResult, tool)
244
+ // Preserve meaningful non-text structured payloads (file/image/etc.) and
245
+ // non-empty object-form text parts. Empty text-only content, whether an
246
+ // array of text parts or a single object-form text part, must reach the
247
+ // child-dispatch guard below instead of bypassing it.
248
+ const resultContent = (result as V2ToolResult).content
249
+ if (
250
+ hasMeaningfulStructuredContent(resultContent) &&
251
+ (extracted === null || extracted.text.trim() === '')
252
+ ) {
253
+ return
254
+ }
255
+ // Child-dispatch results with no text or structured payload are empty;
256
+ // other tools with no text remain a no-op. The label set is the guard's
257
+ // own set, so a label the guard handles cannot be dropped before the
258
+ // guard sees it.
259
+ if (extracted === null && !isChildDispatchTool(tool)) return
149
260
  const original = extracted === null ? { text: '', field: 'output' as TextField } : extracted
150
261
 
151
262
  const input = { tool, sessionID, callID, args: payload.input }
@@ -159,7 +270,7 @@ export function createV2ExecuteAfter(
159
270
  await readEnhancer(input, output)
160
271
 
161
272
  if (output.output !== original.text) {
162
- writeText(result as V2ToolResult, original.field, output.output)
273
+ writeText(result as V2ToolResult, original.field, output.output, original.text, tool)
163
274
  }
164
275
  // Surface sandbox metadata onto the result (merge, never replace). It is
165
276
  // only present when the sandbox actually truncated something.
@@ -2,7 +2,7 @@
2
2
  * V2 tool surface — the Pantheon tools that are self-sufficient on the
3
3
  * OpenCode V2 host, declared for `ctx.tool.transform`'s `draft.add`.
4
4
  *
5
- * ## Why only three tools
5
+ * ## Why only three unconditional tools
6
6
  *
7
7
  * A V2 tool can only be served here when it needs no V1 infrastructure. The
8
8
  * three goal tools (`pantheon_goal_create`, `pantheon_goal_get`,
@@ -18,6 +18,15 @@
18
18
  * `pantheon_model` (reads/writes `active-preset.json`) need none of that, so
19
19
  * they are wired to their real V1 implementations.
20
20
  *
21
+ * ## Three unconditional tools, up to two host-dependent ones
22
+ *
23
+ * The three above are always built. Two more exist on the V2 host and are
24
+ * conditional: `vision_describe` is added here when the caller supplies a
25
+ * vision runtime (the host model catalog), and `pantheon_bounded_read` is
26
+ * appended by the plugin when the host exposes its permission and session APIs
27
+ * (root Zeus sessions only). The effective count is therefore 3 unconditional
28
+ * plus up to 2 host-dependent — never a flat 3.
29
+ *
21
30
  * ## The output declaration is mandatory
22
31
  *
23
32
  * The host enforces a biconditional between a tool's declared `output` and the
package/src/plugin-v2.ts CHANGED
@@ -2,10 +2,12 @@
2
2
  * Pantheon V2 Plugin — full orchestration plugin for OpenCode V2.
3
3
  *
4
4
  * Registers:
5
- * - 3 self-sufficient tools via V2 tool.transform (hashline_edit,
6
- * pantheon_cost, pantheon_model) plus native `vision_describe` when the host
7
- * exposes the V2 model catalog; Vision resolves OpenCode Zen auth and sends
8
- * images directly to the selected multimodal model.
5
+ * - 3 unconditional self-sufficient tools via V2 tool.transform (hashline_edit,
6
+ * pantheon_cost, pantheon_model) plus up to 2 host-dependent ones: native
7
+ * `vision_describe` when the host exposes the V2 model catalog (it resolves
8
+ * OpenCode Zen auth and sends images directly to the selected multimodal
9
+ * model), and `pantheon_bounded_read` when the host exposes its permission
10
+ * and session APIs (root Zeus sessions only).
9
11
  * The goal tools need V1 infrastructure and are absent from this surface.
10
12
  * - 5 event subscriptions (session.created, idle, deleted, error, compacted)
11
13
  * - Session hooks (prompt, context, compaction)
package/src/plugin.ts CHANGED
@@ -300,8 +300,9 @@ const plugin: Plugin = async (input: PluginInput) => {
300
300
  client: adaptTodoEnforcerClient(input.client),
301
301
  })
302
302
 
303
- // Wave 3 (PR #46): full-auto goal loop — opt-in (`full_auto.enabled:
304
- // false` default, mirrored by GOAL_LOOP_DEFAULTS). File-based GoalStore
303
+ // Wave 3 (PR #46): goal loop. The plugin uses hard-coded GOAL_LOOP_DEFAULTS;
304
+ // routing.yml documents defaults/guards but no runtime config enables the
305
+ // loop in this build. File-based GoalStore
305
306
  // (`.pantheon/goals/<sessionID>.json` — the plugin layer cannot reach MCP
306
307
  // KV). Idle routing: an active goal owns the idle (goal loop); otherwise
307
308
  // the todo enforcer gets it (see idle-continuation.ts).
@@ -477,7 +477,7 @@ function Sidebar(props) {
477
477
  setProp(_el$, "width", "100%");
478
478
  setProp(_el$, "padding", 1);
479
479
  setProp(_el$2, "attributes", 1);
480
- insert(_el$2, `Pantheon v1.6.0-beta.14`);
480
+ insert(_el$2, `Pantheon v1.6.0-beta.17`);
481
481
  insertNode(_el$3, createTextNode(`OpenCode V2 · plugin TUI ativo`));
482
482
  insert(_el$, createComponent(Show, {
483
483
  get when() {
@@ -623,7 +623,7 @@ function HomeStatus(props) {
623
623
  const muted = () => props.context.theme?.text?.muted ?? props.context.theme?.text?.base;
624
624
  return (() => {
625
625
  var _el$20 = createElement("text");
626
- insert(_el$20, () => `Pantheon v1.6.0-beta.14${preset().name ? ` ⚡ ${preset().name}` : ""}`);
626
+ insert(_el$20, () => `Pantheon v1.6.0-beta.17${preset().name ? ` ⚡ ${preset().name}` : ""}`);
627
627
  effect((_$p) => setProp(_el$20, "fg", muted(), _$p));
628
628
  return _el$20;
629
629
  })();
@@ -167,7 +167,7 @@ async function detectVersion(api) {
167
167
  if (ver) return ver;
168
168
  }
169
169
  } catch {}
170
- return "1.6.0-beta.14";
170
+ return "1.6.0-beta.17";
171
171
  }
172
172
  /**
173
173
  * usage-bar — AI subscription usage gauge for the opencode TUI.
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "pantheon-tui",
3
- "version": "1.6.0-beta.14",
3
+ "version": "1.6.0-beta.17",
4
4
  "lockfileVersion": 3,
5
5
  "requires": true,
6
6
  "packages": {
7
7
  "": {
8
8
  "name": "pantheon-tui",
9
- "version": "1.6.0-beta.14",
9
+ "version": "1.6.0-beta.17",
10
10
  "license": "MIT",
11
11
  "dependencies": {
12
12
  "@opencode-ai/plugin": "1.18.33",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "pantheon-tui",
3
3
  "type": "module",
4
- "version": "1.6.0-beta.14",
4
+ "version": "1.6.0-beta.17",
5
5
  "description": "Pantheon TUI plugin — V1 rich sidebar and usage gauges; native V2 status, session and delegation sidebar",
6
6
  "license": "MIT",
7
7
  "engines": {
package/src/routing.yml CHANGED
@@ -596,12 +596,12 @@ hashline:
596
596
  # with per-line sha256 tags (12#XJ|content); hashline_edit anchors edits to
597
597
  # those refs. Documentation mirror — the plugin resolves behavior in code.
598
598
  full_auto:
599
- enabled: false # opt-in: goal continuations are OFF by default
600
- max_continuations: 25 # hard cap on goal continuations per session
599
+ enabled: false # Documentation only; no runtime config enables the loop in this build.
600
+ max_continuations: 25 # Documented hard cap; routing.yml is not loaded for loop settings.
601
601
  # Full-auto only continues a task/scope explicitly authorized by the user.
602
602
  # It never authorizes auth/security gates, risky data/schema or destructive
603
603
  # operations, global config, broad permissions, production deploy, push, or merge.
604
604
  # Low-risk execution is proportional: no forced plan/discovery/council/artifact
605
- # for a bounded fix; use focused verification. Documentation mirror — runtime
606
- # behavior is implemented in the plugin (GOAL_LOOP_DEFAULTS).
605
+ # for a bounded fix; use focused verification. This section documents guards
606
+ # and defaults only; the plugin uses GOAL_LOOP_DEFAULTS directly.
607
607
  # Wave 3 (PR #46): one active goal per session (pending → in_progress → done).
@@ -50,5 +50,5 @@ Generate a hierarchical map of the codebase to understand its structure, key mod
50
50
  Antes de glob/grep manual, tente `code_query`:
51
51
  - `code_query("MyClass")` → busca FTS5 por entidade
52
52
  - Fallback para glob/grep se não indexado ou query vazia
53
- - `code_index("src/")` para indexação incremental (hash-based, skip se não mudou, force=true para re-index)
53
+ - `code_index` não está disponível sob os grants atuais: nenhum agente recebeu essa permissão. Os resultados de consulta dependem de um índice já existente.
54
54
  - `code_neighbors(entity_id, depth=2)` para grafo de imports/calls
@@ -12,12 +12,19 @@ Complete guide to Pantheon memory bank — structure, rules, optimization, and m
12
12
 
13
13
  ---
14
14
 
15
- ## Two-System Model
15
+ ## Actual Storage Model
16
16
 
17
17
  | System | Where | Owner | Lifetime | Purpose |
18
18
  |--------|-------|-------|----------|---------|
19
- | **Memory Bank** | `.pantheon/memory-bank/` | Team | Files persist in the working tree; Git tracking depends on repository ignore/commit policy | Project context: architecture, patterns, progress |
20
- | **VS Code `/memories/`** | `.vscode/` or workspace | Agent | Session/repo scoped | Atomic facts, conversation plans |
19
+ | **Durable Memory** | `pantheon-memory` MCP (SQLite `memory.db`) | Agents with the relevant tool grant | No entry TTL; retained until explicitly forgotten | Reusable facts and decisions |
20
+ | **Persistence** | `pantheon-persistence` MCP | Agents with the relevant tool grant | Optional, separate checkpoint/KV store; checkpoint TTLs apply | Explicit session/workflow checkpoints and temporary state |
21
+ | **Memory Bank** | `.pantheon/memory-bank/` | Team | Files persist in the working tree; Git tracking depends on repository ignore/commit policy | Project context: architecture, patterns, progress, ADRs |
22
+
23
+ Pantheon does not implement `/memories/repo/` or `/memories/session/` stores.
24
+ Memory Bank files are read explicitly or on demand through
25
+ `pantheon://memory-bank/{path}` from `pantheon-resources`; they are not
26
+ auto-loaded. Memory namespaces are organizational filters, not access-control
27
+ boundaries, and tools are available only when the active agent is granted them.
21
28
 
22
29
  ---
23
30
 
@@ -68,13 +75,9 @@ committed under the repository's policy are shared through Git.
68
75
 
69
76
  ---
70
77
 
71
- ## Session → Active Context Graduation
78
+ ## Session → Project Context Graduation
72
79
 
73
80
  ```
74
- During sprint:
75
- Athena writes plan → /memories/session/sprint-plan.md (ephemeral)
76
- Agents track wip → /memories/session/wip.md (ephemeral)
77
-
78
81
  At sprint close:
79
82
  @mnemosyne consolidates → .pantheon/memory-bank/01-active-context.md
80
83
  → .pantheon/memory-bank/02-progress-log.md (appended)
@@ -91,8 +94,9 @@ At sprint close:
91
94
  | Milestone completions | Any agent | `02-progress-log.md` (append) |
92
95
  | Task records | Mnemosyne (on request) | `_tasks/TASK000X-*.md` |
93
96
  | Architecture decisions | Mnemosyne (on request) | `_notes/NOTE000X-*.md` |
94
- | Atomic facts | Any agent | `/memories/repo/` |
95
- | Conversation plans | Athena / any agent | `/memories/session/` |
97
+ | Reusable durable fact or decision | Agent with explicit `memory_store` grant, when retention is warranted | `pantheon-memory` |
98
+ | Conversation-only goal | Current session instructions / `/pantheon-focus` | Not durable; no `/memories/session/` store |
99
+ | Project narrative and ADRs | Mnemosyne on explicit request | `.pantheon/memory-bank/` |
96
100
 
97
101
  ---
98
102
 
@@ -147,10 +151,10 @@ At sprint close → explicit @mnemosyne invocation
147
151
 
148
152
  ### ❌ Duplicating information
149
153
  ```
150
- # Wrong: Stack in 00-project.md AND /memories/repo/stack.json
154
+ # Wrong: duplicate the same fact in both durable Memory and a project document
151
155
 
152
- # Right: Atomic facts → /memories/repo/ (auto-loaded)
153
- Narrative context → 00-project.md (explicit read)
156
+ # Right: Durable reusable fact → pantheon-memory (when warranted and granted)
157
+ Narrative context → 00-project.md (read on demand)
154
158
  ```
155
159
 
156
160
  ---
@@ -72,28 +72,18 @@ Before each major delegation or decision, run this quick check:
72
72
 
73
73
  ## Cross-Session Continuity
74
74
 
75
- V2 does not provide durable goal tools. `/pantheon-focus` only anchors the current
76
- conversation and must not be described as surviving compaction or a new
77
- session. For multi-phase work that needs persistent checkpoints, use
78
- `/pantheon-deepwork`; otherwise ask before writing a goal to a project file.
79
-
80
- In V1, use the implemented goal tools when they are available and explicitly
81
- authorized. Do not infer that their presence in one host generation means they
82
- exist in V2.
83
-
84
- Historical path example (not a V2 runtime command):
85
-
86
- ```
87
- /memories/session/current-goal.md
88
-
89
- # Active Session Goal
90
- Goal: Implement JWT authentication
91
- Started: 2026-05-15
92
- Status: Phase 2 of 3 (backend done, frontend in progress)
93
- Next: POST /auth/refresh endpoint
94
- ```
95
-
96
- This file-based approach requires explicit authorization and is not automatic.
75
+ The V2 plugin does not register the V1 `pantheon_goal_*` tools. `/pantheon-focus`
76
+ only anchors the current conversation and must not be described as surviving
77
+ compaction or a new session. For multi-phase work that needs persistent
78
+ checkpoints, use `/pantheon-deepwork`; otherwise ask before writing a goal to a
79
+ project file.
80
+
81
+ Pantheon does not implement a `/memories/session/` filesystem store. The V1
82
+ goal tools are deprecated legacy manual record tools: stored goals are not
83
+ automatically continued in the current build. Durable manual goals are
84
+ available through the separate Persistence MCP `goal_*` surface in this branch;
85
+ do not present it as released or as part of the V2 plugin. `/pantheon-focus`
86
+ remains a non-persistent conversation anchor.
97
87
 
98
88
  ---
99
89