gitwise-cli 0.34.2__tar.gz → 0.35.1__tar.gz

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/CHANGELOG.md

@@ -3,6 +3,22 @@
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v0.35.1 (2026-07-22)
+
+### Fix
+
+- **snapshot**: honor canonical agents layout
+
+## v0.35.0 (2026-07-22)
+
+### Feat
+
+- **context**: bound agent output with truncation metadata
+
+### Fix
+
+- **cli**: keep JSON Lines free of human timing
+
 ## v0.34.2 (2026-07-22)
 
 ### Fix

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitwise-cli
-Version: 0.34.2
+Version: 0.35.1
 Summary: Python CLI for optimizing git workflows and Claude Code integration
 Project-URL: Homepage, https://github.com/drzioner/gitwise
 Project-URL: Repository, https://github.com/drzioner/gitwise

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/__init__.py

@@ -1,6 +1,6 @@
 """gitwise -- CLI for optimizing git workflows and coding-agent integration."""
 
-__version__ = "0.34.2"
+__version__ = "0.35.1"
 
 
 def get_version() -> str:

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/__main__.py

@@ -113,7 +113,8 @@ def main() -> int:
         reset_runtime_config()
 
     set_json_pretty(args.json_pretty)
-    set_json_mode(args.json)
+    machine_output = args.json or getattr(args, "json_lines", False)
+    set_json_mode(machine_output)
 
     if args.lang:
         set_locale(args.lang)
@@ -147,8 +148,7 @@ def main() -> int:
         ret = 1
 
     elapsed = time.monotonic() - start
-    as_json = getattr(args, "json", False)
-    if not as_json and elapsed > 0.2 and args.command not in ("doctor",):
+    if not machine_output and elapsed > 0.2 and args.command not in ("doctor",):
         print_dim(t("completed_in", elapsed=f"{elapsed:.1f}"))
 
     return ret

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/_cli_dispatch.py

@@ -328,7 +328,7 @@ def _run_context(args: argparse.Namespace) -> int:
     """Dispatch to ``context`` subcommand."""
     from gitwise.context import run_context
 
-    return run_context(as_json=args.json)
+    return run_context(max_entries=args.max_entries, as_json=args.json)
 
 
 def _run_health(args: argparse.Namespace) -> int:

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/_cli_introspection.py

@@ -233,7 +233,12 @@ def _action_property_schema(action: argparse.Action) -> dict[str, object]:
 
     # A "limit"/"max-count" argument is a positive-integer bound; surface that
     # in the input schema so consumers know 0/negative are invalid.
-    if value_schema["type"] == "integer" and action.dest in {"limit", "max_count", "maxcount"}:
+    if value_schema["type"] == "integer" and action.dest in {
+        "limit",
+        "max_count",
+        "max_entries",
+        "maxcount",
+    }:
         value_schema["minimum"] = 1
 
     description = "" if action.help is argparse.SUPPRESS else (action.help or "")

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/_cli_parser.py

@@ -353,6 +353,12 @@ def build_parser() -> argparse.ArgumentParser:
     p.add_argument("--yes", "-y", action="store_true", help="skip confirmation for --hard")
 
     p = sub.add_parser("context", help="enriched repo snapshot for LLMs", parents=[parent])
+    p.add_argument(
+        "--max-entries",
+        type=int,
+        default=100,
+        help="maximum directory tree entries (default: 100)",
+    )
 
     p = sub.add_parser("health", help="repo health score (0-100)", parents=[parent])
 

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/_i18n_data.json

@@ -395,6 +395,10 @@
     "es": "## Tipos de archivo",
     "en": "## File Types"
   },
