@compilr-dev/cli 0.5.0 → 0.5.2

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
-
-*Updated by session management - tracks current sprint/milestone*
-
----
-
-## Key Files
+| 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\` |
 
-*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,34 +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
-│   ├── architecture/      # ADRs, coding standards
-│   └── sessions/          # Session notes
-├── src/                   # Source code
-├── COMPILR.md             # This file
-├── package.json
-└── README.md
-\`\`\`
-
-**Note:** Backlog/tasks are tracked in the compilr database. Use \`/backlog\` command to view.`;
-}
-function generateTwoRepoStructure(name) {
-    return `\`\`\`
-${name}/                   # Code repository
-├── src/
-├── package.json
-└── README.md
-
-${name}-docs/              # Documentation repository
-├── .compilr/
-├── COMPILR.md             # This file
-├── 01-planning/           # Roadmap
-├── 02-architecture/       # ADRs, standards
-└── 04-session-notes/      # Session history
-\`\`\`
-
-**Note:** Backlog/tasks are tracked in the compilr database. Use \`/backlog\` command to view.`;
-}

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
  */

package/dist/templates/index.js

@@ -15,6 +15,8 @@ import { generateReadmeMd } from './readme-md.js';
 import { generatePackageJson } from './package-json.js';
 import { generateGitignore } from './gitignore.js';
 import { generateTsconfig } from './tsconfig.js';
+// Import project template
+export { generateCompilrMdForImport } from './compilr-md-import.js';
 // =============================================================================
 // Main Generator
 // =============================================================================
