dev-playbooks 1.0.0

package/skills/devbooks-delivery-workflow/scripts/spec-preview.sh

@@ -0,0 +1,203 @@
+#!/bin/bash
+# skills/devbooks-delivery-workflow/scripts/spec-preview.sh
+# Spec conflict pre-check script
+#
+# Reads spec deltas from a change package and checks for staging conflicts.
+#
+# Usage:
+#   ./spec-preview.sh <change-id> [options]
+#   ./spec-preview.sh --help
+#
+# Exit codes:
+#   0 - no conflicts
+#   1 - conflicts found
+#   2 - usage error
+
+set -euo pipefail
+
+VERSION="1.0.0"
+
+# Defaults
+project_root="."
+change_root="changes"
+truth_root="specs"
+
+# Color output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+# Help
+show_help() {
+    cat << 'EOF'
+Spec conflict pre-check script (spec-preview.sh)
+
+usage:
+  ./spec-preview.sh <change-id> [options]
+
+options:
+  --project-root DIR  Project root (default: current directory)
+  --change-root DIR   Change root (default: changes)
+  --truth-root DIR    Truth root (default: specs)
+  --help, -h          Show help
+  --version, -v       Show version
+
+conflict detection:
+  1. File-level conflict: the same target file is modified by multiple changes
+  2. Content-level conflict: the same REQ-xxx is modified
+
+exit codes:
+  0 - no conflicts
+  1 - conflicts found
+  2 - usage error
+
+examples:
+  ./spec-preview.sh my-feature
+  ./spec-preview.sh my-feature --change-root dev-playbooks/changes
+
+EOF
+}
+
+show_version() {
+    echo "spec-preview.sh v${VERSION}"
+}
+
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $*"
+}
+
+log_warn() {
+    echo -e "${YELLOW}[WARN]${NC} $*" >&2
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $*" >&2
+}
+
+log_pass() {
+    echo -e "${GREEN}[PASS]${NC} $*"
+}
+
+# Main
+main() {
+    local change_id=""
+
+    # Parse args
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h)
+                show_help
+                exit 0
+                ;;
+            --version|-v)
+                show_version
+                exit 0
+                ;;
+            --project-root)
+                project_root="${2:-.}"
+                shift 2
+                ;;
+            --change-root)
+                change_root="${2:-changes}"
+                shift 2
+                ;;
+            --truth-root)
+                truth_root="${2:-specs}"
+                shift 2
+                ;;
+            -*)
+                log_error "Unknown option: $1"
+                exit 2
+                ;;
+            *)
+                change_id="$1"
+                shift
+                ;;
+        esac
+    done
+
+    if [[ -z "$change_id" ]]; then
+        log_error "Missing change-id"
+        exit 2
+    fi
+
+    # Build paths
+    local change_dir="${project_root}/${change_root}/${change_id}"
+    local staged_dir="${project_root}/${truth_root}/_staged"
+    local specs_delta_dir="${change_dir}/specs"
+
+    log_info "pre-checking change: ${change_id}"
+    log_info "  change dir: ${change_dir}"
+    log_info "  staged dir: ${staged_dir}"
+
+    # Ensure change exists
+    if [[ ! -d "$change_dir" ]]; then
+        log_error "change directory not found: ${change_dir}"
+        exit 2
+    fi
+
+    # Check whether spec deltas exist
+    if [[ ! -d "$specs_delta_dir" ]]; then
+        log_info "no spec deltas; skipping"
+        exit 0
+    fi
+
+    local conflicts=0
+    local file_conflicts=""
+    local req_conflicts=""
+
+    # File-level conflict detection
+    log_info "checking file-level conflicts..."
+    while IFS= read -r delta_file; do
+        [[ -z "$delta_file" ]] && continue
+
+        local relative_path="${delta_file#$specs_delta_dir/}"
+        local staged_path="${staged_dir}/${relative_path}"
+
+        if [[ -f "$staged_path" ]]; then
+            file_conflicts="${file_conflicts}  ${relative_path}\n"
+            conflicts=$((conflicts + 1))
+        fi
+    done < <(find "$specs_delta_dir" -type f -name "*.md" 2>/dev/null)
+
+    # Content-level conflict detection (REQ-xxx)
+    log_info "checking content-level conflicts..."
+    local current_reqs
+    current_reqs=$(grep -rhoE "REQ-[A-Z0-9]+-[0-9]+" "$specs_delta_dir" 2>/dev/null | sort -u || true)
+
+    if [[ -n "$current_reqs" && -d "$staged_dir" ]]; then
+        while IFS= read -r req; do
+            [[ -z "$req" ]] && continue
+
+            if grep -rq "$req" "$staged_dir" 2>/dev/null; then
+                req_conflicts="${req_conflicts}  ${req}\n"
+                conflicts=$((conflicts + 1))
+            fi
+        done <<< "$current_reqs"
+    fi
+
+    # Output
+    echo ""
+    if [[ $conflicts -gt 0 ]]; then
+        log_error "found ${conflicts} conflict(s)"
+
+        if [[ -n "$file_conflicts" ]]; then
+            echo -e "\nFile-level conflicts:"
+            echo -e "$file_conflicts"
+        fi
+
+        if [[ -n "$req_conflicts" ]]; then
+            echo -e "\nContent-level conflicts (REQ-xxx):"
+            echo -e "$req_conflicts"
+        fi
+
+        exit 1
+    fi
+
+    log_pass "no conflicts; safe to stage"
+    exit 0
+}
+
+main "$@"

