tissues 0.5.0 → 0.5.1

package/README.md

@@ -32,11 +32,11 @@ Requires Node.js >= 18.
 # Authenticate (auto-detects gh CLI token)
 tissues auth
 
-# Set your active repo
-tissues open
+# Set your active repo (optional — saves typing --repo every time)
+tissues use calebogden/tissues
 
-# Create an issue interactively
-tissues create
+# Create an issue interactively (title as positional argument — no quotes needed)
+tissues create fix the login bug
 
 # Check safety status before running in CI
 tissues status
@@ -54,13 +54,14 @@ Authenticate with GitHub. Auto-detects your `gh` CLI token if you're already log
 tissues auth
 ```
 
-### `tissues open`
+### `tissues use`
 
-Set the active repository context. All subsequent commands use this repo unless overridden with `--repo`.
+Set the active repository context. Optional — all commands also accept `--repo` directly. Once set, subsequent commands use this repo automatically unless overridden.
 
 ```bash
-tissues open
-# prompts: pick a repo from your GitHub account
+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`
@@ -68,7 +69,7 @@ tissues open
 Create a new GitHub issue. Runs dedup checks and safety gates before creating anything.
 
 ```bash
-tissues create [options]
+tissues create [title...] [options]
 ```
 
 **Options:**
@@ -78,7 +79,10 @@ tissues create [options]
 | `--repo <owner/name>` | Override active repo |
 | `--template <name>` | Template to use: `bug`, `feature`, `security`, `performance`, `refactor` |
 | `--title <title>` | Issue title (skips interactive prompt) |
-| `--body <text>` | Issue body / description (skips interactive prompt) |
+| `--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 |
+| `--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 |
 | `--agent <name>` | Agent identifier for attribution (default: `human`) |
 | `--session <id>` | Session ID for attribution and idempotency |
@@ -88,8 +92,8 @@ tissues create [options]
 **Examples:**
 
 ```bash
-# Interactive
-tissues create
+# Interactive (title pre-filled from positional argument)
+tissues create fix the login bug
 
 # Fully scripted (no prompts)
 tissues create \
@@ -97,6 +101,7 @@ tissues create \
   --template bug \
   --title "Login fails on Safari 17" \
   --body "Reproducible on fresh profile. Console shows CORS error." \
+  --instructions "Keep it under 150 words and include a clear reproduction checklist." \
   --labels "bug,P1"
 
 # From an AI agent
@@ -279,7 +284,7 @@ Template files support `{{variable}}` substitution:
 | Variable | Value |
 |---|---|
 | `{{title}}` | Issue title |
-| `{{description}}` | User's description |
+| `{{description}}` | Issue description — the actual content describing the issue |
 | `{{agent}}` | Agent identifier |
 | `{{session}}` | Session ID |
 | `{{date}}` | ISO date (YYYY-MM-DD) |
@@ -320,11 +325,10 @@ Every issue created by tissues includes a machine-readable HTML comment at the b
 <!-- tissues-meta
 agent: claude-opus-4-6
 session: abc123
-pid: 84921
 trigger: cli-create
 fingerprint: sha256:3f2a1b...
 created_at: 2026-02-19T15:30:00.000Z
-created_via: tissues-cli/0.3.0
+created_via: tissues-cli/0.5
 -->
 ```
 
@@ -336,6 +340,8 @@ The block is used by tissues to:
 
 You can pass additional fields via `--agent`, `--session`, and the programmatic API.
 
+`pid` is available but opt-in — pass it explicitly via the programmatic API (`pid: process.pid`). It is omitted by default to avoid leaking process info into public issues.
+
 ---
 
 ## State Database

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tissues",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "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": {

package/src/cli.js

@@ -3,7 +3,7 @@ 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 { openCommand } from './commands/open.js'
+import { useCommand } from './commands/use.js'
 import { createCommand } from './commands/create.js'
 import { listCommand } from './commands/list.js'
 import { statusCommand } from './commands/status.js'
@@ -40,7 +40,7 @@ program
     requireGh()
 
     // Show active repo context on every command (except auth/open)
-    if (name !== 'auth' && name !== 'open' && name !== 'login' && name !== 'status' && name !== 'switch' && name !== 'logout') {
+    if (name !== 'auth' && name !== 'use' && name !== 'login' && name !== 'status' && name !== 'switch' && name !== 'logout') {
       const activeRepo = store.get('activeRepo')
       if (activeRepo) {
         console.log(chalk.dim(`Working in: ${activeRepo}\n`))
@@ -63,7 +63,7 @@ program.hook('preAction', () => {
 })
 program.addCommand(authCommand)
 program.addCommand(configCommand)
-program.addCommand(openCommand)
+program.addCommand(useCommand)
 program.addCommand(createCommand)
 program.addCommand(listCommand)
 program.addCommand(statusCommand)

package/src/commands/create.js

@@ -88,14 +88,19 @@ function runPostCreateHook(hookCmd, ctx) {
  * Enhance issue body with AI. Currently a structured placeholder.
  * Wire up real AI (OpenAI / Anthropic) here.
  *
- * @param {string} title
- * @param {string} description
+ * @param {string} title - issue title
+ * @param {string} description - the actual issue content describing what the issue is about;
+ *   this is rendered into the template body via {{description}} and forms the core of the issue
  * @param {string} templateBody - already-rendered template body to use as context
+ * @param {string} [instructions] - optional AI prompt instructions that guide *how* the AI
+ *   writes or post-processes the issue body (e.g. "keep it under 200 words",
+ *   "after creating, send to this webhook: https://..."). Does NOT appear in the issue itself.
  * @returns {Promise<string>}
  */
-async function enhanceWithAI(title, description, templateBody) {
+async function enhanceWithAI(title, description, templateBody, instructions) {
   // TODO: wire up real AI (OpenAI / Anthropic)
-  // templateBody is provided as context for the AI to refine
+  // - description goes INTO the issue body (rendered via {{description}} in the template)
+  // - instructions guide the AI behaviour but are NOT included in the output
   return templateBody
 }
 
@@ -164,7 +169,8 @@ async function runCreate(opts) {
   // -----------------------------------------------------------------------
   // 4. Get inputs
   // -----------------------------------------------------------------------
-  const title = opts.title ?? (await input({ message: 'Issue title' }))
+  const title =
+    opts.title ?? (await input({ message: 'Issue title', default: opts._titleDefault }))
   if (!title || !title.trim()) {
     console.error(chalk.red('Title is required.'))
     throw new Error('Title is required')
@@ -173,7 +179,13 @@ async function runCreate(opts) {
   const description =
     opts.body ??
     (await input({
-      message: 'Brief description (optional, used for AI enhancement)',
+      message: 'Issue description (optional)',
+    }))
+
+  const instructions =
+    opts.instructions ??
+    (await input({
+      message: 'Issue instruction (optional, guides AI enhancement)',
     }))
 
   // -----------------------------------------------------------------------
@@ -286,7 +298,7 @@ async function runCreate(opts) {
   if (opts.enhance !== false && !opts.dryRun) {
     const aiSpinner = ora('Enhancing with AI...').start()
     try {
-      body = await enhanceWithAI(title, description, renderedTemplate)
+      body = await enhanceWithAI(title, description, renderedTemplate, instructions)
       aiSpinner.succeed('Enhanced')
     } catch {
       aiSpinner.warn('AI enhancement unavailable — using template as-is')
@@ -427,12 +439,14 @@ async function runCreate(opts) {
 
 export const createCommand = new Command('create')
   .description('Create a new GitHub issue')
+  .argument('[title...]', 'Issue title (positional shorthand for --title)')
   .option('--repo <repo>', 'Repository override (owner/name)')
   .option('--template <name>', 'Template to use (bug, feature, security, performance, refactor)')
   .option('--agent <name>', 'Agent identifier for attribution (default: human)')
   .option('--session <id>', 'Session ID for attribution')
   .option('--title <title>', 'Issue title (skips interactive prompt)')
   .option('--body <body>', 'Issue body / description (skips interactive prompt)')
+  .option('--instructions <text>', 'AI enhancement instruction — a prompt that guides how the AI writes the issue body (skips interactive prompt)')
   .option('--labels <labels>', 'Comma-separated labels to apply')
   .option('--force', 'Skip dedup warnings (still blocks on exact matches)')
   .option('--dry-run', 'Check dedup and safety without creating the issue')
@@ -441,7 +455,10 @@ export const createCommand = new Command('create')
     '--batch <file>',
     'Create multiple issues from a JSON file (title, body, template, labels, agent, session per item)',
   )
-  .action(async (opts) => {
+  .action(async (titleArg, opts) => {
+    // Positional words → prefill the prompt (user can still edit)
+    // --title flag → skip the prompt entirely (scripted/batch use)
+    if (titleArg?.length && !opts.title) opts._titleDefault = titleArg.join(' ')
     // -----------------------------------------------------------------------
     // Batch mode
     // -----------------------------------------------------------------------

package/src/commands/status.js

@@ -83,7 +83,7 @@ export const statusCommand = new Command('status')
     }
 
     if (!repo) {
-      console.error(chalk.red('No active repo. Set one with: tissues open'))
+      console.error(chalk.red('No active repo. Set one with: tissues use <owner/repo>'))
       process.exit(1)
     }
 

package/src/commands/{open.js → use.js}

@@ -3,7 +3,7 @@ import { pickRepo } from '../lib/repo-picker.js'
 import { setConfig } from '../lib/config.js'
 import chalk from 'chalk'
 
-export const openCommand = new Command('open')
+export const useCommand = new Command('use')
   .description('Set the active repository context')
   .argument('[repo]', 'Repository in owner/name format (e.g. owner/repo)')
   .option('--repo <repo>', 'Repository in owner/name format (alias for positional argument)')

package/src/lib/attribution.js

@@ -56,7 +56,7 @@ function nowISO() {
  * @typedef {object} AttributionOpts
  * @property {string}  [agent]          - agent identifier (e.g. 'claude-opus-4-6')
  * @property {string}  [session]        - session or conversation ID
- * @property {number}  [pid]            - process ID of the creating process
+ * @property {number}  [pid]            - process ID (opt-in; omitted by default)
  * @property {string}  [model]          - AI model used (if any)
  * @property {string}  [trigger]        - how the issue was created (e.g. 'cli-create')
  * @property {string}  [fingerprint]    - content fingerprint (sha256:...)
@@ -72,7 +72,8 @@ function nowISO() {
  * Build a normalized attribution metadata object from raw options.
  *
  * The returned object includes all provided fields plus automatic defaults
- * (`created_at`, `created_via`, `pid`). Undefined/null fields are omitted.
+ * (`created_at`, `created_via`). Undefined/null fields are omitted.
+ * `pid` is opt-in — it is only included if explicitly passed.
  *
  * @param {AttributionOpts} opts
  * @returns {object} metadata record
@@ -100,7 +101,7 @@ export function buildAttribution(opts = {}) {
   if (session != null) meta.session = String(session)
   if (model != null) meta.model = String(model)
 
-  // Process info
+  // Process info (pid is opt-in — pass it explicitly to include)
   if (pid != null) meta.pid = Number(pid)
   meta.trigger = trigger != null ? String(trigger) : 'cli-create'
 
@@ -120,7 +121,7 @@ export function buildAttribution(opts = {}) {
 
   // Timestamps / versioning
   meta.created_at = createdAt ?? nowISO()
-  meta.created_via = `tissues-cli/${PKG_VERSION}`
+  meta.created_via = `tissues-cli/${PKG_VERSION.split('.').slice(0, 2).join('.')}`
 
   return meta
 }
@@ -137,11 +138,10 @@ export function buildAttribution(opts = {}) {
  * <!-- tissues-meta
  * agent: claude-opus-4-6
  * session: abc123
- * pid: 12345
  * trigger: cli-create
  * fingerprint: sha256:deadbeef
  * created_at: 2026-02-19T15:30:00Z
- * created_via: tissues-cli/0.1.0
+ * created_via: tissues-cli/0.1
  * -->
  *
  * @param {AttributionOpts} opts
@@ -170,7 +170,7 @@ export function renderAttribution(opts = {}) {
  * Returns the parsed key/value pairs as a plain object, or `null` if no
  * attribution block is present in `issueBody`.
  *
- * Numeric fields (`pid`, `risk`, `complexity`, `confidence`) are coerced to
+ * Numeric fields (`risk`, `complexity`, `confidence`) are coerced to
  * numbers. The `context_tags` field is split back into an array.
  *
  * @param {string} issueBody - raw GitHub issue body markdown

package/src/lib/db.js

@@ -277,6 +277,25 @@ export function getCircuitState(repo, agent = 'human') {
   }
 }
 
+/**
+ * Increment the failure count for a circuit without opening it.
+ * Used to persist intermediate failures before the trip threshold is reached.
+ *
+ * @param {string} repo
+ * @param {string} [agent='human']
+ */
+export function incrementFailureCount(repo, agent = 'human') {
+  const db = getDb()
+  const id = `${repo}:${agent}`
+  db.prepare(
+    `INSERT INTO circuit_breaker (id, repo, agent, status, failure_count, updated_at)
+     VALUES (?, ?, ?, 'closed', 1, datetime('now'))
+     ON CONFLICT(id) DO UPDATE SET
+       failure_count = failure_count + 1,
+       updated_at    = datetime('now')`,
+  ).run(id, repo, agent)
+}
+
 /**
  * Trip (open) the circuit breaker and set a cooldown window.
  *

package/src/lib/safety.js

@@ -16,6 +16,7 @@ import {
   probeCircuit,
   recordRateEvent,
   countRecentEvents,
+  incrementFailureCount,
   getDb,
 } from './db.js'
 
@@ -206,10 +207,8 @@ export function recordFailure(repo, agent, config = {}) {
       `Cooldown: ${cfg.cooldownMinutes} minutes.`
     )
   } else {
-    // Update failure count without tripping — db.tripCircuit handles the trip;
-    // for intermediate increments we record a 'failure' rate event so the count
-    // is persisted across calls.
-    recordRateEvent(repo, agent, 'failure')
+    // Persist intermediate failure count without opening the circuit yet
+    incrementFailureCount(repo, agent)
   }
 }