gaia-framework 1.62.0 → 1.63.0

package/CLAUDE.md

@@ -1,5 +1,5 @@
 
-# GAIA Framework v1.62.0
+# GAIA Framework v1.63.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.62.0"
+framework_version: "1.63.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.62.0"
+framework_version: "1.63.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.39.0"
+    version: "1.40.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","_gaia/lifecycle/skills/memory-management.md","all"
+"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"

package/_gaia/lifecycle/config.yaml

@@ -2,7 +2,7 @@
 inherits: "{project-root}/_gaia/_config/global.yaml"
 
 module_name: "lifecycle"
-module_version: "1.39.0"
+module_version: "1.40.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'
+description: 'Session load/save, decision formatting, stale detection, deduplication, context summarization, cross-ref loading, budget monitoring'
 ---
 
 <!-- SECTION: decision-formatting -->
@@ -320,3 +320,36 @@ 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/memory-hygiene/instructions.xml

@@ -106,24 +106,14 @@
 </step>
 
 <step n="7" title="Token Budget Reporting">
-  <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>
+  <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>
 </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.62.0"
+readonly VERSION="1.63.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.62.0",
+  "version": "1.63.0",
   "description": "GAIA — Generative Agile Intelligence Architecture installer",
   "bin": {
     "gaia-framework": "./bin/gaia-framework.js"