@jaguilar87/gaia 5.0.4 → 5.0.5

package/config/crons-schema.md

@@ -1,81 +0,0 @@
-# Crons Persistence Schema
-
-**Version:** 1  
-**File location:** `.claude/crons.json`  
-**Owner:** Gaia cron persistence system
-
----
-
-## Schema
-
-```json
-{
-  "crons": [
-    {
-      "name": "check-email",
-      "interval_minutes": 180,
-      "prompt": "Revisa el correo y haz triage según gmail-triage skill",
-      "enabled": true,
-      "created": "2026-04-13T20:00:00Z",
-      "last_run": "2026-04-13T23:00:00Z"
-    }
-  ],
-  "version": 1
-}
-```
-
-## Field Definitions
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `name` | string | yes | Unique identifier for the cron. Used as the dedup key during restore. Must be URL-safe (alphanumeric, hyphens). |
-| `interval_minutes` | integer | yes | How often the cron fires, in minutes. Mirrors CronCreate interval. |
-| `prompt` | string | yes | The exact prompt sent to the orchestrator on each tick. |
-| `enabled` | boolean | yes | If false, the cron is skipped during restore. Allows pausing without deletion. |
-| `created` | string (ISO 8601 UTC) | yes | Timestamp when the cron was first created. Set once, never updated. |
-| `last_run` | string (ISO 8601 UTC) or null | yes | Timestamp of the most recent execution. Null if the cron has never run. |
-
-## Top-level Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `crons` | array | The list of persisted cron entries. May be empty. |
-| `version` | integer | Schema version. Currently 1. Increment when field semantics change. |
-
-## Constraints
-
-- `name` must be unique within the `crons` array. Duplicate names are invalid.
-- `interval_minutes` must be a positive integer greater than 0.
-- `last_run` is `null` when the cron has been created but has not yet fired.
-
-## Example: Multiple Crons
-
-```json
-{
-  "crons": [
-    {
-      "name": "check-email",
-      "interval_minutes": 180,
-      "prompt": "Revisa el correo y haz triage según gmail-triage skill",
-      "enabled": true,
-      "created": "2026-04-13T20:00:00Z",
-      "last_run": "2026-04-13T23:00:00Z"
-    },
-    {
-      "name": "drift-monitor",
-      "interval_minutes": 60,
-      "prompt": "Check for infrastructure drift in the current project",
-      "enabled": false,
-      "created": "2026-04-10T10:00:00Z",
-      "last_run": null
-    }
-  ],
-  "version": 1
-}
-```
-
-## File Location
-
-The file lives at `.claude/crons.json`, resolved relative to the active project root (same directory where `.claude/` is found). The path module `find_claude_dir()` from `hooks/modules/core/paths.py` provides the canonical `.claude/` path.
-
-For projects that use `CLAUDE_PLUGIN_DATA`, the file lives under that data directory instead, consistent with how other persisted data (logs, sessions, grants) is stored.

package/config/git_standards.json

@@ -1,72 +0,0 @@
-{
-  "commit_message": {
-    "format": "conventional_commits",
-    "description": "Commit messages must follow Conventional Commits specification",
-
-    "type_allowed": [
-      "feat",
-      "fix",
-      "refactor",
-      "docs",
-      "test",
-      "chore",
-      "ci",
-      "perf",
-      "style",
-      "build"
-    ],
-
-    "scope_required": false,
-    "scope_examples": ["helmrelease", "terraform", "pg-non-prod", "infrastructure"],
-
-    "subject_max_length": 72,
-    "subject_rules": {
-      "capitalize_first_letter": false,
-      "no_period_at_end": true,
-      "imperative_mood": true,
-      "no_emoji": true
-    },
-
-    "body_max_line_length": 72,
-    "body_required": false,
-
-    "footer_forbidden": [
-      "Generated with Claude Code",
-      "Co-Authored-By: Claude",
-      "🤖 Generated with"
-    ],
-
-    "footer_allowed": [
-      "BREAKING CHANGE:",
-      "Refs:",
-      "Closes:",
-      "Fixes:",
-      "Implements:",
-      "See:"
-    ],
-
-    "examples_valid": [
-      "feat(helmrelease): add Phase 3.3 services",
-      "fix(pg-non-prod): correct API key environment variable mappings",
-      "refactor: simplify context provider logic",
-      "docs: update README with new workflow",
-      "chore(deps): update terraform to v1.6.0"
-    ],
-
-    "examples_invalid": [
-      "Added new feature",
-      "Fixed bugs",
-      "Updates",
-      "feat: add feature\n\n🤖 Generated with Claude Code",
-      "feat: add new feature 🚀",
-      "fix: 🐛 correct bug"
-    ]
-  },
-
-  "enforcement": {
-    "enabled": true,
-    "block_on_failure": true,
-    "log_violations": true,
-    "log_path": ".claude/logs/commit-violations.jsonl"
-  }
-}

