@soleri/cli 1.0.4 → 1.2.0

package/src/hook-packs/css-discipline/hookify.no-important.local.md

@@ -0,0 +1,17 @@
+---
+# Soleri Hook Pack: css-discipline
+# Rule: no-important
+name: no-important
+enabled: true
+event: file
+action: block
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: \.(tsx?|jsx?|css)$
+  - field: content
+    operator: regex_match
+    pattern: "!important"
+---
+
+🚫 **!important blocked.** Fix specificity instead. Use Tailwind `!` prefix (`!text-error`) only if needed.

package/src/hook-packs/css-discipline/hookify.no-inline-styles.local.md

@@ -0,0 +1,20 @@
+---
+# Soleri Hook Pack: css-discipline
+# Rule: no-inline-styles
+name: no-inline-styles
+enabled: true
+event: file
+action: warn
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: src/components/.*\.tsx$
+  - field: file_path
+    operator: not_contains
+    pattern: .stories.tsx
+  - field: content
+    operator: regex_match
+    pattern: style=\{\{[^}]*(padding|margin|width|height|fontSize|color|background)[^}]*\}\}
+---
+
+⚠️ **Inline style detected.** Use Tailwind: `p-4` not `style={{ padding: '16px' }}`. Exception: CSS variables.

package/src/hook-packs/css-discipline/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "css-discipline",
+  "description": "CSS best practices",
+  "hooks": ["no-important", "no-inline-styles"]
+}

package/src/hook-packs/full/manifest.json

@@ -0,0 +1,6 @@
+{
+  "name": "full",
+  "description": "Complete quality suite — all 8 hooks",
+  "hooks": ["no-any-types", "no-console-log", "no-important", "no-inline-styles", "semantic-html", "focus-ring-required", "ux-touch-targets", "no-ai-attribution"],
+  "composedFrom": ["typescript-safety", "a11y", "css-discipline", "clean-commits"]
+}

package/src/hook-packs/installer.ts

