tap-the-sign 0.2.0 → 0.2.2

package/README.md

@@ -1,3 +1,5 @@
+<img width="500" height="740" alt="tapthesign 2" src="https://github.com/user-attachments/assets/c938c158-d1b4-4cc2-90b5-05bdd5fc7db5" />
+
 # Tap the Sign
 
 Auto **thermo sign-off** on your plan before you build.
@@ -30,7 +32,7 @@ On Pass 3: Thermo-nuclear subagent on final diff; zero HIGH/MID.
 
 3. After the plan is updated with the pre-flight section, the hook stops (no infinite loop).
 
-If the thermo skill is missing, planning still works; the auto follow-up is **skipped** with a warning in the Hooks output channel.
+If the thermo skill is missing, planning still works; the hook auto-sends a **chat follow-up** with install instructions (also logged to the Hooks output channel).
 
 ## Quick start
 
@@ -39,72 +41,53 @@ npx tap-the-sign install && npx tap-the-sign install-thermo && npx tap-the-sign
 npx tap-the-sign doctor
 ```
 
-**Bun:**
-
-```bash
-bunx tap-the-sign install && bunx tap-the-sign install-thermo && bunx tap-the-sign on
-```
-
 Use Plan mode in Cursor, Claude Code, or Codex.
 
-## Install paths
-
-### 1. npm / npx
+## Install
 
 ```bash
-npx tap-the-sign install              # all IDEs, project-local
+npx tap-the-sign install              # all IDEs, project-local (default)
 npx tap-the-sign install --global     # user-global (~/.cursor, ~/.claude, ~/.codex)
-npx tap-the-sign install-thermo       # skill only (recommended)
+npx tap-the-sign install-thermo       # thermo skill only (recommended)
 npx tap-the-sign install --no-codex   # subset of IDEs
 ```
 
-### 2. Bun / bunx
+From a git clone:
 
 ```bash
-bunx tap-the-sign install
-bunx tap-the-sign install-thermo
-bunx tap-the-sign on
+git clone https://github.com/john-prem/tap-the-sign.git
+cd tap-the-sign
+./install.sh
+npx tap-the-sign install-thermo && npx tap-the-sign on
 ```
 
-From a repo clone:
+Or one-liner:
 
 ```bash
-git clone https://github.com/your-org/tap-the-sign.git
-cd tap-the-sign
-./install.bun.sh
-bun src/cli.mjs install-thermo && bun src/cli.mjs on
+curl -fsSL https://raw.githubusercontent.com/john-prem/tap-the-sign/main/install.sh | bash
+npx tap-the-sign install-thermo && npx tap-the-sign on
 ```
 
-Hook scripts prefer **Bun** at runtime when `bun` is on `PATH`, otherwise Node 18+.
+Requires **Node.js 18+**.
 
-### 3. Git plugin (IDE-native)
+### Git plugin (IDE-native)
 
 | IDE | Install |
 |-----|---------|
-| **Cursor** | `/add-plugin your-org/tap-the-sign` |
+| **Cursor** | `/add-plugin john-prem/tap-the-sign` |
 | **Claude Code** | `/plugin marketplace add …` then `/plugin install tap-the-sign@…` |
 | **Codex** | Install plugin; trust hooks via `/hooks` |
 
-Then run `tap-the-sign on` (or `/tap-the-sign-on` in Cursor). Plugins ship wiring, not default-on.
-
-**Thermo skill:** `tap-the-sign install-thermo` or `/add-plugin cursor-team-kit` (full plugin + subagent for Pass 3).
-
-### 4. curl / install.sh
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/your-org/tap-the-sign/main/install.sh | bash
-# then:
-npx tap-the-sign install-thermo && npx tap-the-sign on
-```
+Then run `npx tap-the-sign on` (or `/tap-the-sign-on` in Cursor). Plugins ship wiring, not default-on.
 
-Or clone and run `./install.sh` (uses Bun if installed, else Node).
+**Thermo skill:** `npx tap-the-sign install-thermo` or `/add-plugin cursor-team-kit` (full plugin + subagent for Pass 3).
 
 ## Thermo skill
 
 **Recommended (skill only):**
 
 ```bash
-tap-the-sign install-thermo
+npx tap-the-sign install-thermo
 # equivalent:
 npx skills add cursor/plugins --skill thermo-nuclear-code-quality-review \
   -a cursor -a claude-code -a codex --copy -y
@@ -122,12 +105,12 @@ npx skills add cursor/plugins --skill thermo-nuclear-code-quality-review \
 
 | Command | Action |
 |---------|--------|
-| `tap-the-sign on` | Enable hook |
-| `tap-the-sign off` | Disable hook |
-| `tap-the-sign status` | Show hook + skill status |
-| `tap-the-sign doctor` | Fail if thermo skill missing |
-| `tap-the-sign doctor --fix` | Run `install-thermo` if skill missing |
-| `tap-the-sign install-thermo` | Install thermo skill via `npx skills add` |
+| `npx tap-the-sign on` | Enable hook |
+| `npx tap-the-sign off` | Disable hook |
+| `npx tap-the-sign status` | Show hook + skill status |
+| `npx tap-the-sign doctor` | Fail if thermo skill missing |
+| `npx tap-the-sign doctor --fix` | Run `install-thermo` if skill missing |
+| `npx tap-the-sign install-thermo` | Install thermo skill via `npx skills add` |
 
 **Cursor slash commands:** `/tap-the-sign-on`, `/tap-the-sign-off`, `/tap-the-sign-status`
 
@@ -150,7 +133,7 @@ See [docs/REQUIREMENTS.md](docs/REQUIREMENTS.md).
 ## Uninstall
 
 ```bash
