rosett-ai 1.3.3

data/conf/schemas/ai_config_schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://neatnerds.be/rosett-ai/schemas/ai_config.json",
+  "title": "rosett-ai AI Tool Configuration",
+  "description": "Schema for .rosett-ai/conf/ai_config.yml defining engine-agnostic AI tool settings",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "model_routing": {
+      "type": "object",
+      "description": "Maps task types to canonical model tiers",
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^(economy|standard|premium|custom:.+)$"
+      }
+    },
+    "context_window": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_tokens": {
+          "type": "integer",
+          "minimum": 1024,
+          "description": "Maximum context window size in tokens"
+        },
+        "output_reserve": {
+          "type": "integer",
+          "minimum": 256,
+          "description": "Tokens reserved for output generation"
+        },
+        "truncation_strategy": {
+          "type": "string",
+          "enum": ["tail", "head", "middle"],
+          "description": "How to truncate input when exceeding context window"
+        }
+      }
+    },
+    "cost_controls": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "preferred_tier": {
+          "type": "string",
+          "enum": ["economy", "standard", "premium"],
+          "description": "Default cost tier preference (advisory only)"
+        },
+        "monthly_budget_note": {
+          "type": "string",
+          "description": "Advisory budget note for team awareness"
+        }
+      }
+    },
+    "fallback_chain": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "engines": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": "Ordered list of engines to try"
+        }
+      }
+    },
+    "operational": {
+      "type": "object",
+      "description": "Engine-specific operational parameters (temperature, top_p, etc.)",
+      "additionalProperties": true
+    }
+  }
+}

data/conf/schemas/behaviour_schema.json

@@ -0,0 +1,132 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/behaviour_schema.json",
+  "title": "NeatNerds Behaviour Configuration",
+  "description": "Schema for validating behaviour configuration files used by the NeatNerds Code Companion (rosett-ai). Behaviour files define operational rules for Claude Code workflows.",
+  "$comment": {
+    "date": "2026-04-17",
+    "version": "1.3.0",
+    "source": "rosett-ai",
+    "compatible_claude_code_versions": [">=0.1.0"]
+  },
+  "type": "object",
+  "required": ["name", "description", "rules"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "description": "Unique identifier for the behaviour"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable explanation of the behaviour"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (e.g. 1.0.0)"
+    },
+    "author": {
+      "type": "string",
+      "description": "Creator of the behaviour file"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date",
+      "description": "Creation date in ISO 8601 format (YYYY-MM-DD)"
+    },
+    "modified_at": {
+      "type": "string",
+      "format": "date",
+      "description": "Last modification date in ISO 8601 format (YYYY-MM-DD)"
+    },
+    "modified_by": {
+      "type": "string",
+      "description": "Last person to modify the behaviour file"
+    },
+    "scope": {
+      "type": "string",
+      "enum": ["global", "project", "personal"],
+      "description": "Compilation scope: global (to ~/.claude/rules/), project (to .claude/rules/), personal (to ~/.claude/rules/, not shared). Defaults to global when omitted."
+    },
+    "sensitive": {
+      "type": "boolean",
+      "description": "When true, this behaviour is excluded from API analysis during adopt"
+    },
+    "used_in": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "description": "List of projects using this behaviour"
+    },
+    "rules": {
+      "type": "array",
+      "minItems": 1,
+      "description": "Operational rules for Claude Code (at least one required)",
+      "items": {
+        "type": "object",
+        "required": ["id", "description"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Unique rule identifier"
+          },
+          "description": {
+            "type": "string",
+            "description": "What this rule instructs Claude Code to do"
+          },
+          "priority": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 100,
+            "description": "Rule priority: 1-29 minimal, 30-49 low, 50-69 medium, 70-89 high, 90-100 critical"
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Whether this rule is active"
+          },
+          "enforcement": {
+            "type": "object",
+            "description": "Optional enforcement block. When present, enables hook generation for this rule. Requires valid pattern and applies_to for enforceable type.",
+            "properties": {
+              "type": {
+                "type": "string",
+                "enum": ["enforceable", "advisory", "informational"],
+                "description": "Enforcement tier: enforceable (hook-generatable), advisory (guidance only), informational (context only)"
+              },
+              "pattern": {
+                "type": "string",
+                "minLength": 1,
+                "description": "Regex pattern to match against tool input. Must not be degenerate (e.g. .*, .+, empty)"
+              },
+              "applies_to": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "minItems": 1,
+                "description": "Tool names this rule applies to (e.g. Bash, Write, Edit)"
+              },
+              "action": {
+                "type": "string",
+                "enum": ["block", "warn", "log"],
+                "description": "Enforcement action: block (reject tool call), warn (stderr warning), log (silent log)"
+              },
+              "message": {
+                "type": "string",
+                "description": "Human-readable message shown when the rule triggers"
+              }
+            },
+            "required": ["type"],
+            "additionalProperties": false
+          }
+        }
+      }
+    }
+  }
+}

