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.
- package/AGENTS.global.md +8 -10
- package/AGENTS.md +1 -1
- package/CHANGELOG.md +62 -3
- package/README.md +155 -24
- package/README.pt-BR.md +14 -14
- package/package.json +3 -3
- package/plugin.json +1 -1
- package/pyproject.toml +1 -1
- package/scripts/_pantheon_paths.py +24 -0
- package/scripts/doctor.mjs +7 -2
- package/scripts/install-mcp.mjs +1 -1
- package/scripts/mcp_persistence.py +1260 -1017
- package/scripts/memory_mcp.py +12 -843
- package/scripts/test-opencode-v2-sandbox.sh +2 -115
- package/skills-lock.json +3 -3
- package/src/agents/aphrodite.md +11 -10
- package/src/agents/apollo.md +1 -2
- package/src/agents/athena.md +13 -13
- package/src/agents/demeter.md +10 -7
- package/src/agents/gaia.md +0 -1
- package/src/agents/hephaestus.md +4 -3
- package/src/agents/hermes.md +10 -9
- package/src/agents/iris.md +0 -1
- package/src/agents/mnemosyne.md +3 -2
- package/src/agents/nyx.md +4 -4
- package/src/agents/prometheus.md +12 -11
- package/src/agents/zeus.md +27 -2
- package/src/instructions/agent-return-format.instructions.md +7 -9
- package/src/instructions/zeus-council-synthesis.instructions.md +2 -2
- package/src/instructions/zeus-memory-operations.instructions.md +9 -1
- package/src/instructions/zeus-timeout-retry.instructions.md +8 -1
- package/src/mcp/_pantheon_paths.py +24 -0
- package/src/mcp/mcp_codemap_module.py +86 -18
- package/src/mcp/mcp_persistence.py +1260 -1017
- package/src/mcp/memory_mcp.py +101 -57
- package/src/pantheon/goal-loop.ts +11 -8
- package/src/pantheon/task-result-guard.ts +50 -14
- package/src/pantheon/v2-execute-after.ts +135 -24
- package/src/pantheon/v2-tools.ts +10 -1
- package/src/plugin-v2.ts +6 -4
- package/src/plugin.ts +3 -2
- package/src/plugins/tui/dist/tui-v2.js +2 -2
- package/src/plugins/tui/dist/tui.js +1 -1
- package/src/plugins/tui/package-lock.json +2 -2
- package/src/plugins/tui/package.json +1 -1
- package/src/routing.yml +4 -4
- package/src/skills/codemap/SKILL.md +1 -1
- package/src/skills/memory-bank/SKILL.md +17 -13
- package/src/skills/session-goal/SKILL.md +12 -22
- 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
|
|
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 {
|
|
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
|
-
*
|
|
78
|
-
*
|
|
79
|
-
*
|
|
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(
|
|
86
|
-
|
|
87
|
-
|
|
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
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
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
|
-
//
|
|
146
|
-
//
|
|
147
|
-
//
|
|
148
|
-
|
|
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.
|
package/src/pantheon/v2-tools.ts
CHANGED
|
@@ -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
|
|
7
|
-
* exposes the V2 model catalog
|
|
8
|
-
* images directly to the selected multimodal
|
|
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):
|
|
304
|
-
//
|
|
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.
|
|
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.
|
|
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
|
})();
|
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "pantheon-tui",
|
|
3
|
-
"version": "1.6.0-beta.
|
|
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.
|
|
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.
|
|
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 #
|
|
600
|
-
max_continuations: 25 # hard cap
|
|
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.
|
|
606
|
-
#
|
|
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
|
|
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
|
-
##
|
|
15
|
+
## Actual Storage Model
|
|
16
16
|
|
|
17
17
|
| System | Where | Owner | Lifetime | Purpose |
|
|
18
18
|
|--------|-------|-------|----------|---------|
|
|
19
|
-
| **Memory
|
|
20
|
-
| **
|
|
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 →
|
|
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
|
-
|
|
|
95
|
-
| Conversation
|
|
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:
|
|
154
|
+
# Wrong: duplicate the same fact in both durable Memory and a project document
|
|
151
155
|
|
|
152
|
-
# Right:
|
|
153
|
-
Narrative context → 00-project.md (
|
|
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
|
|
76
|
-
conversation and must not be described as surviving
|
|
77
|
-
session. For multi-phase work that needs persistent
|
|
78
|
-
`/pantheon-deepwork`; otherwise ask before writing a goal to a
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
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
|
|