gaia-framework 1.63.0 → 1.64.0

package/CLAUDE.md

@@ -1,5 +1,5 @@
 
-# GAIA Framework v1.63.0
+# GAIA Framework v1.64.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.63.0"
+framework_version: "1.64.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.63.0"
+framework_version: "1.64.0"
 
 # User settings
 user_name: "jlouage"

package/_gaia/_config/manifest.yaml

@@ -7,7 +7,7 @@ modules:
     path: "_gaia/core"
     type: built-in
   - name: lifecycle
-    version: "1.40.0"
+    version: "1.37.0"
     path: "_gaia/lifecycle"
     type: built-in
   - name: dev

package/_gaia/_config/skill-manifest.csv

@@ -9,4 +9,4 @@ name,displayName,description,path,applicable_agents
 "security-basics","Security Basics","OWASP Top 10, input validation, secrets, CORS/CSRF","_gaia/dev/skills/security-basics.md","all-dev,architect,security,devops"
 "validation-patterns","Validation Patterns","Claim extraction, filesystem verification, cross-reference, severity classification, findings formatting","_gaia/lifecycle/skills/validation-patterns.md","validator"
 "ground-truth-management","Ground Truth Management","Entry structure, incremental/full refresh, conflict resolution, archival, token budget, brownfield extraction","_gaia/lifecycle/skills/ground-truth-management.md","validator"
-"memory-management","Memory Management","Session load/save, decision formatting, stale detection, deduplication, context summarization, cross-ref loading, budget-monitoring","_gaia/lifecycle/skills/memory-management.md","all"
+"memory-management","Memory Management","Session load/save, decision formatting, stale detection, deduplication, context summarization","_gaia/lifecycle/skills/memory-management.md","all"

package/_gaia/lifecycle/config.yaml

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

package/_gaia/lifecycle/skills/memory-management.md

@@ -2,7 +2,7 @@
 name: memory-management
 version: '1.0'
 applicable_agents: [all]
-description: 'Session load/save, decision formatting, stale detection, deduplication, context summarization, cross-ref loading, budget monitoring'
+description: 'Session load/save, decision formatting, stale detection, deduplication, context summarization'
 ---
 
 <!-- SECTION: decision-formatting -->
@@ -320,36 +320,3 @@ After loading cross-references, record in the session checkpoint:
 
 This enables `/gaia-resume` to detect stale cross-references when resuming a session.
 <!-- END SECTION -->
-
-<!-- SECTION: budget-monitoring -->
-## Budget Monitoring
-
-Calculate and report token budget usage per agent sidecar. Reusable by any workflow that needs budget status.
-
-**Input:**
-- Agent sidecar file sizes (bytes) from filesystem scan
-- Tier budgets from `_memory/config.yaml`: `tiers.tier_1.session_budget` (300K), `tiers.tier_2.session_budget` (100K)
-- Per-agent ground truth budgets: `agents.{agent-id}.ground_truth_budget` (Tier 1 only)
-
-**Token calculation:**
-- Approximate tokens = file size in bytes / 4 (chars-per-token convention)
-- Sum across all sidecar files per agent (decision-log.md + conversation-context.md + ground-truth.md)
-
-**Threshold classification:**
-- **OK:** below 80% of budget
-- **warning:** at or above 80%, below 90%
-- **critical:** at or above 90%, below 100%
-- **over-budget:** at or above 100% — triggers archival recommendation
-
-**Tier handling:**
-- Tier 1: report session budget usage and ground truth budget usage separately
-- Tier 2: report session budget usage only (no ground truth file)
-- Tier 3 / untiered: report actual token count with "no budget enforced"
-
-**Output format (Token Budget Table):**
-
-| Agent | Tier | Files Scanned | Token Usage | Session Budget | GT Budget | % Used | Status |
-|-------|------|---------------|-------------|----------------|-----------|--------|--------|
-
-For Tier 3 and untiered agents, budget columns show "no budget enforced" with actual token count.
-<!-- END SECTION -->

package/_gaia/lifecycle/workflows/anytime/brownfield-onboarding/instructions.xml

@@ -82,7 +82,7 @@
   /gaia-review-api (optional, if APIs) → /gaia-adversarial → /gaia-test-design → /gaia-test-framework (optional) → /gaia-create-epics → /gaia-threat-model → /gaia-infra-design → /gaia-trace → /gaia-ci-setup → /gaia-readiness-check</action>
 </step>
 
-<step n="7" title="Bootstrap Agent Ground Truth" optional="true">
+<step n="7" title="Bootstrap Val Ground Truth" optional="true">
   <action>Check if Val is installed: verify {project-root}/_gaia/lifecycle/agents/validator.md exists AND {memory_path}/validator-sidecar/ directory exists</action>
   <check if="validator.md not found OR validator-sidecar/ not found">Skip Step 7 silently — Val is not installed. Brownfield onboarding continues without ground truth bootstrap.</check>
 
