gardusig-cli 0.1.0__tar.gz

gardusig_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gustavo Gardusi
+
+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.

gardusig_cli-0.1.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: gardusig-cli
+Version: 0.1.0
+Summary: macOS CLI for git shortcuts, backups, and sync workflows
+Author: gardusig
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/gardusig/cli
+Project-URL: Repository, https://github.com/gardusig/cli
+Project-URL: Issues, https://github.com/gardusig/cli/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.3; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Dynamic: license-file
+
+# cli
+
+macOS CLI: **`cli git`** · **`cli drive`** · **`cli chrome`** · **`cli notion`**.
+
+## Naming
+
+| Context | Identifier |
+| --- | --- |
+| **GitHub repo** | [gardusig/cli](https://github.com/gardusig/cli) (clone path is usually `cli/`) |
+| **PyPI package** | `gardusig-cli` — `pip install gardusig-cli` |
+| **Console command** | `cli` (unchanged after PyPI install) |
+| **Python import** | `cli` |
+
+The repo stays **`cli`**; only the published distribution name on PyPI is **`gardusig-cli`** (`cli` is taken on PyPI).
+
+## Requirements
+
+| Tool | Needed for |
+| --- | --- |
+| **macOS** | Primary target for local use |
+| **Python 3.12+** | Local install (`bootstrap.sh` creates a venv) |
+| **[Homebrew](https://brew.sh/)** | Recommended way to install Python and git on macOS |
+| **git** | `cli git` (run from inside a repository) |
+| **zip** | Encrypted tag archives (`cli drive ingest` on `encrypted: true` repos) |
+| **[Docker Desktop](https://www.docker.com/products/docker-desktop/)** | Verification — `./scripts/test-unit.sh` and `./scripts/test-integration.sh` in Docker |
+
+Install Python and git with Homebrew:
+
+```bash
+brew install python@3.12 git
+```
+
+Optional: `gh` (GitHub CLI) for [cursor-skills](https://github.com/gardusig/cursor-skills) workflows — not required by cli itself.
+
+## Configuration (global)
+
+Cli reads **`config/config.yaml`** in the clone, or **`~/.config/cli/`** after install. Override the directory with `CLI_CONFIG_DIR`.
+
+Copy the bundled `config/` tree and edit paths for your machine before daily use:
+
+| Setting | Config key | Purpose |
+| --- | --- | --- |
+| **Git repositories** | `backup.repositories[].path` | Repos for `cli drive ingest` / `drive status` |
+| **Tag zip folder** | `backup.tags_dir` | Local store (default: iCloud `git-tags/`) — source for `drive upload` |
+| **Cloud upload roots** | `drives.yaml` → `google` / `onedrive` / `proton` | Remote folder names per provider |
+| **Notion task root** | `notion.task_root` | Private `header/` + `body/` task files |
+| **Notion pairs manifest** | `notion.pairs_file` | `config/notion/tasks.pairs.json` in this repo |
+| **Notion database** | `notion.database_id` | Existing board ID + `NOTION_TOKEN` env |
+| **Backup zip password** | `BACKUP_ZIP_PASSWORD` env | Encrypted repos (`encrypted: true` in `backup.repositories`) |
+| **Chrome bookmarks file** | `chrome.bookmarks_file` | HTML backup (`chrome bookmarks ingest`) |
+| **Chrome downloads** | `chrome.downloads_dir` | Folder polled when ingesting from Chrome |
+
+Example `config.yaml`:
+
+```yaml
+backup:
+  tags_dir: ~/Library/Mobile Documents/com~apple~CloudDocs/git-tags
+  repositories:
+    - path: ~/git-local/cli
+    - path: ~/git-local/my-other-repo
+
+notion:
+  database_id: your-notion-database-id
+  task_root: ~/git-local/private/configured/tasks
+  pairs_file: config/notion/tasks.pairs.json
+
+chrome:
+  profile: Default
+  bookmarks_file: ~/git-local/private/bookmarks/bookmarks.html
+  downloads_dir: ~/Downloads
+```
+
+Test fixtures (not for production) live under `tests/fixtures/notion/tasks` and `tests/fixtures/bookmarks.html`.
+
+Cloud providers: `config/drives.yaml`. Notion token: **`export NOTION_TOKEN=...`** (never commit).
+
+Environment overrides (optional): `CLI_BOOKMARKS_FILE`, `CLI_DOWNLOADS_DIR`, `CLI_CONFIG_DIR`, `NOTION_TOKEN`.
+
+## Install (macOS)
+
+**Global install (recommended):** `cli` works in any terminal after one setup.
+
+```bash
+./scripts/install.sh
+# open a new terminal OR: source ~/.zprofile
+cli --version
+cli git --help
+```
+
+**Dev install (current shell only):** venv + runtime deps for working in this repo.
+
+```bash
+./scripts/bootstrap.sh
+source .venv/bin/activate
+python -m cli --help
+```
+
+Verification always runs in Docker — same image locally and in CI. Do not run `pytest` on the host; use `./scripts/test-unit.sh` and `./scripts/test-integration.sh` instead.
+
+## Common git commands
+
+Run from inside a repository (`cd` into the repo first).
+
+| Task | Command |
+| --- | --- |
+| **Sync main** (before/after work) | `cli git reset --yes` (`--main-only` to skip branch prune) |
+| **Start issue** (align main + branch) | `cli git start issue-9-slug --yes` |
+| **During work** (add + commit + push) | `cli git push --yes` (on `main`, starts random branch first) |
+| Branch in place (no align) | `cli git start [name] --no-prep` |
+| Commit only | `cli git commit` |
+| Sync feature branch | `cli git pull` |
+| Delete merged branch | `cli git branch-delete BRANCH --yes` |
+| Clear all branches (keep `main`) | `cli git branch-clear --yes` |
+| Tag on main (default: today) | `cli git tag` · `cli git tag list` · `cli git tag push` |
+| Zip one tag (cwd repo) | `cli git zip` · `cli git zip TAG` |
+
+Short alias: `cli g push --yes` == `cli git push --yes`.
+
+Shell wrappers: `scripts/git/` (e.g. `./scripts/git/review.sh`). See [docs/git.md](docs/git.md).
+
+**Safety:** destructive actions (reset, clean, delete, push) require `--yes` or an interactive confirmation. Default `cli git start` aligns main then branches; pass `--no-prep` to branch from the current state.
+
+## Drive (`cli drive`)
+
+Local hub: **iCloud** `git-tags/{repo}/{repo}-{tag}.zip` (via `backup.tags_dir`). Cloud: append-only upload to Google Drive, OneDrive, Proton.
+
+| Task | Command |
+| --- | --- |
+| **Status** (git tags vs local zips) | `cli drive status` |
+| **Ingest** (zip all tags → local store) | `cli drive ingest` (all repos in config) or `cli drive ingest PATH` |
+| List local zips | `cli drive list` · `cli drive list PATH` |
+| Delete local zip | `cli drive delete PATH TAG --yes` |
+| **Upload** to cloud | `cli drive upload` · `cli drive upload google` · `onedrive` · `proton` |
+| **Sync** (ingest all + upload all) | `cli drive sync` |
+
+Typical end-of-day:
+
+```bash
+cli git tag --yes && cli git zip    # single repo (cwd)
+cli drive upload                        # push missing zips to cloud
+```
+
+Multi-repo:
+
+```bash
+cli drive sync                          # ingest all repos + upload all clouds
+# or step by step:
+cli drive ingest
+cli drive status
+cli drive upload
+```
+
+`git zip` is the quick path for the current repo; `drive ingest` iterates configured repositories (or one `PATH`). See [docs/drive.md](docs/drive.md) · [issue #4](https://github.com/gardusig/cli/issues/4).
+
+Shell wrappers: `scripts/drive/` (`status.sh`, `ingest.sh`, `upload.sh`, `sync.sh`).
+
+## Chrome (`cli chrome`)
+
+Browser integrations; **bookmarks** is the first subcommand. Path: **`chrome.bookmarks_file`** in config.
+
+| Direction | Command |
+| --- | --- |
+| **Chrome → local** | `cli chrome bookmarks ingest` |
+| **Local → Chrome** | `cli chrome bookmarks deploy` |
+
+```bash
+cli chrome bookmarks ingest   # Chrome → local HTML file
+cli chrome bookmarks deploy   # local file → Chrome
+```
+
+Shell wrappers: `./scripts/chrome/ingest.sh` · `./scripts/chrome/deploy.sh` (deprecated: `import.sh` / `export.sh`).
+
+See [docs/bookmarks.md](docs/bookmarks.md) · epic [#24](https://github.com/gardusig/cli/issues/24) (shell scripts: [#1](https://github.com/gardusig/cli/issues/1)).
+
+## Notion (`cli notion`)
+
+Local tasks: **`notion.task_root`** (private header/body) + **`notion.pairs_file`** (`config/notion/tasks.pairs.json`). Auth: **`NOTION_TOKEN`** + `notion.database_id`.
+
+| Command | Purpose |
+| --- | --- |
+| `cli notion pairs build` | Scan header/ + body/ → `tasks.pairs.json` |
+| `cli notion ingest` | Notion → local pairs |
+| `cli notion deploy --yes` | Local pairs → Notion (archives board first by default) |
+| `cli notion sync --yes` | Ingest from Notion, then deploy local tasks |
+| `cli notion cleanup --yes` | Archive all database pages |
+
+See [docs/notion.md](docs/notion.md) · epic [#2](https://github.com/gardusig/cli/issues/2) · children [#20](https://github.com/gardusig/cli/issues/20)–[#23](https://github.com/gardusig/cli/issues/23).
+
+## Docker
+
+Local Docker monitor and cleanup (requires `docker` on PATH; no container start):
+
+| Task | Command |
+| --- | --- |
+| **Dashboard** (CPU, memory, storage) | `cli docker top` |
+| **By domain** | `cli docker stats --by cpu` / `memory` / `storage` |
+| **Storage lists** | `cli docker images` · `cli docker containers` · `cli docker df` |
+| **Stop running** | `cli docker stop --yes` |
+| **Delete containers** | `cli docker container-delete --yes` |
+| **Prune images** | `cli docker image-delete --yes` (`--all-images` for all unused) |
+| **Full reset** | `cli docker reset --yes` |
+| Targeted cleanup | `cli docker clean containers --yes` · `clean images` · `clean all` |
+
+Shell wrappers live in `scripts/docker/` (e.g. `./scripts/docker/reset.sh --yes`).
+
+Destructive commands use the write gate; pass `--yes` in scripts.
+
+## Verify (Docker)
+
+Requires [Docker Desktop](https://www.docker.com/products/docker-desktop/) on macOS (or Docker Engine on Linux). The `cli:dev` Linux image is the only supported test environment:
+
+```bash
+./scripts/docker/build-image.sh   # build once (or auto-build on first test run)
+./scripts/test-unit.sh            # unit tests (≥80% coverage)
+./scripts/test-integration.sh     # full pytest + smoke + live docker
+./scripts/docker/shell.sh         # onboard: interactive shell in container
+```
+
+See [docs/docker.md](docs/docker.md).
+
+## Docs
+
+- [Setup](docs/setup.md)
+- [Git commands](docs/git.md)
+- [GitHub (`cli gh`)](docs/gh.md)
+- [Drive (local + cloud)](docs/drive.md)
+- [Chrome](docs/bookmarks.md) · [Notion](docs/notion.md)
+- [Docker integration](docs/docker.md)
+- [Configuration](docs/configuration.md)
+- [Architecture](docs/architecture.md)
+
+## Related
+
+- [cursor-skills](https://github.com/gardusig/cursor-skills) — `@gh-*` AI workflows for issues/PRs
+- Cloud drive epic: [cli #4](https://github.com/gardusig/cli/issues/4)
+- Bootstrap spec: [cli #3](https://github.com/gardusig/cli/issues/3)
+- Chrome: [cli #24](https://github.com/gardusig/cli/issues/24) · bookmarks scripts [#1](https://github.com/gardusig/cli/issues/1)
+- Docker integration: [cli #9](https://github.com/gardusig/cli/issues/9)

gardusig_cli-0.1.0/README.md

@@ -0,0 +1,238 @@
+# cli
+
+macOS CLI: **`cli git`** · **`cli drive`** · **`cli chrome`** · **`cli notion`**.
+
+## Naming
+
+| Context | Identifier |
+| --- | --- |
+| **GitHub repo** | [gardusig/cli](https://github.com/gardusig/cli) (clone path is usually `cli/`) |
+| **PyPI package** | `gardusig-cli` — `pip install gardusig-cli` |
+| **Console command** | `cli` (unchanged after PyPI install) |
+| **Python import** | `cli` |
+
+The repo stays **`cli`**; only the published distribution name on PyPI is **`gardusig-cli`** (`cli` is taken on PyPI).
+
+## Requirements
+
+| Tool | Needed for |
+| --- | --- |
+| **macOS** | Primary target for local use |
+| **Python 3.12+** | Local install (`bootstrap.sh` creates a venv) |
+| **[Homebrew](https://brew.sh/)** | Recommended way to install Python and git on macOS |
+| **git** | `cli git` (run from inside a repository) |
+| **zip** | Encrypted tag archives (`cli drive ingest` on `encrypted: true` repos) |
+| **[Docker Desktop](https://www.docker.com/products/docker-desktop/)** | Verification — `./scripts/test-unit.sh` and `./scripts/test-integration.sh` in Docker |
+
+Install Python and git with Homebrew:
+
+```bash
+brew install python@3.12 git
+```
+
+Optional: `gh` (GitHub CLI) for [cursor-skills](https://github.com/gardusig/cursor-skills) workflows — not required by cli itself.
+
+## Configuration (global)
+
+Cli reads **`config/config.yaml`** in the clone, or **`~/.config/cli/`** after install. Override the directory with `CLI_CONFIG_DIR`.
+
+Copy the bundled `config/` tree and edit paths for your machine before daily use:
+
+| Setting | Config key | Purpose |
+| --- | --- | --- |
+| **Git repositories** | `backup.repositories[].path` | Repos for `cli drive ingest` / `drive status` |
+| **Tag zip folder** | `backup.tags_dir` | Local store (default: iCloud `git-tags/`) — source for `drive upload` |
+| **Cloud upload roots** | `drives.yaml` → `google` / `onedrive` / `proton` | Remote folder names per provider |
+| **Notion task root** | `notion.task_root` | Private `header/` + `body/` task files |
+| **Notion pairs manifest** | `notion.pairs_file` | `config/notion/tasks.pairs.json` in this repo |
+| **Notion database** | `notion.database_id` | Existing board ID + `NOTION_TOKEN` env |
+| **Backup zip password** | `BACKUP_ZIP_PASSWORD` env | Encrypted repos (`encrypted: true` in `backup.repositories`) |
+| **Chrome bookmarks file** | `chrome.bookmarks_file` | HTML backup (`chrome bookmarks ingest`) |
+| **Chrome downloads** | `chrome.downloads_dir` | Folder polled when ingesting from Chrome |
+
+Example `config.yaml`:
+
+```yaml
+backup:
+  tags_dir: ~/Library/Mobile Documents/com~apple~CloudDocs/git-tags
+  repositories:
+    - path: ~/git-local/cli
+    - path: ~/git-local/my-other-repo
+
+notion:
+  database_id: your-notion-database-id
+  task_root: ~/git-local/private/configured/tasks
+  pairs_file: config/notion/tasks.pairs.json
+
+chrome:
+  profile: Default
+  bookmarks_file: ~/git-local/private/bookmarks/bookmarks.html
+  downloads_dir: ~/Downloads
+```
+
+Test fixtures (not for production) live under `tests/fixtures/notion/tasks` and `tests/fixtures/bookmarks.html`.
+
+Cloud providers: `config/drives.yaml`. Notion token: **`export NOTION_TOKEN=...`** (never commit).
+
+Environment overrides (optional): `CLI_BOOKMARKS_FILE`, `CLI_DOWNLOADS_DIR`, `CLI_CONFIG_DIR`, `NOTION_TOKEN`.
+
+## Install (macOS)
+
+**Global install (recommended):** `cli` works in any terminal after one setup.
+
+```bash
+./scripts/install.sh
+# open a new terminal OR: source ~/.zprofile
+cli --version
+cli git --help
+```
+
+**Dev install (current shell only):** venv + runtime deps for working in this repo.
+
+```bash
+./scripts/bootstrap.sh
+source .venv/bin/activate
+python -m cli --help
+```
+
+Verification always runs in Docker — same image locally and in CI. Do not run `pytest` on the host; use `./scripts/test-unit.sh` and `./scripts/test-integration.sh` instead.
+
+## Common git commands
+
+Run from inside a repository (`cd` into the repo first).
+
+| Task | Command |
+| --- | --- |
+| **Sync main** (before/after work) | `cli git reset --yes` (`--main-only` to skip branch prune) |
+| **Start issue** (align main + branch) | `cli git start issue-9-slug --yes` |
+| **During work** (add + commit + push) | `cli git push --yes` (on `main`, starts random branch first) |
+| Branch in place (no align) | `cli git start [name] --no-prep` |
+| Commit only | `cli git commit` |
+| Sync feature branch | `cli git pull` |
+| Delete merged branch | `cli git branch-delete BRANCH --yes` |
+| Clear all branches (keep `main`) | `cli git branch-clear --yes` |
+| Tag on main (default: today) | `cli git tag` · `cli git tag list` · `cli git tag push` |
+| Zip one tag (cwd repo) | `cli git zip` · `cli git zip TAG` |
+
+Short alias: `cli g push --yes` == `cli git push --yes`.
+
+Shell wrappers: `scripts/git/` (e.g. `./scripts/git/review.sh`). See [docs/git.md](docs/git.md).
+
+**Safety:** destructive actions (reset, clean, delete, push) require `--yes` or an interactive confirmation. Default `cli git start` aligns main then branches; pass `--no-prep` to branch from the current state.
+
+## Drive (`cli drive`)
+
+Local hub: **iCloud** `git-tags/{repo}/{repo}-{tag}.zip` (via `backup.tags_dir`). Cloud: append-only upload to Google Drive, OneDrive, Proton.
+
+| Task | Command |
+| --- | --- |
+| **Status** (git tags vs local zips) | `cli drive status` |
+| **Ingest** (zip all tags → local store) | `cli drive ingest` (all repos in config) or `cli drive ingest PATH` |
+| List local zips | `cli drive list` · `cli drive list PATH` |
+| Delete local zip | `cli drive delete PATH TAG --yes` |
+| **Upload** to cloud | `cli drive upload` · `cli drive upload google` · `onedrive` · `proton` |
+| **Sync** (ingest all + upload all) | `cli drive sync` |
+
+Typical end-of-day:
+
+```bash
+cli git tag --yes && cli git zip    # single repo (cwd)
+cli drive upload                        # push missing zips to cloud
+```
+
+Multi-repo:
+
+```bash
+cli drive sync                          # ingest all repos + upload all clouds
+# or step by step:
+cli drive ingest
+cli drive status
+cli drive upload
+```
+
+`git zip` is the quick path for the current repo; `drive ingest` iterates configured repositories (or one `PATH`). See [docs/drive.md](docs/drive.md) · [issue #4](https://github.com/gardusig/cli/issues/4).
+
+Shell wrappers: `scripts/drive/` (`status.sh`, `ingest.sh`, `upload.sh`, `sync.sh`).
+
+## Chrome (`cli chrome`)
+
+Browser integrations; **bookmarks** is the first subcommand. Path: **`chrome.bookmarks_file`** in config.
+
+| Direction | Command |
+| --- | --- |
+| **Chrome → local** | `cli chrome bookmarks ingest` |
+| **Local → Chrome** | `cli chrome bookmarks deploy` |
+
+```bash
+cli chrome bookmarks ingest   # Chrome → local HTML file
+cli chrome bookmarks deploy   # local file → Chrome
+```
+
+Shell wrappers: `./scripts/chrome/ingest.sh` · `./scripts/chrome/deploy.sh` (deprecated: `import.sh` / `export.sh`).
+
+See [docs/bookmarks.md](docs/bookmarks.md) · epic [#24](https://github.com/gardusig/cli/issues/24) (shell scripts: [#1](https://github.com/gardusig/cli/issues/1)).
+
+## Notion (`cli notion`)
+
+Local tasks: **`notion.task_root`** (private header/body) + **`notion.pairs_file`** (`config/notion/tasks.pairs.json`). Auth: **`NOTION_TOKEN`** + `notion.database_id`.
+
+| Command | Purpose |
+| --- | --- |
+| `cli notion pairs build` | Scan header/ + body/ → `tasks.pairs.json` |
+| `cli notion ingest` | Notion → local pairs |
+| `cli notion deploy --yes` | Local pairs → Notion (archives board first by default) |
+| `cli notion sync --yes` | Ingest from Notion, then deploy local tasks |
+| `cli notion cleanup --yes` | Archive all database pages |
+
+See [docs/notion.md](docs/notion.md) · epic [#2](https://github.com/gardusig/cli/issues/2) · children [#20](https://github.com/gardusig/cli/issues/20)–[#23](https://github.com/gardusig/cli/issues/23).
+
+## Docker
+
+Local Docker monitor and cleanup (requires `docker` on PATH; no container start):
+
+| Task | Command |
+| --- | --- |
+| **Dashboard** (CPU, memory, storage) | `cli docker top` |
+| **By domain** | `cli docker stats --by cpu` / `memory` / `storage` |
+| **Storage lists** | `cli docker images` · `cli docker containers` · `cli docker df` |
+| **Stop running** | `cli docker stop --yes` |
+| **Delete containers** | `cli docker container-delete --yes` |
+| **Prune images** | `cli docker image-delete --yes` (`--all-images` for all unused) |
+| **Full reset** | `cli docker reset --yes` |
+| Targeted cleanup | `cli docker clean containers --yes` · `clean images` · `clean all` |
+
+Shell wrappers live in `scripts/docker/` (e.g. `./scripts/docker/reset.sh --yes`).
+
+Destructive commands use the write gate; pass `--yes` in scripts.
+
+## Verify (Docker)
+
+Requires [Docker Desktop](https://www.docker.com/products/docker-desktop/) on macOS (or Docker Engine on Linux). The `cli:dev` Linux image is the only supported test environment:
+
+```bash
+./scripts/docker/build-image.sh   # build once (or auto-build on first test run)
+./scripts/test-unit.sh            # unit tests (≥80% coverage)
+./scripts/test-integration.sh     # full pytest + smoke + live docker
+./scripts/docker/shell.sh         # onboard: interactive shell in container
+```
+
+See [docs/docker.md](docs/docker.md).
+
+## Docs
+
+- [Setup](docs/setup.md)
+- [Git commands](docs/git.md)
+- [GitHub (`cli gh`)](docs/gh.md)
+- [Drive (local + cloud)](docs/drive.md)
+- [Chrome](docs/bookmarks.md) · [Notion](docs/notion.md)
+- [Docker integration](docs/docker.md)
+- [Configuration](docs/configuration.md)
+- [Architecture](docs/architecture.md)
+
+## Related
+
+- [cursor-skills](https://github.com/gardusig/cursor-skills) — `@gh-*` AI workflows for issues/PRs
+- Cloud drive epic: [cli #4](https://github.com/gardusig/cli/issues/4)
+- Bootstrap spec: [cli #3](https://github.com/gardusig/cli/issues/3)
+- Chrome: [cli #24](https://github.com/gardusig/cli/issues/24) · bookmarks scripts [#1](https://github.com/gardusig/cli/issues/1)
+- Docker integration: [cli #9](https://github.com/gardusig/cli/issues/9)

gardusig_cli-0.1.0/cli/__init__.py

@@ -0,0 +1,3 @@
+"""cli: git shortcuts and backup/sync workflows."""
+
+__version__ = "0.1.0"

gardusig_cli-0.1.0/cli/__main__.py

@@ -0,0 +1,4 @@
+from cli.cli import run
+
+if __name__ == "__main__":
+    run()

gardusig_cli-0.1.0/cli/cli.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import typer
+
+from cli import __version__
+from cli.commands.backup import backup_app
+from cli.commands.bookmarks import bookmarks_app
+from cli.commands.chrome import chrome_app
+from cli.commands.contest import contest_app
+from cli.commands.docker import docker_app
+from cli.commands.drive import drive_app
+from cli.commands.gh import gh_app
+from cli.commands.git import git_app
+from cli.commands.links import links_app
+from cli.commands.notion import notion_app
+from cli.commands.publish import publish_app
+from cli.commands.restore import restore_app
+from cli.utils.logger import setup_logging
+
+app = typer.Typer(
+    name="cli",
+    help="Git shortcuts and drive (tag zips) for macOS. Run `cli links` for docs and scripts.",
+    no_args_is_help=True,
+)
+
+app.add_typer(links_app, name="links")
+app.add_typer(git_app, name="git")
+app.add_typer(gh_app, name="gh")
+app.add_typer(backup_app, name="backup", hidden=True)
+app.add_typer(restore_app, name="restore")
+app.add_typer(drive_app, name="drive")
+app.add_typer(notion_app, name="notion")
+app.add_typer(chrome_app, name="chrome")
+app.add_typer(bookmarks_app, name="bookmarks", hidden=True)
+app.add_typer(docker_app, name="docker")
+app.add_typer(contest_app, name="contest")
+app.add_typer(publish_app, name="publish")
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    version: bool = typer.Option(False, "--version", "-V", help="Show version and exit."),
+    verbose: bool = typer.Option(False, "--verbose", "-v"),
+) -> None:
+    setup_logging(verbose=verbose)
+    if version:
+        typer.echo(__version__)
+        raise typer.Exit()
+    if ctx.invoked_subcommand is None and not version:
+        typer.echo(ctx.get_help())
+        typer.echo("\nFull index: cli links  |  docs/README.md")
+        raise typer.Exit()
+    ctx.obj = {"verbose": verbose}
+
+
+def run() -> None:
+    """CLI entrypoint — surfaces ExternalCallError as a clean user message."""
+    from cli.utils.config import load_local_env
+    from cli.utils.external_client import ExternalCallError
+
+    load_local_env()
+    try:
+        app()
+    except ExternalCallError as exc:
+        typer.echo(exc.user_message, err=True)
+        raise typer.Exit(1) from exc
+
+
+# Short alias: cli g <cmd> == cli git <cmd>
+app.add_typer(git_app, name="g", hidden=True)

gardusig_cli-0.1.0/cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""

gardusig_cli-0.1.0/cli/commands/backup.py

@@ -0,0 +1,49 @@
+"""Hidden aliases for legacy `cli backup` → use `cli drive` instead."""
+
+from __future__ import annotations
+
+import typer
+
+from cli.commands.drive import delete_cmd, ingest_cmd, list_cmd, status_cmd
+
+backup_app = typer.Typer(
+    help="(deprecated) use cli drive",
+    no_args_is_help=True,
+    hidden=True,
+)
+repository_app = typer.Typer(help="(deprecated)", hidden=True)
+
+
+@backup_app.command("status")
+def backup_status_alias() -> None:
+    """Deprecated: use `cli drive status`."""
+    status_cmd()
+
+
+@repository_app.command("sync")
+def repository_sync_alias(
+    path: str | None = typer.Argument(None),
+) -> None:
+    """Deprecated: use `cli drive ingest`."""
+    ingest_cmd(path)
+
+
+@repository_app.command("list")
+def repository_list_alias(
+    path: str | None = typer.Argument(None),
+) -> None:
+    """Deprecated: use `cli drive list`."""
+    list_cmd(path)
+
+
+@repository_app.command("delete")
+def repository_delete_alias(
+    path: str = typer.Argument(...),
+    tag: str = typer.Argument(...),
+    yes: bool = typer.Option(False, "--yes", "-y"),
+) -> None:
+    """Deprecated: use `cli drive delete`."""
+    delete_cmd(path, tag, yes=yes)
+
+
+backup_app.add_typer(repository_app, name="repository")