pindex 1.0.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 (139) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +767 -0
  3. package/dist/cli/daemon.d.ts +13 -0
  4. package/dist/cli/daemon.d.ts.map +1 -0
  5. package/dist/cli/daemon.js +70 -0
  6. package/dist/cli/daemon.js.map +1 -0
  7. package/dist/cli/index.d.ts +4 -0
  8. package/dist/cli/index.d.ts.map +1 -0
  9. package/dist/cli/index.js +212 -0
  10. package/dist/cli/index.js.map +1 -0
  11. package/dist/cli/init.d.ts +44 -0
  12. package/dist/cli/init.d.ts.map +1 -0
  13. package/dist/cli/init.js +301 -0
  14. package/dist/cli/init.js.map +1 -0
  15. package/dist/cli/project-detector.d.ts +44 -0
  16. package/dist/cli/project-detector.d.ts.map +1 -0
  17. package/dist/cli/project-detector.js +144 -0
  18. package/dist/cli/project-detector.js.map +1 -0
  19. package/dist/cli/setup.d.ts +9 -0
  20. package/dist/cli/setup.d.ts.map +1 -0
  21. package/dist/cli/setup.js +110 -0
  22. package/dist/cli/setup.js.map +1 -0
  23. package/dist/db/database.d.ts +5 -0
  24. package/dist/db/database.d.ts.map +1 -0
  25. package/dist/db/database.js +19 -0
  26. package/dist/db/database.js.map +1 -0
  27. package/dist/db/migrations.d.ts +6 -0
  28. package/dist/db/migrations.d.ts.map +1 -0
  29. package/dist/db/migrations.js +32 -0
  30. package/dist/db/migrations.js.map +1 -0
  31. package/dist/db/queries.d.ts +132 -0
  32. package/dist/db/queries.d.ts.map +1 -0
  33. package/dist/db/queries.js +222 -0
  34. package/dist/db/queries.js.map +1 -0
  35. package/dist/db/schema.d.ts +5 -0
  36. package/dist/db/schema.d.ts.map +1 -0
  37. package/dist/db/schema.js +179 -0
  38. package/dist/db/schema.js.map +1 -0
  39. package/dist/gui/index.d.ts +3 -0
  40. package/dist/gui/index.d.ts.map +1 -0
  41. package/dist/gui/index.js +56 -0
  42. package/dist/gui/index.js.map +1 -0
  43. package/dist/gui/server.d.ts +31 -0
  44. package/dist/gui/server.d.ts.map +1 -0
  45. package/dist/gui/server.js +729 -0
  46. package/dist/gui/server.js.map +1 -0
  47. package/dist/index.d.ts +3 -0
  48. package/dist/index.d.ts.map +1 -0
  49. package/dist/index.js +93 -0
  50. package/dist/index.js.map +1 -0
  51. package/dist/indexer/index.d.ts +38 -0
  52. package/dist/indexer/index.d.ts.map +1 -0
  53. package/dist/indexer/index.js +283 -0
  54. package/dist/indexer/index.js.map +1 -0
  55. package/dist/indexer/parser.d.ts +20 -0
  56. package/dist/indexer/parser.d.ts.map +1 -0
  57. package/dist/indexer/parser.js +431 -0
  58. package/dist/indexer/parser.js.map +1 -0
  59. package/dist/indexer/summarizer.d.ts +15 -0
  60. package/dist/indexer/summarizer.d.ts.map +1 -0
  61. package/dist/indexer/summarizer.js +24 -0
  62. package/dist/indexer/summarizer.js.map +1 -0
  63. package/dist/indexer/watcher.d.ts +25 -0
  64. package/dist/indexer/watcher.d.ts.map +1 -0
  65. package/dist/indexer/watcher.js +54 -0
  66. package/dist/indexer/watcher.js.map +1 -0
  67. package/dist/monitoring/estimator.d.ts +20 -0
  68. package/dist/monitoring/estimator.d.ts.map +1 -0
  69. package/dist/monitoring/estimator.js +94 -0
  70. package/dist/monitoring/estimator.js.map +1 -0
  71. package/dist/monitoring/server.d.ts +20 -0
  72. package/dist/monitoring/server.d.ts.map +1 -0
  73. package/dist/monitoring/server.js +86 -0
  74. package/dist/monitoring/server.js.map +1 -0
  75. package/dist/monitoring/token-logger.d.ts +26 -0
  76. package/dist/monitoring/token-logger.d.ts.map +1 -0
  77. package/dist/monitoring/token-logger.js +47 -0
  78. package/dist/monitoring/token-logger.js.map +1 -0
  79. package/dist/server.d.ts +18 -0
  80. package/dist/server.d.ts.map +1 -0
  81. package/dist/server.js +310 -0
  82. package/dist/server.js.map +1 -0
  83. package/dist/tools/find_usages.d.ts +4 -0
  84. package/dist/tools/find_usages.d.ts.map +1 -0
  85. package/dist/tools/find_usages.js +13 -0
  86. package/dist/tools/find_usages.js.map +1 -0
  87. package/dist/tools/get_context.d.ts +6 -0
  88. package/dist/tools/get_context.d.ts.map +1 -0
  89. package/dist/tools/get_context.js +36 -0
  90. package/dist/tools/get_context.js.map +1 -0
  91. package/dist/tools/get_dependencies.d.ts +4 -0
  92. package/dist/tools/get_dependencies.d.ts.map +1 -0
  93. package/dist/tools/get_dependencies.js +16 -0
  94. package/dist/tools/get_dependencies.js.map +1 -0
  95. package/dist/tools/get_doc_chunk.d.ts +4 -0
  96. package/dist/tools/get_doc_chunk.d.ts.map +1 -0
  97. package/dist/tools/get_doc_chunk.js +32 -0
  98. package/dist/tools/get_doc_chunk.js.map +1 -0
  99. package/dist/tools/get_file_summary.d.ts +4 -0
  100. package/dist/tools/get_file_summary.d.ts.map +1 -0
  101. package/dist/tools/get_file_summary.js +23 -0
  102. package/dist/tools/get_file_summary.js.map +1 -0
  103. package/dist/tools/get_project_overview.d.ts +5 -0
  104. package/dist/tools/get_project_overview.d.ts.map +1 -0
  105. package/dist/tools/get_project_overview.js +60 -0
  106. package/dist/tools/get_project_overview.js.map +1 -0
  107. package/dist/tools/get_symbol.d.ts +4 -0
  108. package/dist/tools/get_symbol.d.ts.map +1 -0
  109. package/dist/tools/get_symbol.js +21 -0
  110. package/dist/tools/get_symbol.js.map +1 -0
  111. package/dist/tools/get_token_stats.d.ts +4 -0
  112. package/dist/tools/get_token_stats.d.ts.map +1 -0
  113. package/dist/tools/get_token_stats.js +6 -0
  114. package/dist/tools/get_token_stats.js.map +1 -0
  115. package/dist/tools/reindex.d.ts +5 -0
  116. package/dist/tools/reindex.d.ts.map +1 -0
  117. package/dist/tools/reindex.js +21 -0
  118. package/dist/tools/reindex.js.map +1 -0
  119. package/dist/tools/save_context.d.ts +4 -0
  120. package/dist/tools/save_context.d.ts.map +1 -0
  121. package/dist/tools/save_context.js +17 -0
  122. package/dist/tools/save_context.js.map +1 -0
  123. package/dist/tools/search_docs.d.ts +4 -0
  124. package/dist/tools/search_docs.d.ts.map +1 -0
  125. package/dist/tools/search_docs.js +42 -0
  126. package/dist/tools/search_docs.js.map +1 -0
  127. package/dist/tools/search_symbols.d.ts +5 -0
  128. package/dist/tools/search_symbols.d.ts.map +1 -0
  129. package/dist/tools/search_symbols.js +36 -0
  130. package/dist/tools/search_symbols.js.map +1 -0
  131. package/dist/tools/start_comparison.d.ts +4 -0
  132. package/dist/tools/start_comparison.d.ts.map +1 -0
  133. package/dist/tools/start_comparison.js +15 -0
  134. package/dist/tools/start_comparison.js.map +1 -0
  135. package/dist/types.d.ts +318 -0
  136. package/dist/types.d.ts.map +1 -0
  137. package/dist/types.js +3 -0
  138. package/dist/types.js.map +1 -0
  139. package/package.json +69 -0
