sb-tracker 0.1.0__tar.gz

sb_tracker-0.1.0/LICENSE

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

sb_tracker-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+recursive-include src/sb_tracker *.py
+include README.md
+include LICENSE

sb_tracker-0.1.0/PKG-INFO

@@ -0,0 +1,294 @@
+Metadata-Version: 2.4
+Name: sb-tracker
+Version: 0.1.0
+Summary: A minimal, standalone issue tracker for individuals. No git hooks, no complex dependencies, just one JSON file.
+Home-page: https://github.com/sirius-cc-wu/sb-tracker
+Author: Simple Beads Contributors
+License: MIT
+Project-URL: Homepage, https://github.com/sirius-cc-wu/sb-tracker
+Project-URL: Documentation, https://github.com/sirius-cc-wu/sb-tracker#readme
+Keywords: task-tracker,issues,simple,standalone
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# SB Tracker - Simple Beads
+
+A lightweight, standalone task tracker that stores state in a local `.sb.json` file. Perfect for individuals and agents to maintain context and track long-running or multi-step tasks without external dependencies.
+
+## Features
+
+- **Zero Dependencies**: Pure Python, uses only stdlib (json, os, sys, datetime)
+- **Standalone**: One JSON file stores all state locally
+- **Hierarchical Tasks**: Support for sub-tasks with parent-child relationships
+- **Priority Levels**: Tasks support P0-P3 priority levels
+- **Task Status Tracking**: Open/closed status with timestamps
+- **Dependencies**: Link tasks with blocking dependencies
+- **Audit Log**: Track all changes to each task with timestamps
+- **JSON Export**: Machine-readable output for integration
+- **Compaction**: Archive closed tasks to keep context efficient
+
+## Installation
+
+### From PyPI (when published)
+
+```bash
+pip install sb-tracker
+```
+
+### From Source
+
+```bash
+git clone https://github.com/sirius-cc-wu/sb-tracker.git
+cd sb-tracker
+pip install -e .
+```
+
+## Quick Start
+
+Initialize a new task tracker:
+
+```bash
+sb init
+```
+
+Add a task:
+
+```bash
+sb add "My first task"
+sb add "High priority task" 0 "This is urgent"
+```
+
+List tasks:
+
+```bash
+sb list              # Show open tasks
+sb list --all        # Show all tasks
+sb list --json       # Machine-readable output
+```
+
+Complete a task:
+
+```bash
+sb done sb-1
+```
+
+## Commands
+
+### Create and Modify
+
+- **`init`**: Initialize `.sb.json` in the current git repository root
+- **`add <title> [priority] [description] [parent_id]`**
+  - Example: `sb add "Setup database" 1 "Configure PostgreSQL" sb-1`
+- **`update <id> [field=value ...]`**
+  - Fields: `title`, `desc`, `p` (priority), `parent`
+  - Example: `sb update sb-1 p=0 desc="New description"`
+- **`dep <child_id> <parent_id>`**: Add a blocking dependency
+  - Example: `sb dep sb-2 sb-1` (sb-2 blocked by sb-1)
+
+### List and Search
+
+- **`list [--all] [--json]`**: Show open (or all) tasks with hierarchy
+- **`ready [--json]`**: Show tasks with no open blockers
+- **`search <keyword> [--json]`**: Search titles and descriptions
+
+### Reporting and Maintenance
+
+- **`show <id> [--json]`**: Display task details with audit log
+- **`promote <id>`**: Generate Markdown summary of task and sub-tasks
+- **`stats`**: Overview of progress and priority breakdown
+- **`compact`**: Archive closed tasks to save space
+- **`done <id>`**: Mark task as closed
+- **`rm <id>`**: Permanently delete task
+
+## Workflow
+
+### For Individual Sessions
+
+1. **Breakdown**: Create tasks with hierarchies for complex work
+   ```bash
+   sb add "Implement feature X"                    # Creates sb-1
+   sb add "Write unit tests" 1 "" sb-1             # Creates sb-1.1
+   sb add "Write integration tests" 1 "" sb-1      # Creates sb-1.2
+   ```
+
+2. **Execute**: Focus on high-priority ready tasks
+   ```bash
+   sb ready  # Show tasks with no blockers
+   ```
+
+3. **Track Progress**: Update as you complete steps
+   ```bash
+   sb done sb-1.1
+   sb done sb-1.2
+   ```
+
+4. **Report**: Generate summary when handing off
+   ```bash
+   sb promote sb-1
+   ```
+
+### Task ID Format
+
+- **Root tasks**: `sb-1`, `sb-2`, etc.
+- **Sub-tasks**: `sb-1.1`, `sb-1.2`, `sb-1.1.1`, etc.
+- **Parent relationship**: Use parent ID in `add` or `update`
+
+## Priority Levels
+
+- **P0**: Critical, blocking everything
+- **P1**: High priority, do soon
+- **P2**: Normal priority (default)
+- **P3**: Low priority, nice to have
+
+## Database Format
+
+Tasks are stored in `.sb.json` (found in git repository root) with this schema:
+
+```json
+{
+  "issues": [
+    {
+      "id": "sb-1",
+      "title": "Task title",
+      "description": "Optional description",
+      "priority": 1,
+      "status": "open",
+      "depends_on": ["sb-2"],
+      "parent": "sb-1",
+      "created_at": "2026-02-04T18:40:10.692Z",
+      "closed_at": "2026-02-04T19:40:10.692Z",
+      "events": [
+        {
+          "type": "created",
+          "timestamp": "2026-02-04T18:40:10.692Z",
+          "title": "Task title"
+        }
+      ]
+    }
+  ],
+  "compaction_log": []
+}
+```
+
+## Examples
+
+### Hierarchical Task Breakdown
+
+```bash
+$ sb add "Build authentication system"
+Created sb-1: Build authentication system (P2)
+
+$ sb add "Design schema" 1 "" sb-1
+Created sb-1.1: Design schema (P1)
+
+$ sb add "Implement login endpoint" 1 "" sb-1
+Created sb-1.2: Implement login endpoint (P1)
+
+$ sb add "Write tests" 2 "" sb-1
+Created sb-1.3: Write tests (P2)
+
+$ sb list
+ID           P  Status       Deps       Title
+sb-1         2  open                    Build authentication system
+sb-1.1       1  open                      Design schema
+sb-1.2       1  open                      Implement login endpoint
+sb-1.3       2  open                      Write tests
+```
+
+### Blocking Dependencies
+
+```bash
+$ sb add "Deploy to production" 1
+Created sb-2: Deploy to production (P1)
+
+$ sb dep sb-2 sb-1
+Linked sb-2 -> depends on -> sb-1
+
+$ sb ready
+No issues found matching criteria.
+
+$ sb done sb-1.1
+Updated sb-1.1 status to closed
+
+$ sb done sb-1.2
+Updated sb-1.2 status to closed
+
+$ sb done sb-1.3
+Updated sb-1.3 status to closed
+
+$ sb done sb-1
+Updated sb-1 status to closed
+
+$ sb ready
+ID           P  Status       Deps       Title
+sb-2         1  open                    Deploy to production
+```
+
+### Task Reporting
+
+```bash
+$ sb promote sb-1
+### [sb-1] Build authentication system
+**Status:** closed | **Priority:** P2
+
+#### Sub-tasks
+- [x] sb-1.1: Design schema
+- [x] sb-1.2: Implement login endpoint
+- [x] sb-1.3: Write tests
+
+#### Activity Log
+- 2026-02-04: Created
+- 2026-02-04: Status: open -> closed
+```
+
+## License
+
+MIT License - See LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Troubleshooting
+
+### `.sb.json` not found
+
+The tracker looks for `.sb.json` starting from the current directory and walking up the directory tree until it finds a `.git` directory (to keep data project-local). If not found, it creates `.sb.json` in the current working directory.
+
+To initialize:
+```bash
+cd /your/project
+sb init
+```
+
+### Task not found error
+
+Make sure you're using the correct task ID:
+```bash
+$ sb list --json   # See all task IDs
+```
+
+### Compaction
+
+Archive old tasks to reduce token context:
+```bash
+sb compact
+```
+
+This moves all closed tasks to a `compaction_log` and keeps them accessible via `list --all` or `list --json`.

