@loom-framework/core 0.1.0-alpha.7 → 0.1.0-alpha.70

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 (169) hide show
  1. package/dist/adapter-base.d.ts +29 -0
  2. package/dist/adapter-base.d.ts.map +1 -0
  3. package/dist/adapter-base.js +62 -0
  4. package/dist/adapter-base.js.map +1 -0
  5. package/dist/adapter-factory.d.ts +8 -0
  6. package/dist/adapter-factory.d.ts.map +1 -0
  7. package/dist/adapter-factory.js +25 -0
  8. package/dist/adapter-factory.js.map +1 -0
  9. package/dist/adapter-filesystem.d.ts +6 -11
  10. package/dist/adapter-filesystem.d.ts.map +1 -1
  11. package/dist/adapter-filesystem.js +56 -39
  12. package/dist/adapter-filesystem.js.map +1 -1
  13. package/dist/adapter-sqlite.d.ts +6 -23
  14. package/dist/adapter-sqlite.d.ts.map +1 -1
  15. package/dist/adapter-sqlite.js +65 -50
  16. package/dist/adapter-sqlite.js.map +1 -1
  17. package/dist/backend/ai/button-resolver.d.ts +18 -0
  18. package/dist/backend/ai/button-resolver.d.ts.map +1 -0
  19. package/dist/backend/ai/button-resolver.js +58 -0
  20. package/dist/backend/ai/button-resolver.js.map +1 -0
  21. package/dist/backend/ai/engine.d.ts +52 -0
  22. package/dist/backend/ai/engine.d.ts.map +1 -0
  23. package/dist/backend/ai/engine.js +186 -0
  24. package/dist/backend/ai/engine.js.map +1 -0
  25. package/dist/backend/ai/index.d.ts +11 -0
  26. package/dist/backend/ai/index.d.ts.map +1 -0
  27. package/dist/backend/ai/index.js +8 -0
  28. package/dist/backend/ai/index.js.map +1 -0
  29. package/dist/backend/ai/output-parser.d.ts +29 -0
  30. package/dist/backend/ai/output-parser.d.ts.map +1 -0
  31. package/dist/backend/ai/output-parser.js +247 -0
  32. package/dist/backend/ai/output-parser.js.map +1 -0
  33. package/dist/backend/ai/session-manager.d.ts +103 -0
  34. package/dist/backend/ai/session-manager.d.ts.map +1 -0
  35. package/dist/backend/ai/session-manager.js +298 -0
  36. package/dist/backend/ai/session-manager.js.map +1 -0
  37. package/dist/backend/index.d.ts +61 -0
  38. package/dist/backend/index.d.ts.map +1 -0
  39. package/dist/backend/index.js +161 -0
  40. package/dist/backend/index.js.map +1 -0
  41. package/dist/backend/observe/index.d.ts +6 -0
  42. package/dist/backend/observe/index.d.ts.map +1 -0
  43. package/dist/backend/observe/index.js +5 -0
  44. package/dist/backend/observe/index.js.map +1 -0
  45. package/dist/backend/observe/logger.d.ts +28 -0
  46. package/dist/backend/observe/logger.d.ts.map +1 -0
  47. package/dist/backend/observe/logger.js +80 -0
  48. package/dist/backend/observe/logger.js.map +1 -0
  49. package/dist/backend/observe/types.d.ts +26 -0
  50. package/dist/backend/observe/types.d.ts.map +1 -0
  51. package/dist/backend/observe/types.js +7 -0
  52. package/dist/backend/observe/types.js.map +1 -0
  53. package/dist/backend/routes/chat.d.ts +31 -0
  54. package/dist/backend/routes/chat.d.ts.map +1 -0
  55. package/dist/backend/routes/chat.js +426 -0
  56. package/dist/backend/routes/chat.js.map +1 -0
  57. package/dist/backend/routes/data.d.ts +13 -0
  58. package/dist/backend/routes/data.d.ts.map +1 -0
  59. package/dist/backend/routes/data.js +134 -0
  60. package/dist/backend/routes/data.js.map +1 -0
  61. package/dist/backend/routes/health.d.ts +7 -0
  62. package/dist/backend/routes/health.d.ts.map +1 -0
  63. package/dist/backend/routes/health.js +15 -0
  64. package/dist/backend/routes/health.js.map +1 -0
  65. package/dist/backend/routes/index.d.ts +11 -0
  66. package/dist/backend/routes/index.d.ts.map +1 -0
  67. package/dist/backend/routes/index.js +9 -0
  68. package/dist/backend/routes/index.js.map +1 -0
  69. package/dist/backend/routes/skills.d.ts +16 -0
  70. package/dist/backend/routes/skills.d.ts.map +1 -0
  71. package/dist/backend/routes/skills.js +365 -0
  72. package/dist/backend/routes/skills.js.map +1 -0
  73. package/dist/backend/routes/upload.d.ts +24 -0
  74. package/dist/backend/routes/upload.d.ts.map +1 -0
  75. package/dist/backend/routes/upload.js +67 -0
  76. package/dist/backend/routes/upload.js.map +1 -0
  77. package/dist/bin.d.ts +8 -0
  78. package/dist/bin.d.ts.map +1 -0
  79. package/dist/bin.js +12 -0
  80. package/dist/bin.js.map +1 -0
  81. package/dist/capability-generator.d.ts +21 -6
  82. package/dist/capability-generator.d.ts.map +1 -1
  83. package/dist/capability-generator.js +88 -261
  84. package/dist/capability-generator.js.map +1 -1
  85. package/dist/cli/commands/build.d.ts +11 -0
  86. package/dist/cli/commands/build.d.ts.map +1 -0
  87. package/dist/cli/commands/build.js +170 -0
  88. package/dist/cli/commands/build.js.map +1 -0
  89. package/dist/cli/commands/data.d.ts +12 -0
  90. package/dist/cli/commands/data.d.ts.map +1 -0
  91. package/dist/cli/commands/data.js +158 -0
  92. package/dist/cli/commands/data.js.map +1 -0
  93. package/dist/cli/commands/dev.d.ts +9 -0
  94. package/dist/cli/commands/dev.d.ts.map +1 -0
  95. package/dist/cli/commands/dev.js +114 -0
  96. package/dist/cli/commands/dev.js.map +1 -0
  97. package/dist/cli/commands/generate-capabilities.d.ts +8 -0
  98. package/dist/cli/commands/generate-capabilities.d.ts.map +1 -0
  99. package/dist/cli/commands/generate-capabilities.js +40 -0
  100. package/dist/cli/commands/generate-capabilities.js.map +1 -0
  101. package/dist/cli/commands/generate-cli-command.d.ts +8 -0
  102. package/dist/cli/commands/generate-cli-command.d.ts.map +1 -0
  103. package/dist/cli/commands/generate-cli-command.js +64 -0
  104. package/dist/cli/commands/generate-cli-command.js.map +1 -0
  105. package/dist/cli/commands/generate-page.d.ts +9 -0
  106. package/dist/cli/commands/generate-page.d.ts.map +1 -0
  107. package/dist/cli/commands/generate-page.js +578 -0
  108. package/dist/cli/commands/generate-page.js.map +1 -0
  109. package/dist/cli/commands/generate-skill.d.ts +8 -0
  110. package/dist/cli/commands/generate-skill.d.ts.map +1 -0
  111. package/dist/cli/commands/generate-skill.js +75 -0
  112. package/dist/cli/commands/generate-skill.js.map +1 -0
  113. package/dist/cli/commands/generate.d.ts +6 -0
  114. package/dist/cli/commands/generate.d.ts.map +1 -0
  115. package/dist/cli/commands/generate.js +17 -0
  116. package/dist/cli/commands/generate.js.map +1 -0
  117. package/dist/cli/commands/init.d.ts +8 -0
  118. package/dist/cli/commands/init.d.ts.map +1 -0
  119. package/dist/cli/commands/init.js +539 -0
  120. package/dist/cli/commands/init.js.map +1 -0
  121. package/dist/cli/commands/observe.d.ts +9 -0
  122. package/dist/cli/commands/observe.d.ts.map +1 -0
  123. package/dist/cli/commands/observe.js +142 -0
  124. package/dist/cli/commands/observe.js.map +1 -0
  125. package/dist/cli/commands/skill.d.ts +9 -0
  126. package/dist/cli/commands/skill.d.ts.map +1 -0
  127. package/dist/cli/commands/skill.js +186 -0
  128. package/dist/cli/commands/skill.js.map +1 -0
  129. package/dist/cli/helpers/duration.d.ts +5 -0
  130. package/dist/cli/helpers/duration.d.ts.map +1 -0
  131. package/dist/cli/helpers/duration.js +19 -0
  132. package/dist/cli/helpers/duration.js.map +1 -0
  133. package/dist/cli/helpers/field-template.d.ts +10 -0
  134. package/dist/cli/helpers/field-template.d.ts.map +1 -0
  135. package/dist/cli/helpers/field-template.js +100 -0
  136. package/dist/cli/helpers/field-template.js.map +1 -0
  137. package/dist/cli/helpers/naming.d.ts +12 -0
  138. package/dist/cli/helpers/naming.d.ts.map +1 -0
  139. package/dist/cli/helpers/naming.js +25 -0
  140. package/dist/cli/helpers/naming.js.map +1 -0
  141. package/dist/cli/index.d.ts +9 -0
  142. package/dist/cli/index.d.ts.map +1 -0
  143. package/dist/cli/index.js +33 -0
  144. package/dist/cli/index.js.map +1 -0
  145. package/dist/cli/utils.d.ts +10 -0
  146. package/dist/cli/utils.d.ts.map +1 -0
  147. package/dist/cli/utils.js +31 -0
  148. package/dist/cli/utils.js.map +1 -0
  149. package/dist/config.d.ts +8 -40
  150. package/dist/config.d.ts.map +1 -1
  151. package/dist/config.js +6 -8
  152. package/dist/config.js.map +1 -1
  153. package/dist/index.d.ts +6 -1
  154. package/dist/index.d.ts.map +1 -1
  155. package/dist/index.js +6 -0
  156. package/dist/index.js.map +1 -1
  157. package/dist/server-bin.d.ts +12 -0
  158. package/dist/server-bin.d.ts.map +1 -0
  159. package/dist/server-bin.js +75 -0
  160. package/dist/server-bin.js.map +1 -0
  161. package/dist/types.d.ts +33 -20
  162. package/dist/types.d.ts.map +1 -1
  163. package/package.json +24 -11
  164. package/templates/app-skill/SKILL.md +27 -0
  165. package/templates/app-skill/references/data-semantics.md +44 -0
  166. package/templates/app-skill/references/models.md +31 -0
  167. package/templates/loom-skill/SKILL.md +140 -0
  168. package/templates/loom-skill/references/README.md +128 -0
  169. package/templates/loom-skill/references/data-model.md +78 -0
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Routes - Barrel Export
3
+ */
4
+ export { registerDataRoutes } from './data.js';
5
+ export { registerHealthRoute } from './health.js';
6
+ export { registerUploadRoutes, saveUploadedFile } from './upload.js';
7
+ export { registerChatRoutes } from './chat.js';
8
+ export type { ChatRouteOptions } from './chat.js';
9
+ export { registerSkillRoutes } from './skills.js';
10
+ export type { SkillRouteOptions } from './skills.js';
11
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Routes - Barrel Export
3
+ */
4
+ export { registerDataRoutes } from './data.js';
5
+ export { registerHealthRoute } from './health.js';
6
+ export { registerUploadRoutes, saveUploadedFile } from './upload.js';
7
+ export { registerChatRoutes } from './chat.js';
8
+ export { registerSkillRoutes } from './skills.js';
9
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/routes/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,16 @@
1
+ /**
2
+ * Skill Management Routes - REST API for managing skills in .claude/skills/
3
+ *
4
+ * POST /api/v1/skills — Create a new skill
5
+ * GET /api/v1/skills — List all skills with metadata
6
+ * GET /api/v1/skills/:skillName — Get skill details
7
+ * DELETE /api/v1/skills/:skillName — Delete a skill
8
+ * GET /api/v1/skills/:skillName/file/:filePath — Get a file's content
9
+ * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
10
+ */
11
+ import type { FastifyInstance } from 'fastify';
12
+ export interface SkillRouteOptions {
13
+ projectRoot: string;
14
+ }
15
+ export declare function registerSkillRoutes(fastify: FastifyInstance, options: SkillRouteOptions): void;
16
+ //# sourceMappingURL=skills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA0O/C,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,iBAAiB,GACzB,IAAI,CAoMN"}
@@ -0,0 +1,365 @@
1
+ /**
2
+ * Skill Management Routes - REST API for managing skills in .claude/skills/
3
+ *
4
+ * POST /api/v1/skills — Create a new skill
5
+ * GET /api/v1/skills — List all skills with metadata
6
+ * GET /api/v1/skills/:skillName — Get skill details
7
+ * DELETE /api/v1/skills/:skillName — Delete a skill
8
+ * GET /api/v1/skills/:skillName/file/:filePath — Get a file's content
9
+ * POST /api/v1/skills/:skillName/file — Upload/replace a file in a skill
10
+ */
11
+ import { promises as fs } from 'node:fs';
12
+ import path from 'node:path';
13
+ // ── Schemas ──
14
+ const skillNameParamSchema = {
15
+ type: 'object',
16
+ required: ['skillName'],
17
+ properties: {
18
+ skillName: { type: 'string', minLength: 1 },
19
+ },
20
+ };
21
+ const createSkillBodySchema = {
22
+ type: 'object',
23
+ required: ['name'],
24
+ properties: {
25
+ name: { type: 'string', minLength: 1, maxLength: 64 },
26
+ skillMd: { type: 'string' },
27
+ references: {
28
+ type: 'array',
29
+ items: {
30
+ type: 'object',
31
+ required: ['name', 'content'],
32
+ properties: {
33
+ name: { type: 'string' },
34
+ content: { type: 'string' },
35
+ },
36
+ },
37
+ },
38
+ },
39
+ };
40
+ const uploadFileBodySchema = {
41
+ type: 'object',
42
+ required: ['filename', 'content'],
43
+ properties: {
44
+ filename: { type: 'string', minLength: 1 },
45
+ content: { type: 'string' },
46
+ },
47
+ };
48
+ // ── Helpers ─
49
+ /**
50
+ * Parse YAML frontmatter from markdown content using simple regex.
51
+ */
52
+ function parseFrontmatter(content) {
53
+ const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
54
+ if (!match)
55
+ return { metadata: {}, body: content };
56
+ try {
57
+ const metadata = {};
58
+ const lines = match[1].split('\n');
59
+ let currentKey = '';
60
+ let currentValues = [];
61
+ let inArray = false;
62
+ let inBlock = false;
63
+ let blockLines = [];
64
+ const flushBlock = () => {
65
+ if (inBlock && currentKey) {
66
+ metadata[currentKey] = blockLines.join('\n').trim();
67
+ }
68
+ inBlock = false;
69
+ blockLines = [];
70
+ };
71
+ for (const line of lines) {
72
+ if (inBlock) {
73
+ if (/^[ \t]+/.test(line) || (line === '' && blockLines.length > 0)) {
74
+ blockLines.push(line.replace(/^[ \t]+/, ''));
75
+ continue;
76
+ }
77
+ else {
78
+ flushBlock();
79
+ }
80
+ }
81
+ const trimmed = line.trim();
82
+ if (!trimmed)
83
+ continue;
84
+ const arrayMatch = trimmed.match(/^-\s+(.+)$/);
85
+ if (inArray && arrayMatch) {
86
+ currentValues.push(arrayMatch[1].replace(/^['"]|['"]$/g, '').trim());
87
+ continue;
88
+ }
89
+ if (inArray && currentKey) {
90
+ metadata[currentKey] = currentValues;
91
+ inArray = false;
92
+ currentValues = [];
93
+ }
94
+ const kvMatch = trimmed.match(/^([a-zA-Z_-][a-zA-Z0-9_-]*):\s*(.*)$/);
95
+ if (kvMatch) {
96
+ currentKey = kvMatch[1];
97
+ let val = kvMatch[2].trim();
98
+ if ((val.startsWith("'") && val.endsWith("'")) || (val.startsWith('"') && val.endsWith('"'))) {
99
+ val = val.slice(1, -1);
100
+ }
101
+ if (val === '|' || val === '>') {
102
+ inBlock = true;
103
+ blockLines = [];
104
+ continue;
105
+ }
106
+ if (val === '[') {
107
+ inArray = true;
108
+ currentValues = [];
109
+ continue;
110
+ }
111
+ if (val.startsWith('[') && val.endsWith(']')) {
112
+ metadata[currentKey] = val.slice(1, -1).split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
113
+ currentKey = '';
114
+ continue;
115
+ }
116
+ metadata[currentKey] = val;
117
+ currentKey = '';
118
+ }
119
+ }
120
+ if (inArray && currentKey) {
121
+ metadata[currentKey] = currentValues;
122
+ }
123
+ flushBlock();
124
+ return { metadata, body: match[2] || '' };
125
+ }
126
+ catch {
127
+ return { metadata: {}, body: content };
128
+ }
129
+ }
130
+ /**
131
+ * Recursively scan a directory for files, returning relative paths.
132
+ * Excludes SKILL.md (handled separately).
133
+ */
134
+ async function scanDirFiles(dir, base) {
135
+ const results = [];
136
+ let entries;
137
+ try {
138
+ entries = await fs.readdir(dir, { withFileTypes: true });
139
+ }
140
+ catch {
141
+ return results;
142
+ }
143
+ for (const entry of entries) {
144
+ if (entry.isDirectory()) {
145
+ const subFiles = await scanDirFiles(path.join(dir, entry.name), base);
146
+ results.push(...subFiles);
147
+ }
148
+ else {
149
+ const relPath = path.relative(base, path.join(dir, entry.name));
150
+ results.push(relPath);
151
+ }
152
+ }
153
+ return results;
154
+ }
155
+ /**
156
+ * Safely resolve a file path within a directory. Rejects '..' traversal.
157
+ */
158
+ function safeResolve(baseDir, filePath) {
159
+ if (filePath.includes('..'))
160
+ return null;
161
+ const resolved = path.resolve(baseDir, filePath);
162
+ if (!resolved.startsWith(baseDir))
163
+ return null;
164
+ return resolved;
165
+ }
166
+ /**
167
+ * Validate skill name.
168
+ */
169
+ function isValidSkillName(name) {
170
+ return /^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name);
171
+ }
172
+ /**
173
+ * Get MIME type for a file extension.
174
+ */
175
+ function getContentType(filePath) {
176
+ const ext = path.extname(filePath).toLowerCase();
177
+ const types = {
178
+ '.md': 'text/markdown',
179
+ '.txt': 'text/plain',
180
+ '.json': 'application/json',
181
+ '.xml': 'application/xml',
182
+ '.yaml': 'text/yaml',
183
+ '.yml': 'text/yaml',
184
+ '.ts': 'text/typescript',
185
+ '.js': 'text/javascript',
186
+ '.html': 'text/html',
187
+ '.css': 'text/css',
188
+ };
189
+ return types[ext] || 'text/plain';
190
+ }
191
+ export function registerSkillRoutes(fastify, options) {
192
+ const skillsDir = path.join(options.projectRoot, '.claude', 'skills');
193
+ const ensureSkillsDir = async () => {
194
+ await fs.mkdir(skillsDir, { recursive: true });
195
+ };
196
+ // ── GET /api/v1/skills ──
197
+ fastify.get('/api/v1/skills', async (_request, reply) => {
198
+ await ensureSkillsDir();
199
+ let entries;
200
+ try {
201
+ entries = await fs.readdir(skillsDir, { withFileTypes: true });
202
+ }
203
+ catch {
204
+ return reply.send({ data: [] });
205
+ }
206
+ const skills = [];
207
+ for (const entry of entries) {
208
+ if (!entry.isDirectory())
209
+ continue;
210
+ const skillDir = path.join(skillsDir, entry.name);
211
+ const skillMdPath = path.join(skillDir, 'SKILL.md');
212
+ let metadata = {};
213
+ try {
214
+ const content = await fs.readFile(skillMdPath, 'utf-8');
215
+ metadata = parseFrontmatter(content).metadata;
216
+ }
217
+ catch {
218
+ // SKILL.md doesn't exist or is unreadable
219
+ }
220
+ // Scan subdirectories dynamically (any folder name, not just 'references')
221
+ let subDirs = [];
222
+ try {
223
+ const dirEntries = await fs.readdir(skillDir, { withFileTypes: true });
224
+ subDirs = dirEntries.filter((e) => e.isDirectory()).map((e) => e.name);
225
+ }
226
+ catch {
227
+ // ignore
228
+ }
229
+ skills.push({ name: entry.name, metadata, subDirs });
230
+ }
231
+ return reply.send({ data: skills });
232
+ });
233
+ // ── GET /api/v1/skills/:skillName ──
234
+ fastify.get('/api/v1/skills/:skillName', {
235
+ schema: { params: skillNameParamSchema },
236
+ }, async (request, reply) => {
237
+ const { skillName } = request.params;
238
+ const skillDir = path.join(skillsDir, skillName);
239
+ const exists = await fs.access(skillDir).then(() => true, () => false);
240
+ if (!exists) {
241
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
242
+ }
243
+ let skillMd = '';
244
+ let metadata = {};
245
+ try {
246
+ skillMd = await fs.readFile(path.join(skillDir, 'SKILL.md'), 'utf-8');
247
+ metadata = parseFrontmatter(skillMd).metadata;
248
+ }
249
+ catch {
250
+ // SKILL.md doesn't exist
251
+ }
252
+ // Dynamically scan all files in subdirectories
253
+ const allFiles = await scanDirFiles(skillDir, skillDir);
254
+ const files = allFiles.map((p) => ({
255
+ name: path.basename(p),
256
+ path: p,
257
+ }));
258
+ return reply.send({ data: { name: skillName, metadata, skillMd, files } });
259
+ });
260
+ // ── GET /api/v1/skills/:skillName/file/* ──
261
+ fastify.get('/api/v1/skills/:skillName/file/*', async (request, reply) => {
262
+ const { skillName } = request.params;
263
+ const filePath = request.params['*'];
264
+ const skillDir = path.join(skillsDir, skillName);
265
+ const exists = await fs.access(skillDir).then(() => true, () => false);
266
+ if (!exists) {
267
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
268
+ }
269
+ const resolvedPath = safeResolve(skillDir, filePath);
270
+ if (!resolvedPath) {
271
+ return reply.status(400).send({ error: 'Invalid file path' });
272
+ }
273
+ const fileExists = await fs.access(resolvedPath).then(() => true, () => false);
274
+ if (!fileExists) {
275
+ return reply.status(404).send({ error: `File "${filePath}" not found` });
276
+ }
277
+ try {
278
+ const content = await fs.readFile(resolvedPath, 'utf-8');
279
+ return reply.send({ data: { content, path: filePath } });
280
+ }
281
+ catch (err) {
282
+ return reply.status(500).send({ error: `Failed to read file: ${err}` });
283
+ }
284
+ });
285
+ // ── POST /api/v1/skills ──
286
+ fastify.post('/api/v1/skills', {
287
+ schema: { body: createSkillBodySchema },
288
+ }, async (request, reply) => {
289
+ const body = request.body;
290
+ const { name, skillMd, references } = body;
291
+ if (!isValidSkillName(name)) {
292
+ return reply.status(400).send({ error: 'Invalid skill name. Use alphanumeric, hyphens, and underscores only.' });
293
+ }
294
+ const skillDir = path.join(skillsDir, name);
295
+ const exists = await fs.access(skillDir).then(() => true, () => false);
296
+ if (exists) {
297
+ return reply.status(409).send({ error: `Skill "${name}" already exists` });
298
+ }
299
+ await fs.mkdir(skillDir, { recursive: true });
300
+ const contentToWrite = skillMd || `---
301
+ name: ${name}
302
+ description: ''
303
+ version: 1.0.0
304
+ ---
305
+
306
+ # ${name}
307
+
308
+ ## Overview
309
+
310
+ [Describe what this skill does]
311
+
312
+ ## Usage Scenarios
313
+
314
+ - "User prompt" → [what the skill does]
315
+ `;
316
+ await fs.writeFile(path.join(skillDir, 'SKILL.md'), contentToWrite, 'utf-8');
317
+ if (references && references.length > 0) {
318
+ const refDir = path.join(skillDir, 'references');
319
+ await fs.mkdir(refDir, { recursive: true });
320
+ for (const ref of references) {
321
+ const safePath = safeResolve(refDir, ref.name);
322
+ if (safePath) {
323
+ await fs.mkdir(path.dirname(safePath), { recursive: true });
324
+ await fs.writeFile(safePath, ref.content, 'utf-8');
325
+ }
326
+ }
327
+ }
328
+ const metadata = parseFrontmatter(contentToWrite).metadata;
329
+ return reply.code(201).send({ data: { name, metadata } });
330
+ });
331
+ // ── DELETE /api/v1/skills/:skillName ──
332
+ fastify.delete('/api/v1/skills/:skillName', {
333
+ schema: { params: skillNameParamSchema },
334
+ }, async (request, reply) => {
335
+ const { skillName } = request.params;
336
+ const skillDir = path.join(skillsDir, skillName);
337
+ const exists = await fs.access(skillDir).then(() => true, () => false);
338
+ if (!exists) {
339
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
340
+ }
341
+ await fs.rm(skillDir, { recursive: true, force: true });
342
+ return reply.send({ success: true });
343
+ });
344
+ // ── POST /api/v1/skills/:skillName/file ──
345
+ fastify.post('/api/v1/skills/:skillName/file', {
346
+ schema: { params: skillNameParamSchema, body: uploadFileBodySchema },
347
+ }, async (request, reply) => {
348
+ const { skillName } = request.params;
349
+ const body = request.body;
350
+ const { filename, content } = body;
351
+ const skillDir = path.join(skillsDir, skillName);
352
+ const exists = await fs.access(skillDir).then(() => true, () => false);
353
+ if (!exists) {
354
+ return reply.status(404).send({ error: `Skill "${skillName}" not found` });
355
+ }
356
+ const resolvedPath = safeResolve(skillDir, filename);
357
+ if (!resolvedPath) {
358
+ return reply.status(400).send({ error: 'Invalid file path' });
359
+ }
360
+ await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
361
+ await fs.writeFile(resolvedPath, content, 'utf-8');
362
+ return reply.send({ success: true, path: filename });
363
+ });
364
+ }
365
+ //# sourceMappingURL=skills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/backend/routes/skills.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * Upload Routes - File upload and static serving
3
+ *
4
+ * Handles base64 file uploads via SSE chat and provides
5
+ * static file serving for uploaded files.
6
+ */
7
+ import type { FastifyInstance } from 'fastify';
8
+ export interface UploadRouteOptions {
9
+ /** Project root directory */
10
+ projectRoot: string;
11
+ }
12
+ /**
13
+ * Register upload and static file serving routes
14
+ */
15
+ export declare function registerUploadRoutes(fastify: FastifyInstance, options: UploadRouteOptions): void;
16
+ /**
17
+ * Save an uploaded file from base64 data
18
+ * Returns the relative URL path for accessing the file
19
+ */
20
+ export declare function saveUploadedFile(projectRoot: string, sessionId: string, filename: string, base64Data: string): Promise<{
21
+ url: string;
22
+ path: string;
23
+ }>;
24
+ //# sourceMappingURL=upload.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/upload.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAI/C,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CA8CN;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAYxC"}
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Upload Routes - File upload and static serving
3
+ *
4
+ * Handles base64 file uploads via SSE chat and provides
5
+ * static file serving for uploaded files.
6
+ */
7
+ import { promises as fs } from 'fs';
8
+ import path from 'path';
9
+ /**
10
+ * Register upload and static file serving routes
11
+ */
12
+ export function registerUploadRoutes(fastify, options) {
13
+ const uploadsDir = path.join(options.projectRoot, '.loom', 'uploads');
14
+ // Ensure uploads directory exists
15
+ fs.mkdir(uploadsDir, { recursive: true }).catch(() => { });
16
+ // Serve uploaded files: GET /uploads/:sessionId/:filename
17
+ fastify.get('/uploads/:sessionId/:filename', async (request, reply) => {
18
+ const { sessionId, filename } = request.params;
19
+ // Sanitize path components to prevent directory traversal
20
+ const sanitizedSessionId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '');
21
+ const sanitizedFilename = filename.replace(/[^a-zA-Z0-9._-]/g, '');
22
+ if (!sanitizedSessionId || !sanitizedFilename) {
23
+ return reply.status(400).send({ error: 'Invalid path parameters' });
24
+ }
25
+ const filePath = path.join(uploadsDir, sanitizedSessionId, sanitizedFilename);
26
+ // Ensure resolved path is within uploads directory
27
+ const resolvedPath = path.resolve(filePath);
28
+ if (!resolvedPath.startsWith(path.resolve(uploadsDir))) {
29
+ return reply.status(403).send({ error: 'Access denied' });
30
+ }
31
+ try {
32
+ const buffer = await fs.readFile(filePath);
33
+ const ext = path.extname(sanitizedFilename).toLowerCase();
34
+ const contentTypes = {
35
+ '.png': 'image/png',
36
+ '.jpg': 'image/jpeg',
37
+ '.jpeg': 'image/jpeg',
38
+ '.gif': 'image/gif',
39
+ '.pdf': 'application/pdf',
40
+ '.txt': 'text/plain',
41
+ '.json': 'application/json',
42
+ '.csv': 'text/csv',
43
+ };
44
+ reply.header('Content-Type', contentTypes[ext] || 'application/octet-stream');
45
+ return reply.send(buffer);
46
+ }
47
+ catch {
48
+ return reply.status(404).send({ error: 'File not found' });
49
+ }
50
+ });
51
+ }
52
+ /**
53
+ * Save an uploaded file from base64 data
54
+ * Returns the relative URL path for accessing the file
55
+ */
56
+ export async function saveUploadedFile(projectRoot, sessionId, filename, base64Data) {
57
+ const uploadsDir = path.join(projectRoot, '.loom', 'uploads', sessionId);
58
+ await fs.mkdir(uploadsDir, { recursive: true });
59
+ const filePath = path.join(uploadsDir, filename);
60
+ const buffer = Buffer.from(base64Data, 'base64');
61
+ await fs.writeFile(filePath, buffer);
62
+ return {
63
+ url: `/uploads/${sessionId}/${filename}`,
64
+ path: filePath,
65
+ };
66
+ }
67
+ //# sourceMappingURL=upload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/backend/routes/upload.ts"],"names":[],"mappings":"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"}
package/dist/bin.d.ts ADDED
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Loom CLI - Entry Point
4
+ *
5
+ * Project scaffolding, development, data operations, skill management
6
+ */
7
+ export {};
8
+ //# sourceMappingURL=bin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}
package/dist/bin.js ADDED
@@ -0,0 +1,12 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Loom CLI - Entry Point
4
+ *
5
+ * Project scaffolding, development, data operations, skill management
6
+ */
7
+ import { run } from './cli/index.js';
8
+ run().catch((err) => {
9
+ console.error(err.message || err);
10
+ process.exit(1);
11
+ });
12
+ //# sourceMappingURL=bin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;GAIG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAErC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
@@ -1,20 +1,35 @@
1
1
  /**
2
2
  * Capability Generator
3
3
  *
4
- * Core innovation: One schema definition → MCP Server + CLI commands
4
+ * Core innovation: One schema definition → Skill + CLI data access
5
5
  *
6
6
  * From loom.config.ts model definitions, generates:
7
- * 1. MCP Server (.loom/mcp-server/) - structured data CRUD tools
8
- * 2. CLI data commands (cli/commands/data/) - dev/debug data access
9
- * 3. MCP config (.loom/mcp.json) - Claude Code MCP registration
7
+ * 1. SKILL.md guided instructions for AI to write natural language (only on first run, never overwritten)
8
+ * 2. references/models.md auto-generated structural content (always overwritten on generate)
9
+ * 3. references/data-semantics.md — AI-driven semantic guidance (always overwritten on generate)
10
+ *
11
+ * Template files live in templates/app-skill/ — static content is defined there,
12
+ * dynamic content (model tables, AI buttons) is filled in by code.
10
13
  */
11
14
  import type { LoomConfig } from './types.js';
12
15
  export interface GenerateResult {
13
- mcpServerDir: string;
16
+ /** Path to the generated skill directory */
17
+ skillDir: string;
18
+ /** Path to the SKILL.md file */
19
+ skillPromptFile: string;
20
+ /** Path to the references/models.md file */
21
+ modelsFile: string;
22
+ /** Path to the references/data-semantics.md file */
23
+ dataSemanticsFile: string;
14
24
  filesWritten: string[];
15
25
  }
16
26
  /**
17
- * Generate all capabilities from config
27
+ * Generate all capabilities from config.
28
+ *
29
+ * Three-file strategy:
30
+ * - SKILL.md: natural language content (only created if not exists, never overwritten)
31
+ * - references/models.md: structural content (always regenerated)
32
+ * - references/data-semantics.md: semantic guidance (always regenerated)
18
33
  */
19
34
  export declare function generateCapabilities(projectRoot: string, config: LoomConfig): Promise<GenerateResult>;
20
35
  //# sourceMappingURL=capability-generator.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"capability-generator.d.ts","sourceRoot":"","sources":["../src/capability-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAe,UAAU,EAAmB,MAAM,YAAY,CAAC;AA6N3E,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,CAAC,CA+EzB"}
1
+ {"version":3,"file":"capability-generator.d.ts","sourceRoot":"","sources":["../src/capability-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAe,UAAU,EAAmB,MAAM,YAAY,CAAC;AA2D3E,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,cAAc,CAAC,CA+CzB"}