gaia-framework 1.58.1 → 1.59.0

package/CLAUDE.md

@@ -1,5 +1,5 @@
 
-# GAIA Framework v1.58.1
+# GAIA Framework v1.59.0
 
 This project uses the **GAIA** (Generative Agile Intelligence Architecture) framework — an AI agent framework for Claude Code that orchestrates software product development through 26 specialized agents, 65 workflows, and 8 shared skills.
 

package/README.md

@@ -460,7 +460,7 @@ The single source of truth is `_gaia/_config/global.yaml`:
 
 ```yaml
 framework_name: "GAIA"
-framework_version: "1.58.1"
+framework_version: "1.59.0"
 user_name: "your-name"
 project_name: "your-project"
 ```

package/_gaia/_config/global.yaml

@@ -3,7 +3,7 @@
 # After modifying this file, run /gaia-build-configs to regenerate resolved configs.
 
 framework_name: "GAIA"
-framework_version: "1.58.1"
+framework_version: "1.59.0"
 
 # User settings
 user_name: "jlouage"

package/_gaia/_config/manifest.yaml

@@ -3,11 +3,11 @@
 
 modules:
   - name: core
-    version: "1.12.1"
+    version: "1.13.0"
     path: "_gaia/core"
     type: built-in
   - name: lifecycle
-    version: "1.37.1"
+    version: "1.37.0"
     path: "_gaia/lifecycle"
     type: built-in
   - name: dev
@@ -19,6 +19,6 @@ modules:
     path: "_gaia/creative"
     type: built-in
   - name: testing
-    version: "1.8.1"
+    version: "1.8.0"
     path: "_gaia/testing"
     type: built-in

package/_gaia/core/config.yaml

@@ -2,7 +2,7 @@
 inherits: "{project-root}/_gaia/_config/global.yaml"
 
 module_name: "core"
-module_version: "1.12.1"
+module_version: "1.13.0"
 
 engine_path: "{project-root}/_gaia/core/engine/workflow.xml"
 tasks_path: "{project-root}/_gaia/core/tasks"

package/_gaia/core/engine/workflow.xml

@@ -68,8 +68,17 @@ execution modes (normal/yolo/planning), checkpoints, and quality gates.
     <action if="agent is 'dev-*' (wildcard)">Check if workflow.yaml declares agent_auto_detect: true. If true, execute the agent_auto_detect_strategy from workflow.yaml to determine the stack. If auto-detection succeeds, resolve to {project-root}/_gaia/dev/agents/{detected_stack}-dev.md and inform user: "Auto-detected developer: {agent_name} based on {detection_source}." If auto-detection fails or agent_auto_detect is false/absent: ask user which stack developer to use (typescript, angular, flutter, java, python, mobile, go), then resolve to {project-root}/_gaia/dev/agents/{stack}-dev.md</action>
     <action if="agent file resolved">Read the agent persona file — adopt its persona, name, communication style, rules, and domain knowledge for the duration of this workflow</action>
     <action if="agent file resolved">Do NOT execute the agent's activation protocol, greeting, or menu — the workflow engine controls step execution</action>
-    <action if="agent file resolved">Do NOT load the agent's memory sidecar — the workflow engine manages its own checkpoints</action>
     <action if="agent file resolved">Check for {project-root}/_gaia/_config/agents/{agent-id}.customize.yaml. If found, load and merge overrides (persona_overrides, menu_additions, menu_removals, skill_additions, rule_additions, skill_overrides, skill_section_overrides). For dev agents, also check all-dev.customize.yaml and merge (agent-specific takes precedence over all-dev).</action>
