prjct-cli 0.64.0 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,303 @@
 # Changelog
 
+## [1.0.0] - 2026-02-05
+
+### Features
+
+- add input source tagging for context items (PRJ-102) (#106)
+- add timeout management with configurable limits (PRJ-111) (#104)
+- implement graceful degradation for missing dependencies (PRJ-114) (#103)
+- add .prjct-state.md local state file for persistence (PRJ-112) (#102)
+- hierarchical AGENTS.md resolution and template improvements (PRJ-101) (#99)
+- add staleness detection for CLAUDE.md context (PRJ-120) (#97)
+- complete Linear/JIRA workflow integration (#95)
+- monorepo support with nested PRJCT.md inheritance (PRJ-118) (#94)
+- implement output tiers for cleaner CLI output (#88)
+- modular CLAUDE.md for reduced token usage - PRJ-94 (#86)
+- Add showMetrics config option - PRJ-70 (#82)
+- Selective memory retrieval based on task relevance - PRJ-107 (#81)
+- Add session stats to p. stats command - PRJ-89 (#80)
+- Lazy template loading with TTL cache - PRJ-76 (#79)
+- Add confidence scores to all stored preferences - PRJ-104 (#78)
+- Context diff preview before sync applies - PRJ-125 (#77)
+- Unified output system with new methods - PRJ-130 (#76)
+- Error messages with context and recovery hints - PRJ-131 (#75)
+- Read-before-write enforcement for templates - PRJ-108 (#74)
+- Complete and improve help text documentation - PRJ-133 (#73)
+- Workflow hooks via natural language - PRJ-137 (#72)
+- Subtask progress dashboard with domain colors - PRJ-138 (#71)
+- preserve user customizations during sync - PRJ-115 (#70)
+- automated release pipeline - PRJ-147 (#68)
+- add project indexing and analysis services (PRJ-85, PRJ-87) (#66)
+- metrics display in output (PRJ-68, PRJ-69) (#54)
+- add prjct uninstall command (PRJ-146) (#65)
+- add prjct doctor command (PRJ-117) (#62)
+- smart watch mode - auto-sync on file changes (PRJ-123) (#61)
+- add --quiet flag for silent output (PRJ-97) (#60)
+- interactive onboarding wizard (PRJ-124) (#58)
+- smart context filtering tools for AI agents (PRJ-127) (#57)
+- workflow state machine + bidirectional Linear sync (#55)
+- progress indicators for long-running operations (PRJ-129) (#52)
+- agent activity stream for real-time visibility (PRJ-135) (#51)
+- show explicit next steps after each command (PRJ-136) (#50)
+- multi-agent output Phase 3 - Auto-detect + Continue.dev (PRJ-126) (#49)
+- multi-agent output Phase 2 - Copilot + Windsurf (PRJ-126) (#48)
+- multi-agent context output - Phase 1 (PRJ-126) (#47)
+- bidirectional sync Linear ↔ prjct (PRJ-142) (#46)
+- migrate Linear and JIRA from MCP to native SDK (PRJ-141) (#45)
+- enhance skill system with remote installation and lock file (#44)
+- Windsurf IDE support (PRJ-66) (#43)
+- Google Antigravity support via Skills (PRJ-64) (#42)
+- add mandatory plan-before-action rule to all agents
+- Cursor IDE support (PRJ-63) (#40)
+- Cursor IDE support (PRJ-63)
+- dual platform support - Claude + Gemini (PRJ-62) (#39)
+- 100% agentic task routing with subtask fragmentation
+- add agent/skill orchestrator + agentskills.io integration
+- auto-install MCP servers + individual command skills
+- AI-powered ticket enrichment + 4 tracker integrations v0.33.0
+- JIRA MCP integration for corporate SSO v0.32.0
+- JIRA Integration v0.31.0 (#30)
+- PM Expert auto-enrichment + statusline fixes v0.30.2
+- add p. update command for manual sync
+- modular statusline with Linear integration v0.29.0 (#29)
+- redesign build and release flow for npm
+- modular statusline with Linear integration v0.29.0
+- integrate issue tracker and AI enrichment for project management
+- per-project task filtering for status bar v0.28.0
+- Skill integration system v0.27.0 (#24)
+- Claude Code Skill Integration (Agentic) v0.27.0
+- Complete development cycle with workflow integrity v0.26.0
+- Unified /p:task command + auto-sync notification v0.24.0
+- Branch + PR workflow v0.23.0
+- Notion per-project databases + skill registration v0.22.0
+- add optional Notion integration v0.21.0
+- enhance error handling and permissions management
+- UX/UI Design Agent Integration v0.20.0
+- prompt-builder fix + web removal v0.19.0
+- add TestSprite integration for AI-powered testing
+- CLI-API sync bridge + /p:auth command v0.18.0
+- Claude Code sub-agents integration v0.17.0
+- Security, performance, and architecture improvements v0.16.1
+- Dead code cleanup - remove ~6,600 lines v0.16.0
+- Add MCP server configuration for Context7
+- Template optimization - reduce 39 to 27 commands v0.15.0
+- Refactor Project Management with UUID Migration and Enhanced Context Handling
+- Enhance Project Management with Terminal Dock and UI Improvements
+- Actionable Dashboard + Session Recovery v0.14.0
+- Add MomentumWidget + Code workspace + Weekly reports
+- Ship Deep Sync + Cleanup migrations v0.13.0
+- MigrationGate + bug fixes
+- JSON-First Architecture (Zero Data Loss)
+- Implement project stats API and enhance UI components
+- Enhance project management and terminal functionality in web application
+- Revamp web application with Next.js and enhanced features
+- Introduce new server and web components for prjct
+- Release 0.10.14 with 100% agentic delegation and task tool integration
+- Add ⚡ prjct branding with animated spinner
+- 100% agentic agent assignment - JS=orchestrator, Claude=decisions
+- 100% agentic system - eliminate all procedural keyword-based logic
+- Release 0.10.10 with executable templates and context reduction
+- Release 0.10.8 with minimal output system and reduced CLI verbosity
+- Release 0.10.7 with critical improvements and enhanced context handling
+- Enhanced global CLAUDE.md template for better prjct usage
+- Rich project context for Claude
+- Dynamic project context for Claude
+- Intelligent Agent System & Performance Optimization (v0.10.0)
+- add November 22, 2025 release notes for version 0.9.1
+- context optimization and prompt conciseness
+- add legacy installation detector and cleanup system for pre-v0.8.2 curl installations
+- add system timestamp tools and optimize top 7 templates
+- memory-efficient file operations for large JSONL files
+- simplify installation to npm-only with automatic post-install setup
+- v0.8.0 - conversational interface with zero memorization
+- add comprehensive testing documentation
+- add website component tests and configure vitest workspace
+- migrate test suite to Vitest with coverage reporting
+- add isSupported flag to agent detection for Claude and Terminal agents
+- add setup, migrate-all commands and mark roadmap/status/build as implemented
+- redesign footer layout and add AI policy page with updated navigation
+- add Vercel Analytics and Speed Insights tracking to website
+- simplify workflow to 5 essential commands
+- rebrand from project management to developer momentum tool with streamlined templates and workflows
+- add editor uninstallation and smart project data fusion to prjct init
+- add first-time setup flow and auto-initialization for all commands
+- add auto-migration from v0.1.0 projects during post-install hook
+- add auto-install and clean uninstall functionality with editor tracking
+- add GitHub Packages support and track installed editors in config
+- add Windows compatibility feature card to changelog
+- add automatic npm publication and update detection system
+- publish prjct-cli to npm registry
+- remove bun and homebrew installation methods
+- add natural language interface with English and Spanish support
+- add interactive workflow system with capability detection and installation
+- release v0.3.0 with interactive editor selection and codebase analysis
+- add project management workflows for analyzing, tracking, and fixing tasks
+- update CNAME handling and add 404 page for better routing
+- add cleanup and design commands with advanced options
+- initialize project structure with core files and documentation
+
+### Bug Fixes
+
+- generate IDE context files with correct paths and formats (PRJ-122) (#107)
+- improve sync output with summary-first format (PRJ-100) (#100)
+- correct template paths and agent loading in CLAUDE.md (#93)
+- 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)
+- remove legacy p.*.md commands on sync
+- ensure test isolation in IndexStorage tests
+- remove MCP integrations, keep only Context7 (#87)
+- make Linear/JIRA templates explicitly ignore MCP tools
+- remove MCP inheritance from Linear/JIRA templates
+- standardize confirmation pattern across all commands (#85)
+- LLM debe manejar los prompts, no el CLI - PRJ-149 (#84)
+- Claude over-plans simple commands like p. sync - PRJ-148 (#83)
+- implement silent memory application - PRJ-103 (#69)
+- ignore tar warning in release workflow - PRJ-147
+- remove --provenance (requires public repo) - PRJ-147
+- use Production environment for npm secrets - PRJ-147
+- use semver-sorted tags for version detection - PRJ-147
+- npm auth configuration for CI publish - PRJ-147
+- add Bun setup for test runner in CI - PRJ-147
+- use npm instead of bun for CI tests - PRJ-147
+- remove IDE files from repo - PRJ-144, PRJ-145
+- add --help handler in CLI entry point for CI compatibility
+- update tests for CI compatibility
+- CI workflow - remove unsupported bun reporter flag and fix verification
+- enforce workflow steps in templates (PRJ-143) (#56)
+- add $PRJCT_CLI prefix to relative paths in templates (PRJ-143)
+- use stderr for Linear connection log to not break JSON output
+- show Cursor in same format as other providers in --version
+- Cursor command syntax (PRJ-65) (#41)
+- reduce permission prompts from 50+ to 1 (#38)
+- cleanup legacy files and fix TS error (#37)
+- chore: release v0.35.2
+- connect CLI workflow to CommandExecutor
+- execute orchestration in TypeScript, not just paths (#36)
+- execute orchestration in TypeScript, not just paths
+- remove unsafe 'as unknown' casts (PRJ-54)
+- complete error differentiation (Phase 3) (#35)
+- enable enrichment by default in statusline config
+- self-healing setup in bin/prjct v0.30.1
+- distribution system overhaul - remove fallback, always read from npm root v0.30.0
+- setup.ts auto-execute when run directly
+- remove duplicate statusline version check
+- dynamic path resolution for compiled dist/
+- ALWAYS run postinstall setup, remove global detection
+- detect /opt/homebrew for M1/M2 Macs in postinstall
+- handle bun test warnings in release script
+- include assets/ in npm package + add linear to router
+- add cliVersion to project.json on postinstall
+- resolve symlinks in bin/prjct for npm install
+- agents only write to global storage v0.18.2
+- agents only in global storage + auto-migrate legacy v0.18.1
+- serve.js use start instead of start:prod
+- Remove migration gate from production
+- Restore sidebar collapse + fix server OOM crash
+- Prevent terminal session loss on navigation
+- Terminal responsive & performance issues
+- Server runs in production mode, port 9472
+- Export commands as singleton for direct invocation
+- Update global CLAUDE.md on sync, analyze, and init
+- Add glob dependency and update to modern API
+- critical memory leaks - LRU cache, HTTP cleanup, session expiration
+- ensure command templates always update by removing mtime checks and forcing overwrites
+- resolve critical installation bugs and add auto-update functionality with visual feedback
+- resolve TypeScript errors in website tests
+- remove unused variables to pass lint
+- update vercel build and install commands to use npm prefix syntax
+- remove unused Globe import from Privacy.tsx
+- resolve TypeScript errors in website build
+- remove vercel.json, configure Root Directory in Vercel UI
+- set rootDirectory to website for Vercel
+- use npm --prefix for Vercel build command
+- correct Vercel install command path
+- configure Vercel deployment output directory
+- restore Catppuccin-inspired ASCII art and fix undefined editor names in prjct start command
+- update Badge import path to use correct casing
+- return success exit code for help command
+- remove install script tests from workflow
+- add TERM environment variable to workflow steps
+- add missing WorkflowsGuide.tsx to repository
+- deploy install.sh and setup.sh to website
+- replace inquirer with prompts for better CommonJS compatibility in interactive editor selection
+- resolve installation path errors in setup scripts and add verification tests
+- update init command to use global architecture and fix installer version display
+- update install command URL to use www.prjct.app
+- build(deps-dev): bump vite from 4.5.14 to 7.1.7 in /docs (#1)
+
+### Performance
+
+- parallelize agent/skill loading with Promise.all (PRJ-110) (#101)
+- parallelize sync operations for 30-50% speedup (PRJ-116) (#59)
+
+### Refactoring
+
+- migrate from ESLint + Prettier to Biome
+- consolidate and optimize CI workflows
+- extract StackDetector from sync-service (PRJ-86) (#64)
+- extract ContextFileGenerator from sync-service (PRJ-88) (#63)
+- differentiate error types in catch blocks - Phase 2 (PRJ-60) (#34)
+- differentiate error types in catch blocks (PRJ-51) (#33)
+- simplify logger level detection logic (#32)
+- consolidate hardcoded paths to use pathManager singleton (#31)
+- type consolidation in core/types/ v0.20.1
+- centralize types in core/types/ following DRY principles
+- restructure command and agent modules for improved organization
+- consolidate command and storage modules for improved structure
+- migrate testing setup to Bun and enhance documentation
+- Update project structure and enhance component functionality
+- update command registry structure and remove unused imports
+- remove open source references and GitHub links
+- move Changelog link from header to footer
+- use centralized helper utilities in commands
+- migrate from GitHub Pages to Vercel deployment
+- remove redundant title from changelog technical details section
+- extract reusable components from Changelog.tsx
+- sync install.sh from scripts directory to website/public and docs
+- remove unnecessary comments from prjct.sh script
+- remove unnecessary comments from command line parsing logic
+- remove comments and unnecessary whitespace across core modules
+- move author data and system fields from local to global config
+- migrate legacy project files to new global structure with auto-migration
+- rename landing directory to website and update deploy workflow paths
+- update build paths from docs to lp directory in deploy workflow
+- improve GitHub Pages deployment workflow with better file handling and directory structure
+
+
+## [0.64.1] - 2026-02-05
+
+### Bug Fixes
+
+- **IDE context file generation (PRJ-122)**: Fixed Cursor and Windsurf context file paths and formats
+
+### Implementation Details
+
+Fixed misalignment between `ai-provider.ts` (correct paths) and `ai-tools/registry.ts` (incorrect paths). Updated Cursor output to `.cursor/rules/prjct.mdc` with MDC format and `alwaysApply: true` frontmatter. Updated Windsurf output to `.windsurf/rules/prjct.md` with `trigger: always_on` frontmatter. Modified sync-service default behavior to auto-detect IDE tools when `.cursor/` or `.windsurf/` directories exist.
+
+### Learnings
+
+- Two separate implementations existed (ai-provider vs ai-tools) that needed synchronization
+- IDE formats differ: Cursor uses `alwaysApply: true`, Windsurf uses `trigger: always_on`
+- Auto-detection pattern: check for directory existence to enable optional features
+
+### Test Plan
+
+#### For QA
+1. Run `prjct sync` in project with `.cursor/` dir - verify `.cursor/rules/prjct.mdc` generated
+2. Run `prjct sync` in project with `.windsurf/` dir - verify `.windsurf/rules/prjct.md` generated
+3. Verify Cursor file has `alwaysApply: true` in frontmatter
+4. Verify Windsurf file has `trigger: always_on` in frontmatter
+5. Run `bun test` - all 405 tests pass
+
+#### For Users
+- `prjct sync` now auto-generates IDE context files when `.cursor/` or `.windsurf/` directories exist
+- No manual flags needed - detection is automatic
+- No breaking changes
+
+
 ## [0.64.0] - 2026-02-05
 
 ### Features

package/core/__tests__/ai-tools/formatters.test.ts

@@ -0,0 +1,358 @@
+/**
+ * Tests for AI Tools Formatters
+ *
+ * @see PRJ-122
+ */
+
+import { describe, expect, test } from 'bun:test'
+import {
+  formatForClaude,
+  formatForContinue,
+  formatForCopilot,
+  formatForCursor,
+  formatForWindsurf,
+  getFormatter,
+  type ProjectContext,
+} from '../../ai-tools/formatters'
+import { AI_TOOLS, getAIToolConfig } from '../../ai-tools/registry'
+
+// =============================================================================
+// Test Fixtures
+// =============================================================================
+
+const mockContext: ProjectContext = {
+  projectId: 'test-project-id',
+  name: 'test-project',
+  version: '1.0.0',
+  ecosystem: 'Node.js',
+  projectType: 'library',
+  languages: ['TypeScript'],
+  frameworks: ['Hono'],
+  repoPath: '/Users/test/project',
+  branch: 'main',
+  fileCount: 100,
+  commits: 50,
+  hasChanges: false,
+  commands: {
+    install: 'bun install',
+    dev: 'bun run dev',
+    test: 'bun test',
+    build: 'bun run build',
+    lint: 'bun run lint',
+    format: 'bun run format',
+  },
+  agents: {
+    workflow: ['prjct-planner', 'prjct-shipper'],
+    domain: ['backend'],
+  },
+}
+
+// =============================================================================
+// Registry Tests
+// =============================================================================
+
+describe('AI Tools Registry', () => {
+  test('cursor uses correct output file path', () => {
+    expect(AI_TOOLS.cursor.outputFile).toBe('.cursor/rules/prjct.mdc')
+  })
+
+  test('windsurf uses correct output file path', () => {
+    expect(AI_TOOLS.windsurf.outputFile).toBe('.windsurf/rules/prjct.md')
+  })
+
+  test('copilot uses correct output file path', () => {
+    expect(AI_TOOLS.copilot.outputFile).toBe('.github/copilot-instructions.md')
+  })
+
+  test('claude uses correct output file path', () => {
+    expect(AI_TOOLS.claude.outputFile).toBe('CLAUDE.md')
+  })
+
+  test('continue uses correct output file path', () => {
+    expect(AI_TOOLS.continue.outputFile).toBe('.continue/config.json')
+  })
+
+  test('getAIToolConfig returns config for valid tool', () => {
+    const config = getAIToolConfig('cursor')
+    expect(config).not.toBeNull()
+    expect(config?.id).toBe('cursor')
+  })
+
+  test('getAIToolConfig returns null for invalid tool', () => {
+    const config = getAIToolConfig('invalid-tool')
+    expect(config).toBeNull()
+  })
+})
+
+// =============================================================================
+// Formatter Tests
+// =============================================================================
+
+describe('formatForCursor', () => {
+  const config = AI_TOOLS.cursor
+
+  test('generates MDC format with YAML frontmatter', () => {
+    const result = formatForCursor(mockContext, config)
+
+    // Should start with YAML frontmatter
+    expect(result.startsWith('---\n')).toBe(true)
+    expect(result).toContain('description: prjct context for test-project')
+    expect(result).toContain('alwaysApply: true')
+    expect(result).toContain('---')
+  })
+
+  test('includes project info', () => {
+    const result = formatForCursor(mockContext, config)
+
+    expect(result).toContain('test-project')
+    expect(result).toContain('library')
+    expect(result).toContain('Node.js')
+  })
+
+  test('includes tech stack', () => {
+    const result = formatForCursor(mockContext, config)
+
+    expect(result).toContain('TypeScript')
+    expect(result).toContain('Hono')
+  })
+
+  test('includes commands', () => {
+    const result = formatForCursor(mockContext, config)
+
+    expect(result).toContain('bun install')
+    expect(result).toContain('bun run dev')
+    expect(result).toContain('bun test')
+    expect(result).toContain('bun run build')
+  })
+})
+
+describe('formatForWindsurf', () => {
+  const config = AI_TOOLS.windsurf
+
+  test('generates MD format with YAML frontmatter', () => {
+    const result = formatForWindsurf(mockContext, config)
+
+    // Should start with YAML frontmatter
+    expect(result.startsWith('---\n')).toBe(true)
+    expect(result).toContain('description: prjct context for test-project')
+    expect(result).toContain('trigger: always_on')
+    expect(result).toContain('---')
+  })
+
+  test('uses trigger: always_on (not alwaysApply)', () => {
+    const result = formatForWindsurf(mockContext, config)
+
+    expect(result).toContain('trigger: always_on')
+    expect(result).not.toContain('alwaysApply')
+  })
+
+  test('includes project info', () => {
+    const result = formatForWindsurf(mockContext, config)
+
+    expect(result).toContain('test-project')
+    expect(result).toContain('library')
+    expect(result).toContain('Node.js')
+  })
+
+  test('includes commands in bash block', () => {
+    const result = formatForWindsurf(mockContext, config)
+
+    expect(result).toContain('```bash')
+    expect(result).toContain('bun install')
+    expect(result).toContain('bun run dev')
+    expect(result).toContain('bun test')
+    expect(result).toContain('bun run build')
+    expect(result).toContain('```')
+  })
+})
+
+describe('formatForCopilot', () => {
+  const config = AI_TOOLS.copilot
+
+  test('generates minimal format without frontmatter', () => {
+    const result = formatForCopilot(mockContext, config)
+
+    // Copilot uses plain markdown, no YAML frontmatter
+    expect(result.startsWith('# Copilot Instructions')).toBe(true)
+    expect(result).not.toContain('---')
+  })
+
+  test('includes project info', () => {
+    const result = formatForCopilot(mockContext, config)
+
+    expect(result).toContain('test-project')
+    expect(result).toContain('library')
+    expect(result).toContain('Node.js')
+  })
+
+  test('includes essential commands only', () => {
+    const result = formatForCopilot(mockContext, config)
+
+    expect(result).toContain('bun test')
+    expect(result).toContain('bun run build')
+  })
+})
+
+describe('formatForClaude', () => {
+  const config = AI_TOOLS.claude
+
+  test('generates detailed markdown format', () => {
+    const result = formatForClaude(mockContext, config)
+
+    expect(result).toContain('# test-project - Project Rules')
+    expect(result).toContain('<!-- projectId: test-project-id -->')
+  })
+
+  test('includes prjct workflow reference', () => {
+    const result = formatForClaude(mockContext, config)
+
+    expect(result).toContain('## PRJCT RULES')
+    expect(result).toContain('p. sync')
+    expect(result).toContain('p. task')
+    expect(result).toContain('p. done')
+    expect(result).toContain('p. ship')
+  })
+
+  test('includes commands table', () => {
+    const result = formatForClaude(mockContext, config)
+
+    expect(result).toContain('| Action | Command |')
+    expect(result).toContain('bun install')
+    expect(result).toContain('bun run dev')
+  })
+
+  test('includes agent references', () => {
+    const result = formatForClaude(mockContext, config)
+
+    expect(result).toContain('prjct-planner')
+    expect(result).toContain('prjct-shipper')
+    expect(result).toContain('backend')
+  })
+})
+
+describe('formatForContinue', () => {
+  const config = AI_TOOLS.continue
+
+  test('generates valid JSON format', () => {
+    const result = formatForContinue(mockContext, config)
+
+    const parsed = JSON.parse(result)
+    expect(parsed).toBeDefined()
+  })
+
+  test('includes system message with project info', () => {
+    const result = formatForContinue(mockContext, config)
+    const parsed = JSON.parse(result)
+
+    expect(parsed.systemMessage).toContain('test-project')
+    expect(parsed.systemMessage).toContain('library')
+    expect(parsed.systemMessage).toContain('Node.js')
+  })
+
+  test('includes context providers', () => {
+    const result = formatForContinue(mockContext, config)
+    const parsed = JSON.parse(result)
+
+    expect(parsed.contextProviders).toBeArray()
+    expect(parsed.contextProviders.length).toBeGreaterThan(0)
+    expect(parsed.contextProviders).toContainEqual({ name: 'code' })
+    expect(parsed.contextProviders).toContainEqual({ name: 'diff' })
+  })
+
+  test('includes slash commands', () => {
+    const result = formatForContinue(mockContext, config)
+    const parsed = JSON.parse(result)
+
+    expect(parsed.slashCommands).toBeArray()
+    expect(parsed.slashCommands.length).toBeGreaterThan(0)
+  })
+
+  test('includes custom test command with project test command', () => {
+    const result = formatForContinue(mockContext, config)
+    const parsed = JSON.parse(result)
+
+    expect(parsed.customCommands).toBeArray()
+    const testCmd = parsed.customCommands.find((c: { name: string }) => c.name === 'test')
+    expect(testCmd).toBeDefined()
+    expect(testCmd.prompt).toContain('bun test')
+  })
+})
+
+// =============================================================================
+// getFormatter Tests
+// =============================================================================
+
+describe('getFormatter', () => {
+  test('returns formatter for claude', () => {
+    const formatter = getFormatter('claude')
+    expect(formatter).toBe(formatForClaude)
+  })
+
+  test('returns formatter for cursor', () => {
+    const formatter = getFormatter('cursor')
+    expect(formatter).toBe(formatForCursor)
+  })
+
+  test('returns formatter for windsurf', () => {
+    const formatter = getFormatter('windsurf')
+    expect(formatter).toBe(formatForWindsurf)
+  })
+
+  test('returns formatter for copilot', () => {
+    const formatter = getFormatter('copilot')
+    expect(formatter).toBe(formatForCopilot)
+  })
+
+  test('returns formatter for continue', () => {
+    const formatter = getFormatter('continue')
+    expect(formatter).toBe(formatForContinue)
+  })
+
+  test('returns null for unknown tool', () => {
+    const formatter = getFormatter('unknown-tool')
+    expect(formatter).toBeNull()
+  })
+})
+
+// =============================================================================
+// Edge Cases
+// =============================================================================
+
+describe('Formatter Edge Cases', () => {
+  test('handles empty languages array', () => {
+    const ctx = { ...mockContext, languages: [] }
+
+    const cursorResult = formatForCursor(ctx, AI_TOOLS.cursor)
+    expect(cursorResult).not.toContain('Languages:')
+
+    const windsurfResult = formatForWindsurf(ctx, AI_TOOLS.windsurf)
+    expect(windsurfResult).toContain('## Stack')
+  })
+
+  test('handles empty frameworks array', () => {
+    const ctx = { ...mockContext, frameworks: [] }
+
+    const cursorResult = formatForCursor(ctx, AI_TOOLS.cursor)
+    expect(cursorResult).not.toContain('Frameworks:')
+
+    const windsurfResult = formatForWindsurf(ctx, AI_TOOLS.windsurf)
+    expect(windsurfResult).toContain('## Stack')
+  })
+
+  test('handles empty agents', () => {
+    const ctx = { ...mockContext, agents: { workflow: [], domain: [] } }
+
+    const claudeResult = formatForClaude(ctx, AI_TOOLS.claude)
+    expect(claudeResult).toContain('**Domain**: none')
+  })
+
+  test('handles special characters in project name', () => {
+    const ctx = { ...mockContext, name: '@scope/my-project' }
+
+    const cursorResult = formatForCursor(ctx, AI_TOOLS.cursor)
+    expect(cursorResult).toContain('@scope/my-project')
+
+    const claudeResult = formatForClaude(ctx, AI_TOOLS.claude)
+    expect(claudeResult).toContain('@scope/my-project')
+  })
+})

package/core/ai-tools/formatters.ts

@@ -114,50 +114,60 @@ Load from \`~/.prjct-cli/projects/${ctx.projectId}/agents/\`:
 }
 
 /**
- * Format context for Cursor (.cursorrules)
- * Concise rules format, optimized for inline suggestions
+ * Format context for Cursor (.cursor/rules/prjct.mdc)
+ * MDC format with YAML frontmatter, optimized for inline suggestions
+ *
+ * @see https://cursor.com/docs/context/rules
  */
 export function formatForCursor(ctx: ProjectContext, _config: AIToolConfig): string {
-  const rules: string[] = []
+  const lines: string[] = []
+
+  // MDC format with YAML frontmatter
+  lines.push('---')
+  lines.push(`description: prjct context for ${ctx.name}`)
+  lines.push('globs:')
+  lines.push('alwaysApply: true')
+  lines.push('---')
+  lines.push('')
 
   // Project identity
-  rules.push(`You are working on ${ctx.name}, a ${ctx.projectType} ${ctx.ecosystem} project.`)
-  rules.push('')
+  lines.push(`You are working on ${ctx.name}, a ${ctx.projectType} ${ctx.ecosystem} project.`)
+  lines.push('')
 
   // Tech stack
-  rules.push('## Tech Stack')
+  lines.push('## Tech Stack')
   if (ctx.languages.length > 0) {
-    rules.push(`- Languages: ${ctx.languages.join(', ')}`)
+    lines.push(`- Languages: ${ctx.languages.join(', ')}`)
   }
   if (ctx.frameworks.length > 0) {
-    rules.push(`- Frameworks: ${ctx.frameworks.join(', ')}`)
+    lines.push(`- Frameworks: ${ctx.frameworks.join(', ')}`)
   }
-  rules.push('')
+  lines.push('')
 
   // Commands
-  rules.push('## Commands')
-  rules.push(`- Install: \`${ctx.commands.install}\``)
-  rules.push(`- Dev: \`${ctx.commands.dev}\``)
-  rules.push(`- Test: \`${ctx.commands.test}\``)
-  rules.push(`- Build: \`${ctx.commands.build}\``)
-  rules.push('')
+  lines.push('## Commands')
+  lines.push(`- Install: \`${ctx.commands.install}\``)
+  lines.push(`- Dev: \`${ctx.commands.dev}\``)
+  lines.push(`- Test: \`${ctx.commands.test}\``)
+  lines.push(`- Build: \`${ctx.commands.build}\``)
+  lines.push('')
 
   // Code style - language agnostic
-  rules.push('## Code Style')
-  rules.push(`- Follow ${ctx.ecosystem} conventions`)
-  rules.push('- Match existing code patterns in this project')
-  rules.push('- Use idiomatic constructs for the language')
-  rules.push('')
+  lines.push('## Code Style')
+  lines.push(`- Follow ${ctx.ecosystem} conventions`)
+  lines.push('- Match existing code patterns in this project')
+  lines.push('- Use idiomatic constructs for the language')
+  lines.push('')
 
   // Best practices
-  rules.push('## Best Practices')
-  rules.push('- Write clean, readable code')
-  rules.push('- Add comments only for complex logic')
-  rules.push('- Keep functions small and focused')
-  rules.push('- Handle errors appropriately')
-  rules.push('- Write tests for new functionality')
-
-  return rules.join('\n')
+  lines.push('## Best Practices')
+  lines.push('- Write clean, readable code')
+  lines.push('- Add comments only for complex logic')
+  lines.push('- Keep functions small and focused')
+  lines.push('- Handle errors appropriately')
+  lines.push('- Write tests for new functionality')
+
+  return lines.join('\n')
 }
 
 /**
@@ -194,48 +204,57 @@ export function formatForCopilot(ctx: ProjectContext, _config: AIToolConfig): st
 }
 
 /**
- * Format context for Windsurf (.windsurfrules)
- * Optimized for Cascade AI with flow-based suggestions
+ * Format context for Windsurf (.windsurf/rules/prjct.md)
+ * MD format with YAML frontmatter, optimized for Cascade AI
+ *
+ * @see https://docs.windsurf.com/windsurf/cascade/memories
  */
 export function formatForWindsurf(ctx: ProjectContext, _config: AIToolConfig): string {
-  const rules: string[] = []
+  const lines: string[] = []
+
+  // YAML frontmatter (Windsurf uses trigger: always_on instead of alwaysApply)
+  lines.push('---')
+  lines.push(`description: prjct context for ${ctx.name}`)
+  lines.push('trigger: always_on')
+  lines.push('---')
+  lines.push('')
 
   // Project identity
-  rules.push(`# ${ctx.name}`)
-  rules.push('')
-  rules.push(`${ctx.projectType} project using ${ctx.ecosystem}.`)
-  rules.push('')
+  lines.push(`# ${ctx.name}`)
+  lines.push('')
+  lines.push(`${ctx.projectType} project using ${ctx.ecosystem}.`)
+  lines.push('')
 
   // Tech stack (concise)
-  rules.push('## Stack')
-  rules.push(`- ${ctx.languages.join(', ')}`)
+  lines.push('## Stack')
+  lines.push(`- ${ctx.languages.join(', ')}`)
   if (ctx.frameworks.length > 0) {
-    rules.push(`- ${ctx.frameworks.join(', ')}`)
+    lines.push(`- ${ctx.frameworks.join(', ')}`)
   }
-  rules.push('')
+  lines.push('')
 
   // Commands (essential only)
-  rules.push('## Commands')
-  rules.push(`\`\`\`bash`)
-  rules.push(`# Install`)
-  rules.push(ctx.commands.install)
-  rules.push(`# Dev`)
-  rules.push(ctx.commands.dev)
-  rules.push(`# Test`)
-  rules.push(ctx.commands.test)
-  rules.push(`# Build`)
-  rules.push(ctx.commands.build)
-  rules.push(`\`\`\``)
-  rules.push('')
+  lines.push('## Commands')
+  lines.push('```bash')
+  lines.push(`# Install`)
+  lines.push(ctx.commands.install)
+  lines.push(`# Dev`)
+  lines.push(ctx.commands.dev)
+  lines.push(`# Test`)
+  lines.push(ctx.commands.test)
+  lines.push(`# Build`)
+  lines.push(ctx.commands.build)
+  lines.push('```')
+  lines.push('')
 
   // Code style - language agnostic
-  rules.push('## Rules')
-  rules.push(`- Follow ${ctx.ecosystem} conventions`)
-  rules.push('- Match existing project patterns')
-  rules.push('- Clean code, minimal comments')
-  rules.push('- Test new functionality')
+  lines.push('## Rules')
+  lines.push(`- Follow ${ctx.ecosystem} conventions`)
+  lines.push('- Match existing project patterns')
+  lines.push('- Clean code, minimal comments')
+  lines.push('- Test new functionality')
 
-  return rules.join('\n')
+  return lines.join('\n')
 }
 
 /**

package/core/ai-tools/registry.ts

@@ -40,7 +40,7 @@ export const AI_TOOLS: Record<string, AIToolConfig> = {
   cursor: {
     id: 'cursor',
     name: 'Cursor',
-    outputFile: '.cursorrules',
+    outputFile: '.cursor/rules/prjct.mdc',
     outputPath: 'repo',
     maxTokens: 2000,
     format: 'concise',
@@ -58,7 +58,7 @@ export const AI_TOOLS: Record<string, AIToolConfig> = {
   windsurf: {
     id: 'windsurf',
     name: 'Windsurf',
-    outputFile: '.windsurfrules',
+    outputFile: '.windsurf/rules/prjct.md',
     outputPath: 'repo',
     maxTokens: 2000,
     format: 'concise',

package/core/services/sync-service.ts

@@ -142,9 +142,14 @@ class SyncService {
     const startTime = Date.now()
 
     // Resolve AI tools: supports 'auto', 'all', or specific list
+    // Default behavior: claude + any detected IDE tools (.cursor/, .windsurf/)
     let aiToolIds: string[]
     if (!options.aiTools || options.aiTools.length === 0) {
-      aiToolIds = DEFAULT_AI_TOOLS
+      // Start with default CLI tools and add detected IDE tools
+      const detectedIdeTools = detectInstalledTools(projectPath).filter(
+        (id) => !DEFAULT_AI_TOOLS.includes(id)
+      )
+      aiToolIds = [...DEFAULT_AI_TOOLS, ...detectedIdeTools]
     } else if (options.aiTools[0] === 'auto') {
       aiToolIds = detectInstalledTools(projectPath)
       if (aiToolIds.length === 0) aiToolIds = ['claude'] // fallback

package/dist/bin/prjct.mjs

@@ -19701,35 +19701,41 @@ Load from \`~/.prjct-cli/projects/${ctx.projectId}/agents/\`:
 `;
 }
 function formatForCursor(ctx, _config) {
-  const rules = [];
-  rules.push(`You are working on ${ctx.name}, a ${ctx.projectType} ${ctx.ecosystem} project.`);
-  rules.push("");
-  rules.push("## Tech Stack");
+  const lines = [];
+  lines.push("---");
+  lines.push(`description: prjct context for ${ctx.name}`);
+  lines.push("globs:");
+  lines.push("alwaysApply: true");
+  lines.push("---");
+  lines.push("");
+  lines.push(`You are working on ${ctx.name}, a ${ctx.projectType} ${ctx.ecosystem} project.`);
+  lines.push("");
+  lines.push("## Tech Stack");
   if (ctx.languages.length > 0) {
-    rules.push(`- Languages: ${ctx.languages.join(", ")}`);
+    lines.push(`- Languages: ${ctx.languages.join(", ")}`);
   }
   if (ctx.frameworks.length > 0) {
-    rules.push(`- Frameworks: ${ctx.frameworks.join(", ")}`);
-  }
-  rules.push("");
-  rules.push("## Commands");
-  rules.push(`- Install: \`${ctx.commands.install}\``);
-  rules.push(`- Dev: \`${ctx.commands.dev}\``);
-  rules.push(`- Test: \`${ctx.commands.test}\``);
-  rules.push(`- Build: \`${ctx.commands.build}\``);
-  rules.push("");
-  rules.push("## Code Style");
-  rules.push(`- Follow ${ctx.ecosystem} conventions`);
-  rules.push("- Match existing code patterns in this project");
-  rules.push("- Use idiomatic constructs for the language");
-  rules.push("");
-  rules.push("## Best Practices");
-  rules.push("- Write clean, readable code");
-  rules.push("- Add comments only for complex logic");
-  rules.push("- Keep functions small and focused");
-  rules.push("- Handle errors appropriately");
-  rules.push("- Write tests for new functionality");
-  return rules.join("\n");
+    lines.push(`- Frameworks: ${ctx.frameworks.join(", ")}`);
+  }
+  lines.push("");
+  lines.push("## Commands");
+  lines.push(`- Install: \`${ctx.commands.install}\``);
+  lines.push(`- Dev: \`${ctx.commands.dev}\``);
+  lines.push(`- Test: \`${ctx.commands.test}\``);
+  lines.push(`- Build: \`${ctx.commands.build}\``);
+  lines.push("");
+  lines.push("## Code Style");
+  lines.push(`- Follow ${ctx.ecosystem} conventions`);
+  lines.push("- Match existing code patterns in this project");
+  lines.push("- Use idiomatic constructs for the language");
+  lines.push("");
+  lines.push("## Best Practices");
+  lines.push("- Write clean, readable code");
+  lines.push("- Add comments only for complex logic");
+  lines.push("- Keep functions small and focused");
+  lines.push("- Handle errors appropriately");
+  lines.push("- Write tests for new functionality");
+  return lines.join("\n");
 }
 function formatForCopilot(ctx, _config) {
   const lines = [];
@@ -19752,35 +19758,40 @@ function formatForCopilot(ctx, _config) {
   return lines.join("\n");
 }
 function formatForWindsurf(ctx, _config) {
-  const rules = [];
-  rules.push(`# ${ctx.name}`);
-  rules.push("");
-  rules.push(`${ctx.projectType} project using ${ctx.ecosystem}.`);
-  rules.push("");
-  rules.push("## Stack");
-  rules.push(`- ${ctx.languages.join(", ")}`);
+  const lines = [];
+  lines.push("---");
+  lines.push(`description: prjct context for ${ctx.name}`);
+  lines.push("trigger: always_on");
+  lines.push("---");
+  lines.push("");
+  lines.push(`# ${ctx.name}`);
+  lines.push("");
+  lines.push(`${ctx.projectType} project using ${ctx.ecosystem}.`);
+  lines.push("");
+  lines.push("## Stack");
+  lines.push(`- ${ctx.languages.join(", ")}`);
   if (ctx.frameworks.length > 0) {
-    rules.push(`- ${ctx.frameworks.join(", ")}`);
-  }
-  rules.push("");
-  rules.push("## Commands");
-  rules.push(`\`\`\`bash`);
-  rules.push(`# Install`);
-  rules.push(ctx.commands.install);
-  rules.push(`# Dev`);
-  rules.push(ctx.commands.dev);
-  rules.push(`# Test`);
-  rules.push(ctx.commands.test);
-  rules.push(`# Build`);
-  rules.push(ctx.commands.build);
-  rules.push(`\`\`\``);
-  rules.push("");
-  rules.push("## Rules");
-  rules.push(`- Follow ${ctx.ecosystem} conventions`);
-  rules.push("- Match existing project patterns");
-  rules.push("- Clean code, minimal comments");
-  rules.push("- Test new functionality");
-  return rules.join("\n");
+    lines.push(`- ${ctx.frameworks.join(", ")}`);
+  }
+  lines.push("");
+  lines.push("## Commands");
+  lines.push("```bash");
+  lines.push(`# Install`);
+  lines.push(ctx.commands.install);
+  lines.push(`# Dev`);
+  lines.push(ctx.commands.dev);
+  lines.push(`# Test`);
+  lines.push(ctx.commands.test);
+  lines.push(`# Build`);
+  lines.push(ctx.commands.build);
+  lines.push("```");
+  lines.push("");
+  lines.push("## Rules");
+  lines.push(`- Follow ${ctx.ecosystem} conventions`);
+  lines.push("- Match existing project patterns");
+  lines.push("- Clean code, minimal comments");
+  lines.push("- Test new functionality");
+  return lines.join("\n");
 }
 function formatForContinue(ctx, _config) {
   const systemMessage = [
@@ -19907,7 +19918,7 @@ var init_registry = __esm({
       cursor: {
         id: "cursor",
         name: "Cursor",
-        outputFile: ".cursorrules",
+        outputFile: ".cursor/rules/prjct.mdc",
         outputPath: "repo",
         maxTokens: 2e3,
         format: "concise",
@@ -19925,7 +19936,7 @@ var init_registry = __esm({
       windsurf: {
         id: "windsurf",
         name: "Windsurf",
-        outputFile: ".windsurfrules",
+        outputFile: ".windsurf/rules/prjct.md",
         outputPath: "repo",
         maxTokens: 2e3,
         format: "concise",
@@ -20704,7 +20715,10 @@ var init_sync_service = __esm({
         const startTime = Date.now();
         let aiToolIds;
         if (!options.aiTools || options.aiTools.length === 0) {
-          aiToolIds = DEFAULT_AI_TOOLS;
+          const detectedIdeTools = detectInstalledTools(projectPath).filter(
+            (id) => !DEFAULT_AI_TOOLS.includes(id)
+          );
+          aiToolIds = [...DEFAULT_AI_TOOLS, ...detectedIdeTools];
         } else if (options.aiTools[0] === "auto") {
           aiToolIds = detectInstalledTools(projectPath);
           if (aiToolIds.length === 0) aiToolIds = ["claude"];
@@ -26845,7 +26859,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "prjct-cli",
-      version: "0.64.0",
+      version: "1.0.0",
       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.64.0",
+  "version": "1.0.0",
   "description": "Context layer for AI agents. Project context for Claude Code, Gemini CLI, and more.",
   "main": "core/index.ts",
   "bin": {