its-magic 0.1.2-9 → 0.1.2

package/gsd-installer.py

@@ -1,195 +0,0 @@
-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, "gsd-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 GSD toolkit 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",
-        "gsd-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/gsd-installer.sh

@@ -1,201 +0,0 @@
-#!/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/gsd-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
-gsd-installer.py
-gsd-installer.ps1
-gsd-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/handoffs/release_notes.md

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

package/handoffs/resume_brief.md

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

package/milestones/M0001/milestone.json

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

package/milestones/M0001/phases.json

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

package/milestones/M0001/progress.md

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

package/milestones/M0001/summary.md

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

package/scripts/generate-release-notes.ps1

@@ -1,74 +0,0 @@
-Param(
-  [string]$RepoRoot,
-  [string]$Version = "v0.0.0",
-  [string]$Sprint = "S0001"
-)
-
-$ErrorActionPreference = "Stop"
-
-function Resolve-RepoRoot {
-  if ($RepoRoot) { return (Resolve-Path $RepoRoot).Path }
-  return (Resolve-Path (Join-Path $PSScriptRoot "..")).Path
-}
-
-function Read-IfExists($Path) {
-  if (Test-Path $Path -PathType Leaf) {
-    return Get-Content -Path $Path -Raw
-  }
-  return ""
-}
-
-$root = Resolve-RepoRoot
-$summaryPath = Join-Path $root "sprints\$Sprint\summary.md"
-$qaPath = Join-Path $root "sprints\$Sprint\qa-findings.md"
-$runbookPath = Join-Path $root "docs\engineering\runbook.md"
-$outPath = Join-Path $root "handoffs\release_notes.md"
-
-$summary = Read-IfExists $summaryPath
-$qa = Read-IfExists $qaPath
-$runbook = Read-IfExists $runbookPath
-
-$gitChanges = ""
-if (Get-Command git -ErrorAction SilentlyContinue) {
-  try {
-    $isRepo = git -C $root rev-parse --is-inside-work-tree 2>$null
-    if ($isRepo -eq "true") {
-      $gitChanges = git -C $root log -n 20 --pretty=format:"- %s"
-    }
-  } catch {}
-}
-
-$timestamp = (Get-Date).ToString("yyyy-MM-dd")
-
-@"
-# Release Notes — $Version
-
-**Sprint:** $Sprint
-**Date:** $timestamp
-
----
-
-## Summary
-
-${summary.Trim()}
-
----
-
-## Changes (last 20 commits)
-
-${gitChanges.Trim()}
-
----
-
-## QA Findings (from sprint)
-
-${qa.Trim()}
-
----
-
-## Runbook Notes
-
-${runbook.Trim()}
-"@ | Set-Content -Path $outPath
-
-Write-Host "Release notes written to: $outPath"

package/scripts/generate-release-notes.sh

@@ -1,63 +0,0 @@
-#!/usr/bin/env sh
-set -e
-
-ROOT="${1:-$(cd "$(dirname "$0")/.." && pwd)}"
-VERSION="${2:-v0.0.0}"
-SPRINT="${3:-S0001}"
-
-SUMMARY_PATH="$ROOT/sprints/$SPRINT/summary.md"
-QA_PATH="$ROOT/sprints/$SPRINT/qa-findings.md"
-RUNBOOK_PATH="$ROOT/docs/engineering/runbook.md"
-OUT_PATH="$ROOT/handoffs/release_notes.md"
-
-read_if_exists() {
-  if [ -f "$1" ]; then
-    cat "$1"
-  fi
-}
-
-summary="$(read_if_exists "$SUMMARY_PATH")"
-qa="$(read_if_exists "$QA_PATH")"
-runbook="$(read_if_exists "$RUNBOOK_PATH")"
-
-git_changes=""
-if command -v git >/dev/null 2>&1; then
-  if git -C "$ROOT" rev-parse --is-inside-work-tree >/dev/null 2>&1; then
-    git_changes="$(git -C "$ROOT" log -n 20 --pretty=format:"- %s")"
-  fi
-fi
-
-timestamp="$(date +"%Y-%m-%d")"
-
-cat > "$OUT_PATH" <<EOF
-# Release Notes — $VERSION
-
-**Sprint:** $SPRINT
-**Date:** $timestamp
-
----
-
-## Summary
-
-$summary
-
----
-
-## Changes (last 20 commits)
-
-$git_changes
-
----
-
-## QA Findings (from sprint)
-
-$qa
-
----
-
-## Runbook Notes
-
-$runbook
-EOF
-
-echo "Release notes written to: $OUT_PATH"