@skillhouse/cli 0.1.2 → 0.3.1

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 (78) hide show
  1. package/README.md +20 -0
  2. package/dist/cli.js +69 -1
  3. package/dist/cli.js.map +1 -1
  4. package/dist/commands/check.d.ts +6 -0
  5. package/dist/commands/check.d.ts.map +1 -0
  6. package/dist/commands/check.js +61 -0
  7. package/dist/commands/check.js.map +1 -0
  8. package/dist/commands/index.d.ts +4 -0
  9. package/dist/commands/index.d.ts.map +1 -1
  10. package/dist/commands/index.js +4 -0
  11. package/dist/commands/index.js.map +1 -1
  12. package/dist/commands/install.d.ts +3 -0
  13. package/dist/commands/install.d.ts.map +1 -1
  14. package/dist/commands/install.js +62 -3
  15. package/dist/commands/install.js.map +1 -1
  16. package/dist/commands/list.d.ts +6 -0
  17. package/dist/commands/list.d.ts.map +1 -0
  18. package/dist/commands/list.js +35 -0
  19. package/dist/commands/list.js.map +1 -0
  20. package/dist/commands/publish.d.ts +7 -0
  21. package/dist/commands/publish.d.ts.map +1 -0
  22. package/dist/commands/publish.js +74 -0
  23. package/dist/commands/publish.js.map +1 -0
  24. package/dist/commands/uninstall.d.ts +11 -0
  25. package/dist/commands/uninstall.d.ts.map +1 -0
  26. package/dist/commands/uninstall.js +146 -0
  27. package/dist/commands/uninstall.js.map +1 -0
  28. package/dist/commands/updates.d.ts +2 -0
  29. package/dist/commands/updates.d.ts.map +1 -1
  30. package/dist/commands/updates.js +19 -6
  31. package/dist/commands/updates.js.map +1 -1
  32. package/dist/index.d.ts +2 -0
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +2 -0
  35. package/dist/index.js.map +1 -1
  36. package/dist/lib/agents.d.ts +9 -0
  37. package/dist/lib/agents.d.ts.map +1 -1
  38. package/dist/lib/agents.js +42 -0
  39. package/dist/lib/agents.js.map +1 -1
  40. package/dist/lib/api.d.ts +26 -0
  41. package/dist/lib/api.d.ts.map +1 -1
  42. package/dist/lib/api.js +55 -0
  43. package/dist/lib/api.js.map +1 -1
  44. package/dist/lib/config.d.ts +4 -1
  45. package/dist/lib/config.d.ts.map +1 -1
  46. package/dist/lib/config.js +17 -0
  47. package/dist/lib/config.js.map +1 -1
  48. package/dist/lib/package.d.ts +12 -0
  49. package/dist/lib/package.d.ts.map +1 -0
  50. package/dist/lib/package.js +165 -0
  51. package/dist/lib/package.js.map +1 -0
  52. package/dist/lib/skill-checks/engine.d.ts +10 -0
  53. package/dist/lib/skill-checks/engine.d.ts.map +1 -0
  54. package/dist/lib/skill-checks/engine.js +322 -0
  55. package/dist/lib/skill-checks/engine.js.map +1 -0
  56. package/dist/lib/skill-checks/executables.d.ts +10 -0
  57. package/dist/lib/skill-checks/executables.d.ts.map +1 -0
  58. package/dist/lib/skill-checks/executables.js +35 -0
  59. package/dist/lib/skill-checks/executables.js.map +1 -0
  60. package/dist/lib/skill-checks/index.d.ts +5 -0
  61. package/dist/lib/skill-checks/index.d.ts.map +1 -0
  62. package/dist/lib/skill-checks/index.js +5 -0
  63. package/dist/lib/skill-checks/index.js.map +1 -0
  64. package/dist/lib/skill-checks/types.d.ts +53 -0
  65. package/dist/lib/skill-checks/types.d.ts.map +1 -0
  66. package/dist/lib/skill-checks/types.js +18 -0
  67. package/dist/lib/skill-checks/types.js.map +1 -0
  68. package/dist/lib/skill-checks/verdict.d.ts +9 -0
  69. package/dist/lib/skill-checks/verdict.d.ts.map +1 -0
  70. package/dist/lib/skill-checks/verdict.js +14 -0
  71. package/dist/lib/skill-checks/verdict.js.map +1 -0
  72. package/dist/lib/unpack.d.ts +10 -1
  73. package/dist/lib/unpack.d.ts.map +1 -1
  74. package/dist/lib/unpack.js +58 -16
  75. package/dist/lib/unpack.js.map +1 -1
  76. package/dist/types.d.ts +14 -0
  77. package/dist/types.d.ts.map +1 -1
  78. package/package.json +9 -1
