raptor-aios 0.1.0

package/dist/workflow/executor.js

@@ -0,0 +1,112 @@
+/**
+ * CLI command executor for the workflow engine.
+ *
+ * Converts a workflow `command:` step into a real invocation of the matching
+ * Oclif command class, in-process, with full error capture. This is what
+ * turns `raptor workflow run sdd-cycle` from a DAG declaration into a real
+ * orchestrator of the SDD pipeline.
+ *
+ * Blueprint ref: 05 §5 — "Modelo de execução".
+ */
+import { buildArgvForCommand } from "./args-builder.js";
+/**
+ * Workflow `command:` step executor. Dispatches to the correct CLI command
+ * class by dynamic import, keyed on the `raptor.<name>` identifier.
+ */
+export const cliCommandExecutor = async (command, input, ctx) => {
+    const started = Date.now();
+    let argv;
+    try {
+        argv = buildArgvForCommand(command, input, ctx);
+    }
+    catch (err) {
+        return {
+            command,
+            status: "failed",
+            exitCode: 1,
+            argv: [],
+            durationMs: Date.now() - started,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    let CommandClass;
+    try {
+        CommandClass = await loadCommandClass(command);
+    }
+    catch (err) {
+        return {
+            command,
+            status: "failed",
+            exitCode: 1,
+            argv,
+            durationMs: Date.now() - started,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    try {
+        await CommandClass.run(argv);
+        return {
+            command,
+            status: "success",
+            exitCode: 0,
+            argv,
+            feature: ctx.feature,
+            durationMs: Date.now() - started,
+        };
+    }
+    catch (err) {
+        const e = err;
+        return {
+            command,
+            status: "failed",
+            exitCode: typeof e.oclif?.exit === "number" ? e.oclif.exit : 1,
+            argv,
+            durationMs: Date.now() - started,
+            error: e.message ?? String(err),
+        };
+    }
+};
+/**
+ * Dynamic import of the Oclif Command class for `raptor.<name>`.
+ * Kept as a static switch (not path-based) so bundlers can trace imports.
+ */
+async function loadCommandClass(command) {
+    const id = command.replace(/^raptor\./, "");
+    switch (id) {
+        case "new":
+            return (await import("../commands/new.js"))
+                .default;
+        case "approve":
+            return (await import("../commands/approve.js"))
+                .default;
+        case "plan":
+            return (await import("../commands/plan.js"))
+                .default;
+        case "tasks":
+            return (await import("../commands/tasks.js"))
+                .default;
+        case "implement":
+            return (await import("../commands/implement.js"))
+                .default;
+        case "clarify":
+            return (await import("../commands/clarify.js"))
+                .default;
+        case "checklist":
+            return (await import("../commands/checklist.js"))
+                .default;
+        case "analyze":
+            return (await import("../commands/analyze.js"))
+                .default;
+        case "hotfix":
+            return (await import("../commands/hotfix.js"))
+                .default;
+        case "verify":
+            return (await import("../commands/verify.js"))
+                .default;
+        default:
+            throw new Error(`Unknown raptor command in workflow step: "${command}". ` +
+                `Expected one of: raptor.{new,approve,plan,tasks,implement,clarify,checklist,analyze,hotfix,verify}.`);
+    }
+}
+export { buildArgvForCommand } from "./args-builder.js";
+//# sourceMappingURL=executor.js.map

package/dist/workflow/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/workflow/executor.ts"],"names":[],"mappings":"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"}

package/extensions/git/commands/rpt.git.feature.md

@@ -0,0 +1,85 @@
+---
+description: Create or validate a feature branch following Raptor naming conventions
+handoffs:
+  - label: Start new feature
+    agent: rpt.specify
+    prompt: "Start specifying the feature"
+    send: false
+scripts:
+  sh: scripts/bash/create-new-feature.sh --json
+---
+
+<!-- prompt-version: 1.0.0 -->
+
+# /rpt.git.feature
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+## Pre-Execution Checks
+
+1. Read `.raptor/extensions.yml` (if present).
+2. For each hook registered under `before_git_feature`:
+   - If `optional: false` → execute `EXECUTE_COMMAND: <command>` and wait.
+   - If `optional: true` → suggest `/<command>` to the user.
+3. If `.raptor/extensions.yml` is absent or invalid, proceed silently.
+
+## Outline
+
+1. **Parse input**: Extract feature short name from `$ARGUMENTS`.
+2. **Validate**: Ensure feature name is valid kebab-case.
+3. **Create branch**: Run `{SCRIPT}` with `--short-name <name>`.
+4. **Report**: Show the created branch and feature directory.
+
+## Phases
+
+### Phase 0 — Parse Input
+
+Extract the feature short name from `$ARGUMENTS`. The user may provide:
+
+- Just a name: `user-authentication`
+- A name with description: `user-auth for the login system`
+- A numbered name: `003-user-auth` (use the number, don't auto-assign)
+
+Normalize to kebab-case: `user-authentication` → `user-auth` (max 4 words).
+
+### Phase 1 — Create Feature Branch
+
+Run `{SCRIPT}` with appropriate arguments:
+
+```bash
+scripts/bash/create-new-feature.sh --json --short-name "<name>"
+```
+
+Parse the JSON output:
+
+```json
+{
+  "BRANCH_NAME": "003-user-auth",
+  "FEATURE_NUM": "003",
+  "FEATURE_DIR": "specs/003-user-auth"
+}
+```
+
+### Phase 2 — Report
+
+Present to the user:
+
+```
+✅ Feature branch created:
+   Branch: 003-user-auth
+   Directory: specs/003-user-auth/
+   
+Next step: Run /rpt.specify to create the feature specification.
+```
+
+## Final Hook Check
+
+1. Read `.raptor/extensions.yml` (if present).
+2. For each hook registered under `after_git_feature`:
+   - If `optional: false` → execute `EXECUTE_COMMAND: <command>` and wait.
+   - If `optional: true` → suggest `/<command>` to the user.
+3. If `.raptor/extensions.yml` is absent or invalid, proceed silently.

package/extensions/git/extension.yml

@@ -0,0 +1,47 @@
+# Git Extension — Bundled
+# Schema: raptor.extension/v1
+#
+# This extension provides git integration for the Raptor SDD lifecycle.
+# It manages feature branches, commit conventions, and branch validation.
+#
+# Spec Kit ref: E08 — "Extension bundled extensions/git/"
+
+schema: raptor.extension/v1
+id: git
+name: "Git Integration"
+description: "Feature branch management and commit conventions for SDD."
+version: "1.0.0"
+
+hooks:
+  - event: pre-feature
+    script: scripts/bash/create-new-feature.sh
+    description: "Create feature branch and spec directory"
+
+  - event: pre-plan
+    script: scripts/bash/setup-plan.sh
+    description: "Prepare plan artifacts directory"
+
+  - event: pre-implement
+    script: scripts/bash/check-prerequisites.sh
+    description: "Validate all prerequisite artifacts exist"
+
+templates:
+  - name: rpt.git.feature
+    path: commands/rpt.git.feature.md
+    description: "Feature branch creation prompt"
+
+gates:
+  - id: branch-naming
+    type: format
+    pattern: "^(feature|feat|fix|hotfix|chore)/\\d{3,}-[a-z0-9-]+$"
+    message: "Branch name must follow the pattern: type/NNN-kebab-name"
+
+  - id: branch-clean
+    type: command
+    command: "git diff --exit-code HEAD"
+    message: "Working tree must be clean before switching features"
+
+metadata:
+  category: vcs
+  required_tools:
+    - git

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "raptor-aios",
+  "version": "0.1.0",
+  "description": "Raptor — Spec-Driven Development (SDD) CLI for modern mobile apps. Constitutional gates, audit trail, real verification (a11y/perf/stores/OS matrix), and AI-agent slash commands.",
+  "type": "module",
+  "bin": {
+    "raptor": "./bin/raptor.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "templates",
+    "extensions",
+    "scripts",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "oclif": {
+    "bin": "raptor",
+    "dirname": "raptor",
+    "commands": "./dist/commands",
+    "topicSeparator": " "
+  },
+  "keywords": [
+    "sdd",
+    "spec-driven-development",
+    "cli",
+    "mobile",
+    "react-native",
+    "spec-kit",
+    "ai",
+    "claude",
+    "governance",
+    "audit"
+  ],
+  "author": "lucaspedronet",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lucaspedronet/raptor-aios.git"
+  },
+  "homepage": "https://github.com/lucaspedronet/raptor-aios#readme",
+  "bugs": {
+    "url": "https://github.com/lucaspedronet/raptor-aios/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@oclif/core": "^4",
+    "ajv": "^8.18.0",
+    "yaml": "^2.5.0"
+  }
+}

package/scripts/bash/check-prerequisites.sh

@@ -0,0 +1,149 @@
+#!/usr/bin/env bash
+# check-prerequisites.sh — Validate feature artifacts exist before commands.
+#
+# Spec Kit ref: E04 — "Valida existência de spec.md, plan.md, opcionalmente tasks.md"
+#
+# Args:
+#   --json               Output JSON to stdout
+#   --require-tasks      Fail if tasks.md is missing
+#   --include-tasks      Include tasks.md content in output
+#   --paths-only         Only output file paths, not content
+#
+# Output JSON (--json):
+#   { "FEATURE_DIR": "specs/003-user-auth",
+#     "AVAILABLE_DOCS": "spec.md,plan.md,research.md,data-model.md",
+#     "HAS_SPEC": "true",
+#     "HAS_PLAN": "true",
+#     "HAS_TASKS": "false",
+#     "HAS_RESEARCH": "false",
+#     "HAS_DATA_MODEL": "false",
+#     "HAS_CONTRACTS": "false",
+#     "HAS_QUICKSTART": "false",
+#     "HAS_CHECKLIST": "false" }
+#
+# Exit codes: 0=success, 1=validation error, 2=I/O error
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=common.sh
+source "${SCRIPT_DIR}/common.sh"
+
+# ---------------------------------------------------------------------------
+# Defaults
+# ---------------------------------------------------------------------------
+JSON_MODE=false
+REQUIRE_TASKS=false
+INCLUDE_TASKS=false
+PATHS_ONLY=false
+
+# ---------------------------------------------------------------------------
+# Parse arguments
+# ---------------------------------------------------------------------------
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --json)           JSON_MODE=true ;;
+    --require-tasks)  REQUIRE_TASKS=true ;;
+    --include-tasks)  INCLUDE_TASKS=true ;;
+    --paths-only)     PATHS_ONLY=true ;;
+    *)
+      die "Unknown argument: $1" 1
+      ;;
+  esac
+  shift
+done
+
+# ---------------------------------------------------------------------------
+# Resolve feature
+# ---------------------------------------------------------------------------
+get_feature_paths || die "Cannot resolve feature paths" 1
+
+# ---------------------------------------------------------------------------
+# Check each artifact
+# ---------------------------------------------------------------------------
+AVAILABLE_DOCS=""
+
+check_doc() {
+  local name="$1"
+  local path="${FEATURE_DIR}/${name}"
+  if [ -f "$path" ]; then
+    if [ -n "$AVAILABLE_DOCS" ]; then
+      AVAILABLE_DOCS="${AVAILABLE_DOCS},${name}"
+    else
+      AVAILABLE_DOCS="$name"
+    fi
+    echo "true"
+  else
+    echo "false"
+  fi
+}
+
+HAS_SPEC="$(check_doc "spec.md")"
+HAS_PLAN="$(check_doc "plan.md")"
+HAS_TASKS="$(check_doc "tasks.md")"
+HAS_RESEARCH="$(check_doc "research.md")"
+HAS_DATA_MODEL="$(check_doc "data-model.md")"
+HAS_QUICKSTART="$(check_doc "quickstart.md")"
+HAS_CHECKLIST="false"
+
+# Check checklists directory
+if [ -d "${FEATURE_DIR}/checklists" ]; then
+  for cl in "${FEATURE_DIR}/checklists"/*.md; do
+    [ -f "$cl" ] || continue
+    HAS_CHECKLIST="true"
+    clname="checklists/$(basename "$cl")"
+    if [ -n "$AVAILABLE_DOCS" ]; then
+      AVAILABLE_DOCS="${AVAILABLE_DOCS},${clname}"
+    else
+      AVAILABLE_DOCS="$clname"
+    fi
+  done
+fi
+
+# Check contracts directory
+HAS_CONTRACTS="false"
+if [ -d "${FEATURE_DIR}/contracts" ]; then
+  for ct in "${FEATURE_DIR}/contracts"/*; do
+    [ -f "$ct" ] || continue
+    HAS_CONTRACTS="true"
+    ctname="contracts/$(basename "$ct")"
+    if [ -n "$AVAILABLE_DOCS" ]; then
+      AVAILABLE_DOCS="${AVAILABLE_DOCS},${ctname}"
+    else
+      AVAILABLE_DOCS="$ctname"
+    fi
+  done
+fi
+
+# ---------------------------------------------------------------------------
+# Validate required artifacts
+# ---------------------------------------------------------------------------
+if [ "$HAS_SPEC" = "false" ]; then
+  die "spec.md not found in ${FEATURE_DIR}. Run /rpt.specify first." 1
+fi
+
+if [ "$REQUIRE_TASKS" = true ] && [ "$HAS_TASKS" = "false" ]; then
+  die "tasks.md not found in ${FEATURE_DIR}. Run /rpt.tasks first." 1
+fi
+
+# ---------------------------------------------------------------------------
+# Output
+# ---------------------------------------------------------------------------
+if [ "$JSON_MODE" = true ]; then
+  emit_json \
+    "FEATURE_DIR" "$FEATURE_DIR" \
+    "FEATURE_NAME" "$FEATURE_NAME" \
+    "AVAILABLE_DOCS" "$AVAILABLE_DOCS" \
+    "HAS_SPEC" "$HAS_SPEC" \
+    "HAS_PLAN" "$HAS_PLAN" \
+    "HAS_TASKS" "$HAS_TASKS" \
+    "HAS_RESEARCH" "$HAS_RESEARCH" \
+    "HAS_DATA_MODEL" "$HAS_DATA_MODEL" \
+    "HAS_CONTRACTS" "$HAS_CONTRACTS" \
+    "HAS_QUICKSTART" "$HAS_QUICKSTART" \
+    "HAS_CHECKLIST" "$HAS_CHECKLIST"
+else
+  echo "Feature: $FEATURE_DIR"
+  echo "Available docs: $AVAILABLE_DOCS"
+  echo "Spec: $HAS_SPEC | Plan: $HAS_PLAN | Tasks: $HAS_TASKS"
+fi