@sentry/dotagents 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/README.md +96 -0
  2. package/dist/cli/commands/add.d.ts +12 -0
  3. package/dist/cli/commands/add.d.ts.map +1 -0
  4. package/dist/cli/commands/add.js +127 -0
  5. package/dist/cli/commands/add.js.map +1 -0
  6. package/dist/cli/commands/init.d.ts +10 -0
  7. package/dist/cli/commands/init.d.ts.map +1 -0
  8. package/dist/cli/commands/init.js +81 -0
  9. package/dist/cli/commands/init.js.map +1 -0
  10. package/dist/cli/commands/init.test.d.ts +2 -0
  11. package/dist/cli/commands/init.test.d.ts.map +1 -0
  12. package/dist/cli/commands/init.test.js +71 -0
  13. package/dist/cli/commands/init.test.js.map +1 -0
  14. package/dist/cli/commands/install.d.ts +15 -0
  15. package/dist/cli/commands/install.d.ts.map +1 -0
  16. package/dist/cli/commands/install.js +139 -0
  17. package/dist/cli/commands/install.js.map +1 -0
  18. package/dist/cli/commands/install.test.d.ts +2 -0
  19. package/dist/cli/commands/install.test.d.ts.map +1 -0
  20. package/dist/cli/commands/install.test.js +94 -0
  21. package/dist/cli/commands/install.test.js.map +1 -0
  22. package/dist/cli/commands/list.d.ts +13 -0
  23. package/dist/cli/commands/list.d.ts.map +1 -0
  24. package/dist/cli/commands/list.js +82 -0
  25. package/dist/cli/commands/list.js.map +1 -0
  26. package/dist/cli/commands/list.test.d.ts +2 -0
  27. package/dist/cli/commands/list.test.d.ts.map +1 -0
  28. package/dist/cli/commands/list.test.js +96 -0
  29. package/dist/cli/commands/list.test.js.map +1 -0
  30. package/dist/cli/commands/remove.d.ts +10 -0
  31. package/dist/cli/commands/remove.d.ts.map +1 -0
  32. package/dist/cli/commands/remove.js +68 -0
  33. package/dist/cli/commands/remove.js.map +1 -0
  34. package/dist/cli/commands/sync.d.ts +16 -0
  35. package/dist/cli/commands/sync.d.ts.map +1 -0
  36. package/dist/cli/commands/sync.js +108 -0
  37. package/dist/cli/commands/sync.js.map +1 -0
  38. package/dist/cli/commands/sync.test.d.ts +2 -0
  39. package/dist/cli/commands/sync.test.d.ts.map +1 -0
  40. package/dist/cli/commands/sync.test.js +100 -0
  41. package/dist/cli/commands/sync.test.js.map +1 -0
  42. package/dist/cli/commands/update.d.ts +15 -0
  43. package/dist/cli/commands/update.d.ts.map +1 -0
  44. package/dist/cli/commands/update.js +113 -0
  45. package/dist/cli/commands/update.js.map +1 -0
  46. package/dist/cli/commands/update.test.d.ts +2 -0
  47. package/dist/cli/commands/update.test.d.ts.map +1 -0
  48. package/dist/cli/commands/update.test.js +90 -0
  49. package/dist/cli/commands/update.test.js.map +1 -0
  50. package/dist/cli/index.d.ts +2 -0
  51. package/dist/cli/index.d.ts.map +1 -0
  52. package/dist/cli/index.js +49 -0
  53. package/dist/cli/index.js.map +1 -0
  54. package/dist/config/index.d.ts +5 -0
  55. package/dist/config/index.d.ts.map +1 -0
  56. package/dist/config/index.js +4 -0
  57. package/dist/config/index.js.map +1 -0
  58. package/dist/config/loader.d.ts +6 -0
  59. package/dist/config/loader.d.ts.map +1 -0
  60. package/dist/config/loader.js +35 -0
  61. package/dist/config/loader.js.map +1 -0
  62. package/dist/config/loader.test.d.ts +2 -0
  63. package/dist/config/loader.test.d.ts.map +1 -0
  64. package/dist/config/loader.test.js +60 -0
  65. package/dist/config/loader.test.js.map +1 -0
  66. package/dist/config/schema.d.ts +37 -0
  67. package/dist/config/schema.d.ts.map +1 -0
  68. package/dist/config/schema.js +43 -0
  69. package/dist/config/schema.js.map +1 -0
  70. package/dist/config/schema.test.d.ts +2 -0
  71. package/dist/config/schema.test.d.ts.map +1 -0
  72. package/dist/config/schema.test.js +138 -0
  73. package/dist/config/schema.test.js.map +1 -0
  74. package/dist/config/writer.d.ts +17 -0
  75. package/dist/config/writer.d.ts.map +1 -0
  76. package/dist/config/writer.js +71 -0
  77. package/dist/config/writer.js.map +1 -0
  78. package/dist/config/writer.test.d.ts +2 -0
  79. package/dist/config/writer.test.d.ts.map +1 -0
  80. package/dist/config/writer.test.js +103 -0
  81. package/dist/config/writer.test.js.map +1 -0
  82. package/dist/gitignore/index.d.ts +2 -0
  83. package/dist/gitignore/index.d.ts.map +1 -0
  84. package/dist/gitignore/index.js +2 -0
  85. package/dist/gitignore/index.js.map +1 -0
  86. package/dist/gitignore/writer.d.ts +16 -0
  87. package/dist/gitignore/writer.d.ts.map +1 -0
  88. package/dist/gitignore/writer.js +40 -0
  89. package/dist/gitignore/writer.js.map +1 -0
  90. package/dist/gitignore/writer.test.d.ts +2 -0
  91. package/dist/gitignore/writer.test.d.ts.map +1 -0
  92. package/dist/gitignore/writer.test.js +99 -0
  93. package/dist/gitignore/writer.test.js.map +1 -0
  94. package/dist/index.d.ts +12 -0
  95. package/dist/index.d.ts.map +1 -0
  96. package/dist/index.js +8 -0
  97. package/dist/index.js.map +1 -0
  98. package/dist/lockfile/index.d.ts +5 -0
  99. package/dist/lockfile/index.d.ts.map +1 -0
  100. package/dist/lockfile/index.js +4 -0
  101. package/dist/lockfile/index.js.map +1 -0
  102. package/dist/lockfile/loader.d.ts +10 -0
  103. package/dist/lockfile/loader.d.ts.map +1 -0
  104. package/dist/lockfile/loader.js +36 -0
  105. package/dist/lockfile/loader.js.map +1 -0
  106. package/dist/lockfile/schema.d.ts +42 -0
  107. package/dist/lockfile/schema.d.ts.map +1 -0
  108. package/dist/lockfile/schema.js +25 -0
  109. package/dist/lockfile/schema.js.map +1 -0
  110. package/dist/lockfile/schema.test.d.ts +2 -0
  111. package/dist/lockfile/schema.test.d.ts.map +1 -0
  112. package/dist/lockfile/schema.test.js +60 -0
  113. package/dist/lockfile/schema.test.js.map +1 -0
  114. package/dist/lockfile/writer.d.ts +7 -0
  115. package/dist/lockfile/writer.d.ts.map +1 -0
  116. package/dist/lockfile/writer.js +17 -0
  117. package/dist/lockfile/writer.js.map +1 -0
  118. package/dist/lockfile/writer.test.d.ts +2 -0
  119. package/dist/lockfile/writer.test.d.ts.map +1 -0
  120. package/dist/lockfile/writer.test.js +73 -0
  121. package/dist/lockfile/writer.test.js.map +1 -0
  122. package/dist/skills/discovery.d.ts +17 -0
  123. package/dist/skills/discovery.d.ts.map +1 -0
  124. package/dist/skills/discovery.js +156 -0
  125. package/dist/skills/discovery.js.map +1 -0
  126. package/dist/skills/discovery.test.d.ts +2 -0
  127. package/dist/skills/discovery.test.d.ts.map +1 -0
  128. package/dist/skills/discovery.test.js +110 -0
  129. package/dist/skills/discovery.test.js.map +1 -0
  130. package/dist/skills/index.d.ts +7 -0
  131. package/dist/skills/index.d.ts.map +1 -0
  132. package/dist/skills/index.js +4 -0
  133. package/dist/skills/index.js.map +1 -0
  134. package/dist/skills/loader.d.ts +14 -0
  135. package/dist/skills/loader.d.ts.map +1 -0
  136. package/dist/skills/loader.js +57 -0
  137. package/dist/skills/loader.js.map +1 -0
  138. package/dist/skills/loader.test.d.ts +2 -0
  139. package/dist/skills/loader.test.d.ts.map +1 -0
  140. package/dist/skills/loader.test.js +69 -0
  141. package/dist/skills/loader.test.js.map +1 -0
  142. package/dist/skills/resolver.d.ts +46 -0
  143. package/dist/skills/resolver.d.ts.map +1 -0
  144. package/dist/skills/resolver.integration.test.d.ts +2 -0
  145. package/dist/skills/resolver.integration.test.d.ts.map +1 -0
  146. package/dist/skills/resolver.integration.test.js +106 -0
  147. package/dist/skills/resolver.integration.test.js.map +1 -0
  148. package/dist/skills/resolver.js +82 -0
  149. package/dist/skills/resolver.js.map +1 -0
  150. package/dist/skills/resolver.test.d.ts +2 -0
  151. package/dist/skills/resolver.test.d.ts.map +1 -0
  152. package/dist/skills/resolver.test.js +36 -0
  153. package/dist/skills/resolver.test.js.map +1 -0
  154. package/dist/sources/cache.d.ts +23 -0
  155. package/dist/sources/cache.d.ts.map +1 -0
  156. package/dist/sources/cache.js +61 -0
  157. package/dist/sources/cache.js.map +1 -0
  158. package/dist/sources/git.d.ts +25 -0
  159. package/dist/sources/git.d.ts.map +1 -0
  160. package/dist/sources/git.js +72 -0
  161. package/dist/sources/git.js.map +1 -0
  162. package/dist/sources/index.d.ts +5 -0
  163. package/dist/sources/index.d.ts.map +1 -0
  164. package/dist/sources/index.js +4 -0
  165. package/dist/sources/index.js.map +1 -0
  166. package/dist/sources/local.d.ts +9 -0
  167. package/dist/sources/local.d.ts.map +1 -0
  168. package/dist/sources/local.js +32 -0
  169. package/dist/sources/local.js.map +1 -0
  170. package/dist/symlinks/index.d.ts +2 -0
  171. package/dist/symlinks/index.d.ts.map +1 -0
  172. package/dist/symlinks/index.js +2 -0
  173. package/dist/symlinks/index.js.map +1 -0
  174. package/dist/symlinks/manager.d.ts +20 -0
  175. package/dist/symlinks/manager.d.ts.map +1 -0
  176. package/dist/symlinks/manager.js +103 -0
  177. package/dist/symlinks/manager.js.map +1 -0
  178. package/dist/symlinks/manager.test.d.ts +2 -0
  179. package/dist/symlinks/manager.test.d.ts.map +1 -0
  180. package/dist/symlinks/manager.test.js +94 -0
  181. package/dist/symlinks/manager.test.js.map +1 -0
  182. package/dist/utils/exec.d.ts +16 -0
  183. package/dist/utils/exec.d.ts.map +1 -0
  184. package/dist/utils/exec.js +37 -0
  185. package/dist/utils/exec.js.map +1 -0
  186. package/dist/utils/fs.d.ts +6 -0
  187. package/dist/utils/fs.d.ts.map +1 -0
  188. package/dist/utils/fs.js +10 -0
  189. package/dist/utils/fs.js.map +1 -0
  190. package/dist/utils/hash.d.ts +16 -0
  191. package/dist/utils/hash.d.ts.map +1 -0
  192. package/dist/utils/hash.js +50 -0
  193. package/dist/utils/hash.js.map +1 -0
  194. package/dist/utils/hash.test.d.ts +2 -0
  195. package/dist/utils/hash.test.d.ts.map +1 -0
  196. package/dist/utils/hash.test.js +61 -0
  197. package/dist/utils/hash.test.js.map +1 -0
  198. package/dist/utils/index.d.ts +4 -0
  199. package/dist/utils/index.d.ts.map +1 -0
  200. package/dist/utils/index.js +4 -0
  201. package/dist/utils/index.js.map +1 -0
  202. package/package.json +56 -0
