@soleri/cli 1.9.0 → 1.10.0

package/src/prompts/playbook.ts

@@ -7,7 +7,7 @@
 
 // ─── Domains ────────────────────────────────────────────────
 
-export interface DomainOption {
+interface DomainOption {
   value: string;
   label: string;
   hint: string;
@@ -60,6 +60,36 @@ export const DOMAIN_OPTIONS: DomainOption[] = [
     hint: 'API docs, READMEs, changelogs, code comments',
   },
   { value: 'devops', label: 'devops', hint: 'CI/CD pipelines, infrastructure as code, deployment' },
+  {
+    value: 'developer-experience',
+    label: 'developer-experience',
+    hint: 'Developer tooling, onboarding, and ergonomics',
+  },
+  {
+    value: 'design-tokens',
+    label: 'design-tokens',
+    hint: 'Semantic tokens, color systems, spacing scales, typography',
+  },
+  {
+    value: 'frontend',
+    label: 'frontend',
+    hint: 'Component patterns, state management, rendering, bundling',
+  },
+  {
+    value: 'ux-design',
+    label: 'ux-design',
+    hint: 'User flows, conversion, onboarding, forms, navigation',
+  },
+  {
+    value: 'knowledge-management',
+    label: 'knowledge-management',
+    hint: 'Vault curation, pattern lifecycle, cross-project learning',
+  },
+  {
+    value: 'governance',
+    label: 'governance',
+    hint: 'Approval gates, policy enforcement, audit trails',
+  },
 ];
 
 export const CUSTOM_DOMAIN_GUIDANCE = {
@@ -77,12 +107,12 @@ export const CUSTOM_DOMAIN_GUIDANCE = {
 
 // ─── Principles ─────────────────────────────────────────────
 
-export interface PrincipleCategory {
+interface PrincipleCategory {
   label: string;
   options: PrincipleOption[];
 }
 
-export interface PrincipleOption {
+interface PrincipleOption {
   value: string;
   label: string;
 }
@@ -95,6 +125,7 @@ export const PRINCIPLE_CATEGORIES: PrincipleCategory[] = [
       { value: 'Convention over configuration', label: 'Convention over configuration' },
       { value: 'Test everything that can break', label: 'Test everything that can break' },
       { value: 'Respect existing patterns', label: 'Respect existing patterns' },
+      { value: 'Progressive enhancement', label: 'Progressive enhancement' },
     ],
   },
   {
@@ -104,6 +135,7 @@ export const PRINCIPLE_CATEGORIES: PrincipleCategory[] = [
       { value: 'Fail closed, not open', label: 'Fail closed, not open' },
       { value: 'Zero trust by default', label: 'Zero trust by default' },
       { value: 'Least privilege always', label: 'Least privilege always' },
+      { value: 'Defense in depth', label: 'Defense in depth' },
     ],
   },
   {
@@ -136,6 +168,173 @@ export const PRINCIPLE_CATEGORIES: PrincipleCategory[] = [
       { value: 'Every migration must be reversible', label: 'Every migration must be reversible' },
     ],
   },
+  {
+    label: 'Code Review',
+    options: [
+      { value: 'Readable over clever', label: 'Readable over clever' },
+      { value: 'Small PR scope', label: 'Small PR scope' },
+    ],
+  },
+  {
+    label: 'API Design',
+    options: [
+      { value: 'Backward compatibility by default', label: 'Backward compatibility by default' },
+      { value: 'Consumer-driven contracts', label: 'Consumer-driven contracts' },
+    ],
+  },
+  {
+    label: 'Testing',
+    options: [
+      { value: 'Deterministic tests only', label: 'Deterministic tests only' },
+      { value: 'Test at boundaries, not internals', label: 'Test at boundaries, not internals' },
+    ],
+  },
+  {
+    label: 'Operations',
+    options: [
+      { value: 'Infrastructure as code', label: 'Infrastructure as code' },
+      { value: 'Blast radius awareness', label: 'Blast radius awareness' },
+    ],
+  },
+  {
+    label: 'Data',
+    options: [
+      {
+        value: 'Schema evolution over breaking changes',
+        label: 'Schema evolution over breaking changes',
+      },
+      { value: 'Query performance first', label: 'Query performance first' },
+    ],
+  },
+  {
+    label: 'Accessibility',
+    options: [
+      { value: 'WCAG compliance is non-negotiable', label: 'WCAG compliance is non-negotiable' },
+      { value: 'Semantic HTML before ARIA', label: 'Semantic HTML before ARIA' },
+      {
+        value: 'Keyboard navigation for every interaction',
+        label: 'Keyboard navigation for every interaction',
+      },
+    ],
+  },
+  {
+    label: 'Documentation',
+    options: [
+      { value: 'Clarity over completeness', label: 'Clarity over completeness' },
+      { value: 'Every concept needs an example', label: 'Every concept needs an example' },
+      {
+        value: 'Docs rot faster than code — keep current',
+        label: 'Docs rot faster than code — keep current',
+      },
+    ],
+  },
+  {
+    label: 'Design Systems',
+    options: [
+      { value: 'Semantic tokens over primitives', label: 'Semantic tokens over primitives' },
+      {
+        value: 'Component variant enum over boolean props',
+        label: 'Component variant enum over boolean props',
+      },
+      {
+        value: 'Atomic design classification for component hierarchy',
+        label: 'Atomic design classification for component hierarchy',
+      },
+      {
+        value: 'Token enforcement: blocked then forbidden then preferred',
+        label: 'Token enforcement: blocked then forbidden then preferred',
+      },
+      {
+        value: 'Respect existing design system patterns',
+        label: 'Respect existing design system patterns',
+      },
+      {
+        value: 'Every component needs accessibility baseline',
+        label: 'Every component needs accessibility baseline',
+      },
+    ],
+  },
+  {
+    label: 'Frontend Engineering',
+    options: [
+      {
+        value: 'Stack-aware implementation over generic advice',
+        label: 'Stack-aware implementation over generic advice',
+      },
+      { value: 'UX patterns inform code structure', label: 'UX patterns inform code structure' },
+      {
+        value: 'Performance budget before feature scope',
+        label: 'Performance budget before feature scope',
+      },
+      {
+        value: 'Accessible by default, not bolted on after',
+        label: 'Accessible by default, not bolted on after',
+      },
+    ],
+  },
+  {
+    label: 'UX Intelligence',
+    options: [
+      {
+        value: 'User behavior drives design decisions',
+        label: 'User behavior drives design decisions',
+      },
+      {
+        value: 'Accessibility is not a feature, it is a baseline',
+        label: 'Accessibility is not a feature, it is a baseline',
+      },
+      {
+        value: 'Measure conversion impact of every UX change',
+        label: 'Measure conversion impact of every UX change',
+      },
+      {
+        value: 'Progressive disclosure over information overload',
+        label: 'Progressive disclosure over information overload',
+      },
+    ],
+  },
+  {
+    label: 'Knowledge Management',
+    options: [
+      {
+        value: 'Knowledge-gather before execute, always',
+        label: 'Knowledge-gather before execute, always',
+      },
+      {
+        value: 'Vault is the single source of truth',
+        label: 'Vault is the single source of truth',
+      },
+      {
+        value: 'Capture lessons at the moment of discovery',
+        label: 'Capture lessons at the moment of discovery',
+      },
+      {
+        value: 'Cross-project patterns beat project-local fixes',
+        label: 'Cross-project patterns beat project-local fixes',
+      },
+      {
+        value: 'Domain vocabulary must be explicit and extensible',
+        label: 'Domain vocabulary must be explicit and extensible',
+      },
+    ],
+  },
+  {
+    label: 'Governance',
+    options: [
+      {
+        value: 'Two-gate approval: plan then execute, never skip',
+        label: 'Two-gate approval: plan then execute, never skip',
+      },
+      {
+        value: 'Protocol enforcement via checkpoint gates',
+        label: 'Protocol enforcement via checkpoint gates',
+      },
+      {
+        value: 'Data-driven architecture: logic in config, not code',
+        label: 'Data-driven architecture: logic in config, not code',
+      },
+    ],
+  },
 ];
 
 export const CUSTOM_PRINCIPLE_GUIDANCE = {
@@ -160,35 +359,22 @@ export const CORE_SKILLS = [
   'verification-before-completion',
   'health-check',
   'context-resume',
+  'writing-plans',
+  'executing-plans',
 ] as const;
 
-export interface SkillCategory {
+interface SkillCategory {
   label: string;
   options: SkillOption[];
 }
 
-export interface SkillOption {
+interface SkillOption {
   value: string;
   label: string;
   hint: string;
 }
 
 export const SKILL_CATEGORIES: SkillCategory[] = [
-  {
-    label: 'Planning & Execution',
-    options: [
-      {
-        value: 'writing-plans',
-        label: 'writing-plans',
-        hint: 'Structured multi-step planning before code changes',
-      },
-      {
-        value: 'executing-plans',
-        label: 'executing-plans',
-        hint: 'Execute approved plans with review checkpoints',
-      },
-    ],
-  },
   {
     label: 'Knowledge & Learning',
     options: [
@@ -261,7 +447,7 @@ export const ALL_OPTIONAL_SKILLS = SKILL_CATEGORIES.flatMap((c) => c.options.map
 
 // ─── Tones ──────────────────────────────────────────────────
 
-export interface ToneOption {
+interface ToneOption {
   value: 'precise' | 'mentor' | 'pragmatic';
   label: string;
   hint: string;

package/src/utils/checks.ts

@@ -135,7 +135,7 @@ function checkCognee(): CheckResult {
   }
 }
 
-export function checkHookPacks(): CheckResult {
+function checkHookPacks(): CheckResult {
   const installed = getInstalledPacks();
   if (installed.length === 0) {
     return {

package/code-reviewer/.claude/hookify.focus-ring-required.local.md

@@ -1,21 +0,0 @@
----
-# Soleri Hook Pack: a11y
-# Version: 1.0.0
-# Rule: focus-ring-required
-name: focus-ring-required
-enabled: true
-event: file
-action: warn
-conditions:
-  - field: file_path
-    operator: regex_match
-    pattern: src/components/ui/.*\.tsx$
-  - field: content
-    operator: regex_match
-    pattern: (<button|<Button|<a\s+href)
-  - field: content
-    operator: not_regex_match
-    pattern: (focus:ring|focus-visible:ring|focus:outline)
----
-
-⚠️ **A11y:** Add focus ring for keyboard navigation: `focus:ring-2 focus:ring-accent focus:ring-offset-2`

package/code-reviewer/.claude/hookify.no-ai-attribution.local.md

@@ -1,18 +0,0 @@
----
-# Soleri Hook Pack: clean-commits
-# Version: 1.0.0
-# Rule: no-ai-attribution
-name: no-ai-attribution
-enabled: true
-event: bash
-action: block
-conditions:
-  - field: command
-    operator: regex_match
-    pattern: git\s+commit.*(-m|--message)
-  - field: command
-    operator: regex_match
-    pattern: (🤖|Co-Authored-By|Generated with|AI-generated|by Claude|Claude Code|with Claude|noreply@anthropic\.com|Anthropic|Claude\s+(Opus|Sonnet|Haiku))
----
-
-🚫 **AI attribution blocked.** Use clean conventional commits: `feat:`, `fix:`, `refactor:`. No 🤖, Claude, Co-Authored-By, or Anthropic references.

package/code-reviewer/.claude/hookify.no-any-types.local.md

@@ -1,18 +0,0 @@
----
-# Soleri Hook Pack: typescript-safety
-# Version: 1.0.0
-# 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/code-reviewer/.claude/hookify.no-console-log.local.md

@@ -1,21 +0,0 @@
----
-# Soleri Hook Pack: typescript-safety
-# Version: 1.0.0
-# 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/code-reviewer/.claude/hookify.no-important.local.md

@@ -1,18 +0,0 @@
----
-# Soleri Hook Pack: css-discipline
-# Version: 1.0.0
-# 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/code-reviewer/.claude/hookify.no-inline-styles.local.md

@@ -1,21 +0,0 @@
----
-# Soleri Hook Pack: css-discipline
-# Version: 1.0.0
-# 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/code-reviewer/.claude/hookify.semantic-html.local.md

@@ -1,18 +0,0 @@
----
-# Soleri Hook Pack: a11y
-# Version: 1.0.0
-# Rule: semantic-html
-name: semantic-html
-enabled: true
-event: file
-action: warn
-conditions:
-  - field: file_path
-    operator: regex_match
-    pattern: src/components/.*\.tsx$
-  - field: content
-    operator: regex_match
-    pattern: (<div\s+onClick(?!=)|<span\s+onClick(?!=))
----
-
-⚠️ **A11y:** Use `<button>` instead of `<div onClick>`. Semantic HTML provides keyboard support.

package/code-reviewer/.claude/hookify.ux-touch-targets.local.md

@@ -1,18 +0,0 @@
----
-# Soleri Hook Pack: a11y
-# Version: 1.0.0
-# Rule: ux-touch-targets
-name: ux-touch-targets
-enabled: true
-event: file
-action: warn
-conditions:
-  - field: file_path
-    operator: regex_match
-    pattern: src/components/.*\.tsx$
-  - field: content
-    operator: regex_match
-    pattern: (<button[^>]*className="[^"]*(?:p-1|p-2|h-6|h-7|h-8|w-6|w-7|w-8)[^"]*"[^>]*>|className="[^"]*(?:p-1|p-2)[^"]*"[^>]*onClick)
----
-
-⚠️ **Touch target too small.** Min 44x44px required. Add `min-h-11 min-w-11` to small interactive elements.

package/code-reviewer/.mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "code-reviewer": {
-      "command": "node",
-      "args": [
-        "dist/index.js"
-      ],
-      "cwd": "."
-    }
-  }
-}