safeword 0.1.0

package/dist/upgrade-DOKWRK7J.js

@@ -0,0 +1,146 @@
+import {
+  compareVersions
+} from "./chunk-W66Z3C5H.js";
+import {
+  AGENTS_MD_LINK,
+  HOOK_AGENTS_CHECK,
+  HOOK_POST_TOOL,
+  HOOK_PRE_COMMIT,
+  SAFEWORD_MD,
+  SETTINGS_HOOKS,
+  SKILL_QUALITY_REVIEWER
+} from "./chunk-DB4CMUFD.js";
+import {
+  VERSION
+} from "./chunk-WWQ4YRZN.js";
+import {
+  installGitHook,
+  isGitRepo
+} from "./chunk-24OB57NJ.js";
+import {
+  ensureDir,
+  error,
+  exists,
+  header,
+  info,
+  listItem,
+  makeExecutable,
+  readFile,
+  readFileSafe,
+  success,
+  updateJson,
+  writeFile
+} from "./chunk-UQMQ64CB.js";
+
+// src/commands/upgrade.ts
+import { join } from "path";
+async function upgrade() {
+  const cwd = process.cwd();
+  const safewordDir = join(cwd, ".safeword");
+  if (!exists(safewordDir)) {
+    error("Not configured. Run `safeword setup` first.");
+    process.exit(1);
+  }
+  const versionPath = join(safewordDir, "version");
+  const projectVersion = readFileSafe(versionPath)?.trim() ?? "0.0.0";
+  if (compareVersions(VERSION, projectVersion) < 0) {
+    error(`CLI v${VERSION} is older than project v${projectVersion}.`);
+    error("Update the CLI first: npm install -g safeword");
+    process.exit(1);
+  }
+  header("Safeword Upgrade");
+  info(`Upgrading from v${projectVersion} to v${VERSION}`);
+  const updated = [];
+  const unchanged = [];
+  try {
+    info("\nUpdating .safeword directory...");
+    ensureDir(join(safewordDir, "guides"));
+    ensureDir(join(safewordDir, "templates"));
+    ensureDir(join(safewordDir, "hooks"));
+    writeFile(join(safewordDir, "SAFEWORD.md"), SAFEWORD_MD);
+    writeFile(join(safewordDir, "version"), VERSION);
+    updated.push(".safeword/SAFEWORD.md");
+    updated.push(".safeword/version");
+    writeFile(join(safewordDir, "hooks", "agents-md-check.sh"), HOOK_AGENTS_CHECK);
+    writeFile(join(safewordDir, "hooks", "pre-commit.sh"), HOOK_PRE_COMMIT);
+    writeFile(join(safewordDir, "hooks", "post-tool.sh"), HOOK_POST_TOOL);
+    makeExecutable(join(safewordDir, "hooks", "agents-md-check.sh"));
+    makeExecutable(join(safewordDir, "hooks", "pre-commit.sh"));
+    makeExecutable(join(safewordDir, "hooks", "post-tool.sh"));
+    updated.push(".safeword/hooks/");
+    success("Updated .safeword directory");
+    info("\nVerifying AGENTS.md...");
+    const agentsMdPath = join(cwd, "AGENTS.md");
+    if (exists(agentsMdPath)) {
+      const content = readFile(agentsMdPath);
+      if (!content.includes("@./.safeword/SAFEWORD.md")) {
+        writeFile(agentsMdPath, `${AGENTS_MD_LINK}
+
+${content}`);
+        updated.push("AGENTS.md");
+        success("Restored link to AGENTS.md");
+      } else {
+        unchanged.push("AGENTS.md");
+        info("AGENTS.md link is present");
+      }
+    } else {
+      writeFile(agentsMdPath, `${AGENTS_MD_LINK}
+`);
+      updated.push("AGENTS.md");
+      success("Created AGENTS.md");
+    }
+    info("\nUpdating Claude Code hooks...");
+    const claudeDir = join(cwd, ".claude");
+    const settingsPath = join(claudeDir, "settings.json");
+    ensureDir(claudeDir);
+    updateJson(settingsPath, (existing) => {
+      const hooks = existing?.hooks ?? {};
+      for (const [event, newHooks] of Object.entries(SETTINGS_HOOKS)) {
+        const existingHooks = hooks[event] ?? [];
+        const nonSafewordHooks = existingHooks.filter(
+          (h) => typeof h === "object" && h !== null && "command" in h && typeof h.command === "string" && !h.command.includes(".safeword")
+        );
+        hooks[event] = [...nonSafewordHooks, ...newHooks];
+      }
+      return { ...existing, hooks };
+    });
+    updated.push(".claude/settings.json");
+    success("Updated hooks in .claude/settings.json");
+    info("\nUpdating skills...");
+    const skillsDir = join(claudeDir, "skills", "safeword-quality-reviewer");
+    ensureDir(skillsDir);
+    writeFile(join(skillsDir, "SKILL.md"), SKILL_QUALITY_REVIEWER);
+    updated.push(".claude/skills/safeword-quality-reviewer/");
+    success("Updated skills");
+    if (isGitRepo(cwd)) {
+      info("\nUpdating git hooks...");
+      installGitHook(cwd);
+      updated.push(".git/hooks/pre-commit");
+      success("Updated git pre-commit hook");
+    }
+    header("Upgrade Complete");
+    info(`
+Version: v${projectVersion} \u2192 v${VERSION}`);
+    if (updated.length > 0) {
+      info("\nUpdated:");
+      for (const file of updated) {
+        listItem(file);
+      }
+    }
+    if (unchanged.length > 0) {
+      info("\nUnchanged:");
+      for (const file of unchanged) {
+        listItem(file);
+      }
+    }
+    success(`
+Safeword upgraded to v${VERSION}`);
+  } catch (err) {
+    error(`Upgrade failed: ${err instanceof Error ? err.message : "Unknown error"}`);
+    process.exit(1);
+  }
+}
+export {
+  upgrade
+};
+//# sourceMappingURL=upgrade-DOKWRK7J.js.map

