k0ntext 3.0.0

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

@@ -0,0 +1,54 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/anchors.schema.json",
+  "title": "Claude Context Semantic Anchors",
+  "description": "Schema for sync/anchors.json - maps function signatures to workflow references",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string"
+    },
+    "generatedAt": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "files": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "anchors": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "line": { "type": "integer" },
+                "type": { "type": "string" },
+                "signature": { "type": "string" },
+                "hash": { "type": "string" },
+                "workflows": {
+                  "type": "array",
+                  "items": { "type": "string" }
+                }
+              }
+            }
+          },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,93 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/automation.schema.json",
+  "title": "Claude Context Automation Configuration",
+  "description": "Schema for automation/config.json",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Configuration version"
+    },
+    "generators": {
+      "type": "object",
+      "description": "Auto-generation settings",
+      "properties": {
+        "code_mapper": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "output": { "type": "string" },
+            "include_patterns": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "exclude_patterns": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        },
+        "index_builder": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "rebuild_on_change": { "type": "boolean", "default": true },
+            "indexes": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Git hook settings",
+      "properties": {
+        "pre_commit": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "check_drift": { "type": "boolean", "default": true },
+            "block_on_stale": { "type": "boolean", "default": false }
+          }
+        },
+        "post_commit": {
+          "type": "object",
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "rebuild_code_map": { "type": "boolean", "default": true },
+            "update_hashes": { "type": "boolean", "default": true }
+          }
+        }
+      }
+    },
+    "sync": {
+      "type": "object",
+      "description": "Synchronization settings",
+      "properties": {
+        "semantic_anchors": { "type": "boolean", "default": true },
+        "hash_algorithm": {
+          "type": "string",
+          "enum": ["md5", "sha1", "sha256"],
+          "default": "md5"
+        },
+        "staleness_thresholds": {
+          "type": "object",
+          "properties": {
+            "warning_days": { "type": "integer", "default": 30 },
+            "stale_days": { "type": "integer", "default": 90 }
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,134 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/command.schema.json",
+  "title": "Claude Context Command",
+  "description": "Schema for command manifest files",
+  "type": "object",
+  "required": ["name", "version", "description"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "minLength": 1,
+      "maxLength": 50,
+      "description": "Command identifier (without leading slash)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Command version (semver)"
+    },
+    "displayName": {
+      "type": "string",
+      "maxLength": 100,
+      "description": "Human-readable command name"
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "Brief description of command purpose"
+    },
+    "category": {
+      "type": "string",
+      "enum": [
+        "rpi-orchestration",
+        "validation",
+        "system",
+        "debugging",
+        "documentation",
+        "extension-management",
+        "collaboration",
+        "custom"
+      ],
+      "description": "Command category"
+    },
+    "syntax": {
+      "type": "string",
+      "description": "Command syntax pattern (e.g., '/command [arg1] [--flag]')"
+    },
+    "arguments": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "type": {
+            "type": "string",
+            "enum": ["string", "number", "boolean", "file", "directory"]
+          },
+          "required": { "type": "boolean", "default": false },
+          "description": { "type": "string" },
+          "default": {}
+        },
+        "required": ["name", "type", "description"]
+      },
+      "description": "Command arguments"
+    },
+    "flags": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": { "type": "string" },
+          "short": { "type": "string", "maxLength": 1 },
+          "type": { "type": "string", "enum": ["boolean", "string", "number"] },
+          "description": { "type": "string" },
+          "default": {}
+        },
+        "required": ["name", "description"]
+      },
+      "description": "Command flags/options"
+    },
+    "context_budget_estimate": {
+      "type": "string",
+      "description": "Estimated token usage (e.g., '50K tokens')"
+    },
+    "typical_context_usage": {
+      "type": "string",
+      "pattern": "^\\d+%$",
+      "description": "Typical usage as percentage (e.g., '25%')"
+    },
+    "prerequisites": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Required conditions before running"
+    },
+    "outputs": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "What this command produces"
+    },
+    "next_commands": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Suggested follow-up commands"
+    },
+    "related_agents": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Related agents"
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "command": { "type": "string" },
+          "description": { "type": "string" }
+        },
+        "required": ["command", "description"]
+      },
+      "description": "Usage examples"
+    },
+    "exit_criteria": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Checklist for command completion"
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,40 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/hashes.schema.json",
+  "title": "Claude Context File Hashes",
+  "description": "Schema for sync/hashes.json - content hashes for drift detection",
+  "type": "object",
+  "required": ["version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string"
+    },
+    "generatedAt": {
+      "type": ["string", "null"],
+      "format": "date-time"
+    },
+    "files": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "hash": { "type": "string" },
+          "updatedAt": {
+            "type": "string",
+            "format": "date-time"
+          }
+        },
+        "required": ["hash"]
+      }
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,117 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/manifest.schema.json",
+  "title": "Claude Context Manifest",
+  "description": "Root manifest for Claude context engineering installation",
+  "type": "object",
+  "required": ["name", "version"],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema reference"
+    },
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+$",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Project context name (lowercase, hyphens allowed)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of this context installation"
+    },
+    "claude_context_version": {
+      "type": "string",
+      "description": "Compatible claude-context template version (semver range)"
+    },
+    "description": {
+      "type": "string",
+      "maxLength": 500,
+      "description": "Brief description of the project context"
+    },
+    "repository": {
+      "type": "string",
+      "format": "uri",
+      "description": "Repository URL"
+    },
+    "author": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "email": { "type": "string", "format": "email" },
+            "url": { "type": "string", "format": "uri" }
+          },
+          "required": ["name"]
+        }
+      ],
+      "description": "Author information"
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier"
+    },
+    "keywords": {
+      "type": "array",
+      "items": { "type": "string" },
+      "maxItems": 20,
+      "description": "Keywords for discovery"
+    },
+    "agents": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of agent names included"
+    },
+    "commands": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of command names included"
+    },
+    "workflows": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of workflow names documented"
+    },
+    "extensions": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Installed extension identifiers"
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Extension dependencies with version ranges"
+    },
+    "config": {
+      "type": "object",
+      "description": "Default configuration overrides",
+      "properties": {
+        "context_budget": {
+          "type": "object",
+          "properties": {
+            "max_tokens": { "type": "integer" },
+            "target_utilization": { "type": "number" },
+            "compact_trigger": { "type": "number" }
+          }
+        },
+        "rpi": {
+          "type": "object",
+          "properties": {
+            "require_human_approval": { "type": "boolean" },
+            "auto_doc_update": { "type": "boolean" }
+          }
+        }
+      }
+    },
+    "scripts": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Custom scripts (init, validate, etc.)"
+    }
+  },
+  "additionalProperties": false
+}

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

