112 lines
6.2 KiB
Markdown
112 lines
6.2 KiB
Markdown
# Project State
|
|
|
|
> This file is the system's persistent memory — Stages 3-5 of the PAIMM progression.
|
|
> It survives between sessions so every run resumes, not restarts.
|
|
> Auto-written by the dream engine. Do not delete entries without explicit confirmation.
|
|
|
|
---
|
|
|
|
## Stage 1 · Session Notes
|
|
|
|
*Written each run. Cleared when archived to Stage 2.*
|
|
|
|
- Last run: 2026-06-14
|
|
- Current goal: Integrate elder-plinius-inspired upgrade modules into fable-agent CLI and stack
|
|
- Open threads: —
|
|
- Fixed: build errors in fusion-executor, openrouter-fusion-executor, media-generator
|
|
- Fixed: ESM require() crash in fusion panels CLI
|
|
- Verified: all 43 tests pass, demo runs, CLI fusion/generate commands operational
|
|
- Added: `plinius` CLI group for GodMode, UltraPlinian, Parseltongue, AutoTune, STM, refusal analysis, prompt observatory, prompt liberation metadata, and transparency reports
|
|
- Fixed: DynamicWorkflows concurrency now preserves panel/fan-out result order
|
|
- Fixed: UltraPlinian composite scores now stay on the expected 0-1 scale
|
|
- Verified: all 50 tests pass, build passes, representative `plinius` commands and `fable5 stack --enable-plinius` run successfully
|
|
|
|
---
|
|
|
|
## Stage 2 · Run History
|
|
|
|
*Appended each session. Used for pattern recognition by the dreaming system.*
|
|
|
|
| # | Date | Goal | Outcome | Key Lesson |
|
|
|---|------|------|---------|------------|
|
|
|
|
---
|
|
|
|
## Stage 3 · Verified Facts
|
|
|
|
*Stop guessing about these. Verified by query, experiment, or human confirmation.*
|
|
|
|
### Architecture
|
|
- fable-agent is a self-improving agent system implementing the Dream → Act → Validate → Codify loop
|
|
- The system is model-agnostic — PhaseExecutor, ToolOrchestrator, and SafetyBoundary handle model routing
|
|
- Fable 5 and Mythos 5 are BLOCKED (US export control directive, June 12, 2026)
|
|
- Opus 4.8 is the top available tier for orchestration
|
|
- Fusion panel (draft → critique → fuse) matches or exceeds Fable 5 capability using available models
|
|
- OpenRouter Fusion API provides Fable-tier compound model access via single API call
|
|
- Plinius-inspired upgrades are available through `fable-agent plinius ...` and stack visibility through `fable5 stack --enable-plinius`
|
|
- State persists across sessions via `~/.fable-agent/` (JSON files) and `STATE.md` / `SKILLS/` (markdown)
|
|
|
|
### Persistence
|
|
- `~/.fable-agent/` stores machine-readable state (sessions, knowledge, memory, skills)
|
|
- `STATE.md` stores human-readable state (facts, rules, failure modes)
|
|
- `SKILLS/` stores reusable procedural knowledge with version history
|
|
|
|
### Safety
|
|
- Never route to blocked models (Fable 5, Mythos 5)
|
|
- On 401/403/404, auto-block the model and fall through the chain
|
|
- Verifier must be a SEPARATE sub-agent with clean context — never self-critique
|
|
|
|
### Dreaming
|
|
- Dream every 3 goals or N iterations
|
|
- Dream cycle: review → extract patterns → distill insights → codify → dream
|
|
- Skills are versioned and auto-evolved by the dream engine
|
|
|
|
---
|
|
|
|
## Stage 4 · General Rules
|
|
|
|
*Consult before re-deriving. These apply across tasks.*
|
|
|
|
1. **Verifier sub-agent beats self-critique** — never have the same model check its own output.
|
|
2. **State file accumulates; it does not replace.** New facts append; nothing is deleted without explicit human confirmation.
|
|
3. **Skills sharpen every run.** After any non-trivial failure or discovery, write the lesson into the relevant SKILL file.
|
|
4. **Route by model tier.** Opus 4.8 orchestrates. Sonnet 4.6 handles hard bounded subtasks. Haiku handles quick routine work.
|
|
5. **Dynamic workflows over static scripts.** Let the agent compose its own execution plan per task.
|
|
6. **Worktrees for parallelism.** Never have two agents writing the same checkout. Each sub-agent gets its own git worktree.
|
|
7. **Fable 5 is unavailable** (blocked by US export control directive, June 12, 2026). Opus 4.8 is the ceiling. Architect accordingly.
|
|
8. **Vision self-check before declaring done.** For visual tasks, verify output against goal via a vision-capable model.
|
|
9. **Dream every 3 goals.** The compounding primitive. Without dreaming, skills don't evolve and memory doesn't consolidate.
|
|
10. **Fusion panel beats single model for high-stakes work.** Run `fable-agent fusion run` for complex research, architecture, and debugging.
|
|
11. **OpenRouter Fusion API** is the zero-effort fusion option `(--openrouter)`. Local panel dispatch gives more control `(--panel opus4.8-gpt5.5)`.
|
|
12. **CineFable media generation** available via `fable-agent generate image/video` (fal.ai, needs FAL_KEY).
|
|
|
|
---
|
|
|
|
## Stage 5 · Failure Modes
|
|
|
|
*Appended on discovery. Consult before repeating tasks.*
|
|
|
|
*(Add entries here as failures are discovered. Each entry: symptom, root cause, fix.)*
|
|
|
|
- Symptom: `fable worktree` switch referenced `godmode` / `parseltongue` cases with undefined `task` and `opts`, causing `tsc` failures. Root cause: misplaced command cases in the worktree action. Fix: removed stale cases and exposed these operations through the dedicated `plinius` CLI group.
|
|
- Symptom: Dynamic workflow fan-out/fusion concurrency limiter did not remove completed promises and could return completion order instead of panel order. Root cause: comparing promises to a new `Promise.race(...)` result. Fix: replaced with an index-preserving worker pool.
|
|
- Symptom: UltraPlinian reported artificially tiny composite scores. Root cause: weighted tier scores were averaged a second time after weighting. Fix: sum weighted tier scores and normalize by total weight.
|
|
|
|
---
|
|
|
|
## Memory Architecture
|
|
|
|
| Stage | Type | Location | Persistence |
|
|
|-------|------|----------|-------------|
|
|
| 1 | Session notes | This file | Cleared each run |
|
|
| 2 | Run history | This file, table | Appended each run |
|
|
| 3 | Verified facts | This file | Human-confirmed only |
|
|
| 4 | General rules | This file | Updated by agent + human review |
|
|
| 5 | Failure modes | This file | Appended on discovery |
|
|
| Skills | Procedural memory | `SKILLS/` directory | Sharpened each run |
|
|
| Episodic | What happened | `~/.fable-agent/memory/episodic/` | Auto-managed |
|
|
| Semantic | What it means | `~/.fable-agent/memory/semantic/` | Auto-managed |
|
|
| Procedural | How to do it | `~/.fable-agent/memory/procedural/` | Auto-managed |
|
|
|
|
*Stage 1-2 are session memory. Stage 3-5 are durable. Skills are executable. Episodic/semantic/procedural are machine-managed.*
|