spine-framework 0.1.61 → 0.2.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 (246) hide show
  1. package/.framework/cli/commands/create-app.ts +1 -1
  2. package/.framework/cli/commands/dev.ts +215 -33
  3. package/.framework/cli/index.ts +37 -63
  4. package/.framework/functions/_shared/app-manifest.ts +8 -15
  5. package/.framework/functions/_shared/db.ts +11 -15
  6. package/.framework/functions/_shared/index.ts +0 -9
  7. package/.framework/functions/_shared/principal.ts +4 -62
  8. package/.framework/functions/_shared/resolve-ids.ts +6 -6
  9. package/.framework/functions/_shared/webhook-registry.ts +1 -1
  10. package/.framework/functions/admin-funnel.ts +104 -0
  11. package/.framework/functions/admin-install-funnel.ts +225 -0
  12. package/.framework/functions/admin-signals.ts +241 -0
  13. package/.framework/migrations/001_schema.sql +406 -0
  14. package/.framework/migrations/002_rls_and_functions.sql +710 -0
  15. package/.framework/migrations/003_system_data.sql +520 -0
  16. package/.framework/migrations/004_enhancements.sql +43 -0
  17. package/.framework/public/_redirects +3 -0
  18. package/.framework/public/spine-logo.jpg +0 -0
  19. package/.framework/public/spine-logo.svg +3 -0
  20. package/{scripts → .framework/scripts}/assemble-frontend.sh +1 -1
  21. package/{scripts → .framework/scripts}/assemble-functions.sh +1 -1
  22. package/{scripts → .framework/scripts}/assemble.sh +2 -8
  23. package/{scripts → .framework/scripts}/check-core-integrity.sh +0 -0
  24. package/.framework/seeds/link_types/account_cli_instances.json +9 -0
  25. package/.framework/seeds/types/funnel_signal_use.json +98 -0
  26. package/.framework/seeds/types/spine_instance.json +109 -0
  27. package/.framework/src/App.tsx +6 -4
  28. package/.framework/src/components/ui/accordion.tsx +1 -1
  29. package/.framework/src/components/ui/alert-dialog.tsx +1 -1
  30. package/.framework/src/components/ui/aspect-ratio.tsx +1 -1
  31. package/.framework/src/components/ui/avatar.tsx +1 -1
  32. package/.framework/src/components/ui/badge.tsx +2 -2
  33. package/.framework/src/components/ui/breadcrumb.tsx +2 -2
  34. package/.framework/src/components/ui/button-group.tsx +2 -2
  35. package/.framework/src/components/ui/button.tsx +2 -2
  36. package/.framework/src/components/ui/chart.tsx +6 -1
  37. package/.framework/src/components/ui/checkbox.tsx +1 -1
  38. package/.framework/src/components/ui/collapsible.tsx +1 -1
  39. package/.framework/src/components/ui/context-menu.tsx +1 -1
  40. package/.framework/src/components/ui/dialog.tsx +1 -1
  41. package/.framework/src/components/ui/direction.tsx +17 -1
  42. package/.framework/src/components/ui/dropdown-menu.tsx +1 -1
  43. package/.framework/src/components/ui/hover-card.tsx +1 -1
  44. package/.framework/src/components/ui/item.tsx +2 -2
  45. package/.framework/src/components/ui/label.tsx +1 -1
  46. package/.framework/src/components/ui/menubar.tsx +1 -1
  47. package/.framework/src/components/ui/navigation-menu.tsx +1 -1
  48. package/.framework/src/components/ui/popover.tsx +1 -1
  49. package/.framework/src/components/ui/progress.tsx +1 -1
  50. package/.framework/src/components/ui/radio-group.tsx +1 -1
  51. package/.framework/src/components/ui/scroll-area.tsx +1 -1
  52. package/.framework/src/components/ui/select.tsx +1 -1
  53. package/.framework/src/components/ui/separator.tsx +1 -1
  54. package/.framework/src/components/ui/sheet.tsx +1 -1
  55. package/.framework/src/components/ui/sidebar.tsx +6 -6
  56. package/.framework/src/components/ui/slider.tsx +1 -1
  57. package/.framework/src/components/ui/switch.tsx +1 -1
  58. package/.framework/src/components/ui/tabs.tsx +1 -1
  59. package/.framework/src/components/ui/toggle-group.tsx +1 -1
  60. package/.framework/src/components/ui/toggle.tsx +1 -1
  61. package/.framework/src/components/ui/tooltip.tsx +1 -1
  62. package/.framework/src/pages/auth/LoginPage.tsx +10 -9
  63. package/LICENSE.md +193 -0
  64. package/README.md +254 -0
  65. package/custom/.devin/skills/install-app/SKILL.md +39 -0
  66. package/custom/.devin/workflows/app-install.yaml +83 -0
  67. package/custom/README.md +79 -0
  68. package/docs/APPS.md +232 -0
  69. package/docs/ARCHITECTURE.md +246 -0
  70. package/docs/INSTALL.md +155 -0
  71. package/docs/README.md +170 -0
  72. package/docs/design-schema-spec.md +1837 -0
  73. package/docs/dev-guides/01-create-an-app.md +183 -0
  74. package/docs/dev-guides/02-create-a-function.md +178 -0
  75. package/docs/dev-guides/03-create-a-component.md +178 -0
  76. package/docs/dev-guides/04-webhook-handlers.md +129 -0
  77. package/docs/dev-guides/05-testing.md +168 -0
  78. package/docs/dev-guides/README.md +40 -0
  79. package/docs/npm-packages-plan.md +288 -0
  80. package/docs/spine-core--api-reference.md +822 -0
  81. package/package.json +78 -144
  82. package/.framework/cli/bin.cjs +0 -14
  83. package/.framework/cli/commands/init.ts +0 -186
  84. package/.framework/cli/commands/install-app.ts +0 -565
  85. package/.framework/cli/commands/migrate.ts +0 -139
  86. package/.framework/cli/commands/status.ts +0 -197
  87. package/.framework/cli/commands/uninstall-app.ts +0 -166
  88. package/.framework/cli/welcome.cjs +0 -45
  89. package/.framework/docs/STABILITY.md +0 -52
  90. package/.framework/docs/examples/custom-app/README.md +0 -77
  91. package/.framework/docs/examples/custom-function/README.md +0 -27
  92. package/.framework/docs/examples/custom-function/handler.ts +0 -48
  93. package/.framework/docs/examples/custom-webhook/README.md +0 -68
  94. package/.framework/migrations/000_foundation.sql +0 -1266
  95. package/.framework/migrations/001_seed.sql +0 -163
  96. package/.framework/migrations/002_seed_constraints.sql +0 -19
  97. package/.framework/migrations/003_auth_user_trigger.sql +0 -67
  98. package/.framework/src/pages/auth/RegisterPage.tsx +0 -163
  99. package/STRUCTURE.md +0 -150
  100. package/bin/spine-framework.cjs +0 -62
  101. package/bin/welcome.cjs +0 -45
  102. package/bin/ws-shim.cjs +0 -8
  103. package/bin/ws-shim.ts +0 -10
  104. package/config/components.json +0 -25
  105. package/config/deno.lock +0 -108
  106. package/config/package-lock.json +0 -17183
  107. package/config/postcss.config.cjs +0 -10
  108. package/config/tailwind.config.cjs +0 -78
  109. package/config/tsconfig.build.json +0 -32
  110. package/config/tsconfig.cli.json +0 -18
  111. package/config/tsconfig.json +0 -41
  112. package/config/tsconfig.node.json +0 -17
  113. package/config/tsconfig.node.tsbuildinfo +0 -1
  114. package/config/tsconfig.tsbuildinfo +0 -1
  115. package/config/typedoc.json +0 -16
  116. package/config/vite.config.d.ts +0 -2
  117. package/config/vite.config.ts +0 -72
  118. package/dist/cli/commands/agents.d.ts +0 -39
  119. package/dist/cli/commands/agents.d.ts.map +0 -1
  120. package/dist/cli/commands/auth.d.ts +0 -36
  121. package/dist/cli/commands/auth.d.ts.map +0 -1
  122. package/dist/cli/commands/create-app.d.ts +0 -23
  123. package/dist/cli/commands/create-app.d.ts.map +0 -1
  124. package/dist/cli/commands/dev.d.ts +0 -24
  125. package/dist/cli/commands/dev.d.ts.map +0 -1
  126. package/dist/cli/commands/doctor.d.ts +0 -42
  127. package/dist/cli/commands/doctor.d.ts.map +0 -1
  128. package/dist/cli/commands/generate.d.ts +0 -36
  129. package/dist/cli/commands/generate.d.ts.map +0 -1
  130. package/dist/cli/commands/init.d.ts +0 -20
  131. package/dist/cli/commands/init.d.ts.map +0 -1
  132. package/dist/cli/commands/install-app.d.ts +0 -30
  133. package/dist/cli/commands/install-app.d.ts.map +0 -1
  134. package/dist/cli/commands/items.d.ts +0 -45
  135. package/dist/cli/commands/items.d.ts.map +0 -1
  136. package/dist/cli/commands/migrate.d.ts +0 -21
  137. package/dist/cli/commands/migrate.d.ts.map +0 -1
  138. package/dist/cli/commands/migrations.d.ts +0 -41
  139. package/dist/cli/commands/migrations.d.ts.map +0 -1
  140. package/dist/cli/commands/pipelines.d.ts +0 -40
  141. package/dist/cli/commands/pipelines.d.ts.map +0 -1
  142. package/dist/cli/commands/status.d.ts +0 -23
  143. package/dist/cli/commands/status.d.ts.map +0 -1
  144. package/dist/cli/commands/system.d.ts +0 -29
  145. package/dist/cli/commands/system.d.ts.map +0 -1
  146. package/dist/cli/commands/test.d.ts +0 -46
  147. package/dist/cli/commands/test.d.ts.map +0 -1
  148. package/dist/cli/commands/uninstall-app.d.ts +0 -23
  149. package/dist/cli/commands/uninstall-app.d.ts.map +0 -1
  150. package/dist/cli/context.d.ts +0 -88
  151. package/dist/cli/context.d.ts.map +0 -1
  152. package/dist/cli/env-loader.d.ts +0 -14
  153. package/dist/cli/env-loader.d.ts.map +0 -1
  154. package/dist/cli/index.d.ts +0 -41
  155. package/dist/cli/index.d.ts.map +0 -1
  156. package/dist/functions/_shared/agent-runner.d.ts +0 -156
  157. package/dist/functions/_shared/agent-runner.d.ts.map +0 -1
  158. package/dist/functions/_shared/app-manifest.d.ts +0 -68
  159. package/dist/functions/_shared/app-manifest.d.ts.map +0 -1
  160. package/dist/functions/_shared/audit.d.ts +0 -91
  161. package/dist/functions/_shared/audit.d.ts.map +0 -1
  162. package/dist/functions/_shared/db.d.ts +0 -125
  163. package/dist/functions/_shared/db.d.ts.map +0 -1
  164. package/dist/functions/_shared/index.d.ts +0 -299
  165. package/dist/functions/_shared/index.d.ts.map +0 -1
  166. package/dist/functions/_shared/middleware.d.ts +0 -315
  167. package/dist/functions/_shared/middleware.d.ts.map +0 -1
  168. package/dist/functions/_shared/permissions.d.ts +0 -626
  169. package/dist/functions/_shared/permissions.d.ts.map +0 -1
  170. package/dist/functions/_shared/pipeline-runner.d.ts +0 -124
  171. package/dist/functions/_shared/pipeline-runner.d.ts.map +0 -1
  172. package/dist/functions/_shared/principal.d.ts +0 -284
  173. package/dist/functions/_shared/principal.d.ts.map +0 -1
  174. package/dist/functions/_shared/resolve-ids.d.ts +0 -10
  175. package/dist/functions/_shared/resolve-ids.d.ts.map +0 -1
  176. package/dist/functions/_shared/schema-utils.d.ts +0 -181
  177. package/dist/functions/_shared/schema-utils.d.ts.map +0 -1
  178. package/dist/functions/_shared/testing.d.ts +0 -172
  179. package/dist/functions/_shared/testing.d.ts.map +0 -1
  180. package/dist/functions/_shared/trigger-engine.d.ts +0 -140
  181. package/dist/functions/_shared/trigger-engine.d.ts.map +0 -1
  182. package/dist/functions/_shared/webhook-registration.d.ts +0 -81
  183. package/dist/functions/_shared/webhook-registration.d.ts.map +0 -1
  184. package/dist/functions/_shared/webhook-registry.d.ts +0 -57
  185. package/dist/functions/_shared/webhook-registry.d.ts.map +0 -1
  186. package/dist/functions/account-nodes.d.ts +0 -48
  187. package/dist/functions/account-nodes.d.ts.map +0 -1
  188. package/dist/functions/admin-data.d.ts +0 -178
  189. package/dist/functions/admin-data.d.ts.map +0 -1
  190. package/dist/functions/ai-agents.d.ts +0 -125
  191. package/dist/functions/ai-agents.d.ts.map +0 -1
  192. package/dist/functions/api-keys.d.ts +0 -140
  193. package/dist/functions/api-keys.d.ts.map +0 -1
  194. package/dist/functions/apps.d.ts +0 -163
  195. package/dist/functions/apps.d.ts.map +0 -1
  196. package/dist/functions/auth.d.ts +0 -74
  197. package/dist/functions/auth.d.ts.map +0 -1
  198. package/dist/functions/debug-auth.d.ts +0 -33
  199. package/dist/functions/debug-auth.d.ts.map +0 -1
  200. package/dist/functions/embeddings.d.ts +0 -205
  201. package/dist/functions/embeddings.d.ts.map +0 -1
  202. package/dist/functions/integration-routes.d.ts +0 -45
  203. package/dist/functions/integration-routes.d.ts.map +0 -1
  204. package/dist/functions/integrations.d.ts +0 -124
  205. package/dist/functions/integrations.d.ts.map +0 -1
  206. package/dist/functions/item-progress.d.ts +0 -41
  207. package/dist/functions/item-progress.d.ts.map +0 -1
  208. package/dist/functions/logs.d.ts +0 -162
  209. package/dist/functions/logs.d.ts.map +0 -1
  210. package/dist/functions/observability.d.ts +0 -123
  211. package/dist/functions/observability.d.ts.map +0 -1
  212. package/dist/functions/pipeline-executions.d.ts +0 -190
  213. package/dist/functions/pipeline-executions.d.ts.map +0 -1
  214. package/dist/functions/pipelines.d.ts +0 -171
  215. package/dist/functions/pipelines.d.ts.map +0 -1
  216. package/dist/functions/prompt-configs.d.ts +0 -125
  217. package/dist/functions/prompt-configs.d.ts.map +0 -1
  218. package/dist/functions/roles.d.ts +0 -118
  219. package/dist/functions/roles.d.ts.map +0 -1
  220. package/dist/functions/system-cron.d.ts +0 -65
  221. package/dist/functions/system-cron.d.ts.map +0 -1
  222. package/dist/functions/system.d.ts +0 -29
  223. package/dist/functions/system.d.ts.map +0 -1
  224. package/dist/functions/tests.d.ts +0 -28
  225. package/dist/functions/tests.d.ts.map +0 -1
  226. package/dist/functions/timers.d.ts +0 -139
  227. package/dist/functions/timers.d.ts.map +0 -1
  228. package/dist/functions/triggers.d.ts +0 -203
  229. package/dist/functions/triggers.d.ts.map +0 -1
  230. package/dist/functions/types.d.ts +0 -151
  231. package/dist/functions/types.d.ts.map +0 -1
  232. package/dist/src/types/types.d.ts +0 -364
  233. package/dist/src/types/types.d.ts.map +0 -1
  234. package/index.html +0 -13
  235. package/netlify.toml +0 -36
  236. package/package-project.json +0 -64
  237. package/scripts/ingest-chunks.cjs +0 -202
  238. package/scripts/kb-chunk-parser.cjs +0 -312
  239. package/scripts/kb-chunk-parser.ts +0 -330
  240. package/scripts/load-test-app-install.ts +0 -484
  241. package/scripts/netlify-dev-wrapper.sh +0 -22
  242. package/vitest.config.ts +0 -45
  243. /package/{scripts → .framework/scripts}/app-install-cli.ts +0 -0
  244. /package/{scripts → .framework/scripts}/boundary-check.sh +0 -0
  245. /package/{scripts → .framework/scripts}/build-manifest.sh +0 -0
  246. /package/{scripts → .framework/scripts}/verify-integrity.sh +0 -0