@@ -0,0 +1,113 @@
+/**
+ * Hook pack installer — copies hookify files to ~/.claude/ for global enforcement.
+ */
+import { existsSync, copyFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { getPack } from './registry.js';
+
+/**
+ * Resolve all hookify file paths for a pack, handling composed packs.
+ * Returns a map of hook name → source file path.
+ */
+function resolveHookFiles(packName: string): Map<string, string> {
+  const pack = getPack(packName);
+  if (!pack) return new Map();
+
+  const files = new Map<string, string>();
+
+  if (pack.manifest.composedFrom) {
+    // Composed pack: gather files from constituent packs
+    for (const subPackName of pack.manifest.composedFrom) {
+      const subFiles = resolveHookFiles(subPackName);
+      for (const [hook, path] of subFiles) {
+        files.set(hook, path);
+      }
+    }
+  } else {
+    // Direct pack: look for hookify files in the pack directory
+    for (const hook of pack.manifest.hooks) {
+      const filePath = join(pack.dir, `hookify.${hook}.local.md`);
+      if (existsSync(filePath)) {
+        files.set(hook, filePath);
+      }
+    }
+  }
+
+  return files;
+}
+
+/**
+ * Install a hook pack globally to ~/.claude/.
+ * Skips files that already exist (idempotent).
+ */
+export function installPack(packName: string): { installed: string[]; skipped: string[] } {
+  const pack = getPack(packName);
+  if (!pack) {
+    throw new Error(`Unknown hook pack: "${packName}"`);
+  }
+
+  const claudeDir = join(homedir(), '.claude');
+  mkdirSync(claudeDir, { recursive: true });
+
+  const hookFiles = resolveHookFiles(packName);
+  const installed: string[] = [];
+  const skipped: string[] = [];
+
+  for (const [hook, sourcePath] of hookFiles) {
+    const destPath = join(claudeDir, `hookify.${hook}.local.md`);
+    if (existsSync(destPath)) {
+      skipped.push(hook);
+    } else {
+      copyFileSync(sourcePath, destPath);
+      installed.push(hook);
+    }
+  }
+
+  return { installed, skipped };
+}
+
+/**
+ * Remove a hook pack's files from ~/.claude/.
+ */
+export function removePack(packName: string): { removed: string[] } {
+  const pack = getPack(packName);
+  if (!pack) {
+    throw new Error(`Unknown hook pack: "${packName}"`);
+  }
+
+  const claudeDir = join(homedir(), '.claude');
+  const removed: string[] = [];
+
+  for (const hook of pack.manifest.hooks) {
+    const filePath = join(claudeDir, `hookify.${hook}.local.md`);
+    if (existsSync(filePath)) {
+      unlinkSync(filePath);
+      removed.push(hook);
+    }
+  }
+
+  return { removed };
+}
+
+/**
+ * Check if a pack is installed.
+ * Returns true (all hooks present), false (none present), or 'partial'.
+ */
+export function isPackInstalled(packName: string): boolean | 'partial' {
+  const pack = getPack(packName);
+  if (!pack) return false;
+
+  const claudeDir = join(homedir(), '.claude');
+  let present = 0;
+
+  for (const hook of pack.manifest.hooks) {
+    if (existsSync(join(claudeDir, `hookify.${hook}.local.md`))) {
+      present++;
+    }
+  }
+
+  if (present === 0) return false;
+  if (present === pack.manifest.hooks.length) return true;
+  return 'partial';
+}

package/src/hook-packs/registry.ts

@@ -0,0 +1,84 @@
+/**
+ * Hook pack registry — discovers built-in packs and checks installation status.
+ */
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
+
+export interface HookPackManifest {
+  name: string;
+  description: string;
+  hooks: string[];
+  composedFrom?: string[];
+}
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/** Root directory containing all built-in hook packs. */
+function getPacksRoot(): string {
+  return __dirname;
+}
+
+/**
+ * List all available built-in hook packs.
+ */
+export function listPacks(): HookPackManifest[] {
+  const root = getPacksRoot();
+  const entries = readdirSync(root, { withFileTypes: true });
+  const packs: HookPackManifest[] = [];
+
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    const manifestPath = join(root, entry.name, 'manifest.json');
+    if (!existsSync(manifestPath)) continue;
+
+    try {
+      const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as HookPackManifest;
+      packs.push(manifest);
+    } catch {
+      // Skip malformed manifests
+    }
+  }
+
+  return packs;
+}
+
+/**
+ * Get a specific pack by name.
+ */
+export function getPack(name: string): { manifest: HookPackManifest; dir: string } | null {
+  const root = getPacksRoot();
+  const dir = join(root, name);
+  const manifestPath = join(dir, 'manifest.json');
+
+  if (!existsSync(manifestPath)) return null;
+
+  try {
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as HookPackManifest;
+    return { manifest, dir };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Get names of packs that are fully installed in ~/.claude/.
+ */
+export function getInstalledPacks(): string[] {
+  const claudeDir = join(homedir(), '.claude');
+  const packs = listPacks();
+  const installed: string[] = [];
+
+  for (const pack of packs) {
+    const allPresent = pack.hooks.every((hook) =>
+      existsSync(join(claudeDir, `hookify.${hook}.local.md`)),
+    );
+    if (allPresent) {
+      installed.push(pack.name);
+    }
+  }
+
+  return installed;
+}

package/src/hook-packs/typescript-safety/hookify.no-any-types.local.md

@@ -0,0 +1,17 @@
+---
+# Soleri Hook Pack: typescript-safety
+# Rule: no-any-types
+name: no-any-types
+enabled: true
+event: file
+action: block
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: \.(tsx?|jsx?)$
+  - field: content
+    operator: regex_match
+    pattern: (:\s*any(?![a-zA-Z])|as\s+any(?![a-zA-Z])|<any>|Record<string,\s*any>)
+---
+
+🚫 **Type bypass blocked.** Replace `:any` with specific type or `unknown`. Fix `as any` at the source.

package/src/hook-packs/typescript-safety/hookify.no-console-log.local.md

@@ -0,0 +1,20 @@
+---
+# Soleri Hook Pack: typescript-safety
+# Rule: no-console-log
+name: no-console-log
+enabled: true
+event: file
+action: warn
+conditions:
+  - field: file_path
+    operator: regex_match
+    pattern: src/.*\.(tsx?|jsx?)$
+  - field: file_path
+    operator: not_regex_match
+    pattern: (\.test\.|\.spec\.|\.stories\.)
+  - field: content
+    operator: regex_match
+    pattern: console\.(log|debug|info)\(
+---
+
+⚠️ **Debug code detected.** Remove `console.log/debug/info` before commit. `console.error/warn` allowed.

package/src/hook-packs/typescript-safety/manifest.json

@@ -0,0 +1,5 @@
+{
+  "name": "typescript-safety",
+  "description": "Block unsafe TypeScript patterns",
+  "hooks": ["no-any-types", "no-console-log"]
+}