chief-clancy 0.8.22 → 0.9.0

package/bin/clancy.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+/**
+ * Clancy installer — CLI entry point for `npx chief-clancy`.
+ *
+ * Thin wiring layer that delegates to the @chief-clancy/terminal
+ * installer orchestrator. All logic lives in the terminal package;
+ * this script only resolves paths, builds the dependency bag, and
+ * hands off to `runInstall`.
+ */
+import {
+  copyFileSync,
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+} from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { fileURLToPath } from 'node:url';
+
+import {
+  createPrompts,
+  dim,
+  parseInstallFlag,
+  printBanner,
+  red,
+  resolveInstallPaths,
+  runInstall,
+} from '@chief-clancy/terminal';
+
+// ---------------------------------------------------------------------------
+// Resolve package metadata and terminal source directories
+// ---------------------------------------------------------------------------
+
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+
+const terminalEntry = fileURLToPath(
+  import.meta.resolve('@chief-clancy/terminal'),
+);
+const terminalRoot = join(dirname(terminalEntry), '..');
+
+const sources = {
+  rolesDir: join(terminalRoot, 'src', 'roles'),
+  hooksDir: join(terminalRoot, 'dist', 'hooks'),
+  bundleDir: join(terminalRoot, 'dist', 'bundle'),
+  agentsDir: join(terminalRoot, 'src', 'agents'),
+};
+
+// ---------------------------------------------------------------------------
+// Environment
+// ---------------------------------------------------------------------------
+
+const homeDir = process.env.HOME ?? process.env.USERPROFILE;
+
+if (!homeDir) {
+  console.error(red('  Error: Could not determine home directory.'));
+  process.exit(1);
+}
+
+const cwd = process.cwd();
+
+// ---------------------------------------------------------------------------
+// CLI flag parsing
+// ---------------------------------------------------------------------------
+
+const flag = parseInstallFlag(process.argv.slice(2));
+const nonInteractive = flag !== null;
+
+// ---------------------------------------------------------------------------
+// Prompts
+// ---------------------------------------------------------------------------
+
+const rl = createInterface({ input: process.stdin, output: process.stdout });
+const prompts = createPrompts(rl);
+
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+
+/**
+ * Prompt the user for global/local install mode when no CLI flag is provided.
+ *
+ * @param {ReturnType<typeof createPrompts>} p
+ * @returns {Promise<'global' | 'local'>}
+ */
+async function chooseMode(p) {
+  const choice = await p.choose('Where would you like to install?', [
+    `Global  ${dim('(~/.claude)')}   — available in all projects`,
+    `Local   ${dim('(./.claude)')}  — this project only`,
+  ]);
+
+  if (choice === '1' || choice.toLowerCase() === 'global') return 'global';
+  if (choice === '2' || choice.toLowerCase() === 'local') return 'local';
+
+  console.log(
+    red('\n  Invalid choice. Run npx chief-clancy again and enter 1 or 2.'),
+  );
+  p.close();
+  process.exit(1);
+}
+
+async function main() {
+  printBanner(pkg.version);
+
+  const mode = flag ?? (await chooseMode(prompts));
+
+  if (flag) {
+    console.log(dim(`  Mode: ${flag} (--${flag} flag)`));
+  }
+
+  const paths = resolveInstallPaths(mode, homeDir, cwd);
+
+  await runInstall({
+    mode,
+    paths,
+    sources,
+    version: pkg.version,
+    nonInteractive,
+    prompts,
+    cwd,
+    fs: {
+      exists: existsSync,
+      readFile: (p) => readFileSync(p, 'utf8'),
+      writeFile: (p, c) => writeFileSync(p, c, 'utf8'),
+      mkdir: (p) => mkdirSync(p, { recursive: true }),
+      copyFile: (s, d) => copyFileSync(s, d),
+      // TOCTOU: narrow window between lstat and the caller's write. Acceptable
+      // for a local CLI installer — no privileged paths are involved.
+      rejectSymlink: (p) => {
+        try {
+          if (lstatSync(p).isSymbolicLink()) {
+            throw new Error(`Symlink rejected: ${p}`);
+          }
+        } catch (err) {
+          if (/** @type {NodeJS.ErrnoException} */ (err).code !== 'ENOENT')
+            throw err;
+        }
+      },
+    },
+  });
+
+  prompts.close();
+}
+
+main().catch((err) => {
+  console.error(red(`\n  Error: ${err.message}`));
+  prompts.close();
+  process.exit(1);
+});

package/package.json

@@ -1,97 +1,17 @@
 {
   "name": "chief-clancy",
-  "version": "0.8.22",
-  "description": "Autonomous, board-driven development for Claude Code — scaffolds docs, integrates Kanban boards, runs tickets in a loop.",
-  "keywords": [
-    "claude",
-    "claude-code",
-    "ai",
-    "kanban",
-    "jira",
-    "github-issues",
-    "linear",
-    "autonomous",
-    "slash-commands"
-  ],
-  "homepage": "https://github.com/Pushedskydiver/clancy#readme",
-  "bugs": {
-    "url": "https://github.com/Pushedskydiver/clancy/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Pushedskydiver/clancy.git"
-  },
-  "license": "MIT",
+  "version": "0.9.0",
+  "description": "Autonomous, board-driven development for Claude Code",
   "author": "Alex Clapperton",
+  "license": "MIT",
   "type": "module",
   "bin": {
-    "clancy": "dist/installer/install.js"
+    "chief-clancy": "./bin/clancy.js"
   },
-  "main": "dist/installer/install.js",
   "files": [
-    "dist/bundle/",
-    "dist/installer/",
-    "dist/scripts/shared/env-parser/",
-    "dist/utils/ansi/",
-    "hooks/*.js",
-    "hooks/package.json",
-    "src/roles/",
-    "src/agents/",
-    "src/templates/",
-    "registry/"
+    "bin"
   ],
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build": "npm run clean && tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && npm run bundle",
-    "bundle": "node esbuild.config.js",
-    "dev": "vitest",
-    "test": "vitest run",
-    "test:integration": "vitest run --config test/integration/vitest.config.integration.ts",
-    "test:all": "npm test && npm run test:integration",
-    "test:e2e": "vitest run --config test/e2e/vitest.config.e2e.ts",
-    "test:e2e:gc": "npx tsx test/e2e/helpers/gc.ts",
-    "test:fixtures:validate": "npx tsx test/integration/validate-fixtures.ts",
-    "test:fixtures:live": "npx tsx test/e2e/validate-live-schemas.ts",
-    "test:coverage": "vitest run --coverage",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build",
-    "prepare": "husky"
-  },
-  "lint-staged": {
-    "*.ts": [
-      "eslint --fix",
-      "prettier --write"
-    ]
-  },
-  "engines": {
-    "node": ">=22.0.0"
-  },
-  "overrides": {
-    "tinyexec": "1.0.2"
-  },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
-    "@types/node": "^25.4.0",
-    "@vitest/coverage-v8": "^4.0.18",
-    "esbuild": "^0.27.3",
-    "eslint": "^10.0.3",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-prettier": "^5.5.5",
-    "husky": "^9.1.7",
-    "jiti": "^2.6.1",
-    "lint-staged": "^16.3.3",
-    "msw": "^2.12.14",
-    "prettier": "^3.8.1",
-    "tsc-alias": "^1.8.16",
-    "tsx": "^4.21.0",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.0",
-    "vitest": "^4.0.18",
-    "zod": "^4.3.6"
+  "dependencies": {
+    "@chief-clancy/terminal": "0.1.0"
   }
-}
+}

package/README.md

@@ -1,292 +0,0 @@
-# Clancy
-
-**Autonomous, board-driven development for Claude Code.**
-
-[![npm](https://img.shields.io/npm/v/chief-clancy?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/chief-clancy) [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](./LICENSE) [![Tests](https://img.shields.io/badge/tests-1479%20passing-brightgreen?style=for-the-badge)](docs/TESTING.md) [![GitHub Stars](https://img.shields.io/github/stars/Pushedskydiver/clancy?style=for-the-badge)](https://github.com/Pushedskydiver/clancy/stargazers)
-
-> [!WARNING]
-> Clancy is in early development. Expect bugs, breaking changes, and rough edges. If you hit an issue, please [open a bug report](https://github.com/Pushedskydiver/clancy/issues/new).
-
-```bash
-npx chief-clancy
-```
-
-Works on Mac, Linux, and Windows.
-
-[What it does](#what-it-does) · [Install](#install) · [Commands](#commands) · [Supported boards](#supported-boards) · [Comparison](./docs/COMPARISON.md) · [Roadmap](./ROADMAP.md) · [Contributing](./CONTRIBUTING.md)
-
----
-
-![Clancy terminal preview](assets/terminal-preview.svg)
-
-Named after Chief Clancy Wiggum (The Simpsons) — built on the [Ralph technique](https://ghuntley.com/ralph/) by Geoffrey Huntley. [See lineage →](#lineage)
-
----
-
-## What it does
-
-Clancy does six things:
-
-1. **Scaffolds itself** into a project — scripts, docs, CLAUDE.md, .clancy/.env
-2. **Scans your codebase** with 5 parallel specialist agents and writes 10 structured docs that Claude reads before every run
-3. **Writes strategy briefs** — interviews you (or runs a devil's advocate AI-grill in AFK mode), decomposes work into vertical slices with HITL/AFK classification, and creates board tickets with blocking dependencies
-4. **Plans tickets** — fetches backlog tickets, explores the codebase, and generates structured implementation plans posted as comments for human review
-5. **Runs autonomously** — picking one ticket per loop from your Kanban board (skipping blocked candidates), implementing it, committing, and creating a PR (targeting an epic branch for parented tickets, or the base branch for standalone tickets)
-6. **Verifies before delivery** — runs lint, test, and typecheck via verification gates with self-healing retry, guards against force push and destructive resets, and recovers from crashes via lock file detection
-
-Brief → approve → plan → implement. Pipeline labels (`clancy:brief` → `clancy:plan` → `clancy:build`) move tickets between stages automatically. One ticket per run. Fresh context window every iteration. No context rot.
-
----
-
-## Who this is for
-
-Clancy is for developers who:
-
-- Use a Kanban board (Jira, GitHub Issues, Linear, Shortcut, Notion, or Azure DevOps) and want Claude to work through their backlog unattended
-- Are comfortable with Claude Code and want to extend it for team workflows — not just solo hacking
-- Have a codebase with enough structure that an AI agent can make meaningful progress on a ticket without constant hand-holding
-- Want to go AFK and come back to committed, merged work
-
-**Clancy is not for you if:**
-
-- You want to supervise every change — use Claude Code directly instead
-- Your tickets are large, vague, or span multiple sessions — Clancy works best with small, well-scoped tickets
-- You don't use a Kanban board — you can still use `/clancy:map-codebase` for codebase scanning, but the run loop won't apply
-
-Evaluating other tools? See [COMPARISON.md](./docs/COMPARISON.md) for a side-by-side with GSD and PAUL.
-
----
-
-## Expectations
-
-Clancy is powerful but not magic. Here's what to expect:
-
-**It will get things wrong sometimes.** Claude can misread a ticket, make the wrong architectural choice, or produce code that doesn't compile. This is normal. Use `/clancy:once` to watch the first few runs, then review the output before going fully AFK. Over time you'll learn which ticket types Clancy handles well on your codebase.
-
-**Ticket quality matters more than you think.** A vague ticket produces vague implementation. Clancy works best when tickets have a clear summary, a description that explains the _why_, and concrete acceptance criteria. Use `/clancy:review` to score a ticket before running — it'll tell you exactly what's missing.
-
-**You still own the code.** Clancy pushes a feature branch and creates a pull request for every ticket — targeting an epic branch for parented tickets, or the base branch for standalone ones. When all children of an epic are done, Clancy creates a final PR from the epic branch to your base branch. Either way, treat it like code from a junior developer who works very fast — it needs a sanity check, not a full rewrite.
-
-**Some tickets will need a retry.** If Claude gets stuck or produces something obviously wrong, delete the branch and run `/clancy:once` again. Fresh context, fresh attempt. If it fails twice on the same ticket, the ticket probably needs more detail.
-
-**Clancy is token-heavy.** Each ticket starts a fresh Claude session that reads your codebase docs, CLAUDE.md, and then implements the ticket — before writing a single line of code, it has already consumed significant context. Rough estimates per ticket:
-
-| Ticket complexity | Approximate total tokens | Approximate cost (Sonnet) |
-|---|---|---|
-| Simple (small change, clear scope) | 50,000–100,000 | $0.25–$0.75 |
-| Medium (feature, 5–15 files touched) | 100,000–250,000 | $0.75–$2.00 |
-| Complex (large feature, many files) | 250,000–500,000+ | $2.00–$5.00+ |
-
-These are rough estimates — actual usage depends on your codebase doc size, how many files Claude reads during implementation, and how much code it writes. **Check Claude Code's usage dashboard after your first `/clancy:once` run to see real numbers for your codebase.**
-
-A few ways to manage costs:
-- Use a lighter model — set `CLANCY_MODEL=claude-haiku-4-5` in `.clancy/.env` for simpler tickets (significantly cheaper, less capable)
-- Keep `.clancy/docs/` files concise — they're read in full on every ticket
-- Use small, well-scoped tickets — fewer files read, less output generated
-
----
-
-## Supported boards
-
-- **Jira** — via REST API v3, JQL, ADF description parsing
-- **GitHub Issues** — via REST API with PR filtering
-- **Linear** — via GraphQL, `viewer.assignedIssues`, `state.type: unstarted`
-- **Shortcut** — via REST API v3, workflow state resolution, epic stories
-- **Notion** — via REST API, database rows as tickets, property name overrides
-- **Azure DevOps** — via REST API, work items, org + project scoping
-
-Community can add boards — see [CONTRIBUTING.md](./CONTRIBUTING.md).
-
----
-
-## Install
-
-```bash
-npx chief-clancy
-```
-
-You'll be asked: global install (`~/.claude`) or local (`./.claude`). Either works. Global makes commands available in all projects.
-
-**Prerequisites:**
-
-- [Claude Code](https://claude.ai/code) CLI installed
-- Node.js 22+ (`node -v`)
-- `git` installed (comes with most development environments)
-
-### Permissions
-
-Clancy is designed to run Claude with `--dangerously-skip-permissions`:
-
-```bash
-claude --dangerously-skip-permissions
-```
-
-> [!TIP]
-> This is how Clancy is intended to be used — stopping to approve `git commit` and `node` 50 times defeats the purpose. Only use it on codebases you own and trust.
-
----
-
-## Getting started
-
-```bash
-# 1. Install Clancy commands
-npx chief-clancy
-
-# 2. Open a project in Claude Code, then:
-/clancy:init
-
-# 3. Scan your codebase (or say yes during init)
-/clancy:map-codebase
-
-# 4. Preview the first ticket (no changes made)
-/clancy:dry-run
-
-# 5. Watch your first ticket
-/clancy:once
-
-# 6. Go AFK
-/clancy:run
-
-# Fully autonomous (no prompts at any step):
-# /clancy:brief --afk #42 → /clancy:approve-brief --afk → /clancy:run
-```
-
----
-
-## Commands
-
-| Command                | Description                                                              |
-| ---------------------- | ------------------------------------------------------------------------ |
-| `/clancy:brief` ²      | Grill phase → strategy brief → vertical slice decomposition → tickets    |
-| `/clancy:approve-brief` ² | Review and approve a strategy brief, then create board tickets         |
-| `/clancy:plan` ¹       | Refine backlog tickets into structured implementation plans              |
-| `/clancy:plan 3` ¹     | Plan up to 3 tickets in batch mode                                       |
-| `/clancy:approve-plan` ¹ | Promote an approved plan to the ticket description                     |
-| `/clancy:init`         | Wizard — choose board, collect config, scaffold everything               |
-| `/clancy:run`          | Loop mode — processes tickets until queue is empty or MAX_ITERATIONS hit |
-| `/clancy:run 20`       | Same, override MAX_ITERATIONS to 20 for this session                     |
-| `/clancy:once`         | Pick up one ticket and stop                                              |
-| `/clancy:dry-run`      | Preview next ticket without making changes — no git ops, no Claude call  |
-| `/clancy:status`       | Show next tickets without running — read-only                            |
-| `/clancy:review`       | Score next ticket (0–100%) with actionable recommendations               |
-| `/clancy:logs`         | Format and display `.clancy/progress.txt`                                |
-| `/clancy:map-codebase` | Full 5-agent parallel codebase scan, writes 10 docs                      |
-| `/clancy:update-docs`  | Incremental refresh — re-runs agents for changed areas                   |
-| `/clancy:settings`     | View and change configuration — model, iterations, board, and more      |
-| `/clancy:doctor`       | Diagnose your setup — test every integration, report what's broken       |
-| `/clancy:update`       | Update Clancy to latest version                                          |
-| `/clancy:uninstall`    | Remove Clancy commands — optionally remove `.clancy/` too               |
-| `/clancy:help`         | Command reference                                                        |
-
-¹ Planner is an optional role — see [Roles](#roles) below.
-² Strategist is an optional role — see [Roles](#roles) below.
-
----
-
-## Roles
-
-Clancy organises its commands into **roles** — each role handles a different stage of the development workflow.
-
-| Role | Purpose | Commands |
-| --- | --- | --- |
-| **Implementer** | Plan → code. Picks up tickets, implements, commits, merges | `/clancy:once`, `/clancy:run`, `/clancy:dry-run` |
-| **Reviewer** | Score ticket readiness and track progress | `/clancy:review`, `/clancy:status`, `/clancy:logs` |
-| **Setup** | Configure and maintain Clancy | `/clancy:init`, `/clancy:settings`, `/clancy:doctor`, etc. |
-| **Planner** *(optional)* | Refine backlog tickets into structured implementation plans | `/clancy:plan`, `/clancy:approve-plan` |
-| **Strategist** *(optional)* | Grill → brief → vertical slices → board tickets | `/clancy:brief`, `/clancy:approve-brief` |
-
-**Core roles** (Implementer, Reviewer, Setup) are always installed. **Optional roles** (Planner, Strategist) are opt-in — add them to `CLANCY_ROLES` in `.clancy/.env` and re-run the installer:
-
-```bash
-# Enable optional roles
-echo 'CLANCY_ROLES="planner,strategist"' >> .clancy/.env
-npx chief-clancy@latest --local   # or --global
-```
-
-You can also toggle roles from within Claude Code using `/clancy:settings`.
-
-Each role has detailed documentation:
-
-- [Implementer](docs/roles/IMPLEMENTER.md) — picks up tickets, implements, commits, merges (AFK loop support)
-- [Reviewer](docs/roles/REVIEWER.md) — scores ticket readiness, tracks progress
-- [Setup & Maintenance](docs/roles/SETUP.md) — init wizard, settings, diagnostics, codebase mapping
-- [Planner](docs/roles/PLANNER.md) — refines backlog tickets into structured implementation plans
-- [Strategist](docs/roles/STRATEGIST.md) — grill phase, strategy briefs, vertical slice decomposition, board ticket creation
-
-For a visual overview of how roles, commands, and flows connect, see the [Visual Architecture](docs/VISUAL-ARCHITECTURE.md) diagrams.
-
----
-
-## What gets created
-
-```
-.clancy/
-  clancy-once.js      — picks up one ticket, implements, commits, merges
-  clancy-afk.js       — loop runner (board-agnostic)
-  docs/               — 10 structured docs read before every run
-    STACK.md
-    INTEGRATIONS.md
-    ARCHITECTURE.md
-    CONVENTIONS.md
-    TESTING.md
-    GIT.md
-    DESIGN-SYSTEM.md
-    ACCESSIBILITY.md
-    DEFINITION-OF-DONE.md
-    CONCERNS.md
-  progress.txt        — append-only log of completed tickets
-  .env                — your board credentials (gitignored)
-  .env.example        — credential template for your board
-```
-
-Clancy also merges a section into your `CLAUDE.md` (or creates one) that tells Claude to read all these docs before every run.
-
----
-
-## Configuration
-
-Clancy supports optional enhancements — Figma design specs, Playwright visual checks, status transitions, and Slack/Teams notifications. All are configured via `.clancy/.env` or `/clancy:settings`.
-
-See [Configuration guide](docs/guides/CONFIGURATION.md) for full details and all environment variables.
-
----
-
-## Lineage
-
-![Chief Clancy Wiggum inspiration. Generated by Google Gemini](assets/inspired-chief-clancy.webp)
-
-Clancy is built on the **Ralph technique** coined by **Geoffrey Huntley** ([ghuntley.com/ralph/](https://ghuntley.com/ralph/)).
-
-Ralph in its purest form:
-
-```bash
-while :; do cat PROMPT.md | claude-code; done
-```
-
-Clancy is what happens when you take that idea seriously for team development. See [CREDITS.md](./CREDITS.md) for the full story.
-
----
-
-## Security
-
-Clancy runs Claude with `--dangerously-skip-permissions` for unattended operation. It includes a credential guard hook, recommended permission deny lists, and token scope guidance.
-
-See [Security guide](docs/guides/SECURITY.md) for full details — permissions model, credential protection, token scopes, and webhook security.
-
----
-
-## Troubleshooting
-
-**Start here:** run `/clancy:doctor` — it tests every integration and tells you exactly what's broken and how to fix it.
-
-See [Troubleshooting guide](docs/guides/TROUBLESHOOTING.md) for common issues and solutions.
-
----
-
-## Contributing
-
-See [CONTRIBUTING.md](./CONTRIBUTING.md). The most useful contribution is adding a new board — it's a TypeScript module + a JSON entry.
-
-## License
-
-MIT — see [LICENSE](./LICENSE).

package/dist/bundle/clancy-afk.js

@@ -1,6 +0,0 @@
-import{spawnSync as nt}from"node:child_process";import{existsSync as st}from"node:fs";import{dirname as rt,join as it,resolve as ct}from"node:path";import{setTimeout as L}from"node:timers/promises";import{fileURLToPath as U}from"node:url";function k(t){let o=Math.floor(t/1e3);if(o<60)return`${o}s`;let n=Math.floor(o/60),i=o%60;if(n<60)return i>0?`${n}m ${i}s`:`${n}m`;let l=Math.floor(n/60),a=n%60;return a>0?`${l}h ${a}m`:`${l}h`}function H(t){return t.includes("hooks.slack.com")}function K(t){return JSON.stringify({text:t})}function j(t){return JSON.stringify({type:"message",attachments:[{contentType:"application/vnd.microsoft.card.adaptive",content:{$schema:"http://adaptivecards.io/schemas/adaptive-card.json",type:"AdaptiveCard",version:"1.4",body:[{type:"TextBlock",text:t,wrap:!0}]}}]})}async function P(t,o){let n=H(t)?K(o):j(o);try{let i=await fetch(t,{method:"POST",headers:{"Content-Type":"application/json"},body:n});i.ok||console.warn(`\u26A0 Notification failed: HTTP ${i.status}`)}catch{console.warn("\u26A0 Notification failed: could not reach webhook")}}var m=t=>`\x1B[2m${t}\x1B[0m`,x=t=>`\x1B[1m${t}\x1B[0m`;var M=t=>`\x1B[32m${t}\x1B[0m`,w=t=>`\x1B[31m${t}\x1B[0m`,N=t=>`\x1B[33m${t}\x1B[0m`;import{mkdirSync as z,readFileSync as G,writeFileSync as tt}from"node:fs";import{join as C}from"node:path";import{mkdirSync as ht,readFileSync as B,renameSync as gt,writeFileSync as St}from"node:fs";import{join as Y}from"node:path";function q(t){return Y(t,".clancy","quality.json")}function W(t){try{let o=B(q(t),"utf8"),n=JSON.parse(o);if(n&&typeof n.tickets=="object"&&n.tickets!==null&&!Array.isArray(n.tickets))return J(n),n}catch{}return{tickets:{},summary:{totalTickets:0,avgReworkCycles:0,avgVerificationRetries:0,avgDuration:0}}}function J(t){let o=Object.values(t.tickets),n=o.length;if(n===0){t.summary={totalTickets:0,avgReworkCycles:0,avgVerificationRetries:0,avgDuration:0};return}let i=0,l=0,a=0,s=0;for(let c of o)i+=c.reworkCycles,l+=c.verificationRetries,c.duration!=null&&(a+=c.duration,s++);t.summary={totalTickets:n,avgReworkCycles:Math.round(i/n*100)/100,avgVerificationRetries:Math.round(l/n*100)/100,avgDuration:s>0?Math.round(a/s*100)/100:0}}function b(t){let o=W(t);if(Object.keys(o.tickets).length!==0)return o}import{appendFileSync as Et,mkdirSync as xt,readFileSync as X}from"node:fs";import{dirname as Dt,join as Z}from"node:path";function I(t){let o=Z(t,".clancy","progress.txt"),n;try{n=X(o,"utf8")}catch{return[]}let i=[];for(let l of n.split(`
-`)){let a=l.trim();if(!a)continue;let s=a.split(" | ");if(s.length<4)continue;let c=s[0];if(s[1]==="BRIEF"||s[1]==="APPROVE_BRIEF"){i.push({timestamp:c,key:s[2],summary:s.slice(3).join(" | "),status:s[1]});continue}let p=s[1],u,d,h,S=[];for(let y=2;y<s.length;y++){let f=s[y],T=f.match(/^pr:(\d+)$/),r=f.match(/^parent:(.+)$/);T?d=parseInt(T[1],10):r?h=r[1]:y>=3&&!u&&f===f.toUpperCase()&&f.length>1?u=f:S.push(f)}u&&(u==="APPROVE"&&(u="APPROVE_PLAN"),i.push({timestamp:c,key:p,summary:S.join(" | "),status:u,...d!=null&&{prNumber:d},...h!=null&&{parent:h}}))}return i}var $=new Set(["DONE","PR_CREATED","PUSHED","EPIC_PR_CREATED","RESUMED"]),D=new Set(["SKIPPED","PUSH_FAILED","TIME_LIMIT"]);function et(t,o){let n=C(t,".clancy","costs.log"),i;try{i=G(n,"utf8")}catch{return[]}let l=[];for(let a of i.split(`
-`)){let s=a.trim();if(!s)continue;let c=s.split(" | ");if(c.length<4)continue;let p=c[0],u=new Date(p).getTime();Number.isNaN(u)||u<o||l.push({timestamp:p,key:c[1],duration:c[2],tokens:c[3]})}return l}function ot(t){return/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(t)?new Date(t.replace(" ","T")+":00Z").getTime():NaN}function _(t,o,n){let i=Math.floor(o/6e4)*6e4,a=I(t).filter(e=>{let g=ot(e.timestamp);return!Number.isNaN(g)&&g>=i}),s=et(t,o),c=new Map;for(let e of s)c.set(e.key,e);let p=new Map;for(let e of a)p.set(e.key,e);let u=[];for(let e of p.values()){let g=c.get(e.key);u.push({key:e.key,summary:e.summary,status:e.status,...e.prNumber!=null&&{prNumber:e.prNumber},...g&&{duration:g.duration,tokens:g.tokens}})}let d=u.filter(e=>$.has(e.status)),h=u.filter(e=>D.has(e.status)),S=k(n-o),y=0;for(let e of s){let g=e.tokens.match(/~(\d[\d,]*)/);g&&(y+=parseInt(g[1].replace(/,/g,""),10))}let f=new Date(o),T=`${f.getUTCFullYear()}-${String(f.getUTCMonth()+1).padStart(2,"0")}-${String(f.getUTCDate()).padStart(2,"0")}`,r=[];r.push(`# AFK Session Report \u2014 ${T}`),r.push(""),r.push("## Summary"),r.push(`- Tickets completed: ${d.length}`),r.push(`- Tickets failed: ${h.length}`),r.push(`- Total duration: ${S}`),y>0&&r.push(`- Estimated token usage: ${y.toLocaleString("en-US")}`),r.push(""),r.push("## Tickets"),u.length===0&&(r.push(""),r.push("No tickets were processed in this session."));for(let e of u){let V=$.has(e.status)?"\u2713":"\u2717";r.push(""),r.push(`### ${V} ${e.key} \u2014 ${e.summary}`),e.duration&&r.push(`- Duration: ${e.duration}`),e.tokens&&r.push(`- Tokens: ${e.tokens}`),e.prNumber!=null&&r.push(`- PR: #${e.prNumber}`),r.push(`- Status: ${e.status}`)}let E=u.filter(e=>e.prNumber!=null).map(e=>`#${e.prNumber}`),R=h.map(e=>e.key);if(E.length>0||R.length>0){r.push(""),r.push("## Next Steps"),E.length>0&&r.push(`- Review PRs ${E.join(", ")}`);for(let e of R)r.push(`- ${e} needs manual intervention`)}try{let e=b(t);e&&(r.push(""),r.push("## Quality Metrics"),r.push(`- Avg rework cycles: ${e.summary.avgReworkCycles}`),r.push(`- Avg verification retries: ${e.summary.avgVerificationRetries}`),e.summary.avgDuration>0&&r.push(`- Avg delivery time: ${k(e.summary.avgDuration)}`))}catch{}r.push("");let A=r.join(`
-`);try{let e=C(t,".clancy","session-report.md");z(C(t,".clancy"),{recursive:!0}),tt(e,A,"utf8")}catch{}return A}function F(t){let o=t.trim().match(/^(\d{1,2}):(\d{2})$/);if(!o)return null;let n=parseInt(o[1],10),i=parseInt(o[2],10);return n<0||n>23||i<0||i>59?null:{hours:n,minutes:i}}var O=!1;function at(t,o,n=new Date){let i=F(t),l=F(o);if(!i||!l)return O||(console.warn("\u26A0 Invalid quiet hours format. Expected HH:MM (24h). Quiet hours disabled."),O=!0),0;let a=n.getHours()*60+n.getMinutes(),s=i.hours*60+i.minutes,c=l.hours*60+l.minutes,p=!1;if(s<c?p=a>=s&&a<c:s>c&&(p=a>=s||a<c),!p)return 0;let u=c-a;u<=0&&(u+=1440);let d=n.getSeconds()*1e3+n.getMilliseconds();return Math.max(0,u*6e4-d)}var v={noTickets:/No tickets found|No issues found|All done/,skipped:/Ticket skipped/,preflightFail:/^✗ /m};function ut(t){return v.noTickets.test(t)?{stop:!0,reason:"No more tickets \u2014 all done"}:v.skipped.test(t)?{stop:!0,reason:"Ticket was skipped \u2014 update the ticket and re-run"}:v.preflightFail.test(t)?{stop:!0,reason:"Preflight check failed"}:{stop:!1}}function lt(t){return nt("node",[t],{encoding:"utf8",stdio:["inherit","pipe","inherit"],cwd:process.cwd(),env:{...process.env,CLANCY_AFK_MODE:"1"}})}async function pt(t,o=5,n=lt){let i=it(t,"clancy-once.js");if(!st(i)){console.error(w("\u2717 clancy-once.js not found in"),t);return}console.log(m("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510")),console.log(m("\u2502")+x("  \u{1F916} Clancy \u2014 AFK mode                                  ")+m("\u2502")),console.log(m("\u2502")+m(`  "I'm on it. Proceed to the abandoned warehouse."       `)+m("\u2502")),console.log(m("\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"));let l=Date.now();for(let s=1;s<=o;s++){let c=process.env.CLANCY_QUIET_START,p=process.env.CLANCY_QUIET_END;if(c&&p){let f=at(c,p);if(f>0){let T=Math.ceil(f/6e4);console.log(""),console.log(N(`\u23F8 Quiet hours active (${c}\u2013${p}). Sleeping ${T} minutes until ${p}.`)),await L(f),console.log(m("  Quiet hours ended. Resuming."))}}else(c&&!p||!c&&p)&&console.log(m("  \u26A0 Only one of CLANCY_QUIET_START / CLANCY_QUIET_END is set \u2014 skipping quiet hours check."));let u=Date.now();console.log(""),console.log(x(`\u{1F501} Iteration ${s}/${o}`));let d=await n(i),h=d.stdout??"";h&&process.stdout.write(h);let S=k(Date.now()-u);if(d.error){console.error(w(`\u2717 Failed to run clancy-once: ${d.error.message}`));return}let y=ut(h);if(y.stop){let f=k(Date.now()-l);console.log(""),console.log(m(`  Iteration ${s} took ${S}`)),console.log(`
-${y.reason}`),console.log(m(`  Total: ${s} iteration${s>1?"s":""} in ${f}`)),Q(l);return}console.log(m(`  Iteration ${s} took ${S}`)),s<o&&await L(2e3)}let a=k(Date.now()-l);console.log(""),console.log(M(`\u{1F3C1} Completed ${o} iterations`)+m(` (${a})`)),console.log(m(`  "That's some good police work."`)),console.log(m("  Run clancy-afk again to continue.")),Q(l)}function Q(t){try{let o=_(process.cwd(),t,Date.now());console.log(""),console.log(m("\u2500\u2500\u2500 Session Report \u2500\u2500\u2500")),console.log(o);let n=process.env.CLANCY_NOTIFY_WEBHOOK;if(n){let a=`Clancy AFK: ${o.split(`
-`).filter(s=>s.startsWith("- Tickets")||s.startsWith("- Total")).join(". ")}. Report: .clancy/session-report.md`;P(n,a).catch(()=>{})}}catch{}}if(process.argv[1]&&U(import.meta.url)===ct(process.argv[1])){let t=rt(U(import.meta.url)),o=parseInt(process.env.MAX_ITERATIONS??"5",10)||5;pt(t,o)}export{ut as checkStopCondition,at as getQuietSleepMs,F as parseTime,pt as runAfkLoop};