@soleri/forge 5.5.0 → 5.6.0

package/src/scaffolder.ts

@@ -98,7 +98,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
     {
       name: `${config.id}_core`,
       ops: [
-        // From createCoreOps() — 144 generic ops
+        // From createCoreOps() — 150 generic ops
         'search',
         'vault_stats',
         'list_all',
@@ -131,6 +131,8 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'brain_promote_proposals',
         'brain_lifecycle',
         'brain_reset_extracted',
+        // Brain decay report (#89) — 1
+        'brain_decay_report',
         // Cognee ops — 5
         'cognee_status',
         'cognee_search',
@@ -140,6 +142,9 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         // LLM ops — 2
         'llm_rotate',
         'llm_call',
+        // Prompt ops — 2
+        'render_prompt',
+        'list_templates',
         'curator_status',
         'curator_detect_duplicates',
         'curator_contradictions',
@@ -162,7 +167,7 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'governance_stats',
         'governance_expire',
         'governance_dashboard',
-        // Planning Extra ops — 9
+        // Planning Extra ops — 22
         'plan_iterate',
         'plan_split',
         'plan_reconcile',
@@ -172,6 +177,25 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'plan_archive',
         'plan_list_tasks',
         'plan_stats',
+        // Planning evidence (#148)
+        'plan_submit_evidence',
+        'plan_verify_task',
+        'plan_verify_plan',
+        // Subagent dispatch (#149)
+        'plan_review_spec',
+        'plan_review_quality',
+        'plan_review_outcome',
+        // Brainstorm (#150)
+        'plan_brainstorm',
+        // Auto-reconcile (#151)
+        'plan_auto_reconcile',
+        // Validate plan (#152)
+        'plan_validate',
+        // Execution metrics + deliverables (#80, #83)
+        'plan_execution_metrics',
+        'plan_record_task_metrics',
+        'plan_submit_deliverable',
+        'plan_verify_deliverables',
         // Memory Extra ops — 8
         'memory_delete',
         'memory_stats',
@@ -194,6 +218,16 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'vault_seed',
         'vault_backup',
         'vault_age_report',
+        // Vault extra — seed canonical + knowledge lifecycle (5)
+        'vault_seed_canonical',
+        'knowledge_audit',
+        'knowledge_health',
+        'knowledge_merge',
+        'knowledge_reorganize',
+        // Bi-temporal vault ops (#89) — 3
+        'vault_set_temporal',
+        'vault_find_expiring',
+        'vault_find_expired',
         // Admin ops — 8
         'admin_health',
         'admin_tool_list',
@@ -203,14 +237,16 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'admin_version',
         'admin_reset_cache',
         'admin_diagnostic',
-        // Loop ops — 7
+        // Loop ops — 9
         'loop_start',
         'loop_iterate',
+        'loop_iterate_gate',
         'loop_status',
         'loop_cancel',
         'loop_history',
         'loop_is_active',
         'loop_complete',
+        'loop_anomaly_check',
         // Orchestrate ops — 5
         'orchestrate_plan',
         'orchestrate_execute',
@@ -228,7 +264,22 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'capture_quick',
         'search_intelligent',
         'search_feedback',
-        // Admin Extra ops — 10
+        // Enriched capture (#154) — 1
+        'capture_enriched',
+        // Cognee graph (#156) — 3
+        'cognee_get_node',
+        'cognee_graph_stats',
+        'cognee_export_status',
+        // Cognee Sync ops — 3
+        'cognee_sync_status',
+        'cognee_sync_drain',
+        'cognee_sync_reconcile',
+        // Intake ops — 4
+        'intake_ingest_book',
+        'intake_process',
+        'intake_status',
+        'intake_preview',
+        // Admin Extra ops — 23
         'admin_telemetry',
         'admin_telemetry_recent',
         'admin_telemetry_reset',
@@ -239,11 +290,31 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'admin_env',
         'admin_gc',
         'admin_export_config',
-        // Curator Extra ops — 4
+        // Admin key pool (#157)
+        'admin_key_pool_status',
+        'admin_create_token',
+        'admin_revoke_token',
+        'admin_list_tokens',
+        // Admin accounts (#158)
+        'admin_add_account',
+        'admin_remove_account',
+        'admin_rotate_account',
+        'admin_list_accounts',
+        'admin_account_status',
+        // Admin plugins (#159)
+        'admin_list_plugins',
+        'admin_plugin_status',
+        // Admin instruction validation (#160)
+        'admin_validate_instructions',
+        // Hot reload (#63)
+        'admin_hot_reload',
+        // Curator Extra ops — 5
         'curator_entry_history',
         'curator_record_snapshot',
         'curator_queue_stats',
         'curator_enrich',
+        // Hybrid contradiction detection (#36) — 1
+        'curator_hybrid_contradictions',
         // Project ops — 12
         'project_get',
         'project_list',
@@ -261,6 +332,12 @@ export function previewScaffold(config: AgentConfig): ScaffoldPreview {
         'memory_promote_to_global',
         'memory_configure',
         'memory_cross_project_search',
+        // Playbook ops — 5
+        'playbook_list',
+        'playbook_get',
+        'playbook_create',
+        'playbook_match',
+        'playbook_seed',
         // Agent-specific ops — 5
         'health',
         'identity',

package/src/skills/brain-debrief.md

@@ -16,33 +16,43 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "What have I learned?" (General debrief)
 
 1. Get the big picture:
+
    ```
    YOUR_AGENT_core op:brain_stats
    ```
+
    Total sessions, patterns captured, quality scores, coverage gaps.
 
 2. Get patterns ranked by proven strength:
+
    ```
    YOUR_AGENT_core op:brain_strengths
    ```
+
    Focus on strength >= 70 and successRate >= 0.7.
 
 3. Check memory landscape:
+
    ```
    YOUR_AGENT_core op:memory_topics
    ```
+
    Shows how knowledge clusters by topic.
 
 4. Check for stale knowledge:
+
    ```
    YOUR_AGENT_core op:vault_age_report
    ```
+
    Find entries that haven't been updated recently — candidates for review.
 
 5. Run a curator health audit:
+
    ```
    YOUR_AGENT_core op:curator_health_audit
    ```
+
    Vault quality score, tag normalization status, duplicate density.
 
 6. Present: top 5 strongest patterns, top 3 recurring anti-patterns, stale entries needing refresh, and coverage gaps.
@@ -50,22 +60,26 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "What's working across projects?" (Cross-project intelligence)
 
 1. Get patterns promoted to the global pool:
+
    ```
    YOUR_AGENT_core op:brain_global_patterns
    ```
 
 2. Get recommendations based on project similarity:
+
    ```
    YOUR_AGENT_core op:brain_recommend
      params: { projectName: "<current project>" }
    ```
 
 3. Check linked projects:
+
    ```
    YOUR_AGENT_core op:project_linked_projects
    ```
 
 4. Search across all projects for relevant patterns:
+
    ```
    YOUR_AGENT_core op:memory_cross_project_search
      params: { query: "<topic>", crossProject: true }
@@ -76,28 +90,33 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "Am I getting smarter?" (Learning velocity)
 
 1. Recent stats:
+
    ```
    YOUR_AGENT_core op:brain_stats
      params: { since: "<7 days ago>" }
    ```
 
 2. Longer period for comparison:
+
    ```
    YOUR_AGENT_core op:brain_stats
      params: { since: "<30 days ago>" }
    ```
 
 3. Memory stats:
+
    ```
    YOUR_AGENT_core op:memory_stats
    ```
 
 4. Vault analytics:
+
    ```
    YOUR_AGENT_core op:admin_vault_analytics
    ```
 
 5. Search insights — what queries are people running, what's missing:
+
    ```
    YOUR_AGENT_core op:admin_search_insights
    ```
@@ -107,17 +126,21 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "Build fresh intelligence" (Rebuild)
 
 1. Run the full pipeline:
+
    ```
    YOUR_AGENT_core op:brain_build_intelligence
    ```
+
    Compute strengths, update global registry, refresh project profiles.
 
 2. Consolidate vault (curator cleanup):
+
    ```
    YOUR_AGENT_core op:curator_consolidate
    ```
 
 3. Show updated metrics:
+
    ```
    YOUR_AGENT_core op:brain_stats
    ```
@@ -127,21 +150,25 @@ When the user wants to understand what patterns have proven valuable, what anti-
 ### "Export what I know" (Portability)
 
 Export brain intelligence:
+
 ```
 YOUR_AGENT_core op:brain_export
 ```
 
 Export memory:
+
 ```
 YOUR_AGENT_core op:memory_export
 ```
 
 Export vault as backup:
+
 ```
 YOUR_AGENT_core op:vault_backup
 ```
 
 These can be imported into another vault:
+
 ```
 YOUR_AGENT_core op:brain_import
 YOUR_AGENT_core op:memory_import
@@ -151,6 +178,7 @@ YOUR_AGENT_core op:vault_import
 ## Presenting Intelligence
 
 Format as a report:
+
 - **Strengths**: Top patterns with strength scores and domains
 - **Risks**: Recurring anti-patterns that keep appearing
 - **Gaps**: Domains with low coverage or stale knowledge
@@ -165,22 +193,22 @@ Debrief is complete when the user's specific question has been answered with dat
 
 ## Agent Tools Reference
 
-| Op | When to Use |
-|----|-------------|
-| `brain_stats` | Aggregate metrics — sessions, patterns, quality |
-| `brain_strengths` | Patterns ranked by proven strength |
-| `brain_global_patterns` | Cross-project promoted patterns |
-| `brain_recommend` | Project-similarity recommendations |
-| `brain_build_intelligence` | Rebuild full intelligence pipeline |
-| `brain_export` / `brain_import` | Portable intelligence transfer |
-| `memory_topics` | Knowledge clusters by topic |
-| `memory_stats` | Memory statistics |
-| `memory_export` / `memory_import` | Memory portability |
-| `memory_cross_project_search` | Search across linked projects |
-| `vault_age_report` | Find stale entries needing refresh |
-| `vault_backup` / `vault_import` | Vault backup and restore |
-| `curator_health_audit` | Vault quality score and status |
-| `curator_consolidate` | Full vault cleanup pipeline |
-| `admin_vault_analytics` | Overall knowledge quality metrics |
-| `admin_search_insights` | Search miss analysis — what's not found |
-| `project_linked_projects` | See connected projects |
+| Op                                | When to Use                                     |
+| --------------------------------- | ----------------------------------------------- |
+| `brain_stats`                     | Aggregate metrics — sessions, patterns, quality |
+| `brain_strengths`                 | Patterns ranked by proven strength              |
+| `brain_global_patterns`           | Cross-project promoted patterns                 |
+| `brain_recommend`                 | Project-similarity recommendations              |
+| `brain_build_intelligence`        | Rebuild full intelligence pipeline              |
+| `brain_export` / `brain_import`   | Portable intelligence transfer                  |
+| `memory_topics`                   | Knowledge clusters by topic                     |
+| `memory_stats`                    | Memory statistics                               |
+| `memory_export` / `memory_import` | Memory portability                              |
+| `memory_cross_project_search`     | Search across linked projects                   |
+| `vault_age_report`                | Find stale entries needing refresh              |
+| `vault_backup` / `vault_import`   | Vault backup and restore                        |
+| `curator_health_audit`            | Vault quality score and status                  |
+| `curator_consolidate`             | Full vault cleanup pipeline                     |
+| `admin_vault_analytics`           | Overall knowledge quality metrics               |
+| `admin_search_insights`           | Search miss analysis — what's not found         |
+| `project_linked_projects`         | See connected projects                          |

package/src/skills/brainstorming.md

@@ -1,6 +1,6 @@
 ---
 name: brainstorming
-description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
+description: 'You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.'
 ---
 
 <!-- Adapted from superpowers (MIT License) -->
@@ -52,12 +52,14 @@ This returns the intent type (BUILD, FIX, VALIDATE, DESIGN, IMPROVE, DELIVER) an
 **BEFORE asking any questions or exploring code**, search for existing knowledge. Follow this order:
 
 ### Vault First
+
 ```
 YOUR_AGENT_core op:search_intelligent
   params: { query: "<the feature or idea the user described>" }
 ```
 
 Look for:
+
 - **Previous designs** — was this discussed or attempted before?
 - **Architectural decisions** — are there constraints from past decisions?
 - **Patterns** — established approaches in this codebase
@@ -84,18 +86,22 @@ YOUR_AGENT_core op:memory_cross_project_search
 ```
 
 ### Web Search Second
+
 If the vault doesn't have prior art, search the web for:
+
 - **Existing libraries/tools** that solve this problem (don't build what exists)
 - **Reference implementations** in similar projects
 - **Best practices** and established patterns for this type of feature
 - **Known pitfalls** that others have documented
 
 ### Present Findings
+
 Present vault + web findings to the user: "Before we design this, here's what I found..." This informs the design conversation and prevents reinventing solutions.
 
 ## The Process
 
 **Understanding the idea:**
+
 - Check out the current project state first (files, docs, recent commits)
 - Ask questions one at a time to refine the idea
 - Prefer multiple choice questions when possible, but open-ended is fine too
@@ -103,6 +109,7 @@ Present vault + web findings to the user: "Before we design this, here's what I
 - Focus on understanding: purpose, constraints, success criteria
 
 **Exploring approaches:**
+
 - Propose 2-3 different approaches with trade-offs
 - Present options conversationally with your recommendation and reasoning
 - Lead with your recommended option and explain why
@@ -110,6 +117,7 @@ Present vault + web findings to the user: "Before we design this, here's what I
 - **Reference web findings** — if an existing library solves this, recommend it over custom code
 
 **Presenting the design:**
+
 - Once you understand what you're building, present the design
 - Scale each section to its complexity
 - Ask after each section whether it looks right so far
@@ -133,10 +141,12 @@ YOUR_AGENT_core op:capture_knowledge
 This ensures future brainstorming sessions can reference what was decided and why.
 
 **Documentation:**
+
 - Write the validated design to `docs/plans/YYYY-MM-DD-<topic>-design.md`
 - Commit the design document to git
 
 **Implementation:**
+
 - Invoke the writing-plans skill to create a detailed implementation plan
 - Do NOT invoke any other skill. writing-plans is the next step.
 
@@ -160,11 +170,11 @@ This ensures future brainstorming sessions can reference what was decided and wh
 
 ## Agent Tools Reference
 
-| Op | When to Use |
-|----|-------------|
-| `route_intent` | Classify the type of work (BUILD, FIX, etc.) |
-| `search_intelligent` | Search vault for prior art |
-| `vault_tags` / `vault_domains` | Browse knowledge landscape |
-| `brain_strengths` | Check proven patterns |
-| `memory_cross_project_search` | Check if other projects solved this |
-| `capture_knowledge` | Persist design decision to vault |
+| Op                             | When to Use                                  |
+| ------------------------------ | -------------------------------------------- |
+| `route_intent`                 | Classify the type of work (BUILD, FIX, etc.) |
+| `search_intelligent`           | Search vault for prior art                   |
+| `vault_tags` / `vault_domains` | Browse knowledge landscape                   |
+| `brain_strengths`              | Check proven patterns                        |
+| `memory_cross_project_search`  | Check if other projects solved this          |
+| `capture_knowledge`            | Persist design decision to vault             |

package/src/skills/code-patrol.md

@@ -75,13 +75,13 @@ YOUR_AGENT_core op:brain_strengths
 
 With vault patterns loaded, review the code checking for:
 
-| Check | Source | Severity |
-|-------|--------|----------|
-| Violates a critical rule | `search (severity: critical)` | Must fix |
-| Matches a known anti-pattern | `search (type: anti-pattern)` | Must fix |
-| Doesn't follow a proven pattern | `brain_strengths` | Should fix |
-| Breaks project conventions | `project_list_rules` | Should fix |
-| Misses an opportunity to use a pattern | `search_intelligent` | Could improve |
+| Check                                  | Source                        | Severity      |
+| -------------------------------------- | ----------------------------- | ------------- |
+| Violates a critical rule               | `search (severity: critical)` | Must fix      |
+| Matches a known anti-pattern           | `search (type: anti-pattern)` | Must fix      |
+| Doesn't follow a proven pattern        | `brain_strengths`             | Should fix    |
+| Breaks project conventions             | `project_list_rules`          | Should fix    |
+| Misses an opportunity to use a pattern | `search_intelligent`          | Could improve |
 
 ### Step 4: Present the Review
 
@@ -146,6 +146,7 @@ YOUR_AGENT_core op:search_intelligent
 ```
 
 Check system health:
+
 ```
 YOUR_AGENT_core op:admin_health
 ```
@@ -153,6 +154,7 @@ YOUR_AGENT_core op:admin_health
 ## The Magic
 
 This feels like magic because:
+
 1. It's not ESLint — it catches things like "we decided not to use inheritance here" or "this API pattern caused production issues last month"
 2. The rules come from YOUR team's experience, not a generic config file
 3. It gets smarter over time — every captured pattern becomes a new check
@@ -162,15 +164,15 @@ A linter checks syntax. Code patrol checks wisdom.
 
 ## Agent Tools Reference
 
-| Op | When to Use |
-|----|-------------|
-| `route_intent` | Classify the code's domain |
-| `vault_domains` | See which domains are relevant |
-| `search_intelligent` | Find relevant patterns for this code |
-| `search` | Find anti-patterns and critical rules |
-| `project_list_rules` | Project-specific conventions |
-| `get_behavior_rules` | Behavioral rules |
-| `brain_strengths` | Proven patterns to check against |
-| `capture_quick` | Capture new patterns discovered during review |
-| `capture_knowledge` | Capture new conventions |
-| `admin_health` | Post-review health check |
+| Op                   | When to Use                                   |
+| -------------------- | --------------------------------------------- |
+| `route_intent`       | Classify the code's domain                    |
+| `vault_domains`      | See which domains are relevant                |
+| `search_intelligent` | Find relevant patterns for this code          |
+| `search`             | Find anti-patterns and critical rules         |
+| `project_list_rules` | Project-specific conventions                  |
+| `get_behavior_rules` | Behavioral rules                              |
+| `brain_strengths`    | Proven patterns to check against              |
+| `capture_quick`      | Capture new patterns discovered during review |
+| `capture_knowledge`  | Capture new conventions                       |
+| `admin_health`       | Post-review health check                      |

package/src/skills/context-resume.md

@@ -34,6 +34,7 @@ YOUR_AGENT_core op:plan_list_tasks
 ```
 
 Present:
+
 - Plan objective and current status
 - Which tasks are completed, in progress, or pending
 - What's next to do
@@ -66,6 +67,7 @@ YOUR_AGENT_core op:loop_is_active
 ```
 
 If active:
+
 ```
 YOUR_AGENT_core op:loop_status
 ```
@@ -119,6 +121,7 @@ Format as a concise standup:
 ## The Magic
 
 This feels like magic because the user just says "catch me up" and the agent:
+
 1. Knows what plans are active and where they stand
 2. Remembers what happened last session (even across context compactions)
 3. Shows what knowledge was recently captured
@@ -129,15 +132,15 @@ No other tool does this — the agent has genuine persistent memory.
 
 ## Agent Tools Reference
 
-| Op | When to Use |
-|----|-------------|
-| `plan_stats` | Find active plans |
-| `get_plan` | Load plan details |
+| Op                | When to Use                 |
+| ----------------- | --------------------------- |
+| `plan_stats`      | Find active plans           |
+| `get_plan`        | Load plan details           |
 | `plan_list_tasks` | See task status within plan |
-| `memory_search` | Find session summaries |
-| `memory_list` | Browse recent memories |
-| `vault_recent` | Recently captured knowledge |
-| `loop_is_active` | Check for in-flight loops |
-| `loop_status` | Get loop details |
-| `brain_strengths` | Relevant proven patterns |
-| `admin_health` | System health check |
+| `memory_search`   | Find session summaries      |
+| `memory_list`     | Browse recent memories      |
+| `vault_recent`    | Recently captured knowledge |
+| `loop_is_active`  | Check for in-flight loops   |
+| `loop_status`     | Get loop details            |
+| `brain_strengths` | Relevant proven patterns    |
+| `admin_health`    | System health check         |