RepoPackPy 0.1.9__py3-none-any.whl → 0.2.0__py3-none-any.whl

repopack/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.9"
+__version__ = "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)

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")
 

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.9.dist-info → repopackpy-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: RepoPackPy
-Version: 0.1.9
+Version: 0.2.0
 Summary: Pack/unpack any source workspace into portable JSON, with MCP server support.
 License: MIT
 License-File: LICENSE
@@ -71,8 +71,10 @@ pip install ".[dev]"
 ## 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 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
 ```
 
@@ -87,6 +89,8 @@ repopack serve
 | `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
 
@@ -108,6 +112,12 @@ 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
@@ -132,6 +142,41 @@ Dry run — destination: /home/user/restored
   ...
 ```
 
+#### 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
@@ -159,8 +204,10 @@ When running `repopack serve`, two tools are registered via FastMCP:
 |---|---|---|
 | `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 either tool to get a plain-text report without reading file content or writing to disk.
+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
 

repopackpy-0.2.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+repopack/__init__.py,sha256=Zn1KFblwuFHiDRdRAiRnDBRkbPttWh44jKa5zG2ov0E,22
+repopack/cli.py,sha256=aoegt3XazDlue_Cj7fSLPc4oloQ-eG4ws9HlgybY89I,6979
+repopack/mcp_server.py,sha256=zIwDCohU8G3qXsnSsC2tqNneLkVMAqs993DDD4uALE4,3246
+repopack/packer.py,sha256=35HHwUSzvNYIxjArzJ-OdYidqSGH8YMs9uQxbDHZ3AE,5841
+repopack/unpacker.py,sha256=pxToRzBMVGnh_gsI3ChXQPdkTf-GBkghTbYHG4ntXJ8,2423
+repopack/utils.py,sha256=UnKnSGl_StMlE4OQI1zCNUl--UPV6VFzW3UGTfsi6JI,4807
+repopackpy-0.2.0.dist-info/METADATA,sha256=8jfT5_mjzPe-aQBDiRRCFNVxhV6J2jnazfT7rSnD4cY,8493
+repopackpy-0.2.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+repopackpy-0.2.0.dist-info/entry_points.txt,sha256=6_yKH4CqxdMrFaHwQH-bKM1XW0lppiBJ3ioWJ8RFlTs,47
+repopackpy-0.2.0.dist-info/licenses/LICENSE,sha256=Z4Oa85qoUpnHkq4Pa4-LOGiCT5cvJaX5_aP0K8OXBNQ,1069
+repopackpy-0.2.0.dist-info/RECORD,,

repopackpy-0.1.9.dist-info/RECORD

@@ -1,11 +0,0 @@
-repopack/__init__.py,sha256=XIaxbMbyiP-L3kguR1GhxirFblTXiHR1lMfDVITvHUI,22
-repopack/cli.py,sha256=oUmkddm7wPeFcnBW5jqZEhnH-U0GgnLxCYFj7jZuvVg,4352
-repopack/mcp_server.py,sha256=WT3r5ASrTqOcZGtoQnVgZvEWcQK_7QsxR3yE4M3QD4c,1965
-repopack/packer.py,sha256=lNwCtbPCKgQTRZW59tn8S9ZkHf5YtDEyY0ITztkY1xs,3196
-repopack/unpacker.py,sha256=pxToRzBMVGnh_gsI3ChXQPdkTf-GBkghTbYHG4ntXJ8,2423
-repopack/utils.py,sha256=UnKnSGl_StMlE4OQI1zCNUl--UPV6VFzW3UGTfsi6JI,4807
-repopackpy-0.1.9.dist-info/METADATA,sha256=-oaP7IprQVZIQmkB838i3vAvs_nhj-tNnm3Et5KA1p4,7069
-repopackpy-0.1.9.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-repopackpy-0.1.9.dist-info/entry_points.txt,sha256=6_yKH4CqxdMrFaHwQH-bKM1XW0lppiBJ3ioWJ8RFlTs,47
-repopackpy-0.1.9.dist-info/licenses/LICENSE,sha256=Z4Oa85qoUpnHkq4Pa4-LOGiCT5cvJaX5_aP0K8OXBNQ,1069
-repopackpy-0.1.9.dist-info/RECORD,,