workspace-repo-map 0.2.0__tar.gz

workspace_repo_map-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install -e ".[test]"
+      - run: python -m pytest

workspace_repo_map-0.2.0/.github/workflows/release-artifacts.yml

@@ -0,0 +1,26 @@
+name: Release Artifacts
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Build package
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+          python -m build
+          python -m twine check dist/*
+      - uses: actions/upload-artifact@v5
+        with:
+          name: workspace-repo-map-dist
+          path: dist/*

workspace_repo_map-0.2.0/.gitignore

@@ -0,0 +1,10 @@
+__pycache__/
+.pytest_cache/
+.venv/
+env/
+*.pyc
+.idea/
+dist/
+build/
+.ruff_cache/
+.mypy_cache/

workspace_repo_map-0.2.0/.warden-safe-cache/prompts/2450a49b8338078957f882e5.audit.json

@@ -0,0 +1,5 @@
+{
+  "session_id": "2a7ea611-2ded-46e4-9204-a5c2a3024929",
+  "audit_counts": {},
+  "total": 0
+}

workspace_repo_map-0.2.0/.warden-safe-cache/prompts/2450a49b8338078957f882e5.raw

@@ -0,0 +1 @@
+yes for all

workspace_repo_map-0.2.0/AUTHORS.md

@@ -0,0 +1 @@
+Zain Dana Harper

workspace_repo_map-0.2.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+## Unreleased
+
+- Makes generated repository maps portable by default.
+- Replaces absolute local root paths with a root hash prefix.
+- Omits protected remotes and redacts credential-shaped remote URL material.
+
+## 0.2.0 - 2026-06-18
+
+- Config-driven classification via optional `.repomap.toml` (ordered path-glob rules,
+  neutral remote-host fallback). Personal taxonomy moves to user config.
+- Unifies the CLI into a single argument parser; removes the duplicate.
+- Adds a stable public API (`__all__`, `__version__`) and a versioned output
+  (`schema_version: 1`); drops the duplicated `relative` field and protected-specific
+  counts in favor of generic `class_counts`.
+- Parallelizes per-repo git calls; output remains deterministic.
+- Adds a portable (default) / local output mode and an `annotations` passthrough.
+- Raises the Python floor to 3.11 (stdlib `tomllib`); runtime dependencies stay empty.
+
+## 0.1.0 - 2026-06-13
+
+- Initial public release candidate.
+- Ships compact JSON repository inventory mapping for multi-repo local
+  workspaces.
+- Adds Python package metadata, CI, license, authorship, and contribution
+  boundary files.

workspace_repo_map-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,12 @@
+# Contributing
+
+## Success Criteria
+
+- Public docs and scripts include explicit references to known limitations.
+- No secrets and no em-dash characters in public markdown.
+- Release artifacts are deterministic and reproducible.
+- Tests cover core behavior.
+
+## How to Contribute
+
+Open PRs with targeted changes and include test coverage for behavior changes.

workspace_repo_map-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zain Dana Harper
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

workspace_repo_map-0.2.0/PKG-INFO

@@ -0,0 +1,78 @@
+Metadata-Version: 2.4
+Name: workspace-repo-map
+Version: 0.2.0
+Summary: Compact JSON repository inventory maps for multi-repo workspaces.
+Project-URL: Homepage, https://github.com/HarperZ9/workspace-repo-map
+Project-URL: Repository, https://github.com/HarperZ9/workspace-repo-map
+Project-URL: Issues, https://github.com/HarperZ9/workspace-repo-map/issues
+Author: Zain Dana Harper
+License: MIT
+License-File: AUTHORS.md
+License-File: LICENSE
+Keywords: cli,git,inventory,workspace
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.11
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# Workspace Repo Map
+
+> Compact JSON repository inventory maps for multi-repo workspaces.
+
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+![python](https://img.shields.io/badge/python-3.11%2B-blue.svg)
+![version](https://img.shields.io/badge/version-0.2.0-informational.svg)
+[![CI](https://github.com/HarperZ9/workspace-repo-map/actions/workflows/ci.yml/badge.svg)](https://github.com/HarperZ9/workspace-repo-map/actions/workflows/ci.yml)
+![deps: none](https://img.shields.io/badge/deps-none-success.svg)
+[![part of: AI-accountability toolkit](https://img.shields.io/badge/part_of-AI--accountability_toolkit-7a5cff.svg)](https://harperz9.github.io)
+
+`workspace-repo-map` scans a workspace root for Git repositories and writes a
+compact JSON map of remotes, branches, dirty counts, marker files, and public or
+local-only classification hints.
+
+Generated maps are portable by default: repository paths are root-relative, the local
+root is represented by a short hash, and credential-shaped material in remote URLs is
+always redacted. Dropping whole origins by class is opt-in via `.repomap.toml`.
+
+## Install
+
+```bash
+python -m pip install workspace-repo-map
+```
+
+## Usage
+
+```bash
+workspace-repo-map --root . --output WORKSPACE-REPO-MAP.json
+workspace-repo-map --json
+```
+
+Without `--json`, the map is written to `<root>/WORKSPACE-REPO-MAP.json` (or `--output`)
+and a one-line summary (`wrote <path>` / `repos=N dirty=M`) is printed.
+
+Classification is driven by an optional `.repomap.toml` at the workspace root (see
+`example.repomap.toml`). With no config, repos are classified by a neutral remote-host
+heuristic: `local` (no remote), `public` (origin on a public host), or `private`. Here
+`public` means "origin is on a public code-hosting platform" — a heuristic, not a
+guarantee of visibility.
+
+For a full install line, the complete flag list, the importable Python API, and worked
+examples with expected output, see [USAGE.md](USAGE.md). A runnable end-to-end demo lives
+in [`examples/demo.py`](examples/demo.py).
+
+## Notes
+
+- This CLI is agent assisted. Review output before sharing it in public.
+- Repository names and branch details are exported from local git metadata.
+- Absolute local root paths are not included by default.
+
+---
+**Zain Dana Harper** — small tools with explicit edges.
+[Portfolio](https://harperz9.github.io) · [HarperZ9](https://github.com/HarperZ9)
+<sub>Built with Claude Code; reviewed, tested, and owned by me.</sub>

workspace_repo_map-0.2.0/README.md

@@ -0,0 +1,55 @@
+# Workspace Repo Map
+
+> Compact JSON repository inventory maps for multi-repo workspaces.
+
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+![python](https://img.shields.io/badge/python-3.11%2B-blue.svg)
+![version](https://img.shields.io/badge/version-0.2.0-informational.svg)
+[![CI](https://github.com/HarperZ9/workspace-repo-map/actions/workflows/ci.yml/badge.svg)](https://github.com/HarperZ9/workspace-repo-map/actions/workflows/ci.yml)
+![deps: none](https://img.shields.io/badge/deps-none-success.svg)
+[![part of: AI-accountability toolkit](https://img.shields.io/badge/part_of-AI--accountability_toolkit-7a5cff.svg)](https://harperz9.github.io)
+
+`workspace-repo-map` scans a workspace root for Git repositories and writes a
+compact JSON map of remotes, branches, dirty counts, marker files, and public or
+local-only classification hints.
+
+Generated maps are portable by default: repository paths are root-relative, the local
+root is represented by a short hash, and credential-shaped material in remote URLs is
+always redacted. Dropping whole origins by class is opt-in via `.repomap.toml`.
+
+## Install
+
+```bash
+python -m pip install workspace-repo-map
+```
+
+## Usage
+
+```bash
+workspace-repo-map --root . --output WORKSPACE-REPO-MAP.json
+workspace-repo-map --json
+```
+
+Without `--json`, the map is written to `<root>/WORKSPACE-REPO-MAP.json` (or `--output`)
+and a one-line summary (`wrote <path>` / `repos=N dirty=M`) is printed.
+
+Classification is driven by an optional `.repomap.toml` at the workspace root (see
+`example.repomap.toml`). With no config, repos are classified by a neutral remote-host
+heuristic: `local` (no remote), `public` (origin on a public host), or `private`. Here
+`public` means "origin is on a public code-hosting platform" — a heuristic, not a
+guarantee of visibility.
+
+For a full install line, the complete flag list, the importable Python API, and worked
+examples with expected output, see [USAGE.md](USAGE.md). A runnable end-to-end demo lives
+in [`examples/demo.py`](examples/demo.py).
+
+## Notes
+
+- This CLI is agent assisted. Review output before sharing it in public.
+- Repository names and branch details are exported from local git metadata.
+- Absolute local root paths are not included by default.
+
+---
+**Zain Dana Harper** — small tools with explicit edges.
+[Portfolio](https://harperz9.github.io) · [HarperZ9](https://github.com/HarperZ9)
+<sub>Built with Claude Code; reviewed, tested, and owned by me.</sub>

workspace_repo_map-0.2.0/RELEASE.md

@@ -0,0 +1,16 @@
+# Release Checklist
+
+## 0.1.0 Candidate
+
+- [ ] Confirm `README.md`, `LICENSE`, `AUTHORS.md`, `CONTRIBUTING.md`, and
+  `CHANGELOG.md` are present.
+- [ ] Run `python -m pytest -q`.
+- [ ] Run `python -m build`.
+- [ ] Run `python -m twine check dist/*`.
+- [ ] Run `public-surface-sweeper . --summary`.
+- [ ] Create a signed `v0.1.0` tag when signing is configured, or an
+  annotated `v0.1.0` tag when it is not.
+- [ ] Publish to PyPI only after account ownership, 2FA, and trusted publishing
+  configuration are confirmed.
+
+This repository does not auto-publish to a package registry.

workspace_repo_map-0.2.0/USAGE.md

@@ -0,0 +1,215 @@
+# Usage
+
+`workspace-repo-map` scans a workspace root for Git repositories and emits a compact
+JSON inventory map. It ships a CLI (`workspace-repo-map`) and a small importable Python
+API. Runtime dependencies: none. Python: 3.11+.
+
+## Install
+
+```bash
+python -m pip install workspace-repo-map
+```
+
+Or from a checkout (editable):
+
+```bash
+python -m pip install -e .
+```
+
+## CLI
+
+The console script is `workspace-repo-map` (equivalently `python -m workspace_repo_map`).
+
+```text
+workspace-repo-map [--root ROOT] [--output OUTPUT] [--json]
+                   [--config CONFIG] [--jobs JOBS] [--version]
+```
+
+| Flag        | Default                          | Meaning                                              |
+| ----------- | -------------------------------- | ---------------------------------------------------- |
+| `--root`    | current directory                | Workspace root to scan.                              |
+| `--output`  | `<root>/WORKSPACE-REPO-MAP.json` | Output path (ignored when `--json` is given).        |
+| `--json`    | off                              | Print the JSON map to stdout instead of writing it.  |
+| `--config`  | `<root>/.repomap.toml` if present | Path to a `.repomap.toml`. Missing explicit path is fatal. |
+| `--jobs`    | config / CPU heuristic           | Override the parallel git worker count (must be ≥ 1).|
+| `--version` | —                                | Print `workspace-repo-map 0.2.0` and exit.           |
+
+Classification with no config falls back to a remote-host heuristic: `local` (no
+remote), `public` (origin host in the known public set), or `private`. Supply a
+`.repomap.toml` (see `example.repomap.toml`) for ordered path-glob rules.
+
+### Example 1 — print a map to stdout
+
+```bash
+workspace-repo-map --root ./my-workspace --json
+```
+
+Expected output (illustrative — paths, hashes, and timestamps vary):
+
+```json
+{
+  "schema_version": 1,
+  "tool_version": "0.2.0",
+  "generated_at": "2026-06-18T10:16:44-07:00",
+  "root_sha256_prefix": "617a55395ac0d599",
+  "absolute_paths_included": false,
+  "repo_count": 2,
+  "dirty_count": 0,
+  "class_counts": {
+    "public": 1,
+    "local": 1
+  },
+  "top_level": [
+    { "name": "proj-a", "kind": "directory", "class": "entry", "bytes": null,
+      "modified": "2026-06-18T10:16:37-07:00" },
+    { "name": "proj-b", "kind": "directory", "class": "entry", "bytes": null,
+      "modified": "2026-06-18T10:16:37-07:00" }
+  ],
+  "repositories": [
+    { "path": "proj-a", "class": "public", "branch": "main", "head": "eb4e19b",
+      "origin": "https://github.com/example/proj-a.git",
+      "dirty_count": 0, "untracked_count": 1, "markers": ["README.md"] },
+    { "path": "proj-b", "class": "local", "branch": "main", "head": "e4f1b0c",
+      "origin": "", "dirty_count": 0, "untracked_count": 0,
+      "markers": ["pyproject.toml"] }
+  ]
+}
+```
+
+### Example 2 — write a map file (default mode)
+
+```bash
+workspace-repo-map --root ./my-workspace
+```
+
+Expected output (illustrative):
+
+```text
+wrote /path/to/my-workspace/WORKSPACE-REPO-MAP.json
+repos=2 dirty=0
+```
+
+The JSON file content matches the structure shown in Example 1.
+
+### Example 3 — custom output path and worker count
+
+```bash
+workspace-repo-map --root ./my-workspace --output ./inventory.json --jobs 8
+```
+
+Expected output (illustrative):
+
+```text
+wrote /path/to/inventory.json
+repos=2 dirty=0
+```
+
+### Example 4 — use an explicit config
+
+```bash
+workspace-repo-map --root ./my-workspace --config ./example.repomap.toml --json
+```
+
+Rules in the config are matched against each repo's workspace-relative path (first
+match wins) before the remote-host fallback. A `--config` path that does not exist is a
+fatal error (non-zero exit).
+
+## Configuration (`.repomap.toml`)
+
+Place a `.repomap.toml` at the workspace root (auto-discovered) or pass `--config PATH`.
+Every section is optional; with no file, the neutral remote-host heuristic applies.
+
+```toml
+# Ordered classification rules — first match wins. `pattern` is matched against each
+# repo's workspace-relative POSIX path (and against top-level entry names).
+[[rule]]
+pattern = "oss/**"     # *  matches within one path segment (stops at "/")
+class   = "public"     # ** matches across segments; "oss/**" also matches bare "oss"
+
+[[rule]]
+pattern = "work/**"
+class   = "internal"
+
+[scan]
+jobs    = 16            # parallel git workers (default: a CPU heuristic)
+prune   = ["vendor"]   # ADDED to the built-in safety set (.git, node_modules, .venv, ...)
+markers = ["go.mod"]   # REPLACES the default marker-file list when present
+
+[privacy]
+omit_origin_classes = ["internal"]   # blank the `origin` for repos of these classes
+
+[output]
+portable    = true                   # false = absolute paths + a `root` field (private local maps)
+annotations = { team = "infra" }     # arbitrary key/values emitted verbatim under "annotations"
+```
+
+When no rule matches a repo, classification falls back to the remote host: no remote →
+`local`, a public-hosting domain (`github.com`, `gitlab.com`, `bitbucket.org`,
+`codeberg.org`, `git.sr.ht`) → `public`, otherwise → `private`. Credential-shaped material
+in remote URLs is redacted in **every** mode; `portable = false` additionally emits
+absolute paths and a `root` field and is meant only for maps that never leave the machine.
+
+## Python API
+
+The package exposes a stable surface via `__all__`:
+
+```python
+from workspace_repo_map import (
+    build_map, write_map, discover_repos,
+    Map, RepoRow, SCHEMA_VERSION,
+    Config, Rule, load_config, default_config,
+    classify, __version__,
+)
+```
+
+Key entry points:
+
+- `build_map(root: Path, config: Config, tool_version: str) -> Map` — scan and return
+  the in-memory map.
+- `write_map(root, config, tool_version, output: Path) -> Map` — same, but also writes
+  pretty JSON to `output`.
+- `load_config(path: Path | None, root: Path) -> Config` / `default_config() -> Config`.
+- `classify(path: str, is_repo: bool, origin: str, config: Config) -> str`.
+- `Map.to_json()` / `RepoRow.to_json()` — plain-dict serialization.
+
+### Example — build a map in code
+
+```python
+from pathlib import Path
+from workspace_repo_map import build_map, default_config, __version__
+
+config = default_config()
+m = build_map(Path("./my-workspace"), config, __version__)
+
+print(m.repo_count, m.dirty_count)   # e.g. 2 0
+print(m.class_counts)                # e.g. {'public': 1, 'local': 1}
+for row in m.repositories:
+    print(row.path, row.class_, row.branch, row.head)
+```
+
+Expected output (illustrative):
+
+```text
+2 0
+{'public': 1, 'local': 1}
+proj-a public main eb4e19b
+proj-b local main e4f1b0c
+```
+
+### Example — classify a single path
+
+```python
+from workspace_repo_map import classify, default_config
+
+cfg = default_config()
+classify("proj-a", True, "https://github.com/example/proj-a.git", cfg)  # -> "public"
+classify("proj-b", True, "", cfg)                                       # -> "local"
+```
+
+## Notes
+
+- This CLI is agent assisted. Review output before sharing it in public.
+- Maps are portable by default: repo paths are root-relative, the absolute root is
+  replaced by a short hash prefix, and credential-shaped material in remote URLs is
+  redacted.
+- The output schema is versioned (`schema_version: 1`).