+  "ctx_invalid_max_entries": {
+    "es": "--max-entries debe ser mayor que cero",
+    "en": "--max-entries must be greater than zero"
+  },
   "ctx_more_entries": {
     "es": "  ... ({count} entradas más)",
     "en": "  ... ({count} more entries)"

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/context.py

@@ -12,10 +12,13 @@ from gitwise.output import (
     print_dim,
     print_header,
     print_json,
+    report_error,
     status,
 )
 from gitwise.utils.json_envelope import ok_envelope
 
+DEFAULT_MAX_ENTRIES = 100
+
 
 def _directory_tree(root: Path, max_depth: int = 3) -> list[str]:
     """Return Unicode box-drawing lines for the directory tree, skipping common noise dirs."""
@@ -118,14 +121,24 @@ def _branch_topology(root: Path) -> dict[str, list[str]]:
     return {"local": local, "remote": remote}
 
 
-def run_context(*, as_json: bool = False) -> int:
+def run_context(*, max_entries: int = DEFAULT_MAX_ENTRIES, as_json: bool = False) -> int:
     """Entry point for the ``gitwise context`` command."""
     root = require_root(as_json=as_json, command="context")
     if root is None:
         return 1
+    if max_entries <= 0:
+        return report_error(
+            "context",
+            as_json=as_json,
+            msg=t("ctx_invalid_max_entries"),
+            code="invalid_max_entries",
+        )
 
     with status(t("status_context_scan")):
-        tree = _directory_tree(root)
+        full_tree = _directory_tree(root)
+        tree = full_tree[:max_entries]
+        tree_total = len(full_tree)
+        tree_truncated = tree_total > len(tree)
         contributors = _top_contributors(root)
         file_types = _file_type_breakdown(root)
         todo_fixme = _todo_fixme_counts(root)
@@ -140,6 +153,8 @@ def run_context(*, as_json: bool = False) -> int:
                 "context",
                 data={
                     "tree": tree,
+                    "tree_total": tree_total,
+                    "tree_truncated": tree_truncated,
                     "contributors": contributors,
                     "file_types": file_types,
                     "todo_fixme": todo_fixme,
@@ -150,10 +165,10 @@ def run_context(*, as_json: bool = False) -> int:
         )
     else:
         print_header(t("ctx_directory_tree"))
-        for ln in tree[:50]:
+        for ln in tree:
             info(f"  {ln}")
-        if len(tree) > 50:
-            print_dim(t("ctx_more_entries", count=str(len(tree) - 50)))
+        if tree_truncated:
+            print_dim(t("ctx_more_entries", count=str(tree_total - len(tree))))
         print_blank()
         if contributors:
             print_bracket(t("ctx_top_contributors"))

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/gitwise/snapshot.py

@@ -10,6 +10,13 @@ from gitwise.output import debug, print_header, print_json, status
 from gitwise.utils.json_envelope import ok_envelope
 
 
+def _snapshot_relative_path(root: Path) -> str:
+    """Return the snapshot path for the repository's active agent layout."""
+    if (root / ".agents").is_dir():
+        return ".agents/git-snapshot.md"
+    return ".claude/git-snapshot.md"
+
+
 def _append_branch_section(lines: list[str], *, root: Path) -> None:
     """Append the current branch section to *lines*."""
     branch = git_run(["branch", "--show-current"], cwd=root, check=False)
@@ -105,7 +112,7 @@ def run_snapshot(*, as_json: bool = False) -> int:
         return 1
 
     with status(t("status_snapshot_gen")):
-        path = generate_snapshot(root)
+        path = generate_snapshot(root, relative_path=_snapshot_relative_path(root))
 
     if as_json:
         print_json(ok_envelope("snapshot", path=str(path)))

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitwise-cli"
-version = "0.34.2"
+version = "0.35.1"
 description = "Python CLI for optimizing git workflows and Claude Code integration"
 readme = "README.md"
 license = "MIT"

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/claude/rules/gitwise.md

@@ -9,7 +9,7 @@ globs: "**/*"
 - Changed files: `gitwise diff` — never raw `git diff`
 - Status + log: `gitwise summarize` — never raw `git status` or `git log`
 - Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
-- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Snapshot: `gitwise snapshot`; writes `.agents/git-snapshot.md` when `.agents/` exists, otherwise `.claude/git-snapshot.md`
 
 ## Shell note
 

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/codex/agents/gitwise.toml.template

@@ -10,7 +10,7 @@ developer_instructions = """
 - Changed files: `gitwise diff` — never raw `git diff`
 - Status + log: `gitwise summarize` — never raw `git status` or `git log`
 - Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
-- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Snapshot: `gitwise snapshot`; writes `.agents/git-snapshot.md` when `.agents/` exists, otherwise `.claude/git-snapshot.md`
 
 ## Shell note
 

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/continue/rules/gitwise.md.template

@@ -8,7 +8,7 @@ description: Use gitwise CLI for git operations — gitwise diff, summarize, wor
 - Changed files: `gitwise diff` — never raw `git diff`
 - Status + log: `gitwise summarize` — never raw `git status` or `git log`
 - Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
-- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Snapshot: `gitwise snapshot`; writes `.agents/git-snapshot.md` when `.agents/` exists, otherwise `.claude/git-snapshot.md`
 - Audit: `gitwise audit --quick` — before large commits
 - Clean: `gitwise clean --branches` — remove stale branches
 - Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/cursor/rules/gitwise.mdc.template

@@ -10,7 +10,7 @@ alwaysApply: true
 - Changed files: `gitwise diff` — never raw `git diff`
 - Status + log: `gitwise summarize` — never raw `git status` or `git log`
 - Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
-- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Snapshot: `gitwise snapshot`; writes `.agents/git-snapshot.md` when `.agents/` exists, otherwise `.claude/git-snapshot.md`
 - Audit: `gitwise audit --quick` — before large commits
 - Clean: `gitwise clean --branches` — remove stale branches
 - Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/opencode/agents/gitwise.md.template

@@ -8,7 +8,7 @@ description: Use gitwise CLI for git operations — gitwise diff, summarize, wor
 - Changed files: `gitwise diff` — never raw `git diff`
 - Status + log: `gitwise summarize` — never raw `git status` or `git log`
 - Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
-- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Snapshot: `gitwise snapshot`; writes `.agents/git-snapshot.md` when `.agents/` exists, otherwise `.claude/git-snapshot.md`
 - Audit: `gitwise audit --quick` — before large commits
 - Clean: `gitwise clean --branches` — remove stale branches
 - Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/pi/skills/gitwise.md.template

@@ -8,7 +8,7 @@ description: Use gitwise CLI for git operations — gitwise diff, summarize, wor
 - Changed files: `gitwise diff` — never raw `git diff`
 - Status + log: `gitwise summarize` — never raw `git status` or `git log`
 - Branch switch: `gitwise worktree new <branch>` — never `git stash + checkout`
-- Snapshot: `gitwise snapshot` — regenerates `.claude/git-snapshot.md`
+- Snapshot: `gitwise snapshot`; writes `.agents/git-snapshot.md` when `.agents/` exists, otherwise `.claude/git-snapshot.md`
 - Audit: `gitwise audit --quick` — before large commits
 - Clean: `gitwise clean --branches` — remove stale branches
 - Optimize: `gitwise optimize` — gc, pack-refs, commit-graph

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/schemas/v1/input/context.json

@@ -31,6 +31,12 @@
       "type": "boolean",
       "description": "pretty-print JSON output",
       "default": false
+    },
+    "max_entries": {
+      "type": "integer",
+      "minimum": 1,
+      "description": "maximum directory tree entries (default: 100)",
+      "default": 100
     }
   }
 }

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/share/schemas/v1/output/context.json

@@ -52,7 +52,21 @@
     },
     "data": {
       "type": "object",
-      "properties": {}
+      "properties": {
+        "tree": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "tree_total": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "tree_truncated": {
+          "type": "boolean"
+        }
+      }
     }
   }
 }

gitwise_cli-0.35.1/tests/test_context.py

@@ -0,0 +1,63 @@
+"""Tests for gitwise context command."""
+
+import json
+
+from conftest import run_gitwise
+
+
+def test_context_json(tmp_git_repo):
+    r = run_gitwise("context", "--json", cwd=tmp_git_repo)
+    assert r.returncode == 0
+    data = json.loads(r.stdout)
+    assert data["v"] == 3
+    inner = data["data"]
+    assert isinstance(inner["tree"], list)
+    assert isinstance(inner["contributors"], list)
+    assert isinstance(inner["file_types"], dict)
+    assert "todo_fixme" in inner
+    assert "branches" in inner
+
+
+def test_context_human(tmp_git_repo):
+    r = run_gitwise("context", cwd=tmp_git_repo)
+    assert r.returncode == 0
+    assert "Directory Tree" in r.stdout
+
+
+def test_context_json_limits_tree_and_reports_truncation(tmp_git_repo):
+    for index in range(5):
+        (tmp_git_repo / f"file-{index}.txt").write_text("x")
+
+    r = run_gitwise("context", "--max-entries", "2", "--json", cwd=tmp_git_repo)
+
+    assert r.returncode == 0
+    data = json.loads(r.stdout)["data"]
+    assert len(data["tree"]) == 2
+    assert data["tree_total"] >= 5
+    assert data["tree_truncated"] is True
+
+
+def test_context_json_rejects_non_positive_max_entries(tmp_git_repo):
+    r = run_gitwise("context", "--max-entries", "0", "--json", cwd=tmp_git_repo)
+
+    assert r.returncode == 1
+    data = json.loads(r.stdout)
+    assert data["errors"][0]["code"] == "invalid_max_entries"
+
+
+def test_context_json_default_limits_tree_to_one_hundred_entries(tmp_git_repo):
+    for index in range(105):
+        (tmp_git_repo / f"wide-file-{index:03d}.txt").write_text("x")
+
+    r = run_gitwise("context", "--json", cwd=tmp_git_repo)
+
+    assert r.returncode == 0
+    data = json.loads(r.stdout)["data"]
+    assert len(data["tree"]) == 100
+    assert data["tree_total"] >= 105
+    assert data["tree_truncated"] is True
+
+
+def test_context_not_git(tmp_path):
+    r = run_gitwise("context", cwd=tmp_path)
+    assert r.returncode == 1

{gitwise_cli-0.34.2 → gitwise_cli-0.35.1}/tests/test_snapshot.py

@@ -1,5 +1,6 @@
 """Tests for gitwise snapshot."""
 
+import json
 import time
 
 from conftest import run_gitwise as _run
@@ -12,6 +13,18 @@ def test_snapshot_creates_file(tmp_git_repo):
     assert snapshot.exists()
 
 
+def test_snapshot_uses_agents_layout_when_present(tmp_git_repo):
+    (tmp_git_repo / ".agents").mkdir()
+
+    result = _run("snapshot", "--json", cwd=tmp_git_repo)
+
+    assert result.returncode == 0
+    data = json.loads(result.stdout)["data"]
+    assert data["path"].endswith(".agents/git-snapshot.md")
+    assert (tmp_git_repo / ".agents" / "git-snapshot.md").exists()
+    assert not (tmp_git_repo / ".claude" / "git-snapshot.md").exists()
+
+
 def test_snapshot_has_generated_at(tmp_git_repo):
     _run("snapshot", cwd=tmp_git_repo)
     content = (tmp_git_repo / ".claude" / "git-snapshot.md").read_text()

gitwise_cli-0.34.2/tests/test_context.py

@@ -1,29 +0,0 @@
-"""Tests for gitwise context command."""
-
-import json
-
-from conftest import run_gitwise
-
-
-def test_context_json(tmp_git_repo):
-    r = run_gitwise("context", "--json", cwd=tmp_git_repo)
-    assert r.returncode == 0
-    data = json.loads(r.stdout)
-    assert data["v"] == 3
-    inner = data["data"]
-    assert isinstance(inner["tree"], list)
-    assert isinstance(inner["contributors"], list)
-    assert isinstance(inner["file_types"], dict)
-    assert "todo_fixme" in inner
-    assert "branches" in inner
-
-
-def test_context_human(tmp_git_repo):
-    r = run_gitwise("context", cwd=tmp_git_repo)
-    assert r.returncode == 0
-    assert "Directory Tree" in r.stdout
-
-
-def test_context_not_git(tmp_path):
-    r = run_gitwise("context", cwd=tmp_path)
-    assert r.returncode == 1