@@ -0,0 +1,56 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * pindex-gui entry point.
4
+ * Starts an aggregated dashboard server and opens the browser.
5
+ */
6
+ import { startGuiServer } from './server.js';
7
+ const portArgIdx = process.argv.indexOf('--port');
8
+ const BASE_PORT = portArgIdx !== -1 && process.argv[portArgIdx + 1]
9
+ ? parseInt(process.argv[portArgIdx + 1], 10)
10
+ : parseInt(process.env.GUI_PORT ?? '7842', 10);
11
+ async function main() {
12
+ let server = null;
13
+ for (let attempt = 0; attempt < 5; attempt++) {
14
+ const tryPort = BASE_PORT + attempt;
15
+ try {
16
+ server = await startGuiServer(tryPort);
17
+ break;
18
+ }
19
+ catch (err) {
20
+ if (err.code === 'EADDRINUSE') {
21
+ if (attempt === 4) {
22
+ console.error(` [pindex-gui] No free port found (tried ${BASE_PORT}–${BASE_PORT + 4}). Set GUI_PORT=<port> to override.`);
23
+ process.exit(1);
24
+ }
25
+ console.error(` [pindex-gui] Port ${tryPort} in use, trying ${tryPort + 1}…`);
26
+ continue;
27
+ }
28
+ throw err;
29
+ }
30
+ }
31
+ const port = server.port;
32
+ console.log(`\n PindeX Dashboard → http://localhost:${port}\n`);
33
+ try {
34
+ const { default: open } = await import('open');
35
+ await open(`http://localhost:${port}`);
36
+ }
37
+ catch {
38
+ // open is optional – ignore if it fails
39
+ }
40
+ // Keep the process alive
41
+ process.on('SIGINT', () => {
42
+ console.log('\n Dashboard stopped.');
43
+ process.exit(0);
44
+ });
45
+ }
46
+ process.on('uncaughtException', (err) => {
47
+ console.error('[pindex-gui] Uncaught exception (keeping process alive):', err.message);
48
+ });
49
+ process.on('unhandledRejection', (reason) => {
50
+ console.error('[pindex-gui] Unhandled rejection (keeping process alive):', reason);
51
+ });
52
+ main().catch((err) => {
53
+ console.error('pindex-gui error:', err instanceof Error ? err.message : err);
54
+ process.exit(1);
55
+ });
56
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gui/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,UAAU,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IACjE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5C,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,IAAI,MAAM,GAAsD,IAAI,CAAC;IACrE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM;QACR,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAK,GAA6B,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBACzD,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;oBAClB,OAAO,CAAC,KAAK,CAAC,4CAA4C,SAAS,IAAI,SAAS,GAAG,CAAC,qCAAqC,CAAC,CAAC;oBAC3H,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,uBAAuB,OAAO,mBAAmB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC/E,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,MAAO,CAAC,IAAI,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,6CAA6C,IAAI,IAAI,CAAC,CAAC;IAEnE,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IAED,yBAAyB;IACzB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,0DAA0D,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;AACzF,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,2DAA2D,EAAE,MAAM,CAAC,CAAC;AACrF,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -0,0 +1,31 @@
1
+ /**
2
+ * pindex-gui: Aggregated dashboard server.
3
+ * Reads all registered projects from ~/.pindex/registry.json and their
4
+ * SQLite databases directly (no running pindex-server required).
5
+ */
6
+ import { createServer } from 'node:http';
7
+ import express from 'express';
8
+ import { type RegistryEntry } from '../cli/project-detector.js';
9
+ export interface ProjectStats {
10
+ entry: RegistryEntry;
11
+ fileCount: number;
12
+ symbolCount: number;
13
+ totalTokensSaved: number;
14
+ totalTokensActual: number;
15
+ savingsPercent: number;
16
+ sessionCount: number;
17
+ dbExists: boolean;
18
+ lastIndexed: string | null;
19
+ serverRunning: boolean;
20
+ }
21
+ export declare function loadProjectStats(entry: RegistryEntry): Omit<ProjectStats, 'serverRunning'>;
22
+ export declare function createGuiApp(): express.Application;
23
+ export interface GuiServer {
24
+ httpServer: ReturnType<typeof createServer>;
25
+ close(): Promise<void>;
26
+ }
27
+ export interface GuiServerWithPort extends GuiServer {
28
+ port: number;
29
+ }
30
+ export declare function startGuiServer(port: number): Promise<GuiServerWithPort>;
31
+ //# sourceMappingURL=server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/gui/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AAIpC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB;AAaD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAmD1F;AAID,wBAAgB,YAAY,IAAI,OAAO,CAAC,WAAW,CAsIlD;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBvE"}