+
+    <!-- Memory Load Protocol (E9-S7) — Load agent memory sidecar files after persona, before instructions -->
+    <action if="agent file resolved">Read {project-root}/_memory/config.yaml to resolve agent tier and sidecar path. If the file does not exist, log "Memory config not found — skipping memory loading." and skip all remaining memory load actions in this step.</action>
+    <action if="agent file resolved">Resolve the agent's tier classification: look up the resolved agent ID in _memory/config.yaml tier lists — check tiers.tier_1.agents, tiers.tier_2.agents, and tiers.tier_3.agents in that order. If the agent ID is not found in any tier list (untiered), treat as Tier 3 by default — load decision-log.md only if it exists, with no budget enforcement.</action>
+    <action if="agent file resolved">Resolve sidecar path: read agents.{agent-id}.sidecar from _memory/config.yaml, construct absolute path as {project-root}/_memory/{sidecar_value}/. If the agent entry is not found in the agents section, construct path as {project-root}/_memory/{agent-id}-sidecar/.</action>
+    <action if="agent file resolved">Check if the sidecar directory exists. If the directory does not exist or is empty, skip all file loading silently — no error, no warning. Proceed to Step 4.</action>
+    <action if="agent file resolved and tier == 1">Load canonical sidecar files (silently skip any that do not exist): ground-truth.md, decision-log.md, conversation-context.md (3 files). These provide the agent's persistent ground truth, decision history, and recent conversation context.</action>
+    <action if="agent file resolved and tier == 2">Load canonical sidecar files (silently skip any that do not exist): decision-log.md, conversation-context.md (2 files). Tier 2 agents do not have ground-truth.md.</action>
+    <action if="agent file resolved and tier == 3 or untiered">Load canonical sidecar file (silently skip if it does not exist): decision-log.md (1 file). Tier 3 and untiered agents receive minimal memory context.</action>
+    <action if="agent file resolved and tier in [1, 2]">Estimate token budget usage: sum the byte lengths of all loaded sidecar files, divide by the token_approximation value (default: 4 chars per token, from _memory/config.yaml archival.token_approximation). Compare against the agent's session_budget from the tier definition in _memory/config.yaml. If usage reaches or exceeds the budget_warn_at threshold (0.8 / 80% from _memory/config.yaml archival.budget_warn_at): display warning "Memory budget at {N}% for {agent_name} — {used}K of {budget}K tokens." For Tier 3 and untiered agents (session_budget: null), skip the token budget check entirely.</action>
   </step>
 
   <step n="4" title="Load Instructions">
@@ -171,10 +180,7 @@ execution modes (normal/yolo/planning), checkpoints, and quality gates.
 <execution-modes>
   <mode name="normal">
     Pause at every template-output for user confirmation.
-    Prompt: "[c] Continue | [y] Switch to YOLO | [e] Edit output | [v] Review with Val"
-    The [v] option is shown when Val integration is enabled (val_integration.template_output_review: true in global.yaml,
-    validator.md exists, and validator-sidecar/ exists). When [v] is selected, the engine invokes val-validate-artifact
-    as a subagent to validate the saved artifact. If Val is not enabled, only [c]/[y]/[e] are shown.
+    Prompt: "[c] Continue | [y] Switch to YOLO | [e] Edit output"
     Pause at every ask tag — present the question and WAIT for user response.
     NEVER infer or skip an ask, even if the answer appears available from context.
     Pause when a subagent returns — show results summary and wait for [c]ontinue.

package/_gaia/core/workflows/brainstorming/template.md

@@ -1,9 +1,3 @@
----
-template: 'brainstorming'
-version: 1.0.0
-used_by: ['brainstorming']
----
-
 # Brainstorming Session: {topic}
 
 **Date:** {date}

package/_gaia/lifecycle/config.yaml

@@ -2,7 +2,7 @@
 inherits: "{project-root}/_gaia/_config/global.yaml"
 
 module_name: "lifecycle"
-module_version: "1.37.1"
+module_version: "1.37.0"
 
 planning_artifacts: "{project-root}/docs/planning-artifacts"
 implementation_artifacts: "{project-root}/docs/implementation-artifacts"

package/_gaia/lifecycle/workflows/1-analysis/create-product-brief/workflow.yaml

