@wrongstack/core 0.4.1 → 0.5.2
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.
- package/dist/{agent-bridge-DaOnnHNW.d.ts → agent-bridge-EiUFe3if.d.ts} +1 -1
- package/dist/{compactor-CFky6JKM.d.ts → compactor-BP4xhKVi.d.ts} +1 -1
- package/dist/{config-RlhKLjme.d.ts → config-BOD_HQBw.d.ts} +1 -1
- package/dist/{context-B1kBj1lY.d.ts → context-PH4DvBZV.d.ts} +60 -1
- package/dist/coordination/index.d.ts +10 -891
- package/dist/coordination/index.js +500 -238
- package/dist/coordination/index.js.map +1 -1
- package/dist/defaults/index.d.ts +20 -19
- package/dist/defaults/index.js +2210 -264
- package/dist/defaults/index.js.map +1 -1
- package/dist/director-state-CVzkjKRZ.d.ts +539 -0
- package/dist/{events-BBaKeMfb.d.ts → events-oxn-Wkub.d.ts} +58 -1
- package/dist/execution/index.d.ts +19 -13
- package/dist/execution/index.js +15 -6
- package/dist/execution/index.js.map +1 -1
- package/dist/extension/index.d.ts +6 -6
- package/dist/index-CcbWbcpy.d.ts +899 -0
- package/dist/{index-meJRuQtc.d.ts → index-a12jc7-r.d.ts} +8 -6
- package/dist/index.d.ts +33 -28
- package/dist/index.js +3798 -1237
- package/dist/index.js.map +1 -1
- package/dist/infrastructure/index.d.ts +6 -6
- package/dist/infrastructure/index.js +67 -2
- package/dist/infrastructure/index.js.map +1 -1
- package/dist/kernel/index.d.ts +10 -9
- package/dist/kernel/index.js.map +1 -1
- package/dist/{mcp-servers-Cf4-bJnd.d.ts → mcp-servers-uPmBxZ1B.d.ts} +18 -3
- package/dist/models/index.d.ts +2 -2
- package/dist/models/index.js +106 -0
- package/dist/models/index.js.map +1 -1
- package/dist/{multi-agent-D5m66hzB.d.ts → multi-agent-D6S4Z7H8.d.ts} +71 -16
- package/dist/observability/index.d.ts +2 -2
- package/dist/{path-resolver-Bg4OP5fi.d.ts → path-resolver-CprD5DhS.d.ts} +9 -2
- package/dist/{provider-runner-CU9gnU2E.d.ts → provider-runner-DGisz_lG.d.ts} +3 -3
- package/dist/{skill-DayhFUBb.d.ts → retry-policy-DUJ8-Qc_.d.ts} +2 -28
- package/dist/sdd/index.d.ts +419 -5
- package/dist/sdd/index.js +1580 -1
- package/dist/sdd/index.js.map +1 -1
- package/dist/{secret-scrubber-DyUAWS09.d.ts → secret-scrubber-CB11A2P7.d.ts} +1 -1
- package/dist/{secret-scrubber-Dyh5LVYL.d.ts → secret-scrubber-EqFa0SyI.d.ts} +1 -1
- package/dist/security/index.d.ts +8 -4
- package/dist/security/index.js +8 -0
- package/dist/security/index.js.map +1 -1
- package/dist/{selector-DBEiwXBk.d.ts → selector-yqyxt-Ii.d.ts} +1 -1
- package/dist/{session-reader-D-z0AgHs.d.ts → session-reader-1tOyoY1s.d.ts} +1 -1
- package/dist/session-rewinder-C9HnMkhP.d.ts +23 -0
- package/dist/skill-CxuWrsKK.d.ts +29 -0
- package/dist/skills/index.d.ts +136 -0
- package/dist/skills/index.js +478 -0
- package/dist/skills/index.js.map +1 -0
- package/dist/storage/index.d.ts +21 -534
- package/dist/storage/index.js +246 -3
- package/dist/storage/index.js.map +1 -1
- package/dist/{system-prompt-DNetCecu.d.ts → system-prompt-BJlzKGO6.d.ts} +1 -1
- package/dist/{tool-executor-B5bgmEgE.d.ts → tool-executor-B6kRcWeF.d.ts} +4 -4
- package/dist/types/index.d.ts +17 -15
- package/dist/types/index.js +116 -0
- package/dist/types/index.js.map +1 -1
- package/dist/utils/index.d.ts +35 -2
- package/dist/utils/index.js +49 -1
- package/dist/utils/index.js.map +1 -1
- package/package.json +5 -1
- package/skills/sdd/SKILL.md +93 -6
- package/skills/skill-creator/SKILL.md +98 -0
|
@@ -0,0 +1,478 @@
|
|
|
1
|
+
import * as fs3 from 'fs/promises';
|
|
2
|
+
import * as path3 from 'path';
|
|
3
|
+
import * as os from 'os';
|
|
4
|
+
import { createGunzip } from 'zlib';
|
|
5
|
+
import { Readable } from 'stream';
|
|
6
|
+
import { pipeline } from 'stream/promises';
|
|
7
|
+
|
|
8
|
+
// src/skills/skill-installer.ts
|
|
9
|
+
function parseSkillRef(input) {
|
|
10
|
+
const trimmed = input.trim().replace(/^https?:\/\/github\.com\//, "").replace(/\.git$/, "");
|
|
11
|
+
const atIdx = trimmed.indexOf("@");
|
|
12
|
+
let refPath;
|
|
13
|
+
let ref;
|
|
14
|
+
if (atIdx > 0) {
|
|
15
|
+
refPath = trimmed.slice(0, atIdx);
|
|
16
|
+
ref = trimmed.slice(atIdx + 1);
|
|
17
|
+
} else {
|
|
18
|
+
refPath = trimmed;
|
|
19
|
+
ref = "main";
|
|
20
|
+
}
|
|
21
|
+
const parts = refPath.split("/").filter(Boolean);
|
|
22
|
+
if (parts.length < 2) {
|
|
23
|
+
throw new Error(`Invalid skill reference "${input}". Expected format: user/repo or user/repo@ref`);
|
|
24
|
+
}
|
|
25
|
+
return { owner: parts[0], repo: parts[1], ref };
|
|
26
|
+
}
|
|
27
|
+
var MAX_TARBALL_SIZE = 50 * 1024 * 1024;
|
|
28
|
+
async function downloadGitHubTarball(parsed) {
|
|
29
|
+
const url = `https://api.github.com/repos/${parsed.owner}/${parsed.repo}/tarball/${parsed.ref}`;
|
|
30
|
+
const response = await fetch(url, {
|
|
31
|
+
headers: {
|
|
32
|
+
Accept: "application/vnd.github+json",
|
|
33
|
+
"User-Agent": "wrongstack-skill-installer"
|
|
34
|
+
},
|
|
35
|
+
redirect: "follow"
|
|
36
|
+
});
|
|
37
|
+
if (!response.ok) {
|
|
38
|
+
if (response.status === 404) {
|
|
39
|
+
throw new Error(
|
|
40
|
+
`Repository not found: ${parsed.owner}/${parsed.repo}` + (parsed.ref !== "main" ? ` (ref: ${parsed.ref})` : "")
|
|
41
|
+
);
|
|
42
|
+
}
|
|
43
|
+
if (response.status === 403) {
|
|
44
|
+
throw new Error(
|
|
45
|
+
`Access denied: ${parsed.owner}/${parsed.repo}. The repository may be private or rate-limited.`
|
|
46
|
+
);
|
|
47
|
+
}
|
|
48
|
+
throw new Error(`GitHub API error (${response.status}): ${response.statusText}`);
|
|
49
|
+
}
|
|
50
|
+
const contentLength = response.headers.get("content-length");
|
|
51
|
+
if (contentLength && Number.parseInt(contentLength, 10) > MAX_TARBALL_SIZE) {
|
|
52
|
+
throw new Error(
|
|
53
|
+
`Tarball too large (${(Number.parseInt(contentLength, 10) / 1024 / 1024).toFixed(1)}MB). Max: ${MAX_TARBALL_SIZE / 1024 / 1024}MB`
|
|
54
|
+
);
|
|
55
|
+
}
|
|
56
|
+
const tempDir = await fs3.mkdtemp(path3.join(os.tmpdir(), "wskill-"));
|
|
57
|
+
try {
|
|
58
|
+
if (!response.body) {
|
|
59
|
+
throw new Error("Empty response body from GitHub API");
|
|
60
|
+
}
|
|
61
|
+
const nodeStream = Readable.fromWeb(response.body);
|
|
62
|
+
const gunzip = createGunzip();
|
|
63
|
+
const chunks = [];
|
|
64
|
+
await pipeline(nodeStream, gunzip, async (source) => {
|
|
65
|
+
for await (const chunk of source) {
|
|
66
|
+
chunks.push(Buffer.from(chunk));
|
|
67
|
+
}
|
|
68
|
+
});
|
|
69
|
+
const tarBuf = Buffer.concat(chunks);
|
|
70
|
+
await extractTar(tarBuf, tempDir);
|
|
71
|
+
return { tempDir };
|
|
72
|
+
} catch (err) {
|
|
73
|
+
await fs3.rm(tempDir, { recursive: true, force: true }).catch(() => {
|
|
74
|
+
});
|
|
75
|
+
throw err;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
async function extractTar(buf, destDir) {
|
|
79
|
+
let offset = 0;
|
|
80
|
+
while (offset + 512 <= buf.length) {
|
|
81
|
+
const header = buf.subarray(offset, offset + 512);
|
|
82
|
+
if (header.every((b) => b === 0)) break;
|
|
83
|
+
const name = readTarString(buf, offset, 100);
|
|
84
|
+
const prefix = readTarString(buf, offset + 345, 155);
|
|
85
|
+
const size = Number.parseInt(readTarString(buf, offset + 124, 12).trim(), 8) || 0;
|
|
86
|
+
const typeflag = buf[offset + 156] ?? 0;
|
|
87
|
+
const fullPath = prefix ? `${prefix}/${name}` : name;
|
|
88
|
+
const relPath = stripTopDir(fullPath);
|
|
89
|
+
if (relPath && relPath !== "." && relPath !== "..") {
|
|
90
|
+
const destPath = path3.join(destDir, relPath);
|
|
91
|
+
if (typeflag === 53 || typeflag === 0) {
|
|
92
|
+
if (relPath.endsWith("/") || typeflag === 53) {
|
|
93
|
+
await fs3.mkdir(destPath, { recursive: true });
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
if ((typeflag === 48 || typeflag === 0 || typeflag === 0) && size > 0) {
|
|
97
|
+
const dir = path3.dirname(destPath);
|
|
98
|
+
await fs3.mkdir(dir, { recursive: true });
|
|
99
|
+
const dataStart = offset + 512;
|
|
100
|
+
const dataEnd = dataStart + size;
|
|
101
|
+
if (dataEnd > buf.length) break;
|
|
102
|
+
await fs3.writeFile(destPath, buf.subarray(dataStart, dataEnd));
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
offset += 512 + Math.ceil(size / 512) * 512;
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
function readTarString(buf, start, maxLen) {
|
|
109
|
+
let end = start;
|
|
110
|
+
while (end < start + maxLen && end < buf.length && buf[end] !== 0) {
|
|
111
|
+
end++;
|
|
112
|
+
}
|
|
113
|
+
return buf.subarray(start, end).toString("utf8");
|
|
114
|
+
}
|
|
115
|
+
function stripTopDir(p) {
|
|
116
|
+
const idx = p.indexOf("/");
|
|
117
|
+
if (idx === -1) return "";
|
|
118
|
+
return p.slice(idx + 1);
|
|
119
|
+
}
|
|
120
|
+
var SkillManifestStore = class {
|
|
121
|
+
manifestPath;
|
|
122
|
+
cache;
|
|
123
|
+
constructor(manifestPath) {
|
|
124
|
+
this.manifestPath = manifestPath;
|
|
125
|
+
}
|
|
126
|
+
async read() {
|
|
127
|
+
if (this.cache) return this.cache;
|
|
128
|
+
try {
|
|
129
|
+
const raw = await fs3.readFile(this.manifestPath, "utf8");
|
|
130
|
+
const data = JSON.parse(raw);
|
|
131
|
+
if (!Array.isArray(data.skills)) {
|
|
132
|
+
this.cache = { skills: [] };
|
|
133
|
+
} else {
|
|
134
|
+
this.cache = data;
|
|
135
|
+
}
|
|
136
|
+
} catch {
|
|
137
|
+
this.cache = { skills: [] };
|
|
138
|
+
}
|
|
139
|
+
return this.cache;
|
|
140
|
+
}
|
|
141
|
+
async write(data) {
|
|
142
|
+
const dir = path3.dirname(this.manifestPath);
|
|
143
|
+
await fs3.mkdir(dir, { recursive: true });
|
|
144
|
+
await fs3.writeFile(this.manifestPath, JSON.stringify(data, null, 2) + "\n", "utf8");
|
|
145
|
+
this.cache = data;
|
|
146
|
+
}
|
|
147
|
+
async addEntry(entry) {
|
|
148
|
+
const data = await this.read();
|
|
149
|
+
data.skills = data.skills.filter(
|
|
150
|
+
(s) => !(s.name === entry.name && s.scope === entry.scope)
|
|
151
|
+
);
|
|
152
|
+
data.skills.push(entry);
|
|
153
|
+
await this.write(data);
|
|
154
|
+
}
|
|
155
|
+
async removeEntry(name, scope) {
|
|
156
|
+
const data = await this.read();
|
|
157
|
+
const before = data.skills.length;
|
|
158
|
+
data.skills = data.skills.filter(
|
|
159
|
+
(s) => !(s.name === name && s.scope === scope)
|
|
160
|
+
);
|
|
161
|
+
if (data.skills.length === before) return false;
|
|
162
|
+
await this.write(data);
|
|
163
|
+
return true;
|
|
164
|
+
}
|
|
165
|
+
async findByName(name) {
|
|
166
|
+
const data = await this.read();
|
|
167
|
+
return data.skills.filter((s) => s.name === name);
|
|
168
|
+
}
|
|
169
|
+
async findBySource(source) {
|
|
170
|
+
const data = await this.read();
|
|
171
|
+
return data.skills.filter((s) => s.source === source);
|
|
172
|
+
}
|
|
173
|
+
async listAll() {
|
|
174
|
+
const data = await this.read();
|
|
175
|
+
return data.skills;
|
|
176
|
+
}
|
|
177
|
+
/** Invalidate the in-memory cache (e.g. after external file changes). */
|
|
178
|
+
invalidateCache() {
|
|
179
|
+
this.cache = void 0;
|
|
180
|
+
}
|
|
181
|
+
};
|
|
182
|
+
|
|
183
|
+
// src/skills/skill-installer.ts
|
|
184
|
+
var MAX_SKILL_FILE_SIZE = 100 * 1024;
|
|
185
|
+
var SkillInstaller = class {
|
|
186
|
+
opts;
|
|
187
|
+
manifest;
|
|
188
|
+
constructor(opts) {
|
|
189
|
+
this.opts = opts;
|
|
190
|
+
this.manifest = new SkillManifestStore(opts.manifestPath);
|
|
191
|
+
}
|
|
192
|
+
/**
|
|
193
|
+
* Install skills from a GitHub repository.
|
|
194
|
+
* Supports both single-skill repos (SKILL.md at root) and multi-skill repos (skills/ subdirectory).
|
|
195
|
+
*/
|
|
196
|
+
async install(refInput, opts) {
|
|
197
|
+
const parsed = parseSkillRef(refInput);
|
|
198
|
+
const scope = opts?.global ? "user" : "project";
|
|
199
|
+
const targetDir = scope === "project" ? this.opts.projectSkillsDir : this.opts.globalSkillsDir;
|
|
200
|
+
const source = `github:${parsed.owner}/${parsed.repo}`;
|
|
201
|
+
this.opts.log?.(`Downloading ${parsed.owner}/${parsed.repo}@${parsed.ref}...`);
|
|
202
|
+
const { tempDir } = await downloadGitHubTarball(parsed);
|
|
203
|
+
try {
|
|
204
|
+
const skills = await this.detectSkills(tempDir);
|
|
205
|
+
if (skills.length === 0) {
|
|
206
|
+
throw new Error(
|
|
207
|
+
"No skills found in repository. Expected SKILL.md at root or skills/ subdirectory."
|
|
208
|
+
);
|
|
209
|
+
}
|
|
210
|
+
const results = [];
|
|
211
|
+
for (const skill of skills) {
|
|
212
|
+
const existing = await this.manifest.findByName(skill.name);
|
|
213
|
+
const existingInScope = existing.find((e) => e.scope === scope);
|
|
214
|
+
if (existingInScope) {
|
|
215
|
+
this.opts.log?.(`Overwriting existing skill "${skill.name}" (${scope})...`);
|
|
216
|
+
await this.removeSkillFiles(skill.name, scope);
|
|
217
|
+
}
|
|
218
|
+
const destDir = path3.join(targetDir, skill.name);
|
|
219
|
+
await fs3.mkdir(destDir, { recursive: true });
|
|
220
|
+
const copiedFiles = [];
|
|
221
|
+
for (const file of skill.files) {
|
|
222
|
+
const srcPath = path3.join(skill.baseDir, file);
|
|
223
|
+
const destPath = path3.join(destDir, file);
|
|
224
|
+
const resolved = path3.resolve(destPath);
|
|
225
|
+
if (!resolved.startsWith(path3.resolve(destDir))) {
|
|
226
|
+
throw new Error(`Path traversal detected in skill file: ${file}`);
|
|
227
|
+
}
|
|
228
|
+
const stat2 = await fs3.stat(srcPath);
|
|
229
|
+
if (stat2.size > MAX_SKILL_FILE_SIZE) {
|
|
230
|
+
throw new Error(
|
|
231
|
+
`Skill file "${file}" is too large (${(stat2.size / 1024).toFixed(1)}KB). Max: ${MAX_SKILL_FILE_SIZE / 1024}KB`
|
|
232
|
+
);
|
|
233
|
+
}
|
|
234
|
+
await fs3.mkdir(path3.dirname(destPath), { recursive: true });
|
|
235
|
+
await fs3.copyFile(srcPath, destPath);
|
|
236
|
+
copiedFiles.push(file);
|
|
237
|
+
}
|
|
238
|
+
const entry = {
|
|
239
|
+
name: skill.name,
|
|
240
|
+
source,
|
|
241
|
+
ref: parsed.ref,
|
|
242
|
+
scope,
|
|
243
|
+
projectHash: scope === "project" ? this.opts.projectHash : void 0,
|
|
244
|
+
installedAt: (/* @__PURE__ */ new Date()).toISOString(),
|
|
245
|
+
files: copiedFiles
|
|
246
|
+
};
|
|
247
|
+
await this.manifest.addEntry(entry);
|
|
248
|
+
results.push({
|
|
249
|
+
name: skill.name,
|
|
250
|
+
path: destDir,
|
|
251
|
+
scope,
|
|
252
|
+
source,
|
|
253
|
+
ref: parsed.ref,
|
|
254
|
+
skillCount: 1
|
|
255
|
+
});
|
|
256
|
+
}
|
|
257
|
+
this.invalidateLoaderCache();
|
|
258
|
+
return results;
|
|
259
|
+
} finally {
|
|
260
|
+
await fs3.rm(tempDir, { recursive: true, force: true }).catch(() => {
|
|
261
|
+
});
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
/**
|
|
265
|
+
* Update installed skills.
|
|
266
|
+
* - No args: update all
|
|
267
|
+
* - Name: update that specific skill
|
|
268
|
+
* - Name + newRef: update to a different ref
|
|
269
|
+
*/
|
|
270
|
+
async update(nameOrRef, opts) {
|
|
271
|
+
const result = { updated: [], unchanged: [], errors: [] };
|
|
272
|
+
const allEntries = await this.manifest.listAll();
|
|
273
|
+
let targets;
|
|
274
|
+
if (nameOrRef) {
|
|
275
|
+
const byName = allEntries.filter((e) => e.name === nameOrRef);
|
|
276
|
+
if (byName.length > 0) {
|
|
277
|
+
targets = byName;
|
|
278
|
+
} else {
|
|
279
|
+
try {
|
|
280
|
+
const parsed = parseSkillRef(nameOrRef);
|
|
281
|
+
const source = `github:${parsed.owner}/${parsed.repo}`;
|
|
282
|
+
targets = allEntries.filter((e) => e.source === source);
|
|
283
|
+
if (targets.length === 0) {
|
|
284
|
+
result.errors.push({
|
|
285
|
+
name: nameOrRef,
|
|
286
|
+
error: `No installed skills found matching "${nameOrRef}"`
|
|
287
|
+
});
|
|
288
|
+
return result;
|
|
289
|
+
}
|
|
290
|
+
} catch {
|
|
291
|
+
result.errors.push({
|
|
292
|
+
name: nameOrRef,
|
|
293
|
+
error: `Invalid reference: ${nameOrRef}`
|
|
294
|
+
});
|
|
295
|
+
return result;
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
} else {
|
|
299
|
+
targets = allEntries;
|
|
300
|
+
}
|
|
301
|
+
const bySource = /* @__PURE__ */ new Map();
|
|
302
|
+
for (const entry of targets) {
|
|
303
|
+
const key = `${entry.source}@${entry.ref}`;
|
|
304
|
+
if (!bySource.has(key)) bySource.set(key, []);
|
|
305
|
+
bySource.get(key).push(entry);
|
|
306
|
+
}
|
|
307
|
+
for (const [, entries] of bySource) {
|
|
308
|
+
const first = entries[0];
|
|
309
|
+
const scope = first.scope;
|
|
310
|
+
const isGlobal = scope === "user";
|
|
311
|
+
try {
|
|
312
|
+
const sourceRepo = first.source.replace("github:", "");
|
|
313
|
+
let refToInstall = first.ref;
|
|
314
|
+
if (nameOrRef && !allEntries.find((e) => e.name === nameOrRef)) {
|
|
315
|
+
try {
|
|
316
|
+
const parsed = parseSkillRef(nameOrRef);
|
|
317
|
+
refToInstall = parsed.ref;
|
|
318
|
+
} catch {
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
this.opts.log?.(`Updating ${first.source}@${refToInstall}...`);
|
|
322
|
+
const results = await this.install(`${sourceRepo}@${refToInstall}`, { global: isGlobal });
|
|
323
|
+
for (const r of results) {
|
|
324
|
+
result.updated.push({
|
|
325
|
+
name: r.name,
|
|
326
|
+
oldRef: first.ref,
|
|
327
|
+
newRef: refToInstall
|
|
328
|
+
});
|
|
329
|
+
}
|
|
330
|
+
} catch (err) {
|
|
331
|
+
const msg = err instanceof Error ? err.message : String(err);
|
|
332
|
+
for (const entry of entries) {
|
|
333
|
+
result.errors.push({ name: entry.name, error: msg });
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
return result;
|
|
338
|
+
}
|
|
339
|
+
/**
|
|
340
|
+
* Uninstall a skill by name.
|
|
341
|
+
*/
|
|
342
|
+
async uninstall(name, opts) {
|
|
343
|
+
const scope = opts?.global ? "user" : "project";
|
|
344
|
+
const entries = await this.manifest.findByName(name);
|
|
345
|
+
const entry = entries.find((e) => e.scope === scope);
|
|
346
|
+
if (!entry) {
|
|
347
|
+
throw new Error(`Skill "${name}" is not installed${scope === "user" ? " (global)" : ""}.`);
|
|
348
|
+
}
|
|
349
|
+
await this.removeSkillFiles(name, scope);
|
|
350
|
+
await this.manifest.removeEntry(name, scope);
|
|
351
|
+
this.invalidateLoaderCache();
|
|
352
|
+
}
|
|
353
|
+
/**
|
|
354
|
+
* List all installed skills from the manifest.
|
|
355
|
+
*/
|
|
356
|
+
async listInstalled() {
|
|
357
|
+
return this.manifest.listAll();
|
|
358
|
+
}
|
|
359
|
+
// ── Private helpers ──────────────────────────────────────────────
|
|
360
|
+
/**
|
|
361
|
+
* Detect skills in an extracted repository.
|
|
362
|
+
* Returns an array of detected skills with their files.
|
|
363
|
+
*/
|
|
364
|
+
async detectSkills(baseDir) {
|
|
365
|
+
const results = [];
|
|
366
|
+
const rootSkillMd = path3.join(baseDir, "SKILL.md");
|
|
367
|
+
try {
|
|
368
|
+
await fs3.access(rootSkillMd);
|
|
369
|
+
const content = await fs3.readFile(rootSkillMd, "utf8");
|
|
370
|
+
const meta = parseFrontmatter(content);
|
|
371
|
+
if (meta.name && meta.description) {
|
|
372
|
+
results.push({
|
|
373
|
+
name: meta.name,
|
|
374
|
+
baseDir,
|
|
375
|
+
files: ["SKILL.md"]
|
|
376
|
+
});
|
|
377
|
+
return results;
|
|
378
|
+
}
|
|
379
|
+
} catch {
|
|
380
|
+
}
|
|
381
|
+
const skillsDir = path3.join(baseDir, "skills");
|
|
382
|
+
try {
|
|
383
|
+
const entries = await fs3.readdir(skillsDir, { withFileTypes: true });
|
|
384
|
+
for (const entry of entries) {
|
|
385
|
+
if (!entry.isDirectory()) continue;
|
|
386
|
+
const skillFile = path3.join(skillsDir, entry.name, "SKILL.md");
|
|
387
|
+
try {
|
|
388
|
+
const content = await fs3.readFile(skillFile, "utf8");
|
|
389
|
+
const meta = parseFrontmatter(content);
|
|
390
|
+
if (meta.name && meta.description) {
|
|
391
|
+
const skillDir = path3.join(skillsDir, entry.name);
|
|
392
|
+
const files = await collectFiles(skillDir, skillDir);
|
|
393
|
+
results.push({
|
|
394
|
+
name: meta.name,
|
|
395
|
+
baseDir: skillDir,
|
|
396
|
+
files
|
|
397
|
+
});
|
|
398
|
+
}
|
|
399
|
+
} catch {
|
|
400
|
+
}
|
|
401
|
+
}
|
|
402
|
+
} catch {
|
|
403
|
+
}
|
|
404
|
+
return results;
|
|
405
|
+
}
|
|
406
|
+
/**
|
|
407
|
+
* Remove all files for an installed skill.
|
|
408
|
+
*/
|
|
409
|
+
async removeSkillFiles(name, scope) {
|
|
410
|
+
const targetDir = scope === "project" ? this.opts.projectSkillsDir : this.opts.globalSkillsDir;
|
|
411
|
+
const skillDir = path3.join(targetDir, name);
|
|
412
|
+
await fs3.rm(skillDir, { recursive: true, force: true });
|
|
413
|
+
}
|
|
414
|
+
/**
|
|
415
|
+
* Invalidate the skill loader's cache so newly installed skills appear.
|
|
416
|
+
*/
|
|
417
|
+
invalidateLoaderCache() {
|
|
418
|
+
const loader = this.opts.skillLoader;
|
|
419
|
+
if (loader && typeof loader.invalidateCache === "function") {
|
|
420
|
+
loader.invalidateCache();
|
|
421
|
+
}
|
|
422
|
+
}
|
|
423
|
+
};
|
|
424
|
+
function parseFrontmatter(raw) {
|
|
425
|
+
if (!raw.startsWith("---")) return {};
|
|
426
|
+
const end = raw.indexOf("\n---", 4);
|
|
427
|
+
if (end === -1) return {};
|
|
428
|
+
const block = raw.slice(4, end);
|
|
429
|
+
const out = {};
|
|
430
|
+
let key = null;
|
|
431
|
+
let value = [];
|
|
432
|
+
const flush = () => {
|
|
433
|
+
if (key) {
|
|
434
|
+
out[key] = value.join("\n").trim();
|
|
435
|
+
}
|
|
436
|
+
key = null;
|
|
437
|
+
value = [];
|
|
438
|
+
};
|
|
439
|
+
for (const line of block.split("\n")) {
|
|
440
|
+
const m = /^([a-zA-Z_]+):\s*(\|?)\s*(.*)$/.exec(line);
|
|
441
|
+
if (m) {
|
|
442
|
+
flush();
|
|
443
|
+
key = m[1] ?? "";
|
|
444
|
+
const pipe = m[2];
|
|
445
|
+
const rest = m[3] ?? "";
|
|
446
|
+
if (pipe === "|") {
|
|
447
|
+
value = [];
|
|
448
|
+
} else if (rest) {
|
|
449
|
+
value = [rest];
|
|
450
|
+
} else {
|
|
451
|
+
value = [];
|
|
452
|
+
}
|
|
453
|
+
} else if (key) {
|
|
454
|
+
value.push(line.replace(/^\s+/, ""));
|
|
455
|
+
}
|
|
456
|
+
}
|
|
457
|
+
flush();
|
|
458
|
+
return out;
|
|
459
|
+
}
|
|
460
|
+
async function collectFiles(dir, baseDir) {
|
|
461
|
+
const results = [];
|
|
462
|
+
const entries = await fs3.readdir(dir, { withFileTypes: true });
|
|
463
|
+
for (const entry of entries) {
|
|
464
|
+
const fullPath = path3.join(dir, entry.name);
|
|
465
|
+
const relPath = path3.relative(baseDir, fullPath);
|
|
466
|
+
if (entry.isDirectory()) {
|
|
467
|
+
if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
|
|
468
|
+
results.push(...await collectFiles(fullPath, baseDir));
|
|
469
|
+
} else {
|
|
470
|
+
results.push(relPath);
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
return results;
|
|
474
|
+
}
|
|
475
|
+
|
|
476
|
+
export { SkillInstaller, SkillManifestStore, downloadGitHubTarball, parseSkillRef };
|
|
477
|
+
//# sourceMappingURL=index.js.map
|
|
478
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../src/skills/github-fetcher.ts","../../src/skills/manifest-store.ts","../../src/skills/skill-installer.ts"],"names":["fs","path","fs2","path2","stat"],"mappings":"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","file":"index.js","sourcesContent":["import * as fs from 'node:fs/promises';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\nimport { createGunzip } from 'node:zlib';\nimport { Readable } from 'node:stream';\nimport { pipeline } from 'node:stream/promises';\n\nexport interface ParsedRef {\n owner: string;\n repo: string;\n ref: string;\n}\n\n/**\n * Parse a skill reference string.\n * Formats: `user/repo` (default ref: main), `user/repo@ref`\n */\nexport function parseSkillRef(input: string): ParsedRef {\n const trimmed = input.trim().replace(/^https?:\\/\\/github\\.com\\//, '').replace(/\\.git$/, '');\n const atIdx = trimmed.indexOf('@');\n let refPath: string;\n let ref: string;\n if (atIdx > 0) {\n refPath = trimmed.slice(0, atIdx);\n ref = trimmed.slice(atIdx + 1);\n } else {\n refPath = trimmed;\n ref = 'main';\n }\n const parts = refPath.split('/').filter(Boolean);\n if (parts.length < 2) {\n throw new Error(`Invalid skill reference \"${input}\". Expected format: user/repo or user/repo@ref`);\n }\n return { owner: parts[0]!, repo: parts[1]!, ref };\n}\n\nexport interface DownloadResult {\n /** Temp directory containing the extracted repo. Caller must clean up. */\n tempDir: string;\n}\n\nconst MAX_TARBALL_SIZE = 50 * 1024 * 1024; // 50MB\n\n/**\n * Download and extract a GitHub repository tarball.\n * Uses the public GitHub API — no auth token required for public repos.\n * Returns the path to a temp directory with the extracted contents.\n */\nexport async function downloadGitHubTarball(parsed: ParsedRef): Promise<DownloadResult> {\n const url = `https://api.github.com/repos/${parsed.owner}/${parsed.repo}/tarball/${parsed.ref}`;\n\n const response = await fetch(url, {\n headers: {\n Accept: 'application/vnd.github+json',\n 'User-Agent': 'wrongstack-skill-installer',\n },\n redirect: 'follow',\n });\n\n if (!response.ok) {\n if (response.status === 404) {\n throw new Error(\n `Repository not found: ${parsed.owner}/${parsed.repo}` +\n (parsed.ref !== 'main' ? ` (ref: ${parsed.ref})` : ''),\n );\n }\n if (response.status === 403) {\n throw new Error(\n `Access denied: ${parsed.owner}/${parsed.repo}. The repository may be private or rate-limited.`,\n );\n }\n throw new Error(`GitHub API error (${response.status}): ${response.statusText}`);\n }\n\n const contentLength = response.headers.get('content-length');\n if (contentLength && Number.parseInt(contentLength, 10) > MAX_TARBALL_SIZE) {\n throw new Error(\n `Tarball too large (${(Number.parseInt(contentLength, 10) / 1024 / 1024).toFixed(1)}MB). Max: ${MAX_TARBALL_SIZE / 1024 / 1024}MB`,\n );\n }\n\n const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'wskill-'));\n\n try {\n if (!response.body) {\n throw new Error('Empty response body from GitHub API');\n }\n\n // Gunzip the response body, then extract the tar stream\n const nodeStream = Readable.fromWeb(response.body as import('node:stream/web').ReadableStream);\n const gunzip = createGunzip();\n\n // Collect the uncompressed tar data into a buffer, then extract\n const chunks: Buffer[] = [];\n await pipeline(nodeStream, gunzip, async (source) => {\n for await (const chunk of source) {\n chunks.push(Buffer.from(chunk));\n }\n });\n const tarBuf = Buffer.concat(chunks);\n\n // Extract tar archive (POSIX ustar format)\n await extractTar(tarBuf, tempDir);\n\n return { tempDir };\n } catch (err) {\n await fs.rm(tempDir, { recursive: true, force: true }).catch(() => {});\n throw err;\n }\n}\n\n/**\n * Minimal POSIX tar extractor. Handles the ustar format produced by GitHub.\n * Only extracts regular files and directories — symlinks and special entries\n * are skipped for security.\n */\nasync function extractTar(buf: Buffer, destDir: string): Promise<void> {\n let offset = 0;\n\n while (offset + 512 <= buf.length) {\n // Check for end-of-archive (two consecutive zero blocks)\n const header = buf.subarray(offset, offset + 512);\n if (header.every((b) => b === 0)) break;\n\n // Parse ustar header\n const name = readTarString(buf, offset, 100); // name field\n const prefix = readTarString(buf, offset + 345, 155); // ustar prefix\n const size = Number.parseInt(readTarString(buf, offset + 124, 12).trim(), 8) || 0;\n const typeflag = buf[offset + 156] ?? 0;\n\n // Full path: prefix/name (ustar) or just name\n const fullPath = prefix ? `${prefix}/${name}` : name;\n // Strip the top-level directory (GitHub tarballs have owner-repo-sha/)\n const relPath = stripTopDir(fullPath);\n\n if (relPath && relPath !== '.' && relPath !== '..') {\n const destPath = path.join(destDir, relPath);\n\n // typeflag: '0' or '\\0' = regular file, '5' = directory\n if (typeflag === 0x35 || typeflag === 0) {\n // Directory\n if (relPath.endsWith('/') || typeflag === 0x35) {\n await fs.mkdir(destPath, { recursive: true });\n }\n }\n\n if ((typeflag === 0x30 || typeflag === 0 || typeflag === 0x00) && size > 0) {\n // Regular file\n const dir = path.dirname(destPath);\n await fs.mkdir(dir, { recursive: true });\n const dataStart = offset + 512;\n const dataEnd = dataStart + size;\n if (dataEnd > buf.length) break; // truncated archive\n await fs.writeFile(destPath, buf.subarray(dataStart, dataEnd));\n }\n }\n\n // Advance: 512-byte header + data padded to 512-byte boundary\n offset += 512 + Math.ceil(size / 512) * 512;\n }\n}\n\nfunction readTarString(buf: Buffer, start: number, maxLen: number): string {\n let end = start;\n while (end < start + maxLen && end < buf.length && buf[end] !== 0) {\n end++;\n }\n return buf.subarray(start, end).toString('utf8');\n}\n\n/**\n * Strip the top-level directory from a tar path.\n * GitHub tarballs have a single root dir like `owner-repo-sha/`.\n */\nfunction stripTopDir(p: string): string {\n const idx = p.indexOf('/');\n if (idx === -1) return ''; // top-level file, skip\n return p.slice(idx + 1);\n}\n","import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\n\nexport interface InstalledSkillEntry {\n name: string;\n /** Source identifier, e.g. \"github:user/repo\" */\n source: string;\n /** Git ref that was installed (branch, tag, commit) */\n ref: string;\n /** Installation scope */\n scope: 'project' | 'user';\n /** Project hash — only set when scope=project */\n projectHash?: string;\n /** ISO 8601 timestamp */\n installedAt: string;\n /** List of files that were installed (relative to skill dir) */\n files: string[];\n}\n\nexport interface ManifestData {\n skills: InstalledSkillEntry[];\n}\n\nexport class SkillManifestStore {\n private readonly manifestPath: string;\n private cache?: ManifestData;\n\n constructor(manifestPath: string) {\n this.manifestPath = manifestPath;\n }\n\n async read(): Promise<ManifestData> {\n if (this.cache) return this.cache;\n try {\n const raw = await fs.readFile(this.manifestPath, 'utf8');\n const data = JSON.parse(raw) as ManifestData;\n if (!Array.isArray(data.skills)) {\n this.cache = { skills: [] };\n } else {\n this.cache = data;\n }\n } catch {\n this.cache = { skills: [] };\n }\n return this.cache;\n }\n\n async write(data: ManifestData): Promise<void> {\n const dir = path.dirname(this.manifestPath);\n await fs.mkdir(dir, { recursive: true });\n await fs.writeFile(this.manifestPath, JSON.stringify(data, null, 2) + '\\n', 'utf8');\n this.cache = data;\n }\n\n async addEntry(entry: InstalledSkillEntry): Promise<void> {\n const data = await this.read();\n // Remove existing entry with the same name + scope\n data.skills = data.skills.filter(\n (s) => !(s.name === entry.name && s.scope === entry.scope),\n );\n data.skills.push(entry);\n await this.write(data);\n }\n\n async removeEntry(name: string, scope: 'project' | 'user'): Promise<boolean> {\n const data = await this.read();\n const before = data.skills.length;\n data.skills = data.skills.filter(\n (s) => !(s.name === name && s.scope === scope),\n );\n if (data.skills.length === before) return false;\n await this.write(data);\n return true;\n }\n\n async findByName(name: string): Promise<InstalledSkillEntry[]> {\n const data = await this.read();\n return data.skills.filter((s) => s.name === name);\n }\n\n async findBySource(source: string): Promise<InstalledSkillEntry[]> {\n const data = await this.read();\n return data.skills.filter((s) => s.source === source);\n }\n\n async listAll(): Promise<InstalledSkillEntry[]> {\n const data = await this.read();\n return data.skills;\n }\n\n /** Invalidate the in-memory cache (e.g. after external file changes). */\n invalidateCache(): void {\n this.cache = undefined;\n }\n}\n","import * as fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport type { SkillLoader } from '../types/skill.js';\nimport { type ParsedRef, downloadGitHubTarball, parseSkillRef } from './github-fetcher.js';\nimport { type InstalledSkillEntry, SkillManifestStore } from './manifest-store.js';\n\nexport interface SkillInstallerOptions {\n /** Path to the manifest file (~/.wrongstack/installed-skills.json) */\n manifestPath: string;\n /** Path to project-level skills dir (<project>/.wrongstack/skills/) */\n projectSkillsDir: string;\n /** Path to user-global skills dir (~/.wrongstack/skills/) */\n globalSkillsDir: string;\n /** Current project hash (for manifest tracking) */\n projectHash: string;\n /** Skill loader — cache will be invalidated after mutations */\n skillLoader?: SkillLoader;\n /** Logger for status messages */\n log?: (msg: string) => void;\n}\n\nexport interface InstallResult {\n name: string;\n path: string;\n scope: 'project' | 'user';\n source: string;\n ref: string;\n skillCount: number;\n}\n\nexport interface UpdateResult {\n updated: Array<{ name: string; oldRef: string; newRef: string }>;\n unchanged: string[];\n errors: Array<{ name: string; error: string }>;\n}\n\nconst MAX_SKILL_FILE_SIZE = 100 * 1024; // 100KB\n\nexport class SkillInstaller {\n private readonly opts: SkillInstallerOptions;\n private readonly manifest: SkillManifestStore;\n\n constructor(opts: SkillInstallerOptions) {\n this.opts = opts;\n this.manifest = new SkillManifestStore(opts.manifestPath);\n }\n\n /**\n * Install skills from a GitHub repository.\n * Supports both single-skill repos (SKILL.md at root) and multi-skill repos (skills/ subdirectory).\n */\n async install(refInput: string, opts?: { global?: boolean }): Promise<InstallResult[]> {\n const parsed = parseSkillRef(refInput);\n const scope: 'project' | 'user' = opts?.global ? 'user' : 'project';\n const targetDir = scope === 'project' ? this.opts.projectSkillsDir : this.opts.globalSkillsDir;\n const source = `github:${parsed.owner}/${parsed.repo}`;\n\n this.opts.log?.(`Downloading ${parsed.owner}/${parsed.repo}@${parsed.ref}...`);\n\n const { tempDir } = await downloadGitHubTarball(parsed);\n\n try {\n // Detect skill structure\n const skills = await this.detectSkills(tempDir);\n\n if (skills.length === 0) {\n throw new Error(\n 'No skills found in repository. Expected SKILL.md at root or skills/ subdirectory.',\n );\n }\n\n const results: InstallResult[] = [];\n\n for (const skill of skills) {\n // Check for overwrite\n const existing = await this.manifest.findByName(skill.name);\n const existingInScope = existing.find((e) => e.scope === scope);\n if (existingInScope) {\n this.opts.log?.(`Overwriting existing skill \"${skill.name}\" (${scope})...`);\n await this.removeSkillFiles(skill.name, scope);\n }\n\n // Copy skill files\n const destDir = path.join(targetDir, skill.name);\n await fs.mkdir(destDir, { recursive: true });\n const copiedFiles: string[] = [];\n\n for (const file of skill.files) {\n const srcPath = path.join(skill.baseDir, file);\n const destPath = path.join(destDir, file);\n\n // Path traversal check\n const resolved = path.resolve(destPath);\n if (!resolved.startsWith(path.resolve(destDir))) {\n throw new Error(`Path traversal detected in skill file: ${file}`);\n }\n\n // Size check\n const stat = await fs.stat(srcPath);\n if (stat.size > MAX_SKILL_FILE_SIZE) {\n throw new Error(\n `Skill file \"${file}\" is too large (${(stat.size / 1024).toFixed(1)}KB). Max: ${MAX_SKILL_FILE_SIZE / 1024}KB`,\n );\n }\n\n await fs.mkdir(path.dirname(destPath), { recursive: true });\n await fs.copyFile(srcPath, destPath);\n copiedFiles.push(file);\n }\n\n // Write manifest entry\n const entry: InstalledSkillEntry = {\n name: skill.name,\n source,\n ref: parsed.ref,\n scope,\n projectHash: scope === 'project' ? this.opts.projectHash : undefined,\n installedAt: new Date().toISOString(),\n files: copiedFiles,\n };\n await this.manifest.addEntry(entry);\n\n results.push({\n name: skill.name,\n path: destDir,\n scope,\n source,\n ref: parsed.ref,\n skillCount: 1,\n });\n }\n\n this.invalidateLoaderCache();\n return results;\n } finally {\n // Clean up temp directory\n await fs.rm(tempDir, { recursive: true, force: true }).catch(() => {});\n }\n }\n\n /**\n * Update installed skills.\n * - No args: update all\n * - Name: update that specific skill\n * - Name + newRef: update to a different ref\n */\n async update(\n nameOrRef?: string,\n opts?: { global?: boolean },\n ): Promise<UpdateResult> {\n const result: UpdateResult = { updated: [], unchanged: [], errors: [] };\n const allEntries = await this.manifest.listAll();\n\n let targets: InstalledSkillEntry[];\n if (nameOrRef) {\n // Check if it's a name or a ref (user/repo@ref)\n const byName = allEntries.filter((e) => e.name === nameOrRef);\n if (byName.length > 0) {\n targets = byName;\n } else {\n // Treat as a new ref — find matching source\n try {\n const parsed = parseSkillRef(nameOrRef);\n const source = `github:${parsed.owner}/${parsed.repo}`;\n targets = allEntries.filter((e) => e.source === source);\n if (targets.length === 0) {\n result.errors.push({\n name: nameOrRef,\n error: `No installed skills found matching \"${nameOrRef}\"`,\n });\n return result;\n }\n } catch {\n result.errors.push({\n name: nameOrRef,\n error: `Invalid reference: ${nameOrRef}`,\n });\n return result;\n }\n }\n } else {\n targets = allEntries;\n }\n\n // Group by source to avoid downloading the same repo multiple times\n const bySource = new Map<string, InstalledSkillEntry[]>();\n for (const entry of targets) {\n const key = `${entry.source}@${entry.ref}`;\n if (!bySource.has(key)) bySource.set(key, []);\n bySource.get(key)!.push(entry);\n }\n\n for (const [, entries] of bySource) {\n const first = entries[0]!;\n const scope = first.scope;\n const isGlobal = scope === 'user';\n\n try {\n // Parse the original source to get the ref\n const sourceRepo = first.source.replace('github:', '');\n let refToInstall = first.ref;\n\n // If nameOrRef looks like a new ref, use it\n if (nameOrRef && !allEntries.find((e) => e.name === nameOrRef)) {\n try {\n const parsed = parseSkillRef(nameOrRef);\n refToInstall = parsed.ref;\n } catch {\n // keep original ref\n }\n }\n\n this.opts.log?.(`Updating ${first.source}@${refToInstall}...`);\n const results = await this.install(`${sourceRepo}@${refToInstall}`, { global: isGlobal });\n\n for (const r of results) {\n result.updated.push({\n name: r.name,\n oldRef: first.ref,\n newRef: refToInstall,\n });\n }\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n for (const entry of entries) {\n result.errors.push({ name: entry.name, error: msg });\n }\n }\n }\n\n return result;\n }\n\n /**\n * Uninstall a skill by name.\n */\n async uninstall(name: string, opts?: { global?: boolean }): Promise<void> {\n const scope: 'project' | 'user' = opts?.global ? 'user' : 'project';\n const entries = await this.manifest.findByName(name);\n const entry = entries.find((e) => e.scope === scope);\n\n if (!entry) {\n throw new Error(`Skill \"${name}\" is not installed${scope === 'user' ? ' (global)' : ''}.`);\n }\n\n // Remove files\n await this.removeSkillFiles(name, scope);\n\n // Remove from manifest\n await this.manifest.removeEntry(name, scope);\n this.invalidateLoaderCache();\n }\n\n /**\n * List all installed skills from the manifest.\n */\n async listInstalled(): Promise<InstalledSkillEntry[]> {\n return this.manifest.listAll();\n }\n\n // ── Private helpers ──────────────────────────────────────────────\n\n /**\n * Detect skills in an extracted repository.\n * Returns an array of detected skills with their files.\n */\n private async detectSkills(\n baseDir: string,\n ): Promise<Array<{ name: string; baseDir: string; files: string[] }>> {\n const results: Array<{ name: string; baseDir: string; files: string[] }> = [];\n\n // Check for SKILL.md at root (single-skill repo)\n const rootSkillMd = path.join(baseDir, 'SKILL.md');\n try {\n await fs.access(rootSkillMd);\n const content = await fs.readFile(rootSkillMd, 'utf8');\n const meta = parseFrontmatter(content);\n if (meta.name && meta.description) {\n results.push({\n name: meta.name,\n baseDir,\n files: ['SKILL.md'],\n });\n return results; // Single-skill repo — don't look for skills/\n }\n } catch {\n // No root SKILL.md\n }\n\n // Check for skills/ subdirectory (multi-skill repo)\n const skillsDir = path.join(baseDir, 'skills');\n try {\n const entries = await fs.readdir(skillsDir, { withFileTypes: true });\n for (const entry of entries) {\n if (!entry.isDirectory()) continue;\n const skillFile = path.join(skillsDir, entry.name, 'SKILL.md');\n try {\n const content = await fs.readFile(skillFile, 'utf8');\n const meta = parseFrontmatter(content);\n if (meta.name && meta.description) {\n // Collect all files in the skill directory\n const skillDir = path.join(skillsDir, entry.name);\n const files = await collectFiles(skillDir, skillDir);\n results.push({\n name: meta.name,\n baseDir: skillDir,\n files,\n });\n }\n } catch {\n // Skip malformed skills\n }\n }\n } catch {\n // No skills/ directory\n }\n\n return results;\n }\n\n /**\n * Remove all files for an installed skill.\n */\n private async removeSkillFiles(name: string, scope: 'project' | 'user'): Promise<void> {\n const targetDir =\n scope === 'project' ? this.opts.projectSkillsDir : this.opts.globalSkillsDir;\n const skillDir = path.join(targetDir, name);\n await fs.rm(skillDir, { recursive: true, force: true });\n }\n\n /**\n * Invalidate the skill loader's cache so newly installed skills appear.\n */\n private invalidateLoaderCache(): void {\n // The SkillLoader interface has a cache internally.\n // We access it via the 'any' cast to call invalidateCache if available.\n const loader = this.opts.skillLoader as unknown as { invalidateCache?: () => void };\n if (loader && typeof loader.invalidateCache === 'function') {\n loader.invalidateCache();\n }\n }\n}\n\n// ── Utilities ──────────────────────────────────────────────────────\n\ninterface Frontmatter {\n name?: string;\n description?: string;\n}\n\nfunction parseFrontmatter(raw: string): Frontmatter {\n if (!raw.startsWith('---')) return {};\n const end = raw.indexOf('\\n---', 4);\n if (end === -1) return {};\n const block = raw.slice(4, end);\n const out: Frontmatter = {};\n let key: keyof Frontmatter | null = null;\n let value: string[] = [];\n const flush = () => {\n if (key) {\n out[key] = value.join('\\n').trim();\n }\n key = null;\n value = [];\n };\n for (const line of block.split('\\n')) {\n const m = /^([a-zA-Z_]+):\\s*(\\|?)\\s*(.*)$/.exec(line);\n if (m) {\n flush();\n key = (m[1] ?? '') as keyof Frontmatter;\n const pipe = m[2];\n const rest = m[3] ?? '';\n if (pipe === '|') {\n value = [];\n } else if (rest) {\n value = [rest];\n } else {\n value = [];\n }\n } else if (key) {\n value.push(line.replace(/^\\s+/, ''));\n }\n }\n flush();\n return out;\n}\n\n/**\n * Recursively collect all files in a directory (relative paths).\n */\nasync function collectFiles(dir: string, baseDir: string): Promise<string[]> {\n const results: string[] = [];\n const entries = await fs.readdir(dir, { withFileTypes: true });\n for (const entry of entries) {\n const fullPath = path.join(dir, entry.name);\n const relPath = path.relative(baseDir, fullPath);\n if (entry.isDirectory()) {\n // Skip hidden dirs and node_modules\n if (entry.name.startsWith('.') || entry.name === 'node_modules') continue;\n results.push(...(await collectFiles(fullPath, baseDir)));\n } else {\n results.push(relPath);\n }\n }\n return results;\n}\n"]}
|