acker-dacker 0.2.0 → 0.3.0

package/README.md

@@ -81,6 +81,17 @@ In all cases, repository `.git/info/exclude` rules and local/nested `.gitignore`
 
 Git handoff mode asks Git for tracked files and standard-ignore-aware untracked files. Tracked files remain eligible by design; sensitive and generated files are safety-filtered only when untracked. Deleted tracked files missing from the worktree are omitted from the archive and recorded in the report. Absolute, escaping, dangling, and cyclic symlinks are rejected, as are symlinked ancestor directories. Output and report artifact paths must reside outside the worktree and cannot alias each other via directory symlinks or hard links. `--exclude`, `--filter`, `--profile`, and `--report` are applied as documented above.
 
+For a slim source handoff, repeat `--exclude` for known assets and duplicated captures; no new profile is needed:
+
+```bash
+bunx acker-dacker ../my-repository --git-handoff \
+  --exclude '**/*.[gG][lL][bB]' --exclude '**/*.[pP][nN][gG]' \
+  --exclude recovery/original/public --exclude recovery/original/bundle.js \
+  --output ./handoff-slim.zip --report ./handoff-slim.json
+```
+
+Exclusions are case-sensitive, root-relative paths/globs; `**/` also matches the root, character classes cover mixed-case extensions, and excluding a directory excludes its descendants. The example omits GLBs, PNGs, the captured public tree and captured bundle only; add the other media extensions present in your repository explicitly. File size alone never determines exclusion. Source/shader text, configs, lockfiles and recovery evidence remain unless explicitly matched. Reports list included paths and omission counts per pattern (overlaps count toward the first matching pattern). Keep a full packet for browser parity, asset checks and recovery reproduction, and document which static checks still work in the slim packet.
+
 ### Determinism and format limits
 
 Archives are deterministic: file ordering, ZIP timestamps (normalized to 1980-01-01), and compression choices do not depend on the current clock. ZIP files are created using maximum DEFLATE compression (`level: 9, memLevel: 9`), with streaming deflation spooled for entries over 64 MiB (falling back to STORE only if compression does not reduce size). Archive files are written atomically via temporary siblings to ensure existing files are never corrupted on failure.