@@ -1,202 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- const fs = require('fs');
4
- const https = require('https');
5
- const querystring = require('querystring');
6
-
7
- // Configuration - use local Netlify Functions
8
- const NETLIFY_URL = 'http://localhost:8888';
9
- const SUPABASE_SERVICE_ROLE_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV5b2t1aWlienR3YXNkcHJzb3YiLCJyb2xlIjoic2VydmljZV9yb2xlIiwiaWF0IjoxNzM2MTY3Njk5LCJleHAiOjIwNTE3NDM2OTl9.qKqJv8N-IY9q8o_XJtq2o5s3RfD2W4x7J8L9q8o_XJt';
10
-
11
- // Read chunks from file
12
- function readChunks(filePath) {
13
- try {
14
- const content = fs.readFileSync(filePath, 'utf8');
15
- const data = JSON.parse(content);
16
- return data.chunks || [];
17
- } catch (error) {
18
- console.error('Error reading chunks file:', error.message);
19
- process.exit(1);
20
- }
21
- }
22
-
23
- // Make HTTP request to local Netlify Function
24
- function makeRequest(functionName, data) {
25
- return new Promise((resolve, reject) => {
26
- const postData = JSON.stringify(data);
27
- const url = `${NETLIFY_URL}/.netlify/functions/${functionName}`;
28
-
29
- console.log(` 🌐 Calling: ${url}`);
30
- console.log(` 📦 Data size: ${postData.length} bytes`);
31
-
32
- const options = {
33
- hostname: 'localhost',
34
- port: 8888,
35
- path: `/.netlify/functions/${functionName}`,
36
- method: 'POST',
37
- headers: {
38
- 'Content-Type': 'application/json',
39
- 'Authorization': `Bearer ${SUPABASE_SERVICE_ROLE_KEY}`,
40
- 'Content-Length': Buffer.byteLength(postData)
41
- }
42
- };
43
-
44
- const req = require('http').request(options, (res) => {
45
- let responseData = '';
46
-
47
- res.on('data', (chunk) => {
48
- responseData += chunk;
49
- });
50
-
51
- res.on('end', () => {
52
- console.log(` 📡 Response status: ${res.statusCode}`);
53
- console.log(` 📄 Response body: ${responseData.substring(0, 200)}${responseData.length > 200 ? '...' : ''}`);
54
-
55
- try {
56
- const parsed = JSON.parse(responseData);
57
- resolve({ status: res.statusCode, data: parsed });
58
- } catch (error) {
59
- resolve({ status: res.statusCode, data: responseData });
60
- }
61
- });
62
- });
63
-
64
- req.on('error', (error) => {
65
- console.log(` ❌ Request error: ${error.message}`);
66
- reject(error);
67
- });
68
-
69
- req.write(postData);
70
- req.end();
71
- });
72
- }
73
-
74
- // Ingest chunks in batches to avoid timeouts
75
- async function ingestChunks(chunks, batchSize = 10) {
76
- const results = {
77
- total: chunks.length,
78
- processed: 0,
79
- created: 0,
80
- updated: 0,
81
- errors: []
82
- };
83
-
84
- console.log(`Starting ingestion of ${chunks.length} chunks in batches of ${batchSize}...`);
85
-
86
- for (let i = 0; i < chunks.length; i += batchSize) {
87
- const batch = chunks.slice(i, i + batchSize);
88
- const batchNum = Math.floor(i / batchSize) + 1;
89
- const totalBatches = Math.ceil(chunks.length / batchSize);
90
-
91
- console.log(`Processing batch ${batchNum}/${totalBatches} (${batch.length} chunks)...`);
92
-
93
- try {
94
- const response = await makeRequest('custom_kb-ingestion', {
95
- chunks: batch,
96
- force_update: false
97
- });
98
-
99
- if (response.status === 200) {
100
- const result = response.data;
101
- results.processed += batch.length;
102
- results.created += result.items_created || 0;
103
- results.updated += result.items_updated || 0;
104
-
105
- if (result.errors && result.errors.length > 0) {
106
- results.errors.push(...result.errors);
107
- }
108
-
109
- if (result.skipped && result.skipped.length > 0) {
110
- console.log(` Batch ${batchNum}: ${result.items_created || 0} created, ${result.items_updated || 0} updated, ${result.skipped?.length || 0} skipped`);
111
- } else {
112
- console.log(` Batch ${batchNum}: ${result.items_created || 0} created, ${result.items_updated || 0} updated`);
113
- }
114
- } else {
115
- const error = `HTTP ${response.status}: ${JSON.stringify(response.data)}`;
116
- results.errors.push(`Batch ${batchNum}: ${error}`);
117
- console.error(` Batch ${batchNum} failed: ${error}`);
118
- }
119
- } catch (error) {
120
- const batchError = `Batch ${batchNum}: ${error.message}`;
121
- results.errors.push(batchError);
122
- console.error(` Batch ${batchNum} failed: ${error.message}`);
123
- }
124
-
125
- // Small delay between batches to avoid rate limiting
126
- if (i + batchSize < chunks.length) {
127
- await new Promise(resolve => setTimeout(resolve, 1000));
128
- }
129
- }
130
-
131
- return results;
132
- }
133
-
134
- // Main function
135
- async function main() {
136
- const args = process.argv.slice(2);
137
-
138
- if (args.length < 1) {
139
- console.log('Usage: node ingest-chunks.js <chunks.json>');
140
- console.log('Example: node ingest-chunks.js chunks.json');
141
- process.exit(1);
142
- }
143
-
144
- const chunksFile = args[0];
145
-
146
- if (!fs.existsSync(chunksFile)) {
147
- console.error(`Chunks file not found: ${chunksFile}`);
148
- process.exit(1);
149
- }
150
-
151
- try {
152
- const chunks = readChunks(chunksFile);
153
- console.log(`Loaded ${chunks.length} chunks from ${chunksFile}`);
154
-
155
- // Show sample chunk
156
- if (chunks.length > 0) {
157
- console.log('\nSample chunk:');
158
- console.log(`- ID: ${chunks[0].chunk_id}`);
159
- console.log(`- Macro: ${chunks[0].macro}`);
160
- console.log(`- Micro: ${chunks[0].micro}`);
161
- console.log(`- File: ${chunks[0].metadata.file_path}`);
162
- }
163
-
164
- // Ask for confirmation
165
- console.log('\nReady to ingest chunks into KB system.');
166
- console.log('This will create KB articles and embeddings for each chunk.');
167
- console.log('Continue? (y/N)');
168
-
169
- // For automation, we'll proceed without interactive confirmation
170
- console.log('Proceeding with ingestion...\n');
171
-
172
- const results = await ingestChunks(chunks);
173
-
174
- console.log('\n=== Ingestion Complete ===');
175
- console.log(`Total chunks: ${results.total}`);
176
- console.log(`Processed: ${results.processed}`);
177
- console.log(`Created: ${results.created}`);
178
- console.log(`Updated: ${results.updated}`);
179
- console.log(`Errors: ${results.errors.length}`);
180
-
181
- if (results.errors.length > 0) {
182
- console.log('\nErrors:');
183
- results.errors.slice(0, 10).forEach((error, i) => {
184
- console.log(`${i + 1}. ${error}`);
185
- });
186
-
187
- if (results.errors.length > 10) {
188
- console.log(`... and ${results.errors.length - 10} more errors`);
189
- }
190
- }
191
-
192
- console.log('\nYou can now check the KB articles in your Spine instance!');
193
-
194
- } catch (error) {
195
- console.error('Fatal error:', error.message);
196
- process.exit(1);
197
- }
198
- }
199
-
200
- if (require.main === module) {
201
- main();
202
- }
@@ -1,312 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- const fs = require('fs');
4
- const path = require('path');
5
-
6
- class KBChunkParser {
7
- constructor() {
8
- this.chunks = [];
9
- this.currentChunk = {};
10
- this.inChunk = false;
11
- this.currentFile = '';
12
- this.currentLine = 0;
13
- }
14
-
15
- async parseDirectory(dirPath) {
16
- this.chunks = [];
17
-
18
- const walkDir = (dir, fileList = []) => {
19
- const files = fs.readdirSync(dir);
20
-
21
- for (const file of files) {
22
- const filePath = path.join(dir, file);
23
- const stat = fs.statSync(filePath);
24
-
25
- if (stat.isDirectory()) {
26
- // Skip certain directories
27
- if (!['node_modules', '.git', 'dist', 'src/v2-assembled'].includes(file)) {
28
- walkDir(filePath, fileList);
29
- }
30
- } else if (file.match(/\.(ts|js|tsx|jsx)$/)) {
31
- fileList.push(filePath);
32
- }
33
- }
34
-
35
- return fileList;
36
- };
37
-
38
- const files = walkDir(dirPath);
39
-
40
- for (const filePath of files) {
41
- await this.parseFile(filePath);
42
- }
43
-
44
- return this.chunks;
45
- }
46
-
47
- async parseFile(filePath) {
48
- this.currentFile = filePath;
49
- this.currentLine = 0;
50
- this.inChunk = false;
51
- this.currentChunk = {};
52
-
53
- try {
54
- const content = fs.readFileSync(filePath, 'utf8');
55
- const lines = content.split('\n');
56
-
57
- for (let i = 0; i < lines.length; i++) {
58
- this.currentLine = i + 1;
59
- const line = lines[i];
60
-
61
- if (line.includes('CHUNK_START:')) {
62
- this.handleChunkStart(line);
63
- } else if (line.includes('CHUNK_END:')) {
64
- this.handleChunkEnd();
65
- } else if (this.inChunk && this.currentChunk.code !== undefined) {
66
- this.currentChunk.code += line + '\n';
67
- }
68
- }
69
- } catch (error) {
70
- console.error(`Error parsing file ${filePath}:`, error.message);
71
- }
72
- }
73
-
74
- handleChunkStart(line) {
75
- const match = line.match(/CHUNK_START:\s*(.+?)\s*─/);
76
- if (!match) {
77
- console.warn(`Invalid CHUNK_START format at line ${this.currentLine}: ${line}`);
78
- return;
79
- }
80
-
81
- const identifier = match[1].trim();
82
- this.inChunk = true;
83
- this.currentChunk = {
84
- identifier,
85
- code: '',
86
- metadata: {
87
- chunk_id: '',
88
- file_path: this.currentFile,
89
- line_start: this.currentLine,
90
- line_end: 0,
91
- chunk_type: 'function',
92
- purpose: '',
93
- hash: '',
94
- dependencies: [],
95
- dependents: [],
96
- source: {
97
- source_type: 'core',
98
- ref: this.currentFile,
99
- line_start: this.currentLine,
100
- line_end: 0
101
- }
102
- }
103
- };
104
- }
105
-
106
- handleChunkEnd() {
107
- if (!this.inChunk) {
108
- console.warn(`CHUNK_END without CHUNK_START at line ${this.currentLine}`);
109
- return;
110
- }
111
-
112
- const match = this.currentChunk.code?.match(/@chunk-id\s+(.+)/);
113
- if (!match) {
114
- console.warn(`Missing @chunk-id in chunk ${this.currentChunk.identifier}`);
115
- this.inChunk = false;
116
- return;
117
- }
118
-
119
- const chunkId = match[1].trim();
120
- const hash = this.generateHash(this.currentChunk.code || '');
121
-
122
- // Parse JSDoc-style comments
123
- const parsed = this.parseChunkDoc(this.currentChunk.code || '');
124
-
125
- const chunk = {
126
- identifier: this.currentChunk.identifier,
127
- chunk_id: chunkId,
128
- version: '1.0.0',
129
- hash,
130
- macro: parsed.macro || '',
131
- micro: parsed.micro || '',
132
- inputs: parsed.inputs || {},
133
- outputs: parsed.outputs || '',
134
- depends_on: parsed.depends_on || [],
135
- depended_by: parsed.depended_by || [],
136
- side_effects: parsed.side_effects || [],
137
- tags: parsed.tags || [],
138
- code: (this.currentChunk.code || '').trim(),
139
- metadata: {
140
- ...this.currentChunk.metadata,
141
- chunk_id: chunkId,
142
- hash,
143
- line_end: this.currentLine,
144
- source: {
145
- ...this.currentChunk.metadata.source,
146
- line_end: this.currentLine
147
- }
148
- }
149
- };
150
-
151
- this.chunks.push(chunk);
152
- this.inChunk = false;
153
- this.currentChunk = {};
154
- }
155
-
156
- parseChunkDoc(code) {
157
- const doc = {};
158
-
159
- // Extract @chunk-id
160
- const chunkIdMatch = code.match(/@chunk-id\s+(.+)/);
161
- if (chunkIdMatch) {
162
- doc.chunk_id = chunkIdMatch[1].trim();
163
- }
164
-
165
- // Extract @version
166
- const versionMatch = code.match(/@version\s+(.+)/);
167
- if (versionMatch) {
168
- doc.version = versionMatch[1].trim();
169
- }
170
-
171
- // Extract @hash
172
- const hashMatch = code.match(/@hash\s+(.+)/);
173
- if (hashMatch) {
174
- doc.hash = hashMatch[1].trim();
175
- }
176
-
177
- // Extract @macro
178
- const macroMatch = code.match(/@macro\s+(.+)/);
179
- if (macroMatch) {
180
- doc.macro = macroMatch[1].trim();
181
- }
182
-
183
- // Extract @micro
184
- const microMatch = code.match(/@micro\s+(.+)/);
185
- if (microMatch) {
186
- doc.micro = microMatch[1].trim();
187
- }
188
-
189
- // Extract @inputs
190
- const inputsMatch = code.match(/@inputs\s+(.+)/);
191
- if (inputsMatch) {
192
- doc.inputs = this.parseKeyValuePairs(inputsMatch[1].trim());
193
- }
194
-
195
- // Extract @outputs
196
- const outputsMatch = code.match(/@outputs\s+(.+)/);
197
- if (outputsMatch) {
198
- doc.outputs = outputsMatch[1].trim();
199
- }
200
-
201
- // Extract @depends-on
202
- const dependsOnMatch = code.match(/@depends-on\s+(.+)/);
203
- if (dependsOnMatch) {
204
- doc.depends_on = this.parseList(dependsOnMatch[1].trim());
205
- }
206
-
207
- // Extract @depended-by
208
- const dependedByMatch = code.match(/@depended-by\s+(.+)/);
209
- if (dependedByMatch) {
210
- doc.depended_by = this.parseList(dependedByMatch[1].trim());
211
- }
212
-
213
- // Extract @side-effects
214
- const sideEffectsMatch = code.match(/@side-effects\s+(.+)/);
215
- if (sideEffectsMatch) {
216
- doc.side_effects = this.parseList(sideEffectsMatch[1].trim());
217
- }
218
-
219
- // Extract @tags
220
- const tagsMatch = code.match(/@tags\s+(.+)/);
221
- if (tagsMatch) {
222
- doc.tags = this.parseList(tagsMatch[1].trim());
223
- }
224
-
225
- return doc;
226
- }
227
-
228
- parseKeyValuePairs(str) {
229
- const pairs = {};
230
- const regex = /(\w+):\s*([^,]+)(?:,\s*|$)/g;
231
- let match;
232
-
233
- while ((match = regex.exec(str)) !== null) {
234
- pairs[match[1]] = match[2].trim();
235
- }
236
-
237
- return pairs;
238
- }
239
-
240
- parseList(str) {
241
- return str.split(',').map(s => s.trim()).filter(Boolean);
242
- }
243
-
244
- generateHash(content) {
245
- // Simple hash function for demonstration
246
- let hash = 0;
247
- for (let i = 0; i < content.length; i++) {
248
- const char = content.charCodeAt(i);
249
- hash = ((hash << 5) - hash) + char;
250
- hash = hash & hash; // Convert to 32-bit integer
251
- }
252
- return Math.abs(hash).toString(16);
253
- }
254
-
255
- async saveChunks(outputFile) {
256
- const output = {
257
- generated_at: new Date().toISOString(),
258
- total_chunks: this.chunks.length,
259
- chunks: this.chunks
260
- };
261
-
262
- fs.writeFileSync(outputFile, JSON.stringify(output, null, 2));
263
- console.log(`Saved ${this.chunks.length} chunks to ${outputFile}`);
264
- }
265
- }
266
-
267
- // CLI usage
268
- async function main() {
269
- const args = process.argv.slice(2);
270
-
271
- if (args.length < 2) {
272
- console.log('Usage: node kb-chunk-parser.js <source-dir> <output-file>');
273
- console.log('Example: node kb-chunk-parser.js v2-core/functions chunks.json');
274
- process.exit(1);
275
- }
276
-
277
- const [sourceDir, outputFile] = args;
278
-
279
- if (!fs.existsSync(sourceDir)) {
280
- console.error(`Source directory not found: ${sourceDir}`);
281
- process.exit(1);
282
- }
283
-
284
- const parser = new KBChunkParser();
285
-
286
- try {
287
- console.log(`Parsing chunks from ${sourceDir}...`);
288
- const chunks = await parser.parseDirectory(sourceDir);
289
-
290
- console.log(`Found ${chunks.length} chunks`);
291
-
292
- await parser.saveChunks(outputFile);
293
-
294
- // Display summary
295
- console.log('\nSummary:');
296
- console.log(`- Functions: ${chunks.filter(c => c.metadata.chunk_type === 'function').length}`);
297
- console.log(`- Classes: ${chunks.filter(c => c.metadata.chunk_type === 'class').length}`);
298
- console.log(`- Interfaces: ${chunks.filter(c => c.metadata.chunk_type === 'interface').length}`);
299
- console.log(`- Configs: ${chunks.filter(c => c.metadata.chunk_type === 'config').length}`);
300
- console.log(`- Objects: ${chunks.filter(c => c.metadata.chunk_type === 'object').length}`);
301
-
302
- } catch (error) {
303
- console.error('Error:', error.message);
304
- process.exit(1);
305
- }
306
- }
307
-
308
- if (require.main === module) {
309
- main();
310
- }
311
-
312
- module.exports = { KBChunkParser };