prjct-cli 0.60.0 → 0.60.1

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## [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/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/dist/bin/prjct.mjs

@@ -18093,72 +18093,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 +26412,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.60.0",
+      version: "0.60.1",
       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.1",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {