client-handover 1.0.5 → 1.1.0

package/generator.js

@@ -1,5 +1,9 @@
 import Anthropic from '@anthropic-ai/sdk'
-import { marked } from 'marked'
+import {
+  Document, Packer, Paragraph, TextRun, HeadingLevel,
+  AlignmentType, BorderStyle, TableRow, TableCell, Table,
+  WidthType, ShadingType
+} from 'docx'
 import fs from 'fs'
 import path from 'path'
 import os from 'os'
@@ -7,15 +11,12 @@ import os from 'os'
 function resolveApiKey() {
   if (process.env.ANTHROPIC_API_KEY) return process.env.ANTHROPIC_API_KEY
 
-  // Check saved key from `handover key <your-key>`
   const configPath = path.join(os.homedir(), '.handover', 'config.json')
   if (fs.existsSync(configPath)) {
     try {
       const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
       if (config?.apiKey) return config.apiKey
-    } catch {
-      // ignore malformed config file
-    }
+    } catch {}
   }
 
   const credentialsPath = path.join(os.homedir(), '.claude', '.credentials.json')
@@ -24,42 +25,293 @@ function resolveApiKey() {
       const creds = JSON.parse(fs.readFileSync(credentialsPath, 'utf-8'))
       const token = creds?.claudeAiOauth?.accessToken
       const expiresAt = creds?.claudeAiOauth?.expiresAt
-      if (token && (!expiresAt || expiresAt > Date.now())) {
-        return token
-      }
-    } catch {
-      // ignore malformed credentials file
-    }
+      if (token && (!expiresAt || expiresAt > Date.now())) return token
+    } catch {}
   }
 
   return null
 }
 
+export function loadDeveloperInfo() {
+  const configPath = path.join(os.homedir(), '.handover', 'config.json')
+  try {
+    if (fs.existsSync(configPath)) {
+      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+      return {
+        name: config.developerName || '',
+        company: config.developerCompany || '',
+        email: config.developerEmail || '',
+        phone: config.developerPhone || '',
+      }
+    }
+  } catch {}
+  return { name: '', company: '', email: '', phone: '' }
+}
+
 export function saveApiKey(key) {
   const configDir = path.join(os.homedir(), '.handover')
   const configPath = path.join(configDir, 'config.json')
   if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
-  fs.writeFileSync(configPath, JSON.stringify({ apiKey: key }, null, 2), 'utf-8')
+  let config = {}
+  try { config = JSON.parse(fs.readFileSync(configPath, 'utf-8')) } catch {}
+  config.apiKey = key
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
 }
 
 const apiKey = resolveApiKey()
 if (!apiKey) {
-  console.error('\n❌ No API key found. Set ANTHROPIC_API_KEY or install Claude Code (code.visualstudio.com/download).\n')
+  console.error('\n❌ No API key found. Run "handover key <your-api-key>" or install Claude Code.\n')
   process.exit(1)
 }
 
 const client = new Anthropic({ apiKey })
 