sb_tracker-0.1.0/README.md

@@ -0,0 +1,265 @@
+# SB Tracker - Simple Beads
+
+A lightweight, standalone task tracker that stores state in a local `.sb.json` file. Perfect for individuals and agents to maintain context and track long-running or multi-step tasks without external dependencies.
+
+## Features
+
+- **Zero Dependencies**: Pure Python, uses only stdlib (json, os, sys, datetime)
+- **Standalone**: One JSON file stores all state locally
+- **Hierarchical Tasks**: Support for sub-tasks with parent-child relationships
+- **Priority Levels**: Tasks support P0-P3 priority levels
+- **Task Status Tracking**: Open/closed status with timestamps
+- **Dependencies**: Link tasks with blocking dependencies
+- **Audit Log**: Track all changes to each task with timestamps
+- **JSON Export**: Machine-readable output for integration
+- **Compaction**: Archive closed tasks to keep context efficient
+
+## Installation
+
+### From PyPI (when published)
+
+```bash
+pip install sb-tracker
+```
+
+### From Source
+
+```bash
+git clone https://github.com/sirius-cc-wu/sb-tracker.git
+cd sb-tracker
+pip install -e .
+```
+
+## Quick Start
+
+Initialize a new task tracker:
+
+```bash
+sb init
+```
+
+Add a task:
+
+```bash
+sb add "My first task"
+sb add "High priority task" 0 "This is urgent"
+```
+
+List tasks:
+
+```bash
+sb list              # Show open tasks
+sb list --all        # Show all tasks
+sb list --json       # Machine-readable output
+```
+
+Complete a task:
+
+```bash
+sb done sb-1
+```
+
+## Commands
+
+### Create and Modify
+
+- **`init`**: Initialize `.sb.json` in the current git repository root
+- **`add <title> [priority] [description] [parent_id]`**
+  - Example: `sb add "Setup database" 1 "Configure PostgreSQL" sb-1`
+- **`update <id> [field=value ...]`**
+  - Fields: `title`, `desc`, `p` (priority), `parent`
+  - Example: `sb update sb-1 p=0 desc="New description"`
+- **`dep <child_id> <parent_id>`**: Add a blocking dependency
+  - Example: `sb dep sb-2 sb-1` (sb-2 blocked by sb-1)
+
+### List and Search
+
+- **`list [--all] [--json]`**: Show open (or all) tasks with hierarchy
+- **`ready [--json]`**: Show tasks with no open blockers
+- **`search <keyword> [--json]`**: Search titles and descriptions
+
+### Reporting and Maintenance
+
+- **`show <id> [--json]`**: Display task details with audit log
+- **`promote <id>`**: Generate Markdown summary of task and sub-tasks
+- **`stats`**: Overview of progress and priority breakdown
+- **`compact`**: Archive closed tasks to save space
+- **`done <id>`**: Mark task as closed
+- **`rm <id>`**: Permanently delete task
+
+## Workflow
+
+### For Individual Sessions
+
+1. **Breakdown**: Create tasks with hierarchies for complex work
+   ```bash
+   sb add "Implement feature X"                    # Creates sb-1
+   sb add "Write unit tests" 1 "" sb-1             # Creates sb-1.1
+   sb add "Write integration tests" 1 "" sb-1      # Creates sb-1.2
+   ```
+
+2. **Execute**: Focus on high-priority ready tasks
+   ```bash
+   sb ready  # Show tasks with no blockers
+   ```
+
+3. **Track Progress**: Update as you complete steps
+   ```bash
+   sb done sb-1.1
+   sb done sb-1.2
+   ```
+
+4. **Report**: Generate summary when handing off
+   ```bash
+   sb promote sb-1
+   ```
+
+### Task ID Format
+
+- **Root tasks**: `sb-1`, `sb-2`, etc.
+- **Sub-tasks**: `sb-1.1`, `sb-1.2`, `sb-1.1.1`, etc.
+- **Parent relationship**: Use parent ID in `add` or `update`
+
+## Priority Levels
+
+- **P0**: Critical, blocking everything
+- **P1**: High priority, do soon
+- **P2**: Normal priority (default)
+- **P3**: Low priority, nice to have
+
+## Database Format
+
+Tasks are stored in `.sb.json` (found in git repository root) with this schema:
+
+```json
+{
+  "issues": [
+    {
+      "id": "sb-1",
+      "title": "Task title",
+      "description": "Optional description",
+      "priority": 1,
+      "status": "open",
+      "depends_on": ["sb-2"],
+      "parent": "sb-1",
+      "created_at": "2026-02-04T18:40:10.692Z",
+      "closed_at": "2026-02-04T19:40:10.692Z",
+      "events": [
+        {
+          "type": "created",
+          "timestamp": "2026-02-04T18:40:10.692Z",
+          "title": "Task title"
+        }
+      ]
+    }
+  ],
+  "compaction_log": []
+}
+```
+
+## Examples
+
+### Hierarchical Task Breakdown
+
+```bash
+$ sb add "Build authentication system"
+Created sb-1: Build authentication system (P2)
+
+$ sb add "Design schema" 1 "" sb-1
+Created sb-1.1: Design schema (P1)
+
+$ sb add "Implement login endpoint" 1 "" sb-1
+Created sb-1.2: Implement login endpoint (P1)
+
+$ sb add "Write tests" 2 "" sb-1
+Created sb-1.3: Write tests (P2)
+
+$ sb list
+ID           P  Status       Deps       Title
+sb-1         2  open                    Build authentication system
+sb-1.1       1  open                      Design schema
+sb-1.2       1  open                      Implement login endpoint
+sb-1.3       2  open                      Write tests
+```
+
+### Blocking Dependencies
+
+```bash
+$ sb add "Deploy to production" 1
+Created sb-2: Deploy to production (P1)
+
+$ sb dep sb-2 sb-1
+Linked sb-2 -> depends on -> sb-1
+
+$ sb ready
+No issues found matching criteria.
+
+$ sb done sb-1.1
+Updated sb-1.1 status to closed
+
+$ sb done sb-1.2
+Updated sb-1.2 status to closed
+
+$ sb done sb-1.3
+Updated sb-1.3 status to closed
+
+$ sb done sb-1
+Updated sb-1 status to closed
+
+$ sb ready
+ID           P  Status       Deps       Title
+sb-2         1  open                    Deploy to production
+```
+
+### Task Reporting
+
+```bash
+$ sb promote sb-1
+### [sb-1] Build authentication system
+**Status:** closed | **Priority:** P2
+
+#### Sub-tasks
+- [x] sb-1.1: Design schema
+- [x] sb-1.2: Implement login endpoint
+- [x] sb-1.3: Write tests
+
+#### Activity Log
+- 2026-02-04: Created
+- 2026-02-04: Status: open -> closed
+```
+
+## License
+
+MIT License - See LICENSE file for details
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Troubleshooting
+
+### `.sb.json` not found
+
+The tracker looks for `.sb.json` starting from the current directory and walking up the directory tree until it finds a `.git` directory (to keep data project-local). If not found, it creates `.sb.json` in the current working directory.
+
+To initialize:
+```bash
+cd /your/project
+sb init
+```
+
+### Task not found error
+
+Make sure you're using the correct task ID:
+```bash
+$ sb list --json   # See all task IDs
+```
+
+### Compaction
+
+Archive old tasks to reduce token context:
+```bash
+sb compact
+```
+
+This moves all closed tasks to a `compaction_log` and keeps them accessible via `list --all` or `list --json`.

sb_tracker-0.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sb-tracker"
+version = "0.1.0"
+description = "A minimal, standalone issue tracker for individuals. No git hooks, no complex dependencies, just one JSON file."
+readme = "README.md"
+license = {text = "MIT"}
+authors = [
+    {name = "Simple Beads Contributors"}
+]
+keywords = ["task-tracker", "issues", "simple", "standalone"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+requires-python = ">=3.7"
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/sirius-cc-wu/sb-tracker"
+Documentation = "https://github.com/sirius-cc-wu/sb-tracker#readme"
+
+[project.scripts]
+sb = "sb_tracker.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages]
+find = {where = ["src"]}

sb_tracker-0.1.0/setup.cfg

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

sb_tracker-0.1.0/setup.py

@@ -0,0 +1,34 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="sb-tracker",
+    version="0.1.0",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    python_requires=">=3.7",
+    entry_points={
+        "console_scripts": [
+            "sb=sb_tracker.cli:main",
+        ],
+    },
+    author="Simple Beads Contributors",
+    description="A minimal, standalone issue tracker for individuals",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/sirius-cc-wu/sb-tracker",
+    license="MIT",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Environment :: Console",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+)

sb_tracker-0.1.0/src/sb_tracker/__init__.py

@@ -0,0 +1,11 @@
+"""
+Simple Beads (sb) - A minimal, standalone issue tracker for individuals.
+No git hooks, no complex dependencies, just one JSON file.
+"""
+
+__version__ = "0.1.0"
+__author__ = "Simple Beads Contributors"
+
+from .cli import main
+
+__all__ = ["main"]