package/skills/devbooks-delivery-workflow/scripts/spec-promote.sh

@@ -0,0 +1,118 @@
+#!/bin/bash
+# skills/devbooks-delivery-workflow/scripts/spec-promote.sh
+# Spec promotion script
+#
+# Promotes staged spec deltas into the truth root.
+#
+# Usage:
+#   ./spec-promote.sh <change-id> [options]
+#   ./spec-promote.sh --help
+#
+# Exit codes:
+#   0 - success
+#   1 - failure
+#   2 - usage error
+
+set -euo pipefail
+
+VERSION="1.0.0"
+
+project_root="."
+truth_root="specs"
+dry_run=false
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+show_help() {
+    cat << 'EOF'
+Spec promotion script (spec-promote.sh)
+
+usage:
+  ./spec-promote.sh <change-id> [options]
+
+options:
+  --project-root DIR  Project root
+  --truth-root DIR    Truth root
+  --dry-run           Dry run
+  --help, -h          Show help
+
+flow:
+  1. Verify preconditions (already staged)
+  2. Copy _staged/<change-id>/ into specs/
+  3. Remove _staged/<change-id>/
+
+EOF
+}
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $*"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $*" >&2; }
+log_error() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
+log_pass() { echo -e "${GREEN}[PASS]${NC} $*"; }
+
+main() {
+    local change_id=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h) show_help; exit 0 ;;
+            --version|-v) echo "spec-promote.sh v${VERSION}"; exit 0 ;;
+            --project-root) project_root="${2:-.}"; shift 2 ;;
+            --truth-root) truth_root="${2:-specs}"; shift 2 ;;
+            --dry-run) dry_run=true; shift ;;
+            -*) log_error "Unknown option: $1"; exit 2 ;;
+            *) change_id="$1"; shift ;;
+        esac
+    done
+
+    if [[ -z "$change_id" ]]; then
+        log_error "Missing change-id"
+        exit 2
+    fi
+
+    local staged_dir="${project_root}/${truth_root}/_staged/${change_id}"
+    local specs_dir="${project_root}/${truth_root}"
+
+    log_info "promoting change: ${change_id}"
+
+    # Preconditions
+    if [[ ! -d "$staged_dir" ]]; then
+        log_error "staged content not found: ${staged_dir}"
+        log_error "run spec-stage.sh first"
+        exit 1
+    fi
+
+    # Promote files
+    local promoted=0
+    while IFS= read -r file; do
+        [[ -z "$file" ]] && continue
+
+        local relative_path="${file#$staged_dir/}"
+        local target_path="${specs_dir}/${relative_path}"
+        local target_dir
+        target_dir=$(dirname "$target_path")
+
+        if [[ "$dry_run" == true ]]; then
+            log_info "[DRY-RUN] ${relative_path} -> ${target_path}"
+        else
+            mkdir -p "$target_dir"
+            cp "$file" "$target_path"
+        fi
+        promoted=$((promoted + 1))
+    done < <(find "$staged_dir" -type f 2>/dev/null)
+
+    # Cleanup staged directory
+    if [[ "$dry_run" == true ]]; then
+        log_info "[DRY-RUN] would remove: ${staged_dir}"
+    else
+        rm -rf "$staged_dir"
+    fi
+
+    log_pass "promoted ${promoted} file(s) into truth root"
+    exit 0
+}
+
+main "$@"

package/skills/devbooks-delivery-workflow/scripts/spec-rollback.sh

