@devenius/junamis-skills 0.0.0-stage → 1.1.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 (311) hide show
  1. package/CHANGELOG.md +150 -0
  2. package/LICENSE +21 -0
  3. package/README.md +231 -2
  4. package/SECURITY.md +81 -0
  5. package/bin/junamis-skills.js +7 -0
  6. package/dist/cli.d.ts +59 -0
  7. package/dist/cli.d.ts.map +1 -0
  8. package/dist/cli.js +564 -0
  9. package/dist/cli.js.map +1 -0
  10. package/dist/color.d.ts +40 -0
  11. package/dist/color.d.ts.map +1 -0
  12. package/dist/color.js +55 -0
  13. package/dist/color.js.map +1 -0
  14. package/dist/design/atomic.d.ts +4 -0
  15. package/dist/design/atomic.d.ts.map +1 -0
  16. package/dist/design/atomic.js +14 -0
  17. package/dist/design/atomic.js.map +1 -0
  18. package/dist/design/bootstrap.d.ts +23 -0
  19. package/dist/design/bootstrap.d.ts.map +1 -0
  20. package/dist/design/bootstrap.js +411 -0
  21. package/dist/design/bootstrap.js.map +1 -0
  22. package/dist/design/cli.d.ts +86 -0
  23. package/dist/design/cli.d.ts.map +1 -0
  24. package/dist/design/cli.js +425 -0
  25. package/dist/design/cli.js.map +1 -0
  26. package/dist/design/delta.d.ts +45 -0
  27. package/dist/design/delta.d.ts.map +1 -0
  28. package/dist/design/delta.js +557 -0
  29. package/dist/design/delta.js.map +1 -0
  30. package/dist/design/drift.d.ts +26 -0
  31. package/dist/design/drift.d.ts.map +1 -0
  32. package/dist/design/drift.js +341 -0
  33. package/dist/design/drift.js.map +1 -0
  34. package/dist/design/errors.d.ts +25 -0
  35. package/dist/design/errors.d.ts.map +1 -0
  36. package/dist/design/errors.js +30 -0
  37. package/dist/design/errors.js.map +1 -0
  38. package/dist/design/events.d.ts +18 -0
  39. package/dist/design/events.d.ts.map +1 -0
  40. package/dist/design/events.js +44 -0
  41. package/dist/design/events.js.map +1 -0
  42. package/dist/design/fingerprint.d.ts +10 -0
  43. package/dist/design/fingerprint.d.ts.map +1 -0
  44. package/dist/design/fingerprint.js +66 -0
  45. package/dist/design/fingerprint.js.map +1 -0
  46. package/dist/design/index-gen.d.ts +16 -0
  47. package/dist/design/index-gen.d.ts.map +1 -0
  48. package/dist/design/index-gen.js +94 -0
  49. package/dist/design/index-gen.js.map +1 -0
  50. package/dist/design/schema.d.ts +54 -0
  51. package/dist/design/schema.d.ts.map +1 -0
  52. package/dist/design/schema.js +408 -0
  53. package/dist/design/schema.js.map +1 -0
  54. package/dist/design/yaml.d.ts +12 -0
  55. package/dist/design/yaml.d.ts.map +1 -0
  56. package/dist/design/yaml.js +264 -0
  57. package/dist/design/yaml.js.map +1 -0
  58. package/dist/external.d.ts +61 -0
  59. package/dist/external.d.ts.map +1 -0
  60. package/dist/external.js +426 -0
  61. package/dist/external.js.map +1 -0
  62. package/dist/guide.d.ts +17 -0
  63. package/dist/guide.d.ts.map +1 -0
  64. package/dist/guide.js +219 -0
  65. package/dist/guide.js.map +1 -0
  66. package/dist/index.d.ts +2 -0
  67. package/dist/index.d.ts.map +1 -0
  68. package/dist/index.js +7 -0
  69. package/dist/index.js.map +1 -0
  70. package/dist/install-external.d.ts +3 -0
  71. package/dist/install-external.d.ts.map +1 -0
  72. package/dist/install-external.js +37 -0
  73. package/dist/install-external.js.map +1 -0
  74. package/dist/library-install.d.ts +39 -0
  75. package/dist/library-install.d.ts.map +1 -0
  76. package/dist/library-install.js +663 -0
  77. package/dist/library-install.js.map +1 -0
  78. package/dist/orchestrator/boot.d.ts +3 -0
  79. package/dist/orchestrator/boot.d.ts.map +1 -0
  80. package/dist/orchestrator/boot.js +515 -0
  81. package/dist/orchestrator/boot.js.map +1 -0
  82. package/dist/orchestrator/cli.d.ts +37 -0
  83. package/dist/orchestrator/cli.d.ts.map +1 -0
  84. package/dist/orchestrator/cli.js +563 -0
  85. package/dist/orchestrator/cli.js.map +1 -0
  86. package/dist/orchestrator/commands.d.ts +46 -0
  87. package/dist/orchestrator/commands.d.ts.map +1 -0
  88. package/dist/orchestrator/commands.js +752 -0
  89. package/dist/orchestrator/commands.js.map +1 -0
  90. package/dist/orchestrator/compaction.d.ts +21 -0
  91. package/dist/orchestrator/compaction.d.ts.map +1 -0
  92. package/dist/orchestrator/compaction.js +93 -0
  93. package/dist/orchestrator/compaction.js.map +1 -0
  94. package/dist/orchestrator/drift.d.ts +11 -0
  95. package/dist/orchestrator/drift.d.ts.map +1 -0
  96. package/dist/orchestrator/drift.js +181 -0
  97. package/dist/orchestrator/drift.js.map +1 -0
  98. package/dist/orchestrator/errors.d.ts +52 -0
  99. package/dist/orchestrator/errors.d.ts.map +1 -0
  100. package/dist/orchestrator/errors.js +96 -0
  101. package/dist/orchestrator/errors.js.map +1 -0
  102. package/dist/orchestrator/frontmatter.d.ts +6 -0
  103. package/dist/orchestrator/frontmatter.d.ts.map +1 -0
  104. package/dist/orchestrator/frontmatter.js +50 -0
  105. package/dist/orchestrator/frontmatter.js.map +1 -0
  106. package/dist/orchestrator/fsx.d.ts +45 -0
  107. package/dist/orchestrator/fsx.d.ts.map +1 -0
  108. package/dist/orchestrator/fsx.js +295 -0
  109. package/dist/orchestrator/fsx.js.map +1 -0
  110. package/dist/orchestrator/handoff.d.ts +8 -0
  111. package/dist/orchestrator/handoff.d.ts.map +1 -0
  112. package/dist/orchestrator/handoff.js +246 -0
  113. package/dist/orchestrator/handoff.js.map +1 -0
  114. package/dist/orchestrator/hash.d.ts +10 -0
  115. package/dist/orchestrator/hash.d.ts.map +1 -0
  116. package/dist/orchestrator/hash.js +65 -0
  117. package/dist/orchestrator/hash.js.map +1 -0
  118. package/dist/orchestrator/journal.d.ts +35 -0
  119. package/dist/orchestrator/journal.d.ts.map +1 -0
  120. package/dist/orchestrator/journal.js +163 -0
  121. package/dist/orchestrator/journal.js.map +1 -0
  122. package/dist/orchestrator/lease.d.ts +31 -0
  123. package/dist/orchestrator/lease.d.ts.map +1 -0
  124. package/dist/orchestrator/lease.js +175 -0
  125. package/dist/orchestrator/lease.js.map +1 -0
  126. package/dist/orchestrator/plan.d.ts +27 -0
  127. package/dist/orchestrator/plan.d.ts.map +1 -0
  128. package/dist/orchestrator/plan.js +240 -0
  129. package/dist/orchestrator/plan.js.map +1 -0
  130. package/dist/orchestrator/report.d.ts +49 -0
  131. package/dist/orchestrator/report.d.ts.map +1 -0
  132. package/dist/orchestrator/report.js +244 -0
  133. package/dist/orchestrator/report.js.map +1 -0
  134. package/dist/orchestrator/state.d.ts +43 -0
  135. package/dist/orchestrator/state.d.ts.map +1 -0
  136. package/dist/orchestrator/state.js +369 -0
  137. package/dist/orchestrator/state.js.map +1 -0
  138. package/dist/orchestrator/store.d.ts +42 -0
  139. package/dist/orchestrator/store.d.ts.map +1 -0
  140. package/dist/orchestrator/store.js +202 -0
  141. package/dist/orchestrator/store.js.map +1 -0
  142. package/dist/orchestrator/test-hooks.d.ts +5 -0
  143. package/dist/orchestrator/test-hooks.d.ts.map +1 -0
  144. package/dist/orchestrator/test-hooks.js +31 -0
  145. package/dist/orchestrator/test-hooks.js.map +1 -0
  146. package/dist/orchestrator/time.d.ts +11 -0
  147. package/dist/orchestrator/time.d.ts.map +1 -0
  148. package/dist/orchestrator/time.js +38 -0
  149. package/dist/orchestrator/time.js.map +1 -0
  150. package/dist/paths.d.ts +9 -0
  151. package/dist/paths.d.ts.map +1 -0
  152. package/dist/paths.js +42 -0
  153. package/dist/paths.js.map +1 -0
  154. package/dist/pinned-source.d.ts +13 -0
  155. package/dist/pinned-source.d.ts.map +1 -0
  156. package/dist/pinned-source.js +238 -0
  157. package/dist/pinned-source.js.map +1 -0
  158. package/dist/reconcile/cli.d.ts +17 -0
  159. package/dist/reconcile/cli.d.ts.map +1 -0
  160. package/dist/reconcile/cli.js +171 -0
  161. package/dist/reconcile/cli.js.map +1 -0
  162. package/dist/reconcile/detectors.d.ts +29 -0
  163. package/dist/reconcile/detectors.d.ts.map +1 -0
  164. package/dist/reconcile/detectors.js +294 -0
  165. package/dist/reconcile/detectors.js.map +1 -0
  166. package/dist/reconcile/manifest.d.ts +11 -0
  167. package/dist/reconcile/manifest.d.ts.map +1 -0
  168. package/dist/reconcile/manifest.js +118 -0
  169. package/dist/reconcile/manifest.js.map +1 -0
  170. package/dist/reconcile/queue.d.ts +3 -0
  171. package/dist/reconcile/queue.d.ts.map +1 -0
  172. package/dist/reconcile/queue.js +723 -0
  173. package/dist/reconcile/queue.js.map +1 -0
  174. package/dist/reconcile/score.d.ts +19 -0
  175. package/dist/reconcile/score.d.ts.map +1 -0
  176. package/dist/reconcile/score.js +58 -0
  177. package/dist/reconcile/score.js.map +1 -0
  178. package/dist/scripts/check-opencode-config.d.ts +12 -0
  179. package/dist/scripts/check-opencode-config.d.ts.map +1 -0
  180. package/dist/scripts/check-opencode-config.js +216 -0
  181. package/dist/scripts/check-opencode-config.js.map +1 -0
  182. package/dist/scripts/check-pack.d.ts +3 -0
  183. package/dist/scripts/check-pack.d.ts.map +1 -0
  184. package/dist/scripts/check-pack.js +74 -0
  185. package/dist/scripts/check-pack.js.map +1 -0
  186. package/dist/scripts/check-pins.d.ts +9 -0
  187. package/dist/scripts/check-pins.d.ts.map +1 -0
  188. package/dist/scripts/check-pins.js +65 -0
  189. package/dist/scripts/check-pins.js.map +1 -0
  190. package/dist/scripts/check-security.d.ts +3 -0
  191. package/dist/scripts/check-security.d.ts.map +1 -0
  192. package/dist/scripts/check-security.js +47 -0
  193. package/dist/scripts/check-security.js.map +1 -0
  194. package/dist/scripts/check-skills-lock.d.ts +7 -0
  195. package/dist/scripts/check-skills-lock.d.ts.map +1 -0
  196. package/dist/scripts/check-skills-lock.js +36 -0
  197. package/dist/scripts/check-skills-lock.js.map +1 -0
  198. package/dist/scripts/check-skills-sync.d.ts +7 -0
  199. package/dist/scripts/check-skills-sync.d.ts.map +1 -0
  200. package/dist/scripts/check-skills-sync.js +146 -0
  201. package/dist/scripts/check-skills-sync.js.map +1 -0
  202. package/dist/scripts/check-yaml.d.ts +3 -0
  203. package/dist/scripts/check-yaml.d.ts.map +1 -0
  204. package/dist/scripts/check-yaml.js +41 -0
  205. package/dist/scripts/check-yaml.js.map +1 -0
  206. package/dist/scripts/publish-npm.d.ts +3 -0
  207. package/dist/scripts/publish-npm.d.ts.map +1 -0
  208. package/dist/scripts/publish-npm.js +67 -0
  209. package/dist/scripts/publish-npm.js.map +1 -0
  210. package/dist/scripts/release-check.d.ts +3 -0
  211. package/dist/scripts/release-check.d.ts.map +1 -0
  212. package/dist/scripts/release-check.js +97 -0
  213. package/dist/scripts/release-check.js.map +1 -0
  214. package/dist/scripts/support.d.ts +41 -0
  215. package/dist/scripts/support.d.ts.map +1 -0
  216. package/dist/scripts/support.js +78 -0
  217. package/dist/scripts/support.js.map +1 -0
  218. package/dist/targets/claude.d.ts +4 -0
  219. package/dist/targets/claude.d.ts.map +1 -0
  220. package/dist/targets/claude.js +42 -0
  221. package/dist/targets/claude.js.map +1 -0
  222. package/dist/targets/cline.d.ts +4 -0
  223. package/dist/targets/cline.d.ts.map +1 -0
  224. package/dist/targets/cline.js +39 -0
  225. package/dist/targets/cline.js.map +1 -0
  226. package/dist/targets/cursor.d.ts +4 -0
  227. package/dist/targets/cursor.d.ts.map +1 -0
  228. package/dist/targets/cursor.js +40 -0
  229. package/dist/targets/cursor.js.map +1 -0
  230. package/dist/targets/index.d.ts +4 -0
  231. package/dist/targets/index.d.ts.map +1 -0
  232. package/dist/targets/index.js +11 -0
  233. package/dist/targets/index.js.map +1 -0
  234. package/dist/targets/opencode.d.ts +4 -0
  235. package/dist/targets/opencode.d.ts.map +1 -0
  236. package/dist/targets/opencode.js +48 -0
  237. package/dist/targets/opencode.js.map +1 -0
  238. package/dist/targets/windsurf.d.ts +4 -0
  239. package/dist/targets/windsurf.d.ts.map +1 -0
  240. package/dist/targets/windsurf.js +41 -0
  241. package/dist/targets/windsurf.js.map +1 -0
  242. package/dist/types/common.d.ts +193 -0
  243. package/dist/types/common.d.ts.map +1 -0
  244. package/dist/types/common.js +6 -0
  245. package/dist/types/common.js.map +1 -0
  246. package/dist/types/design.d.ts +185 -0
  247. package/dist/types/design.d.ts.map +1 -0
  248. package/dist/types/design.js +3 -0
  249. package/dist/types/design.js.map +1 -0
  250. package/dist/types/guards.d.ts +13 -0
  251. package/dist/types/guards.d.ts.map +1 -0
  252. package/dist/types/guards.js +64 -0
  253. package/dist/types/guards.js.map +1 -0
  254. package/dist/types/handoff.d.ts +29 -0
  255. package/dist/types/handoff.d.ts.map +1 -0
  256. package/dist/types/handoff.js +3 -0
  257. package/dist/types/handoff.js.map +1 -0
  258. package/dist/types/index.d.ts +7 -0
  259. package/dist/types/index.d.ts.map +1 -0
  260. package/dist/types/index.js +11 -0
  261. package/dist/types/index.js.map +1 -0
  262. package/dist/types/orchestrator.d.ts +414 -0
  263. package/dist/types/orchestrator.d.ts.map +1 -0
  264. package/dist/types/orchestrator.js +4 -0
  265. package/dist/types/orchestrator.js.map +1 -0
  266. package/dist/types/reconcile.d.ts +160 -0
  267. package/dist/types/reconcile.d.ts.map +1 -0
  268. package/dist/types/reconcile.js +3 -0
  269. package/dist/types/reconcile.js.map +1 -0
  270. package/docs/RECONCILE.md +505 -0
  271. package/docs/design/_schema.md +506 -0
  272. package/junamis-skills.yml +328 -0
  273. package/library/EXTERNAL.md +35 -0
  274. package/library/HANDOFF.md +93 -0
  275. package/library/RESUME.md +429 -0
  276. package/library/SAFETY.md +83 -0
  277. package/library/agents/context-keeper.md +41 -0
  278. package/library/agents/frontend.md +43 -0
  279. package/library/agents/maintainer.md +44 -0
  280. package/library/agents/nestjs.md +40 -0
  281. package/library/agents/nextjs.md +40 -0
  282. package/library/agents/operator.md +42 -0
  283. package/library/agents/orchestrator.md +313 -0
  284. package/library/agents/researcher.md +40 -0
  285. package/library/agents/reviewer.md +40 -0
  286. package/library/skills/db-migrate/SKILL.md +50 -0
  287. package/library/skills/decision-record/SKILL.md +74 -0
  288. package/library/skills/dependency-upgrade/SKILL.md +57 -0
  289. package/library/skills/deploy-verify/SKILL.md +51 -0
  290. package/library/skills/document/SKILL.md +51 -0
  291. package/library/skills/env-doctor/SKILL.md +65 -0
  292. package/library/skills/frontend/SKILL.md +63 -0
  293. package/library/skills/handoff/SKILL.md +79 -0
  294. package/library/skills/incident-response/SKILL.md +69 -0
  295. package/library/skills/nestjs/SKILL.md +49 -0
  296. package/library/skills/nextjs/SKILL.md +48 -0
  297. package/library/skills/perf-budget/SKILL.md +62 -0
  298. package/library/skills/refactor-safely/SKILL.md +48 -0
  299. package/library/skills/release-prep/SKILL.md +75 -0
  300. package/library/skills/research/SKILL.md +66 -0
  301. package/library/skills/rollback/SKILL.md +49 -0
  302. package/library/skills/route/SKILL.md +107 -0
  303. package/library/skills/route-external/SKILL.md +67 -0
  304. package/library/skills/security-audit/SKILL.md +64 -0
  305. package/library/skills/skill-author/SKILL.md +49 -0
  306. package/opencode.json +5906 -0
  307. package/package.json +88 -4
  308. package/scripts/design-registry.mjs +7 -0
  309. package/scripts/orchestrator-state.mjs +7 -0
  310. package/scripts/reconcile.mjs +7 -0
  311. package/skills-lock.json +197 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-hooks.d.ts","sourceRoot":"","sources":["../../src/orchestrator/test-hooks.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAUxC,CAAC;AAEH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAK7C"}
