rosett-ai 1.3.3

data/conf/schemas/lockfile_schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://neatnerds.be/schemas/rosett-ai/lockfile_schema.json",
+  "title": "rosett-ai Lockfile Schema",
+  "description": "Schema for .rosett-ai-lock.yml behaviour composition lockfile",
+  "type": "object",
+  "required": ["lockfile_version", "generated_at", "generator", "generator_version", "rule_count", "behaviours", "composition"],
+  "properties": {
+    "lockfile_version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Lockfile format version"
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of generation"
+    },
+    "generator": {
+      "type": "string",
+      "const": "rosett-ai",
+      "description": "Tool that generated this lockfile"
+    },
+    "generator_version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+",
+      "description": "Version of Rosett-AI that generated this lockfile"
+    },
+    "rule_count": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Total number of composed rules"
+    },
+    "behaviours": {
+      "type": "object",
+      "description": "Map of behaviour file relative paths to SHA-256 checksums",
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^sha256:[a-f0-9]{64}$"
+      }
+    },
+    "composition": {
+      "type": "array",
+      "description": "Ordered list of composed rules",
+      "items": {
+        "type": "object",
+        "required": ["id", "behaviour", "scope", "priority"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Rule identifier"
+          },
+          "behaviour": {
+            "type": "string",
+            "description": "Source behaviour name"
+          },
+          "scope": {
+            "type": "string",
+            "enum": ["global", "organisation", "project", "local"],
+            "description": "Scope in which this rule was defined"
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Rule priority (1=highest)"
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/conf/schemas/mcp_server_schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MCP Server Configuration",
+  "description": "Schema for Rosett-AI MCP server configuration files",
+  "type": "object",
+  "required": ["name", "transport"],
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Unique server name"
+    },
+    "transport": {
+      "type": "string",
+      "enum": ["stdio", "http", "streamable-http"],
+      "description": "Transport protocol"
+    },
+    "command": {
+      "type": ["string", "array"],
+      "description": "Command to launch stdio server"
+    },
+    "url": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL for HTTP transport"
+    },
+    "args": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Additional command arguments"
+    },
+    "env": {
+      "type": "object",
+      "additionalProperties": { "type": "string" },
+      "description": "Environment variables"
+    },
+    "source_file": {
+      "type": "string",
+      "description": "Path to source configuration file"
+    }
+  },
+  "if": { "properties": { "transport": { "const": "stdio" } } },
+  "then": { "required": ["command"] },
+  "else": {
+    "if": { "properties": { "transport": { "enum": ["http", "streamable-http"] } } },
+    "then": { "required": ["url"] }
+  }
+}

data/conf/schemas/packaging_schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/packaging_schema.json",
+  "title": "NeatNerds Package Variant",
+  "description": "Schema for validating packaging variant configurations. Each variant defines a Debian package with its dependencies and metadata.",
+  "$comment": {
+    "date": "2026-02-21",
+    "version": "1.0.0",
+    "source": "rosett-ai"
+  },
+  "type": "object",
+  "required": ["name", "variant", "description"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "pattern": "^rosett-ai(-[a-z0-9]+)?$",
+      "description": "Debian package name (e.g. rosett-ai, rosett-ai-gtk4)"
+    },
+    "variant": {
+      "type": "string",
+      "enum": ["core", "gtk4", "qt6", "kde"],
+      "description": "Package variant identifier"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable package description"
+    },
+    "ui_adapter": {
+      "type": "string",
+      "enum": ["tui", "gtk4", "qt6", "kde"],
+      "description": "UI adapter this variant provides"
+    },
+    "system_dependencies": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      },
+      "uniqueItems": true,
+      "description": "Debian system package dependencies"
+    },
+    "package_dependencies": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "version"],
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Dependency package name"
+          },
+          "version": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Version constraint. Use 'current' to resolve to RosettAi::VERSION at load time.",
+            "pattern": "^(current|[><=~!]+\\s*\\d+\\.\\d+(\\.\\d+)?)$"
+          }
+        }
+      },
+      "uniqueItems": true,
+      "description": "rosett-ai package dependencies with version constraints"
+    }
+  }
+}