@@ -0,0 +1,124 @@
+#!/bin/bash
+# skills/devbooks-delivery-workflow/scripts/spec-rollback.sh
+# Spec rollback script
+#
+# Rolls back spec staging operations.
+#
+# Usage:
+#   ./spec-rollback.sh <change-id> [options]
+#   ./spec-rollback.sh --help
+#
+# Exit codes:
+#   0 - success
+#   1 - failure
+#   2 - usage error
+
+set -euo pipefail
+
+VERSION="1.0.0"
+
+project_root="."
+truth_root="specs"
+change_root="changes"
+target="staged"
+dry_run=false
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+show_help() {
+    cat << 'EOF'
+Spec rollback script (spec-rollback.sh)
+
+usage:
+  ./spec-rollback.sh <change-id> [options]
+
+options:
+  --project-root DIR  Project root
+  --truth-root DIR    Truth root
+  --change-root DIR   Change root
+  --target TARGET     Target: staged | draft
+  --dry-run           Dry run
+  --help, -h          Show help
+
+targets:
+  staged - clear the staging layer (keep spec deltas in the change package)
+  draft  - roll back to change-package state (clear staging; do not touch specs)
+
+EOF
+}
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $*"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $*" >&2; }
+log_error() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
+log_pass() { echo -e "${GREEN}[PASS]${NC} $*"; }
+
+main() {
+    local change_id=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h) show_help; exit 0 ;;
+            --version|-v) echo "spec-rollback.sh v${VERSION}"; exit 0 ;;
+            --project-root) project_root="${2:-.}"; shift 2 ;;
+            --truth-root) truth_root="${2:-specs}"; shift 2 ;;
+            --change-root) change_root="${2:-changes}"; shift 2 ;;
+            --target) target="${2:-staged}"; shift 2 ;;
+            --dry-run) dry_run=true; shift ;;
+            -*) log_error "Unknown option: $1"; exit 2 ;;
+            *) change_id="$1"; shift ;;
+        esac
+    done
+
+    if [[ -z "$change_id" ]]; then
+        log_error "Missing change-id"
+        exit 2
+    fi
+
+    case "$target" in
+        staged|draft) ;;
+        *) log_error "Invalid target: $target"; exit 2 ;;
+    esac
+
+    local staged_dir="${project_root}/${truth_root}/_staged/${change_id}"
+
+    log_info "rolling back change: ${change_id}"
+    log_info "target: ${target}"
+
+    case "$target" in
+        staged)
+            # Clear staging layer
+            if [[ -d "$staged_dir" ]]; then
+                if [[ "$dry_run" == true ]]; then
+                    log_info "[DRY-RUN] would remove: ${staged_dir}"
+                else
+                    rm -rf "$staged_dir"
+                    log_pass "cleared staging: ${staged_dir}"
+                fi
+            else
+                log_info "staging is empty; nothing to do"
+            fi
+            ;;
+
+        draft)
+            # Roll back to change-package state (clear staging)
+            if [[ -d "$staged_dir" ]]; then
+                if [[ "$dry_run" == true ]]; then
+                    log_info "[DRY-RUN] would remove: ${staged_dir}"
+                else
+                    rm -rf "$staged_dir"
+                    log_pass "rolled back to draft state"
+                fi
+            else
+                log_info "already in draft state"
+            fi
+            ;;
+    esac
+
+    exit 0
+}
+
+main "$@"

package/skills/devbooks-delivery-workflow/scripts/spec-stage.sh