package/dist/upgrade-DOKWRK7J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/upgrade.ts"],"sourcesContent":["/**\n * Upgrade command - Update safeword configuration to latest version\n */\n\nimport { join } from 'node:path';\nimport { VERSION } from '../version.js';\nimport {\n  exists,\n  ensureDir,\n  writeFile,\n  readFile,\n  readFileSafe,\n  readJson,\n  updateJson,\n  makeExecutable,\n} from '../utils/fs.js';\nimport { info, success, warn, error, header, listItem } from '../utils/output.js';\nimport { isGitRepo, installGitHook } from '../utils/git.js';\nimport { compareVersions } from '../utils/version.js';\nimport {\n  SAFEWORD_MD,\n  AGENTS_MD_LINK,\n  HOOK_AGENTS_CHECK,\n  HOOK_PRE_COMMIT,\n  HOOK_POST_TOOL,\n  SETTINGS_HOOKS,\n  SKILL_QUALITY_REVIEWER,\n} from '../templates/index.js';\n\nexport async function upgrade(): Promise<void> {\n  const cwd = process.cwd();\n  const safewordDir = join(cwd, '.safeword');\n\n  // Check if configured\n  if (!exists(safewordDir)) {\n    error('Not configured. Run `safeword setup` first.');\n    process.exit(1);\n  }\n\n  // Read project version\n  const versionPath = join(safewordDir, 'version');\n  const projectVersion = readFileSafe(versionPath)?.trim() ?? '0.0.0';\n\n  // Check for downgrade\n  if (compareVersions(VERSION, projectVersion) < 0) {\n    error(`CLI v${VERSION} is older than project v${projectVersion}.`);\n    error('Update the CLI first: npm install -g safeword');\n    process.exit(1);\n  }\n\n  header('Safeword Upgrade');\n  info(`Upgrading from v${projectVersion} to v${VERSION}`);\n\n  const updated: string[] = [];\n  const unchanged: string[] = [];\n\n  try {\n    // 1. Update .safeword directory\n    info('\\nUpdating .safeword directory...');\n\n    ensureDir(join(safewordDir, 'guides'));\n    ensureDir(join(safewordDir, 'templates'));\n    ensureDir(join(safewordDir, 'hooks'));\n\n    // Update core files\n    writeFile(join(safewordDir, 'SAFEWORD.md'), SAFEWORD_MD);\n    writeFile(join(safewordDir, 'version'), VERSION);\n    updated.push('.safeword/SAFEWORD.md');\n    updated.push('.safeword/version');\n\n    // Update hook scripts\n    writeFile(join(safewordDir, 'hooks', 'agents-md-check.sh'), HOOK_AGENTS_CHECK);\n    writeFile(join(safewordDir, 'hooks', 'pre-commit.sh'), HOOK_PRE_COMMIT);\n    writeFile(join(safewordDir, 'hooks', 'post-tool.sh'), HOOK_POST_TOOL);\n\n    makeExecutable(join(safewordDir, 'hooks', 'agents-md-check.sh'));\n    makeExecutable(join(safewordDir, 'hooks', 'pre-commit.sh'));\n    makeExecutable(join(safewordDir, 'hooks', 'post-tool.sh'));\n\n    updated.push('.safeword/hooks/');\n    success('Updated .safeword directory');\n\n    // 2. Verify AGENTS.md link\n    info('\\nVerifying AGENTS.md...');\n    const agentsMdPath = join(cwd, 'AGENTS.md');\n\n    if (exists(agentsMdPath)) {\n      const content = readFile(agentsMdPath);\n      if (!content.includes('@./.safeword/SAFEWORD.md')) {\n        writeFile(agentsMdPath, `${AGENTS_MD_LINK}\\n\\n${content}`);\n        updated.push('AGENTS.md');\n        success('Restored link to AGENTS.md');\n      } else {\n        unchanged.push('AGENTS.md');\n        info('AGENTS.md link is present');\n      }\n    } else {\n      writeFile(agentsMdPath, `${AGENTS_MD_LINK}\\n`);\n      updated.push('AGENTS.md');\n      success('Created AGENTS.md');\n    }\n\n    // 3. Update Claude Code hooks\n    info('\\nUpdating Claude Code hooks...');\n\n    const claudeDir = join(cwd, '.claude');\n    const settingsPath = join(claudeDir, 'settings.json');\n\n    ensureDir(claudeDir);\n\n    updateJson<{ hooks?: Record<string, unknown[]> }>(settingsPath, existing => {\n      const hooks = existing?.hooks ?? {};\n\n      // Merge hooks, preserving non-safeword hooks\n      for (const [event, newHooks] of Object.entries(SETTINGS_HOOKS)) {\n        const existingHooks = (hooks[event] as unknown[]) ?? [];\n\n        // Filter out existing safeword hooks\n        const nonSafewordHooks = existingHooks.filter(\n          (h: unknown) =>\n            typeof h === 'object' &&\n            h !== null &&\n            'command' in h &&\n            typeof (h as { command: string }).command === 'string' &&\n            !(h as { command: string }).command.includes('.safeword'),\n        );\n\n        // Add safeword hooks\n        hooks[event] = [...nonSafewordHooks, ...newHooks];\n      }\n\n      return { ...existing, hooks };\n    });\n\n    updated.push('.claude/settings.json');\n    success('Updated hooks in .claude/settings.json');\n\n    // 4. Update skills\n    info('\\nUpdating skills...');\n\n    const skillsDir = join(claudeDir, 'skills', 'safeword-quality-reviewer');\n    ensureDir(skillsDir);\n    writeFile(join(skillsDir, 'SKILL.md'), SKILL_QUALITY_REVIEWER);\n\n    updated.push('.claude/skills/safeword-quality-reviewer/');\n    success('Updated skills');\n\n    // 5. Update git hooks if repo exists\n    if (isGitRepo(cwd)) {\n      info('\\nUpdating git hooks...');\n      installGitHook(cwd);\n      updated.push('.git/hooks/pre-commit');\n      success('Updated git pre-commit hook');\n    }\n\n    // Print summary\n    header('Upgrade Complete');\n\n    info(`\\nVersion: v${projectVersion} → v${VERSION}`);\n\n    if (updated.length > 0) {\n      info('\\nUpdated:');\n      for (const file of updated) {\n        listItem(file);\n      }\n    }\n\n    if (unchanged.length > 0) {\n      info('\\nUnchanged:');\n      for (const file of unchanged) {\n        listItem(file);\n      }\n    }\n\n    success(`\\nSafeword upgraded to v${VERSION}`);\n  } catch (err) {\n    error(`Upgrade failed: ${err instanceof Error ? err.message : 'Unknown error'}`);\n    process.exit(1);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,SAAS,YAAY;AAyBrB,eAAsB,UAAyB;AAC7C,QAAM,MAAM,QAAQ,IAAI;AACxB,QAAM,cAAc,KAAK,KAAK,WAAW;AAGzC,MAAI,CAAC,OAAO,WAAW,GAAG;AACxB,UAAM,6CAA6C;AACnD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,cAAc,KAAK,aAAa,SAAS;AAC/C,QAAM,iBAAiB,aAAa,WAAW,GAAG,KAAK,KAAK;AAG5D,MAAI,gBAAgB,SAAS,cAAc,IAAI,GAAG;AAChD,UAAM,QAAQ,OAAO,2BAA2B,cAAc,GAAG;AACjE,UAAM,+CAA+C;AACrD,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,SAAO,kBAAkB;AACzB,OAAK,mBAAmB,cAAc,QAAQ,OAAO,EAAE;AAEvD,QAAM,UAAoB,CAAC;AAC3B,QAAM,YAAsB,CAAC;AAE7B,MAAI;AAEF,SAAK,mCAAmC;AAExC,cAAU,KAAK,aAAa,QAAQ,CAAC;AACrC,cAAU,KAAK,aAAa,WAAW,CAAC;AACxC,cAAU,KAAK,aAAa,OAAO,CAAC;AAGpC,cAAU,KAAK,aAAa,aAAa,GAAG,WAAW;AACvD,cAAU,KAAK,aAAa,SAAS,GAAG,OAAO;AAC/C,YAAQ,KAAK,uBAAuB;AACpC,YAAQ,KAAK,mBAAmB;AAGhC,cAAU,KAAK,aAAa,SAAS,oBAAoB,GAAG,iBAAiB;AAC7E,cAAU,KAAK,aAAa,SAAS,eAAe,GAAG,eAAe;AACtE,cAAU,KAAK,aAAa,SAAS,cAAc,GAAG,cAAc;AAEpE,mBAAe,KAAK,aAAa,SAAS,oBAAoB,CAAC;AAC/D,mBAAe,KAAK,aAAa,SAAS,eAAe,CAAC;AAC1D,mBAAe,KAAK,aAAa,SAAS,cAAc,CAAC;AAEzD,YAAQ,KAAK,kBAAkB;AAC/B,YAAQ,6BAA6B;AAGrC,SAAK,0BAA0B;AAC/B,UAAM,eAAe,KAAK,KAAK,WAAW;AAE1C,QAAI,OAAO,YAAY,GAAG;AACxB,YAAM,UAAU,SAAS,YAAY;AACrC,UAAI,CAAC,QAAQ,SAAS,0BAA0B,GAAG;AACjD,kBAAU,cAAc,GAAG,cAAc;AAAA;AAAA,EAAO,OAAO,EAAE;AACzD,gBAAQ,KAAK,WAAW;AACxB,gBAAQ,4BAA4B;AAAA,MACtC,OAAO;AACL,kBAAU,KAAK,WAAW;AAC1B,aAAK,2BAA2B;AAAA,MAClC;AAAA,IACF,OAAO;AACL,gBAAU,cAAc,GAAG,cAAc;AAAA,CAAI;AAC7C,cAAQ,KAAK,WAAW;AACxB,cAAQ,mBAAmB;AAAA,IAC7B;AAGA,SAAK,iCAAiC;AAEtC,UAAM,YAAY,KAAK,KAAK,SAAS;AACrC,UAAM,eAAe,KAAK,WAAW,eAAe;AAEpD,cAAU,SAAS;AAEnB,eAAkD,cAAc,cAAY;AAC1E,YAAM,QAAQ,UAAU,SAAS,CAAC;AAGlC,iBAAW,CAAC,OAAO,QAAQ,KAAK,OAAO,QAAQ,cAAc,GAAG;AAC9D,cAAM,gBAAiB,MAAM,KAAK,KAAmB,CAAC;AAGtD,cAAM,mBAAmB,cAAc;AAAA,UACrC,CAAC,MACC,OAAO,MAAM,YACb,MAAM,QACN,aAAa,KACb,OAAQ,EAA0B,YAAY,YAC9C,CAAE,EAA0B,QAAQ,SAAS,WAAW;AAAA,QAC5D;AAGA,cAAM,KAAK,IAAI,CAAC,GAAG,kBAAkB,GAAG,QAAQ;AAAA,MAClD;AAEA,aAAO,EAAE,GAAG,UAAU,MAAM;AAAA,IAC9B,CAAC;AAED,YAAQ,KAAK,uBAAuB;AACpC,YAAQ,wCAAwC;AAGhD,SAAK,sBAAsB;AAE3B,UAAM,YAAY,KAAK,WAAW,UAAU,2BAA2B;AACvE,cAAU,SAAS;AACnB,cAAU,KAAK,WAAW,UAAU,GAAG,sBAAsB;AAE7D,YAAQ,KAAK,2CAA2C;AACxD,YAAQ,gBAAgB;AAGxB,QAAI,UAAU,GAAG,GAAG;AAClB,WAAK,yBAAyB;AAC9B,qBAAe,GAAG;AAClB,cAAQ,KAAK,uBAAuB;AACpC,cAAQ,6BAA6B;AAAA,IACvC;AAGA,WAAO,kBAAkB;AAEzB,SAAK;AAAA,YAAe,cAAc,YAAO,OAAO,EAAE;AAElD,QAAI,QAAQ,SAAS,GAAG;AACtB,WAAK,YAAY;AACjB,iBAAW,QAAQ,SAAS;AAC1B,iBAAS,IAAI;AAAA,MACf;AAAA,IACF;AAEA,QAAI,UAAU,SAAS,GAAG;AACxB,WAAK,cAAc;AACnB,iBAAW,QAAQ,WAAW;AAC5B,iBAAS,IAAI;AAAA,MACf;AAAA,IACF;AAEA,YAAQ;AAAA,wBAA2B,OAAO,EAAE;AAAA,EAC9C,SAAS,KAAK;AACZ,UAAM,mBAAmB,eAAe,QAAQ,IAAI,UAAU,eAAe,EAAE;AAC/E,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "safeword",
+  "version": "0.1.0",
+  "description": "CLI for setting up and managing safeword development environments",
+  "type": "module",
+  "bin": {
+    "safeword": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src tests",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.0.0"
+  },
+  "keywords": [
+    "cli",
+    "safeword",
+    "developer-experience",
+    "linting",
+    "claude-code"
+  ],
+  "author": "",
+  "license": "MIT"
+}