@@ -50,7 +52,6 @@ function generateSingleRepoProject(config, basePath, filesCreated) {
         projectPath,
         path.join(projectPath, 'src'),
         path.join(projectPath, '.compilr'),
-        path.join(projectPath, '.compilr', 'requirements'),
         path.join(projectPath, '.compilr', 'architecture'),
         path.join(projectPath, '.compilr', 'architecture', 'decisions'),
         path.join(projectPath, '.compilr', 'docs'),
@@ -67,17 +68,13 @@ function generateSingleRepoProject(config, basePath, filesCreated) {
         { path: path.join(projectPath, 'package.json'), content: generatePackageJson(config) },
         { path: path.join(projectPath, '.gitignore'), content: generateGitignore(config) },
         { path: path.join(projectPath, 'tsconfig.json'), content: generateTsconfig(config) },
-        // .compilr files (backlog is now tracked in database, not as file)
+        // .compilr files (backlog and PRD are now tracked in database, not as files)
         { path: path.join(projectPath, '.compilr', 'config.json'), content: generateConfigJson(config, projectPath) },
         { path: path.join(projectPath, '.compilr', 'roadmap.md'), content: generateRoadmapMd(config) },
         {
             path: path.join(projectPath, '.compilr', 'architecture', 'coding-standards.md'),
             content: generateCodingStandardsMd(config),
         },
-        {
-            path: path.join(projectPath, '.compilr', 'requirements', 'PRD.md'),
-            content: generatePrdMd(config),
-        },
         {
             path: path.join(projectPath, '.compilr', 'docs', 'README.md'),
             content: '# Documentation\n\n*Add your documentation here*\n',
@@ -116,7 +113,6 @@ function generateTwoRepoProject(config, basePath, filesCreated) {
     const docsDirs = [
         docsPath,
         path.join(docsPath, '.compilr'),
-        path.join(docsPath, '00-requirements'),
         path.join(docsPath, '01-planning'),
         path.join(docsPath, '02-architecture'),
         path.join(docsPath, '02-architecture', 'decisions'),
@@ -141,8 +137,7 @@ function generateTwoRepoProject(config, basePath, filesCreated) {
     const docsFiles = [
         { path: path.join(docsPath, 'COMPILR.md'), content: generateCompilrMd(config) },
         { path: path.join(docsPath, '.compilr', 'config.json'), content: generateConfigJson(config, projectPath, docsPath) },
-        { path: path.join(docsPath, '00-requirements', 'PRD.md'), content: generatePrdMd(config) },
-        // backlog.md removed - backlog is now tracked in database
+        // PRD and backlog are now tracked in database, not as files
         { path: path.join(docsPath, '01-planning', 'roadmap.md'), content: generateRoadmapMd(config) },
         {
             path: path.join(docsPath, '02-architecture', 'coding-standards.md'),
@@ -176,14 +171,40 @@ function generateTwoRepoProject(config, basePath, filesCreated) {
 // =============================================================================
 // Helper Functions
 // =============================================================================
+/**
+ * Check if git user.name and user.email are configured
+ */
+function isGitConfigured() {
+    try {
+        const name = execSync('git config --global user.name', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const email = execSync('git config --global user.email', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return Boolean(name && email);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize git repository
+ * If git config is not set, only runs git init (skips commit)
+ */
 function initGit(projectPath) {
     try {
         execSync('git init', { cwd: projectPath, stdio: 'ignore' });
         execSync('git add .', { cwd: projectPath, stdio: 'ignore' });
-        execSync('git commit -m "Initial commit from compilr init"', {
-            cwd: projectPath,
-            stdio: 'ignore',
-        });
+        // Only commit if git config is set
+        if (isGitConfigured()) {
+            execSync('git commit -m "Initial commit from compilr init"', {
+                cwd: projectPath,
+                stdio: 'ignore',
+            });
+        }
     }
     catch {
         // Git init failed - not critical
@@ -221,66 +242,6 @@ ${config.description}
 
 ---
 
-*Last Updated: ${new Date().toISOString().split('T')[0]}*
-`;
-}
-function generatePrdMd(config) {
-    return `# Product Requirements Document - ${config.name}
-
-## Overview
-
-${config.description}
-
----
-
-## Problem Statement
-
-*What problem does this project solve?*
-
----
-
-## Goals
-
-1. *Primary goal*
-2. *Secondary goal*
-3. *Success metrics*
-
----
-
-## User Stories
-
-### As a user, I want to...
-
-1. *User story 1*
-2. *User story 2*
-3. *User story 3*
-
----
-
-## Requirements
-
-### Functional Requirements
-
-| ID | Requirement | Priority |
-|----|-------------|----------|
-| FR-1 | | High |
-| FR-2 | | Medium |
-| FR-3 | | Low |
-
-### Non-Functional Requirements
-
-- Performance: *Specify targets*
-- Security: *Specify requirements*
-- Accessibility: *Specify standards*
-
----
-
-## Out of Scope
-
-*What is NOT included in this version*
-
----
-
 *Last Updated: ${new Date().toISOString().split('T')[0]}*
 `;
 }

package/dist/tool-names.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Tool Names - Single Source of Truth
+ *
+ * This file contains ONLY tool name constants with NO imports.
+ * This breaks circular dependency chains and ensures all modules
+ * can safely import tool names.
+ *
+ * Import from here instead of tools.ts when you only need the names.
+ */
+/**
+ * All tool names as constants. Import these instead of hardcoding strings.
+ * This ensures all tool references stay in sync across the codebase.
+ */
+export declare const TOOL_NAMES: {
+    readonly READ_FILE: "read_file";
+    readonly WRITE_FILE: "write_file";
+    readonly EDIT: "edit";
+    readonly BASH: "bash";
+    readonly BASH_OUTPUT: "bash_output";
+    readonly KILL_SHELL: "kill_shell";
+    readonly GLOB: "glob";
+    readonly GREP: "grep";
+    readonly TODO_WRITE: "todo_write";
+    readonly TODO_READ: "todo_read";
+    readonly TODO_CLAIM: "todo_claim";
+    readonly TODO_HANDOFF: "todo_handoff";
+    readonly ASK_USER: "ask_user";
+    readonly ASK_USER_SIMPLE: "ask_user_simple";
+    readonly DELEGATE: "delegate";
+    readonly DELEGATE_BACKGROUND: "delegate_background";
+    readonly DELEGATION_STATUS: "delegation_status";
+    readonly HANDOFF: "handoff";
+    readonly COMPILR_GUIDE: "compilr_guide";
+    readonly TASK: "task";
+    readonly SUGGEST: "suggest";
+    readonly LIST_TOOLS: "list_tools";
+    readonly GET_TOOL_INFO: "get_tool_info";
+    readonly USE_TOOL: "use_tool";
+    readonly GIT_STATUS: "git_status";
+    readonly GIT_DIFF: "git_diff";
+    readonly GIT_LOG: "git_log";
+    readonly GIT_COMMIT: "git_commit";
+    readonly GIT_BRANCH: "git_branch";
+    readonly GIT_STASH: "git_stash";
+    readonly GIT_BLAME: "git_blame";
+    readonly GIT_FILE_HISTORY: "git_file_history";
+    readonly DETECT_PROJECT: "detect_project";
+    readonly FIND_PROJECT_ROOT: "find_project_root";
+    readonly RUN_TESTS: "run_tests";
+    readonly RUN_LINT: "run_lint";
+    readonly RUN_BUILD: "run_build";
+    readonly RUN_FORMAT: "run_format";
+    readonly FIND_DEFINITION: "find_definition";
+    readonly FIND_REFERENCES: "find_references";
+    readonly FIND_TODOS: "find_todos";
+    readonly CHECK_OUTDATED: "check_outdated";
+    readonly FIND_VULNERABILITIES: "find_vulnerabilities";
+    readonly ANALYZE_TEST_COVERAGE: "analyze_test_coverage";
+    readonly GET_FILE_STRUCTURE: "get_file_structure";
+    readonly GET_COMPLEXITY: "get_complexity";
+    readonly READ_FUNCTION: "read_function";
+    readonly READ_CLASS: "read_class";
+    readonly READ_TYPE: "read_type";
+    readonly BACKLOG_READ: "backlog_read";
+    readonly BACKLOG_WRITE: "backlog_write";
+    readonly WORKITEM_ADD: "workitem_add";
+    readonly WORKITEM_UPDATE: "workitem_update";
+    readonly WORKITEM_DELETE: "workitem_delete";
+    readonly WORKITEM_QUERY: "workitem_query";
+    readonly WORKITEM_NEXT: "workitem_next";
+    readonly WORKITEM_ADVANCE_STEP: "workitem_advance_step";
+    readonly WORKITEM_STATUS_COUNTS: "workitem_status_counts";
+    readonly WORKITEM_CLAIM: "workitem_claim";
+    readonly WORKITEM_HANDOFF: "workitem_handoff";
+    readonly PROJECT_GET: "project_get";
+    readonly PROJECT_LIST: "project_list";
+    readonly PROJECT_UPDATE: "project_update";
+    readonly PROJECT_DOCUMENT_ADD: "project_document_add";
+    readonly PROJECT_DOCUMENT_GET: "project_document_get";
+    readonly PROJECT_DOCUMENT_LIST: "project_document_list";
+    readonly PROJECT_DOCUMENT_DELETE: "project_document_delete";
+    readonly PLAN_CREATE: "plan_create";
+    readonly PLAN_UPDATE: "plan_update";
+    readonly PLAN_GET: "plan_get";
+    readonly PLAN_LIST: "plan_list";
+    readonly PLAN_DELETE: "plan_delete";
+    readonly ANCHOR_ADD: "anchor_add";
+    readonly ANCHOR_LIST: "anchor_list";
+    readonly ANCHOR_REMOVE: "anchor_remove";
+    readonly ARTIFACT_SAVE: "artifact_save";
+    readonly ARTIFACT_GET: "artifact_get";
+    readonly ARTIFACT_LIST: "artifact_list";
+    readonly ARTIFACT_DELETE: "artifact_delete";
+    readonly RECALL_WORK: "recall_work";
+    readonly APP_MODEL_GET: "app_model_get";
+    readonly APP_MODEL_UPDATE: "app_model_update";
+    readonly APP_MODEL_VALIDATE: "app_model_validate";
+    readonly FACTORY_SCAFFOLD: "factory_scaffold";
+    readonly FACTORY_LIST_TOOLKITS: "factory_list_toolkits";
+};
+/** Type for all valid tool names */
+export type ToolName = (typeof TOOL_NAMES)[keyof typeof TOOL_NAMES];
+/** Array of all direct tool names (always available) */
+export declare const DIRECT_TOOL_NAMES: readonly ToolName[];
+/** Array of all meta-tool names (tool discovery) */
+export declare const META_TOOL_NAMES: readonly ToolName[];
+/** Array of all meta-registry tool names (accessed via use_tool) */
+export declare const META_REGISTRY_TOOL_NAMES: readonly ToolName[];
+/**
+ * Get all tool names as an array.
+ * Useful for validation or iteration.
+ */
+export declare function getAllToolNames(): string[];