@@ -111,3 +122,7 @@ npm pack --dry-run
 ```
 
 The package exposes the `acker-dacker` bin and intentionally ships only `src/` (excluding tests) as application files, plus npm's standard metadata files.
+
+### Slim Git handoffs
+
+Use `acker-dacker ../repo --git-handoff --slim --output ../repo-slim.zip --report ../repo-slim.json`. `--slim` requires `--git-handoff` and composes with repeatable `--exclude`. It omits case-insensitive extensions GLB, GLTF, PNG, JPG, JPEG, WebP, GIF, AVIF, ICO, KTX, KTX2, HDR, EXR, MP3, WAV, OGG, MP4, WebM, MOV, WASM, WOFF, WOFF2, TTF and OTF at any depth. Source, shaders, configs, lockfiles and text evidence remain, regardless of size. Captured text bundles remain unless explicitly excluded. Omission counts use the existing report. Default/full behavior is unchanged; keep full assets for browser parity and asset-dependent checks.

package/package.json

@@ -1,36 +1,36 @@
 {
-  "name": "acker-dacker",
-  "author": {
-    "name": "Ragaeeb Haq",
-    "url": "https://github.com/ragaeeb"
-  },
-  "bugs": {
-    "url": "https://github.com/ragaeeb/acker-dacker/issues"
-  },
-  "version": "0.2.0",
-  "description": "Create deterministic, privacy-aware repository ZIPs for AI handoffs and code review.",
-  "type": "module",
-  "bin": {
-    "acker-dacker": "src/index.ts"
-  },
-  "files": [
-    "src",
-    "!src/__tests__"
-  ],
-  "scripts": {
-    "build": "bun build ./src/index.ts --compile --minify --bytecode --format=esm --outfile ./dist/acker-dacker",
-    "check": "bun run typecheck && bun test && bun build ./src/index.ts --target=bun --outfile /tmp/acker-dacker-check.js",
-    "prepublishOnly": "bun run check",
-    "test": "bun test",
-    "typecheck": "tsc --noEmit"
-  },
-  "engines": {
-    "bun": ">=1.4.2",
-    "node": ">=26.x"
-  },
-  "packageManager": "bun@1.4.2",
-  "devDependencies": {
-    "@types/bun": "^1.4.2",
-    "typescript": "^7.0.2"
-  }
+	"name": "acker-dacker",
+	"author": {
+		"name": "Ragaeeb Haq",
+		"url": "https://github.com/ragaeeb"
+	},
+	"bugs": {
+		"url": "https://github.com/ragaeeb/acker-dacker/issues"
+	},
+	"version": "0.3.0",
+	"description": "Create deterministic, privacy-aware repository ZIPs for AI handoffs and code review.",
+	"type": "module",
+	"bin": {
+		"acker-dacker": "src/index.ts"
+	},
+	"files": [
+		"src",
+		"!src/__tests__"
+	],
+	"scripts": {
+		"build": "bun build ./src/index.ts --compile --minify --bytecode --format=esm --outfile ./dist/acker-dacker",
+		"check": "bun run typecheck && bun test && bun build ./src/index.ts --target=bun --outfile /tmp/acker-dacker-check.js",
+		"prepublishOnly": "bun run check",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit"
+	},
+	"engines": {
+		"bun": ">=1.4.4",
+		"node": ">=26.x"
+	},
+	"packageManager": "bun@1.4.2",
+	"devDependencies": {
+		"@types/bun": "^1.4.4",
+		"typescript": "^7.0.2"
+	}
 }

package/src/cli/cli-options.ts

@@ -2,6 +2,7 @@ export type CliOptions = {
     readonly excludes: readonly string[];
     readonly filters: readonly string[];
     readonly gitHandoff: boolean;
+    readonly slim: boolean;
     readonly includes: readonly string[];
     readonly outputFile: string | null;
     readonly profile: string | null;
@@ -15,6 +16,7 @@ export const parseCliArgs = (args: readonly string[]): CliOptions => {
     const filters: string[] = [];
     const includes: string[] = [];
     let gitHandoff = false;
+    let slim = false;
     let outputFile: string | null = null;
     let profile: string | null = null;
     let reportFile: string | null = null;
@@ -67,6 +69,8 @@ export const parseCliArgs = (args: readonly string[]): CliOptions => {
 
         if (argument === '--help' || argument === '-h') {
             showHelp = true;
+        } else if (argument === '--slim') {
+            slim = true;
         } else if (argument === '--git-handoff') {
             gitHandoff = true;
         } else if (argument.startsWith('--profile=')) {
@@ -141,7 +145,7 @@ export const parseCliArgs = (args: readonly string[]): CliOptions => {
         }
     }
 
-    return { excludes, filters, gitHandoff, includes, outputFile, profile, reportFile, showHelp, targetDir };
+    return { excludes, filters, gitHandoff, slim, includes, outputFile, profile, reportFile, showHelp, targetDir };
 };
 
 export const printUsage = (): void => {
@@ -150,6 +154,7 @@ Usage: acker-dacker [targetRepoPath] [options]
 
 Options:
   --git-handoff          Use Git's tracked + eligible-untracked set and preserve modes/symlinks
+  --slim                Omit media/fonts/WASM in Git handoffs; keep source/config/evidence (requires --git-handoff)
   --profile <name>       Select a named Git handoff profile (currently rust-stage3; requires --git-handoff)
   --filter, -f <pattern> Include ONLY files matching pattern (e.g. *.md, *.ts; can be specified multiple times)
   --include, -i <path|glob> Additional folder path, repo name, or glob pattern to include (can be specified multiple times)

package/src/cli/cli.ts

@@ -103,7 +103,7 @@ export const main = async (args: readonly string[] = process.argv.slice(2)): Pro
             throw new Error('--include is not supported with --git-handoff; Git defines the handoff boundary.');
         }
         await runGitHandoff({
-            excludes: options.excludes,
+            excludes: options.slim ? [...options.excludes, ...['glb', 'gltf', 'png', 'jpg', 'jpeg', 'webp', 'gif', 'avif', 'ico', 'ktx', 'ktx2', 'hdr', 'exr', 'mp3', 'wav', 'ogg', 'mp4', 'webm', 'mov', 'wasm', 'woff', 'woff2', 'ttf', 'otf'].map(extension => `**/*.${[...extension].map(c => /[a-z]/.test(c) ? `[${c}${c.toUpperCase()}]` : c).join('')}`)] : options.excludes,
             filters: options.filters.map(globToRegex),
             outputFile: options.outputFile,
             profile: options.profile,
@@ -113,8 +113,8 @@ export const main = async (args: readonly string[] = process.argv.slice(2)): Pro
         return;
     }
 
-    if (options.excludes.length > 0 || options.profile || options.reportFile) {
-        throw new Error('--exclude, --profile, and --report require --git-handoff.');
+    if (options.slim || options.excludes.length > 0 || options.profile || options.reportFile) {
+        throw new Error('--slim, --exclude, --profile, and --report require --git-handoff.');
     }
 
     await runDefaultPack({