jekyll-component-mcp 0.0.0-stage → 1.0.2

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 (107) hide show
  1. package/.github/skills/.gitkeep +0 -0
  2. package/.github/skills/jekyll-component-mcp/SKILL.md +98 -0
  3. package/CHANGELOG.md +18 -0
  4. package/LICENSE +21 -0
  5. package/README.md +167 -2
  6. package/dist/config/constants.d.ts +46 -0
  7. package/dist/config/constants.d.ts.map +1 -0
  8. package/dist/config/constants.js +75 -0
  9. package/dist/config/constants.js.map +1 -0
  10. package/dist/config/environment.d.ts +51 -0
  11. package/dist/config/environment.d.ts.map +1 -0
  12. package/dist/config/environment.js +102 -0
  13. package/dist/config/environment.js.map +1 -0
  14. package/dist/index.d.ts +7 -0
  15. package/dist/index.d.ts.map +1 -0
  16. package/dist/index.js +86 -0
  17. package/dist/index.js.map +1 -0
  18. package/dist/parsers/frontmatter-parser.d.ts +19 -0
  19. package/dist/parsers/frontmatter-parser.d.ts.map +1 -0
  20. package/dist/parsers/frontmatter-parser.js +71 -0
  21. package/dist/parsers/frontmatter-parser.js.map +1 -0
  22. package/dist/parsers/liquid-parser.d.ts +33 -0
  23. package/dist/parsers/liquid-parser.d.ts.map +1 -0
  24. package/dist/parsers/liquid-parser.js +98 -0
  25. package/dist/parsers/liquid-parser.js.map +1 -0
  26. package/dist/parsers/project-scanner.d.ts +29 -0
  27. package/dist/parsers/project-scanner.d.ts.map +1 -0
  28. package/dist/parsers/project-scanner.js +194 -0
  29. package/dist/parsers/project-scanner.js.map +1 -0
  30. package/dist/parsers/scss-parser.d.ts +26 -0
  31. package/dist/parsers/scss-parser.d.ts.map +1 -0
  32. package/dist/parsers/scss-parser.js +90 -0
  33. package/dist/parsers/scss-parser.js.map +1 -0
  34. package/dist/security/command-policy.d.ts +21 -0
  35. package/dist/security/command-policy.d.ts.map +1 -0
  36. package/dist/security/command-policy.js +48 -0
  37. package/dist/security/command-policy.js.map +1 -0
  38. package/dist/security/path-policy.d.ts +31 -0
  39. package/dist/security/path-policy.d.ts.map +1 -0
  40. package/dist/security/path-policy.js +127 -0
  41. package/dist/security/path-policy.js.map +1 -0
  42. package/dist/security/validation.d.ts +18 -0
  43. package/dist/security/validation.d.ts.map +1 -0
  44. package/dist/security/validation.js +59 -0
  45. package/dist/security/validation.js.map +1 -0
  46. package/dist/server/context.d.ts +18 -0
  47. package/dist/server/context.d.ts.map +1 -0
  48. package/dist/server/context.js +34 -0
  49. package/dist/server/context.js.map +1 -0
  50. package/dist/server/create-server.d.ts +8 -0
  51. package/dist/server/create-server.d.ts.map +1 -0
  52. package/dist/server/create-server.js +546 -0
  53. package/dist/server/create-server.js.map +1 -0
  54. package/dist/services/build-service.d.ts +27 -0
  55. package/dist/services/build-service.d.ts.map +1 -0
  56. package/dist/services/build-service.js +85 -0
  57. package/dist/services/build-service.js.map +1 -0
  58. package/dist/services/component-service.d.ts +74 -0
  59. package/dist/services/component-service.d.ts.map +1 -0
  60. package/dist/services/component-service.js +422 -0
  61. package/dist/services/component-service.js.map +1 -0
  62. package/dist/services/documentation-service.d.ts +64 -0
  63. package/dist/services/documentation-service.d.ts.map +1 -0
  64. package/dist/services/documentation-service.js +186 -0
  65. package/dist/services/documentation-service.js.map +1 -0
  66. package/dist/services/liquid-service.d.ts +31 -0
  67. package/dist/services/liquid-service.d.ts.map +1 -0
  68. package/dist/services/liquid-service.js +103 -0
  69. package/dist/services/liquid-service.js.map +1 -0
  70. package/dist/services/project-service.d.ts +30 -0
  71. package/dist/services/project-service.d.ts.map +1 -0
  72. package/dist/services/project-service.js +102 -0
  73. package/dist/services/project-service.js.map +1 -0
  74. package/dist/services/scss-service.d.ts +37 -0
  75. package/dist/services/scss-service.d.ts.map +1 -0
  76. package/dist/services/scss-service.js +82 -0
  77. package/dist/services/scss-service.js.map +1 -0
  78. package/dist/services/token-service.d.ts +29 -0
  79. package/dist/services/token-service.d.ts.map +1 -0
  80. package/dist/services/token-service.js +97 -0
  81. package/dist/services/token-service.js.map +1 -0
  82. package/dist/services/validation-service.d.ts +33 -0
  83. package/dist/services/validation-service.d.ts.map +1 -0
  84. package/dist/services/validation-service.js +101 -0
  85. package/dist/services/validation-service.js.map +1 -0
  86. package/dist/utils/filesystem.d.ts +38 -0
  87. package/dist/utils/filesystem.d.ts.map +1 -0
  88. package/dist/utils/filesystem.js +131 -0
  89. package/dist/utils/filesystem.js.map +1 -0
  90. package/dist/utils/json.d.ts +6 -0
  91. package/dist/utils/json.d.ts.map +1 -0
  92. package/dist/utils/json.js +20 -0
  93. package/dist/utils/json.js.map +1 -0
  94. package/dist/utils/logger.d.ts +14 -0
  95. package/dist/utils/logger.d.ts.map +1 -0
  96. package/dist/utils/logger.js +58 -0
  97. package/dist/utils/logger.js.map +1 -0
  98. package/dist/utils/shell.d.ts +23 -0
  99. package/dist/utils/shell.d.ts.map +1 -0
  100. package/dist/utils/shell.js +96 -0
  101. package/dist/utils/shell.js.map +1 -0
  102. package/dist/utils/yaml.d.ts +15 -0
  103. package/dist/utils/yaml.d.ts.map +1 -0
  104. package/dist/utils/yaml.js +34 -0
  105. package/dist/utils/yaml.js.map +1 -0
  106. package/package.json +65 -4
  107. package/skills/SKILL.md +98 -0
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Design token detection and updates (prefer CSS custom properties).
3
+ */
4
+ import { assertWriteAllowed } from "../server/context.js";
5
+ import { safeExists, safeReadFile, safeWriteFile, safeWalk } from "../utils/filesystem.js";
6
+ import { analyzeScss } from "../parsers/scss-parser.js";
7
+ export class TokenService {
8
+ ctx;
9
+ constructor(ctx) {
10
+ this.ctx = ctx;
11
+ }
12
+ list() {
13
+ const root = this.ctx.config.root;
14
+ const scssRoot = this.ctx.config.paths.scss;
15
+ const tokens = [];
16
+ const files = [];
17
+ if (!safeExists(root, scssRoot)) {
18
+ return { tokens, files };
19
+ }
20
+ for (const e of safeWalk(root, scssRoot, {
21
+ maxDepth: 6,
22
+ extensions: [".scss", ".sass", ".css"],
23
+ })) {
24
+ if (e.isDirectory)
25
+ continue;
26
+ const base = e.relativePath.toLowerCase();
27
+ if (!base.includes("token") &&
28
+ !base.includes("variable") &&
29
+ !base.includes("abstract") &&
30
+ !base.includes("_vars") &&
31
+ !base.includes("theme")) {
32
+ continue;
33
+ }
34
+ try {
35
+ const source = safeReadFile(root, e.relativePath, {
36
+ maxSize: this.ctx.config.maxFileSize,
37
+ });
38
+ const analysis = analyzeScss(source);
39
+ files.push(e.relativePath);
40
+ tokens.push(...analysis.cssCustomProperties, ...analysis.variables);
41
+ }
42
+ catch {
43
+ /* skip */
44
+ }
45
+ }
46
+ return { tokens, files };
47
+ }
48
+ get(name) {
49
+ const { tokens } = this.list();
50
+ const lower = name.toLowerCase().replace(/^--/, "").replace(/^\$/, "");
51
+ return tokens.filter((t) => t.name.toLowerCase().includes(lower) ||
52
+ t.category === lower);
53
+ }
54
+ update(input) {
55
+ try {
56
+ assertWriteAllowed(this.ctx, "update");
57
+ }
58
+ catch (err) {
59
+ return {
60
+ success: false,
61
+ error: {
62
+ code: err.code ?? "WRITE_MODE_DENIED",
63
+ message: err.message,
64
+ },
65
+ };
66
+ }
67
+ const root = this.ctx.config.root;
68
+ if (!safeExists(root, input.file)) {
69
+ return {
70
+ success: false,
71
+ error: { code: "NOT_FOUND", message: `File not found: ${input.file}` },
72
+ };
73
+ }
74
+ const source = safeReadFile(root, input.file, {
75
+ maxSize: this.ctx.config.maxFileSize,
76
+ });
77
+ const name = input.name.startsWith("--") || input.name.startsWith("$")
78
+ ? input.name
79
+ : `--${input.name}`;
80
+ // Simple replace of existing declaration or append
81
+ const re = new RegExp(`(${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\s*:\\s*)([^;]+)(;)`);
82
+ let next;
83
+ if (re.test(source)) {
84
+ next = source.replace(re, `$1${input.value}$3`);
85
+ }
86
+ else {
87
+ next = source.trimEnd() + `\n${name}: ${input.value};\n`;
88
+ }
89
+ if (input.dry_run) {
90
+ return { success: true, dry_run: true, path: input.file };
91
+ }
92
+ safeWriteFile(root, input.file, next, { maxSize: this.ctx.config.maxFileSize });
93
+ this.ctx.invalidateCache();
94
+ return { success: true, path: input.file };
95
+ }
96
+ }
97
+ //# sourceMappingURL=token-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"token-service.js","sourceRoot":"","sources":["../../src/services/token-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Project-level validation orchestration.
3
+ */
4
+ import type { ServerContext } from "../server/context.js";
5
+ export interface ProjectValidationResult {
6
+ valid: boolean;
7
+ errors: Array<{
8
+ code: string;
9
+ message: string;
10
+ file?: string;
11
+ }>;
12
+ warnings: Array<{
13
+ code: string;
14
+ message: string;
15
+ file?: string;
16
+ }>;
17
+ componentsChecked: number;
18
+ build?: {
19
+ success: boolean;
20
+ message?: string;
21
+ };
22
+ }
23
+ export declare class ValidationService {
24
+ private readonly ctx;
25
+ private components;
26
+ private project;
27
+ private build;
28
+ constructor(ctx: ServerContext);
29
+ validate(options?: {
30
+ runBuild?: boolean;
31
+ }): Promise<ProjectValidationResult>;
32
+ }
33
+ //# sourceMappingURL=validation-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validation-service.d.ts","sourceRoot":"","sources":["../../src/services/validation-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChE,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,qBAAa,iBAAiB;IAKhB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJhC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,KAAK,CAAe;gBAEC,GAAG,EAAE,aAAa;IAMzC,QAAQ,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAkFvF"}
@@ -0,0 +1,101 @@
1
+ /**
2
+ * Project-level validation orchestration.
3
+ */
4
+ import { ComponentService } from "./component-service.js";
5
+ import { ProjectService } from "./project-service.js";
6
+ import { BuildService } from "./build-service.js";
7
+ import { validateFrontMatter } from "../parsers/frontmatter-parser.js";
8
+ import { safeExists, safeReadFile, safeWalk } from "../utils/filesystem.js";
9
+ export class ValidationService {
10
+ ctx;
11
+ components;
12
+ project;
13
+ build;
14
+ constructor(ctx) {
15
+ this.ctx = ctx;
16
+ this.components = new ComponentService(ctx);
17
+ this.project = new ProjectService(ctx);
18
+ this.build = new BuildService(ctx);
19
+ }
20
+ async validate(options = {}) {
21
+ const errors = [];
22
+ const warnings = [];
23
+ const info = this.project.getInfo();
24
+ if (!info.jekyll) {
25
+ warnings.push({
26
+ code: "NOT_JEKYLL",
27
+ message: "Project does not look like a Jekyll site (no _config or standard dirs)",
28
+ });
29
+ }
30
+ const scan = this.project.getScan();
31
+ let componentsChecked = 0;
32
+ for (const c of scan.components) {
33
+ componentsChecked += 1;
34
+ const result = this.components.validate(c.name);
35
+ for (const e of result.errors) {
36
+ errors.push({ code: "COMPONENT_ERROR", message: e.message, file: e.file });
37
+ }
38
+ for (const w of result.warnings) {
39
+ warnings.push({ code: "COMPONENT_WARNING", message: w.message, file: w.file });
40
+ }
41
+ }
42
+ // Front matter on markdown under docs
43
+ const root = this.ctx.config.root;
44
+ if (safeExists(root, this.ctx.config.paths.docs)) {
45
+ for (const e of safeWalk(root, this.ctx.config.paths.docs, {
46
+ maxDepth: 4,
47
+ extensions: [".md", ".markdown"],
48
+ })) {
49
+ if (e.isDirectory)
50
+ continue;
51
+ try {
52
+ const source = safeReadFile(root, e.relativePath, {
53
+ maxSize: this.ctx.config.maxFileSize,
54
+ });
55
+ const fm = validateFrontMatter(source);
56
+ for (const issue of fm.issues) {
57
+ if (issue.level === "error") {
58
+ errors.push({
59
+ code: "FRONTMATTER",
60
+ message: issue.message,
61
+ file: e.relativePath,
62
+ });
63
+ }
64
+ else {
65
+ warnings.push({
66
+ code: "FRONTMATTER",
67
+ message: issue.message,
68
+ file: e.relativePath,
69
+ });
70
+ }
71
+ }
72
+ }
73
+ catch {
74
+ /* skip */
75
+ }
76
+ }
77
+ }
78
+ let buildResult;
79
+ if (options.runBuild) {
80
+ const b = await this.build.build();
81
+ buildResult = {
82
+ success: b.success,
83
+ message: b.success ? "Build succeeded" : b.error?.message ?? "Build failed",
84
+ };
85
+ if (!b.success) {
86
+ errors.push({
87
+ code: "BUILD_FAILED",
88
+ message: buildResult.message ?? "Build failed",
89
+ });
90
+ }
91
+ }
92
+ return {
93
+ valid: errors.length === 0,
94
+ errors,
95
+ warnings,
96
+ componentsChecked,
97
+ build: buildResult,
98
+ };
99
+ }
100
+ }
101
+ //# sourceMappingURL=validation-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validation-service.js","sourceRoot":"","sources":["../../src/services/validation-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAU5E,MAAM,OAAO,iBAAiB;IAKC;IAJrB,UAAU,CAAmB;IAC7B,OAAO,CAAiB;IACxB,KAAK,CAAe;IAE5B,YAA6B,GAAkB;QAAlB,QAAG,GAAH,GAAG,CAAe;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,UAAkC,EAAE;QACjD,MAAM,MAAM,GAAsC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAwC,EAAE,CAAC;QAEzD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,wEAAwE;aAClF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAChC,iBAAiB,IAAI,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAChD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAClC,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;gBACzD,QAAQ,EAAE,CAAC;gBACX,UAAU,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC;aACjC,CAAC,EAAE,CAAC;gBACH,IAAI,CAAC,CAAC,WAAW;oBAAE,SAAS;gBAC5B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,YAAY,EAAE;wBAChD,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW;qBACrC,CAAC,CAAC;oBACH,MAAM,EAAE,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;oBACvC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;wBAC9B,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;4BAC5B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI,EAAE,aAAa;gCACnB,OAAO,EAAE,KAAK,CAAC,OAAO;gCACtB,IAAI,EAAE,CAAC,CAAC,YAAY;6BACrB,CAAC,CAAC;wBACL,CAAC;6BAAM,CAAC;4BACN,QAAQ,CAAC,IAAI,CAAC;gCACZ,IAAI,EAAE,aAAa;gCACnB,OAAO,EAAE,KAAK,CAAC,OAAO;gCACtB,IAAI,EAAE,CAAC,CAAC,YAAY;6BACrB,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,UAAU;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,WAA6C,CAAC;QAClD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnC,WAAW,GAAG;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,cAAc;aAC5E,CAAC;YACF,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,cAAc;iBAC/C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;YACR,iBAAiB;YACjB,KAAK,EAAE,WAAW;SACnB,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Safe filesystem helpers that always go through path-policy.
3
+ */
4
+ import fs from "node:fs";
5
+ export interface ReadOptions {
6
+ maxSize?: number;
7
+ encoding?: BufferEncoding;
8
+ }
9
+ export interface WriteOptions {
10
+ maxSize?: number;
11
+ createDirs?: boolean;
12
+ overwrite?: boolean;
13
+ }
14
+ export declare function safeExists(root: string, relativePath: string): boolean;
15
+ export declare function safeStat(root: string, relativePath: string): fs.Stats | null;
16
+ export declare function safeReadFile(root: string, relativePath: string, options?: ReadOptions): string;
17
+ export declare function safeWriteFile(root: string, relativePath: string, content: string | Buffer, options?: WriteOptions): {
18
+ created: boolean;
19
+ modified: boolean;
20
+ path: string;
21
+ };
22
+ export declare function safeReadDir(root: string, relativePath: string, options?: {
23
+ withFileTypes?: boolean;
24
+ }): string[] | fs.Dirent[];
25
+ export declare function safeMkdir(root: string, relativePath: string): string;
26
+ export declare function safeUnlink(root: string, relativePath: string): void;
27
+ /**
28
+ * Walk directory under root with depth limit. Yields relative paths.
29
+ */
30
+ export declare function safeWalk(root: string, relativeDir: string, options?: {
31
+ maxDepth?: number;
32
+ extensions?: string[];
33
+ }): Generator<{
34
+ relativePath: string;
35
+ absolutePath: string;
36
+ isDirectory: boolean;
37
+ }>;
38
+ //# sourceMappingURL=filesystem.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../src/utils/filesystem.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AAKzB,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAOtE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,EAAE,CAAC,KAAK,GAAG,IAAI,CAO5E;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,MAAM,CAaR;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,YAAiB,GACzB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAwCvD;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAMxB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,wBAAiB,QAAQ,CACvB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAO,GACzD,SAAS,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC,CAkCjF"}
@@ -0,0 +1,131 @@
1
+ /**
2
+ * Safe filesystem helpers that always go through path-policy.
3
+ */
4
+ import fs from "node:fs";
5
+ import path from "node:path";
6
+ import { resolveSafePath, toRelative } from "../security/path-policy.js";
7
+ import { logger } from "./logger.js";
8
+ export function safeExists(root, relativePath) {
9
+ try {
10
+ const abs = resolveSafePath(root, relativePath);
11
+ return fs.existsSync(abs);
12
+ }
13
+ catch {
14
+ return false;
15
+ }
16
+ }
17
+ export function safeStat(root, relativePath) {
18
+ try {
19
+ const abs = resolveSafePath(root, relativePath);
20
+ return fs.statSync(abs);
21
+ }
22
+ catch {
23
+ return null;
24
+ }
25
+ }
26
+ export function safeReadFile(root, relativePath, options = {}) {
27
+ const abs = resolveSafePath(root, relativePath);
28
+ const maxSize = options.maxSize ?? 2 * 1024 * 1024;
29
+ const stat = fs.statSync(abs);
30
+ if (!stat.isFile()) {
31
+ throw new Error(`Not a file: ${toRelative(root, abs)}`);
32
+ }
33
+ if (stat.size > maxSize) {
34
+ throw new Error(`File exceeds maximum size (${stat.size} > ${maxSize}): ${toRelative(root, abs)}`);
35
+ }
36
+ return fs.readFileSync(abs, options.encoding ?? "utf8");
37
+ }
38
+ export function safeWriteFile(root, relativePath, content, options = {}) {
39
+ const abs = resolveSafePath(root, relativePath);
40
+ const maxSize = options.maxSize ?? 2 * 1024 * 1024;
41
+ const size = typeof content === "string" ? Buffer.byteLength(content, "utf8") : content.length;
42
+ if (size > maxSize) {
43
+ throw new Error(`Content exceeds maximum writable size (${size} > ${maxSize})`);
44
+ }
45
+ const existed = fs.existsSync(abs);
46
+ if (existed && options.overwrite === false) {
47
+ return { created: false, modified: false, path: toRelative(root, abs) };
48
+ }
49
+ if (options.createDirs !== false) {
50
+ fs.mkdirSync(path.dirname(abs), { recursive: true });
51
+ }
52
+ let modified = true;
53
+ if (existed) {
54
+ try {
55
+ const existing = fs.readFileSync(abs);
56
+ const next = typeof content === "string" ? Buffer.from(content, "utf8") : content;
57
+ if (existing.equals(next)) {
58
+ modified = false;
59
+ }
60
+ }
61
+ catch {
62
+ // proceed with write
63
+ }
64
+ }
65
+ if (modified || !existed) {
66
+ fs.writeFileSync(abs, content, typeof content === "string" ? "utf8" : undefined);
67
+ logger.debug(existed ? "Modified file" : "Created file", { path: toRelative(root, abs) });
68
+ }
69
+ return {
70
+ created: !existed,
71
+ modified,
72
+ path: toRelative(root, abs),
73
+ };
74
+ }
75
+ export function safeReadDir(root, relativePath, options = {}) {
76
+ const abs = resolveSafePath(root, relativePath);
77
+ if (options.withFileTypes) {
78
+ return fs.readdirSync(abs, { withFileTypes: true });
79
+ }
80
+ return fs.readdirSync(abs);
81
+ }
82
+ export function safeMkdir(root, relativePath) {
83
+ const abs = resolveSafePath(root, relativePath);
84
+ fs.mkdirSync(abs, { recursive: true });
85
+ return toRelative(root, abs);
86
+ }
87
+ export function safeUnlink(root, relativePath) {
88
+ const abs = resolveSafePath(root, relativePath);
89
+ if (fs.existsSync(abs)) {
90
+ fs.unlinkSync(abs);
91
+ logger.debug("Deleted file", { path: toRelative(root, abs) });
92
+ }
93
+ }
94
+ /**
95
+ * Walk directory under root with depth limit. Yields relative paths.
96
+ */
97
+ export function* safeWalk(root, relativeDir, options = {}) {
98
+ const maxDepth = options.maxDepth ?? 12;
99
+ const extensions = options.extensions?.map((e) => e.toLowerCase());
100
+ function* walk(rel, depth) {
101
+ if (depth > maxDepth)
102
+ return;
103
+ let entries;
104
+ try {
105
+ entries = fs.readdirSync(resolveSafePath(root, rel), { withFileTypes: true });
106
+ }
107
+ catch {
108
+ return;
109
+ }
110
+ for (const entry of entries) {
111
+ if (entry.name.startsWith(".") && entry.name !== ".jekyll-mcp.json")
112
+ continue;
113
+ const childRel = rel ? `${rel}/${entry.name}` : entry.name;
114
+ const childAbs = resolveSafePath(root, childRel);
115
+ if (entry.isDirectory()) {
116
+ yield { relativePath: childRel, absolutePath: childAbs, isDirectory: true };
117
+ yield* walk(childRel, depth + 1);
118
+ }
119
+ else if (entry.isFile()) {
120
+ if (extensions) {
121
+ const ext = path.extname(entry.name).toLowerCase();
122
+ if (!extensions.includes(ext))
123
+ continue;
124
+ }
125
+ yield { relativePath: childRel, absolutePath: childAbs, isDirectory: false };
126
+ }
127
+ }
128
+ }
129
+ yield* walk(relativeDir === "." ? "" : relativeDir, 0);
130
+ }
131
+ //# sourceMappingURL=filesystem.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../src/utils/filesystem.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Safe JSON helpers.
3
+ */
4
+ export declare function safeJsonParse<T = unknown>(text: string): T | null;
5
+ export declare function safeJsonStringify(value: unknown, pretty?: boolean): string;
6
+ //# sourceMappingURL=json.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,MAAM,CAMxE"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Safe JSON helpers.
3
+ */
4
+ export function safeJsonParse(text) {
5
+ try {
6
+ return JSON.parse(text);
7
+ }
8
+ catch {
9
+ return null;
10
+ }
11
+ }
12
+ export function safeJsonStringify(value, pretty = false) {
13
+ try {
14
+ return JSON.stringify(value, null, pretty ? 2 : 0) ?? "null";
15
+ }
16
+ catch {
17
+ return "null";
18
+ }
19
+ }
20
+ //# sourceMappingURL=json.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/utils/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,aAAa,CAAc,IAAY;IACrD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc,EAAE,MAAM,GAAG,KAAK;IAC9D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC"}
@@ -0,0 +1,14 @@
1
+ /**
2
+ * Stderr-only logger. stdout is reserved exclusively for MCP JSON-RPC traffic.
3
+ * NEVER use console.log in this process.
4
+ */
5
+ export type LogLevel = "debug" | "info" | "warn" | "error";
6
+ export declare function setLogLevel(level: LogLevel): void;
7
+ export declare function getLogLevel(): LogLevel;
8
+ export declare const logger: {
9
+ debug(message: string, meta?: unknown): void;
10
+ info(message: string, meta?: unknown): void;
11
+ warn(message: string, meta?: unknown): void;
12
+ error(message: string, meta?: unknown): void;
13
+ };
14
+ //# sourceMappingURL=logger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAqBD,eAAO,MAAM,MAAM;mBACF,MAAM,SAAS,OAAO,GAAG,IAAI;kBAK9B,MAAM,SAAS,OAAO,GAAG,IAAI;kBAK7B,MAAM,SAAS,OAAO,GAAG,IAAI;mBAK5B,MAAM,SAAS,OAAO,GAAG,IAAI;CAK7C,CAAC"}
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Stderr-only logger. stdout is reserved exclusively for MCP JSON-RPC traffic.
3
+ * NEVER use console.log in this process.
4
+ */
5
+ const LEVEL_ORDER = {
6
+ debug: 0,
7
+ info: 1,
8
+ warn: 2,
9
+ error: 3,
10
+ };
11
+ let currentLevel = "info";
12
+ export function setLogLevel(level) {
13
+ currentLevel = level;
14
+ }
15
+ export function getLogLevel() {
16
+ return currentLevel;
17
+ }
18
+ function shouldLog(level) {
19
+ return LEVEL_ORDER[level] >= LEVEL_ORDER[currentLevel];
20
+ }
21
+ function formatMessage(level, message, meta) {
22
+ const ts = new Date().toISOString();
23
+ const prefix = `[MCP] ${ts} ${level.toUpperCase()}`;
24
+ if (meta === undefined) {
25
+ return `${prefix} ${message}`;
26
+ }
27
+ // Never log secrets; stringify carefully
28
+ try {
29
+ const safe = typeof meta === "string" ? meta : JSON.stringify(meta, null, 0);
30
+ return `${prefix} ${message} ${safe}`;
31
+ }
32
+ catch {
33
+ return `${prefix} ${message} [unserializable]`;
34
+ }
35
+ }
36
+ export const logger = {
37
+ debug(message, meta) {
38
+ if (shouldLog("debug")) {
39
+ console.error(formatMessage("debug", message, meta));
40
+ }
41
+ },
42
+ info(message, meta) {
43
+ if (shouldLog("info")) {
44
+ console.error(formatMessage("info", message, meta));
45
+ }
46
+ },
47
+ warn(message, meta) {
48
+ if (shouldLog("warn")) {
49
+ console.error(formatMessage("warn", message, meta));
50
+ }
51
+ },
52
+ error(message, meta) {
53
+ if (shouldLog("error")) {
54
+ console.error(formatMessage("error", message, meta));
55
+ }
56
+ },
57
+ };
58
+ //# sourceMappingURL=logger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;IACrE,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,SAAS,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IACpD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC;IAChC,CAAC;IACD,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7E,OAAO,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,MAAM,IAAI,OAAO,mBAAmB,CAAC;IACjD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,IAAc;QAClC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,IAAc;QACnC,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF,CAAC"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Safe subprocess execution with timeout and allowlist enforcement.
3
+ */
4
+ export interface RunResult {
5
+ exitCode: number | null;
6
+ stdout: string;
7
+ stderr: string;
8
+ durationMs: number;
9
+ timedOut: boolean;
10
+ command: string;
11
+ }
12
+ export interface RunOptions {
13
+ cwd: string;
14
+ timeoutMs: number;
15
+ env?: NodeJS.ProcessEnv;
16
+ /** Strip known secret-like patterns from captured output. */
17
+ redactSecrets?: boolean;
18
+ }
19
+ /**
20
+ * Run an allowlisted command. Throws CommandPolicyError if not allowed.
21
+ */
22
+ export declare function runAllowedCommand(command: string, options: RunOptions): Promise<RunResult>;
23
+ //# sourceMappingURL=shell.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,SAAS,CAAC,CA6EpB"}