@cleocode/core 2026.3.45 → 2026.3.47

package/templates/agent-registry.json

@@ -0,0 +1,305 @@
+{
+  "$schema": "https://cleo-dev.com/schemas/v1/agent-registry.schema.json",
+  "schemaVersion": "1.0.0",
+  "lastUpdated": "2026-01-27",
+  "agents": {
+    "claude-code": {
+      "id": "claude-code",
+      "displayName": "Claude Code",
+      "vendor": "Anthropic",
+      "globalDir": "$HOME/.claude",
+      "projectDir": ".claude",
+      "instructionFile": "CLAUDE.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".claude/skills",
+      "priority": "high",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.claude"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Primary CLEO target. Anthropic's official CLI."
+    },
+    "cursor": {
+      "id": "cursor",
+      "displayName": "Cursor",
+      "vendor": "Anysphere",
+      "globalDir": "$HOME/.cursor",
+      "projectDir": ".cursor",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".cursor/skills",
+      "priority": "high",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.cursor"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Popular VS Code fork with AI integration"
+    },
+    "windsurf": {
+      "id": "windsurf",
+      "displayName": "Windsurf",
+      "vendor": "Codeium",
+      "globalDir": "$HOME/.codeium/windsurf",
+      "projectDir": ".windsurf",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".windsurf/skills",
+      "priority": "high",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.codeium/windsurf"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Codeium's AI IDE"
+    },
+    "codex": {
+      "id": "codex",
+      "displayName": "OpenAI Codex",
+      "vendor": "OpenAI",
+      "globalDir": "$HOME/.codex",
+      "projectDir": ".codex",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".codex/skills",
+      "priority": "medium",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.codex"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "OpenAI's coding assistant"
+    },
+    "gemini-cli": {
+      "id": "gemini-cli",
+      "displayName": "Google Gemini",
+      "vendor": "Google",
+      "globalDir": "$HOME/.gemini",
+      "projectDir": ".gemini",
+      "instructionFile": "GEMINI.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".gemini/skills",
+      "priority": "medium",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.gemini"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Google's Gemini CLI assistant"
+    },
+    "github-copilot": {
+      "id": "github-copilot",
+      "displayName": "GitHub Copilot",
+      "vendor": "GitHub/Microsoft",
+      "globalDir": "$HOME/.copilot",
+      "projectDir": ".github",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".github/skills",
+      "priority": "medium",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.copilot"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "GitHub's AI pair programmer"
+    },
+    "opencode": {
+      "id": "opencode",
+      "displayName": "OpenCode",
+      "vendor": "OpenCode",
+      "globalDir": "$HOME/.config/opencode",
+      "projectDir": ".opencode",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".opencode/skills",
+      "priority": "medium",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.config/opencode"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Open-source coding assistant"
+    },
+    "cline": {
+      "id": "cline",
+      "displayName": "Cline",
+      "vendor": "Cline",
+      "globalDir": "$HOME/.cline",
+      "projectDir": ".cline",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".cline/skills",
+      "priority": "medium",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.cline"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "VS Code extension for AI coding"
+    },
+    "kimi": {
+      "id": "kimi",
+      "displayName": "Kimi Coding",
+      "vendor": "Moonshot AI",
+      "globalDir": "$HOME/.kimi",
+      "projectDir": ".kimi",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".kimi/skills",
+      "priority": "medium",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.kimi"
+      },
+      "agentSkillsCompatible": false,
+      "notes": "Moonshot AI's coding assistant"
+    },
+    "roo": {
+      "id": "roo",
+      "displayName": "Roo Code",
+      "vendor": "Roo",
+      "globalDir": "$HOME/.roo",
+      "projectDir": ".roo",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".roo/skills",
+      "priority": "low",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.roo"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Roo coding assistant"
+    },
+    "continue": {
+      "id": "continue",
+      "displayName": "Continue",
+      "vendor": "Continue",
+      "globalDir": "$HOME/.continue",
+      "projectDir": ".continue",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".continue/skills",
+      "priority": "low",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.continue"
+      },
+      "agentSkillsCompatible": false,
+      "notes": "Open-source AI coding assistant"
+    },
+    "antigravity": {
+      "id": "antigravity",
+      "displayName": "Antigravity",
+      "vendor": "Google",
+      "globalDir": "$HOME/.gemini/antigravity",
+      "projectDir": ".antigravity",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "global_skills",
+      "projectSkillsDir": ".antigravity/skills",
+      "priority": "low",
+      "status": "beta",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.gemini/antigravity"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Google's experimental coding assistant"
+    },
+    "goose": {
+      "id": "goose",
+      "displayName": "Goose",
+      "vendor": "Block",
+      "globalDir": "$HOME/.goose",
+      "projectDir": ".goose",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".goose/skills",
+      "priority": "low",
+      "status": "active",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.goose"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Block's open-source AI agent"
+    },
+    "kiro-cli": {
+      "id": "kiro-cli",
+      "displayName": "Kiro CLI",
+      "vendor": "Kiro",
+      "globalDir": "$HOME/.kiro",
+      "projectDir": ".kiro",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".kiro/skills",
+      "priority": "low",
+      "status": "beta",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.kiro"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Kiro command-line coding assistant"
+    },
+    "amp": {
+      "id": "amp",
+      "displayName": "Amp",
+      "vendor": "Sourcegraph",
+      "globalDir": "$HOME/.amp",
+      "projectDir": ".amp",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".amp/skills",
+      "priority": "low",
+      "status": "beta",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.amp"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "Sourcegraph's AI coding assistant"
+    },
+    "trae": {
+      "id": "trae",
+      "displayName": "Trae",
+      "vendor": "ByteDance",
+      "globalDir": "$HOME/.trae",
+      "projectDir": ".trae",
+      "instructionFile": "AGENTS.md",
+      "skillsDir": "skills",
+      "projectSkillsDir": ".trae/skills",
+      "priority": "low",
+      "status": "beta",
+      "cliDetection": {
+        "method": "directory",
+        "check": "$HOME/.trae"
+      },
+      "agentSkillsCompatible": true,
+      "notes": "ByteDance's AI IDE"
+    }
+  },
+  "instructionFileMap": {
+    "CLAUDE.md": ["claude-code"],
+    "GEMINI.md": ["gemini-cli"],
+    "AGENTS.md": ["cursor", "windsurf", "codex", "github-copilot", "opencode", "cline", "kimi", "roo", "continue", "antigravity", "goose", "kiro-cli", "amp", "trae"]
+  },
+  "priorityTiers": {
+    "tier1": ["claude-code", "cursor", "windsurf"],
+    "tier2": ["codex", "gemini-cli", "github-copilot", "opencode", "cline", "kimi"],
+    "tier3": ["roo", "continue", "antigravity", "goose", "kiro-cli", "amp", "trae"]
+  }
+}

