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
package/dist/index.js ADDED
@@ -0,0 +1,86 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * jekyll-component-mcp entry point.
4
+ * stdout is reserved for MCP JSON-RPC. All logging goes to stderr.
5
+ */
6
+ import { serveStdio } from "@modelcontextprotocol/server/stdio";
7
+ import { resolveConfig } from "./config/environment.js";
8
+ import { createContext } from "./server/context.js";
9
+ import { createServer } from "./server/create-server.js";
10
+ import { setLogLevel, logger } from "./utils/logger.js";
11
+ import { PACKAGE_NAME, PACKAGE_VERSION } from "./config/constants.js";
12
+ function parseArgs(argv) {
13
+ const opts = {};
14
+ for (let i = 0; i < argv.length; i++) {
15
+ const a = argv[i];
16
+ if (a === "--root" && argv[i + 1]) {
17
+ opts.root = argv[++i];
18
+ }
19
+ else if (a === "--readonly" || a === "--read-only") {
20
+ opts.writeMode = "read-only";
21
+ }
22
+ else if (a === "--safe-write") {
23
+ opts.writeMode = "safe-write";
24
+ }
25
+ else if (a === "--full-write") {
26
+ opts.writeMode = "full-write";
27
+ }
28
+ else if (a === "--timeout" && argv[i + 1]) {
29
+ opts.timeout = Number(argv[++i]);
30
+ }
31
+ else if (a === "--max-file-size" && argv[i + 1]) {
32
+ opts.maxFileSize = Number(argv[++i]);
33
+ }
34
+ else if (a === "--debug") {
35
+ opts.debug = true;
36
+ }
37
+ else if (a === "--allow-package-manager") {
38
+ opts.allowPackageManager = true;
39
+ }
40
+ else if (a === "--help" || a === "-h") {
41
+ console.error(`
42
+ ${PACKAGE_NAME} v${PACKAGE_VERSION}
43
+
44
+ AI-native MCP server for Jekyll projects and reusable Liquid/SCSS/JS components.
45
+
46
+ Usage:
47
+ jekyll-component-mcp [options]
48
+
49
+ Options:
50
+ --root <path> Project root (or set JEKYLL_PROJECT_ROOT)
51
+ --readonly Write mode: read-only
52
+ --safe-write Write mode: safe-write (default)
53
+ --full-write Write mode: full-write (allows destructive ops)
54
+ --timeout <ms> Build timeout in milliseconds (default 120000)
55
+ --max-file-size <bytes> Max file size for read/write (default 2MiB)
56
+ --debug Enable debug logging to stderr
57
+ --allow-package-manager Allow package-manager commands when implemented
58
+ -h, --help Show this help
59
+
60
+ Security:
61
+ All filesystem access is sandboxed to the project root.
62
+ Commands are allowlisted (jekyll build/clean/doctor only).
63
+ Destructive operations require full-write mode and confirm: true.
64
+ `);
65
+ process.exit(0);
66
+ }
67
+ }
68
+ return opts;
69
+ }
70
+ function main() {
71
+ const cli = parseArgs(process.argv.slice(2));
72
+ const config = resolveConfig(cli);
73
+ if (config.debug) {
74
+ setLogLevel("debug");
75
+ }
76
+ logger.info(`${PACKAGE_NAME} v${PACKAGE_VERSION} starting`, {
77
+ root: config.root,
78
+ writeMode: config.writeMode,
79
+ buildTimeout: config.build.timeout,
80
+ });
81
+ const ctx = createContext(config);
82
+ // serveStdio owns the transport; factory creates a fresh server per connection
83
+ void serveStdio(() => createServer(ctx));
84
+ }
85
+ main();
86
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAmB,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAEtE,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,KAAK,YAAY,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YACrD,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC;QAC/B,CAAC;aAAM,IAAI,CAAC,KAAK,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;QAChC,CAAC;aAAM,IAAI,CAAC,KAAK,cAAc,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC;QAChC,CAAC;aAAM,IAAI,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,CAAC,KAAK,iBAAiB,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,KAAK,yBAAyB,EAAE,CAAC;YAC3C,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;QAClC,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,CAAC,KAAK,CAAC;EAClB,YAAY,KAAK,eAAe;;;;;;;;;;;;;;;;;;;;;;CAsBjC,CAAC,CAAC;YACG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,IAAI;IACX,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAElC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,WAAW,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,KAAK,eAAe,WAAW,EAAE;QAC1D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO;KACnC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAElC,+EAA+E;IAC/E,KAAK,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC"}
@@ -0,0 +1,19 @@
1
+ /**
2
+ * Front matter validation and parsing for Jekyll documents.
3
+ */
4
+ export interface FrontMatterIssue {
5
+ field: string;
6
+ level: "error" | "warning";
7
+ message: string;
8
+ }
9
+ export interface FrontMatterResult {
10
+ data: Record<string, unknown>;
11
+ content: string;
12
+ issues: FrontMatterIssue[];
13
+ valid: boolean;
14
+ }
15
+ /**
16
+ * Validate front matter. Prefer warnings over hard errors for optional fields.
17
+ */
18
+ export declare function validateFrontMatter(source: string): FrontMatterResult;
19
+ //# sourceMappingURL=frontmatter-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/frontmatter-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;CAChB;AAsBD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CA+CrE"}
@@ -0,0 +1,71 @@
1
+ /**
2
+ * Front matter validation and parsing for Jekyll documents.
3
+ */
4
+ import { extractFrontMatter } from "../utils/yaml.js";
5
+ const KNOWN_FIELDS = new Set([
6
+ "title",
7
+ "description",
8
+ "layout",
9
+ "permalink",
10
+ "date",
11
+ "categories",
12
+ "tags",
13
+ "author",
14
+ "image",
15
+ "published",
16
+ "sitemap",
17
+ "robots",
18
+ "excerpt",
19
+ "slug",
20
+ "name",
21
+ "variant",
22
+ "component",
23
+ ]);
24
+ /**
25
+ * Validate front matter. Prefer warnings over hard errors for optional fields.
26
+ */
27
+ export function validateFrontMatter(source) {
28
+ const { data, content } = extractFrontMatter(source);
29
+ const issues = [];
30
+ if (Object.keys(data).length === 0 && source.trimStart().startsWith("---")) {
31
+ issues.push({
32
+ field: "_root",
33
+ level: "warning",
34
+ message: "Front matter block appears present but could not be parsed",
35
+ });
36
+ }
37
+ // Soft checks
38
+ if (data.title !== undefined && typeof data.title !== "string") {
39
+ issues.push({ field: "title", level: "warning", message: "title should be a string" });
40
+ }
41
+ if (data.layout !== undefined && typeof data.layout !== "string") {
42
+ issues.push({ field: "layout", level: "warning", message: "layout should be a string" });
43
+ }
44
+ if (data.date !== undefined) {
45
+ const d = data.date;
46
+ if (!(d instanceof Date) && typeof d !== "string") {
47
+ issues.push({ field: "date", level: "warning", message: "date should be a string or date" });
48
+ }
49
+ }
50
+ if (data.permalink !== undefined && typeof data.permalink !== "string") {
51
+ issues.push({
52
+ field: "permalink",
53
+ level: "warning",
54
+ message: "permalink should be a string",
55
+ });
56
+ }
57
+ // Unknown fields are fine in Jekyll; just note very unusual ones at debug level only
58
+ for (const key of Object.keys(data)) {
59
+ if (!KNOWN_FIELDS.has(key) && key.startsWith("_")) {
60
+ // ignore private
61
+ }
62
+ }
63
+ const hasErrors = issues.some((i) => i.level === "error");
64
+ return {
65
+ data,
66
+ content,
67
+ issues,
68
+ valid: !hasErrors,
69
+ };
70
+ }
71
+ //# sourceMappingURL=frontmatter-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frontmatter-parser.js","sourceRoot":"","sources":["../../src/parsers/frontmatter-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAetD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,OAAO;IACP,aAAa;IACb,QAAQ;IACR,WAAW;IACX,MAAM;IACN,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,OAAO;IACP,WAAW;IACX,SAAS;IACT,QAAQ;IACR,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,MAAM,GAAuB,EAAE,CAAC;IAEtC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,OAAO;YACd,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,4DAA4D;SACtE,CAAC,CAAC;IACL,CAAC;IAED,cAAc;IACd,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;IAC3F,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC;YACV,KAAK,EAAE,WAAW;YAClB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,qFAAqF;IACrF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClD,iBAAiB;QACnB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC;IAC1D,OAAO;QACL,IAAI;QACJ,OAAO;QACP,MAAM;QACN,KAAK,EAAE,CAAC,SAAS;KAClB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * Liquid source analysis (never executes Liquid).
3
+ * Detects include parameters, variants, and basic structural patterns.
4
+ */
5
+ export interface LiquidParameter {
6
+ name: string;
7
+ usageCount: number;
8
+ examples: string[];
9
+ }
10
+ export interface LiquidAnalysis {
11
+ parameters: LiquidParameter[];
12
+ hasCapture: boolean;
13
+ hasIf: boolean;
14
+ hasFor: boolean;
15
+ hasInclude: boolean;
16
+ hasAssign: boolean;
17
+ classNames: string[];
18
+ idAttributes: string[];
19
+ interactiveElements: string[];
20
+ accessibilityHints: string[];
21
+ }
22
+ /**
23
+ * Analyze Liquid component source for metadata useful to agents.
24
+ */
25
+ export declare function analyzeLiquid(source: string): LiquidAnalysis;
26
+ /**
27
+ * Basic Liquid syntax pattern checks (not a full parser).
28
+ */
29
+ export declare function checkLiquidSyntax(source: string): {
30
+ errors: string[];
31
+ warnings: string[];
32
+ };
33
+ //# sourceMappingURL=liquid-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liquid-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/liquid-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AASD;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAoE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB1F"}
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Liquid source analysis (never executes Liquid).
3
+ * Detects include parameters, variants, and basic structural patterns.
4
+ */
5
+ const INCLUDE_PARAM_RE = /include\.([a-zA-Z_][a-zA-Z0-9_]*)/g;
6
+ const CLASS_RE = /class\s*=\s*["']([^"']+)["']/gi;
7
+ const ID_RE = /\bid\s*=\s*["']([^"']+)["']/gi;
8
+ const INTERACTIVE_RE = /<(button|a|input|select|textarea|details|summary)\b/gi;
9
+ const ARIA_RE = /\baria-[a-z-]+\s*=/gi;
10
+ const ROLE_RE = /\brole\s*=\s*["']([^"']+)["']/gi;
11
+ /**
12
+ * Analyze Liquid component source for metadata useful to agents.
13
+ */
14
+ export function analyzeLiquid(source) {
15
+ const paramMap = new Map();
16
+ let m;
17
+ const paramRe = new RegExp(INCLUDE_PARAM_RE.source, "g");
18
+ while ((m = paramRe.exec(source)) !== null) {
19
+ const name = m[1];
20
+ const entry = paramMap.get(name) ?? { count: 0, examples: [] };
21
+ entry.count += 1;
22
+ if (entry.examples.length < 3) {
23
+ const start = Math.max(0, m.index - 20);
24
+ const end = Math.min(source.length, m.index + m[0].length + 20);
25
+ entry.examples.push(source.slice(start, end).replace(/\s+/g, " ").trim());
26
+ }
27
+ paramMap.set(name, entry);
28
+ }
29
+ const parameters = [...paramMap.entries()]
30
+ .map(([name, v]) => ({ name, usageCount: v.count, examples: v.examples }))
31
+ .sort((a, b) => b.usageCount - a.usageCount);
32
+ const classNames = new Set();
33
+ const classRe = new RegExp(CLASS_RE.source, "gi");
34
+ while ((m = classRe.exec(source)) !== null) {
35
+ for (const c of m[1].split(/\s+/)) {
36
+ if (c)
37
+ classNames.add(c);
38
+ }
39
+ }
40
+ const idAttributes = new Set();
41
+ const idRe = new RegExp(ID_RE.source, "gi");
42
+ while ((m = idRe.exec(source)) !== null) {
43
+ if (m[1])
44
+ idAttributes.add(m[1]);
45
+ }
46
+ const interactiveElements = new Set();
47
+ const intRe = new RegExp(INTERACTIVE_RE.source, "gi");
48
+ while ((m = intRe.exec(source)) !== null) {
49
+ interactiveElements.add(m[1].toLowerCase());
50
+ }
51
+ const accessibilityHints = [];
52
+ if (interactiveElements.size > 0) {
53
+ const hasAria = ARIA_RE.test(source) || ROLE_RE.test(source);
54
+ if (!hasAria) {
55
+ accessibilityHints.push("Interactive elements present; consider ARIA attributes and keyboard support");
56
+ }
57
+ if (interactiveElements.has("button") || interactiveElements.has("a")) {
58
+ if (!/tabindex|@keydown|onkeydown|keyboard/i.test(source)) {
59
+ accessibilityHints.push("Interactive component may lack explicit keyboard behavior");
60
+ }
61
+ }
62
+ }
63
+ return {
64
+ parameters,
65
+ hasCapture: /\{\%\s*capture\b/.test(source),
66
+ hasIf: /\{\%\s*if\b/.test(source),
67
+ hasFor: /\{\%\s*for\b/.test(source),
68
+ hasInclude: /\{\%\s*include\b/.test(source),
69
+ hasAssign: /\{\%\s*assign\b/.test(source),
70
+ classNames: [...classNames],
71
+ idAttributes: [...idAttributes],
72
+ interactiveElements: [...interactiveElements],
73
+ accessibilityHints,
74
+ };
75
+ }
76
+ /**
77
+ * Basic Liquid syntax pattern checks (not a full parser).
78
+ */
79
+ export function checkLiquidSyntax(source) {
80
+ const errors = [];
81
+ const warnings = [];
82
+ const openTags = (source.match(/\{\%/g) ?? []).length;
83
+ const closeTags = (source.match(/\%\}/g) ?? []).length;
84
+ if (openTags !== closeTags) {
85
+ errors.push(`Unbalanced Liquid tags: ${openTags} opening vs ${closeTags} closing`);
86
+ }
87
+ const openOutput = (source.match(/\{\{/g) ?? []).length;
88
+ const closeOutput = (source.match(/\}\}/g) ?? []).length;
89
+ if (openOutput !== closeOutput) {
90
+ errors.push(`Unbalanced Liquid output: ${openOutput} opening vs ${closeOutput} closing`);
91
+ }
92
+ // Detect common mistakes
93
+ if (/\{\%\s*end(?!if|for|capture|unless|case|comment|raw|tablerow|paginate)\w*/.test(source)) {
94
+ warnings.push("Possible misspelled end tag");
95
+ }
96
+ return { errors, warnings };
97
+ }
98
+ //# sourceMappingURL=liquid-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"liquid-parser.js","sourceRoot":"","sources":["../../src/parsers/liquid-parser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Structured project architecture scan for Jekyll + component framework.
3
+ */
4
+ import type { McpConfig } from "../config/environment.js";
5
+ export interface ProjectScanResult {
6
+ root: string;
7
+ jekyll: boolean;
8
+ configFiles: string[];
9
+ directories: Record<string, boolean>;
10
+ layouts: string[];
11
+ includes: string[];
12
+ components: Array<{
13
+ name: string;
14
+ liquid?: string;
15
+ scss?: string;
16
+ javascript?: string;
17
+ documentation?: string;
18
+ example?: string;
19
+ }>;
20
+ sections: string[];
21
+ scssFiles: string[];
22
+ jsFiles: string[];
23
+ docsFiles: string[];
24
+ hasBundler: boolean;
25
+ hasPackageJson: boolean;
26
+ }
27
+ export declare function scanProject(config: McpConfig): ProjectScanResult;
28
+ export declare function detectScssArchitecture(root: string, scssRoot: string): string[];
29
+ //# sourceMappingURL=project-scanner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-scanner.d.ts","sourceRoot":"","sources":["../../src/parsers/project-scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAI1D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAyBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,GAAG,iBAAiB,CAiJhE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAmC/E"}
@@ -0,0 +1,194 @@
1
+ /**
2
+ * Structured project architecture scan for Jekyll + component framework.
3
+ */
4
+ import path from "node:path";
5
+ import { safeExists, safeReadDir, safeWalk } from "../utils/filesystem.js";
6
+ import { resolveSafePath, toRelative } from "../security/path-policy.js";
7
+ function listHtmlIn(root, relDir, maxDepth = 4) {
8
+ if (!safeExists(root, relDir))
9
+ return [];
10
+ const out = [];
11
+ for (const entry of safeWalk(root, relDir, { maxDepth, extensions: [".html", ".liquid"] })) {
12
+ if (!entry.isDirectory)
13
+ out.push(entry.relativePath);
14
+ }
15
+ return out;
16
+ }
17
+ function listScss(root, relDir, maxDepth = 6) {
18
+ if (!safeExists(root, relDir))
19
+ return [];
20
+ const out = [];
21
+ for (const entry of safeWalk(root, relDir, { maxDepth, extensions: [".scss", ".sass", ".css"] })) {
22
+ if (!entry.isDirectory)
23
+ out.push(entry.relativePath);
24
+ }
25
+ return out;
26
+ }
27
+ function componentNameFromPath(filePath) {
28
+ const base = path.basename(filePath, path.extname(filePath));
29
+ return base.replace(/^_/, "").toLowerCase();
30
+ }
31
+ export function scanProject(config) {
32
+ const { root, paths } = config;
33
+ const configFiles = [];
34
+ for (const name of ["_config.yml", "_config.yaml", "_config.toml", "config.yml"]) {
35
+ if (safeExists(root, name))
36
+ configFiles.push(name);
37
+ }
38
+ const directories = {
39
+ _layouts: safeExists(root, paths.layouts),
40
+ _includes: safeExists(root, paths.includes),
41
+ _data: safeExists(root, paths.data),
42
+ _posts: safeExists(root, paths.posts),
43
+ _sass: safeExists(root, paths.sass),
44
+ assets: safeExists(root, paths.assets),
45
+ docs: safeExists(root, paths.docs),
46
+ examples: safeExists(root, paths.examples),
47
+ _site: safeExists(root, paths.site),
48
+ components: safeExists(root, paths.components),
49
+ sections: safeExists(root, paths.sections),
50
+ scss: safeExists(root, paths.scss),
51
+ };
52
+ const layouts = listHtmlIn(root, paths.layouts);
53
+ const includes = listHtmlIn(root, paths.includes, 5);
54
+ // Components under _includes/components or configured path
55
+ const componentLiquid = listHtmlIn(root, paths.components, 3);
56
+ const componentMap = new Map();
57
+ for (const f of componentLiquid) {
58
+ const name = componentNameFromPath(f);
59
+ componentMap.set(name, { name, liquid: f });
60
+ }
61
+ // SCSS components
62
+ const scssComponents = listScss(root, paths.scssComponents ?? path.join(paths.scss, "components"), 3);
63
+ for (const f of scssComponents) {
64
+ const name = componentNameFromPath(f);
65
+ const existing = componentMap.get(name) ?? { name };
66
+ existing.scss = f;
67
+ componentMap.set(name, existing);
68
+ }
69
+ // Also scan main scss for component-like files
70
+ const allScss = listScss(root, paths.scss, 5);
71
+ for (const f of allScss) {
72
+ if (f.includes("components/") || f.includes("component")) {
73
+ const name = componentNameFromPath(f);
74
+ if (!componentMap.has(name)) {
75
+ componentMap.set(name, { name, scss: f });
76
+ }
77
+ }
78
+ }
79
+ // JS components
80
+ if (safeExists(root, paths.jsComponents)) {
81
+ for (const entry of safeWalk(root, paths.jsComponents, {
82
+ maxDepth: 3,
83
+ extensions: [".js", ".ts", ".mjs"],
84
+ })) {
85
+ if (entry.isDirectory)
86
+ continue;
87
+ const name = componentNameFromPath(entry.relativePath);
88
+ const existing = componentMap.get(name) ?? { name };
89
+ existing.javascript = entry.relativePath;
90
+ componentMap.set(name, existing);
91
+ }
92
+ }
93
+ // Docs
94
+ if (safeExists(root, paths.docsComponents)) {
95
+ for (const entry of safeWalk(root, paths.docsComponents, {
96
+ maxDepth: 3,
97
+ extensions: [".md", ".markdown", ".html"],
98
+ })) {
99
+ if (entry.isDirectory)
100
+ continue;
101
+ const name = componentNameFromPath(entry.relativePath);
102
+ const existing = componentMap.get(name) ?? { name };
103
+ existing.documentation = entry.relativePath;
104
+ componentMap.set(name, existing);
105
+ }
106
+ }
107
+ // Examples
108
+ if (safeExists(root, paths.examplesComponents)) {
109
+ for (const entry of safeWalk(root, paths.examplesComponents, {
110
+ maxDepth: 3,
111
+ extensions: [".html", ".md"],
112
+ })) {
113
+ if (entry.isDirectory)
114
+ continue;
115
+ const name = componentNameFromPath(entry.relativePath);
116
+ const existing = componentMap.get(name) ?? { name };
117
+ existing.example = entry.relativePath;
118
+ componentMap.set(name, existing);
119
+ }
120
+ }
121
+ const sections = listHtmlIn(root, paths.sections, 3).map(componentNameFromPath);
122
+ const jsFiles = [];
123
+ if (safeExists(root, paths.js)) {
124
+ for (const entry of safeWalk(root, paths.js, { maxDepth: 5, extensions: [".js", ".ts", ".mjs"] })) {
125
+ if (!entry.isDirectory)
126
+ jsFiles.push(entry.relativePath);
127
+ }
128
+ }
129
+ const docsFiles = [];
130
+ if (safeExists(root, paths.docs)) {
131
+ for (const entry of safeWalk(root, paths.docs, {
132
+ maxDepth: 5,
133
+ extensions: [".md", ".markdown", ".html"],
134
+ })) {
135
+ if (!entry.isDirectory)
136
+ docsFiles.push(entry.relativePath);
137
+ }
138
+ }
139
+ const hasBundler = safeExists(root, "Gemfile") || safeExists(root, "Gemfile.lock");
140
+ const hasPackageJson = safeExists(root, "package.json");
141
+ return {
142
+ root,
143
+ jekyll: configFiles.length > 0 || directories._layouts || directories._includes,
144
+ configFiles,
145
+ directories,
146
+ layouts: layouts.map((f) => toRelative(root, resolveSafePath(root, f))),
147
+ includes: includes.map((f) => toRelative(root, resolveSafePath(root, f))),
148
+ components: [...componentMap.values()].sort((a, b) => a.name.localeCompare(b.name)),
149
+ sections,
150
+ scssFiles: allScss,
151
+ jsFiles,
152
+ docsFiles,
153
+ hasBundler,
154
+ hasPackageJson,
155
+ };
156
+ }
157
+ export function detectScssArchitecture(root, scssRoot) {
158
+ const layers = [];
159
+ const candidates = [
160
+ "tokens",
161
+ "abstracts",
162
+ "variables",
163
+ "mixins",
164
+ "functions",
165
+ "base",
166
+ "vendors",
167
+ "utilities",
168
+ "components",
169
+ "sections",
170
+ "layout",
171
+ "pages",
172
+ "themes",
173
+ ];
174
+ for (const c of candidates) {
175
+ if (safeExists(root, path.join(scssRoot, c)) || safeExists(root, path.join(scssRoot, `_${c}`))) {
176
+ layers.push(c);
177
+ }
178
+ }
179
+ // Also check for files
180
+ try {
181
+ const entries = safeReadDir(root, scssRoot);
182
+ for (const e of entries) {
183
+ const name = e.replace(/^_/, "").replace(/\.(scss|sass)$/, "");
184
+ if (candidates.includes(name) && !layers.includes(name)) {
185
+ layers.push(name);
186
+ }
187
+ }
188
+ }
189
+ catch {
190
+ /* ignore */
191
+ }
192
+ return layers;
193
+ }
194
+ //# sourceMappingURL=project-scanner.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-scanner.js","sourceRoot":"","sources":["../../src/parsers/project-scanner.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ /**
2
+ * SCSS source analysis for design tokens, imports, and architecture.
3
+ */
4
+ export interface ScssToken {
5
+ name: string;
6
+ value: string;
7
+ category: string;
8
+ line?: number;
9
+ }
10
+ export interface ScssAnalysis {
11
+ imports: string[];
12
+ variables: ScssToken[];
13
+ cssCustomProperties: ScssToken[];
14
+ mixins: string[];
15
+ selectors: string[];
16
+ usesForward: boolean;
17
+ }
18
+ export declare function analyzeScss(source: string): ScssAnalysis;
19
+ /**
20
+ * Detect whether a component SCSS file is already imported in an entry point.
21
+ */
22
+ export declare function findImportForComponent(entrySource: string, componentName: string): {
23
+ present: boolean;
24
+ line?: string;
25
+ };
26
+ //# sourceMappingURL=scss-parser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scss-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/scss-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,mBAAmB,EAAE,SAAS,EAAE,CAAC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB;AAqBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAgDxD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAarC"}