@@ -0,0 +1,31 @@
1
+ // Crash injection. Inert unless ORCH_TEST_MODE=1.
2
+ //
3
+ // Reaching a point is a no-op in a normal command path, so these calls are safe
4
+ // to leave in production code.
5
+ export const CRASH_POINTS = Object.freeze([
6
+ "after_lease",
7
+ "after_plan_journal",
8
+ "after_step_start_journal",
9
+ "after_task_snapshot",
10
+ "before_step_end_journal",
11
+ "after_step_end_journal",
12
+ "after_task_snapshot_on_end",
13
+ "after_checkpoint_snapshot",
14
+ "before_journal_truncation",
15
+ ]);
16
+ export function testMode() {
17
+ return process.env["ORCH_TEST_MODE"] === "1";
18
+ }
19
+ export function allowTmpRoot() {
20
+ return process.env["ORCH_TEST_ALLOW_TMP"] === "1";
21
+ }
22
+ export function crashPoint(name) {
23
+ if (!testMode())
24
+ return;
25
+ if (process.env["ORCH_TEST_CRASH_AT"] !== name)
26
+ return;
27
+ if (!CRASH_POINTS.includes(name))
28
+ return;
29
+ process.kill(process.pid, "SIGKILL");
30
+ }
31
+ //# sourceMappingURL=test-hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-hooks.js","sourceRoot":"","sources":["../../src/orchestrator/test-hooks.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,gFAAgF;AAChF,+BAA+B;AAE/B,MAAM,CAAC,MAAM,YAAY,GAAsB,MAAM,CAAC,MAAM,CAAC;IAC3D,aAAa;IACb,oBAAoB;IACpB,0BAA0B;IAC1B,qBAAqB;IACrB,yBAAyB;IACzB,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,2BAA2B;CAC5B,CAAC,CAAC;AAEH,MAAM,UAAU,QAAQ;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,KAAK,GAAG,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,QAAQ,EAAE;QAAE,OAAO;IACxB,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,KAAK,IAAI;QAAE,OAAO;IACvD,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO;IACzC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC"}
@@ -0,0 +1,11 @@
1
+ type Clock = () => Date;
2
+ export declare function setClock(fn: Clock): void;
3
+ export declare function resetClock(): void;
4
+ export declare function nowDate(): Date;
5
+ export declare function nowMs(): number;
6
+ export declare function toIso(date: Date | string | number): string;
7
+ export declare function nowIso(): string;
8
+ export declare function isoFromMs(ms: number): string;
9
+ export declare function parseIso(value: unknown): number | null;
10
+ export {};
11
+ //# sourceMappingURL=time.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/orchestrator/time.ts"],"names":[],"mappings":"AAKA,KAAK,KAAK,GAAG,MAAM,IAAI,CAAC;AAIxB,wBAAgB,QAAQ,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,CAGxC;AAED,wBAAgB,UAAU,IAAI,IAAI,CAEjC;AAED,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAED,wBAAgB,KAAK,IAAI,MAAM,CAE9B;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAI1D;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAItD"}
@@ -0,0 +1,38 @@
1
+ // Clock injection and ISO 8601 UTC timestamps.
2
+ //
3
+ // The contract uses second precision timestamps (for example
4
+ // 2026-11-09T10:42:13Z). Lease math still uses milliseconds.
5
+ let clock = () => new Date();
6
+ export function setClock(fn) {
7
+ if (typeof fn !== "function")
8
+ throw new TypeError("clock must be a function");
9
+ clock = fn;
10
+ }
11
+ export function resetClock() {
12
+ clock = () => new Date();
13
+ }
14
+ export function nowDate() {
15
+ return clock();
16
+ }
17
+ export function nowMs() {
18
+ return clock().getTime();
19
+ }
20
+ export function toIso(date) {
21
+ const d = date instanceof Date ? date : new Date(date);
22
+ if (Number.isNaN(d.getTime()))
23
+ throw new TypeError("invalid date");
24
+ return `${d.toISOString().slice(0, 19)}Z`;
25
+ }
26
+ export function nowIso() {
27
+ return toIso(clock());
28
+ }
29
+ export function isoFromMs(ms) {
30
+ return toIso(new Date(ms));
31
+ }
32
+ export function parseIso(value) {
33
+ if (typeof value !== "string")
34
+ return null;
35
+ const ms = Date.parse(value);
36
+ return Number.isNaN(ms) ? null : ms;
37
+ }
38
+ //# sourceMappingURL=time.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/orchestrator/time.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,6DAA6D;AAC7D,6DAA6D;AAI7D,IAAI,KAAK,GAAU,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;AAEpC,MAAM,UAAU,QAAQ,CAAC,EAAS;IAChC,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAC9E,KAAK,GAAG,EAAE,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,KAAK,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,KAAK,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,KAAK;IACnB,OAAO,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAA4B;IAChD,MAAM,CAAC,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,cAAc,CAAC,CAAC;IACnE,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC"}
@@ -0,0 +1,9 @@
1
+ import type { InstallScope } from "./types/index.js";
2
+ export declare const PROJECT_SEGMENT = "skills";
3
+ export declare function configRoot(scope?: InstallScope, projectDir?: string): string;
4
+ export declare function legacyConfigParent(scope?: InstallScope, projectDir?: string): string;
5
+ export declare function internalSkillsDir(scope?: InstallScope, projectDir?: string): string;
6
+ export declare function canonicalAgentsDir(scope?: InstallScope, projectDir?: string): string;
7
+ export declare function sharedDocsDir(scope?: InstallScope, projectDir?: string): string;
8
+ export declare function manifestPath(agentId: string, scope?: InstallScope, projectDir?: string): string;
9
+ //# sourceMappingURL=paths.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAerD,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,wBAAgB,UAAU,CAAC,KAAK,GAAE,YAAuB,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM,CAKrG;AAID,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,YAAuB,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM,CAK7G;AAED,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,YAAuB,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM,CAE5G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,YAAuB,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM,CAE7G;AAED,wBAAgB,aAAa,CAAC,KAAK,GAAE,YAAuB,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM,CAExG;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,YAAuB,EAAE,UAAU,GAAE,MAAsB,GAAG,MAAM,CAExH"}
package/dist/paths.js ADDED
@@ -0,0 +1,42 @@
1
+ import { homedir } from "node:os";
2
+ import { join } from "node:path";
3
+ // Single source of truth for where this package writes.
4
+ //
5
+ // The npm package is @devenius/junamis-skills, so its segment under
6
+ // ~/.config/junamis is "skills". The resulting tree is:
7
+ //
8
+ // <configRoot>/skills/<name>/SKILL.md internal (library) skills
9
+ // <configRoot>/agents/<name>.md canonical agent definitions
10
+ // <configRoot>/{HANDOFF,SAFETY,EXTERNAL,SECURITY}.md
11
+ // <configRoot>/installed/library-<agent>.json
12
+ //
13
+ // Target-specific agents directories are link destinations only; the canonical
14
+ // file always lives in <configRoot>/agents.
15
+ export const PROJECT_SEGMENT = "skills";
16
+ export function configRoot(scope = "global", projectDir = process.cwd()) {
17
+ if (scope === "project") {
18
+ return join(projectDir, ".config", "junamis", PROJECT_SEGMENT);
19
+ }
20
+ return join(homedir(), ".config", "junamis", PROJECT_SEGMENT);
21
+ }
22
+ // The legacy root, before the nested layout. Used only to report leftovers;
23
+ // nothing is ever written or deleted there by this package.
24
+ export function legacyConfigParent(scope = "global", projectDir = process.cwd()) {
25
+ if (scope === "project") {
26
+ return join(projectDir, ".config", "junamis");
27
+ }
28
+ return join(homedir(), ".config", "junamis");
29
+ }
30
+ export function internalSkillsDir(scope = "global", projectDir = process.cwd()) {
31
+ return join(configRoot(scope, projectDir), "skills");
32
+ }
33
+ export function canonicalAgentsDir(scope = "global", projectDir = process.cwd()) {
34
+ return join(configRoot(scope, projectDir), "agents");
35
+ }
36
+ export function sharedDocsDir(scope = "global", projectDir = process.cwd()) {
37
+ return configRoot(scope, projectDir);
38
+ }
39
+ export function manifestPath(agentId, scope = "global", projectDir = process.cwd()) {
40
+ return join(configRoot(scope, projectDir), "installed", `library-${agentId}.json`);
41
+ }
42
+ //# sourceMappingURL=paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,wDAAwD;AACxD,EAAE;AACF,oEAAoE;AACpE,wDAAwD;AACxD,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,uDAAuD;AACvD,gDAAgD;AAChD,EAAE;AACF,+EAA+E;AAC/E,4CAA4C;AAE5C,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC;AAExC,MAAM,UAAU,UAAU,CAAC,KAAK,GAAiB,QAAQ,EAAE,UAAU,GAAW,OAAO,CAAC,GAAG,EAAE;IAC3F,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;AAChE,CAAC;AAED,4EAA4E;AAC5E,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAAC,KAAK,GAAiB,QAAQ,EAAE,UAAU,GAAW,OAAO,CAAC,GAAG,EAAE;IACnG,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAK,GAAiB,QAAQ,EAAE,UAAU,GAAW,OAAO,CAAC,GAAG,EAAE;IAClG,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAK,GAAiB,QAAQ,EAAE,UAAU,GAAW,OAAO,CAAC,GAAG,EAAE;IACnG,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAK,GAAiB,QAAQ,EAAE,UAAU,GAAW,OAAO,CAAC,GAAG,EAAE;IAC9F,OAAO,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,KAAK,GAAiB,QAAQ,EAAE,UAAU,GAAW,OAAO,CAAC,GAAG,EAAE;IAC9G,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,WAAW,OAAO,OAAO,CAAC,CAAC;AACrF,CAAC"}
@@ -0,0 +1,13 @@
1
+ import type { PinnedSource, PreparedCheckout } from "./types/index.js";
2
+ export declare function validatePinnedSource(input: unknown): void;
3
+ export declare function buildPinnedCheckoutCommands(source: string, ref: string, directory: string): string[][];
4
+ export declare function verifyCheckout(directory: string, ref: string, timeout?: number): Promise<string>;
5
+ export interface PreparePinnedSourceOptions {
6
+ readonly timeout?: number;
7
+ }
8
+ export declare function preparePinnedSource(source: PinnedSource, { timeout }?: PreparePinnedSourceOptions): Promise<PreparedCheckout>;
9
+ export interface GetSkillTreeShaOptions {
10
+ readonly timeout?: number;
11
+ }
12
+ export declare function getSkillTreeSha(directory: string, skillPath: string, { timeout }?: GetSkillTreeShaOptions): Promise<string>;
13
+ //# sourceMappingURL=pinned-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pinned-source.d.ts","sourceRoot":"","sources":["../src/pinned-source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAcvE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAyBzD;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAetG;AA8GD,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAStG;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,EAAE,OAAgB,EAAE,GAAE,0BAA+B,GACpD,OAAO,CAAC,gBAAgB,CAAC,CAoB3B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,EAAE,OAAgB,EAAE,GAAE,sBAA2B,GAChD,OAAO,CAAC,MAAM,CAAC,CAkCjB"}
@@ -0,0 +1,238 @@
1
+ import { spawn } from "node:child_process";
2
+ import { mkdtemp, rm } from "node:fs/promises";
3
+ import { devNull, tmpdir } from "node:os";
4
+ import { join, posix } from "node:path";
5
+ import { isRecord } from "./types/guards.js";
6
+ const SOURCE = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
7
+ const SHA = /^[a-f0-9]{40}$/;
8
+ function isValidSkillPath(value) {
9
+ if (typeof value !== "string")
10
+ return false;
11
+ const segments = value.split("/");
12
+ return segments.at(-1) === "SKILL.md" && segments.every((segment) => segment !== "" && segment !== "." && segment !== ".." && /^[A-Za-z0-9._-]+$/.test(segment));
13
+ }
14
+ // The lock is external input until each field is proved here.
15
+ export function validatePinnedSource(input) {
16
+ if (!isRecord(input))
17
+ throw new Error("pinned source must be an object");
18
+ const source = input["source"];
19
+ const ref = input["ref"];
20
+ const skills = input["skills"];
21
+ if (typeof source !== "string" || !SOURCE.test(source)) {
22
+ throw new Error(`invalid GitHub source: ${JSON.stringify(source)}`);
23
+ }
24
+ if (typeof ref !== "string" || !SHA.test(ref)) {
25
+ throw new Error(`invalid commit SHA for ${source}`);
26
+ }
27
+ if (!Array.isArray(skills) || skills.length === 0) {
28
+ throw new Error(`no skills listed for ${source}`);
29
+ }
30
+ for (const skill of skills) {
31
+ if (!isRecord(skill) || typeof skill["name"] !== "string" || !isValidSkillPath(skill["skillPath"])) {
32
+ const named = isRecord(skill) && typeof skill["name"] === "string" ? skill["name"] : "unknown skill";
33
+ throw new Error(`invalid skill path for ${named}`);
34
+ }
35
+ if (typeof skill["treeSha"] !== "string" || !SHA.test(skill["treeSha"])) {
36
+ throw new Error(`invalid tree SHA for ${skill["name"]}`);
37
+ }
38
+ }
39
+ }
40
+ export function buildPinnedCheckoutCommands(source, ref, directory) {
41
+ if (typeof source !== "string" || !SOURCE.test(source)) {
42
+ throw new Error(`invalid GitHub source: ${JSON.stringify(source)}`);
43
+ }
44
+ if (typeof ref !== "string" || !SHA.test(ref)) {
45
+ throw new Error(`invalid commit SHA for ${source}`);
46
+ }
47
+ const url = `https://github.com/${source}.git`;
48
+ return [
49
+ ["init", "--quiet", directory],
50
+ ["-C", directory, "remote", "add", "origin", url],
51
+ ["-C", directory, "fetch", "--quiet", "--depth=1", "origin", ref],
52
+ ["-C", directory, "checkout", "--quiet", "--detach", "FETCH_HEAD"],
53
+ ];
54
+ }
55
+ const MAX_CAPTURE_BYTES = 64 * 1024;
56
+ const KILL_GRACE_MS = 5000;
57
+ const SETTLE_GRACE_MS = KILL_GRACE_MS + 2000;
58
+ const EMPTY_RESULT = { code: 1, stdout: "", stderr: "" };
59
+ // maxBytes = 0 means unlimited. Local repository metadata (rev-parse, cat-file,
60
+ // ls-tree) can legitimately be large; network commands keep the small cap.
61
+ function runGit(args, timeout = 300000, { maxBytes = MAX_CAPTURE_BYTES } = {}) {
62
+ const limit = maxBytes > 0 ? maxBytes : Number.POSITIVE_INFINITY;
63
+ return new Promise((resolve, reject) => {
64
+ const env = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith("GIT_CONFIG_")));
65
+ Object.assign(env, {
66
+ GIT_CONFIG_NOSYSTEM: "1",
67
+ GIT_CONFIG_GLOBAL: devNull,
68
+ GIT_TERMINAL_PROMPT: "0",
69
+ GIT_LFS_SKIP_SMUDGE: "1",
70
+ });
71
+ const child = spawn("git", args, { stdio: ["ignore", "pipe", "pipe"], shell: false, env, detached: true });
72
+ let stdout = "";
73
+ let stderr = "";
74
+ let settled = false;
75
+ let timedOut = false;
76
+ let overflowed = false;
77
+ let killTimer;
78
+ let settleTimer;
79
+ const killGroup = (signal) => {
80
+ try {
81
+ if (child.pid)
82
+ process.kill(-child.pid, signal);
83
+ else
84
+ child.kill(signal);
85
+ }
86
+ catch {
87
+ try {
88
+ child.kill(signal);
89
+ }
90
+ catch { /* ignore */ }
91
+ }
92
+ };
93
+ const finish = (error, result) => {
94
+ if (settled)
95
+ return;
96
+ settled = true;
97
+ clearTimeout(timer);
98
+ clearTimeout(killTimer);
99
+ clearTimeout(settleTimer);
100
+ if (error)
101
+ reject(error);
102
+ else
103
+ resolve(result);
104
+ };
105
+ const terminate = () => {
106
+ killGroup("SIGTERM");
107
+ if (!killTimer)
108
+ killTimer = setTimeout(() => killGroup("SIGKILL"), KILL_GRACE_MS);
109
+ if (!settleTimer)
110
+ settleTimer = setTimeout(() => {
111
+ // A detached descendant can hold the pipes open forever. Stop waiting.
112
+ child.stdout?.destroy();
113
+ child.stderr?.destroy();
114
+ if (timedOut)
115
+ return finish(new Error("git operation timed out"), EMPTY_RESULT);
116
+ if (overflowed)
117
+ return finish(new Error("git output exceeded the 64 KiB capture limit"), EMPTY_RESULT);
118
+ finish(new Error("git operation did not close"), EMPTY_RESULT);
119
+ }, SETTLE_GRACE_MS);
120
+ };
121
+ const timer = timeout > 0
122
+ ? setTimeout(() => {
123
+ timedOut = true;
124
+ terminate();
125
+ }, timeout)
126
+ : undefined;
127
+ const capture = (stream, which) => {
128
+ stream.on("data", (chunk) => {
129
+ const text = chunk.toString();
130
+ const next = (which === "stdout" ? stdout : stderr) + text;
131
+ if (next.length > limit) {
132
+ overflowed = true;
133
+ terminate();
134
+ }
135
+ const capped = Number.isFinite(limit) ? next.slice(-limit) : next;
136
+ if (which === "stdout")
137
+ stdout = capped;
138
+ else
139
+ stderr = capped;
140
+ });
141
+ };
142
+ capture(child.stdout, "stdout");
143
+ capture(child.stderr, "stderr");
144
+ child.on("error", (error) => finish(error, EMPTY_RESULT));
145
+ child.on("close", (code) => {
146
+ if (timedOut)
147
+ return finish(new Error("git operation timed out"), EMPTY_RESULT);
148
+ if (overflowed)
149
+ return finish(new Error("git output exceeded the 64 KiB capture limit"), EMPTY_RESULT);
150
+ finish(null, { code: code ?? 1, stdout, stderr });
151
+ });
152
+ });
153
+ }
154
+ async function runCheckedGit(args, timeout, options) {
155
+ const result = await runGit(args, timeout, options);
156
+ if (result.code !== 0) {
157
+ throw new Error(`git ${args.slice(1).join(" ")} failed (exit ${result.code}): ${result.stderr.trim()}`);
158
+ }
159
+ return result.stdout.trim();
160
+ }
161
+ export async function verifyCheckout(directory, ref, timeout = 300000) {
162
+ if (typeof ref !== "string" || !SHA.test(ref)) {
163
+ throw new Error(`invalid locked commit SHA: ${JSON.stringify(ref)}`);
164
+ }
165
+ const head = await runCheckedGit(["-C", directory, "rev-parse", "HEAD"], timeout, { maxBytes: 0 });
166
+ if (head !== ref) {
167
+ throw new Error(`checkout HEAD ${head} does not match locked commit ${ref}`);
168
+ }
169
+ return head;
170
+ }
171
+ export async function preparePinnedSource(source, { timeout = 300000 } = {}) {
172
+ validatePinnedSource(source);
173
+ const directory = await mkdtemp(join(tmpdir(), "junamis-skills-"));
174
+ try {
175
+ for (const command of buildPinnedCheckoutCommands(source.source, source.ref, directory)) {
176
+ await runCheckedGit(command, timeout);
177
+ }
178
+ await verifyCheckout(directory, source.ref, timeout);
179
+ }
180
+ catch (error) {
181
+ await rm(directory, { recursive: true, force: true });
182
+ throw error;
183
+ }
184
+ return {
185
+ path: directory,
186
+ async cleanup() {
187
+ await rm(directory, { recursive: true, force: true });
188
+ },
189
+ };
190
+ }
191
+ export async function getSkillTreeSha(directory, skillPath, { timeout = 300000 } = {}) {
192
+ if (!isValidSkillPath(skillPath)) {
193
+ throw new Error(`invalid skill path: ${JSON.stringify(skillPath)}`);
194
+ }
195
+ const folder = skillPath.slice(0, -"/SKILL.md".length);
196
+ const revision = folder ? `HEAD:${folder}` : "HEAD^{tree}";
197
+ const sha = await runCheckedGit(["-C", directory, "rev-parse", "--verify", revision], timeout, { maxBytes: 0 });
198
+ if (!SHA.test(sha))
199
+ throw new Error(`git returned an invalid tree SHA for ${skillPath}`);
200
+ const type = await runCheckedGit(["-C", directory, "cat-file", "-t", sha], timeout, { maxBytes: 0 });
201
+ if (type !== "tree") {
202
+ throw new Error(`pinned path for ${skillPath} is not a directory tree (found ${type})`);
203
+ }
204
+ const listing = await runCheckedGit(["-C", directory, "ls-tree", "-r", sha], timeout, { maxBytes: 0 });
205
+ for (const line of listing.split("\n")) {
206
+ if (!line)
207
+ continue;
208
+ const match = line.match(/^(\d+)\s+\w+\s+([0-9a-f]+)\t(.+)$/);
209
+ if (!match)
210
+ continue;
211
+ const [, mode, object, entryPath] = match;
212
+ if (mode === "120000") {
213
+ // In-tree symlinks are legitimate (for example CLAUDE.md -> AGENTS.md).
214
+ // Read the blob and allow it only when its target stays inside the skill
215
+ // folder; an absolute or escaping target is rejected.
216
+ const target = await runCheckedGit(["-C", directory, "cat-file", "blob", object ?? ""], timeout, { maxBytes: 0 });
217
+ assertContainedSymlink(entryPath ?? "", target, skillPath, line);
218
+ continue;
219
+ }
220
+ if (mode === "160000") {
221
+ throw new Error(`pinned path for ${skillPath} contains a gitlink: ${line}`);
222
+ }
223
+ }
224
+ return sha;
225
+ }
226
+ // Resolve a symlink target lexically from the link's own directory using POSIX
227
+ // rules. Reject absolute targets and anything that climbs above the skill folder.
228
+ function assertContainedSymlink(entryPath, target, skillPath, line) {
229
+ if (posix.isAbsolute(target)) {
230
+ throw new Error(`pinned path for ${skillPath} contains an absolute symlink: ${line}`);
231
+ }
232
+ const base = posix.dirname(entryPath);
233
+ const resolved = posix.normalize(posix.join(base === "." ? "" : base, target));
234
+ if (posix.isAbsolute(resolved) || resolved === ".." || resolved.startsWith("../")) {
235
+ throw new Error(`pinned path for ${skillPath} contains a symlink that escapes the skill folder: ${line}`);
236
+ }
237
+ }
238
+ //# sourceMappingURL=pinned-source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pinned-source.js","sourceRoot":"","sources":["../src/pinned-source.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,17 @@
1
+ import type { ParsedOptions } from "../orchestrator/cli.js";
2
+ export interface ReconcileCliOptions extends ParsedOptions {
3
+ trigger: string;
4
+ }
5
+ export type ReconcileParsedArgs = {
6
+ readonly help: true;
7
+ } | {
8
+ readonly help: false;
9
+ readonly command: string;
10
+ readonly options: ReconcileCliOptions;
11
+ };
12
+ export interface ReconcileRunOptions {
13
+ readonly env?: NodeJS.ProcessEnv;
14
+ readonly cwd?: string;
15
+ }
16
+ export declare function run(argv: readonly string[], { env, cwd }?: ReconcileRunOptions): Promise<number>;
17
+ //# sourceMappingURL=cli.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/reconcile/cli.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAyB5D,MAAM,WAAW,mBAAoB,SAAQ,aAAa;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAuF9F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,GAAiB,EAAE,GAAmB,EAAE,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCxI"}
@@ -0,0 +1,171 @@
1
+ // Command line entry for one RECONCILE pass.
2
+ //
3
+ // It does not dispatch a skill. It reads durable state and writes the queue,
4
+ // report, and one reconcile_pass journal event.
5
+ import { resolveContext } from "../orchestrator/cli.js";
6
+ import { UsageError } from "../orchestrator/errors.js";
7
+ import { errorMessage } from "../types/guards.js";
8
+ import { runReconcile } from "./queue.js";
9
+ const HELP = `junamis-reconcile
10
+
11
+ Usage:
12
+ junamis-reconcile pass [--trigger <name>] [common]
13
+
14
+ Common options:
15
+ --project <dir> Project root (default: cwd)
16
+ --state-root <dir> State root (default: ORCH_STATE_ROOT, then <project>/.orchestrator)
17
+ --design-root <dir> Design registry root (default: <project>/docs/design)
18
+ --library-root <dir> Directory containing skills/ and agents/
19
+ --manifest <path> skills-lock.json path
20
+ --json Emit exactly one JSON object on stdout
21
+ --quiet Suppress human output
22
+ --help Print this help
23
+ `;
24
+ const VALUE_OPTIONS = new Set(["--project", "--state-root", "--design-root", "--library-root", "--manifest", "--trigger"]);
25
+ const FLAG_OPTIONS = new Set(["--json", "--quiet", "--help"]);
26
+ function parseArgs(argv) {
27
+ if (argv.length === 0 || argv.includes("--help") || argv[0] === "help")
28
+ return { help: true };
29
+ const command = argv[0];
30
+ if (command !== "pass")
31
+ throw new UsageError(`unknown command ${JSON.stringify(command)}`);
32
+ const options = {
33
+ json: false,
34
+ quiet: false,
35
+ replace: false,
36
+ project: null,
37
+ stateRoot: null,
38
+ session: null,
39
+ libraryRoot: null,
40
+ manifest: null,
41
+ designRoot: null,
42
+ file: null,
43
+ task: null,
44
+ step: null,
45
+ handoff: null,
46
+ status: null,
47
+ reason: null,
48
+ decision: null,
49
+ trigger: "manual",
50
+ };
51
+ for (let i = 1; i < argv.length; i++) {
52
+ const arg = argv[i];
53
+ if (FLAG_OPTIONS.has(arg)) {
54
+ if (arg === "--json")
55
+ options.json = true;
56
+ else if (arg === "--quiet")
57
+ options.quiet = true;
58
+ else
59
+ return { help: true };
60
+ continue;
61
+ }
62
+ if (VALUE_OPTIONS.has(arg)) {
63
+ const value = argv[i + 1];
64
+ if (value === undefined || value.startsWith("--"))
65
+ throw new UsageError(`${arg} needs a value`);
66
+ i += 1;
67
+ switch (arg) {
68
+ case "--project":
69
+ options.project = value;
70
+ break;
71
+ case "--state-root":
72
+ options.stateRoot = value;
73
+ break;
74
+ case "--design-root":
75
+ options.designRoot = value;
76
+ break;
77
+ case "--library-root":
78
+ options.libraryRoot = value;
79
+ break;
80
+ case "--manifest":
81
+ options.manifest = value;
82
+ break;
83
+ case "--trigger":
84
+ options.trigger = value;
85
+ break;
86
+ default: break;
87
+ }
88
+ continue;
89
+ }
90
+ throw new UsageError(`unexpected argument ${JSON.stringify(arg)}`);
91
+ }
92
+ return { help: false, command, options };
93
+ }
94
+ function emit(command, ctx, result) {
95
+ if (ctx.json) {
96
+ process.stdout.write(`${JSON.stringify({
97
+ ok: true,
98
+ command,
99
+ status: result.status,
100
+ pass_id: result.passId,
101
+ queue_path: result.queuePath,
102
+ report_path: result.reportPath,
103
+ summary: result.queue.summary,
104
+ head: result.head,
105
+ })}\n`);
106
+ return;
107
+ }
108
+ if (ctx.quiet)
109
+ return;
110
+ process.stdout.write(`status: ${result.status}\n`);
111
+ process.stdout.write(`pass: ${result.passId}\n`);
112
+ process.stdout.write(`queue: ${result.queuePath}\n`);
113
+ process.stdout.write(`report: ${result.reportPath}\n`);
114
+ process.stdout.write(`head: ${result.head?.candidate_id ?? "none"}\n`);
115
+ }
116
+ export async function run(argv, { env = process.env, cwd = process.cwd() } = {}) {
117
+ let parsed;
118
+ try {
119
+ parsed = parseArgs(argv);
120
+ }
121
+ catch (error) {
122
+ return finishWithError(error, argv.includes("--json"), null, null);
123
+ }
124
+ if (parsed.help) {
125
+ process.stdout.write(HELP);
126
+ return 0;
127
+ }
128
+ let ctx;
129
+ try {
130
+ ctx = resolveContext(parsed.options, { env, cwd });
131
+ }
132
+ catch (error) {
133
+ return finishWithError(error, parsed.options.json, null, null);
134
+ }
135
+ try {
136
+ const result = await runReconcile({
137
+ stateRoot: ctx.stateRoot,
138
+ projectRoot: ctx.projectRoot,
139
+ designRoot: ctx.designRoot,
140
+ libraryRoot: ctx.libraryRoot,
141
+ manifestPath: ctx.manifestPath,
142
+ packageVersion: ctx.packageVersion,
143
+ trigger: parsed.options.trigger,
144
+ sessionId: ctx.sessionId,
145
+ });
146
+ emit(parsed.command, ctx, result);
147
+ return 0;
148
+ }
149
+ catch (error) {
150
+ return finishWithError(error, ctx.json, ctx, parsed.command);
151
+ }
152
+ }
153
+ function finishWithError(error, json, ctx, command) {
154
+ const fields = error;
155
+ const exitCode = fields?.exitCode ?? 1;
156
+ const message = errorMessage(error);
157
+ if (json) {
158
+ process.stdout.write(`${JSON.stringify({
159
+ ok: false,
160
+ command,
161
+ error: { code: fields?.code ?? "error", message },
162
+ stateRoot: ctx?.stateRoot ?? null,
163
+ })}\n`);
164
+ }
165
+ else {
166
+ process.stderr.write(`error: ${fields?.code ?? "error"}: ${message}\n`);
167
+ }
168
+ process.exitCode = exitCode;
169
+ return exitCode;
170
+ }
171
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/reconcile/cli.ts"],"names":[],"mappings":"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"}