nod-cli 0.1.0rc1__tar.gz

nod_cli-0.1.0rc1/.github/workflows/publish.yml

@@ -0,0 +1,22 @@
+name: publish
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: python -m pip install --upgrade build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

nod_cli-0.1.0rc1/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.nod/
+.DS_Store
+dist/
+build/

nod_cli-0.1.0rc1/LICENSE

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

nod_cli-0.1.0rc1/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: nod-cli
+Version: 0.1.0rc1
+Summary: Git-native project management for humans and coding agents.
+Project-URL: Homepage, https://github.com/neatnettech/nod
+Project-URL: Repository, https://github.com/neatnettech/nod
+Author: neatnettech
+License: MIT
+License-File: LICENSE
+Keywords: cli,git,kanban,mcp,project-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: >=3.13
+Requires-Dist: alembic<2,>=1.16
+Requires-Dist: mcp<2,>=1.9
+Requires-Dist: networkx<4,>=3.4
+Requires-Dist: pydantic<3,>=2.11
+Requires-Dist: rich<15,>=14
+Requires-Dist: sqlalchemy<3,>=2.0
+Requires-Dist: typer<1,>=0.16
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio<2,>=1; extra == 'dev'
+Requires-Dist: pytest<9,>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Nod
+
+Git-native project management for humans and coding agents.
+
+Nod lives in your repository: project state is stored in `.nod/nod.db`, so
+the plan travels with the code. Humans drive it through a focused CLI,
+coding agents drive the same state through an MCP server.
+
+## Install
+
+```bash
+# released version from PyPI (both nod and nod-mcp on PATH)
+pipx install nod-cli
+
+# bleeding edge, straight from main
+pipx install git+https://github.com/neatnettech/nod.git
+```
+
+After a PyPI release, update with `pipx upgrade nod-cli`. For git installs,
+run `pipx reinstall nod-cli` to pick up new commits.
+
+## Quick start
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+
+mkdir demo && cd demo
+git init
+nod init
+```
+
+## Concepts
+
+* **Modules** group work by area: `nod module add "Vault"`
+* **Cycles** are timeboxed plans: `nod cycle add "Sprint 1" --start 2026-10-01 --end 2026-10-14`
+* **Work items** are epics, stories, tasks, and bugs:
+  `nod task add "Seed categories" --module vault --cycle sprint-1 --estimate 2h`
+* **Dependencies** order the work: `nod depends OSS-2 OSS-1`
+
+## Views
+
+```bash
+nod task list                    # tabular work items
+nod module list                  # modules
+nod cycle list                   # cycles
+nod board                        # kanban grouped by status
+nod timeline                     # cycles over time with estimates
+nod graph                        # ASCII dependency diagram
+```
+
+The dependency graph renders as a tree of prerequisite arrows with status
+glyphs and branch names:
+
+```
+OSS-1  StateBadge component  ✓ DONE  ⎇ feat/oss-1-statebadge
+OSS-3  Seed categories       ○ TODO
+├─► OSS-4  Vault home        ◐ IN_PROGRESS  (depends on this)
+└─► OSS-6  Note editor       ○ TODO         (depends on this)
+```
+
+Every view accepts `--json` for scripting and agents.
+
+## Agents
+
+`nod-mcp` exposes the same state as MCP tools: work item create/update/list,
+project info, the board, the timeline, and the dependency graph. Point your
+MCP client at `nod-mcp` from inside the repository.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+Releases: tag a version (`v0.1.0-rc.1`, then `v0.1.0`) and push it. The
+`publish` workflow builds the version from the tag and publishes to PyPI via
+trusted publishing. Requires Python 3.13+.

nod_cli-0.1.0rc1/README.md

@@ -0,0 +1,80 @@
+# Nod
+
+Git-native project management for humans and coding agents.
+
+Nod lives in your repository: project state is stored in `.nod/nod.db`, so
+the plan travels with the code. Humans drive it through a focused CLI,
+coding agents drive the same state through an MCP server.
+
+## Install
+
+```bash
+# released version from PyPI (both nod and nod-mcp on PATH)
+pipx install nod-cli
+
+# bleeding edge, straight from main
+pipx install git+https://github.com/neatnettech/nod.git
+```
+
+After a PyPI release, update with `pipx upgrade nod-cli`. For git installs,
+run `pipx reinstall nod-cli` to pick up new commits.
+
+## Quick start
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+
+mkdir demo && cd demo
+git init
+nod init
+```
+
+## Concepts
+
+* **Modules** group work by area: `nod module add "Vault"`
+* **Cycles** are timeboxed plans: `nod cycle add "Sprint 1" --start 2026-10-01 --end 2026-10-14`
+* **Work items** are epics, stories, tasks, and bugs:
+  `nod task add "Seed categories" --module vault --cycle sprint-1 --estimate 2h`
+* **Dependencies** order the work: `nod depends OSS-2 OSS-1`
+
+## Views
+
+```bash
+nod task list                    # tabular work items
+nod module list                  # modules
+nod cycle list                   # cycles
+nod board                        # kanban grouped by status
+nod timeline                     # cycles over time with estimates
+nod graph                        # ASCII dependency diagram
+```
+
+The dependency graph renders as a tree of prerequisite arrows with status
+glyphs and branch names:
+
+```
+OSS-1  StateBadge component  ✓ DONE  ⎇ feat/oss-1-statebadge
+OSS-3  Seed categories       ○ TODO
+├─► OSS-4  Vault home        ◐ IN_PROGRESS  (depends on this)
+└─► OSS-6  Note editor       ○ TODO         (depends on this)
+```
+
+Every view accepts `--json` for scripting and agents.
+
+## Agents
+
+`nod-mcp` exposes the same state as MCP tools: work item create/update/list,
+project info, the board, the timeline, and the dependency graph. Point your
+MCP client at `nod-mcp` from inside the repository.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+Releases: tag a version (`v0.1.0-rc.1`, then `v0.1.0`) and push it. The
+`publish` workflow builds the version from the tag and publishes to PyPI via
+trusted publishing. Requires Python 3.13+.

