skills-manager-cli 2026.8.26-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 (91) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +103 -0
  3. package/README.zh-CN.md +103 -0
  4. package/dist/cli/main.js +261 -0
  5. package/dist/cli/main.js.map +1 -0
  6. package/dist/cli.js +3 -0
  7. package/dist/cli.js.map +1 -0
  8. package/dist/core/catalog/agent-catalog.json +1134 -0
  9. package/dist/core/catalog/evaluate-detection.js +41 -0
  10. package/dist/core/catalog/evaluate-detection.js.map +1 -0
  11. package/dist/core/catalog/extract.js +388 -0
  12. package/dist/core/catalog/extract.js.map +1 -0
  13. package/dist/core/catalog/resolve-path.js +29 -0
  14. package/dist/core/catalog/resolve-path.js.map +1 -0
  15. package/dist/core/catalog/validate-snapshot.js +117 -0
  16. package/dist/core/catalog/validate-snapshot.js.map +1 -0
  17. package/dist/core/index.js +6 -0
  18. package/dist/core/index.js.map +1 -0
  19. package/dist/core/model/catalog.js +7 -0
  20. package/dist/core/model/catalog.js.map +1 -0
  21. package/dist/core/model/index.js +7 -0
  22. package/dist/core/model/index.js.map +1 -0
  23. package/dist/core/ports/filesystem.js +2 -0
  24. package/dist/core/ports/filesystem.js.map +1 -0
  25. package/dist/core/ports/git.js +2 -0
  26. package/dist/core/ports/git.js.map +1 -0
  27. package/dist/core/ports/process-runner.js +2 -0
  28. package/dist/core/ports/process-runner.js.map +1 -0
  29. package/dist/core/services/activity-service.js +36 -0
  30. package/dist/core/services/activity-service.js.map +1 -0
  31. package/dist/core/services/adopt-service.js +7 -0
  32. package/dist/core/services/adopt-service.js.map +1 -0
  33. package/dist/core/services/archive-service.js +35 -0
  34. package/dist/core/services/archive-service.js.map +1 -0
  35. package/dist/core/services/backup-service.js +94 -0
  36. package/dist/core/services/backup-service.js.map +1 -0
  37. package/dist/core/services/catalog-service.js +123 -0
  38. package/dist/core/services/catalog-service.js.map +1 -0
  39. package/dist/core/services/distribute-service.js +474 -0
  40. package/dist/core/services/distribute-service.js.map +1 -0
  41. package/dist/core/services/doctor-service.js +75 -0
  42. package/dist/core/services/doctor-service.js.map +1 -0
  43. package/dist/core/services/index.js +54 -0
  44. package/dist/core/services/index.js.map +1 -0
  45. package/dist/core/services/init-service.js +234 -0
  46. package/dist/core/services/init-service.js.map +1 -0
  47. package/dist/core/services/install-service.js +73 -0
  48. package/dist/core/services/install-service.js.map +1 -0
  49. package/dist/core/services/migration-service.js +102 -0
  50. package/dist/core/services/migration-service.js.map +1 -0
  51. package/dist/core/services/package-service.js +33 -0
  52. package/dist/core/services/package-service.js.map +1 -0
  53. package/dist/core/services/registry-service.js +133 -0
  54. package/dist/core/services/registry-service.js.map +1 -0
  55. package/dist/core/services/skill-home-resolver.js +33 -0
  56. package/dist/core/services/skill-home-resolver.js.map +1 -0
  57. package/dist/core/services/skill-home-service.js +35 -0
  58. package/dist/core/services/skill-home-service.js.map +1 -0
  59. package/dist/core/services/source-service.js +109 -0
  60. package/dist/core/services/source-service.js.map +1 -0
  61. package/dist/core/services/update-service.js +93 -0
  62. package/dist/core/services/update-service.js.map +1 -0
  63. package/dist/core/services/view-service.js +45 -0
  64. package/dist/core/services/view-service.js.map +1 -0
  65. package/dist/dashboard/server/main.js +427 -0
  66. package/dist/dashboard/server/main.js.map +1 -0
  67. package/dist/dashboard/server/render-markdown.js +75 -0
  68. package/dist/dashboard/server/render-markdown.js.map +1 -0
  69. package/dist/dashboard/server/skill-file.js +129 -0
  70. package/dist/dashboard/server/skill-file.js.map +1 -0
  71. package/dist/dashboard-web/assets/index-B43GPIpA.js +13 -0
  72. package/dist/dashboard-web/assets/index-CzbkHV2A.css +1 -0
  73. package/dist/dashboard-web/index.html +13 -0
  74. package/dist/infra/fs-skill-home.js +87 -0
  75. package/dist/infra/fs-skill-home.js.map +1 -0
  76. package/dist/infra/git-cli.js +36 -0
  77. package/dist/infra/git-cli.js.map +1 -0
  78. package/dist/infra/index.js +5 -0
  79. package/dist/infra/index.js.map +1 -0
  80. package/dist/infra/runtime.js +23 -0
  81. package/dist/infra/runtime.js.map +1 -0
  82. package/dist/infra/shell-runner.js +18 -0
  83. package/dist/infra/shell-runner.js.map +1 -0
  84. package/dist/shared/errors.js +17 -0
  85. package/dist/shared/errors.js.map +1 -0
  86. package/dist/shared/result.js +17 -0
  87. package/dist/shared/result.js.map +1 -0
  88. package/dist/shared/validation.js +92 -0
  89. package/dist/shared/validation.js.map +1 -0
  90. package/docs/CLI.md +75 -0
  91. package/package.json +73 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry-service.js","sourceRoot":"","sources":["../../../src/core/services/registry-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ import os from 'node:os';