@@ -0,0 +1,12 @@
1
+ export { loadConfig, ConfigError, agentsConfigSchema } from "./config/index.js";
2
+ export type { AgentsConfig, SkillDependency, SymlinksConfig, ProjectConfig, SkillSource, } from "./config/index.js";
3
+ export { writeAgentsGitignore, removeAgentsGitignore, updateAgentsGitignore } from "./gitignore/index.js";
4
+ export { ensureSkillsSymlink, verifySymlinks } from "./symlinks/index.js";
5
+ export { exec, ExecError, hashDirectory, sha256, copyDir } from "./utils/index.js";
6
+ export { clone, fetchAndReset, fetchRef, headCommit, isGitRepo, GitError, ensureCached, resolveLocalSource, LocalSourceError } from "./sources/index.js";
7
+ export type { CacheResult } from "./sources/index.js";
8
+ export { loadSkillMd, SkillLoadError, discoverSkill, discoverAllSkills, resolveSkill, parseSource, ResolveError } from "./skills/index.js";
9
+ export type { SkillMeta, DiscoveredSkill, ResolvedSkill, ResolvedGitSkill, ResolvedLocalSkill } from "./skills/index.js";
10
+ export { lockfileSchema, isGitLocked, loadLockfile, LockfileError, writeLockfile } from "./lockfile/index.js";
11
+ export type { Lockfile, LockedSkill } from "./lockfile/index.js";
12
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAChF,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzJ,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC3I,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC9G,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,8 @@
1
+ export { loadConfig, ConfigError, agentsConfigSchema } from "./config/index.js";
2
+ export { writeAgentsGitignore, removeAgentsGitignore, updateAgentsGitignore } from "./gitignore/index.js";
3
+ export { ensureSkillsSymlink, verifySymlinks } from "./symlinks/index.js";
4
+ export { exec, ExecError, hashDirectory, sha256, copyDir } from "./utils/index.js";
5
+ export { clone, fetchAndReset, fetchRef, headCommit, isGitRepo, GitError, ensureCached, resolveLocalSource, LocalSourceError } from "./sources/index.js";
6
+ export { loadSkillMd, SkillLoadError, discoverSkill, discoverAllSkills, resolveSkill, parseSource, ResolveError } from "./skills/index.js";
7
+ export { lockfileSchema, isGitLocked, loadLockfile, LockfileError, writeLockfile } from "./lockfile/index.js";
8
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQhF,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEzJ,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE3I,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
@@ -0,0 +1,5 @@
1
+ export { lockfileSchema, isGitLocked } from "./schema.js";
2
+ export type { Lockfile, LockedSkill } from "./schema.js";
3
+ export { loadLockfile, LockfileError } from "./loader.js";
4
+ export { writeLockfile } from "./writer.js";
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lockfile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,4 @@
1
+ export { lockfileSchema, isGitLocked } from "./schema.js";
2
+ export { loadLockfile, LockfileError } from "./loader.js";
3
+ export { writeLockfile } from "./writer.js";
4
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lockfile/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,10 @@
1
+ import type { Lockfile } from "./schema.js";
2
+ export declare class LockfileError extends Error {
3
+ constructor(message: string);
4
+ }
5
+ /**
6
+ * Load and validate agents.lock.
7
+ * Returns null if the file doesn't exist (first install).
8
+ */
9
+ export declare function loadLockfile(filePath: string): Promise<Lockfile | null>;
10
+ //# sourceMappingURL=loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/lockfile/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsB7E"}
@@ -0,0 +1,36 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { parse as parseTOML } from "smol-toml";
3
+ import { lockfileSchema } from "./schema.js";
4
+ export class LockfileError extends Error {
5
+ constructor(message) {
6
+ super(message);
7
+ this.name = "LockfileError";
8
+ }
9
+ }
10
+ /**
11
+ * Load and validate agents.lock.
12
+ * Returns null if the file doesn't exist (first install).
13
+ */
14
+ export async function loadLockfile(filePath) {
15
+ let raw;
16
+ try {
17
+ raw = await readFile(filePath, "utf-8");
18
+ }
19
+ catch {
20
+ return null;
21
+ }
22
+ let parsed;
23
+ try {
24
+ parsed = parseTOML(raw);
25
+ }
26
+ catch (err) {
27
+ const message = err instanceof Error ? err.message : String(err);
28
+ throw new LockfileError(`Invalid TOML in lockfile: ${message}`);
29
+ }
30
+ const result = lockfileSchema.safeParse(parsed);
31
+ if (!result.success) {
32
+ throw new LockfileError(`Invalid lockfile schema: ${result.error.message}`);
33
+ }
34
+ return result.data;
35
+ }
36
+ //# sourceMappingURL=loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/lockfile/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,IAAI,aAAa,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,aAAa,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}
@@ -0,0 +1,42 @@
1
+ import { z } from "zod/v4";
2
+ declare const lockedGitSkillSchema: z.ZodObject<{
3
+ source: z.ZodString;
4
+ resolved_url: z.ZodString;
5
+ resolved_path: z.ZodString;
6
+ resolved_ref: z.ZodOptional<z.ZodString>;
7
+ commit: z.ZodString;
8
+ integrity: z.ZodString;
9
+ }, z.core.$strip>;
10
+ declare const lockedSkillSchema: z.ZodUnion<readonly [z.ZodObject<{
11
+ source: z.ZodString;
12
+ resolved_url: z.ZodString;
13
+ resolved_path: z.ZodString;
14
+ resolved_ref: z.ZodOptional<z.ZodString>;
15
+ commit: z.ZodString;
16
+ integrity: z.ZodString;
17
+ }, z.core.$strip>, z.ZodObject<{
18
+ source: z.ZodString;
19
+ integrity: z.ZodString;
20
+ }, z.core.$strip>]>;
21
+ export type LockedSkill = z.infer<typeof lockedSkillSchema>;
22
+ export declare const lockfileSchema: z.ZodObject<{
23
+ version: z.ZodLiteral<1>;
24
+ skills: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
25
+ source: z.ZodString;
26
+ resolved_url: z.ZodString;
27
+ resolved_path: z.ZodString;
28
+ resolved_ref: z.ZodOptional<z.ZodString>;
29
+ commit: z.ZodString;
30
+ integrity: z.ZodString;
31
+ }, z.core.$strip>, z.ZodObject<{
32
+ source: z.ZodString;
33
+ integrity: z.ZodString;
34
+ }, z.core.$strip>]>>>;
35
+ }, z.core.$strip>;
36
+ export type Lockfile = z.infer<typeof lockfileSchema>;
37
+ /**
38
+ * Type guard: is this a git-based locked skill?
39
+ */
40
+ export declare function isGitLocked(skill: LockedSkill): skill is z.infer<typeof lockedGitSkillSchema>;
41
+ export {};
42
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/lockfile/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,QAAA,MAAM,oBAAoB;;;;;;;iBAOxB,CAAC;AAOH,QAAA,MAAM,iBAAiB;;;;;;;;;;mBAA0D,CAAC;AAElF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,cAAc;;;;;;;;;;;;;iBAGzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAE7F"}
@@ -0,0 +1,25 @@
1
+ import { z } from "zod/v4";
2
+ const lockedGitSkillSchema = z.object({
3
+ source: z.string(),
4
+ resolved_url: z.string(),
5
+ resolved_path: z.string(),
6
+ resolved_ref: z.string().optional(),
7
+ commit: z.string(),
8
+ integrity: z.string(),
9
+ });
10
+ const lockedLocalSkillSchema = z.object({
11
+ source: z.string(),
12
+ integrity: z.string(),
13
+ });
14
+ const lockedSkillSchema = z.union([lockedGitSkillSchema, lockedLocalSkillSchema]);
15
+ export const lockfileSchema = z.object({
16
+ version: z.literal(1),
17
+ skills: z.record(z.string(), lockedSkillSchema).default({}),
18
+ });
19
+ /**
20
+ * Type guard: is this a git-based locked skill?
21
+ */
22
+ export function isGitLocked(skill) {
23
+ return "commit" in skill && "resolved_url" in skill;
24
+ }
25
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/lockfile/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAIlF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC5D,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAkB;IAC5C,OAAO,QAAQ,IAAI,KAAK,IAAI,cAAc,IAAI,KAAK,CAAC;AACtD,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=schema.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.test.d.ts","sourceRoot":"","sources":["../../src/lockfile/schema.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,60 @@
1
+ import { describe, it, expect } from "vitest";
2
+ import { lockfileSchema, isGitLocked } from "./schema.js";
3
+ describe("lockfileSchema", () => {
4
+ it("parses a minimal lockfile", () => {
5
+ const result = lockfileSchema.safeParse({ version: 1 });
6
+ expect(result.success).toBe(true);
7
+ if (result.success) {
8
+ expect(result.data.skills).toEqual({});
9
+ }
10
+ });
11
+ it("parses a lockfile with git skills", () => {
12
+ const result = lockfileSchema.safeParse({
13
+ version: 1,
14
+ skills: {
15
+ "pdf-processing": {
16
+ source: "anthropics/skills",
17
+ resolved_url: "https://github.com/anthropics/skills.git",
18
+ resolved_path: "pdf-processing",
19
+ resolved_ref: "v1.2.0",
20
+ commit: "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
21
+ integrity: "sha256-Kx3bXjQ9mFpLw7rN8vYzTg==",
22
+ },
23
+ },
24
+ });
25
+ expect(result.success).toBe(true);
26
+ });
27
+ it("parses a lockfile with local skills", () => {
28
+ const result = lockfileSchema.safeParse({
29
+ version: 1,
30
+ skills: {
31
+ "my-skill": {
32
+ source: "path:../shared/my-skill",
33
+ integrity: "sha256-Kx3bXjQ9mFpLw7rN8vYzTg==",
34
+ },
35
+ },
36
+ });
37
+ expect(result.success).toBe(true);
38
+ });
39
+ it("rejects invalid version", () => {
40
+ expect(lockfileSchema.safeParse({ version: 2 }).success).toBe(false);
41
+ });
42
+ });
43
+ describe("isGitLocked", () => {
44
+ it("returns true for git-locked skills", () => {
45
+ expect(isGitLocked({
46
+ source: "anthropics/skills",
47
+ resolved_url: "https://github.com/anthropics/skills.git",
48
+ resolved_path: "pdf-processing",
49
+ commit: "abc123",
50
+ integrity: "sha256-test",
51
+ })).toBe(true);
52
+ });
53
+ it("returns false for local-locked skills", () => {
54
+ expect(isGitLocked({
55
+ source: "path:../shared/my-skill",
56
+ integrity: "sha256-test",
57
+ })).toBe(false);
58
+ });
59
+ });
60
+ //# sourceMappingURL=schema.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.test.js","sourceRoot":"","sources":["../../src/lockfile/schema.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC;YACtC,OAAO,EAAE,CAAC;YACV,MAAM,EAAE;gBACN,gBAAgB,EAAE;oBAChB,MAAM,EAAE,mBAAmB;oBAC3B,YAAY,EAAE,0CAA0C;oBACxD,aAAa,EAAE,gBAAgB;oBAC/B,YAAY,EAAE,QAAQ;oBACtB,MAAM,EAAE,0CAA0C;oBAClD,SAAS,EAAE,iCAAiC;iBAC7C;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC;YACtC,OAAO,EAAE,CAAC;YACV,MAAM,EAAE;gBACN,UAAU,EAAE;oBACV,MAAM,EAAE,yBAAyB;oBACjC,SAAS,EAAE,iCAAiC;iBAC7C;aACF;SACF,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CACJ,WAAW,CAAC;YACV,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,0CAA0C;YACxD,aAAa,EAAE,gBAAgB;YAC/B,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,aAAa;SACzB,CAAC,CACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CACJ,WAAW,CAAC;YACV,MAAM,EAAE,yBAAyB;YACjC,SAAS,EAAE,aAAa;SACzB,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,7 @@
1
+ import type { Lockfile } from "./schema.js";
2
+ /**
3
+ * Write an agents.lock file.
4
+ * Skills are sorted alphabetically for deterministic output.
5
+ */
6
+ export declare function writeLockfile(filePath: string, lockfile: Lockfile): Promise<void>;
7
+ //# sourceMappingURL=writer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/lockfile/writer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CASf"}
@@ -0,0 +1,17 @@
1
+ import { writeFile } from "node:fs/promises";
2
+ import { stringify } from "smol-toml";
3
+ const HEADER = "# Auto-generated by dotagents. Do not edit.\n";
4
+ /**
5
+ * Write an agents.lock file.
6
+ * Skills are sorted alphabetically for deterministic output.
7
+ */
8
+ export async function writeLockfile(filePath, lockfile) {
9
+ // Sort skills by name for deterministic output
10
+ const sortedSkills = {};
11
+ for (const name of Object.keys(lockfile.skills).sort()) {
12
+ sortedSkills[name] = lockfile.skills[name];
13
+ }
14
+ const toml = stringify({ version: lockfile.version, skills: sortedSkills });
15
+ await writeFile(filePath, HEADER + toml + "\n", "utf-8");
16
+ }
17
+ //# sourceMappingURL=writer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/lockfile/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,MAAM,GAAG,+CAA+C,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAgB,EAChB,QAAkB;IAElB,+CAA+C;IAC/C,MAAM,YAAY,GAA4B,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACvD,YAAY,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5E,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=writer.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writer.test.d.ts","sourceRoot":"","sources":["../../src/lockfile/writer.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,73 @@
1
+ import { describe, it, expect, beforeEach, afterEach } from "vitest";
2
+ import { mkdtemp, rm } from "node:fs/promises";
3
+ import { join } from "node:path";
4
+ import { tmpdir } from "node:os";
5
+ import { writeLockfile } from "./writer.js";
6
+ import { loadLockfile } from "./loader.js";
7
+ describe("writeLockfile + loadLockfile", () => {
8
+ let dir;
9
+ beforeEach(async () => {
10
+ dir = await mkdtemp(join(tmpdir(), "dotagents-lock-"));
11
+ });
12
+ afterEach(async () => {
13
+ await rm(dir, { recursive: true });
14
+ });
15
+ it("round-trips a lockfile with git skills", async () => {
16
+ const lockPath = join(dir, "agents.lock");
17
+ await writeLockfile(lockPath, {
18
+ version: 1,
19
+ skills: {
20
+ "pdf-processing": {
21
+ source: "anthropics/skills",
22
+ resolved_url: "https://github.com/anthropics/skills.git",
23
+ resolved_path: "pdf-processing",
24
+ resolved_ref: "v1.2.0",
25
+ commit: "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
26
+ integrity: "sha256-test123",
27
+ },
28
+ },
29
+ });
30
+ const loaded = await loadLockfile(lockPath);
31
+ expect(loaded).not.toBeNull();
32
+ expect(loaded.version).toBe(1);
33
+ expect(loaded.skills["pdf-processing"]?.integrity).toBe("sha256-test123");
34
+ });
35
+ it("round-trips a lockfile with local skills", async () => {
36
+ const lockPath = join(dir, "agents.lock");
37
+ await writeLockfile(lockPath, {
38
+ version: 1,
39
+ skills: {
40
+ "my-skill": {
41
+ source: "path:../shared/my-skill",
42
+ integrity: "sha256-localtest",
43
+ },
44
+ },
45
+ });
46
+ const loaded = await loadLockfile(lockPath);
47
+ expect(loaded.skills["my-skill"]?.source).toBe("path:../shared/my-skill");
48
+ });
49
+ it("sorts skills alphabetically", async () => {
50
+ const lockPath = join(dir, "agents.lock");
51
+ await writeLockfile(lockPath, {
52
+ version: 1,
53
+ skills: {
54
+ "z-skill": {
55
+ source: "org/z-repo",
56
+ integrity: "sha256-z",
57
+ },
58
+ "a-skill": {
59
+ source: "org/a-repo",
60
+ integrity: "sha256-a",
61
+ },
62
+ },
63
+ });
64
+ const loaded = await loadLockfile(lockPath);
65
+ const keys = Object.keys(loaded.skills);
66
+ expect(keys).toEqual(["a-skill", "z-skill"]);
67
+ });
68
+ it("returns null for missing lockfile", async () => {
69
+ const result = await loadLockfile(join(dir, "nope.lock"));
70
+ expect(result).toBeNull();
71
+ });
72
+ });
73
+ //# sourceMappingURL=writer.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"writer.test.js","sourceRoot":"","sources":["../../src/lockfile/writer.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import type { SkillMeta } from "./loader.js";
2
+ export interface DiscoveredSkill {
3
+ /** Relative path within the repo to the skill directory */
4
+ path: string;
5
+ meta: SkillMeta;
6
+ }
7
+ /**
8
+ * Discover a specific skill by name within a repo directory.
9
+ * Scans conventional directories in priority order.
10
+ */
11
+ export declare function discoverSkill(repoDir: string, skillName: string): Promise<DiscoveredSkill | null>;
12
+ /**
13
+ * Discover all skills in a repo.
14
+ * Scans conventional directories and returns everything found.
15
+ */
16
+ export declare function discoverAllSkills(repoDir: string): Promise<DiscoveredSkill[]>;
17
+ //# sourceMappingURL=discovery.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/skills/discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;CACjB;AAaD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAgBjC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,CAAC,CA2C5B"}
@@ -0,0 +1,156 @@
1
+ import { join } from "node:path";
2
+ import { existsSync } from "node:fs";
3
+ import { readdir } from "node:fs/promises";
4
+ import { loadSkillMd } from "./loader.js";
5
+ /**
6
+ * Conventional directories to scan for skills, in priority order.
7
+ * Each pattern is a function that takes the skill name and returns a relative path.
8
+ */
9
+ const SKILL_PATTERNS = [
10
+ (name) => name,
11
+ (name) => `skills/${name}`,
12
+ (name) => `.agents/skills/${name}`,
13
+ (name) => `.claude/skills/${name}`,
14
+ ];
15
+ /**
16
+ * Discover a specific skill by name within a repo directory.
17
+ * Scans conventional directories in priority order.
18
+ */
19
+ export async function discoverSkill(repoDir, skillName) {
20
+ // Try each conventional pattern
21
+ for (const pattern of SKILL_PATTERNS) {
22
+ const relPath = pattern(skillName);
23
+ const skillMdPath = join(repoDir, relPath, "SKILL.md");
24
+ if (existsSync(skillMdPath)) {
25
+ const meta = await loadSkillMd(skillMdPath);
26
+ return { path: relPath, meta };
27
+ }
28
+ }
29
+ // Marketplace format: check .claude-plugin/marketplace.json
30
+ const marketplaceSkill = await tryMarketplaceFormat(repoDir, skillName);
31
+ if (marketplaceSkill)
32
+ return marketplaceSkill;
33
+ return null;
34
+ }
35
+ /**
36
+ * Discover all skills in a repo.
37
+ * Scans conventional directories and returns everything found.
38
+ */
39
+ export async function discoverAllSkills(repoDir) {
40
+ const found = new Map();
41
+ // Scan each pattern location for directories containing SKILL.md
42
+ const scanDirs = [".", "skills", ".agents/skills", ".claude/skills"];
43
+ for (const scanDir of scanDirs) {
44
+ const absDir = join(repoDir, scanDir);
45
+ if (!existsSync(absDir))
46
+ continue;
47
+ let entries;
48
+ try {
49
+ entries = await readdir(absDir, { withFileTypes: true });
50
+ }
51
+ catch {
52
+ continue;
53
+ }
54
+ for (const entry of entries) {
55
+ if (!entry.isDirectory())
56
+ continue;
57
+ const skillMdPath = join(absDir, entry.name, "SKILL.md");
58
+ if (!existsSync(skillMdPath))
59
+ continue;
60
+ // First match wins (higher priority dirs are scanned first)
61
+ if (found.has(entry.name))
62
+ continue;
63
+ try {
64
+ const meta = await loadSkillMd(skillMdPath);
65
+ const relPath = scanDir === "." ? entry.name : `${scanDir}/${entry.name}`;
66
+ found.set(entry.name, { path: relPath, meta });
67
+ }
68
+ catch {
69
+ // Skip skills with invalid SKILL.md
70
+ }
71
+ }
72
+ }
73
+ // Marketplace format: plugins/*/skills/*/SKILL.md
74
+ const marketplaceSkills = await scanMarketplaceFormat(repoDir);
75
+ for (const skill of marketplaceSkills) {
76
+ if (!found.has(skill.meta.name)) {
77
+ found.set(skill.meta.name, skill);
78
+ }
79
+ }
80
+ return [...found.values()];
81
+ }
82
+ async function scanMarketplaceFormat(repoDir) {
83
+ const pluginsDir = join(repoDir, ".claude-plugin");
84
+ if (!existsSync(pluginsDir))
85
+ return [];
86
+ const pluginsDirPath = join(repoDir, "plugins");
87
+ if (!existsSync(pluginsDirPath))
88
+ return [];
89
+ let plugins;
90
+ try {
91
+ plugins = await readdir(pluginsDirPath, { withFileTypes: true });
92
+ }
93
+ catch {
94
+ return [];
95
+ }
96
+ const results = [];
97
+ for (const plugin of plugins) {
98
+ if (!plugin.isDirectory())
99
+ continue;
100
+ const skillsDir = join(pluginsDirPath, plugin.name, "skills");
101
+ if (!existsSync(skillsDir))
102
+ continue;
103
+ let skillEntries;
104
+ try {
105
+ skillEntries = await readdir(skillsDir, { withFileTypes: true });
106
+ }
107
+ catch {
108
+ continue;
109
+ }
110
+ for (const entry of skillEntries) {
111
+ if (!entry.isDirectory())
112
+ continue;
113
+ const skillMdPath = join(skillsDir, entry.name, "SKILL.md");
114
+ if (!existsSync(skillMdPath))
115
+ continue;
116
+ try {
117
+ const meta = await loadSkillMd(skillMdPath);
118
+ results.push({
119
+ path: `plugins/${plugin.name}/skills/${entry.name}`,
120
+ meta,
121
+ });
122
+ }
123
+ catch {
124
+ // Skip invalid
125
+ }
126
+ }
127
+ }
128
+ return results;
129
+ }
130
+ async function tryMarketplaceFormat(repoDir, skillName) {
131
+ const pluginsDir = join(repoDir, ".claude-plugin");
132
+ if (!existsSync(pluginsDir))
133
+ return null;
134
+ // Scan plugins/*/skills/<name>/SKILL.md
135
+ const pluginsDirPath = join(repoDir, "plugins");
136
+ if (!existsSync(pluginsDirPath))
137
+ return null;
138
+ let plugins;
139
+ try {
140
+ plugins = await readdir(pluginsDirPath, { withFileTypes: true });
141
+ }
142
+ catch {
143
+ return null;
144
+ }
145
+ for (const plugin of plugins) {
146
+ if (!plugin.isDirectory())
147
+ continue;
148
+ const skillMdPath = join(pluginsDirPath, plugin.name, "skills", skillName, "SKILL.md");
149
+ if (!existsSync(skillMdPath))
150
+ continue;
151
+ const meta = await loadSkillMd(skillMdPath);
152
+ return { path: `plugins/${plugin.name}/skills/${skillName}`, meta };
153
+ }
154
+ return null;
155
+ }
156
+ //# sourceMappingURL=discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/skills/discovery.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=discovery.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"discovery.test.d.ts","sourceRoot":"","sources":["../../src/skills/discovery.test.ts"],"names":[],"mappings":""}