gtd-tui 0.1.0__tar.gz

gtd_tui-0.1.0/LICENSE

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

gtd_tui-0.1.0/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: gtd-tui
+Version: 0.1.0
+Summary: GTD + 12-Week Year CLI powered by Notion
+License-Expression: MIT
+Project-URL: Repository, https://github.com/dannybrown37/gtd
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: python-dateutil>=2.9.0.post0
+Requires-Dist: textual>=0.71.0
+Provides-Extra: api
+Requires-Dist: flask>=3.1.0; extra == "api"
+Dynamic: license-file
+
+# The Getting Things Done Terminal User Interface
+
+A TUI/CLI/API for personal productivity built around [GTD (Getting Things Done)](https://gettingthingsdone.com/).
+
+## What it does
+
+- Capture items to an inbox and triage them into projects
+- Track projects with contexts, next actions, and follow-up dates
+- Log completions and auto-reschedule recurring items
+- Defer, snooze, and review Someday/Maybe lists
+- Filter by context for focused work sessions
+
+## Requirements
+
+- Python 3.12+
+- [fzf](https://github.com/junegunn/fzf) (for interactive menus)
+- A [Notion integration token](https://developers.notion.com/) (for `gtd`)
+
+## Installation
+
+```bash
+cd gtd
+uv sync
+uv pip install -e .
+```
+
+This installs the `gtd` command.
+
+## Usage
+
+### GTD interactive mode
+
+```bash
+gtd
+```
+
+Opens the fzf-powered GTD menu:
+
+<!-- BEGIN MENU -->
+| Category | Action |
+| --- | --- |
+| Do | Today |
+| Do | Log & Reschedule |
+| Do | Snooze until tomorrow |
+| Do | Capture new item |
+| Do | Brain dump |
+| Do | Triage inbox |
+| Manage | Update project |
+| Manage | Defer project until date |
+| Manage | Waiting For |
+| Manage | Mark done (delete) |
+| Review | Weekly Review |
+| Review | Review Someday/Maybe |
+| View | View all projects |
+| View | Filter by context |
+<!-- END MENU -->
+
+### GTD subcommands
+
+```bash
+gtd init             # Set up a new GTD Notion database
+gtd init --upgrade   # Add missing properties/options to existing DB
+gtd triage           # Process inbox items
+gtd review           # Guided weekly review ritual
+gtd dump             # Rapid-fire brain dump
+gtd filter work      # Filter projects by context
+gtd today            # Show today's actionable items
+gtd capture          # Quick-capture to inbox
+gtd done             # Mark a project as done
+gtd update           # Update project fields
+gtd defer            # Defer a project
+```
+
+## HTTP API
+
+A small Flask app (`gtd api`) exposes GTD operations over HTTP, primarily so
+you can drive `gtd` from **iOS Shortcuts** (or any other HTTP client) without
+opening a terminal — capture a thought, check today's actionable items, or
+triage the inbox from your phone.
+
+There's no central server in the loop: you run this yourself, against your own
+Notion integration and database. Your GTD data lives in your Notion account under
+your own token.
+
+
+**Install**: `uv pip install "gtd[api]"`
+**Run**: `gtd api` (default `0.0.0.0:8000`) or `gtd api --port 9000`
+**Auth**: Bearer token — set `GTD_API_KEY` on the server, then pass
+`Authorization: Bearer <key>` on every request.
+
+<!-- BEGIN API MENU -->
+| Method | Path | Description |
+| --- | --- | --- |
+| `POST` | `/capture` | Add an item to the inbox. Body: {"header": "..."}. |
+| `GET` | `/contexts` | Get active contexts. |
+| `GET` | `/inbox` | Get all Triage entries (inbox). |
+| `GET` | `/list-categories` | Return canonical list categories from Notion (for debugging/UI use). |
+| `GET` | `/list/<category>` | Get all entries in a specific list category. |
+| `GET` | `/next-steps` | Get actionable next steps, optionally filtered by context. |
+| `GET` | `/triage-schema` | Get schema for triage workflow: statuses and contexts per status. |
+| `POST` | `/triage/<page_id>` | Atomically triage an entry with full data. |
+<!-- END API MENU -->
+
+## Updating this README
+
+The menu table and the HTTP API table above are both extracted from source
+(`cli.py`'s `menu_items` and the `@app.get`/`@app.post`/... routes in
+`api.py`, respectively). After changing either, regenerate both:
+
+```bash
+python scripts/update_readme.py
+```
+
+A pre-commit hook (`sync-readme`) runs this automatically whenever `cli.py`,
+`api.py`, or `README.md` changes, so the tables shouldn't drift in practice.
+
+## Data storage
+
+- **GTD**: Notion database (configured via `gtd init` or `NOTION_NOTES_TOKEN` / `NOTION_PROJECTS_DB_ID` env vars)
+- **Weekly review state, Areas of Focus, list categories**: JSON files in `~/.local/share/gtd/`
+
+## Project structure
+
+```
+src/gtd/
+├── gtd.py           # GTD interactive menu and CLI commands
+├── gtd_tui.py       # Textual TUI
+├── storage.py       # File I/O and path management
+├── ui.py            # fzf helpers, prompts, formatting
+└── notion/
+    ├── client.py    # Notion API client
+    ├── config.py    # Config file management (~/.config/gtd/)
+    ├── schema.py    # Database schema definition
+    ├── init.py      # Database creation and upgrades
+    ├── models.py    # ProjectEntry dataclass
+    ├── commands.py  # GTD command implementations
+    ├── capture.py   # Inbox capture
+    ├── triage.py    # Triage processing
+    └── display.py   # Entry formatting
+scripts/
+└── update_readme.py # Auto-update README menu section
+```

gtd_tui-0.1.0/README.md

@@ -0,0 +1,142 @@
+# The Getting Things Done Terminal User Interface
+
+A TUI/CLI/API for personal productivity built around [GTD (Getting Things Done)](https://gettingthingsdone.com/).
+
+## What it does
+
+- Capture items to an inbox and triage them into projects
+- Track projects with contexts, next actions, and follow-up dates
+- Log completions and auto-reschedule recurring items
+- Defer, snooze, and review Someday/Maybe lists
+- Filter by context for focused work sessions
+
+## Requirements
+
+- Python 3.12+
+- [fzf](https://github.com/junegunn/fzf) (for interactive menus)
+- A [Notion integration token](https://developers.notion.com/) (for `gtd`)
+
+## Installation
+
+```bash
+cd gtd
+uv sync
+uv pip install -e .
+```
+
+This installs the `gtd` command.
+
+## Usage
+
+### GTD interactive mode
+
+```bash
+gtd
+```
+
+Opens the fzf-powered GTD menu:
+
+<!-- BEGIN MENU -->
+| Category | Action |
+| --- | --- |
+| Do | Today |
+| Do | Log & Reschedule |
+| Do | Snooze until tomorrow |
+| Do | Capture new item |
+| Do | Brain dump |
+| Do | Triage inbox |
+| Manage | Update project |
+| Manage | Defer project until date |
+| Manage | Waiting For |
+| Manage | Mark done (delete) |
+| Review | Weekly Review |
+| Review | Review Someday/Maybe |
+| View | View all projects |
+| View | Filter by context |
+<!-- END MENU -->
+
+### GTD subcommands
+
+```bash
+gtd init             # Set up a new GTD Notion database
+gtd init --upgrade   # Add missing properties/options to existing DB
+gtd triage           # Process inbox items
+gtd review           # Guided weekly review ritual
+gtd dump             # Rapid-fire brain dump
+gtd filter work      # Filter projects by context
+gtd today            # Show today's actionable items
+gtd capture          # Quick-capture to inbox
+gtd done             # Mark a project as done
+gtd update           # Update project fields
+gtd defer            # Defer a project
+```
+
+## HTTP API
+
+A small Flask app (`gtd api`) exposes GTD operations over HTTP, primarily so
+you can drive `gtd` from **iOS Shortcuts** (or any other HTTP client) without
+opening a terminal — capture a thought, check today's actionable items, or
+triage the inbox from your phone.
+
+There's no central server in the loop: you run this yourself, against your own
+Notion integration and database. Your GTD data lives in your Notion account under
+your own token.
+
+
+**Install**: `uv pip install "gtd[api]"`
+**Run**: `gtd api` (default `0.0.0.0:8000`) or `gtd api --port 9000`
+**Auth**: Bearer token — set `GTD_API_KEY` on the server, then pass
+`Authorization: Bearer <key>` on every request.
+
+<!-- BEGIN API MENU -->
+| Method | Path | Description |
+| --- | --- | --- |
+| `POST` | `/capture` | Add an item to the inbox. Body: {"header": "..."}. |
+| `GET` | `/contexts` | Get active contexts. |
+| `GET` | `/inbox` | Get all Triage entries (inbox). |
+| `GET` | `/list-categories` | Return canonical list categories from Notion (for debugging/UI use). |
+| `GET` | `/list/<category>` | Get all entries in a specific list category. |
+| `GET` | `/next-steps` | Get actionable next steps, optionally filtered by context. |
+| `GET` | `/triage-schema` | Get schema for triage workflow: statuses and contexts per status. |
+| `POST` | `/triage/<page_id>` | Atomically triage an entry with full data. |
+<!-- END API MENU -->
+
+## Updating this README
+
+The menu table and the HTTP API table above are both extracted from source
+(`cli.py`'s `menu_items` and the `@app.get`/`@app.post`/... routes in
+`api.py`, respectively). After changing either, regenerate both:
+
+```bash
+python scripts/update_readme.py
+```
+
+A pre-commit hook (`sync-readme`) runs this automatically whenever `cli.py`,
+`api.py`, or `README.md` changes, so the tables shouldn't drift in practice.
+
+## Data storage
+
+- **GTD**: Notion database (configured via `gtd init` or `NOTION_NOTES_TOKEN` / `NOTION_PROJECTS_DB_ID` env vars)
+- **Weekly review state, Areas of Focus, list categories**: JSON files in `~/.local/share/gtd/`
+
+## Project structure
+
+```
+src/gtd/
+├── gtd.py           # GTD interactive menu and CLI commands
+├── gtd_tui.py       # Textual TUI
+├── storage.py       # File I/O and path management
+├── ui.py            # fzf helpers, prompts, formatting
+└── notion/
+    ├── client.py    # Notion API client
+    ├── config.py    # Config file management (~/.config/gtd/)
+    ├── schema.py    # Database schema definition
+    ├── init.py      # Database creation and upgrades
+    ├── models.py    # ProjectEntry dataclass
+    ├── commands.py  # GTD command implementations
+    ├── capture.py   # Inbox capture
+    ├── triage.py    # Triage processing
+    └── display.py   # Entry formatting
+scripts/
+└── update_readme.py # Auto-update README menu section
+```

gtd_tui-0.1.0/pyproject.toml

@@ -0,0 +1,82 @@
+[project]
+name = "gtd-tui"
+version = "0.1.0"
+description = "GTD + 12-Week Year CLI powered by Notion"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+dependencies = ["click>=8.1.0", "httpx>=0.28.0", "pydantic>=2.13.4", "python-dateutil>=2.9.0.post0", "textual>=0.71.0"]
+
+[project.urls]
+Repository = "https://github.com/dannybrown37/gtd"
+
+[project.optional-dependencies]
+api = ["flask>=3.1.0"]
+
+
+[project.scripts]
+gtd = "gtd.cli:main"
+
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+
+[build-system]
+requires = ["setuptools>=75.0"]
+build-backend = "setuptools.build_meta"
+
+
+[tool.ruff]
+line-length = 79
+show-fixes = true
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+  "A", "ANN", "ARG", "B", "C4", "COM", "C90",
+  "D200", "D201", "D202", "D205", "D212",
+  "E", "EM", "ERA", "EXE", "F", "FBT", "G", "I", "ICN", "ISC", "N",
+  "PGH", "PIE", "PL", "PLE", "PLR", "PLW", "PT", "PTH", "PYI", "Q",
+  "RET", "RSE", "RUF", "S", "SLF", "SIM", "TCH", "TID", "TRY", "W",
+  "UP", "YTT",
+]
+ignore = [
+    "S311",
+    "S101",
+    "I001",
+    "S113",
+    "PLR0913",
+    "PLC0415",
+    "COM812",  # conflicts with formatter
+    "FBT001",  # click uses bool positional args by design
+]
+
+[tool.ruff.lint.flake8-quotes]
+inline-quotes = "single"
+
+[tool.ruff.lint.per-file-ignores]
+"test_*.py" = ["ANN201", "PLR2004", "ANN001", "ANN003", "ARG002", "PT019"]
+"tests/**" = ["ANN201", "PLR2004", "ANN001", "ANN003", "ARG002", "PT019"]
+"api.py" = ["ANN401"]
+
+[tool.ruff.format]
+quote-style = "single"
+docstring-code-format = true
+
+[dependency-groups]
+dev = [
+    "commitizen>=4.10.0",
+    "pytest>=9.1.1",
+    "pytest-cov>=7.1.0",
+]
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version_provider = "pep621"
+tag_format = "v$version"
+major_version_zero = true
+# BOOTSTRAP ONLY: true crashes `cz bump` with NoRevisionError when the repo
+# has zero tags (incremental changelog has nothing to diff against). Flip
+# back to true in a follow-up commit once v0.1.0 exists.
+update_changelog_on_bump = false

gtd_tui-0.1.0/setup.cfg

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

gtd_tui-0.1.0/src/gtd/__init__.py

@@ -0,0 +1 @@
+"""A CLI for the Getting Things Done (GTD) method."""