prjct-cli 0.28.3 → 0.28.4

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## [0.28.4] - 2026-01-11
+
+### Feature: Claude Code UX Enhancements
+
+Rich terminal experience for Claude Code - 100% ToS compliant.
+
+**Status Line System:**
+- Custom status line script showing prjct task, git branch, lines changed
+- Context usage bar with color-coded warnings (green/yellow/red)
+- Model icons (🎭 Opus, 📝 Sonnet, 🍃 Haiku)
+- Installed at `~/.prjct-cli/statusline/statusline.sh`
+
+**Theme System:**
+- Three built-in themes: default (prjct), gentleman, minimal
+- JSON-based theme configuration
+- ANSI 256 color support
+- Located at `~/.prjct-cli/statusline/themes/`
+
+**Output Styles:**
+- `prjct.md` - Concise, actionable output (default)
+- `verbose.md` - Detailed explanations for learning
+- `ship-fast.md` - Minimal output for max velocity
+- Located at `~/.prjct-cli/output-styles/`
+
+**Hooks Integration:**
+- `update-metrics.sh` - Tracks tool usage per session
+- `session-summary.sh` - Shows stats when Claude stops
+- Located at `~/.prjct-cli/hooks/`
+
+**Visual Theme (tweakcc):**
+- Full Claude Code color theme
+- Spanish thinking verbs
+- Located at `~/.prjct-cli/tweakcc-theme.json`
+
+**New Templates:**
+- `templates/commands/setup-statusline.md` - Interactive setup
+- `templates/guides/claude-code-ux.md` - Full documentation
+- Updated `templates/global/CLAUDE.md` with UX section
+
+**Template Optimization:**
+- Further reduced template sizes
+- New shared patterns in `templates/shared/`
+
 ## [0.28.3] - 2026-01-11
 
 ### Feature: Claude Code Synergy Optimization

package/core/agentic/memory-system.ts

