its-magic 0.1.2-27 → 0.1.2-28

package/installer.ps1

@@ -111,7 +111,7 @@ function Choose-Mode {
 function Classify-File($RelPath) {
   $normalized = $RelPath -replace '\\','/'
 
-  $mixedFiles = @('.cursor/scratchpad.md')
+  $mixedFiles = @('.cursor/scratchpad.md', 'README.md')
   if ($mixedFiles -contains $normalized) { return 'mixed' }
 
   $frameworkPrefixes = @(
@@ -174,6 +174,15 @@ function Write-InstalledVersion($TargetRoot, $Ver) {
   }
 }
 
+function Sync-RootReadmeToItsMagic($TargetRoot) {
+  $rootReadme = Join-Path $TargetRoot "README.md"
+  if (-not (Test-Path $rootReadme -PathType Leaf)) { return $false }
+  $itsMagicReadme = Join-Path $TargetRoot "its_magic\README.md"
+  Ensure-Parent $itsMagicReadme
+  Copy-Item -Path $rootReadme -Destination $itsMagicReadme -Force
+  return $true
+}
+
 function Read-RunbookKeyValue($RunbookPath, $Key) {
   if (-not (Test-Path $RunbookPath -PathType Leaf)) { return "" }
   $needle = "${Key}:"
@@ -617,6 +626,7 @@ if ($mode -eq "upgrade") {
   }
 
   Write-InstalledVersion $targetRoot $appVersion
+  Sync-RootReadmeToItsMagic $targetRoot | Out-Null
   $runbookBootstrap = Invoke-RunbookBootstrap -TargetRoot $targetRoot
   foreach ($note in $runbookBootstrap.notes) { Write-Host $note }
   if (-not $runbookBootstrap.ok) { exit 1 }
@@ -694,6 +704,7 @@ foreach ($rel in $files) {
 }
 
 Write-InstalledVersion $targetRoot $appVersion
+Sync-RootReadmeToItsMagic $targetRoot | Out-Null
 $runbookBootstrap = Invoke-RunbookBootstrap -TargetRoot $targetRoot
 foreach ($note in $runbookBootstrap.notes) { Write-Host $note }
 if (-not $runbookBootstrap.ok) { exit 1 }

package/installer.py

@@ -119,7 +119,7 @@ USER_DATA_PREFIXES = (
     "docs/product/", "docs/engineering/", "docs/user-guides/",
     "sprints/", "handoffs/", "decisions/",
 )
-MIXED_FILES = {".cursor/scratchpad.md"}
+MIXED_FILES = {".cursor/scratchpad.md", "README.md"}
 
 
 def classify_file(rel_path):
@@ -159,6 +159,16 @@ def write_installed_version(target_root, ver):
         os.remove(legacy)
 
 
+def sync_root_readme_to_its_magic(target_root):
+    root_readme = os.path.join(target_root, "README.md")
+    if not os.path.isfile(root_readme):
+        return False
+    its_magic_readme = os.path.join(target_root, "its_magic", "README.md")
+    ensure_parent(its_magic_readme)
+    shutil.copy2(root_readme, its_magic_readme)
+    return True
+
+
 def read_runbook_key(runbook_path, key):
     if not os.path.isfile(runbook_path):
         return ""
@@ -550,6 +560,7 @@ def main():
                 continue
 
         write_installed_version(target_root, version)
+        sync_root_readme_to_its_magic(target_root)
         runbook_ok, runbook_notes = bootstrap_runbook_commands(target_root)
         for note in runbook_notes:
             print(note)
@@ -620,6 +631,7 @@ def main():
                 shutil.copy2(src, dst)
 
     write_installed_version(target_root, version)
+    sync_root_readme_to_its_magic(target_root)
     runbook_ok, runbook_notes = bootstrap_runbook_commands(target_root)
     for note in runbook_notes:
         print(note)

package/installer.sh

@@ -133,7 +133,7 @@ choose_mode() {
 classify_file() {
   rel="$1"
   case "$rel" in
-    .cursor/scratchpad.md) echo "mixed" ;;
+    .cursor/scratchpad.md|README.md) echo "mixed" ;;
     .cursor/commands/*|.cursor/rules/*|.cursor/agents/*|.cursor/skills/*) echo "framework" ;;
     .cursor/hooks/*|.cursor/hooks.json|.cursor/scratchpad.local.example.md) echo "framework" ;;
     .github/workflows/*|scripts/validate-and-push*|docs/engineering/context/*|its_magic/*) echo "framework" ;;
@@ -166,6 +166,15 @@ write_installed_version() {
   [ -f "$legacy" ] && rm -f "$legacy"
 }
 
+sync_root_readme_to_its_magic() {
+  target_root="$1"
+  [ -f "$target_root/README.md" ] || return 1
+  dst="$target_root/its_magic/README.md"
+  ensure_parent "$dst"
+  cp -p "$target_root/README.md" "$dst"
+  return 0
+}
+
 read_runbook_key() {
   runbook_path="$1"
   key="$2"
@@ -505,6 +514,7 @@ if [ "$MODE" = "upgrade" ]; then
   done
 
   write_installed_version "$TARGET_ROOT" "$APP_VERSION"
+  sync_root_readme_to_its_magic "$TARGET_ROOT" || true
   bootstrap_runbook_commands "$TARGET_ROOT"
   [ -n "$BOOTSTRAP_NOTES" ] && printf "%s" "$BOOTSTRAP_NOTES"
   [ "$BOOTSTRAP_OK" = "true" ] || exit 1
@@ -572,6 +582,7 @@ for rel in $FILES; do
 done
 
 write_installed_version "$TARGET_ROOT" "$APP_VERSION"
+sync_root_readme_to_its_magic "$TARGET_ROOT" || true
 bootstrap_runbook_commands "$TARGET_ROOT"
 [ -n "$BOOTSTRAP_NOTES" ] && printf "%s" "$BOOTSTRAP_NOTES"
 [ "$BOOTSTRAP_OK" = "true" ] || exit 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "its-magic",
-  "version": "0.1.2-27",
+  "version": "0.1.2-28",
   "description": "its-magic - AI dev team workflow for Cursor.",
   "license": "MIT",
   "bin": {

package/template/docs/engineering/context/installer-owned-paths.manifest

@@ -17,6 +17,7 @@ decisions
 scripts/validate-and-push.ps1
 scripts/validate-and-push.sh
 .github/workflows
+README.md
 its_magic
 
 [clean_paths]