/** * Profile Output — profile rendering, questionnaire, and artifact generation * * Renders profiling analysis into user-facing artifacts: * - write-profile: USER-PROFILE.md from analysis JSON * - profile-questionnaire: fallback when no sessions available * - generate-dev-preferences: dev-preferences.md command artifact * - generate-claude-profile: Developer Profile section in CLAUDE.md * - generate-claude-md: full CLAUDE.md with managed sections */ const fs = require('fs'); const path = require('path'); const os = require('os'); const { output, error, safeReadFile } = require('./core.cjs'); // ─── Constants ──────────────────────────────────────────────────────────────── const DIMENSION_KEYS = [ 'communication_style', 'decision_speed', 'explanation_depth', 'debugging_approach', 'ux_philosophy', 'vendor_philosophy', 'frustration_triggers', 'learning_style' ]; const PROFILING_QUESTIONS = [ { dimension: 'communication_style', header: 'Communication Style', context: 'Think about the last few times you asked Claude to build or change something. How did you frame the request?', question: 'When you ask Claude to build something, how much context do you typically provide?', options: [ { label: 'Minimal -- "fix the bug", "add dark mode", just say what\'s needed', value: 'a', rating: 'terse-direct' }, { label: 'Some context -- explain what and why in a paragraph or two', value: 'b', rating: 'conversational' }, { label: 'Detailed specs -- headers, numbered lists, problem analysis, constraints', value: 'c', rating: 'detailed-structured' }, { label: 'It depends on the task -- simple tasks get short prompts, complex ones get detailed specs', value: 'd', rating: 'mixed' }, ], }, { dimension: 'decision_speed', header: 'Decision Making', context: 'Think about times when Claude presented you with multiple options -- like choosing a library, picking an architecture, or selecting an approach.', question: 'When Claude presents you with options, how do you typically decide?', options: [ { label: 'Pick quickly based on gut feeling or past experience', value: 'a', rating: 'fast-intuitive' }, { label: 'Ask for a comparison table or pros/cons, then decide', value: 'b', rating: 'deliberate-informed' }, { label: 'Research independently (read docs, check GitHub stars) before deciding', value: 'c', rating: 'research-first' }, { label: 'Let Claude recommend -- I generally trust the suggestion', value: 'd', rating: 'delegator' }, ], }, { dimension: 'explanation_depth', header: 'Explanation Preferences', context: 'Think about when Claude explains code it wrote or an approach it took. How much detail feels right?', question: 'When Claude explains something, how much detail do you want?', options: [ { label: 'Just the code -- I\'ll read it and figure it out myself', value: 'a', rating: 'code-only' }, { label: 'Brief explanation with the code -- a sentence or two about the approach', value: 'b', rating: 'concise' }, { label: 'Detailed walkthrough -- explain the approach, trade-offs, and code structure', value: 'c', rating: 'detailed' }, { label: 'Deep dive -- teach me the concepts behind it so I understand the fundamentals', value: 'd', rating: 'educational' }, ], }, { dimension: 'debugging_approach', header: 'Debugging Style', context: 'Think about the last few times something broke in your code. How did you approach it with Claude?', question: 'When something breaks, how do you typically approach debugging with Claude?', options: [ { label: 'Paste the error and say "fix it" -- get it working fast', value: 'a', rating: 'fix-first' }, { label: 'Share the error plus context, ask Claude to diagnose what went wrong', value: 'b', rating: 'diagnostic' }, { label: 'Investigate myself first, then ask Claude about my specific theories', value: 'c', rating: 'hypothesis-driven' }, { label: 'Walk through the code together step by step to understand the issue', value: 'd', rating: 'collaborative' }, ], }, { dimension: 'ux_philosophy', header: 'UX Philosophy', context: 'Think about user-facing features you have built recently. How did you balance functionality with design?', question: 'When building user-facing features, what do you prioritize?', options: [ { label: 'Get it working first, polish the UI later (or never)', value: 'a', rating: 'function-first' }, { label: 'Basic usability from the start -- nothing ugly, but no pixel-perfection', value: 'b', rating: 'pragmatic' }, { label: 'Design and UX are as important as functionality -- I care about the experience', value: 'c', rating: 'design-conscious' }, { label: 'I mostly build backend, CLI, or infrastructure -- UX is minimal', value: 'd', rating: 'backend-focused' }, ], }, { dimension: 'vendor_philosophy', header: 'Library & Vendor Choices', context: 'Think about the last time you needed a library or service for a project. How did you go about choosing it?', question: 'When choosing libraries or services, what is your typical approach?', options: [ { label: 'Use whatever Claude suggests -- speed matters more than the perfect choice', value: 'a', rating: 'pragmatic-fast' }, { label: 'Prefer well-known, battle-tested options (React, PostgreSQL, Express)', value: 'b', rating: 'conservative' }, { label: 'Research alternatives, read docs, compare benchmarks before committing', value: 'c', rating: 'thorough-evaluator' }, { label: 'Strong opinions -- I already know what I like and I stick with it', value: 'd', rating: 'opinionated' }, ], }, { dimension: 'frustration_triggers', header: 'Frustration Triggers', context: 'Think about moments when working with AI coding assistants that made you frustrated or annoyed.', question: 'What frustrates you most when working with AI coding assistants?', options: [ { label: 'Doing things I didn\'t ask for -- adding features, refactoring code, scope creep', value: 'a', rating: 'scope-creep' }, { label: 'Not following instructions precisely -- ignoring constraints or requirements I stated', value: 'b', rating: 'instruction-adherence' }, { label: 'Over-explaining or being too verbose -- just give me the code and move on', value: 'c', rating: 'verbosity' }, { label: 'Breaking working code while fixing something else -- regressions', value: 'd', rating: 'regression' }, ], }, { dimension: 'learning_style', header: 'Learning Preferences', context: 'Think about encountering something new -- an unfamiliar library, a codebase you inherited, a concept you hadn\'t used before.', question: 'When you encounter something new in your codebase, how do you prefer to learn about it?', options: [ { label: 'Read the code directly -- I figure things out by reading and experimenting', value: 'a', rating: 'self-directed' }, { label: 'Ask Claude to explain the relevant parts to me', value: 'b', rating: 'guided' }, { label: 'Read official docs and tutorials first, then try things', value: 'c', rating: 'documentation-first' }, { label: 'See a working example, then modify it to understand how it works', value: 'd', rating: 'example-driven' }, ], }, ]; const CLAUDE_INSTRUCTIONS = { communication_style: { 'terse-direct': 'Keep responses concise and action-oriented. Skip lengthy preambles. Match this developer\'s direct style.', 'conversational': 'Use a natural conversational tone. Explain reasoning briefly alongside code. Engage with the developer\'s questions.', 'detailed-structured': 'Match this developer\'s structured communication: use headers for sections, numbered lists for steps, and acknowledge provided context before responding.', 'mixed': 'Adapt response detail to match the complexity of each request. Brief for simple tasks, detailed for complex ones.', }, decision_speed: { 'fast-intuitive': 'Present a single strong recommendation with brief justification. Skip lengthy comparisons unless asked.', 'deliberate-informed': 'Present options in a structured comparison table with pros/cons. Let the developer make the final call.', 'research-first': 'Include links to docs, GitHub repos, or benchmarks when recommending tools. Support the developer\'s research process.', 'delegator': 'Make clear recommendations with confidence. Explain your reasoning briefly, but own the suggestion.', }, explanation_depth: { 'code-only': 'Prioritize code output. Add comments inline rather than prose explanations. Skip walkthroughs unless asked.', 'concise': 'Pair code with a brief explanation (1-2 sentences) of the approach. Keep prose minimal.', 'detailed': 'Explain the approach, key trade-offs, and code structure alongside the implementation. Use headers to organize.', 'educational': 'Teach the underlying concepts and principles, not just the implementation. Relate new patterns to fundamentals.', }, debugging_approach: { 'fix-first': 'Prioritize the fix. Show the corrected code first, then optionally explain what was wrong. Minimize diagnostic preamble.', 'diagnostic': 'Diagnose the root cause before presenting the fix. Explain what went wrong and why the fix addresses it.', 'hypothesis-driven': 'Engage with the developer\'s theories. Validate or refine their hypotheses before jumping to solutions.', 'collaborative': 'Walk through the debugging process step by step. Explain the investigation approach, not just the conclusion.', }, ux_philosophy: { 'function-first': 'Focus on functionality and correctness. Keep UI minimal and functional. Skip design polish unless requested.', 'pragmatic': 'Build clean, usable interfaces without over-engineering. Apply basic design principles (spacing, alignment, contrast).', 'design-conscious': 'Invest in UX quality: thoughtful spacing, smooth transitions, responsive layouts. Treat design as a first-class concern.', 'backend-focused': 'Optimize for developer experience (clear APIs, good error messages, helpful CLI output) over visual design.', }, vendor_philosophy: { 'pragmatic-fast': 'Suggest libraries quickly based on popularity and reliability. Don\'t over-analyze choices for non-critical dependencies.', 'conservative': 'Recommend well-established, widely-adopted tools with strong community support. Avoid bleeding-edge options.', 'thorough-evaluator': 'Compare alternatives with specific metrics (bundle size, GitHub stars, maintenance activity). Support informed decisions.', 'opinionated': 'Respect the developer\'s existing tool preferences. Ask before suggesting alternatives to their preferred stack.', }, frustration_triggers: { 'scope-creep': 'Do exactly what is asked -- nothing more. Never add unrequested features, refactoring, or "improvements". Ask before expanding scope.', 'instruction-adherence': 'Follow instructions precisely. Re-read constraints before responding. If requirements conflict, flag the conflict rather than silently choosing.', 'verbosity': 'Be concise. Lead with code, follow with brief explanation only if needed. Avoid restating the problem or unnecessary context.', 'regression': 'Before modifying working code, verify the change is safe. Run existing tests mentally. Flag potential regression risks explicitly.', }, learning_style: { 'self-directed': 'Point to relevant code sections and let the developer explore. Add signposts (file paths, function names) rather than full explanations.', 'guided': 'Explain concepts in context of the developer\'s codebase. Use their actual code as examples when teaching.', 'documentation-first': 'Link to official documentation and relevant sections. Structure explanations like reference material.', 'example-driven': 'Lead with working code examples. Show a minimal example first, then explain how to extend or modify it.', }, }; const CLAUDE_MD_FALLBACKS = { project: 'Project not yet initialized. Run /gsd:new-project to set up.', stack: 'Technology stack not yet documented. Will populate after codebase mapping or first phase.', conventions: 'Conventions not yet established. Will populate as patterns emerge during development.', architecture: 'Architecture not yet mapped. Follow existing patterns found in the codebase.', }; const CLAUDE_MD_PROFILE_PLACEHOLDER = [ '', '## Developer Profile', '', '> Profile not yet configured. Run `/gsd:profile-user` to generate your developer profile.', '> This section is managed by `generate-claude-profile` -- do not edit manually.', '', ].join('\n'); // ─── Helper Functions ───────────────────────────────────────────────────────── function isAmbiguousAnswer(dimension, value) { if (dimension === 'communication_style' && value === 'd') return true; const question = PROFILING_QUESTIONS.find(q => q.dimension === dimension); if (!question) return false; const option = question.options.find(o => o.value === value); if (!option) return false; return option.rating === 'mixed'; } function generateClaudeInstruction(dimension, rating) { const dimInstructions = CLAUDE_INSTRUCTIONS[dimension]; if (dimInstructions && dimInstructions[rating]) { return dimInstructions[rating]; } return `Adapt to this developer's ${dimension.replace(/_/g, ' ')} preference: ${rating}.`; } function extractSectionContent(fileContent, sectionName) { const startMarker = ``; const startIdx = fileContent.indexOf(startMarker); const endIdx = fileContent.indexOf(endMarker); if (startIdx === -1 || endIdx === -1) return null; const startTagEnd = fileContent.indexOf('-->', startIdx); if (startTagEnd === -1) return null; return fileContent.substring(startTagEnd + 3, endIdx); } function buildSection(sectionName, sourceFile, content) { return [ ``, content, ``, ].join('\n'); } function updateSection(fileContent, sectionName, newContent) { const startMarker = ``; const startIdx = fileContent.indexOf(startMarker); const endIdx = fileContent.indexOf(endMarker); if (startIdx !== -1 && endIdx !== -1) { const before = fileContent.substring(0, startIdx); const after = fileContent.substring(endIdx + endMarker.length); return { content: before + newContent + after, action: 'replaced' }; } return { content: fileContent.trimEnd() + '\n\n' + newContent + '\n', action: 'appended' }; } function detectManualEdit(fileContent, sectionName, expectedContent) { const currentContent = extractSectionContent(fileContent, sectionName); if (currentContent === null) return false; const normalize = (s) => s.trim().replace(/\n{3,}/g, '\n\n'); return normalize(currentContent) !== normalize(expectedContent); } function extractMarkdownSection(content, sectionName) { if (!content) return null; const lines = content.split('\n'); let capturing = false; const result = []; const headingPattern = new RegExp(`^## ${sectionName}\\s*$`); for (const line of lines) { if (headingPattern.test(line)) { capturing = true; result.push(line); continue; } if (capturing && /^## /.test(line)) break; if (capturing) result.push(line); } return result.length > 0 ? result.join('\n').trim() : null; } // ─── CLAUDE.md Section Generators ───────────────────────────────────────────── function generateProjectSection(cwd) { const projectPath = path.join(cwd, '.planning', 'PROJECT.md'); const content = safeReadFile(projectPath); if (!content) { return { content: CLAUDE_MD_FALLBACKS.project, source: 'PROJECT.md', hasFallback: true }; } const parts = []; const h1Match = content.match(/^# (.+)$/m); if (h1Match) parts.push(`**${h1Match[1]}**`); const whatThisIs = extractMarkdownSection(content, 'What This Is'); if (whatThisIs) { const body = whatThisIs.replace(/^## What This Is\s*/i, '').trim(); if (body) parts.push(body); } const coreValue = extractMarkdownSection(content, 'Core Value'); if (coreValue) { const body = coreValue.replace(/^## Core Value\s*/i, '').trim(); if (body) parts.push(`**Core Value:** ${body}`); } const constraints = extractMarkdownSection(content, 'Constraints'); if (constraints) { const body = constraints.replace(/^## Constraints\s*/i, '').trim(); if (body) parts.push(`### Constraints\n\n${body}`); } if (parts.length === 0) { return { content: CLAUDE_MD_FALLBACKS.project, source: 'PROJECT.md', hasFallback: true }; } return { content: parts.join('\n\n'), source: 'PROJECT.md', hasFallback: false }; } function generateStackSection(cwd) { const codebasePath = path.join(cwd, '.planning', 'codebase', 'STACK.md'); const researchPath = path.join(cwd, '.planning', 'research', 'STACK.md'); let content = safeReadFile(codebasePath); let source = 'codebase/STACK.md'; if (!content) { content = safeReadFile(researchPath); source = 'research/STACK.md'; } if (!content) { return { content: CLAUDE_MD_FALLBACKS.stack, source: 'STACK.md', hasFallback: true }; } const lines = content.split('\n'); const summaryLines = []; let inTable = false; for (const line of lines) { if (line.startsWith('#')) { if (!line.startsWith('# ') || summaryLines.length > 0) summaryLines.push(line); continue; } if (line.startsWith('|')) { inTable = true; summaryLines.push(line); continue; } if (inTable && line.trim() === '') inTable = false; if (line.startsWith('- ') || line.startsWith('* ')) summaryLines.push(line); } const summary = summaryLines.length > 0 ? summaryLines.join('\n') : content.trim(); return { content: summary, source, hasFallback: false }; } function generateConventionsSection(cwd) { const conventionsPath = path.join(cwd, '.planning', 'codebase', 'CONVENTIONS.md'); const content = safeReadFile(conventionsPath); if (!content) { return { content: CLAUDE_MD_FALLBACKS.conventions, source: 'CONVENTIONS.md', hasFallback: true }; } const lines = content.split('\n'); const summaryLines = []; for (const line of lines) { if (line.startsWith('#')) { if (!line.startsWith('# ')) summaryLines.push(line); continue; } if (line.startsWith('- ') || line.startsWith('* ') || line.startsWith('|')) summaryLines.push(line); } const summary = summaryLines.length > 0 ? summaryLines.join('\n') : content.trim(); return { content: summary, source: 'CONVENTIONS.md', hasFallback: false }; } function generateArchitectureSection(cwd) { const architecturePath = path.join(cwd, '.planning', 'codebase', 'ARCHITECTURE.md'); const content = safeReadFile(architecturePath); if (!content) { return { content: CLAUDE_MD_FALLBACKS.architecture, source: 'ARCHITECTURE.md', hasFallback: true }; } const lines = content.split('\n'); const summaryLines = []; for (const line of lines) { if (line.startsWith('#')) { if (!line.startsWith('# ')) summaryLines.push(line); continue; } if (line.startsWith('- ') || line.startsWith('* ') || line.startsWith('|') || line.startsWith('```')) summaryLines.push(line); } const summary = summaryLines.length > 0 ? summaryLines.join('\n') : content.trim(); return { content: summary, source: 'ARCHITECTURE.md', hasFallback: false }; } // ─── Commands ───────────────────────────────────────────────────────────────── function cmdWriteProfile(cwd, options, raw) { if (!options.input) { error('--input is required'); } let analysisPath = options.input; if (!path.isAbsolute(analysisPath)) analysisPath = path.join(cwd, analysisPath); if (!fs.existsSync(analysisPath)) error(`Analysis file not found: ${analysisPath}`); let analysis; try { analysis = JSON.parse(fs.readFileSync(analysisPath, 'utf-8')); } catch (err) { error(`Failed to parse analysis JSON: ${err.message}`); } if (!analysis.dimensions || typeof analysis.dimensions !== 'object') { error('Analysis JSON must contain a "dimensions" object'); } if (!analysis.profile_version) { error('Analysis JSON must contain "profile_version"'); } const SENSITIVE_PATTERNS = [ /sk-[a-zA-Z0-9]{20,}/g, /Bearer\s+[a-zA-Z0-9._-]+/gi, /password\s*[:=]\s*\S+/gi, /secret\s*[:=]\s*\S+/gi, /token\s*[:=]\s*\S+/gi, /api[_-]?key\s*[:=]\s*\S+/gi, /\/Users\/[a-zA-Z0-9._-]+\//g, /\/home\/[a-zA-Z0-9._-]+\//g, /ghp_[a-zA-Z0-9]{36}/g, /gho_[a-zA-Z0-9]{36}/g, /xoxb-[a-zA-Z0-9-]+/g, ]; let redactedCount = 0; function redactSensitive(text) { if (typeof text !== 'string') return text; let result = text; for (const pattern of SENSITIVE_PATTERNS) { pattern.lastIndex = 0; const matches = result.match(pattern); if (matches) { redactedCount += matches.length; result = result.replace(pattern, '[REDACTED]'); } } return result; } for (const dimKey of Object.keys(analysis.dimensions)) { const dim = analysis.dimensions[dimKey]; if (dim.evidence && Array.isArray(dim.evidence)) { for (let i = 0; i < dim.evidence.length; i++) { const ev = dim.evidence[i]; if (ev.quote) ev.quote = redactSensitive(ev.quote); if (ev.example) ev.example = redactSensitive(ev.example); if (ev.signal) ev.signal = redactSensitive(ev.signal); } } } if (redactedCount > 0) { process.stderr.write(`Sensitive content redacted: ${redactedCount} pattern(s) removed from evidence quotes\n`); } const templatePath = path.join(__dirname, '..', '..', 'templates', 'user-profile.md'); if (!fs.existsSync(templatePath)) error(`Template not found: ${templatePath}`); let template = fs.readFileSync(templatePath, 'utf-8'); const dimensionLabels = { communication_style: 'Communication', decision_speed: 'Decisions', explanation_depth: 'Explanations', debugging_approach: 'Debugging', ux_philosophy: 'UX Philosophy', vendor_philosophy: 'Vendor Philosophy', frustration_triggers: 'Frustration Triggers', learning_style: 'Learning Style', }; const summaryLines = []; let highCount = 0, mediumCount = 0, lowCount = 0, dimensionsScored = 0; for (const dimKey of DIMENSION_KEYS) { const dim = analysis.dimensions[dimKey]; if (!dim) continue; const conf = (dim.confidence || '').toUpperCase(); if (conf === 'HIGH' || conf === 'MEDIUM' || conf === 'LOW') dimensionsScored++; if (conf === 'HIGH') { highCount++; if (dim.claude_instruction) summaryLines.push(`- **${dimensionLabels[dimKey] || dimKey}:** ${dim.claude_instruction} (HIGH)`); } else if (conf === 'MEDIUM') { mediumCount++; if (dim.claude_instruction) summaryLines.push(`- **${dimensionLabels[dimKey] || dimKey}:** ${dim.claude_instruction} (MEDIUM)`); } else if (conf === 'LOW') { lowCount++; } } const summaryInstructions = summaryLines.length > 0 ? summaryLines.join('\n') : '- No high or medium confidence dimensions scored yet.'; template = template.replace(/\{\{generated_at\}\}/g, new Date().toISOString()); template = template.replace(/\{\{data_source\}\}/g, analysis.data_source || 'session_analysis'); template = template.replace(/\{\{projects_list\}\}/g, (analysis.projects_list || analysis.projects_analyzed || []).join(', ')); template = template.replace(/\{\{message_count\}\}/g, String(analysis.message_count || analysis.messages_analyzed || 0)); template = template.replace(/\{\{summary_instructions\}\}/g, summaryInstructions); template = template.replace(/\{\{profile_version\}\}/g, analysis.profile_version); template = template.replace(/\{\{projects_count\}\}/g, String((analysis.projects_list || analysis.projects_analyzed || []).length)); template = template.replace(/\{\{dimensions_scored\}\}/g, String(dimensionsScored)); template = template.replace(/\{\{high_confidence_count\}\}/g, String(highCount)); template = template.replace(/\{\{medium_confidence_count\}\}/g, String(mediumCount)); template = template.replace(/\{\{low_confidence_count\}\}/g, String(lowCount)); template = template.replace(/\{\{sensitive_excluded_summary\}\}/g, redactedCount > 0 ? `${redactedCount} pattern(s) redacted` : 'None detected'); for (const dimKey of DIMENSION_KEYS) { const dim = analysis.dimensions[dimKey] || {}; const rating = dim.rating || 'UNSCORED'; const confidence = dim.confidence || 'UNSCORED'; const instruction = dim.claude_instruction || 'No strong preference detected. Ask the developer when this dimension is relevant.'; const summary = dim.summary || ''; let evidenceBlock = ''; const evidenceArr = dim.evidence_quotes || dim.evidence; if (evidenceArr && Array.isArray(evidenceArr) && evidenceArr.length > 0) { const evidenceLines = evidenceArr.map(ev => { const signal = ev.signal || ev.pattern || ''; const quote = ev.quote || ev.example || ''; const project = ev.project || 'unknown'; return `- **Signal:** ${signal} / **Example:** "${quote}" -- project: ${project}`; }); evidenceBlock = evidenceLines.join('\n'); } else { evidenceBlock = '- No evidence collected for this dimension.'; } template = template.replace(new RegExp(`\\{\\{${dimKey}\\.rating\\}\\}`, 'g'), rating); template = template.replace(new RegExp(`\\{\\{${dimKey}\\.confidence\\}\\}`, 'g'), confidence); template = template.replace(new RegExp(`\\{\\{${dimKey}\\.claude_instruction\\}\\}`, 'g'), instruction); template = template.replace(new RegExp(`\\{\\{${dimKey}\\.summary\\}\\}`, 'g'), summary); template = template.replace(new RegExp(`\\{\\{${dimKey}\\.evidence\\}\\}`, 'g'), evidenceBlock); } let outputPath = options.output; if (!outputPath) { outputPath = path.join(os.homedir(), '.claude', 'get-shit-done', 'USER-PROFILE.md'); } else if (!path.isAbsolute(outputPath)) { outputPath = path.join(cwd, outputPath); } fs.mkdirSync(path.dirname(outputPath), { recursive: true }); fs.writeFileSync(outputPath, template, 'utf-8'); const result = { profile_path: outputPath, dimensions_scored: dimensionsScored, high_confidence: highCount, medium_confidence: mediumCount, low_confidence: lowCount, sensitive_redacted: redactedCount, source: analysis.data_source || 'session_analysis', }; output(result, raw); } function cmdProfileQuestionnaire(options, raw) { if (!options.answers) { const questionsOutput = { mode: 'interactive', questions: PROFILING_QUESTIONS.map(q => ({ dimension: q.dimension, header: q.header, context: q.context, question: q.question, options: q.options.map(o => ({ label: o.label, value: o.value })), })), }; output(questionsOutput, raw); return; } const answerValues = options.answers.split(',').map(a => a.trim()); if (answerValues.length !== PROFILING_QUESTIONS.length) { error(`Expected ${PROFILING_QUESTIONS.length} answers (comma-separated), got ${answerValues.length}`); } const analysis = { profile_version: '1.0', analyzed_at: new Date().toISOString(), data_source: 'questionnaire', projects_analyzed: [], messages_analyzed: 0, message_threshold: 'questionnaire', sensitive_excluded: [], dimensions: {}, }; for (let i = 0; i < PROFILING_QUESTIONS.length; i++) { const question = PROFILING_QUESTIONS[i]; const answerValue = answerValues[i]; const selectedOption = question.options.find(o => o.value === answerValue); if (!selectedOption) { error(`Invalid answer "${answerValue}" for ${question.dimension}. Valid values: ${question.options.map(o => o.value).join(', ')}`); } const ambiguous = isAmbiguousAnswer(question.dimension, answerValue); analysis.dimensions[question.dimension] = { rating: selectedOption.rating, confidence: ambiguous ? 'LOW' : 'MEDIUM', evidence_count: 1, cross_project_consistent: null, evidence: [{ signal: 'Self-reported via questionnaire', quote: selectedOption.label, project: 'N/A (questionnaire)', }], summary: `Developer self-reported as ${selectedOption.rating} for ${question.header.toLowerCase()}.`, claude_instruction: generateClaudeInstruction(question.dimension, selectedOption.rating), }; } output(analysis, raw); } function cmdGenerateDevPreferences(cwd, options, raw) { if (!options.analysis) error('--analysis is required'); let analysisPath = options.analysis; if (!path.isAbsolute(analysisPath)) analysisPath = path.join(cwd, analysisPath); if (!fs.existsSync(analysisPath)) error(`Analysis file not found: ${analysisPath}`); let analysis; try { analysis = JSON.parse(fs.readFileSync(analysisPath, 'utf-8')); } catch (err) { error(`Failed to parse analysis JSON: ${err.message}`); } if (!analysis.dimensions || typeof analysis.dimensions !== 'object') { error('Analysis JSON must contain a "dimensions" object'); } const devPrefLabels = { communication_style: 'Communication', decision_speed: 'Decision Support', explanation_depth: 'Explanations', debugging_approach: 'Debugging', ux_philosophy: 'UX Approach', vendor_philosophy: 'Library & Tool Choices', frustration_triggers: 'Boundaries', learning_style: 'Learning Support', }; const templatePath = path.join(__dirname, '..', '..', 'templates', 'dev-preferences.md'); if (!fs.existsSync(templatePath)) error(`Template not found: ${templatePath}`); let template = fs.readFileSync(templatePath, 'utf-8'); const directiveLines = []; const dimensionsIncluded = []; for (const dimKey of DIMENSION_KEYS) { const dim = analysis.dimensions[dimKey]; if (!dim) continue; const label = devPrefLabels[dimKey] || dimKey; const confidence = dim.confidence || 'UNSCORED'; let instruction = dim.claude_instruction; if (!instruction) { const lookup = CLAUDE_INSTRUCTIONS[dimKey]; if (lookup && dim.rating && lookup[dim.rating]) { instruction = lookup[dim.rating]; } else { instruction = `Adapt to this developer's ${dimKey.replace(/_/g, ' ')} preference.`; } } directiveLines.push(`### ${label}\n${instruction} (${confidence} confidence)\n`); dimensionsIncluded.push(dimKey); } const directivesBlock = directiveLines.join('\n').trim(); template = template.replace(/\{\{behavioral_directives\}\}/g, directivesBlock); template = template.replace(/\{\{generated_at\}\}/g, new Date().toISOString()); template = template.replace(/\{\{data_source\}\}/g, analysis.data_source || 'session_analysis'); let stackBlock; if (analysis.data_source === 'questionnaire') { stackBlock = 'Stack preferences not available (questionnaire-only profile). Run `/gsd:profile-user --refresh` with session data to populate.'; } else if (options.stack) { stackBlock = options.stack; } else { stackBlock = 'Stack preferences will be populated from session analysis.'; } template = template.replace(/\{\{stack_preferences\}\}/g, stackBlock); let outputPath = options.output; if (!outputPath) { outputPath = path.join(os.homedir(), '.claude', 'commands', 'gsd', 'dev-preferences.md'); } else if (!path.isAbsolute(outputPath)) { outputPath = path.join(cwd, outputPath); } fs.mkdirSync(path.dirname(outputPath), { recursive: true }); fs.writeFileSync(outputPath, template, 'utf-8'); const result = { command_path: outputPath, command_name: '/gsd:dev-preferences', dimensions_included: dimensionsIncluded, source: analysis.data_source || 'session_analysis', }; output(result, raw); } function cmdGenerateClaudeProfile(cwd, options, raw) { if (!options.analysis) error('--analysis is required'); let analysisPath = options.analysis; if (!path.isAbsolute(analysisPath)) analysisPath = path.join(cwd, analysisPath); if (!fs.existsSync(analysisPath)) error(`Analysis file not found: ${analysisPath}`); let analysis; try { analysis = JSON.parse(fs.readFileSync(analysisPath, 'utf-8')); } catch (err) { error(`Failed to parse analysis JSON: ${err.message}`); } if (!analysis.dimensions || typeof analysis.dimensions !== 'object') { error('Analysis JSON must contain a "dimensions" object'); } const profileLabels = { communication_style: 'Communication', decision_speed: 'Decisions', explanation_depth: 'Explanations', debugging_approach: 'Debugging', ux_philosophy: 'UX Philosophy', vendor_philosophy: 'Vendor Choices', frustration_triggers: 'Frustrations', learning_style: 'Learning', }; const dataSource = analysis.data_source || 'session_analysis'; const tableRows = []; const directiveLines = []; const dimensionsIncluded = []; for (const dimKey of DIMENSION_KEYS) { const dim = analysis.dimensions[dimKey]; if (!dim) continue; const label = profileLabels[dimKey] || dimKey; const rating = dim.rating || 'UNSCORED'; const confidence = dim.confidence || 'UNSCORED'; tableRows.push(`| ${label} | ${rating} | ${confidence} |`); let instruction = dim.claude_instruction; if (!instruction) { const lookup = CLAUDE_INSTRUCTIONS[dimKey]; if (lookup && dim.rating && lookup[dim.rating]) { instruction = lookup[dim.rating]; } else { instruction = `Adapt to this developer's ${dimKey.replace(/_/g, ' ')} preference.`; } } directiveLines.push(`- **${label}:** ${instruction}`); dimensionsIncluded.push(dimKey); } const sectionLines = [ '', '## Developer Profile', '', `> Generated by GSD from ${dataSource}. Run \`/gsd:profile-user --refresh\` to update.`, '', '| Dimension | Rating | Confidence |', '|-----------|--------|------------|', ...tableRows, '', '**Directives:**', ...directiveLines, '', ]; const sectionContent = sectionLines.join('\n'); let targetPath; if (options.global) { targetPath = path.join(os.homedir(), '.claude', 'CLAUDE.md'); } else if (options.output) { targetPath = path.isAbsolute(options.output) ? options.output : path.join(cwd, options.output); } else { targetPath = path.join(cwd, 'CLAUDE.md'); } let action; if (fs.existsSync(targetPath)) { let existingContent = fs.readFileSync(targetPath, 'utf-8'); const startMarker = ''; const endMarker = ''; const startIdx = existingContent.indexOf(startMarker); const endIdx = existingContent.indexOf(endMarker); if (startIdx !== -1 && endIdx !== -1) { const before = existingContent.substring(0, startIdx); const after = existingContent.substring(endIdx + endMarker.length); existingContent = before + sectionContent + after; action = 'updated'; } else { existingContent = existingContent.trimEnd() + '\n\n' + sectionContent + '\n'; action = 'appended'; } fs.writeFileSync(targetPath, existingContent, 'utf-8'); } else { fs.mkdirSync(path.dirname(targetPath), { recursive: true }); fs.writeFileSync(targetPath, sectionContent + '\n', 'utf-8'); action = 'created'; } const result = { claude_md_path: targetPath, action, dimensions_included: dimensionsIncluded, is_global: !!options.global, }; output(result, raw); } function cmdGenerateClaudeMd(cwd, options, raw) { const MANAGED_SECTIONS = ['project', 'stack', 'conventions', 'architecture']; const generators = { project: generateProjectSection, stack: generateStackSection, conventions: generateConventionsSection, architecture: generateArchitectureSection, }; const sectionHeadings = { project: '## Project', stack: '## Technology Stack', conventions: '## Conventions', architecture: '## Architecture', }; const generated = {}; const sectionsGenerated = []; const sectionsFallback = []; const sectionsSkipped = []; for (const name of MANAGED_SECTIONS) { const gen = generators[name](cwd); generated[name] = gen; if (gen.hasFallback) { sectionsFallback.push(name); } else { sectionsGenerated.push(name); } } let outputPath = options.output; if (!outputPath) { outputPath = path.join(cwd, 'CLAUDE.md'); } else if (!path.isAbsolute(outputPath)) { outputPath = path.join(cwd, outputPath); } let existingContent = safeReadFile(outputPath); let action; if (existingContent === null) { const sections = []; for (const name of MANAGED_SECTIONS) { const gen = generated[name]; const heading = sectionHeadings[name]; const body = `${heading}\n\n${gen.content}`; sections.push(buildSection(name, gen.source, body)); } sections.push(''); sections.push(CLAUDE_MD_PROFILE_PLACEHOLDER); existingContent = sections.join('\n\n') + '\n'; action = 'created'; fs.mkdirSync(path.dirname(outputPath), { recursive: true }); fs.writeFileSync(outputPath, existingContent, 'utf-8'); } else { action = 'updated'; let fileContent = existingContent; for (const name of MANAGED_SECTIONS) { const gen = generated[name]; const heading = sectionHeadings[name]; const body = `${heading}\n\n${gen.content}`; const fullSection = buildSection(name, gen.source, body); const hasMarkers = fileContent.indexOf(`