package/dist/gaia-ops/commands/gaia.md

@@ -1,37 +0,0 @@
----
-name: gaia
-description: Invoke the Gaia meta-agent for system architecture analysis, agent design, skill creation, and orchestration debugging
-allowed-tools:
-  - Bash(*)
-  - Read
-  - Edit
-  - Write
-  - Glob
-  - Grep
-  - WebSearch
-  - WebFetch
-  - Task
-  - Agent
-  - Skill
----
-
-Invoke the Gaia meta-agent (`gaia-system`) to work on the gaia-ops orchestration
-system itself. This is the entry point for tasks that modify or analyze agents,
-skills, hooks, or system architecture.
-
-## When to use
-
-- Analyze or improve the gaia-ops architecture
-- Create or update agent definitions (`.md` files)
-- Create or update skills (`SKILL.md` files)
-- Write or debug Python hooks and tools
-- Update `CLAUDE.md` or system configuration
-- Research best practices for agent orchestration
-
-## How it works
-
-This command delegates to the `gaia-system` agent, which is the meta-agent
-specialized in the orchestration system. It follows the standard agent protocol
-and returns a `agent_contract_handoff` block with findings and status.
-
-$ARGUMENTS

package/dist/gaia-ops/config/crons-schema.md

@@ -1,81 +0,0 @@
-# Crons Persistence Schema
-
-**Version:** 1  
-**File location:** `.claude/crons.json`  
-**Owner:** Gaia cron persistence system
-
----
-
-## Schema
-
-```json
-{
-  "crons": [
-    {
-      "name": "check-email",
-      "interval_minutes": 180,
-      "prompt": "Revisa el correo y haz triage según gmail-triage skill",
-      "enabled": true,
-      "created": "2026-04-13T20:00:00Z",
-      "last_run": "2026-04-13T23:00:00Z"
-    }
-  ],
-  "version": 1
-}
-```
-
-## Field Definitions
-
-| Field | Type | Required | Description |
-|-------|------|----------|-------------|
-| `name` | string | yes | Unique identifier for the cron. Used as the dedup key during restore. Must be URL-safe (alphanumeric, hyphens). |
-| `interval_minutes` | integer | yes | How often the cron fires, in minutes. Mirrors CronCreate interval. |
-| `prompt` | string | yes | The exact prompt sent to the orchestrator on each tick. |
-| `enabled` | boolean | yes | If false, the cron is skipped during restore. Allows pausing without deletion. |
-| `created` | string (ISO 8601 UTC) | yes | Timestamp when the cron was first created. Set once, never updated. |
-| `last_run` | string (ISO 8601 UTC) or null | yes | Timestamp of the most recent execution. Null if the cron has never run. |
-
-## Top-level Fields
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `crons` | array | The list of persisted cron entries. May be empty. |
-| `version` | integer | Schema version. Currently 1. Increment when field semantics change. |
-
-## Constraints
-
-- `name` must be unique within the `crons` array. Duplicate names are invalid.
-- `interval_minutes` must be a positive integer greater than 0.
-- `last_run` is `null` when the cron has been created but has not yet fired.
-
-## Example: Multiple Crons
-
-```json
-{
-  "crons": [
-    {
-      "name": "check-email",
-      "interval_minutes": 180,
-      "prompt": "Revisa el correo y haz triage según gmail-triage skill",
-      "enabled": true,
-      "created": "2026-04-13T20:00:00Z",
-      "last_run": "2026-04-13T23:00:00Z"
-    },
-    {
-      "name": "drift-monitor",
-      "interval_minutes": 60,
-      "prompt": "Check for infrastructure drift in the current project",
-      "enabled": false,
-      "created": "2026-04-10T10:00:00Z",
-      "last_run": null
-    }
-  ],
-  "version": 1
-}
-```
-
-## File Location
-
-The file lives at `.claude/crons.json`, resolved relative to the active project root (same directory where `.claude/` is found). The path module `find_claude_dir()` from `hooks/modules/core/paths.py` provides the canonical `.claude/` path.
-
-For projects that use `CLAUDE_PLUGIN_DATA`, the file lives under that data directory instead, consistent with how other persisted data (logs, sessions, grants) is stored.

