javi-forge 1.6.0 → 1.6.1

package/dist/lib/context.js

@@ -1,14 +1,16 @@
-import { STACK_CONTEXT_MAP } from '../constants.js';
+import fs from "fs-extra";
+import path from "path";
+import { STACK_CONTEXT_MAP } from "../constants.js";
 // =============================================================================
 // Internal helpers
 // =============================================================================
 function getStackContext(stack) {
-    return STACK_CONTEXT_MAP[stack] ?? STACK_CONTEXT_MAP['default'];
+    return STACK_CONTEXT_MAP[stack] ?? STACK_CONTEXT_MAP["default"];
 }
 export function buildIndexMd(projectName, stackCtx, ciProvider, memory) {
-    return `# ${projectName} — File Index
+    return `# ${projectName} — Project Index
 
-## Directory Structure
+## Structure
 
 \`\`\`
 ${stackCtx.tree}
@@ -20,13 +22,14 @@ ${stackCtx.tree}
 
 ## Conventions
 
-- **Stack conventions**: ${stackCtx.conventions}
+- **Stack**: ${stackCtx.conventions}
 - **CI**: ${ciProvider}
 - **Memory**: ${memory}
 `;
 }
-export function buildSummaryMd(projectName, stack, ciProvider, memory, modules) {
-    const modulesList = modules.length > 0 ? modules.join(', ') : 'none';
+export function buildSummaryMd(projectName, stack, ciProvider, memory, modules, dependencies = []) {
+    const modulesList = modules.length > 0 ? modules.join(", ") : "none";
+    const depsList = dependencies.length > 0 ? dependencies.join(", ") : "none detected";
     return `# ${projectName}
 
 ## Overview
@@ -35,10 +38,11 @@ ${stack}-based project scaffolded with javi-forge.
 
 ## Stack
 
-- **Language/Runtime**: ${stack}
+- **Runtime**: ${stack}
 - **CI**: ${ciProvider}
 - **Memory**: ${memory}
 - **Modules**: ${modulesList}
+- **Dependencies**: ${depsList}
 
 ## Key Decisions
 
@@ -47,6 +51,99 @@ ${stack}-based project scaffolded with javi-forge.
 `;
 }
 // =============================================================================
+// Dependency detection
+// =============================================================================
+/**
+ * Detect top-level dependencies from project manifest files.
+ * Returns up to 10 dependency names (key deps only, not devDeps).
+ */
+export async function detectDependencies(projectDir, stack) {
+    const MAX_DEPS = 10;
+    try {
+        switch (stack) {
+            case "node": {
+                const pkgPath = path.join(projectDir, "package.json");
+                if (!(await fs.pathExists(pkgPath)))
+                    return [];
+                const pkg = await fs.readJson(pkgPath).catch(() => ({}));
+                const deps = Object.keys(pkg.dependencies ?? {});
+                return deps.slice(0, MAX_DEPS);
+            }
+            case "python": {
+                const pyprojectPath = path.join(projectDir, "pyproject.toml");
+                if (await fs.pathExists(pyprojectPath)) {
+                    const content = await fs.readFile(pyprojectPath, "utf-8");
+                    const match = content.match(/dependencies\s*=\s*\[([\s\S]*?)\]/);
+                    if (match?.[1]) {
+                        const deps = match[1]
+                            .split("\n")
+                            .map((l) => l.replace(/[",]/g, "").trim())
+                            .filter((l) => l.length > 0 && !l.startsWith("#"))
+                            .map((l) => l.split(/[>=<~!]/)[0].trim())
+                            .filter(Boolean);
+                        return deps.slice(0, MAX_DEPS);
+                    }
+                }
+                const reqPath = path.join(projectDir, "requirements.txt");
+                if (await fs.pathExists(reqPath)) {
+                    const content = await fs.readFile(reqPath, "utf-8");
+                    const deps = content
+                        .split("\n")
+                        .map((l) => l.trim())
+                        .filter((l) => l.length > 0 && !l.startsWith("#") && !l.startsWith("-"))
+                        .map((l) => l.split(/[>=<~!]/)[0].trim())
+                        .filter(Boolean);
+                    return deps.slice(0, MAX_DEPS);
+                }
+                return [];
+            }
+            case "go": {
+                const goModPath = path.join(projectDir, "go.mod");
+                if (!(await fs.pathExists(goModPath)))
+                    return [];
+                const content = await fs.readFile(goModPath, "utf-8");
+                const requireBlock = content.match(/require\s*\(([\s\S]*?)\)/);
+                if (requireBlock?.[1]) {
+                    const deps = requireBlock[1]
+                        .split("\n")
+                        .map((l) => l.trim())
+                        .filter((l) => l.length > 0 && !l.startsWith("//"))
+                        .map((l) => {
+                        const parts = l.split(/\s+/);
+                        const mod = parts[0] ?? "";
+                        return mod.split("/").pop() ?? mod;
+                    })
+                        .filter(Boolean);
+                    return deps.slice(0, MAX_DEPS);
+                }
+                return [];
+            }
+            case "rust": {
+                const cargoPath = path.join(projectDir, "Cargo.toml");
+                if (!(await fs.pathExists(cargoPath)))
+                    return [];
+                const content = await fs.readFile(cargoPath, "utf-8");
+                const depsSection = content.match(/\[dependencies\]([\s\S]*?)(?=\n\[|$)/);
+                if (depsSection?.[1]) {
+                    const deps = depsSection[1]
+                        .split("\n")
+                        .map((l) => l.trim())
+                        .filter((l) => l.length > 0 && !l.startsWith("#"))
+                        .map((l) => l.split(/\s*=/)[0].trim())
+                        .filter(Boolean);
+                    return deps.slice(0, MAX_DEPS);
+                }
+                return [];
+            }
+            default:
+                return [];
+        }
+    }
+    catch {
+        return [];
+    }
+}
+// =============================================================================
 // Public API
 // =============================================================================
 /**
@@ -59,17 +156,49 @@ export async function generateContextDir(options) {
     // Collect enabled modules for summary
     const modules = [];
     if (options.aiSync)
-        modules.push('ai-sync');
+        modules.push("ai-sync");
     if (options.sdd)
-        modules.push('sdd');
+        modules.push("sdd");
     if (options.ghagga)
-        modules.push('ghagga');
+        modules.push("ghagga");
     if (options.mock)
-        modules.push('mock');
+        modules.push("mock");
     if (options.contextDir)
-        modules.push('context');
+        modules.push("context");
     const index = buildIndexMd(projectName, stackCtx, ciProvider, memory);
     const summary = buildSummaryMd(projectName, stack, ciProvider, memory, modules);
     return { index, summary };
 }
+/**
+ * Refresh .context/ directory from the forge manifest and live project state.
+ * Reads manifest, detects current dependencies, regenerates INDEX.md + summary.md.
+ * Returns null if the project is not forge-managed or has no .context/ dir.
+ */
+export async function refreshContextDir(projectDir) {
+    const manifestPath = path.join(projectDir, ".javi-forge", "manifest.json");
+    const contextDirPath = path.join(projectDir, ".context");
+    // Only refresh if forge-managed and .context/ exists
+    if (!(await fs.pathExists(manifestPath)) ||
+        !(await fs.pathExists(contextDirPath))) {
+        return null;
+    }
+    let manifest;
+    try {
+        manifest = (await fs.readJson(manifestPath));
+    }
+    catch {
+        return null;
+    }
+    const stackCtx = getStackContext(manifest.stack);
+    const dependencies = await detectDependencies(projectDir, manifest.stack);
+    const index = buildIndexMd(manifest.projectName, stackCtx, manifest.ciProvider, manifest.memory);
+    const summary = buildSummaryMd(manifest.projectName, manifest.stack, manifest.ciProvider, manifest.memory, manifest.modules, dependencies);
+    // Write updated files
+    await fs.writeFile(path.join(contextDirPath, "INDEX.md"), index, "utf-8");
+    await fs.writeFile(path.join(contextDirPath, "summary.md"), summary, "utf-8");
+    // Update manifest timestamp
+    manifest.updatedAt = new Date().toISOString();
+    await fs.writeJson(manifestPath, manifest, { spaces: 2 });
+    return { index, summary, updated: true };
+}
 //# sourceMappingURL=context.js.map

package/dist/lib/docker.d.ts

@@ -1,4 +1,4 @@
-import type { Stack } from '../types/index.js';
+import type { Stack } from "../types/index.js";
 export interface DockerRunOptions {
     /** Absolute path to mount as /home/runner/work */
     projectDir: string;

package/dist/lib/docker.js

@@ -1,8 +1,8 @@
-import { execFile, spawn } from 'child_process';
-import { promisify } from 'util';
-import crypto from 'crypto';
-import fs from 'fs-extra';
-import path from 'path';
+import { execFile, spawn } from "child_process";
+import crypto from "crypto";
+import fs from "fs-extra";
+import path from "path";
+import { promisify } from "util";
 const execFileAsync = promisify(execFile);
 // =============================================================================
 // Image name
@@ -15,66 +15,66 @@ export function getImageName(stack) {
 // =============================================================================
 export function getDockerfileContent(stack) {
     switch (stack) {
-        case 'java-gradle':
-        case 'java-maven':
+        case "java-gradle":
+        case "java-maven":
             return [
-                'ARG JAVA_VERSION=21',
-                'FROM eclipse-temurin:${JAVA_VERSION}-jdk-noble',
-                'RUN apt-get update && apt-get install -y git curl unzip && rm -rf /var/lib/apt/lists/*',
-                'RUN useradd -m -s /bin/bash runner',
-                'USER runner',
-                'WORKDIR /home/runner/work',
+                "ARG JAVA_VERSION=21",
+                "FROM eclipse-temurin:${JAVA_VERSION}-jdk-noble",
+                "RUN apt-get update && apt-get install -y git curl unzip && rm -rf /var/lib/apt/lists/*",
+                "RUN useradd -m -s /bin/bash runner",
+                "USER runner",
+                "WORKDIR /home/runner/work",
                 'ENTRYPOINT ["/bin/bash", "-c"]',
-            ].join('\n');
-        case 'node':
+            ].join("\n");
+        case "node":
             return [
-                'FROM node:22-slim',
-                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
-                'RUN npm install -g pnpm',
-                'RUN useradd -m -s /bin/bash runner',
-                'USER runner',
-                'WORKDIR /home/runner/work',
+                "FROM node:22-slim",
+                "RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*",
+                "RUN npm install -g pnpm",
+                "RUN useradd -m -s /bin/bash runner",
+                "USER runner",
+                "WORKDIR /home/runner/work",
                 'ENTRYPOINT ["/bin/bash", "-c"]',
-            ].join('\n');
-        case 'python':
+            ].join("\n");
+        case "python":
             return [
-                'FROM python:3.12-slim',
-                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
-                'RUN pip install --no-cache-dir pytest ruff pylint poetry',
-                'RUN useradd -m -s /bin/bash runner',
-                'USER runner',
-                'WORKDIR /home/runner/work',
+                "FROM python:3.12-slim",
+                "RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*",
+                "RUN pip install --no-cache-dir pytest ruff pylint poetry",
+                "RUN useradd -m -s /bin/bash runner",
+                "USER runner",
+                "WORKDIR /home/runner/work",
                 'ENTRYPOINT ["/bin/bash", "-c"]',
-            ].join('\n');
-        case 'go':
+            ].join("\n");
+        case "go":
             return [
-                'FROM golang:1.23-bookworm',
-                'RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*',
-                'RUN go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.62.0 && mv /root/go/bin/golangci-lint /usr/local/bin/',
-                'RUN useradd -m -s /bin/bash runner',
-                'USER runner',
-                'WORKDIR /home/runner/work',
+                "FROM golang:1.23-bookworm",
+                "RUN apt-get update && apt-get install -y git && rm -rf /var/lib/apt/lists/*",
+                "RUN go install github.com/golangci/golangci-lint/cmd/golangci-lint@v1.62.0 && mv /root/go/bin/golangci-lint /usr/local/bin/",
+                "RUN useradd -m -s /bin/bash runner",
+                "USER runner",
+                "WORKDIR /home/runner/work",
                 'ENTRYPOINT ["/bin/bash", "-c"]',
-            ].join('\n');
-        case 'rust':
+            ].join("\n");
+        case "rust":
             return [
-                'FROM rust:1.83-slim',
-                'RUN apt-get update && apt-get install -y git pkg-config libssl-dev && rm -rf /var/lib/apt/lists/*',
-                'RUN rustup component add clippy rustfmt',
-                'RUN useradd -m -s /bin/bash runner',
-                'USER runner',
-                'WORKDIR /home/runner/work',
+                "FROM rust:1.83-slim",
+                "RUN apt-get update && apt-get install -y git pkg-config libssl-dev && rm -rf /var/lib/apt/lists/*",
+                "RUN rustup component add clippy rustfmt",
+                "RUN useradd -m -s /bin/bash runner",
+                "USER runner",
+                "WORKDIR /home/runner/work",
                 'ENTRYPOINT ["/bin/bash", "-c"]',
-            ].join('\n');
+            ].join("\n");
         default:
             return [
-                'FROM ubuntu:24.04',
-                'RUN apt-get update && apt-get install -y git curl && rm -rf /var/lib/apt/lists/*',
-                'RUN useradd -m -s /bin/bash runner',
-                'USER runner',
-                'WORKDIR /home/runner/work',
+                "FROM ubuntu:24.04",
+                "RUN apt-get update && apt-get install -y git curl && rm -rf /var/lib/apt/lists/*",
+                "RUN useradd -m -s /bin/bash runner",
+                "USER runner",
+                "WORKDIR /home/runner/work",
                 'ENTRYPOINT ["/bin/bash", "-c"]',
-            ].join('\n');
+            ].join("\n");
     }
 }
 // =============================================================================
@@ -82,7 +82,7 @@ export function getDockerfileContent(stack) {
 // =============================================================================
 export async function isDockerAvailable() {
     try {
-        await execFileAsync('docker', ['info'], { timeout: 5000 });
+        await execFileAsync("docker", ["info"], { timeout: 5000 });
         return true;
     }
     catch {
@@ -101,20 +101,24 @@ export async function ensureImage(options) {
     const { stack, javaVersion, dockerfilesDir } = options;
     const imageName = getImageName(stack);
     // Resolve Dockerfile path
-    const dockerDir = dockerfilesDir ?? path.join(path.dirname(new URL(import.meta.url).pathname), '../../ci-local/docker');
+    const dockerDir = dockerfilesDir ??
+        path.join(path.dirname(new URL(import.meta.url).pathname), "../../ci-local/docker");
     const dockerfilePath = path.join(dockerDir, `${stack}.Dockerfile`);
     // Write Dockerfile if it doesn't exist yet (first run)
-    if (!await fs.pathExists(dockerfilePath)) {
+    if (!(await fs.pathExists(dockerfilePath))) {
         await fs.ensureDir(dockerDir);
-        await fs.writeFile(dockerfilePath, getDockerfileContent(stack), 'utf-8');
+        await fs.writeFile(dockerfilePath, getDockerfileContent(stack), "utf-8");
     }
     // Staleness check: compare Dockerfile hash with the one embedded in the image label
-    const content = await fs.readFile(dockerfilePath, 'utf-8');
-    const currentHash = crypto.createHash('sha256').update(content).digest('hex');
-    let imageHash = '';
+    const content = await fs.readFile(dockerfilePath, "utf-8");
+    const currentHash = crypto.createHash("sha256").update(content).digest("hex");
+    let imageHash = "";
     try {
-        const { stdout } = await execFileAsync('docker', [
-            'inspect', '--format', '{{index .Config.Labels "dockerfile-hash"}}', imageName,
+        const { stdout } = await execFileAsync("docker", [
+            "inspect",
+            "--format",
+            '{{index .Config.Labels "dockerfile-hash"}}',
+            imageName,
         ]);
         imageHash = stdout.trim();
     }
@@ -126,19 +130,24 @@ export async function ensureImage(options) {
     }
     // Build image
     const buildArgs = [
-        'build',
-        '--label', `dockerfile-hash=${currentHash}`,
-        '-f', dockerfilePath,
-        '-t', imageName,
+        "build",
+        "--label",
+        `dockerfile-hash=${currentHash}`,
+        "-f",
+        dockerfilePath,
+        "-t",
+        imageName,
     ];
-    if (javaVersion && (stack === 'java-gradle' || stack === 'java-maven')) {
-        buildArgs.push('--build-arg', `JAVA_VERSION=${javaVersion}`);
+    if (javaVersion && (stack === "java-gradle" || stack === "java-maven")) {
+        buildArgs.push("--build-arg", `JAVA_VERSION=${javaVersion}`);
     }
     buildArgs.push(dockerDir);
     await new Promise((resolve, reject) => {
-        const proc = spawn('docker', buildArgs, { stdio: 'inherit' });
-        proc.on('close', code => code === 0 ? resolve() : reject(new Error(`docker build exited with code ${code}`)));
-        proc.on('error', reject);
+        const proc = spawn("docker", buildArgs, { stdio: "inherit" });
+        proc.on("close", (code) => code === 0
+            ? resolve()
+            : reject(new Error(`docker build exited with code ${code}`)));
+        proc.on("error", reject);
     });
     return imageName;
 }
@@ -156,28 +165,41 @@ export async function runInContainer(options) {
     const imageName = getImageName(stack);
     const isInteractive = process.stdin.isTTY && stream;
     const dockerArgs = [
-        'run', '--rm',
-        ...(isInteractive ? ['-it'] : []),
-        '--stop-timeout', '30',
-        '--entrypoint', '',
-        ...(user ? ['--user', user] : []),
-        '-v', `${projectDir}:/home/runner/work`,
-        '-e', 'CI=true',
+        "run",
+        "--rm",
+        ...(isInteractive ? ["-it"] : []),
+        "--stop-timeout",
+        "30",
+        "--entrypoint",
+        "",
+        ...(user ? ["--user", user] : []),
+        "-v",
+        `${projectDir}:/home/runner/work`,
+        "-e",
+        "CI=true",
         imageName,
-        'timeout', String(timeout), 'bash', '-c', command,
+        "timeout",
+        String(timeout),
+        "bash",
+        "-c",
+        command,
     ];
     return new Promise((resolve, reject) => {
-        const proc = spawn('docker', dockerArgs, {
-            stdio: stream ? 'inherit' : 'pipe',
+        const proc = spawn("docker", dockerArgs, {
+            stdio: stream ? "inherit" : "pipe",
         });
-        let stdout = '';
-        let stderr = '';
+        let stdout = "";
+        let stderr = "";
         if (!stream) {
-            proc.stdout?.on('data', (d) => { stdout += d.toString(); });
-            proc.stderr?.on('data', (d) => { stderr += d.toString(); });
+            proc.stdout?.on("data", (d) => {
+                stdout += d.toString();
+            });
+            proc.stderr?.on("data", (d) => {
+                stderr += d.toString();
+            });
         }
-        proc.on('close', code => resolve({ exitCode: code ?? 1, stdout, stderr }));
-        proc.on('error', reject);
+        proc.on("close", (code) => resolve({ exitCode: code ?? 1, stdout, stderr }));
+        proc.on("error", reject);
     });
 }
 /**
@@ -187,38 +209,45 @@ export async function openShell(projectDir) {
     const stack = await detectStackFromDir(projectDir);
     const imageName = getImageName(stack);
     await new Promise((resolve, reject) => {
-        const proc = spawn('docker', [
-            'run', '--rm', '-it',
-            '--entrypoint', '',
-            '-v', `${projectDir}:/home/runner/work`,
-            '-e', 'CI=true',
+        const proc = spawn("docker", [
+            "run",
+            "--rm",
+            "-it",
+            "--entrypoint",
+            "",
+            "-v",
+            `${projectDir}:/home/runner/work`,
+            "-e",
+            "CI=true",
             imageName,
-            'bash', '-c', 'cd /home/runner/work && exec bash',
-        ], { stdio: 'inherit' });
-        proc.on('close', () => resolve());
-        proc.on('error', reject);
+            "bash",
+            "-c",
+            "cd /home/runner/work && exec bash",
+        ], { stdio: "inherit" });
+        proc.on("close", () => resolve());
+        proc.on("error", reject);
     });
 }
 // =============================================================================
 // Internal helpers
 // =============================================================================
 async function detectStackFromDir(projectDir) {
-    if (await fs.pathExists(path.join(projectDir, 'build.gradle.kts')))
-        return 'java-gradle';
-    if (await fs.pathExists(path.join(projectDir, 'build.gradle')))
-        return 'java-gradle';
-    if (await fs.pathExists(path.join(projectDir, 'pom.xml')))
-        return 'java-maven';
-    if (await fs.pathExists(path.join(projectDir, 'package.json')))
-        return 'node';
-    if (await fs.pathExists(path.join(projectDir, 'go.mod')))
-        return 'go';
-    if (await fs.pathExists(path.join(projectDir, 'Cargo.toml')))
-        return 'rust';
-    if (await fs.pathExists(path.join(projectDir, 'pyproject.toml')) ||
-        await fs.pathExists(path.join(projectDir, 'requirements.txt')) ||
-        await fs.pathExists(path.join(projectDir, 'setup.py')))
-        return 'python';
-    return 'node'; // fallback
+    if (await fs.pathExists(path.join(projectDir, "build.gradle.kts")))
+        return "java-gradle";
+    if (await fs.pathExists(path.join(projectDir, "build.gradle")))
+        return "java-gradle";
+    if (await fs.pathExists(path.join(projectDir, "pom.xml")))
+        return "java-maven";
+    if (await fs.pathExists(path.join(projectDir, "package.json")))
+        return "node";
+    if (await fs.pathExists(path.join(projectDir, "go.mod")))
+        return "go";
+    if (await fs.pathExists(path.join(projectDir, "Cargo.toml")))
+        return "rust";
+    if ((await fs.pathExists(path.join(projectDir, "pyproject.toml"))) ||
+        (await fs.pathExists(path.join(projectDir, "requirements.txt"))) ||
+        (await fs.pathExists(path.join(projectDir, "setup.py"))))
+        return "python";
+    return "node"; // fallback
 }
 //# sourceMappingURL=docker.js.map

package/dist/lib/frontmatter.d.ts

@@ -14,5 +14,5 @@ export interface ValidationError {
 /**
  * Validate frontmatter against schema rules for agent or skill definitions.
  */
-export declare function validateFrontmatter(frontmatter: Record<string, unknown>, type: 'agent' | 'skill'): ValidationError[];
+export declare function validateFrontmatter(frontmatter: Record<string, unknown>, type: "agent" | "skill"): ValidationError[];
 //# sourceMappingURL=frontmatter.d.ts.map

package/dist/lib/frontmatter.js

@@ -1,20 +1,20 @@
-import YAML from 'yaml';
+import YAML from "yaml";
 /**
  * Extract YAML frontmatter from a markdown string.
  * Frontmatter is delimited by --- at the start of the file.
  */
 export function parseFrontmatter(raw) {
     const trimmed = raw.trimStart();
-    if (!trimmed.startsWith('---'))
+    if (!trimmed.startsWith("---"))
         return null;
-    const endIdx = trimmed.indexOf('---', 3);
+    const endIdx = trimmed.indexOf("---", 3);
     if (endIdx === -1)
         return null;
     const yamlBlock = trimmed.slice(3, endIdx).trim();
     const content = trimmed.slice(endIdx + 3).trim();
     try {
         const data = YAML.parse(yamlBlock);
-        if (typeof data !== 'object' || data === null)
+        if (typeof data !== "object" || data === null)
             return null;
         return { data, content };
     }
@@ -29,30 +29,44 @@ const KEBAB_CASE_RE = /^[a-z0-9]+(-[a-z0-9]+)*$/;
 export function validateFrontmatter(frontmatter, type) {
     const errors = [];
     // name: required, kebab-case, 2-60 chars
-    const name = frontmatter['name'];
-    if (typeof name !== 'string' || !name) {
-        errors.push({ field: 'name', message: 'name is required and must be a string' });
+    const name = frontmatter["name"];
+    if (typeof name !== "string" || !name) {
+        errors.push({
+            field: "name",
+            message: "name is required and must be a string",
+        });
     }
     else {
         if (name.length < 2 || name.length > 60) {
-            errors.push({ field: 'name', message: 'name must be 2-60 characters' });
+            errors.push({ field: "name", message: "name must be 2-60 characters" });
         }
         if (!KEBAB_CASE_RE.test(name)) {
-            errors.push({ field: 'name', message: 'name must be kebab-case (e.g. my-skill-name)' });
+            errors.push({
+                field: "name",
+                message: "name must be kebab-case (e.g. my-skill-name)",
+            });
         }
     }
     // description: required, non-empty, min 10 chars
-    const desc = frontmatter['description'];
-    if (typeof desc !== 'string' || !desc) {
-        errors.push({ field: 'description', message: 'description is required and must be a string' });
+    const desc = frontmatter["description"];
+    if (typeof desc !== "string" || !desc) {
+        errors.push({
+            field: "description",
+            message: "description is required and must be a string",
+        });
     }
     else if (desc.length < 10) {
-        errors.push({ field: 'description', message: 'description must be at least 10 characters' });
+        errors.push({
+            field: "description",
+            message: "description must be at least 10 characters",
+        });
     }
     // skill-specific: description should include "Trigger:" hint
-    if (type === 'skill' && typeof desc === 'string' && !desc.includes('Trigger:')) {
+    if (type === "skill" &&
+        typeof desc === "string" &&
+        !desc.includes("Trigger:")) {
         errors.push({
-            field: 'description',
+            field: "description",
             message: 'skill description should include a "Trigger:" hint for auto-invoke',
         });
     }