rosett-ai 1.3.3 → 1.5.9

data/conf/schemas/policy_schema.json

@@ -4,7 +4,10 @@
   "title": "rosett-ai Policy Schema",
   "description": "Schema for rai policy configuration files",
   "type": "object",
-  "required": ["policy_version", "tier"],
+  "required": [
+    "policy_version",
+    "tier"
+  ],
   "properties": {
     "policy_version": {
       "type": "integer",
@@ -13,12 +16,20 @@
     },
     "tier": {
       "type": "string",
-      "enum": ["mandatory", "advisory", "informational"],
+      "enum": [
+        "mandatory",
+        "advisory",
+        "informational"
+      ],
       "description": "Policy enforcement tier"
     },
     "scope": {
       "type": "string",
-      "enum": ["org", "team", "project"],
+      "enum": [
+        "org",
+        "team",
+        "project"
+      ],
       "description": "Policy scope in the hierarchy"
     },
     "deny_list": {
@@ -33,7 +44,9 @@
           "description": "Glob patterns for denied file access"
         }
       },
-      "required": ["patterns"]
+      "required": [
+        "patterns"
+      ]
     },
     "protected_files": {
       "type": "object",
@@ -47,7 +60,9 @@
           "description": "File paths that AI may read but not modify"
         }
       },
-      "required": ["paths"]
+      "required": [
+        "paths"
+      ]
     },
     "rate_limiting": {
       "type": "object",
@@ -59,7 +74,10 @@
         },
         "enforcement": {
           "type": "string",
-          "enum": ["advisory", "enforced"],
+          "enum": [
+            "advisory",
+            "enforced"
+          ],
           "default": "advisory",
           "description": "Whether rate limiting is advisory or enforced"
         }
@@ -70,16 +88,24 @@
       "properties": {
         "allowed": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Allowed SPDX license identifiers"
         },
         "rejected": {
           "type": "array",
-          "items": { "type": "string" },
+          "items": {
+            "type": "string"
+          },
           "description": "Rejected SPDX license identifiers"
         }
       }
     }
   },
-  "additionalProperties": false
+  "additionalProperties": false,
+  "$comment": {
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only",
+    "note": null
+  }
 }

data/conf/schemas/provenance_schema.json

@@ -4,7 +4,10 @@
   "title": "rosett-ai AI Provenance",
   "description": "Schema for .ai-provenance.yml files tracking AI involvement in code contributions",
   "type": "object",
