tissues 0.3.0 → 0.4.1

package/README.md

@@ -1,18 +1,25 @@
-# ghissue
+# tissues
 
 AI-enhanced GitHub issue creation with built-in safety guardrails.
 
 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.
 
-[![npm version](https://img.shields.io/npm/v/ghissue)](https://www.npmjs.com/package/ghissue)
+[![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)
+[![Website](https://img.shields.io/badge/website-tissues.cc-blue)](https://tissues.cc)
 
 ---
 
 ## Install
 
+**Homebrew (recommended):**
 ```bash
-npm install -g ghissue
+brew install calebogden/tap/tissues
+```
+
+**npm:**
+```bash
+npm install -g tissues
 ```
 
 Requires Node.js >= 18.
@@ -23,45 +30,45 @@ Requires Node.js >= 18.
 
 ```bash
 # Authenticate (auto-detects gh CLI token)
-ghissue auth
+tissues auth
 
 # Set your active repo
-ghissue open
+tissues open
 
 # Create an issue interactively
-ghissue create
+tissues create
 
 # Check safety status before running in CI
-ghissue status
+tissues status
 ```
 
 ---
 
 ## Commands
 
-### `ghissue auth`
+### `tissues auth`
 
 Authenticate with GitHub. Auto-detects your `gh` CLI token if you're already logged in via `gh`. Falls back to GitHub OAuth Device Flow if not.
 
 ```bash
-ghissue auth
+tissues auth
 ```
 
-### `ghissue open`
+### `tissues open`
 
 Set the active repository context. All subsequent commands use this repo unless overridden with `--repo`.
 
 ```bash
-ghissue open
+tissues open
 # prompts: pick a repo from your GitHub account
 ```
 
-### `ghissue create`
+### `tissues create`
 
 Create a new GitHub issue. Runs dedup checks and safety gates before creating anything.
 
 ```bash
-ghissue create [options]
+tissues create [options]
 ```
 
 **Options:**
@@ -82,10 +89,10 @@ ghissue create [options]
 
 ```bash
 # Interactive
-ghissue create
+tissues create
 
 # Fully scripted (no prompts)
-ghissue create \
+tissues create \
   --repo owner/my-repo \
   --template bug \
   --title "Login fails on Safari 17" \
@@ -93,7 +100,7 @@ ghissue create \
   --labels "bug,P1"
 
 # From an AI agent
-ghissue create \
+tissues create \
   --agent claude-opus-4-6 \
   --session abc123 \
   --template feature \
@@ -101,23 +108,23 @@ ghissue create \
   --dry-run
 ```
 
-### `ghissue list`
+### `tissues list`
 
 Browse open issues for the active repo.
 
 ```bash
-ghissue list
-ghissue list --repo owner/other-repo
+tissues list
+tissues list --repo owner/other-repo
 ```
 
-### `ghissue status`
+### `tissues status`
 
 Show circuit breaker state and rate limit usage for the active repo.
 
 ```bash
-ghissue status
-ghissue status --agent claude-opus-4-6
-ghissue status --reset   # force-reset circuit breaker to closed
+tissues status
+tissues status --agent claude-opus-4-6
+tissues status --reset   # force-reset circuit breaker to closed
 ```
 
 Output:
@@ -136,7 +143,7 @@ Fingerprints stored: 47
 
 ## Safety Features
 
-ghissue is designed to be called from AI agent loops. The safety infrastructure prevents one misconfigured agent from flooding a repo with issues.
+tissues is designed to be called from AI agent loops. The safety infrastructure prevents one misconfigured agent from flooding a repo with issues.
 
 ### Circuit Breaker
 
@@ -151,8 +158,8 @@ The circuit trips after 3 blocked attempts (dedup blocks count as failures). If
 To inspect or reset:
 
 ```bash
-ghissue status
-ghissue status --reset
+tissues status
+tissues status --reset
 ```
 
 ### Rate Limiting
@@ -165,7 +172,7 @@ Three independent rate limits, all checked before creating:
 | Per-agent burst | 5 issues / 5 minutes | per repo + agent |
 | Global hourly | 30 issues/hour | per repo, all agents combined |
 
-All limits are configurable in `.gitissues/config.json`.
+All limits are configurable in `.tissues/config.json`.
 
 ### Deduplication (3 layers)
 
@@ -179,7 +186,7 @@ A `block` always prevents creation. A `warn` prompts interactively (or is skippe
 
 ### Attribution Tracking
 
-Every issue created by ghissue includes a machine-readable `<!-- gitissues-meta -->` block. See [Attribution](#attribution) below.
+Every issue created by tissues includes a machine-readable `<!-- tissues-meta -->` block. See [Attribution](#attribution) below.
 
 ---
 
@@ -188,11 +195,11 @@ Every issue created by ghissue includes a machine-readable `<!-- gitissues-meta
 Configuration is loaded and merged from four sources in ascending priority order:
 
 1. Built-in defaults
-2. User-level config: `~/.config/gitissues/config.json`
-3. Repo-level config: `.gitissues/config.json`
-4. Environment variables: `GITISSUES_*`
+2. User-level config: `~/.config/tissues/config.json`
+3. Repo-level config: `.tissues/config.json`
+4. Environment variables: `TISSUES_*`
 
-### Example `.gitissues/config.json`
+### Example `.tissues/config.json`
 
 ```json
 {
@@ -214,7 +221,7 @@ Configuration is loaded and merged from four sources in ascending priority order
     "defaultAgent": "human"
   },
   "templates": {
-    "dir": ".gitissues/templates",
+    "dir": ".tissues/templates",
     "default": "bug"
   },
   "hooks": {
@@ -225,13 +232,13 @@ Configuration is loaded and merged from four sources in ascending priority order
 
 ### Environment Variables
 
-Environment variables follow the pattern `GITISSUES_<SECTION>_<KEY>`:
+Environment variables follow the pattern `TISSUES_<SECTION>_<KEY>`:
 
 ```bash
-GITISSUES_SAFETY_MAX_PER_HOUR=5
-GITISSUES_SAFETY_BURST_LIMIT=3
-GITISSUES_SAFETY_GLOBAL_MAX_PER_HOUR=20
-GITISSUES_ATTRIBUTION_DEFAULT_AGENT=my-agent
+TISSUES_SAFETY_MAX_PER_HOUR=5
+TISSUES_SAFETY_BURST_LIMIT=3
+TISSUES_SAFETY_GLOBAL_MAX_PER_HOUR=20
+TISSUES_ATTRIBUTION_DEFAULT_AGENT=my-agent
 ```
 
 ### Hooks
@@ -239,9 +246,9 @@ GITISSUES_ATTRIBUTION_DEFAULT_AGENT=my-agent
 `postCreate` runs a shell command after every successful issue creation. Three environment variables are injected:
 
 ```bash
-GITISSUES_REPO          # owner/repo
-GITISSUES_ISSUE_NUMBER  # 142
-GITISSUES_ISSUE_URL     # https://github.com/owner/repo/issues/142
+TISSUES_REPO          # owner/repo
+TISSUES_ISSUE_NUMBER  # 142
+TISSUES_ISSUE_URL     # https://github.com/owner/repo/issues/142
 ```
 
 ---
@@ -261,7 +268,7 @@ GITISSUES_ISSUE_URL     # https://github.com/owner/repo/issues/142
 
 ### Custom Templates
 
-Place `.md` files in `.gitissues/templates/` (repo-level) or `~/.config/gitissues/templates/` (user-level). Repo templates take priority over user templates, which take priority over built-ins.
+Place `.md` files in `.tissues/templates/` (repo-level) or `~/.config/tissues/templates/` (user-level). Repo templates take priority over user templates, which take priority over built-ins.
 
 Template files support `{{variable}}` substitution:
 
@@ -274,7 +281,7 @@ Template files support `{{variable}}` substitution:
 | `{{date}}` | ISO date (YYYY-MM-DD) |
 | `{{repo}}` | Repository (owner/name) |
 
-**Example** `.gitissues/templates/incident.md`:
+**Example** `.tissues/templates/incident.md`:
 
 ```markdown
 name: Incident Report
@@ -303,21 +310,21 @@ Use it with `--template incident`.
 
 ## Attribution
 
-Every issue created by ghissue includes a machine-readable HTML comment at the bottom of the body. GitHub renders it as invisible text; it does not appear in the rendered issue.
+Every issue created by tissues includes a machine-readable HTML comment at the bottom of the body. GitHub renders it as invisible text; it does not appear in the rendered issue.
 
 ```html
-<!-- gitissues-meta
+<!-- 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: ghissue-cli/0.3.0
+created_via: tissues-cli/0.3.0
 -->
 ```
 
-The block is used by ghissue to:
+The block is used by tissues to:
 
 - Power content fingerprint dedup (prevents re-creating identical issues)
 - Track which agent created which issue
@@ -329,10 +336,10 @@ You can pass additional fields via `--agent`, `--session`, and the programmatic
 
 ## State Database
 
-ghissue stores local state in a SQLite database at:
+tissues stores local state in a SQLite database at:
 
 ```
-.gitissues/data/gitissues.db
+.tissues/data/tissues.db
 ```
 
 **No separate SQLite install.** The CLI uses [better-sqlite3](https://github.com/WiseLibs/better-sqlite3), which compiles SQLite into the Node addon at `npm install` time. Users do not need to install SQLite on their system. SQLite is a common choice for CLI tool state when you need queryable, structured data (rate limits, dedup history, circuit breaker); simpler config lives in JSON (e.g. `conf` store).

package/package.json

@@ -1,18 +1,17 @@
 {
   "name": "tissues",
-  "version": "0.3.0",
+  "version": "0.4.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": {
-    "tissues": "./bin/gitissues.js"
+    "tissues": "./bin/tissues.js"
   },
   "scripts": {
-    "dev": "node bin/gitissues.js",
-    "watch": "node --watch bin/gitissues.js --help",
+    "dev": "node bin/tissues.js",
+    "watch": "node --watch bin/tissues.js --help",
     "test": "node --test src/**/*.test.js",
     "audit": "node scripts/audit.js",
     "build": "node scripts/build.js",
-    "prepublishOnly": "node scripts/audit.js",
     "dev:install": "node scripts/dev-install.js",
     "dev:uninstall": "node scripts/dev-install.js --uninstall"
   },
@@ -28,13 +27,13 @@
   ],
   "author": "Caleb Ogden",
   "license": "MIT",
-  "homepage": "https://ghissue.dev",
+  "homepage": "https://tissues.cc",
   "repository": {
     "type": "git",
-    "url": "https://github.com/calebogden/ghissue.git"
+    "url": "https://github.com/calebogden/tissues.git"
   },
   "bugs": {
-    "url": "https://github.com/calebogden/ghissue/issues"
+    "url": "https://github.com/calebogden/tissues/issues"
   },
   "files": [
     "bin",

package/src/cli.js

@@ -1,4 +1,6 @@
 import { Command } from 'commander'
+import { createRequire } from 'module'
+const { version } = createRequire(import.meta.url)('../package.json')
 import { authCommand } from './commands/auth.js'
 import { openCommand } from './commands/open.js'
 import { createCommand } from './commands/create.js'
@@ -26,7 +28,7 @@ function authDescription() {
 program
   .name('tissues')
   .description('AI-enhanced GitHub issue creation from the command line.')
-  .version('0.3.0')
+  .version(version)
   .hook('preAction', (_thisCommand, actionCommand) => {
     const name = actionCommand.name()
 
@@ -49,7 +51,8 @@ program.addHelpText(
   'after',
   `
 
-Repo: https://github.com/calebogden/ghissue
+Web:  https://tissues.cc
+Pkg:  https://www.npmjs.com/package/tissues
 `,
 )
 

package/src/commands/create.js

@@ -29,7 +29,7 @@ function warnIfCircuitNotClosed(circuitState) {
     chalk.yellow('[safety]') +
       ' Circuit breaker is ' +
       stateColor(circuitState.toUpperCase()) +
-      '. Use `ghissue status` to view details.',
+      '. Use `tissues status` to view details.',
   )
 }
 
@@ -62,9 +62,9 @@ function runPostCreateHook(hookCmd, ctx) {
     execSync(hookCmd, {
       env: {
         ...process.env,
-        GITISSUES_REPO: ctx.repo,
-        GITISSUES_ISSUE_NUMBER: String(ctx.issueNumber),
-        GITISSUES_ISSUE_URL: ctx.issueUrl,
+        TISSUES_REPO: ctx.repo,
+        TISSUES_ISSUE_NUMBER: String(ctx.issueNumber),
+        TISSUES_ISSUE_URL: ctx.issueUrl,
       },
       stdio: 'inherit',
     })

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: ghissue open'))
+      console.error(chalk.red('No active repo. Set one with: tissues open'))
       process.exit(1)
     }
 

package/src/lib/attribution.js

@@ -23,7 +23,7 @@ function resolvePackageVersion() {
       const pkgPath = path.join(dir, 'package.json')
       if (fs.existsSync(pkgPath)) {
         const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
-        if ((pkg.name === 'ghissue' || pkg.name === 'gitissues') && pkg.version) return pkg.version
+        if (pkg.name === 'tissues' && pkg.version) return pkg.version
       }
       dir = path.dirname(dir)
     }
@@ -120,7 +120,7 @@ export function buildAttribution(opts = {}) {
 
   // Timestamps / versioning
   meta.created_at = createdAt ?? nowISO()
-  meta.created_via = `ghissue-cli/${PKG_VERSION}`
+  meta.created_via = `tissues-cli/${PKG_VERSION}`
 
   return meta
 }
@@ -130,18 +130,18 @@ export function buildAttribution(opts = {}) {
  * bottom of a GitHub issue body.
  *
  * The format is a YAML-like key: value listing inside an HTML comment, which
- * GitHub renders as invisible text. Other tools (including gitissues itself)
+ * GitHub renders as invisible text. Other tools (including tissues itself)
  * can parse it back via `parseAttribution`.
  *
  * @example
- * <!-- gitissues-meta
+ * <!-- 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: gitissues-cli/0.1.0
+ * created_via: tissues-cli/0.1.0
  * -->
  *
  * @param {AttributionOpts} opts
@@ -149,7 +149,7 @@ export function buildAttribution(opts = {}) {
  */
 export function renderAttribution(opts = {}) {
   const meta = buildAttribution(opts)
-  const lines = ['<!-- gitissues-meta']
+  const lines = ['<!-- tissues-meta']
 
   for (const [key, value] of Object.entries(meta)) {
     if (Array.isArray(value)) {
@@ -165,7 +165,7 @@ export function renderAttribution(opts = {}) {
 }
 
 /**
- * Parse a `<!-- gitissues-meta ... -->` attribution block from an issue body.
+ * Parse a `<!-- tissues-meta ... -->` attribution block from an issue body.
  *
  * Returns the parsed key/value pairs as a plain object, or `null` if no
  * attribution block is present in `issueBody`.
@@ -180,7 +180,7 @@ export function parseAttribution(issueBody) {
   if (!issueBody) return null
 
   // Match the comment block (non-greedy, handle CRLF)
-  const match = issueBody.match(/<!--\s*gitissues-meta\s*([\s\S]*?)-->/m)
+  const match = issueBody.match(/<!--\s*tissues-meta\s*([\s\S]*?)-->/m)
   if (!match) return null
 
   const block = match[1]

package/src/lib/config.js

@@ -1,9 +1,9 @@
 import Conf from 'conf'
 
 // Conf handles OS-appropriate storage path + creates dir automatically
-// macOS: ~/Library/Preferences/gitissues-nodejs/config.json
-// Linux: ~/.config/gitissues-nodejs/config.json
-export const store = new Conf({ projectName: 'gitissues' })
+// macOS: ~/Library/Preferences/tissues-nodejs/config.json
+// Linux: ~/.config/tissues-nodejs/config.json
+export const store = new Conf({ projectName: 'tissues' })
 
 export function getConfig() {
   return store.store

package/src/lib/db.js

@@ -1,10 +1,10 @@
 /**
- * SQLite state database for ghissue CLI.
+ * SQLite state database for tissues CLI.
  *
  * Stores fingerprints (deduplication), idempotency keys, circuit breaker
  * state, and rate-limit event log. Uses better-sqlite3 (synchronous API).
  *
- * Database path: .gitissues/data/gitissues.db (relative to repo root).
+ * Database path: .tissues/data/tissues.db (relative to repo root).
  * Created automatically on first use. Users can .gitignore the data dir
  * for personal-only state, or commit it for shared team dedup history.
  */
@@ -14,7 +14,7 @@ import path from 'path'
 import fs from 'fs'
 
 // ---------------------------------------------------------------------------
-// Path resolution — repo-local .gitissues/data/gitissues.db
+// Path resolution — repo-local .tissues/data/tissues.db
 // ---------------------------------------------------------------------------
 
 /**
@@ -35,11 +35,11 @@ function findRepoRootForDb(startDir) {
 function getDbPath() {
   const repoRoot = findRepoRootForDb()
   if (repoRoot) {
-    return path.join(repoRoot, '.gitissues', 'data', 'gitissues.db')
+    return path.join(repoRoot, '.tissues', 'data', 'tissues.db')
   }
   // Fallback: user home config dir (outside a git repo)
   const home = process.env.HOME || process.env.USERPROFILE || ''
-  return path.join(home, '.config', 'gitissues', 'gitissues.db')
+  return path.join(home, '.config', 'tissues', 'tissues.db')
 }
 
 const DB_PATH = getDbPath()

package/src/lib/defaults.js

@@ -32,7 +32,7 @@ const BUILT_IN_DEFAULTS = {
 
   // Templates
   templates: {
-    dir: '.gitissues/templates', // relative to repo root, or absolute
+    dir: '.tissues/templates', // relative to repo root, or absolute
     default: 'default',          // default template name
   },
 
@@ -54,7 +54,7 @@ const BUILT_IN_DEFAULTS = {
 // Env var prefix
 // ---------------------------------------------------------------------------
 
-const ENV_PREFIX = 'GITISSUES_'
+const ENV_PREFIX = 'TISSUES_'
 
 // ---------------------------------------------------------------------------
 // Helpers
@@ -114,15 +114,15 @@ function readJsonFile(filePath) {
  * @returns {string}
  */
 function userConfigPath() {
-  return path.join(os.homedir(), '.config', 'gitissues', 'config.json')
+  return path.join(os.homedir(), '.config', 'tissues', 'config.json')
 }
 
 /**
- * Convert a flat `GITISSUES_SECTION_KEY=value` environment variable map into
+ * Convert a flat `TISSUES_SECTION_KEY=value` environment variable map into
  * a nested object matching the config shape.
  *
  * Variable names are lowercased and split on `_` to build the path:
- *   GITISSUES_SAFETY_MAX_PER_HOUR=20  →  { safety: { maxPerHour: 20 } }
+ *   TISSUES_SAFETY_MAX_PER_HOUR=20  →  { safety: { maxPerHour: 20 } }
  *
  * Simple camelCase reconstruction: after stripping the prefix and splitting on
  * `_`, the first segment is the section; the remaining segments are joined in
@@ -198,9 +198,9 @@ export function findRepoRoot(startDir) {
 /**
  * Load merged configuration from all sources in ascending priority order:
  *   1. Built-in defaults  (lowest)
- *   2. User-level config  (~/.config/gitissues/config.json)
- *   3. Repo-level config  (<repoRoot>/.gitissues/config.json)
- *   4. Environment vars   (GITISSUES_*)
+ *   2. User-level config  (~/.config/tissues/config.json)
+ *   3. Repo-level config  (<repoRoot>/.tissues/config.json)
+ *   4. Environment vars   (TISSUES_*)
  *   5. CLI flags          (passed as `cliOverrides`, highest)
  *
  * @param {string} [repoRoot] - path to the repo root; auto-detected if omitted
@@ -219,7 +219,7 @@ export function loadConfig(repoRoot, cliOverrides) {
 
   // 3. Repo-level config
   if (root) {
-    const repoCfg = readJsonFile(path.join(root, '.gitissues', 'config.json'))
+    const repoCfg = readJsonFile(path.join(root, '.tissues', 'config.json'))
     if (repoCfg) merged = deepMerge(merged, repoCfg)
   }
 

package/src/lib/safety.js

@@ -1,5 +1,5 @@
 /**
- * Circuit breaker and rate limiter for ghissue CLI.
+ * Circuit breaker and rate limiter for tissues CLI.
  *
  * Prevents runaway issue creation loops by:
  * - Rate limiting per agent (hourly + burst window)

package/src/lib/templates.js

@@ -86,10 +86,10 @@ function readTemplatesFromDir(dir, source) {
  */
 function resolveTemplateDir(source, repoRoot, cfg) {
   if (source === 'user') {
-    return path.join(os.homedir(), '.config', 'gitissues', 'templates')
+    return path.join(os.homedir(), '.config', 'tissues', 'templates')
   }
   // repo source
-  const templateDir = cfg.templates?.dir ?? '.gitissues/templates'
+  const templateDir = cfg.templates?.dir ?? '.tissues/templates'
   if (path.isAbsolute(templateDir)) return templateDir
   if (repoRoot) return path.join(repoRoot, templateDir)
   return path.resolve(templateDir)