package/dist/gaia-ops/config/git_standards.json

@@ -1,72 +0,0 @@
-{
-  "commit_message": {
-    "format": "conventional_commits",
-    "description": "Commit messages must follow Conventional Commits specification",
-
-    "type_allowed": [
-      "feat",
-      "fix",
-      "refactor",
-      "docs",
-      "test",
-      "chore",
-      "ci",
-      "perf",
-      "style",
-      "build"
-    ],
-
-    "scope_required": false,
-    "scope_examples": ["helmrelease", "terraform", "pg-non-prod", "infrastructure"],
-
-    "subject_max_length": 72,
-    "subject_rules": {
-      "capitalize_first_letter": false,
-      "no_period_at_end": true,
-      "imperative_mood": true,
-      "no_emoji": true
-    },
-
-    "body_max_line_length": 72,
-    "body_required": false,
-
-    "footer_forbidden": [
-      "Generated with Claude Code",
-      "Co-Authored-By: Claude",
-      "🤖 Generated with"
-    ],
-
-    "footer_allowed": [
-      "BREAKING CHANGE:",
-      "Refs:",
-      "Closes:",
-      "Fixes:",
-      "Implements:",
-      "See:"
-    ],
-
-    "examples_valid": [
-      "feat(helmrelease): add Phase 3.3 services",
-      "fix(pg-non-prod): correct API key environment variable mappings",
-      "refactor: simplify context provider logic",
-      "docs: update README with new workflow",
-      "chore(deps): update terraform to v1.6.0"
-    ],
-
-    "examples_invalid": [
-      "Added new feature",
-      "Fixed bugs",
-      "Updates",
-      "feat: add feature\n\n🤖 Generated with Claude Code",
-      "feat: add new feature 🚀",
-      "fix: 🐛 correct bug"
-    ]
-  },
-
-  "enforcement": {
-    "enabled": true,
-    "block_on_failure": true,
-    "log_violations": true,
-    "log_path": ".claude/logs/commit-violations.jsonl"
-  }
-}

package/dist/gaia-ops/tools/agentic-loop/decide-status.py