@@ -0,0 +1,165 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import AdmZip from 'adm-zip';
4
+ import { calculateChecksum } from './unpack.js';
5
+ const IGNORED_DIRS = new Set([
6
+ '.git',
7
+ 'node_modules',
8
+ 'dist',
9
+ 'coverage',
10
+ '.idea',
11
+ '.vscode',
12
+ '.superpowers',
13
+ '.agent',
14
+ ]);
15
+ const IGNORED_FILES = new Set([
16
+ '.DS_Store',
17
+ 'Thumbs.db',
18
+ '.npmrc',
19
+ 'package-lock.json',
20
+ ]);
21
+ /**
22
+ * Extracts YAML-like frontmatter from markdown text if present.
23
+ */
24
+ function extractFrontmatter(text) {
25
+ const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---/);
26
+ if (!match)
27
+ return {};
28
+ const lines = match[1].split(/\r?\n/);
29
+ const result = {};
30
+ let currentKey = '';
31
+ let inList = false;
32
+ for (const line of lines) {
33
+ const trimmed = line.trim();
34
+ if (!trimmed || trimmed.startsWith('#'))
35
+ continue;
36
+ if (trimmed.startsWith('- ') && inList && currentKey) {
37
+ const val = trimmed.slice(2).trim().replace(/^['"]|['"]$/g, '');
38
+ result[currentKey].push(val);
39
+ continue;
40
+ }
41
+ const colonIdx = trimmed.indexOf(':');
42
+ if (colonIdx !== -1) {
43
+ const key = trimmed.slice(0, colonIdx).trim();
44
+ let val = trimmed.slice(colonIdx + 1).trim();
45
+ if (val === '') {
46
+ // List starter
47
+ currentKey = key;
48
+ inList = true;
49
+ result[key] = [];
50
+ }
51
+ else {
52
+ inList = false;
53
+ currentKey = '';
54
+ if (val.startsWith('[') && val.endsWith(']')) {
55
+ result[key] = val
56
+ .slice(1, -1)
57
+ .split(',')
58
+ .map((s) => s.trim().replace(/^['"]|['"]$/g, ''))
59
+ .filter(Boolean);
60
+ }
61
+ else {
62
+ val = val.replace(/^['"]|['"]$/g, '');
63
+ result[key] = val;
64
+ }
65
+ }
66
+ }
67
+ }
68
+ return result;
69
+ }
70
+ /**
71
+ * Recursively scans a directory and collects all files, skipping ignore patterns.
72
+ */
73
+ function scanDirectory(dir, baseDir = dir) {
74
+ const entries = fs.readdirSync(dir, { withFileTypes: true });
75
+ const files = [];
76
+ for (const entry of entries) {
77
+ const fullPath = path.join(dir, entry.name);
78
+ const relPath = path.relative(baseDir, fullPath).replace(/\\/g, '/');
79
+ if (entry.isDirectory()) {
80
+ if (IGNORED_DIRS.has(entry.name))
81
+ continue;
82
+ files.push(...scanDirectory(fullPath, baseDir));
83
+ }
84
+ else if (entry.isFile()) {
85
+ if (IGNORED_FILES.has(entry.name))
86
+ continue;
87
+ if (entry.name.startsWith('.env'))
88
+ continue;
89
+ if (entry.name.endsWith('.log'))
90
+ continue;
91
+ const content = fs.readFileSync(fullPath);
92
+ files.push({ path: relPath, content });
93
+ }
94
+ }
95
+ return files;
96
+ }
97
+ /**
98
+ * Loads a skill directory, resolves the manifest, and builds the SkillPackage and zip archive.
99
+ */
100
+ export function loadSkillPackage(sourceDir) {
101
+ const resolvedDir = path.resolve(sourceDir);
102
+ if (!fs.existsSync(resolvedDir)) {
103
+ throw new Error(`Directory not found: ${resolvedDir}`);
104
+ }
105
+ const stat = fs.statSync(resolvedDir);
106
+ if (!stat.isDirectory()) {
107
+ throw new Error(`Path is not a directory: ${resolvedDir}`);
108
+ }
109
+ const files = scanDirectory(resolvedDir);
110
+ // Look for manifest in skillhouse.json or manifest.json
111
+ let manifest = {};
112
+ const manifestFile = files.find((f) => f.path === 'skillhouse.json' || f.path === 'manifest.json');
113
+ if (manifestFile) {
114
+ try {
115
+ manifest = JSON.parse(manifestFile.content.toString('utf-8'));
116
+ }
117
+ catch {
118
+ // JSON parse error will result in empty manifest, flagged by checker
119
+ }
120
+ }
121
+ else {
122
+ // Check SKILL.md frontmatter fallback
123
+ const skillMdFile = files.find((f) => f.path === 'SKILL.md');
124
+ if (skillMdFile) {
125
+ const frontmatter = extractFrontmatter(skillMdFile.content.toString('utf-8'));
126
+ manifest = {
127
+ id: (frontmatter.id || frontmatter.name || ''),
128
+ title: (frontmatter.title || ''),
129
+ summary: (frontmatter.summary || frontmatter.description || ''),
130
+ category: (frontmatter.category || ''),
131
+ version: (frontmatter.version || ''),
132
+ agents: Array.isArray(frontmatter.agents)
133
+ ? frontmatter.agents
134
+ : [],
135
+ access: (frontmatter.access || 'free'),
136
+ };
137
+ }
138
+ }
139
+ const pkg = {
140
+ manifest: {
141
+ id: manifest.id ?? '',
142
+ title: manifest.title ?? '',
143
+ summary: manifest.summary ?? '',
144
+ category: manifest.category ?? '',
145
+ version: manifest.version ?? '',
146
+ agents: manifest.agents ?? [],
147
+ access: manifest.access ?? 'free',
148
+ },
149
+ files,
150
+ };
151
+ // Build zip archive
152
+ const zip = new AdmZip();
153
+ for (const f of files) {
154
+ zip.addFile(f.path, f.content);
155
+ }
156
+ const zipBuffer = zip.toBuffer();
157
+ const checksum = calculateChecksum(zipBuffer);
158
+ return {
159
+ pkg,
160
+ zipBuffer,
161
+ checksum,
162
+ sourceDir: resolvedDir,
163
+ };
164
+ }
165
+ //# sourceMappingURL=package.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"package.js","sourceRoot":"","sources":["../../src/lib/package.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { type CheckReport, type SkillChecker, type SkillPackage } from './types.js';
2
+ export declare const RULE_SET_VERSION = "2026-11-13.1";
3
+ /**
4
+ * Pure quality and safety checker for skill packages.
5
+ * Runs locally before upload to provide immediate creator feedback.
6
+ */
7
+ export declare class DefaultSkillChecker implements SkillChecker {
8
+ check(pkg: SkillPackage): Promise<CheckReport>;
9
+ }
10
+ //# sourceMappingURL=engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,YAAY,EACjB,KAAK,YAAY,EAElB,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AA8F/C;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IAChD,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;CAsRrD"}
@@ -0,0 +1,322 @@
1
+ import { FINDING_CODES, } from './types.js';
2
+ import { verdictFromFindings } from './verdict.js';
3
+ export const RULE_SET_VERSION = '2026-11-13.1';
4
+ const SEMVER_REGEX = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
5
+ const SLUG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
6
+ const MAX_TOTAL_UNCOMPRESSED_BYTES = 10 * 1024 * 1024; // 10MB (blocks)
7
+ const WARN_TOTAL_UNCOMPRESSED_BYTES = 2 * 1024 * 1024; // 2MB (warns, passes)
8
+ const MAX_SINGLE_FILE_BYTES = 5 * 1024 * 1024; // 5MB (blocks)
9
+ const MAX_PACKAGE_FILES = 500; // 500 files (blocks)
10
+ const BINARY_EXTENSIONS = new Set([
11
+ '.png',
12
+ '.jpg',
13
+ '.jpeg',
14
+ '.gif',
15
+ '.webp',
16
+ '.ico',
17
+ '.bmp',
18
+ '.tiff',
19
+ '.zip',
20
+ '.tar',
21
+ '.gz',
22
+ '.tgz',
23
+ '.bz2',
24
+ '.7z',
25
+ '.wasm',
26
+ '.bin',
27
+ '.pdf',
28
+ '.mp3',
29
+ '.mp4',
30
+ '.mov',
31
+ '.avi',
32
+ '.woff',
33
+ '.woff2',
34
+ '.ttf',
35
+ '.eot',
36
+ ]);
37
+ function isBinaryFile(file) {
38
+ const lastDot = file.path.lastIndexOf('.');
39
+ if (lastDot !== -1) {
40
+ const ext = file.path.slice(lastDot).toLowerCase();
41
+ if (BINARY_EXTENSIONS.has(ext))
42
+ return true;
43
+ }
44
+ const checkLen = Math.min(file.content.length, 8192);
45
+ for (let i = 0; i < checkLen; i++) {
46
+ if (file.content[i] === 0)
47
+ return true;
48
+ }
49
+ return false;
50
+ }
51
+ function isInvalidPath(path) {
52
+ if (typeof path !== 'string' || path.trim().length === 0)
53
+ return true;
54
+ if (path.includes('\0'))
55
+ return true;
56
+ if (/^[\\/]/.test(path))
57
+ return true;
58
+ if (/^[a-zA-Z]:/.test(path))
59
+ return true;
60
+ const segments = path.split(/[\\/]/);
61
+ if (segments.some((seg) => seg === '..' || seg === '.'))
62
+ return true;
63
+ return false;
64
+ }
65
+ const RM_DESTRUCTIVE_PATTERN = /\brm\s+(?:-[a-zA-Z0-9]+\s+)*(?:-[a-zA-Z]*r[a-zA-Z]*f[a-zA-Z]*|-[a-zA-Z]*f[a-zA-Z]*r[a-zA-Z]*)\s+(?:--\s+)?(?:\/|\/\w+|~|\*)/i;
66
+ const FORK_BOMB_PATTERN = /:\s*\(\s*\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;\s*:/;
67
+ const SHELL_PIPE_PATTERN = /\b(?:curl|wget)\b.*?\|\s*(?:sudo\s+)?(?:ba|z)?sh\b/i;
68
+ const DISK_DESTRUCTIVE_PATTERN = /\b(?:mkfs(?:\.[a-z0-9]+)?\b|dd\b.*?\bof=\/dev\/)/i;
69
+ const SSH_KEY_PATTERN = /(?:~|\/(?:root|home\/[^/\s]+))\/\.ssh\/id_[a-zA-Z0-9_-]+/i;
70
+ const CLOUD_CRED_PATTERN = /(?:~|\/(?:root|home\/[^/\s]+))\/\.(?:aws\/credentials|config\/gcloud|kube\/config)\b/i;
71
+ const ENV_EXFIL_PATTERN = /\b(?:curl|wget)\b.*?(?:-d|--data(?:-binary|-raw)?)\s+@\.env(?:\.[a-zA-Z0-9_-]+)?\b/i;
72
+ const HIDDEN_TEXT_PATTERN = /[\u200B-\u200D\uFEFF\u202A-\u202E\u2066-\u2069]|[\u{E0001}-\u{E007F}]/u;
73
+ const AGENT_OVERRIDE_PATTERNS = [
74
+ /\bignore\s+(?:all\s+)?(?:previous|prior|above)\s+instructions\b/i,
75
+ /\bdisregard\s+(?:all\s+)?(?:previous|prior|above)\s+(?:instructions|directives)\b/i,
76
+ /\byou\s+are\s+now\s+in\s+developer\s+mode\b/i,
77
+ /\bdeveloper\s+mode\s+and\s+have\s+no\s+restrictions\b/i,
78
+ /\bbypass\s+(?:all\s+)?(?:safety|security)\s+(?:guidelines|rules|filters|checks|restrictions)\b/i,
79
+ /\bsystem\s+prompt\s+override\b/i,
80
+ ];
81
+ /**
82
+ * Pure quality and safety checker for skill packages.
83
+ * Runs locally before upload to provide immediate creator feedback.
84
+ */
85
+ export class DefaultSkillChecker {
86
+ async check(pkg) {
87
+ const findings = [];
88
+ if (!pkg || typeof pkg !== 'object') {
89
+ findings.push({
90
+ code: FINDING_CODES.MANIFEST_INVALID,
91
+ category: 'quality',
92
+ severity: 'high',
93
+ message: 'Invalid package: package payload is missing or empty.',
94
+ });
95
+ return {
96
+ verdict: 'block',
97
+ findings,
98
+ ruleSetVersion: RULE_SET_VERSION,
99
+ };
100
+ }
101
+ const manifest = pkg.manifest || {};
102
+ const files = Array.isArray(pkg.files) ? pkg.files : [];
103
+ // --- Quality Check: Manifest validation ---
104
+ if (!manifest.id ||
105
+ typeof manifest.id !== 'string' ||
106
+ manifest.id.length < 2 ||
107
+ manifest.id.length > 100 ||
108
+ !SLUG_REGEX.test(manifest.id)) {
109
+ findings.push({
110
+ code: FINDING_CODES.MANIFEST_INVALID,
111
+ category: 'quality',
112
+ severity: 'high',
113
+ message: 'Skill id must be a lowercase slug between 2 and 100 characters (e.g. "my-skill").',
114
+ });
115
+ }
116
+ if (!manifest.title ||
117
+ typeof manifest.title !== 'string' ||
118
+ manifest.title.trim().length === 0 ||
119
+ manifest.title.length > 100) {
120
+ findings.push({
121
+ code: FINDING_CODES.MANIFEST_INVALID,
122
+ category: 'quality',
123
+ severity: 'high',
124
+ message: 'Skill title must be between 1 and 100 characters.',
125
+ });
126
+ }
127
+ if (!manifest.summary ||
128
+ typeof manifest.summary !== 'string' ||
129
+ manifest.summary.trim().length === 0 ||
130
+ manifest.summary.length > 300) {
131
+ findings.push({
132
+ code: FINDING_CODES.MANIFEST_INVALID,
133
+ category: 'quality',
134
+ severity: 'high',
135
+ message: 'Skill summary must be between 1 and 300 characters.',
136
+ });
137
+ }
138
+ if (!manifest.category ||
139
+ typeof manifest.category !== 'string' ||
140
+ manifest.category.trim().length === 0 ||
141
+ manifest.category.length > 50) {
142
+ findings.push({
143
+ code: FINDING_CODES.MANIFEST_INVALID,
144
+ category: 'quality',
145
+ severity: 'high',
146
+ message: 'Skill category must be between 1 and 50 characters.',
147
+ });
148
+ }
149
+ if (!manifest.version ||
150
+ typeof manifest.version !== 'string' ||
151
+ !SEMVER_REGEX.test(manifest.version)) {
152
+ findings.push({
153
+ code: FINDING_CODES.MANIFEST_INVALID,
154
+ category: 'quality',
155
+ severity: 'high',
156
+ message: 'Skill version must be valid semver (e.g. "1.0.0").',
157
+ });
158
+ }
159
+ if (!Array.isArray(manifest.agents) ||
160
+ manifest.agents.length === 0 ||
161
+ manifest.agents.some((a) => typeof a !== 'string' || a.trim().length === 0 || a.length > 50)) {
162
+ findings.push({
163
+ code: FINDING_CODES.MANIFEST_INVALID,
164
+ category: 'quality',
165
+ severity: 'high',
166
+ message: 'Skill agents must contain at least one valid agent name (max 50 chars each).',
167
+ });
168
+ }
169
+ if (manifest.access !== 'free' && manifest.access !== 'premium') {
170
+ findings.push({
171
+ code: FINDING_CODES.MANIFEST_INVALID,
172
+ category: 'quality',
173
+ severity: 'high',
174
+ message: 'Skill access tier must be "free" or "premium".',
175
+ });
176
+ }
177
+ // --- Quality Check: File Paths & Counts ---
178
+ let totalUncompressedBytes = 0;
179
+ let hasSkillMd = false;
180
+ let skillMdEmpty = true;
181
+ if (files.length > MAX_PACKAGE_FILES) {
182
+ findings.push({
183
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
184
+ category: 'quality',
185
+ severity: 'high',
186
+ message: `Package contains ${files.length} files (maximum allowed is ${MAX_PACKAGE_FILES}).`,
187
+ });
188
+ }
189
+ for (const file of files) {
190
+ if (isInvalidPath(file.path)) {
191
+ findings.push({
192
+ code: FINDING_CODES.MANIFEST_INVALID,
193
+ category: 'quality',
194
+ severity: 'high',
195
+ message: 'Package file path is invalid or unsafe.',
196
+ file: file.path,
197
+ });
198
+ }
199
+ const fileLen = file.content ? file.content.length : 0;
200
+ totalUncompressedBytes += fileLen;
201
+ if (fileLen > MAX_SINGLE_FILE_BYTES) {
202
+ findings.push({
203
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
204
+ category: 'quality',
205
+ severity: 'high',
206
+ message: 'File exceeds maximum single file size limit of 5MB.',
207
+ file: file.path,
208
+ });
209
+ }
210
+ if (file.path === 'SKILL.md') {
211
+ hasSkillMd = true;
212
+ if (file.content && file.content.toString('utf-8').trim().length > 0) {
213
+ skillMdEmpty = false;
214
+ }
215
+ }
216
+ }
217
+ if (!hasSkillMd) {
218
+ findings.push({
219
+ code: FINDING_CODES.REQUIRED_FILE_MISSING,
220
+ category: 'quality',
221
+ severity: 'high',
222
+ message: 'Required file SKILL.md is missing from the package.',
223
+ file: 'SKILL.md',
224
+ });
225
+ }
226
+ else if (skillMdEmpty) {
227
+ findings.push({
228
+ code: FINDING_CODES.REQUIRED_FILE_MISSING,
229
+ category: 'quality',
230
+ severity: 'high',
231
+ message: 'Required file SKILL.md is empty.',
232
+ file: 'SKILL.md',
233
+ });
234
+ }
235
+ if (totalUncompressedBytes > MAX_TOTAL_UNCOMPRESSED_BYTES) {
236
+ findings.push({
237
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
238
+ category: 'quality',
239
+ severity: 'high',
240
+ message: `Total package size (${totalUncompressedBytes} bytes) exceeds the 10MB limit.`,
241
+ });
242
+ }
243
+ else if (totalUncompressedBytes > WARN_TOTAL_UNCOMPRESSED_BYTES) {
244
+ findings.push({
245
+ code: FINDING_CODES.PACKAGE_TOO_LARGE,
246
+ category: 'quality',
247
+ severity: 'medium',
248
+ message: `Total package size (${totalUncompressedBytes} bytes) exceeds 2MB warning threshold.`,
249
+ });
250
+ }
251
+ // --- Safety Checks: Text files scanning ---
252
+ for (const file of files) {
253
+ if (isBinaryFile(file)) {
254
+ continue;
255
+ }
256
+ const text = file.content.toString('utf-8');
257
+ const lines = text.split(/\r?\n/);
258
+ for (let i = 0; i < lines.length; i++) {
259
+ const line = lines[i];
260
+ const lineNum = i + 1;
261
+ // 1. Dangerous system commands
262
+ if (RM_DESTRUCTIVE_PATTERN.test(line) ||
263
+ FORK_BOMB_PATTERN.test(line) ||
264
+ SHELL_PIPE_PATTERN.test(line) ||
265
+ DISK_DESTRUCTIVE_PATTERN.test(line)) {
266
+ findings.push({
267
+ code: FINDING_CODES.DANGEROUS_COMMAND,
268
+ category: 'safety',
269
+ severity: 'high',
270
+ message: 'Potentially dangerous system command detected.',
271
+ file: file.path,
272
+ line: lineNum,
273
+ });
274
+ }
275
+ // 2. Data exfiltration and credential reading
276
+ if (SSH_KEY_PATTERN.test(line) ||
277
+ CLOUD_CRED_PATTERN.test(line) ||
278
+ ENV_EXFIL_PATTERN.test(line)) {
279
+ findings.push({
280
+ code: FINDING_CODES.DATA_EXFILTRATION,
281
+ category: 'safety',
282
+ severity: 'high',
283
+ message: 'Potential credential access or secret exfiltration detected.',
284
+ file: file.path,
285
+ line: lineNum,
286
+ });
287
+ }
288
+ // 3. Hidden or invisible text
289
+ if (HIDDEN_TEXT_PATTERN.test(line)) {
290
+ findings.push({
291
+ code: FINDING_CODES.HIDDEN_TEXT,
292
+ category: 'safety',
293
+ severity: 'medium',
294
+ message: 'Hidden or zero-width characters detected.',
295
+ file: file.path,
296
+ line: lineNum,
297
+ });
298
+ }
299
+ // 4. Agent prompt overrides
300
+ for (const overridePattern of AGENT_OVERRIDE_PATTERNS) {
301
+ if (overridePattern.test(line)) {
302
+ findings.push({
303
+ code: FINDING_CODES.AGENT_OVERRIDE,
304
+ category: 'safety',
305
+ severity: 'medium',
306
+ message: 'Attempted agent instruction override detected.',
307
+ file: file.path,
308
+ line: lineNum,
309
+ });
310
+ break;
311
+ }
312
+ }
313
+ }
314
+ }
315
+ return {
316
+ verdict: verdictFromFindings(findings),
317
+ findings,
318
+ ruleSetVersion: RULE_SET_VERSION,
319
+ };
320
+ }
321
+ }
322
+ //# sourceMappingURL=engine.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { SkillPackageFile } from './types.js';
2
+ /**
3
+ * Files in a package that might run code on a person's machine. Fails closed: a file counts as plain only if
4
+ * its ending is a known plain-content type (or it is a well-known text file like LICENSE) AND its first bytes are
5
+ * not a program or a `#!` line AND it is not inside a scripts/ or bin/ folder at any depth. Everything else is
6
+ * reported, so renaming a script to `notes.txt`-style tricks or using an unknown ending does not hide it.
7
+ * This is a "heads up" so the terminal can ask first, not a verdict on whether the contents are harmful.
8
+ */
9
+ export declare function detectExecutables(files: SkillPackageFile[]): string[];
10
+ //# sourceMappingURL=executables.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executables.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/executables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsBnD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,EAAE,CASrE"}
@@ -0,0 +1,35 @@
1
+ /** File endings that are plain content: text, data and images an agent reads but nothing runs. */
2
+ const PLAIN_EXTENSIONS = new Set(['md', 'markdown', 'txt', 'json', 'yaml', 'yml', 'csv', 'png', 'jpg', 'jpeg', 'gif', 'webp', 'svg']);
3
+ /** Well-known files with no ending that are plain text. */
4
+ const PLAIN_NAMES = new Set(['license', 'licence', 'readme', 'notice', 'changelog']);
5
+ /** First bytes of programs: ELF, Mach-O (all variants, fat), Windows PE, WebAssembly. */
6
+ const MAGIC = [
7
+ [0x7f, 0x45, 0x4c, 0x46],
8
+ [0xfe, 0xed, 0xfa, 0xce],
9
+ [0xfe, 0xed, 0xfa, 0xcf],
10
+ [0xce, 0xfa, 0xed, 0xfe],
11
+ [0xcf, 0xfa, 0xed, 0xfe],
12
+ [0xca, 0xfe, 0xba, 0xbe],
13
+ [0x4d, 0x5a],
14
+ [0x00, 0x61, 0x73, 0x6d],
15
+ [0x23, 0x21], // "#!" script
16
+ ];
17
+ const startsWith = (b, sig) => b.length >= sig.length && sig.every((x, i) => b[i] === x);
18
+ /**
19
+ * Files in a package that might run code on a person's machine. Fails closed: a file counts as plain only if
20
+ * its ending is a known plain-content type (or it is a well-known text file like LICENSE) AND its first bytes are
21
+ * not a program or a `#!` line AND it is not inside a scripts/ or bin/ folder at any depth. Everything else is
22
+ * reported, so renaming a script to `notes.txt`-style tricks or using an unknown ending does not hide it.
23
+ * This is a "heads up" so the terminal can ask first, not a verdict on whether the contents are harmful.
24
+ */
25
+ export function detectExecutables(files) {
26
+ const found = files.filter((f) => {
27
+ const name = (f.path.split('/').pop() ?? '').toLowerCase();
28
+ const dot = name.lastIndexOf('.');
29
+ const plainName = dot > 0 ? PLAIN_EXTENSIONS.has(name.slice(dot + 1)) : PLAIN_NAMES.has(name);
30
+ const inScripts = /(^|\/)(scripts|bin)\//i.test(f.path);
31
+ return !plainName || inScripts || MAGIC.some((sig) => startsWith(f.content, sig));
32
+ });
33
+ return found.map((f) => f.path).sort();
34
+ }
35
+ //# sourceMappingURL=executables.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"executables.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/executables.ts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACtI,2DAA2D;AAC3D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAErF,yFAAyF;AACzF,MAAM,KAAK,GAAe;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,CAAC;IACZ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACxB,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,cAAc;CAC7B,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,CAAsB,EAAE,GAAa,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;AAExH;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9F,MAAM,SAAS,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,CAAC,SAAS,IAAI,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './types.js';
2
+ export * from './verdict.js';
3
+ export * from './engine.js';
4
+ export * from './executables.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/skill-checks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,5 @@
1
+ export * from './types.js';
2
+ export * from './verdict.js';
3
+ export * from './engine.js';
4
+ export * from './executables.js';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/skill-checks/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,53 @@
1
+ /**
2
+ * Skill checks: the shared seam between the `skillhouse` CLI and the API.
3
+ *
4
+ * Runs identically in the CLI (locally before upload) and on the API server.
5
+ */
6
+ export interface SkillPackageFile {
7
+ path: string;
8
+ content: Buffer;
9
+ }
10
+ export interface SkillManifest {
11
+ id: string;
12
+ title: string;
13
+ summary: string;
14
+ category: string;
15
+ version: string;
16
+ agents: string[];
17
+ access: 'free' | 'premium';
18
+ }
19
+ export interface SkillPackage {
20
+ manifest: SkillManifest;
21
+ files: SkillPackageFile[];
22
+ }
23
+ export type FindingCategory = 'quality' | 'safety';
24
+ export type FindingSeverity = 'low' | 'medium' | 'high';
25
+ export declare const FINDING_CODES: {
26
+ readonly MANIFEST_INVALID: "manifest_invalid";
27
+ readonly REQUIRED_FILE_MISSING: "required_file_missing";
28
+ readonly PACKAGE_TOO_LARGE: "package_too_large";
29
+ readonly VERSION_NOT_NEWER: "version_not_newer";
30
+ readonly DANGEROUS_COMMAND: "dangerous_command";
31
+ readonly DATA_EXFILTRATION: "data_exfiltration";
32
+ readonly HIDDEN_TEXT: "hidden_text";
33
+ readonly AGENT_OVERRIDE: "agent_override";
34
+ };
35
+ export type FindingCode = (typeof FINDING_CODES)[keyof typeof FINDING_CODES];
36
+ export interface Finding {
37
+ code: FindingCode;
38
+ category: FindingCategory;
39
+ severity: FindingSeverity;
40
+ message: string;
41
+ file?: string;
42
+ line?: number;
43
+ }
44
+ export type Verdict = 'pass' | 'review' | 'block';
45
+ export interface CheckReport {
46
+ verdict: Verdict;
47
+ findings: Finding[];
48
+ ruleSetVersion: string;
49
+ }
50
+ export interface SkillChecker {
51
+ check(pkg: SkillPackage): Promise<CheckReport>;
52
+ }
53
+ //# sourceMappingURL=types.d.ts.map