its-magic 0.1.2-10

package/handoffs/release_notes.md

@@ -0,0 +1,14 @@
+# Release Notes
+
+## Summary
+- ...
+
+## Changes
+- ...
+
+## Known issues
+- ...
+
+## Deploy steps
+- ...
+

package/handoffs/resume_brief.md

@@ -0,0 +1,8 @@
+# Resume Brief
+
+## Current status
+- ...
+
+## Next actions
+- ...
+

package/handoffs/tl_to_dev.md

@@ -0,0 +1,7 @@
+# TL -> Dev Handoff
+
+## Summary
+- ...
+
+## Tasks
+- ...

package/installer.ps1

@@ -0,0 +1,189 @@
+Param(
+  [string]$Target,
+  [ValidateSet("missing","overwrite","interactive")]
+  [string]$Mode,
+  [switch]$Backup,
+  [switch]$Create
+)
+
+$ErrorActionPreference = "Stop"
+
+function Normalize-PathSafe($Path) {
+  return [System.IO.Path]::GetFullPath($Path)
+}
+
+function Ensure-Parent($Path) {
+  $parent = Split-Path -Parent $Path
+  if ($parent -and -not (Test-Path $parent)) {
+    New-Item -ItemType Directory -Path $parent -Force | Out-Null
+  }
+}
+
+function List-SourceFiles($SourceRoot, $IncludePaths) {
+  $files = New-Object System.Collections.Generic.List[string]
+  foreach ($rel in $IncludePaths) {
+    $src = Join-Path $SourceRoot $rel
+    if (Test-Path $src -PathType Leaf) {
+      $files.Add($rel)
+    } elseif (Test-Path $src -PathType Container) {
+      Get-ChildItem -Path $src -Recurse -File | ForEach-Object {
+        $relPath = $_.FullName.Substring($SourceRoot.Length).TrimStart("\","/")
+        $files.Add($relPath)
+      }
+    }
+  }
+  return $files | Select-Object -Unique | Sort-Object
+}
+
+function Backup-Files($TargetRoot, $RelPaths) {
+  $timestamp = (Get-Date).ToUniversalTime().ToString("yyyyMMdd-HHmmssZ")
+  $backupRoot = Join-Path $TargetRoot ("backups\" + $timestamp)
+  foreach ($rel in $RelPaths) {
+    $src = Join-Path $TargetRoot $rel
+    if (Test-Path $src -PathType Leaf) {
+      $dst = Join-Path $backupRoot $rel
+      Ensure-Parent $dst
+      Copy-Item -Path $src -Destination $dst -Force
+    }
+  }
+  return $backupRoot
+}
+
+function Choose-Mode {
+  Write-Host "Select install mode:"
+  Write-Host "1) missing-only (copy only files that do not exist)"
+  Write-Host "2) overwrite-all (replace existing files)"
+  Write-Host "3) interactive (prompt per file)"
+  $choice = Read-Host "Enter 1, 2, or 3"
+  switch ($choice) {
+    "1" { return "missing" }
+    "2" { return "overwrite" }
+    Default { return "interactive" }
+  }
+}
+
+function Prompt-YesNo($Label, $Default = $false) {
+  $suffix = if ($Default) { "Y/n" } else { "y/N" }
+  $value = (Read-Host "$Label [$suffix]").ToLowerInvariant()
+  if ([string]::IsNullOrWhiteSpace($value)) { return $Default }
+  return @("y","yes") -contains $value
+}
+
+$sourceRoot = Normalize-PathSafe (Split-Path -Parent $MyInvocation.MyCommand.Path)
+if (-not $Target) {
+  $Target = Read-Host "Target repository path"
+}
+$targetRoot = Normalize-PathSafe $Target
+
+if (-not (Test-Path $targetRoot -PathType Container)) {
+  if ($Create -or (Prompt-YesNo "Target missing. Create?" $false)) {
+    New-Item -ItemType Directory -Path $targetRoot -Force | Out-Null
+  } else {
+    Write-Host "Target directory does not exist."
+    exit 1
+  }
+}
+
+$mode = if ($Mode) { $Mode } else { Choose-Mode }
+$backupEnabled = $Backup.IsPresent
+if (($mode -eq "overwrite" -or $mode -eq "interactive") -and -not $backupEnabled) {
+  $backupEnabled = Prompt-YesNo "Backup existing files before overwrite?" $false
+}
+
+$includePaths = @(
+  ".cursor/commands",
+  ".cursor/rules",
+  ".cursor/skills",
+  ".cursor/agents",
+  ".cursor/hooks",
+  ".cursor/hooks.json",
+  ".cursor/scratchpad.md",
+  "docs",
+  "sprints",
+  "handoffs",
+  "decisions",
+  ".github/workflows",
+  "README.md",
+  "installer.py",
+  "installer.ps1",
+  "installer.sh"
+)
+
+$files = List-SourceFiles $sourceRoot $includePaths
+if ($files.Count -eq 0) {
+  Write-Host "No source files found to install."
+  exit 1
+}
+
+if ($backupEnabled -and $mode -eq "overwrite") {
+  $overwriteCandidates = @()
+  foreach ($rel in $files) {
+    $dst = Join-Path $targetRoot $rel
+    if (Test-Path $dst -PathType Leaf) { $overwriteCandidates += $rel }
+  }
+  if ($overwriteCandidates.Count -gt 0) {
+    $backupRoot = Backup-Files $targetRoot $overwriteCandidates
+    Write-Host "Backup created at: $backupRoot"
+  }
+}
+
+foreach ($rel in $files) {
+  $src = Join-Path $sourceRoot $rel
+  $dst = Join-Path $targetRoot $rel
+  $exists = Test-Path $dst -PathType Leaf
+
+  if ($mode -eq "missing") {
+    if ($exists) { continue }
+    Ensure-Parent $dst
+    Copy-Item -Path $src -Destination $dst -Force
+    continue
+  }
+
+  if ($mode -eq "overwrite") {
+    Ensure-Parent $dst
+    Copy-Item -Path $src -Destination $dst -Force
+    continue
+  }
+
+  if ($mode -eq "interactive") {
+    if (-not $exists) {
+      Ensure-Parent $dst
+      Copy-Item -Path $src -Destination $dst -Force
+      continue
+    }
+    $answer = (Read-Host "File exists: $rel | [o]verwrite [s]kip [q]uit").ToLowerInvariant()
+    if ($answer -eq "q") {
+      Write-Host "Aborted."
+      exit 1
+    }
+    if ($answer -eq "o") {
+      if ($backupEnabled) {
+        $backupRoot = Backup-Files $targetRoot @($rel)
+        Write-Host "Backed up: $rel -> $backupRoot"
+      }
+      Ensure-Parent $dst
+      Copy-Item -Path $src -Destination $dst -Force
+    }
+  }
+}
+
+function Show-ItsMagicBanner {
+    $prev = [Console]::OutputEncoding
+    [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+    Write-Host ""
+    Write-Host "  ██╗████████╗███████╗      ███╗   ███╗ █████╗  ██████╗ ██╗ ██████╗" -ForegroundColor Magenta
+    Write-Host "  ██║╚══██╔══╝██╔════╝      ████╗ ████║██╔══██╗██╔════╝ ██║██╔════╝" -ForegroundColor Magenta
+    Write-Host "  ██║   ██║   ███████╗█████╗██╔████╔██║███████║██║  ███╗██║██║     " -ForegroundColor Magenta
+    Write-Host "  ██║   ██║   ╚════██║╚════╝██║╚██╔╝██║██╔══██║██║   ██║██║██║     " -ForegroundColor Cyan
+    Write-Host "  ██║   ██║   ███████║      ██║ ╚═╝ ██║██║  ██║╚██████╔╝██║╚██████╗" -ForegroundColor Cyan
+    Write-Host "  ╚═╝   ╚═╝   ╚══════╝      ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝ ╚═════╝" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "                         AI dev team" -ForegroundColor Yellow
+    Write-Host "                    Installation complete!" -ForegroundColor Green
+    Write-Host ""
+    [Console]::OutputEncoding = $prev
+}
+
+Show-ItsMagicBanner
+exit 0
+

package/installer.py

@@ -0,0 +1,195 @@
+import argparse
+import os
+import shutil
+import sys
+from datetime import datetime
+
+
+def normalize(path):
+    return os.path.normpath(os.path.abspath(path))
+
+
+def list_source_files(source_root, include_paths):
+    files = []
+    for rel in include_paths:
+        src = os.path.join(source_root, rel)
+        if os.path.isfile(src):
+            files.append(rel)
+        elif os.path.isdir(src):
+            for root, _, filenames in os.walk(src):
+                for name in filenames:
+                    full = os.path.join(root, name)
+                    rel_path = os.path.relpath(full, source_root)
+                    files.append(rel_path)
+    return sorted(set(files))
+
+
+def ensure_parent(path):
+    parent = os.path.dirname(path)
+    if parent and not os.path.isdir(parent):
+        os.makedirs(parent, exist_ok=True)
+
+
+def backup_files(target_root, rel_paths):
+    timestamp = datetime.utcnow().strftime("%Y%m%d-%H%M%SZ")
+    backup_root = os.path.join(target_root, "backups", timestamp)
+    for rel in rel_paths:
+        src = os.path.join(target_root, rel)
+        if os.path.isfile(src):
+            dst = os.path.join(backup_root, rel)
+            ensure_parent(dst)
+            shutil.copy2(src, dst)
+    return backup_root
+
+
+def choose_mode():
+    print("Select install mode:")
+    print("1) missing-only (copy only files that do not exist)")
+    print("2) overwrite-all (replace existing files)")
+    print("3) interactive (prompt per file)")
+    choice = input("Enter 1, 2, or 3: ").strip()
+    if choice == "1":
+        return "missing"
+    if choice == "2":
+        return "overwrite"
+    return "interactive"
+
+
+def prompt_yes_no(label, default=False):
+    suffix = "Y/n" if default else "y/N"
+    value = input(f"{label} [{suffix}]: ").strip().lower()
+    if not value:
+        return default
+    return value in ("y", "yes")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Install its-magic into a repo")
+    parser.add_argument("--target", help="Target repository path")
+    parser.add_argument(
+        "--mode",
+        choices=["missing", "overwrite", "interactive"],
+        help="Install mode",
+    )
+    parser.add_argument(
+        "--backup",
+        action="store_true",
+        help="Backup files before overwriting",
+    )
+    parser.add_argument(
+        "--create",
+        action="store_true",
+        help="Create target directory if missing",
+    )
+    args = parser.parse_args()
+
+    source_root = normalize(os.path.dirname(__file__))
+    target_root = normalize(args.target) if args.target else None
+
+    if not target_root:
+        target_root = normalize(input("Target repository path: ").strip())
+
+    if not os.path.isdir(target_root):
+        if args.create or prompt_yes_no("Target missing. Create?", default=False):
+            os.makedirs(target_root, exist_ok=True)
+        else:
+            print("Target directory does not exist.")
+            return 1
+
+    mode = args.mode or choose_mode()
+    backup_enabled = args.backup
+    if mode in ("overwrite", "interactive") and not args.backup:
+        backup_enabled = prompt_yes_no("Backup existing files before overwrite?", False)
+
+    include_paths = [
+        ".cursor/commands",
+        ".cursor/rules",
+        ".cursor/skills",
+        ".cursor/agents",
+        ".cursor/hooks",
+        ".cursor/hooks.json",
+        ".cursor/scratchpad.md",
+        "docs",
+        "sprints",
+        "handoffs",
+        "decisions",
+        ".github/workflows",
+        "README.md",
+        "installer.py",
+    ]
+
+    files = list_source_files(source_root, include_paths)
+    if not files:
+        print("No source files found to install.")
+        return 1
+
+    overwrite_candidates = []
+    if backup_enabled and mode == "overwrite":
+        for rel in files:
+            if os.path.isfile(os.path.join(target_root, rel)):
+                overwrite_candidates.append(rel)
+        if overwrite_candidates:
+            backup_root = backup_files(target_root, overwrite_candidates)
+            print(f"Backup created at: {backup_root}")
+
+    for rel in files:
+        src = os.path.join(source_root, rel)
+        dst = os.path.join(target_root, rel)
+        exists = os.path.isfile(dst)
+
+        if mode == "missing":
+            if exists:
+                continue
+            ensure_parent(dst)
+            shutil.copy2(src, dst)
+            continue
+
+        if mode == "overwrite":
+            ensure_parent(dst)
+            shutil.copy2(src, dst)
+            continue
+
+        if mode == "interactive":
+            if not exists:
+                ensure_parent(dst)
+                shutil.copy2(src, dst)
+                continue
+            answer = input(f"File exists: {rel} | [o]verwrite [s]kip [q]uit: ").strip().lower()
+            if answer == "q":
+                print("Aborted.")
+                return 1
+            if answer == "o":
+                if backup_enabled:
+                    backup_root = backup_files(target_root, [rel])
+                    print(f"Backed up: {rel} -> {backup_root}")
+                ensure_parent(dst)
+                shutil.copy2(src, dst)
+            else:
+                continue
+
+    show_banner()
+    return 0
+
+
+def show_banner():
+    M = "\033[1;35m"
+    C = "\033[1;36m"
+    Y = "\033[1;33m"
+    G = "\033[1;32m"
+    R = "\033[0m"
+    print()
+    print(f"{M}  ██╗████████╗███████╗      ███╗   ███╗ █████╗  ██████╗ ██╗ ██████╗{R}")
+    print(f"{M}  ██║╚══██╔══╝██╔════╝      ████╗ ████║██╔══██╗██╔════╝ ██║██╔════╝{R}")
+    print(f"{M}  ██║   ██║   ███████╗█████╗██╔████╔██║███████║██║  ███╗██║██║     {R}")
+    print(f"{C}  ██║   ██║   ╚════██║╚════╝██║╚██╔╝██║██╔══██║██║   ██║██║██║     {R}")
+    print(f"{C}  ██║   ██║   ███████║      ██║ ╚═╝ ██║██║  ██║╚██████╔╝██║╚██████╗{R}")
+    print(f"{C}  ╚═╝   ╚═╝   ╚══════╝      ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝ ╚═════╝{R}")
+    print()
+    print(f"{Y}                         AI dev team{R}")
+    print(f"{G}                    Installation complete!{R}")
+    print()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())
+

package/installer.sh

@@ -0,0 +1,201 @@
+#!/usr/bin/env sh
+set -e
+
+
+ensure_parent() {
+  dir=$(dirname "$1")
+  [ -d "$dir" ] || mkdir -p "$dir"
+}
+
+list_source_files() {
+  source_root="$1"
+  shift
+  for rel in "$@"; do
+    src="$source_root/$rel"
+    if [ -f "$src" ]; then
+      echo "$rel"
+    elif [ -d "$src" ]; then
+      find "$src" -type f | sed "s|^$source_root/||"
+    fi
+  done | sort -u
+}
+
+backup_files() {
+  target_root="$1"
+  shift
+  timestamp=$(date -u +"%Y%m%d-%H%M%SZ")
+  backup_root="$target_root/backups/$timestamp"
+  for rel in "$@"; do
+    src="$target_root/$rel"
+    if [ -f "$src" ]; then
+      dst="$backup_root/$rel"
+      ensure_parent "$dst"
+      cp -p "$src" "$dst"
+    fi
+  done
+  echo "$backup_root"
+}
+
+choose_mode() {
+  printf "%s\n" "Select install mode:"
+  printf "%s\n" "1) missing-only (copy only files that do not exist)"
+  printf "%s\n" "2) overwrite-all (replace existing files)"
+  printf "%s\n" "3) interactive (prompt per file)"
+  printf "%s" "Enter 1, 2, or 3: "
+  read -r choice
+  case "$choice" in
+    1) echo "missing" ;;
+    2) echo "overwrite" ;;
+    *) echo "interactive" ;;
+  esac
+}
+
+prompt_yes_no() {
+  label="$1"
+  default="$2"
+  suffix="y/N"
+  [ "$default" = "true" ] && suffix="Y/n"
+  printf "%s [%s]: " "$label" "$suffix"
+  read -r value
+  value=$(printf "%s" "$value" | tr 'A-Z' 'a-z')
+  if [ -z "$value" ]; then
+    [ "$default" = "true" ] && return 0 || return 1
+  fi
+  [ "$value" = "y" ] || [ "$value" = "yes" ]
+}
+
+TARGET=""
+MODE=""
+BACKUP="false"
+CREATE="false"
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --target) TARGET="$2"; shift 2 ;;
+    --mode) MODE="$2"; shift 2 ;;
+    --backup) BACKUP="true"; shift 1 ;;
+    --create) CREATE="true"; shift 1 ;;
+    *) shift 1 ;;
+  esac
+done
+
+SOURCE_ROOT=$(cd "$(dirname "$0")" && pwd)
+
+if [ -z "$TARGET" ]; then
+  printf "%s" "Target repository path: "
+  read -r TARGET
+fi
+
+if [ ! -d "$TARGET" ]; then
+  if [ "$CREATE" = "true" ] || prompt_yes_no "Target missing. Create?" "false"; then
+    mkdir -p "$TARGET"
+  else
+    printf "%s\n" "Target directory does not exist."
+    exit 1
+  fi
+fi
+TARGET_ROOT=$(cd "$TARGET" && pwd)
+
+if [ -z "$MODE" ]; then
+  MODE=$(choose_mode)
+fi
+
+if [ "$MODE" = "overwrite" ] || [ "$MODE" = "interactive" ]; then
+  if [ "$BACKUP" = "false" ]; then
+    if prompt_yes_no "Backup existing files before overwrite?" "false"; then
+      BACKUP="true"
+    fi
+  fi
+fi
+
+INCLUDE_PATHS="
+.cursor/commands
+.cursor/rules
+.cursor/skills
+.cursor/agents
+.cursor/hooks
+.cursor/hooks.json
+.cursor/scratchpad.md
+docs
+sprints
+handoffs
+decisions
+.github/workflows
+README.md
+installer.py
+installer.ps1
+installer.sh
+"
+
+FILES=$(list_source_files "$SOURCE_ROOT" $INCLUDE_PATHS)
+if [ -z "$FILES" ]; then
+  printf "%s\n" "No source files found to install."
+  exit 1
+fi
+
+if [ "$BACKUP" = "true" ] && [ "$MODE" = "overwrite" ]; then
+  overwrite_candidates=""
+  for rel in $FILES; do
+    [ -f "$TARGET_ROOT/$rel" ] && overwrite_candidates="$overwrite_candidates $rel"
+  done
+  if [ -n "$overwrite_candidates" ]; then
+    backup_root=$(backup_files "$TARGET_ROOT" $overwrite_candidates)
+    printf "%s\n" "Backup created at: $backup_root"
+  fi
+fi
+
+for rel in $FILES; do
+  src="$SOURCE_ROOT/$rel"
+  dst="$TARGET_ROOT/$rel"
+  if [ "$MODE" = "missing" ]; then
+    [ -f "$dst" ] && continue
+    ensure_parent "$dst"
+    cp -p "$src" "$dst"
+    continue
+  fi
+  if [ "$MODE" = "overwrite" ]; then
+    ensure_parent "$dst"
+    cp -p "$src" "$dst"
+    continue
+  fi
+  if [ "$MODE" = "interactive" ]; then
+    if [ ! -f "$dst" ]; then
+      ensure_parent "$dst"
+      cp -p "$src" "$dst"
+      continue
+    fi
+    printf "%s" "File exists: $rel | [o]verwrite [s]kip [q]uit: "
+    read -r answer
+    answer=$(printf "%s" "$answer" | tr 'A-Z' 'a-z')
+    if [ "$answer" = "q" ]; then
+      printf "%s\n" "Aborted."
+      exit 1
+    fi
+    if [ "$answer" = "o" ]; then
+      if [ "$BACKUP" = "true" ]; then
+        backup_root=$(backup_files "$TARGET_ROOT" "$rel")
+        printf "%s\n" "Backed up: $rel -> $backup_root"
+      fi
+      ensure_parent "$dst"
+      cp -p "$src" "$dst"
+    fi
+  fi
+done
+
+show_banner() {
+    printf "\n"
+    printf "\033[1;35m  ██╗████████╗███████╗      ███╗   ███╗ █████╗  ██████╗ ██╗ ██████╗\033[0m\n"
+    printf "\033[1;35m  ██║╚══██╔══╝██╔════╝      ████╗ ████║██╔══██╗██╔════╝ ██║██╔════╝\033[0m\n"
+    printf "\033[1;35m  ██║   ██║   ███████╗█████╗██╔████╔██║███████║██║  ███╗██║██║     \033[0m\n"
+    printf "\033[1;36m  ██║   ██║   ╚════██║╚════╝██║╚██╔╝██║██╔══██║██║   ██║██║██║     \033[0m\n"
+    printf "\033[1;36m  ██║   ██║   ███████║      ██║ ╚═╝ ██║██║  ██║╚██████╔╝██║╚██████╗\033[0m\n"
+    printf "\033[1;36m  ╚═╝   ╚═╝   ╚══════╝      ╚═╝     ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝ ╚═════╝\033[0m\n"
+    printf "\n"
+    printf "\033[1;33m                         AI dev team\033[0m\n"
+    printf "\033[1;32m                    Installation complete!\033[0m\n"
+    printf "\n"
+}
+
+show_banner
+exit 0
+

