@jaguilar87/gaia-ops 1.0.0

package/speckit/scripts/check-prerequisites.sh

@@ -0,0 +1,194 @@
+#!/usr/bin/env bash
+
+# Consolidated prerequisite checking script
+#
+# This script provides unified prerequisite checking for Spec-Driven Development workflow.
+# It replaces the functionality previously spread across multiple scripts.
+#
+# Usage: ./check-prerequisites.sh <speckit-root> <feature-name> [OPTIONS]
+#
+# ARGUMENTS:
+#   <speckit-root>      Path to spec-kit root directory (e.g., spec-kit-tcm-plan)
+#   <feature-name>      Feature directory name (e.g., 004-project-guidance-deployment)
+#
+# OPTIONS:
+#   --json              Output in JSON format
+#   --require-tasks     Require tasks.md to exist (for implementation phase)
+#   --include-tasks     Include tasks.md in AVAILABLE_DOCS list
+#   --paths-only        Only output path variables (no validation)
+#   --help, -h          Show help message
+#
+# OUTPUTS:
+#   JSON mode: {"FEATURE_DIR":"...", "AVAILABLE_DOCS":["..."]}
+#   Text mode: FEATURE_DIR:... \n AVAILABLE_DOCS: \n ✓/✗ file.md
+#   Paths only: REPO_ROOT: ... \n BRANCH: ... \n FEATURE_DIR: ... etc.
+
+set -e
+
+# Parse positional arguments and flags
+POSITIONAL_ARGS=()
+JSON_MODE=false
+REQUIRE_TASKS=false
+INCLUDE_TASKS=false
+PATHS_ONLY=false
+
+for arg in "$@"; do
+    case "$arg" in
+        --json)
+            JSON_MODE=true
+            ;;
+        --require-tasks)
+            REQUIRE_TASKS=true
+            ;;
+        --include-tasks)
+            INCLUDE_TASKS=true
+            ;;
+        --paths-only)
+            PATHS_ONLY=true
+            ;;
+        --help|-h)
+            cat << 'EOF'
+Usage: check-prerequisites.sh <speckit-root> <feature-name> [OPTIONS]
+
+Consolidated prerequisite checking for Spec-Driven Development workflow.
+
+ARGUMENTS:
+  <speckit-root>      Path to spec-kit root directory (e.g., spec-kit-tcm-plan)
+  <feature-name>      Feature directory name (e.g., 004-project-guidance-deployment)
+
+OPTIONS:
+  --json              Output in JSON format
+  --require-tasks     Require tasks.md to exist (for implementation phase)
+  --include-tasks     Include tasks.md in AVAILABLE_DOCS list
+  --paths-only        Only output path variables (no prerequisite validation)
+  --help, -h          Show this help message
+
+EXAMPLES:
+  # Check task prerequisites (plan.md required)
+  ./check-prerequisites.sh spec-kit-tcm-plan 004-feature-name --json
+
+  # Check implementation prerequisites (plan.md + tasks.md required)
+  ./check-prerequisites.sh spec-kit-tcm-plan 004-feature-name --json --require-tasks --include-tasks
+
+  # Get feature paths only (no validation)
+  ./check-prerequisites.sh spec-kit-tcm-plan 004-feature-name --paths-only
+
+EOF
+            exit 0
+            ;;
+        -*)
+            echo "ERROR: Unknown option '$arg'. Use --help for usage information." >&2
+            exit 1
+            ;;
+        *)
+            POSITIONAL_ARGS+=("$arg")
+            ;;
+    esac
+done
+
+# Extract positional arguments
+SPECKIT_ROOT_ARG="${POSITIONAL_ARGS[0]:-}"
+FEATURE_NAME_ARG="${POSITIONAL_ARGS[1]:-}"
+
+# Validate required arguments
+if [[ -z "$SPECKIT_ROOT_ARG" ]]; then
+    echo "ERROR: speckit-root argument is required" >&2
+    echo "Usage: check-prerequisites.sh <speckit-root> <feature-name> [OPTIONS]" >&2
+    exit 1
+fi
+
+if [[ -z "$FEATURE_NAME_ARG" ]]; then
+    echo "ERROR: feature-name argument is required" >&2
+    echo "Usage: check-prerequisites.sh <speckit-root> <feature-name> [OPTIONS]" >&2
+    exit 1
+fi
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Get feature paths using explicit arguments
+eval $(get_feature_paths "$SPECKIT_ROOT_ARG" "$FEATURE_NAME_ARG")
+
+# If paths-only mode, output paths and exit (support JSON + paths-only combined)
+if $PATHS_ONLY; then
+    if $JSON_MODE; then
+        # Minimal JSON paths payload (no validation performed)
+        printf '{"REPO_ROOT":"%s","BRANCH":"%s","FEATURE_DIR":"%s","FEATURE_SPEC":"%s","IMPL_PLAN":"%s","TASKS":"%s"}\n' \
+            "$REPO_ROOT" "$CURRENT_BRANCH" "$FEATURE_DIR" "$FEATURE_SPEC" "$IMPL_PLAN" "$TASKS"
+    else
+        echo "REPO_ROOT: $REPO_ROOT"
+        echo "BRANCH: $CURRENT_BRANCH"
+        echo "FEATURE_DIR: $FEATURE_DIR"
+        echo "FEATURE_SPEC: $FEATURE_SPEC"
+        echo "IMPL_PLAN: $IMPL_PLAN"
+        echo "TASKS: $TASKS"
+    fi
+    exit 0
+fi
+
+# Validate required directories and files
+if [[ ! -d "$FEATURE_DIR" ]]; then
+    echo "ERROR: Feature directory not found: $FEATURE_DIR" >&2
+    echo "Run /specify first to create the feature structure." >&2
+    exit 1
+fi
+
+if [[ ! -f "$IMPL_PLAN" ]]; then
+    echo "ERROR: plan.md not found in $FEATURE_DIR" >&2
+    echo "Run /plan first to create the implementation plan." >&2
+    exit 1
+fi
+
+# Check for tasks.md if required
+if $REQUIRE_TASKS && [[ ! -f "$TASKS" ]]; then
+    echo "ERROR: tasks.md not found in $FEATURE_DIR" >&2
+    echo "Run /tasks first to create the task list." >&2
+    exit 1
+fi
+
+# Build list of available documents
+docs=()
+
+# Always check these optional docs
+[[ -f "$RESEARCH" ]] && docs+=("research.md")
+[[ -f "$DATA_MODEL" ]] && docs+=("data-model.md")
+
+# Check contracts directory (only if it exists and has files)
+if [[ -d "$CONTRACTS_DIR" ]] && [[ -n "$(ls -A "$CONTRACTS_DIR" 2>/dev/null)" ]]; then
+    docs+=("contracts/")
+fi
+
+[[ -f "$QUICKSTART" ]] && docs+=("quickstart.md")
+
+# Include tasks.md if requested and it exists
+if $INCLUDE_TASKS && [[ -f "$TASKS" ]]; then
+    docs+=("tasks.md")
+fi
+
+# Output results
+if $JSON_MODE; then
+    # Build JSON array of documents
+    if [[ ${#docs[@]} -eq 0 ]]; then
+        json_docs="[]"
+    else
+        json_docs=$(printf '"%s",' "${docs[@]}")
+        json_docs="[${json_docs%,}]"
+    fi
+    
+    printf '{"FEATURE_DIR":"%s","AVAILABLE_DOCS":%s}\n' "$FEATURE_DIR" "$json_docs"
+else
+    # Text output
+    echo "FEATURE_DIR:$FEATURE_DIR"
+    echo "AVAILABLE_DOCS:"
+    
+    # Show status of each potential document
+    check_file "$RESEARCH" "research.md"
+    check_file "$DATA_MODEL" "data-model.md"
+    check_dir "$CONTRACTS_DIR" "contracts/"
+    check_file "$QUICKSTART" "quickstart.md"
+    
+    if $INCLUDE_TASKS; then
+        check_file "$TASKS" "tasks.md"
+    fi
+fi

package/speckit/scripts/common.sh

@@ -0,0 +1,126 @@
+#!/usr/bin/env bash
+# Common functions for Spec-Kit scripts - Simplified Version 2.0
+# All commands now receive explicit arguments: <speckit-root> <feature-name>
+
+# Get repository root
+get_repo_root() {
+    if git rev-parse --show-toplevel >/dev/null 2>&1; then
+        git rev-parse --show-toplevel
+    else
+        # Fall back to script location for non-git repos
+        local script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+        (cd "$script_dir/../../.." && pwd)
+    fi
+}
+
+# Derive all paths from explicit arguments
+# Usage: get_feature_paths <speckit-root> <feature-name>
+# Returns: Environment variables for all paths
+get_feature_paths() {
+    local speckit_root_arg="${1:-}"
+    local feature_name_arg="${2:-}"
+
+    # Validate arguments
+    if [[ -z "$speckit_root_arg" ]]; then
+        echo "ERROR: speckit-root argument is required" >&2
+        echo "Usage: <command> <speckit-root> <feature-name>" >&2
+        echo "Example: setup-plan.sh spec-kit-tcm-plan 004-project-guidance-deployment" >&2
+        return 1
+    fi
+
+    if [[ -z "$feature_name_arg" ]]; then
+        echo "ERROR: feature-name argument is required" >&2
+        echo "Usage: <command> <speckit-root> <feature-name>" >&2
+        echo "Example: setup-plan.sh spec-kit-tcm-plan 004-project-guidance-deployment" >&2
+        return 1
+    fi
+
+    local repo_root=$(get_repo_root)
+
+    # Resolve speckit_root to absolute path
+    local speckit_root
+    if [[ "$speckit_root_arg" = /* ]]; then
+        # Already absolute path
+        speckit_root="$speckit_root_arg"
+    else
+        # Relative path - resolve from repo root
+        speckit_root="$repo_root/$speckit_root_arg"
+    fi
+
+    # Extract feature name (if path was provided instead of name)
+    local feature_name
+    if [[ "$feature_name_arg" == *"/"* ]]; then
+        # Extract basename from path
+        feature_name=$(basename "$feature_name_arg")
+    else
+        feature_name="$feature_name_arg"
+    fi
+
+    # Clean up feature name
+    feature_name=$(echo "$feature_name" | tr -d '\r' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    # Derive all paths from these two arguments
+    local specs_dir="$speckit_root/specs"
+    local feature_dir="$specs_dir/$feature_name"
+    local constitution_path="$speckit_root/constitution.md"
+    local templates_dir="$repo_root/.claude/speckit/templates"
+    local scripts_dir="$repo_root/.claude/speckit/scripts"
+
+    # Output all paths
+    cat <<EOF
+REPO_ROOT='$repo_root'
+SPECKIT_ROOT='$speckit_root'
+SPECS_DIR='$specs_dir'
+FEATURE_NAME='$feature_name'
+FEATURE_DIR='$feature_dir'
+FEATURE_SPEC='$feature_dir/spec.md'
+IMPL_PLAN='$feature_dir/plan.md'
+TASKS='$feature_dir/tasks.md'
+RESEARCH='$feature_dir/research.md'
+DATA_MODEL='$feature_dir/data-model.md'
+QUICKSTART='$feature_dir/quickstart.md'
+CONTRACTS_DIR='$feature_dir/contracts'
+CONSTITUTION_PATH='$constitution_path'
+TEMPLATES_DIR='$templates_dir'
+SCRIPTS_DIR='$scripts_dir'
+EOF
+}
+
+# Utility functions for validation
+check_file() {
+    [[ -f "$1" ]] && echo "  ✓ $2" || echo "  ✗ $2"
+}
+
+check_dir() {
+    [[ -d "$1" && -n $(ls -A "$1" 2>/dev/null) ]] && echo "  ✓ $2" || echo "  ✗ $2"
+}
+
+# Validate speckit root directory exists
+validate_speckit_root() {
+    local speckit_root="$1"
+
+    if [[ ! -d "$speckit_root" ]]; then
+        echo "ERROR: Spec-Kit root directory not found: $speckit_root" >&2
+        echo "" >&2
+        echo "Create it first: mkdir -p $speckit_root" >&2
+        return 1
+    fi
+
+    # Optionally warn if constitution doesn't exist
+    if [[ ! -f "$speckit_root/constitution.md" ]]; then
+        echo "WARNING: constitution.md not found at $speckit_root/constitution.md" >&2
+        echo "Consider creating it for project governance." >&2
+    fi
+
+    return 0
+}
+
+# Create specs directory if it doesn't exist
+ensure_specs_dir() {
+    local specs_dir="$1"
+
+    if [[ ! -d "$specs_dir" ]]; then
+        mkdir -p "$specs_dir"
+        echo "Created specs directory: $specs_dir"
+    fi
+}

package/speckit/scripts/create-new-feature.sh

@@ -0,0 +1,131 @@
+#!/usr/bin/env bash
+
+set -e
+
+# Parse command line arguments
+JSON_MODE=false
+SPECKIT_ROOT_ARG=""
+FEATURE_DESCRIPTION=""
+
+usage() {
+    echo "Usage: $0 [--json] <speckit-root> <feature-description>"
+    echo ""
+    echo "Arguments:"
+    echo "  speckit-root         Path to spec-kit root directory (e.g., spec-kit-tcm-plan)"
+    echo "  feature-description  Natural language description of the feature"
+    echo ""
+    echo "Options:"
+    echo "  --json              Output results in JSON format"
+    echo "  --help, -h          Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 spec-kit-tcm-plan Add dark mode toggle"
+    echo "  $0 --json spec-kit-tcm-plan Implement user authentication"
+    exit 0
+}
+
+# Parse arguments
+POSITIONAL_ARGS=()
+for arg in "$@"; do
+    case "$arg" in
+        --json)
+            JSON_MODE=true
+            ;;
+        --help|-h)
+            usage
+            ;;
+        -*)
+            echo "Unknown option: $arg" >&2
+            usage
+            ;;
+        *)
+            POSITIONAL_ARGS+=("$arg")
+            ;;
+    esac
+done
+
+# Extract speckit-root (first positional) and feature-description (remaining)
+if [ "${#POSITIONAL_ARGS[@]}" -lt 2 ]; then
+    echo "ERROR: Both <speckit-root> and <feature-description> are required" >&2
+    echo "" >&2
+    usage
+fi
+
+SPECKIT_ROOT_ARG="${POSITIONAL_ARGS[0]}"
+# Join remaining args as feature description
+FEATURE_DESCRIPTION="${POSITIONAL_ARGS[@]:1}"
+
+if [ -z "$FEATURE_DESCRIPTION" ]; then
+    echo "ERROR: Feature description cannot be empty" >&2
+    exit 1
+fi
+
+# Get script directory and load common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+REPO_ROOT=$(get_repo_root)
+cd "$REPO_ROOT"
+
+# Resolve speckit_root to absolute path
+if [[ "$SPECKIT_ROOT_ARG" = /* ]]; then
+    SPECKIT_ROOT="$SPECKIT_ROOT_ARG"
+else
+    SPECKIT_ROOT="$REPO_ROOT/$SPECKIT_ROOT_ARG"
+fi
+
+# Validate speckit root exists
+validate_speckit_root "$SPECKIT_ROOT" || exit 1
+
+# Derive specs directory
+SPECS_DIR="$SPECKIT_ROOT/specs"
+ensure_specs_dir "$SPECS_DIR"
+
+# Find highest numbered feature
+HIGHEST=0
+if [ -d "$SPECS_DIR" ]; then
+    for dir in "$SPECS_DIR"/*; do
+        [ -d "$dir" ] || continue
+        dirname=$(basename "$dir")
+        number=$(echo "$dirname" | grep -o '^[0-9]\+' || echo "0")
+        number=$((10#$number))
+        if [ "$number" -gt "$HIGHEST" ]; then
+            HIGHEST=$number
+        fi
+    done
+fi
+
+# Generate next feature number
+NEXT=$((HIGHEST + 1))
+FEATURE_NUM=$(printf "%03d" "$NEXT")
+
+# Generate feature name from description
+FEATURE_NAME=$(echo "$FEATURE_DESCRIPTION" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/-\+/-/g' | sed 's/^-//' | sed 's/-$//')
+WORDS=$(echo "$FEATURE_NAME" | tr '-' '\n' | grep -v '^$' | head -3 | tr '\n' '-' | sed 's/-$//')
+FEATURE_NAME="${FEATURE_NUM}-${WORDS}"
+
+# Create feature directory
+FEATURE_DIR="$SPECS_DIR/$FEATURE_NAME"
+mkdir -p "$FEATURE_DIR"
+
+# Copy spec template
+TEMPLATE="$REPO_ROOT/.claude/speckit/templates/spec-template.md"
+SPEC_FILE="$FEATURE_DIR/spec.md"
+if [ -f "$TEMPLATE" ]; then
+    cp "$TEMPLATE" "$SPEC_FILE"
+else
+    touch "$SPEC_FILE"
+    echo "Warning: Spec template not found at $TEMPLATE" >&2
+fi
+
+# Output results
+if $JSON_MODE; then
+    printf '{"FEATURE_NAME":"%s","SPEC_FILE":"%s","FEATURE_NUM":"%s","FEATURE_DIR":"%s","SPECKIT_ROOT":"%s"}\n' \
+        "$FEATURE_NAME" "$SPEC_FILE" "$FEATURE_NUM" "$FEATURE_DIR" "$SPECKIT_ROOT"
+else
+    echo "FEATURE_NAME: $FEATURE_NAME"
+    echo "SPEC_FILE: $SPEC_FILE"
+    echo "FEATURE_NUM: $FEATURE_NUM"
+    echo "FEATURE_DIR: $FEATURE_DIR"
+    echo "SPECKIT_ROOT: $SPECKIT_ROOT"
+fi

package/speckit/scripts/init.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# ============================================================================
+# DEPRECATED: This script is no longer needed in Spec-Kit 2.0
+# ============================================================================
+#
+# Spec-Kit 2.0 uses explicit arguments instead of config.json:
+#
+# OLD WORKFLOW (config.json required):
+#   /speckit.init --root spec-kit-tcm-plan
+#   /speckit.plan
+#   /speckit.tasks
+#
+# NEW WORKFLOW (no initialization needed):
+#   /speckit.plan spec-kit-tcm-plan 004-feature-name
+#   /speckit.tasks spec-kit-tcm-plan 004-feature-name
+#
+# All commands now receive two explicit arguments:
+#   1. <speckit-root>: Path to spec-kit directory
+#   2. <feature-name>: Name of the feature
+#
+# This eliminates the need for config.json and makes all operations explicit.
+#
+# If you need to migrate from Spec-Kit 1.0, simply start using the new
+# command format. Your existing specs/ directories will work unchanged.
+#
+# ============================================================================
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "  ⚠️  DEPRECATED: /speckit.init is no longer needed in Spec-Kit 2.0"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Spec-Kit 2.0 uses explicit arguments instead of config.json."
+echo ""
+echo "NEW USAGE:"
+echo "  /speckit.plan <speckit-root> <feature-name>"
+echo ""
+echo "EXAMPLE:"
+echo "  /speckit.plan spec-kit-tcm-plan 004-project-guidance-deployment"
+echo ""
+echo "No initialization is required. Just use the commands with explicit paths!"
+echo ""
+exit 1

package/speckit/scripts/setup-plan.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+
+set -e
+
+# Parse command line arguments
+JSON_MODE=false
+SPECKIT_ROOT_ARG=""
+FEATURE_NAME_ARG=""
+
+usage() {
+    echo "Usage: $0 [--json] <speckit-root> <feature-name>"
+    echo ""
+    echo "Arguments:"
+    echo "  speckit-root      Path to spec-kit root directory (e.g., spec-kit-tcm-plan)"
+    echo "  feature-name      Feature name (e.g., 004-project-guidance-deployment)"
+    echo ""
+    echo "Options:"
+    echo "  --json            Output results in JSON format"
+    echo "  --help, -h        Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 spec-kit-tcm-plan 004-project-guidance-deployment"
+    echo "  $0 --json spec-kit-tcm-plan 004-project-guidance-deployment"
+    echo "  $0 /absolute/path/to/spec-kit-tcm-plan 004-project-guidance-deployment"
+    exit 0
+}
+
+for arg in "$@"; do
+    case "$arg" in
+        --json)
+            JSON_MODE=true
+            ;;
+        --help|-h)
+            usage
+            ;;
+        -*)
+            echo "Unknown option: $arg" >&2
+            usage
+            ;;
+        *)
+            # First positional arg = speckit-root, second = feature-name
+            if [[ -z "$SPECKIT_ROOT_ARG" ]]; then
+                SPECKIT_ROOT_ARG="$arg"
+            elif [[ -z "$FEATURE_NAME_ARG" ]]; then
+                FEATURE_NAME_ARG="$arg"
+            fi
+            ;;
+    esac
+done
+
+# Validate required arguments
+if [[ -z "$SPECKIT_ROOT_ARG" ]] || [[ -z "$FEATURE_NAME_ARG" ]]; then
+    echo "ERROR: Both <speckit-root> and <feature-name> are required" >&2
+    echo "" >&2
+    usage
+fi
+
+# Get script directory and load common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+# Get all paths from explicit arguments (no config.json needed!)
+eval $(get_feature_paths "$SPECKIT_ROOT_ARG" "$FEATURE_NAME_ARG") || exit 1
+
+# Validate speckit root exists
+validate_speckit_root "$SPECKIT_ROOT" || exit 1
+
+# Ensure specs directory exists
+ensure_specs_dir "$SPECS_DIR"
+
+# Ensure feature directory exists
+mkdir -p "$FEATURE_DIR"
+
+# Copy plan template if it exists
+TEMPLATE="$TEMPLATES_DIR/plan-template.md"
+if [[ -f "$TEMPLATE" ]]; then
+    cp "$TEMPLATE" "$IMPL_PLAN"
+    echo "Copied plan template to $IMPL_PLAN"
+else
+    echo "Warning: Plan template not found at $TEMPLATE"
+    # Create a basic plan file if template doesn't exist
+    touch "$IMPL_PLAN"
+fi
+
+# Output results
+if $JSON_MODE; then
+    printf '{"FEATURE_SPEC":"%s","IMPL_PLAN":"%s","FEATURE_DIR":"%s","FEATURE_NAME":"%s","SPECKIT_ROOT":"%s"}\n' \
+        "$FEATURE_SPEC" "$IMPL_PLAN" "$FEATURE_DIR" "$FEATURE_NAME" "$SPECKIT_ROOT"
+else
+    echo "FEATURE_SPEC: $FEATURE_SPEC"
+    echo "IMPL_PLAN: $IMPL_PLAN"
+    echo "FEATURE_DIR: $FEATURE_DIR"
+    echo "FEATURE_NAME: $FEATURE_NAME"
+    echo "SPECKIT_ROOT: $SPECKIT_ROOT"
+fi