tsk-cli 0.1.0__py3-none-any.whl

tsk_cli/resolve.py

@@ -0,0 +1,40 @@
+"""
+Shared utilities for resolving thing refs to local .task/ files.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+from .push import ParsedThingFile, parse_thing_markdown
+
+
+def task_root(target_dir: Path | None = None) -> Path:
+    return (target_dir or Path.cwd()) / ".task"
+
+
+def find_thing_file(ref: str, target_dir: Path | None = None) -> Optional[Path]:
+    """Find the .md file for a thing ref like COM-001."""
+    root = task_root(target_dir)
+    projects_dir = root / "projects"
+    if not projects_dir.is_dir():
+        return None
+
+    ref_upper = ref.upper()
+    for md in sorted(projects_dir.glob("**/things/*.md")):
+        if md.stem.upper() == ref_upper:
+            return md
+    return None
+
+
+def parse_thing_at(path: Path) -> ParsedThingFile:
+    return parse_thing_markdown(path.read_text())
+
+
+def snapshot_path_for(thing_path: Path, target_dir: Path | None = None) -> Path:
+    """Return the .snapshot/ counterpart of a thing file."""
+    root = task_root(target_dir)
+    projects_dir = root / "projects"
+    rel = thing_path.relative_to(projects_dir)
+    return root / ".snapshot" / "projects" / rel

tsk_cli/set_status.py

@@ -0,0 +1,60 @@
+"""
+tsk set-status -- update a thing's status and push immediately.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import click
+
+from .api import api_get, api_patch
+from .push import build_thing_markdown
+from .resolve import find_thing_file, parse_thing_at, snapshot_path_for
+
+VALID_STATUSES = ("not_started", "in_progress", "in_review", "done")
+
+
+def set_status(ref: str, status: str, target_dir: Path | None = None) -> None:
+    if status not in VALID_STATUSES:
+        click.echo(
+            f"Invalid status: {status}. Must be one of: {', '.join(VALID_STATUSES)}",
+            err=True,
+        )
+        raise SystemExit(1)
+
+    thing_path = find_thing_file(ref, target_dir)
+    if not thing_path:
+        click.echo(f"Thing not found: {ref}. Run tsk pull first.", err=True)
+        raise SystemExit(1)
+
+    parsed = parse_thing_at(thing_path)
+    thing_id = parsed.frontmatter.get("id", "")
+    if not thing_id:
+        click.echo(f"Thing file missing id: {thing_path}", err=True)
+        raise SystemExit(1)
+
+    old_status = parsed.frontmatter.get("status", "")
+    if old_status == status:
+        click.echo(f"{ref} is already {status}")
+        return
+
+    try:
+        updated = api_patch(f"/api/things/{thing_id}/", {"status": status})
+    except Exception as e:
+        click.echo(f"Failed to update {ref}: {e}", err=True)
+        raise SystemExit(1)
+
+    parsed.frontmatter["status"] = status
+    if isinstance(updated, dict) and updated.get("updated_at"):
+        parsed.frontmatter["updated_at"] = str(updated["updated_at"])
+
+    new_raw = build_thing_markdown(parsed.frontmatter, parsed.name, parsed.body)
+    thing_path.write_text(new_raw)
+
+    snap = snapshot_path_for(thing_path, target_dir)
+    if snap.parent.is_dir():
+        snap.write_text(new_raw)
+
+    click.echo(f"{ref}: {old_status} → {status}")

tsk_cli/show.py

@@ -0,0 +1,59 @@
+"""
+tsk show -- display a thing's details in the terminal.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+
+from .config import get_server_url
+from .resolve import find_thing_file, parse_thing_at
+
+_STATUS_COLORS = {
+    "not_started": "white",
+    "in_progress": "cyan",
+    "in_review": "yellow",
+    "done": "green",
+}
+
+
+def show(ref: str, target_dir: Path | None = None) -> None:
+    thing_path = find_thing_file(ref, target_dir)
+    if not thing_path:
+        click.echo(f"Thing not found: {ref}. Run tsk pull first.", err=True)
+        raise SystemExit(1)
+
+    parsed = parse_thing_at(thing_path)
+    fm = parsed.frontmatter
+
+    display_ref = fm.get("ref", ref)
+    status = fm.get("status", "not_started")
+    assigned = fm.get("assigned_to", "")
+    thing_id = fm.get("id", "")
+    created = fm.get("created_at", "")
+    updated = fm.get("updated_at", "")
+
+    color = _STATUS_COLORS.get(status, "white")
+
+    click.echo()
+    click.echo(click.style(f"  {display_ref}", bold=True) + f"  {parsed.name}")
+    click.echo(f"  Status:      {click.style(status, fg=color)}")
+    if assigned:
+        click.echo(f"  Assigned to: {assigned}")
+    if created:
+        click.echo(f"  Created:     {created}")
+    if updated:
+        click.echo(f"  Updated:     {updated}")
+
+    if thing_id:
+        server = get_server_url()
+        click.echo(f"  Web:         {server}/projects?thing={thing_id}")
+
+    if parsed.body.strip():
+        click.echo()
+        for line in parsed.body.strip().split("\n"):
+            click.echo(f"  {line}")
+
+    click.echo()

tsk_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: tsk-cli
+Version: 0.1.0
+Summary: CLI for TSK — pull projects and things for editor agents
+Author: Rob Crosby
+License: MIT
+Project-URL: Homepage, https://tsk.tools
+Project-URL: Repository, https://github.com/rncrosby/text_plan
+Project-URL: Issues, https://github.com/rncrosby/text_plan/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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 :: Software Development :: Bug Tracking
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: requests>=2.31
+
+# tsk-cli
+
+Command-line interface for [TSK](https://tsk.tools) — pull projects and things into your editor so AI agents can work with them.
+
+## Install
+
+```bash
+pipx install tsk-cli
+# or
+pip install tsk-cli
+```
+
+Requires Python 3.11+.
+
+## Quick start
+
+```bash
+tsk login              # authenticate via browser
+tsk orgs               # list your organizations
+tsk org <name>         # set the default org
+tsk pull               # sync projects and things to .task/
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `tsk login [--server URL]` | Authenticate via browser OAuth |
+| `tsk logout` | Clear stored credentials |
+| `tsk orgs` | List your organizations |
+| `tsk org <name-or-id>` | Set the default organization |
+| `tsk pull` | Sync projects/things to `.task/` |
+| `tsk push [--force]` | Upload local edits to the server |
+| `tsk status` | Show current config and auth state |
+| `tsk list [--status S] [--project P]` | List things with optional filters |
+| `tsk show <ref>` | Display a thing's details |
+| `tsk set-status <ref> <status>` | Update status and push immediately |
+| `tsk start <ref>` | Set status to `in_progress` |
+| `tsk done <ref>` | Set status to `done` |
+| `tsk review <ref>` | Set status to `in_review` |
+| `tsk open <ref>` | Open thing in browser |
+
+## How it works
+
+`tsk pull` writes a `.task/` directory containing your projects and things as markdown files. Editor agents (Cursor, Copilot, etc.) can read these files to understand what to work on. After making changes locally, `tsk push` syncs them back to the server.
+
+## License
+
+MIT

tsk_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,16 @@
+tsk_cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tsk_cli/api.py,sha256=u4fmifdwWS40thNcUUfZ_QXlHpRz0Klmt-Oy-pjafwo,2243
+tsk_cli/auth.py,sha256=xpm4kOQZnO5trRXnSoY7fUcSrpnRVHeup-SSzr6Q20M,4162
+tsk_cli/config.py,sha256=CiDT01vclJGgFasCtuJaBWPWqDT_SoY2Hl4I6KFPN1s,1858
+tsk_cli/list_cmd.py,sha256=fIYfIjDn47Bs0SndkOWo8ZUb3jWcfA9OJyhdv0x1Wa4,2407
+tsk_cli/main.py,sha256=3DiAiHzr-oLQYyOJyjnRm7CPuoGE77YHXBhPiTdSeas,6789
+tsk_cli/pull.py,sha256=HTN7fbQzf56ECNxK-oKoUIPqVIJQjjixpEfku9lLA4s,15046
+tsk_cli/push.py,sha256=QvvYmUK-B30ev35uNaGv_BPwu8P8tfWGKZy6Y4aN7tE,7651
+tsk_cli/resolve.py,sha256=A7dwyL8MqEg36l6MZr3g-mVj0JY5vdk9MNVQ5E3a3Ek,1170
+tsk_cli/set_status.py,sha256=y05GnjqTsIAHoQ4moqdtCYpxRuGotjhQOKb8JmY0zhY,1877
+tsk_cli/show.py,sha256=3pU8dCXq6Ouhv7PI1GA5VcPTNmxmLFLThoFU9xiaf3s,1585
+tsk_cli-0.1.0.dist-info/METADATA,sha256=sL8b6Z9ix3InJf9ZqDI9XJ_XRq3oqfK8qh4LEsYvS-s,2465
+tsk_cli-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+tsk_cli-0.1.0.dist-info/entry_points.txt,sha256=OVoWHmhlhQz8FMLUY-aQsvLvKbHfRZby0nUxChtSdsE,41
+tsk_cli-0.1.0.dist-info/top_level.txt,sha256=3fQVFC52p0S8aHWeh7itafx5rqvuv_3S0Vm0dpiBG5Q,8
+tsk_cli-0.1.0.dist-info/RECORD,,

tsk_cli-0.1.0.dist-info/WHEEL

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

tsk_cli-0.1.0.dist-info/entry_points.txt

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

tsk_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tsk_cli