tissues 0.5.2 → 0.6.0

package/README.md

@@ -1,8 +1,8 @@
-# tissues 🔖
+# tissues 🧻
 
-AI-enhanced GitHub issue creation with built-in safety guardrails.
+AI Enhanced GitHub Issues: create consistent, high-quality GitHub Issues cut for agents to make reliable updates to your codebase through rich context add-ons for git history, related issues, project rules, coding standards, risk and complexity scores, auto-labeling, and templates.
 
-Create structured, deduplicated GitHub issues from the command line — with circuit breakers and rate limiting to prevent runaway issue creation when used inside AI agent workflows.
+Agent Safety Mechanics: automatic data recovery, configurable rate limits, loop detection with circuit breakers, auditable signatures.
 
 [![npm version](https://img.shields.io/npm/v/tissues)](https://www.npmjs.com/package/tissues)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -32,13 +32,13 @@ Requires Node.js >= 18.
 # Authenticate (auto-detects gh CLI token)
 tissues auth
 
-# Set your active repo (optional — saves typing --repo every time)
-tissues use calebogden/tissues
+# Set your active repo and configure AI (interactive wizard)
+tissues config
 
 # Create an issue interactively (title as positional argument — no quotes needed)
 tissues create fix the login bug
 
-# Check safety status before running in CI
+# Check auth, safety, and config status
 tissues status
 ```
 
@@ -54,16 +54,6 @@ Authenticate with GitHub. Auto-detects your `gh` CLI token if you're already log
 tissues auth
 ```
 
-### `tissues use`
-
-Set the active repository context. Optional — all commands also accept `--repo` directly. Once set, subsequent commands use this repo automatically unless overridden.
-
-```bash
-tissues use calebogden/tissues   # set by name
-tissues use                      # prompts: pick a repo from your GitHub account
-tissues use --repo calebogden/tissues  # same, via flag
-```
-
 ### `tissues create`
 
 Create a new GitHub issue. Runs dedup checks and safety gates before creating anything.
@@ -77,13 +67,15 @@ tissues create [title...] [options]
 | Flag | Description |
 |---|---|
 | `--repo <owner/name>` | Override active repo |
-| `--template <name>` | Template to use: `bug`, `feature`, `security`, `performance`, `refactor` |
-| `--title <title>` | Issue title (skips interactive prompt) |
+| `--template <name>` | Template to use: `default`, `bug`, `feature`, or custom |
+| `--title <title>` | Issue title (skips interactive prompt and triage step — title used as-is) |
 | `--body <text>` | Issue body / description — the actual content describing the issue (skips interactive prompt) |
 | `--instructions <text>` | AI enhancement instructions: guides how the AI writes the issue body (e.g. "keep it under 200 words", "use formal tone"). Does not appear in the created issue. Optional — skips interactive prompt when provided. |
 | `--no-enhance` | Skip AI enhancement, use rendered template as-is |
+| `--pipeline` | Force multi-step AI pipeline even if config disabled |
+| `--no-pipeline` | Force single-shot AI enhancement even if pipeline enabled |
 | `--batch <file>` | Create multiple issues from a JSON file. Each item supports: `title`, `body`, `template`, `labels`, `agent`, `session` |
-| `--labels <labels>` | Comma-separated labels to apply |
+| `--labels <labels>` | Comma-separated labels to apply. If a label doesn't exist on the repo, tissues will prompt to create it automatically. |
 | `--agent <name>` | Agent identifier for attribution (default: `human`) |
 | `--session <id>` | Session ID for attribution and idempotency |
 | `--force` | Skip dedup warnings (still blocks on exact matches) |
@@ -113,6 +105,23 @@ tissues create \
   --dry-run
 ```
 
+### `tissues drafts`
+
+Manage issue drafts. tissues saves your issue to `.tissues/drafts/` before any safety or dedup checks — the drafts command lets you view, flush, retry failed items, or clear the queue.
+
+```bash
+tissues drafts                    # interactive management menu
+tissues drafts flush              # flush pending issues (non-interactive)
+```
+
+### `tissues templates`
+
+Manage issue templates interactively. View, edit, or create templates. Editing a built-in template creates a user copy that overrides the default.
+
+```bash
+tissues templates
+```
+
 ### `tissues list`
 
 Browse open issues for the active repo.
@@ -124,7 +133,7 @@ tissues list --repo owner/other-repo
 
 ### `tissues status`
 
-Show circuit breaker state and rate limit usage for the active repo.
+Show auth, AI config, safety status, and draft count for the active repo.
 
 ```bash
 tissues status
@@ -132,17 +141,51 @@ tissues status --agent claude-opus-4-6
 tissues status --reset   # force-reset circuit breaker to closed
 ```
 
-Output:
+---
+
+## Data Recovery
+
+tissues never silently discards your input. Before any safety check or network call, your issue is written to `.tissues/drafts/`. If a rate limit, circuit breaker, or network failure blocks submission, your work is saved and `tissues drafts flush` sends it when you're ready.
 
+```bash
+# See what's waiting
+tissues status       # shows "Drafts: N pending"
+
+# Manage or flush
+tissues drafts       # interactive: view, flush, retry, clear
+tissues drafts flush # send all pending (non-interactive)
+```
+
+→ See [Non-Destructive Data Policy](docs/data-policy.md) and [Your Data in tissues](docs/user-data.md) for full details.
+
+---
+
+## AI Enhancement
+
+tissues enhances your issues using an 8-step AI pipeline. You type freeform text into "What's the issue" and the pipeline derives everything: the **triage** step extracts a concise title and structured description, followed by duplicate check, context extraction, scope analysis, complexity scoring, risk assessment, label suggestion, and body formatting. Each step feeds the next, producing structured issues with scores, auto-labels, and rich sections.
+
+```bash
+# Interactive setup
+tissues config
+
+# Or set a key directly
+tissues config set ai.keys.anthropic sk-ant-your-key
 ```
-Circuit Breaker: closed ✓
-Rate Limit: 3/10 per hour (7 remaining)
-Burst: 1/5 in last 5 min
-Global: 3/30 per hour (27 remaining)
 
-Last issue created: 12 minutes ago
-Fingerprints stored: 47
 ```
+  ✓ Input analyzed: Fix OAuth 401 error on Safari
+  ✓ Duplicate check (none)
+  ✓ Context gathered
+  ✓ Scope analyzed (3 files)
+  ✓ Complexity: 4/10
+  ✓ Risk: 2/10
+  ✓ Labels: bug, P2-medium
+  ✓ Body formatted
+```
+
+The pipeline is resilient — failed steps are skipped, and the format step always runs with whatever data is available. Use `--no-pipeline` for single-shot enhancement, or `--no-enhance` to skip AI entirely.
+
+→ See [AI Enhancement docs](docs/features/ai.md) for pipeline configuration, providers, routing rules, model selection, and token budgets.
 
 ---
 
@@ -234,20 +277,34 @@ Configuration is loaded and merged from three sources in ascending priority orde
 }
 ```
 
-### `tissues config`
+AI keys go in user-level config only (`~/.config/tissues/config.json`) — never commit them:
 
-Get or set persistent user-level config values using dot notation. Values are stored in `~/.config/tissues/config.json`.
+```json
+{
+  "ai": {
+    "provider": "anthropic",
+    "keys": {
+      "anthropic": "sk-ant-...",
+      "openai": "sk-..."
+    }
+  }
+}
+```
 
-```bash
-# Set a value
-tissues config set safety.maxPerHour 5
-tissues config set attribution.defaultAgent my-agent
+### `tissues config`
 
-# Read a value
-tissues config get safety.maxPerHour
+Interactive config wizard or direct KVP access. Values are stored in `~/.config/tissues/config.json`.
 
-# Show all resolved config
-tissues config list
+```bash
+# Interactive wizard (main menu: repo, AI provider, keys, budgets, templates, safety, routing, backup)
+tissues config
+
+# Direct KVP access
+tissues config ai.provider                    # get
+tissues config ai.provider anthropic          # set
+tissues config set safety.maxPerHour 5        # set (subcommand form)
+tissues config get safety.maxPerHour          # get (subcommand form)
+tissues config list                           # show all resolved config
 ```
 
 ### Hooks
@@ -271,9 +328,6 @@ TISSUES_ISSUE_URL     # https://github.com/owner/repo/issues/142
 | `default` | Generic summary + details + additional context |
 | `bug` | Steps to reproduce, expected vs actual behavior, environment |
 | `feature` | Motivation, proposed solution, alternatives |
-| `security` | Severity, affected components, suggested fix |
-| `performance` | Current metric, target metric, affected area |
-| `refactor` | Motivation, scope, risk assessment |
 
 ### Custom Templates
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tissues",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "AI-enhanced GitHub issue creation with built-in safety guardrails. Wraps gh CLI with circuit breakers, rate limiting, dedup, and templates.",
   "type": "module",
   "bin": {
@@ -9,7 +9,7 @@
   "scripts": {
     "dev": "node bin/tissues.js",
     "watch": "node --watch bin/tissues.js --help",
-    "test": "node --test src/**/*.test.js",
+    "test": "node --experimental-test-module-mocks --test 'src/**/*.test.js'",
     "audit": "node scripts/audit.js",
     "build": "node scripts/build.js",
     "dev:install": "node scripts/dev-install.js",
@@ -42,12 +42,11 @@
     "LICENSE"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20.12"
   },
   "dependencies": {
     "@inquirer/prompts": "^7.0.0",
     "better-sqlite3": "^11.0.0",
-    "chalk": "^5.3.0",
     "commander": "^12.0.0",
     "conf": "^13.0.0",
     "ora": "^8.0.0"

package/src/cli.js

@@ -3,33 +3,35 @@ import { createRequire } from 'module'
 const { version } = createRequire(import.meta.url)('../package.json')
 import { authCommand } from './commands/auth.js'
 import { configCommand } from './commands/config.js'
-import { useCommand } from './commands/use.js'
-import { createCommand } from './commands/create.js'
+import { createCommand, draftCommand } from './commands/create.js'
 import { listCommand } from './commands/list.js'
 import { statusCommand } from './commands/status.js'
+import { templatesCommand } from './commands/templates.js'
+import { draftsCommand } from './commands/drafts.js'
+import { aiCommand } from './commands/ai.js'
 import { store } from './lib/config.js'
-import { requireGh, getAuthStatus } from './lib/gh.js'
-import chalk from 'chalk'
+import { requireGh } from './lib/gh.js'
+import { dim } from './lib/color.js'
 
 export const program = new Command()
 
 function authDescription() {
-  const base = 'Authenticate with GitHub (via gh CLI)'
-  try {
-    const status = getAuthStatus()
-    const active = status.accounts?.find(a => a.active)
-    if (!active) return base
-    const check = chalk.green('✔')
-    return `${base} ${check} ${chalk.dim(active.login)}`
-  } catch {
-    return base
-  }
+  return 'Authenticate with GitHub (via gh CLI)'
 }
 
+const SKIP_REPO_BANNER = new Set([
+  'auth', 'login', 'status', 'switch', 'logout',
+  'config', 'drafts', 'publish', 'templates', 'ai',
+])
+
 program
   .name('tissues')
   .description('AI-enhanced GitHub issue creation from the command line.')
   .version(version)
+  .configureHelp({
+    subcommandTerm: (cmd) => cmd.name(),
+  })
+  .helpCommand('help', 'Show this help')
   .hook('preAction', (_thisCommand, actionCommand) => {
     const name = actionCommand.name()
 
@@ -39,11 +41,12 @@ program
     // Ensure gh is installed before any command
     requireGh()
 
-    // Show active repo context on every command (except auth/open)
-    if (name !== 'auth' && name !== 'use' && name !== 'login' && name !== 'status' && name !== 'switch' && name !== 'logout') {
+    // Show active repo context on relevant commands only
+    const parentName = actionCommand.parent?.name?.()
+    if (!SKIP_REPO_BANNER.has(name) && !SKIP_REPO_BANNER.has(parentName)) {
       const activeRepo = store.get('activeRepo')
       if (activeRepo) {
-        console.log(chalk.dim(`Working in: ${activeRepo}\n`))
+        console.log(dim(`Working in: ${activeRepo}\n`))
       }
     }
   })
@@ -57,13 +60,12 @@ Pkg:  https://www.npmjs.com/package/tissues
 `,
 )
 
-program.hook('preAction', () => {
-  // Lazily resolve auth description only when a command actually runs
-  authCommand.description(authDescription())
-})
 program.addCommand(authCommand)
 program.addCommand(configCommand)
-program.addCommand(useCommand)
 program.addCommand(createCommand)
+program.addCommand(draftCommand)
 program.addCommand(listCommand)
 program.addCommand(statusCommand)
+program.addCommand(templatesCommand)
+program.addCommand(draftsCommand)
+program.addCommand(aiCommand)

package/src/commands/ai.js

@@ -0,0 +1,266 @@
+import { Command } from 'commander'
+import { confirm } from '@inquirer/prompts'
+import { store } from '../lib/config.js'
+import { theme } from '../lib/theme.js'
+import { loadConfig, findRepoRoot } from '../lib/defaults.js'
+import { requireAuth, getAuthenticatedUser, listLabels, listRepos } from '../lib/gh.js'
+import { listTemplates } from '../lib/templates.js'
+import { checkDuplicate } from '../lib/dedup.js'
+import { resolveRoute } from '../lib/ai/router.js'
+import { checkAvailable } from '../lib/ai/index.js'
+import { runCreate } from './create.js'
+import { red, yellow, dim, bold, cyan } from '../lib/color.js'
+import ora from 'ora'
+
+// ---------------------------------------------------------------------------
+// System prompt — tells the AI how to build a `tissues create` invocation
+// ---------------------------------------------------------------------------
+
+function buildSystemPrompt(context) {
+  const lines = [
+    'You translate natural language into a `tissues create` command.',
+    'Return ONLY a JSON object with the fields to pass to the create command.',
+    '',
+    'Available fields:',
+    '  "title"    (required) — concise issue title',
+    '  "body"     (optional) — issue body in markdown',
+    '  "labels"   (optional) — comma-separated label names',
+    '  "template" (optional) — template key to use',
+    '  "repo"     (optional) — "owner/name", omit to use the active repo',
+    '',
+    'Rules:',
+    '- Return ONLY valid JSON. No markdown fences, no explanation.',
+    '- Write a clear, actionable title.',
+    '- If the user gives enough detail, write a well-structured markdown body.',
+    '- Only include fields the user mentions or that you can clearly infer.',
+    '- Pick labels from the available labels when appropriate.',
+    '- Pick a template that fits the issue type (bug, feature, default).',
+  ]
+
+  if (context.activeRepo) {
+    lines.push(`\nActive repo: ${context.activeRepo}`)
+  }
+  if (context.user) {
+    lines.push(`Authenticated user: ${context.user}`)
+  }
+  if (context.repos?.length) {
+    lines.push(`Available repos: ${context.repos.join(', ')}`)
+  }
+  if (context.templates?.length) {
+    const keys = [...new Set(context.templates.map((t) => t.key))]
+    lines.push(`Available templates: ${keys.join(', ')}`)
+  }
+  if (context.labels?.length) {
+    lines.push(`Labels on active repo: ${context.labels.join(', ')}`)
+  }
+
+  return lines.join('\n')
+}
+
+// ---------------------------------------------------------------------------
+// Gather context for the AI prompt
+// ---------------------------------------------------------------------------
+
+function gatherContext(opts) {
+  const activeRepo = opts.repo || store.get('activeRepo')
+  const repoRoot = findRepoRoot()
+  const config = loadConfig(repoRoot)
+
+  const context = { activeRepo, config, repoRoot }
+
+  try { context.user = getAuthenticatedUser() } catch { /* non-fatal */ }
+  try { context.templates = listTemplates(repoRoot) } catch { /* non-fatal */ }
+  try { context.repos = listRepos({ limit: 30 }) } catch { /* non-fatal */ }
+
+  if (activeRepo) {
+    try { context.labels = listLabels(activeRepo) } catch { /* non-fatal */ }
+  }
+
+  return context
+}
+
+// ---------------------------------------------------------------------------
+// Parse AI response into runCreate opts
+// ---------------------------------------------------------------------------
+
+function parseCreateOpts(raw) {
+  let cleaned = raw.trim()
+  if (cleaned.startsWith('```')) {
+    cleaned = cleaned.replace(/^```(?:json)?\s*\n?/, '').replace(/\n?```\s*$/, '')
+  }
+
+  const parsed = JSON.parse(cleaned)
+  if (!parsed.title) throw new Error('AI response missing "title"')
+  return parsed
+}
+
+// ---------------------------------------------------------------------------
+// Command
+// ---------------------------------------------------------------------------
+
+export const aiCommand = new Command('ai')
+  .description('Create an issue from a natural language prompt')
+  .argument('[prompt...]', 'Describe the issue you want to create')
+  .option('--dry-run', 'Preview the create command without executing')
+  .option('--yes, -y', 'Skip confirmation, run create immediately')
+  .option('--repo <repo>', 'Override active repo')
+  .option('--provider <name>', 'AI provider override')
+  .option('--model <name>', 'AI model override')
+  .action(async (promptWords, opts) => {
+    if (!promptWords || promptWords.length === 0) {
+      aiCommand.help()
+      return
+    }
+    const prompt = promptWords.join(' ')
+
+    requireAuth()
+
+    // Gather context (no spinner — fast local calls)
+    const context = gatherContext(opts)
+    const { config } = context
+    const repo = opts.repo || context.activeRepo
+
+    const aiContext = { provider: opts.provider, model: opts.model }
+
+    // Early dedup check — before any LLM call
+    if (repo) {
+      const dedupSpinner = ora('Checking for duplicates...').start()
+      try {
+        const dedupResult = await checkDuplicate(repo, { title: prompt, agent: 'ai' })
+        dedupSpinner.stop()
+
+        if (dedupResult.action === 'block') {
+          const blockReasons = dedupResult.results.filter((r) => r.action === 'block')
+          for (const r of blockReasons) {
+            console.error(r.reason)
+            if (r.existingIssue?.number) {
+              console.error(dim(`  #${r.existingIssue.number}${r.existingIssue.title ? ` — ${r.existingIssue.title}` : ''}`))
+              if (r.existingIssue.url) console.error(dim(`  ${r.existingIssue.url}`))
+            }
+          }
+          console.error(red('Duplicate detected — issue not created.'))
+          process.exit(1)
+        }
+
+        if (dedupResult.action === 'warn') {
+          console.warn(yellow('Similar issue(s) found:'))
+          for (const r of dedupResult.results.filter((r) => r.action === 'warn')) {
+            console.warn(r.reason)
+            if (r.existingIssue?.number) {
+              console.warn(dim(`  #${r.existingIssue.number}${r.existingIssue.title ? ` — ${r.existingIssue.title}` : ''}`))
+              if (r.existingIssue.url) console.warn(dim(`  ${r.existingIssue.url}`))
+            }
+          }
+          console.warn()
+          const proceed = await confirm({ message: 'Continue anyway?', default: false, theme })
+          if (!proceed) {
+            console.log(dim('Aborted.'))
+            process.exit(0)
+          }
+        }
+      } catch {
+        dedupSpinner.stop()
+        // Non-fatal — proceed without dedup
+      }
+    }
+
+    // If AI isn't configured at all, go straight to create with the prompt as title
+    if (!checkAvailable(config, aiContext)) {
+      console.warn(yellow('AI not configured — using prompt as issue title.'))
+      console.warn(dim('Run `tissues config` to set up an AI provider.\n'))
+      return fallbackToCreate(prompt, opts)
+    }
+
+    // Ask AI to build the create options
+    const systemPrompt = buildSystemPrompt(context)
+    const messages = [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: prompt },
+    ]
+
+    const { adapter, model } = resolveRoute(config, aiContext)
+    const spinner = ora('Building create command...').start()
+    let raw
+    try {
+      raw = await adapter.complete(messages, { model, maxTokens: 2048 })
+      spinner.stop()
+    } catch (err) {
+      spinner.fail('AI failed')
+      if (/\b401\b/.test(err.message)) {
+        console.warn(red('  API key is invalid or expired.'))
+        console.warn(dim('  Run ') + cyan('tissues config') + dim(' to update your API key.'))
+      }
+      return fallbackToCreate(prompt, opts)
+    }
+
+    let plan
+    try {
+      plan = parseCreateOpts(raw)
+    } catch {
+      return fallbackToCreate(prompt, opts)
+    }
+
+    // Show what create will receive
+    const planRepo = plan.repo || context.activeRepo
+    console.log()
+    console.log(bold('  tissues create'))
+    console.log(`    ${dim('--title')}    ${plan.title}`)
+    if (planRepo) console.log(`    ${dim('--repo')}     ${planRepo}`)
+    if (plan.template) console.log(`    ${dim('--template')} ${plan.template}`)
+    if (plan.labels) console.log(`    ${dim('--labels')}   ${plan.labels}`)
+    if (plan.body) {
+      console.log(`    ${dim('--body')}`)
+      const preview = plan.body.length > 400
+        ? plan.body.slice(0, 400) + dim('\n    ...(truncated)')
+        : plan.body
+      for (const line of preview.split('\n')) {
+        console.log(`    ${dim(line)}`)
+      }
+    }
+    console.log()
+
+    if (opts.dryRun) {
+      console.log(dim('  --dry-run: stopping here.\n'))
+      process.exit(0)
+    }
+
+    if (!opts.yes) {
+      const ok = await confirm({ message: 'Run this create?', default: true, theme })
+      if (!ok) {
+        console.log(dim('Aborted.'))
+        process.exit(0)
+      }
+    }
+
+    // Hand off to the same runCreate that `tissues create` uses
+    try {
+      const result = await runCreate({
+        repo: planRepo,
+        title: plan.title,
+        body: plan.body || undefined,
+        labels: plan.labels || undefined,
+        template: plan.template || undefined,
+      })
+      if (result === null) process.exit(0)
+    } catch (err) {
+      process.exit(err.isAbort ? 0 : 1)
+    }
+  })
+
+// ---------------------------------------------------------------------------
+// Fallback — AI unavailable, run create with the prompt as the title
+// ---------------------------------------------------------------------------
+
+async function fallbackToCreate(prompt, opts) {
+  try {
+    const result = await runCreate({
+      repo: opts.repo || undefined,
+      _titleDefault: prompt,
+      dryRun: opts.dryRun || false,
+      enhance: true, // let create's own AI enhancement try (it handles failure gracefully)
+    })
+    if (result === null) process.exit(0)
+  } catch (err) {
+    process.exit(err.isAbort ? 0 : 1)
+  }
+}

package/src/commands/auth.js

@@ -7,7 +7,7 @@ import {
   authSwitch,
   authLogout,
 } from '../lib/gh.js'
-import chalk from 'chalk'
+import { yellow, bold, dim, cyan, green } from '../lib/color.js'
 
 export const authCommand = new Command('auth')
   .description('Authenticate with GitHub (via gh CLI)')
@@ -35,10 +35,10 @@ authCommand.addCommand(
       const { ok, missing } = checkScopes()
       if (!ok) {
         console.log()
-        console.log(chalk.yellow('⚠ Missing required scope: ') + chalk.bold(missing.join(', ')))
-        console.log(chalk.dim('  Fix with: ') + chalk.cyan(`gh auth refresh -s ${missing.join(',')}`))
+        console.log(yellow('⚠ Missing required scope: ') + bold(missing.join(', ')))
+        console.log(dim('  Fix with: ') + cyan(`gh auth refresh -s ${missing.join(',')}`))
       } else {
-        console.log(chalk.green('\n✓ Token has required scopes for issue creation'))
+        console.log(green('\n✓ Token has required scopes for issue creation'))
       }
     }),
 )