data/conf/schemas/compliance_rule_schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/compliance_rule_schema.json",
+  "title": "Compliance Rule",
+  "description": "Schema for conf/compliance/*.yml — declarative compliance check rules.",
+  "$comment": {
+    "date": "2026-03-16",
+    "version": "1.0.0",
+    "source": "rosett-ai"
+  },
+  "type": "object",
+  "required": ["name", "version", "rules"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Compliance rule set name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Rule set version"
+    },
+    "description": {
+      "type": "string",
+      "description": "Human-readable description of the rule set"
+    },
+    "rules": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "description", "severity"],
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Z]+-\\d+$",
+            "description": "Unique rule identifier (e.g., CRA-001)"
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable rule description"
+          },
+          "severity": {
+            "type": "string",
+            "enum": ["error", "warning", "info"],
+            "description": "Severity level"
+          },
+          "check": {
+            "type": "string",
+            "description": "Check type identifier"
+          },
+          "remediation": {
+            "type": "string",
+            "description": "How to fix when this rule fails"
+          }
+        }
+      }
+    }
+  }
+}

data/conf/schemas/content_pack_manifest_schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "NeatNerds Content Pack Manifest",
+  "description": "Schema for premium content pack manifest files",
+  "type": "object",
+  "required": ["name", "version", "tier_required", "description", "author", "contents"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Pack identifier (lowercase, underscores)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version string"
+    },
+    "tier_required": {
+      "type": "string",
+      "enum": ["supporter", "subscriber", "enterprise"],
+      "description": "Minimum tier required to access this pack"
+    },
+    "description": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable pack description"
+    },
+    "author": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Pack author"
+    },
+    "contents": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "behaviours": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of behaviour YAML filenames"
+        },
+        "designs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "List of design YAML filenames"
+        }
+      }
+    }
+  }
+}

data/conf/schemas/design_schema.json

@@ -0,0 +1,210 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/design_schema.json",
+  "title": "NeatNerds Design Document",
+  "description": "Schema for validating design documents used by the NeatNerds Code Companion (rosett-ai). Design documents define application intent, constraints, and requirements for AI-assisted development.",
+  "$comment": {
+    "date": "2026-02-22",
+    "version": "1.2.0",
+    "source": "rosett-ai",
+    "compatible_claude_code_versions": [">=0.1.0"]
+  },
+  "type": "object",
+  "required": ["name", "domain", "version", "status", "intent", "constraints", "acceptance_criteria"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 100,
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Unique identifier for the design document (snake_case)"
+    },
+    "domain": {
+      "type": "string",
+      "enum": ["core", "ui", "security", "testing", "styles", "i18n", "accessibility", "licensing", "ci", "compiler", "release", "documentation", "operations", "forge"],
+      "description": "Domain category grouping related specs"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version (e.g. 1.0.0)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "approved", "implemented"],
+      "description": "Draft allows AI deviation; approved means follow strictly; implemented means code exists"
+    },
+    "priority": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 6,
+      "description": "Implementation priority: 1=foundation, 2=structure, 3=interface, 4=business, 5=delivery, 6=operations"
+    },
+    "author": {
+      "type": "string",
+      "description": "Creator of the design document"
+    },
+    "created_at": {
+      "type": "string",
+      "format": "date",
+      "description": "Creation date in ISO 8601 format (YYYY-MM-DD)"
+    },
+    "modified_at": {
+      "type": "string",
+      "format": "date",
+      "description": "Last modification date in ISO 8601 format (YYYY-MM-DD)"
+    },
+    "modified_by": {
+      "type": "string",
+      "description": "Last person to modify the design document"
+    },
+    "depends_on": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "List of design document names this document depends on"
+    },
+    "intent": {
+      "type": "string",
+      "minLength": 10,
+      "description": "Why this exists, what problem it solves, who benefits. Most valuable section for AI decision-making."
+    },
+    "constraints": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" },
+      "description": "Hard boundaries that must not be crossed"
+    },
+    "acceptance_criteria": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" },
+      "description": "Testable statements defining done"
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["scenario", "expected"],
+        "properties": {
+          "scenario": { "type": "string", "description": "Description of the situation" },
+          "expected": { "type": "string", "description": "What should happen" },
+          "not": { "type": "string", "description": "What should NOT happen" }
+        }
+      },
+      "description": "Concrete examples of expected behaviour"
+    },
+    "anti_patterns": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "What NOT to do — common wrong approaches to avoid"
+    },
+    "preferences": {
+      "type": "object",
+      "properties": {
+        "language": { "type": "string" },
+        "patterns": { "type": "array", "items": { "type": "string" } },
+        "testing": { "type": "string" },
+        "gems": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true,
+      "description": "Technical preferences (only when it matters)"
+    },
+    "assets": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["path", "type", "description"],
+        "properties": {
+          "path": { "type": "string", "description": "Relative path to asset file" },
+          "type": { "type": "string", "enum": ["mockup", "reference", "diagram"] },
+          "description": { "type": "string" }
+        }
+      },
+      "description": "Visual assets (images) AI can process directly"
+    },
+    "tui_layout": {
+      "type": "string",
+      "description": "ASCII art TUI layout (versionable, diffable)"
+    },
+    "implementation_notes": {
+      "type": "string",
+      "description": "Post-implementation notes documenting how the design was realised, including intentional divergences from the original design"
+    },
+    "gui_notes": {
+      "type": "string",
+      "description": "Platform-specific GUI implementation notes"
+    },
+    "interactions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["action"],
+        "properties": {
+          "action": { "type": "string" },
+          "tui": { "type": "string" },
+          "gtk4": { "type": "string" },
+          "qt6": { "type": "string" }
+        }
+      },
+      "description": "Cross-platform interaction definitions"
+    },
+    "accessibility": {
+      "type": "object",
+      "properties": {
+        "roles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["element", "role", "label"],
+            "properties": {
+              "element": { "type": "string" },
+              "role": { "type": "string" },
+              "label": { "type": "string" },
+              "description": { "type": "string" }
+            }
+          }
+        },
+        "keyboard": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["key", "action"],
+            "properties": {
+              "key": { "type": "string" },
+              "action": { "type": "string" }
+            }
+          }
+        },
+        "focus_order": { "type": "array", "items": { "type": "string" } },
+        "announcements": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["event", "announce"],
+            "properties": {
+              "event": { "type": "string" },
+              "announce": { "type": "string" },
+              "priority": { "type": "string", "enum": ["polite", "assertive"] }
+            }
+          }
+        },
+        "target_sizes": {
+          "type": "object",
+          "properties": {
+            "minimum": { "type": "string" },
+            "recommended": { "type": "string" }
+          }
+        },
+        "timing": {
+          "type": "object",
+          "properties": {
+            "no_time_limits": { "type": "boolean" },
+            "animations_respect_prefers_reduced_motion": { "type": "boolean" }
+          }
+        }
+      },
+      "description": "Accessibility requirements for UI components"
+    }
+  }
+}

