@hexidecibel/companion 0.0.1 → 0.1.1

package/dist/scaffold/claude-commands.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * Generates CLAUDE.md content and .claude/commands/*.md files
+ * tailored to each project template.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateClaudeMd = generateClaudeMd;
+exports.generateCommandFiles = generateCommandFiles;
+const STACK_CONFIGS = {
+    'react-typescript': {
+        upCmd: 'npm run dev',
+        downCmd: 'Stop the Vite dev server (Ctrl+C in terminal)',
+        testCmd: 'npm test',
+        buildCmd: 'npm run build',
+        installCmd: 'npm install',
+        devServer: 'Vite dev server',
+        language: 'TypeScript',
+    },
+    'react-mui-website': {
+        upCmd: 'npm run dev',
+        downCmd: 'Stop the Vite dev server (Ctrl+C in terminal)',
+        testCmd: 'npm test',
+        buildCmd: 'npm run build',
+        installCmd: 'npm install',
+        devServer: 'Vite dev server',
+        language: 'TypeScript',
+    },
+    'node-express': {
+        upCmd: 'npm run dev',
+        downCmd: 'Stop the Express server (Ctrl+C in terminal)',
+        testCmd: 'npm test',
+        buildCmd: 'npm run build',
+        installCmd: 'npm install',
+        devServer: 'Express dev server with ts-node',
+        language: 'TypeScript',
+    },
+    'python-fastapi': {
+        upCmd: 'uvicorn main:app --reload',
+        downCmd: 'Stop the uvicorn server (Ctrl+C in terminal)',
+        testCmd: 'pytest',
+        installCmd: 'pip install -r requirements.txt',
+        devServer: 'uvicorn with hot reload',
+        language: 'Python',
+    },
+    nextjs: {
+        upCmd: 'npm run dev',
+        downCmd: 'Stop the Next.js dev server (Ctrl+C in terminal)',
+        testCmd: 'npm test',
+        buildCmd: 'npm run build',
+        installCmd: 'npm install',
+        devServer: 'Next.js dev server',
+        language: 'TypeScript',
+    },
+    'go-cli': {
+        upCmd: 'go run .',
+        downCmd: 'N/A (CLI exits after execution)',
+        testCmd: 'go test ./...',
+        buildCmd: 'go build -o bin/',
+        language: 'Go',
+    },
+    'typescript-library': {
+        upCmd: 'npm run build -- --watch',
+        downCmd: 'Stop the TypeScript watcher (Ctrl+C in terminal)',
+        testCmd: 'npm test',
+        buildCmd: 'npm run build',
+        installCmd: 'npm install',
+        language: 'TypeScript',
+    },
+};
+const DEFAULT_CONFIG = {
+    upCmd: 'npm run dev',
+    downCmd: 'Stop the dev server',
+    testCmd: 'npm test',
+    buildCmd: 'npm run build',
+    installCmd: 'npm install',
+    language: 'TypeScript',
+};
+function getStackConfig(templateId) {
+    return STACK_CONFIGS[templateId] || DEFAULT_CONFIG;
+}
+/**
+ * Generate CLAUDE.md content for a project.
+ */
+function generateClaudeMd(projectName, description, templateId) {
+    const config = getStackConfig(templateId);
+    const sections = [];
+    sections.push(`# ${projectName}`);
+    sections.push('');
+    sections.push(description);
+    sections.push('');
+    // Commands section
+    sections.push('## Commands');
+    sections.push('');
+    if (config.installCmd) {
+        sections.push(`- Install: \`${config.installCmd}\``);
+    }
+    if (config.buildCmd) {
+        sections.push(`- Build: \`${config.buildCmd}\``);
+    }
+    sections.push(`- Dev: \`${config.upCmd}\``);
+    sections.push(`- Test: \`${config.testCmd}\``);
+    sections.push('');
+    // Code style
+    sections.push('## Code Style');
+    sections.push('');
+    sections.push(`- Language: ${config.language}`);
+    sections.push('- Use functional patterns where possible');
+    sections.push('- Keep functions small and focused');
+    sections.push('- Prefer explicit types over `any`');
+    sections.push('');
+    // Workflow
+    sections.push('## Workflow');
+    sections.push('');
+    sections.push('Use the slash commands for common tasks:');
+    sections.push('- `/up` — Start dev server');
+    sections.push('- `/down` — Stop services');
+    sections.push('- `/test` — Run test suite');
+    sections.push('- `/todo` — Capture a task');
+    sections.push('- `/plan` — Plan implementation from todo');
+    sections.push('- `/work` — Implement planned items');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Generate .claude/commands/*.md files for a project.
+ */
+function generateCommandFiles(projectName, templateId) {
+    const config = getStackConfig(templateId);
+    const commands = [
+        {
+            name: 'up',
+            path: '.claude/commands/up.md',
+            content: generateUpCommand(projectName, config),
+        },
+        {
+            name: 'down',
+            path: '.claude/commands/down.md',
+            content: generateDownCommand(projectName, config),
+        },
+        {
+            name: 'todo',
+            path: '.claude/commands/todo.md',
+            content: generateTodoCommand(projectName),
+        },
+        {
+            name: 'plan',
+            path: '.claude/commands/plan.md',
+            content: generatePlanCommand(projectName),
+        },
+        {
+            name: 'work',
+            path: '.claude/commands/work.md',
+            content: generateWorkCommand(projectName, config),
+        },
+        {
+            name: 'test',
+            path: '.claude/commands/test.md',
+            content: generateTestCommand(projectName, config),
+        },
+    ];
+    return commands;
+}
+function generateUpCommand(projectName, config) {
+    const lines = [];
+    lines.push(`# Start ${projectName}`);
+    lines.push('');
+    lines.push(`Start the development server/services for ${projectName}.`);
+    lines.push('');
+    lines.push('## Steps');
+    lines.push('');
+    if (config.installCmd) {
+        lines.push(`1. Install dependencies if needed: \`${config.installCmd}\``);
+        lines.push(`2. Start: \`${config.upCmd}\``);
+    }
+    else {
+        lines.push(`1. Start: \`${config.upCmd}\``);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function generateDownCommand(projectName, config) {
+    const lines = [];
+    lines.push(`# Stop ${projectName}`);
+    lines.push('');
+    lines.push(`Stop running services for ${projectName}.`);
+    lines.push('');
+    lines.push('## Steps');
+    lines.push('');
+    lines.push(`1. ${config.downCmd}`);
+    lines.push('');
+    return lines.join('\n');
+}
+function generateTodoCommand(_projectName) {
+    return `# Add Todo Item
+
+Quickly capture ideas and tasks to todo.md.
+
+## Usage
+
+\`\`\`
+/todo <description>
+\`\`\`
+
+## Instructions
+
+1. The item to add: \`$ARGUMENTS\`
+
+2. Read or create todo.md
+
+3. Add the item as a bullet point:
+   - Format: \`- <the text>\`
+   - Add under the appropriate section
+
+4. Confirm what was added
+
+## Notes
+
+- This is for quick capture - don't overthink it
+- Use \`/plan\` later to process these into detailed plans
+- Use \`/work\` to implement from the plan
+`;
+}
+function generatePlanCommand(_projectName) {
+    return `# Plan from Todo
+
+Process todo.md items into detailed implementation plans.
+
+## Instructions
+
+1. Read todo.md
+
+2. Read plan.md (if exists)
+
+3. For each unplanned item in todo.md:
+   - Ask clarifying questions if needed
+   - Understand the scope and requirements
+   - Identify which files need changes
+
+4. Write detailed plan to plan.md:
+   \`\`\`markdown
+   # Implementation Plan
+
+   ## Item: <title>
+   **Status:** planned | in-progress | done
+
+   ### Requirements
+   - <bullet points>
+
+   ### Files to Modify
+   - \`path/to/file\` - <what changes>
+
+   ### Implementation Steps
+   1. <step>
+   2. <step>
+
+   ### Tests Needed
+   - <test case>
+   \`\`\`
+
+5. Mark items as planned in todo.md
+
+## Rules
+
+- NO CODING in this phase
+- Ask questions if anything is unclear
+- Keep plans focused and actionable
+`;
+}
+function generateWorkCommand(_projectName, config) {
+    const typeCheck = config.language === 'Python'
+        ? 'mypy .'
+        : config.language === 'Go'
+            ? 'go vet ./...'
+            : 'npx tsc --noEmit';
+    return `# Work on Planned Items
+
+Implement items from plan.md using TDD. If multiple items can be parallelized, spawn worker sessions.
+
+## Instructions
+
+1. Read plan.md
+
+2. Find ALL items with **Status: planned** or **Status: in-progress**
+
+3. **If 2+ planned items exist, analyze parallelism:**
+
+   a. For each item, look at the "Files to Modify" section
+   b. Compare file lists between items \u2014 items with NO shared files can run in parallel
+   c. Group items into:
+      - **Parallel group**: Items with non-overlapping files
+      - **Sequential group**: Items that share files with another item
+
+   d. Present the analysis via AskUserQuestion:
+      - Show which items can be parallelized and why
+      - Show which items must be sequential and why (list shared files)
+      - Options: [Parallelize] [Work sequentially] [Let me choose]
+
+   e. If user approves parallelization, spawn worker sessions by calling the
+      companion daemon API with a \\\`spawn_work_group\\\` message via curl to
+      \\\`http://localhost:9877\\\`. Include the token from config, a group name,
+      the current session ID, the parent directory, and a workers array with
+      each worker's taskSlug, taskDescription, planSection, and files list.
+
+   f. After spawning, continue working on sequential items (if any) using TDD
+   g. When done with sequential items, check worker status and report
+
+4. **If only 1 item, or user chose sequential:** Follow TDD for each item:
+
+   a. **Write tests first**
+      - Create/update test files based on "Tests Needed" section
+      - Run tests - they should fail (red)
+
+   b. **Implement the feature**
+      - Follow the "Implementation Steps" from plan
+      - Make tests pass (green)
+      - Run type check: \`${typeCheck}\`
+
+   c. **Refactor if needed**
+      - Clean up code while keeping tests green
+
+   d. **Commit**
+      - Commit with descriptive message
+      - Update plan.md status to "done"
+
+5. When ALL items are done (including parallel workers), merge if needed by
+   calling the daemon API with a \\\`merge_work_group\\\` message.
+
+## Rules
+
+- Tests first, always
+- Commit after each completed item
+- NO push without explicit approval
+- Ask if stuck or unclear
+- When spawning workers, each worker handles ONE plan item only
+- Workers should not modify files outside their scope
+`;
+}
+function generateTestCommand(_projectName, config) {
+    const lines = [];
+    lines.push(`# Run Tests`);
+    lines.push('');
+    lines.push('Run the project test suite.');
+    lines.push('');
+    lines.push('## Steps');
+    lines.push('');
+    lines.push(`1. Run: \`${config.testCmd}\``);
+    lines.push('2. Report results: pass/fail count, any failures');
+    lines.push('3. If tests fail, show the failure details');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=claude-commands.js.map

package/dist/scaffold/claude-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-commands.js","sourceRoot":"","sources":["../../src/scaffold/claude-commands.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/scaffold/generator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAiB,MAAM,SAAS,CAAC;AAgBzF,KAAK,gBAAgB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAoB7D,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA2IzB;AAGD,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAUvE"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/scaffold/generator.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiB1E,KAAK,gBAAgB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAoB7D,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,EACrB,UAAU,CAAC,EAAE,gBAAgB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAuKzB;AAGD,wBAAsB,eAAe,CACnC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBvE"}

package/dist/scaffold/generator.js

@@ -41,6 +41,7 @@ const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const util_1 = require("util");
 const templates_1 = require("./templates");
+const claude_commands_1 = require("./claude-commands");
 // Expand ~ to home directory
 function expandPath(p) {
     if (p.startsWith('~/')) {
@@ -109,6 +110,24 @@ async function scaffoldProject(config, onProgress) {
             await fs.writeFile(filePath, fileContent, 'utf-8');
             filesCreated.push(file.path);
         }
+        // Step 2b: Generate CLAUDE.md and .claude/commands/
+        onProgress?.({
+            step: 'Generating CLAUDE.md and commands',
+            progress: 58,
+            complete: false,
+        });
+        const claudeMdContent = (0, claude_commands_1.generateClaudeMd)(variables.projectName, config.description || `A ${template.name} project`, config.stackId);
+        const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+        await fs.writeFile(claudeMdPath, claudeMdContent, 'utf-8');
+        filesCreated.push('CLAUDE.md');
+        const commandFiles = (0, claude_commands_1.generateCommandFiles)(variables.projectName, config.stackId);
+        const commandsDir = path.join(projectPath, '.claude', 'commands');
+        await fs.mkdir(commandsDir, { recursive: true });
+        for (const cmd of commandFiles) {
+            const cmdPath = path.join(projectPath, cmd.path);
+            await fs.writeFile(cmdPath, cmd.content, 'utf-8');
+            filesCreated.push(cmd.path);
+        }
         // Step 3: Initialize git if requested
         if (config.options.initGit) {
             onProgress?.({
@@ -200,7 +219,13 @@ async function previewScaffold(config) {
         return { error: `Unknown template: ${config.stackId}` };
     }
     const projectPath = path.join(expandPath(config.location), toValidName(config.name));
-    const files = template.files.map(f => f.path);
+    const files = template.files.map((f) => f.path);
+    // Include CLAUDE.md and commands in preview
+    files.push('CLAUDE.md');
+    const commandFiles = (0, claude_commands_1.generateCommandFiles)(toValidName(config.name), config.stackId);
+    for (const cmd of commandFiles) {
+        files.push(cmd.path);
+    }
     return { files, projectPath };
 }
 //# sourceMappingURL=generator.js.map

package/dist/scaffold/generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/scaffold/generator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../src/scaffold/generator.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/scorer.d.ts

@@ -0,0 +1,19 @@
+import { StackTemplate } from './types';
+export interface ScoredTemplate {
+    templateId: string;
+    score: number;
+    matchedKeywords: string[];
+}
+/**
+ * Score templates against a user description.
+ * Pure function, no I/O.
+ *
+ * Weights:
+ *  - useCases substring match: 5
+ *  - primaryKeywords token match: 3
+ *  - typeSignals synonym match: 2
+ *  - secondaryKeywords token match: 1
+ *  - tags token match: 0.5
+ */
+export declare function scoreTemplates(templates: StackTemplate[], description: string): ScoredTemplate[];
+//# sourceMappingURL=scorer.d.ts.map

package/dist/scaffold/scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.d.ts","sourceRoot":"","sources":["../../src/scaffold/scorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAkBD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,cAAc,EAAE,CAwEhG"}

package/dist/scaffold/scorer.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreTemplates = scoreTemplates;
+/**
+ * Tokenize a description into lowercase words and bigrams.
+ */
+function tokenize(text) {
+    const lower = text.toLowerCase();
+    const words = lower.match(/[a-z0-9]+/g) || [];
+    const tokens = new Set(words);
+    // Add bigrams (consecutive word pairs)
+    for (let i = 0; i < words.length - 1; i++) {
+        tokens.add(`${words[i]} ${words[i + 1]}`);
+    }
+    return tokens;
+}
+/**
+ * Score templates against a user description.
+ * Pure function, no I/O.
+ *
+ * Weights:
+ *  - useCases substring match: 5
+ *  - primaryKeywords token match: 3
+ *  - typeSignals synonym match: 2
+ *  - secondaryKeywords token match: 1
+ *  - tags token match: 0.5
+ */
+function scoreTemplates(templates, description) {
+    if (!description || !description.trim()) {
+        return templates.map((t) => ({ templateId: t.id, score: 0, matchedKeywords: [] }));
+    }
+    const descLower = description.toLowerCase();
+    const tokens = tokenize(description);
+    const rawScores = [];
+    let maxRaw = 0;
+    for (const template of templates) {
+        let raw = 0;
+        const matched = [];
+        const scoring = template.scoring;
+        if (scoring) {
+            // useCases: substring match against full description (weight 5)
+            for (const useCase of scoring.useCases) {
+                if (descLower.includes(useCase.toLowerCase())) {
+                    raw += 5;
+                    matched.push(useCase);
+                }
+            }
+            // primaryKeywords: token match (weight 3)
+            for (const kw of scoring.primaryKeywords) {
+                if (tokens.has(kw.toLowerCase())) {
+                    raw += 3;
+                    matched.push(kw);
+                }
+            }
+            // typeSignals: synonym match (weight 2 * signal value)
+            for (const [signal, value] of Object.entries(scoring.typeSignals)) {
+                if (tokens.has(signal.toLowerCase())) {
+                    raw += 2 * value;
+                    matched.push(signal);
+                }
+            }
+            // secondaryKeywords: token match (weight 1)
+            for (const kw of scoring.secondaryKeywords) {
+                if (tokens.has(kw.toLowerCase())) {
+                    raw += 1;
+                    matched.push(kw);
+                }
+            }
+        }
+        // tags: token match (weight 0.5)
+        for (const tag of template.tags) {
+            if (tokens.has(tag.toLowerCase())) {
+                raw += 0.5;
+                if (!matched.includes(tag)) {
+                    matched.push(tag);
+                }
+            }
+        }
+        if (raw > maxRaw)
+            maxRaw = raw;
+        rawScores.push({ templateId: template.id, raw, matchedKeywords: matched });
+    }
+    // Normalize to 0.0–1.0
+    return rawScores
+        .map((s) => ({
+        templateId: s.templateId,
+        score: maxRaw > 0 ? Math.round((s.raw / maxRaw) * 100) / 100 : 0,
+        matchedKeywords: s.matchedKeywords,
+    }))
+        .sort((a, b) => b.score - a.score || a.templateId.localeCompare(b.templateId));
+}
+//# sourceMappingURL=scorer.js.map

package/dist/scaffold/scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scorer.js","sourceRoot":"","sources":["../../src/scaffold/scorer.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/templates/go-cli.d.ts

@@ -0,0 +1,3 @@
+import { StackTemplate } from '../types';
+export declare const goCliTemplate: StackTemplate;
+//# sourceMappingURL=go-cli.d.ts.map

package/dist/scaffold/templates/go-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-cli.d.ts","sourceRoot":"","sources":["../../../src/scaffold/templates/go-cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,aAAa,EAAE,aAoP3B,CAAC"}