clibo 1.1.0__tar.gz

clibo-1.1.0/.claude/scheduled_tasks.lock

@@ -0,0 +1 @@
+{"sessionId":"64da017d-3a40-4db0-8a48-f0cdcdb0e0d6","pid":49315,"procStart":"Fri May 22 16:44:14 2026","acquiredAt":1779469388744}

clibo-1.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,37 @@
+---
+name: 🐛 Bug report
+about: Report something clibo does wrong
+labels: bug
+---
+
+## What happened
+
+<!-- Describe the bug in 1-2 sentences. -->
+
+## To reproduce
+
+The smallest sequence of `clibo ...` commands that produces the bug:
+
+```bash
+clibo …
+clibo …
+```
+
+## What you expected to happen
+
+## What actually happened
+
+Paste the full output / traceback. If it's terminal output, drop it in a code
+block so the formatting survives.
+
+```
+…
+```
+
+## Environment
+
+Run `clibo doctor --json` and paste the result:
+
+```json
+…
+```

clibo-1.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,32 @@
+---
+name: ✨ Feature request
+about: Suggest a new tool, command or improvement
+labels: enhancement
+---
+
+## What you'd like
+
+<!-- One paragraph describing the feature. -->
+
+## Why it matters
+
+<!-- The use case it unlocks. If it's a new tool, who would use it daily? -->
+
+## Sketch
+
+If you're proposing a new sub-command, what would it look like?
+
+```bash
+clibo <tool> <verb> ...
+```
+
+What does `--json` return?
+
+```json
+…
+```
+
+## Alternatives
+
+Anything else you considered or any existing tool that already does most of
+this?

clibo-1.1.0/.github/pull_request_template.md

@@ -0,0 +1,26 @@
+<!--
+Thanks for contributing! A small checklist keeps clibo consistent across all
+50+ tools. Tick whatever applies; delete sections that don't.
+-->
+
+## What this PR does
+
+<!-- One paragraph. -->
+
+## Checklist
+
+### For a new tool
+
+- [ ] Module in `clibo/clis/<tool>.py` follows `docs/ADDING_A_TOOL.md`.
+- [ ] Namespaced `__tablename__` (e.g. `<tool>_<thing>`).
+- [ ] Every command accepts `--json` and uses `core.output` helpers.
+- [ ] Registered in `clibo/clis/__init__.py` (imports **and** `ALL`).
+- [ ] Tests at `tests/test_<tool>.py` cover create, list/show, `--json` shape, stats, an error path.
+- [ ] Micro-skill at `skills/<tool>/SKILL.md` with frontmatter, commands, examples, and a *For agents* section.
+- [ ] Box ticked in `PLAN.md`; entry appended to `PROGRESS.md`.
+
+### Always
+
+- [ ] `./.venv/bin/pytest` is green.
+- [ ] Smoke-tested by hand, including `--json`.
+- [ ] No `Co-Authored-By` trailer, no "Generated with …" line, no LLM mentions in commit messages.

clibo-1.1.0/.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+      - name: Lint with ruff
+        run: ruff check clibo/ tests/ scripts/
+      - name: Run tests
+        run: pytest
+      - name: Smoke-test the CLI
+        run: |
+          clibo info
+          clibo calorie log "ci test" -k 100
+          clibo calorie today --json

clibo-1.1.0/.github/workflows/publish.yml

