@know-graph/cli 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +47 -0
  3. package/dist/commands/coverage.d.ts +3 -0
  4. package/dist/commands/coverage.d.ts.map +1 -0
  5. package/dist/commands/coverage.js +98 -0
  6. package/dist/commands/coverage.js.map +1 -0
  7. package/dist/commands/export.d.ts +7 -0
  8. package/dist/commands/export.d.ts.map +1 -0
  9. package/dist/commands/export.js +193 -0
  10. package/dist/commands/export.js.map +1 -0
  11. package/dist/commands/hook.d.ts +30 -0
  12. package/dist/commands/hook.d.ts.map +1 -0
  13. package/dist/commands/hook.js +224 -0
  14. package/dist/commands/hook.js.map +1 -0
  15. package/dist/commands/index-cmd.d.ts +3 -0
  16. package/dist/commands/index-cmd.d.ts.map +1 -0
  17. package/dist/commands/index-cmd.js +96 -0
  18. package/dist/commands/index-cmd.js.map +1 -0
  19. package/dist/commands/index.d.ts +12 -0
  20. package/dist/commands/index.d.ts.map +1 -0
  21. package/dist/commands/index.js +12 -0
  22. package/dist/commands/index.js.map +1 -0
  23. package/dist/commands/init.d.ts +3 -0
  24. package/dist/commands/init.d.ts.map +1 -0
  25. package/dist/commands/init.js +105 -0
  26. package/dist/commands/init.js.map +1 -0
  27. package/dist/commands/parse.d.ts +3 -0
  28. package/dist/commands/parse.d.ts.map +1 -0
  29. package/dist/commands/parse.js +130 -0
  30. package/dist/commands/parse.js.map +1 -0
  31. package/dist/commands/query.d.ts +3 -0
  32. package/dist/commands/query.d.ts.map +1 -0
  33. package/dist/commands/query.js +74 -0
  34. package/dist/commands/query.js.map +1 -0
  35. package/dist/commands/serve.d.ts +3 -0
  36. package/dist/commands/serve.d.ts.map +1 -0
  37. package/dist/commands/serve.js +56 -0
  38. package/dist/commands/serve.js.map +1 -0
  39. package/dist/commands/suggest.d.ts +3 -0
  40. package/dist/commands/suggest.d.ts.map +1 -0
  41. package/dist/commands/suggest.js +79 -0
  42. package/dist/commands/suggest.js.map +1 -0
  43. package/dist/commands/sync.d.ts +5 -0
  44. package/dist/commands/sync.d.ts.map +1 -0
  45. package/dist/commands/sync.js +151 -0
  46. package/dist/commands/sync.js.map +1 -0
  47. package/dist/commands/validate.d.ts +3 -0
  48. package/dist/commands/validate.d.ts.map +1 -0
  49. package/dist/commands/validate.js +81 -0
  50. package/dist/commands/validate.js.map +1 -0
  51. package/dist/index.d.ts +3 -0
  52. package/dist/index.d.ts.map +1 -0
  53. package/dist/index.js +32 -0
  54. package/dist/index.js.map +1 -0
  55. package/dist/utils/detect.d.ts +3 -0
  56. package/dist/utils/detect.d.ts.map +1 -0
  57. package/dist/utils/detect.js +153 -0
  58. package/dist/utils/detect.js.map +1 -0
  59. package/dist/utils/format.d.ts +16 -0
  60. package/dist/utils/format.d.ts.map +1 -0
  61. package/dist/utils/format.js +37 -0
  62. package/dist/utils/format.js.map +1 -0
  63. package/dist/utils/index.d.ts +3 -0
  64. package/dist/utils/index.d.ts.map +1 -0
  65. package/dist/utils/index.js +3 -0
  66. package/dist/utils/index.js.map +1 -0
  67. package/package.json +62 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerIndexCommand(program: Command): void;
3
+ //# sourceMappingURL=index-cmd.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-cmd.d.ts","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2GzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgB3D"}
@@ -0,0 +1,96 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: CLI command that builds the SQLite code graph index from annotated source files
5
+ * owner: knowgraph-cli
6
+ * status: stable
7
+ * tags: [cli, command, index, build]
8
+ * context:
9
+ * business_goal: Enable developers to build a searchable code knowledge graph
10
+ * domain: cli
11
+ */
12
+ import { mkdirSync } from 'node:fs';
13
+ import { resolve, join } from 'node:path';
14
+ import chalk from 'chalk';
15
+ import ora from 'ora';
16
+ import { createDefaultRegistry, createDatabaseManager, createIndexer, } from '@know-graph/core';
17
+ function createParserRegistryAdapter(coreRegistry) {
18
+ return {
19
+ parse(filePath, content) {
20
+ return coreRegistry.parseFile(content, filePath);
21
+ },
22
+ canParse(filePath) {
23
+ return coreRegistry.getParser(filePath) !== undefined;
24
+ },
25
+ };
26
+ }
27
+ function runIndex(targetPath, options) {
28
+ const rootDir = resolve(targetPath);
29
+ const outputDir = resolve(options.output);
30
+ const dbPath = join(outputDir, 'knowgraph.db');
31
+ mkdirSync(outputDir, { recursive: true });
32
+ const spinner = ora('Initializing indexer...').start();
33
+ try {
34
+ const coreRegistry = createDefaultRegistry();
35
+ const registryAdapter = createParserRegistryAdapter(coreRegistry);
36
+ const dbManager = createDatabaseManager(dbPath);
37
+ dbManager.initialize();
38
+ const indexer = createIndexer(registryAdapter, dbManager);
39
+ const excludePatterns = options.exclude
40
+ ? options.exclude.split(',').map((p) => p.trim())
41
+ : ['node_modules', '.git', 'dist', 'build'];
42
+ const onProgress = (progress) => {
43
+ const pct = progress.totalFiles > 0
44
+ ? Math.round((progress.processedFiles / progress.totalFiles) * 100)
45
+ : 0;
46
+ spinner.text = `Indexing: ${pct}% (${progress.processedFiles}/${progress.totalFiles}) ${progress.currentFile}`;
47
+ if (options.verbose && progress.currentFile) {
48
+ spinner.text += `\n Entities found: ${progress.entitiesFound}`;
49
+ }
50
+ };
51
+ const result = indexer.index({
52
+ rootDir,
53
+ exclude: excludePatterns,
54
+ incremental: options.incremental,
55
+ onProgress,
56
+ });
57
+ dbManager.close();
58
+ spinner.succeed(chalk.green('Indexing complete!'));
59
+ console.log('');
60
+ console.log(chalk.bold('Summary:'));
61
+ console.log(` Files scanned: ${chalk.cyan(String(result.totalFiles))}`);
62
+ console.log(` Entities indexed: ${chalk.cyan(String(result.totalEntities))}`);
63
+ console.log(` Relationships: ${chalk.cyan(String(result.totalRelationships))}`);
64
+ console.log(` Duration: ${chalk.cyan(`${result.duration}ms`)}`);
65
+ console.log(` Database: ${chalk.cyan(dbPath)}`);
66
+ if (result.errors.length > 0) {
67
+ console.log('');
68
+ console.log(chalk.yellow(`${result.errors.length} error(s) during indexing:`));
69
+ for (const err of result.errors.slice(0, 10)) {
70
+ console.log(chalk.yellow(` ${err.filePath}: ${err.message}`));
71
+ }
72
+ if (result.errors.length > 10) {
73
+ console.log(chalk.yellow(` ... and ${result.errors.length - 10} more`));
74
+ }
75
+ }
76
+ }
77
+ catch (err) {
78
+ spinner.fail(chalk.red('Indexing failed'));
79
+ console.error(chalk.red(err instanceof Error ? err.message : String(err)));
80
+ process.exitCode = 1;
81
+ }
82
+ }
83
+ export function registerIndexCommand(program) {
84
+ program
85
+ .command('index [path]')
86
+ .description('Scan repository and build the SQLite index')
87
+ .option('--output <dir>', 'Output directory', '.knowgraph')
88
+ .option('--exclude <patterns>', 'Comma-separated glob patterns to exclude')
89
+ .option('--incremental', 'Only re-index changed files (default: true)', true)
90
+ .option('--no-incremental', 'Force full re-index')
91
+ .option('--verbose', 'Show detailed progress')
92
+ .action((path, options) => {
93
+ runIndex(path ?? '.', options);
94
+ });
95
+ }
96
+ //# sourceMappingURL=index-cmd.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index-cmd.js","sourceRoot":"","sources":["../../src/commands/index-cmd.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ export { registerParseCommand } from './parse.js';
2
+ export { registerIndexCommand } from './index-cmd.js';
3
+ export { registerQueryCommand } from './query.js';
4
+ export { registerServeCommand } from './serve.js';
5
+ export { registerInitCommand } from './init.js';
6
+ export { registerValidateCommand } from './validate.js';
7
+ export { registerCoverageCommand } from './coverage.js';
8
+ export { registerSuggestCommand } from './suggest.js';
9
+ export { registerHookCommand } from './hook.js';
10
+ export { registerExportCommand } from './export.js';
11
+ export { registerSyncCommand } from './sync.js';
12
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,12 @@
1
+ export { registerParseCommand } from './parse.js';
2
+ export { registerIndexCommand } from './index-cmd.js';
3
+ export { registerQueryCommand } from './query.js';
4
+ export { registerServeCommand } from './serve.js';
5
+ export { registerInitCommand } from './init.js';
6
+ export { registerValidateCommand } from './validate.js';
7
+ export { registerCoverageCommand } from './coverage.js';
8
+ export { registerSuggestCommand } from './suggest.js';
9
+ export { registerHookCommand } from './hook.js';
10
+ export { registerExportCommand } from './export.js';
11
+ export { registerSyncCommand } from './sync.js';
12
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerInitCommand(program: Command): void;
3
+ //# sourceMappingURL=init.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoGzC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS1D"}
@@ -0,0 +1,105 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: CLI command that initializes a new .knowgraph.yml project configuration
5
+ * owner: knowgraph-cli
6
+ * status: stable
7
+ * tags: [cli, command, init, setup]
8
+ * context:
9
+ * business_goal: Provide guided onboarding for new KnowGraph users
10
+ * domain: cli
11
+ */
12
+ import { writeFileSync, existsSync } from 'node:fs';
13
+ import { resolve, basename } from 'node:path';
14
+ import chalk from 'chalk';
15
+ import { stringify } from 'yaml';
16
+ import { detectLanguages, suggestFiles } from '../utils/detect.js';
17
+ function generateManifest(projectName, languages) {
18
+ return {
19
+ version: '1.0',
20
+ name: projectName,
21
+ languages: [...languages],
22
+ include: ['**/*'],
23
+ exclude: ['node_modules', '.git', 'dist', 'build', '__pycache__'],
24
+ index: {
25
+ output_dir: '.knowgraph',
26
+ incremental: true,
27
+ },
28
+ };
29
+ }
30
+ async function runInit(options) {
31
+ const dir = resolve('.');
32
+ const configPath = resolve('.knowgraph.yml');
33
+ if (existsSync(configPath) && !options.yes) {
34
+ console.log(chalk.yellow('.knowgraph.yml already exists. Use -y to overwrite.'));
35
+ return;
36
+ }
37
+ console.log(chalk.bold('Initializing KnowGraph...'));
38
+ console.log('');
39
+ // Step 1: Detect languages
40
+ const languages = detectLanguages(dir);
41
+ if (languages.length > 0) {
42
+ console.log(`Detected languages: ${chalk.cyan(languages.join(', '))}`);
43
+ }
44
+ else {
45
+ console.log(chalk.yellow('No supported languages detected.'));
46
+ }
47
+ // Step 2: Determine project name
48
+ let projectName;
49
+ if (options.name) {
50
+ projectName = options.name;
51
+ }
52
+ else if (options.yes) {
53
+ projectName = basename(dir);
54
+ }
55
+ else {
56
+ // Use inquirer for interactive input
57
+ try {
58
+ const { default: inquirer } = await import('inquirer');
59
+ const answer = await inquirer.prompt([
60
+ {
61
+ type: 'input',
62
+ name: 'name',
63
+ message: 'Project name:',
64
+ default: basename(dir),
65
+ },
66
+ ]);
67
+ projectName = answer.name;
68
+ }
69
+ catch {
70
+ projectName = basename(dir);
71
+ }
72
+ }
73
+ // Step 3: Generate .knowgraph.yml
74
+ const manifest = generateManifest(projectName, languages);
75
+ const yamlContent = stringify(manifest);
76
+ writeFileSync(configPath, yamlContent, 'utf-8');
77
+ console.log(`\nCreated ${chalk.green('.knowgraph.yml')}`);
78
+ // Step 4: Suggest high-impact files
79
+ const suggested = suggestFiles(dir);
80
+ if (suggested.length > 0) {
81
+ console.log('');
82
+ console.log(chalk.bold('Suggested files to annotate first:'));
83
+ for (const file of suggested.slice(0, 5)) {
84
+ console.log(` ${chalk.cyan(file)}`);
85
+ }
86
+ }
87
+ // Step 5: Next steps
88
+ console.log('');
89
+ console.log(chalk.bold('Next steps:'));
90
+ console.log(` 1. Add ${chalk.cyan('@knowgraph')} annotations to your code`);
91
+ console.log(` 2. Run ${chalk.cyan('knowgraph index')} to build the graph`);
92
+ console.log(` 3. Run ${chalk.cyan('knowgraph serve')} to start the MCP server`);
93
+ console.log(` 4. Run ${chalk.cyan('knowgraph query <term>')} to search`);
94
+ }
95
+ export function registerInitCommand(program) {
96
+ program
97
+ .command('init')
98
+ .description('Initialize KnowGraph in the current directory')
99
+ .option('--name <name>', 'Project name')
100
+ .option('-y, --yes', 'Non-interactive mode, use defaults')
101
+ .action((options) => {
102
+ runInit(options);
103
+ });
104
+ }
105
+ //# sourceMappingURL=init.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOnE,SAAS,gBAAgB,CACvB,WAAmB,EACnB,SAA4B;IAE5B,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC;QACzB,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC;QACjE,KAAK,EAAE;YACL,UAAU,EAAE,YAAY;YACxB,WAAW,EAAE,IAAI;SAClB;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAAoB;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACzB,MAAM,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE7C,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,MAAM,CAAC,qDAAqD,CAAC,CACpE,CAAC;QACF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,2BAA2B;IAC3B,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,iCAAiC;IACjC,IAAI,WAAmB,CAAC;IACxB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7B,CAAC;SAAM,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACvB,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;gBACnC;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,eAAe;oBACxB,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC;iBACvB;aACF,CAAC,CAAC;YACH,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IACxC,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAE1D,oCAAoC;IACpC,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAC7E,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,CACT,YAAY,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,0BAA0B,CACpE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,YAAY,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,eAAe,EAAE,cAAc,CAAC;SACvC,MAAM,CAAC,WAAW,EAAE,oCAAoC,CAAC;SACzD,MAAM,CAAC,CAAC,OAAoB,EAAE,EAAE;QAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerParseCommand(program: Command): void;
3
+ //# sourceMappingURL=parse.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/commands/parse.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0IzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAW3D"}
@@ -0,0 +1,130 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: CLI command that parses source files and displays extracted @knowgraph annotations
5
+ * owner: knowgraph-cli
6
+ * status: stable
7
+ * tags: [cli, command, parse, output]
8
+ * context:
9
+ * business_goal: Let developers preview annotations before indexing
10
+ * domain: cli
11
+ */
12
+ import { readFileSync, statSync, readdirSync } from 'node:fs';
13
+ import { join, resolve, extname } from 'node:path';
14
+ import chalk from 'chalk';
15
+ import { createDefaultRegistry } from '@know-graph/core';
16
+ import { formatJson } from '../utils/format.js';
17
+ function collectFilePaths(targetPath) {
18
+ const stat = statSync(targetPath);
19
+ if (stat.isFile()) {
20
+ return [targetPath];
21
+ }
22
+ if (!stat.isDirectory()) {
23
+ return [];
24
+ }
25
+ const skipDirs = new Set([
26
+ 'node_modules',
27
+ '.git',
28
+ 'dist',
29
+ 'build',
30
+ '__pycache__',
31
+ '.venv',
32
+ 'venv',
33
+ 'coverage',
34
+ ]);
35
+ const results = [];
36
+ function walk(dir) {
37
+ const entries = readdirSync(dir);
38
+ for (const entry of entries) {
39
+ if (entry.startsWith('.') || skipDirs.has(entry))
40
+ continue;
41
+ const fullPath = join(dir, entry);
42
+ const s = statSync(fullPath);
43
+ if (s.isDirectory()) {
44
+ walk(fullPath);
45
+ }
46
+ else if (s.isFile()) {
47
+ results.push(fullPath);
48
+ }
49
+ }
50
+ }
51
+ walk(targetPath);
52
+ return results;
53
+ }
54
+ function runParse(targetPath, options) {
55
+ const absPath = resolve(targetPath);
56
+ try {
57
+ statSync(absPath);
58
+ }
59
+ catch {
60
+ console.error(chalk.red(`Error: Path not found: ${absPath}`));
61
+ process.exitCode = 1;
62
+ return;
63
+ }
64
+ const registry = createDefaultRegistry();
65
+ const files = collectFilePaths(absPath);
66
+ const allResults = [];
67
+ let fileCount = 0;
68
+ for (const filePath of files) {
69
+ const ext = extname(filePath);
70
+ const parsable = ['.py', '.ts', '.tsx', '.js', '.jsx'];
71
+ if (!parsable.includes(ext) && !options.language)
72
+ continue;
73
+ try {
74
+ const content = readFileSync(filePath, 'utf-8');
75
+ const results = registry.parseFile(content, filePath);
76
+ if (results.length > 0) {
77
+ fileCount++;
78
+ allResults.push(...results);
79
+ }
80
+ }
81
+ catch (err) {
82
+ console.error(chalk.yellow(`Warning: Could not parse ${filePath}: ${err instanceof Error ? err.message : String(err)}`));
83
+ }
84
+ }
85
+ if (options.validate) {
86
+ let hasErrors = false;
87
+ for (const result of allResults) {
88
+ if (!result.metadata.description) {
89
+ console.error(chalk.red(`Validation error in ${result.filePath}:${result.line} - ${result.name}: missing description`));
90
+ hasErrors = true;
91
+ }
92
+ }
93
+ if (hasErrors) {
94
+ process.exitCode = 1;
95
+ }
96
+ }
97
+ if (options.format === 'yaml') {
98
+ // Dynamic import for yaml since it's optional
99
+ import('yaml')
100
+ .then((yamlModule) => {
101
+ console.log(yamlModule.stringify(allResults));
102
+ printSummary(allResults.length, fileCount);
103
+ })
104
+ .catch(() => {
105
+ console.error(chalk.red('Error: yaml package not installed. Use --format json or install yaml.'));
106
+ process.exitCode = 1;
107
+ });
108
+ }
109
+ else {
110
+ const pretty = options.pretty ?? false;
111
+ console.log(formatJson(allResults, pretty));
112
+ printSummary(allResults.length, fileCount);
113
+ }
114
+ }
115
+ function printSummary(entityCount, fileCount) {
116
+ console.error(chalk.green(`\nFound ${chalk.bold(String(entityCount))} entities in ${chalk.bold(String(fileCount))} files`));
117
+ }
118
+ export function registerParseCommand(program) {
119
+ program
120
+ .command('parse <path>')
121
+ .description('Parse a file or directory for knowgraph annotations')
122
+ .option('--format <format>', 'Output format (json|yaml)', 'json')
123
+ .option('--validate', 'Validate metadata against schema')
124
+ .option('--language <lang>', 'Override language auto-detection')
125
+ .option('--pretty', 'Pretty-print output')
126
+ .action((path, options) => {
127
+ runParse(path, options);
128
+ });
129
+ }
130
+ //# sourceMappingURL=parse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/commands/parse.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerQueryCommand(program: Command): void;
3
+ //# sourceMappingURL=query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa3D"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: CLI command for searching the code graph with filters and formatted output
5
+ * owner: knowgraph-cli
6
+ * status: stable
7
+ * tags: [cli, command, query, search]
8
+ * context:
9
+ * business_goal: Provide terminal-based code graph search for developers
10
+ * domain: cli
11
+ */
12
+ import { resolve } from 'node:path';
13
+ import chalk from 'chalk';
14
+ import { createDatabaseManager, createQueryEngine } from '@know-graph/core';
15
+ import { formatTable, formatJson } from '../utils/format.js';
16
+ function runQuery(searchTerm, options) {
17
+ const dbPath = resolve(options.db);
18
+ let dbManager;
19
+ try {
20
+ dbManager = createDatabaseManager(dbPath);
21
+ }
22
+ catch {
23
+ console.error(chalk.red(`Error: Could not open database at ${dbPath}`));
24
+ console.error(chalk.yellow("Run 'knowgraph index' first to create the database."));
25
+ process.exitCode = 1;
26
+ return;
27
+ }
28
+ try {
29
+ const engine = createQueryEngine(dbManager);
30
+ const tags = options.tags
31
+ ? options.tags.split(',').map((t) => t.trim())
32
+ : undefined;
33
+ const result = engine.search({
34
+ query: searchTerm,
35
+ type: options.type,
36
+ owner: options.owner,
37
+ tags,
38
+ limit: parseInt(options.limit, 10),
39
+ });
40
+ if (result.entities.length === 0) {
41
+ console.log(chalk.yellow('No results found.'));
42
+ return;
43
+ }
44
+ if (options.format === 'json') {
45
+ console.log(formatJson(result.entities, true));
46
+ }
47
+ else {
48
+ console.log(formatTable(result.entities));
49
+ }
50
+ console.error(chalk.dim(`\nShowing ${result.entities.length} of ${result.total} results`));
51
+ }
52
+ catch (err) {
53
+ console.error(chalk.red(`Query failed: ${err instanceof Error ? err.message : String(err)}`));
54
+ process.exitCode = 1;
55
+ }
56
+ finally {
57
+ dbManager.close();
58
+ }
59
+ }
60
+ export function registerQueryCommand(program) {
61
+ program
62
+ .command('query <search-term>')
63
+ .description('Search the code graph')
64
+ .option('--type <type>', 'Filter by entity type')
65
+ .option('--owner <owner>', 'Filter by owner')
66
+ .option('--tags <tags>', 'Comma-separated tag filter')
67
+ .option('--format <format>', 'Output format (json|table)', 'table')
68
+ .option('--limit <n>', 'Max results', '20')
69
+ .option('--db <path>', 'Database path', '.knowgraph/knowgraph.db')
70
+ .action((searchTerm, options) => {
71
+ runQuery(searchTerm, options);
72
+ });
73
+ }
74
+ //# sourceMappingURL=query.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/commands/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAW7D,SAAS,QAAQ,CAAC,UAAkB,EAAE,OAA4B;IAChE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEnC,IAAI,SAAS,CAAC;IACd,IAAI,CAAC;QACH,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CAAC,qDAAqD,CAAC,CACpE,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI;YACvB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9C,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC3B,KAAK,EAAE,UAAU;YACjB,IAAI,EAAE,OAAO,CAAC,IAA8B;YAC5C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI;YACJ,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,aAAa,MAAM,CAAC,QAAQ,CAAC,MAAM,OAAO,MAAM,CAAC,KAAK,UAAU,CACjE,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACpE,CACF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,uBAAuB,CAAC;SACpC,MAAM,CAAC,eAAe,EAAE,uBAAuB,CAAC;SAChD,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;SAC5C,MAAM,CAAC,eAAe,EAAE,4BAA4B,CAAC;SACrD,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,EAAE,OAAO,CAAC;SAClE,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;SAC1C,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,yBAAyB,CAAC;SACjE,MAAM,CAAC,CAAC,UAAkB,EAAE,OAA4B,EAAE,EAAE;QAC3D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerServeCommand(program: Command): void;
3
+ //# sourceMappingURL=serve.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwDzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS3D"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * @knowgraph
3
+ * type: module
4
+ * description: CLI command that starts the MCP server for AI agent integration
5
+ * owner: knowgraph-cli
6
+ * status: stable
7
+ * tags: [cli, command, serve, mcp]
8
+ * context:
9
+ * business_goal: Enable AI assistants to query the code graph via MCP protocol
10
+ * domain: cli
11
+ */
12
+ import { resolve } from 'node:path';
13
+ import { existsSync } from 'node:fs';
14
+ import chalk from 'chalk';
15
+ async function runServe(options) {
16
+ const dbPath = resolve(options.db);
17
+ if (!existsSync(dbPath)) {
18
+ console.error(chalk.red(`Error: Database not found at ${dbPath}`));
19
+ console.error(chalk.yellow("Run 'knowgraph index' first to create the database."));
20
+ process.exitCode = 1;
21
+ return;
22
+ }
23
+ console.log(chalk.bold('Starting KnowGraph MCP server...'));
24
+ console.log(` Database: ${chalk.cyan(dbPath)}`);
25
+ console.log('');
26
+ console.log(chalk.dim('Add this to your Claude Desktop config:'));
27
+ console.log('');
28
+ console.log(chalk.dim(JSON.stringify({
29
+ mcpServers: {
30
+ knowgraph: {
31
+ command: 'npx',
32
+ args: ['knowgraph', 'serve', '--db', dbPath],
33
+ },
34
+ },
35
+ }, null, 2)));
36
+ console.log('');
37
+ try {
38
+ const { startServer } = await import('@know-graph/mcp-server');
39
+ await startServer({ dbPath, verbose: options.verbose });
40
+ }
41
+ catch (err) {
42
+ console.error(chalk.red(`Failed to start MCP server: ${err instanceof Error ? err.message : String(err)}`));
43
+ process.exitCode = 1;
44
+ }
45
+ }
46
+ export function registerServeCommand(program) {
47
+ program
48
+ .command('serve')
49
+ .description('Start the MCP server')
50
+ .option('--db <path>', 'Database path', '.knowgraph/knowgraph.db')
51
+ .option('--verbose', 'Enable verbose logging')
52
+ .action((options) => {
53
+ runServe(options);
54
+ });
55
+ }
56
+ //# sourceMappingURL=serve.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"serve.js","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,KAAK,UAAU,QAAQ,CAAC,OAAqB;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gCAAgC,MAAM,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,MAAM,CAAC,qDAAqD,CAAC,CACpE,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,IAAI,CAAC,SAAS,CACZ;QACE,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;aAC7C;SACF;KACF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CACF,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;QAC/D,MAAM,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CACP,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAClF,CACF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sBAAsB,CAAC;SACnC,MAAM,CAAC,aAAa,EAAE,eAAe,EAAE,yBAAyB,CAAC;SACjE,MAAM,CAAC,WAAW,EAAE,wBAAwB,CAAC;SAC7C,MAAM,CAAC,CAAC,OAAqB,EAAE,EAAE;QAChC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerSuggestCommand(program: Command): void;
3
+ //# sourceMappingURL=suggest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/commands/suggest.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiFzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAW7D"}