nod_cli-0.1.0rc1/migrations/README.md

@@ -0,0 +1,3 @@
+# Alembic migrations
+
+The initial scaffold uses SQLAlchemy metadata for bootstrap. Alembic migrations should be introduced before production use.

nod_cli-0.1.0rc1/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "nod-cli"
+dynamic = ["version"]
+description = "Git-native project management for humans and coding agents."
+requires-python = ">=3.13"
+license = { text = "MIT" }
+readme = "README.md"
+authors = [{ name = "neatnettech" }]
+keywords = ["project-management", "cli", "kanban", "mcp", "git"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: MacOS :: MacOS X",
+  "Operating System :: POSIX :: Linux",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development",
+]
+dependencies = [
+  "alembic>=1.16,<2",
+  "mcp>=1.9,<2",
+  "networkx>=3.4,<4",
+  "pydantic>=2.11,<3",
+  "rich>=14,<15",
+  "sqlalchemy>=2.0,<3",
+  "typer>=0.16,<1",
+]
+
+[project.urls]
+Homepage = "https://github.com/neatnettech/nod"
+Repository = "https://github.com/neatnettech/nod"
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8,<9",
+  "pytest-asyncio>=1,<2",
+]
+
+[project.scripts]
+nod = "nod.cli.app:app"
+nod-mcp = "nod.mcp.server:main"
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nod"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

nod_cli-0.1.0rc1/src/nod/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

nod_cli-0.1.0rc1/src/nod/application/services.py

@@ -0,0 +1,195 @@
+from pathlib import Path
+import re
+from uuid import UUID, uuid4
+
+import networkx as nx
+from sqlalchemy import select
+
+from nod.domain.enums import (
+    CycleStatus,
+    ModuleStatus,
+    Priority,
+    RelationType,
+    WorkItemStatus,
+    WorkItemType,
+)
+from nod.domain.errors import DependencyCycleError, NotFoundError, ValidationError
+from nod.domain.models import Cycle, Module, WorkItem
+from nod.infrastructure.models import WorkItemRelationModel
+
+
+def slugify(value: str) -> str:
+    value = value.strip().lower()
+    value = re.sub(r"[^a-z0-9]+", "-", value)
+    return value.strip("-")
+
+
+class Services:
+    def __init__(self, session, project):
+        from nod.infrastructure.repositories import (
+            CycleRepository,
+            ModuleRepository,
+            WorkItemRepository,
+        )
+        self.session = session
+        self.project = project
+        self.modules = ModuleRepository(session)
+        self.cycles = CycleRepository(session)
+        self.items = WorkItemRepository(session)
+
+    def create_module(self, name: str, description=None) -> Module:
+        if not name.strip():
+            raise ValidationError("Module name cannot be empty.")
+        module = Module(uuid4(), self.project.id, name.strip(), slugify(name), description=description)
+        self.modules.add(module)
+        self.session.commit()
+        return module
+
+    def update_module(self, ref: str, title=None, description=None, append=None, status=None, start=None, target=None):
+        module = self.modules.get(ref)
+        if not module:
+            raise NotFoundError(f"Module not found: {ref}")
+        if title is not None:
+            module.name = title.strip()
+        if description is not None:
+            module.description = description
+        if append is not None:
+            module.description = ((module.description or "").rstrip() + "\n\n" + append.strip()).strip()
+        if status is not None:
+            module.status = ModuleStatus(status)
+        self.modules.update(module)
+        self.session.commit()
+        return module
+
+    def create_cycle(self, name: str, start=None, end=None, description=None) -> Cycle:
+        if not name.strip():
+            raise ValidationError("Cycle name cannot be empty.")
+        if start and end and start > end:
+            raise ValidationError("Cycle start date cannot be after end date.")
+        cycle = Cycle(uuid4(), self.project.id, name.strip(), slugify(name), description=description, start_date=start, end_date=end)
+        self.cycles.add(cycle)
+        self.session.commit()
+        return cycle
+
+    def update_cycle(self, ref: str, title=None, description=None, append=None, status=None, start=None, end=None):
+        cycle = self.cycles.get(ref)
+        if not cycle:
+            raise NotFoundError(f"Cycle not found: {ref}")
+        new_start = start if start is not None else cycle.start_date
+        new_end = end if end is not None else cycle.end_date
+        if new_start and new_end and new_start > new_end:
+            raise ValidationError("Cycle start date cannot be after end date.")
+        if title is not None:
+            cycle.name = title.strip()
+        if description is not None:
+            cycle.description = description
+        if append is not None:
+            cycle.description = ((cycle.description or "").rstrip() + "\n\n" + append.strip()).strip()
+        if status is not None:
+            cycle.status = CycleStatus(status)
+        cycle.start_date, cycle.end_date = new_start, new_end
+        self.cycles.update(cycle)
+        self.session.commit()
+        return cycle
+
+    def create_task(self, title: str, description=None, type_=WorkItemType.TASK, priority=Priority.MEDIUM, module=None, cycle=None, estimate=None, status=None, branch=None):
+        if not title.strip():
+            raise ValidationError("Task title cannot be empty.")
+        sequence = self.items.next_sequence(self.project.id)
+        item = WorkItem(
+            uuid4(), self.project.id, sequence,
+            f"{self.project.identifier}-{sequence}", title.strip(),
+            description=description, type=type_, priority=priority,
+            module_id=module.id if module else None,
+            cycle_id=cycle.id if cycle else None,
+            estimate=estimate,
+            status=status or WorkItemStatus.TODO,
+            branch_name=branch,
+        )
+        self.items.add(item)
+        self.session.commit()
+        return item
+
+    def update_task(
+        self, identifier: str, title=None, description=None, append=None,
+        status=None, priority=None, module=None, cycle=None, branch=None, estimate=None
+    ):
+        item = self.items.get(self.project.id, identifier)
+        if not item:
+            raise NotFoundError(f"Work Item not found: {identifier}")
+        if title is not None:
+            item.title = title.strip()
+        if description is not None:
+            item.description = description
+        if append is not None:
+            item.description = ((item.description or "").rstrip() + "\n\n" + append.strip()).strip()
+        if status is not None:
+            item.status = WorkItemStatus(status)
+        if priority is not None:
+            item.priority = Priority(priority)
+        if module is not None:
+            item.module_id = module.id
+        if cycle is not None:
+            item.cycle_id = cycle.id
+        if branch is not None:
+            item.branch_name = branch
+        if estimate is not None:
+            item.estimate = estimate
+        self.items.update(item)
+        self.session.commit()
+        return item
+
+    def add_dependency(self, source: str, target: str):
+        source_item = self.items.get(self.project.id, source)
+        target_item = self.items.get(self.project.id, target)
+        if not source_item or not target_item:
+            raise NotFoundError("Both Work Items must exist.")
+
+        graph = self._dependency_graph()
+        graph.add_edge(source_item.identifier, target_item.identifier)
+        if not nx.is_directed_acyclic_graph(graph):
+            raise DependencyCycleError("Dependency would create a cycle.")
+
+        self.session.add(WorkItemRelationModel(
+            source_work_item_id=str(source_item.id),
+            target_work_item_id=str(target_item.id),
+            relation_type=RelationType.DEPENDS_ON.value,
+        ))
+        self.session.commit()
+
+    def _dependency_graph(self):
+        graph = nx.DiGraph()
+        rows = self.session.scalars(
+            select(WorkItemRelationModel).where(
+                WorkItemRelationModel.relation_type == RelationType.DEPENDS_ON.value
+            )
+        ).all()
+        for row in rows:
+            source = self.session.get(__import__("nod.infrastructure.models", fromlist=["WorkItemModel"]).WorkItemModel, row.source_work_item_id)
+            target = self.session.get(__import__("nod.infrastructure.models", fromlist=["WorkItemModel"]).WorkItemModel, row.target_work_item_id)
+            if source and target:
+                graph.add_edge(source.identifier, target.identifier)
+        return graph
+
+    def graph(self):
+        from nod.infrastructure.models import WorkItemRelationModel, WorkItemModel
+        graph = nx.DiGraph()
+        items = self.items.list(self.project.id)
+        modules = {m.id: m.slug for m in self.modules.list()}
+        for item in items:
+            graph.add_node(
+                item.identifier,
+                title=item.title,
+                status=item.status.value,
+                priority=item.priority.value,
+                description=item.description or "",
+                branch=item.branch_name,
+                module=modules.get(item.module_id),
+            )
+        rows = self.session.scalars(select(WorkItemRelationModel)).all()
+        for row in rows:
+            source = self.session.get(WorkItemModel, row.source_work_item_id)
+            target = self.session.get(WorkItemModel, row.target_work_item_id)
+            if source and target:
+                graph.add_edge(source.identifier, target.identifier, relation=row.relation_type)
+        return graph