@@ -0,0 +1,33 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+        with:
+          python-version: "3.12"
+      - run: uv sync --all-extras --dev
+      - run: uv run pytest tests/
+      - run: uv run ruff check clibo/ tests/ scripts/
+
+  publish:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*
+      - run: twine upload dist/*
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}

clibo-1.1.0/.github/workflows/release.yml

@@ -0,0 +1,60 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: write   # needed to create the release & upload assets
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build wheel + sdist
+        run: |
+          python -m pip install --upgrade pip build
+          python -m build
+
+      - name: Show artifacts
+        run: ls -la dist/
+
+      - name: Sanity-check version matches the tag
+        run: |
+          tag="${GITHUB_REF#refs/tags/v}"
+          ver=$(python -c "import tomllib,sys; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          if [ "$tag" != "$ver" ]; then
+            echo "Tag $tag does not match pyproject version $ver" >&2
+            exit 1
+          fi
+
+      - name: Create or update the GitHub release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          tag="${GITHUB_REF#refs/tags/}"
+          if ! gh release view "$tag" >/dev/null 2>&1; then
+            gh release create "$tag" \
+              --title "clibo $tag" \
+              --notes "Automated release for $tag. See [CHANGELOG.md](https://github.com/${GITHUB_REPOSITORY}/blob/main/CHANGELOG.md) for details."
+          fi
+          gh release upload "$tag" dist/* --clobber
+
+      - name: Publish to PyPI (only if PYPI_API_TOKEN is configured)
+        env:
+          PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        if: env.PYPI_API_TOKEN != ''
+        run: |
+          python -m pip install --upgrade twine
+          python -m twine upload dist/* \
+            --username __token__ \
+            --password "$PYPI_API_TOKEN" \
+            --non-interactive

clibo-1.1.0/.gitignore

@@ -0,0 +1,22 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+venv/
+
+# Tooling
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+
+# clibo local data (never commit a user's database)
+*.db
+*.db-journal
+.clibo/
+
+# OS
+.DS_Store

clibo-1.1.0/AGENTS.md

@@ -0,0 +1,107 @@
+# Agents guide
+
+This file is for **AI agents** (Claude Code, Codex, Aider, OpenCode, …) that
+will be calling clibo on a user's machine. If you are a human contributor,
+read [`docs/ADDING_A_TOOL.md`](docs/ADDING_A_TOOL.md) instead.
+
+## What clibo is
+
+A box of **50 local-first CLI tools** under one `clibo` command, all writing
+to a single SQLite file at `~/.clibo/clibo.db`. There is no network, no
+account, no cloud — installing clibo is enough.
+
+Each tool is a sub-command: `clibo calorie`, `clibo crm`, `clibo todo`, … Run
+`clibo info --json` for the full list, or `clibo <tool> --help` for any tool.
+
+## The contract every command keeps
+
+| Rule | Why it matters |
+|---|---|
+| Every command accepts `--json`. | Stdout becomes a clean, parseable JSON document. |
+| Mutations return the affected record. | `add`/`log`/`edit` emit the created/updated object — no follow-up read required. |
+| Deletes return `{"deleted": ID}`. | One-shot confirmation. |
+| Errors go to **stderr** with non-zero exit code. | Use the exit code and read stderr to recover. |
+| Verbs are predictable. | `add` (or a domain verb like `log`, `drink`, `take`), `list`, `show`, `edit`, `rm`, `stats`. |
+| Free-form IDs accept names too. | Most tools resolve a positional argument as numeric ID *or* case-insensitive name (`clibo habit check "Read 10 pages"`). |
+| Dates are forgiving. | `today`, `yesterday`, `tomorrow`, `YYYY-MM-DD`, `DD.MM`, `MM/DD`. |
+
+## Three integrating commands you'll use a lot
+
+```bash
+clibo today --json    # one snapshot across 12 tools — fastest "what's going on?"
+clibo search Q --json # full-text search across 22 text-bearing tables
+clibo export --json   # dump the entire local state to one JSON document
+```
+
+`clibo doctor --json` returns `{"healthy": true, ...}` — use it as a smoke
+check before doing real work.
+
+## Per-tool skills
+
+Every tool ships a micro-skill in [`skills/<tool>/SKILL.md`](skills/) with
+YAML frontmatter compatible with Claude Code Skills. Each skill has:
+
+- a `name` and `description` for skill-selection,
+- a command table with flags,
+- copy-paste examples,
+- a **For agents** section that documents the exact JSON output.
+
+If you can read one file from this repo to learn a tool, read its
+`skills/<tool>/SKILL.md`.
+
+## Common agent recipes
+
+### Log a meal
+
+```bash
+clibo calorie log "oatmeal with berries" --kcal 320 --protein 12 --carbs 48 --fat 6 -m breakfast --json
+```
+Returns the created entry; check `data["id"]` if you need to edit it later.
+
+### Find every mention of a topic
+
+```bash
+clibo search "acme" --json
+```
+Returns `{"query": "acme", "count": N, "results": [{"source", "id", "snippet"}, ...]}`.
+`source` is the tool name; `id` is the row ID in that tool's table.
+
+### Read the whole picture
+
+```bash
+clibo today --json                                   # everything actionable today
+path=$(clibo export --json | jq -r .path); cat $path # entire DB as JSON (all tables)
+```
+
+`clibo export --json` returns `{"path", "tables", "rows"}` — the dump itself
+is written to `path` so it can be reused later.
+
+### Mutate by name without a separate lookup
+
+```bash
+clibo habit check "Read 10 pages" --json
+clibo crm touch "Anna Petrova" --json
+clibo savings deposit "Vacation" 200 --json
+```
+
+### Detect that clibo is installed and working
+
+```bash
+clibo doctor --json | jq .healthy   # → true
+```
+
+## Things to avoid
+
+- **Don't shell out to `sqlite3` directly.** The schema may evolve between
+  versions; use the CLI. If you need bulk reads, use `clibo export --json`.
+- **Don't write the database file.** Use the CLI for mutations so triggers,
+  defaults and timestamps stay consistent.
+- **Don't assume timezone.** All dates are local-time, naive. Use the
+  command's own date parsing instead of pre-formatting.
+- **Don't pre-quote `--json`.** It's a plain flag.
+
+## Versioning
+
+Run `clibo --version` or read `clibo doctor --json | jq .version`. Major
+versions follow semver — a 1.x bump means the JSON contract for any command
+may have changed; minor bumps add new tools or fields.

clibo-1.1.0/CHANGELOG.md

@@ -0,0 +1,124 @@
+# Changelog
+
+All notable changes to **clibo** are recorded here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project
+follows [Semantic Versioning](https://semver.org/).
+
+## [Unreleased] — staged for `v1.1.0`
+
+Thirteen polish iterations have landed on `main` since `v1.0.0`. Ship them
+by pushing a `v1.1.0` tag — the
+[`Release` workflow](.github/workflows/release.yml) handles the rest.
+
+### Added — six new cross-tool commands
+
+- 🚀 `clibo init` — one-shot onboarding. Sets the shared currency plus daily
+  goals for calories, water, focus, sleep and meditation in a single call.
+- 🗓️ `clibo week` — 7-day rollup across sleep, calories, water, focus,
+  mood, habits (vs each habit's weekly target), expenses (with top
+  category) and productivity (tasks/journal/worklog).
+- 📜 `clibo recent` — chronological activity feed across 40+ tables,
+  newest-first, with relative "just now / 9h ago / yesterday" labels.
+- 🏷️ `clibo tags` — discover every tag used across notes, todo, bookmark,
+  crm, brag, recipes and journal, with counts and per-source breakdown.
+- 🩺 `clibo doctor` — install health check: version, Python, tools built,
+  database size and per-table row counts; `--json` returns a `healthy` bool.
+- 📥 `clibo import PATH` — counterpart to `clibo export`. Loads a JSON dump
+  back into the live database (`INSERT OR IGNORE` by default, `--replace`
+  for a clean overwrite). Accepts both the v1 envelope and a bare
+  `{table: [rows]}` map.
+
+### Added — documentation & ergonomics
+
+- 📝 `AGENTS.md` at the repo root: one-page agent guide with the universal
+  contract, integrating commands, copy-paste recipes and pitfalls.
+- 🎯 `docs/PHILOSOPHY.md` — the seven design trade-offs that explain
+  why clibo looks the way it does (local-first, JSON contract, 50 tools
+  vs library, forgiving dates, beautiful output, sane test bar).
+- 📄 `docs/SCHEMA.md` — auto-generated reference for all 63 tables;
+  regenerated by `scripts/dump_schema.py`.
+- 📁 `examples/` directory: `daily_brief.py`/`daily_brief.sh` (combine
+  `today` + `week` into a Markdown brief) and `find_and_act.py` (the
+  search-then-act agent pattern). All smoke-tested end-to-end.
+- 🛠️ `CONTRIBUTING.md` and `.github/{ISSUE_TEMPLATE,pull_request_template}.md`
+  — the four-part "done" definition for new tools, a maintainer
+  Releasing section, plus pointers to SCHEMA.md and PHILOSOPHY.md.
+
+### Added — infrastructure
+
+- 🤖 `.github/workflows/release.yml` — automated release on `v*.*.*` tag
+  push: builds wheel + sdist, sanity-checks the tag matches `pyproject`'s
+  version, creates the GitHub release with artifacts, and publishes to
+  PyPI when the `PYPI_API_TOKEN` repo secret is set.
+- 🧹 `ruff>=0.5` lint, configured in `pyproject.toml`
+  (`E/W/F/I/UP/B/SIM`), enforced as a new `Lint with ruff` step in CI.
+  The first run found 12 real issues (unused imports / locals / a stale
+  `typing.Callable`); all fixed.
+- 📦 Wheel and sdist attached to the GitHub release page for v1.0.0
+  (and every future release via the workflow).
+
+### Tests
+
+- 332 passing (up from 299 at v1.0.0); ruff clean.
+
+[Unreleased]: https://github.com/dm1tryG/clibo/compare/v1.0.0...HEAD
+
+## [1.0.0] — 2026-05-23
+
+The first stable release. All 50 planned tools are shipped, every command
+supports a `--json` mode for AI agents, and the project carries 299 tests.
+
+### Added — 50 local-first CLI tools, in 5 categories
+
+- **🏃 Health & Wellness** — `calorie`, `water`, `weight`, `workout`,
+  `sleep`, `mood`, `meds`, `period`, `meditate`, `vitals`.
+- **💰 Money & Finance** — `expense`, `budget`, `subs`, `bills`, `savings`,
+  `debt`, `networth`, `invoice`, `split`, `wishlist`.
+- **✅ Productivity & Work** — `todo`, `notes`, `habit`, `focus`, `time`,
+  `journal`, `goals`, `events`, `worklog`, `bookmark`.
+- **🤝 CRM & Relationships** — `crm`, `leads`, `followup`, `meetings`,
+  `jobs`, `clients`, `birthdays`, `network`, `gifts`, `brag`.
+- **🏠 Home & Life** — `groceries`, `pantry`, `recipes`, `meals`, `chores`,
+  `plants`, `car`, `home`, `pets`, `travel`.
+
+### Added — Cross-tool commands
+
+- `clibo today` — a one-screen dashboard pulling from 12 tools at once:
+  overdue/today tasks, habit check-offs, water/calorie/focus progress bars,
+  today's events and meals, bills due, follow-ups, plants needing water,
+  chores due, and today's birthdays.
+- `clibo search QUERY` — one query across 13 text-bearing tables (notes,
+  journal, todo, bookmark, crm, network, meetings, brag, recipes, worklog,
+  gifts, expense, wishlist).
+- `clibo backup [PATH]` / `clibo restore PATH` — file-level SQLite backup
+  and restore, with timestamped defaults under `~/.clibo/backups/`.
+- `clibo export [PATH]` — dump every clibo table to one JSON file,
+  ideal for an agent to read the whole local state in one go.
+- `clibo info` — progress dashboard for the project itself.
+
+### Added — Agent-native contract
+
+- Every command accepts `--json` for machine-readable output on stdout.
+- Mutations return the affected record as JSON; deletes return
+  `{"deleted": ID}`; errors go to stderr with a non-zero exit code.
+- One micro-skill (`SKILL.md`) per tool in `skills/`, ready to drop into
+  an AI agent's skill set.
+
+### Added — Engineering
+
+- Stack: Python 3.10+ · [Typer](https://typer.tiangolo.com/) ·
+  [SQLModel](https://sqlmodel.tiangolo.com/) · [Rich](https://rich.readthedocs.io/).
+- One SQLite file at `~/.clibo/clibo.db` (`CLIBO_HOME` / `CLIBO_DB` override).
+- 299 pytest tests covering every tool and the cross-tool commands.
+- GitHub Actions CI on Python 3.10/3.11/3.12.
+- MIT licensed.
+
+### Install
+
+```bash
+uv tool install --from git+https://github.com/dm1tryG/clibo.git clibo
+# or
+pipx install git+https://github.com/dm1tryG/clibo.git
+```
+
+[1.0.0]: https://github.com/dm1tryG/clibo/releases/tag/v1.0.0

clibo-1.1.0/CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# Contributing to clibo
+
+Thanks for thinking about contributing — clibo is built to grow.
+
+## Quick setup
+
+```bash
+git clone https://github.com/dm1tryG/clibo.git
+cd clibo
+uv venv .venv             # or python -m venv .venv
+uv pip install --python .venv -e ".[dev]"
+./.venv/bin/pytest        # 300+ tests
+./.venv/bin/ruff check    # lint
+```
+
+CI runs both `ruff check` and `pytest` — keep both green locally before opening
+a PR. Ruff config lives in `pyproject.toml`.
+
+The full developer guide for adding a new clibo tool lives at
+[`docs/ADDING_A_TOOL.md`](docs/ADDING_A_TOOL.md) — read it before you start.
+[`clibo/clis/calorie.py`](clibo/clis/calorie.py) is the canonical reference.
+[`docs/SCHEMA.md`](docs/SCHEMA.md) lists every existing table; regenerate it
+with `python scripts/dump_schema.py` after adding a new model.
+[`docs/PHILOSOPHY.md`](docs/PHILOSOPHY.md) explains the design trade-offs every
+tool is built on — please read it before proposing structural changes.
+
+## What a "done" tool looks like
+
+A tool is not done until **all four** of these are true:
+
+1. The module in `clibo/clis/<tool>.py` follows the pattern in
+   `docs/ADDING_A_TOOL.md`: namespaced table name, Typer `app`, predictable
+   verbs, `--json` on every command, output routed through `core.output`.
+2. It is registered in `clibo/clis/__init__.py` (both the import block and
+   the `ALL` list).
+3. There is a pytest file at `tests/test_<tool>.py` that covers create, a
+   read/list, the `--json` shape, `stats`, and at least one error path.
+4. There is a micro-skill at `skills/<tool>/SKILL.md` with the YAML
+   frontmatter (`name`, `description`), a command table, examples, and a
+   **For agents** section documenting the JSON output.
+
+`./.venv/bin/pytest` must be green. Smoke-test the new tool by hand,
+including `--json`, before opening a PR.
+
+## Commit messages
+
+Plain, present-tense, one short subject line. No `Co-Authored-By` trailers,
+no "Generated with …" lines, no mentions of any LLM.
+
+## PR checklist
+
+A short [pull-request template](.github/pull_request_template.md) is
+auto-filled when you open a PR — please tick the boxes honestly.
+
+## Releasing (maintainers)
+
+Cutting a new version is one command on a clean `main`:
+
+1. Bump `version` in `pyproject.toml` **and** `__version__` in
+   `clibo/__init__.py`.
+2. Add a `## [X.Y.Z] — YYYY-MM-DD` section at the top of `CHANGELOG.md`.
+3. Commit the bump, then:
+
+   ```bash
+   git tag -a vX.Y.Z -m "clibo vX.Y.Z"
+   git push origin main --follow-tags
+   ```
+
+The [`Release` workflow](.github/workflows/release.yml) takes it from there:
+builds the wheel and sdist, sanity-checks the tag matches the pyproject
+version, creates the GitHub release, attaches the artifacts, and (if the
+`PYPI_API_TOKEN` repo secret is set) publishes to PyPI.
+
+## Code of conduct
+
+Be kind. Assume good faith. We follow the
+[Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)
+in spirit; no formal document needed at this size.

clibo-1.1.0/LICENSE

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