pomban 0.2.0__tar.gz

pomban-0.2.0/LICENSE

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

pomban-0.2.0/PKG-INFO

@@ -0,0 +1,305 @@
+Metadata-Version: 2.4
+Name: pomban
+Version: 0.2.0
+Summary: Project-management TUI that runs on pomodoros
+Author-email: Prajwal Mahajan <prajwal.mahajan101@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/prajwalmahajan101/pomban
+Project-URL: Documentation, https://prajwalmahajan101.github.io/pomban/
+Project-URL: Repository, https://github.com/prajwalmahajan101/pomban
+Project-URL: Changelog, https://github.com/prajwalmahajan101/pomban/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/prajwalmahajan101/pomban/issues
+Keywords: tui,textual,pomodoro,kanban,sprint,project-management,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Scheduling
+Classifier: Topic :: Terminals
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.79
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff==0.15.16; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: pre-commit>=3.7; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<2.0,>=9.5; extra == "docs"
+Requires-Dist: pymdown-extensions>=10; extra == "docs"
+Dynamic: license-file
+
+# pomban
+
+[![Python](https://img.shields.io/badge/python-%E2%89%A53.11-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
+[![test](https://github.com/prajwalmahajan101/pomban/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/prajwalmahajan101/pomban/actions/workflows/test.yml)
+
+> A local-first personal productivity platform — projects, sprints,
+> kanban, and focus sessions — that runs entirely in your terminal.
+
+![pomban dashboard](docs/screenshots/dashboard.svg)
+
+```bash
+pipx install pomban && pomban
+```
+
+## What is pomban?
+
+pomban is a single-binary planning, focus, and review platform built
+around one SQLite library on your machine. It models work the way you
+actually do it — projects own sprints, sprints own tasks, tasks
+accumulate focus sessions — and gives every layer a keyboard-driven
+screen:
+
+- **Plan** at the project and sprint level. Move tasks across a
+  kanban with WIP limits, deadlines, and inline `@project` /
+  `!sprint` syntax.
+- **Focus** with a Pomodoro engine that logs every session against a
+  task, captures mid-session blockers, and records a free-text note
+  when a session ends.
+- **Review** with stats, per-tag analytics, a daily digest, exports
+  (CSV / JSON / grouped markdown), and a full session history.
+- **Integrate** through phase-lifecycle shell hooks and in-process
+  Python plugins. The first-party `git_sync` plugin commits the
+  SQLite library on exit so the same database follows you across
+  machines via a personal git remote.
+
+The terminal is the runtime — fast launch, zero chrome, every action
+one keystroke — but the product is the platform underneath. Your
+library never leaves your machine, no account, no telemetry, no cloud.
+
+### How it compares
+
+- **vs CLI timers** — full task surface (kanban + projects + sprints
+  + digest + stats + history), not just a countdown.
+- **vs phone Pomodoro apps** — keyboard-driven, distraction-free,
+  themed, runs in the terminal you already have open.
+- **vs PM SaaS (Linear/Jira/Notion)** — local-first, single-file
+  library you own, no login, no rate limits, no migration anxiety.
+- **vs a wall clock + sticky notes** — every session is logged. Per
+  task, per project, per sprint, per day, per week.
+
+## Features
+
+### Plan
+
+- **Projects and Sprints** (`5` / `6`) — full CRUD with archiving,
+  completion states, and `@project` / `!sprint` inline task syntax.
+  One sprint per project can be active; sprint runner overlay
+  (`Shift+R`) keeps the current goal pinned regardless of screen.
+- **Kanban board** (`2`) — three columns, priorities, due dates
+  (overdue render red), per-column WIP limits, board search (`/`),
+  visual-mode bulk actions (`v`), card-detail screen (`i`).
+- **Context header** — every screen carries the active project /
+  sprint chip so you always know what work the next focus session
+  attaches to.
+- **First-run flow** — empty DB launches a modal that seeds your
+  first project so the hierarchy is never empty.
+
+### Focus
+
+- **Pomodoro engine** — focus / short-break / long-break / lunch
+  phases, configurable cycle length, auto-advance toggle (`Shift+T`),
+  resume-on-restart prompt, lunch-window suggestion.
+- **Blocker capture** (`b`) — log a one-line blocker against the
+  current focus session without breaking the timer.
+- **Session notes** — at session end, jot a freeform note; it
+  surfaces on the history screen against that row.
+- **Working-hours quiet** — set a daily window in `[breaks]` and
+  outside it desktop popups + sound suppress automatically. A
+  header chip shows the current state.
+
+### Review
+
+- **Stats** (`3`) — daily / weekly / monthly buckets, top tasks,
+  interruption counts, plus a **per-tag analytics panel** built on
+  `minutes_per_tag`.
+- **Today digest** (`7`) — sessions, top tasks, interruptions for
+  the current day, one screenful.
+- **History** (`4`) — every session with planned vs. actual
+  duration and the session note inline.
+- **Exports** — `pomban export` ships CSV, JSON, and
+  grouped-markdown formats. `pomban sprint export …` produces a
+  per-sprint report.
+
+### Integrate
+
+- **Hooks** — `[hooks].on_focus_start` / `on_focus_end` /
+  `on_break_start` / `on_break_end` shell commands invoked with
+  `POMODORO_PHASE` and `POMODORO_TASK_TITLE` env vars.
+- **In-process plugins** — Python entry points discovered at
+  startup; exceptions are sandboxed and never crash the app.
+- **`git_sync` plugin** — commits the SQLite library on exit so it
+  can sync across devices via a personal git remote.
+- **Themes** — nord, gruvbox, dracula, catppuccin-mocha,
+  tokyo-night. Cycle with `t`; persisted to `config.toml`.
+
+## Install
+
+```bash
+pipx install pomban
+```
+
+`pipx` (or [`uv tool`](https://docs.astral.sh/uv/)) is the
+recommended path for end-user CLI tools — it sandboxes pomban's
+dependencies in their own venv and gives you a global `pomban`
+command. On modern Linux distros it's also the only path that works
+without virtualenv gymnastics, thanks to
+[PEP 668](https://peps.python.org/pep-0668/).
+
+```bash
+# uv tool — same idea, faster
+uv tool install pomban
+
+# pip (inside a venv)
+python -m venv .venv && source .venv/bin/activate
+pip install pomban
+
+# From source
+git clone https://github.com/prajwalmahajan101/pomban
+cd pomban && pip install -e ".[dev]"
+```
+
+### Requirements
+
+- Python ≥ 3.11
+- A terminal with at least 80 columns. 100+ recommended.
+- Linux desktop notifications need `notify-send`; sound needs
+  `paplay`, `aplay`, or `ffplay` on `$PATH`. Both degrade silently
+  if missing — the in-TUI bell still fires.
+
+## Quick start
+
+```bash
+pomban                    # launch the TUI
+```
+
+On an empty database the first-run modal walks you through creating
+a project. From there: pick a sprint, add tasks (`n`, with inline
+`@project` / `!sprint` / `#tag` / `~25` for a 25-minute estimate),
+and hit `s` to start a focus session.
+
+Press `?` at any time for a context-aware help overlay. The most
+common keys:
+
+| Key | Action |
+|---|---|
+| `s` / `Space` | Start / pause / resume the timer |
+| `r` | Reset |
+| `Shift+S` / `S` | Skip to the next phase |
+| `n` | Focus the "new task" input |
+| `b` | Log a blocker against the current focus session |
+| `1`–`7` | Jump to Dashboard / Kanban / Stats / History / Projects / Sprints / Today |
+| `Shift+R` | Sprint runner overlay |
+| `t` | Cycle theme |
+| `?` | Help overlay |
+| `q` | Quit (persists pending focus session) |
+
+Full reference: [docs/site/keybindings.md](docs/site/keybindings.md).
+
+### CLI
+
+```bash
+pomban                                # launch the TUI
+pomban export --since 7d              # markdown review to stdout
+pomban export --since 7d --format csv # CSV export
+pomban export --since 7d --format json
+pomban sprint export …                # per-sprint reports (see `--help`)
+```
+
+## Configuration
+
+pomban reads `~/.config/pomban/config.toml` (XDG-compliant). The
+file is optional — sane defaults ship. Top-level sections:
+
+| Section | What it controls |
+|---|---|
+| `[timer]` | Focus / break minutes, cycle count, warning seconds, auto-advance |
+| `[notifications]` | Desktop / sound / bell |
+| `[ui]` | Theme |
+| `[hooks]` | Shell commands on phase start / end |
+| `[sync]` | The `git_sync` plugin |
+| `[breaks]` | Lunch-break window + working-hours quiet window |
+| `[kanban]` | Per-column WIP limits |
+| `[[preset]]` | One block per preset, switchable via `p` |
+
+The working-hours window lives under `[breaks]` as
+`working_hours_start` / `working_hours_end` (`"HH:MM"`); outside the
+window, desktop popups and sound suppress (the in-TUI bell still
+fires).
+
+Full reference: [docs/site/configuration.md](docs/site/configuration.md).
+
+### XDG paths
+
+| Purpose | Path |
+|---|---|
+| Config | `$XDG_CONFIG_HOME/pomban/config.toml`, default `~/.config/pomban/config.toml` |
+| Library DB | `$XDG_DATA_HOME/pomban/pomban.db`, default `~/.local/share/pomban/pomban.db` |
+| Log | `$XDG_STATE_HOME/pomban/pomban.log`, default `~/.local/state/pomban/pomban.log` |
+
+## Troubleshooting
+
+**The bell rings but no desktop notification appears.**
+On Linux, install a notification daemon and `notify-send` (`libnotify`
+on most distros). On macOS, install `terminal-notifier`. The bell
+itself always fires; the desktop notification is best-effort.
+
+**Notifications stay quiet during the day.**
+Check your `[breaks].working_hours_start` / `working_hours_end`. The
+header chip reflects the current quiet state.
+
+**`git_sync` complained "not a git repo".**
+Run `git init && git remote add origin <your-url>` inside
+`~/.local/share/pomban/`. pomban commits on exit but never
+pushes — set up a `post-commit` hook or cron if you want auto-push.
+
+**A focus session crashed mid-pomodoro; will I lose it?**
+No. The session and remaining seconds are persisted at every phase
+transition. On next launch you'll get a resume prompt.
+
+**SQLite says "database is locked".**
+pomban uses a single SQLite connection by design (see
+[ADR-0002](docs/adr/0002-single-sqlite-connection.md)). If you opened
+the DB in another tool while pomban was running, close that tool.
+
+## Development
+
+```bash
+git clone https://github.com/prajwalmahajan101/pomban
+cd pomban
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+
+pytest -q
+ruff format --check . && ruff check src/ tests/
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full convention list,
+[ROADMAP.md](./ROADMAP.md) for what's coming, and
+[RELEASE_PLAN.md](./RELEASE_PLAN.md) for how releases are cut.
+
+## Project background
+
+pomban is a solo, phase-driven project. The phase plan and current
+status are in [ROADMAP.md](./ROADMAP.md); architectural decisions are
+recorded under [docs/adr/](docs/adr/); the cumulative change history
+is in [CHANGELOG.md](./CHANGELOG.md). Active and resolved code-review
+findings live under [`.code_review/`](.code_review/).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

pomban-0.2.0/README.md

@@ -0,0 +1,263 @@
+# pomban
+
+[![Python](https://img.shields.io/badge/python-%E2%89%A53.11-blue.svg)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
+[![test](https://github.com/prajwalmahajan101/pomban/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/prajwalmahajan101/pomban/actions/workflows/test.yml)
+
+> A local-first personal productivity platform — projects, sprints,
+> kanban, and focus sessions — that runs entirely in your terminal.
+
+![pomban dashboard](docs/screenshots/dashboard.svg)
+
+```bash
+pipx install pomban && pomban
+```
+
+## What is pomban?
+
+pomban is a single-binary planning, focus, and review platform built
+around one SQLite library on your machine. It models work the way you
+actually do it — projects own sprints, sprints own tasks, tasks
+accumulate focus sessions — and gives every layer a keyboard-driven
+screen:
+
+- **Plan** at the project and sprint level. Move tasks across a
+  kanban with WIP limits, deadlines, and inline `@project` /
+  `!sprint` syntax.
+- **Focus** with a Pomodoro engine that logs every session against a
+  task, captures mid-session blockers, and records a free-text note
+  when a session ends.
+- **Review** with stats, per-tag analytics, a daily digest, exports
+  (CSV / JSON / grouped markdown), and a full session history.
+- **Integrate** through phase-lifecycle shell hooks and in-process
+  Python plugins. The first-party `git_sync` plugin commits the
+  SQLite library on exit so the same database follows you across
+  machines via a personal git remote.
+
+The terminal is the runtime — fast launch, zero chrome, every action
+one keystroke — but the product is the platform underneath. Your
+library never leaves your machine, no account, no telemetry, no cloud.
+
+### How it compares
+
+- **vs CLI timers** — full task surface (kanban + projects + sprints
+  + digest + stats + history), not just a countdown.
+- **vs phone Pomodoro apps** — keyboard-driven, distraction-free,
+  themed, runs in the terminal you already have open.
+- **vs PM SaaS (Linear/Jira/Notion)** — local-first, single-file
+  library you own, no login, no rate limits, no migration anxiety.
+- **vs a wall clock + sticky notes** — every session is logged. Per
+  task, per project, per sprint, per day, per week.
+
+## Features
+
+### Plan
+
+- **Projects and Sprints** (`5` / `6`) — full CRUD with archiving,
+  completion states, and `@project` / `!sprint` inline task syntax.
+  One sprint per project can be active; sprint runner overlay
+  (`Shift+R`) keeps the current goal pinned regardless of screen.
+- **Kanban board** (`2`) — three columns, priorities, due dates
+  (overdue render red), per-column WIP limits, board search (`/`),
+  visual-mode bulk actions (`v`), card-detail screen (`i`).
+- **Context header** — every screen carries the active project /
+  sprint chip so you always know what work the next focus session
+  attaches to.
+- **First-run flow** — empty DB launches a modal that seeds your
+  first project so the hierarchy is never empty.
+
+### Focus
+
+- **Pomodoro engine** — focus / short-break / long-break / lunch
+  phases, configurable cycle length, auto-advance toggle (`Shift+T`),
+  resume-on-restart prompt, lunch-window suggestion.
+- **Blocker capture** (`b`) — log a one-line blocker against the
+  current focus session without breaking the timer.
+- **Session notes** — at session end, jot a freeform note; it
+  surfaces on the history screen against that row.
+- **Working-hours quiet** — set a daily window in `[breaks]` and
+  outside it desktop popups + sound suppress automatically. A
+  header chip shows the current state.
+
+### Review
+
+- **Stats** (`3`) — daily / weekly / monthly buckets, top tasks,
+  interruption counts, plus a **per-tag analytics panel** built on
+  `minutes_per_tag`.
+- **Today digest** (`7`) — sessions, top tasks, interruptions for
+  the current day, one screenful.
+- **History** (`4`) — every session with planned vs. actual
+  duration and the session note inline.
+- **Exports** — `pomban export` ships CSV, JSON, and
+  grouped-markdown formats. `pomban sprint export …` produces a
+  per-sprint report.
+
+### Integrate
+
+- **Hooks** — `[hooks].on_focus_start` / `on_focus_end` /
+  `on_break_start` / `on_break_end` shell commands invoked with
+  `POMODORO_PHASE` and `POMODORO_TASK_TITLE` env vars.
+- **In-process plugins** — Python entry points discovered at
+  startup; exceptions are sandboxed and never crash the app.
+- **`git_sync` plugin** — commits the SQLite library on exit so it
+  can sync across devices via a personal git remote.
+- **Themes** — nord, gruvbox, dracula, catppuccin-mocha,
+  tokyo-night. Cycle with `t`; persisted to `config.toml`.
+
+## Install
+
+```bash
+pipx install pomban
+```
+
+`pipx` (or [`uv tool`](https://docs.astral.sh/uv/)) is the
+recommended path for end-user CLI tools — it sandboxes pomban's
+dependencies in their own venv and gives you a global `pomban`
+command. On modern Linux distros it's also the only path that works
+without virtualenv gymnastics, thanks to
+[PEP 668](https://peps.python.org/pep-0668/).
+
+```bash
+# uv tool — same idea, faster
+uv tool install pomban
+
+# pip (inside a venv)
+python -m venv .venv && source .venv/bin/activate
+pip install pomban
+
+# From source
+git clone https://github.com/prajwalmahajan101/pomban
+cd pomban && pip install -e ".[dev]"
+```
+
+### Requirements
+
+- Python ≥ 3.11
+- A terminal with at least 80 columns. 100+ recommended.
+- Linux desktop notifications need `notify-send`; sound needs
+  `paplay`, `aplay`, or `ffplay` on `$PATH`. Both degrade silently
+  if missing — the in-TUI bell still fires.
+
+## Quick start
+
+```bash
+pomban                    # launch the TUI
+```
+
+On an empty database the first-run modal walks you through creating
+a project. From there: pick a sprint, add tasks (`n`, with inline
+`@project` / `!sprint` / `#tag` / `~25` for a 25-minute estimate),
+and hit `s` to start a focus session.
+
+Press `?` at any time for a context-aware help overlay. The most
+common keys:
+
+| Key | Action |
+|---|---|
+| `s` / `Space` | Start / pause / resume the timer |
+| `r` | Reset |
+| `Shift+S` / `S` | Skip to the next phase |
+| `n` | Focus the "new task" input |
+| `b` | Log a blocker against the current focus session |
+| `1`–`7` | Jump to Dashboard / Kanban / Stats / History / Projects / Sprints / Today |
+| `Shift+R` | Sprint runner overlay |
+| `t` | Cycle theme |
+| `?` | Help overlay |
+| `q` | Quit (persists pending focus session) |
+
+Full reference: [docs/site/keybindings.md](docs/site/keybindings.md).
+
+### CLI
+
+```bash
+pomban                                # launch the TUI
+pomban export --since 7d              # markdown review to stdout
+pomban export --since 7d --format csv # CSV export
+pomban export --since 7d --format json
+pomban sprint export …                # per-sprint reports (see `--help`)
+```
+
+## Configuration
+
+pomban reads `~/.config/pomban/config.toml` (XDG-compliant). The
+file is optional — sane defaults ship. Top-level sections:
+
+| Section | What it controls |
+|---|---|
+| `[timer]` | Focus / break minutes, cycle count, warning seconds, auto-advance |
+| `[notifications]` | Desktop / sound / bell |
+| `[ui]` | Theme |
+| `[hooks]` | Shell commands on phase start / end |
+| `[sync]` | The `git_sync` plugin |
+| `[breaks]` | Lunch-break window + working-hours quiet window |
+| `[kanban]` | Per-column WIP limits |
+| `[[preset]]` | One block per preset, switchable via `p` |
+
+The working-hours window lives under `[breaks]` as
+`working_hours_start` / `working_hours_end` (`"HH:MM"`); outside the
+window, desktop popups and sound suppress (the in-TUI bell still
+fires).
+
+Full reference: [docs/site/configuration.md](docs/site/configuration.md).
+
+### XDG paths
+
+| Purpose | Path |
+|---|---|
+| Config | `$XDG_CONFIG_HOME/pomban/config.toml`, default `~/.config/pomban/config.toml` |
+| Library DB | `$XDG_DATA_HOME/pomban/pomban.db`, default `~/.local/share/pomban/pomban.db` |
+| Log | `$XDG_STATE_HOME/pomban/pomban.log`, default `~/.local/state/pomban/pomban.log` |
+
+## Troubleshooting
+
+**The bell rings but no desktop notification appears.**
+On Linux, install a notification daemon and `notify-send` (`libnotify`
+on most distros). On macOS, install `terminal-notifier`. The bell
+itself always fires; the desktop notification is best-effort.
+
+**Notifications stay quiet during the day.**
+Check your `[breaks].working_hours_start` / `working_hours_end`. The
+header chip reflects the current quiet state.
+
+**`git_sync` complained "not a git repo".**
+Run `git init && git remote add origin <your-url>` inside
+`~/.local/share/pomban/`. pomban commits on exit but never
+pushes — set up a `post-commit` hook or cron if you want auto-push.
+
+**A focus session crashed mid-pomodoro; will I lose it?**
+No. The session and remaining seconds are persisted at every phase
+transition. On next launch you'll get a resume prompt.
+
+**SQLite says "database is locked".**
+pomban uses a single SQLite connection by design (see
+[ADR-0002](docs/adr/0002-single-sqlite-connection.md)). If you opened
+the DB in another tool while pomban was running, close that tool.
+
+## Development
+
+```bash
+git clone https://github.com/prajwalmahajan101/pomban
+cd pomban
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+
+pytest -q
+ruff format --check . && ruff check src/ tests/
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full convention list,
+[ROADMAP.md](./ROADMAP.md) for what's coming, and
+[RELEASE_PLAN.md](./RELEASE_PLAN.md) for how releases are cut.
+
+## Project background
+
+pomban is a solo, phase-driven project. The phase plan and current
+status are in [ROADMAP.md](./ROADMAP.md); architectural decisions are
+recorded under [docs/adr/](docs/adr/); the cumulative change history
+is in [CHANGELOG.md](./CHANGELOG.md). Active and resolved code-review
+findings live under [`.code_review/`](.code_review/).
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

pomban-0.2.0/pyproject.toml

@@ -0,0 +1,102 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pomban"
+version = "0.2.0"
+description = "Project-management TUI that runs on pomodoros"
+readme = "README.md"
+keywords = ["tui", "textual", "pomodoro", "kanban", "sprint", "project-management", "productivity"]
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Prajwal Mahajan", email = "prajwal.mahajan101@gmail.com" }]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console :: Curses",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Scheduling",
+    "Topic :: Terminals",
+    "Typing :: Typed",
+]
+dependencies = [
+    "textual>=0.79",
+]
+
+[project.urls]
+Homepage = "https://github.com/prajwalmahajan101/pomban"
+Documentation = "https://prajwalmahajan101.github.io/pomban/"
+Repository = "https://github.com/prajwalmahajan101/pomban"
+Changelog = "https://github.com/prajwalmahajan101/pomban/blob/main/CHANGELOG.md"
+Issues = "https://github.com/prajwalmahajan101/pomban/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "ruff==0.15.16",
+    "mypy>=1.11",
+    "pre-commit>=3.7",
+    "build>=1.2",
+    "twine>=5",
+]
+docs = [
+    "mkdocs>=1.6",
+    "mkdocs-material>=9.5,<2.0",
+    "pymdown-extensions>=10",
+]
+
+[project.scripts]
+pomban = "pomban.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+extend-exclude = [".venv", "build", "dist"]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP", "SIM", "N", "RUF"]
+ignore = [
+    "E501",   # line length — formatter handles it
+    "RUF012", # ClassVar on Textual reactives — false-positive on the framework
+    "RUF001", # ambiguous unicode in strings — author's choice (× as "x times" etc.)
+    "RUF002", # ambiguous unicode in docstrings — author's choice
+    "RUF003", # ambiguous unicode in comments — author's choice
+    "UP045",  # PEP-604 union — Optional[X] kept on Textual generic bases (runtime-evaluated)
+    "UP042",  # str-mixin Enum — explicit (str, Enum) preferred over StrEnum here for clarity
+    "SIM117", # combine `with` — nested `with` matches the visual widget hierarchy in compose()
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["N802", "N803", "N806"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+line-ending = "lf"
+
+[tool.mypy]
+python_version = "3.11"
+files = ["src"]
+warn_unused_ignores = true
+warn_unreachable = true
+show_error_codes = true
+
+[[tool.mypy.overrides]]
+module = ["textual.*"]
+ignore_missing_imports = true

pomban-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+