@tacuchi/agent-workflow-cli 5.0.2 → 5.3.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 (230) hide show
  1. package/dist/adapters/node-file-system.d.ts +7 -0
  2. package/dist/adapters/node-file-system.d.ts.map +1 -1
  3. package/dist/adapters/node-file-system.js +22 -2
  4. package/dist/adapters/node-file-system.js.map +1 -1
  5. package/dist/application/artifacts-service.d.ts.map +1 -1
  6. package/dist/application/artifacts-service.js +15 -13
  7. package/dist/application/artifacts-service.js.map +1 -1
  8. package/dist/application/checkpoint/markdown.d.ts +3 -0
  9. package/dist/application/checkpoint/markdown.d.ts.map +1 -0
  10. package/dist/application/checkpoint/markdown.js +86 -0
  11. package/dist/application/checkpoint/markdown.js.map +1 -0
  12. package/dist/application/checkpoint/state-reader.d.ts +28 -0
  13. package/dist/application/checkpoint/state-reader.d.ts.map +1 -0
  14. package/dist/application/checkpoint/state-reader.js +152 -0
  15. package/dist/application/checkpoint/state-reader.js.map +1 -0
  16. package/dist/application/checkpoint-service.d.ts.map +1 -1
  17. package/dist/application/checkpoint-service.js +15 -16
  18. package/dist/application/checkpoint-service.js.map +1 -1
  19. package/dist/application/checkpoint-write-service.d.ts.map +1 -1
  20. package/dist/application/checkpoint-write-service.js +2 -235
  21. package/dist/application/checkpoint-write-service.js.map +1 -1
  22. package/dist/application/decisiones-service.d.ts.map +1 -1
  23. package/dist/application/decisiones-service.js +5 -5
  24. package/dist/application/decisiones-service.js.map +1 -1
  25. package/dist/application/dependencias-service.d.ts.map +1 -1
  26. package/dist/application/dependencias-service.js +5 -5
  27. package/dist/application/dependencias-service.js.map +1 -1
  28. package/dist/application/dev-graduate-service.d.ts +2 -48
  29. package/dist/application/dev-graduate-service.d.ts.map +1 -1
  30. package/dist/application/dev-graduate-service.js +1 -226
  31. package/dist/application/dev-graduate-service.js.map +1 -1
  32. package/dist/application/graduate/handlers.d.ts +61 -0
  33. package/dist/application/graduate/handlers.d.ts.map +1 -0
  34. package/dist/application/graduate/handlers.js +148 -0
  35. package/dist/application/graduate/handlers.js.map +1 -0
  36. package/dist/application/graduate/helpers.d.ts +13 -0
  37. package/dist/application/graduate/helpers.d.ts.map +1 -0
  38. package/dist/application/graduate/helpers.js +82 -0
  39. package/dist/application/graduate/helpers.js.map +1 -0
  40. package/dist/application/handoff.d.ts.map +1 -1
  41. package/dist/application/handoff.js +14 -11
  42. package/dist/application/handoff.js.map +1 -1
  43. package/dist/application/markdown.d.ts +18 -0
  44. package/dist/application/markdown.d.ts.map +1 -1
  45. package/dist/application/markdown.js +129 -0
  46. package/dist/application/markdown.js.map +1 -1
  47. package/dist/application/multiroot/claude.d.ts +26 -0
  48. package/dist/application/multiroot/claude.d.ts.map +1 -0
  49. package/dist/application/multiroot/claude.js +125 -0
  50. package/dist/application/multiroot/claude.js.map +1 -0
  51. package/dist/application/multiroot/codex.d.ts +36 -0
  52. package/dist/application/multiroot/codex.d.ts.map +1 -0
  53. package/dist/application/multiroot/codex.js +221 -0
  54. package/dist/application/multiroot/codex.js.map +1 -0
  55. package/dist/application/multiroot/paths.d.ts +6 -0
  56. package/dist/application/multiroot/paths.d.ts.map +1 -0
  57. package/dist/application/multiroot/paths.js +23 -0
  58. package/dist/application/multiroot/paths.js.map +1 -0
  59. package/dist/application/multiroot-service.d.ts +2 -52
  60. package/dist/application/multiroot-service.d.ts.map +1 -1
  61. package/dist/application/multiroot-service.js +2 -364
  62. package/dist/application/multiroot-service.js.map +1 -1
  63. package/dist/application/objetivo-service.d.ts.map +1 -1
  64. package/dist/application/objetivo-service.js +3 -3
  65. package/dist/application/objetivo-service.js.map +1 -1
  66. package/dist/application/parsers/objetivo.d.ts.map +1 -1
  67. package/dist/application/parsers/objetivo.js +7 -10
  68. package/dist/application/parsers/objetivo.js.map +1 -1
  69. package/dist/application/phase-detect-service.d.ts.map +1 -1
  70. package/dist/application/phase-detect-service.js +6 -6
  71. package/dist/application/phase-detect-service.js.map +1 -1
  72. package/dist/application/plugin-doctor/common.d.ts +27 -0
  73. package/dist/application/plugin-doctor/common.d.ts.map +1 -0
  74. package/dist/application/plugin-doctor/common.js +28 -0
  75. package/dist/application/plugin-doctor/common.js.map +1 -0
  76. package/dist/application/plugin-doctor/exported-skills.d.ts +8 -0
  77. package/dist/application/plugin-doctor/exported-skills.d.ts.map +1 -0
  78. package/dist/application/plugin-doctor/exported-skills.js +128 -0
  79. package/dist/application/plugin-doctor/exported-skills.js.map +1 -0
  80. package/dist/application/plugin-doctor/hooks.d.ts +8 -0
  81. package/dist/application/plugin-doctor/hooks.d.ts.map +1 -0
  82. package/dist/application/plugin-doctor/hooks.js +53 -0
  83. package/dist/application/plugin-doctor/hooks.js.map +1 -0
  84. package/dist/application/plugin-doctor/manifests.d.ts +11 -0
  85. package/dist/application/plugin-doctor/manifests.d.ts.map +1 -0
  86. package/dist/application/plugin-doctor/manifests.js +83 -0
  87. package/dist/application/plugin-doctor/manifests.js.map +1 -0
  88. package/dist/application/plugin-doctor/mcp.d.ts +10 -0
  89. package/dist/application/plugin-doctor/mcp.d.ts.map +1 -0
  90. package/dist/application/plugin-doctor/mcp.js +58 -0
  91. package/dist/application/plugin-doctor/mcp.js.map +1 -0
  92. package/dist/application/plugin-doctor/skills.d.ts +16 -0
  93. package/dist/application/plugin-doctor/skills.d.ts.map +1 -0
  94. package/dist/application/plugin-doctor/skills.js +167 -0
  95. package/dist/application/plugin-doctor/skills.js.map +1 -0
  96. package/dist/application/plugin-doctor-service.d.ts +2 -23
  97. package/dist/application/plugin-doctor-service.d.ts.map +1 -1
  98. package/dist/application/plugin-doctor-service.js +10 -514
  99. package/dist/application/plugin-doctor-service.js.map +1 -1
  100. package/dist/application/release-data/artifacts.d.ts +32 -0
  101. package/dist/application/release-data/artifacts.d.ts.map +1 -0
  102. package/dist/application/release-data/artifacts.js +105 -0
  103. package/dist/application/release-data/artifacts.js.map +1 -0
  104. package/dist/application/release-data/bundles.d.ts +15 -0
  105. package/dist/application/release-data/bundles.d.ts.map +1 -0
  106. package/dist/application/release-data/bundles.js +42 -0
  107. package/dist/application/release-data/bundles.js.map +1 -0
  108. package/dist/application/release-data/common.d.ts +11 -0
  109. package/dist/application/release-data/common.d.ts.map +1 -0
  110. package/dist/application/release-data/common.js +61 -0
  111. package/dist/application/release-data/common.js.map +1 -0
  112. package/dist/application/release-data/sessions.d.ts +19 -0
  113. package/dist/application/release-data/sessions.d.ts.map +1 -0
  114. package/dist/application/release-data/sessions.js +51 -0
  115. package/dist/application/release-data/sessions.js.map +1 -0
  116. package/dist/application/release-data-service.d.ts +8 -50
  117. package/dist/application/release-data-service.d.ts.map +1 -1
  118. package/dist/application/release-data-service.js +14 -252
  119. package/dist/application/release-data-service.js.map +1 -1
  120. package/dist/application/session-artifacts.d.ts +48 -0
  121. package/dist/application/session-artifacts.d.ts.map +1 -0
  122. package/dist/application/session-artifacts.js +116 -0
  123. package/dist/application/session-artifacts.js.map +1 -0
  124. package/dist/application/session-create-service.d.ts.map +1 -1
  125. package/dist/application/session-create-service.js +45 -15
  126. package/dist/application/session-create-service.js.map +1 -1
  127. package/dist/application/session-resolver.d.ts.map +1 -1
  128. package/dist/application/session-resolver.js +10 -15
  129. package/dist/application/session-resolver.js.map +1 -1
  130. package/dist/application/session-resume-service.d.ts.map +1 -1
  131. package/dist/application/session-resume-service.js +3 -2
  132. package/dist/application/session-resume-service.js.map +1 -1
  133. package/dist/application/templates/objetivo.js +32 -32
  134. package/dist/cli/commands/auto-plan-decide.d.ts +3 -0
  135. package/dist/cli/commands/auto-plan-decide.d.ts.map +1 -0
  136. package/dist/cli/commands/auto-plan-decide.js +19 -0
  137. package/dist/cli/commands/auto-plan-decide.js.map +1 -0
  138. package/dist/cli/commands/bootstrap-dsn.d.ts +3 -0
  139. package/dist/cli/commands/bootstrap-dsn.d.ts.map +1 -0
  140. package/dist/cli/commands/bootstrap-dsn.js +20 -0
  141. package/dist/cli/commands/bootstrap-dsn.js.map +1 -0
  142. package/dist/cli/commands/check-branch.d.ts +3 -0
  143. package/dist/cli/commands/check-branch.d.ts.map +1 -0
  144. package/dist/cli/commands/check-branch.js +30 -0
  145. package/dist/cli/commands/check-branch.js.map +1 -0
  146. package/dist/cli/commands/checkpoint-read.d.ts +3 -0
  147. package/dist/cli/commands/checkpoint-read.d.ts.map +1 -0
  148. package/dist/cli/commands/checkpoint-read.js +19 -0
  149. package/dist/cli/commands/checkpoint-read.js.map +1 -0
  150. package/dist/cli/commands/code-scan.d.ts +3 -0
  151. package/dist/cli/commands/code-scan.d.ts.map +1 -0
  152. package/dist/cli/commands/code-scan.js +74 -0
  153. package/dist/cli/commands/code-scan.js.map +1 -0
  154. package/dist/cli/commands/compress-checkpoint.d.ts +3 -0
  155. package/dist/cli/commands/compress-checkpoint.d.ts.map +1 -0
  156. package/dist/cli/commands/compress-checkpoint.js +28 -0
  157. package/dist/cli/commands/compress-checkpoint.js.map +1 -0
  158. package/dist/cli/commands/graduate.d.ts +3 -0
  159. package/dist/cli/commands/graduate.d.ts.map +1 -0
  160. package/dist/cli/commands/graduate.js +36 -0
  161. package/dist/cli/commands/graduate.js.map +1 -0
  162. package/dist/cli/commands/hub-init.d.ts.map +1 -1
  163. package/dist/cli/commands/hub-init.js +13 -43
  164. package/dist/cli/commands/hub-init.js.map +1 -1
  165. package/dist/cli/commands/phase-detect.d.ts +3 -0
  166. package/dist/cli/commands/phase-detect.d.ts.map +1 -0
  167. package/dist/cli/commands/phase-detect.js +19 -0
  168. package/dist/cli/commands/phase-detect.js.map +1 -0
  169. package/dist/cli/commands/phase-next.d.ts +3 -0
  170. package/dist/cli/commands/phase-next.d.ts.map +1 -0
  171. package/dist/cli/commands/phase-next.js +23 -0
  172. package/dist/cli/commands/phase-next.js.map +1 -0
  173. package/dist/cli/commands/project-md-upsert.d.ts.map +1 -1
  174. package/dist/cli/commands/project-md-upsert.js +2 -49
  175. package/dist/cli/commands/project-md-upsert.js.map +1 -1
  176. package/dist/cli/commands/resume-summary.d.ts +3 -0
  177. package/dist/cli/commands/resume-summary.d.ts.map +1 -0
  178. package/dist/cli/commands/resume-summary.js +10 -0
  179. package/dist/cli/commands/resume-summary.js.map +1 -0
  180. package/dist/cli/commands/session-create.js +2 -2
  181. package/dist/cli/commands/session-create.js.map +1 -1
  182. package/dist/cli/commands/skill-index.d.ts +3 -0
  183. package/dist/cli/commands/skill-index.d.ts.map +1 -0
  184. package/dist/cli/commands/skill-index.js +20 -0
  185. package/dist/cli/commands/skill-index.js.map +1 -0
  186. package/dist/cli/commands/sources.d.ts +3 -0
  187. package/dist/cli/commands/sources.d.ts.map +1 -0
  188. package/dist/cli/commands/sources.js +30 -0
  189. package/dist/cli/commands/sources.js.map +1 -0
  190. package/dist/cli/commands/specialty-choose.d.ts +3 -0
  191. package/dist/cli/commands/specialty-choose.d.ts.map +1 -0
  192. package/dist/cli/commands/specialty-choose.js +30 -0
  193. package/dist/cli/commands/specialty-choose.js.map +1 -0
  194. package/dist/cli/commands/stack.d.ts +3 -0
  195. package/dist/cli/commands/stack.d.ts.map +1 -0
  196. package/dist/cli/commands/stack.js +11 -0
  197. package/dist/cli/commands/stack.js.map +1 -0
  198. package/dist/cli/commands/topic-change-check.d.ts +3 -0
  199. package/dist/cli/commands/topic-change-check.d.ts.map +1 -0
  200. package/dist/cli/commands/topic-change-check.js +23 -0
  201. package/dist/cli/commands/topic-change-check.js.map +1 -0
  202. package/dist/cli/commands/upgrade-hub-mode.d.ts +3 -0
  203. package/dist/cli/commands/upgrade-hub-mode.d.ts.map +1 -0
  204. package/dist/cli/commands/upgrade-hub-mode.js +11 -0
  205. package/dist/cli/commands/upgrade-hub-mode.js.map +1 -0
  206. package/dist/cli/commands/workflows.d.ts +3 -0
  207. package/dist/cli/commands/workflows.d.ts.map +1 -0
  208. package/dist/cli/commands/workflows.js +30 -0
  209. package/dist/cli/commands/workflows.js.map +1 -0
  210. package/dist/cli/commands/workspace-mode.d.ts +3 -0
  211. package/dist/cli/commands/workspace-mode.d.ts.map +1 -0
  212. package/dist/cli/commands/workspace-mode.js +11 -0
  213. package/dist/cli/commands/workspace-mode.js.map +1 -0
  214. package/dist/cli/helpers/objetivo-loader.d.ts +3 -0
  215. package/dist/cli/helpers/objetivo-loader.d.ts.map +1 -0
  216. package/dist/cli/helpers/objetivo-loader.js +17 -0
  217. package/dist/cli/helpers/objetivo-loader.js.map +1 -0
  218. package/dist/cli/main.js +18 -4
  219. package/dist/cli/main.js.map +1 -1
  220. package/dist/cli/parsers/fuentes.d.ts +11 -0
  221. package/dist/cli/parsers/fuentes.d.ts.map +1 -0
  222. package/dist/cli/parsers/fuentes.js +37 -0
  223. package/dist/cli/parsers/fuentes.js.map +1 -0
  224. package/dist/cli/parsers/working-branches.d.ts +2 -0
  225. package/dist/cli/parsers/working-branches.d.ts.map +1 -0
  226. package/dist/cli/parsers/working-branches.js +14 -0
  227. package/dist/cli/parsers/working-branches.js.map +1 -0
  228. package/dist/domain/session.d.ts +2 -2
  229. package/dist/domain/session.d.ts.map +1 -1
  230. package/package.json +1 -1
