k0ntext 3.0.0

package/templates/base/schemas/research.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/research.schema.json",
+  "title": "Claude Context Research Document",
+  "description": "Schema for RPI research phase documents (YAML frontmatter)",
+  "type": "object",
+  "required": ["name", "objective", "status"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Research topic/feature name"
+    },
+    "objective": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "What this research aims to discover"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["in-progress", "completed", "blocked", "archived"],
+      "description": "Current research status"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Research start time"
+    },
+    "completed_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Research completion time"
+    },
+    "context_tokens_used": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Tokens used during research"
+    },
+    "files_explored": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "file": { "type": "string" },
+          "lines": { "type": "string", "description": "Line range (e.g., '10-50')" },
+          "findings": { "type": "string" }
+        },
+        "required": ["file"]
+      },
+      "description": "Files explored with findings"
+    },
+    "call_chains": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "entry_point": { "type": "string" },
+          "depth": { "type": "integer" },
+          "chain": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        }
+      },
+      "description": "Traced call chains"
+    },
+    "dependencies": {
+      "type": "object",
+      "properties": {
+        "internal": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Internal module dependencies"
+        },
+        "external": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "External service dependencies"
+        }
+      },
+      "description": "Identified dependencies"
+    },
+    "test_coverage": {
+      "type": "object",
+      "properties": {
+        "existing_tests": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "gaps": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "description": "Test coverage analysis"
+    },
+    "open_questions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Unresolved questions"
+    },
+    "summary": {
+      "type": "string",
+      "maxLength": 1000,
+      "description": "Executive summary (max 150 words recommended)"
+    },
+    "next_phase": {
+      "type": "string",
+      "enum": ["plan", "more-research", "blocked"],
+      "description": "Recommended next phase"
+    }
+  },
+  "additionalProperties": false
+}

