gsd:thread

Parse $ARGUMENTS to determine mode:

• "list" or "" (empty) → LIST mode (show all, default)
• "list --open" → LIST-OPEN mode (filter to open/in_progress only)
• "list --resolved" → LIST-RESOLVED mode (resolved only)
• "close <slug>" → CLOSE mode; extract SLUG = remainder after "close " (sanitize)
• "status <slug>" → STATUS mode; extract SLUG = remainder after "status " (sanitize)
• matches existing filename (.planning/threads/{arg}.md exists) → RESUME mode (existing behavior)
• anything else (new description) → CREATE mode (existing behavior)

Slug sanitization (for close and status): Strip any characters not matching [a-z0-9-]. Reject slugs longer than 60 chars or containing .. or /. If invalid, output "Invalid thread slug." and stop.

<mode_list> LIST / LIST-OPEN / LIST-RESOLVED mode:

ls .planning/threads/*.md 2>/dev/null

For each thread file found:

• Read frontmatter status field via:

  gsd-sdk query frontmatter.get .planning/threads/{file} status
  

• If frontmatter status field is missing, fall back to reading markdown heading ## Status: OPEN (or IN PROGRESS / RESOLVED) from the file body
• Read frontmatter updated field for the last-updated date
• Read frontmatter title field (or fall back to first # Thread: heading) for the title

SECURITY: File names read from filesystem. Before constructing any file path, sanitize the filename: strip non-printable characters, ANSI escape sequences, and path separators. Never pass raw filenames to shell commands via string interpolation.

Apply filter for LIST-OPEN (show only status=open or status=in_progress) or LIST-RESOLVED (show only status=resolved).

Display:

Context Threads
─────────────────────────────────────────────────────────
slug                      status        updated      title
auth-decision             open          2026-04-09   OAuth vs Session tokens
db-schema-v2              in_progress   2026-04-07   Connection pool sizing
frontend-build-tools      resolved      2026-04-01   Vite vs webpack
─────────────────────────────────────────────────────────
3 threads (2 open/in_progress, 1 resolved)

If no threads exist (or none match the filter):

No threads found. Create one with: /gsd-thread <description>

STOP after displaying. Do NOT proceed to further steps. </mode_list>

<mode_close> CLOSE mode:

When SUBCMD=close and SLUG is set (already sanitized):

1. Verify .planning/threads/{SLUG}.md exists. If not, print No thread found with slug: {SLUG} and stop.

2. Update the thread file's frontmatter status field to resolved and updated to today's ISO date:

   gsd-sdk query frontmatter.set .planning/threads/{SLUG}.md status resolved
   gsd-sdk query frontmatter.set .planning/threads/{SLUG}.md updated YYYY-MM-DD
   

3. Commit:

   gsd-sdk query commit "docs: resolve thread — {SLUG}" --files ".planning/threads/{SLUG}.md"
   

4. Print:

   Thread resolved: {SLUG}
   File: .planning/threads/{SLUG}.md
   

STOP after committing. Do NOT proceed to further steps. </mode_close>

<mode_status> STATUS mode:

When SUBCMD=status and SLUG is set (already sanitized):

1. Verify .planning/threads/{SLUG}.md exists. If not, print No thread found with slug: {SLUG} and stop.

2. Read the file and display a summary:

   Thread: {SLUG}
   ─────────────────────────────────────
   Title:   {title from frontmatter or # heading}
   Status:  {status from frontmatter or ## Status heading}
   Updated: {updated from frontmatter}
   Created: {created from frontmatter}
   
   Goal:
   {content of ## Goal section}
   
   Next Steps:
   {content of ## Next Steps section}
   ─────────────────────────────────────
   Resume with: /gsd-thread {SLUG}
   Close with:  /gsd-thread close {SLUG}