@@ -0,0 +1,28 @@
1
+ import { extname } from "node:path";
2
+ export function isRecord(v) {
3
+ return typeof v === "object" && v !== null && !Array.isArray(v);
4
+ }
5
+ export async function collectMarkdownFiles(fs, dir) {
6
+ const out = [];
7
+ const stack = [dir];
8
+ while (stack.length > 0) {
9
+ const current = stack.pop();
10
+ if (!current)
11
+ break;
12
+ let entries;
13
+ try {
14
+ entries = await fs.list(current);
15
+ }
16
+ catch {
17
+ continue;
18
+ }
19
+ for (const e of entries) {
20
+ if (e.type === "dir")
21
+ stack.push(e.path);
22
+ else if (e.type === "file" && extname(e.name).toLowerCase() === ".md")
23
+ out.push(e.path);
24
+ }
25
+ }
26
+ return out;
27
+ }
28
+ //# sourceMappingURL=common.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/application/plugin-doctor/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2BpC,MAAM,UAAU,QAAQ,CAAC,CAAU;IACjC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EAAkB,EAAE,GAAW;IACxE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,MAAM;QACpB,IAAI,OAAoD,CAAC;QACzD,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;iBACpC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK;gBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
@@ -0,0 +1,8 @@
1
+ import type { FileSystemPort } from "../../ports/file-system.js";
2
+ import { type DoctorFinding, type ExportedSkillRecord, type SkillFrontmatterInfo } from "./common.js";
3
+ export interface ExportedSkillsResult {
4
+ exportedInfo: ExportedSkillRecord[];
5
+ findings: DoctorFinding[];
6
+ }
7
+ export declare function validateExportedSkills(skillsDir: string, pluginRoot: string, exportsFile: string | undefined, pluginName: string, skillsInfo: SkillFrontmatterInfo[], fs: FileSystemPort): Promise<ExportedSkillsResult>;
8
+ //# sourceMappingURL=exported-skills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exported-skills.d.ts","sourceRoot":"","sources":["../../../src/application/plugin-doctor/exported-skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAE1B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,oBAAoB,EAAE,EAClC,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}
@@ -0,0 +1,128 @@
1
+ import { join } from "node:path";
2
+ import { isRecord, } from "./common.js";
3
+ export async function validateExportedSkills(skillsDir, pluginRoot, exportsFile, pluginName, skillsInfo, fs) {
4
+ const findings = [];
5
+ const exportedInfo = [];
6
+ const exportedSkills = await loadExportedSkills(fs, pluginRoot, exportsFile, pluginName);
7
+ const skillsByDirName = new Map();
8
+ for (const s of skillsInfo) {
9
+ if (s.name)
10
+ skillsByDirName.set(s.dir, s);
11
+ }
12
+ const skillsDirExists = await fs.exists(skillsDir);
13
+ for (const exp of exportedSkills) {
14
+ const record = await validateSingleExportedSkill(exp, skillsDir, skillsDirExists, skillsByDirName, fs, findings);
15
+ exportedInfo.push(record);
16
+ }
17
+ return { exportedInfo, findings };
18
+ }
19
+ async function validateSingleExportedSkill(exp, skillsDir, skillsDirExists, skillsByDirName, fs, findings) {
20
+ const expSkillName = exp.skill;
21
+ const record = {
22
+ namespace: exp.namespace,
23
+ version_declared: exp.version ?? null,
24
+ since: exp.since ?? null,
25
+ exists_in_disk: false,
26
+ frontmatter_ok: false,
27
+ };
28
+ if (!skillsDirExists) {
29
+ findings.push({
30
+ level: "error",
31
+ file: "skills/",
32
+ msg: `exported skill '${exp.namespace}' registered but plugin has no skills/ directory`,
33
+ });
34
+ return record;
35
+ }
36
+ const targetSkill = join(skillsDir, expSkillName, "SKILL.md");
37
+ if (!(await fs.exists(targetSkill))) {
38
+ findings.push({
39
+ level: "error",
40
+ file: `skills/${expSkillName}/SKILL.md`,
41
+ msg: `exported skill '${exp.namespace}' registered but not found in plugin's skills/ directory — fix the register_exported_skill call or add the SKILL.md`,
42
+ });
43
+ return record;
44
+ }
45
+ record.exists_in_disk = true;
46
+ const diskSkill = skillsByDirName.get(expSkillName);
47
+ if (!diskSkill?.name || !diskSkill.version) {
48
+ findings.push({
49
+ level: "error",
50
+ file: `skills/${expSkillName}/SKILL.md`,
51
+ msg: "exported skill SKILL.md missing required frontmatter (name + version)",
52
+ });
53
+ return record;
54
+ }
55
+ record.frontmatter_ok = true;
56
+ record.version_in_skill = diskSkill.version;
57
+ if (exp.version && diskSkill.version !== exp.version) {
58
+ findings.push({
59
+ level: "warn",
60
+ file: `skills/${expSkillName}/SKILL.md`,
61
+ msg: `exported skill version drift: registry declares ${exp.version}, SKILL.md frontmatter declares ${diskSkill.version}`,
62
+ });
63
+ }
64
+ return record;
65
+ }
66
+ async function loadExportedSkills(fs, pluginRoot, exportsFile, pluginName) {
67
+ const sources = exportsFile
68
+ ? await readExportsFromCustomFile(fs, exportsFile)
69
+ : await readExportsFromClaudeManifest(fs, pluginRoot);
70
+ return parseExportedSkillEntries(sources, pluginName);
71
+ }
72
+ async function readExportsFromCustomFile(fs, exportsFile) {
73
+ if (!(await fs.exists(exportsFile)))
74
+ return [];
75
+ try {
76
+ return [JSON.parse(await fs.readText(exportsFile))];
77
+ }
78
+ catch {
79
+ return [];
80
+ }
81
+ }
82
+ async function readExportsFromClaudeManifest(fs, pluginRoot) {
83
+ const claudeManifest = join(pluginRoot, ".claude-plugin", "plugin.json");
84
+ if (!(await fs.exists(claudeManifest)))
85
+ return [];
86
+ try {
87
+ const data = JSON.parse(await fs.readText(claudeManifest));
88
+ if (isRecord(data) && Array.isArray(data.exportedSkills)) {
89
+ return [data.exportedSkills];
90
+ }
91
+ }
92
+ catch {
93
+ // ignore
94
+ }
95
+ return [];
96
+ }
97
+ function parseExportedSkillEntries(sources, pluginName) {
98
+ const out = [];
99
+ for (const src of sources) {
100
+ if (!Array.isArray(src))
101
+ continue;
102
+ for (const item of src) {
103
+ const entry = parseExportedSkillItem(item, pluginName);
104
+ if (entry)
105
+ out.push(entry);
106
+ }
107
+ }
108
+ return out;
109
+ }
110
+ function parseExportedSkillItem(item, pluginName) {
111
+ if (!isRecord(item))
112
+ return null;
113
+ const skill = typeof item.skill === "string" ? item.skill : null;
114
+ if (!skill)
115
+ return null;
116
+ const plugin = typeof item.plugin === "string" && item.plugin.length > 0 ? item.plugin : pluginName;
117
+ const namespace = typeof item.namespace === "string" && item.namespace.length > 0
118
+ ? item.namespace
119
+ : `${plugin}:${skill}`;
120
+ return {
121
+ plugin,
122
+ skill,
123
+ namespace,
124
+ version: typeof item.version === "string" ? item.version : null,
125
+ since: typeof item.since === "string" ? item.since : null,
126
+ };
127
+ }
128
+ //# sourceMappingURL=exported-skills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"exported-skills.js","sourceRoot":"","sources":["../../../src/application/plugin-doctor/exported-skills.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { FileSystemPort } from "../../ports/file-system.js";
2
+ import { type DoctorFinding, type HooksInfoValue } from "./common.js";
3
+ export interface HooksResult {
4
+ hooksInfo: Record<string, HooksInfoValue>;
5
+ findings: DoctorFinding[];
6
+ }
7
+ export declare function parseHooks(pluginRoot: string, fs: FileSystemPort): Promise<HooksResult>;
8
+ //# sourceMappingURL=hooks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/application/plugin-doctor/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAY,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAS7F"}
@@ -0,0 +1,53 @@
1
+ import { join } from "node:path";
2
+ import { isRecord } from "./common.js";
3
+ export async function parseHooks(pluginRoot, fs) {
4
+ const findings = [];
5
+ const hooksInfo = {};
6
+ for (const relPath of ["hooks/hooks.json", "codex-hooks/hooks.json"]) {
7
+ const result = await parseHookFile(join(pluginRoot, relPath), relPath, fs);
8
+ hooksInfo[relPath] = result.value;
9
+ findings.push(...result.findings);
10
+ }
11
+ return { hooksInfo, findings };
12
+ }
13
+ async function parseHookFile(hookPath, relPath, fs) {
14
+ const findings = [];
15
+ if (!(await fs.exists(hookPath))) {
16
+ findings.push({ level: "warn", file: relPath, msg: "hooks file missing" });
17
+ return { value: null, findings };
18
+ }
19
+ let raw;
20
+ try {
21
+ raw = await fs.readText(hookPath);
22
+ }
23
+ catch (e) {
24
+ findings.push({
25
+ level: "error",
26
+ file: relPath,
27
+ msg: `invalid JSON: ${e.message}`,
28
+ });
29
+ return { value: null, findings };
30
+ }
31
+ let data;
32
+ try {
33
+ data = JSON.parse(raw);
34
+ }
35
+ catch (e) {
36
+ findings.push({
37
+ level: "error",
38
+ file: relPath,
39
+ msg: `invalid JSON: ${e.message}`,
40
+ });
41
+ return { value: null, findings };
42
+ }
43
+ if (!isRecord(data) || !("hooks" in data) || !isRecord(data.hooks)) {
44
+ findings.push({
45
+ level: "warn",
46
+ file: relPath,
47
+ msg: "hooks JSON missing top-level 'hooks' key",
48
+ });
49
+ return { value: "invalid-structure", findings };
50
+ }
51
+ return { value: Object.keys(data.hooks).sort(), findings };
52
+ }
53
+ //# sourceMappingURL=hooks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/application/plugin-doctor/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAA2C,QAAQ,EAAE,MAAM,aAAa,CAAC;AAOhF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB,EAAE,EAAkB;IACrE,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,SAAS,GAAmC,EAAE,CAAC;IACrD,KAAK,MAAM,OAAO,IAAI,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3E,SAAS,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,QAAgB,EAChB,OAAe,EACf,EAAkB;IAElB,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAC;QAC3E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,iBAAkB,CAAW,CAAC,OAAO,EAAE;SAC7C,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,iBAAkB,CAAW,CAAC,OAAO,EAAE;SAC7C,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACnE,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,OAAO;YACb,GAAG,EAAE,0CAA0C;SAChD,CAAC,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IAClD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC"}
@@ -0,0 +1,11 @@
1
+ import type { FileSystemPort } from "../../ports/file-system.js";
2
+ import { type DoctorFinding } from "./common.js";
3
+ export interface ManifestsResult {
4
+ manifestsInfo: Record<string, string | null>;
5
+ canonicalVersion: string | null;
6
+ manifestPluginName: string | null;
7
+ manifestQtcContractVersion: string | null;
8
+ findings: DoctorFinding[];
9
+ }
10
+ export declare function parseManifests(pluginRoot: string, fs: FileSystemPort, inputPluginVersion: string | null): Promise<ManifestsResult>;
11
+ //# sourceMappingURL=manifests.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifests.d.ts","sourceRoot":"","sources":["../../../src/application/plugin-doctor/manifests.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,cAAc,EAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,GAChC,OAAO,CAAC,eAAe,CAAC,CAsC1B"}
@@ -0,0 +1,83 @@
1
+ import { join } from "node:path";
2
+ import { isRecord } from "./common.js";
3
+ export async function parseManifests(pluginRoot, fs, inputPluginVersion) {
4
+ const findings = [];
5
+ const manifestsInfo = {};
6
+ let canonicalVersion = inputPluginVersion;
7
+ let manifestPluginName = null;
8
+ let manifestQtcContractVersion = null;
9
+ for (const relPath of [".claude-plugin/plugin.json", ".codex-plugin/plugin.json"]) {
10
+ const parsed = await parseManifestFile(join(pluginRoot, relPath), relPath, fs);
11
+ manifestsInfo[relPath] = parsed.version;
12
+ findings.push(...parsed.findings);
13
+ if (parsed.parseError)
14
+ continue;
15
+ if (manifestPluginName === null && parsed.name !== null) {
16
+ manifestPluginName = parsed.name;
17
+ }
18
+ if (canonicalVersion === null && parsed.version !== null) {
19
+ canonicalVersion = parsed.version;
20
+ }
21
+ else if (canonicalVersion !== null &&
22
+ parsed.version !== null &&
23
+ parsed.version !== canonicalVersion) {
24
+ findings.push({
25
+ level: "error",
26
+ file: relPath,
27
+ msg: `version drift: manifest=${parsed.version} vs declared=${canonicalVersion}`,
28
+ });
29
+ }
30
+ if (manifestQtcContractVersion === null && parsed.qtcContractVersion !== null) {
31
+ manifestQtcContractVersion = parsed.qtcContractVersion;
32
+ }
33
+ }
34
+ return {
35
+ manifestsInfo,
36
+ canonicalVersion,
37
+ manifestPluginName,
38
+ manifestQtcContractVersion,
39
+ findings,
40
+ };
41
+ }
42
+ async function parseManifestFile(manifestPath, relPath, fs) {
43
+ const findings = [];
44
+ if (!(await fs.exists(manifestPath))) {
45
+ findings.push({ level: "warn", file: relPath, msg: "manifest missing" });
46
+ return { version: null, name: null, qtcContractVersion: null, parseError: true, findings };
47
+ }
48
+ let raw;
49
+ try {
50
+ raw = await fs.readText(manifestPath);
51
+ }
52
+ catch (e) {
53
+ findings.push({
54
+ level: "error",
55
+ file: relPath,
56
+ msg: `invalid JSON: ${e.message}`,
57
+ });
58
+ return { version: null, name: null, qtcContractVersion: null, parseError: true, findings };
59
+ }
60
+ let data;
61
+ try {
62
+ data = JSON.parse(raw);
63
+ }
64
+ catch (e) {
65
+ findings.push({
66
+ level: "error",
67
+ file: relPath,
68
+ msg: `invalid JSON: ${e.message}`,
69
+ });
70
+ return { version: null, name: null, qtcContractVersion: null, parseError: true, findings };
71
+ }
72
+ if (!isRecord(data)) {
73
+ return { version: null, name: null, qtcContractVersion: null, parseError: false, findings };
74
+ }
75
+ return {
76
+ version: typeof data.version === "string" ? data.version : null,
77
+ name: typeof data.name === "string" && data.name.length > 0 ? data.name : null,
78
+ qtcContractVersion: typeof data.qtcContractVersion === "string" ? data.qtcContractVersion : null,
79
+ parseError: false,
80
+ findings,
81
+ };
82
+ }
83
+ //# sourceMappingURL=manifests.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifests.js","sourceRoot":"","sources":["../../../src/application/plugin-doctor/manifests.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import type { EnvPort } from "../../ports/env.js";
2
+ import type { FileSystemPort } from "../../ports/file-system.js";
3
+ import type { ResolvedRuntime } from "../../runtime/types.js";
4
+ import { type DoctorFinding, type McpServerInfo } from "./common.js";
5
+ export interface McpResult {
6
+ mcpInfo: Record<string, McpServerInfo>;
7
+ findings: DoctorFinding[];
8
+ }
9
+ export declare function validateMcp(pluginRoot: string, runtime: ResolvedRuntime, env: EnvPort, fs: FileSystemPort): Promise<McpResult>;
10
+ //# sourceMappingURL=mcp.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/application/plugin-doctor/mcp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAE/E,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,SAAS,CAAC,CA0BpB"}
@@ -0,0 +1,58 @@
1
+ import { join } from "node:path";
2
+ import { isRecord } from "./common.js";
3
+ export async function validateMcp(pluginRoot, runtime, env, fs) {
4
+ const findings = [];
5
+ const mcpInfo = {};
6
+ const mcpPath = join(pluginRoot, ".mcp.json");
7
+ const expectedMcpServers = runtime.expectedMcpServers ?? [];
8
+ if (expectedMcpServers.length === 0 || !(await fs.exists(mcpPath))) {
9
+ return { mcpInfo, findings };
10
+ }
11
+ let mcpData = null;
12
+ try {
13
+ mcpData = JSON.parse(await fs.readText(mcpPath));
14
+ }
15
+ catch (e) {
16
+ findings.push({
17
+ level: "error",
18
+ file: ".mcp.json",
19
+ msg: `invalid JSON: ${e.message}`,
20
+ });
21
+ return { mcpInfo, findings };
22
+ }
23
+ if (!isRecord(mcpData))
24
+ return { mcpInfo, findings };
25
+ const servers = isRecord(mcpData.mcpServers) ? mcpData.mcpServers : {};
26
+ for (const exp of expectedMcpServers) {
27
+ const server = servers[exp];
28
+ mcpInfo[exp] = validateMcpServer(server, exp, env, findings);
29
+ }
30
+ return { mcpInfo, findings };
31
+ }
32
+ function validateMcpServer(server, exp, env, findings) {
33
+ if (server === undefined) {
34
+ findings.push({
35
+ level: "warn",
36
+ file: ".mcp.json",
37
+ msg: `expected server '${exp}' not configured`,
38
+ });
39
+ return "missing";
40
+ }
41
+ const dsnRaw = isRecord(server) && isRecord(server.env) && typeof server.env.DSN === "string"
42
+ ? server.env.DSN
43
+ : "";
44
+ const m = dsnRaw.match(/^\$\{(\w+)\}$/);
45
+ if (!m?.[1])
46
+ return { dsn_env: null, env_set: null };
47
+ const envVar = m[1];
48
+ const envSet = Boolean(env.get(envVar));
49
+ if (!envSet) {
50
+ findings.push({
51
+ level: "warn",
52
+ file: ".mcp.json",
53
+ msg: `env var ${envVar} not set (required by mcp server '${exp}')`,
54
+ });
55
+ }
56
+ return { dsn_env: envVar, env_set: envSet };
57
+ }
58
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/application/plugin-doctor/mcp.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { FileSystemPort } from "../../ports/file-system.js";
2
+ import { type DoctorFinding, type SkillFrontmatterInfo } from "./common.js";
3
+ export interface SkillsCheckResult {
4
+ skillsCount: number;
5
+ skillsInfo: SkillFrontmatterInfo[];
6
+ findings: DoctorFinding[];
7
+ }
8
+ export interface ReadmeCheckResult {
9
+ readmeCountExpected: number | null;
10
+ readmeCountMatch: boolean | null;
11
+ findings: DoctorFinding[];
12
+ }
13
+ export declare function checkSkillsFrontmatter(skillsDir: string, fs: FileSystemPort): Promise<SkillsCheckResult>;
14
+ export declare function checkReadmeSync(readmePath: string, skillsCount: number, fs: FileSystemPort): Promise<ReadmeCheckResult>;
15
+ export declare function checkFrontendDesignGeneralization(skillsDir: string, pluginRoot: string, fs: FileSystemPort): Promise<DoctorFinding[]>;
16
+ //# sourceMappingURL=skills.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/application/plugin-doctor/skills.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAwB,MAAM,aAAa,CAAC;AAUlG,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAqB5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,iBAAiB,CAAC,CA+B5B;AAED,wBAAsB,iCAAiC,CACrD,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,cAAc,GACjB,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB1B"}
@@ -0,0 +1,167 @@
1
+ import { join, relative, sep } from "node:path";
2
+ import { collectMarkdownFiles } from "./common.js";
3
+ const SESSION_SPECIFIC_MARKERS = [
4
+ "session034",
5
+ "idNegocioFinanciero",
6
+ "usuario-editar.component",
7
+ "AuthUserServiceImpl",
8
+ "tb_acceso_usuario_rol",
9
+ ];
10
+ export async function checkSkillsFrontmatter(skillsDir, fs) {
11
+ const findings = [];
12
+ const skillsInfo = [];
13
+ const skillDirs = await collectSkillDirs(skillsDir, fs);
14
+ for (const sd of skillDirs) {
15
+ const skillMd = join(sd, "SKILL.md");
16
+ const dirName = sd.split(sep).pop() ?? "";
17
+ const parsed = await parseSkillFile(skillMd, fs);
18
+ if (parsed.error) {
19
+ findings.push({ level: "error", file: skillMd, msg: parsed.error });
20
+ skillsInfo.push({ dir: dirName, name: null, version: null });
21
+ continue;
22
+ }
23
+ validateSkillFrontmatter(skillMd, dirName, parsed.frontmatter, findings);
24
+ skillsInfo.push({
25
+ dir: dirName,
26
+ name: parsed.frontmatter.name ?? null,
27
+ version: parsed.frontmatter.version ?? null,
28
+ });
29
+ }
30
+ return { skillsCount: skillDirs.length, skillsInfo, findings };
31
+ }
32
+ export async function checkReadmeSync(readmePath, skillsCount, fs) {
33
+ const findings = [];
34
+ if (!(await fs.exists(readmePath))) {
35
+ findings.push({ level: "warn", file: "README.md", msg: "README.md not found at plugin root" });
36
+ return { readmeCountExpected: null, readmeCountMatch: null, findings };
37
+ }
38
+ let readmeText;
39
+ try {
40
+ readmeText = await fs.readText(readmePath);
41
+ }
42
+ catch (e) {
43
+ findings.push({
44
+ level: "warn",
45
+ file: "README.md",
46
+ msg: `cannot read: ${e.message}`,
47
+ });
48
+ return { readmeCountExpected: null, readmeCountMatch: null, findings };
49
+ }
50
+ const m = readmeText.match(/\*\*Skills\*\*\s*\((\d+)/);
51
+ if (!m?.[1]) {
52
+ return { readmeCountExpected: null, readmeCountMatch: null, findings };
53
+ }
54
+ const readmeCountExpected = Number.parseInt(m[1], 10);
55
+ const readmeCountMatch = readmeCountExpected === skillsCount;
56
+ if (!readmeCountMatch) {
57
+ findings.push({
58
+ level: "warn",
59
+ file: "README.md",
60
+ msg: `Skills count mismatch: README claims ${readmeCountExpected}, actual ${skillsCount}`,
61
+ });
62
+ }
63
+ return { readmeCountExpected, readmeCountMatch, findings };
64
+ }
65
+ export async function checkFrontendDesignGeneralization(skillsDir, pluginRoot, fs) {
66
+ const findings = [];
67
+ const fdDir = join(skillsDir, "frontend-design");
68
+ if (!(await fs.exists(skillsDir)) || !(await fs.exists(fdDir)))
69
+ return findings;
70
+ const mdFiles = await collectMarkdownFiles(fs, fdDir);
71
+ mdFiles.sort((a, b) => a.localeCompare(b));
72
+ for (const mdFile of mdFiles) {
73
+ let text;
74
+ try {
75
+ text = await fs.readText(mdFile);
76
+ }
77
+ catch {
78
+ continue;
79
+ }
80
+ scanForSessionMarkers(text, mdFile, pluginRoot, findings);
81
+ }
82
+ return findings;
83
+ }
84
+ async function collectSkillDirs(skillsDir, fs) {
85
+ const out = [];
86
+ if (!(await fs.exists(skillsDir)))
87
+ return out;
88
+ const entries = await fs.list(skillsDir);
89
+ for (const entry of entries) {
90
+ if (entry.type !== "dir")
91
+ continue;
92
+ const skillMd = join(entry.path, "SKILL.md");
93
+ if (await fs.exists(skillMd))
94
+ out.push(entry.path);
95
+ }
96
+ out.sort((a, b) => a.localeCompare(b));
97
+ return out;
98
+ }
99
+ async function parseSkillFile(skillMd, fs) {
100
+ let content;
101
+ try {
102
+ content = await fs.readText(skillMd);
103
+ }
104
+ catch (e) {
105
+ return { frontmatter: {}, error: `cannot read: ${e.message}` };
106
+ }
107
+ const lines = content.split(/\r?\n/);
108
+ if (lines.length === 0 || (lines[0] ?? "").trim() !== "---") {
109
+ return { frontmatter: {}, error: "missing frontmatter opening ---" };
110
+ }
111
+ let endIdx = -1;
112
+ for (let i = 1; i < lines.length; i++) {
113
+ if ((lines[i] ?? "").trim() === "---") {
114
+ endIdx = i;
115
+ break;
116
+ }
117
+ }
118
+ if (endIdx === -1) {
119
+ return { frontmatter: {}, error: "missing frontmatter closing ---" };
120
+ }
121
+ const fm = {};
122
+ for (let i = 1; i < endIdx; i++) {
123
+ const m = (lines[i] ?? "").match(/^(\w+):\s*(.+)$/);
124
+ if (m?.[1] && m[2] !== undefined)
125
+ fm[m[1]] = m[2].trim();
126
+ }
127
+ return { frontmatter: fm, error: null };
128
+ }
129
+ function validateSkillFrontmatter(skillMd, dirName, fm, findings) {
130
+ const { name, version, description } = fm;
131
+ if (!name) {
132
+ findings.push({ level: "error", file: skillMd, msg: "missing 'name' in frontmatter" });
133
+ }
134
+ else if (name !== dirName) {
135
+ findings.push({
136
+ level: "warn",
137
+ file: skillMd,
138
+ msg: `frontmatter name '${name}' differs from directory '${dirName}'`,
139
+ });
140
+ }
141
+ if (!description) {
142
+ findings.push({ level: "error", file: skillMd, msg: "missing 'description' in frontmatter" });
143
+ }
144
+ if (!version) {
145
+ findings.push({ level: "warn", file: skillMd, msg: "missing 'version' in frontmatter" });
146
+ }
147
+ else if (!/^\d+\.\d+\.\d+$/.test(version)) {
148
+ findings.push({
149
+ level: "warn",
150
+ file: skillMd,
151
+ msg: `version '${version}' not semver-compatible`,
152
+ });
153
+ }
154
+ }
155
+ function scanForSessionMarkers(text, mdFile, pluginRoot, findings) {
156
+ for (const marker of SESSION_SPECIFIC_MARKERS) {
157
+ if (!text.includes(marker))
158
+ continue;
159
+ const rel = relative(pluginRoot, mdFile).split(sep).join("/");
160
+ findings.push({
161
+ level: "error",
162
+ file: rel,
163
+ msg: `contains session-specific name '${marker}' (frontend-design must stay generalized)`,
164
+ });
165
+ }
166
+ }
167
+ //# sourceMappingURL=skills.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/application/plugin-doctor/skills.ts"],"names":[],"mappings":"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"}