-/**
- * Generate a handover document using the Claude API
- * @param {string} prompt - The command prompt to send
- * @param {string} outputName - Base filename (without extension)
- * @param {string} outputDir - Directory to save files
- */
+// ---------------------------------------------------------------------------
+// Inline text parser — splits a line into TextRun segments handling **bold**,
+// *italic*, `code`, and [link text](url) → just the text
+// ---------------------------------------------------------------------------
+function parseInline(text) {
+  const runs = []
+  // Strip markdown links to plain text
+  text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+
+  const pattern = /(\*\*(.+?)\*\*|\*(.+?)\*|`(.+?)`)/g
+  let lastIndex = 0
+  let match
+
+  while ((match = pattern.exec(text)) !== null) {
+    if (match.index > lastIndex) {
+      runs.push(new TextRun({ text: text.slice(lastIndex, match.index) }))
+    }
+    if (match[2] !== undefined) {
+      runs.push(new TextRun({ text: match[2], bold: true }))
+    } else if (match[3] !== undefined) {
+      runs.push(new TextRun({ text: match[3], italics: true }))
+    } else if (match[4] !== undefined) {
+      runs.push(new TextRun({
+        text: match[4],
+        font: 'Courier New',
+        size: 18,
+        shading: { type: ShadingType.CLEAR, fill: 'F4F4F4' },
+      }))
+    }
+    lastIndex = match.index + match[0].length
+  }
+
+  if (lastIndex < text.length) {
+    runs.push(new TextRun({ text: text.slice(lastIndex) }))
+  }
+
+  return runs.length ? runs : [new TextRun({ text })]
+}
+
+// ---------------------------------------------------------------------------
+// Convert markdown string to an array of docx Paragraph/Table objects
+// ---------------------------------------------------------------------------
+function markdownToDocxChildren(markdown) {
+  const children = []
+  const lines = markdown.split('\n')
+  let i = 0
+
+  while (i < lines.length) {
+    const line = lines[i]
+
+    // Fenced code block
+    if (line.trim().startsWith('```')) {
+      const codeLines = []
+      i++
+      while (i < lines.length && !lines[i].trim().startsWith('```')) {
+        codeLines.push(lines[i])
+        i++
+      }
+      for (const codeLine of codeLines) {
+        children.push(new Paragraph({
+          children: [new TextRun({ text: codeLine || ' ', font: 'Courier New', size: 18 })],
+          shading: { type: ShadingType.CLEAR, fill: 'F4F4F4' },
+          spacing: { before: 0, after: 0 },
+          indent: { left: 360 },
+        }))
+      }
+      // Add small gap after code block
+      children.push(new Paragraph({ text: '' }))
+      i++
+      continue
+    }
+
+    // Horizontal rule
+    if (/^---+$/.test(line.trim())) {
+      children.push(new Paragraph({
+        text: '',
+        border: { bottom: { style: BorderStyle.SINGLE, size: 6, color: 'CCCCCC' } },
+        spacing: { before: 200, after: 200 },
+      }))
+      i++
+      continue
+    }
+
+    // Headings
+    const h1 = line.match(/^# (.+)/)
+    const h2 = line.match(/^## (.+)/)
+    const h3 = line.match(/^### (.+)/)
+    const h4 = line.match(/^#{4,6} (.+)/)
+
+    if (h1) {
+      children.push(new Paragraph({
+        children: parseInline(h1[1]),
+        heading: HeadingLevel.HEADING_1,
+        spacing: { before: 400, after: 160 },
+      }))
+      i++; continue
+    }
+    if (h2) {
+      children.push(new Paragraph({
+        children: parseInline(h2[1]),
+        heading: HeadingLevel.HEADING_2,
+        spacing: { before: 320, after: 120 },
+      }))
+      i++; continue
+    }
+    if (h3) {
+      children.push(new Paragraph({
+        children: parseInline(h3[1]),
+        heading: HeadingLevel.HEADING_3,
+        spacing: { before: 240, after: 80 },
+      }))
+      i++; continue
+    }
+    if (h4) {
+      children.push(new Paragraph({
+        children: [new TextRun({ text: h4[1], bold: true })],
+        spacing: { before: 160, after: 80 },
+      }))
+      i++; continue
+    }
+
+    // Checkbox list items  - [ ] or - [x]
+    const checkbox = line.match(/^(\s*)- \[(x| )\] (.+)/i)
+    if (checkbox) {
+      const checked = checkbox[2].toLowerCase() === 'x'
+      children.push(new Paragraph({
+        children: [
+          new TextRun({ text: checked ? '☑ ' : '☐ ' }),
+          ...parseInline(checkbox[3]),
+        ],
+        indent: { left: 360 },
+        spacing: { before: 40, after: 40 },
+      }))
+      i++; continue
+    }
+
+    // Bullet list items  - or *
+    const bullet = line.match(/^(\s*)[-*+] (.+)/)
+    if (bullet) {
+      const indent = bullet[1].length > 0 ? 720 : 360
+      children.push(new Paragraph({
+        children: [new TextRun({ text: '• ' }), ...parseInline(bullet[2])],
+        indent: { left: indent },
+        spacing: { before: 40, after: 40 },
+      }))
+      i++; continue
+    }
+
+    // Numbered list items
+    const numbered = line.match(/^\d+\. (.+)/)
+    if (numbered) {
+      children.push(new Paragraph({
+        children: parseInline(numbered[1]),
+        numbering: { reference: 'default-numbering', level: 0 },
+        indent: { left: 360 },
+        spacing: { before: 40, after: 40 },
+      }))
+      i++; continue
+    }
+
+    // Bold-only line (often used as a label/key line like **Key:** value)
+    // Handled by parseInline already — fall through to normal paragraph
+
+    // Empty line
+    if (line.trim() === '') {
+      children.push(new Paragraph({ text: '', spacing: { before: 0, after: 80 } }))
+      i++; continue
+    }
+
+    // Normal paragraph
+    children.push(new Paragraph({
+      children: parseInline(line),
+      spacing: { before: 0, after: 80 },
+    }))
+    i++
+  }
+
+  return children
+}
+
+// ---------------------------------------------------------------------------
+// Build a docx Document from markdown
+// ---------------------------------------------------------------------------
+function buildDocx(markdown) {
+  const children = markdownToDocxChildren(markdown)
+
+  return new Document({
+    numbering: {
+      config: [{
+        reference: 'default-numbering',
+        levels: [{
+          level: 0,
+          format: 'decimal',
+          text: '%1.',
+          alignment: AlignmentType.LEFT,
+          style: { paragraph: { indent: { left: 360, hanging: 260 } } },
+        }],
+      }],
+    },
+    styles: {
+      default: {
+        document: {
+          run: { font: 'Calibri', size: 22 },
+          paragraph: { spacing: { line: 276 } },
+        },
+      },
+      paragraphStyles: [
+        {
+          id: 'Heading1',
+          name: 'Heading 1',
+          basedOn: 'Normal',
+          next: 'Normal',
+          run: { bold: true, size: 36, color: '1a1a1a' },
+          paragraph: { spacing: { before: 400, after: 160 } },
+        },
+        {
+          id: 'Heading2',
+          name: 'Heading 2',
+          basedOn: 'Normal',
+          next: 'Normal',
+          run: { bold: true, size: 28, color: '2c2c2c' },
+          paragraph: {
+            spacing: { before: 320, after: 120 },
+            border: { bottom: { style: BorderStyle.SINGLE, size: 4, color: 'E0E0E0' } },
+          },
+        },
+        {
+          id: 'Heading3',
+          name: 'Heading 3',
+          basedOn: 'Normal',
+          next: 'Normal',
+          run: { bold: true, size: 24, color: '444444' },
+          paragraph: { spacing: { before: 240, after: 80 } },
+        },
+      ],
+    },
+    sections: [{ properties: {}, children }],
+  })
+}
+
+// ---------------------------------------------------------------------------
+// Main export
+// ---------------------------------------------------------------------------
 export async function generateDoc(prompt, outputName = 'handover', outputDir = './output') {
   console.log('⏳ Generating document with Claude...\n')
 
-  // Call Claude API
   const message = await client.messages.create({
     model: 'claude-sonnet-4-20250514',
     max_tokens: 4096,
@@ -68,105 +320,38 @@ export async function generateDoc(prompt, outputName = 'handover', outputDir = '
 
   const markdown = message.content[0].text
 
-  // Ensure output directory exists
   if (!fs.existsSync(outputDir)) {
     fs.mkdirSync(outputDir, { recursive: true })
   }
 
   const basePath = path.join(outputDir, outputName)
 
-  // --- 1. Save as Markdown ---
+  // Save as Markdown
   const mdPath = `${basePath}.md`
   fs.writeFileSync(mdPath, markdown, 'utf-8')
-  console.log(`✅ Markdown saved:  ${mdPath}`)
+  console.log(`✅ Markdown saved:   ${mdPath}`)
 
-  // --- 2. Save as Plain Text ---
+  // Save as plain text
   const plainText = markdown
-    .replace(/#{1,6}\s+/g, '')         // Remove headings
-    .replace(/\*\*(.*?)\*\*/g, '$1')   // Remove bold
-    .replace(/\*(.*?)\*/g, '$1')       // Remove italic
-    .replace(/`{1,3}[^`]*`{1,3}/g, (m) => m.replace(/`/g, '')) // Remove code ticks
-    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1') // Remove links, keep text
-    .replace(/[-*+] /g, '• ')          // Convert bullets
-    .replace(/\n{3,}/g, '\n\n')        // Clean extra blank lines
+    .replace(/#{1,6}\s+/g, '')
+    .replace(/\*\*(.*?)\*\*/g, '$1')
+    .replace(/\*(.*?)\*/g, '$1')
+    .replace(/`{1,3}[^`]*`{1,3}/g, m => m.replace(/`/g, ''))
+    .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+    .replace(/[-*+] /g, '• ')
+    .replace(/\n{3,}/g, '\n\n')
     .trim()
 
   const txtPath = `${basePath}.txt`
   fs.writeFileSync(txtPath, plainText, 'utf-8')
   console.log(`✅ Plain text saved: ${txtPath}`)
 
-  // --- 3. Save as HTML ---
-  const htmlBody = marked(markdown)
-  const html = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Handover Document</title>
-  <style>
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      max-width: 860px;
-      margin: 0 auto;
-      padding: 2rem;
-      color: #1a1a1a;
-      line-height: 1.7;
-    }
-    h1 { border-bottom: 2px solid #e0e0e0; padding-bottom: 0.5rem; }
-    h2 { margin-top: 2.5rem; color: #2c2c2c; }
-    h3 { color: #444; }
-    code {
-      background: #f4f4f4;
-      padding: 0.2em 0.4em;
-      border-radius: 4px;
-      font-size: 0.9em;
-    }
-    pre {
-      background: #f4f4f4;
-      padding: 1rem;
-      border-radius: 6px;
-      overflow-x: auto;
-    }
-    pre code { background: none; padding: 0; }
-    table {
-      width: 100%;
-      border-collapse: collapse;
-      margin: 1rem 0;
-    }
-    th, td {
-      border: 1px solid #ddd;
-      padding: 0.6rem 0.8rem;
-      text-align: left;
-    }
-    th { background: #f0f0f0; font-weight: 600; }
-    blockquote {
-      border-left: 4px solid #ccc;
-      margin: 0;
-      padding-left: 1rem;
-      color: #555;
-    }
-    .badge {
-      display: inline-block;
-      background: #e8f4fd;
-      color: #0969da;
-      padding: 0.2em 0.6em;
-      border-radius: 4px;
-      font-size: 0.8em;
-      font-weight: 600;
-    }
-    input[type="checkbox"] { margin-right: 0.4rem; }
-  </style>
-</head>
-<body>
-${htmlBody}
-</body>
-</html>`
-
-  const htmlPath = `${basePath}.html`
-  fs.writeFileSync(htmlPath, html, 'utf-8')
-  console.log(`✅ HTML saved:       ${htmlPath}`)
-
-  console.log('\n🎉 All formats generated successfully!\n')
+  // Save as Word document
+  const doc = buildDocx(markdown)
+  const docxBuffer = await Packer.toBuffer(doc)
+  const docxPath = `${basePath}.docx`
+  fs.writeFileSync(docxPath, docxBuffer)
+  console.log(`✅ Word doc saved:   ${docxPath}`)
 
-  return { markdown, plainText, html }
+  return { markdown, plainText }
 }

package/license.js

@@ -2,8 +2,9 @@ export function license(projectInfo = '') {
   return `
 You are a technical documentation writer creating a LICENSING & ATTRIBUTION section for a frontend website handover document.
 
-Using the following project information:
-${projectInfo || '[No project info provided — use placeholder examples]'}
+The following context has been automatically scanned from the developer's actual project files. Use the real dependencies, license file, and detected libraries to generate licensing documentation specific to THIS project — do not use generic placeholder libraries.
+
+${projectInfo || '[No project data available — use placeholder examples]'}
 
 Generate a LICENSING & ATTRIBUTION section that includes:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "client-handover",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "AI-powered handover document generator for frontend developers handing off client websites",
   "type": "module",
   "main": "index.js",
@@ -11,11 +11,8 @@
     "cli.js",
     "index.js",
     "generator.js",
-    "handover.js",
-    "setup.js",
-    "deploy.js",
-    "credentials.js",
-    "license.js",
+    "prompts.js",
+    "scanner.js",
     "postinstall.js",
     "README.md"
   ],
@@ -40,7 +37,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.39.0",
     "chalk": "^5.3.0",
-    "client-handover": "^1.0.2",
-    "marked": "^12.0.0"
+    "client-handover": "^1.0.6",
+    "docx": "^8.5.0"
   }
 }

package/postinstall.js

@@ -9,56 +9,87 @@ const configDir = path.join(os.homedir(), '.handover')
 const configPath = path.join(configDir, 'config.json')
 const claudeCredsPath = path.join(os.homedir(), '.claude', '.credentials.json')
 
-function alreadyConfigured() {
-  if (process.env.ANTHROPIC_API_KEY) return true
+function loadConfig() {
+  try {
+    if (fs.existsSync(configPath)) {
+      return JSON.parse(fs.readFileSync(configPath, 'utf-8'))
+    }
+  } catch {}
+  return {}
+}
 
-  if (fs.existsSync(configPath)) {
-    try {
-      const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'))
-      if (config?.apiKey) return true
-    } catch {}
-  }
+function saveConfig(config) {
+  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8')
+}
 
-  if (fs.existsSync(claudeCredsPath)) {
-    try {
+function hasApiKey(config) {
+  if (process.env.ANTHROPIC_API_KEY) return true
+  if (config?.apiKey) return true
+  try {
+    if (fs.existsSync(claudeCredsPath)) {
       const creds = JSON.parse(fs.readFileSync(claudeCredsPath, 'utf-8'))
       const token = creds?.claudeAiOauth?.accessToken
       const expiresAt = creds?.claudeAiOauth?.expiresAt
       if (token && (!expiresAt || expiresAt > Date.now())) return true
-    } catch {}
-  }
-
+    }
+  } catch {}
   return false
 }
 
-function saveKey(key) {
-  if (!fs.existsSync(configDir)) fs.mkdirSync(configDir, { recursive: true })
-  fs.writeFileSync(configPath, JSON.stringify({ apiKey: key }, null, 2), 'utf-8')
-}
+if (!process.stdin.isTTY) process.exit(0)
 
-// Skip if already set up or not in an interactive terminal
-if (alreadyConfigured() || !process.stdin.isTTY) {
-  process.exit(0)
-}
+const config = loadConfig()
+const needsApiKey = !hasApiKey(config)
+const needsDeveloperInfo = !config.developerName
+
+if (!needsApiKey && !needsDeveloperInfo) process.exit(0)
 
 const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
 
+function ask(question) {
+  return new Promise(resolve => rl.question(question, answer => resolve(answer.trim())))
+}
+
 console.log('\n──────────────────────────────────────────')
 console.log(' client-handover setup')
 console.log('──────────────────────────────────────────')
-console.log(' To generate documents, you need an Anthropic API key.')
-console.log(' Get one free at: https://console.anthropic.com\n')
+console.log(' This tool generates professional handover documents for client websites.\n')
 
-rl.question(' Enter your Anthropic API key (or press Enter to skip): ', (answer) => {
-  rl.close()
-  const key = answer.trim()
+async function run() {
+  if (needsApiKey) {
+    console.log(' To generate documents you need an Anthropic API key.')
+    console.log(' Get one free at: https://console.anthropic.com\n')
+    const key = await ask(' Enter your Anthropic API key (or press Enter to skip): ')
+    if (key) {
+      config.apiKey = key
+      console.log(' ✓ API key saved.\n')
+    } else {
+      console.log(' Skipped. Run "handover key <your-api-key>" at any time.\n')
+    }
+  }
+
+  if (needsDeveloperInfo) {
+    console.log(' Developer details will appear in all generated handover documents.\n')
+    const name = await ask(' Your full name (developer): ')
+    if (name) config.developerName = name
 
-  if (!key) {
-    console.log('\n Skipped. Run "handover key <your-api-key>" at any time to set it.\n')
-    process.exit(0)
+    const company = await ask(' Your company name (or press Enter if not applicable): ')
+    if (company) config.developerCompany = company
+
+    const email = await ask(' Your email address: ')
+    if (email) config.developerEmail = email
+
+    const phone = await ask(' Your phone number (optional, press Enter to skip): ')
+    if (phone) config.developerPhone = phone
+
+    console.log()
   }
 
-  saveKey(key)
-  console.log('\n✅ API key saved. Run "handover handover" to get started.\n')
+  rl.close()
+  saveConfig(config)
+  console.log(' ✅ Setup complete. Run "handover /create" in any project folder to generate handover documents.\n')
   process.exit(0)
-})
+}
+
+run()