@@ -7,7 +7,6 @@ config_source: "{project-root}/_gaia/lifecycle/config.yaml"
 installed_path: "{project-root}/_gaia/lifecycle/workflows/1-analysis/create-product-brief"
 instructions: "{installed_path}/instructions.xml"
 validation: "{installed_path}/checklist.md"
-template: "{project-root}/_gaia/lifecycle/templates/product-brief-template.md"
 input_file_patterns:
   brainstorm:
     whole: "{planning_artifacts}/project-brainstorm.md"

package/_gaia/lifecycle/workflows/4-implementation/code-review/workflow.yaml

@@ -7,7 +7,6 @@ config_source: "{project-root}/_gaia/lifecycle/config.yaml"
 installed_path: "{project-root}/_gaia/lifecycle/workflows/4-implementation/code-review"
 instructions: "{installed_path}/instructions.xml"
 validation: "{installed_path}/checklist.md"
-template: "{project-root}/_gaia/lifecycle/templates/review-template.md"
 input_file_patterns:
   architecture:
     whole: "{planning_artifacts}/architecture.md"

package/_gaia/lifecycle/workflows/4-implementation/sprint-planning/workflow.yaml

@@ -8,7 +8,6 @@ config_source: "{project-root}/_gaia/lifecycle/config.yaml"
 installed_path: "{project-root}/_gaia/lifecycle/workflows/4-implementation/sprint-planning"
 instructions: "{installed_path}/instructions.xml"
 validation: "{installed_path}/checklist.md"
-template: "{project-root}/_gaia/lifecycle/templates/sprint-plan-template.md"
 input_file_patterns:
   epics:
     whole: "{planning_artifacts}/epics-and-stories.md"

package/_gaia/lifecycle/workflows/5-deployment/deployment-checklist/workflow.yaml

@@ -7,7 +7,6 @@ config_source: "{project-root}/_gaia/lifecycle/config.yaml"
 installed_path: "{project-root}/_gaia/lifecycle/workflows/5-deployment/deployment-checklist"
 instructions: "{installed_path}/instructions.xml"
 validation: "{installed_path}/checklist.md"
-template: "{project-root}/_gaia/lifecycle/templates/deployment-template.md"
 input_file_patterns:
   architecture:
     whole: "{planning_artifacts}/architecture.md"

package/_gaia/testing/config.yaml

@@ -2,7 +2,7 @@
 inherits: "{project-root}/_gaia/_config/global.yaml"
 
 module_name: "testing"
-module_version: "1.8.1"
+module_version: "1.8.0"
 
 test_artifacts: "{project-root}/docs/test-artifacts"
 knowledge_path: "{project-root}/_gaia/testing/knowledge"

package/_gaia/testing/workflows/test-design/workflow.yaml

@@ -7,6 +7,5 @@ config_source: "{project-root}/_gaia/testing/config.yaml"
 installed_path: "{project-root}/_gaia/testing/workflows/test-design"
 instructions: "{installed_path}/instructions.xml"
 validation: "{installed_path}/checklist.md"
-template: "{project-root}/_gaia/lifecycle/templates/test-plan-template.md"
 output:
   primary: "{test_artifacts}/test-plan.md"

package/gaia-install.sh

@@ -6,7 +6,7 @@ set -euo pipefail
 # Installs, updates, validates, and reports on GAIA installations.
 # ─────────────────────────────────────────────────────────────────────────────
 
-readonly VERSION="1.58.1"
+readonly VERSION="1.59.0"
 readonly GITHUB_REPO="https://github.com/jlouage/Gaia-framework.git"
 readonly MANIFEST_REL="_gaia/_config/manifest.yaml"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gaia-framework",
-  "version": "1.58.1",
+  "version": "1.59.0",
   "description": "GAIA — Generative Agile Intelligence Architecture installer",
   "bin": {
     "gaia-framework": "./bin/gaia-framework.js"