dev-playbooks-cn 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 the spec delta from a change package and checks for conflicts in the staging layer.
+#
+# Usage:
+#   ./spec-preview.sh <change-id> [options]
+#   ./spec-preview.sh --help
+#
+# Exit codes:
+#   0 - No conflicts
+#   1 - Conflicts detected
+#   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'
+
+# Show 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 directory, default is current directory
+  --change-root DIR   Change package directory, default is changes
+  --truth-root DIR    Truth source directory, default is specs
+  --help, -h          Show this help message
+  --version, -v       Show version information
+
+Conflict detection:
+  1. File-level conflicts: Same target file modified by multiple change packages
+  2. Content-level conflicts: Same REQ-xxx being modified
+
+Exit codes:
+  0 - No conflicts
+  1 - Conflicts detected
+  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 function
+main() {
+    local change_id=""
+
+    # Parse arguments
+    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 package: ${change_id}"
+    log_info "  Change directory: ${change_dir}"
+    log_info "  Staging directory: ${staged_dir}"
+
+    # Check change package exists
+    if [[ ! -d "$change_dir" ]]; then
+        log_error "Change package does not exist: ${change_dir}"
+        exit 2
+    fi
+
+    # Check if there is spec delta
+    if [[ ! -d "$specs_delta_dir" ]]; then
+        log_info "No spec delta, skipping pre-check"
+        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 results
+    echo ""
+    if [[ $conflicts -gt 0 ]]; then
+        log_error "Detected ${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, ready 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 the spec delta from the staging layer to the truth layer.
+#
+# Usage:
+#   ./spec-promote.sh <change-id> [options]
+#   ./spec-promote.sh --help
+#
+# Exit codes:
+#   0 - Promotion successful
+#   1 - Promotion failed
+#   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 directory
+  --truth-root DIR    Truth source directory
+  --dry-run           Simulate run
+  --help, -h          Show help
+
+Process:
+  1. Check prerequisites (already staged)
+  2. Move _staged/<change-id>/ contents to specs/
+  3. Clean up _staged/<change-id>/ directory
+
+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 package: ${change_id}"
+
+    # Check prerequisites
+    if [[ ! -d "$staged_dir" ]]; then
+        log_error "Staged content not found: ${staged_dir}"
+        log_error "Please 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)
+
+    # Clean up staging directory
+    if [[ "$dry_run" == true ]]; then
+        log_info "[DRY-RUN] Would delete: ${staged_dir}"
+    else
+        rm -rf "$staged_dir"
+    fi
+
+    log_pass "Promoted ${promoted} file(s) to truth layer"
+    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 sync operations.
+#
+# Usage:
+#   ./spec-rollback.sh <change-id> [options]
+#   ./spec-rollback.sh --help
+#
+# Exit codes:
+#   0 - Rollback successful
+#   1 - Rollback failed
+#   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 directory
+  --truth-root DIR    Truth source directory
+  --change-root DIR   Change package directory
+  --target TARGET     Rollback target: staged | draft
+  --dry-run           Simulate run
+  --help, -h          Show help
+
+Rollback targets:
+  staged - Clean up staging layer (preserve spec delta in change package)
+  draft  - Roll back to change package state (clean up staging layer, 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 rollback target: $target"; exit 2 ;;
+    esac
+
+    local staged_dir="${project_root}/${truth_root}/_staged/${change_id}"
+
+    log_info "Rolling back change package: ${change_id}"
+    log_info "Rollback target: ${target}"
+
+    case "$target" in
+        staged)
+            # Clean up staging layer
+            if [[ -d "$staged_dir" ]]; then
+                if [[ "$dry_run" == true ]]; then
+                    log_info "[DRY-RUN] Would delete: ${staged_dir}"
+                else
+                    rm -rf "$staged_dir"
+                    log_pass "Cleaned up staging layer: ${staged_dir}"
+                fi
+            else
+                log_info "Staging layer is empty, no cleanup needed"
+            fi
+            ;;
+
+        draft)
+            # Roll back to change package state (clean up staging layer)
+            if [[ -d "$staged_dir" ]]; then
+                if [[ "$dry_run" == true ]]; then
+                    log_info "[DRY-RUN] Would delete: ${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 the spec delta from a change package to the staging layer.
+#
+# Usage:
+#   ./spec-stage.sh <change-id> [options]
+#   ./spec-stage.sh --help
+#
+# Exit codes:
+#   0 - Staging successful
+#   1 - Staging failed (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 directory
+  --change-root DIR   Change package directory
+  --truth-root DIR    Truth source directory
+  --dry-run           Simulate run, do not actually modify files
+  --force             Force staging, ignore conflicts
+  --help, -h          Show help
+
+Exit codes:
+  0 - Staging successful
+  1 - Staging failed
+  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 package: ${change_id}"
+
+    if [[ ! -d "$specs_delta_dir" ]]; then
+        log_info "No spec delta, skipping staging"
+        exit 0
+    fi
+
+    # Call 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 exist, use --force to force staging"
+            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
+#
+# Aggregate AC-001 ~ AC-022 verification results
+
+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 each verification script
+echo -e "${YELLOW}>>> OpenSpec Cleanup 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 Results                  ║${NC}"
+echo -e "${CYAN}╚════════════════════════════════════════════════╝${NC}"
+echo ""
+
+if [[ $openspec_result -eq 1 ]]; then
+    echo -e "${GREEN}✅ OpenSpec Cleanup Verification${NC}"
+else
+    echo -e "${RED}❌ OpenSpec Cleanup 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 verifications passed! DevBooks independence verification successful.${NC}"
+    exit 0
+else
+    echo -e "${RED}Some verifications failed, please check the output above.${NC}"
+    exit 1
+fi