@@ -102,74 +102,6 @@
 
   <action>Write extracted project facts to {memory_path}/validator-sidecar/ground-truth.md. If ground-truth.md already exists with content: merge new facts with existing entries — add new facts, update changed facts, flag removed facts — never destructive overwrite. Follow merge semantics from ground-truth-management conflict-resolution section. If ground-truth.md is empty or new: write all extracted facts as initial seed entries with verification count = 1.</action>
   <action>Report: "Seeded {N} ground-truth entries from brownfield artifacts + filesystem scan"</action>
-
-  <!-- Step 7d/7e/7f: Tier 1 Agent Ground Truth Bootstrap (E9-S12) -->
-
-  <ask>Bootstrap Tier 1 agent ground truth (Theo, Derek, Nate)? [y/n]</ask>
-
-  <action>JIT load ground-truth-management skill sections from {project-root}/_gaia/lifecycle/skills/ground-truth-management.md: entry-structure, conflict-resolution, brownfield-extraction. All ground-truth entries must follow the canonical entry format from the entry-structure section. When the same fact appears in multiple source documents with conflicting values (e.g., different version numbers), annotate the entry with "conflicting sources: {source1} says X, {source2} says Y" and use the higher-precedence source (brownfield-assessment.md > project-documentation.md for tech stack facts).</action>
-
-  <!-- Step 7d: Theo (Architect) ground truth extraction (AC1) -->
-  <action>Step 7d — Theo ground truth extraction.
-    Read {planning_artifacts}/architecture.md and extract:
-    — Tech stack (languages, frameworks, runtime versions) → variable-inventory entries
-    — ADRs (architecture decision records — ID, title, status, rationale) → structural-pattern entries
-    — Component inventory (modules, packages, services) → file-inventory entries
-    — Dependency map (internal and external dependencies) → cross-reference entries
-
-    If {planning_artifacts}/architecture.md does not exist: fall back to {planning_artifacts}/brownfield-assessment.md for Theo. Extract tech stack, file counts, and project structure from the brownfield assessment instead.
-
-    Token budget guard: Theo has a 150K token budget (150,000 tokens). Estimate extraction size (characters / 4). If estimated tokens exceed 60% threshold (90,000 tokens), trim to highest-signal entries — prioritize ADRs and tech stack over detailed file inventories.
-
-    Write extracted entries to {memory_path}/architect-sidecar/ground-truth.md.
-    If the {memory_path}/architect-sidecar/ directory does not exist, create it along with a new ground-truth.md file with standard headers.
-    If ground-truth.md already exists with content: follow merge semantics from the conflict-resolution section — add new entries, update changed entries, preserve existing entries. Never perform a destructive overwrite.</action>
-
-  <!-- Step 7e: Derek (Product Manager) ground truth extraction (AC2) -->
-  <action>Step 7e — Derek ground truth extraction.
-    Read {planning_artifacts}/prd.md and extract:
-    — Functional requirements (feature list, requirement IDs) → structural-pattern entries
-    — User stories and acceptance criteria summaries → cross-reference entries
-
-    If {planning_artifacts}/prd.md does not exist: fall back to {planning_artifacts}/prd-brownfield-gaps.md as the alternate PRD path for Derek.
-
-    Read {planning_artifacts}/epics-and-stories.md and extract for Derek:
-    — Epic overview (epic IDs, titles, story counts) → file-inventory entries
-    — Story-to-epic mappings → cross-reference entries
-
-    Read {test_artifacts}/nfr-assessment.md (if present) and extract for Derek:
-    — Quality baselines (performance targets, security posture, test coverage) → variable-inventory entries
-    If {test_artifacts}/nfr-assessment.md does not exist: log warning "nfr-assessment.md not found in test_artifacts — skipping quality baselines for Derek" and continue without error.
-
-    Token budget guard: Derek has a 100K token budget (100,000 tokens). Estimate extraction size (characters / 4). If estimated tokens exceed 60% threshold (60,000 tokens), trim to highest-signal entries — prioritize functional requirements and epic summaries over detailed story mappings.
-
-    Write extracted entries to {memory_path}/pm-sidecar/ground-truth.md.
-    If the {memory_path}/pm-sidecar/ directory does not exist, create it along with a new ground-truth.md file with standard headers.
-    If ground-truth.md already exists with content: follow merge semantics from the conflict-resolution section — add new entries, update changed entries, preserve existing entries. Never perform a destructive overwrite.</action>
-
-  <!-- Step 7f: Nate (Scrum Master) ground truth extraction (AC3) -->
-  <action>Step 7f — Nate ground truth extraction.
-    Read {implementation_artifacts}/sprint-status.yaml (if it exists) and extract for Nate:
-    — Current sprint ID, story count, points total → variable-inventory entries
-    — Story status distribution → structural-pattern entries
-
-    Read {memory_path}/sm-sidecar/velocity-data.md (if it exists) and extract for Nate:
-    — Velocity history (sprint-over-sprint) → variable-inventory entries
-    — Capacity data → variable-inventory entries
-
-    If neither {implementation_artifacts}/sprint-status.yaml nor {memory_path}/sm-sidecar/velocity-data.md exists: complete this step gracefully with a log message "insufficient sprint data, velocity unavailable" and write ground-truth.md omitting velocity entries. Do not raise an error.
-
-    Token budget guard: Nate has a 100K token budget (100,000 tokens). Estimate extraction size (characters / 4). If estimated tokens exceed 60% threshold (60,000 tokens), trim to highest-signal entries — prioritize current sprint status over historical velocity data.
-
-    Write extracted entries to {memory_path}/sm-sidecar/ground-truth.md.
-    If the {memory_path}/sm-sidecar/ directory does not exist, create it along with a new ground-truth.md file with standard headers.
-    If ground-truth.md already exists with content: follow merge semantics from the conflict-resolution section — add new entries, update changed entries, preserve existing entries. Never perform a destructive overwrite.</action>
-
-  <!-- Summary report (AC6) -->
-  <action>After all Tier 1 extractions complete, output a summary report:
-    "Seeded {N} entries for Theo, {M} entries for Derek, {K} entries for Nate"
-    If sprint data was absent for Nate, append a note: "(sprint data absent — velocity entries omitted)"
-    Include token budget status for each agent (GREEN/YELLOW/RED).</action>
 </step>
 
 <next-step command="/gaia-review-api">

package/_gaia/lifecycle/workflows/anytime/memory-hygiene/instructions.xml

@@ -106,14 +106,24 @@
 </step>
 
 <step n="7" title="Token Budget Reporting">
-  <action>JIT-load the budget-monitoring section from {project-root}/_gaia/lifecycle/skills/memory-management.md
-    Load only the content between &lt;!-- SECTION: budget-monitoring --&gt; and &lt;!-- END SECTION --&gt; markers</action>
-  <action>Apply the budget-monitoring skill procedure using file sizes from Step 2 inventory and tier budgets from {memory_path}/config.yaml:
-    - Calculate token usage per agent (sum sidecar file sizes, convert via skill formula)
-    - Classify each agent by threshold status (OK / warning / critical / over-budget)
-    - For Tier 1 agents: also report ground truth budget usage separately
-    - For Tier 3 / untiered: report actual tokens with "no budget enforced"</action>
-  <action>Build Token Budget Table per the skill's output format</action>
+  <action>For each agent sidecar, calculate token usage:
+    - Sum file sizes in bytes across all sidecar files (from Step 2 inventory)
+    - Convert to approximate token count: file size in bytes / 4 (chars-per-token approximation from config archival.token_approximation)
+    - For Tier 1 agents: also calculate ground-truth.md token usage separately</action>
+  <action>Compare against budgets from {memory_path}/config.yaml:
+    - Tier 1 session budget: tiers.tier_1.session_budget (300K tokens)
+    - Tier 1 ground truth budget: agents.{agent}.ground_truth_budget (per-agent: Val 200K, Theo 150K, Derek 100K, Nate 100K)
+    - Tier 2 session budget: tiers.tier_2.session_budget (100K tokens)
+    - Tier 3: no budget enforced
+    - Untiered: no budget enforced</action>
+  <action>Apply threshold status indicators per archival config:
+    - OK: below 80% of budget
+    - warning: at or above 80% but below 90%
+    - critical: at or above 90% but below 100%
+    - over-budget: at or above 100%</action>
+  <action>Build Token Budget Table with columns:
+    | Agent | Tier | Files Scanned | Token Usage | Session Budget | GT Budget | % Used | Status |
+    For Tier 3 and untiered agents: budget column shows "no budget enforced" with actual token count reported</action>
 </step>
 
 <step n="8" title="Archival Recommendations">

package/gaia-install.sh

@@ -6,7 +6,7 @@ set -euo pipefail
 # Installs, updates, validates, and reports on GAIA installations.
 # ─────────────────────────────────────────────────────────────────────────────
 
-readonly VERSION="1.63.0"
+readonly VERSION="1.64.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.63.0",
+  "version": "1.64.0",
   "description": "GAIA — Generative Agile Intelligence Architecture installer",
   "bin": {
     "gaia-framework": "./bin/gaia-framework.js"