package/templates/cleo-gitignore

@@ -0,0 +1,74 @@
+# =============================================================================
+# .cleo/.gitignore — Deny-by-default for CLEO project data
+# =============================================================================
+# STRATEGY: Ignore everything, then explicitly allow only tracked files.
+# This prevents runtime data (databases, logs, caches, metrics) from ever
+# being accidentally committed.
+#
+# Canonical audit: .cleo/agent-outputs/T5159-cleo-file-audit.md
+# ADR: ADR-013-data-integrity-checkpoint-architecture.md
+# =============================================================================
+
+# Step 1: Ignore everything in .cleo/
+*
+
+# =============================================================================
+# ALLOW LIST — files and directories that SHOULD be tracked
+# =============================================================================
+
+# Step 2: Allow this .gitignore itself
+!.gitignore
+
+# Step 3: Allow project configuration files
+!config.json
+!project-context.json
+!project-info.json
+!setup-otel.sh
+!DATA-SAFETY-IMPLEMENTATION-SUMMARY.md
+
+# Step 4: Allow ADRs directory (architecture decisions — project-level, not CLEO-specific)
+!adrs/
+!adrs/**
+
+# Step 5: Allow RCASD lifecycle provenance directory
+# Structure: rcasd/{epic#}/research/, consensus/, architecture/, specs/, contributions/
+!rcasd/
+!rcasd/**
+
+# Step 6: Allow agent-outputs directory
+!agent-outputs/
+!agent-outputs/**
+
+# =============================================================================
+# EXPLICIT DENY — safety net that overrides allow rules above
+# =============================================================================
+
+# SQLite databases — NEVER track (data loss root cause, ADR-013)
+*.db
+*.db-shm
+*.db-wal
+*.db-journal
+
+# Logs — NEVER track (append-only runtime data)
+log.json
+tasks-log.jsonl
+todo-log.jsonl
+bypass-log.json
+qa-log.json
+
+# Caches and transient state
+.deps-cache/
+.context-alert-state.json
+.context-state*.json
+context-states/
+.git-checkpoint-state
+.migration-state.json
+
+# Instance-specific runtime data
+migrations.json
+sync/
+metrics/
+
+# Backups — NEVER track
+.backups/
+backups/

package/templates/config.template.json

@@ -0,0 +1,187 @@
+{
+  "$schema": "../schemas/config.schema.json",
+  "version": "{{SCHEMA_VERSION_CONFIG}}",
+  "_meta": {
+    "schemaVersion": "{{SCHEMA_VERSION_CONFIG}}",
+    "createdAt": "{{TIMESTAMP}}",
+    "updatedAt": "{{TIMESTAMP}}"
+  },
+
+  "archive": {
+    "enabled": true,
+    "daysUntilArchive": 7,
+    "maxCompletedTasks": 15,
+    "preserveRecentCount": 3,
+    "archiveOnSessionEnd": true,
+    "autoArchiveOnComplete": false
+  },
+
+  "logging": {
+    "enabled": true,
+    "retentionDays": 30,
+    "level": "standard",
+    "logSessionEvents": true
+  },
+
+  "validation": {
+    "strictMode": false,
+    "checksumEnabled": true,
+    "enforceAcceptance": true,
+    "requireDescription": false,
+    "maxActiveTasks": 1,
+    "validateDependencies": true,
+    "detectCircularDeps": true
+  },
+
+  "defaults": {
+    "priority": "medium",
+    "phase": "core",
+    "labels": []
+  },
+
+  "session": {
+    "requireSession": true,
+    "requireSessionNote": true,
+    "requireNotesOnComplete": true,
+    "warnOnNoFocus": true,
+    "allowNestedSessions": true,
+    "allowParallelAgents": true,
+    "autoStartSession": true,
+    "autoDiscoveryOnStart": true,
+    "sessionTimeoutHours": 72
+  },
+
+  "multiSession": {
+    "enabled": true,
+    "maxConcurrentSessions": 5,
+    "maxActiveTasksPerScope": 1,
+    "scopeValidation": "strict",
+    "allowNestedScopes": true,
+    "allowScopeOverlap": false
+  },
+
+  "release": {
+    "gates": [],
+    "changelog": {
+      "enabled": true,
+      "autoGenerate": false,
+      "source": "CHANGELOG.md",
+      "outputs": []
+    }
+  },
+
+  "display": {
+    "showArchiveCount": true,
+    "showLogSummary": true,
+    "warnStaleDays": 30
+  },
+
+  "output": {
+    "defaultFormat": "text",
+    "showColor": true,
+    "showUnicode": true,
+    "showProgressBars": true,
+    "csvDelimiter": ",",
+    "dateFormat": "iso8601",
+    "showCompactTitles": false,
+    "maxTitleLength": 80
+  },
+
+  "cli": {
+    "aliases": {
+      "ls": "list",
+      "done": "complete",
+      "new": "add",
+      "edit": "update",
+      "rm": "archive",
+      "check": "validate"
+    },
+    "plugins": {
+      "enabled": true,
+      "directories": ["~/.cleo/plugins", "./.cleo/plugins"],
+      "autoDiscover": true
+    },
+    "debug": {
+      "enabled": true,
+      "validateMappings": true,
+      "checksumVerify": true,
+      "showTimings": false
+    }
+  },
+
+  "backup": {
+    "enabled": true,
+    "directory": ".cleo/backups",
+    "maxSnapshots": 10,
+    "maxSafetyBackups": 5,
+    "maxIncremental": 10,
+    "maxArchiveBackups": 3,
+    "safetyRetentionDays": 7
+  },
+
+  "cancellation": {
+    "cascadeConfirmThreshold": 10,
+    "requireReason": true,
+    "daysUntilArchive": 3,
+    "allowCascade": true,
+    "defaultChildStrategy": "block"
+  },
+
+  "contextAlerts": {
+    "enabled": true,
+    "minThreshold": "warning",
+    "triggerCommands": ["complete", "start", "stop", "add", "session"],
+    "suppressDuration": 0
+  },
+
+  "orchestrator": {
+    "contextThresholds": {
+      "warning": 70,
+      "critical": 80
+    },
+    "autoStopOnCritical": true,
+    "hitlSummaryOnPause": true
+  },
+
+  "agentOutputs": {
+    "directory": ".cleo/agent-outputs",
+    "manifestFile": "MANIFEST.jsonl",
+    "archiveDir": "archive",
+    "archiveDays": 30
+  },
+
+  "retention": {
+    "maxArchivedSessions": 100,
+    "autoArchiveEndedAfterDays": 30,
+    "autoDeleteArchivedAfterDays": 90,
+    "contextStateRetentionDays": 7,
+    "cleanupOnSessionEnd": true,
+    "dryRunByDefault": true,
+    "maxSessionsInMemory": 100,
+    "autoEndActiveAfterDays": 7
+  },
+
+  "project": {
+    "status": {
+      "health": "unknown",
+      "lastCheck": null,
+      "schemaVersions": {
+        "todo": "{{SCHEMA_VERSION_TODO}}",
+        "config": "{{SCHEMA_VERSION_CONFIG}}",
+        "archive": "{{SCHEMA_VERSION_ARCHIVE}}",
+        "log": "{{SCHEMA_VERSION_LOG}}"
+      },
+      "validation": {
+        "lastValidated": null,
+        "passed": false,
+        "errors": [],
+        "warnings": []
+      },
+      "injection": {
+        "CLAUDE.md": "not_found",
+        "AGENTS.md": "not_found",
+        "GEMINI.md": "not_found"
+      }
+    }
+  }
+}