shadow-git 0.1.0 → 1.0.2

package/.claude/settings.local.json

@@ -33,7 +33,11 @@
       "Bash(complete -p)",
       "Bash(pkg-config --variable=completionsdir bash-completion)",
       "Bash(dpkg -l bash-completion)",
-      "Bash(git diff:*)"
+      "Bash(git diff:*)",
+      "Bash(git --git-dir=.sgit --work-tree=. diff --cached --name-only)",
+      "Bash(git --git-dir=.sgit --work-tree=. reset HEAD temp/shouldnt-track)",
+      "Bash(git --git-dir=.sgit --work-tree=. add .)",
+      "Bash(git stash:*)"
     ]
   }
 }

package/.temp/.sgit/info/exclude

@@ -1,11 +1,20 @@
-# Exclude everything by default
+# sgit-managed
 *
-
-# .sgit.json (always tracked)
 !.sgit.json
-
-# temp.md
 !temp.md
-
-# README.md
 !README.md
+!temp/
+temp/*
+!temp/should-track
+!temp2/
+!temp2/**
+!test/
+test/*
+!test/1
+!rec1/
+rec1/*
+!rec1/rec2/
+rec1/rec2/*
+!rec1/rec2/test
+.gitignore-sgit.bat
+# end: sgit-managed

package/.temp/.sgit.json

@@ -1,6 +1,10 @@
 {
   "paths": [
     "temp.md",
-    "README.md"
+    "README.md",
+    "temp/should-track",
+    "temp2/",
+    "test/1",
+    "rec1/rec2/test"
   ]
-}
+}

package/.temp/README.md

@@ -1,3 +0,0 @@
-# Demo Project
-
-A sample project for testing.

package/CLAUDE.md

@@ -12,6 +12,8 @@ npm run dev      # Build in watch mode
 
 After building, the global `sgit` command uses `dist/cli.js`. Rebuild after source changes to test CLI manually.
 
+Always run `npm run lint` after making changes to verify the code type-checks.
+
 ## Architecture
 
 ```
@@ -19,6 +21,9 @@ src/
   cli.ts                    # Entry point, routes to track commands or git passthrough
   commands/
     forward.ts              # Forwards non-track commands to shadow git
+    debug/
+      index.ts              # Commander registration for hidden debug subcommands
+      gitignores.ts         # Disable .gitignore files for 10s then re-enable
     track/
       index.ts              # Commander registration for all track subcommands
       init.ts               # Initialize .sgit/ repo
@@ -37,6 +42,7 @@ src/
     exclude.ts              # Generate .git/info/exclude and .sgit/info/exclude
     hooks.ts                # Install/uninstall pre-commit hooks
     errors.ts               # Custom error classes (SgitError hierarchy)
+    gitignore.ts            # Disable/enable .gitignore files during sgit operations
   utils/
     logger.ts               # Color-coded stdout/stderr logging
     process.ts              # Child process execution
@@ -45,7 +51,9 @@ src/
 ## Key Conventions
 
 - All paths in `.sgit.json` use forward slashes, relative to repo root
-- Directories are stored with trailing `/` (e.g., `docs/.internal/`)
-- The `.git/info/exclude` sgit section uses `# sgit` marker comments on their own line (not inline) above each entry
+- Directories are stored with trailing `/` (e.g., `docs/.internal/`) and track all contents recursively
+- Exclude files use block markers: `# sgit-managed` and `# end: sgit-managed` — everything between is replaced on sync
 - Shadow repo exclude uses a deny-all + allow-list pattern (`*` then `!path`)
 - Error classes extend `SgitError`; the CLI catches these and prints the message
+- Hidden `debug` commands (`sgit debug <cmd>`) are registered with `{ hidden: true }` so they don't appear in `sgit --help`. They are only visible via `sgit debug --help`. Debug commands manage their own gitignore guard (the CLI-level guard is skipped for them). No tests are written for debug commands.
+- **HARD RULE — gitignore revert guarantee:** `.gitignore` files inside sgit-tracked directories are temporarily renamed to `.gitignore-sgit.bat` during sgit command execution (via `setupGitignoreGuard` in `src/core/gitignore.ts`). **The rename MUST always be reverted** when the command ends — whether it succeeds, fails, is cancelled (Ctrl+C), or receives SIGTERM. The guard uses `try/finally`, signal handlers, and `process.on('exit')` to ensure this. Any new code that executes sgit operations must use the guard or equivalent cleanup guarantees. Pre-commit hooks verify no `.gitignore-sgit.bat` files exist at commit time.

package/README.md

@@ -8,56 +8,43 @@ Shadow-git (`sgit`) creates a `.sgit/` repository alongside your `.git/` directo
 
 ```bash
 npm install -g .
-# or
-npm link
 ```
 
-## Quick Start
+Optionally, install shell completions (bash, zsh, or fish):
 
 ```bash
-# Initialize shadow repo in an existing git project
-sgit track init
-
-# Start tracking a file
-sgit track add notes/todo.md
-
-# Move a main-git-tracked file to shadow tracking
-sgit track add --adopt config.local.json
+sgit track completion install
+```
 
-# List tracked files
-sgit track list
+## Quick Start
 
-# Use git commands against the shadow repo
-sgit status
-sgit commit -m "update notes"
-sgit log
+```bash
+sgit track init                        # Initialize shadow repo
+sgit track add notes/todo.md           # Start tracking a file
+sgit track add --adopt config.local    # Move a main-git file to shadow tracking
+sgit track list                        # List tracked paths
+sgit status                            # Git status in shadow repo
+sgit commit -m "update notes"          # Commit to shadow repo
 ```
 
 ## Commands
 
-### Track Management
-
 | Command | Description |
 |---|---|
 | `sgit track init` | Initialize shadow repository |
+| `sgit track clone <url>` | Clone a shadow repository from a remote URL |
 | `sgit track add <paths...>` | Start shadow-tracking paths |
 | `sgit track add --adopt <paths...>` | Move main-git-tracked files to shadow tracking |
 | `sgit track remove <paths...>` | Stop shadow-tracking paths |
 | `sgit track list` | List all shadow-tracked paths |
 | `sgit track sync` | Regenerate exclude files from manifest |
 | `sgit track verify` | Validate staged files against manifest |
+| `sgit track ignore <paths...>` | Ignore paths within tracked directories |
+| `sgit track unignore <paths...>` | Stop ignoring paths within tracked directories |
 | `sgit track destroy` | Remove shadow repository entirely |
+| `sgit track completion [install]` | Print or install shell completion scripts |
 
-### Git Passthrough
-
-Any command not listed above is forwarded directly to git using the shadow repository:
-
-```bash
-sgit status          # git status in shadow repo
-sgit diff            # git diff in shadow repo
-sgit commit -m "msg" # commit to shadow repo
-sgit log             # log of shadow repo
-```
+Any non-track command is forwarded to git using the shadow repository (e.g. `sgit status`, `sgit log`, `sgit diff`).
 
 ## How It Works