ticketwright 4.0.2__tar.gz → 4.0.3__tar.gz

{ticketwright-4.0.2 → ticketwright-4.0.3}/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented here. Format loosely follows
 [Keep a Changelog](https://keepachangelog.com/); this project uses semantic-ish versioning.
 
 
+## [4.0.3] — 2026-09-03
+
+### Added
+- **A prompt you can paste, for each track.** The person who most needs Ticketwright installed has
+  no plugin yet, so no `/setup` and no skill to ask — and every onboarding session so far opened
+  with someone improvising the words. Track 1 and Track 2 now each lead with a short prompt in a
+  copyable block: hand it to an agent and it does the track. They stay short on purpose. The doctor
+  already prints each fix at the moment it applies, so a prompt that restated them would be a
+  second copy to drift; what they carry instead is the part no tool enforces — "this repo only, not
+  globally", and, for Track 1, that the `setup` interview belongs to the person rather than to an
+  agent guessing the stack from whatever is installed. The joiner prompt also ships in
+  `templates/AGENTS.md.tmpl`, so it lands in every configured repo, and selftest pins the two copies
+  byte-identical.
+
 ## [4.0.2] — 2026-09-03
 
 ### Added

{ticketwright-4.0.2 → ticketwright-4.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ticketwright
-Version: 4.0.2
+Version: 4.0.3
 Summary: Tool-agnostic AI layer for ticket-driven work repos: prior-art recall, object reverse-index, deep QC, and a self-maintaining ticket index. Stdlib-only, no vector store.
 Project-URL: Homepage, https://github.com/kyle-chalmers/ticketwright
 Project-URL: Repository, https://github.com/kyle-chalmers/ticketwright
@@ -153,6 +153,21 @@ carries its own one-line check, so a stall is diagnosable instead of mysterious.
 
 ### Track 1 — Setting up a repo
 
+**Hand it to your agent.** Paste this into a Claude Code session opened on the repo, and the
+five steps below happen with you answering rather than driving:
+
+```text
+Set up Ticketwright in this repo for my whole team. Install it at project scope
+from the repo root, get me to restart so the skills load, then run
+/ticketwright:setup and put its questions to me rather than answering them
+yourself - it's asking about my team's tools and my identity. Show me the file
+list before committing anything.
+```
+
+The prompt keeps the interview yours on purpose: `setup` asks about your team's tools and who
+you are, and an agent that infers those from whatever is installed on the machine writes a
+confidently wrong `stack.yaml`. To drive it by hand instead, follow the steps:
+
 **1 · Install the plugin at project scope**, from inside the repo you want to work tickets in:
 
 ```bash
@@ -254,6 +269,21 @@ start, but does NOT install the plugin.** Verified live: a teammate's `installed
 stayed `{}` across restarts until the manual install in step 2. Skip step 2 and
 `/ticketwright:setup` is not a command that exists.
 
+**Hand it to your agent.** Paste this into a Claude Code session opened on the repo — it works
+the checklist below for you, in order:
+
+```text
+Install the Ticketwright plugin for this repo. Start with:
+python3 ~/.claude/plugins/marketplaces/ticketwright/bin/plugin_doctor.py
+Follow its fixes in order. I want it installed for this repo only, not globally.
+If a check fails in a way its fix doesn't cover, stop and tell me instead of
+working around it. When it's clean, tell me how to restart.
+```
+
+The prompt stays short because the doctor carries the detail: every check prints its own fix,
+so there is one copy of each instruction rather than two that drift. The rest of this track is
+what that prompt makes happen — read on to drive it yourself, or when an agent gets stuck.
+
 #### If you are the agent helping someone install — read this first
 
 One command answers most of what follows. The marketplace clone lands on disk as soon as the person

{ticketwright-4.0.2 → ticketwright-4.0.3}/README.md

@@ -129,6 +129,21 @@ carries its own one-line check, so a stall is diagnosable instead of mysterious.
 
 ### Track 1 — Setting up a repo
 
+**Hand it to your agent.** Paste this into a Claude Code session opened on the repo, and the
+five steps below happen with you answering rather than driving:
+
+```text
+Set up Ticketwright in this repo for my whole team. Install it at project scope
+from the repo root, get me to restart so the skills load, then run
+/ticketwright:setup and put its questions to me rather than answering them
+yourself - it's asking about my team's tools and my identity. Show me the file
+list before committing anything.
+```
+
+The prompt keeps the interview yours on purpose: `setup` asks about your team's tools and who
+you are, and an agent that infers those from whatever is installed on the machine writes a
+confidently wrong `stack.yaml`. To drive it by hand instead, follow the steps:
+
 **1 · Install the plugin at project scope**, from inside the repo you want to work tickets in:
 
 ```bash
@@ -230,6 +245,21 @@ start, but does NOT install the plugin.** Verified live: a teammate's `installed
 stayed `{}` across restarts until the manual install in step 2. Skip step 2 and
 `/ticketwright:setup` is not a command that exists.
 
+**Hand it to your agent.** Paste this into a Claude Code session opened on the repo — it works
+the checklist below for you, in order:
+
+```text
+Install the Ticketwright plugin for this repo. Start with:
+python3 ~/.claude/plugins/marketplaces/ticketwright/bin/plugin_doctor.py
+Follow its fixes in order. I want it installed for this repo only, not globally.
+If a check fails in a way its fix doesn't cover, stop and tell me instead of
+working around it. When it's clean, tell me how to restart.
+```
+
+The prompt stays short because the doctor carries the detail: every check prints its own fix,
+so there is one copy of each instruction rather than two that drift. The rest of this track is
+what that prompt makes happen — read on to drive it yourself, or when an agent gets stuck.
+
 #### If you are the agent helping someone install — read this first
 
 One command answers most of what follows. The marketplace clone lands on disk as soon as the person

{ticketwright-4.0.2 → ticketwright-4.0.3}/bin/selftest.sh

@@ -1259,6 +1259,49 @@ s21step "$T2" '**1 · ' '**2 · ' | grep -q 'git clone' \
   && ok "README Track 2 step 1 says git clone (not 'download')" \
   || bad "Track 2 step 1 must tell the joiner to git clone — a Download-ZIP folder has no .git"
 
+# (g) the paste-able install prompts. A person who has just cloned has no plugin, so no skill and no
+# /setup — the only thing that always works is text they can paste into a chat box. Both prompts
+# stay SHORT on purpose: the doctor prints each fix at the moment it applies, so a prompt that
+# restated them would be a second copy to drift. What the prompt must carry is the part no tool
+# enforces — "this repo only" (an agent that runs the bare install goes global) and, for Track 1,
+# that the interview belongs to the person (an agent inferring the stack writes it wrong).
+python3 - README.md templates/AGENTS.md.tmpl >"$TMP/s21b-prompts.out" 2>&1 <<'PYPROMPT'
+import sys
+def blocks(path):
+    out, cur, infence = [], [], False
+    for l in open(path, encoding="utf-8").read().splitlines():
+        if l.startswith("```text"):
+            infence, cur = True, []
+            continue
+        if infence and l.startswith("```"):
+            out.append("\n".join(cur)); infence = False
+            continue
+        if infence: cur.append(l)
+    return out
+readme, tmpl = blocks(sys.argv[1]), blocks(sys.argv[2])
+bad = []
+t1 = [b for b in readme if b.startswith("Set up Ticketwright in this repo")]
+t2 = [b for b in readme if b.startswith("Install the Ticketwright plugin for this repo")]
+if len(t1) != 1: bad.append("README has %d Track 1 prompt blocks, want 1" % len(t1))
+if len(t2) != 1: bad.append("README has %d Track 2 prompt blocks, want 1" % len(t2))
+if t1 and "put its questions to me" not in t1[0]:
+    bad.append("the Track 1 prompt no longer keeps the interview with the person")
+if t2:
+    if "this repo only, not globally" not in t2[0]:
+        bad.append("the Track 2 prompt no longer says this repo only")
+    if "plugin_doctor.py" not in t2[0]:
+        bad.append("the Track 2 prompt no longer starts at the doctor")
+    if not [b for b in tmpl if b.strip() == t2[0].strip()]:
+        bad.append("templates/AGENTS.md.tmpl's joiner prompt is not byte-identical to README's")
+for name, b in (("Track 1", t1), ("Track 2", t2)):
+    if b and len(b[0].splitlines()) > 8:
+        bad.append("%s prompt is %d lines — keep it short enough to paste" % (name, len(b[0].splitlines())))
+print(" | ".join(bad))
+PYPROMPT
+[ -z "$(cat "$TMP/s21b-prompts.out")" ] \
+  && ok "both paste-able install prompts are present, short, and identical across README and the AGENTS template" \
+  || bad "an install prompt drifted, grew, or lost the rule no tool enforces" "$(cat "$TMP/s21b-prompts.out")"
+
 hdr "22 · Obsidian graph config (.obsidian/graph.json)"
 GC="$TMP/graphcfg"; mkdir -p "$GC/.claude/config" "$GC/tickets/a/ENG-1" "$GC/tickets/a/ENG-2"
 printf 'project:\n  key_prefix: ENG\n' > "$GC/.claude/config/stack.yaml"

{ticketwright-4.0.2 → ticketwright-4.0.3}/templates/AGENTS.md.tmpl

@@ -49,6 +49,16 @@ The plugin ref is `ticketwright@ticketwright` and the marketplace URL is
 section. Registering the marketplace is not installing the plugin — a teammate who opens and trusts
 the repo gets the marketplace clone, then runs the install themselves (Track 2).
 
+The person you are helping can hand you this and you have everything you need:
+
+```text
+Install the Ticketwright plugin for this repo. Start with:
+python3 ~/.claude/plugins/marketplaces/ticketwright/bin/plugin_doctor.py
+Follow its fixes in order. I want it installed for this repo only, not globally.
+If a check fails in a way its fix doesn't cover, stop and tell me instead of
+working around it. When it's clean, tell me how to restart.
+```
+
 One command reports every check below with its fix, and runs before anything is installed, from the
 marketplace clone that lands on disk when the repo is trusted:
 

{ticketwright-4.0.2 → ticketwright-4.0.3}/ticketwright/__init__.py

@@ -6,4 +6,4 @@ This package is the PyPI distribution: a stdlib-only CLI that scaffolds the kit
 bundled under `ticketwright/_kit/`. The Claude Code plugin and `cp -r` install paths are unchanged.
 """
 
-__version__ = "4.0.2"
+__version__ = "4.0.3"