raptor-aios 0.1.0

package/scripts/check-naming.sh

@@ -0,0 +1,138 @@
+#!/usr/bin/env bash
+# check-naming.sh — Validates Raptor naming conventions.
+#
+# Spec Kit ref: E01 — "Convenção de naming aplicada e validada por linter"
+#
+# Rules:
+#   - Command files: rpt.<verb>.md (e.g., rpt.specify.md → templates/commands/specify.md)
+#   - Extension commands: rpt.<ext-id>.<verb>.md
+#   - Feature directories: <prefix>-<short-name> (NNN-name or YYYYMMDD-HHMMSS-name)
+#
+# Usage: ./scripts/check-naming.sh [repo-root]
+#
+# Exit codes:
+#   0 — All checks pass
+#   1 — Naming violations found
+
+set -euo pipefail
+
+REPO_ROOT="${1:-$(git rev-parse --show-toplevel 2>/dev/null || pwd)}"
+ERRORS=0
+
+# ---------------------------------------------------------------------------
+# Color helpers
+# ---------------------------------------------------------------------------
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+NC='\033[0m' # No Color
+
+log_ok()    { echo -e "${GREEN}✓${NC} $1"; }
+log_warn()  { echo -e "${YELLOW}⚠${NC} $1"; }
+log_err()   { echo -e "${RED}✗${NC} $1"; ERRORS=$((ERRORS + 1)); }
+
+# ---------------------------------------------------------------------------
+# Check 1: Command prompt files in templates/commands/
+# ---------------------------------------------------------------------------
+echo "=== Checking command prompt file naming ==="
+
+COMMANDS_DIR="${REPO_ROOT}/templates/commands"
+if [ -d "$COMMANDS_DIR" ]; then
+  for f in "$COMMANDS_DIR"/*.md; do
+    [ -f "$f" ] || continue
+    fname=$(basename "$f")
+    # Valid patterns: specify.md, clarify.md, plan.md, etc.
+    if [[ "$fname" =~ ^[a-z][a-z0-9_-]*\.md$ ]]; then
+      log_ok "Command file: $fname"
+    else
+      log_err "Invalid command file name: $fname (expected lowercase-verb.md)"
+    fi
+  done
+else
+  log_warn "No templates/commands/ directory found"
+fi
+
+# ---------------------------------------------------------------------------
+# Check 2: Extension command files
+# ---------------------------------------------------------------------------
+echo ""
+echo "=== Checking extension command file naming ==="
+
+EXTENSIONS_DIR="${REPO_ROOT}/extensions"
+if [ -d "$EXTENSIONS_DIR" ]; then
+  for ext_dir in "$EXTENSIONS_DIR"/*/; do
+    [ -d "$ext_dir" ] || continue
+    ext_id=$(basename "$ext_dir")
+    cmd_dir="${ext_dir}commands"
+    if [ -d "$cmd_dir" ]; then
+      for f in "$cmd_dir"/*.md; do
+        [ -f "$f" ] || continue
+        fname=$(basename "$f")
+        # Valid pattern: rpt.<ext-id>.<verb>.md
+        if [[ "$fname" =~ ^rpt\."$ext_id"\.[a-z][a-z0-9_-]*\.md$ ]]; then
+          log_ok "Extension command: $fname"
+        else
+          log_err "Invalid extension command name: $fname (expected rpt.${ext_id}.<verb>.md)"
+        fi
+      done
+    fi
+  done
+else
+  log_warn "No extensions/ directory found"
+fi
+
+# ---------------------------------------------------------------------------
+# Check 3: Feature directory naming in specs/
+# ---------------------------------------------------------------------------
+echo ""
+echo "=== Checking feature directory naming ==="
+
+SPECS_DIR="${REPO_ROOT}/specs"
+if [ -d "$SPECS_DIR" ]; then
+  for feat_dir in "$SPECS_DIR"/*/; do
+    [ -d "$feat_dir" ] || continue
+    dirname=$(basename "$feat_dir")
+    # Valid patterns:
+    #   Sequential: NNN-short-name (e.g., 001-user-auth, 0042-payment)
+    #   Timestamp: YYYYMMDD-HHMMSS-short-name
+    if [[ "$dirname" =~ ^[0-9]+-[a-z][a-z0-9-]*$ ]]; then
+      log_ok "Feature dir (sequential): $dirname"
+    elif [[ "$dirname" =~ ^[0-9]{8}-[0-9]{6}-[a-z][a-z0-9-]*$ ]]; then
+      log_ok "Feature dir (timestamp): $dirname"
+    else
+      log_err "Invalid feature directory name: $dirname (expected NNN-name or YYYYMMDD-HHMMSS-name)"
+    fi
+  done
+else
+  log_warn "No specs/ directory found"
+fi
+
+# ---------------------------------------------------------------------------
+# Check 4: Extension ID naming
+# ---------------------------------------------------------------------------
+echo ""
+echo "=== Checking extension ID naming ==="
+
+if [ -d "$EXTENSIONS_DIR" ]; then
+  for ext_dir in "$EXTENSIONS_DIR"/*/; do
+    [ -d "$ext_dir" ] || continue
+    ext_id=$(basename "$ext_dir")
+    if [[ "$ext_id" =~ ^[a-z][a-z0-9-]*$ ]]; then
+      log_ok "Extension ID: $ext_id"
+    else
+      log_err "Invalid extension ID: $ext_id (expected lowercase-kebab-case)"
+    fi
+  done
+fi
+
+# ---------------------------------------------------------------------------
+# Summary
+# ---------------------------------------------------------------------------
+echo ""
+if [ "$ERRORS" -eq 0 ]; then
+  echo -e "${GREEN}All naming checks passed.${NC}"
+  exit 0
+else
+  echo -e "${RED}${ERRORS} naming violation(s) found.${NC}"
+  exit 1
+fi

package/scripts/check-prompts.sh

@@ -0,0 +1,165 @@
+#!/usr/bin/env bash
+# check-prompts.sh — Lint script for Raptor prompt templates.
+#
+# Validates that all prompt files in templates/commands/ follow the
+# canonical structure (frontmatter, version marker, phases, hook check).
+#
+# Spec Kit ref: E05 — "Lint de prompts (CI script)"
+#
+# Usage: ./scripts/check-prompts.sh
+# Exit code: 0 = all pass, 1 = lint errors found
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROMPTS_DIR="$REPO_ROOT/templates/commands"
+EXT_COMMANDS_DIR="$REPO_ROOT/extensions"
+
+ERRORS=0
+WARNINGS=0
+CHECKED=0
+
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+error() {
+  echo -e "  ${RED}✗${NC} $1: $2"
+  ERRORS=$((ERRORS + 1))
+}
+
+warn() {
+  echo -e "  ${YELLOW}⚠${NC} $1: $2"
+  WARNINGS=$((WARNINGS + 1))
+}
+
+pass() {
+  echo -e "  ${GREEN}✓${NC} $1"
+}
+
+lint_prompt() {
+  local file="$1"
+  local basename
+  basename="$(basename "$file")"
+  local had_error=false
+
+  # 1. Must start with YAML frontmatter
+  local first_line
+  first_line="$(head -1 "$file")"
+  if [[ "$first_line" != "---" ]]; then
+    error "$basename" "Missing YAML frontmatter (must start with ---)"
+    had_error=true
+  fi
+
+  # 2. Must have frontmatter end marker
+  local fm_end
+  fm_end="$(awk 'NR>1 && /^---$/{print NR; exit}' "$file")"
+  if [[ -z "$fm_end" ]]; then
+    error "$basename" "Missing frontmatter end marker (---)"
+    had_error=true
+  fi
+
+  # 3. Must have description in frontmatter
+  if ! grep -q "^description:" "$file"; then
+    error "$basename" "Missing 'description:' in frontmatter"
+    had_error=true
+  fi
+
+  # 4. Must have prompt-version marker
+  if ! grep -q "<!-- prompt-version:" "$file"; then
+    warn "$basename" "Missing <!-- prompt-version: X.X.X --> marker"
+  fi
+
+  # 5. Must have ## Outline section
+  if ! grep -q "^## Outline" "$file"; then
+    warn "$basename" "Missing '## Outline' section"
+  fi
+
+  # 6. Must have ## Phases section or at least ### Phase
+  if ! grep -q "^## Phases\|^### Phase" "$file"; then
+    warn "$basename" "Missing Phases section"
+  fi
+
+  # 7. Check for hook blocks (pre/post execution checks)
+  if ! grep -q "Pre-Execution Check\|Final Hook Check" "$file"; then
+    warn "$basename" "Missing hook check blocks (Pre-Execution / Final Hook Check)"
+  fi
+
+  # 8. Check for $ARGUMENTS placeholder
+  if ! grep -q '\$ARGUMENTS' "$file"; then
+    warn "$basename" "No \$ARGUMENTS placeholder found"
+  fi
+
+  # 9. Check for rpt. prefix in heading
+  local heading
+  heading="$(grep "^# /rpt\." "$file" | head -1)"
+  if [[ -z "$heading" ]]; then
+    # Extension commands use rpt.*.* format
+    heading="$(grep "^# /rpt\." "$file" | head -1)"
+    if [[ -z "$heading" ]]; then
+      warn "$basename" "Missing canonical heading (# /rpt.<name>)"
+    fi
+  fi
+
+  if [[ "$had_error" == false ]]; then
+    pass "$basename"
+  fi
+
+  CHECKED=$((CHECKED + 1))
+}
+
+echo "=== Linting prompt templates ==="
+echo ""
+
+# Lint core prompts
+echo "--- Core prompts (templates/commands/) ---"
+if [[ -d "$PROMPTS_DIR" ]]; then
+  for f in "$PROMPTS_DIR"/*.md; do
+    [[ -f "$f" ]] || continue
+    lint_prompt "$f"
+  done
+else
+  error "templates/commands/" "Directory not found"
+fi
+
+echo ""
+
+# Lint extension prompts
+echo "--- Extension prompts ---"
+found_ext=false
+for ext_dir in "$EXT_COMMANDS_DIR"/*/; do
+  [[ -d "$ext_dir" ]] || continue
+  cmd_dir="${ext_dir}commands/"
+  [[ -d "$cmd_dir" ]] || continue
+  for f in "$cmd_dir"*.md; do
+    [[ -f "$f" ]] || continue
+    lint_prompt "$f"
+    found_ext=true
+  done
+done
+
+if [[ "$found_ext" == false ]]; then
+  echo "  (no extension prompts found)"
+fi
+
+echo ""
+echo "=== Summary ==="
+echo "  Checked: $CHECKED"
+echo "  Errors:  $ERRORS"
+echo "  Warnings: $WARNINGS"
+echo ""
+
+if [[ "$ERRORS" -gt 0 ]]; then
+  echo -e "${RED}Prompt lint FAILED${NC} — $ERRORS error(s) found."
+  exit 1
+else
+  if [[ "$WARNINGS" -gt 0 ]]; then
+    echo -e "${YELLOW}Prompt lint PASSED with warnings${NC} — $WARNINGS warning(s)."
+  else
+    echo -e "${GREEN}Prompt lint PASSED${NC} — all checks clean."
+  fi
+  exit 0
+fi