package/templates/base/schemas/roles.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/roles.schema.json",
+  "title": "Claude Context Team Roles",
+  "description": "Schema for team/roles.json",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "roles": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "description": { "type": "string" },
+          "permissions": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "default_agent": { "type": "string" }
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/templates/base/schemas/session.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/session.schema.json",
+  "title": "Claude Context Session State",
+  "description": "Schema for session/current/state.json",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "sessionId": {
+      "type": ["string", "null"],
+      "description": "Unique session identifier"
+    },
+    "started": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "Session start timestamp"
+    },
+    "lastActivity": {
+      "type": ["string", "null"],
+      "format": "date-time",
+      "description": "Last activity timestamp"
+    },
+    "phase": {
+      "type": "string",
+      "enum": ["idle", "research", "plan", "implement"],
+      "default": "idle",
+      "description": "Current RPI phase"
+    },
+    "task": {
+      "type": "object",
+      "properties": {
+        "name": { "type": ["string", "null"] },
+        "description": { "type": ["string", "null"] },
+        "artifacts": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "startedAt": {
+          "type": ["string", "null"],
+          "format": "date-time"
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "properties": {
+        "tokensUsed": { "type": "integer", "default": 0 },
+        "filesLoaded": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "workflowsReferenced": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "pendingUpdates": {
+      "type": "array",
+      "items": {
+        "type": ["string", "object"]
+      },
+      "description": "Pending documentation updates"
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": ["string", "object"]
+      },
+      "description": "Session notes"
+    }
+  },
+  "additionalProperties": true
+}

package/templates/base/schemas/settings.schema.json

@@ -0,0 +1,244 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/settings.schema.json",
+  "title": "Claude Context Engineering Settings",
+  "description": "Configuration schema for Claude Code context engineering system",
+  "type": "object",
+  "required": ["version", "context_engineering"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the configuration format"
+    },
+    "context_engineering": {
+      "type": "object",
+      "description": "Core context engineering settings",
+      "required": ["enabled", "max_context_tokens"],
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable context engineering features"
+        },
+        "max_context_tokens": {
+          "type": "integer",
+          "minimum": 1000,
+          "maximum": 200000,
+          "default": 200000,
+          "description": "Maximum context window size in tokens"
+        },
+        "max_output_tokens": {
+          "type": "integer",
+          "minimum": 1000,
+          "maximum": 30000,
+          "default": 30000,
+          "description": "Maximum output tokens per response"
+        },
+        "target_utilization": {
+          "type": "number",
+          "minimum": 0.1,
+          "maximum": 1.0,
+          "default": 0.40,
+          "description": "Target context utilization (0.0-1.0)"
+        },
+        "compact_trigger": {
+          "type": "number",
+          "minimum": 0.1,
+          "maximum": 1.0,
+          "default": 0.35,
+          "description": "Context utilization threshold to trigger compaction"
+        }
+      }
+    },
+    "rpi_workflow": {
+      "type": "object",
+      "description": "Research-Plan-Implement workflow settings",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable RPI workflow commands"
+        },
+        "phases": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["research", "plan", "implement"]
+          },
+          "default": ["research", "plan", "implement"],
+          "description": "Enabled RPI phases"
+        },
+        "require_human_approval": {
+          "type": "boolean",
+          "default": true,
+          "description": "Require human approval before implementation"
+        },
+        "auto_doc_update": {
+          "type": "boolean",
+          "default": true,
+          "description": "Automatically update documentation after changes"
+        },
+        "research_timeout_minutes": {
+          "type": "integer",
+          "minimum": 5,
+          "maximum": 120,
+          "default": 30,
+          "description": "Timeout for research phase in minutes"
+        },
+        "plan_timeout_minutes": {
+          "type": "integer",
+          "minimum": 5,
+          "maximum": 60,
+          "default": 20,
+          "description": "Timeout for plan phase in minutes"
+        }
+      }
+    },
+    "documentation": {
+      "type": "object",
+      "description": "Documentation maintenance settings",
+      "properties": {
+        "self_maintaining": {
+          "type": "boolean",
+          "default": true,
+          "description": "Enable self-maintaining documentation features"
+        },
+        "verify_after_changes": {
+          "type": "boolean",
+          "default": true,
+          "description": "Verify documentation after code changes"
+        },
+        "line_number_tolerance": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 50,
+          "default": 10,
+          "description": "Acceptable line number drift tolerance"
+        },
+        "auto_commit_docs": {
+          "type": "boolean",
+          "default": false,
+          "description": "Automatically commit documentation updates"
+        }
+      }
+    },
+    "agents": {
+      "type": "object",
+      "description": "Agent configuration",
+      "properties": {
+        "default": {
+          "type": "string",
+          "default": "context-engineer",
+          "description": "Default agent for initialization tasks"
+        },
+        "auto_select": {
+          "type": "boolean",
+          "default": true,
+          "description": "Automatically select appropriate agent for task"
+        },
+        "fallback": {
+          "type": "string",
+          "description": "Fallback agent when auto-selection fails"
+        }
+      }
+    },
+    "commands": {
+      "type": "object",
+      "description": "Command configuration",
+      "properties": {
+        "rpi_commands": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": ["/rpi-research", "/rpi-plan", "/rpi-implement"],
+          "description": "RPI workflow commands"
+        },
+        "validation_commands": {
+          "type": "array",
+          "items": { "type": "string" },
+          "default": ["/verify-docs-current", "/validate-all"],
+          "description": "Validation commands"
+        }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "description": "Validation settings",
+      "properties": {
+        "on_commit": {
+          "type": "boolean",
+          "default": true,
+          "description": "Run validation on commit"
+        },
+        "line_accuracy_threshold": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "default": 60,
+          "description": "Minimum line number accuracy percentage"
+        },
+        "link_check_external": {
+          "type": "boolean",
+          "default": false,
+          "description": "Check external links (slower)"
+        }
+      }
+    },
+    "logging": {
+      "type": "object",
+      "description": "Logging configuration",
+      "properties": {
+        "level": {
+          "type": "string",
+          "enum": ["debug", "info", "warn", "error"],
+          "default": "info",
+          "description": "Minimum log level"
+        },
+        "file": {
+          "type": "string",
+          "default": ".ai-context/logs/claude.log",
+          "description": "Log file path"
+        },
+        "max_size_mb": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 100,
+          "default": 10,
+          "description": "Maximum log file size in MB"
+        }
+      }
+    },
+    "telemetry": {
+      "type": "object",
+      "description": "Optional telemetry settings (opt-in only)",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "default": false,
+          "description": "Enable telemetry (opt-in)"
+        },
+        "events": {
+          "type": "object",
+          "properties": {
+            "command_usage": { "type": "boolean", "default": true },
+            "agent_usage": { "type": "boolean", "default": true },
+            "context_metrics": { "type": "boolean", "default": true },
+            "error_reports": { "type": "boolean", "default": true }
+          }
+        },
+        "privacy": {
+          "type": "object",
+          "properties": {
+            "anonymize_paths": { "type": "boolean", "default": true },
+            "exclude_content": { "type": "boolean", "default": true }
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/templates/base/schemas/staleness.schema.json

@@ -0,0 +1,53 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/staleness.schema.json",
+  "title": "Claude Context Staleness Tracking",
+  "description": "Schema for sync/staleness.json - documentation freshness tracking",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string"
+    },
+    "thresholds": {
+      "type": "object",
+      "properties": {
+        "warningDays": {
+          "type": "integer",
+          "default": 30,
+          "description": "Days before warning status"
+        },
+        "staleDays": {
+          "type": "integer",
+          "default": 90,
+          "description": "Days before stale status"
+        }
+      }
+    },
+    "workflows": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "lastVerified": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["verified", "warning", "stale"]
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/templates/base/schemas/team-config.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/team-config.schema.json",
+  "title": "Claude Context Team Configuration",
+  "description": "Schema for team/config.json",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "team": {
+      "type": "object",
+      "properties": {
+        "name": { "type": "string" },
+        "description": { "type": "string" }
+      }
+    },
+    "collaboration": {
+      "type": "object",
+      "properties": {
+        "enabled": { "type": "boolean", "default": true },
+        "handoff_required": { "type": "boolean", "default": true },
+        "knowledge_sharing": { "type": "boolean", "default": true }
+      }
+    },
+    "notifications": {
+      "type": "object",
+      "properties": {
+        "on_session_end": { "type": "boolean", "default": true },
+        "on_gotcha_found": { "type": "boolean", "default": true },
+        "on_decision_made": { "type": "boolean", "default": true }
+      }
+    }
+  },
+  "additionalProperties": true
+}