@chief-clancy/terminal 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Clapperton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @chief-clancy/terminal
+
+Installer, slash commands, hooks, runners, agents, and Claude CLI bridge for [Clancy](https://github.com/Pushedskydiver/chief-clancy).
+
+[![npm](https://img.shields.io/npm/v/@chief-clancy/terminal?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/@chief-clancy/terminal) [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=for-the-badge)](../../LICENSE)
+
+> This package is part of the [Clancy monorepo](https://github.com/Pushedskydiver/chief-clancy). You don't install it directly — run `npx chief-clancy` to install Clancy into your project.
+
+## What's in it
+
+### Installer
+
+The install orchestrator that powers `npx chief-clancy`. Copies slash commands, workflows, hooks, and runtime bundles into the user's `.claude/` and `.clancy/` directories. Supports global (`~/.claude`) and local (`./.claude`) installs, SHA-256 manifest tracking for patch preservation, and role-based filtering via `CLANCY_ROLES`.
+
+### Slash commands & workflows
+
+18 slash commands across 5 roles, each backed by a detailed workflow file:
+
+| Role            | Commands                                                                                                                                                   |
+| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Implementer** | `/clancy:implement`, `/clancy:autopilot`, `/clancy:dry-run`                                                                                                |
+| **Reviewer**    | `/clancy:review`, `/clancy:status`, `/clancy:logs`                                                                                                         |
+| **Setup**       | `/clancy:init`, `/clancy:settings`, `/clancy:doctor`, `/clancy:map-codebase`, `/clancy:update-docs`, `/clancy:update`, `/clancy:uninstall`, `/clancy:help` |
+| **Planner**     | `/clancy:plan`, `/clancy:approve-plan`                                                                                                                     |
+| **Strategist**  | `/clancy:brief`, `/clancy:approve-brief`                                                                                                                   |
+
+### Hooks
+
+CJS bundles built by esbuild — best-effort, fail-open, never block the user:
+
+| Hook                      | Event        | Purpose                                                      |
+| ------------------------- | ------------ | ------------------------------------------------------------ |
+| `clancy-credential-guard` | PreToolUse   | Blocks credential writes to source files                     |
+| `clancy-branch-guard`     | PreToolUse   | Blocks force push, protected branch push, destructive resets |
+| `clancy-context-monitor`  | PostToolUse  | Context % warnings and time guard                            |
+| `clancy-drift-detector`   | PostToolUse  | Warns when runtime files are outdated                        |
+| `clancy-statusline`       | Statusline   | Context usage bar and update notices                         |
+| `clancy-check-update`     | SessionStart | Background npm version check                                 |
+| `clancy-post-compact`     | PostCompact  | Re-injects ticket context after compaction                   |
+| `clancy-notification`     | Notification | Native OS desktop notifications                              |
+
+### Runners
+
+Two execution modes powered by the `@chief-clancy/core` pipeline:
+
+- **`runImplement`** — single ticket: fetch, implement, deliver, exit
+- **`runAutopilot`** — loop: repeat implement until queue is empty, generate session report
+
+### Agents
+
+Specialist agent prompts (`.md` files) for codebase scanning, devil's advocate grilling, verification gates, and more.
+
+## Documentation
+
+- [Architecture](../../docs/ARCHITECTURE.md) — full module map and package boundaries
+- [Role documentation](../../docs/roles/) — detailed docs for each role
+- [Configuration](../../docs/guides/CONFIGURATION.md) — all env vars and settings
+- [Testing](../../docs/TESTING.md) — test patterns, E2E setup, CI schedule
+
+## License
+
+MIT — see [LICENSE](../../LICENSE).

package/dist/hooks/clancy-branch-guard.js

@@ -0,0 +1 @@
+"use strict";var E=require("node:fs");function r(){return{decision:"approve"}}function u(t){return{decision:"block",reason:t}}function p(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}var l={};var k=0;function g(t){try{let e=JSON.parse(t);return p(e)?e:l}catch{return l}}function f(t){let e=t.argv[2];if(e)return g(e);try{let n=t.readFileSync(k,"utf8");return g(n)}catch{return l}}var i=["main","master","develop"],A=/\bgit\s+push\b/,R=/\s--force\b/,S=/\s-f\b/,b=/--force-with-lease/,T=/\bgit\s+reset\s+--hard\b/,O=/\bgit\s+clean\s+(.*)/,y=/(?:^|\s)-[a-zA-Z]*f/,P=/(?:^|\s)-[a-zA-Z]*n/,D=/\bgit\s+checkout\s+--\s+\./,F=/\bgit\s+restore\s+\.(?:\s*$|\s*[;&|])/,N=/\bgit\s+branch\s+.*-D\b/,x="Blocked: git push --force destroys remote history. Use --force-with-lease instead.",B=t=>`Blocked: direct push to protected branch '${t}'. Create a PR instead.`,L="Blocked: git reset --hard discards all uncommitted changes.",I="Blocked: git clean -f deletes untracked files. Use -n for a dry run first.",H="Blocked: git checkout -- . discards all unstaged changes.",U="Blocked: git restore . discards all unstaged changes.",M="Blocked: git branch -D force-deletes without merge check. Use -d for safe deletion.";function _(t){return t?i.includes(t)?[...i]:[...i,t]:[...i]}function G(t){let e=/\bgit\s+push\b[^&|;]*/.exec(t);return e?e[0]:null}function v(t){let e=G(t);if(!e)return null;let n=R.test(e)||S.test(e),o=b.test(e);return n&&!o?x:null}function J(t,e){if(!A.test(t))return null;let n=t.split(/\s+/),o=n.indexOf("push");if(o<0)return null;let c=(n.slice(o+1).filter(a=>!a.startsWith("-"))[1]??"").split(":")[0],h=e.find(a=>c===a);return h?B(h):null}function w(t){return T.test(t)?L:null}function Y(t){let e=O.exec(t);if(!e)return null;let n=e[1],o=y.test(n),s=P.test(n);return o&&!s?I:null}function j(t){return D.test(t)?H:null}function z(t){return F.test(t)?U:null}function K(t){return N.test(t)?M:null}function m(t,e){return t?[()=>v(t),()=>J(t,e),()=>w(t),()=>Y(t),()=>j(t),()=>z(t),()=>K(t)].map(s=>s()).find(Boolean)??null:null}try{process.env.CLANCY_BRANCH_GUARD==="false"&&(console.log(JSON.stringify(r())),process.exit(0));let e=f({argv:process.argv,readFileSync:E.readFileSync}),n=e.tool_name??"",o=e.tool_input??{},s=typeof o.command=="string"?o.command:"";n==="Bash"||(console.log(JSON.stringify(r())),process.exit(0));let d=_(process.env.CLANCY_BASE_BRANCH),c=m(s,d);console.log(JSON.stringify(c?u(c):r()))}catch{console.log(JSON.stringify(r()))}

package/dist/hooks/clancy-check-update.js

@@ -0,0 +1,2 @@
+"use strict";var S=require("node:child_process"),r=require("node:fs"),o=require("node:os");var c=require("node:path"),u="VERSION",a=(0,c.join)(".claude","commands","clancy"),x=(0,c.join)(".clancy","briefs"),v=(0,c.join)(".clancy",".brief-stale-count"),D=7,F=864e5;function d(t,e){let n=(0,c.join)(t,a);if(l(n,e))return n;let i=(0,c.join)(e.homedir(),a);return l(i,e)?i:null}function l(t,e){try{return e.readFileSync((0,c.join)(t,u),"utf8"),!0}catch{return!1}}function f(t,e){try{return e.readFileSync((0,c.join)(t,u),"utf8").trim()}catch{return"0.0.0"}}var b=11;function g(t){let e=t.slice(0,b-1),n=new Date(`${e}T00:00:00Z`);return!isNaN(n.getTime())?n:null}function k(t,e){if(!(t.endsWith(".md")&&!t.endsWith(".feedback.md"))||e.deps.existsSync((0,c.join)(e.briefsPath,`${t}.approved`)))return!1;let s=g(t);return s!==null&&s.getTime()<e.staleThreshold}function h(t,e,n){let i=(0,c.join)(t,x);try{let s=n.readdirSync(i),m=e-D*F,w={briefsPath:i,staleThreshold:m,deps:n};return s.filter(_=>k(_,w)).length}catch{return null}}function p(t){let e=(0,c.join)(t,".claude","cache");return{dir:e,file:(0,c.join)(e,"clancy-update-check.json")}}function y(t){return(0,c.join)(t,v)}try{let t=process.cwd(),e=(0,o.homedir)();A(t);let n=d(t,{readFileSync:r.readFileSync,homedir:o.homedir});n||process.exit(0),E(n,e)}catch{}function A(t){let e=y(t),n=h(t,Date.now(),{readdirSync:r.readdirSync,existsSync:r.existsSync});if(n===null){try{(0,r.unlinkSync)(e)}catch{}return}try{(0,r.writeFileSync)(e,String(n))}catch{}}function E(t,e){let n=f(t,{readFileSync:r.readFileSync}),i=p(e);try{(0,r.mkdirSync)(i.dir,{recursive:!0})}catch{}(0,S.spawn)(process.execPath,["-e",I(n,i.file)],{detached:!0,stdio:"ignore",windowsHide:!0}).unref()}function I(t,e){let n=JSON.stringify(t),i=JSON.stringify(e);return["const { execFileSync } = require('child_process');","const fs = require('fs');","let latest = 'unknown';","try {","  latest = execFileSync('npm', ['view', 'chief-clancy', 'version'], { timeout: 10000, encoding: 'utf8' }).trim();","} catch {}",`const installed = ${n};`,"const hasLatest = latest !== 'unknown' && latest !== '';","const cache = {","  update_available: hasLatest && latest !== installed,","  installed,","  latest,","  checked: Math.floor(Date.now() / 1000),","};",`try { fs.writeFileSync(${i}, JSON.stringify(cache)); } catch {}`].join(`
+`)}

package/dist/hooks/clancy-context-monitor.js

@@ -0,0 +1,9 @@
+"use strict";var g=require("node:fs"),k=require("node:os");function x(e,t){return{hookSpecificOutput:{hookEventName:e,additionalContext:t}}}var P=require("node:path");function l(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function y(e,t){let n=(0,P.join)(e,".clancy","lock.json");try{let r=JSON.parse(t.readFileSync(n,"utf8"));return l(r)?r:null}catch{return null}}var M=require("node:stream/consumers");var w={},G=3e3;function Y(e){try{let t=JSON.parse(e);return l(t)?t:w}catch{return w}}function H(e){return new Promise(t=>{setTimeout(()=>t(w),e)})}function S(e){let t=e.timeoutMs??G,n=(0,M.text)(e.stdin).then(Y);return Promise.race([n,H(t)])}var L=require("node:path");function b(e){return String(e).replace(/[^a-zA-Z0-9_-]/g,"")}function C(e,t){return(0,L.join)(t.tmpdir(),`clancy-ctx-${b(e)}.json`)}function I(e,t){return(0,L.join)(t.tmpdir(),`clancy-ctx-${b(e)}-warned.json`)}var J=35,B=25,q=60,K=5,V=80,X=100,N=30;function A(e,t,n){return e||t>=K||n}function D(e,t,n){let r={message:null,debounce:t};if(!e||e.timestamp!==void 0&&n-e.timestamp>q)return r;let o=e.remaining_percentage;if(!(o<=J))return r;let m=t.callsSinceWarn+1,a=o<=B,d=a?"critical":"warning",p=t.lastLevel===null,c=t.lastLevel==="warning";return A(p,m,a&&c)?{message:a?Z(e.used_pct,o):z(e.used_pct,o),debounce:{callsSinceWarn:0,lastLevel:d}}:{message:null,debounce:{callsSinceWarn:m,lastLevel:t.lastLevel}}}function O(e,t){let n={message:null,debounce:t},{startedAt:r,timeLimitMinutes:i,nowMs:o}=e;if(!r||i<=0)return n;let s=new Date(r).getTime();if(isNaN(s))return n;let a=o-s,d=Math.floor(a/6e4),p=i*6e4,c=Math.floor(a/p*100);if(c<V)return n;let f=t.callsSinceWarn+1,u=c>=X,E=u?"critical":"warning",$=t.lastLevel===null,j=t.lastLevel==="warning";return A($,f,u&&j)?{message:u?tt(d,i):Q(d,i,c),debounce:{callsSinceWarn:0,lastLevel:E}}:{message:null,debounce:{callsSinceWarn:f,lastLevel:t.lastLevel}}}var v={callsSinceWarn:0,lastLevel:null},h={context:v,time:v};function F(e){try{let t=JSON.parse(e);return l(t)?{context:_(t.context),time:_(t.time)}:h}catch{return h}}function W(e){try{let t=JSON.parse(e);if(!l(t))return null;let n=t.remaining_percentage,r=t.used_pct;if(!(typeof n=="number"&&typeof r=="number"&&Number.isFinite(n)&&Number.isFinite(r)))return null;let o={remaining_percentage:n,used_pct:r},s=t.timestamp;return typeof s=="number"&&Number.isFinite(s)?{...o,timestamp:s}:o}catch{return null}}function R(e){if(e===void 0)return N;let t=Number(e);return Number.isFinite(t)?t:N}function _(e){if(!l(e))return v;let t=e.callsSinceWarn,n=typeof t=="number"?t:0,r=e.lastLevel;return{callsSinceWarn:n,lastLevel:r==="warning"||r==="critical"?r:null}}function z(e,t){return`CONTEXT WARNING: Usage at ${e}%. Remaining: ${t}%. Context is getting limited. Stop exploring and move to implementation. Avoid reading additional files unless strictly necessary. Commit completed work as soon as it is ready.`}function Z(e,t){return`CONTEXT CRITICAL: Usage at ${e}%. Remaining: ${t}%. Context is nearly exhausted. Stop reading files and wrap up immediately:
+1. Commit whatever work is staged on the current feature branch
+2. Append a WIP entry to .clancy/progress.txt: YYYY-MM-DD HH:MM | TICKET-KEY | Summary | WIP \u2014 context exhausted
+3. Inform the user what was completed and what remains.
+Do NOT start any new work.`}function Q(e,t,n){return`TIME WARNING: Ticket implementation at ${e}min of ${t}min limit (${n}%).
+Wrap up implementation and prepare for delivery. Avoid starting new approaches.`}function tt(e,t){return`TIME CRITICAL: Time limit reached (${e}min of ${t}min).
+STOP implementation immediately. Commit current work, push the branch,
+and create the PR with whatever is ready. Log a WIP entry if incomplete.`}S({stdin:process.stdin}).then(et).catch(()=>{});function et(e){let t=e.session_id??"";if(!t)return;let n=e.cwd??process.cwd(),r={readFileSync:g.readFileSync},i={tmpdir:k.tmpdir},o=I(t,i),s=nt(o,r),m=C(t,i),a=U(m,r),d=a?W(a):null,p=Math.floor(Date.now()/1e3),c=D(d,s.context,p),T=y(n,r),f=R(process.env.CLANCY_TIME_LIMIT),u=O({startedAt:T?.startedAt,timeLimitMinutes:f,nowMs:Date.now()},s.time);rt(o,s,{context:c,time:u}),it(c,u)}function U(e,t){try{return t.readFileSync(e,"utf8")}catch{return null}}function nt(e,t){let n=U(e,t);return n?F(n):h}function rt(e,t,n){if(!(n.context.debounce!==t.context||n.time.debounce!==t.time))return;let i={context:n.context.debounce,time:n.time.debounce};try{(0,g.writeFileSync)(e,JSON.stringify(i))}catch{}}function it(e,t){let n=[e.message,t.message].filter(i=>i!==null);if(n.length===0)return;let r=x("PostToolUse",n.join(`
+`));process.stdout.write(JSON.stringify(r))}

package/dist/hooks/clancy-credential-guard.js

@@ -0,0 +1,2 @@
+"use strict";var x=require("node:fs");function o(){return{decision:"approve"}}function i(e){return{decision:"block",reason:e}}function f(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}var a={};var P=0;function g(e){try{let t=JSON.parse(e);return f(t)?t:a}catch{return a}}function c(e){let t=e.argv[2];if(t)return g(t);try{let n=e.readFileSync(P,"utf8");return g(n)}catch{return a}}function r(e,t,n){return new RegExp(`(?:${e})\\s*[:=]\\s*["']?${t}{${n},}["']?`,"i")}var l="[A-Za-z0-9\\-_.]",h="[A-Za-z0-9+/=]",v="[A-Za-z0-9/+=]",b=[{name:"Generic API key",regex:r("api[_-]?key|apikey",l,20)},{name:"Generic secret",regex:r("secret|private[_-]?key",l,20)},{name:"Generic token",regex:r("auth[_-]?token|access[_-]?token|bearer",l,20)},{name:"Generic password",regex:r("password|passwd|pwd",`[^\\s"']`,8)},{name:"AWS Secret Key",regex:r("aws_secret_access_key|aws_secret",v,40)},{name:"Atlassian API token",regex:r("jira_api_token|atlassian[_-]?token",h,24)},{name:"AWS Access Key",regex:/AKIA[0-9A-Z]{16}/},{name:"GitHub PAT (classic)",regex:/ghp_[A-Za-z0-9]{36}/},{name:"GitHub PAT (fine-grained)",regex:/github_pat_[A-Za-z0-9_]{82}/},{name:"GitHub OAuth token",regex:/gho_[A-Za-z0-9]{36}/},{name:"Slack token",regex:/xox[bpors]-[0-9]{10,}-[A-Za-z0-9-]+/},{name:"Stripe key",regex:/(?:sk|pk)_(?:live|test)_[A-Za-z0-9]{24,}/},{name:"Linear API key",regex:/lin_api_[A-Za-z0-9]{40,}/},{name:"Private key",regex:/-----BEGIN (?:RSA |EC |DSA |OPENSSH )?PRIVATE KEY-----/},{name:"Database connection string",regex:/(?:mongodb|postgres|mysql|redis):\/\/[^\s"']+:[^\s"']+@/i}],w=[".clancy/.env",".env.local",".env.example",".env.development",".env.test"];function m(e){return w.some(t=>e.endsWith(t))}function A(e){return e?b.filter(({regex:t})=>t.test(e)).map(({name:t})=>t):[]}function T(e){if(!(typeof e=="object"&&e!==null))return;let n=e.new_string;return typeof n=="string"?n:void 0}function d(e,t){if(e==="Write"){let n=t.content;return typeof n=="string"?n:null}if(e==="Edit"){let n=t.new_string;return typeof n=="string"?n:null}if(e==="MultiEdit"){let n=t.edits;return Array.isArray(n)?n.map(T).filter(Boolean).join(`
+`):null}return null}try{let e=c({argv:process.argv,readFileSync:x.readFileSync}),t=e.tool_name??"",n=e.tool_input??{},s=typeof n.file_path=="string"?n.file_path:"",u=d(t,n),_=u!==null,y=s!==""&&m(s);(!_||y)&&(console.log(JSON.stringify(o())),process.exit(0));let p=A(u);if(p.length>0){let k=p.join(", "),S=`Credential guard: blocked writing to ${s}. Detected: ${k}. Move credentials to .clancy/.env instead.`;console.log(JSON.stringify(i(S)))}else console.log(JSON.stringify(o()))}catch{console.log(JSON.stringify(o()))}

package/dist/hooks/clancy-drift-detector.js

@@ -0,0 +1 @@
+"use strict";var u=require("node:fs"),f=require("node:os");function l(t,r){return{hookSpecificOutput:{hookEventName:t,additionalContext:r}}}var x=require("node:stream/consumers");function a(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}var p={},D=3e3;function F(t){try{let r=JSON.parse(t);return a(r)?r:p}catch{return p}}function T(t){return new Promise(r=>{setTimeout(()=>r(p),t)})}function d(t){let r=t.timeoutMs??D,n=(0,x.text)(t.stdin).then(F);return Promise.race([n,T(r)])}var P=require("node:path");function h(t){return String(t).replace(/[^a-zA-Z0-9_-]/g,"")}function m(t,r){return(0,P.join)(r.tmpdir(),`clancy-drift-${h(t)}`)}var s=require("node:path");var j=(0,s.join)(".clancy","version.json"),g=(0,s.join)(".claude","commands","clancy","VERSION");function S(t,r){return!t||!r?!1:t.trim()!==r.trim()}function y(t,r){try{return r.readFileSync(t,"utf8")}catch{return null}}function I(t,r){let n=y((0,s.join)(t,j),r);if(!n)return null;try{let o=JSON.parse(n);if(!a(o))return null;let e=o.version;return typeof e=="string"?e:null}catch{return null}}function O(t,r,n){let o=(0,s.join)(t,g),e=(0,s.join)(r,g),i=y(o,n);if(i)return i.trim();let c=y(e,n);return c?c.trim():null}function b(t,r){return`DRIFT WARNING: Clancy runtime files are outdated (runtime: ${t}, commands: ${r}). Run /clancy:update to sync your installation.`}d({stdin:process.stdin}).then(t=>{let r=t.session_id??"";if(!r)return;let n=m(r,{tmpdir:f.tmpdir});try{(0,u.writeFileSync)(n,"1",{flag:"wx"})}catch{return}let o=t.cwd??process.cwd(),e={readFileSync:u.readFileSync},i=I(o,e),c=O(o,(0,f.homedir)(),e);if(!i||!c||!S(i,c))return;let N=b(i,c),w=l("PostToolUse",N);process.stdout.write(JSON.stringify(w))}).catch(()=>{});

package/dist/hooks/clancy-notification.js

@@ -0,0 +1 @@
+"use strict";var l=require("node:child_process");var a=require("node:stream/consumers");function s(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}var i={},p=3e3;function m(t){try{let e=JSON.parse(t);return s(e)?e:i}catch{return i}}function d(t){return new Promise(e=>{setTimeout(()=>e(i),t)})}function c(t){let e=t.timeoutMs??p,n=(0,a.text)(t.stdin).then(m);return Promise.race([n,d(e)])}var y="Clancy notification";function f(t){return typeof t.message=="string"&&t.message!==""?t.message:typeof t.notification=="string"&&t.notification!==""?t.notification:x(t)??y}function x(t){let e=t.text;if(typeof e=="string"&&e!=="")return e;let n=t.hookSpecificOutput,r=typeof n=="object"&&n!==null?n.message:void 0;if(typeof r=="string"&&r!=="")return r}function E(t){return t.replaceAll("\\","\\\\").replaceAll('"','\\"')}function T(t){return t.replaceAll("`","``").replaceAll("$","`$").replaceAll('"','`"')}function S(t,e){let o=`display notification "${E(t)}" with title "Clancy"`;e("osascript",["-e",o],{timeout:5e3,windowsHide:!0})}function M(t,e){e("notify-send",["Clancy",t],{timeout:5e3,windowsHide:!0})}function g(t,e){let o=`Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show("${T(t)}", "Clancy")`;e("powershell",["-NoProfile","-Command",o],{timeout:5e3,windowsHide:!0})}var w={darwin:S,linux:M,win32:g};function u(t,e){let n=w[e.platform];if(!n){e.log(`[Clancy] ${t}`);return}try{n(t,e.exec)}catch{e.log(`[Clancy] ${t}`)}}var A=process.env.CLANCY_DESKTOP_NOTIFY==="false";A&&process.exit(0);c({stdin:process.stdin}).then(t=>{let e=f(t);u(e,{platform:process.platform,exec:l.execFileSync,log:console.log})}).catch(()=>{});

package/dist/hooks/clancy-post-compact.js

@@ -0,0 +1,2 @@
+"use strict";var d=require("node:fs");function c(t,n){return{hookSpecificOutput:{hookEventName:t,additionalContext:n}}}var p=require("node:path");function o(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}function s(t,n){let e=(0,p.join)(t,".clancy","lock.json");try{let r=JSON.parse(n.readFileSync(e,"utf8"));return o(r)?r:null}catch{return null}}var m=require("node:stream/consumers");var a={},x=3e3;function P(t){try{let n=JSON.parse(t);return o(n)?n:a}catch{return a}}function T(t){return new Promise(n=>{setTimeout(()=>n(a),t)})}function u(t){let n=t.timeoutMs??x,e=(0,m.text)(t.stdin).then(P);return Promise.race([e,T(n)])}function f(t){let{ticketKey:n,ticketBranch:e}=t;if(!n||!e)return null;let r=t.ticketTitle||"Unknown",i=t.targetBranch??"main",l=t.parentKey!==void 0&&t.parentKey!=="none"&&t.parentKey!==""?`Parent: ${t.parentKey}.`:void 0,y=t.description?`Requirements: ${t.description.slice(0,2e3)}`:void 0;return[`CONTEXT RESTORED: You are implementing ticket [${n}] ${r}.`,`Branch: ${e} targeting ${i}.`,l,y,"Continue your implementation. Do not start over."].filter(Boolean).join(`
+`)}u({stdin:process.stdin}).then(t=>{let n=t.cwd??process.cwd(),e=s(n,{readFileSync:d.readFileSync});if(!e)return;let r=f(e);if(!r)return;let i=c("PostCompact",r);process.stdout.write(JSON.stringify(i))}).catch(()=>{});

package/dist/hooks/clancy-statusline.js

@@ -0,0 +1 @@
+"use strict";var c=require("node:fs"),s=require("node:os");var h=require("node:stream/consumers");function i(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}var d={},C=3e3;function D(t){try{let n=JSON.parse(t);return i(n)?n:d}catch{return d}}function I(t){return new Promise(n=>{setTimeout(()=>n(d),t)})}function f(t){let n=t.timeoutMs??C,e=(0,h.text)(t.stdin).then(D);return Promise.race([e,I(n)])}var x=require("node:path");function b(t){return String(t).replace(/[^a-zA-Z0-9_-]/g,"")}function l(t,n){return(0,x.join)(n.tmpdir(),`clancy-ctx-${b(t)}.json`)}var p=require("node:path");var $=16.5,m=10,T="\u2588",F="\u2591",o="\x1B[0m",y="\x1B[2m",O="\x1B[32m",g="\x1B[33m",B="\x1B[38;5;208m",R="\x1B[5;31m",w=" \u2502 ";function _(t){let n=Math.max(0,(t-$)/(100-$)*100),e=Math.max(0,Math.min(100,Math.round(100-n)));return{usableRemaining:n,usedPct:e}}function A(t,n,e){let{usedPct:r}=_(n);return{session_id:t,remaining_percentage:n,used_pct:r,timestamp:e}}function j(t){let n=Math.max(0,Math.min(m,Math.floor(t/m))),e=T.repeat(n)+F.repeat(m-n),r=t<50,a=t>=50&&t<65,u=t>=65&&t<80;return r?`${O}${e} ${t}%${o}`:a?`${g}${e} ${t}%${o}`:u?`${B}${e} ${t}%${o}`:`${R}\u{1F480} ${e} ${t}%${o}`}function P(t,n){try{let e=JSON.parse(n.readFileSync(t,"utf8"));return i(e)?e.update_available===!0:!1}catch{return!1}}function M(t){let n=t.env??(0,p.join)(t.homedir(),".claude");return(0,p.join)(n,"cache","clancy-update-check.json")}function E(t,n){let e=t?`${g}\u2B06 /clancy:update${o}`:void 0,a=n!==void 0?`${y}Clancy${o} ${j(_(n).usedPct)}`:`${y}Clancy${o}`;return[e,a].filter(Boolean).join(w)}f({stdin:process.stdin}).then(U).catch(()=>{});function U(t){let n=t.session_id??"",e=t.context_window?.remaining_percentage;n!==""&&e!==void 0&&v(n,e);let a=M({env:process.env.CLAUDE_CONFIG_DIR,homedir:s.homedir}),u=P(a,{readFileSync:c.readFileSync}),S=E(u,e);process.stdout.write(S)}function v(t,n){try{let e=l(t,{tmpdir:s.tmpdir}),r=A(t,n,Math.floor(Date.now()/1e3));(0,c.writeFileSync)(e,JSON.stringify(r))}catch{}}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @chief-clancy/terminal
+ *
+ * Installer, slash commands, hooks, AFK runner, agents,
+ * and Claude CLI bridge.
+ */
+export declare const PACKAGE_NAME: "@chief-clancy/terminal";
+export { copyDir, inlineWorkflows } from './installer/file-ops/index.js';
+export { installHooks } from './installer/hook-installer/index.js';
+export type { InstallMode, InstallPaths, RunInstallOptions, } from './installer/install/index.js';
+export { parseEnabledRoles, parseInstallFlag, resolveInstallPaths, runInstall, validateSources, } from './installer/install/index.js';
+export { backupModifiedFiles, buildManifest, detectModifiedFiles, } from './installer/manifest/index.js';
+export { createPrompts } from './installer/prompts/index.js';
+export { copyRoleFiles } from './installer/role-filter/index.js';
+export { printBanner, printSuccess } from './installer/ui/index.js';
+export { blue, bold, cyan, dim, green, red, yellow, } from './shared/ansi/index.js';
+export { runAutopilot } from './runner/autopilot/index.js';
+export { invokeClaudePrint, invokeClaudeSession, } from './runner/cli-bridge/index.js';
+export { buildPipelineDeps } from './runner/dep-factory/index.js';
+export { sendNotification } from './runner/notify/index.js';
+export { runImplement } from './runner/implement/index.js';
+export { buildPrompt, buildReworkPrompt, } from './runner/prompt-builder/index.js';
+export { buildSessionReport, generateSessionReport, } from './runner/session-report/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAG,wBAAiC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,MAAM,GACP,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @chief-clancy/terminal
+ *
+ * Installer, slash commands, hooks, AFK runner, agents,
+ * and Claude CLI bridge.
+ */
+export const PACKAGE_NAME = '@chief-clancy/terminal';
+export { copyDir, inlineWorkflows } from './installer/file-ops/index.js';
+export { installHooks } from './installer/hook-installer/index.js';
+export { parseEnabledRoles, parseInstallFlag, resolveInstallPaths, runInstall, validateSources, } from './installer/install/index.js';
+export { backupModifiedFiles, buildManifest, detectModifiedFiles, } from './installer/manifest/index.js';
+export { createPrompts } from './installer/prompts/index.js';
+export { copyRoleFiles } from './installer/role-filter/index.js';
+export { printBanner, printSuccess } from './installer/ui/index.js';
+export { blue, bold, cyan, dim, green, red, yellow, } from './shared/ansi/index.js';
+export { runAutopilot } from './runner/autopilot/index.js';
+export { invokeClaudePrint, invokeClaudeSession, } from './runner/cli-bridge/index.js';
+export { buildPipelineDeps } from './runner/dep-factory/index.js';
+export { sendNotification } from './runner/notify/index.js';
+export { runImplement } from './runner/implement/index.js';
+export { buildPrompt, buildReworkPrompt, } from './runner/prompt-builder/index.js';
+export { buildSessionReport, generateSessionReport, } from './runner/session-report/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,wBAAiC,CAAC;AAE9D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAMnE,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEpE,OAAO,EACL,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,KAAK,EACL,GAAG,EACH,MAAM,GACP,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC"}

package/dist/installer/file-ops/file-ops.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Compute the SHA-256 hash of a file.
+ *
+ * @param filePath - Absolute path to the file.
+ * @returns The hex-encoded SHA-256 hash string.
+ */
+export declare const fileHash: (filePath: string) => string;
+/**
+ * Recursively copy a directory, throwing if any destination path is a symlink.
+ *
+ * Checks both the destination root and individual file paths for symlinks.
+ * The source is trusted installer content and not checked.
+ * Reads the source before creating the destination to avoid leaving empty
+ * directories on failure.
+ *
+ * @param src - Source directory path.
+ * @param dest - Destination directory path.
+ * @returns Nothing — throws on symlink or missing source.
+ */
+export declare const copyDir: (src: string, dest: string) => void;
+/**
+ * Inline workflow content into command markdown files.
+ *
+ * For global installs, @-file references resolve relative to the project root
+ * (not ~/.claude), so the workflow files won't be found at runtime. This
+ * replaces matching `@.claude/clancy/workflows/<name>.md` references with the
+ * actual workflow content. References to missing files are left unchanged.
+ * Handles multiple references per file.
+ *
+ * @param commandsDir - The installed commands directory.
+ * @param workflowsDir - The installed workflows directory.
+ * @returns Nothing — files are modified in place.
+ */
+export declare const inlineWorkflows: (commandsDir: string, workflowsDir: string) => void;
+//# sourceMappingURL=file-ops.d.ts.map

package/dist/installer/file-ops/file-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops.d.ts","sourceRoot":"","sources":["../../../src/installer/file-ops/file-ops.ts"],"names":[],"mappings":"AAqBA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU,MAAM,KAAG,MAI3C,CAAC;AAoBF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,KAAG,IAOnD,CAAC;AA6CF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,MAAM,EACnB,cAAc,MAAM,KACnB,IAMF,CAAC"}

package/dist/installer/file-ops/file-ops.js

@@ -0,0 +1,95 @@
+import { createHash } from 'node:crypto';
+import { copyFileSync, mkdirSync, readdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { hasErrorCode } from '../../installer/shared/fs-errors/index.js';
+import { rejectSymlink } from '../../installer/shared/fs-guards/index.js';
+/**
+ * Compute the SHA-256 hash of a file.
+ *
+ * @param filePath - Absolute path to the file.
+ * @returns The hex-encoded SHA-256 hash string.
+ */
+export const fileHash = (filePath) => {
+    const content = readFileSync(filePath);
+    return createHash('sha256').update(content).digest('hex');
+};
+/** Copy a single directory entry from src to dest, recursing into subdirectories. */
+const copyEntry = (src, dest) => (entry) => {
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+    if (entry.isDirectory()) {
+        copyDir(srcPath, destPath);
+        return;
+    }
+    if (!entry.isFile())
+        return; // Skip symlinks, FIFOs, sockets, etc.
+    rejectSymlink(destPath);
+    copyFileSync(srcPath, destPath);
+};
+/**
+ * Recursively copy a directory, throwing if any destination path is a symlink.
+ *
+ * Checks both the destination root and individual file paths for symlinks.
+ * The source is trusted installer content and not checked.
+ * Reads the source before creating the destination to avoid leaving empty
+ * directories on failure.
+ *
+ * @param src - Source directory path.
+ * @param dest - Destination directory path.
+ * @returns Nothing — throws on symlink or missing source.
+ */
+export const copyDir = (src, dest) => {
+    rejectSymlink(dest);
+    const entries = readdirSync(src, { withFileTypes: true });
+    mkdirSync(dest, { recursive: true });
+    entries.forEach(copyEntry(src, dest));
+};
+/** Matches `@.claude/clancy/workflows/<filename>.md` on its own line. Disallows path separators. */
+const WORKFLOW_REF = /^@\.claude\/clancy\/workflows\/([^/\\]+\.md)\r?$/gm;
+/** Resolve a workflow @-file reference to its content, or return the original if missing. */
+const resolveWorkflowRef = (workflowsDir, fullMatch, fileName) => {
+    const workflowFile = join(workflowsDir, fileName);
+    try {
+        rejectSymlink(workflowFile);
+        return readFileSync(workflowFile, 'utf8');
+    }
+    catch (error) {
+        if (hasErrorCode(error, 'ENOENT'))
+            return fullMatch;
+        throw error;
+    }
+};
+/** Inline workflow references in a single command file. */
+const inlineFileWorkflows = (commandsDir, workflowsDir) => (entry) => {
+    const isMarkdownFile = entry.isFile() && entry.name.endsWith('.md');
+    if (!isMarkdownFile)
+        return;
+    const cmdPath = join(commandsDir, entry.name);
+    const content = readFileSync(cmdPath, 'utf8');
+    const resolved = content.replace(WORKFLOW_REF, (match, fileName) => resolveWorkflowRef(workflowsDir, match, fileName));
+    const hasChanges = resolved !== content;
+    if (!hasChanges)
+        return;
+    rejectSymlink(cmdPath);
+    writeFileSync(cmdPath, resolved);
+};
+/**
+ * Inline workflow content into command markdown files.
+ *
+ * For global installs, @-file references resolve relative to the project root
+ * (not ~/.claude), so the workflow files won't be found at runtime. This
+ * replaces matching `@.claude/clancy/workflows/<name>.md` references with the
+ * actual workflow content. References to missing files are left unchanged.
+ * Handles multiple references per file.
+ *
+ * @param commandsDir - The installed commands directory.
+ * @param workflowsDir - The installed workflows directory.
+ * @returns Nothing — files are modified in place.
+ */
+export const inlineWorkflows = (commandsDir, workflowsDir) => {
+    rejectSymlink(commandsDir);
+    rejectSymlink(workflowsDir);
+    const entries = readdirSync(commandsDir, { withFileTypes: true });
+    entries.forEach(inlineFileWorkflows(commandsDir, workflowsDir));
+};
+//# sourceMappingURL=file-ops.js.map

package/dist/installer/file-ops/file-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ops.js","sourceRoot":"","sources":["../../../src/installer/file-ops/file-ops.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAU,EAAE;IACnD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEvC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC,CAAC;AAEF,qFAAqF;AACrF,MAAM,SAAS,GACb,CAAC,GAAW,EAAE,IAAY,EAAE,EAAE,CAC9B,CAAC,KAAa,EAAQ,EAAE;IACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAExC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,sCAAsC;IAEnE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACxB,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC,CAAC;AAEJ;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,IAAY,EAAQ,EAAE;IACzD,aAAa,CAAC,IAAI,CAAC,CAAC;IAEpB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1D,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,oGAAoG;AACpG,MAAM,YAAY,GAAG,oDAAoD,CAAC;AAE1E,6FAA6F;AAC7F,MAAM,kBAAkB,GAAG,CACzB,YAAoB,EACpB,SAAiB,EACjB,QAAgB,EACR,EAAE;IACV,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,aAAa,CAAC,YAAY,CAAC,CAAC;QAE5B,OAAO,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAEpD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF,2DAA2D;AAC3D,MAAM,mBAAmB,GACvB,CAAC,WAAmB,EAAE,YAAoB,EAAE,EAAE,CAC9C,CAAC,KAAa,EAAQ,EAAE;IACtB,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpE,IAAI,CAAC,cAAc;QAAE,OAAO;IAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,QAAgB,EAAE,EAAE,CACzE,kBAAkB,CAAC,YAAY,EAAE,KAAK,EAAE,QAAQ,CAAC,CAClD,CAAC;IACF,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,CAAC;IAExC,IAAI,CAAC,UAAU;QAAE,OAAO;IAExB,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC,CAAC;AAEJ;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,WAAmB,EACnB,YAAoB,EACd,EAAE;IACR,aAAa,CAAC,WAAW,CAAC,CAAC;IAC3B,aAAa,CAAC,YAAY,CAAC,CAAC;IAE5B,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC"}

package/dist/installer/file-ops/index.d.ts

@@ -0,0 +1,2 @@
+export { copyDir, inlineWorkflows } from './file-ops.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/installer/file-ops/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/installer/file-ops/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/installer/file-ops/index.js

@@ -0,0 +1,2 @@
+export { copyDir, inlineWorkflows } from './file-ops.js';
+//# sourceMappingURL=index.js.map

package/dist/installer/file-ops/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/installer/file-ops/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/installer/hook-installer/hook-installer.d.ts

@@ -0,0 +1,22 @@
+/** Options for the hook installer. */
+type HookInstallerOptions = {
+    readonly claudeConfigDir: string;
+    readonly hooksSourceDir: string;
+    readonly verificationGatePrompt?: string;
+};
+/** Compiled hook files Clancy ships. */
+export declare const HOOK_FILES: readonly ["clancy-check-update.js", "clancy-statusline.js", "clancy-context-monitor.js", "clancy-credential-guard.js", "clancy-branch-guard.js", "clancy-post-compact.js", "clancy-notification.js", "clancy-drift-detector.js"];
+/**
+ * Install Clancy hooks into the Claude config directory.
+ *
+ * Copies hook scripts, writes a CommonJS `package.json` to the hooks dir,
+ * and merges hook registrations into `settings.json`.
+ *
+ * Best-effort — never throws. Returns `false` if installation fails.
+ *
+ * @param options - The hook installer options.
+ * @returns `true` if hooks were installed successfully.
+ */
+export declare function installHooks(options: HookInstallerOptions): boolean;
+export {};
+//# sourceMappingURL=hook-installer.d.ts.map

package/dist/installer/hook-installer/hook-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-installer.d.ts","sourceRoot":"","sources":["../../../src/installer/hook-installer/hook-installer.ts"],"names":[],"mappings":"AA+BA,sCAAsC;AACtC,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,UAAU,kOASb,CAAC;AAmOX;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CA6BnE"}

package/dist/installer/hook-installer/hook-installer.js

@@ -0,0 +1,213 @@
+/**
+ * Hook installer for Claude Code settings.
+ *
+ * Copies compiled hook scripts into the Claude config directory and
+ * registers them in `settings.json` without clobbering existing config.
+ * All internal logic is immutable — settings are built as new objects,
+ * never mutated in place.
+ */
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { hasErrorCode } from '../../installer/shared/fs-errors/index.js';
+import { rejectSymlink } from '../../installer/shared/fs-guards/index.js';
+import { isPlainObject } from '../../installer/shared/type-guards/index.js';
+/** Compiled hook files Clancy ships. */
+export const HOOK_FILES = [
+    'clancy-check-update.js',
+    'clancy-statusline.js',
+    'clancy-context-monitor.js',
+    'clancy-credential-guard.js',
+    'clancy-branch-guard.js',
+    'clancy-post-compact.js',
+    'clancy-notification.js',
+    'clancy-drift-detector.js',
+];
+/** Build a `node "path"` command string for a hook file. */
+function buildNodeCommand(hooksDir, fileName) {
+    return `node ${JSON.stringify(join(hooksDir, fileName))}`;
+}
+/** Wrap a command string in a single-hook entry. */
+function commandEntry(command) {
+    return { hooks: [{ type: 'command', command }] };
+}
+/** Wrap an agent prompt in a single-hook entry. */
+function agentEntry(prompt, timeout) {
+    return { hooks: [{ type: 'agent', prompt, timeout }] };
+}
+/** Check whether a single hook matches a given command string. */
+function isCommandMatch(hook, command) {
+    return hook.type === 'command' && hook.command === command;
+}
+/** Check whether a single hook matches an agent prompt fingerprint. */
+function isAgentMatch(hook, fingerprint) {
+    const hasStringPrompt = hook.type === 'agent' && typeof hook.prompt === 'string';
+    return hasStringPrompt && hook.prompt.slice(0, 100) === fingerprint;
+}
+/** Flatten all hooks from a list of entries, filtering out non-object values. */
+function allHooks(entries) {
+    return entries
+        .flatMap((e) => e.hooks)
+        .filter((h) => isPlainObject(h));
+}
+/** Check whether an event's entries already contain a given command. */
+function hasCommand(entries, command) {
+    return allHooks(entries).some((h) => isCommandMatch(h, command));
+}
+/** Check whether an event's entries already contain a matching agent prompt. */
+function hasAgentPrompt(entries, prompt) {
+    const fingerprint = prompt.slice(0, 100);
+    return allHooks(entries).some((h) => isAgentMatch(h, fingerprint));
+}
+/**
+ * Build the desired hook registrations for a given hooks directory.
+ *
+ * Returns a pure data structure mapping event names to hook entries.
+ * No deduplication — that happens during merge.
+ *
+ * @param hooksDir - The installed hooks directory path.
+ * @param verificationGatePrompt - Optional agent prompt for the Stop hook.
+ * @returns A record of event names to their desired hook entries.
+ */
+function buildDesiredHooks(hooksDir, verificationGatePrompt) {
+    const cmd = (fileName) => buildNodeCommand(hooksDir, fileName);
+    const base = {
+        SessionStart: [commandEntry(cmd('clancy-check-update.js'))],
+        PostToolUse: [
+            commandEntry(cmd('clancy-context-monitor.js')),
+            commandEntry(cmd('clancy-drift-detector.js')),
+        ],
+        PreToolUse: [
+            commandEntry(cmd('clancy-credential-guard.js')),
+            commandEntry(cmd('clancy-branch-guard.js')),
+        ],
+        PostCompact: [commandEntry(cmd('clancy-post-compact.js'))],
+        Notification: [commandEntry(cmd('clancy-notification.js'))],
+    };
+    if (!verificationGatePrompt)
+        return base;
+    return { ...base, Stop: [agentEntry(verificationGatePrompt, 120)] };
+}
+/** Filter out desired entries that are already registered in existing. */
+function filterNewEntries(existing, desired) {
+    return desired.filter((entry) => {
+        if (entry.hooks.length === 0)
+            return false;
+        const hook = entry.hooks[0];
+        if (hook.type === 'command')
+            return !hasCommand(existing, hook.command);
+        return !hasAgentPrompt(existing, hook.prompt);
+    });
+}
+/** Merge desired entries into existing for a single event, deduplicating. */
+function mergeEventEntries(existing, desired) {
+    const newEntries = filterNewEntries(existing, desired);
+    return [...existing, ...newEntries];
+}
+/**
+ * Merge desired hook registrations into existing ones, deduplicating.
+ *
+ * @param existing - The current hook registrations from settings.json.
+ * @param desired - The hook registrations to add.
+ * @returns A new merged registrations record.
+ */
+function mergeHookRegistrations(existing, desired) {
+    const allEvents = [
+        ...new Set([...Object.keys(existing), ...Object.keys(desired)]),
+    ];
+    const entries = allEvents.map((event) => {
+        const merged = mergeEventEntries(existing[event] ?? [], desired[event] ?? []);
+        return [event, merged];
+    });
+    return Object.fromEntries(entries);
+}
+/** Check whether a value looks like a HookEntry ({ hooks: [...] }). */
+function isHookEntry(value) {
+    if (!isPlainObject(value))
+        return false;
+    const hooks = value.hooks;
+    return Array.isArray(hooks);
+}
+/** Safely extract a HookRegistrations record from raw settings.hooks. */
+function normalizeHooks(raw) {
+    if (!isPlainObject(raw))
+        return {};
+    const safeEntries = Object.entries(raw)
+        .filter(([, value]) => Array.isArray(value))
+        .map(([event, value]) => [event, value.filter(isHookEntry)]);
+    return Object.fromEntries(safeEntries);
+}
+/**
+ * Merge hook registrations and statusLine into existing settings immutably.
+ *
+ * @param settings - The current settings.json contents.
+ * @param desired - The desired hook registrations.
+ * @param statusLineCommand - The statusLine command string.
+ * @returns A new settings object with hooks and statusLine merged.
+ */
+function mergeSettings(settings, desired, statusLineCommand) {
+    const existingHooks = normalizeHooks(settings.hooks);
+    const mergedHooks = mergeHookRegistrations(existingHooks, desired);
+    const statusLine = { type: 'command', command: statusLineCommand };
+    return { ...settings, hooks: mergedHooks, statusLine };
+}
+/** Copy all hook files from source to the install directory. */
+function copyHookFiles(sourceDir, installDir) {
+    rejectSymlink(installDir);
+    mkdirSync(installDir, { recursive: true });
+    HOOK_FILES.forEach((f) => {
+        const dest = join(installDir, f);
+        rejectSymlink(dest);
+        copyFileSync(join(sourceDir, f), dest);
+    });
+}
+/** Write a CommonJS package.json so hooks resolve as CJS in ESM projects. */
+function writeCommonJsMarker(installDir) {
+    const packageJsonPath = join(installDir, 'package.json');
+    rejectSymlink(packageJsonPath);
+    writeFileSync(packageJsonPath, JSON.stringify({ type: 'commonjs' }, null, 2) + '\n');
+}
+/** Read and parse settings.json, returning empty on ENOENT or malformed JSON. */
+function readSettingsFile(settingsFile) {
+    try {
+        const parsed = JSON.parse(readFileSync(settingsFile, 'utf8'));
+        return isPlainObject(parsed) ? parsed : {};
+    }
+    catch (err) {
+        if (hasErrorCode(err, 'ENOENT') || err instanceof SyntaxError)
+            return {};
+        throw err;
+    }
+}
+/**
+ * Install Clancy hooks into the Claude config directory.
+ *
+ * Copies hook scripts, writes a CommonJS `package.json` to the hooks dir,
+ * and merges hook registrations into `settings.json`.
+ *
+ * Best-effort — never throws. Returns `false` if installation fails.
+ *
+ * @param options - The hook installer options.
+ * @returns `true` if hooks were installed successfully.
+ */
+export function installHooks(options) {
+    const { claudeConfigDir, hooksSourceDir } = options;
+    const hooksInstallDir = join(claudeConfigDir, 'hooks');
+    const settingsFile = join(claudeConfigDir, 'settings.json');
+    try {
+        copyHookFiles(hooksSourceDir, hooksInstallDir);
+        writeCommonJsMarker(hooksInstallDir);
+        rejectSymlink(settingsFile);
+        const existing = readSettingsFile(settingsFile);
+        const desired = buildDesiredHooks(hooksInstallDir, options.verificationGatePrompt);
+        const statusLineCmd = buildNodeCommand(hooksInstallDir, 'clancy-statusline.js');
+        const merged = mergeSettings(existing, desired, statusLineCmd);
+        writeFileSync(settingsFile, JSON.stringify(merged, null, 2) + '\n');
+        return true;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`  Hook install failed: ${message}`);
+        return false;
+    }
+}
+//# sourceMappingURL=hook-installer.js.map