@@ -0,0 +1,136 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://claude-context.dev/schemas/plan.schema.json",
+  "title": "Claude Context Implementation Plan",
+  "description": "Schema for RPI plan phase documents (YAML frontmatter)",
+  "type": "object",
+  "required": ["name", "status", "research_ref"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Plan name matching research document"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "pending-approval", "approved", "in-progress", "completed", "rejected", "archived"],
+      "description": "Current plan status"
+    },
+    "research_ref": {
+      "type": "string",
+      "description": "Path to research document this plan is based on"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Plan creation time"
+    },
+    "approved_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Plan approval time"
+    },
+    "approved_by": {
+      "type": "string",
+      "description": "Who approved the plan"
+    },
+    "completed_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Plan completion time"
+    },
+    "scope": {
+      "type": "object",
+      "properties": {
+        "in_scope": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Explicitly included items"
+        },
+        "out_of_scope": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Explicitly excluded items"
+        }
+      },
+      "description": "Scope definition"
+    },
+    "modifications": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "file": { "type": "string" },
+          "lines": { "type": "string", "description": "Line range (e.g., '10-50')" },
+          "change": { "type": "string" },
+          "risk": {
+            "type": "string",
+            "enum": ["low", "medium", "high"]
+          }
+        },
+        "required": ["file", "change"]
+      },
+      "description": "Planned file modifications"
+    },
+    "steps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "order": { "type": "integer" },
+          "description": { "type": "string" },
+          "file": { "type": "string" },
+          "lines": { "type": "string" },
+          "current_code": { "type": "string" },
+          "proposed_code": { "type": "string" },
+          "test_command": { "type": "string" },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "in-progress", "completed", "failed"]
+          }
+        },
+        "required": ["order", "description"]
+      },
+      "description": "Step-by-step implementation"
+    },
+    "test_strategy": {
+      "type": "object",
+      "properties": {
+        "unit_tests": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "integration_tests": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "e2e_tests": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "description": "Testing strategy"
+    },
+    "rollback_plan": {
+      "type": "string",
+      "description": "How to rollback if implementation fails"
+    },
+    "doc_updates_required": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Documentation files to update"
+    },
+    "estimated_context_tokens": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Estimated tokens for implementation"
+    },
+    "actual_context_tokens": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Actual tokens used"
+    }
+  },
+  "additionalProperties": false
+}