@@ -1,210 +0,0 @@
-#!/usr/bin/env python3
-"""
-decide-status.py
-
-Mechanically decide what to do based on numbers alone.  No LLM judgment.
-
-Usage:
-    python3 decide-status.py \
-        --current 94.5 \
-        --best 92.0 \
-        --threshold 98 \
-        --direction higher \
-        --consecutive-discards 2 \
-        --pivot-count 1
-
-Output JSON:
-    {
-      "decision": "keep",
-      "reason": "Metric improved from 92.0 to 94.5",
-      "improved": true,
-      "gap_remaining": 3.5
-    }
-
-Decision precedence (evaluated top-to-bottom, first match wins):
-  1. pivot_count >= 3                          → stop
-  2. consecutive_discards >= 5                 → pivot   (also a discard)
-  3. consecutive_discards >= 3                 → refine  (also a discard)
-  4. current meets or passes threshold         → threshold_reached
-  5. current improved vs best (per direction)  → keep
-  6. current same or worse                     → discard
-
-Exit codes:
-  0  success (decision emitted as JSON)
-  1  invalid input
-"""
-
-import argparse
-import json
-import sys
-
-
-Decision = str  # type alias for readability
-
-
-def _is_improved(current: float, best: float, direction: str) -> bool:
-    """Return True if *current* is strictly better than *best* per direction."""
-    if direction == "higher":
-        return current > best
-    return current < best  # lower is better
-
-
-def _threshold_reached(current: float, threshold: float, direction: str) -> bool:
-    """Return True if *current* has met or surpassed *threshold*."""
-    if direction == "higher":
-        return current >= threshold
-    return current <= threshold
-
-
-def _gap_remaining(current: float, threshold: float, direction: str) -> float:
-    """Absolute gap between current value and threshold."""
-    if direction == "higher":
-        return max(0.0, threshold - current)
-    return max(0.0, current - threshold)
-
-
-def decide(
-    current: float,
-    best: float,
-    threshold: float,
-    direction: str,
-    consecutive_discards: int,
-    pivot_count: int,
-) -> dict:
-    """Pure function: return decision dict from numeric inputs."""
-
-    gap = _gap_remaining(current, threshold, direction)
-    improved = _is_improved(current, best, direction)
-
-    # --- Precedence 1: hard stop on too many pivots ---
-    if pivot_count >= 3:
-        return {
-            "decision": "stop",
-            "reason": f"pivot_count={pivot_count} has reached the maximum of 3; halting loop",
-            "improved": improved,
-            "gap_remaining": gap,
-        }
-
-    # --- Precedence 2 & 3: discard streak escalations ---
-    # Evaluated before threshold/keep so an ongoing failing streak is flagged
-    # even if the current run happens to reach the threshold.
-    if consecutive_discards >= 5:
-        return {
-            "decision": "pivot",
-            "reason": (
-                f"consecutive_discards={consecutive_discards} >= 5; "
-                "strategy is not working, force a pivot"
-            ),
-            "improved": improved,
-            "gap_remaining": gap,
-        }
-
-    if consecutive_discards >= 3:
-        return {
-            "decision": "refine",
-            "reason": (
-                f"consecutive_discards={consecutive_discards} >= 3; "
-                "current approach needs refinement before continuing"
-            ),
-            "improved": improved,
-            "gap_remaining": gap,
-        }
-
-    # --- Precedence 4: threshold reached ---
-    if _threshold_reached(current, threshold, direction):
-        return {
-            "decision": "threshold_reached",
-            "reason": (
-                f"current={current} {'≥' if direction == 'higher' else '≤'} "
-                f"threshold={threshold}; goal achieved"
-            ),
-            "improved": improved,
-            "gap_remaining": 0.0,
-        }
-
-    # --- Precedence 5 & 6: standard keep/discard ---
-    if improved:
-        return {
-            "decision": "keep",
-            "reason": f"Metric improved from {best} to {current}",
-            "improved": True,
-            "gap_remaining": gap,
-        }
-
-    return {
-        "decision": "discard",
-        "reason": f"Metric did not improve (current={current}, best={best})",
-        "improved": False,
-        "gap_remaining": gap,
-    }
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Compute the next agentic-loop decision from metric numbers only.",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Decisions:
-  keep               current improved vs best
-  discard            current same or worse
-  refine             3+ consecutive discards (improvement needed in approach)
-  pivot              5+ consecutive discards (strategy change required)
-  stop               3+ pivots already attempted
-  threshold_reached  current meets or surpasses the goal threshold
-
-Direction values:
-  higher   larger numbers are better  (e.g. accuracy, passing tests)
-  lower    smaller numbers are better (e.g. error rate, latency ms)
-        """,
-    )
-    parser.add_argument("--current", required=True, type=float, help="Metric value for the current run")
-    parser.add_argument("--best", required=True, type=float, help="Best metric seen so far (from state.json)")
-    parser.add_argument("--threshold", required=True, type=float, help="Target threshold to reach")
-    parser.add_argument(
-        "--direction",
-        required=True,
-        choices=["higher", "lower"],
-        help="Whether higher or lower values are better",
-    )
-    parser.add_argument(
-        "--consecutive-discards",
-        required=True,
-        type=int,
-        metavar="N",
-        help="Number of consecutive discard outcomes so far (from state.json)",
-    )
-    parser.add_argument(
-        "--pivot-count",
-        required=True,
-        type=int,
-        metavar="N",
-        help="Number of pivots executed so far (from state.json)",
-    )
-    args = parser.parse_args()
-
-    # --- Input validation ---
-    errors = []
-    if args.consecutive_discards < 0:
-        errors.append("--consecutive-discards must be >= 0")
-    if args.pivot_count < 0:
-        errors.append("--pivot-count must be >= 0")
-
-    if errors:
-        for err in errors:
-            print(f"error: {err}", file=sys.stderr)
-        sys.exit(1)
-
-    result = decide(
-        current=args.current,
-        best=args.best,
-        threshold=args.threshold,
-        direction=args.direction,
-        consecutive_discards=args.consecutive_discards,
-        pivot_count=args.pivot_count,
-    )
-
-    print(json.dumps(result, indent=2))
-
-
-if __name__ == "__main__":
-    main()

package/dist/gaia-ops/tools/agentic-loop/parse-metric.py

@@ -1,106 +0,0 @@
-#!/usr/bin/env python3
-"""
-parse-metric.py
-
-Read stdout from eval_command and extract METRIC lines.
-
-Usage:
-    echo "output" | python3 parse-metric.py --metric accuracy
-    python3 parse-metric.py --metric accuracy --file /tmp/eval-output.txt
-
-Input lines must match: METRIC {name}={number}
-Output: JSON to stdout with metric name, numeric value, and raw line.
-"""
-
-import argparse
-import json
-import re
-import sys
-from typing import Optional
-
-
-METRIC_PATTERN = re.compile(r"^METRIC\s+(\w+)=([\d.]+)\s*$")
-
-
-def parse_lines(lines: list[str]) -> list[dict]:
-    """Extract all METRIC entries from a sequence of lines."""
-    results = []
-    for line in lines:
-        stripped = line.rstrip("\n")
-        match = METRIC_PATTERN.match(stripped)
-        if match:
-            name = match.group(1)
-            raw_value = match.group(2)
-            # Preserve int vs float from the source text.
-            value: int | float
-            if "." in raw_value:
-                value = float(raw_value)
-            else:
-                value = int(raw_value)
-            results.append(
-                {
-                    "metric": name,
-                    "value": value,
-                    "raw_line": stripped,
-                }
-            )
-    return results
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(
-        description="Extract METRIC lines from eval_command output.",
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
-Examples:
-  echo "METRIC accuracy=94.5" | python3 parse-metric.py --metric accuracy
-  python3 parse-metric.py --metric passing_tests --file /tmp/out.txt
-  python3 parse-metric.py --file /tmp/out.txt          # returns all metrics
-        """,
-    )
-    parser.add_argument(
-        "--metric",
-        metavar="NAME",
-        help="Return only this named metric (case-sensitive). Exits 1 if not found.",
-    )
-    parser.add_argument(
-        "--file",
-        metavar="PATH",
-        help="Read from file instead of stdin.",
-    )
-    args = parser.parse_args()
-
-    # --- Read input ---
-    try:
-        if args.file:
-            with open(args.file, "r") as fh:
-                lines = fh.readlines()
-        else:
-            lines = sys.stdin.readlines()
-    except OSError as exc:
-        print(f"error: cannot read input: {exc}", file=sys.stderr)
-        sys.exit(1)
-
-    # --- Parse ---
-    all_metrics = parse_lines(lines)
-
-    if args.metric:
-        # Filter to the requested metric name.
-        matches = [m for m in all_metrics if m["metric"] == args.metric]
-        if not matches:
-            print(
-                f"error: metric '{args.metric}' not found in input",
-                file=sys.stderr,
-            )
-            sys.exit(1)
-        # Return the last occurrence if there are duplicates.
-        result = matches[-1]
-    else:
-        # Return all metrics as a list when no --metric filter is given.
-        result = all_metrics  # type: ignore[assignment]
-
-    print(json.dumps(result, indent=2))
-
-
-if __name__ == "__main__":
-    main()