prjct-cli 0.55.3 → 0.56.0

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # Changelog
 
+## [0.56.0] - 2026-02-05
+
+### Features
+
+- implement output tiers for cleaner CLI output (#88)
+
+### Bug Fixes
+
+- make lefthook hooks portable (no bun required) (#92)
+- skip lefthook in CI environments (#91)
+- use npm instead of bun in lefthook hooks (#90)
+- add pre-commit hooks to prevent commits with lint errors (#89)
+
+
+## [0.55.6] - 2026-02-04
+
+### Fixed
+
+- **Portable git hooks**: Removed `skip_in_ci` and test from pre-push hook - hooks now work everywhere with npm-only commands (lint, typecheck). Tests run in CI where bun is properly installed.
+
+## [0.55.5] - 2026-02-05
+
+### Added
+
+- **Pre-commit hooks**: Added lefthook for git hooks - blocks commits with lint/format errors
+- **Pre-push hooks**: Runs typecheck and tests before push
+
+### Fixed
+
+- Fixed 3 lint errors (import ordering, formatting)
+
+## [0.55.4] - 2026-02-05
+
+### Features
+
+- **Output tiers**: New tiered output system (silent/minimal/compact/verbose) for cleaner CLI output
+- **Human-friendly Linear output**: `p. linear list` now shows concise table instead of raw JSON
+- **--json flag**: Use `--json` to get machine-parseable JSON output when needed
+- **--verbose flag**: Use `--verbose` for full untruncated output
+
+### Improved
+
+- Removed noisy `[linear] Connected as...` messages from every API call
+- Added `limitLines()` and `formatForHuman()` utilities for consistent output formatting
+
+### Bug Fixes
+
+- remove legacy p.*.md commands on sync
+
+### Tests
+
+- Added 11 new tests for output tier functionality
+
 ## [0.55.3] - 2026-02-05
 
 ### Bug Fixes

package/core/__tests__/utils/output.test.ts

@@ -4,7 +4,14 @@
  */
 
 import { afterEach, beforeEach, describe, expect, it, spyOn } from 'bun:test'
-import out from '../../utils/output'
+import out, {
+  formatForHuman,
+  getOutputTier,
+  getTierConfig,
+  limitLines,
+  OUTPUT_TIERS,
+  setOutputTier,
+} from '../../utils/output'
 
 describe('Output Module', () => {
   let consoleLogSpy: ReturnType<typeof spyOn>
@@ -151,4 +158,115 @@ describe('Output Module', () => {
       expect(consoleLogSpy).toHaveBeenCalled()
     })
   })
+
+  describe('Output Tiers', () => {
+    afterEach(() => {
+      setOutputTier('compact') // Reset to default
+    })
+
+    it('should have correct tier configs', () => {
+      expect(OUTPUT_TIERS.silent.maxLines).toBe(0)
+      expect(OUTPUT_TIERS.minimal.maxLines).toBe(1)
+      expect(OUTPUT_TIERS.compact.maxLines).toBe(4)
+      expect(OUTPUT_TIERS.verbose.maxLines).toBe(Infinity)
+    })
+
+    it('should get and set output tier', () => {
+      setOutputTier('verbose')
+      expect(getOutputTier()).toBe('verbose')
+
+      setOutputTier('minimal')
+      expect(getOutputTier()).toBe('minimal')
+    })
+
+    it('should return correct tier config', () => {
+      setOutputTier('compact')
+      const config = getTierConfig()
+      expect(config.maxLines).toBe(4)
+      expect(config.maxCharsPerLine).toBe(80)
+      expect(config.showMetrics).toBe(true)
+    })
+  })
+
+  describe('limitLines()', () => {
+    it('should limit content to maxLines', () => {
+      setOutputTier('compact') // maxLines = 4
+      const content = 'line1\nline2\nline3\nline4\nline5\nline6'
+      const result = limitLines(content)
+
+      expect(result.split('\n').length).toBe(5) // 4 lines + "...2 more lines"
+      expect(result).toContain('...2 more lines')
+    })
+
+    it('should not truncate if under limit', () => {
+      setOutputTier('compact')
+      const content = 'line1\nline2'
+      const result = limitLines(content)
+
+      expect(result).toBe(content)
+    })
+
+    it('should respect custom maxLines parameter', () => {
+      const content = 'line1\nline2\nline3\nline4'
+      const result = limitLines(content, 2)
+
+      expect(result.split('\n').length).toBe(3) // 2 lines + indicator
+      expect(result).toContain('...2 more lines')
+    })
+
+    it('should return content unchanged for verbose tier', () => {
+      setOutputTier('verbose')
+      const content = 'line1\nline2\nline3\nline4\nline5'
+      const result = limitLines(content)
+
+      expect(result).toBe(content)
+    })
+  })
+
+  describe('formatForHuman()', () => {
+    afterEach(() => {
+      setOutputTier('compact')
+    })
+
+    it('should format Linear issue object', () => {
+      const issue = {
+        identifier: 'PRJ-123',
+        title: 'Test issue title',
+        status: 'in_progress',
+        priority: 'high',
+        url: 'https://linear.app/test',
+      }
+
+      const result = formatForHuman(issue)
+      expect(result).toContain('PRJ-123')
+      expect(result).toContain('Test issue title')
+      expect(result).toContain('in_progress')
+    })
+
+    it('should format issue list', () => {
+      const list = {
+        issues: [
+          { identifier: 'PRJ-1', title: 'First issue', priority: 'high' },
+          { identifier: 'PRJ-2', title: 'Second issue', priority: 'none' },
+        ],
+      }
+
+      const result = formatForHuman(list)
+      expect(result).toContain('PRJ-1')
+      expect(result).toContain('PRJ-2')
+    })
+
+    it('should return empty string for silent tier', () => {
+      setOutputTier('silent')
+      const result = formatForHuman({ test: 'data' })
+      expect(result).toBe('')
+    })
+
+    it('should return full JSON for verbose tier', () => {
+      setOutputTier('verbose')
+      const data = { test: 'data', nested: { key: 'value' } }
+      const result = formatForHuman(data)
+      expect(result).toBe(JSON.stringify(data, null, 2))
+    })
+  })
 })

package/core/cli/linear.ts

@@ -4,6 +4,11 @@
  *
  * Usage: bun core/cli/linear.ts --project <projectId> <command> [args...]
  *
+ * Flags:
+ *   --project <id>   - Project ID (required)
+ *   --json           - Output raw JSON (default: human-readable)
+ *   --verbose        - Show all details (no truncation)
+ *
  * Commands:
  *   setup <apiKey> [teamId]    - Store API key in project credentials
  *   list                       - List my assigned issues
@@ -21,11 +26,12 @@
  *   projects                   - List available projects
  *   status                     - Check connection status
  *
- * All output is JSON for easy parsing by Claude.
+ * Default output is human-readable. Use --json for machine parsing.
  */
 
 import type { CreateIssueInput, Issue } from '../integrations/issue-tracker/types'
 import { linearService, linearSync } from '../integrations/linear'
+import { formatForHuman, setOutputTier } from '../utils/output'
 import {
   getCredentialSource,
   getLinearApiKey,
@@ -44,20 +50,41 @@ if (projectIdx !== -1 && args[projectIdx + 1]) {
   args.splice(projectIdx, 2)
 }
 
+// Extract --json flag (raw JSON output)
+const jsonIdx = args.indexOf('--json')
+const jsonMode = jsonIdx !== -1
+if (jsonMode) args.splice(jsonIdx, 1)
+
+// Extract --verbose flag
+const verboseIdx = args.indexOf('--verbose')
+const verboseMode = verboseIdx !== -1
+if (verboseMode) {
+  args.splice(verboseIdx, 1)
+  setOutputTier('verbose')
+}
+
 const [command, ...commandArgs] = args
 
 /**
- * Output result as JSON
+ * Output result - human-readable by default, JSON with --json flag
  */
 function output(data: unknown): void {
-  console.log(JSON.stringify(data, null, 2))
+  if (jsonMode) {
+    console.log(JSON.stringify(data, null, 2))
+  } else {
+    console.log(formatForHuman(data))
+  }
 }
 
 /**
- * Output error as JSON and exit
+ * Output error and exit
  */
 function error(message: string, code = 1): never {
-  console.error(JSON.stringify({ error: message }))
+  if (jsonMode) {
+    console.error(JSON.stringify({ error: message }))
+  } else {
+    console.error(`Error: ${message}`)
+  }
   process.exit(code)
 }
 
@@ -148,17 +175,28 @@ async function main(): Promise<void> {
           issues = await linearService.fetchAssignedIssues({ limit })
         }
 
-        output({
-          count: issues.length,
-          issues: issues.map((issue) => ({
-            id: issue.id,
-            identifier: issue.externalId,
-            title: issue.title,
-            status: issue.status,
-            priority: issue.priority,
-            url: issue.url,
-          })),
-        })
+        const issueList = issues.map((issue) => ({
+          id: issue.id,
+          identifier: issue.externalId,
+          title: issue.title,
+          status: issue.status,
+          priority: issue.priority,
+          url: issue.url,
+        }))
+
+        if (jsonMode) {
+          output({ count: issues.length, issues: issueList })
+        } else {
+          // Human-friendly table output
+          console.log(`Your issues (${issues.length}):`)
+          for (const issue of issueList.slice(0, 10)) {
+            const p = issue.priority && issue.priority !== 'none' ? ` [${issue.priority}]` : ''
+            console.log(`  ${issue.identifier}  ${issue.title.slice(0, 50)}${p}`)
+          }
+          if (issues.length > 10) {
+            console.log(`  ...${issues.length - 10} more`)
+          }
+        }
         break
       }
 
@@ -199,7 +237,18 @@ async function main(): Promise<void> {
           error(`Issue not found: ${id}`)
         }
 
-        output(issue)
+        if (jsonMode) {
+          output(issue)
+        } else {
+          // Human-friendly issue display
+          console.log(`${issue.externalId}: ${issue.title}`)
+          console.log(`Status: ${issue.status} | Priority: ${issue.priority || 'none'}`)
+          if (issue.description) {
+            const desc = issue.description.slice(0, 200)
+            console.log(`\n${desc}${issue.description.length > 200 ? '...' : ''}`)
+          }
+          console.log(`\n${issue.url}`)
+        }
         break
       }
 
@@ -371,11 +420,12 @@ async function main(): Promise<void> {
         const creds = await getProjectCredentials(projectId)
 
         if (!apiKey) {
-          output({
-            configured: false,
-            source: 'none',
-            message: 'Linear not configured. Run: p. linear setup',
-          })
+          if (jsonMode) {
+            output({ configured: false, source: 'none', message: 'Linear not configured' })
+          } else {
+            console.log('Linear: Not configured')
+            console.log('Run: p. linear setup')
+          }
           break
         }
 
@@ -384,19 +434,28 @@ async function main(): Promise<void> {
           await linearService.initializeFromApiKey(apiKey, creds.linear?.teamId)
           const teams = await linearService.getTeams()
 
-          output({
-            configured: true,
-            source,
-            teamId: creds.linear?.teamId,
-            teamKey: creds.linear?.teamKey,
-            teamsAvailable: teams.length,
-          })
+          if (jsonMode) {
+            output({
+              configured: true,
+              source,
+              teamId: creds.linear?.teamId,
+              teamKey: creds.linear?.teamKey,
+              teamsAvailable: teams.length,
+            })
+          } else {
+            console.log(`Linear: Connected`)
+            if (creds.linear?.teamKey) {
+              console.log(`Team: ${creds.linear.teamKey}`)
+            }
+            console.log(`Teams: ${teams.length} available`)
+          }
         } catch (err) {
-          output({
-            configured: true,
-            source,
-            connectionError: (err as Error).message,
-          })
+          if (jsonMode) {
+            output({ configured: true, source, connectionError: (err as Error).message })
+          } else {
+            console.log(`Linear: Connection error`)
+            console.log(`Error: ${(err as Error).message}`)
+          }
         }
         break
       }

package/core/infrastructure/command-installer.ts

@@ -569,6 +569,36 @@ export class CommandInstaller {
     }
   }
 
+  /**
+   * Remove legacy p.*.md files from commands root directory
+   * These were replaced by the p/ subdirectory structure in v0.50+
+   */
+  async removeLegacyCommands(): Promise<number> {
+    const aiProvider = require('./ai-provider')
+    const activeProvider = aiProvider.getActiveProvider()
+    const commandsRoot = path.join(activeProvider.configDir, 'commands')
+
+    let removed = 0
+
+    try {
+      const files = await fs.readdir(commandsRoot)
+      const legacyFiles = files.filter((f) => f.startsWith('p.') && f.endsWith('.md'))
+
+      for (const file of legacyFiles) {
+        try {
+          await fs.unlink(path.join(commandsRoot, file))
+          removed++
+        } catch {
+          // Ignore errors removing individual files
+        }
+      }
+    } catch {
+      // Ignore errors if directory doesn't exist
+    }
+
+    return removed
+  }
+
   /**
    * Sync commands - intelligent update that detects and removes orphans
    */
@@ -639,9 +669,9 @@ export class CommandInstaller {
         }
       }
 
-      // Note: We do NOT remove orphaned files
-      // Legacy commands from older versions are preserved
-      // to avoid breaking existing workflows
+      // Remove legacy p.*.md files from commands root (old naming convention)
+      // These were replaced by p/ subdirectory structure
+      await this.removeLegacyCommands()
 
       return results
     } catch (error) {

package/core/integrations/linear/client.ts

@@ -79,11 +79,9 @@ export class LinearProvider implements IssueTrackerProvider {
 
     this.sdk = new LinearSDK({ apiKey })
 
-    // Verify connection
+    // Verify connection silently (no output noise)
     try {
-      const viewer = await this.sdk.viewer
-      // Use stderr for logs to not break JSON output
-      console.error(`[linear] Connected as ${viewer.name} (${viewer.email})`)
+      await this.sdk.viewer
     } catch (error) {
       this.sdk = null
       throw new Error(`Linear connection failed: ${(error as Error).message}`)

package/core/utils/output.ts

@@ -4,8 +4,9 @@
  * With prjct branding
  *
  * Supports --quiet mode for CI/CD and scripting
+ * Supports output tiers: silent, minimal, compact, verbose
  *
- * @see PRJ-130
+ * @see PRJ-105, PRJ-130
  */
 
 import chalk from 'chalk'
@@ -16,6 +17,49 @@ import { getError } from './error-messages'
 const _FRAMES = branding.spinner.frames
 const SPEED = branding.spinner.speed
 
+/**
+ * Output tier configuration
+ * Controls verbosity of CLI output
+ */
+export type OutputTier = 'silent' | 'minimal' | 'compact' | 'verbose'
+
+export interface TierConfig {
+  maxLines: number
+  maxCharsPerLine: number
+  showMetrics: boolean
+}
+
+export const OUTPUT_TIERS: Record<OutputTier, TierConfig> = {
+  silent: { maxLines: 0, maxCharsPerLine: 0, showMetrics: false },
+  minimal: { maxLines: 1, maxCharsPerLine: 65, showMetrics: false },
+  compact: { maxLines: 4, maxCharsPerLine: 80, showMetrics: true },
+  verbose: { maxLines: Infinity, maxCharsPerLine: Infinity, showMetrics: true },
+}
+
+// Current output tier (default: compact for human-readable output)
+let currentTier: OutputTier = 'compact'
+
+/**
+ * Set the output tier
+ */
+export function setOutputTier(tier: OutputTier): void {
+  currentTier = tier
+}
+
+/**
+ * Get current output tier
+ */
+export function getOutputTier(): OutputTier {
+  return currentTier
+}
+
+/**
+ * Get current tier config
+ */
+export function getTierConfig(): TierConfig {
+  return OUTPUT_TIERS[currentTier]
+}
+
 /**
  * Centralized icons for consistent output
  */
@@ -52,8 +96,89 @@ export function isQuietMode(): boolean {
   return quietMode
 }
 
-const truncate = (s: string | undefined | null, max = 50): string =>
-  s && s.length > max ? `${s.slice(0, max - 1)}…` : s || ''
+/**
+ * Truncate string to max chars (uses tier config if no max specified)
+ */
+const truncate = (s: string | undefined | null, max?: number): string => {
+  const limit = max ?? (getTierConfig().maxCharsPerLine || 50)
+  return s && s.length > limit ? `${s.slice(0, limit - 1)}…` : s || ''
+}
+
+/**
+ * Limit output to maxLines (respects tier config)
+ * Returns truncated content with "...N more lines" indicator
+ */
+/**
+ * Limit output to maxLines (respects tier config)
+ * Returns truncated content with "...N more lines" indicator
+ */
+export function limitLines(content: string, maxLines?: number): string {
+  const limit = maxLines ?? getTierConfig().maxLines
+  if (limit === Infinity || limit === 0) return content
+
+  const lines = content.split('\n')
+  if (lines.length <= limit) return content
+
+  const shown = lines.slice(0, limit)
+  const remaining = lines.length - limit
+  return `${shown.join('\n')}\n${chalk.dim(`...${remaining} more lines`)}`
+}
+
+/**
+ * Format data for human-readable output (respects tier)
+ * Use this instead of JSON.stringify for CLI output
+ */
+export function formatForHuman(data: unknown): string {
+  const tier = getTierConfig()
+
+  if (currentTier === 'silent') return ''
+  if (currentTier === 'verbose') return JSON.stringify(data, null, 2)
+
+  // For minimal/compact: extract key info
+  if (typeof data !== 'object' || data === null) {
+    return truncate(String(data), tier.maxCharsPerLine)
+  }
+
+  const obj = data as Record<string, unknown>
+
+  // Linear issue format
+  if ('identifier' in obj && 'title' in obj) {
+    const lines: string[] = []
+    lines.push(`${obj.identifier}: ${truncate(String(obj.title), tier.maxCharsPerLine - 10)}`)
+    if (obj.status) lines.push(`Status: ${obj.status}`)
+    if (obj.priority && obj.priority !== 'none') lines.push(`Priority: ${obj.priority}`)
+    if (obj.url && currentTier === 'compact') lines.push(chalk.dim(String(obj.url)))
+    return limitLines(lines.join('\n'), tier.maxLines)
+  }
+
+  // Issue list format
+  if ('issues' in obj && Array.isArray(obj.issues)) {
+    const issues = obj.issues as Array<Record<string, unknown>>
+    const lines = issues.slice(0, tier.maxLines).map((i) => {
+      const priority = i.priority && i.priority !== 'none' ? ` [${i.priority}]` : ''
+      return `${i.identifier}  ${truncate(String(i.title), 50)}${priority}`
+    })
+    if (issues.length > tier.maxLines) {
+      lines.push(chalk.dim(`...${issues.length - tier.maxLines} more`))
+    }
+    return lines.join('\n')
+  }
+
+  // Generic object: show key fields only
+  const keyFields = ['id', 'name', 'title', 'status', 'message', 'success', 'error']
+  const relevant = keyFields.filter((k) => k in obj)
+  if (relevant.length > 0) {
+    return limitLines(
+      relevant
+        .map((k) => `${k}: ${truncate(String(obj[k]), tier.maxCharsPerLine - k.length - 2)}`)
+        .join('\n'),
+      tier.maxLines
+    )
+  }
+
+  // Fallback: compact JSON
+  return limitLines(JSON.stringify(data, null, 2), tier.maxLines)
+}
 
 const clear = (): boolean => process.stdout.write(`\r${' '.repeat(80)}\r`)
 

package/dist/bin/prjct.mjs

@@ -2088,20 +2088,82 @@ var output_exports = {};
 __export(output_exports, {
   ERRORS: () => ERRORS,
   ICONS: () => ICONS,
+  OUTPUT_TIERS: () => OUTPUT_TIERS,
   createError: () => createError,
   default: () => output_default,
+  formatForHuman: () => formatForHuman,
   getError: () => getError,
+  getOutputTier: () => getOutputTier,
+  getTierConfig: () => getTierConfig,
   isQuietMode: () => isQuietMode,
+  limitLines: () => limitLines,
+  setOutputTier: () => setOutputTier,
   setQuietMode: () => setQuietMode
 });
 import chalk2 from "chalk";
+function setOutputTier(tier) {
+  currentTier = tier;
+}
+function getOutputTier() {
+  return currentTier;
+}
+function getTierConfig() {
+  return OUTPUT_TIERS[currentTier];
+}
 function setQuietMode(enabled) {
   quietMode = enabled;
 }
 function isQuietMode() {
   return quietMode;
 }
-var _FRAMES, SPEED, ICONS, interval, frame, quietMode, truncate, clear, out, output_default;
+function limitLines(content, maxLines) {
+  const limit = maxLines ?? getTierConfig().maxLines;
+  if (limit === Infinity || limit === 0) return content;
+  const lines = content.split("\n");
+  if (lines.length <= limit) return content;
+  const shown = lines.slice(0, limit);
+  const remaining = lines.length - limit;
+  return `${shown.join("\n")}
+${chalk2.dim(`...${remaining} more lines`)}`;
+}
+function formatForHuman(data) {
+  const tier = getTierConfig();
+  if (currentTier === "silent") return "";
+  if (currentTier === "verbose") return JSON.stringify(data, null, 2);
+  if (typeof data !== "object" || data === null) {
+    return truncate(String(data), tier.maxCharsPerLine);
+  }
+  const obj = data;
+  if ("identifier" in obj && "title" in obj) {
+    const lines = [];
+    lines.push(`${obj.identifier}: ${truncate(String(obj.title), tier.maxCharsPerLine - 10)}`);
+    if (obj.status) lines.push(`Status: ${obj.status}`);
+    if (obj.priority && obj.priority !== "none") lines.push(`Priority: ${obj.priority}`);
+    if (obj.url && currentTier === "compact") lines.push(chalk2.dim(String(obj.url)));
+    return limitLines(lines.join("\n"), tier.maxLines);
+  }
+  if ("issues" in obj && Array.isArray(obj.issues)) {
+    const issues = obj.issues;
+    const lines = issues.slice(0, tier.maxLines).map((i) => {
+      const priority = i.priority && i.priority !== "none" ? ` [${i.priority}]` : "";
+      return `${i.identifier}  ${truncate(String(i.title), 50)}${priority}`;
+    });
+    if (issues.length > tier.maxLines) {
+      lines.push(chalk2.dim(`...${issues.length - tier.maxLines} more`));
+    }
+    return lines.join("\n");
+  }
+  const keyFields = ["id", "name", "title", "status", "message", "success", "error"];
+  const relevant = keyFields.filter((k) => k in obj);
+  if (relevant.length > 0) {
+    return limitLines(
+      relevant.map((k) => `${k}: ${truncate(String(obj[k]), tier.maxCharsPerLine - k.length - 2)}`).join("\n"),
+      tier.maxLines
+    );
+  }
+  return limitLines(JSON.stringify(data, null, 2), tier.maxLines);
+}
+var _FRAMES, SPEED, OUTPUT_TIERS, currentTier, ICONS, interval, frame, quietMode, truncate, clear, out, output_default;
 var init_output = __esm({
   "core/utils/output.ts"() {
     "use strict";
@@ -2110,6 +2172,16 @@ var init_output = __esm({
     init_error_messages();
     _FRAMES = branding_default.spinner.frames;
     SPEED = branding_default.spinner.speed;
+    OUTPUT_TIERS = {
+      silent: { maxLines: 0, maxCharsPerLine: 0, showMetrics: false },
+      minimal: { maxLines: 1, maxCharsPerLine: 65, showMetrics: false },
+      compact: { maxLines: 4, maxCharsPerLine: 80, showMetrics: true },
+      verbose: { maxLines: Infinity, maxCharsPerLine: Infinity, showMetrics: true }
+    };
+    currentTier = "compact";
+    __name(setOutputTier, "setOutputTier");
+    __name(getOutputTier, "getOutputTier");
+    __name(getTierConfig, "getTierConfig");
     ICONS = {
       success: chalk2.green("\u2713"),
       fail: chalk2.red("\u2717"),
@@ -2127,7 +2199,12 @@ var init_output = __esm({
     quietMode = false;
     __name(setQuietMode, "setQuietMode");
     __name(isQuietMode, "isQuietMode");
-    truncate = /* @__PURE__ */ __name((s, max = 50) => s && s.length > max ? `${s.slice(0, max - 1)}\u2026` : s || "", "truncate");
+    truncate = /* @__PURE__ */ __name((s, max) => {
+      const limit = max ?? (getTierConfig().maxCharsPerLine || 50);
+      return s && s.length > limit ? `${s.slice(0, limit - 1)}\u2026` : s || "";
+    }, "truncate");
+    __name(limitLines, "limitLines");
+    __name(formatForHuman, "formatForHuman");
     clear = /* @__PURE__ */ __name(() => process.stdout.write(`\r${" ".repeat(80)}\r`), "clear");
     out = {
       // Branding: Show header at start
@@ -5952,6 +6029,29 @@ var init_command_installer = __esm({
           throw error;
         }
       }
+      /**
+       * Remove legacy p.*.md files from commands root directory
+       * These were replaced by the p/ subdirectory structure in v0.50+
+       */
+      async removeLegacyCommands() {
+        const aiProvider = (init_ai_provider(), __toCommonJS(ai_provider_exports));
+        const activeProvider = aiProvider.getActiveProvider();
+        const commandsRoot = path16.join(activeProvider.configDir, "commands");
+        let removed = 0;
+        try {
+          const files = await fs16.readdir(commandsRoot);
+          const legacyFiles = files.filter((f) => f.startsWith("p.") && f.endsWith(".md"));
+          for (const file of legacyFiles) {
+            try {
+              await fs16.unlink(path16.join(commandsRoot, file));
+              removed++;
+            } catch {
+            }
+          }
+        } catch {
+        }
+        return removed;
+      }
       /**
        * Sync commands - intelligent update that detects and removes orphans
        */
@@ -6004,6 +6104,7 @@ var init_command_installer = __esm({
               results.errors.push({ file, error: error.message });
             }
           }
+          await this.removeLegacyCommands();
           return results;
         } catch (error) {
           return {
@@ -23907,8 +24008,7 @@ var init_client = __esm({
         }
         this.sdk = new LinearSDK({ apiKey });
         try {
-          const viewer = await this.sdk.viewer;
-          console.error(`[linear] Connected as ${viewer.name} (${viewer.email})`);
+          await this.sdk.viewer;
         } catch (error) {
           this.sdk = null;
           throw new Error(`Linear connection failed: ${error.message}`);
@@ -25197,7 +25297,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.55.3",
+      version: "0.56.0",
       description: "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
       main: "core/index.ts",
       bin: {
@@ -25215,6 +25315,7 @@ var require_package = __commonJS({
         "release:minor": "node scripts/release.js minor",
         "release:major": "node scripts/release.js major",
         postinstall: "node scripts/postinstall.js",
+        prepare: "lefthook install",
         "update-commands": `bun -e "const installer = require('./core/infrastructure/command-installer'); installer.syncCommands().then(r => console.log('Commands updated:', r)).catch(e => console.error('Error:', e.message))"`,
         "install-global": "./scripts/install.sh",
         update: "./scripts/update.sh",
@@ -25264,6 +25365,7 @@ var require_package = __commonJS({
         "@types/bun": "latest",
         "@types/chokidar": "^2.1.7",
         "@types/prompts": "^2.4.9",
+        lefthook: "^2.1.0",
         typescript: "^5.9.3"
       },
       repository: {

package/dist/core/infrastructure/command-installer.js

@@ -873,6 +873,29 @@ var CommandInstaller = class {
       throw error;
     }
   }
+  /**
+   * Remove legacy p.*.md files from commands root directory
+   * These were replaced by the p/ subdirectory structure in v0.50+
+   */
+  async removeLegacyCommands() {
+    const aiProvider = (init_ai_provider(), __toCommonJS(ai_provider_exports));
+    const activeProvider = aiProvider.getActiveProvider();
+    const commandsRoot = import_node_path3.default.join(activeProvider.configDir, "commands");
+    let removed = 0;
+    try {
+      const files = await import_promises.default.readdir(commandsRoot);
+      const legacyFiles = files.filter((f) => f.startsWith("p.") && f.endsWith(".md"));
+      for (const file of legacyFiles) {
+        try {
+          await import_promises.default.unlink(import_node_path3.default.join(commandsRoot, file));
+          removed++;
+        } catch {
+        }
+      }
+    } catch {
+    }
+    return removed;
+  }
   /**
    * Sync commands - intelligent update that detects and removes orphans
    */
@@ -925,6 +948,7 @@ var CommandInstaller = class {
           results.errors.push({ file, error: error.message });
         }
       }
+      await this.removeLegacyCommands();
       return results;
     } catch (error) {
       return {

package/dist/core/infrastructure/setup.js

@@ -876,6 +876,29 @@ var CommandInstaller = class {
       throw error;
     }
   }
+  /**
+   * Remove legacy p.*.md files from commands root directory
+   * These were replaced by the p/ subdirectory structure in v0.50+
+   */
+  async removeLegacyCommands() {
+    const aiProvider = (init_ai_provider(), __toCommonJS(ai_provider_exports));
+    const activeProvider = aiProvider.getActiveProvider();
+    const commandsRoot = import_node_path3.default.join(activeProvider.configDir, "commands");
+    let removed = 0;
+    try {
+      const files = await import_promises.default.readdir(commandsRoot);
+      const legacyFiles = files.filter((f) => f.startsWith("p.") && f.endsWith(".md"));
+      for (const file of legacyFiles) {
+        try {
+          await import_promises.default.unlink(import_node_path3.default.join(commandsRoot, file));
+          removed++;
+        } catch {
+        }
+      }
+    } catch {
+    }
+    return removed;
+  }
   /**
    * Sync commands - intelligent update that detects and removes orphans
    */
@@ -928,6 +951,7 @@ var CommandInstaller = class {
           results.errors.push({ file, error: error.message });
         }
       }
+      await this.removeLegacyCommands();
       return results;
     } catch (error) {
       return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prjct-cli",
-  "version": "0.55.3",
+  "version": "0.56.0",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {
@@ -18,6 +18,7 @@
     "release:minor": "node scripts/release.js minor",
     "release:major": "node scripts/release.js major",
     "postinstall": "node scripts/postinstall.js",
+    "prepare": "lefthook install",
     "update-commands": "bun -e \"const installer = require('./core/infrastructure/command-installer'); installer.syncCommands().then(r => console.log('Commands updated:', r)).catch(e => console.error('Error:', e.message))\"",
     "install-global": "./scripts/install.sh",
     "update": "./scripts/update.sh",
@@ -67,6 +68,7 @@
     "@types/bun": "latest",
     "@types/chokidar": "^2.1.7",
     "@types/prompts": "^2.4.9",
+    "lefthook": "^2.1.0",
     "typescript": "^5.9.3"
   },
   "repository": {