tix-cli 0.1.0__py3-none-any.whl

tix/__init__.py

@@ -0,0 +1,3 @@
+"""tix — keyboard-driven terminal ticket explorer for a tree of markdown briefs."""
+
+__version__ = "0.1.0"

tix/__main__.py

@@ -0,0 +1,29 @@
+"""tix CLI entry point.
+
+  tix                browse $TICKETS_DIR (default ~/.claude/tickets)
+  tix <project>      cd into ./<project>, set TICKETS_DIR=<project>/.claude/tickets
+"""
+import os
+import sys
+from pathlib import Path
+
+
+def main(argv=None):
+    argv = list(sys.argv[1:] if argv is None else argv)
+
+    if argv and not argv[0].startswith("-"):
+        proj = argv.pop(0)
+        proj_dir = Path.cwd() / proj
+        if not proj_dir.is_dir():
+            print(f"tix: no project directory at {proj_dir}", file=sys.stderr)
+            return 1
+        os.chdir(proj_dir)
+        os.environ["TICKETS_DIR"] = str(proj_dir / ".claude" / "tickets")
+
+    from . import tui
+    sys.argv = ["tix", *argv]
+    return tui.main()
+
+
+if __name__ == "__main__":
+    sys.exit(main())

tix/templates/_CHILD-TEMPLATE.md

@@ -0,0 +1,20 @@
+---
+linear:                       # Linear ID once synced; empty = draft
+title: <≤80 chars, action-oriented>
+epic: <parent epic folder slug>
+order: <NN — matches the filename prefix and the epic-stories id>
+---
+
+## Context
+<2–4 sentences — this story's slice of the epic. Assume _epic.md is already read.>
+
+## Acceptance criteria
+- <bulleted, each independently verifiable. Always include "Typecheck passes".>
+
+## Surface area
+- **Mirror**: `<feature/file>` — one-line why it's the structural twin.
+- **Files to start in** (≤8): `path — reason`.
+- **Gotchas**: quoted project CLAUDE.md rules that apply.
+
+## Out of scope
+- <explicit — what belongs to a sibling story, not this one>

tix/templates/_EPIC-TEMPLATE.md

@@ -0,0 +1,42 @@
+---
+linear:                       # Linear epic ID once synced; empty = draft
+title: <epic name, ≤80 chars>
+status: open
+area: integrations            # integrations | platform | ops | tooling | spikes
+created: <ISO-8601>
+---
+
+## Context
+<why this epic exists — the problem, the trigger, the source.>
+
+## Goal
+<one sentence — the end state when the epic is done.>
+
+## Acceptance criteria
+<epic-level "done when" — the integration test for the whole thing, not per-story.>
+
+## Constraints
+<non-negotiables; load-bearing facts every story inherits. None → "none.">
+
+<!--
+  epic-stories: the authoritative ordered story list + dependency DAG.
+  A human confirms this block before any lane spawns. epic-parse.sh projects it
+  into scripts/ralph/prd.json at lane-spawn. Ralph executes it — it never decomposes.
+    id      — matches the child filename, NN-<slug> (NN = execution order)
+    needs   — story ids this one depends on; [] = ready immediately
+    context — the NN-<child>.md file carrying this story's deep detail
+-->
+<!-- epic-stories:start -->
+stories:
+  - id: 01-<child-slug>
+    title: <story title>
+    needs: []
+    context: 01-<child-slug>.md
+  - id: 02-<child-slug>
+    title: <story title>
+    needs: [01-<child-slug>]
+    context: 02-<child-slug>.md
+<!-- epic-stories:end -->
+
+## Local notes
+<!-- lane / agent scratch — preserved across any later /sync-from-linear -->

tix/templates/_TEMPLATE.md

@@ -0,0 +1,33 @@
+---
+linear:                       # Linear ID once synced; empty = draft
+title: <≤80 chars, action-oriented, no fluff>
+status: draft                 # draft | open | active | done — cache, reconciled not hand-edited
+epic:                         # parent epic folder slug, or empty
+area: integrations            # integrations | platform | ops | tooling | spikes
+labels: []
+created: <ISO-8601>
+---
+
+## Context
+<2–4 sentences — why this exists. Quote the slack / email / customer / trace source.>
+
+## Acceptance criteria
+- <bulleted, each independently verifiable>
+
+## Surface area
+- **Mirror**: `<feature/file>` — one-line why it's the structural twin.
+- **Files to start in** (≤8): `path — reason`.
+- **Gotchas**: quoted project CLAUDE.md rules that apply.
+
+## Out of scope
+- <explicit — better to over-list>
+
+## Open questions
+- **Ambiguous**: <question + who to ask: teammate / customer / #eng-chat>
+- **Risky**: <blast radius + rollback path>
+
+## Prerequisites
+<env vars to set, accounts to provision, infra to stand up. None → "none.">
+
+## Local notes
+<!-- lane / agent scratch — preserved across any later /sync-from-linear -->