2
+ import path from 'node:path';
3
+ import { createSkillHome, SkillHomeService } from './skill-home-service.js';
4
+ export class SkillHomeResolver {
5
+ fs;
6
+ constructor(fs) {
7
+ this.fs = fs;
8
+ }
9
+ resolve(input = {}) {
10
+ const env = input.env || process.env;
11
+ const cwd = path.resolve(input.cwd || process.cwd());
12
+ const defaultHome = path.resolve(input.defaultHome || path.join(os.homedir(), '.skills-manager'));
13
+ if (input.explicitHome)
14
+ return this.ensure(path.resolve(input.explicitHome), 'explicit');
15
+ if (env.SKILL_HOME)
16
+ return this.ensure(path.resolve(env.SKILL_HOME), 'env');
17
+ if (this.isSkillHome(cwd))
18
+ return { root: cwd, reason: 'cwd', created: false };
19
+ return this.ensure(defaultHome, 'default');
20
+ }
21
+ isSkillHome(root) {
22
+ return this.fs.kind(path.join(root, 'skills')) === 'directory'
23
+ && this.fs.kind(path.join(root, 'registry.yaml')) === 'file';
24
+ }
25
+ ensure(root, reason) {
26
+ const existed = this.isSkillHome(root);
27
+ const service = new SkillHomeService(this.fs, createSkillHome(root));
28
+ service.ensure();
29
+ this.fs.makeDirectory(path.dirname(service.home.activityFile));
30
+ return { root, reason, created: !existed };
31
+ }
32
+ }
33
+ //# sourceMappingURL=skill-home-resolver.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-home-resolver.js","sourceRoot":"","sources":["../../../src/core/services/skill-home-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAe5E,MAAM,OAAO,iBAAiB;IACC,EAAE;IAA/B,YAA6B,EAAkB;kBAAlB,EAAE;IAAmB,CAAC;IAEnD,OAAO,CAAC,KAAK,GAA6B,EAAE;QAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAClG,IAAI,KAAK,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC;QACzF,IAAI,GAAG,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5E,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/E,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,WAAW;eACzD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,KAAK,MAAM,CAAC;IACjE,CAAC;IAEO,MAAM,CAAC,IAAY,EAAE,MAAqC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,MAAM,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7C,CAAC;CACF"}
@@ -0,0 +1,35 @@
1
+ import path from 'node:path';
2
+ export function createSkillHome(root) {
3
+ return {
4
+ root: path.resolve(root),
5
+ skillsDir: path.resolve(root, 'skills'),
6
+ viewsDir: path.resolve(root, 'views'),
7
+ collectionsDir: path.resolve(root, 'collections'),
8
+ registryFile: path.resolve(root, 'registry.yaml'),
9
+ activityFile: path.resolve(root, '.skills', 'activity.jsonl'),
10
+ };
11
+ }
12
+ export class SkillHomeService {
13
+ fs;
14
+ home;
15
+ constructor(fs, home) {
16
+ this.fs = fs;
17
+ this.home = home;
18
+ }
19
+ isSkillHome(root = this.home.root) {
20
+ return this.fs.kind(path.join(root, 'skills')) === 'directory'
21
+ && this.fs.kind(path.join(root, 'registry.yaml')) === 'file';
22
+ }
23
+ ensure() {
24
+ this.fs.makeDirectory(this.home.root);
25
+ this.fs.makeDirectory(this.home.skillsDir);
26
+ this.fs.makeDirectory(this.home.collectionsDir);
27
+ if (!this.fs.exists(this.home.registryFile))
28
+ this.fs.writeText(this.home.registryFile, 'skills: {}\n');
29
+ return this.home;
30
+ }
31
+ path(...parts) {
32
+ return path.join(this.home.root, ...parts);
33
+ }
34
+ }
35
+ //# sourceMappingURL=skill-home-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill-home-service.js","sourceRoot":"","sources":["../../../src/core/services/skill-home-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;QACvC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;QACrC,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC;QACjD,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC;QACjD,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,gBAAgB,CAAC;KAC9D,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,gBAAgB;IACE,EAAE;IAA2B,IAAI;IAA9D,YAA6B,EAAkB,EAAW,IAAe;kBAA5C,EAAE;oBAA2B,IAAI;IAAc,CAAC;IAE7E,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI;QAC/B,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,WAAW;eACzD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC,KAAK,MAAM,CAAC;IACjE,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YAAE,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QACvG,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,GAAG,KAAe;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF"}
@@ -0,0 +1,109 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+ import { SkillsManagerError } from '../../shared/errors.js';
5
+ import { assertPathInside, assertSafeSkillName, parseSkillMarkdownMetadata } from '../../shared/validation.js';
6
+ export class SourceService {
7
+ fs;
8
+ git;
9
+ tempRoot;
10
+ constructor(fs, git, tempRoot = os.tmpdir()) {
11
+ this.fs = fs;
12
+ this.git = git;
13
+ this.tempRoot = tempRoot;
14
+ }
15
+ normalize(source) {
16
+ const input = source.trim();
17
+ if (!input)
18
+ throw new SkillsManagerError('missing_source', 'Source is required');
19
+ if (this.fs.exists(input))
20
+ return { input, repoUrl: path.resolve(input), isLocal: true };
21
+ if (/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(input)) {
22
+ return { input, repoUrl: `https://github.com/${input}.git`, isLocal: false };
23
+ }
24
+ const githubTree = input.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+)\/tree\/(.+)$/);
25
+ if (githubTree) {
26
+ const [, owner, repo, treeRest] = githubTree;
27
+ return { input, repoUrl: `https://github.com/${owner}/${repo.replace(/\.git$/, '')}.git`, treeRest, isLocal: false };
28
+ }
29
+ const githubRepo = input.match(/^https:\/\/github\.com\/([^/]+)\/([^/#?]+)\/?$/);
30
+ if (githubRepo) {
31
+ const [, owner, repo] = githubRepo;
32
+ return { input, repoUrl: `https://github.com/${owner}/${repo.replace(/\.git$/, '')}.git`, isLocal: false };
33
+ }
34
+ return { input, repoUrl: input, isLocal: false };
35
+ }
36
+ checkout(source, forcedRef) {
37
+ const normalized = this.normalize(source);
38
+ if (normalized.isLocal) {
39
+ const commit = this.fs.kind(path.join(normalized.repoUrl, '.git')) !== 'missing'
40
+ ? this.git.revParseHead(normalized.repoUrl)
41
+ : null;
42
+ return { ...normalized, repoDir: normalized.repoUrl, commit };
43
+ }
44
+ const tree = normalized.treeRest ? this.resolveGitHubTreeRef(normalized.repoUrl, normalized.treeRest) : (forcedRef ? { ref: forcedRef } : {});
45
+ const repoDir = path.join(this.tempRoot, `skills-source-${randomUUID()}`, 'repo');
46
+ this.fs.makeDirectory(path.dirname(repoDir));
47
+ this.git.clone(normalized.repoUrl, repoDir);
48
+ if (tree.ref)
49
+ this.git.checkout(repoDir, tree.ref);
50
+ const commit = this.git.revParseHead(repoDir);
51
+ return { ...normalized, ...tree, repoDir, commit };
52
+ }
53
+ discover(source) {
54
+ const baseDir = source.baseSubpath ? path.join(source.repoDir, source.baseSubpath) : source.repoDir;
55
+ if (this.fs.kind(baseDir) !== 'directory')
56
+ throw new SkillsManagerError('source_path_missing', `Discovery path does not exist: ${baseDir}`);
57
+ assertPathInside(baseDir, source.repoDir);
58
+ const found = [];
59
+ const walk = (dir) => {
60
+ assertPathInside(dir, source.repoDir);
61
+ const skillFile = path.join(dir, 'SKILL.md');
62
+ if (this.fs.kind(skillFile) === 'file') {
63
+ const metadata = parseSkillMarkdownMetadata(this.fs.readText(skillFile));
64
+ const fallbackName = path.basename(dir);
65
+ const name = String(metadata.name || fallbackName).trim();
66
+ assertSafeSkillName(name);
67
+ found.push({
68
+ name,
69
+ title: metadata.title || name,
70
+ description: metadata.description || '',
71
+ subpath: path.relative(source.repoDir, dir).split(path.sep).join('/'),
72
+ absoluteDir: dir,
73
+ });
74
+ return;
75
+ }
76
+ for (const entry of this.fs.readDirectory(dir)) {
77
+ if (entry.kind !== 'directory' || this.shouldSkipDiscoverDir(entry.name))
78
+ continue;
79
+ walk(path.join(dir, entry.name));
80
+ }
81
+ };
82
+ walk(baseDir);
83
+ return found.sort((a, b) => a.name.localeCompare(b.name) || a.subpath.localeCompare(b.subpath));
84
+ }
85
+ assertUniqueSkillDestinations(skills) {
86
+ const byName = new Map();
87
+ for (const skill of skills)
88
+ byName.set(skill.name, [...(byName.get(skill.name) || []), skill.subpath]);
89
+ const duplicates = [...byName.entries()].filter(([, subpaths]) => subpaths.length > 1);
90
+ if (duplicates.length > 0) {
91
+ throw new SkillsManagerError('duplicate_skill_names', `Selected skills contain duplicate destination names: ${duplicates.map(([name, subpaths]) => `${name} (${subpaths.join(', ')})`).join('; ')}`);
92
+ }
93
+ }
94
+ resolveGitHubTreeRef(repoUrl, treeRest) {
95
+ const heads = this.git.listRemoteHeads(repoUrl).sort((a, b) => b.length - a.length);
96
+ for (const head of heads) {
97
+ if (treeRest === head)
98
+ return { ref: head };
99
+ if (treeRest.startsWith(`${head}/`))
100
+ return { ref: head, baseSubpath: treeRest.slice(head.length + 1) || undefined };
101
+ }
102
+ const [fallbackRef, ...rest] = treeRest.split('/');
103
+ return { ref: fallbackRef, baseSubpath: rest.join('/') || undefined };
104
+ }
105
+ shouldSkipDiscoverDir(dirName) {
106
+ return ['.git', 'node_modules', 'dist', 'build', '.next', '.turbo'].includes(dirName);
107
+ }
108
+ }
109
+ //# sourceMappingURL=source-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"source-service.js","sourceRoot":"","sources":["../../../src/core/services/source-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,93 @@
1
+ import path from 'node:path';
2
+ import { SkillsManagerError } from '../../shared/errors.js';
3
+ import { parseAgentTags } from '../../shared/validation.js';
4
+ export class UpdateService {
5
+ registry;
6
+ source;
7
+ installer;
8
+ constructor(registry, source, installer) {
9
+ this.registry = registry;
10
+ this.source = source;
11
+ this.installer = installer;
12
+ }
13
+ candidatesFromRegistry() {
14
+ const registry = this.registry.load();
15
+ const candidates = [];
16
+ for (const [skill, entry] of Object.entries(registry.skills || {})) {
17
+ if (entry.archived || !this.registry.skillExists(skill))
18
+ continue;
19
+ const url = entry.source?.url;
20
+ const subpath = entry.source?.subpath;
21
+ if (!url || !subpath)
22
+ continue;
23
+ candidates.push({
24
+ skill,
25
+ url,
26
+ subpath,
27
+ ref: entry.source?.ref || undefined,
28
+ title: entry.title || skill,
29
+ description: entry.description || '',
30
+ consumers: entry.consumers !== undefined ? parseAgentTags(entry.consumers, undefined, { allowEmpty: true }) : [],
31
+ });
32
+ }
33
+ return candidates.sort((a, b) => a.skill.localeCompare(b.skill));
34
+ }
35
+ plan() {
36
+ const candidates = this.candidatesFromRegistry();
37
+ return { candidates, groups: this.groupCandidates(candidates) };
38
+ }
39
+ groupCandidates(candidates) {
40
+ const groups = new Map();
41
+ for (const candidate of candidates) {
42
+ const key = this.sourceKey(candidate.url, candidate.ref);
43
+ const group = groups.get(key) || { key, url: candidate.url, ref: candidate.ref, skills: [] };
44
+ group.skills.push(candidate);
45
+ groups.set(key, group);
46
+ }
47
+ return [...groups.values()].sort((a, b) => a.url.localeCompare(b.url) || (a.ref || '').localeCompare(b.ref || ''));
48
+ }
49
+ updateSkills(skillNames) {
50
+ const byName = new Map(this.candidatesFromRegistry().map((candidate) => [candidate.skill, candidate]));
51
+ const missing = skillNames.filter((skill) => !byName.has(skill));
52
+ if (missing.length > 0)
53
+ throw new SkillsManagerError('update_source_missing', `Skills have no registry source: ${missing.join(', ')}`, { missing });
54
+ return this.updateCandidates(skillNames.map((skill) => byName.get(skill)));
55
+ }
56
+ updateSource(sourceKey, skillNames) {
57
+ const group = this.plan().groups.find((item) => item.key === sourceKey);
58
+ if (!group)
59
+ throw new SkillsManagerError('source_group_missing', `Source group not found: ${sourceKey}`);
60
+ if (!skillNames || skillNames.length === 0)
61
+ return this.updateCandidates(group.skills);
62
+ const requested = new Set(skillNames);
63
+ const selected = group.skills.filter((candidate) => requested.has(candidate.skill));
64
+ const missing = [...requested].filter((skill) => !selected.some((candidate) => candidate.skill === skill));
65
+ if (missing.length > 0)
66
+ throw new SkillsManagerError('source_skill_missing', `Skills are not in source group ${sourceKey}: ${missing.join(', ')}`, { missing });
67
+ return this.updateCandidates(selected);
68
+ }
69
+ updateCandidates(candidates) {
70
+ if (candidates.length === 0)
71
+ throw new SkillsManagerError('empty_update_plan', 'No skills to update');
72
+ const installed = [];
73
+ for (const group of this.groupCandidates([...candidates])) {
74
+ const sourceCheckout = this.source.checkout(group.url, group.ref);
75
+ for (const candidate of group.skills) {
76
+ const discovered = [{
77
+ name: candidate.skill,
78
+ title: candidate.title,
79
+ description: candidate.description,
80
+ subpath: candidate.subpath,
81
+ absoluteDir: path.join(sourceCheckout.repoDir, candidate.subpath),
82
+ }];
83
+ const plan = this.installer.planInstall(sourceCheckout, discovered, [candidate.subpath], candidate.consumers, { overwrite: true });
84
+ installed.push(...this.installer.installPlan(plan).installed);
85
+ }
86
+ }
87
+ return { updated: installed };
88
+ }
89
+ sourceKey(url, ref) {
90
+ return `${url}#${ref || ''}`;
91
+ }
92
+ }
93
+ //# sourceMappingURL=update-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update-service.js","sourceRoot":"","sources":["../../../src/core/services/update-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,OAAO,aAAa;IACK,QAAQ;IAAoC,MAAM;IAAkC,SAAS;IAA1H,YAA6B,QAAyB,EAAmB,MAAqB,EAAmB,SAAyB;wBAA7G,QAAQ;sBAAoC,MAAM;yBAAkC,SAAS;IAAmB,CAAC;IAE9I,sBAAsB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,UAAU,GAAsB,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,SAAS;YAClE,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;YAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC;YACtC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO;gBAAE,SAAS;YAC/B,UAAU,CAAC,IAAI,CAAC;gBACd,KAAK;gBACL,GAAG;gBACH,OAAO;gBACP,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,SAAS;gBACnC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK;gBAC3B,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;gBACpC,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;aACjH,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,IAAI;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACjD,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC;IAClE,CAAC;IAED,eAAe,CAAC,UAA6B;QAC3C,MAAM,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;QACpD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAC7F,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACrH,CAAC;IAED,YAAY,CAAC,UAA6B;QACxC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QACvG,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,uBAAuB,EAAE,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACpJ,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,UAA8B;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;QACxE,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,EAAE,2BAA2B,SAAS,EAAE,CAAC,CAAC;QACzG,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC;QAC3G,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,sBAAsB,EAAE,kCAAkC,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAChK,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB,CAAC,UAAsC;QACrD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;QACtG,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,CAAC;YAC1D,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YAClE,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,UAAU,GAAG,CAAC;wBAClB,IAAI,EAAE,SAAS,CAAC,KAAK;wBACrB,KAAK,EAAE,SAAS,CAAC,KAAK;wBACtB,WAAW,EAAE,SAAS,CAAC,WAAW;wBAClC,OAAO,EAAE,SAAS,CAAC,OAAO;wBAC1B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC;qBAClE,CAAC,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACnI,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IAEO,SAAS,CAAC,GAAW,EAAE,GAAY;QACzC,OAAO,GAAG,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;IAC/B,CAAC;CACF"}
@@ -0,0 +1,45 @@
1
+ import path from 'node:path';
2
+ import { SkillsManagerError } from '../../shared/errors.js';
3
+ /** Collections organization tree only (ADR-0003): consumer wiring is distribute-to-runtime, never views. */
4
+ export class ViewService {
5
+ fs;
6
+ home;
7
+ registry;
8
+ constructor(fs, home, registry) {
9
+ this.fs = fs;
10
+ this.home = home;
11
+ this.registry = registry;
12
+ }
13
+ rebuildCollections() {
14
+ this.fs.makeDirectory(this.home.collectionsDir);
15
+ for (const entry of this.fs.readDirectory(this.home.collectionsDir)) {
16
+ const full = path.join(this.home.collectionsDir, entry.name);
17
+ if (entry.kind === 'symlink' || entry.kind === 'file')
18
+ this.fs.removeFileOrSymlink(full);
19
+ else if (entry.kind === 'directory')
20
+ this.safeClearSymlinkDir(full);
21
+ }
22
+ const registry = this.registry.load();
23
+ for (const [skill, entry] of Object.entries(registry.skills || {})) {
24
+ if (entry.archived || !this.registry.skillExists(skill))
25
+ continue;
26
+ const category = entry.category || 'experimental';
27
+ const dir = path.join(this.home.collectionsDir, category);
28
+ this.fs.makeDirectory(dir);
29
+ const link = path.join(dir, skill);
30
+ if (this.fs.kind(link) === 'missing')
31
+ this.fs.symlink(path.join('..', '..', 'skills', skill), link);
32
+ }
33
+ }
34
+ safeClearSymlinkDir(dir) {
35
+ this.fs.makeDirectory(dir);
36
+ for (const entry of this.fs.readDirectory(dir)) {
37
+ const full = path.join(dir, entry.name);
38
+ if (entry.kind === 'symlink' || entry.kind === 'file')
39
+ this.fs.removeFileOrSymlink(full);
40
+ else if (entry.kind === 'directory')
41
+ throw new SkillsManagerError('unsafe_view_delete', `Refusing to delete a real directory from a generated view: ${full}`);
42
+ }
43
+ }
44
+ }
45
+ //# sourceMappingURL=view-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"view-service.js","sourceRoot":"","sources":["../../../src/core/services/view-service.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,4GAA4G;AAC5G,MAAM,OAAO,WAAW;IACO,EAAE;IAAmC,IAAI;IAA8B,QAAQ;IAA5G,YAA6B,EAAkB,EAAmB,IAAe,EAAmB,QAAyB;kBAAhG,EAAE;oBAAmC,IAAI;wBAA8B,QAAQ;IAAoB,CAAC;IAEjI,kBAAkB;QAChB,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC7D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;gBAAE,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;iBACpF,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;YACnE,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC;gBAAE,SAAS;YAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,cAAc,CAAC;YAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;YAC1D,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACnC,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,SAAS;gBAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,GAAW;QACrC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;gBAAE,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;iBACpF,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;gBAAE,MAAM,IAAI,kBAAkB,CAAC,oBAAoB,EAAE,8DAA8D,IAAI,EAAE,CAAC,CAAC;QAChK,CAAC;IACH,CAAC;CACF"}