@weavelogic/knowledge-graph-agent 0.8.6 → 0.8.8

package/dist/cli/commands/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAkM3C"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAoM3C"}

package/dist/cli/commands/docs.js

@@ -7,7 +7,7 @@ import { validateProjectRoot, validateDocsPath } from "../../core/security.js";
 function createDocsCommand() {
   const command = new Command("docs");
   command.description("Documentation management commands");
-  command.command("init").description("Initialize documentation directory with weave-nn structure").option("-p, --path <path>", "Project root path", ".").option("-d, --docs <path>", "Docs directory path", "docs").option("-t, --template <template>", "Template to use (default, minimal)").option("--no-examples", "Skip example files").option("--no-detect", "Skip framework detection").option("-f, --force", "Overwrite existing files").option("-g, --generate", "Generate documents using expert agents").option("--parallel", "Run agent generation in parallel").option("--dry-run", "Show what would be generated without creating files").option("-v, --verbose", "Show detailed agent output").action(async (options) => {
+  command.command("init").description("Initialize documentation directory with weave-nn structure").option("-p, --path <path>", "Project root path", ".").option("-d, --docs <path>", "Docs directory path", "docs").option("-t, --template <template>", "Template to use (default, minimal)").option("--no-examples", "Skip example files").option("--no-detect", "Skip framework detection").option("-f, --force", "Overwrite existing files").option("-g, --generate", "Generate documents using expert agents").option("--parallel", "Run agent generation in parallel").option("--dry-run", "Show what would be generated without creating files").option("-v, --verbose", "Show detailed agent output").option("--force-generate", "Force regenerate documents even if they exist").action(async (options) => {
     const spinner = ora("Initializing documentation...").start();
     try {
       const projectRoot = validateProjectRoot(options.path);
@@ -68,7 +68,8 @@ function createDocsCommand() {
           const genResult = await generateDocsWithAgents(projectRoot, result.docsPath, {
             parallel: options.parallel,
             dryRun: options.dryRun,
-            verbose: options.verbose
+            verbose: options.verbose,
+            force: options.forceGenerate
           });
           if (options.dryRun) {
             genSpinner.info("Dry run complete - no files created");

package/dist/cli/commands/docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"docs.js","sources":["../../../src/cli/commands/docs.ts"],"sourcesContent":["/**\n * Docs Command\n *\n * Initialize and manage documentation directory.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { initDocs, docsExist, getDocsPath } from '../../generators/docs-init.js';\nimport { generateDocsWithAgents } from '../../generators/doc-generator-agents.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create docs command\n */\nexport function createDocsCommand(): Command {\n  const command = new Command('docs');\n\n  command\n    .description('Documentation management commands');\n\n  // Init subcommand\n  command\n    .command('init')\n    .description('Initialize documentation directory with weave-nn structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-d, --docs <path>', 'Docs directory path', 'docs')\n    .option('-t, --template <template>', 'Template to use (default, minimal)')\n    .option('--no-examples', 'Skip example files')\n    .option('--no-detect', 'Skip framework detection')\n    .option('-f, --force', 'Overwrite existing files')\n    .option('-g, --generate', 'Generate documents using expert agents')\n    .option('--parallel', 'Run agent generation in parallel')\n    .option('--dry-run', 'Show what would be generated without creating files')\n    .option('-v, --verbose', 'Show detailed agent output')\n    .action(async (options) => {\n      const spinner = ora('Initializing documentation...').start();\n\n      try {\n        // Validate paths to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const docsPath = options.docs;\n        validateDocsPath(projectRoot, docsPath); // Ensure docs stays within project\n\n        // Note: initDocs is additive - it only creates missing files/directories\n        // The --force flag is for overwriting existing files if needed in the future\n        const isExisting = docsExist(projectRoot, docsPath);\n        if (isExisting) {\n          spinner.text = 'Adding missing files to existing documentation...';\n        }\n\n        const result = await initDocs({\n          projectRoot,\n          docsPath,\n          includeExamples: options.examples !== false,\n          detectFramework: options.detect !== false,\n        });\n\n        if (result.success) {\n          if (isExisting && result.filesCreated.length === 0) {\n            spinner.succeed('Documentation already complete - no new files needed');\n          } else if (isExisting) {\n            spinner.succeed(`Documentation updated - added ${result.filesCreated.length} missing files`);\n          } else {\n            spinner.succeed('Documentation initialized!');\n          }\n        } else {\n          spinner.warn('Documentation initialized with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Created:'));\n        console.log(chalk.gray(`    Path: ${result.docsPath}`));\n        console.log(chalk.green(`    Files: ${result.filesCreated.length}`));\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Errors:'));\n          result.errors.forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n        }\n\n        console.log();\n        console.log(chalk.cyan('Structure created:'));\n        console.log(chalk.gray(`\n    ${docsPath}/\n    ├── README.md           # Documentation home\n    ├── PRIMITIVES.md       # Technology primitives\n    ├── MOC.md              # Map of Content\n    ├── concepts/           # Abstract concepts\n    ├── components/         # Reusable components\n    ├── services/           # Backend services\n    ├── features/           # Product features\n    ├── integrations/       # External integrations\n    ├── standards/          # Coding standards\n    ├── guides/             # How-to guides\n    └── references/         # API references\n        `));\n\n        // Run agent generation if requested\n        if (options.generate) {\n          console.log();\n          const genSpinner = ora('Analyzing project and generating documents with expert agents...').start();\n\n          try {\n            const genResult = await generateDocsWithAgents(projectRoot, result.docsPath, {\n              parallel: options.parallel,\n              dryRun: options.dryRun,\n              verbose: options.verbose,\n            });\n\n            if (options.dryRun) {\n              genSpinner.info('Dry run complete - no files created');\n            } else if (genResult.success) {\n              genSpinner.succeed(`Generated ${genResult.documentsGenerated.filter(d => d.generated).length} documents using ${genResult.agentsSpawned} agents`);\n            } else {\n              genSpinner.warn(`Generated ${genResult.documentsGenerated.filter(d => d.generated).length} documents with ${genResult.errors.length} errors`);\n            }\n\n            if (genResult.documentsGenerated.length > 0 && !options.dryRun) {\n              console.log();\n              console.log(chalk.white('  Generated Documents:'));\n              for (const doc of genResult.documentsGenerated) {\n                const icon = doc.generated ? chalk.green('✓') : chalk.red('✗');\n                console.log(`    ${icon} ${doc.path}${doc.error ? chalk.gray(` (${doc.error})`) : ''}`);\n              }\n            }\n\n            if (genResult.errors.length > 0 && !options.dryRun) {\n              console.log();\n              console.log(chalk.yellow('  Agent Errors:'));\n              genResult.errors.forEach(err => {\n                console.log(chalk.gray(`    - ${err}`));\n              });\n            }\n          } catch (genError) {\n            genSpinner.fail('Agent generation failed');\n            console.error(chalk.red(String(genError)));\n          }\n        }\n\n        console.log();\n        console.log(chalk.cyan('Next: ') + chalk.white('kg graph') + chalk.gray(' to generate knowledge graph'));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to initialize documentation');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Status subcommand\n  command\n    .command('status')\n    .description('Show documentation status')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (options) => {\n      // Validate path to prevent traversal\n      const projectRoot = validateProjectRoot(options.path);\n      const docsPath = getDocsPath(projectRoot);\n\n      if (!docsPath) {\n        console.log(chalk.yellow('  No documentation directory found'));\n        console.log(chalk.gray('  Run ') + chalk.cyan('kg docs init') + chalk.gray(' to create one'));\n        return;\n      }\n\n      console.log(chalk.white('\\n  Documentation Status\\n'));\n      console.log(chalk.gray('  Path:'), chalk.white(docsPath));\n      console.log();\n\n      // Count files\n      const fg = await import('fast-glob');\n      const files = await fg.default('**/*.md', {\n        cwd: docsPath,\n        ignore: ['node_modules/**', '.git/**'],\n      });\n\n      console.log(chalk.gray('  Markdown files:'), chalk.white(files.length));\n\n      // Check for key files\n      const keyFiles = ['README.md', 'PRIMITIVES.md', 'MOC.md'];\n      const fs = await import('fs');\n      const path = await import('path');\n\n      console.log();\n      console.log(chalk.white('  Key Files:'));\n      keyFiles.forEach(file => {\n        const exists = fs.existsSync(path.join(docsPath, file));\n        const icon = exists ? chalk.green('✓') : chalk.red('✗');\n        console.log(`    ${icon} ${file}`);\n      });\n\n      // Check directories\n      const dirs = ['concepts', 'components', 'services', 'features', 'guides'];\n      console.log();\n      console.log(chalk.white('  Directories:'));\n      dirs.forEach(dir => {\n        const exists = fs.existsSync(path.join(docsPath, dir));\n        const icon = exists ? chalk.green('✓') : chalk.gray('○');\n        console.log(`    ${icon} ${dir}/`);\n      });\n\n      console.log();\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs.js","sources":["../../../src/cli/commands/docs.ts"],"sourcesContent":["/**\n * Docs Command\n *\n * Initialize and manage documentation directory.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { initDocs, docsExist, getDocsPath } from '../../generators/docs-init.js';\nimport { generateDocsWithAgents } from '../../generators/doc-generator-agents.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create docs command\n */\nexport function createDocsCommand(): Command {\n  const command = new Command('docs');\n\n  command\n    .description('Documentation management commands');\n\n  // Init subcommand\n  command\n    .command('init')\n    .description('Initialize documentation directory with weave-nn structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-d, --docs <path>', 'Docs directory path', 'docs')\n    .option('-t, --template <template>', 'Template to use (default, minimal)')\n    .option('--no-examples', 'Skip example files')\n    .option('--no-detect', 'Skip framework detection')\n    .option('-f, --force', 'Overwrite existing files')\n    .option('-g, --generate', 'Generate documents using expert agents')\n    .option('--parallel', 'Run agent generation in parallel')\n    .option('--dry-run', 'Show what would be generated without creating files')\n    .option('-v, --verbose', 'Show detailed agent output')\n    .option('--force-generate', 'Force regenerate documents even if they exist')\n    .action(async (options) => {\n      const spinner = ora('Initializing documentation...').start();\n\n      try {\n        // Validate paths to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const docsPath = options.docs;\n        validateDocsPath(projectRoot, docsPath); // Ensure docs stays within project\n\n        // Note: initDocs is additive - it only creates missing files/directories\n        // The --force flag is for overwriting existing files if needed in the future\n        const isExisting = docsExist(projectRoot, docsPath);\n        if (isExisting) {\n          spinner.text = 'Adding missing files to existing documentation...';\n        }\n\n        const result = await initDocs({\n          projectRoot,\n          docsPath,\n          includeExamples: options.examples !== false,\n          detectFramework: options.detect !== false,\n        });\n\n        if (result.success) {\n          if (isExisting && result.filesCreated.length === 0) {\n            spinner.succeed('Documentation already complete - no new files needed');\n          } else if (isExisting) {\n            spinner.succeed(`Documentation updated - added ${result.filesCreated.length} missing files`);\n          } else {\n            spinner.succeed('Documentation initialized!');\n          }\n        } else {\n          spinner.warn('Documentation initialized with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Created:'));\n        console.log(chalk.gray(`    Path: ${result.docsPath}`));\n        console.log(chalk.green(`    Files: ${result.filesCreated.length}`));\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Errors:'));\n          result.errors.forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n        }\n\n        console.log();\n        console.log(chalk.cyan('Structure created:'));\n        console.log(chalk.gray(`\n    ${docsPath}/\n    ├── README.md           # Documentation home\n    ├── PRIMITIVES.md       # Technology primitives\n    ├── MOC.md              # Map of Content\n    ├── concepts/           # Abstract concepts\n    ├── components/         # Reusable components\n    ├── services/           # Backend services\n    ├── features/           # Product features\n    ├── integrations/       # External integrations\n    ├── standards/          # Coding standards\n    ├── guides/             # How-to guides\n    └── references/         # API references\n        `));\n\n        // Run agent generation if requested\n        if (options.generate) {\n          console.log();\n          const genSpinner = ora('Analyzing project and generating documents with expert agents...').start();\n\n          try {\n            const genResult = await generateDocsWithAgents(projectRoot, result.docsPath, {\n              parallel: options.parallel,\n              dryRun: options.dryRun,\n              verbose: options.verbose,\n              force: options.forceGenerate,\n            });\n\n            if (options.dryRun) {\n              genSpinner.info('Dry run complete - no files created');\n            } else if (genResult.success) {\n              genSpinner.succeed(`Generated ${genResult.documentsGenerated.filter(d => d.generated).length} documents using ${genResult.agentsSpawned} agents`);\n            } else {\n              genSpinner.warn(`Generated ${genResult.documentsGenerated.filter(d => d.generated).length} documents with ${genResult.errors.length} errors`);\n            }\n\n            if (genResult.documentsGenerated.length > 0 && !options.dryRun) {\n              console.log();\n              console.log(chalk.white('  Generated Documents:'));\n              for (const doc of genResult.documentsGenerated) {\n                const icon = doc.generated ? chalk.green('✓') : chalk.red('✗');\n                console.log(`    ${icon} ${doc.path}${doc.error ? chalk.gray(` (${doc.error})`) : ''}`);\n              }\n            }\n\n            if (genResult.errors.length > 0 && !options.dryRun) {\n              console.log();\n              console.log(chalk.yellow('  Agent Errors:'));\n              genResult.errors.forEach(err => {\n                console.log(chalk.gray(`    - ${err}`));\n              });\n            }\n          } catch (genError) {\n            genSpinner.fail('Agent generation failed');\n            console.error(chalk.red(String(genError)));\n          }\n        }\n\n        console.log();\n        console.log(chalk.cyan('Next: ') + chalk.white('kg graph') + chalk.gray(' to generate knowledge graph'));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to initialize documentation');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Status subcommand\n  command\n    .command('status')\n    .description('Show documentation status')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (options) => {\n      // Validate path to prevent traversal\n      const projectRoot = validateProjectRoot(options.path);\n      const docsPath = getDocsPath(projectRoot);\n\n      if (!docsPath) {\n        console.log(chalk.yellow('  No documentation directory found'));\n        console.log(chalk.gray('  Run ') + chalk.cyan('kg docs init') + chalk.gray(' to create one'));\n        return;\n      }\n\n      console.log(chalk.white('\\n  Documentation Status\\n'));\n      console.log(chalk.gray('  Path:'), chalk.white(docsPath));\n      console.log();\n\n      // Count files\n      const fg = await import('fast-glob');\n      const files = await fg.default('**/*.md', {\n        cwd: docsPath,\n        ignore: ['node_modules/**', '.git/**'],\n      });\n\n      console.log(chalk.gray('  Markdown files:'), chalk.white(files.length));\n\n      // Check for key files\n      const keyFiles = ['README.md', 'PRIMITIVES.md', 'MOC.md'];\n      const fs = await import('fs');\n      const path = await import('path');\n\n      console.log();\n      console.log(chalk.white('  Key Files:'));\n      keyFiles.forEach(file => {\n        const exists = fs.existsSync(path.join(docsPath, file));\n        const icon = exists ? chalk.green('✓') : chalk.red('✗');\n        console.log(`    ${icon} ${file}`);\n      });\n\n      // Check directories\n      const dirs = ['concepts', 'components', 'services', 'features', 'guides'];\n      console.log();\n      console.log(chalk.white('  Directories:'));\n      dirs.forEach(dir => {\n        const exists = fs.existsSync(path.join(docsPath, dir));\n        const icon = exists ? chalk.green('✓') : chalk.gray('○');\n        console.log(`    ${icon} ${dir}/`);\n      });\n\n      console.log();\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}

package/dist/generators/doc-generator-agents.d.ts

@@ -4,6 +4,15 @@
  * Spawns expert agents from claude-flow to analyze existing code and
  * documentation, then generates appropriate documents for each directory.
  */
+/**
+ * Service documentation found in src/{service}/docs directories
+ */
+interface ServiceDoc {
+    serviceName: string;
+    sourcePath: string;
+    fileName: string;
+    relativePath: string;
+}
 /**
  * Document generation context
  */
@@ -15,6 +24,7 @@ export interface GenerationContext {
     frameworks: string[];
     existingDocs: string[];
     sourceFiles: string[];
+    serviceDocs: ServiceDoc[];
 }
 /**
  * Generation result for a single document
@@ -42,5 +52,7 @@ export declare function generateDocsWithAgents(projectRoot: string, docsPath: st
     parallel?: boolean;
     dryRun?: boolean;
     verbose?: boolean;
+    force?: boolean;
 }): Promise<AgentGenerationResult>;
+export {};
 //# sourceMappingURL=doc-generator-agents.d.ts.map

package/dist/generators/doc-generator-agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doc-generator-agents.d.ts","sourceRoot":"","sources":["../../src/generators/doc-generator-agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GACL,OAAO,CAAC,qBAAqB,CAAC,CA0EhC"}
+{"version":3,"file":"doc-generator-agents.d.ts","sourceRoot":"","sources":["../../src/generators/doc-generator-agents.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAaD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACZ,GACL,OAAO,CAAC,qBAAqB,CAAC,CAuFhC"}

package/dist/generators/doc-generator-agents.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { basename, join } from "path";
+import { existsSync, readFileSync, readdirSync, mkdirSync, copyFileSync, writeFileSync } from "fs";
+import { basename, join, dirname } from "path";
 import fg from "fast-glob";
 import { spawn } from "child_process";
 async function generateDocsWithAgents(projectRoot, docsPath, options = {}) {
@@ -11,14 +11,22 @@ async function generateDocsWithAgents(projectRoot, docsPath, options = {}) {
   };
   try {
     const context = await buildGenerationContext(projectRoot, docsPath);
-    const tasks = await planDocumentGeneration(context);
+    const tasks = await planDocumentGeneration(context, options.force);
     if (options.dryRun) {
       console.log("\n[Dry Run] Would generate the following documents:");
       for (const task of tasks) {
         console.log(`  - ${task.outputFile} (${task.agentType} agent)`);
       }
+      if (context.serviceDocs.length > 0) {
+        console.log("\n[Dry Run] Would copy service docs:");
+        for (const doc of context.serviceDocs) {
+          const targetPath = `services/${doc.serviceName}/${doc.relativePath}`;
+          console.log(`  - ${doc.sourcePath} → ${targetPath}`);
+        }
+      }
       return result;
     }
+    const copiedDocs = copyServiceDocs(context, options.force);
     if (options.parallel) {
       const results = await Promise.allSettled(
         tasks.map((task) => executeAgentTask(task, context, options.verbose))
@@ -57,6 +65,7 @@ async function generateDocsWithAgents(projectRoot, docsPath, options = {}) {
         }
       }
     }
+    result.documentsGenerated.push(...copiedDocs);
     result.success = result.errors.length === 0;
   } catch (error) {
     result.success = false;
@@ -64,6 +73,40 @@ async function generateDocsWithAgents(projectRoot, docsPath, options = {}) {
   }
   return result;
 }
+function copyServiceDocs(context, force) {
+  const { docsPath, serviceDocs } = context;
+  const copied = [];
+  for (const doc of serviceDocs) {
+    const targetDir = join(docsPath, "services", doc.serviceName);
+    const targetPath = join(targetDir, doc.relativePath);
+    const relativeTarget = `services/${doc.serviceName}/${doc.relativePath}`;
+    if (!force && existsSync(targetPath)) {
+      continue;
+    }
+    try {
+      const targetFileDir = dirname(targetPath);
+      if (!existsSync(targetFileDir)) {
+        mkdirSync(targetFileDir, { recursive: true });
+      }
+      copyFileSync(doc.sourcePath, targetPath);
+      copied.push({
+        path: relativeTarget,
+        title: doc.fileName.replace(".md", ""),
+        type: "service",
+        generated: true
+      });
+    } catch (error) {
+      copied.push({
+        path: relativeTarget,
+        title: doc.fileName.replace(".md", ""),
+        type: "service",
+        generated: false,
+        error: String(error)
+      });
+    }
+  }
+  return copied;
+}
 async function buildGenerationContext(projectRoot, docsPath) {
   const context = {
     projectRoot,
@@ -72,7 +115,8 @@ async function buildGenerationContext(projectRoot, docsPath) {
     languages: [],
     frameworks: [],
     existingDocs: [],
-    sourceFiles: []
+    sourceFiles: [],
+    serviceDocs: []
   };
   const pkgPath = join(projectRoot, "package.json");
   if (existsSync(pkgPath)) {
@@ -95,8 +139,32 @@ async function buildGenerationContext(projectRoot, docsPath) {
   if (existsSync(join(projectRoot, "package.json"))) {
     context.languages.push("JavaScript");
   }
-  if (existsSync(join(projectRoot, "requirements.txt")) || existsSync(join(projectRoot, "pyproject.toml"))) {
+  const pythonConfigPaths = [
+    join(projectRoot, "requirements.txt"),
+    join(projectRoot, "pyproject.toml"),
+    join(projectRoot, "src/backend/requirements.txt"),
+    join(projectRoot, "backend/requirements.txt"),
+    join(projectRoot, "src/requirements.txt")
+  ];
+  const foundPythonConfig = pythonConfigPaths.find((p) => existsSync(p));
+  if (foundPythonConfig) {
     context.languages.push("Python");
+    try {
+      let reqContent = readFileSync(foundPythonConfig, "utf-8").toLowerCase();
+      if (foundPythonConfig.includes("requirements.txt")) {
+        const pyprojectPath = join(projectRoot, "pyproject.toml");
+        if (existsSync(pyprojectPath)) {
+          reqContent += readFileSync(pyprojectPath, "utf-8").toLowerCase();
+        }
+      }
+      if (reqContent.includes("fastapi")) context.frameworks.push("FastAPI");
+      if (reqContent.includes("flask")) context.frameworks.push("Flask");
+      if (reqContent.includes("django")) context.frameworks.push("Django");
+      if (reqContent.includes("sqlalchemy")) context.frameworks.push("SQLAlchemy");
+      if (reqContent.includes("pydantic")) context.frameworks.push("Pydantic");
+      if (reqContent.includes("alembic")) context.frameworks.push("Alembic");
+    } catch {
+    }
   }
   if (existsSync(join(projectRoot, "Cargo.toml"))) {
     context.languages.push("Rust");
@@ -115,30 +183,77 @@ async function buildGenerationContext(projectRoot, docsPath) {
     dot: true
   });
   context.sourceFiles = sourceFiles;
+  if (!context.languages.includes("Python") && sourceFiles.some((f) => f.endsWith(".py"))) {
+    context.languages.push("Python");
+  }
+  const serviceDocs = [];
+  const srcDir = join(projectRoot, "src");
+  if (existsSync(srcDir)) {
+    try {
+      const srcEntries = readdirSync(srcDir, { withFileTypes: true });
+      for (const entry of srcEntries) {
+        if (entry.isDirectory()) {
+          const serviceDocsDir = join(srcDir, entry.name, "docs");
+          if (existsSync(serviceDocsDir)) {
+            const docsFiles = await fg("**/*.md", {
+              cwd: serviceDocsDir,
+              ignore: ["node_modules/**", ".git/**"]
+            });
+            for (const docFile of docsFiles) {
+              serviceDocs.push({
+                serviceName: entry.name,
+                sourcePath: join(serviceDocsDir, docFile),
+                fileName: basename(docFile),
+                relativePath: docFile
+              });
+            }
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  context.serviceDocs = serviceDocs;
   return context;
 }
-async function planDocumentGeneration(context) {
+async function planDocumentGeneration(context, force) {
   const tasks = [];
   const { projectRoot, docsPath, sourceFiles, frameworks } = context;
   const docExists = (relativePath) => {
+    if (force) return false;
     return existsSync(join(docsPath, relativePath));
   };
   const srcDirs = /* @__PURE__ */ new Set();
   const componentFiles = [];
   const serviceFiles = [];
   const utilityFiles = [];
+  const backendFiles = [];
+  const modelFiles = [];
   for (const file of sourceFiles) {
     const dir = file.split("/")[0];
     srcDirs.add(dir);
-    if (file.includes("component") || file.includes("ui/")) {
+    const fileLower = file.toLowerCase();
+    if (fileLower.includes("component") || fileLower.includes("/ui/") || fileLower.includes("/views/")) {
       componentFiles.push(file);
-    } else if (file.includes("service") || file.includes("api/")) {
+    }
+    if (fileLower.includes("service") || fileLower.includes("/api/") || fileLower.includes("routes") || fileLower.includes("endpoints")) {
       serviceFiles.push(file);
-    } else if (file.includes("util") || file.includes("helper") || file.includes("lib/")) {
+    }
+    if (fileLower.includes("util") || fileLower.includes("helper") || fileLower.includes("/lib/") || fileLower.includes("common")) {
       utilityFiles.push(file);
     }
+    if (fileLower.includes("backend") || fileLower.includes("server") || fileLower.includes("app/")) {
+      backendFiles.push(file);
+    }
+    if (fileLower.includes("model") || fileLower.includes("schema") || fileLower.includes("entities")) {
+      modelFiles.push(file);
+    }
+    if (fileLower.includes("frontend") || fileLower.includes("client") || fileLower.includes("pages")) ;
   }
-  if (srcDirs.size > 2 && !docExists("concepts/architecture/overview.md")) {
+  if (serviceFiles.length === 0 && backendFiles.length > 0) {
+    serviceFiles.push(...backendFiles);
+  }
+  if (srcDirs.size >= 1 && sourceFiles.length >= 3 && !docExists("concepts/architecture/overview.md")) {
     tasks.push({
       directory: "concepts/architecture",
       type: "concept",
@@ -205,6 +320,33 @@ async function planDocumentGeneration(context) {
       outputFile: "integrations/databases/prisma.md"
     });
   }
+  if (frameworks.includes("SQLAlchemy") && !docExists("integrations/databases/sqlalchemy.md")) {
+    tasks.push({
+      directory: "integrations/databases",
+      type: "integration",
+      agentType: "coder",
+      prompt: buildSQLAlchemyPrompt(context, modelFiles),
+      outputFile: "integrations/databases/sqlalchemy.md"
+    });
+  }
+  if (frameworks.includes("FastAPI") && !docExists("services/api/fastapi.md")) {
+    tasks.push({
+      directory: "services/api",
+      type: "service",
+      agentType: "coder",
+      prompt: buildFastAPIPrompt(context, serviceFiles),
+      outputFile: "services/api/fastapi.md"
+    });
+  }
+  if (frameworks.includes("Flask") && !docExists("services/api/flask.md")) {
+    tasks.push({
+      directory: "services/api",
+      type: "service",
+      agentType: "coder",
+      prompt: buildFlaskPrompt(context, serviceFiles),
+      outputFile: "services/api/flask.md"
+    });
+  }
   return tasks;
 }
 async function executeAgentTask(task, context, verbose) {
@@ -483,6 +625,111 @@ npx prisma migrate dev
 
 *Add Prisma client usage examples*
 
+---
+> Auto-generated by kg-agent
+`,
+    "integrations/databases/sqlalchemy.md": `---
+title: SQLAlchemy Integration
+type: integration
+status: active
+tags: [sqlalchemy, database, orm, python]
+created: ${date}
+---
+
+# SQLAlchemy Integration
+
+Database ORM configuration for ${projectName}.
+
+## Models
+
+*Document your SQLAlchemy models*
+
+## Database Connection
+
+\`\`\`python
+from sqlalchemy import create_engine
+from sqlalchemy.orm import sessionmaker
+
+engine = create_engine(DATABASE_URL)
+Session = sessionmaker(bind=engine)
+\`\`\`
+
+## Migrations (Alembic)
+
+\`\`\`bash
+alembic upgrade head
+\`\`\`
+
+## Query Examples
+
+*Add common query patterns*
+
+---
+> Auto-generated by kg-agent
+`,
+    "services/api/fastapi.md": `---
+title: FastAPI Service
+type: service
+status: active
+tags: [fastapi, api, python]
+created: ${date}
+---
+
+# FastAPI Service
+
+API service documentation for ${projectName}.
+
+## Running the Server
+
+\`\`\`bash
+uvicorn main:app --reload
+\`\`\`
+
+## API Endpoints
+
+*Document your API endpoints*
+
+## Authentication
+
+*Document authentication flow*
+
+## Request/Response Schemas
+
+*Document Pydantic models*
+
+---
+> Auto-generated by kg-agent
+`,
+    "services/api/flask.md": `---
+title: Flask Service
+type: service
+status: active
+tags: [flask, api, python]
+created: ${date}
+---
+
+# Flask Service
+
+API service documentation for ${projectName}.
+
+## Running the Server
+
+\`\`\`bash
+flask run
+\`\`\`
+
+## Routes
+
+*Document your Flask routes*
+
+## Blueprints
+
+*Document blueprints structure*
+
+## Error Handling
+
+*Document error handling patterns*
+
 ---
 > Auto-generated by kg-agent
 `
@@ -557,6 +804,21 @@ function buildPrismaPrompt(context) {
   return `Document Prisma database integration for ${context.projectName}.
 Generate integration documentation with schema, models, and usage patterns.`;
 }
+function buildSQLAlchemyPrompt(context, modelFiles) {
+  return `Document SQLAlchemy database integration for ${context.projectName}.
+Model files: ${modelFiles.slice(0, 10).join(", ")}.
+Generate integration documentation with models, relationships, and query patterns.`;
+}
+function buildFastAPIPrompt(context, serviceFiles) {
+  return `Document FastAPI API service for ${context.projectName}.
+API files: ${serviceFiles.slice(0, 10).join(", ")}.
+Generate API documentation with endpoints, request/response schemas, and authentication.`;
+}
+function buildFlaskPrompt(context, serviceFiles) {
+  return `Document Flask API service for ${context.projectName}.
+Route files: ${serviceFiles.slice(0, 10).join(", ")}.
+Generate API documentation with routes, blueprints, and request handling.`;
+}
 export {
   generateDocsWithAgents
 };

package/dist/generators/doc-generator-agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"doc-generator-agents.js","sources":["../../src/generators/doc-generator-agents.ts"],"sourcesContent":["/**\n * Agent-Driven Document Generator\n *\n * Spawns expert agents from claude-flow to analyze existing code and\n * documentation, then generates appropriate documents for each directory.\n */\n\nimport { existsSync, readFileSync, writeFileSync, readdirSync, statSync } from 'fs';\nimport { join, basename, extname, relative } from 'path';\nimport fg from 'fast-glob';\nimport { spawn } from 'child_process';\n\n/**\n * Document generation context\n */\nexport interface GenerationContext {\n  projectRoot: string;\n  docsPath: string;\n  projectName: string;\n  languages: string[];\n  frameworks: string[];\n  existingDocs: string[];\n  sourceFiles: string[];\n}\n\n/**\n * Generation result for a single document\n */\nexport interface GeneratedDoc {\n  path: string;\n  title: string;\n  type: string;\n  generated: boolean;\n  error?: string;\n}\n\n/**\n * Overall generation result\n */\nexport interface AgentGenerationResult {\n  success: boolean;\n  documentsGenerated: GeneratedDoc[];\n  agentsSpawned: number;\n  errors: string[];\n}\n\n/**\n * Agent task definition\n */\ninterface AgentTask {\n  directory: string;\n  type: 'concept' | 'component' | 'service' | 'feature' | 'integration' | 'standard' | 'guide' | 'reference';\n  agentType: 'researcher' | 'coder' | 'analyst';\n  prompt: string;\n  outputFile: string;\n}\n\n/**\n * Analyze project and generate documents using expert agents\n */\nexport async function generateDocsWithAgents(\n  projectRoot: string,\n  docsPath: string,\n  options: {\n    parallel?: boolean;\n    dryRun?: boolean;\n    verbose?: boolean;\n  } = {}\n): Promise<AgentGenerationResult> {\n  const result: AgentGenerationResult = {\n    success: true,\n    documentsGenerated: [],\n    agentsSpawned: 0,\n    errors: [],\n  };\n\n  try {\n    // Build context by analyzing the project\n    const context = await buildGenerationContext(projectRoot, docsPath);\n\n    // Determine what documents should be generated\n    const tasks = await planDocumentGeneration(context);\n\n    if (options.dryRun) {\n      console.log('\\n[Dry Run] Would generate the following documents:');\n      for (const task of tasks) {\n        console.log(`  - ${task.outputFile} (${task.agentType} agent)`);\n      }\n      return result;\n    }\n\n    // Execute tasks (parallel or sequential)\n    if (options.parallel) {\n      const results = await Promise.allSettled(\n        tasks.map(task => executeAgentTask(task, context, options.verbose))\n      );\n\n      for (let i = 0; i < results.length; i++) {\n        const r = results[i];\n        result.agentsSpawned++;\n\n        if (r.status === 'fulfilled') {\n          result.documentsGenerated.push(r.value);\n        } else {\n          result.errors.push(`Failed: ${tasks[i].outputFile} - ${r.reason}`);\n          result.documentsGenerated.push({\n            path: tasks[i].outputFile,\n            title: basename(tasks[i].outputFile, '.md'),\n            type: tasks[i].type,\n            generated: false,\n            error: String(r.reason),\n          });\n        }\n      }\n    } else {\n      // Sequential execution\n      for (const task of tasks) {\n        result.agentsSpawned++;\n\n        try {\n          const doc = await executeAgentTask(task, context, options.verbose);\n          result.documentsGenerated.push(doc);\n        } catch (error) {\n          result.errors.push(`Failed: ${task.outputFile} - ${error}`);\n          result.documentsGenerated.push({\n            path: task.outputFile,\n            title: basename(task.outputFile, '.md'),\n            type: task.type,\n            generated: false,\n            error: String(error),\n          });\n        }\n      }\n    }\n\n    result.success = result.errors.length === 0;\n  } catch (error) {\n    result.success = false;\n    result.errors.push(`Generation failed: ${error}`);\n  }\n\n  return result;\n}\n\n/**\n * Build context by analyzing the project\n */\nasync function buildGenerationContext(\n  projectRoot: string,\n  docsPath: string\n): Promise<GenerationContext> {\n  const context: GenerationContext = {\n    projectRoot,\n    docsPath,\n    projectName: basename(projectRoot),\n    languages: [],\n    frameworks: [],\n    existingDocs: [],\n    sourceFiles: [],\n  };\n\n  // Get project name from package.json\n  const pkgPath = join(projectRoot, 'package.json');\n  if (existsSync(pkgPath)) {\n    try {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      context.projectName = pkg.name?.replace(/^@[^/]+\\//, '') || context.projectName;\n\n      // Detect frameworks from dependencies\n      const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n      if (deps.react) context.frameworks.push('React');\n      if (deps.next) context.frameworks.push('Next.js');\n      if (deps.vue) context.frameworks.push('Vue');\n      if (deps.express) context.frameworks.push('Express');\n      if (deps.fastify) context.frameworks.push('Fastify');\n      if (deps['@prisma/client'] || deps.prisma) context.frameworks.push('Prisma');\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  // Detect languages\n  if (existsSync(join(projectRoot, 'tsconfig.json'))) {\n    context.languages.push('TypeScript');\n  }\n  if (existsSync(join(projectRoot, 'package.json'))) {\n    context.languages.push('JavaScript');\n  }\n  if (existsSync(join(projectRoot, 'requirements.txt')) || existsSync(join(projectRoot, 'pyproject.toml'))) {\n    context.languages.push('Python');\n  }\n  if (existsSync(join(projectRoot, 'Cargo.toml'))) {\n    context.languages.push('Rust');\n  }\n  if (existsSync(join(projectRoot, 'go.mod'))) {\n    context.languages.push('Go');\n  }\n\n  // Find existing docs\n  const existingDocs = await fg('**/*.md', {\n    cwd: docsPath,\n    ignore: ['node_modules/**', '.git/**', '_templates/**'],\n  });\n  context.existingDocs = existingDocs;\n\n  // Find source files\n  const sourceFiles = await fg('**/*.{ts,tsx,js,jsx,py,rs,go}', {\n    cwd: projectRoot,\n    ignore: ['node_modules/**', '.git/**', 'dist/**', 'build/**', docsPath + '/**'],\n    dot: true,\n  });\n  context.sourceFiles = sourceFiles;\n\n  return context;\n}\n\n/**\n * Plan what documents should be generated based on context\n */\nasync function planDocumentGeneration(context: GenerationContext): Promise<AgentTask[]> {\n  const tasks: AgentTask[] = [];\n  const { projectRoot, docsPath, sourceFiles, frameworks } = context;\n\n  // Helper to check if doc already exists\n  const docExists = (relativePath: string) => {\n    return existsSync(join(docsPath, relativePath));\n  };\n\n  // Analyze source structure to determine what docs to generate\n  const srcDirs = new Set<string>();\n  const componentFiles: string[] = [];\n  const serviceFiles: string[] = [];\n  const utilityFiles: string[] = [];\n\n  for (const file of sourceFiles) {\n    const dir = file.split('/')[0];\n    srcDirs.add(dir);\n\n    // Categorize files\n    if (file.includes('component') || file.includes('ui/')) {\n      componentFiles.push(file);\n    } else if (file.includes('service') || file.includes('api/')) {\n      serviceFiles.push(file);\n    } else if (file.includes('util') || file.includes('helper') || file.includes('lib/')) {\n      utilityFiles.push(file);\n    }\n  }\n\n  // Generate architecture overview if source has multiple modules\n  if (srcDirs.size > 2 && !docExists('concepts/architecture/overview.md')) {\n    tasks.push({\n      directory: 'concepts/architecture',\n      type: 'concept',\n      agentType: 'analyst',\n      prompt: buildArchitecturePrompt(context, Array.from(srcDirs)),\n      outputFile: 'concepts/architecture/overview.md',\n    });\n  }\n\n  // Generate component docs for detected UI frameworks\n  if (frameworks.includes('React') || frameworks.includes('Vue')) {\n    if (componentFiles.length > 0 && !docExists('components/ui/overview.md')) {\n      tasks.push({\n        directory: 'components/ui',\n        type: 'component',\n        agentType: 'coder',\n        prompt: buildComponentPrompt(context, componentFiles.slice(0, 10)),\n        outputFile: 'components/ui/overview.md',\n      });\n    }\n  }\n\n  // Generate service docs if API files detected\n  if (serviceFiles.length > 0 && !docExists('services/api/overview.md')) {\n    tasks.push({\n      directory: 'services/api',\n      type: 'service',\n      agentType: 'coder',\n      prompt: buildServicePrompt(context, serviceFiles.slice(0, 10)),\n      outputFile: 'services/api/overview.md',\n    });\n  }\n\n  // Generate utility docs\n  if (utilityFiles.length > 0 && !docExists('components/utilities/overview.md')) {\n    tasks.push({\n      directory: 'components/utilities',\n      type: 'component',\n      agentType: 'coder',\n      prompt: buildUtilityPrompt(context, utilityFiles.slice(0, 10)),\n      outputFile: 'components/utilities/overview.md',\n    });\n  }\n\n  // Generate getting started guide\n  if (!docExists('guides/getting-started/quick-start.md')) {\n    tasks.push({\n      directory: 'guides/getting-started',\n      type: 'guide',\n      agentType: 'researcher',\n      prompt: buildGettingStartedPrompt(context),\n      outputFile: 'guides/getting-started/quick-start.md',\n    });\n  }\n\n  // Generate standards/coding guide if tsconfig or eslint exists\n  const hasLinting = existsSync(join(projectRoot, '.eslintrc.json')) ||\n                     existsSync(join(projectRoot, '.eslintrc.js')) ||\n                     existsSync(join(projectRoot, 'eslint.config.js'));\n  const hasTypescript = existsSync(join(projectRoot, 'tsconfig.json'));\n\n  if ((hasLinting || hasTypescript) && !docExists('standards/coding-standards/guide.md')) {\n    tasks.push({\n      directory: 'standards/coding-standards',\n      type: 'standard',\n      agentType: 'analyst',\n      prompt: buildCodingStandardsPrompt(context, hasTypescript, hasLinting),\n      outputFile: 'standards/coding-standards/guide.md',\n    });\n  }\n\n  // Generate integration docs for detected databases/services\n  if (frameworks.includes('Prisma') && !docExists('integrations/databases/prisma.md')) {\n    tasks.push({\n      directory: 'integrations/databases',\n      type: 'integration',\n      agentType: 'coder',\n      prompt: buildPrismaPrompt(context),\n      outputFile: 'integrations/databases/prisma.md',\n    });\n  }\n\n  return tasks;\n}\n\n/**\n * Execute a single agent task\n */\nasync function executeAgentTask(\n  task: AgentTask,\n  context: GenerationContext,\n  verbose?: boolean\n): Promise<GeneratedDoc> {\n  const { docsPath } = context;\n  const outputPath = join(docsPath, task.outputFile);\n\n  // Try to use claude-flow if available, otherwise generate locally\n  const hasClaudeFlow = await checkClaudeFlowAvailable();\n\n  let content: string;\n\n  if (hasClaudeFlow) {\n    content = await executeWithClaudeFlow(task, context, verbose);\n  } else {\n    // Fallback to local template generation\n    content = generateLocalTemplate(task, context);\n  }\n\n  // Write the file\n  writeFileSync(outputPath, content, 'utf-8');\n\n  return {\n    path: task.outputFile,\n    title: extractTitle(content) || basename(task.outputFile, '.md'),\n    type: task.type,\n    generated: true,\n  };\n}\n\n/**\n * Check if claude-flow is available\n */\nasync function checkClaudeFlowAvailable(): Promise<boolean> {\n  return new Promise((resolve) => {\n    const proc = spawn('npx', ['claude-flow@alpha', '--version'], {\n      stdio: 'pipe',\n      shell: true,\n    });\n\n    proc.on('close', (code) => {\n      resolve(code === 0);\n    });\n\n    proc.on('error', () => {\n      resolve(false);\n    });\n\n    // Timeout after 5 seconds\n    setTimeout(() => {\n      proc.kill();\n      resolve(false);\n    }, 5000);\n  });\n}\n\n/**\n * Execute task using claude-flow expert agents\n */\nasync function executeWithClaudeFlow(\n  task: AgentTask,\n  context: GenerationContext,\n  verbose?: boolean\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const agentCmd = `npx claude-flow@alpha sparc run ${task.agentType} \"${task.prompt.replace(/\"/g, '\\\\\"')}\"`;\n\n    if (verbose) {\n      console.log(`\\n  Spawning ${task.agentType} agent for ${task.outputFile}...`);\n    }\n\n    const proc = spawn(agentCmd, {\n      shell: true,\n      cwd: context.projectRoot,\n      stdio: verbose ? 'inherit' : 'pipe',\n    });\n\n    let output = '';\n\n    if (proc.stdout) {\n      proc.stdout.on('data', (data) => {\n        output += data.toString();\n      });\n    }\n\n    proc.on('close', (code) => {\n      if (code === 0 && output) {\n        resolve(output);\n      } else {\n        // Fallback to local generation\n        resolve(generateLocalTemplate(task, context));\n      }\n    });\n\n    proc.on('error', () => {\n      resolve(generateLocalTemplate(task, context));\n    });\n\n    // Timeout after 60 seconds\n    setTimeout(() => {\n      proc.kill();\n      resolve(generateLocalTemplate(task, context));\n    }, 60000);\n  });\n}\n\n/**\n * Generate document using local templates (fallback)\n */\nfunction generateLocalTemplate(task: AgentTask, context: GenerationContext): string {\n  const date = new Date().toISOString().split('T')[0];\n  const { projectName } = context;\n\n  const templates: Record<string, string> = {\n    'concepts/architecture/overview.md': `---\ntitle: Architecture Overview\ntype: concept\nstatus: active\ntags: [architecture, overview]\ncreated: ${date}\n---\n\n# Architecture Overview\n\nHigh-level architecture documentation for ${projectName}.\n\n## System Overview\n\nThis document describes the overall architecture and design patterns used in ${projectName}.\n\n## Module Structure\n\n${context.sourceFiles.slice(0, 20).map(f => `- \\`${f}\\``).join('\\n')}\n\n## Key Patterns\n\n*Document key architectural patterns here*\n\n## Design Decisions\n\n*Add Architecture Decision Records (ADRs)*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'components/ui/overview.md': `---\ntitle: UI Components Overview\ntype: technical\nstatus: active\ntags: [components, ui]\ncreated: ${date}\n---\n\n# UI Components\n\nUser interface components for ${projectName}.\n\n## Component Library\n\n${context.frameworks.includes('React') ? 'Built with **React**.' : ''}\n${context.frameworks.includes('Vue') ? 'Built with **Vue**.' : ''}\n\n## Available Components\n\n*Document available UI components*\n\n## Usage Patterns\n\n*Add component usage examples*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'services/api/overview.md': `---\ntitle: API Services Overview\ntype: service\nstatus: active\ntags: [api, services]\ncreated: ${date}\n---\n\n# API Services\n\nBackend API services for ${projectName}.\n\n## Endpoints\n\n*Document API endpoints*\n\n## Authentication\n\n*Document authentication flow*\n\n## Error Handling\n\n*Document error handling patterns*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'components/utilities/overview.md': `---\ntitle: Utilities Overview\ntype: technical\nstatus: active\ntags: [utilities, helpers]\ncreated: ${date}\n---\n\n# Utility Functions\n\nReusable utilities and helpers for ${projectName}.\n\n## Available Utilities\n\n*Document available utilities*\n\n## Usage Examples\n\n*Add code examples*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'guides/getting-started/quick-start.md': `---\ntitle: Quick Start Guide\ntype: guide\nstatus: active\ntags: [guide, getting-started]\ncreated: ${date}\n---\n\n# Quick Start\n\nGet up and running with ${projectName}.\n\n## Prerequisites\n\n${context.languages.map(l => `- ${l}`).join('\\n')}\n\n## Installation\n\n\\`\\`\\`bash\nnpm install\n\\`\\`\\`\n\n## Basic Usage\n\n*Add basic usage instructions*\n\n## Next Steps\n\n- [[concepts/architecture/overview|Architecture Overview]]\n- [[guides/_MOC|More Guides]]\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'standards/coding-standards/guide.md': `---\ntitle: Coding Standards\ntype: standard\nstatus: active\ntags: [standards, coding]\ncreated: ${date}\n---\n\n# Coding Standards\n\nCode style and conventions for ${projectName}.\n\n## Language Standards\n\n${context.languages.map(l => `### ${l}\\n\\n*Add ${l} specific standards*`).join('\\n\\n')}\n\n## Linting Configuration\n\n*Document ESLint/Prettier setup*\n\n## Best Practices\n\n*Add coding best practices*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'integrations/databases/prisma.md': `---\ntitle: Prisma Integration\ntype: integration\nstatus: active\ntags: [prisma, database, orm]\ncreated: ${date}\n---\n\n# Prisma Integration\n\nDatabase ORM configuration for ${projectName}.\n\n## Schema Location\n\n\\`prisma/schema.prisma\\`\n\n## Models\n\n*Document database models*\n\n## Migrations\n\n\\`\\`\\`bash\nnpx prisma migrate dev\n\\`\\`\\`\n\n## Client Usage\n\n*Add Prisma client usage examples*\n\n---\n> Auto-generated by kg-agent\n`,\n  };\n\n  return templates[task.outputFile] || generateGenericTemplate(task, context, date);\n}\n\n/**\n * Generate a generic template for unknown task types\n */\nfunction generateGenericTemplate(\n  task: AgentTask,\n  context: GenerationContext,\n  date: string\n): string {\n  const title = basename(task.outputFile, '.md')\n    .split('-')\n    .map(w => w.charAt(0).toUpperCase() + w.slice(1))\n    .join(' ');\n\n  return `---\ntitle: ${title}\ntype: ${task.type}\nstatus: draft\ntags: [${task.type}]\ncreated: ${date}\n---\n\n# ${title}\n\nDocumentation for ${context.projectName}.\n\n## Overview\n\n*Add overview content*\n\n## Details\n\n*Add detailed documentation*\n\n---\n> Auto-generated by kg-agent\n`;\n}\n\n/**\n * Extract title from markdown content\n */\nfunction extractTitle(content: string): string | null {\n  const match = content.match(/^#\\s+(.+)$/m);\n  return match ? match[1] : null;\n}\n\n// Prompt builders\n\nfunction buildArchitecturePrompt(context: GenerationContext, dirs: string[]): string {\n  return `Analyze the architecture of ${context.projectName}.\nModules: ${dirs.join(', ')}.\nLanguages: ${context.languages.join(', ')}.\nGenerate an Architecture Overview markdown document with system design, patterns, and key decisions.`;\n}\n\nfunction buildComponentPrompt(context: GenerationContext, files: string[]): string {\n  return `Document the UI components in ${context.projectName}.\nFrameworks: ${context.frameworks.join(', ')}.\nComponent files: ${files.join(', ')}.\nGenerate a Components Overview markdown document.`;\n}\n\nfunction buildServicePrompt(context: GenerationContext, files: string[]): string {\n  return `Document the API services in ${context.projectName}.\nService files: ${files.join(', ')}.\nGenerate an API Services Overview markdown document with endpoints and patterns.`;\n}\n\nfunction buildUtilityPrompt(context: GenerationContext, files: string[]): string {\n  return `Document utility functions in ${context.projectName}.\nUtility files: ${files.join(', ')}.\nGenerate a Utilities Overview markdown document.`;\n}\n\nfunction buildGettingStartedPrompt(context: GenerationContext): string {\n  return `Create a Quick Start guide for ${context.projectName}.\nLanguages: ${context.languages.join(', ')}.\nFrameworks: ${context.frameworks.join(', ')}.\nGenerate a Getting Started guide with installation and basic usage.`;\n}\n\nfunction buildCodingStandardsPrompt(\n  context: GenerationContext,\n  hasTypescript: boolean,\n  hasLinting: boolean\n): string {\n  return `Document coding standards for ${context.projectName}.\nTypeScript: ${hasTypescript ? 'yes' : 'no'}.\nESLint: ${hasLinting ? 'yes' : 'no'}.\nGenerate a Coding Standards guide with style rules and best practices.`;\n}\n\nfunction buildPrismaPrompt(context: GenerationContext): string {\n  return `Document Prisma database integration for ${context.projectName}.\nGenerate integration documentation with schema, models, and usage patterns.`;\n}\n"],"names":[],"mappings":";;;;AA4DA,eAAsB,uBACpB,aACA,UACA,UAII,CAAA,GAC4B;AAChC,QAAM,SAAgC;AAAA,IACpC,SAAS;AAAA,IACT,oBAAoB,CAAA;AAAA,IACpB,eAAe;AAAA,IACf,QAAQ,CAAA;AAAA,EAAC;AAGX,MAAI;AAEF,UAAM,UAAU,MAAM,uBAAuB,aAAa,QAAQ;AAGlE,UAAM,QAAQ,MAAM,uBAAuB,OAAO;AAElD,QAAI,QAAQ,QAAQ;AAClB,cAAQ,IAAI,qDAAqD;AACjE,iBAAW,QAAQ,OAAO;AACxB,gBAAQ,IAAI,OAAO,KAAK,UAAU,KAAK,KAAK,SAAS,SAAS;AAAA,MAChE;AACA,aAAO;AAAA,IACT;AAGA,QAAI,QAAQ,UAAU;AACpB,YAAM,UAAU,MAAM,QAAQ;AAAA,QAC5B,MAAM,IAAI,CAAA,SAAQ,iBAAiB,MAAM,SAAS,QAAQ,OAAO,CAAC;AAAA,MAAA;AAGpE,eAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,cAAM,IAAI,QAAQ,CAAC;AACnB,eAAO;AAEP,YAAI,EAAE,WAAW,aAAa;AAC5B,iBAAO,mBAAmB,KAAK,EAAE,KAAK;AAAA,QACxC,OAAO;AACL,iBAAO,OAAO,KAAK,WAAW,MAAM,CAAC,EAAE,UAAU,MAAM,EAAE,MAAM,EAAE;AACjE,iBAAO,mBAAmB,KAAK;AAAA,YAC7B,MAAM,MAAM,CAAC,EAAE;AAAA,YACf,OAAO,SAAS,MAAM,CAAC,EAAE,YAAY,KAAK;AAAA,YAC1C,MAAM,MAAM,CAAC,EAAE;AAAA,YACf,WAAW;AAAA,YACX,OAAO,OAAO,EAAE,MAAM;AAAA,UAAA,CACvB;AAAA,QACH;AAAA,MACF;AAAA,IACF,OAAO;AAEL,iBAAW,QAAQ,OAAO;AACxB,eAAO;AAEP,YAAI;AACF,gBAAM,MAAM,MAAM,iBAAiB,MAAM,SAAS,QAAQ,OAAO;AACjE,iBAAO,mBAAmB,KAAK,GAAG;AAAA,QACpC,SAAS,OAAO;AACd,iBAAO,OAAO,KAAK,WAAW,KAAK,UAAU,MAAM,KAAK,EAAE;AAC1D,iBAAO,mBAAmB,KAAK;AAAA,YAC7B,MAAM,KAAK;AAAA,YACX,OAAO,SAAS,KAAK,YAAY,KAAK;AAAA,YACtC,MAAM,KAAK;AAAA,YACX,WAAW;AAAA,YACX,OAAO,OAAO,KAAK;AAAA,UAAA,CACpB;AAAA,QACH;AAAA,MACF;AAAA,IACF;AAEA,WAAO,UAAU,OAAO,OAAO,WAAW;AAAA,EAC5C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,sBAAsB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO;AACT;AAKA,eAAe,uBACb,aACA,UAC4B;AAC5B,QAAM,UAA6B;AAAA,IACjC;AAAA,IACA;AAAA,IACA,aAAa,SAAS,WAAW;AAAA,IACjC,WAAW,CAAA;AAAA,IACX,YAAY,CAAA;AAAA,IACZ,cAAc,CAAA;AAAA,IACd,aAAa,CAAA;AAAA,EAAC;AAIhB,QAAM,UAAU,KAAK,aAAa,cAAc;AAChD,MAAI,WAAW,OAAO,GAAG;AACvB,QAAI;AACF,YAAM,MAAM,KAAK,MAAM,aAAa,SAAS,OAAO,CAAC;AACrD,cAAQ,cAAc,IAAI,MAAM,QAAQ,aAAa,EAAE,KAAK,QAAQ;AAGpE,YAAM,OAAO,EAAE,GAAG,IAAI,cAAc,GAAG,IAAI,gBAAA;AAC3C,UAAI,KAAK,MAAO,SAAQ,WAAW,KAAK,OAAO;AAC/C,UAAI,KAAK,KAAM,SAAQ,WAAW,KAAK,SAAS;AAChD,UAAI,KAAK,IAAK,SAAQ,WAAW,KAAK,KAAK;AAC3C,UAAI,KAAK,QAAS,SAAQ,WAAW,KAAK,SAAS;AACnD,UAAI,KAAK,QAAS,SAAQ,WAAW,KAAK,SAAS;AACnD,UAAI,KAAK,gBAAgB,KAAK,KAAK,OAAQ,SAAQ,WAAW,KAAK,QAAQ;AAAA,IAC7E,QAAQ;AAAA,IAER;AAAA,EACF;AAGA,MAAI,WAAW,KAAK,aAAa,eAAe,CAAC,GAAG;AAClD,YAAQ,UAAU,KAAK,YAAY;AAAA,EACrC;AACA,MAAI,WAAW,KAAK,aAAa,cAAc,CAAC,GAAG;AACjD,YAAQ,UAAU,KAAK,YAAY;AAAA,EACrC;AACA,MAAI,WAAW,KAAK,aAAa,kBAAkB,CAAC,KAAK,WAAW,KAAK,aAAa,gBAAgB,CAAC,GAAG;AACxG,YAAQ,UAAU,KAAK,QAAQ;AAAA,EACjC;AACA,MAAI,WAAW,KAAK,aAAa,YAAY,CAAC,GAAG;AAC/C,YAAQ,UAAU,KAAK,MAAM;AAAA,EAC/B;AACA,MAAI,WAAW,KAAK,aAAa,QAAQ,CAAC,GAAG;AAC3C,YAAQ,UAAU,KAAK,IAAI;AAAA,EAC7B;AAGA,QAAM,eAAe,MAAM,GAAG,WAAW;AAAA,IACvC,KAAK;AAAA,IACL,QAAQ,CAAC,mBAAmB,WAAW,eAAe;AAAA,EAAA,CACvD;AACD,UAAQ,eAAe;AAGvB,QAAM,cAAc,MAAM,GAAG,iCAAiC;AAAA,IAC5D,KAAK;AAAA,IACL,QAAQ,CAAC,mBAAmB,WAAW,WAAW,YAAY,WAAW,KAAK;AAAA,IAC9E,KAAK;AAAA,EAAA,CACN;AACD,UAAQ,cAAc;AAEtB,SAAO;AACT;AAKA,eAAe,uBAAuB,SAAkD;AACtF,QAAM,QAAqB,CAAA;AAC3B,QAAM,EAAE,aAAa,UAAU,aAAa,eAAe;AAG3D,QAAM,YAAY,CAAC,iBAAyB;AAC1C,WAAO,WAAW,KAAK,UAAU,YAAY,CAAC;AAAA,EAChD;AAGA,QAAM,8BAAc,IAAA;AACpB,QAAM,iBAA2B,CAAA;AACjC,QAAM,eAAyB,CAAA;AAC/B,QAAM,eAAyB,CAAA;AAE/B,aAAW,QAAQ,aAAa;AAC9B,UAAM,MAAM,KAAK,MAAM,GAAG,EAAE,CAAC;AAC7B,YAAQ,IAAI,GAAG;AAGf,QAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,KAAK,GAAG;AACtD,qBAAe,KAAK,IAAI;AAAA,IAC1B,WAAW,KAAK,SAAS,SAAS,KAAK,KAAK,SAAS,MAAM,GAAG;AAC5D,mBAAa,KAAK,IAAI;AAAA,IACxB,WAAW,KAAK,SAAS,MAAM,KAAK,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,MAAM,GAAG;AACpF,mBAAa,KAAK,IAAI;AAAA,IACxB;AAAA,EACF;AAGA,MAAI,QAAQ,OAAO,KAAK,CAAC,UAAU,mCAAmC,GAAG;AACvE,UAAM,KAAK;AAAA,MACT,WAAW;AAAA,MACX,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ,wBAAwB,SAAS,MAAM,KAAK,OAAO,CAAC;AAAA,MAC5D,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAGA,MAAI,WAAW,SAAS,OAAO,KAAK,WAAW,SAAS,KAAK,GAAG;AAC9D,QAAI,eAAe,SAAS,KAAK,CAAC,UAAU,2BAA2B,GAAG;AACxE,YAAM,KAAK;AAAA,QACT,WAAW;AAAA,QACX,MAAM;AAAA,QACN,WAAW;AAAA,QACX,QAAQ,qBAAqB,SAAS,eAAe,MAAM,GAAG,EAAE,CAAC;AAAA,QACjE,YAAY;AAAA,MAAA,CACb;AAAA,IACH;AAAA,EACF;AAGA,MAAI,aAAa,SAAS,KAAK,CAAC,UAAU,0BAA0B,GAAG;AACrE,UAAM,KAAK;AAAA,MACT,WAAW;AAAA,MACX,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ,mBAAmB,SAAS,aAAa,MAAM,GAAG,EAAE,CAAC;AAAA,MAC7D,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAGA,MAAI,aAAa,SAAS,KAAK,CAAC,UAAU,kCAAkC,GAAG;AAC7E,UAAM,KAAK;AAAA,MACT,WAAW;AAAA,MACX,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ,mBAAmB,SAAS,aAAa,MAAM,GAAG,EAAE,CAAC;AAAA,MAC7D,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAGA,MAAI,CAAC,UAAU,uCAAuC,GAAG;AACvD,UAAM,KAAK;AAAA,MACT,WAAW;AAAA,MACX,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ,0BAA0B,OAAO;AAAA,MACzC,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAGA,QAAM,aAAa,WAAW,KAAK,aAAa,gBAAgB,CAAC,KAC9C,WAAW,KAAK,aAAa,cAAc,CAAC,KAC5C,WAAW,KAAK,aAAa,kBAAkB,CAAC;AACnE,QAAM,gBAAgB,WAAW,KAAK,aAAa,eAAe,CAAC;AAEnE,OAAK,cAAc,kBAAkB,CAAC,UAAU,qCAAqC,GAAG;AACtF,UAAM,KAAK;AAAA,MACT,WAAW;AAAA,MACX,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ,2BAA2B,SAAS,eAAe,UAAU;AAAA,MACrE,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAGA,MAAI,WAAW,SAAS,QAAQ,KAAK,CAAC,UAAU,kCAAkC,GAAG;AACnF,UAAM,KAAK;AAAA,MACT,WAAW;AAAA,MACX,MAAM;AAAA,MACN,WAAW;AAAA,MACX,QAAQ,kBAAkB,OAAO;AAAA,MACjC,YAAY;AAAA,IAAA,CACb;AAAA,EACH;AAEA,SAAO;AACT;AAKA,eAAe,iBACb,MACA,SACA,SACuB;AACvB,QAAM,EAAE,aAAa;AACrB,QAAM,aAAa,KAAK,UAAU,KAAK,UAAU;AAGjD,QAAM,gBAAgB,MAAM,yBAAA;AAE5B,MAAI;AAEJ,MAAI,eAAe;AACjB,cAAU,MAAM,sBAAsB,MAAM,SAAS,OAAO;AAAA,EAC9D,OAAO;AAEL,cAAU,sBAAsB,MAAM,OAAO;AAAA,EAC/C;AAGA,gBAAc,YAAY,SAAS,OAAO;AAE1C,SAAO;AAAA,IACL,MAAM,KAAK;AAAA,IACX,OAAO,aAAa,OAAO,KAAK,SAAS,KAAK,YAAY,KAAK;AAAA,IAC/D,MAAM,KAAK;AAAA,IACX,WAAW;AAAA,EAAA;AAEf;AAKA,eAAe,2BAA6C;AAC1D,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,OAAO,MAAM,OAAO,CAAC,qBAAqB,WAAW,GAAG;AAAA,MAC5D,OAAO;AAAA,MACP,OAAO;AAAA,IAAA,CACR;AAED,SAAK,GAAG,SAAS,CAAC,SAAS;AACzB,cAAQ,SAAS,CAAC;AAAA,IACpB,CAAC;AAED,SAAK,GAAG,SAAS,MAAM;AACrB,cAAQ,KAAK;AAAA,IACf,CAAC;AAGD,eAAW,MAAM;AACf,WAAK,KAAA;AACL,cAAQ,KAAK;AAAA,IACf,GAAG,GAAI;AAAA,EACT,CAAC;AACH;AAKA,eAAe,sBACb,MACA,SACA,SACiB;AACjB,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,WAAW,mCAAmC,KAAK,SAAS,KAAK,KAAK,OAAO,QAAQ,MAAM,KAAK,CAAC;AAEvG,QAAI,SAAS;AACX,cAAQ,IAAI;AAAA,aAAgB,KAAK,SAAS,cAAc,KAAK,UAAU,KAAK;AAAA,IAC9E;AAEA,UAAM,OAAO,MAAM,UAAU;AAAA,MAC3B,OAAO;AAAA,MACP,KAAK,QAAQ;AAAA,MACb,OAAO,UAAU,YAAY;AAAA,IAAA,CAC9B;AAED,QAAI,SAAS;AAEb,QAAI,KAAK,QAAQ;AACf,WAAK,OAAO,GAAG,QAAQ,CAAC,SAAS;AAC/B,kBAAU,KAAK,SAAA;AAAA,MACjB,CAAC;AAAA,IACH;AAEA,SAAK,GAAG,SAAS,CAAC,SAAS;AACzB,UAAI,SAAS,KAAK,QAAQ;AACxB,gBAAQ,MAAM;AAAA,MAChB,OAAO;AAEL,gBAAQ,sBAAsB,MAAM,OAAO,CAAC;AAAA,MAC9C;AAAA,IACF,CAAC;AAED,SAAK,GAAG,SAAS,MAAM;AACrB,cAAQ,sBAAsB,MAAM,OAAO,CAAC;AAAA,IAC9C,CAAC;AAGD,eAAW,MAAM;AACf,WAAK,KAAA;AACL,cAAQ,sBAAsB,MAAM,OAAO,CAAC;AAAA,IAC9C,GAAG,GAAK;AAAA,EACV,CAAC;AACH;AAKA,SAAS,sBAAsB,MAAiB,SAAoC;AAClF,QAAM,4BAAW,KAAA,GAAO,cAAc,MAAM,GAAG,EAAE,CAAC;AAClD,QAAM,EAAE,gBAAgB;AAExB,QAAM,YAAoC;AAAA,IACxC,qCAAqC;AAAA;AAAA;AAAA;AAAA;AAAA,WAK9B,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,4CAK6B,WAAW;AAAA;AAAA;AAAA;AAAA,+EAIwB,WAAW;AAAA;AAAA;AAAA;AAAA,EAIxF,QAAQ,YAAY,MAAM,GAAG,EAAE,EAAE,IAAI,CAAA,MAAK,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAchE,6BAA6B;AAAA;AAAA;AAAA;AAAA;AAAA,WAKtB,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,gCAKiB,WAAW;AAAA;AAAA;AAAA;AAAA,EAIzC,QAAQ,WAAW,SAAS,OAAO,IAAI,0BAA0B,EAAE;AAAA,EACnE,QAAQ,WAAW,SAAS,KAAK,IAAI,wBAAwB,EAAE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAc7D,4BAA4B;AAAA;AAAA;AAAA;AAAA;AAAA,WAKrB,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,2BAKY,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBlC,oCAAoC;AAAA;AAAA;AAAA;AAAA;AAAA,WAK7B,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,qCAKsB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAc5C,yCAAyC;AAAA;AAAA;AAAA;AAAA;AAAA,WAKlC,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,0BAKW,WAAW;AAAA;AAAA;AAAA;AAAA,EAInC,QAAQ,UAAU,IAAI,CAAA,MAAK,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAqB7C,uCAAuC;AAAA;AAAA;AAAA;AAAA;AAAA,WAKhC,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,iCAKkB,WAAW;AAAA;AAAA;AAAA;AAAA,EAI1C,QAAQ,UAAU,IAAI,CAAA,MAAK,OAAO,CAAC;AAAA;AAAA,OAAY,CAAC,sBAAsB,EAAE,KAAK,MAAM,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAclF,oCAAoC;AAAA;AAAA;AAAA;AAAA;AAAA,WAK7B,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,iCAKkB,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAAA;AAyB1C,SAAO,UAAU,KAAK,UAAU,KAAK,wBAAwB,MAAM,SAAS,IAAI;AAClF;AAKA,SAAS,wBACP,MACA,SACA,MACQ;AACR,QAAM,QAAQ,SAAS,KAAK,YAAY,KAAK,EAC1C,MAAM,GAAG,EACT,IAAI,CAAA,MAAK,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,EAC/C,KAAK,GAAG;AAEX,SAAO;AAAA,SACA,KAAK;AAAA,QACN,KAAK,IAAI;AAAA;AAAA,SAER,KAAK,IAAI;AAAA,WACP,IAAI;AAAA;AAAA;AAAA,IAGX,KAAK;AAAA;AAAA,oBAEW,QAAQ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAavC;AAKA,SAAS,aAAa,SAAgC;AACpD,QAAM,QAAQ,QAAQ,MAAM,aAAa;AACzC,SAAO,QAAQ,MAAM,CAAC,IAAI;AAC5B;AAIA,SAAS,wBAAwB,SAA4B,MAAwB;AACnF,SAAO,+BAA+B,QAAQ,WAAW;AAAA,WAChD,KAAK,KAAK,IAAI,CAAC;AAAA,aACb,QAAQ,UAAU,KAAK,IAAI,CAAC;AAAA;AAEzC;AAEA,SAAS,qBAAqB,SAA4B,OAAyB;AACjF,SAAO,iCAAiC,QAAQ,WAAW;AAAA,cAC/C,QAAQ,WAAW,KAAK,IAAI,CAAC;AAAA,mBACxB,MAAM,KAAK,IAAI,CAAC;AAAA;AAEnC;AAEA,SAAS,mBAAmB,SAA4B,OAAyB;AAC/E,SAAO,gCAAgC,QAAQ,WAAW;AAAA,iBAC3C,MAAM,KAAK,IAAI,CAAC;AAAA;AAEjC;AAEA,SAAS,mBAAmB,SAA4B,OAAyB;AAC/E,SAAO,iCAAiC,QAAQ,WAAW;AAAA,iBAC5C,MAAM,KAAK,IAAI,CAAC;AAAA;AAEjC;AAEA,SAAS,0BAA0B,SAAoC;AACrE,SAAO,kCAAkC,QAAQ,WAAW;AAAA,aACjD,QAAQ,UAAU,KAAK,IAAI,CAAC;AAAA,cAC3B,QAAQ,WAAW,KAAK,IAAI,CAAC;AAAA;AAE3C;AAEA,SAAS,2BACP,SACA,eACA,YACQ;AACR,SAAO,iCAAiC,QAAQ,WAAW;AAAA,cAC/C,gBAAgB,QAAQ,IAAI;AAAA,UAChC,aAAa,QAAQ,IAAI;AAAA;AAEnC;AAEA,SAAS,kBAAkB,SAAoC;AAC7D,SAAO,4CAA4C,QAAQ,WAAW;AAAA;AAExE;"}
+{"version":3,"file":"doc-generator-agents.js","sources":["../../src/generators/doc-generator-agents.ts"],"sourcesContent":["/**\n * Agent-Driven Document Generator\n *\n * Spawns expert agents from claude-flow to analyze existing code and\n * documentation, then generates appropriate documents for each directory.\n */\n\nimport { existsSync, readFileSync, writeFileSync, readdirSync, statSync, mkdirSync, copyFileSync } from 'fs';\nimport { join, basename, extname, relative, dirname } from 'path';\nimport fg from 'fast-glob';\nimport { spawn } from 'child_process';\n\n/**\n * Service documentation found in src/{service}/docs directories\n */\ninterface ServiceDoc {\n  serviceName: string;\n  sourcePath: string;\n  fileName: string;\n  relativePath: string;\n}\n\n/**\n * Document generation context\n */\nexport interface GenerationContext {\n  projectRoot: string;\n  docsPath: string;\n  projectName: string;\n  languages: string[];\n  frameworks: string[];\n  existingDocs: string[];\n  sourceFiles: string[];\n  serviceDocs: ServiceDoc[];\n}\n\n/**\n * Generation result for a single document\n */\nexport interface GeneratedDoc {\n  path: string;\n  title: string;\n  type: string;\n  generated: boolean;\n  error?: string;\n}\n\n/**\n * Overall generation result\n */\nexport interface AgentGenerationResult {\n  success: boolean;\n  documentsGenerated: GeneratedDoc[];\n  agentsSpawned: number;\n  errors: string[];\n}\n\n/**\n * Agent task definition\n */\ninterface AgentTask {\n  directory: string;\n  type: 'concept' | 'component' | 'service' | 'feature' | 'integration' | 'standard' | 'guide' | 'reference';\n  agentType: 'researcher' | 'coder' | 'analyst';\n  prompt: string;\n  outputFile: string;\n}\n\n/**\n * Analyze project and generate documents using expert agents\n */\nexport async function generateDocsWithAgents(\n  projectRoot: string,\n  docsPath: string,\n  options: {\n    parallel?: boolean;\n    dryRun?: boolean;\n    verbose?: boolean;\n    force?: boolean;\n  } = {}\n): Promise<AgentGenerationResult> {\n  const result: AgentGenerationResult = {\n    success: true,\n    documentsGenerated: [],\n    agentsSpawned: 0,\n    errors: [],\n  };\n\n  try {\n    // Build context by analyzing the project\n    const context = await buildGenerationContext(projectRoot, docsPath);\n\n    // Determine what documents should be generated\n    const tasks = await planDocumentGeneration(context, options.force);\n\n    if (options.dryRun) {\n      console.log('\\n[Dry Run] Would generate the following documents:');\n      for (const task of tasks) {\n        console.log(`  - ${task.outputFile} (${task.agentType} agent)`);\n      }\n      if (context.serviceDocs.length > 0) {\n        console.log('\\n[Dry Run] Would copy service docs:');\n        for (const doc of context.serviceDocs) {\n          const targetPath = `services/${doc.serviceName}/${doc.relativePath}`;\n          console.log(`  - ${doc.sourcePath} → ${targetPath}`);\n        }\n      }\n      return result;\n    }\n\n    // Copy service docs from src/{service}/docs to main docs directory\n    const copiedDocs = copyServiceDocs(context, options.force);\n\n    // Execute tasks (parallel or sequential)\n    if (options.parallel) {\n      const results = await Promise.allSettled(\n        tasks.map(task => executeAgentTask(task, context, options.verbose))\n      );\n\n      for (let i = 0; i < results.length; i++) {\n        const r = results[i];\n        result.agentsSpawned++;\n\n        if (r.status === 'fulfilled') {\n          result.documentsGenerated.push(r.value);\n        } else {\n          result.errors.push(`Failed: ${tasks[i].outputFile} - ${r.reason}`);\n          result.documentsGenerated.push({\n            path: tasks[i].outputFile,\n            title: basename(tasks[i].outputFile, '.md'),\n            type: tasks[i].type,\n            generated: false,\n            error: String(r.reason),\n          });\n        }\n      }\n    } else {\n      // Sequential execution\n      for (const task of tasks) {\n        result.agentsSpawned++;\n\n        try {\n          const doc = await executeAgentTask(task, context, options.verbose);\n          result.documentsGenerated.push(doc);\n        } catch (error) {\n          result.errors.push(`Failed: ${task.outputFile} - ${error}`);\n          result.documentsGenerated.push({\n            path: task.outputFile,\n            title: basename(task.outputFile, '.md'),\n            type: task.type,\n            generated: false,\n            error: String(error),\n          });\n        }\n      }\n    }\n\n    // Add copied service docs to result\n    result.documentsGenerated.push(...copiedDocs);\n\n    result.success = result.errors.length === 0;\n  } catch (error) {\n    result.success = false;\n    result.errors.push(`Generation failed: ${error}`);\n  }\n\n  return result;\n}\n\n/**\n * Copy service docs from src/{service}/docs to main docs directory\n */\nfunction copyServiceDocs(context: GenerationContext, force?: boolean): GeneratedDoc[] {\n  const { docsPath, serviceDocs } = context;\n  const copied: GeneratedDoc[] = [];\n\n  for (const doc of serviceDocs) {\n    const targetDir = join(docsPath, 'services', doc.serviceName);\n    const targetPath = join(targetDir, doc.relativePath);\n    const relativeTarget = `services/${doc.serviceName}/${doc.relativePath}`;\n\n    // Skip if target exists and not forcing\n    if (!force && existsSync(targetPath)) {\n      continue;\n    }\n\n    try {\n      // Create target directory if needed\n      const targetFileDir = dirname(targetPath);\n      if (!existsSync(targetFileDir)) {\n        mkdirSync(targetFileDir, { recursive: true });\n      }\n\n      // Copy the file\n      copyFileSync(doc.sourcePath, targetPath);\n\n      copied.push({\n        path: relativeTarget,\n        title: doc.fileName.replace('.md', ''),\n        type: 'service',\n        generated: true,\n      });\n    } catch (error) {\n      copied.push({\n        path: relativeTarget,\n        title: doc.fileName.replace('.md', ''),\n        type: 'service',\n        generated: false,\n        error: String(error),\n      });\n    }\n  }\n\n  return copied;\n}\n\n/**\n * Build context by analyzing the project\n */\nasync function buildGenerationContext(\n  projectRoot: string,\n  docsPath: string\n): Promise<GenerationContext> {\n  const context: GenerationContext = {\n    projectRoot,\n    docsPath,\n    projectName: basename(projectRoot),\n    languages: [],\n    frameworks: [],\n    existingDocs: [],\n    sourceFiles: [],\n    serviceDocs: [],\n  };\n\n  // Get project name from package.json\n  const pkgPath = join(projectRoot, 'package.json');\n  if (existsSync(pkgPath)) {\n    try {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      context.projectName = pkg.name?.replace(/^@[^/]+\\//, '') || context.projectName;\n\n      // Detect frameworks from dependencies\n      const deps = { ...pkg.dependencies, ...pkg.devDependencies };\n      if (deps.react) context.frameworks.push('React');\n      if (deps.next) context.frameworks.push('Next.js');\n      if (deps.vue) context.frameworks.push('Vue');\n      if (deps.express) context.frameworks.push('Express');\n      if (deps.fastify) context.frameworks.push('Fastify');\n      if (deps['@prisma/client'] || deps.prisma) context.frameworks.push('Prisma');\n    } catch {\n      // Ignore parse errors\n    }\n  }\n\n  // Detect languages\n  if (existsSync(join(projectRoot, 'tsconfig.json'))) {\n    context.languages.push('TypeScript');\n  }\n  if (existsSync(join(projectRoot, 'package.json'))) {\n    context.languages.push('JavaScript');\n  }\n\n  // Detect Python - check multiple locations for requirements\n  const pythonConfigPaths = [\n    join(projectRoot, 'requirements.txt'),\n    join(projectRoot, 'pyproject.toml'),\n    join(projectRoot, 'src/backend/requirements.txt'),\n    join(projectRoot, 'backend/requirements.txt'),\n    join(projectRoot, 'src/requirements.txt'),\n  ];\n  const foundPythonConfig = pythonConfigPaths.find(p => existsSync(p));\n\n  // Also detect Python if we find .py files later in source scan\n  // For now, check if there's a Python config file\n  if (foundPythonConfig) {\n    context.languages.push('Python');\n\n    // Detect Python frameworks from requirements.txt or pyproject.toml\n    try {\n      let reqContent = readFileSync(foundPythonConfig, 'utf-8').toLowerCase();\n      // Also check pyproject.toml if we found requirements.txt\n      if (foundPythonConfig.includes('requirements.txt')) {\n        const pyprojectPath = join(projectRoot, 'pyproject.toml');\n        if (existsSync(pyprojectPath)) {\n          reqContent += readFileSync(pyprojectPath, 'utf-8').toLowerCase();\n        }\n      }\n      if (reqContent.includes('fastapi')) context.frameworks.push('FastAPI');\n      if (reqContent.includes('flask')) context.frameworks.push('Flask');\n      if (reqContent.includes('django')) context.frameworks.push('Django');\n      if (reqContent.includes('sqlalchemy')) context.frameworks.push('SQLAlchemy');\n      if (reqContent.includes('pydantic')) context.frameworks.push('Pydantic');\n      if (reqContent.includes('alembic')) context.frameworks.push('Alembic');\n    } catch {\n      // Ignore read errors\n    }\n  }\n  if (existsSync(join(projectRoot, 'Cargo.toml'))) {\n    context.languages.push('Rust');\n  }\n  if (existsSync(join(projectRoot, 'go.mod'))) {\n    context.languages.push('Go');\n  }\n\n  // Find existing docs\n  const existingDocs = await fg('**/*.md', {\n    cwd: docsPath,\n    ignore: ['node_modules/**', '.git/**', '_templates/**'],\n  });\n  context.existingDocs = existingDocs;\n\n  // Find source files\n  const sourceFiles = await fg('**/*.{ts,tsx,js,jsx,py,rs,go}', {\n    cwd: projectRoot,\n    ignore: ['node_modules/**', '.git/**', 'dist/**', 'build/**', docsPath + '/**'],\n    dot: true,\n  });\n  context.sourceFiles = sourceFiles;\n\n  // Detect Python from .py files if not already detected\n  if (!context.languages.includes('Python') && sourceFiles.some(f => f.endsWith('.py'))) {\n    context.languages.push('Python');\n  }\n\n  // Scan for service docs in src/{service}/docs directories\n  const serviceDocs: ServiceDoc[] = [];\n  const srcDir = join(projectRoot, 'src');\n  if (existsSync(srcDir)) {\n    try {\n      const srcEntries = readdirSync(srcDir, { withFileTypes: true });\n      for (const entry of srcEntries) {\n        if (entry.isDirectory()) {\n          const serviceDocsDir = join(srcDir, entry.name, 'docs');\n          if (existsSync(serviceDocsDir)) {\n            // Find all markdown files in this service's docs directory\n            const docsFiles = await fg('**/*.md', {\n              cwd: serviceDocsDir,\n              ignore: ['node_modules/**', '.git/**'],\n            });\n            for (const docFile of docsFiles) {\n              serviceDocs.push({\n                serviceName: entry.name,\n                sourcePath: join(serviceDocsDir, docFile),\n                fileName: basename(docFile),\n                relativePath: docFile,\n              });\n            }\n          }\n        }\n      }\n    } catch {\n      // Ignore errors reading src directory\n    }\n  }\n  context.serviceDocs = serviceDocs;\n\n  return context;\n}\n\n/**\n * Plan what documents should be generated based on context\n */\nasync function planDocumentGeneration(context: GenerationContext, force?: boolean): Promise<AgentTask[]> {\n  const tasks: AgentTask[] = [];\n  const { projectRoot, docsPath, sourceFiles, frameworks } = context;\n\n  // Helper to check if doc already exists (returns false if force is true)\n  const docExists = (relativePath: string) => {\n    if (force) return false; // Force regeneration\n    return existsSync(join(docsPath, relativePath));\n  };\n\n  // Analyze source structure to determine what docs to generate\n  const srcDirs = new Set<string>();\n  const componentFiles: string[] = [];\n  const serviceFiles: string[] = [];\n  const utilityFiles: string[] = [];\n  const backendFiles: string[] = [];\n  const modelFiles: string[] = [];\n  const frontendFiles: string[] = [];\n\n  for (const file of sourceFiles) {\n    const dir = file.split('/')[0];\n    srcDirs.add(dir);\n    const fileLower = file.toLowerCase();\n\n    // Categorize files (improved patterns for Python and TypeScript)\n    if (fileLower.includes('component') || fileLower.includes('/ui/') || fileLower.includes('/views/')) {\n      componentFiles.push(file);\n    }\n    if (fileLower.includes('service') || fileLower.includes('/api/') || fileLower.includes('routes') || fileLower.includes('endpoints')) {\n      serviceFiles.push(file);\n    }\n    if (fileLower.includes('util') || fileLower.includes('helper') || fileLower.includes('/lib/') || fileLower.includes('common')) {\n      utilityFiles.push(file);\n    }\n    if (fileLower.includes('backend') || fileLower.includes('server') || fileLower.includes('app/')) {\n      backendFiles.push(file);\n    }\n    if (fileLower.includes('model') || fileLower.includes('schema') || fileLower.includes('entities')) {\n      modelFiles.push(file);\n    }\n    if (fileLower.includes('frontend') || fileLower.includes('client') || fileLower.includes('pages')) {\n      frontendFiles.push(file);\n    }\n  }\n\n  // If no service files found but backend files exist, use backend files\n  if (serviceFiles.length === 0 && backendFiles.length > 0) {\n    serviceFiles.push(...backendFiles);\n  }\n\n  // Generate architecture overview if source has modules with files\n  // Threshold: at least 1 directory with 3+ source files\n  if (srcDirs.size >= 1 && sourceFiles.length >= 3 && !docExists('concepts/architecture/overview.md')) {\n    tasks.push({\n      directory: 'concepts/architecture',\n      type: 'concept',\n      agentType: 'analyst',\n      prompt: buildArchitecturePrompt(context, Array.from(srcDirs)),\n      outputFile: 'concepts/architecture/overview.md',\n    });\n  }\n\n  // Generate component docs for detected UI frameworks\n  if (frameworks.includes('React') || frameworks.includes('Vue')) {\n    if (componentFiles.length > 0 && !docExists('components/ui/overview.md')) {\n      tasks.push({\n        directory: 'components/ui',\n        type: 'component',\n        agentType: 'coder',\n        prompt: buildComponentPrompt(context, componentFiles.slice(0, 10)),\n        outputFile: 'components/ui/overview.md',\n      });\n    }\n  }\n\n  // Generate service docs if API files detected\n  if (serviceFiles.length > 0 && !docExists('services/api/overview.md')) {\n    tasks.push({\n      directory: 'services/api',\n      type: 'service',\n      agentType: 'coder',\n      prompt: buildServicePrompt(context, serviceFiles.slice(0, 10)),\n      outputFile: 'services/api/overview.md',\n    });\n  }\n\n  // Generate utility docs\n  if (utilityFiles.length > 0 && !docExists('components/utilities/overview.md')) {\n    tasks.push({\n      directory: 'components/utilities',\n      type: 'component',\n      agentType: 'coder',\n      prompt: buildUtilityPrompt(context, utilityFiles.slice(0, 10)),\n      outputFile: 'components/utilities/overview.md',\n    });\n  }\n\n  // Generate getting started guide\n  if (!docExists('guides/getting-started/quick-start.md')) {\n    tasks.push({\n      directory: 'guides/getting-started',\n      type: 'guide',\n      agentType: 'researcher',\n      prompt: buildGettingStartedPrompt(context),\n      outputFile: 'guides/getting-started/quick-start.md',\n    });\n  }\n\n  // Generate standards/coding guide if tsconfig or eslint exists\n  const hasLinting = existsSync(join(projectRoot, '.eslintrc.json')) ||\n                     existsSync(join(projectRoot, '.eslintrc.js')) ||\n                     existsSync(join(projectRoot, 'eslint.config.js'));\n  const hasTypescript = existsSync(join(projectRoot, 'tsconfig.json'));\n\n  if ((hasLinting || hasTypescript) && !docExists('standards/coding-standards/guide.md')) {\n    tasks.push({\n      directory: 'standards/coding-standards',\n      type: 'standard',\n      agentType: 'analyst',\n      prompt: buildCodingStandardsPrompt(context, hasTypescript, hasLinting),\n      outputFile: 'standards/coding-standards/guide.md',\n    });\n  }\n\n  // Generate integration docs for detected databases/services\n  if (frameworks.includes('Prisma') && !docExists('integrations/databases/prisma.md')) {\n    tasks.push({\n      directory: 'integrations/databases',\n      type: 'integration',\n      agentType: 'coder',\n      prompt: buildPrismaPrompt(context),\n      outputFile: 'integrations/databases/prisma.md',\n    });\n  }\n\n  // Generate SQLAlchemy docs for Python projects\n  if (frameworks.includes('SQLAlchemy') && !docExists('integrations/databases/sqlalchemy.md')) {\n    tasks.push({\n      directory: 'integrations/databases',\n      type: 'integration',\n      agentType: 'coder',\n      prompt: buildSQLAlchemyPrompt(context, modelFiles),\n      outputFile: 'integrations/databases/sqlalchemy.md',\n    });\n  }\n\n  // Generate FastAPI docs\n  if (frameworks.includes('FastAPI') && !docExists('services/api/fastapi.md')) {\n    tasks.push({\n      directory: 'services/api',\n      type: 'service',\n      agentType: 'coder',\n      prompt: buildFastAPIPrompt(context, serviceFiles),\n      outputFile: 'services/api/fastapi.md',\n    });\n  }\n\n  // Generate Flask docs\n  if (frameworks.includes('Flask') && !docExists('services/api/flask.md')) {\n    tasks.push({\n      directory: 'services/api',\n      type: 'service',\n      agentType: 'coder',\n      prompt: buildFlaskPrompt(context, serviceFiles),\n      outputFile: 'services/api/flask.md',\n    });\n  }\n\n  return tasks;\n}\n\n/**\n * Execute a single agent task\n */\nasync function executeAgentTask(\n  task: AgentTask,\n  context: GenerationContext,\n  verbose?: boolean\n): Promise<GeneratedDoc> {\n  const { docsPath } = context;\n  const outputPath = join(docsPath, task.outputFile);\n\n  // Try to use claude-flow if available, otherwise generate locally\n  const hasClaudeFlow = await checkClaudeFlowAvailable();\n\n  let content: string;\n\n  if (hasClaudeFlow) {\n    content = await executeWithClaudeFlow(task, context, verbose);\n  } else {\n    // Fallback to local template generation\n    content = generateLocalTemplate(task, context);\n  }\n\n  // Write the file\n  writeFileSync(outputPath, content, 'utf-8');\n\n  return {\n    path: task.outputFile,\n    title: extractTitle(content) || basename(task.outputFile, '.md'),\n    type: task.type,\n    generated: true,\n  };\n}\n\n/**\n * Check if claude-flow is available\n */\nasync function checkClaudeFlowAvailable(): Promise<boolean> {\n  return new Promise((resolve) => {\n    const proc = spawn('npx', ['claude-flow@alpha', '--version'], {\n      stdio: 'pipe',\n      shell: true,\n    });\n\n    proc.on('close', (code) => {\n      resolve(code === 0);\n    });\n\n    proc.on('error', () => {\n      resolve(false);\n    });\n\n    // Timeout after 5 seconds\n    setTimeout(() => {\n      proc.kill();\n      resolve(false);\n    }, 5000);\n  });\n}\n\n/**\n * Execute task using claude-flow expert agents\n */\nasync function executeWithClaudeFlow(\n  task: AgentTask,\n  context: GenerationContext,\n  verbose?: boolean\n): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const agentCmd = `npx claude-flow@alpha sparc run ${task.agentType} \"${task.prompt.replace(/\"/g, '\\\\\"')}\"`;\n\n    if (verbose) {\n      console.log(`\\n  Spawning ${task.agentType} agent for ${task.outputFile}...`);\n    }\n\n    const proc = spawn(agentCmd, {\n      shell: true,\n      cwd: context.projectRoot,\n      stdio: verbose ? 'inherit' : 'pipe',\n    });\n\n    let output = '';\n\n    if (proc.stdout) {\n      proc.stdout.on('data', (data) => {\n        output += data.toString();\n      });\n    }\n\n    proc.on('close', (code) => {\n      if (code === 0 && output) {\n        resolve(output);\n      } else {\n        // Fallback to local generation\n        resolve(generateLocalTemplate(task, context));\n      }\n    });\n\n    proc.on('error', () => {\n      resolve(generateLocalTemplate(task, context));\n    });\n\n    // Timeout after 60 seconds\n    setTimeout(() => {\n      proc.kill();\n      resolve(generateLocalTemplate(task, context));\n    }, 60000);\n  });\n}\n\n/**\n * Generate document using local templates (fallback)\n */\nfunction generateLocalTemplate(task: AgentTask, context: GenerationContext): string {\n  const date = new Date().toISOString().split('T')[0];\n  const { projectName } = context;\n\n  const templates: Record<string, string> = {\n    'concepts/architecture/overview.md': `---\ntitle: Architecture Overview\ntype: concept\nstatus: active\ntags: [architecture, overview]\ncreated: ${date}\n---\n\n# Architecture Overview\n\nHigh-level architecture documentation for ${projectName}.\n\n## System Overview\n\nThis document describes the overall architecture and design patterns used in ${projectName}.\n\n## Module Structure\n\n${context.sourceFiles.slice(0, 20).map(f => `- \\`${f}\\``).join('\\n')}\n\n## Key Patterns\n\n*Document key architectural patterns here*\n\n## Design Decisions\n\n*Add Architecture Decision Records (ADRs)*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'components/ui/overview.md': `---\ntitle: UI Components Overview\ntype: technical\nstatus: active\ntags: [components, ui]\ncreated: ${date}\n---\n\n# UI Components\n\nUser interface components for ${projectName}.\n\n## Component Library\n\n${context.frameworks.includes('React') ? 'Built with **React**.' : ''}\n${context.frameworks.includes('Vue') ? 'Built with **Vue**.' : ''}\n\n## Available Components\n\n*Document available UI components*\n\n## Usage Patterns\n\n*Add component usage examples*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'services/api/overview.md': `---\ntitle: API Services Overview\ntype: service\nstatus: active\ntags: [api, services]\ncreated: ${date}\n---\n\n# API Services\n\nBackend API services for ${projectName}.\n\n## Endpoints\n\n*Document API endpoints*\n\n## Authentication\n\n*Document authentication flow*\n\n## Error Handling\n\n*Document error handling patterns*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'components/utilities/overview.md': `---\ntitle: Utilities Overview\ntype: technical\nstatus: active\ntags: [utilities, helpers]\ncreated: ${date}\n---\n\n# Utility Functions\n\nReusable utilities and helpers for ${projectName}.\n\n## Available Utilities\n\n*Document available utilities*\n\n## Usage Examples\n\n*Add code examples*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'guides/getting-started/quick-start.md': `---\ntitle: Quick Start Guide\ntype: guide\nstatus: active\ntags: [guide, getting-started]\ncreated: ${date}\n---\n\n# Quick Start\n\nGet up and running with ${projectName}.\n\n## Prerequisites\n\n${context.languages.map(l => `- ${l}`).join('\\n')}\n\n## Installation\n\n\\`\\`\\`bash\nnpm install\n\\`\\`\\`\n\n## Basic Usage\n\n*Add basic usage instructions*\n\n## Next Steps\n\n- [[concepts/architecture/overview|Architecture Overview]]\n- [[guides/_MOC|More Guides]]\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'standards/coding-standards/guide.md': `---\ntitle: Coding Standards\ntype: standard\nstatus: active\ntags: [standards, coding]\ncreated: ${date}\n---\n\n# Coding Standards\n\nCode style and conventions for ${projectName}.\n\n## Language Standards\n\n${context.languages.map(l => `### ${l}\\n\\n*Add ${l} specific standards*`).join('\\n\\n')}\n\n## Linting Configuration\n\n*Document ESLint/Prettier setup*\n\n## Best Practices\n\n*Add coding best practices*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'integrations/databases/prisma.md': `---\ntitle: Prisma Integration\ntype: integration\nstatus: active\ntags: [prisma, database, orm]\ncreated: ${date}\n---\n\n# Prisma Integration\n\nDatabase ORM configuration for ${projectName}.\n\n## Schema Location\n\n\\`prisma/schema.prisma\\`\n\n## Models\n\n*Document database models*\n\n## Migrations\n\n\\`\\`\\`bash\nnpx prisma migrate dev\n\\`\\`\\`\n\n## Client Usage\n\n*Add Prisma client usage examples*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'integrations/databases/sqlalchemy.md': `---\ntitle: SQLAlchemy Integration\ntype: integration\nstatus: active\ntags: [sqlalchemy, database, orm, python]\ncreated: ${date}\n---\n\n# SQLAlchemy Integration\n\nDatabase ORM configuration for ${projectName}.\n\n## Models\n\n*Document your SQLAlchemy models*\n\n## Database Connection\n\n\\`\\`\\`python\nfrom sqlalchemy import create_engine\nfrom sqlalchemy.orm import sessionmaker\n\nengine = create_engine(DATABASE_URL)\nSession = sessionmaker(bind=engine)\n\\`\\`\\`\n\n## Migrations (Alembic)\n\n\\`\\`\\`bash\nalembic upgrade head\n\\`\\`\\`\n\n## Query Examples\n\n*Add common query patterns*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'services/api/fastapi.md': `---\ntitle: FastAPI Service\ntype: service\nstatus: active\ntags: [fastapi, api, python]\ncreated: ${date}\n---\n\n# FastAPI Service\n\nAPI service documentation for ${projectName}.\n\n## Running the Server\n\n\\`\\`\\`bash\nuvicorn main:app --reload\n\\`\\`\\`\n\n## API Endpoints\n\n*Document your API endpoints*\n\n## Authentication\n\n*Document authentication flow*\n\n## Request/Response Schemas\n\n*Document Pydantic models*\n\n---\n> Auto-generated by kg-agent\n`,\n\n    'services/api/flask.md': `---\ntitle: Flask Service\ntype: service\nstatus: active\ntags: [flask, api, python]\ncreated: ${date}\n---\n\n# Flask Service\n\nAPI service documentation for ${projectName}.\n\n## Running the Server\n\n\\`\\`\\`bash\nflask run\n\\`\\`\\`\n\n## Routes\n\n*Document your Flask routes*\n\n## Blueprints\n\n*Document blueprints structure*\n\n## Error Handling\n\n*Document error handling patterns*\n\n---\n> Auto-generated by kg-agent\n`,\n  };\n\n  return templates[task.outputFile] || generateGenericTemplate(task, context, date);\n}\n\n/**\n * Generate a generic template for unknown task types\n */\nfunction generateGenericTemplate(\n  task: AgentTask,\n  context: GenerationContext,\n  date: string\n): string {\n  const title = basename(task.outputFile, '.md')\n    .split('-')\n    .map(w => w.charAt(0).toUpperCase() + w.slice(1))\n    .join(' ');\n\n  return `---\ntitle: ${title}\ntype: ${task.type}\nstatus: draft\ntags: [${task.type}]\ncreated: ${date}\n---\n\n# ${title}\n\nDocumentation for ${context.projectName}.\n\n## Overview\n\n*Add overview content*\n\n## Details\n\n*Add detailed documentation*\n\n---\n> Auto-generated by kg-agent\n`;\n}\n\n/**\n * Extract title from markdown content\n */\nfunction extractTitle(content: string): string | null {\n  const match = content.match(/^#\\s+(.+)$/m);\n  return match ? match[1] : null;\n}\n\n// Prompt builders\n\nfunction buildArchitecturePrompt(context: GenerationContext, dirs: string[]): string {\n  return `Analyze the architecture of ${context.projectName}.\nModules: ${dirs.join(', ')}.\nLanguages: ${context.languages.join(', ')}.\nGenerate an Architecture Overview markdown document with system design, patterns, and key decisions.`;\n}\n\nfunction buildComponentPrompt(context: GenerationContext, files: string[]): string {\n  return `Document the UI components in ${context.projectName}.\nFrameworks: ${context.frameworks.join(', ')}.\nComponent files: ${files.join(', ')}.\nGenerate a Components Overview markdown document.`;\n}\n\nfunction buildServicePrompt(context: GenerationContext, files: string[]): string {\n  return `Document the API services in ${context.projectName}.\nService files: ${files.join(', ')}.\nGenerate an API Services Overview markdown document with endpoints and patterns.`;\n}\n\nfunction buildUtilityPrompt(context: GenerationContext, files: string[]): string {\n  return `Document utility functions in ${context.projectName}.\nUtility files: ${files.join(', ')}.\nGenerate a Utilities Overview markdown document.`;\n}\n\nfunction buildGettingStartedPrompt(context: GenerationContext): string {\n  return `Create a Quick Start guide for ${context.projectName}.\nLanguages: ${context.languages.join(', ')}.\nFrameworks: ${context.frameworks.join(', ')}.\nGenerate a Getting Started guide with installation and basic usage.`;\n}\n\nfunction buildCodingStandardsPrompt(\n  context: GenerationContext,\n  hasTypescript: boolean,\n  hasLinting: boolean\n): string {\n  return `Document coding standards for ${context.projectName}.\nTypeScript: ${hasTypescript ? 'yes' : 'no'}.\nESLint: ${hasLinting ? 'yes' : 'no'}.\nGenerate a Coding Standards guide with style rules and best practices.`;\n}\n\nfunction buildPrismaPrompt(context: GenerationContext): string {\n  return `Document Prisma database integration for ${context.projectName}.\nGenerate integration documentation with schema, models, and usage patterns.`;\n}\n\nfunction buildSQLAlchemyPrompt(context: GenerationContext, modelFiles: string[]): string {\n  return `Document SQLAlchemy database integration for ${context.projectName}.\nModel files: ${modelFiles.slice(0, 10).join(', ')}.\nGenerate integration documentation with models, relationships, and query patterns.`;\n}\n\nfunction buildFastAPIPrompt(context: GenerationContext, serviceFiles: string[]): string {\n  return `Document FastAPI API service for ${context.projectName}.\nAPI files: ${serviceFiles.slice(0, 10).join(', ')}.\nGenerate API documentation with endpoints, request/response schemas, and authentication.`;\n}\n\nfunction buildFlaskPrompt(context: GenerationContext, serviceFiles: string[]): string {\n  return `Document Flask API service for ${context.projectName}.\nRoute files: ${serviceFiles.slice(0, 10).join(', ')}.\nGenerate API documentation with routes, blueprints, and request handling.`;\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weavelogic/knowledge-graph-agent",
-  "version": "0.8.6",
+  "version": "0.8.8",
   "description": "Knowledge graph agent for Claude Code - generates knowledge graphs, initializes docs, and integrates with claude-flow",
   "type": "module",
   "main": "dist/index.js",