data/conf/schemas/policy_schema.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://neatnerds.be/rosett-ai/schemas/policy",
+  "title": "rosett-ai Policy Schema",
+  "description": "Schema for rai policy configuration files",
+  "type": "object",
+  "required": ["policy_version", "tier"],
+  "properties": {
+    "policy_version": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "Schema version for this policy file"
+    },
+    "tier": {
+      "type": "string",
+      "enum": ["mandatory", "advisory", "informational"],
+      "description": "Policy enforcement tier"
+    },
+    "scope": {
+      "type": "string",
+      "enum": ["org", "team", "project"],
+      "description": "Policy scope in the hierarchy"
+    },
+    "deny_list": {
+      "type": "object",
+      "properties": {
+        "patterns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Glob patterns for denied file access"
+        }
+      },
+      "required": ["patterns"]
+    },
+    "protected_files": {
+      "type": "object",
+      "properties": {
+        "paths": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "File paths that AI may read but not modify"
+        }
+      },
+      "required": ["paths"]
+    },
+    "rate_limiting": {
+      "type": "object",
+      "properties": {
+        "max_ai_prs_per_week": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Maximum AI-assisted PRs per contributor per week (advisory)"
+        },
+        "enforcement": {
+          "type": "string",
+          "enum": ["advisory", "enforced"],
+          "default": "advisory",
+          "description": "Whether rate limiting is advisory or enforced"
+        }
+      }
+    },
+    "license_policy": {
+      "type": "object",
+      "properties": {
+        "allowed": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Allowed SPDX license identifiers"
+        },
+        "rejected": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Rejected SPDX license identifiers"
+        }
+      }
+    }
+  },
+  "additionalProperties": false
+}

data/conf/schemas/provenance_schema.json

@@ -0,0 +1,84 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://neatnerds.be/rosett-ai/schemas/provenance.json",
+  "title": "rosett-ai AI Provenance",
+  "description": "Schema for .ai-provenance.yml files tracking AI involvement in code contributions",
+  "type": "object",
+  "required": ["provenance_version", "entries"],
+  "additionalProperties": false,
+  "properties": {
+    "provenance_version": {
+      "type": "integer",
+      "const": 1,
+      "description": "Schema version for forwards compatibility"
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/entry"
+      }
+    }
+  },
+  "$defs": {
+    "entry": {
+      "type": "object",
+      "required": ["commit", "timestamp", "contributor", "ai_tool", "ai_role", "files"],
+      "additionalProperties": false,
+      "properties": {
+        "commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{7,40}$",
+          "description": "Git commit SHA (short or full)"
+        },
+        "timestamp": {
+          "type": "string",
+          "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}Z$",
+          "description": "ISO 8601 UTC timestamp"
+        },
+        "contributor": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Contributor name and email"
+        },
+        "ai_tool": {
+          "type": "string",
+          "minLength": 1,
+          "description": "AI tool identifier (e.g. 'Claude Opus 4.6 (Anthropic)')"
+        },
+        "ai_role": {
+          "type": "string",
+          "enum": ["AI-Generated-By", "AI-Co-Author", "AI-Assisted-By", "AI-Reviewed-By"],
+          "description": "Role the AI played in the contribution"
+        },
+        "files": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/file_source"
+          }
+        }
+      }
+    },
+    "file_source": {
+      "type": "object",
+      "required": ["path", "source_type"],
+      "additionalProperties": false,
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Relative path from project root"
+        },
+        "lines": {
+          "type": "string",
+          "pattern": "^\\d+(-\\d+)?$",
+          "description": "Line range (e.g. '1-50')"
+        },
+        "source_type": {
+          "type": "string",
+          "enum": ["library_api", "project_code", "documentation", "pattern", "external_source"],
+          "description": "Classification of the AI's source material"
+        }
+      }
+    }
+  }
+}

data/conf/schemas/rai_config_schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/rai_config_schema.json",
+  "title": "NeatNerds Code Companion Configuration",
+  "description": "Schema for ~/.config/rosett-ai/config.yml — rosett-ai runtime configuration.",
+  "$comment": {
+    "date": "2026-02-26",
+    "version": "1.0.0",
+    "source": "rosett-ai"
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "default_engine": {
+      "type": "string",
+      "enum": ["claude", "generic"],
+      "description": "Default engine for compile and adopt commands"
+    },
+    "cache": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Enable adopt result caching"
+        },
+        "ttl_hours": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 720,
+          "description": "Cache time-to-live in hours"
+        }
+      }
+    },
+    "detect": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "on_init": {
+          "type": "boolean",
+          "description": "Run engine detection during rai init"
+        }
+      }
+    },
+    "dbus": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "allow_plugin_management": {
+          "type": "boolean",
+          "description": "Allow InstallPlugin/RemovePlugin D-Bus methods. Disabled by default for security."
+        }
+      }
+    }
+  }
+}

data/conf/schemas/rai_project_schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "rai project configuration",
+  "description": "Schema for .rosett-ai/config.yml project marker files",
+  "type": "object",
+  "required": ["project_name"],
+  "properties": {
+    "project_name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable project name"
+    },
+    "default_engine": {
+      "type": "string",
+      "default": "claude",
+      "description": "Default compilation engine for this project"
+    }
+  },
+  "additionalProperties": false
+}