data/conf/schemas/engine_manifest_schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://gitlab.neatnerds.be/neatnerds/NeatNerds-AI/rosett-ai/schemas/engine_manifest_schema.json",
+  "title": "Engine Manifest",
+  "description": "Schema for conf/engines/<name>/manifest.yml — engine capability declarations.",
+  "$comment": {
+    "date": "2026-02-26",
+    "version": "1.2.0",
+    "source": "rosett-ai"
+  },
+  "type": "object",
+  "required": ["name", "display_name", "version", "components", "capabilities"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Machine-readable engine identifier"
+    },
+    "display_name": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Human-readable engine name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the engine manifest"
+    },
+    "components": {
+      "type": "object",
+      "required": ["backend"],
+      "additionalProperties": false,
+      "properties": {
+        "backend": {
+          "type": "boolean",
+          "description": "Whether the engine provides a compilation backend"
+        },
+        "config_compiler": {
+          "type": "boolean",
+          "description": "Whether the engine compiles settings files"
+        },
+        "executor": {
+          "type": "boolean",
+          "description": "Whether the engine provides an API executor for adopt"
+        },
+        "detector": {
+          "type": "boolean",
+          "description": "Whether the engine provides an autodetector"
+        },
+        "scaffolder": {
+          "type": "boolean",
+          "description": "Whether the engine provides project scaffolding"
+        }
+      }
+    },
+    "detection": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "cli_binary": {
+          "type": "string",
+          "description": "Binary name to search in PATH"
+        },
+        "config_dir": {
+          "type": "string",
+          "description": "Configuration directory to check for existence"
+        },
+        "env_var": {
+          "type": "string",
+          "description": "Environment variable indicating engine configuration"
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "api_gem": {
+          "type": "string",
+          "description": "Ruby gem name providing the API client"
+        },
+        "model": {
+          "type": "string",
+          "description": "Default model identifier"
+        },
+        "api_type": {
+          "type": "string",
+          "enum": ["cli", "http", "grpc", "sdk", "openai_compatible"],
+          "description": "Type of API interface used by the engine"
+        },
+        "default_endpoint": {
+          "type": "string",
+          "format": "uri",
+          "description": "Default HTTP endpoint for the engine API"
+        },
+        "default_model": {
+          "type": "string",
+          "description": "Default model name for inference requests"
+        },
+        "cli_binary": {
+          "type": "string",
+          "description": "CLI binary name for subprocess-based executors"
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "required": ["compile"],
+      "additionalProperties": false,
+      "properties": {
+        "compile": {
+          "type": "boolean",
+          "description": "Can compile behaviour YAML to engine-native format"
+        },
+        "config": {
+          "type": "boolean",
+          "description": "Can compile settings/configuration files"
+        },
+        "adopt_api": {
+          "type": "boolean",
+          "description": "Can perform remote adopt analysis via API"
+        },
+        "settings_json": {
+          "type": "boolean",
+          "description": "Supports settings.json configuration files"
+        },
+        "local_only": {
+          "type": "boolean",
+          "description": "Engine only supports local inference (no cloud API)"
+        },
+        "sensitive_filtering": {
+          "type": "boolean",
+          "description": "Supports filtering sensitive content during compilation"
+        },
+        "rule_metadata": {
+          "type": "boolean",
+          "description": "Supports rule metadata (IDs, priority) in compiled output"
+        }
+      }
+    }
+  }
+}