package/milestones/M0001/milestone.json

@@ -0,0 +1,7 @@
+{
+  "id": "M0001",
+  "name": "",
+  "goal": "",
+  "scope": [],
+  "status": "active"
+}

package/milestones/M0001/phases.json

@@ -0,0 +1,9 @@
+{
+  "milestone": "M0001",
+  "phases": [
+    {
+      "name": "intake",
+      "status": "pending"
+    }
+  ]
+}

package/milestones/M0001/progress.md

@@ -0,0 +1,3 @@
+# Milestone Progress
+
+- ...

package/milestones/M0001/summary.md

@@ -0,0 +1,3 @@
+# Milestone Summary
+
+- ...

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "its-magic",
+  "version": "0.1.2-10",
+  "description": "its-magic - AI dev team workflow for Cursor.",
+  "license": "MIT",
+  "bin": {
+    "its-magic": "bin/its-magic.js"
+  },
+  "files": [
+    ".cursor/",
+    ".github/",
+    "decisions/",
+    "docs/",
+    "handoffs/",
+    "milestones/",
+    "scripts/",
+    "sprints/",
+    "installer.ps1",
+    "installer.sh",
+    "installer.py",
+    "README.md",
+    "bin/its-magic.js"
+  ],
+  "scripts": {
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish",
+    "release:all": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1",
+    "release:all:patch": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -Bump patch",
+    "release:all:minor": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -Bump minor",
+    "release:all:major": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -Bump major",
+    "release:all:beta": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -Bump prerelease -NpmTag beta",
+    "release:all:dry": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -DryRun",
+    "release:npm-only": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -SkipChoco -SkipBrew",
+    "release:choco-only": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -SkipNpm -SkipBrew",
+    "release:brew-only": "powershell -ExecutionPolicy Bypass -File scripts/release-all.ps1 -SkipNpm -SkipChoco"
+  }
+}