RepoPackPy 0.1.8__tar.gz → 0.2.0__tar.gz

repopackpy-0.2.0/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: RepoPackPy
+Version: 0.2.0
+Summary: Pack/unpack any source workspace into portable JSON, with MCP server support.
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: mcp[cli]>=1.0
+Requires-Dist: pathspec>=0.12
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# RepoPack
+
+Pack/unpack **any source workspace regardless of technology stack** (Python, Node.js, React, Angular, Vue, Rust, Go, Java, C#, and more) into a portable, structured JSON payload — and restore it faithfully from that payload.
+
+## Features
+
+- **Universal ignore engine** — respects root and nested `.gitignore` files plus stack-agnostic defaults (node_modules, __pycache__, .venv, target/, dist/, secrets, lock files, …)
+- **Polyglot stack detection** — auto-detects Node.js, React, TypeScript, Angular, Next.js, Vue, Python, Rust, Go, Java, C# from project sentinel files
+- **Binary safety** — text files encoded as UTF-8; binaries skipped by default or included as Base64 with `--include-binary`
+- **5 MB guard** — files larger than 5 MB are skipped with a warning
+- **Dry-run mode** — preview exactly which files would be packed or unpacked before committing with `--dry-run`
+- **Path traversal shield** — `unpack` validates every path against the destination root before writing anything; blocks `../`, absolute paths, and injection attempts (CWE-22)
+- **Secure PyPI version check** — uses `http.client.HTTPSConnection` (not `urlopen`) to enforce HTTPS at the type level
+- **MCP server** — expose pack/unpack as tools to any MCP-compatible AI client (Claude Desktop, etc.)
+- **Automated security auditing** — weekly `pip-audit` + `bandit` CI scans on all dependencies
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install RepoPackPy
+```
+
+Requires Python 3.10+.
+
+### Quick start after install
+
+```bash
+# Verify the install
+repopack --version
+repopack --help
+
+# Pack your project
+repopack pack . -o my-workspace.json
+
+# Preview what would be packed (no output written)
+repopack pack . --dry-run
+
+# Restore it somewhere else
+repopack unpack my-workspace.json -t ./restored
+
+# Preview what would be unpacked (nothing written)
+repopack unpack my-workspace.json -t ./restored --dry-run
+```
+
+### For development
+
+```bash
+git clone https://github.com/ShanKonduru/RepoPack.git
+cd RepoPack
+pip install ".[dev]"
+```
+
+> **Note:** Install without `-e` (editable) so `pip-audit` can audit the package metadata correctly.
+
+## CLI Usage
+
+```
+repopack pack     [DIRECTORY] [-o output.json] [--include-binary] [--custom-ignore ".next,dist"] [--dry-run]
+repopack unpack   <input.json> [-t TARGET_DIR] [--force] [--dry-run]
+repopack validate <input.json> [DIRECTORY]
+repopack fix      <input.json> [DIRECTORY] [--include-binary]
+repopack serve
+```
+
+### Options
+
+| Command | Flag | Description |
+|---|---|---|
+| `pack` | `-o / --output` | Write packed JSON to this file (prints to stdout if omitted) |
+| `pack` | `--include-binary` | Include binary files encoded as Base64 |
+| `pack` | `--custom-ignore` | Comma-separated extra ignore patterns |
+| `pack` | `--dry-run` | List files that would be packed — encoding, size, path — without writing anything |
+| `unpack` | `-t / --target` | Destination directory (default: current directory) |
+| `unpack` | `--force` | Overwrite existing files |
+| `unpack` | `--dry-run` | List files that would be extracted or skipped without writing anything |
+| `validate` | _(none)_ | Compare JSON against the live workspace; exit 1 if outdated |
+| `fix` | `--include-binary` | Re-pack workspace into the JSON file, adding/removing/refreshing as needed |
+
+### Examples
+
+```bash
+# Pack current directory
+repopack pack . -o workspace.json
+
+# Dry-run: see what would be packed
+repopack pack . --dry-run
+
+# Pack a specific project, include binaries
+repopack pack ~/projects/my-app -o my-app.json --include-binary
+
+# Unpack into a new directory
+repopack unpack workspace.json -t ./restored
+
+# Dry-run: see what would be unpacked (and what would be skipped)
+repopack unpack workspace.json -t ./restored --dry-run
+
+# Unpack and overwrite existing files
+repopack unpack workspace.json -t ./restored --force
+
+# Validate: check if workspace.json is complete and up to date
+repopack validate workspace.json .
+
+# Fix: update workspace.json with all latest files and folders
+repopack fix workspace.json .
+```
+
+#### Sample `--dry-run` output
+
+```
+# pack --dry-run
+Dry run — would pack 42 files (186320 bytes)
+Root    : /home/user/my-app
+Stack   : Node.js, React, TypeScript
+  utf-8       1024  src/App.tsx
+  utf-8        512  src/index.tsx
+  base64      8192  public/favicon.ico
+  ...
+
+# unpack --dry-run
+Dry run — destination: /home/user/restored
+  Would extract : 40
+  Would skip    : 2
+  create                src/App.tsx
+  create                src/index.tsx
+  skip (exists)         README.md
+  ...
+```
+
+#### Sample `validate` output
+
+```
+Status  : OUTDATED
+JSON    : workspace.json
+Workspace: /home/user/my-app
+  Missing from JSON : 2
+  Extra in JSON     : 1
+  Stale in JSON     : 3
+  Up to date        : 36
+
+Missing (in workspace, not in JSON):
+  + src/NewComponent.tsx
+  + src/utils/helper.ts
+
+Extra (in JSON, not in workspace):
+  - src/OldComponent.tsx
+
+Stale (content changed since packing):
+  ~ README.md
+  ~ src/App.tsx
+  ~ package.json
+```
+
+#### Sample `fix` output
+
+```
+Updated : workspace.json
+Workspace: /home/user/my-app
+  Added    : 2 files
+  Removed  : 1 files
+  Refreshed: 3 files
+  Total    : 42 files (189440 bytes)
+```
+
+## JSON Payload Schema
+
+```json
+{
+  "version": "1.0",
+  "metadata": {
+    "created_at": "2026-07-26T12:00:00Z",
+    "root_directory_name": "my-app",
+    "detected_stack": ["Node.js", "React", "TypeScript"],
+    "total_files": 38,
+    "total_bytes": 128450
+  },
+  "files": [
+    { "path": "src/App.tsx", "encoding": "utf-8", "content": "..." },
+    { "path": "public/favicon.ico", "encoding": "base64", "content": "..." }
+  ]
+}
+```
+
+## MCP Server Tools
+
+When running `repopack serve`, two tools are registered via FastMCP:
+
+| Tool | Parameters | Description |
+|---|---|---|
+| `export_workspace` | `workspace_path, output_json_path, include_binary, dry_run` | Pack a directory into JSON |
+| `import_workspace` | `json_input, destination_path, overwrite, dry_run` | Unpack JSON into a directory |
+| `validate_workspace_tool` | `json_path, workspace_path` | Report missing, extra, and stale files vs the live workspace |
+| `fix_workspace_tool` | `json_path, workspace_path, include_binary` | Re-pack and overwrite the JSON with all latest files and folders |
+
+Set `dry_run=true` on `export_workspace` or `import_workspace` to get a plain-text report without reading file content or writing to disk.
+
+## Security
+
+### Path traversal protection
+
+Every path in an incoming JSON payload is validated before the filesystem is touched:
+
+- Absolute paths are rejected.
+- Any path component equal to `..` is rejected.
+- The resolved output path is checked with `os.path.commonpath` to confirm it stays inside the destination root.
+
+This blocks directory traversal attacks (CWE-22) regardless of how the JSON was produced.
+
+### PyPI version check
+
+The `--version` flag checks for newer releases on PyPI using `http.client.HTTPSConnection` directly, which enforces HTTPS at the type level and is not susceptible to `file://` or custom-scheme abuse (bandit B310 / CWE-22).
+
+### CI security scanning
+
+Every push and weekly schedule runs:
+
+- **`pip-audit --strict`** — checks all third-party dependencies against known CVE databases.
+- **`bandit -r repopack/ -ll -ii`** — static analysis for common Python security issues.
+
+## Project Structure
+
+```
+repopack/
+├── pyproject.toml
+├── README.md
+└── repopack/
+    ├── __init__.py
+    ├── cli.py          # Typer CLI (pack / unpack / serve)
+    ├── mcp_server.py   # FastMCP server
+    ├── packer.py       # Directory walker & JSON builder
+    ├── unpacker.py     # JSON extractor & path-safe reconstructor
+    └── utils.py        # Ignore engine, binary detector, stack detection
+tests/
+└── test_repopack.py
+```
+
+## Running Tests
+
+```bash
+pytest tests/ -v
+```
+
+## Dependencies
+
+- [typer](https://typer.tiangolo.com/) — CLI framework
+- [mcp](https://github.com/modelcontextprotocol/python-sdk) — MCP SDK (FastMCP)
+- [pathspec](https://github.com/cpburnz/python-pathspec) — gitignore wildmatch pattern matching

repopackpy-0.2.0/README.md

@@ -0,0 +1,248 @@
+# RepoPack
+
+Pack/unpack **any source workspace regardless of technology stack** (Python, Node.js, React, Angular, Vue, Rust, Go, Java, C#, and more) into a portable, structured JSON payload — and restore it faithfully from that payload.
+
+## Features
+
+- **Universal ignore engine** — respects root and nested `.gitignore` files plus stack-agnostic defaults (node_modules, __pycache__, .venv, target/, dist/, secrets, lock files, …)
+- **Polyglot stack detection** — auto-detects Node.js, React, TypeScript, Angular, Next.js, Vue, Python, Rust, Go, Java, C# from project sentinel files
+- **Binary safety** — text files encoded as UTF-8; binaries skipped by default or included as Base64 with `--include-binary`
+- **5 MB guard** — files larger than 5 MB are skipped with a warning
+- **Dry-run mode** — preview exactly which files would be packed or unpacked before committing with `--dry-run`
+- **Path traversal shield** — `unpack` validates every path against the destination root before writing anything; blocks `../`, absolute paths, and injection attempts (CWE-22)
+- **Secure PyPI version check** — uses `http.client.HTTPSConnection` (not `urlopen`) to enforce HTTPS at the type level
+- **MCP server** — expose pack/unpack as tools to any MCP-compatible AI client (Claude Desktop, etc.)
+- **Automated security auditing** — weekly `pip-audit` + `bandit` CI scans on all dependencies
+
+## Installation
+
+### From PyPI (recommended)
+
+```bash
+pip install RepoPackPy
+```
+
+Requires Python 3.10+.
+
+### Quick start after install
+
+```bash
+# Verify the install
+repopack --version
+repopack --help
+
+# Pack your project
+repopack pack . -o my-workspace.json
+
+# Preview what would be packed (no output written)
+repopack pack . --dry-run
+
+# Restore it somewhere else
+repopack unpack my-workspace.json -t ./restored
+
+# Preview what would be unpacked (nothing written)
+repopack unpack my-workspace.json -t ./restored --dry-run
+```
+
+### For development
+
+```bash
+git clone https://github.com/ShanKonduru/RepoPack.git
+cd RepoPack
+pip install ".[dev]"
+```
+
+> **Note:** Install without `-e` (editable) so `pip-audit` can audit the package metadata correctly.
+
+## CLI Usage
+
+```
+repopack pack     [DIRECTORY] [-o output.json] [--include-binary] [--custom-ignore ".next,dist"] [--dry-run]
+repopack unpack   <input.json> [-t TARGET_DIR] [--force] [--dry-run]
+repopack validate <input.json> [DIRECTORY]
+repopack fix      <input.json> [DIRECTORY] [--include-binary]
+repopack serve
+```
+
+### Options
+
+| Command | Flag | Description |
+|---|---|---|
+| `pack` | `-o / --output` | Write packed JSON to this file (prints to stdout if omitted) |
+| `pack` | `--include-binary` | Include binary files encoded as Base64 |
+| `pack` | `--custom-ignore` | Comma-separated extra ignore patterns |
+| `pack` | `--dry-run` | List files that would be packed — encoding, size, path — without writing anything |
+| `unpack` | `-t / --target` | Destination directory (default: current directory) |
+| `unpack` | `--force` | Overwrite existing files |
+| `unpack` | `--dry-run` | List files that would be extracted or skipped without writing anything |
+| `validate` | _(none)_ | Compare JSON against the live workspace; exit 1 if outdated |
+| `fix` | `--include-binary` | Re-pack workspace into the JSON file, adding/removing/refreshing as needed |
+
+### Examples
+
+```bash
+# Pack current directory
+repopack pack . -o workspace.json
+
+# Dry-run: see what would be packed
+repopack pack . --dry-run
+
+# Pack a specific project, include binaries
+repopack pack ~/projects/my-app -o my-app.json --include-binary
+
+# Unpack into a new directory
+repopack unpack workspace.json -t ./restored
+
+# Dry-run: see what would be unpacked (and what would be skipped)
+repopack unpack workspace.json -t ./restored --dry-run
+
+# Unpack and overwrite existing files
+repopack unpack workspace.json -t ./restored --force
+
+# Validate: check if workspace.json is complete and up to date
+repopack validate workspace.json .
+
+# Fix: update workspace.json with all latest files and folders
+repopack fix workspace.json .
+```
+
+#### Sample `--dry-run` output
+
+```
+# pack --dry-run
+Dry run — would pack 42 files (186320 bytes)
+Root    : /home/user/my-app
+Stack   : Node.js, React, TypeScript
+  utf-8       1024  src/App.tsx
+  utf-8        512  src/index.tsx
+  base64      8192  public/favicon.ico
+  ...
+
+# unpack --dry-run
+Dry run — destination: /home/user/restored
+  Would extract : 40
+  Would skip    : 2
+  create                src/App.tsx
+  create                src/index.tsx
+  skip (exists)         README.md
+  ...
+```
+
+#### Sample `validate` output
+
+```
+Status  : OUTDATED
+JSON    : workspace.json
+Workspace: /home/user/my-app
+  Missing from JSON : 2
+  Extra in JSON     : 1
+  Stale in JSON     : 3
+  Up to date        : 36
+
+Missing (in workspace, not in JSON):
+  + src/NewComponent.tsx
+  + src/utils/helper.ts
+
+Extra (in JSON, not in workspace):
+  - src/OldComponent.tsx
+
+Stale (content changed since packing):
+  ~ README.md
+  ~ src/App.tsx
+  ~ package.json
+```
+
+#### Sample `fix` output
+
+```
+Updated : workspace.json
+Workspace: /home/user/my-app
+  Added    : 2 files
+  Removed  : 1 files
+  Refreshed: 3 files
+  Total    : 42 files (189440 bytes)
+```
+
+## JSON Payload Schema
+
+```json
+{
+  "version": "1.0",
+  "metadata": {
+    "created_at": "2026-07-26T12:00:00Z",
+    "root_directory_name": "my-app",
+    "detected_stack": ["Node.js", "React", "TypeScript"],
+    "total_files": 38,
+    "total_bytes": 128450
+  },
+  "files": [
+    { "path": "src/App.tsx", "encoding": "utf-8", "content": "..." },
+    { "path": "public/favicon.ico", "encoding": "base64", "content": "..." }
+  ]
+}
+```
+
+## MCP Server Tools
+
+When running `repopack serve`, two tools are registered via FastMCP:
+
+| Tool | Parameters | Description |
+|---|---|---|
+| `export_workspace` | `workspace_path, output_json_path, include_binary, dry_run` | Pack a directory into JSON |
+| `import_workspace` | `json_input, destination_path, overwrite, dry_run` | Unpack JSON into a directory |
+| `validate_workspace_tool` | `json_path, workspace_path` | Report missing, extra, and stale files vs the live workspace |
+| `fix_workspace_tool` | `json_path, workspace_path, include_binary` | Re-pack and overwrite the JSON with all latest files and folders |
+
+Set `dry_run=true` on `export_workspace` or `import_workspace` to get a plain-text report without reading file content or writing to disk.
+
+## Security
+
+### Path traversal protection
+
+Every path in an incoming JSON payload is validated before the filesystem is touched:
+
+- Absolute paths are rejected.
+- Any path component equal to `..` is rejected.
+- The resolved output path is checked with `os.path.commonpath` to confirm it stays inside the destination root.
+
+This blocks directory traversal attacks (CWE-22) regardless of how the JSON was produced.
+
+### PyPI version check
+
+The `--version` flag checks for newer releases on PyPI using `http.client.HTTPSConnection` directly, which enforces HTTPS at the type level and is not susceptible to `file://` or custom-scheme abuse (bandit B310 / CWE-22).
+
+### CI security scanning
+
+Every push and weekly schedule runs:
+
+- **`pip-audit --strict`** — checks all third-party dependencies against known CVE databases.
+- **`bandit -r repopack/ -ll -ii`** — static analysis for common Python security issues.
+
+## Project Structure
+
+```
+repopack/
+├── pyproject.toml
+├── README.md
+└── repopack/
+    ├── __init__.py
+    ├── cli.py          # Typer CLI (pack / unpack / serve)
+    ├── mcp_server.py   # FastMCP server
+    ├── packer.py       # Directory walker & JSON builder
+    ├── unpacker.py     # JSON extractor & path-safe reconstructor
+    └── utils.py        # Ignore engine, binary detector, stack detection
+tests/
+└── test_repopack.py
+```
+
+## Running Tests
+
+```bash
+pytest tests/ -v
+```
+
+## Dependencies
+
+- [typer](https://typer.tiangolo.com/) — CLI framework
+- [mcp](https://github.com/modelcontextprotocol/python-sdk) — MCP SDK (FastMCP)
+- [pathspec](https://github.com/cpburnz/python-pathspec) — gitignore wildmatch pattern matching

{repopackpy-0.1.8 → repopackpy-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "RepoPackPy"
-version = "0.1.8"
+version = "0.2.0"
 description = "Pack/unpack any source workspace into portable JSON, with MCP server support."
 readme = "README.md"
 license = { text = "MIT" }

repopackpy-0.2.0/repopack/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.2.0"

{repopackpy-0.1.8 → repopackpy-0.2.0}/repopack/cli.py

@@ -5,7 +5,7 @@ import typer
 from pathlib import Path
 
 from repopack import __version__
-from repopack.packer import pack_workspace
+from repopack.packer import fix_workspace, pack_workspace, validate_workspace
 from repopack.unpacker import unpack_workspace
 from repopack.mcp_server import run_server
 
@@ -109,6 +109,62 @@ def unpack(
         raise typer.Exit(1)
 
 
+@app.command()
+def validate(
+    json_file: str = typer.Argument(..., help="Packed JSON file to validate."),
+    directory: str = typer.Argument(".", help="Workspace directory to compare against."),
+):
+    """Check whether a packed JSON is complete and up to date with the workspace."""
+    try:
+        report = validate_workspace(json_file, Path(directory))
+        s = report["summary"]
+        status = "OK" if report["valid"] else "OUTDATED"
+        typer.echo(f"Status  : {status}")
+        typer.echo(f"JSON    : {report['json_path']}")
+        typer.echo(f"Workspace: {report['workspace']}")
+        typer.echo(f"  Missing from JSON : {s['missing_from_json']}")
+        typer.echo(f"  Extra in JSON     : {s['extra_in_json']}")
+        typer.echo(f"  Stale in JSON     : {s['stale_in_json']}")
+        typer.echo(f"  Up to date        : {s['up_to_date']}")
+        if report["missing_from_json"]:
+            typer.echo("\nMissing (in workspace, not in JSON):")
+            for p in report["missing_from_json"]:
+                typer.echo(f"  + {p}")
+        if report["extra_in_json"]:
+            typer.echo("\nExtra (in JSON, not in workspace):")
+            for p in report["extra_in_json"]:
+                typer.echo(f"  - {p}")
+        if report["stale_in_json"]:
+            typer.echo("\nStale (content changed since packing):")
+            for p in report["stale_in_json"]:
+                typer.echo(f"  ~ {p}")
+        if not report["valid"]:
+            raise typer.Exit(1)
+    except (ValueError, OSError) as e:
+        typer.echo(str(e), err=True)
+        raise typer.Exit(1)
+
+
+@app.command()
+def fix(
+    json_file: str = typer.Argument(..., help="Packed JSON file to update."),
+    directory: str = typer.Argument(".", help="Workspace directory to pack from."),
+    include_binary: bool = typer.Option(False, "--include-binary", help="Include binary files."),
+):
+    """Re-pack the workspace and update the JSON file with all latest files and folders."""
+    try:
+        result = fix_workspace(json_file, Path(directory), include_binary=include_binary)
+        typer.echo(f"Updated : {result['json_path']}")
+        typer.echo(f"Workspace: {result['workspace']}")
+        typer.echo(f"  Added   : {len(result['added'])} files")
+        typer.echo(f"  Removed : {len(result['removed'])} files")
+        typer.echo(f"  Refreshed: {len(result['refreshed'])} files")
+        typer.echo(f"  Total   : {result['total_files']} files ({result['total_bytes']} bytes)")
+    except (ValueError, OSError) as e:
+        typer.echo(str(e), err=True)
+        raise typer.Exit(1)
+
+
 @app.command()
 def serve():
     typer.echo("Starting RepoPack MCP server (stdio)...", err=True)

{repopackpy-0.1.8 → repopackpy-0.2.0}/repopack/mcp_server.py

@@ -3,7 +3,7 @@ from pathlib import Path
 
 from mcp.server.fastmcp import FastMCP
 
-from repopack.packer import pack_workspace
+from repopack.packer import fix_workspace, pack_workspace, validate_workspace
 from repopack.unpacker import unpack_workspace
 
 mcp = FastMCP("RepoPack")
@@ -49,6 +49,45 @@ def import_workspace(
     return f"Extracted {summary['extracted']} files to {summary['destination']} ({summary['skipped']} skipped)"
 
 
+@mcp.tool()
+def validate_workspace_tool(
+    json_path: str,
+    workspace_path: str = ".",
+) -> str:
+    report = validate_workspace(json_path, Path(workspace_path))
+    s = report["summary"]
+    lines = [
+        f"Status   : {'OK' if report['valid'] else 'OUTDATED'}",
+        f"Missing from JSON : {s['missing_from_json']}",
+        f"Extra in JSON     : {s['extra_in_json']}",
+        f"Stale in JSON     : {s['stale_in_json']}",
+        f"Up to date        : {s['up_to_date']}",
+    ]
+    for p in report["missing_from_json"]:
+        lines.append(f"  + {p}")
+    for p in report["extra_in_json"]:
+        lines.append(f"  - {p}")
+    for p in report["stale_in_json"]:
+        lines.append(f"  ~ {p}")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+def fix_workspace_tool(
+    json_path: str,
+    workspace_path: str = ".",
+    include_binary: bool = False,
+) -> str:
+    result = fix_workspace(json_path, Path(workspace_path), include_binary=include_binary)
+    return (
+        f"Updated {result['json_path']}: "
+        f"+{len(result['added'])} added, "
+        f"-{len(result['removed'])} removed, "
+        f"~{len(result['refreshed'])} refreshed. "
+        f"Total: {result['total_files']} files ({result['total_bytes']} bytes)."
+    )
+
+
 def run_server():
     mcp.run(transport="stdio")
 

{repopackpy-0.1.8 → repopackpy-0.2.0}/repopack/packer.py

@@ -1,5 +1,6 @@
 import base64
 import datetime
+import json
 import os
 import sys
 from pathlib import Path
@@ -109,3 +110,72 @@ def pack_workspace(
         },
         "files": files,
     }
+
+
+def validate_workspace(json_path: str, directory: Path) -> dict:
+    """Compare a packed JSON against the live workspace and report differences."""
+    with open(json_path, "r", encoding="utf-8") as f:
+        data = json.load(f)
+
+    if "files" not in data:
+        raise ValueError("Malformed JSON: missing 'files' key.")
+
+    packed_paths = {entry["path"] for entry in data["files"]}
+
+    live = pack_workspace(directory, dry_run=True)
+    live_files = {f["path"]: f for f in live["files"]}
+    live_paths = set(live_files)
+
+    missing = sorted(live_paths - packed_paths)   # in workspace, not in JSON
+    extra = sorted(packed_paths - live_paths)      # in JSON, not in workspace
+    common = packed_paths & live_paths
+
+    stale: list[str] = []
+    for path in sorted(common):
+        live_size = live_files[path]["size"]
+        disk_path = directory.resolve() / path
+        try:
+            packed_entry = next(e for e in data["files"] if e["path"] == path)
+            packed_len = len(packed_entry.get("content", ""))
+            # Compare mtime-derived size vs packed content length as a quick staleness check.
+            # For utf-8 files packed content length approximates byte size; good enough to flag.
+            if abs(live_size - packed_len) > 0:
+                stale.append(path)
+        except (StopIteration, OSError):
+            pass
+
+    up_to_date = len(common) - len(stale)
+
+    return {
+        "json_path": json_path,
+        "workspace": str(directory.resolve()),
+        "summary": {
+            "missing_from_json": len(missing),
+            "extra_in_json": len(extra),
+            "stale_in_json": len(stale),
+            "up_to_date": up_to_date,
+        },
+        "missing_from_json": missing,
+        "extra_in_json": extra,
+        "stale_in_json": stale,
+        "valid": len(missing) == 0 and len(extra) == 0 and len(stale) == 0,
+    }
+
+
+def fix_workspace(json_path: str, directory: Path, include_binary: bool = False) -> dict:
+    """Re-pack the live workspace and overwrite the JSON file with the latest content."""
+    report = validate_workspace(json_path, directory)
+
+    result = pack_workspace(directory, include_binary=include_binary)
+    with open(json_path, "w", encoding="utf-8") as f:
+        json.dump(result, f, indent=2)
+
+    return {
+        "json_path": json_path,
+        "workspace": str(directory.resolve()),
+        "added": report["missing_from_json"],
+        "removed": report["extra_in_json"],
+        "refreshed": report["stale_in_json"],
+        "total_files": result["metadata"]["total_files"],
+        "total_bytes": result["metadata"]["total_bytes"],
+    }

repopackpy-0.1.8/PKG-INFO

@@ -1,153 +0,0 @@
-Metadata-Version: 2.4
-Name: RepoPackPy
-Version: 0.1.8
-Summary: Pack/unpack any source workspace into portable JSON, with MCP server support.
-License: MIT
-License-File: LICENSE
-Requires-Python: >=3.10
-Requires-Dist: mcp[cli]>=1.0
-Requires-Dist: pathspec>=0.12
-Requires-Dist: typer>=0.12
-Provides-Extra: dev
-Requires-Dist: pytest>=8; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# RepoPack
-
-Pack/unpack **any source workspace regardless of technology stack** (Python, Node.js, React, Angular, Vue, Rust, Go, Java, C#, and more) into a portable, structured JSON payload — and restore it faithfully from that payload.
-
-## Features
-
-- **Universal ignore engine** — respects root and nested `.gitignore` files plus stack-agnostic defaults (node_modules, __pycache__, .venv, target/, dist/, secrets, lock files, …)
-- **Polyglot stack detection** — auto-detects Node.js, React, TypeScript, Angular, Next.js, Vue, Python, Rust, Go, Java, C# from project sentinel files
-- **Binary safety** — text files encoded as UTF-8; binaries skipped by default or included as Base64 with `--include-binary`
-- **5 MB guard** — files larger than 5 MB are skipped with a warning
-- **Path traversal shield** — `unpack` validates every path against the destination root before writing anything
-- **MCP server** — expose pack/unpack as tools to any MCP-compatible AI client (Claude Desktop, etc.)
-
-## Installation
-
-### From PyPI (recommended)
-
-Install the latest stable release:
-
-```bash
-pip install RepoPackPy
-```
-
-Pin to a specific version:
-
-```bash
-pip install RepoPackPy==0.1.1
-```
-
-Requires Python 3.10+.
-
-### Quick start after install
-
-```bash
-# Verify the install
-repopack --help
-
-# Pack your project
-repopack pack . -o my-workspace.json
-
-# Restore it somewhere else
-repopack unpack my-workspace.json -t ./restored
-```
-
-### For development
-
-Clone the repo and install in editable mode with test dependencies:
-
-```bash
-git clone https://github.com/ShanKonduru/RepoPack.git
-cd RepoPack
-pip install -e ".[dev]"
-```
-
-## CLI Usage
-
-```bash
-# Pack a directory into JSON
-repopack pack [DIRECTORY] [-o output.json] [--include-binary] [--custom-ignore ".next,dist"]
-
-# Unpack JSON back into a directory
-repopack unpack <input.json> [-t TARGET_DIR] [--force]
-
-# Start the MCP server (stdio transport)
-repopack serve
-```
-
-### Examples
-
-```bash
-# Pack current directory, write to file
-repopack pack . -o workspace.json
-
-# Pack a specific project, include binaries
-repopack pack ~/projects/my-app -o my-app.json --include-binary
-
-# Unpack into a new directory
-repopack unpack workspace.json -t ./restored
-
-# Unpack and overwrite existing files
-repopack unpack workspace.json -t ./restored --force
-```
-
-## JSON Payload Schema
-
-```json
-{
-  "version": "1.0",
-  "metadata": {
-    "created_at": "2026-07-26T12:00:00Z",
-    "root_directory_name": "my-app",
-    "detected_stack": ["Node.js", "React", "TypeScript"],
-    "total_files": 38,
-    "total_bytes": 128450
-  },
-  "files": [
-    { "path": "src/App.tsx", "encoding": "utf-8", "content": "..." },
-    { "path": "public/favicon.ico", "encoding": "base64", "content": "..." }
-  ]
-}
-```
-
-## MCP Server Tools
-
-When running `repopack serve`, two tools are registered via FastMCP:
-
-| Tool | Description |
-|---|---|
-| `export_workspace(workspace_path, output_json_path, include_binary)` | Pack a directory into JSON |
-| `import_workspace(json_input, destination_path, overwrite)` | Unpack JSON into a directory |
-
-## Project Structure
-
-```
-repopack/
-├── pyproject.toml
-├── README.md
-└── repopack/
-    ├── __init__.py
-    ├── cli.py          # Typer CLI (pack / unpack / serve)
-    ├── mcp_server.py   # FastMCP server
-    ├── packer.py       # Directory walker & JSON builder
-    ├── unpacker.py     # JSON extractor & path-safe reconstructor
-    └── utils.py        # Ignore engine, binary detector, stack detection
-tests/
-└── test_repopack.py    # 26-test pytest suite
-```
-
-## Running Tests
-
-```bash
-pytest tests/ -v
-```
-
-## Dependencies
-
-- [typer](https://typer.tiangolo.com/) — CLI framework
-- [mcp](https://github.com/modelcontextprotocol/python-sdk) — MCP SDK (FastMCP)
-- [pathspec](https://github.com/cpburnz/python-pathspec) — gitignore wildmatch pattern matching

repopackpy-0.1.8/README.md

@@ -1,139 +0,0 @@
-# RepoPack
-
-Pack/unpack **any source workspace regardless of technology stack** (Python, Node.js, React, Angular, Vue, Rust, Go, Java, C#, and more) into a portable, structured JSON payload — and restore it faithfully from that payload.
-
-## Features
-
-- **Universal ignore engine** — respects root and nested `.gitignore` files plus stack-agnostic defaults (node_modules, __pycache__, .venv, target/, dist/, secrets, lock files, …)
-- **Polyglot stack detection** — auto-detects Node.js, React, TypeScript, Angular, Next.js, Vue, Python, Rust, Go, Java, C# from project sentinel files
-- **Binary safety** — text files encoded as UTF-8; binaries skipped by default or included as Base64 with `--include-binary`
-- **5 MB guard** — files larger than 5 MB are skipped with a warning
-- **Path traversal shield** — `unpack` validates every path against the destination root before writing anything
-- **MCP server** — expose pack/unpack as tools to any MCP-compatible AI client (Claude Desktop, etc.)
-
-## Installation
-
-### From PyPI (recommended)
-
-Install the latest stable release:
-
-```bash
-pip install RepoPackPy
-```
-
-Pin to a specific version:
-
-```bash
-pip install RepoPackPy==0.1.1
-```
-
-Requires Python 3.10+.
-
-### Quick start after install
-
-```bash
-# Verify the install
-repopack --help
-
-# Pack your project
-repopack pack . -o my-workspace.json
-
-# Restore it somewhere else
-repopack unpack my-workspace.json -t ./restored
-```
-
-### For development
-
-Clone the repo and install in editable mode with test dependencies:
-
-```bash
-git clone https://github.com/ShanKonduru/RepoPack.git
-cd RepoPack
-pip install -e ".[dev]"
-```
-
-## CLI Usage
-
-```bash
-# Pack a directory into JSON
-repopack pack [DIRECTORY] [-o output.json] [--include-binary] [--custom-ignore ".next,dist"]
-
-# Unpack JSON back into a directory
-repopack unpack <input.json> [-t TARGET_DIR] [--force]
-
-# Start the MCP server (stdio transport)
-repopack serve
-```
-
-### Examples
-
-```bash
-# Pack current directory, write to file
-repopack pack . -o workspace.json
-
-# Pack a specific project, include binaries
-repopack pack ~/projects/my-app -o my-app.json --include-binary
-
-# Unpack into a new directory
-repopack unpack workspace.json -t ./restored
-
-# Unpack and overwrite existing files
-repopack unpack workspace.json -t ./restored --force
-```
-
-## JSON Payload Schema
-
-```json
-{
-  "version": "1.0",
-  "metadata": {
-    "created_at": "2026-07-26T12:00:00Z",
-    "root_directory_name": "my-app",
-    "detected_stack": ["Node.js", "React", "TypeScript"],
-    "total_files": 38,
-    "total_bytes": 128450
-  },
-  "files": [
-    { "path": "src/App.tsx", "encoding": "utf-8", "content": "..." },
-    { "path": "public/favicon.ico", "encoding": "base64", "content": "..." }
-  ]
-}
-```
-
-## MCP Server Tools
-
-When running `repopack serve`, two tools are registered via FastMCP:
-
-| Tool | Description |
-|---|---|
-| `export_workspace(workspace_path, output_json_path, include_binary)` | Pack a directory into JSON |
-| `import_workspace(json_input, destination_path, overwrite)` | Unpack JSON into a directory |
-
-## Project Structure
-
-```
-repopack/
-├── pyproject.toml
-├── README.md
-└── repopack/
-    ├── __init__.py
-    ├── cli.py          # Typer CLI (pack / unpack / serve)
-    ├── mcp_server.py   # FastMCP server
-    ├── packer.py       # Directory walker & JSON builder
-    ├── unpacker.py     # JSON extractor & path-safe reconstructor
-    └── utils.py        # Ignore engine, binary detector, stack detection
-tests/
-└── test_repopack.py    # 26-test pytest suite
-```
-
-## Running Tests
-
-```bash
-pytest tests/ -v
-```
-
-## Dependencies
-
-- [typer](https://typer.tiangolo.com/) — CLI framework
-- [mcp](https://github.com/modelcontextprotocol/python-sdk) — MCP SDK (FastMCP)
-- [pathspec](https://github.com/cpburnz/python-pathspec) — gitignore wildmatch pattern matching

repopackpy-0.1.8/repopack/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.1.8"