package/scripts/check-tasks.sh

@@ -0,0 +1,166 @@
+#!/usr/bin/env bash
+# check-tasks.sh — Lint script for tasks.md files.
+#
+# Validates that tasks files follow the strict checklist format:
+#   - Sequential task IDs (T001, T002, ...)
+#   - Proper status markers: [ ], [/], [x], [!]
+#   - File(s) and Acceptance fields present
+#   - Summary table present
+#
+# Spec Kit ref: E10 — "Linter de tasks.md"
+#
+# Usage: ./scripts/check-tasks.sh [path/to/tasks.md]
+#        ./scripts/check-tasks.sh  (scans all specs/*/tasks.md)
+# Exit code: 0 = all pass, 1 = lint errors found
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+ERRORS=0
+WARNINGS=0
+CHECKED=0
+
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m'
+
+error() {
+  echo -e "  ${RED}✗${NC} $1: $2"
+  ERRORS=$((ERRORS + 1))
+}
+
+warn() {
+  echo -e "  ${YELLOW}⚠${NC} $1: $2"
+  WARNINGS=$((WARNINGS + 1))
+}
+
+pass() {
+  echo -e "  ${GREEN}✓${NC} $1"
+}
+
+lint_tasks() {
+  local file="$1"
+  local basename
+  basename="$(basename "$(dirname "$file")")/tasks.md"
+  local had_error=false
+
+  # 1. Check for heading
+  if ! grep -q "^# Tasks" "$file"; then
+    error "$basename" "Missing '# Tasks' heading"
+    had_error=true
+  fi
+
+  # 2. Check for task IDs (T001, T002, etc.)
+  local task_count=0
+  task_count=$(grep -cE '\*\*T[0-9]{3}\*\*' "$file" 2>/dev/null) || task_count=0
+  if [[ "$task_count" -eq 0 ]]; then
+    warn "$basename" "No task IDs found (expected **T001**, **T002**, ...)"
+  fi
+
+  # 3. Check for status markers
+  local status_count=0
+  status_count=$(grep -cE '^\s*- \[([ /x!])\]' "$file" 2>/dev/null) || status_count=0
+  if [[ "$status_count" -eq 0 ]]; then
+    warn "$basename" "No status markers found (expected - [ ], - [x], etc.)"
+  fi
+
+  # 4. Check for sequential numbering
+  local prev_num=0
+  local sequential=true
+  while IFS= read -r line; do
+    local num
+    num=$(echo "$line" | grep -oE 'T([0-9]+)' | head -1 | sed 's/T//')
+    if [[ -n "$num" ]]; then
+      num=$((10#$num))
+      if [[ "$num" -ne $((prev_num + 1)) ]] && [[ "$prev_num" -gt 0 ]]; then
+        sequential=false
+      fi
+      prev_num=$num
+    fi
+  done < <(grep -E '\*\*T[0-9]+\*\*' "$file" 2>/dev/null || true)
+
+  if [[ "$sequential" == false ]]; then
+    warn "$basename" "Task IDs are not strictly sequential"
+  fi
+
+  # 5. Check for File(s) field
+  local file_field_count=0
+  file_field_count=$(grep -cE '^\s+-\s+File\(s\):' "$file" 2>/dev/null) || file_field_count=0
+  if [[ "$file_field_count" -eq 0 ]] && [[ "$task_count" -gt 0 ]]; then
+    warn "$basename" "No 'File(s):' fields found in tasks"
+  fi
+
+  # 6. Check for Acceptance field
+  local acceptance_count=0
+  acceptance_count=$(grep -cE '^\s+-\s+Acceptance:' "$file" 2>/dev/null) || acceptance_count=0
+  if [[ "$acceptance_count" -eq 0 ]] && [[ "$task_count" -gt 0 ]]; then
+    warn "$basename" "No 'Acceptance:' fields found in tasks"
+  fi
+
+  # 7. Check for Summary table
+  if ! grep -q "^## Summary\|^| Status" "$file"; then
+    warn "$basename" "Missing Summary table"
+  fi
+
+  # 8. Check for Group headings
+  local group_count=0
+  group_count=$(grep -cE '^### Group' "$file" 2>/dev/null) || group_count=0
+  if [[ "$group_count" -eq 0 ]] && [[ "$task_count" -gt 3 ]]; then
+    warn "$basename" "No '### Group' headings (recommended for >3 tasks)"
+  fi
+
+  if [[ "$had_error" == false ]]; then
+    pass "$basename ($task_count tasks, $status_count markers)"
+  fi
+
+  CHECKED=$((CHECKED + 1))
+}
+
+echo "=== Linting tasks.md files ==="
+echo ""
+
+if [[ $# -gt 0 ]]; then
+  # Lint specific file
+  for f in "$@"; do
+    if [[ -f "$f" ]]; then
+      lint_tasks "$f"
+    else
+      error "$f" "File not found"
+    fi
+  done
+else
+  # Scan all specs/*/tasks.md
+  found=false
+  for f in "$REPO_ROOT"/specs/*/tasks.md; do
+    [[ -f "$f" ]] || continue
+    lint_tasks "$f"
+    found=true
+  done
+
+  if [[ "$found" == false ]]; then
+    echo "  (no tasks.md files found in specs/)"
+  fi
+fi
+
+echo ""
+echo "=== Summary ==="
+echo "  Checked: $CHECKED"
+echo "  Errors:  $ERRORS"
+echo "  Warnings: $WARNINGS"
+echo ""
+
+if [[ "$ERRORS" -gt 0 ]]; then
+  echo -e "${RED}Tasks lint FAILED${NC} — $ERRORS error(s) found."
+  exit 1
+else
+  if [[ "$WARNINGS" -gt 0 ]]; then
+    echo -e "${YELLOW}Tasks lint PASSED with warnings${NC} — $WARNINGS warning(s)."
+  else
+    echo -e "${GREEN}Tasks lint PASSED${NC} — all checks clean."
+  fi
+  exit 0
+fi

package/scripts/powershell/check-prerequisites.ps1

@@ -0,0 +1,117 @@
+# check-prerequisites.ps1 — Validate feature artifacts exist (PowerShell parity port).
+#
+# Spec Kit ref: E04
+#
+# Args:
+#   -Json               Output JSON to stdout
+#   -RequireTasks       Fail if tasks.md is missing
+#   -IncludeTasks       Include tasks.md content (reserved for downstream)
+#   -PathsOnly          Only output file paths, not content
+#
+# Output JSON (-Json):
+#   { "FEATURE_DIR": "...", "AVAILABLE_DOCS": "...",
+#     "HAS_SPEC": "...", "HAS_PLAN": "...", "HAS_TASKS": "...",
+#     "HAS_RESEARCH": "...", "HAS_DATA_MODEL": "...",
+#     "HAS_CONTRACTS": "...", "HAS_QUICKSTART": "...",
+#     "HAS_CHECKLIST": "..." }
+
+[CmdletBinding()]
+param(
+  [switch]$Json,
+  [switch]$RequireTasks,
+  [switch]$IncludeTasks,
+  [switch]$PathsOnly
+)
+
+$ErrorActionPreference = 'Stop'
+
+. (Join-Path $PSScriptRoot 'common.ps1')
+
+# ---------------------------------------------------------------------------
+# Resolve feature
+# ---------------------------------------------------------------------------
+try {
+  $paths = Get-FeaturePaths
+} catch {
+  Stop-WithError -Message "Cannot resolve feature paths" -Code 1
+}
+
+$featureDir  = $paths.FEATURE_DIR
+$featureName = $paths.FEATURE_NAME
+
+# ---------------------------------------------------------------------------
+# Check each artifact
+# ---------------------------------------------------------------------------
+$availableDocs = @()
+
+function Test-Doc {
+  param([string]$Name)
+  $path = Join-Path $featureDir $Name
+  if (Test-Path $path) {
+    $script:availableDocs += $Name
+    return "true"
+  }
+  return "false"
+}
+
+$hasSpec      = Test-Doc 'spec.md'
+$hasPlan      = Test-Doc 'plan.md'
+$hasTasks     = Test-Doc 'tasks.md'
+$hasResearch  = Test-Doc 'research.md'
+$hasDataModel = Test-Doc 'data-model.md'
+$hasQuickstart= Test-Doc 'quickstart.md'
+
+# Checklists directory
+$hasChecklist = "false"
+$checklistsDir = Join-Path $featureDir 'checklists'
+if (Test-Path $checklistsDir) {
+  Get-ChildItem -Path $checklistsDir -Filter '*.md' -File -ErrorAction SilentlyContinue | ForEach-Object {
+    $hasChecklist = "true"
+    $availableDocs += "checklists/$($_.Name)"
+  }
+}
+
+# Contracts directory
+$hasContracts = "false"
+$contractsDir = Join-Path $featureDir 'contracts'
+if (Test-Path $contractsDir) {
+  Get-ChildItem -Path $contractsDir -File -ErrorAction SilentlyContinue | ForEach-Object {
+    $hasContracts = "true"
+    $availableDocs += "contracts/$($_.Name)"
+  }
+}
+
+# ---------------------------------------------------------------------------
+# Validate required
+# ---------------------------------------------------------------------------
+if ($hasSpec -eq 'false') {
+  Stop-WithError -Message "spec.md not found in $featureDir. Run /rpt.specify first." -Code 1
+}
+
+if ($RequireTasks -and $hasTasks -eq 'false') {
+  Stop-WithError -Message "tasks.md not found in $featureDir. Run /rpt.tasks first." -Code 1
+}
+
+# ---------------------------------------------------------------------------
+# Output
+# ---------------------------------------------------------------------------
+if ($Json) {
+  $payload = [ordered]@{
+    FEATURE_DIR    = $featureDir
+    FEATURE_NAME   = $featureName
+    AVAILABLE_DOCS = ($availableDocs -join ',')
+    HAS_SPEC       = $hasSpec
+    HAS_PLAN       = $hasPlan
+    HAS_TASKS      = $hasTasks
+    HAS_RESEARCH   = $hasResearch
+    HAS_DATA_MODEL = $hasDataModel
+    HAS_CONTRACTS  = $hasContracts
+    HAS_QUICKSTART = $hasQuickstart
+    HAS_CHECKLIST  = $hasChecklist
+  }
+  Write-Output (ConvertTo-RaptorJson -Data $payload)
+} else {
+  Write-Output "Feature: $featureDir"
+  Write-Output "Available docs: $($availableDocs -join ',')"
+  Write-Output "Spec: $hasSpec | Plan: $hasPlan | Tasks: $hasTasks"
+}