data/conf/schemas/scope_hierarchy_schema.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/scope_hierarchy_schema.json",
+  "title": "NeatNerds Scope Hierarchy Configuration",
+  "description": "Schema for scope hierarchy merge strategy configuration in .rosett-ai/config.yml",
+  "$comment": {
+    "date": "2026-03-23",
+    "version": "0.1.0",
+    "source": "rosett-ai"
+  },
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "merge_strategies": {
+      "type": "object",
+      "description": "Per-key merge strategy overrides. Keys are dot-separated paths into behaviour data.",
+      "additionalProperties": {
+        "type": "string",
+        "enum": ["deep_merge", "replace", "array_union", "first_found"],
+        "description": "Merge strategy for this key"
+      }
+    },
+    "scope_defaults": {
+      "type": "object",
+      "description": "Default merge strategies by value type when no per-key override is set.",
+      "additionalProperties": false,
+      "properties": {
+        "hash": {
+          "type": "string",
+          "enum": ["deep_merge", "replace", "first_found"],
+          "default": "deep_merge",
+          "description": "Default strategy for hash values"
+        },
+        "array": {
+          "type": "string",
+          "enum": ["array_union", "replace", "first_found"],
+          "default": "array_union",
+          "description": "Default strategy for array values"
+        },
+        "scalar": {
+          "type": "string",
+          "enum": ["replace", "first_found"],
+          "default": "replace",
+          "description": "Default strategy for scalar values"
+        }
+      }
+    }
+  }
+}

data/conf/schemas/target_schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/target_schema.json",
+  "title": "NeatNerds Target Profile",
+  "description": "Schema for validating compiler target profiles. Each profile defines how rai compiles source documents for a specific AI assistant target.",
+  "$comment": {
+    "date": "2026-02-21",
+    "version": "1.0.0",
+    "source": "rosett-ai"
+  },
+  "type": "object",
+  "required": ["name", "backend", "output_format"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Unique identifier for the target profile"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable description of the target"
+    },
+    "backend": {
+      "type": "string",
+      "enum": ["acme", "aider", "agents_md", "claude", "copilot", "cursor", "generic", "goose", "gpt_neox", "ollama", "windsurf"],
+      "description": "Compiler backend to use for this target"
+    },
+    "engine_version": {
+      "type": "string",
+      "description": "Semver constraint for engine compatibility"
+    },
+    "output_format": {
+      "type": "string",
+      "enum": ["markdown", "json", "yaml"],
+      "description": "Output format for compiled files"
+    },
+    "output_dir": {
+      "type": ["string", "null"],
+      "description": "Override output directory (null uses default rules_dir)"
+    },
+    "max_context_window": {
+      "type": ["integer", "null"],
+      "minimum": 1,
+      "description": "Maximum context window size in tokens (null for unlimited)"
+    },
+    "rendering": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "include_source_metadata": {
+          "type": "boolean",
+          "description": "Include source file metadata in output"
+        },
+        "include_priority_annotations": {
+          "type": "boolean",
+          "description": "Include priority annotations in rule headings"
+        },
+        "include_generated_marker": {
+          "type": "boolean",
+          "description": "Include generated-by marker comment"
+        }
+      }
+    }
+  }
+}

data/conf/schemas/tooling_schema.json

@@ -0,0 +1,65 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/tooling_schema.json",
+  "title": "NeatNerds Tool Registry Configuration",
+  "description": "Schema for validating the tools.yml registry file used by the NeatNerds Code Companion (rosett-ai) tooling commands.",
+  "$comment": {
+    "date": "2026-02-09",
+    "version": "1.0.0",
+    "source": "rosett-ai",
+    "compatible_claude_code_versions": [">=0.1.0"]
+  },
+  "type": "object",
+  "required": ["tools"],
+  "additionalProperties": false,
+  "properties": {
+    "tools": {
+      "type": "object",
+      "description": "Map of tool names to their configuration",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["description", "permission_pattern", "packages"],
+        "additionalProperties": false,
+        "properties": {
+          "description": {
+            "type": "string",
+            "minLength": 1,
+            "description": "Human-readable description of the tool"
+          },
+          "homepage": {
+            "type": "string",
+            "format": "uri",
+            "description": "URL to the tool's homepage or documentation"
+          },
+          "category": {
+            "type": "string",
+            "enum": ["json", "yaml", "search", "text", "system", "network", "other"],
+            "description": "Category for organizing tools"
+          },
+          "permission_pattern": {
+            "type": "string",
+            "pattern": "^Bash\\([a-z0-9_-]+:\\*\\)$",
+            "description": "Claude Code permission pattern (e.g., 'Bash(jq:*)')"
+          },
+          "packages": {
+            "type": "object",
+            "description": "Map of package manager to package name",
+            "minProperties": 1,
+            "additionalProperties": false,
+            "properties": {
+              "apt": { "type": "string", "minLength": 1 },
+              "dnf": { "type": "string", "minLength": 1 },
+              "pacman": { "type": "string", "minLength": 1 },
+              "zypper": { "type": "string", "minLength": 1 },
+              "brew": { "type": "string", "minLength": 1 },
+              "flatpak": { "type": "string", "minLength": 1 },
+              "snap": { "type": "string", "minLength": 1 },
+              "nix": { "type": "string", "minLength": 1 }
+            }
+          }
+        }
+      }
+    }
+  }
+}