-  "required": ["provenance_version", "entries"],
+  "required": [
+    "provenance_version",
+    "entries"
+  ],
   "additionalProperties": false,
   "properties": {
     "provenance_version": {
@@ -22,7 +25,14 @@
   "$defs": {
     "entry": {
       "type": "object",
-      "required": ["commit", "timestamp", "contributor", "ai_tool", "ai_role", "files"],
+      "required": [
+        "commit",
+        "timestamp",
+        "contributor",
+        "ai_tool",
+        "ai_role",
+        "files"
+      ],
       "additionalProperties": false,
       "properties": {
         "commit": {
@@ -47,7 +57,12 @@
         },
         "ai_role": {
           "type": "string",
-          "enum": ["AI-Generated-By", "AI-Co-Author", "AI-Assisted-By", "AI-Reviewed-By"],
+          "enum": [
+            "AI-Generated-By",
+            "AI-Co-Author",
+            "AI-Assisted-By",
+            "AI-Reviewed-By"
+          ],
           "description": "Role the AI played in the contribution"
         },
         "files": {
@@ -60,7 +75,10 @@
     },
     "file_source": {
       "type": "object",
-      "required": ["path", "source_type"],
+      "required": [
+        "path",
+        "source_type"
+      ],
       "additionalProperties": false,
       "properties": {
         "path": {
@@ -75,10 +93,20 @@
         },
         "source_type": {
           "type": "string",
-          "enum": ["library_api", "project_code", "documentation", "pattern", "external_source"],
+          "enum": [
+            "library_api",
+            "project_code",
+            "documentation",
+            "pattern",
+            "external_source"
+          ],
           "description": "Classification of the AI's source material"
         }
       }
     }
+  },
+  "$comment": {
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only",
+    "note": null
   }
 }

data/conf/schemas/rai_config_schema.json

@@ -6,14 +6,18 @@
   "$comment": {
     "date": "2026-02-26",
     "version": "1.0.0",
-    "source": "rosett-ai"
+    "source": "rosett-ai",
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only"
   },
   "type": "object",
   "additionalProperties": false,
   "properties": {
     "default_engine": {
       "type": "string",
-      "enum": ["claude", "generic"],
+      "enum": [
+        "claude",
+        "generic"
+      ],
       "description": "Default engine for compile and adopt commands"
     },
     "cache": {

data/conf/schemas/rai_project_schema.json

@@ -3,7 +3,9 @@
   "title": "rai project configuration",
   "description": "Schema for .rosett-ai/config.yml project marker files",
   "type": "object",
-  "required": ["project_name"],
+  "required": [
+    "project_name"
+  ],
   "properties": {
     "project_name": {
       "type": "string",
@@ -16,5 +18,9 @@
       "description": "Default compilation engine for this project"
     }
   },
-  "additionalProperties": false
+  "additionalProperties": false,
+  "$comment": {
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only",
+    "note": null
+  }
 }

data/conf/schemas/scope_hierarchy_schema.json

@@ -6,7 +6,8 @@
   "$comment": {
     "date": "2026-03-23",
     "version": "0.1.0",
-    "source": "rosett-ai"
+    "source": "rosett-ai",
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only"
   },
   "type": "object",
   "additionalProperties": false,
@@ -16,7 +17,12 @@
       "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"],
+        "enum": [
+          "deep_merge",
+          "replace",
+          "array_union",
+          "first_found"
+        ],
         "description": "Merge strategy for this key"
       }
     },
@@ -27,19 +33,30 @@
       "properties": {
         "hash": {
           "type": "string",
-          "enum": ["deep_merge", "replace", "first_found"],
+          "enum": [
+            "deep_merge",
+            "replace",
+            "first_found"
+          ],
           "default": "deep_merge",
           "description": "Default strategy for hash values"
         },
         "array": {
           "type": "string",
-          "enum": ["array_union", "replace", "first_found"],
+          "enum": [
+            "array_union",
+            "replace",
+            "first_found"
+          ],
           "default": "array_union",
           "description": "Default strategy for array values"
         },
         "scalar": {
           "type": "string",
-          "enum": ["replace", "first_found"],
+          "enum": [
+            "replace",
+            "first_found"
+          ],
           "default": "replace",
           "description": "Default strategy for scalar values"
         }

data/conf/schemas/target_schema.json

@@ -6,10 +6,15 @@
   "$comment": {
     "date": "2026-02-21",
     "version": "1.0.0",
-    "source": "rosett-ai"
+    "source": "rosett-ai",
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only"
   },
   "type": "object",
-  "required": ["name", "backend", "output_format"],
+  "required": [
+    "name",
+    "backend",
+    "output_format"
+  ],
   "additionalProperties": false,
   "properties": {
     "name": {
@@ -24,7 +29,19 @@
     },
     "backend": {
       "type": "string",
-      "enum": ["acme", "aider", "agents_md", "claude", "copilot", "cursor", "generic", "goose", "gpt_neox", "ollama", "windsurf"],
+      "enum": [
+        "acme",
+        "aider",
+        "agents_md",
+        "claude",
+        "copilot",
+        "cursor",
+        "generic",
+        "goose",
+        "gpt_neox",
+        "ollama",
+        "windsurf"
+      ],
       "description": "Compiler backend to use for this target"
     },
     "engine_version": {
@@ -33,15 +50,25 @@
     },
     "output_format": {
       "type": "string",
-      "enum": ["markdown", "json", "yaml"],
+      "enum": [
+        "markdown",
+        "json",
+        "yaml"
+      ],
       "description": "Output format for compiled files"
     },
     "output_dir": {
-      "type": ["string", "null"],
+      "type": [
+        "string",
+        "null"
+      ],
       "description": "Override output directory (null uses default rules_dir)"
     },
     "max_context_window": {
-      "type": ["integer", "null"],
+      "type": [
+        "integer",
+        "null"
+      ],
       "minimum": 1,
       "description": "Maximum context window size in tokens (null for unlimited)"
     },

data/conf/schemas/tooling_schema.json

@@ -7,10 +7,15 @@
     "date": "2026-02-09",
     "version": "1.0.0",
     "source": "rosett-ai",
-    "compatible_claude_code_versions": [">=0.1.0"]
+    "compatible_claude_code_versions": [
+      ">=0.1.0"
+    ],
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only"
   },
   "type": "object",
-  "required": ["tools"],
+  "required": [
+    "tools"
+  ],
   "additionalProperties": false,
   "properties": {
     "tools": {
@@ -19,7 +24,11 @@
       "minProperties": 1,
       "additionalProperties": {
         "type": "object",
-        "required": ["description", "permission_pattern", "packages"],
+        "required": [
+          "description",
+          "permission_pattern",
+          "packages"
+        ],
         "additionalProperties": false,
         "properties": {
           "description": {
@@ -34,7 +43,15 @@
           },
           "category": {
             "type": "string",
-            "enum": ["json", "yaml", "search", "text", "system", "network", "other"],
+            "enum": [
+              "json",
+              "yaml",
+              "search",
+              "text",
+              "system",
+              "network",
+              "other"
+            ],
             "description": "Category for organizing tools"
           },
           "permission_pattern": {
@@ -48,14 +65,38 @@
             "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 }
+              "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
+              }
             }
           }
         }

data/conf/schemas/workflow_schema.json

@@ -6,10 +6,15 @@
   "$comment": {
     "date": "2026-03-16",
     "version": "1.0.0",
-    "source": "rosett-ai"
+    "source": "rosett-ai",
+    "spdx": "SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be> | SPDX-License-Identifier: GPL-3.0-only"
   },
   "type": "object",
-  "required": ["name", "version", "steps"],
+  "required": [
+    "name",
+    "version",
+    "steps"
+  ],
   "additionalProperties": false,
   "properties": {
     "name": {
@@ -31,7 +36,11 @@
     },
     "scope": {
       "type": "string",
-      "enum": ["global", "local", "project"]
+      "enum": [
+        "global",
+        "local",
+        "project"
+      ]
     },
     "network_required": {
       "type": "boolean",
@@ -43,7 +52,9 @@
     },
     "required_capabilities": {
       "type": "array",
-      "items": { "type": "string" }
+      "items": {
+        "type": "string"
+      }
     },
     "max_steps": {
       "type": "integer",
@@ -57,7 +68,10 @@
       "maxItems": 50,
       "items": {
         "type": "object",
-        "required": ["name", "type"],
+        "required": [
+          "name",
+          "type"
+        ],
         "additionalProperties": false,
         "properties": {
           "name": {
@@ -66,13 +80,26 @@
           },
           "type": {
             "type": "string",
-            "enum": ["shell", "rosett-ai", "prompt"]
+            "enum": [
+              "shell",
+              "rosett-ai",
+              "prompt"
+            ]
           },
           "command": {
             "description": "Array of strings for shell steps, string for Rosett-AI steps",
             "oneOf": [
-              { "type": "array", "items": { "type": "string" }, "minItems": 1 },
-              { "type": "string", "minLength": 1 }
+              {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "minItems": 1
+              },
+              {
+                "type": "string",
+                "minLength": 1
+              }
             ]
           },
           "prompt": {
@@ -88,7 +115,10 @@
           },
           "on_failure": {
             "type": "string",
-            "enum": ["stop", "continue"],
+            "enum": [
+              "stop",
+              "continue"
+            ],
             "default": "stop"
           }
         }

data/conf/targets/agents_md.yml

@@ -1,3 +1,4 @@
+# SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be>
 # SPDX-License-Identifier: GPL-3.0-only
 # Copyright (C) 2026 Hugo Antonio Sepulveda Manriquez / NeatNerds
 #

data/conf/targets/claude.yml

@@ -1,4 +1,6 @@
 ---
+# SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be>
+# SPDX-License-Identifier: GPL-3.0-only
 name: claude
 description: Claude Code (Anthropic) target
 backend: claude

data/conf/tooling/tools.yml

@@ -1,3 +1,5 @@
+# SPDX-FileCopyrightText: 2025-2026 Hugo Antonio Sepulveda Manriquez <query@neatnerds.be>
+# SPDX-License-Identifier: GPL-3.0-only
 # Rosett-AI - Tool Registry
 # This file defines CLI tools that can be managed by rai tooling commands.
 # Each tool entry maps to package names across different package managers.

data/lib/rosett_ai/adopter/local_analysis_collector.rb

@@ -9,8 +9,13 @@ module RosettAi
     # without making API calls. Checks for duplicates, missing
     # fields, and other structural issues.
     class LocalAnalysisCollector
+      # @return [Array] Severity levels that cause a check to fail.
       FAIL_SEVERITIES = ['high', 'critical'].freeze
 
+      # Perform analysis on the given files.
+      #
+      # @param files [Object] the files
+      # @return [Hash]
       def analyze(files)
         @findings = []
         @all_rules = {}

data/lib/rosett_ai/adopter/rule_adopter.rb

@@ -9,6 +9,7 @@ require 'json'
 require 'time'
 
 module RosettAi
+  # Rule file analysis and adoption verification.
   module Adopter
     # Analyzes compiled markdown rule files for inconsistencies, conflicts,
     # harmful content, duplicates, and other issues.
@@ -19,6 +20,7 @@ module RosettAi
     # 3. Configurable endpoint — ANTHROPIC_API_BASE_URL for proxy/Bedrock/Vertex
     # 4. Local-only mode — structural checks without API calls
     class RuleAdopter
+      # @return [String] Marker string identifying generated files.
       GENERATED_MARKER = '<!-- rosett-ai-'
 
       attr_reader :rules_dir, :cache_path, :redactions_path, :engine
@@ -44,6 +46,8 @@ module RosettAi
         end
       end
 
+      # Find all rai-managed rule files in the rules directory.
+      # @return [Array<String>]
       def discover_managed_files
         return [] unless rules_dir.exist?
 
@@ -55,11 +59,19 @@ module RosettAi
         end.sort
       end
 
+      # Compute a SHA-256 checksum of the given files.
+      #
+      # @param files [Object] the files
+      # @return [String]
       def content_checksum(files)
         content = files.sort.map { |f| File.read(f) }.join
         Digest::SHA256.hexdigest(content)
       end
 
+      # Retrieve a cached analysis result by checksum.
+      #
+      # @param checksum [Object] the checksum
+      # @return [Hash, nil]
       def cached_result(checksum)
         return nil unless cache_path.exist?
 
@@ -73,6 +85,11 @@ module RosettAi
         nil
       end
 
+      # Persist analysis results to the cache file.
+      #
+      # @param checksum [Object] the checksum
+      # @param result [Object] the result
+      # @return [void]
       def write_cache(checksum, result)
         FileUtils.mkdir_p(cache_path.dirname)
         data = {
@@ -83,12 +100,20 @@ module RosettAi
         File.open(cache_path, 'w', 0o644) { |f| f.write(data.to_yaml) }
       end
 
+      # Build the analysis prompt from file contents.
+      #
+      # @param files [Object] the files
+      # @return [String]
       def build_prompt(files)
         parts = [prompt_header]
         append_file_contents(parts, files)
         parts.join("\n")
       end
 
+      # Apply redaction patterns to content before API submission.
+      #
+      # @param content [Object] the content
+      # @return [String]
       def redact(content)
         patterns = load_redaction_patterns
         result = content.dup
@@ -101,6 +126,10 @@ module RosettAi
         result
       end
 
+      # Perform analysis on the given files.
+      #
+      # @param files [Object] the files
+      # @return [Hash]
       def analyze(files)
         return empty_result if files.empty?
 
@@ -109,11 +138,17 @@ module RosettAi
         executor.analyze(prompt)
       end
 
+      # Perform local-only structural analysis.
+      #
+      # @param files [Object] the files
+      # @return [Hash]
       def analyze_local(files)
         collector = LocalAnalysisCollector.new
         collector.analyze(files)
       end
 
+      # List behaviour files marked as sensitive.
+      # @return [Array<String>]
       def sensitive_files
         behaviour_dir = RosettAi.root.join('conf', 'behaviour')
         return [] unless behaviour_dir.exist?
@@ -126,6 +161,11 @@ module RosettAi
         end
       end
 
+      # Exclude files marked as sensitive from the file list.
+      #
+      # @param files [Object] the files
+      # @param sensitive_sources [Object] the sensitive sources
+      # @return [Array<String>]
       def filter_sensitive(files, sensitive_sources)
         return files if sensitive_sources.empty?