package/templates/doc-templates/ticket-template.md

@@ -0,0 +1,82 @@
+---
+id: XXX
+status: in_progress
+created: YYYY-MM-DDTHH:MM:SSZ
+last_modified: YYYY-MM-DDTHH:MM:SSZ
+---
+
+# Title
+
+**Goal:** {One sentence: what are we trying to achieve?}
+
+**Why:** {One sentence: why does this matter?}
+
+## Work Log
+
+**Purpose:** Track what you've tried so you don't repeat dead ends or lose context.
+
+**CRITICAL: Re-read this ticket before each significant action to stay on track.**
+
+**Log immediately after:**
+
+- Starting work
+- Completing a step
+- Trying an approach (document result: success or failure)
+- Discovering a blocker, tradeoff, or decision point
+- Writing a test (RED) or making it pass (GREEN)
+- Committing code
+
+**Format:** `YYYY-MM-DDTHH:MM:SSZ Action: Description (refs: commit/file/PR)`
+
+**Examples:**
+
+```
+- 2025-11-24T18:50:00Z Started: Changing button background to red
+- 2025-11-24T18:51:30Z Tried: Added `background: red` to Button.css
+- 2025-11-24T18:52:00Z Found: Button now has white text on red (unreadable)
+- 2025-11-24T18:53:00Z Tried: Changed text color to white
+- 2025-11-24T18:54:15Z Found: Hover state still blue (conflicts)
+- 2025-11-24T18:55:00Z Complete: Updated all button states to red theme (refs: commit 9a3f2c1)
+```
+
+---
+
+{Keep work log in reverse-chronological order. Newest entries at top.}
+{Re-read before each action. Check what you've tried. Stay aligned with Goal.}
+
+---
+
+## Optional Sections (Add When Needed)
+
+### Planning Docs
+
+{Only for complex features that need user stories, test definitions, design docs}
+
+- .safeword/planning/user-stories/XXX-feature-name.md
+- .safeword/planning/test-definitions/XXX-feature-name.md
+- .safeword/planning/design/XXX-feature-name.md
+
+### Scope
+
+{Only for complex features with unclear boundaries}
+
+**In scope:**
+
+-
+
+**Out of scope:**
+
+-
+
+### Acceptance Criteria
+
+{Only for features or complex bugs where "done" isn't obvious}
+
+- [ ]
+- [ ]
+
+### Root Cause
+
+{Only for bugs that required investigation}
+
+{What caused this issue? Document for future reference.}

package/templates/hooks/inject-timestamp.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+# Inject Timestamp - Notification Hook
+# Outputs current Unix timestamp at session start for Claude's context awareness
+# Helps with accurate ticket timestamps and time-based reasoning
+
+echo "Current time: $(date +%s) ($(date -u +%Y-%m-%dT%H:%M:%SZ))"
+