@@ -0,0 +1,117 @@
+#!/bin/bash
+# skills/devbooks-delivery-workflow/scripts/spec-stage.sh
+# Spec staging script
+#
+# Syncs a change package's spec deltas into the staging layer.
+#
+# Usage:
+#   ./spec-stage.sh <change-id> [options]
+#   ./spec-stage.sh --help
+#
+# Exit codes:
+#   0 - success
+#   1 - failure (conflicts)
+#   2 - usage error
+
+set -euo pipefail
+
+VERSION="1.0.0"
+
+project_root="."
+change_root="changes"
+truth_root="specs"
+dry_run=false
+force=false
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+NC='\033[0m'
+
+show_help() {
+    cat << 'EOF'
+Spec staging script (spec-stage.sh)
+
+usage:
+  ./spec-stage.sh <change-id> [options]
+
+options:
+  --project-root DIR  Project root
+  --change-root DIR   Change root
+  --truth-root DIR    Truth root
+  --dry-run           Dry run (no filesystem changes)
+  --force             Force stage (ignore conflicts)
+  --help, -h          Show help
+
+exit codes:
+  0 - success
+  1 - failure
+  2 - usage error
+
+EOF
+}
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $*"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $*" >&2; }
+log_error() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
+log_pass() { echo -e "${GREEN}[PASS]${NC} $*"; }
+
+main() {
+    local change_id=""
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --help|-h) show_help; exit 0 ;;
+            --version|-v) echo "spec-stage.sh v${VERSION}"; exit 0 ;;
+            --project-root) project_root="${2:-.}"; shift 2 ;;
+            --change-root) change_root="${2:-changes}"; shift 2 ;;
+            --truth-root) truth_root="${2:-specs}"; shift 2 ;;
+            --dry-run) dry_run=true; shift ;;
+            --force) force=true; shift ;;
+            -*) log_error "Unknown option: $1"; exit 2 ;;
+            *) change_id="$1"; shift ;;
+        esac
+    done
+
+    if [[ -z "$change_id" ]]; then
+        log_error "Missing change-id"
+        exit 2
+    fi
+
+    local change_dir="${project_root}/${change_root}/${change_id}"
+    local staged_dir="${project_root}/${truth_root}/_staged/${change_id}"
+    local specs_delta_dir="${change_dir}/specs"
+
+    log_info "staging change: ${change_id}"
+
+    if [[ ! -d "$specs_delta_dir" ]]; then
+        log_info "no spec deltas; skipping"
+        exit 0
+    fi
+
+    # Use spec-preview to check for conflicts
+    local script_dir
+    script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+    if [[ "$force" != true && -x "${script_dir}/spec-preview.sh" ]]; then
+        if ! "${script_dir}/spec-preview.sh" "$change_id" --project-root "$project_root" --change-root "$change_root" --truth-root "$truth_root"; then
+            log_error "conflicts detected; use --force to stage anyway"
+            exit 1
+        fi
+    fi
+
+    # Execute staging
+    if [[ "$dry_run" == true ]]; then
+        log_info "[DRY-RUN] would create: ${staged_dir}"
+        log_info "[DRY-RUN] would copy: ${specs_delta_dir}/* -> ${staged_dir}/"
+    else
+        mkdir -p "$staged_dir"
+        cp -r "$specs_delta_dir"/* "$staged_dir"/
+        log_pass "staged to: ${staged_dir}"
+    fi
+
+    exit 0
+}
+
+main "$@"

package/skills/devbooks-delivery-workflow/scripts/verify-all.sh

@@ -0,0 +1,78 @@
+#!/bin/bash
+# verify-all.sh - Run all verification scripts
+#
+# Aggregates verification results for AC-001 ~ AC-022
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+GREEN='\033[0;32m'
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+echo -e "${CYAN}╔════════════════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║     DevBooks Independence Verification Suite   ║${NC}"
+echo -e "${CYAN}╚════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Run verification scripts
+echo -e "${YELLOW}>>> OpenSpec removal verification (AC-001 ~ AC-004)${NC}"
+echo ""
+openspec_result=0
+if "$SCRIPT_DIR/verify-openspec-free.sh"; then
+    openspec_result=1
+fi
+echo ""
+
+echo -e "${YELLOW}>>> Slash command verification (AC-005 ~ AC-010)${NC}"
+echo ""
+slash_result=0
+if "$SCRIPT_DIR/verify-slash-commands.sh"; then
+    slash_result=1
+fi
+echo ""
+
+echo -e "${YELLOW}>>> npm package verification (AC-011 ~ AC-016)${NC}"
+echo ""
+npm_result=0
+if "$SCRIPT_DIR/verify-npm-package.sh"; then
+    npm_result=1
+fi
+echo ""
+
+echo -e "${CYAN}╔════════════════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║                   Summary                      ║${NC}"
+echo -e "${CYAN}╚════════════════════════════════════════════════╝${NC}"
+echo ""
+
+if [[ $openspec_result -eq 1 ]]; then
+    echo -e "${GREEN}✅ OpenSpec removal verification${NC}"
+else
+    echo -e "${RED}❌ OpenSpec removal verification${NC}"
+fi
+
+if [[ $slash_result -eq 1 ]]; then
+    echo -e "${GREEN}✅ Slash command verification${NC}"
+else
+    echo -e "${RED}❌ Slash command verification${NC}"
+fi
+
+if [[ $npm_result -eq 1 ]]; then
+    echo -e "${GREEN}✅ npm package verification${NC}"
+else
+    echo -e "${RED}❌ npm package verification${NC}"
+fi
+
+echo ""
+
+total=$((openspec_result + slash_result + npm_result))
+if [[ $total -eq 3 ]]; then
+    echo -e "${GREEN}🎉 All checks passed! DevBooks independence verified.${NC}"
+    exit 0
+else
+    echo -e "${RED}⚠️  Some checks failed. Review the output above.${NC}"
+    exit 1
+fi