prjct-cli 0.60.0 → 0.60.2

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # Changelog
 
+## [0.60.2] - 2026-02-05
+
+### Performance
+
+- parallelize agent/skill loading with Promise.all (PRJ-110) (#101)
+
+
+## [0.60.2] - 2026-02-05
+
+### Performance
+
+- **Parallel agent/skill loading (PRJ-110)**: Agent and skill loading now uses `Promise.all` for parallel I/O
+
+### Implementation Details
+
+Refactored `loadAgents()` and `loadSkills()` in `core/agentic/orchestrator-executor.ts` to use `Promise.all` with map instead of sequential for loops. Also parallelized `loadAllAgents()` in `core/domain/agent-loader.ts`. Pattern: collect items → map to async promises → Promise.all → filter nulls with type guard.
+
+### Learnings
+
+- Use `Promise.all(items.map(async (item) => ...))` for parallel async operations
+- Return null for failed items, then filter - can't push to array in parallel
+- Collect unique items first (deduplication), then parallelize reads
+
+### Test Plan
+
+#### For QA
+1. Run `prjct sync --yes` - verify agents load successfully
+2. Run `p. task "test"` - verify orchestrator works
+3. Check no errors in agent/skill loading output
+
+#### For Users
+- Agent and skill loading is now faster (parallel I/O)
+- No changes needed - improvement is automatic
+
+
+## [0.60.1] - 2026-02-05
+
+### Bug Fixes
+
+- improve sync output with summary-first format (PRJ-100) (#100)
+
+
+## [0.60.1] - 2026-02-05
+
+### Improved
+
+- **Sync output UX (PRJ-100)**: Summary-first format with key metrics prominent, ~50% less output
+
+### Implementation Details
+
+Refactored `showSyncResult()` in `core/commands/analysis.ts` to show success line with timing immediately, followed by single-line metrics (files → context | agents | reduction). Removed redundant bottom summary section. Fixed compressionRate calculation (was decimal, now percentage). Added conditional display for low-value metrics (only show reduction if >10%). Fixed pluralization ("1 skill" not "1 skills").
+
+### Learnings
+
+- `syncMetrics.compressionRate` is a decimal (0-1), not percentage - multiply by 100
+- Summary-first output pattern improves scannability
+- Conditional metric display reduces noise for low-value data
+
+### Test Plan
+
+#### For QA
+1. Run `prjct sync --yes` on any project
+2. Verify output shows success line first with timing: `✅ Synced {project} ({time}s)`
+3. Verify single-line metrics: `{files} files → {context} context | {agents} agents`
+4. Verify compression rate only shows if > 10%
+5. Verify pluralization is correct ("1 skill" not "1 skills")
+
+#### For Users
+- Sync output is now more scannable - key metrics appear first instead of buried at bottom
+- Run `p. sync` as usual - new format is automatic
+- No breaking changes
+
+
 ## [0.60.0] - 2026-02-05
 
 ### Features

package/core/agentic/orchestrator-executor.ts

@@ -341,13 +341,15 @@ export class OrchestratorExecutor {
    *
    * Reads agent markdown files from {globalPath}/agents/
    * and extracts their content and skills from frontmatter.
+   *
+   * Uses parallel file reads for performance (PRJ-110).
    */
   async loadAgents(domains: string[], projectId: string): Promise<LoadedAgent[]> {
     const globalPath = pathManager.getGlobalProjectPath(projectId)
     const agentsDir = path.join(globalPath, 'agents')
-    const agents: LoadedAgent[] = []
 
-    for (const domain of domains) {
+    // Load all domain agents in parallel
+    const agentPromises = domains.map(async (domain): Promise<LoadedAgent | null> => {
       // Try exact match first, then variations
       const possibleNames = [`${domain}.md`, `${domain}-agent.md`, `prjct-${domain}.md`]
 
@@ -357,21 +359,22 @@ export class OrchestratorExecutor {
           const content = await fs.readFile(filePath, 'utf-8')
           const { frontmatter, body } = this.parseAgentFile(content)
 
-          agents.push({
+          return {
             name: fileName.replace('.md', ''),
             domain,
             content: body,
             skills: frontmatter.skills || [],
             filePath,
-          })
-
-          // Found one, no need to try other variations
-          break
-        } catch {}
+          }
+        } catch {
+          // Try next variation
+        }
       }
-    }
+      return null
+    })
 
-    return agents
+    const results = await Promise.all(agentPromises)
+    return results.filter((agent): agent is LoadedAgent => agent !== null)
   }
 
   /**
@@ -400,51 +403,46 @@ export class OrchestratorExecutor {
    * Load skills from agent frontmatter
    *
    * Skills are stored in ~/.claude/skills/{name}.md
+   *
+   * Uses parallel file reads for performance (PRJ-110).
    */
   async loadSkills(agents: LoadedAgent[]): Promise<LoadedSkill[]> {
     const skillsDir = path.join(os.homedir(), '.claude', 'skills')
-    const skills: LoadedSkill[] = []
-    const loadedSkillNames = new Set<string>()
 
+    // Collect unique skill names from all agents
+    const uniqueSkillNames = new Set<string>()
     for (const agent of agents) {
       for (const skillName of agent.skills) {
-        // Skip if already loaded
-        if (loadedSkillNames.has(skillName)) continue
+        uniqueSkillNames.add(skillName)
+      }
+    }
 
+    // Load all skills in parallel
+    const skillPromises = Array.from(uniqueSkillNames).map(
+      async (skillName): Promise<LoadedSkill | null> => {
         // Check both patterns: flat file and subdirectory (ecosystem standard)
         const flatPath = path.join(skillsDir, `${skillName}.md`)
         const subdirPath = path.join(skillsDir, skillName, 'SKILL.md')
 
-        let content: string | null = null
-        let resolvedPath = flatPath
-
         // Prefer subdirectory format (ecosystem standard)
         try {
-          content = await fs.readFile(subdirPath, 'utf-8')
-          resolvedPath = subdirPath
+          const content = await fs.readFile(subdirPath, 'utf-8')
+          return { name: skillName, content, filePath: subdirPath }
         } catch {
           // Fall back to flat file
           try {
-            content = await fs.readFile(flatPath, 'utf-8')
-            resolvedPath = flatPath
+            const content = await fs.readFile(flatPath, 'utf-8')
+            return { name: skillName, content, filePath: flatPath }
           } catch {
             // Skill not found - not an error, just skip
-            console.warn(`Skill not found: ${skillName}`)
+            return null
           }
         }
-
-        if (content) {
-          skills.push({
-            name: skillName,
-            content,
-            filePath: resolvedPath,
-          })
-          loadedSkillNames.add(skillName)
-        }
       }
-    }
+    )
 
-    return skills
+    const results = await Promise.all(skillPromises)
+    return results.filter((skill): skill is LoadedSkill => skill !== null)
   }
 
   /**

package/core/commands/analysis.ts

@@ -455,89 +455,97 @@ export class AnalysisCommands extends PrjctCommandsBase {
 
   /**
    * Display sync results (extracted to avoid duplication)
+   *
+   * UX Design (PRJ-100):
+   * - Summary first: success + key metrics on first lines
+   * - Scannable: single-line metrics, minimal vertical space
+   * - Changes focused: show what changed, not everything that exists
+   * - Next steps prominent: clear call to action at bottom
    */
   private async showSyncResult(
     result: Awaited<ReturnType<typeof syncService.sync>>,
     startTime: number
   ): Promise<CommandResult> {
-    // Update global config
-    const globalConfigResult = await commandInstaller.installGlobalConfig()
-    if (globalConfigResult.success) {
-      console.log(`📝 Updated ${pathManager.getDisplayPath(globalConfigResult.path!)}`)
+    const elapsed = Date.now() - startTime
+    const contextFilesCount =
+      result.contextFiles.length + (result.aiTools?.filter((t) => t.success).length || 0)
+    const agentCount = result.agents.length
+    const domainAgentCount = result.agents.filter((a) => a.type === 'domain').length
+
+    // Update global config (silent - don't clutter output)
+    await commandInstaller.installGlobalConfig()
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // SUCCESS LINE - Immediate confirmation with timing
+    // ═══════════════════════════════════════════════════════════════════════
+    console.log(`✅ Synced ${result.stats.name || 'project'} (${(elapsed / 1000).toFixed(1)}s)\n`)
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // KEY METRICS - Single scannable line
+    // ═══════════════════════════════════════════════════════════════════════
+    // Only show compression rate if meaningful (> 10%)
+    const compressionPct = result.syncMetrics?.compressionRate
+      ? Math.round(result.syncMetrics.compressionRate * 100)
+      : 0
+    const metricsLine = [
+      `${result.stats.fileCount} files → ${contextFilesCount} context`,
+      `${agentCount} agents`,
+      compressionPct > 10 ? `${compressionPct}% reduction` : null,
+    ]
+      .filter(Boolean)
+      .join(' | ')
+    console.log(metricsLine)
+
+    // Stack and branch info
+    const framework = result.stats.frameworks.length > 0 ? ` (${result.stats.frameworks[0]})` : ''
+    console.log(`Stack: ${result.stats.ecosystem}${framework} | Branch: ${result.git.branch}\n`)
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // CHANGES SECTION - What was generated/updated
+    // ═══════════════════════════════════════════════════════════════════════
+    console.log('Generated:')
+
+    // Context files (condensed)
+    if (result.contextFiles.length > 0) {
+      console.log(`  ✓ ${result.contextFiles.length} context files`)
     }
 
-    // Format output
-    console.log(`🔄 Project synced to prjct v${result.cliVersion}\n`)
-
-    console.log('📊 Project Stats')
-    console.log(`├── Files: ~${result.stats.fileCount}`)
-    console.log(`├── Commits: ${result.git.commits}`)
-    console.log(`├── Version: ${result.stats.version}`)
-    console.log(`└── Stack: ${result.stats.ecosystem}\n`)
-
-    console.log('🌿 Git Status')
-    console.log(`├── Branch: ${result.git.branch}`)
-    console.log(`├── Uncommitted: ${result.git.hasChanges ? 'Yes' : 'Clean'}`)
-    console.log(`└── Recent: ${result.git.weeklyCommits} commits this week\n`)
-
-    console.log('📁 Context Updated')
-    for (const file of result.contextFiles) {
-      console.log(`├── ${file}`)
+    // AI tools
+    const successTools = result.aiTools?.filter((t) => t.success) || []
+    if (successTools.length > 0) {
+      const toolNames = successTools.map((t) => t.toolId).join(', ')
+      console.log(`  ✓ AI tools: ${toolNames}`)
     }
-    console.log('')
 
-    // Show AI Tools generated (multi-agent output)
-    if (result.aiTools && result.aiTools.length > 0) {
-      const successTools = result.aiTools.filter((t) => t.success)
-      console.log(`🤖 AI Tools Context (${successTools.length})`)
-      for (const tool of result.aiTools) {
-        const status = tool.success ? '✓' : '✗'
-        console.log(`├── ${status} ${tool.outputFile} (${tool.toolId})`)
-      }
-      console.log('')
+    // Agents (show count with breakdown)
+    if (agentCount > 0) {
+      const agentSummary =
+        domainAgentCount > 0
+          ? `${agentCount} agents (${domainAgentCount} domain)`
+          : `${agentCount} agents`
+      console.log(`  ✓ ${agentSummary}`)
     }
 
-    const workflowAgents = result.agents.filter((a) => a.type === 'workflow').map((a) => a.name)
-    const domainAgents = result.agents.filter((a) => a.type === 'domain').map((a) => a.name)
-
-    console.log(`🤖 Agents Regenerated (${result.agents.length})`)
-    console.log(`├── Workflow: ${workflowAgents.join(', ')}`)
-    console.log(`└── Domain: ${domainAgents.join(', ') || 'none'}\n`)
-
+    // Skills
     if (result.skills.length > 0) {
-      console.log('📦 Skills Configured')
-      for (const skill of result.skills) {
-        console.log(`├── ${skill.agent}.md → ${skill.skill}`)
-      }
-      console.log('')
+      const skillWord = result.skills.length === 1 ? 'skill' : 'skills'
+      console.log(`  ✓ ${result.skills.length} ${skillWord}`)
     }
 
+    console.log('')
+
+    // ═══════════════════════════════════════════════════════════════════════
+    // STATUS INDICATOR - Repository state
+    // ═══════════════════════════════════════════════════════════════════════
     if (result.git.hasChanges) {
-      console.log('⚠️  You have uncommitted changes\n')
-    } else {
-      console.log('✨ Repository is clean!\n')
+      console.log('⚠️  Uncommitted changes detected\n')
     }
 
+    // ═══════════════════════════════════════════════════════════════════════
+    // NEXT STEPS - Clear call to action
+    // ═══════════════════════════════════════════════════════════════════════
     showNextSteps('sync')
 
-    // Summary metrics
-    const elapsed = Date.now() - startTime
-    const contextFilesCount =
-      result.contextFiles.length + (result.aiTools?.filter((t) => t.success).length || 0)
-    const agentCount = result.agents.length
-
-    console.log('─'.repeat(45))
-    console.log('📊 Sync Summary')
-    console.log(
-      `   Stack: ${result.stats.ecosystem} (${result.stats.frameworks.join(', ') || 'no frameworks'})`
-    )
-    console.log(`   Files: ${result.stats.fileCount} analyzed → ${contextFilesCount} context files`)
-    console.log(
-      `   Agents: ${agentCount} (${result.agents.filter((a) => a.type === 'domain').length} domain)`
-    )
-    console.log(`   Time: ${(elapsed / 1000).toFixed(1)}s`)
-    console.log('')
-
     return {
       success: true,
       data: result,

package/core/domain/agent-loader.ts

@@ -94,22 +94,22 @@ class AgentLoader {
 
   /**
    * Load all agents for the project
+   *
+   * Uses parallel file reads for performance (PRJ-110).
    */
   async loadAllAgents(): Promise<Agent[]> {
     try {
       const files = await fs.readdir(this.agentsDir)
       const agentFiles = files.filter((f) => f.endsWith('.md') && !f.startsWith('.'))
 
-      const agents: Agent[] = []
-      for (const file of agentFiles) {
+      // Load all agents in parallel
+      const agentPromises = agentFiles.map((file) => {
         const agentName = file.replace('.md', '')
-        const agent = await this.loadAgent(agentName)
-        if (agent) {
-          agents.push(agent)
-        }
-      }
+        return this.loadAgent(agentName)
+      })
 
-      return agents
+      const results = await Promise.all(agentPromises)
+      return results.filter((agent): agent is Agent => agent !== null)
     } catch (error) {
       if (isNotFoundError(error)) {
         return [] // Agents directory doesn't exist yet

package/dist/bin/prjct.mjs

@@ -11788,31 +11788,33 @@ var init_orchestrator_executor = __esm({
        *
        * Reads agent markdown files from {globalPath}/agents/
        * and extracts their content and skills from frontmatter.
+       *
+       * Uses parallel file reads for performance (PRJ-110).
        */
       async loadAgents(domains, projectId) {
         const globalPath = path_manager_default.getGlobalProjectPath(projectId);
         const agentsDir = path23.join(globalPath, "agents");
-        const agents = [];
-        for (const domain of domains) {
+        const agentPromises = domains.map(async (domain) => {
           const possibleNames = [`${domain}.md`, `${domain}-agent.md`, `prjct-${domain}.md`];
           for (const fileName of possibleNames) {
             const filePath = path23.join(agentsDir, fileName);
             try {
               const content = await fs24.readFile(filePath, "utf-8");
               const { frontmatter, body } = this.parseAgentFile(content);
-              agents.push({
+              return {
                 name: fileName.replace(".md", ""),
                 domain,
                 content: body,
                 skills: frontmatter.skills || [],
                 filePath
-              });
-              break;
+              };
             } catch {
             }
           }
-        }
-        return agents;
+          return null;
+        });
+        const results = await Promise.all(agentPromises);
+        return results.filter((agent) => agent !== null);
       }
       /**
        * Parse agent markdown file to extract frontmatter and body
@@ -11832,40 +11834,36 @@ var init_orchestrator_executor = __esm({
        * Load skills from agent frontmatter
        *
        * Skills are stored in ~/.claude/skills/{name}.md
+       *
+       * Uses parallel file reads for performance (PRJ-110).
        */
       async loadSkills(agents) {
         const skillsDir = path23.join(os8.homedir(), ".claude", "skills");
-        const skills = [];
-        const loadedSkillNames = /* @__PURE__ */ new Set();
+        const uniqueSkillNames = /* @__PURE__ */ new Set();
         for (const agent of agents) {
           for (const skillName of agent.skills) {
-            if (loadedSkillNames.has(skillName)) continue;
+            uniqueSkillNames.add(skillName);
+          }
+        }
+        const skillPromises = Array.from(uniqueSkillNames).map(
+          async (skillName) => {
             const flatPath = path23.join(skillsDir, `${skillName}.md`);
             const subdirPath = path23.join(skillsDir, skillName, "SKILL.md");
-            let content = null;
-            let resolvedPath = flatPath;
             try {
-              content = await fs24.readFile(subdirPath, "utf-8");
-              resolvedPath = subdirPath;
+              const content = await fs24.readFile(subdirPath, "utf-8");
+              return { name: skillName, content, filePath: subdirPath };
             } catch {
               try {
-                content = await fs24.readFile(flatPath, "utf-8");
-                resolvedPath = flatPath;
+                const content = await fs24.readFile(flatPath, "utf-8");
+                return { name: skillName, content, filePath: flatPath };
               } catch {
-                console.warn(`Skill not found: ${skillName}`);
+                return null;
               }
             }
-            if (content) {
-              skills.push({
-                name: skillName,
-                content,
-                filePath: resolvedPath
-              });
-              loadedSkillNames.add(skillName);
-            }
           }
-        }
-        return skills;
+        );
+        const results = await Promise.all(skillPromises);
+        return results.filter((skill) => skill !== null);
       }
       /**
        * Determine if task should be fragmented into subtasks
@@ -18093,72 +18091,53 @@ ${formatFullDiff(diff)}`);
       }
       /**
        * Display sync results (extracted to avoid duplication)
+       *
+       * UX Design (PRJ-100):
+       * - Summary first: success + key metrics on first lines
+       * - Scannable: single-line metrics, minimal vertical space
+       * - Changes focused: show what changed, not everything that exists
+       * - Next steps prominent: clear call to action at bottom
        */
       async showSyncResult(result, startTime) {
-        const globalConfigResult = await command_installer_default.installGlobalConfig();
-        if (globalConfigResult.success) {
-          console.log(`\u{1F4DD} Updated ${path_manager_default.getDisplayPath(globalConfigResult.path)}`);
-        }
-        console.log(`\u{1F504} Project synced to prjct v${result.cliVersion}
-`);
-        console.log("\u{1F4CA} Project Stats");
-        console.log(`\u251C\u2500\u2500 Files: ~${result.stats.fileCount}`);
-        console.log(`\u251C\u2500\u2500 Commits: ${result.git.commits}`);
-        console.log(`\u251C\u2500\u2500 Version: ${result.stats.version}`);
-        console.log(`\u2514\u2500\u2500 Stack: ${result.stats.ecosystem}
+        const elapsed = Date.now() - startTime;
+        const contextFilesCount = result.contextFiles.length + (result.aiTools?.filter((t) => t.success).length || 0);
+        const agentCount = result.agents.length;
+        const domainAgentCount = result.agents.filter((a) => a.type === "domain").length;
+        await command_installer_default.installGlobalConfig();
+        console.log(`\u2705 Synced ${result.stats.name || "project"} (${(elapsed / 1e3).toFixed(1)}s)
 `);
-        console.log("\u{1F33F} Git Status");
-        console.log(`\u251C\u2500\u2500 Branch: ${result.git.branch}`);
-        console.log(`\u251C\u2500\u2500 Uncommitted: ${result.git.hasChanges ? "Yes" : "Clean"}`);
-        console.log(`\u2514\u2500\u2500 Recent: ${result.git.weeklyCommits} commits this week
+        const compressionPct = result.syncMetrics?.compressionRate ? Math.round(result.syncMetrics.compressionRate * 100) : 0;
+        const metricsLine = [
+          `${result.stats.fileCount} files \u2192 ${contextFilesCount} context`,
+          `${agentCount} agents`,
+          compressionPct > 10 ? `${compressionPct}% reduction` : null
+        ].filter(Boolean).join(" | ");
+        console.log(metricsLine);
+        const framework = result.stats.frameworks.length > 0 ? ` (${result.stats.frameworks[0]})` : "";
+        console.log(`Stack: ${result.stats.ecosystem}${framework} | Branch: ${result.git.branch}
 `);
-        console.log("\u{1F4C1} Context Updated");
-        for (const file of result.contextFiles) {
-          console.log(`\u251C\u2500\u2500 ${file}`);
+        console.log("Generated:");
+        if (result.contextFiles.length > 0) {
+          console.log(`  \u2713 ${result.contextFiles.length} context files`);
         }
-        console.log("");
-        if (result.aiTools && result.aiTools.length > 0) {
-          const successTools = result.aiTools.filter((t) => t.success);
-          console.log(`\u{1F916} AI Tools Context (${successTools.length})`);
-          for (const tool of result.aiTools) {
-            const status = tool.success ? "\u2713" : "\u2717";
-            console.log(`\u251C\u2500\u2500 ${status} ${tool.outputFile} (${tool.toolId})`);
-          }
-          console.log("");
+        const successTools = result.aiTools?.filter((t) => t.success) || [];
+        if (successTools.length > 0) {
+          const toolNames = successTools.map((t) => t.toolId).join(", ");
+          console.log(`  \u2713 AI tools: ${toolNames}`);
+        }
+        if (agentCount > 0) {
+          const agentSummary = domainAgentCount > 0 ? `${agentCount} agents (${domainAgentCount} domain)` : `${agentCount} agents`;
+          console.log(`  \u2713 ${agentSummary}`);
         }
-        const workflowAgents = result.agents.filter((a) => a.type === "workflow").map((a) => a.name);
-        const domainAgents = result.agents.filter((a) => a.type === "domain").map((a) => a.name);
-        console.log(`\u{1F916} Agents Regenerated (${result.agents.length})`);
-        console.log(`\u251C\u2500\u2500 Workflow: ${workflowAgents.join(", ")}`);
-        console.log(`\u2514\u2500\u2500 Domain: ${domainAgents.join(", ") || "none"}
-`);
         if (result.skills.length > 0) {
-          console.log("\u{1F4E6} Skills Configured");
-          for (const skill of result.skills) {
-            console.log(`\u251C\u2500\u2500 ${skill.agent}.md \u2192 ${skill.skill}`);
-          }
-          console.log("");
+          const skillWord = result.skills.length === 1 ? "skill" : "skills";
+          console.log(`  \u2713 ${result.skills.length} ${skillWord}`);
         }
+        console.log("");
         if (result.git.hasChanges) {
-          console.log("\u26A0\uFE0F  You have uncommitted changes\n");
-        } else {
-          console.log("\u2728 Repository is clean!\n");
+          console.log("\u26A0\uFE0F  Uncommitted changes detected\n");
         }
         showNextSteps("sync");
-        const elapsed = Date.now() - startTime;
-        const contextFilesCount = result.contextFiles.length + (result.aiTools?.filter((t) => t.success).length || 0);
-        const agentCount = result.agents.length;
-        console.log("\u2500".repeat(45));
-        console.log("\u{1F4CA} Sync Summary");
-        console.log(
-          `   Stack: ${result.stats.ecosystem} (${result.stats.frameworks.join(", ") || "no frameworks"})`
-        );
-        console.log(`   Files: ${result.stats.fileCount} analyzed \u2192 ${contextFilesCount} context files`);
-        console.log(
-          `   Agents: ${agentCount} (${result.agents.filter((a) => a.type === "domain").length} domain)`
-        );
-        console.log(`   Time: ${(elapsed / 1e3).toFixed(1)}s`);
-        console.log("");
         return {
           success: true,
           data: result,
@@ -26431,7 +26410,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.60.0",
+      version: "0.60.2",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.60.0",
+  "version": "0.60.2",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {