taskunity 2026.1__py3-none-any.whl

taskunity-2026.1.dist-info/METADATA

@@ -0,0 +1,238 @@
+Metadata-Version: 2.4
+Name: taskunity
+Version: 2026.1
+Summary: A local, file-backed productivity app for program/task tracking.
+Author: Taskunity Contributors
+License: MIT
+Keywords: tasks,productivity,fastapi,local-first,dashboard
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.111
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: jinja2>=3.1
+Requires-Dist: python-multipart>=0.0.9
+Requires-Dist: pydantic>=2.7
+Requires-Dist: markdown>=3.6
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7; extra == "docs"
+Requires-Dist: myst-parser>=3; extra == "docs"
+Requires-Dist: furo>=2024.1; extra == "docs"
+
+# Taskunity
+
+A local-first, file-backed productivity web app for managing tasks. Everything lives in
+plain files on your disk — no database, no account, no cloud. Point Taskunity at a folder and it
+serves a browser UI for dashboards, a Gantt timeline, a Kanban board, a calendar, activity logs,
+burndown charts, and an editable task side panel.
+
+> Documentation: a full guide is in the [`docs/`](docs/) folder and is set up to build on
+> [Read the Docs](https://readthedocs.org/) (Sphinx + Markdown).
+
+## Screenshots
+
+| Task List | Task Board |
+|-----------|-----------|
+| ![Task List](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/task-list.png) | ![Task Board](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/task-board.png) |
+
+| Gantt Timeline | Calendar |
+|----------------|----------|
+| ![Gantt](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/gantt.png) | ![Calendar](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/calendar.png) |
+
+| Milestones | Projects |
+|------------|----------|
+| ![Milestones](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/milestones.png) | ![Projects](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/projects.png) |
+
+| Task Activity Log | Settings (Theme) |
+|-------------------|------------------|
+| ![Task Panel](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/task-panel.png) | ![Settings Popup](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/settings-popup.png) |
+
+| Task Burndown Chart | Milestone Burndown Chart |
+|---------------------|--------------------------|
+| ![Task Burndown](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/task-burndown.png) | ![Milestone Burndown](https://raw.githubusercontent.com/briday1/taskwright/main/docs/_static/screenshots/milestone-burndown.png) |
+
+## Why Taskunity
+
+- **File-backed source of truth.** Each task is a single JSON file you can read, diff, and commit
+  to git. The whole workspace is a folder you own.
+- **Local-first.** Runs entirely on `127.0.0.1`. Your data never leaves your machine.
+- **Git-aware.** The UI shows branch/ahead/behind/dirty status and has a one-click commit + pull +
+  push sync button when the workspace folder itself is a git repo.
+
+## Workspace layout
+
+The source of truth is a workspace folder:
+
+```text
+workspace/
+  config.json           # editable workspace/app metadata
+  projects/
+    apollo.json         # one file per project
+  tasks/
+    A1B2-C3D4-E5F6-7890.json  # one file per task (native id format)
+  milestones/
+    M-1A2B-3C4D.json    # one file per milestone (groups tasks across projects)
+  assets/
+    A1B2-C3D4-E5F6-7890/  # attachments live alongside their task id
+      screenshot.png
+```
+
+The app provides a browser UI for viewing dashboards, timelines, task boards, activity logs,
+burndown charts, and editing tasks through a side panel.
+
+## Install locally
+
+From a clone of this repository:
+
+```bash
+pip install -e .
+```
+
+This installs the `taskunity` command. (A PyPI release will come later; for now install from
+source.)
+
+## Quick start
+
+```bash
+taskunity serve --workspace ./my-workboard
+```
+
+If the workspace folder does not exist yet, `taskunity serve` will create the empty Taskunity
+structure for you. You can also run it from the current directory and let Taskunity use `.` as
+the workspace.
+
+Then open:
+
+```text
+http://127.0.0.1:8000
+```
+
+`init` is available if you want to scaffold a folder explicitly. It creates an editable
+`config.json`, empty `projects/`, `tasks/`, `milestones/`, and `assets/` directories, plus a README
+stub. It does not create starter projects or tasks; use the app to add your own once you begin.
+
+## Serve an existing workspace
+
+```bash
+taskunity serve --workspace ./path/to/workspace --host 127.0.0.1 --port 8000
+```
+
+| Flag | Default | Description |
+| --- | --- | --- |
+| `--workspace` | `.` | Workspace folder to serve |
+| `--host` | `127.0.0.1` | Host interface to bind |
+| `--port` | `8000` | Port to listen on |
+| `--reload` | off | Enable uvicorn auto-reload (development) |
+
+## Task file example
+
+```json
+{
+  "id": "A1B2-C3D4-E5F6-7890",
+  "title": "CAF refinement prototype",
+  "status": "working",
+  "priority": "high",
+  "project": "Apollo",
+  "summary": "Build a prototype CAF refinement workflow.",
+  "description": "Compare baseline CAF sharpness against protection-aware refinement.",
+  "tags": ["caf", "signal-processing", "prototype"],
+  "start_date": "2026-06-24",
+  "due_date": "2026-06-30",
+  "completed_date": null,
+  "percent_complete": 60,
+  "depends_on": ["0EBB-528F-371E-61AE"],
+  "checklist": [
+    {"text": "Generate baseline CAF", "done": true},
+    {"text": "Export comparison plots", "done": false}
+  ],
+  "activity": [
+    {
+      "id": "a1b2c3d4",
+      "event_type": "note",
+      "created_at": "2026-06-26T10:30:00",
+      "note_text": "Protection-aware version improved sharpness."
+    },
+    {
+      "id": "e5f6a7b8",
+      "event_type": "progress_update",
+      "created_at": "2026-06-26T11:00:00",
+      "progress_before": 40,
+      "progress_after": 60
+    }
+  ]
+}
+```
+
+`depends_on` stores task **ids**. In the UI you add dependencies with a search-as-you-type picker
+that finds tasks by name and shows their status, project, due date, and id — then stores the id.
+Dependencies are reflected on the Gantt timeline (an `↳ after <name>` label plus a marker where the
+dependency's bar ends).
+
+## Milestones
+
+Milestones are a separate entity from projects. A milestone can span **multiple projects**, holds an
+**ordered list of tasks** (which can come from any project, and a task can belong to any number of
+milestones), and has its own description, notes, and attachments — just like a task.
+
+- Open the **Milestones** view to see every milestone with a live rollup (task count, progress,
+  target date).
+- Click a milestone to **filter the whole board to just its tasks** and show a rollup banner; the
+  side panel opens the milestone for editing.
+- Each milestone has its **own colour** used on milestone cards and the rollup banner.
+- From inside a milestone you can **add a task** with one search-as-you-type picker and use the
+  sticky **+ New task** button at the bottom of the list for quick creation (auto-added to that
+  milestone), and remove tasks.
+
+Milestones are stored one JSON file per milestone under `milestones/`.
+
+## Features
+
+- JSON-per-task source model you can version with git
+- Dashboard summary cards (total / done / working / blocked)
+- Kanban-style board with per-project color strips
+- Gantt timeline with dependency markers
+- Calendar view
+- **Milestones** that group tasks across projects, with per-milestone colour,
+  click-to-filter rollup, and their own notes/attachments/description
+- Click any task (row, card, timeline bar, calendar entry) to open an editable side panel
+- Save edits back to the JSON file; raw JSON editor escape hatch
+- **Unified activity log** per task: notes, images, and progress changes in chronological order
+- **Task burndown chart**: remaining work over time from progress_update events
+- **Milestone cumulative burndown chart**: aggregate remaining work across all tasks in a milestone
+- Searchable "depends on" picker that resolves names to task ids
+- Project management with custom colors, each stored in its own JSON file
+- Filtering by project, milestone, date range, and free-text search; sortable views
+- CSV / JSON export
+- Built-in git status chip and one-click sync (commit + pull + push)
+
+## Building the docs locally
+
+```bash
+pip install -e ".[docs]"
+sphinx-build -b html docs docs/_build/html
+```
+
+Open `docs/_build/html/index.html`. On Read the Docs the build is driven by
+[`.readthedocs.yaml`](.readthedocs.yaml).
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check .
+```
+
+## License
+
+MIT

taskunity-2026.1.dist-info/RECORD

@@ -0,0 +1,27 @@
+taskunity/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+taskunity/app.py,sha256=L8ZpCHD6FmrevznU89cYWHwDyJBh-2w0aOVNlmd7950,46654
+taskunity/cli.py,sha256=JSBe-O5H0_A9BK2Xy4S6O_6E_Y1lqoFQ7BOdsDhtxSU,1702
+taskunity/models.py,sha256=aBNhVdY8naS0M19Dy9Vi0NOkSan6ytMbo1xm81l0SZ4,3057
+taskunity/render.py,sha256=yd9D8TBlcedlGuwklRNtE-S3Uhbg2tq1kY1knd6q0kk,12952
+taskunity/task_store.py,sha256=2_BGI42MbbiiMHn_r_4MVfX_2tUz2zEpauZUIa99y3Y,22217
+taskunity/static/app.css,sha256=moWR7hOM-iBeh33PCXJqfXklLcBsEG735zMBrzTmMVU,45847
+taskunity/static/chart.umd.min.js,sha256=SERKgtTty1vsDxll-qzd4Y2cF9swY9BCq62i9wXJ9Uo,208522
+taskunity/static/chartjs-adapter-date-fns.bundle.min.js,sha256=6nqzDSbDjc8fLSa7Q-c6lFN7WPGQb1XhpUbdCTIbVhU,50650
+taskunity/static/htmx.min.js,sha256=klmgDHsZ6a8XOPG-kmXPLypaMFoBKirr7Mt0uEVp8vw,2773
+taskunity/templates/base.html,sha256=m2VfkK3if5VeqkU56dmD1DSSM5AHRCSuExx5LJTzP6E,16576
+taskunity/templates/index.html,sha256=pwN71jYXFk9F2_u0lnKfjIa1hyheYORJw8pwmh5R7zs,95
+taskunity/templates/partials/board.html,sha256=O3kHt4JOqCLWv-XEodsTtnfhdZWkcwdtzEbI6khelP4,1462
+taskunity/templates/partials/calendar.html,sha256=enMtbW7aLCH22LESwiiH6FVjcy0wEmoR32DkQbmgTrk,1182
+taskunity/templates/partials/main.html,sha256=ADYaFA1SLwbHXcDcunuIhQM7XaHs4fPSaVozKW-GyhQ,18901
+taskunity/templates/partials/milestone_banner.html,sha256=idIeD9uAU4EDnV48m04_st-T5D0J_iXk77OT9--8XhA,2097
+taskunity/templates/partials/milestone_panel.html,sha256=6ACKRGIN77vo9UVSkD2kXiNmAp2U8uvK0p4Ay5a2A2U,12542
+taskunity/templates/partials/milestones.html,sha256=UmbLMCwpPhaxydr3Uqmc3SKxKCqra56bTVg6kuBfnPs,2876
+taskunity/templates/partials/projects.html,sha256=PFvhEprbihtH9sVW-kIB2i5Rth7ffJH7imbTZPl86FI,1768
+taskunity/templates/partials/task_list.html,sha256=HhZikF2clnExMav2PiVbojpTckRKYTm3KRDEk-KZ030,3233
+taskunity/templates/partials/task_panel.html,sha256=qBrs7NZwn5CwVBzdzAZI9atgY7_V_Lr6YDjOPycZy1c,17591
+taskunity/templates/partials/timeline.html,sha256=ae8d_do8Z5bI_IQLiDZmz3o5flAP8fxYQ-yZVqF_zos,1750
+taskunity-2026.1.dist-info/METADATA,sha256=pjWS42bAS6GJRJJYusx-ZZAhYwLWt4SpAf2HPMXU3SY,9134
+taskunity-2026.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+taskunity-2026.1.dist-info/entry_points.txt,sha256=gRoen6I_jQKeihjHZlkw4ewKlr6nfe2YGgvYXDczM4w,49
+taskunity-2026.1.dist-info/top_level.txt,sha256=umSK26x52afLBsi90EfwiR0MuTWrxmgReATuMUAE5L0,10
+taskunity-2026.1.dist-info/RECORD,,

taskunity-2026.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

taskunity-2026.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+taskunity = taskunity.cli:main

taskunity-2026.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+taskunity