@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/shared-handlers.js

@@ -55,3 +55,51 @@ export function setOverlayActive(active) {
 export function isOverlayActive() {
     return overlayActive;
 }
+// =============================================================================
+// Delegate Handler Registry
+// =============================================================================
+let delegateHandler;
+/**
+ * Register the delegate handler. Called during app initialization.
+ */
+export function registerDelegateHandler(handler) {
+    delegateHandler = handler;
+}
+/**
+ * Get the registered delegate handler. Called by the delegate tool.
+ */
+export function getDelegateHandler() {
+    return delegateHandler;
+}
+// =============================================================================
+// Delegate Background Handler Registry
+// =============================================================================
+let delegateBackgroundHandler;
+/**
+ * Register the delegate_background handler. Called during app initialization.
+ */
+export function registerDelegateBackgroundHandler(handler) {
+    delegateBackgroundHandler = handler;
+}
+/**
+ * Get the registered delegate_background handler.
+ */
+export function getDelegateBackgroundHandler() {
+    return delegateBackgroundHandler;
+}
+// =============================================================================
+// Handoff Handler Registry
+// =============================================================================
+let handoffHandler;
+/**
+ * Register the handoff handler. Called during app initialization.
+ */
+export function registerHandoffHandler(handler) {
+    handoffHandler = handler;
+}
+/**
+ * Get the registered handoff handler. Called by the handoff tool.
+ */
+export function getHandoffHandler() {
+    return handoffHandler;
+}

package/dist/system-prompt/builder.d.ts

@@ -0,0 +1,5 @@
+/**
+ * System Prompt Builder — re-exported from @compilr-dev/sdk
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from '@compilr-dev/sdk';
+export type { SystemPromptContext, BuildResult } from '@compilr-dev/sdk';

package/dist/system-prompt/builder.js

@@ -0,0 +1,4 @@
+/**
+ * System Prompt Builder — re-exported from @compilr-dev/sdk
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from '@compilr-dev/sdk';

package/dist/system-prompt/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Modular System Prompt — re-exported from @compilr-dev/sdk
+ *
+ * Usage:
+ * ```typescript
+ * import { SystemPromptBuilder, buildSystemPrompt } from './system-prompt/index.js';
+ *
+ * // Simple usage
+ * const prompt = buildSystemPrompt({ hasGit: true, enableMetaTools: true });
+ *
+ * // Builder pattern for more control
+ * const builder = new SystemPromptBuilder({ hasGit: true });
+ * builder.setContext({ enableMetaTools: true, projectContext: '...' });
+ * const result = builder.build();
+ * ```
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, type SystemPromptContext, type BuildResult, } from './builder.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, type SystemPromptModule, type ModuleConditions, } from './modules.js';

package/dist/system-prompt/index.js

@@ -0,0 +1,18 @@
+/**
+ * Modular System Prompt — re-exported from @compilr-dev/sdk
+ *
+ * Usage:
+ * ```typescript
+ * import { SystemPromptBuilder, buildSystemPrompt } from './system-prompt/index.js';
+ *
+ * // Simple usage
+ * const prompt = buildSystemPrompt({ hasGit: true, enableMetaTools: true });
+ *
+ * // Builder pattern for more control
+ * const builder = new SystemPromptBuilder({ hasGit: true });
+ * builder.setContext({ enableMetaTools: true, projectContext: '...' });
+ * const result = builder.build();
+ * ```
+ */
+export { SystemPromptBuilder, buildSystemPrompt, detectGitRepository, getModuleStats, } from './builder.js';
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from './modules.js';

package/dist/system-prompt/modules.d.ts

@@ -0,0 +1,5 @@
+/**
+ * System Prompt Modules — re-exported from @compilr-dev/sdk
+ */
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from '@compilr-dev/sdk';
+export type { SystemPromptModule, ModuleConditions } from '@compilr-dev/sdk';

package/dist/system-prompt/modules.js

@@ -0,0 +1,4 @@
+/**
+ * System Prompt Modules — re-exported from @compilr-dev/sdk
+ */
+export { ALL_MODULES, IDENTITY_MODULE, STYLE_MODULE, TASK_EXECUTION_MODULE, TODO_MANAGEMENT_MODULE, TOOL_USAGE_DIRECT_MODULE, TOOL_USAGE_META_MODULE, DELEGATION_MODULE, GIT_SAFETY_MODULE, SUGGEST_MODULE, IMPORTANT_RULES_MODULE, ENVIRONMENT_MODULE, shouldIncludeModule, getEstimatedTokensForConditions, getTotalEstimatedTokens, } from '@compilr-dev/sdk';

package/dist/tabbed-menu.js

@@ -6,6 +6,7 @@
  */
 import pc from 'picocolors';
 import { getCustomCommandRegistry } from './commands/index.js';
+import { truncate } from './ui/base/index.js';
 // ANSI escape codes
 const ANSI = {
     HIDE_CURSOR: '\x1B[?25l',
@@ -151,7 +152,7 @@ function renderCustomCommandsTab() {
     else {
         for (const cmd of commands) {
             const name = `/${cmd.name}`.padEnd(20);
-            const desc = cmd.description.slice(0, 40) + (cmd.description.length > 40 ? '...' : '');
+            const desc = truncate(cmd.description, 40);
             const location = ` (${cmd.location})`;
             lines.push(' ' + pc.cyan(name) + pc.dim(desc) + pc.dim(location));
         }

package/dist/templates/compilr-md-import.d.ts

@@ -0,0 +1,16 @@
+/**
+ * COMPILR.md Template Generator for Imported Projects
+ *
+ * Generates the AI assistant context file for existing projects that are being imported.
+ * Different from the new project template - acknowledges existing codebase structure.
+ */
+import type { DetectedProject } from '../utils/project-detection.js';
+export interface ImportProjectConfig {
+    name: string;
+    displayName: string;
+    description?: string;
+    path: string;
+    detected: DetectedProject;
+    workflowMode: 'flexible' | 'guided';
+}
+export declare function generateCompilrMdForImport(config: ImportProjectConfig): string;

package/dist/templates/compilr-md-import.js

@@ -0,0 +1,241 @@
+/**
+ * COMPILR.md Template Generator for Imported Projects
+ *
+ * Generates the AI assistant context file for existing projects that are being imported.
+ * Different from the new project template - acknowledges existing codebase structure.
+ */
+export function generateCompilrMdForImport(config) {
+    const techStackSection = generateTechStackSection(config);
+    const structureSection = generateStructureSection(config);
+    return `# COMPILR.md
+
+This file provides guidance to AI coding assistants when working with this project.
+
+---
+
+## Project Overview
+
+**Project:** ${config.displayName}
+${config.description ? `**Description:** ${config.description}` : '*Add a description for this project*'}
+
+**Workflow:** ${config.workflowMode === 'guided' ? 'Guided (structured step-by-step workflow)' : 'Flexible (user-driven, exploratory)'}
+
+---
+
+${techStackSection}
+
+---
+
+${structureSection}
+
+---
+
+## Project Data (Database-Backed)
+
+This project uses compilr's database for tracking. Use these tools to access project data:
+
+| Data Type | Read Tool | Write Tool |
+|-----------|-----------|------------|
+| Work Items (Backlog) | \`workitem_query\` | \`workitem_add\`, \`workitem_update\` |
+| Project Documents | \`project_document_get\`, \`project_document_list\` | \`project_document_add\` |
+| Anchors (Context) | \`anchor_list\` | \`anchor_add\`, \`anchor_remove\` |
+
+**Important:** Use database tools for project metadata. Explore the existing codebase for implementation details.
+
+---
+
+## Development Commands
+
+\`\`\`bash
+${generateDevCommands(config)}
+\`\`\`
+
+---
+
+## Notes for AI Assistants
+
+1. **This is an existing codebase** - Explore the code structure before making changes
+2. **Respect existing patterns** - Follow the conventions already established in this project
+3. **Use database tools** to query backlog, documents, and anchors (project metadata)
+4. **Check the backlog** with \`workitem_query\` before starting new work
+5. **Read existing code** to understand the architecture before adding features
+
+---
+
+*Generated by compilr CLI on ${new Date().toISOString().split('T')[0]}*
+`;
+}
+function generateTechStackSection(config) {
+    const { detected } = config;
+    if (!detected.language) {
+        return `## Tech Stack
+
+*Tech stack not auto-detected. Update this section with your project's technologies.*
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Language  | TBD        |       |
+| Framework | TBD        |       |
+| Database  | TBD        |       |`;
+    }
+    const languageLabel = getLanguageLabel(detected.language);
+    const frameworkLabel = detected.framework ? getFrameworkLabel(detected.framework) : 'Not detected';
+    const packageManagerLabel = detected.packageManager ?? 'Not detected';
+    return `## Tech Stack
+
+*Auto-detected from project files. Update as needed.*
+
+| Component | Technology | Notes |
+|-----------|------------|-------|
+| Language  | ${languageLabel} | Detected |
+| Framework | ${frameworkLabel} | ${detected.framework ? 'Detected' : 'Update this'} |
+| Package Manager | ${packageManagerLabel} | ${detected.packageManager ? 'Detected' : 'Update this'} |
+| Database  | *Not detected* | Update this |`;
+}
+function generateStructureSection(config) {
+    const { detected } = config;
+    // Provide guidance based on detected language
+    const languageHints = {
+        node: `- \`src/\` - Source code
+- \`package.json\` - Dependencies and scripts
+- \`tsconfig.json\` - TypeScript configuration (if TypeScript)`,
+        python: `- \`src/\` or project module - Source code
+- \`pyproject.toml\` / \`requirements.txt\` - Dependencies
+- \`tests/\` - Test files`,
+        go: `- Go modules structure
+- \`go.mod\` - Module definition
+- \`cmd/\` - Main applications (if present)
+- \`internal/\` - Private packages (if present)`,
+        rust: `- \`src/\` - Source code
+- \`Cargo.toml\` - Dependencies and project config
+- \`target/\` - Build output (gitignored)`,
+        default: `*Explore the project to understand its structure.*`,
+    };
+    const hint = detected.language ? (languageHints[detected.language] ?? languageHints.default) : languageHints.default;
+    return `## Project Structure
+
+*This is an existing codebase. Key locations:*
+
+${hint}
+
+**Tip:** Use \`glob\` and \`read_file\` tools to explore the codebase structure.`;
+}
+function generateDevCommands(config) {
+    const { detected } = config;
+    // Generate appropriate dev commands based on language/package manager
+    const commands = {
+        node: `# Install dependencies
+npm install
+
+# Development
+npm run dev
+
+# Build
+npm run build
+
+# Test
+npm test`,
+        pnpm: `# Install dependencies
+pnpm install
+
+# Development
+pnpm dev
+
+# Build
+pnpm build
+
+# Test
+pnpm test`,
+        yarn: `# Install dependencies
+yarn install
+
+# Development
+yarn dev
+
+# Build
+yarn build
+
+# Test
+yarn test`,
+        python: `# Install dependencies (adjust for your package manager)
+pip install -r requirements.txt
+# or: poetry install
+# or: pdm install
+
+# Run application
+python -m ${config.name.replace(/-/g, '_')}
+
+# Test
+pytest`,
+        go: `# Download dependencies
+go mod download
+
+# Build
+go build ./...
+
+# Test
+go test ./...
+
+# Run (adjust for your main package)
+go run ./cmd/${config.name}`,
+        rust: `# Build
+cargo build
+
+# Run
+cargo run
+
+# Test
+cargo test`,
+        default: `# Update these commands for your project
+# npm run dev
+# npm run build
+# npm test`,
+    };
+    if (detected.packageManager === 'pnpm')
+        return commands.pnpm;
+    if (detected.packageManager === 'yarn')
+        return commands.yarn;
+    if (detected.language)
+        return commands[detected.language] ?? commands.default;
+    return commands.default;
+}
+// =============================================================================
+// Helper Functions (duplicated from project-detection for convenience)
+// =============================================================================
+function getLanguageLabel(language) {
+    const labels = {
+        node: 'Node.js / TypeScript',
+        go: 'Go',
+        python: 'Python',
+        rust: 'Rust',
+        java: 'Java',
+        kotlin: 'Kotlin',
+        php: 'PHP',
+        ruby: 'Ruby',
+        dotnet: '.NET (C#/F#)',
+    };
+    return labels[language] ?? language;
+}
+function getFrameworkLabel(framework) {
+    const labels = {
+        react: 'React',
+        vue: 'Vue.js',
+        svelte: 'Svelte',
+        angular: 'Angular',
+        next: 'Next.js',
+        nuxt: 'Nuxt.js',
+        express: 'Express.js',
+        fastify: 'Fastify',
+        koa: 'Koa',
+        hono: 'Hono',
+        electron: 'Electron',
+        fastapi: 'FastAPI',
+        django: 'Django',
+        flask: 'Flask',
+        rails: 'Ruby on Rails',
+        sinatra: 'Sinatra',
+        laravel: 'Laravel',
+        symfony: 'Symfony',
+    };
+    return labels[framework] ?? framework;
+}

package/dist/templates/compilr-md.js

@@ -27,57 +27,37 @@ ${codingStandardsSection}
 
 ---
 
-## Project Structure
+## Project Data (Database-Backed)
 
-${config.repoPattern === 'single' ? generateSingleRepoStructure() : generateTwoRepoStructure(config.name)}
+This project uses compilr's database for tracking. Use these tools to access project data:
 
----
-
-## Architecture Decisions
-
-Key architectural decisions are documented in:
-- ${config.repoPattern === 'single' ? '`.compilr/architecture/decisions/`' : '`02-architecture/decisions/`'}
-
-When making significant technical choices, create an ADR (Architecture Decision Record).
-
----
-
-## Current Focus
+| Data Type | Read Tool | Write Tool |
+|-----------|-----------|------------|
+| Work Items (Backlog) | \`workitem_query\` | \`workitem_add\`, \`workitem_update\` |
+| Project Documents | \`project_document_get\`, \`project_document_list\` | \`project_document_add\` |
+| Anchors (Context) | \`anchor_list\` | \`anchor_add\`, \`anchor_remove\` |
 
-*Updated by session management - tracks current sprint/milestone*
-
----
-
-## Key Files
-
-*Auto-populated based on usage - frequently referenced files appear here*
+**Important:** Always use database tools instead of exploring the filesystem for project data.
 
 ---
 
 ## Development Commands
 
 \`\`\`bash
-# Development
 npm run dev         # Start development server
 npm run build       # Production build
 npm run lint        # Lint code
 npm run test        # Run tests
-
-# Project workflow
-compilr start       # Begin coding session with context
-compilr save        # Save session progress
-compilr backlog     # View/manage tasks
 \`\`\`
 
 ---
 
 ## Notes for AI Assistants
 
-1. **Always read this file first** when starting a session
-2. **Check the backlog** before starting new work
+1. **Use database tools** to query backlog, documents, and anchors (not filesystem)
+2. **Check the backlog** with \`workitem_query\` before starting new work
 3. **Follow coding standards** defined in this project
 4. **Document decisions** when making architectural choices
-5. **Update session notes** at the end of each session
 
 ---
 
@@ -159,31 +139,3 @@ See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards
 See ${config.repoPattern === 'single' ? '`.compilr/architecture/coding-standards.md`' : '`02-architecture/coding-standards.md`'} for full details.`;
     return standards;
 }
-function generateSingleRepoStructure() {
-    return `\`\`\`
-{project}/
-├── .compilr/              # Workflow files
-│   ├── backlog.md         # Task tracking
-│   ├── architecture/      # ADRs, coding standards
-│   └── sessions/          # Session notes
-├── src/                   # Source code
-├── COMPILR.md             # This file
-├── package.json
-└── README.md
-\`\`\``;
-}
-function generateTwoRepoStructure(name) {
-    return `\`\`\`
-${name}/                   # Code repository
-├── src/
-├── package.json
-└── README.md
-
-${name}-docs/              # Documentation repository
-├── .compilr/
-├── COMPILR.md             # This file
-├── 01-planning/           # Backlog, roadmap
-├── 02-architecture/       # ADRs, standards
-└── 04-session-notes/      # Session history
-\`\`\``;
-}

package/dist/templates/config-json.d.ts

@@ -4,31 +4,7 @@
  * Generates the .compilr/config.json file for workflow versioning and settings.
  */
 import type { ProjectConfig } from './types.js';
-export interface CompilrConfig {
-    version: string;
-    project: {
-        name: string;
-        description: string;
-        createdAt: string;
-    };
-    paths: {
-        /** Absolute path to the project/code repository */
-        project: string;
-        /** Absolute path to the docs repository (two-repo pattern only) */
-        docs: string | null;
-        /** Directory where .compilr/config.json lives (for reference) */
-        workflowRoot: string;
-    };
-    settings: {
-        repoPattern: 'single' | 'two-repo';
-        techStack: string;
-        codingStandards: string;
-    };
-    sessions: {
-        count: number;
-        lastSession: string | null;
-    };
-}
+export type { CompilrConfig } from '../utils/types/config-types.js';
 /**
  * Generate config.json content
  * @param config Project configuration

package/dist/templates/index.d.ts

@@ -5,6 +5,8 @@
  */
 import type { ProjectConfig, GenerationResult } from './types.js';
 export * from './types.js';
+export { generateCompilrMdForImport } from './compilr-md-import.js';
+export type { ImportProjectConfig } from './compilr-md-import.js';
 /**
  * Generate a new project from configuration
  */