-tap-the-sign uninstall
+npx tap-the-sign uninstall
 ```
 
 Also removes legacy `plan-sandwich` hook entries if present.

package/docs/REQUIREMENTS.md

@@ -49,7 +49,7 @@ tap-the-sign doctor
 | Step | Behavior |
 |------|----------|
 | Plan mode submit | Allowed — hook arms normally |
-| Post-plan follow-up | **Skipped** — warning on stderr / systemMessage |
+| Post-plan follow-up | **Skipped** — warning follow-up in chat + Hooks output |
 | `tap-the-sign doctor` | Exits non-zero with install instructions |
 | `tap-the-sign doctor --fix` | Attempts `install-thermo` |
 

package/hooks-bin/constants.mjs

@@ -28,6 +28,5 @@ Be careful to not introduce any blocker higher than LOW and checking three times
 On Pass 3: Thermo-nuclear subagent on final diff; zero HIGH/MID.`;
 
 export const SKILL_MISSING_WARNING =
-  'tap-the-sign: thermo-nuclear-code-quality-review skill not found. ' +
-  'Run: tap-the-sign install-thermo (or /add-plugin cursor-team-kit). ' +
-  'Skipping auto pre-flight follow-up.';
+  'tap-the-sign: thermo skill not found. Run: npx tap-the-sign install-thermo ' +
+  '(or /add-plugin cursor-team-kit). Thermo pre-flight was skipped.';

package/hooks-bin/run-hook.mjs

@@ -79,12 +79,9 @@ function respondFollowUp(host, message) {
   });
 }
 
-function respondWarning(host, warning) {
+function respondSkillMissing(host, warning) {
   console.error(warning);
-  if (host === 'cursor') {
-    return respondEmpty();
-  }
-  return JSON.stringify({ systemMessage: warning });
+  return respondFollowUp(host, warning);
 }
 
 export async function runHook({ event, host }) {
@@ -134,7 +131,7 @@ export async function runHook({ event, host }) {
     if (phase === PHASE_PLANNING) {
       if (!isThermoSkillInstalled()) {
         transitionPhase(sessionId, PHASE_DONE);
-        process.stdout.write(respondWarning(host, SKILL_MISSING_WARNING));
+        process.stdout.write(respondSkillMissing(host, SKILL_MISSING_WARNING));
         return;
       }
       transitionPhase(sessionId, PHASE_PREFLIGHT);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tap-the-sign",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Auto thermo sign-off after Plan mode plans. Requires thermo-nuclear-code-quality-review skill.",
   "type": "module",
   "bin": {
@@ -33,11 +33,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/your-org/tap-the-sign.git"
+    "url": "git+https://github.com/john-prem/tap-the-sign.git"
   },
-  "homepage": "https://github.com/your-org/tap-the-sign#readme",
+  "homepage": "https://github.com/john-prem/tap-the-sign#readme",
   "bugs": {
-    "url": "https://github.com/your-org/tap-the-sign/issues"
+    "url": "https://github.com/john-prem/tap-the-sign/issues"
   },
   "license": "MIT",
   "keywords": [

package/src/constants.mjs

@@ -28,6 +28,5 @@ Be careful to not introduce any blocker higher than LOW and checking three times
 On Pass 3: Thermo-nuclear subagent on final diff; zero HIGH/MID.`;
 
 export const SKILL_MISSING_WARNING =
-  'tap-the-sign: thermo-nuclear-code-quality-review skill not found. ' +
-  'Run: tap-the-sign install-thermo (or /add-plugin cursor-team-kit). ' +
-  'Skipping auto pre-flight follow-up.';
+  'tap-the-sign: thermo skill not found. Run: npx tap-the-sign install-thermo ' +
+  '(or /add-plugin cursor-team-kit). Thermo pre-flight was skipped.';

package/src/hooks/runner.mjs

@@ -79,12 +79,9 @@ function respondFollowUp(host, message) {
   });
 }
 
-function respondWarning(host, warning) {
+function respondSkillMissing(host, warning) {
   console.error(warning);
-  if (host === 'cursor') {
-    return respondEmpty();
-  }
-  return JSON.stringify({ systemMessage: warning });
+  return respondFollowUp(host, warning);
 }
 
 export async function runHook({ event, host }) {
@@ -134,7 +131,7 @@ export async function runHook({ event, host }) {
     if (phase === PHASE_PLANNING) {
       if (!isThermoSkillInstalled()) {
         transitionPhase(sessionId, PHASE_DONE);
-        process.stdout.write(respondWarning(host, SKILL_MISSING_WARNING));
+        process.stdout.write(respondSkillMissing(host, SKILL_MISSING_WARNING));
         return;
       }
       transitionPhase(sessionId, PHASE_PREFLIGHT);