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.
- package/.github/skills/.gitkeep +0 -0
- package/.github/skills/jekyll-component-mcp/SKILL.md +98 -0
- package/CHANGELOG.md +18 -0
- package/LICENSE +21 -0
- package/README.md +167 -2
- package/dist/config/constants.d.ts +46 -0
- package/dist/config/constants.d.ts.map +1 -0
- package/dist/config/constants.js +75 -0
- package/dist/config/constants.js.map +1 -0
- package/dist/config/environment.d.ts +51 -0
- package/dist/config/environment.d.ts.map +1 -0
- package/dist/config/environment.js +102 -0
- package/dist/config/environment.js.map +1 -0
- package/dist/index.d.ts +7 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +86 -0
- package/dist/index.js.map +1 -0
- package/dist/parsers/frontmatter-parser.d.ts +19 -0
- package/dist/parsers/frontmatter-parser.d.ts.map +1 -0
- package/dist/parsers/frontmatter-parser.js +71 -0
- package/dist/parsers/frontmatter-parser.js.map +1 -0
- package/dist/parsers/liquid-parser.d.ts +33 -0
- package/dist/parsers/liquid-parser.d.ts.map +1 -0
- package/dist/parsers/liquid-parser.js +98 -0
- package/dist/parsers/liquid-parser.js.map +1 -0
- package/dist/parsers/project-scanner.d.ts +29 -0
- package/dist/parsers/project-scanner.d.ts.map +1 -0
- package/dist/parsers/project-scanner.js +194 -0
- package/dist/parsers/project-scanner.js.map +1 -0
- package/dist/parsers/scss-parser.d.ts +26 -0
- package/dist/parsers/scss-parser.d.ts.map +1 -0
- package/dist/parsers/scss-parser.js +90 -0
- package/dist/parsers/scss-parser.js.map +1 -0
- package/dist/security/command-policy.d.ts +21 -0
- package/dist/security/command-policy.d.ts.map +1 -0
- package/dist/security/command-policy.js +48 -0
- package/dist/security/command-policy.js.map +1 -0
- package/dist/security/path-policy.d.ts +31 -0
- package/dist/security/path-policy.d.ts.map +1 -0
- package/dist/security/path-policy.js +127 -0
- package/dist/security/path-policy.js.map +1 -0
- package/dist/security/validation.d.ts +18 -0
- package/dist/security/validation.d.ts.map +1 -0
- package/dist/security/validation.js +59 -0
- package/dist/security/validation.js.map +1 -0
- package/dist/server/context.d.ts +18 -0
- package/dist/server/context.d.ts.map +1 -0
- package/dist/server/context.js +34 -0
- package/dist/server/context.js.map +1 -0
- package/dist/server/create-server.d.ts +8 -0
- package/dist/server/create-server.d.ts.map +1 -0
- package/dist/server/create-server.js +546 -0
- package/dist/server/create-server.js.map +1 -0
- package/dist/services/build-service.d.ts +27 -0
- package/dist/services/build-service.d.ts.map +1 -0
- package/dist/services/build-service.js +85 -0
- package/dist/services/build-service.js.map +1 -0
- package/dist/services/component-service.d.ts +74 -0
- package/dist/services/component-service.d.ts.map +1 -0
- package/dist/services/component-service.js +422 -0
- package/dist/services/component-service.js.map +1 -0
- package/dist/services/documentation-service.d.ts +64 -0
- package/dist/services/documentation-service.d.ts.map +1 -0
- package/dist/services/documentation-service.js +186 -0
- package/dist/services/documentation-service.js.map +1 -0
- package/dist/services/liquid-service.d.ts +31 -0
- package/dist/services/liquid-service.d.ts.map +1 -0
- package/dist/services/liquid-service.js +103 -0
- package/dist/services/liquid-service.js.map +1 -0
- package/dist/services/project-service.d.ts +30 -0
- package/dist/services/project-service.d.ts.map +1 -0
- package/dist/services/project-service.js +102 -0
- package/dist/services/project-service.js.map +1 -0
- package/dist/services/scss-service.d.ts +37 -0
- package/dist/services/scss-service.d.ts.map +1 -0
- package/dist/services/scss-service.js +82 -0
- package/dist/services/scss-service.js.map +1 -0
- package/dist/services/token-service.d.ts +29 -0
- package/dist/services/token-service.d.ts.map +1 -0
- package/dist/services/token-service.js +97 -0
- package/dist/services/token-service.js.map +1 -0
- package/dist/services/validation-service.d.ts +33 -0
- package/dist/services/validation-service.d.ts.map +1 -0
- package/dist/services/validation-service.js +101 -0
- package/dist/services/validation-service.js.map +1 -0
- package/dist/utils/filesystem.d.ts +38 -0
- package/dist/utils/filesystem.d.ts.map +1 -0
- package/dist/utils/filesystem.js +131 -0
- package/dist/utils/filesystem.js.map +1 -0
- package/dist/utils/json.d.ts +6 -0
- package/dist/utils/json.d.ts.map +1 -0
- package/dist/utils/json.js +20 -0
- package/dist/utils/json.js.map +1 -0
- package/dist/utils/logger.d.ts +14 -0
- package/dist/utils/logger.d.ts.map +1 -0
- package/dist/utils/logger.js +58 -0
- package/dist/utils/logger.js.map +1 -0
- package/dist/utils/shell.d.ts +23 -0
- package/dist/utils/shell.d.ts.map +1 -0
- package/dist/utils/shell.js +96 -0
- package/dist/utils/shell.js.map +1 -0
- package/dist/utils/yaml.d.ts +15 -0
- package/dist/utils/yaml.d.ts.map +1 -0
- package/dist/utils/yaml.js +34 -0
- package/dist/utils/yaml.js.map +1 -0
- package/package.json +65 -4
- package/skills/SKILL.md +98 -0
|
@@ -0,0 +1,90 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* SCSS source analysis for design tokens, imports, and architecture.
|
|
3
|
+
*/
|
|
4
|
+
const IMPORT_RE = /@(?:import|use|forward)\s+["']([^"']+)["']/g;
|
|
5
|
+
const VAR_RE = /(\$[\w-]+)\s*:\s*([^;]+);/g;
|
|
6
|
+
const CSS_VAR_RE = /(--[\w-]+)\s*:\s*([^;]+);/g;
|
|
7
|
+
const MIXIN_RE = /@mixin\s+([\w-]+)/g;
|
|
8
|
+
const SELECTOR_RE = /^\s*([.#][\w-]+(?:\s*[.#][\w-]+)*)\s*\{/gm;
|
|
9
|
+
function categorizeToken(name) {
|
|
10
|
+
const n = name.toLowerCase();
|
|
11
|
+
if (/color|colour|bg|background|fill|stroke|text-/.test(n))
|
|
12
|
+
return "color";
|
|
13
|
+
if (/space|spacing|gap|margin|padding|inset/.test(n))
|
|
14
|
+
return "spacing";
|
|
15
|
+
if (/radius|rounded|corner/.test(n))
|
|
16
|
+
return "radius";
|
|
17
|
+
if (/shadow|elevation/.test(n))
|
|
18
|
+
return "shadow";
|
|
19
|
+
if (/font|type|text-|line-height|letter/.test(n))
|
|
20
|
+
return "typography";
|
|
21
|
+
if (/break|media|screen|container|viewport/.test(n))
|
|
22
|
+
return "breakpoints";
|
|
23
|
+
if (/motion|transition|duration|easing|animation/.test(n))
|
|
24
|
+
return "motion";
|
|
25
|
+
if (/z-index|layer/.test(n))
|
|
26
|
+
return "z-index";
|
|
27
|
+
return "other";
|
|
28
|
+
}
|
|
29
|
+
export function analyzeScss(source) {
|
|
30
|
+
const imports = [];
|
|
31
|
+
let m;
|
|
32
|
+
const importRe = new RegExp(IMPORT_RE.source, "g");
|
|
33
|
+
while ((m = importRe.exec(source)) !== null) {
|
|
34
|
+
imports.push(m[1]);
|
|
35
|
+
}
|
|
36
|
+
const variables = [];
|
|
37
|
+
const varRe = new RegExp(VAR_RE.source, "g");
|
|
38
|
+
while ((m = varRe.exec(source)) !== null) {
|
|
39
|
+
variables.push({
|
|
40
|
+
name: m[1],
|
|
41
|
+
value: m[2].trim(),
|
|
42
|
+
category: categorizeToken(m[1]),
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
const cssCustomProperties = [];
|
|
46
|
+
const cssRe = new RegExp(CSS_VAR_RE.source, "g");
|
|
47
|
+
while ((m = cssRe.exec(source)) !== null) {
|
|
48
|
+
cssCustomProperties.push({
|
|
49
|
+
name: m[1],
|
|
50
|
+
value: m[2].trim(),
|
|
51
|
+
category: categorizeToken(m[1]),
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
const mixins = [];
|
|
55
|
+
const mixinRe = new RegExp(MIXIN_RE.source, "g");
|
|
56
|
+
while ((m = mixinRe.exec(source)) !== null) {
|
|
57
|
+
mixins.push(m[1]);
|
|
58
|
+
}
|
|
59
|
+
const selectors = [];
|
|
60
|
+
const selRe = new RegExp(SELECTOR_RE.source, "gm");
|
|
61
|
+
while ((m = selRe.exec(source)) !== null) {
|
|
62
|
+
selectors.push(m[1].trim());
|
|
63
|
+
}
|
|
64
|
+
return {
|
|
65
|
+
imports,
|
|
66
|
+
variables,
|
|
67
|
+
cssCustomProperties,
|
|
68
|
+
mixins,
|
|
69
|
+
selectors,
|
|
70
|
+
usesForward: /@forward\b/.test(source),
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
/**
|
|
74
|
+
* Detect whether a component SCSS file is already imported in an entry point.
|
|
75
|
+
*/
|
|
76
|
+
export function findImportForComponent(entrySource, componentName) {
|
|
77
|
+
const patterns = [
|
|
78
|
+
new RegExp(`["']components[/._]?${componentName}["']`),
|
|
79
|
+
new RegExp(`["'][^"']*${componentName}["']`),
|
|
80
|
+
new RegExp(`@import\\s+["'].*${componentName}`),
|
|
81
|
+
new RegExp(`@use\\s+["'].*${componentName}`),
|
|
82
|
+
];
|
|
83
|
+
for (const re of patterns) {
|
|
84
|
+
if (re.test(entrySource)) {
|
|
85
|
+
return { present: true };
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
return { present: false };
|
|
89
|
+
}
|
|
90
|
+
//# sourceMappingURL=scss-parser.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scss-parser.js","sourceRoot":"","sources":["../../src/parsers/scss-parser.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Allowlisted command runner. Never execute arbitrary model-supplied shell.
|
|
3
|
+
*/
|
|
4
|
+
export declare class CommandPolicyError extends Error {
|
|
5
|
+
readonly details: Record<string, unknown>;
|
|
6
|
+
readonly code = "COMMAND_NOT_ALLOWED";
|
|
7
|
+
constructor(message: string, details?: Record<string, unknown>);
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Validate that a command string is on the allowlist and contains no forbidden tokens.
|
|
11
|
+
*/
|
|
12
|
+
export declare function assertAllowedCommand(command: string): void;
|
|
13
|
+
/**
|
|
14
|
+
* Build a safe argv array for the given allowlisted command string.
|
|
15
|
+
* Returns { cmd, args } suitable for child_process.spawn.
|
|
16
|
+
*/
|
|
17
|
+
export declare function parseAllowedCommand(command: string): {
|
|
18
|
+
cmd: string;
|
|
19
|
+
args: string[];
|
|
20
|
+
};
|
|
21
|
+
//# sourceMappingURL=command-policy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-policy.d.ts","sourceRoot":"","sources":["../../src/security/command-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,qBAAa,kBAAmB,SAAQ,KAAK;aAIzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHlD,QAAQ,CAAC,IAAI,yBAAyB;gBAEpC,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKxD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAuB1D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAMpF"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Allowlisted command runner. Never execute arbitrary model-supplied shell.
|
|
3
|
+
*/
|
|
4
|
+
import { ALLOWED_BUILD_COMMANDS, FORBIDDEN_COMMAND_TOKENS } from "../config/constants.js";
|
|
5
|
+
import { logger } from "../utils/logger.js";
|
|
6
|
+
export class CommandPolicyError extends Error {
|
|
7
|
+
details;
|
|
8
|
+
code = "COMMAND_NOT_ALLOWED";
|
|
9
|
+
constructor(message, details = {}) {
|
|
10
|
+
super(message);
|
|
11
|
+
this.details = details;
|
|
12
|
+
this.name = "CommandPolicyError";
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Validate that a command string is on the allowlist and contains no forbidden tokens.
|
|
17
|
+
*/
|
|
18
|
+
export function assertAllowedCommand(command) {
|
|
19
|
+
const normalized = command.trim().replace(/\s+/g, " ");
|
|
20
|
+
// Exact match against allowlist (case-sensitive for predictability)
|
|
21
|
+
const allowed = ALLOWED_BUILD_COMMANDS.includes(normalized);
|
|
22
|
+
if (!allowed) {
|
|
23
|
+
logger.warn("Blocked non-allowlisted command", { command: normalized });
|
|
24
|
+
throw new CommandPolicyError(`Command is not on the allowlist: "${normalized}". Only Jekyll build/clean/doctor commands are permitted.`, { command: normalized, allowed: [...ALLOWED_BUILD_COMMANDS] });
|
|
25
|
+
}
|
|
26
|
+
// Defense-in-depth: reject any forbidden tokens even if somehow allowlisted
|
|
27
|
+
const lower = normalized.toLowerCase();
|
|
28
|
+
for (const token of FORBIDDEN_COMMAND_TOKENS) {
|
|
29
|
+
if (lower.includes(token.toLowerCase())) {
|
|
30
|
+
throw new CommandPolicyError(`Command contains forbidden token: ${token}`, {
|
|
31
|
+
command: normalized,
|
|
32
|
+
token,
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
/**
|
|
38
|
+
* Build a safe argv array for the given allowlisted command string.
|
|
39
|
+
* Returns { cmd, args } suitable for child_process.spawn.
|
|
40
|
+
*/
|
|
41
|
+
export function parseAllowedCommand(command) {
|
|
42
|
+
assertAllowedCommand(command);
|
|
43
|
+
const parts = command.trim().split(/\s+/);
|
|
44
|
+
const cmd = parts[0];
|
|
45
|
+
const args = parts.slice(1);
|
|
46
|
+
return { cmd, args };
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=command-policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"command-policy.js","sourceRoot":"","sources":["../../src/security/command-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAIzB;IAHT,IAAI,GAAG,qBAAqB,CAAC;IACtC,YACE,OAAe,EACC,UAAmC,EAAE;QAErD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAA8B;QAGrD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEvD,oEAAoE;IACpE,MAAM,OAAO,GAAI,sBAA4C,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QACxE,MAAM,IAAI,kBAAkB,CAC1B,qCAAqC,UAAU,2DAA2D,EAC1G,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,GAAG,sBAAsB,CAAC,EAAE,CAC9D,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,wBAAwB,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,kBAAkB,CAAC,qCAAqC,KAAK,EAAE,EAAE;gBACzE,OAAO,EAAE,UAAU;gBACnB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IACtB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Path sandbox: every filesystem operation must stay inside the project root.
|
|
3
|
+
* Prevents path traversal, absolute path escape, and symlink escape.
|
|
4
|
+
*/
|
|
5
|
+
export declare class PathEscapeError extends Error {
|
|
6
|
+
readonly details: Record<string, unknown>;
|
|
7
|
+
readonly code = "PROJECT_ROOT_ESCAPE";
|
|
8
|
+
constructor(message: string, details?: Record<string, unknown>);
|
|
9
|
+
}
|
|
10
|
+
/**
|
|
11
|
+
* Resolve and canonicalize the project root. Must be an existing directory.
|
|
12
|
+
*/
|
|
13
|
+
export declare function resolveProjectRoot(rawRoot: string): string;
|
|
14
|
+
/**
|
|
15
|
+
* Resolve a path relative to root and ensure it stays inside the root.
|
|
16
|
+
* Rejects absolute paths that escape, `..` traversal, and symlink escapes.
|
|
17
|
+
*
|
|
18
|
+
* @param root Absolute canonical project root
|
|
19
|
+
* @param relativePath User-supplied path (relative preferred; absolute only if under root)
|
|
20
|
+
* @returns Absolute path that is guaranteed to be under root
|
|
21
|
+
*/
|
|
22
|
+
export declare function resolveSafePath(root: string, relativePath: string): string;
|
|
23
|
+
/**
|
|
24
|
+
* Return a path relative to root for display/logging (never absolute).
|
|
25
|
+
*/
|
|
26
|
+
export declare function toRelative(root: string, absolutePath: string): string;
|
|
27
|
+
/**
|
|
28
|
+
* Check whether a path (already resolved) is inside root.
|
|
29
|
+
*/
|
|
30
|
+
export declare function isInsideRoot(root: string, absolutePath: string): boolean;
|
|
31
|
+
//# sourceMappingURL=path-policy.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"path-policy.d.ts","sourceRoot":"","sources":["../../src/security/path-policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,qBAAa,eAAgB,SAAQ,KAAK;aAItB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHlD,QAAQ,CAAC,IAAI,yBAAyB;gBAEpC,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgB1D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAwC1E;AAmCD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAGxE"}
|
|
@@ -0,0 +1,127 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Path sandbox: every filesystem operation must stay inside the project root.
|
|
3
|
+
* Prevents path traversal, absolute path escape, and symlink escape.
|
|
4
|
+
*/
|
|
5
|
+
import fs from "node:fs";
|
|
6
|
+
import path from "node:path";
|
|
7
|
+
import { logger } from "../utils/logger.js";
|
|
8
|
+
export class PathEscapeError extends Error {
|
|
9
|
+
details;
|
|
10
|
+
code = "PROJECT_ROOT_ESCAPE";
|
|
11
|
+
constructor(message, details = {}) {
|
|
12
|
+
super(message);
|
|
13
|
+
this.details = details;
|
|
14
|
+
this.name = "PathEscapeError";
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Resolve and canonicalize the project root. Must be an existing directory.
|
|
19
|
+
*/
|
|
20
|
+
export function resolveProjectRoot(rawRoot) {
|
|
21
|
+
const resolved = path.resolve(rawRoot);
|
|
22
|
+
let real;
|
|
23
|
+
try {
|
|
24
|
+
real = fs.realpathSync(resolved);
|
|
25
|
+
}
|
|
26
|
+
catch (err) {
|
|
27
|
+
throw new PathEscapeError(`Project root does not exist or is not accessible: ${resolved}`, {
|
|
28
|
+
root: resolved,
|
|
29
|
+
cause: String(err),
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
const stat = fs.statSync(real);
|
|
33
|
+
if (!stat.isDirectory()) {
|
|
34
|
+
throw new PathEscapeError(`Project root is not a directory: ${real}`, { root: real });
|
|
35
|
+
}
|
|
36
|
+
return real;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Resolve a path relative to root and ensure it stays inside the root.
|
|
40
|
+
* Rejects absolute paths that escape, `..` traversal, and symlink escapes.
|
|
41
|
+
*
|
|
42
|
+
* @param root Absolute canonical project root
|
|
43
|
+
* @param relativePath User-supplied path (relative preferred; absolute only if under root)
|
|
44
|
+
* @returns Absolute path that is guaranteed to be under root
|
|
45
|
+
*/
|
|
46
|
+
export function resolveSafePath(root, relativePath) {
|
|
47
|
+
if (relativePath == null || relativePath === "") {
|
|
48
|
+
throw new PathEscapeError("Path must not be empty", { path: relativePath });
|
|
49
|
+
}
|
|
50
|
+
// Normalize separators and reject null bytes
|
|
51
|
+
const cleaned = relativePath.replace(/\0/g, "").replace(/\\/g, "/");
|
|
52
|
+
// Disallow absolute paths that are not under root (we re-resolve below)
|
|
53
|
+
const candidate = path.isAbsolute(cleaned)
|
|
54
|
+
? path.normalize(cleaned)
|
|
55
|
+
: path.resolve(root, cleaned);
|
|
56
|
+
// Canonicalize if the path already exists (follow symlinks)
|
|
57
|
+
let realCandidate;
|
|
58
|
+
try {
|
|
59
|
+
if (fs.existsSync(candidate)) {
|
|
60
|
+
realCandidate = fs.realpathSync(candidate);
|
|
61
|
+
}
|
|
62
|
+
else {
|
|
63
|
+
// For non-existent paths, resolve the nearest existing ancestor and join remainder
|
|
64
|
+
realCandidate = resolveNonExistentUnderRoot(root, candidate);
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
catch (err) {
|
|
68
|
+
throw new PathEscapeError(`Failed to resolve path safely: ${candidate}`, {
|
|
69
|
+
path: candidate,
|
|
70
|
+
cause: String(err),
|
|
71
|
+
});
|
|
72
|
+
}
|
|
73
|
+
// Ensure real path is strictly under or equal to root
|
|
74
|
+
const relative = path.relative(root, realCandidate);
|
|
75
|
+
if (relative.startsWith("..") || path.isAbsolute(relative)) {
|
|
76
|
+
logger.warn("Path escape attempt blocked", { root, requested: relativePath, resolved: realCandidate });
|
|
77
|
+
throw new PathEscapeError("Requested path is outside the configured Jekyll project root.", { root, requested: relativePath, resolved: realCandidate });
|
|
78
|
+
}
|
|
79
|
+
return realCandidate;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Resolve a non-existent path by walking up to an existing ancestor,
|
|
83
|
+
* realpath-ing that ancestor, then re-joining the remainder.
|
|
84
|
+
*/
|
|
85
|
+
function resolveNonExistentUnderRoot(root, candidate) {
|
|
86
|
+
const parts = [];
|
|
87
|
+
let current = candidate;
|
|
88
|
+
while (current !== root && current !== path.dirname(current)) {
|
|
89
|
+
if (fs.existsSync(current)) {
|
|
90
|
+
const realAncestor = fs.realpathSync(current);
|
|
91
|
+
// Verify ancestor is under root
|
|
92
|
+
const rel = path.relative(root, realAncestor);
|
|
93
|
+
if (rel.startsWith("..") || path.isAbsolute(rel)) {
|
|
94
|
+
throw new PathEscapeError("Path escapes project root via symlink or absolute reference.", {
|
|
95
|
+
root,
|
|
96
|
+
ancestor: realAncestor,
|
|
97
|
+
});
|
|
98
|
+
}
|
|
99
|
+
return path.join(realAncestor, ...parts.reverse());
|
|
100
|
+
}
|
|
101
|
+
parts.push(path.basename(current));
|
|
102
|
+
current = path.dirname(current);
|
|
103
|
+
}
|
|
104
|
+
// Everything is new under root
|
|
105
|
+
if (current === root || path.relative(root, current) === "") {
|
|
106
|
+
return path.join(root, ...parts.reverse());
|
|
107
|
+
}
|
|
108
|
+
throw new PathEscapeError("Path escapes project root.", { root, candidate });
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Return a path relative to root for display/logging (never absolute).
|
|
112
|
+
*/
|
|
113
|
+
export function toRelative(root, absolutePath) {
|
|
114
|
+
const rel = path.relative(root, absolutePath);
|
|
115
|
+
if (rel.startsWith("..") || path.isAbsolute(rel)) {
|
|
116
|
+
return absolutePath; // should not happen if resolveSafePath was used
|
|
117
|
+
}
|
|
118
|
+
return rel.split(path.sep).join("/");
|
|
119
|
+
}
|
|
120
|
+
/**
|
|
121
|
+
* Check whether a path (already resolved) is inside root.
|
|
122
|
+
*/
|
|
123
|
+
export function isInsideRoot(root, absolutePath) {
|
|
124
|
+
const rel = path.relative(root, absolutePath);
|
|
125
|
+
return !rel.startsWith("..") && !path.isAbsolute(rel);
|
|
126
|
+
}
|
|
127
|
+
//# sourceMappingURL=path-policy.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"path-policy.js","sourceRoot":"","sources":["../../src/security/path-policy.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Input validation helpers for component names, paths, etc.
|
|
3
|
+
*/
|
|
4
|
+
export declare class ValidationError extends Error {
|
|
5
|
+
readonly details: Record<string, unknown>;
|
|
6
|
+
readonly code = "VALIDATION_ERROR";
|
|
7
|
+
constructor(message: string, details?: Record<string, unknown>);
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Normalize a component name to kebab-case.
|
|
11
|
+
* Accepts: "Pricing Card", "pricing card", "pricing_card", "pricing-card"
|
|
12
|
+
*/
|
|
13
|
+
export declare function normalizeComponentName(raw: string): string;
|
|
14
|
+
/**
|
|
15
|
+
* Assert that a value is a safe relative path segment (no traversal).
|
|
16
|
+
*/
|
|
17
|
+
export declare function assertSafeRelativeSegment(segment: string, label?: string): void;
|
|
18
|
+
//# sourceMappingURL=validation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/security/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,qBAAa,eAAgB,SAAQ,KAAK;aAItB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAHlD,QAAQ,CAAC,IAAI,sBAAsB;gBAEjC,OAAO,EAAE,MAAM,EACC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAKxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyC1D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,IAAI,CAOvF"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Input validation helpers for component names, paths, etc.
|
|
3
|
+
*/
|
|
4
|
+
import { COMPONENT_NAME_REGEX, MAX_COMPONENT_NAME_LENGTH, } from "../config/constants.js";
|
|
5
|
+
export class ValidationError extends Error {
|
|
6
|
+
details;
|
|
7
|
+
code = "VALIDATION_ERROR";
|
|
8
|
+
constructor(message, details = {}) {
|
|
9
|
+
super(message);
|
|
10
|
+
this.details = details;
|
|
11
|
+
this.name = "ValidationError";
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* Normalize a component name to kebab-case.
|
|
16
|
+
* Accepts: "Pricing Card", "pricing card", "pricing_card", "pricing-card"
|
|
17
|
+
*/
|
|
18
|
+
export function normalizeComponentName(raw) {
|
|
19
|
+
if (typeof raw !== "string" || raw.trim() === "") {
|
|
20
|
+
throw new ValidationError("Component name must be a non-empty string", { name: raw });
|
|
21
|
+
}
|
|
22
|
+
const normalized = raw
|
|
23
|
+
.trim()
|
|
24
|
+
.toLowerCase()
|
|
25
|
+
.replace(/[_\s]+/g, "-")
|
|
26
|
+
.replace(/[^a-z0-9-]/g, "")
|
|
27
|
+
.replace(/-+/g, "-")
|
|
28
|
+
.replace(/^-|-$/g, "");
|
|
29
|
+
if (normalized.length === 0) {
|
|
30
|
+
throw new ValidationError("Component name contains no valid characters", { name: raw });
|
|
31
|
+
}
|
|
32
|
+
if (normalized.length > MAX_COMPONENT_NAME_LENGTH) {
|
|
33
|
+
throw new ValidationError(`Component name exceeds maximum length of ${MAX_COMPONENT_NAME_LENGTH}`, { name: normalized, length: normalized.length });
|
|
34
|
+
}
|
|
35
|
+
if (!COMPONENT_NAME_REGEX.test(normalized)) {
|
|
36
|
+
throw new ValidationError("Component name must be kebab-case, start with a letter, and contain only lowercase letters, numbers, and hyphens", { name: normalized });
|
|
37
|
+
}
|
|
38
|
+
// Reject reserved / unsafe names
|
|
39
|
+
const reserved = new Set([
|
|
40
|
+
"con", "prn", "aux", "nul", "com1", "lpt1", "node_modules", "package",
|
|
41
|
+
"index", "main", "test", "spec",
|
|
42
|
+
]);
|
|
43
|
+
if (reserved.has(normalized)) {
|
|
44
|
+
throw new ValidationError(`Component name is reserved: ${normalized}`, { name: normalized });
|
|
45
|
+
}
|
|
46
|
+
return normalized;
|
|
47
|
+
}
|
|
48
|
+
/**
|
|
49
|
+
* Assert that a value is a safe relative path segment (no traversal).
|
|
50
|
+
*/
|
|
51
|
+
export function assertSafeRelativeSegment(segment, label = "path segment") {
|
|
52
|
+
if (typeof segment !== "string" || segment.trim() === "") {
|
|
53
|
+
throw new ValidationError(`${label} must be a non-empty string`);
|
|
54
|
+
}
|
|
55
|
+
if (segment.includes("..") || segment.includes("/") || segment.includes("\\") || segment.includes("\0")) {
|
|
56
|
+
throw new ValidationError(`${label} contains illegal characters`, { segment });
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=validation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/security/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAItB;IAHT,IAAI,GAAG,kBAAkB,CAAC;IACnC,YACE,OAAe,EACC,UAAmC,EAAE;QAErD,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,YAAO,GAAP,OAAO,CAA8B;QAGrD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,eAAe,CAAC,2CAA2C,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,MAAM,UAAU,GAAG,GAAG;SACnB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEzB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,eAAe,CAAC,6CAA6C,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QAClD,MAAM,IAAI,eAAe,CACvB,4CAA4C,yBAAyB,EAAE,EACvE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,eAAe,CACvB,kHAAkH,EAClH,EAAE,IAAI,EAAE,UAAU,EAAE,CACrB,CAAC;IACJ,CAAC;IAED,iCAAiC;IACjC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;QACvB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS;QACrE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;KAChC,CAAC,CAAC;IACH,IAAI,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,eAAe,CAAC,+BAA+B,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe,EAAE,KAAK,GAAG,cAAc;IAC/E,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzD,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxG,MAAM,IAAI,eAAe,CAAC,GAAG,KAAK,8BAA8B,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared server context: config + lightweight caches.
|
|
3
|
+
*/
|
|
4
|
+
import type { McpConfig } from "../config/environment.js";
|
|
5
|
+
export interface ProjectCache {
|
|
6
|
+
scanResult?: unknown;
|
|
7
|
+
components?: unknown;
|
|
8
|
+
tokens?: unknown;
|
|
9
|
+
scannedAt?: number;
|
|
10
|
+
}
|
|
11
|
+
export interface ServerContext {
|
|
12
|
+
config: McpConfig;
|
|
13
|
+
cache: ProjectCache;
|
|
14
|
+
invalidateCache: () => void;
|
|
15
|
+
}
|
|
16
|
+
export declare function createContext(config: McpConfig): ServerContext;
|
|
17
|
+
export declare function assertWriteAllowed(ctx: ServerContext, operation: "create" | "update" | "delete" | "destructive"): void;
|
|
18
|
+
//# sourceMappingURL=context.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/server/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,eAAe,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAa9D;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,GACxD,IAAI,CAqBN"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared server context: config + lightweight caches.
|
|
3
|
+
*/
|
|
4
|
+
export function createContext(config) {
|
|
5
|
+
const cache = {};
|
|
6
|
+
return {
|
|
7
|
+
config,
|
|
8
|
+
cache,
|
|
9
|
+
invalidateCache() {
|
|
10
|
+
cache.scanResult = undefined;
|
|
11
|
+
cache.components = undefined;
|
|
12
|
+
cache.tokens = undefined;
|
|
13
|
+
cache.scannedAt = undefined;
|
|
14
|
+
},
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
export function assertWriteAllowed(ctx, operation) {
|
|
18
|
+
const mode = ctx.config.writeMode;
|
|
19
|
+
if (mode === "read-only") {
|
|
20
|
+
throw Object.assign(new Error("Server is in read-only mode; write operations are disabled."), {
|
|
21
|
+
code: "WRITE_MODE_DENIED",
|
|
22
|
+
details: { writeMode: mode, operation },
|
|
23
|
+
});
|
|
24
|
+
}
|
|
25
|
+
if (operation === "delete" || operation === "destructive") {
|
|
26
|
+
if (mode !== "full-write") {
|
|
27
|
+
throw Object.assign(new Error(`Destructive operation "${operation}" requires full-write mode. Current mode: ${mode}.`), {
|
|
28
|
+
code: "WRITE_MODE_DENIED",
|
|
29
|
+
details: { writeMode: mode, operation },
|
|
30
|
+
});
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=context.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/server/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC7C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,OAAO;QACL,MAAM;QACN,KAAK;QACL,eAAe;YACb,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;YAC7B,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;YAC7B,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YACzB,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAAkB,EAClB,SAAyD;IAEzD,MAAM,IAAI,GAAc,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;IAC7C,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,6DAA6D,CAAC,EAAE;YAC5F,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,aAAa,EAAE,CAAC;QAC1D,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CACP,0BAA0B,SAAS,6CAA6C,IAAI,GAAG,CACxF,EACD;gBACE,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;aACxC,CACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP server factory: registers tools, resources, and prompts.
|
|
3
|
+
* Business logic lives in services; this layer only wires the protocol.
|
|
4
|
+
*/
|
|
5
|
+
import { McpServer } from "@modelcontextprotocol/server";
|
|
6
|
+
import type { ServerContext } from "./context.js";
|
|
7
|
+
export declare function createServer(ctx: ServerContext): McpServer;
|
|
8
|
+
//# sourceMappingURL=create-server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-server.d.ts","sourceRoot":"","sources":["../../src/server/create-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAyBlD,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,SAAS,CA0rB1D"}
|