@@ -43,7 +43,6 @@ import type {
   MemoryDatabase,
   HistoryEntry,
   HistoryEventType,
-  Decision,
   Workflow,
   Preference,
   Patterns,
@@ -269,8 +268,13 @@ export class HistoryStore {
 /**
  * Patterns - Tier 2
  * Persistent learned preferences and decisions.
+ * OPTIMIZED: Debounced saves to reduce I/O
  */
 export class PatternStore extends CachedStore<Patterns> {
+  private _saveTimeout: ReturnType<typeof setTimeout> | null = null
+  private _pendingSave: string | null = null
+  private static readonly SAVE_DEBOUNCE_MS = 500 // Batch saves within 500ms
+
   protected getFilename(): string {
     return 'patterns.json'
   }
@@ -285,6 +289,41 @@ export class PatternStore extends CachedStore<Patterns> {
     }
   }
 
+  /**
+   * OPTIMIZED: Debounced save - batches multiple updates
+   */
+  private async debouncedSave(projectId: string): Promise<void> {
+    this._pendingSave = projectId
+
+    if (this._saveTimeout) {
+      clearTimeout(this._saveTimeout)
+    }
+
+    return new Promise((resolve) => {
+      this._saveTimeout = setTimeout(async () => {
+        if (this._pendingSave) {
+          await this.save(this._pendingSave)
+          this._pendingSave = null
+        }
+        resolve()
+      }, PatternStore.SAVE_DEBOUNCE_MS)
+    })
+  }
+
+  /**
+   * Force flush any pending saves (call before process exit)
+   */
+  async flush(projectId: string): Promise<void> {
+    if (this._saveTimeout) {
+      clearTimeout(this._saveTimeout)
+      this._saveTimeout = null
+    }
+    if (this._pendingSave) {
+      await this.save(projectId)
+      this._pendingSave = null
+    }
+  }
+
   // Convenience alias for backward compatibility
   async loadPatterns(projectId: string): Promise<Patterns> {
     return this.load(projectId)
@@ -330,7 +369,8 @@ export class PatternStore extends CachedStore<Patterns> {
       }
     }
 
-    await this.save(projectId)
+    // OPTIMIZED: Debounced save instead of immediate
+    await this.debouncedSave(projectId)
   }
 
   async getDecision(projectId: string, key: string): Promise<{ value: string; confidence: string } | null> {
@@ -364,13 +404,12 @@ export class PatternStore extends CachedStore<Patterns> {
       patterns.workflows[workflowName].lastSeen = now
     }
 
-    await this.save(projectId)
+    await this.debouncedSave(projectId)
   }
 
   async getWorkflow(projectId: string, workflowName: string): Promise<Workflow | null> {
     const patterns = await this.load(projectId)
     const workflow = patterns.workflows[workflowName]
-
     if (!workflow || workflow.count < 3) return null
     return workflow
   }
@@ -378,7 +417,7 @@ export class PatternStore extends CachedStore<Patterns> {
   async setPreference(projectId: string, key: string, value: Preference['value']): Promise<void> {
     const patterns = await this.load(projectId)
     patterns.preferences[key] = { value, updatedAt: getTimestamp() }
-    await this.save(projectId)
+    await this.debouncedSave(projectId)
   }
 
   async getPreference(projectId: string, key: string, defaultValue: unknown = null): Promise<unknown> {

package/core/agentic/smart-context.ts

@@ -13,7 +13,6 @@ import { outcomeAnalyzer } from '../outcomes'
 import type { TaskType } from '../types'
 import type {
   ContextDomain,
-  SmartContextProjectState,
   FullContext,
   FilteredContext,
   StackInfo,
@@ -32,8 +31,22 @@ export type {
   FilterMetrics,
 } from '../types'
 
-// Local type alias for backward compatibility
-type ProjectState = SmartContextProjectState
+/**
+ * PERFORMANCE: Pre-built keyword → domain map for O(1) lookup
+ * Instead of iterating 5 arrays of keywords, we do a single pass
+ */
+const KEYWORD_DOMAIN_MAP: Map<string, ContextDomain> = new Map([
+  // Frontend
+  ...['ui', 'component', 'react', 'vue', 'angular', 'css', 'style', 'button', 'form', 'modal', 'layout', 'responsive', 'animation', 'dom', 'html', 'frontend', 'fe', 'client', 'browser', 'jsx', 'tsx'].map(k => [k, 'frontend' as ContextDomain] as const),
+  // Backend
+  ...['api', 'server', 'database', 'db', 'endpoint', 'route', 'handler', 'controller', 'service', 'repository', 'model', 'query', 'backend', 'be', 'rest', 'graphql', 'prisma', 'sql', 'redis', 'auth'].map(k => [k, 'backend' as ContextDomain] as const),
+  // DevOps
+  ...['deploy', 'docker', 'kubernetes', 'k8s', 'ci', 'cd', 'pipeline', 'terraform', 'ansible', 'aws', 'gcp', 'azure', 'nginx', 'devops', 'infrastructure', 'monitoring', 'logging'].map(k => [k, 'devops' as ContextDomain] as const),
+  // Docs
+  ...['document', 'docs', 'readme', 'changelog', 'comment', 'jsdoc', 'tutorial', 'guide', 'explain', 'describe', 'markdown'].map(k => [k, 'docs' as ContextDomain] as const),
+  // Testing
+  ...['test', 'spec', 'jest', 'mocha', 'cypress', 'playwright', 'pytest', 'unittest', 'e2e', 'unit', 'integration', 'coverage', 'mock', 'fixture'].map(k => [k, 'testing' as ContextDomain] as const),
+])
 
 /**
  * SmartContext - Intelligent context filtering.
@@ -41,63 +54,20 @@ type ProjectState = SmartContextProjectState
 class SmartContext {
   /**
    * Detect the domain of a task from its description.
+   * OPTIMIZED: Single-pass O(n) where n = words in description
    */
   detectDomain(taskDescription: string): DomainAnalysis {
-    const lower = taskDescription.toLowerCase()
-
-    // Frontend indicators
-    const frontendKeywords = [
-      'ui', 'component', 'react', 'vue', 'angular', 'css', 'style',
-      'button', 'form', 'modal', 'layout', 'responsive', 'animation',
-      'dom', 'html', 'frontend', 'fe', 'client', 'browser', 'jsx', 'tsx'
-    ]
-
-    // Backend indicators
-    const backendKeywords = [
-      'api', 'server', 'database', 'db', 'endpoint', 'route', 'handler',
-      'controller', 'service', 'repository', 'model', 'query', 'backend',
-      'be', 'rest', 'graphql', 'prisma', 'sql', 'redis', 'auth'
-    ]
-
-    // DevOps indicators
-    const devopsKeywords = [
-      'deploy', 'docker', 'kubernetes', 'k8s', 'ci', 'cd', 'pipeline',
-      'terraform', 'ansible', 'aws', 'gcp', 'azure', 'config', 'nginx',
-      'devops', 'infrastructure', 'monitoring', 'logging', 'build'
-    ]
-
-    // Docs indicators
-    const docsKeywords = [
-      'document', 'docs', 'readme', 'changelog', 'comment', 'jsdoc',
-      'tutorial', 'guide', 'explain', 'describe', 'markdown'
-    ]
-
-    // Testing indicators
-    const testingKeywords = [
-      'test', 'spec',
-      // JS/TS
-      'bun', 'bun test', 'jest', 'mocha', 'cypress', 'playwright',
-      // Python
-      'pytest', 'unittest',
-      // Go
-      'go test',
-      // Rust
-      'cargo test',
-      // .NET
-      'dotnet test',
-      // Java
-      'mvn test', 'gradle test', 'gradlew test',
-      'e2e', 'unit', 'integration', 'coverage', 'mock', 'fixture'
-    ]
-
-    // Count matches
+    const words = taskDescription.toLowerCase().split(/\s+/)
     const scores: Record<ContextDomain, number> = {
-      frontend: frontendKeywords.filter(k => lower.includes(k)).length,
-      backend: backendKeywords.filter(k => lower.includes(k)).length,
-      devops: devopsKeywords.filter(k => lower.includes(k)).length,
-      docs: docsKeywords.filter(k => lower.includes(k)).length,
-      testing: testingKeywords.filter(k => lower.includes(k)).length,
-      general: 0,
+      frontend: 0, backend: 0, devops: 0, docs: 0, testing: 0, general: 0
+    }
+
+    // Single pass: check each word against the map
+    for (const word of words) {
+      const domain = KEYWORD_DOMAIN_MAP.get(word)
+      if (domain) {
+        scores[domain]++
+      }
     }
 
     // Find primary and secondary domains
@@ -139,14 +109,16 @@ class SmartContext {
       agent => relevantDomains.includes(agent.domain)
     )
 
-    // Enrich with performance data
-    for (const agent of filteredAgents) {
-      const perf = await agentPerformanceTracker.getAgentPerformance(
-        projectId,
-        agent.name
-      )
+    // OPTIMIZED: Enrich with performance data in parallel
+    const perfPromises = filteredAgents.map(agent =>
+      agentPerformanceTracker.getAgentPerformance(projectId, agent.name)
+    )
+    const perfResults = await Promise.all(perfPromises)
+
+    for (let i = 0; i < filteredAgents.length; i++) {
+      const perf = perfResults[i]
       if (perf) {
-        agent.successRate = perf.successRate
+        filteredAgents[i].successRate = perf.successRate
       }
     }
 

package/core/infrastructure/path-manager.ts

@@ -115,20 +115,20 @@ class PathManager {
   /**
    * Ensure the project-specific global structure exists
    * Creates the layered directory structure for a project
+   * OPTIMIZED: Parallel directory creation
    */
   async ensureProjectStructure(projectId: string): Promise<string> {
     await this.ensureGlobalStructure()
 
     const projectPath = this.getGlobalProjectPath(projectId)
 
-    const layers = ['core', 'progress', 'planning', 'analysis', 'memory', 'agents']
+    // OPTIMIZED: Create all directories in parallel
+    const dirs = [
+      'core', 'progress', 'planning', 'analysis', 'memory', 'agents',
+      'planning/tasks', 'sessions', 'storage', 'context', 'sync'
+    ].map(dir => path.join(projectPath, dir))
 
-    for (const layer of layers) {
-      await fileHelper.ensureDir(path.join(projectPath, layer))
-    }
-
-    await fileHelper.ensureDir(path.join(projectPath, 'planning', 'tasks'))
-    await fileHelper.ensureDir(path.join(projectPath, 'sessions'))
+    await Promise.all(dirs.map(dir => fileHelper.ensureDir(dir)))
 
     return projectPath
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.28.3",
+  "version": "0.28.4",
   "description": "Built for Claude - Ship fast, track progress, stay focused. Developer momentum tool for indie hackers.",
   "main": "core/index.ts",
   "bin": {