@soleri/cli 1.1.0 → 1.3.0

package/dist/hook-packs/registry.js

@@ -8,14 +8,17 @@ import { homedir } from 'node:os';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /** Root directory containing all built-in hook packs. */
-function getPacksRoot() {
+function getBuiltinRoot() {
     return __dirname;
 }
-/**
- * List all available built-in hook packs.
- */
-export function listPacks() {
-    const root = getPacksRoot();
+/** Local custom packs directory. */
+function getLocalRoot() {
+    return join(process.cwd(), '.soleri', 'hook-packs');
+}
+/** Scan a directory for pack manifests. */
+function scanPacksDir(root, source) {
+    if (!existsSync(root))
+        return [];
     const entries = readdirSync(root, { withFileTypes: true });
     const packs = [];
     for (const entry of entries) {
@@ -26,6 +29,7 @@ export function listPacks() {
             continue;
         try {
             const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
+            manifest.source = source;
             packs.push(manifest);
         }
         catch {
@@ -35,17 +39,46 @@ export function listPacks() {
     return packs;
 }
 /**
- * Get a specific pack by name.
+ * List all available hook packs (built-in + local custom).
+ * Local packs in .soleri/hook-packs/ override built-in packs with the same name.
+ */
+export function listPacks() {
+    const builtIn = scanPacksDir(getBuiltinRoot(), 'built-in');
+    const local = scanPacksDir(getLocalRoot(), 'local');
+    // Local packs override built-in packs with same name
+    const byName = new Map();
+    for (const pack of builtIn)
+        byName.set(pack.name, pack);
+    for (const pack of local)
+        byName.set(pack.name, pack);
+    return Array.from(byName.values());
+}
+/**
+ * Get a specific pack by name. Local packs take precedence.
  */
 export function getPack(name) {
-    const root = getPacksRoot();
-    const dir = join(root, name);
-    const manifestPath = join(dir, 'manifest.json');
-    if (!existsSync(manifestPath))
+    // Check local first
+    const localDir = join(getLocalRoot(), name);
+    const localManifest = join(localDir, 'manifest.json');
+    if (existsSync(localManifest)) {
+        try {
+            const manifest = JSON.parse(readFileSync(localManifest, 'utf-8'));
+            manifest.source = 'local';
+            return { manifest, dir: localDir };
+        }
+        catch {
+            // Fall through to built-in
+        }
+    }
+    // Then built-in
+    const builtinDir = join(getBuiltinRoot(), name);
+    const builtinManifest = join(builtinDir, 'manifest.json');
+    if (!existsSync(builtinManifest))
         return null;
     try {
-        const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
-        return { manifest, dir };
+        const manifest = JSON.parse(readFileSync(builtinManifest, 'utf-8'));
+        manifest.source = 'built-in';
+        return { manifest, dir: builtinDir };
     }
     catch {
         return null;

package/dist/hook-packs/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hook-packs/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASlC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,yDAAyD;AACzD,SAAS,YAAY;IACnB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAuB,EAAE,CAAC;IAErC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,SAAS;QAExC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAqB,CAAC;YACrF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEhD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAqB,CAAC;QACrF,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAC3C,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,IAAI,WAAW,CAAC,CAAC,CACxD,CAAC;QACF,IAAI,UAAU,EAAE,CAAC;YACf,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/hook-packs/registry.ts"],"names":[],"mappings":"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"}

package/dist/hook-packs/registry.ts

@@ -11,21 +11,27 @@ export interface HookPackManifest {
   description: string;
   hooks: string[];
   composedFrom?: string[];
+  version?: string;
+  /** Whether this pack is built-in or user-defined */
+  source?: 'built-in' | 'local';
 }
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 /** Root directory containing all built-in hook packs. */
-function getPacksRoot(): string {
+function getBuiltinRoot(): string {
   return __dirname;
 }
 
-/**
- * List all available built-in hook packs.
- */
-export function listPacks(): HookPackManifest[] {
-  const root = getPacksRoot();
+/** Local custom packs directory. */
+function getLocalRoot(): string {
+  return join(process.cwd(), '.soleri', 'hook-packs');
+}
+
+/** Scan a directory for pack manifests. */
+function scanPacksDir(root: string, source: 'built-in' | 'local'): HookPackManifest[] {
+  if (!existsSync(root)) return [];
   const entries = readdirSync(root, { withFileTypes: true });
   const packs: HookPackManifest[] = [];
 
@@ -36,6 +42,7 @@ export function listPacks(): HookPackManifest[] {
 
     try {
       const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as HookPackManifest;
+      manifest.source = source;
       packs.push(manifest);
     } catch {
       // Skip malformed manifests
@@ -46,18 +53,47 @@ export function listPacks(): HookPackManifest[] {
 }
 
 /**
- * Get a specific pack by name.
+ * List all available hook packs (built-in + local custom).
+ * Local packs in .soleri/hook-packs/ override built-in packs with the same name.
+ */
+export function listPacks(): HookPackManifest[] {
+  const builtIn = scanPacksDir(getBuiltinRoot(), 'built-in');
+  const local = scanPacksDir(getLocalRoot(), 'local');
+
+  // Local packs override built-in packs with same name
+  const byName = new Map<string, HookPackManifest>();
+  for (const pack of builtIn) byName.set(pack.name, pack);
+  for (const pack of local) byName.set(pack.name, pack);
+
+  return Array.from(byName.values());
+}
+
+/**
+ * Get a specific pack by name. Local packs take precedence.
  */
 export function getPack(name: string): { manifest: HookPackManifest; dir: string } | null {
-  const root = getPacksRoot();
-  const dir = join(root, name);
-  const manifestPath = join(dir, 'manifest.json');
+  // Check local first
+  const localDir = join(getLocalRoot(), name);
+  const localManifest = join(localDir, 'manifest.json');
+  if (existsSync(localManifest)) {
+    try {
+      const manifest = JSON.parse(readFileSync(localManifest, 'utf-8')) as HookPackManifest;
+      manifest.source = 'local';
+      return { manifest, dir: localDir };
+    } catch {
+      // Fall through to built-in
+    }
+  }
 
-  if (!existsSync(manifestPath)) return null;
+  // Then built-in
+  const builtinDir = join(getBuiltinRoot(), name);
+  const builtinManifest = join(builtinDir, 'manifest.json');
+  if (!existsSync(builtinManifest)) return null;
 
   try {
-    const manifest = JSON.parse(readFileSync(manifestPath, 'utf-8')) as HookPackManifest;
-    return { manifest, dir };
+    const manifest = JSON.parse(readFileSync(builtinManifest, 'utf-8')) as HookPackManifest;
+    manifest.source = 'built-in';
+    return { manifest, dir: builtinDir };
   } catch {
     return null;
   }

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

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: typescript-safety
+# Version: 1.0.0
 # Rule: no-any-types
 name: no-any-types
 enabled: true

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

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: typescript-safety
+# Version: 1.0.0
 # Rule: no-console-log
 name: no-console-log
 enabled: true

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

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

package/dist/utils/checks.d.ts

@@ -8,5 +8,6 @@ export declare function checkNpm(): CheckResult;
 export declare function checkAgentProject(dir?: string): CheckResult;
 export declare function checkAgentBuild(dir?: string): CheckResult;
 export declare function checkNodeModules(dir?: string): CheckResult;
+export declare function checkHookPacks(): CheckResult;
 export declare function runAllChecks(dir?: string): CheckResult[];
 export {};

package/dist/utils/checks.js

@@ -6,6 +6,7 @@ import { join } from 'node:path';
 import { execFileSync } from 'node:child_process';
 import { homedir } from 'node:os';
 import { detectAgent } from './agent-context.js';
+import { getInstalledPacks } from '../hook-packs/registry.js';
 export function checkNodeVersion() {
     const [major] = process.versions.node.split('.').map(Number);
     if (major >= 18) {
@@ -123,6 +124,21 @@ function checkCognee() {
         };
     }
 }
+export function checkHookPacks() {
+    const installed = getInstalledPacks();
+    if (installed.length === 0) {
+        return {
+            status: 'warn',
+            label: 'Hook packs',
+            detail: 'none installed — run soleri hooks list-packs',
+        };
+    }
+    return {
+        status: 'pass',
+        label: 'Hook packs',
+        detail: installed.join(', '),
+    };
+}
 export function runAllChecks(dir) {
     return [
         checkNodeVersion(),
@@ -132,6 +148,7 @@ export function runAllChecks(dir) {
         checkNodeModules(dir),
         checkAgentBuild(dir),
         checkMcpRegistration(dir),
+        checkHookPacks(),
         checkCognee(),
     ];
 }

package/dist/utils/checks.js.map

@@ -1 +1 @@
-{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/utils/checks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../../src/utils/checks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soleri/cli",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Developer CLI for creating and managing Soleri AI agents.",
   "keywords": [
     "agent",

package/src/commands/create.ts

@@ -4,6 +4,8 @@ import type { Command } from 'commander';
 import * as p from '@clack/prompts';
 import { previewScaffold, scaffold, AgentConfigSchema } from '@soleri/forge/lib';
 import { runCreateWizard } from '../prompts/create-wizard.js';
+import { listPacks } from '../hook-packs/registry.js';
+import { installPack } from '../hook-packs/installer.js';
 
 export function registerCreate(program: Command): void {
   program
@@ -38,12 +40,38 @@ export function registerCreate(program: Command): void {
           }
         }
 
+        // Hook packs — from config file or interactive prompt
+        let selectedPacks: string[] = [];
+        if (config.hookPacks && config.hookPacks.length > 0) {
+          selectedPacks = config.hookPacks;
+        } else if (!opts?.config) {
+          const packs = listPacks();
+          const packChoices = packs.map((pk) => ({
+            value: pk.name,
+            label: pk.name,
+            hint: `${pk.description} (${pk.hooks.length} hooks)`,
+          }));
+
+          const chosen = await p.multiselect({
+            message: 'Install hook packs? (quality gates for ~/.claude/)',
+            options: packChoices,
+            required: false,
+          });
+
+          if (!p.isCancel(chosen)) {
+            selectedPacks = chosen as string[];
+          }
+        }
+
         // Preview
         const preview = previewScaffold(config);
 
         p.log.info(`Will create ${preview.files.length} files in ${preview.agentDir}`);
         p.log.info(`Facades: ${preview.facades.map((f) => f.name).join(', ')}`);
         p.log.info(`Domains: ${preview.domains.join(', ')}`);
+        if (selectedPacks.length > 0) {
+          p.log.info(`Hook packs: ${selectedPacks.join(', ')}`);
+        }
 
         const confirmed = await p.confirm({ message: 'Create agent?' });
         if (p.isCancel(confirmed) || !confirmed) {
@@ -57,13 +85,27 @@ export function registerCreate(program: Command): void {
         const result = scaffold(config);
         s.stop(result.success ? 'Agent created!' : 'Scaffolding failed');
 
-        if (result.success) {
-          p.note(result.summary, 'Next steps');
-        } else {
+        if (!result.success) {
           p.log.error(result.summary);
           process.exit(1);
         }
 
+        // Install selected hook packs
+        if (selectedPacks.length > 0) {
+          for (const packName of selectedPacks) {
+            const { installed } = installPack(packName);
+            if (installed.length > 0) {
+              p.log.success(`Hook pack "${packName}" installed (${installed.length} hooks)`);
+            } else {
+              p.log.info(`Hook pack "${packName}" — all hooks already present`);
+            }
+          }
+        }
+
+        if (result.success) {
+          p.note(result.summary, 'Next steps');
+        }
+
         p.outro('Done!');
       } catch (err) {
         p.log.error(err instanceof Error ? err.message : String(err));

package/src/commands/hooks.ts

@@ -87,8 +87,9 @@ export function registerHooks(program: Command): void {
   hooks
     .command('add-pack')
     .argument('<pack>', 'Hook pack name')
-    .description('Install a hook pack globally (~/.claude/)')
-    .action((packName: string) => {
+    .option('--project', 'Install to project .claude/ instead of global ~/.claude/')
+    .description('Install a hook pack globally (~/.claude/) or per-project (--project)')
+    .action((packName: string, opts: { project?: boolean }) => {
       const pack = getPack(packName);
       if (!pack) {
         const available = listPacks().map((p) => p.name);
@@ -96,15 +97,17 @@ export function registerHooks(program: Command): void {
         process.exit(1);
       }
 
-      const { installed, skipped } = installPack(packName);
+      const projectDir = opts.project ? process.cwd() : undefined;
+      const target = opts.project ? '.claude/' : '~/.claude/';
+      const { installed, skipped } = installPack(packName, { projectDir });
       for (const hook of installed) {
-        log.pass(`Installed hookify.${hook}.local.md`);
+        log.pass(`Installed hookify.${hook}.local.md → ${target}`);
       }
       for (const hook of skipped) {
         log.dim(`  hookify.${hook}.local.md — already exists, skipped`);
       }
       if (installed.length > 0) {
-        log.info(`Pack "${packName}" installed (${installed.length} hooks)`);
+        log.info(`Pack "${packName}" installed (${installed.length} hooks) → ${target}`);
       } else {
         log.info(`Pack "${packName}" — all hooks already installed`);
       }
@@ -113,8 +116,9 @@ export function registerHooks(program: Command): void {
   hooks
     .command('remove-pack')
     .argument('<pack>', 'Hook pack name')
-    .description('Remove a hook pack from ~/.claude/')
-    .action((packName: string) => {
+    .option('--project', 'Remove from project .claude/ instead of global ~/.claude/')
+    .description('Remove a hook pack')
+    .action((packName: string, opts: { project?: boolean }) => {
       const pack = getPack(packName);
       if (!pack) {
         const available = listPacks().map((p) => p.name);
@@ -122,7 +126,8 @@ export function registerHooks(program: Command): void {
         process.exit(1);
       }
 
-      const { removed } = removePack(packName);
+      const projectDir = opts.project ? process.cwd() : undefined;
+      const { removed } = removePack(packName, { projectDir });
       if (removed.length === 0) {
         log.info(`No hooks from pack "${packName}" found to remove.`);
       } else {
@@ -144,15 +149,53 @@ export function registerHooks(program: Command): void {
       for (const pack of packs) {
         const status = isPackInstalled(pack.name);
 
+        const versionLabel = pack.version ? ` v${pack.version}` : '';
+        const sourceLabel = pack.source === 'local' ? ' [local]' : '';
+
         if (status === true) {
-          log.pass(`${pack.name}`, `${pack.description} (${pack.hooks.length} hooks)`);
+          log.pass(
+            `${pack.name}${versionLabel}${sourceLabel}`,
+            `${pack.description} (${pack.hooks.length} hooks)`,
+          );
         } else if (status === 'partial') {
-          log.warn(`${pack.name}`, `${pack.description} (${pack.hooks.length} hooks) — partial`);
+          log.warn(
+            `${pack.name}${versionLabel}${sourceLabel}`,
+            `${pack.description} (${pack.hooks.length} hooks) — partial`,
+          );
         } else {
-          log.dim(`  ${pack.name} — ${pack.description} (${pack.hooks.length} hooks)`);
+          log.dim(
+            `  ${pack.name}${versionLabel}${sourceLabel} — ${pack.description} (${pack.hooks.length} hooks)`,
+          );
         }
       }
     });
+
+  hooks
+    .command('upgrade-pack')
+    .argument('<pack>', 'Hook pack name')
+    .option('--project', 'Upgrade in project .claude/ instead of global ~/.claude/')
+    .description('Upgrade a hook pack to the latest version (overwrites existing files)')
+    .action((packName: string, opts: { project?: boolean }) => {
+      const pack = getPack(packName);
+      if (!pack) {
+        const available = listPacks().map((p) => p.name);
+        log.fail(`Unknown pack "${packName}". Available: ${available.join(', ')}`);
+        process.exit(1);
+      }
+
+      const projectDir = opts.project ? process.cwd() : undefined;
+      const packVersion = pack.manifest.version ?? 'unknown';
+
+      // Remove then reinstall to force overwrite
+      removePack(packName, { projectDir });
+      const { installed } = installPack(packName, { projectDir });
+
+      for (const hook of installed) {
+        log.pass(`hookify.${hook}.local.md → v${packVersion}`);
+      }
+
+      log.info(`Pack "${packName}" upgraded to v${packVersion} (${installed.length} hooks)`);
+    });
 }
 
 function isValidEditor(editor: string): editor is EditorId {

package/src/hook-packs/a11y/hookify.focus-ring-required.local.md

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: a11y
+# Version: 1.0.0
 # Rule: focus-ring-required
 name: focus-ring-required
 enabled: true

package/src/hook-packs/a11y/hookify.semantic-html.local.md

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: a11y
+# Version: 1.0.0
 # Rule: semantic-html
 name: semantic-html
 enabled: true

package/src/hook-packs/a11y/hookify.ux-touch-targets.local.md

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: a11y
+# Version: 1.0.0
 # Rule: ux-touch-targets
 name: ux-touch-targets
 enabled: true

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

@@ -1,5 +1,6 @@
 {
   "name": "a11y",
+  "version": "1.0.0",
   "description": "Accessibility enforcement",
   "hooks": ["semantic-html", "focus-ring-required", "ux-touch-targets"]
 }

package/src/hook-packs/clean-commits/hookify.no-ai-attribution.local.md

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: clean-commits
+# Version: 1.0.0
 # Rule: no-ai-attribution
 name: no-ai-attribution
 enabled: true

package/src/hook-packs/clean-commits/manifest.json

@@ -1,5 +1,6 @@
 {
   "name": "clean-commits",
+  "version": "1.0.0",
   "description": "No AI attribution in git commits",
   "hooks": ["no-ai-attribution"]
 }

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

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: css-discipline
+# Version: 1.0.0
 # Rule: no-important
 name: no-important
 enabled: true

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

@@ -1,5 +1,6 @@
 ---
 # Soleri Hook Pack: css-discipline
+# Version: 1.0.0
 # Rule: no-inline-styles
 name: no-inline-styles
 enabled: true

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

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

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

@@ -1,5 +1,6 @@
 {
   "name": "full",
+  "version": "1.0.0",
   "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"]