@stylusnexus/work-plan 2026.6.9 → 2026.6.10

package/skills/work-plan/work_plan.py

@@ -31,6 +31,8 @@ SUBCOMMANDS = {
     "orient": "commands.where_was_i",
     "--orient": "commands.where_was_i",   # flag-style alias
     "slot": "commands.slot",
+    "batch-slot": "commands.batch_slot",
+    "move": "commands.move",
     "close": "commands.close",
     "refresh-md": "commands.refresh_md",
     "list": "commands.list_cmd",
@@ -38,9 +40,11 @@ SUBCOMMANDS = {
     "init-repo": "commands.init_repo",
     "suggest-priorities": "commands.suggest_priorities",
     "group": "commands.group",
+    "auto-triage": "commands.auto_triage",
     "reconcile": "commands.reconcile",
     "--reconcile": "commands.reconcile",  # flag-style alias
     "duplicates": "commands.duplicates",
+    "coverage": "commands.coverage",
     "canonicalize": "commands.canonicalize",
     "hygiene": "commands.hygiene",
     "--hygiene": "commands.hygiene",      # flag-style alias
@@ -62,25 +66,33 @@ DESCRIPTIONS = [
      "Wrap up a session: capture touched/next/blockers, update body status table. Use --set-next to set the next_up list explicitly. Use --auto-next to suggest a priority-sorted list from open issues (interactive: apply / edit / skip).",
      "Ending a work block — before stepping away, going to bed, or switching tracks. Use --auto-next when you don't want to hand-pick issue numbers.",
      "/work-plan handoff tabletop --auto-next"),
-    ("where-was-i", "[track] [--pick]",
-     "Re-orient. With a track name: track paste-block. With no args: cwd snapshot (branch, recent commits, modified files). Add --pick to force the interactive track picker.",
+    ("where-was-i", "[track | track@repo] [--pick] [--repo=<key>]",
+     "Re-orient. With a track name: track paste-block. With no args: cwd snapshot (branch, recent commits, modified files). Add --pick to force the interactive track picker. Use --repo=<key> or track@repo to disambiguate when the same track slug exists in multiple repos.",
      "Switching to a fresh Claude Code session — either on a known track or in a directory that doesn't yet belong to one.",
      "/work-plan where-was-i ux-redesign  (or just `/work-plan orient` for cwd snapshot)"),
-    ("slot", "<issue-num> [track]",
-     "Add a GitHub issue to a track's frontmatter. If the issue is already in another active track in the same repo, prompts to move it (remove from source) rather than duplicate.",
+    ("slot", "<issue-num> [track | track@repo] [--repo=<key>]",
+     "Add a GitHub issue to a track's frontmatter. If the issue is already in another active track in the same repo, prompts to move it (remove from source) rather than duplicate. Use --repo=<key> or track@repo to disambiguate when the same track slug exists in multiple repos.",
      "When a new GitHub issue is filed and you want it associated with a track — or when an existing issue was relabeled and needs to move tracks.",
      "/work-plan slot 4234 tabletop"),
-    ("close", "<track>",
-     "Retire a track: shipped / parked / abandoned. Moves to archive/.",
+    ("batch-slot", "<issue-num>... <track | track@repo> [--repo=<key>] [--move|--no-move]",
+     "Slot multiple GitHub issues into a track at once. The last positional argument is the track; everything before it is an issue number. Skips issues already in the track. Use --move to remove issues from any prior owning tracks.",
+     "After bulk-triage with auto-triage or group — when several issues need the same track assignment.",
+     "/work-plan batch-slot 100 101 102 tabletop --move"),
+    ("move", "<issue-num> <from-track> <to-track> [--repo=<key>]",
+     "Move an issue from one track to another (remove from source frontmatter, add to destination). Source-first — the verb is the intent. Both tracks must be active and in the same repo.",
+     "When an issue belongs in a different track than where it currently sits — cleaner than slot --move.",
+     "/work-plan move 4234 platform-health org-sharing"),
+    ("close", "<track | track@repo> [--repo=<key>]",
+     "Retire a track: shipped / parked / abandoned. Moves to archive/. Use --repo=<key> or track@repo to disambiguate when the same track slug exists in multiple repos.",
      "When a track is done, paused, or won't ship — frees mental space.",
      "/work-plan close tabletop"),
     ("refresh-md", "<track> | --all | --repo=<key> [--yes]",
      "Update issue STATE (open/closed, status labels) inside the track body's status table. Does not change track membership.",
      "Usually NOT needed directly: `handoff` already refreshes the body table for its own track, and `brief` reads GitHub live. Reach for this when a sibling track has drifted because you haven't `handoff`'d it lately. `--all` sweeps every active track; `--repo=<key>` scopes the sweep to one repo (also runs as part of weekly `hygiene`).",
      "/work-plan refresh-md --repo=critforge"),
-    ("list", "[--all]",
+    ("list", "[--all] [--sort=recent|priority]",
      "List active tracks (or all including parked/archived).",
-     "Quick scan of what tracks exist; --all to see archived.",
+     "Quick scan of what tracks exist; --all to see archived. --sort orders by last_touched recency or launch_priority.",
      "/work-plan list --all"),
     ("init", "<path-to-md>",
      "Add frontmatter to an existing track .md file.",
@@ -94,31 +106,39 @@ DESCRIPTIONS = [
      "AI-assisted batch backfill of priority/PN labels.",
      "ONE-TIME setup, or whenever a wave of new unlabeled issues piles up.",
      "/work-plan suggest-priorities --repo=myproject"),
-    ("group", "[--milestone=X] [--label=Y] [--repo=Z] [--apply]",
-     "AI-cluster GitHub issues into thematic track files.",
+    ("group", "[--milestone=X] [--label=Y] [--repo=Z] [--apply] [--limit=N]",
+     "AI-cluster GitHub issues into thematic track files. --limit controls how many issues are shown in the prompt (default 100).",
      "ONE-TIME bulk organization of an unsorted milestone, or after a re-org.",
      "/work-plan group --milestone='v1.0.0 — Public Launch'"),
-    ("reconcile", "<track> | --all | --repo=<key> [--draft]",
-     "Update track MEMBERSHIP (the `github.issues` list in frontmatter) by syncing it against a GitHub label. Default label is `track/<slug>`; override per-track via `github.labels: [...]` in frontmatter. Read-only on GitHub. Add --draft to preview proposed ADDs/FLAGs without prompting or writing. NOT for hand-curated tracks — see `refresh-md` if you only want to update issue state.",
+    ("auto-triage", "[--repo=<key>] [--apply] [--limit=N]",
+     "AI-assign untracked open issues to existing tracks. Step 1 (no --apply): fetches untracked issues + existing tracks, prints AI prompt. Step 2 (--apply): reads AI's JSON answers and slots each assignment into track frontmatter. Complements `group` (which creates new tracks); `auto-triage` assigns to tracks that already exist. --limit controls how many untracked issues are shown (default 100).",
+     "Periodically — when new issues have piled up outside the track model. Run /work-plan coverage first to confirm there's a gap worth triaging.",
+     "/work-plan auto-triage --repo=critforge"),
+    ("reconcile", "<track> | --all | --repo=<key> [--draft] [--yes]",
+     "Update track MEMBERSHIP (the `github.issues` list in frontmatter) by syncing it against a GitHub label. Default label is `track/<slug>`; override per-track via `github.labels: [...]` in frontmatter. Read-only on GitHub. In an --all/--repo sweep it also detects MOVEs — an issue relabeled from one track to another in the same repo is moved (removed from the old track, added to the new). Add --draft to preview proposed ADDs/MOVEs/FLAGs without prompting or writing; add --yes to apply without prompting (non-interactive, e.g. from the VS Code extension; PUBLIC-repo move destinations are skipped under --yes). NOT for hand-curated tracks — see `refresh-md` if you only want to update issue state.",
      "WEEKLY hygiene on label-driven tracks — pulls labeled issues into their tracks, flags un-labeled ones. Use --repo=<key> to scope the sweep to one repo. Skip on hand-curated tracks (it'll propose dropping curated issues every run).",
      "/work-plan reconcile --repo=critforge --draft"),
-    ("duplicates", "[--min-similarity=0.7] [--limit=20] [--state=open]",
+    ("duplicates", "[--min-similarity=0.7] [--limit=20] [--state=open] [--timeout=N]",
      "Find likely-duplicate issues by title similarity.",
      "WEEKLY hygiene, or before a milestone planning session — find consolidation candidates.",
      "/work-plan duplicates --min-similarity=0.85"),
-    ("canonicalize", "<track> | --all [--force]",
-     "Insert a canonical master issue table at the top of a track. Refresh-md then targets ONLY this table, leaving narrative tables alone.",
+    ("coverage", "[--repo=<key>] [--list] [--limit=N]",
+     "Report how many open issues are not referenced by any track (per repo). --list prints issue titles (default: show 20; override with --limit=N). Read-only; derives live from gh.",
+     "On-demand: measure how much of a repo's backlog has fallen outside the planning layer. Pairs with /work-plan group to bulk-cluster the orphans.",
+     "/work-plan coverage --repo=critforge --list"),
+    ("canonicalize", "<track | track@repo> | --all [--force] [--repo=<key>]",
+     "Insert a canonical master issue table at the top of a track. Refresh-md then targets ONLY this table, leaving narrative tables alone. Use --repo=<key> or track@repo to disambiguate; with --all, --repo=<key> scopes to one repo.",
      "ONE-TIME for hand-written tracks with multiple narrative tables, OR after restructuring a track.",
      "/work-plan canonicalize ux-redesign"),
-    ("hygiene", "[--yes] [--no-duplicates] [--repo=<key>]",
-     "Weekly cleanup wrapper: refresh-md + reconcile + duplicates. With --repo=<key>, steps 1 and 2 scope to that repo; the duplicates step (a global similarity scan) is skipped.",
+    ("hygiene", "[--yes] [--no-duplicates] [--repo=<key>] [--timeout=N]",
+     "Weekly cleanup wrapper: refresh-md + reconcile + duplicates. With --repo=<key>, steps 1 and 2 scope to that repo; the duplicates step (a global similarity scan) is skipped. --timeout=N sets the gh subprocess timeout for the duplicates step (default 30s).",
      "WEEKLY — runs all three hygiene commands in sequence so you don't have to remember each. Use --repo=<key> to clean up one project without touching the others.",
      "/work-plan hygiene --repo=critforge"),
     ("export", "--json",
      "Emit the viewer-ready JSON read surface (schema 1): every frontmatter'd track with repo, tier, status, visibility, blockers, next_up, an open/closed rollup, and per-issue state/assignee/milestone. Read-only; derives live from gh. Consumed by the VS Code extension.",
      "When a tool (the VS Code viewer, or any script) needs structured track state instead of the human-facing brief/orient text.",
      "/work-plan export --json"),
-    ("set", "<track> field=value [field=value …] [--confirm=<token>]",
+    ("set", "<track | track@repo> field=value [field=value …] [--repo=<key>] [--confirm=<token>]",
      "Guarded edit of a track's frontmatter fields (status, launch_priority, milestone_alignment, blockers, next_up). Validates field names + status values; blockers/next_up take comma-separated issue numbers. Writes into a PUBLIC repo only with a confirm token: without one it prints {needs_confirm, reason, token} and makes no change (the VS Code viewer surfaces that as a modal, then re-invokes with --confirm=<token>).",
      "Programmatic/GUI edits that have no dedicated verb — e.g. the VS Code extension changing a status or blockers list. On the terminal you'll usually use the named verbs instead.",
      "/work-plan set ux-redesign status=parked"),