veryfront 0.1.111 → 0.1.113

package/esm/cli/commands/skills/validate.js

@@ -0,0 +1,91 @@
+/**
+ * Skills validate command — validate a skill directory
+ *
+ * @module cli/commands/skills/validate
+ */
+import * as dntShim from "../../../_dnt.shims.js";
+import { createSuccessEnvelope, isJsonMode, outputJson } from "../../shared/json-output.js";
+import { parseSkillJson } from "../../skills/types.js";
+import { COMMANDS } from "../../help/command-definitions.js";
+import { logError, logSuccess } from "../../utils/index.js";
+import { createFileSystem } from "../../../src/platform/index.js";
+export async function validateSkill(args) {
+    const dir = args._[2] ?? ".";
+    const issues = [];
+    const fs = createFileSystem();
+    // Check skill.json exists and parses
+    let manifestRaw;
+    try {
+        manifestRaw = await fs.readTextFile(`${dir}/skill.json`);
+    }
+    catch {
+        issues.push({ severity: "error", message: "skill.json not found" });
+        return outputResults(dir, issues);
+    }
+    let parsed;
+    try {
+        parsed = parseSkillJson(JSON.parse(manifestRaw));
+    }
+    catch {
+        issues.push({
+            severity: "error",
+            message: "skill.json is not valid JSON",
+        });
+        return outputResults(dir, issues);
+    }
+    if (!parsed.success) {
+        issues.push({
+            severity: "error",
+            message: `skill.json schema error: ${parsed.error}`,
+        });
+        return outputResults(dir, issues);
+    }
+    // Check SKILL.md exists
+    try {
+        const content = await fs.readTextFile(`${dir}/SKILL.md`);
+        if (!content.trim()) {
+            issues.push({ severity: "warning", message: "SKILL.md is empty" });
+        }
+    }
+    catch {
+        issues.push({ severity: "error", message: "SKILL.md not found" });
+    }
+    // Check required CLI commands exist
+    const cliReqs = parsed.data.requires?.cli ?? [];
+    for (const cmd of cliReqs) {
+        if (!COMMANDS[cmd]) {
+            issues.push({
+                severity: "warning",
+                message: `Required CLI command "${cmd}" not found in registry`,
+            });
+        }
+    }
+    return outputResults(dir, issues);
+}
+async function outputResults(dir, issues) {
+    const hasErrors = issues.some((i) => i.severity === "error");
+    if (isJsonMode()) {
+        await outputJson(createSuccessEnvelope("skills", {
+            directory: dir,
+            valid: !hasErrors,
+            issues,
+        }));
+        if (hasErrors)
+            dntShim.Deno.exit(1);
+        return;
+    }
+    if (issues.length === 0) {
+        logSuccess(`Skill at "${dir}" is valid`);
+        return;
+    }
+    for (const issue of issues) {
+        if (issue.severity === "error") {
+            logError(issue.message);
+        }
+        else {
+            console.log(`  ! ${issue.message}`);
+        }
+    }
+    if (hasErrors)
+        dntShim.Deno.exit(1);
+}

package/esm/cli/commands/start/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/start/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,SAAS,EAAE,WAgDvB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/start/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,SAAS,EAAE,WAiDvB,CAAC"}

package/esm/cli/commands/start/command-help.js

@@ -1,5 +1,6 @@
 export const startHelp = {
     name: "start",
+    category: "project",
     description: "Start development dashboard with proxy and MCP integration",
     usage: "veryfront start [options]",
     options: [

package/esm/cli/commands/studio/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/studio/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAuBxB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/studio/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAwBxB,CAAC"}

package/esm/cli/commands/studio/command-help.js

@@ -1,5 +1,6 @@
 export const studioHelp = {
     name: "studio",
+    category: "project",
     description: "Open Veryfront Studio in browser",
     usage: "veryfront studio [project] [options]",
     options: [

package/esm/cli/commands/styles/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/styles/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAkBxB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/styles/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAmBxB,CAAC"}

package/esm/cli/commands/styles/command-help.js

@@ -1,5 +1,6 @@
 export const stylesHelp = {
     name: "styles",
+    category: "development",
     description: "Build project CSS artifacts",
     usage: "veryfront styles build-artifact --config <json>",
     options: [

package/esm/cli/commands/task/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/task/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAmBtB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/task/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAoBtB,CAAC"}

package/esm/cli/commands/task/command-help.js

@@ -1,5 +1,6 @@
 export const taskHelp = {
     name: "task",
+    category: "ai",
     description: "Run a task from the tasks/ directory",
     usage: "veryfront task <name> [options]",
     options: [

package/esm/cli/commands/test/command-help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandHelp } from "../../help/types.js";
+export declare const testHelp: CommandHelp;
+//# sourceMappingURL=command-help.d.ts.map

package/esm/cli/commands/test/command-help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/test/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,QAAQ,EAAE,WAetB,CAAC"}

package/esm/cli/commands/test/command-help.js

@@ -0,0 +1,16 @@
+export const testHelp = {
+    name: "test",
+    category: "development",
+    description: "Run tests with optional structured JSON output",
+    usage: "veryfront test [filter] [options]",
+    options: [
+        { flag: "--json", description: "Output structured JSON results" },
+        { flag: "--parallel", description: "Run tests in parallel" },
+        { flag: "--filter <pattern>", description: "Filter tests by name" },
+    ],
+    examples: [
+        "veryfront test",
+        "veryfront test --json",
+        "veryfront test --filter 'deploy' --json",
+    ],
+};

package/esm/cli/commands/test/command.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Test wrapper command
+ *
+ * Runs deno test and transforms output to structured JSON.
+ *
+ * @module cli/commands/test
+ */
+export interface TestResult {
+    success: boolean;
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        skipped: number;
+        duration_ms: number;
+    };
+    failures: Array<{
+        file: string;
+        test: string;
+        error: string;
+        line?: number;
+    }>;
+}
+export declare function parseTestOutput(output: string, exitCode: number): TestResult;
+//# sourceMappingURL=command.d.ts.map

package/esm/cli/commands/test/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/test/command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAgE5E"}

package/esm/cli/commands/test/command.js

@@ -0,0 +1,68 @@
+/**
+ * Test wrapper command
+ *
+ * Runs deno test and transforms output to structured JSON.
+ *
+ * @module cli/commands/test
+ */
+export function parseTestOutput(output, exitCode) {
+    const lines = output.split("\n");
+    let passed = 0;
+    let failed = 0;
+    let skipped = 0;
+    let durationMs = 0;
+    for (const line of lines) {
+        const summaryMatch = line.match(/(\d+)\s+passed\s*\|\s*(\d+)\s+failed/);
+        if (summaryMatch) {
+            passed = parseInt(summaryMatch[1] ?? "0", 10);
+            failed = parseInt(summaryMatch[2] ?? "0", 10);
+        }
+        const durationMatch = line.match(/\((\d+\.?\d*)s\)/);
+        if (durationMatch) {
+            durationMs = Math.round(parseFloat(durationMatch[1] ?? "0") * 1000);
+        }
+        const skippedMatch = line.match(/(\d+)\s+ignored/);
+        if (skippedMatch) {
+            skipped = parseInt(skippedMatch[1] ?? "0", 10);
+        }
+    }
+    const failures = [];
+    const failureRegex = /^(.*?)\s+\.\.\.\s+FAILED/;
+    for (let i = 0; i < lines.length; i++) {
+        const currentLine = lines[i];
+        if (!currentLine)
+            continue;
+        const match = currentLine.match(failureRegex);
+        if (match) {
+            const testName = (match[1] ?? "").trim();
+            let error = "";
+            let file = "";
+            let line;
+            for (let j = i + 1; j < Math.min(i + 10, lines.length); j++) {
+                const lineText = lines[j];
+                if (!lineText)
+                    continue;
+                const fileLine = lineText.match(/at\s+(.*?):(\d+)/);
+                if (fileLine?.[1] && fileLine[2]) {
+                    file = fileLine[1];
+                    line = parseInt(fileLine[2], 10);
+                }
+                if (lineText.includes("Error:") || lineText.includes("assert")) {
+                    error = lineText.trim();
+                }
+            }
+            failures.push({ file, test: testName, error, line });
+        }
+    }
+    return {
+        success: exitCode === 0,
+        summary: {
+            total: passed + failed + skipped,
+            passed,
+            failed,
+            skipped,
+            duration_ms: durationMs,
+        },
+        failures,
+    };
+}

package/esm/cli/commands/test/handler.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from "../../shared/types.js";
+export declare function handleTestCommand(args: ParsedArgs): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

package/esm/cli/commands/test/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/test/handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAmBxD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvE"}

package/esm/cli/commands/test/handler.js

@@ -0,0 +1,61 @@
+import * as dntShim from "../../../_dnt.shims.js";
+import { z } from "zod";
+import { createArgParser, parseArgsOrThrow } from "../../shared/args.js";
+import { createErrorEnvelope, createSuccessEnvelope, isJsonMode, outputJson, } from "../../shared/json-output.js";
+import { parseTestOutput } from "./command.js";
+const TestArgsSchema = z.object({
+    filter: z.string().optional(),
+    parallel: z.boolean().default(false),
+});
+const parseTestArgs = createArgParser(TestArgsSchema, {
+    filter: { keys: ["filter"], type: "string", positional: 0 },
+    parallel: { keys: ["parallel"], type: "boolean" },
+});
+export async function handleTestCommand(args) {
+    const opts = parseArgsOrThrow(parseTestArgs, "test", args);
+    const cmd = new dntShim.Deno.Command("deno", {
+        args: [
+            "test",
+            "--no-check",
+            "--allow-all",
+            "--unstable-worker-options",
+            "--unstable-net",
+            ...(opts.parallel ? ["--parallel"] : []),
+            ...(opts.filter ? [`--filter=${opts.filter}`] : []),
+        ],
+        stdout: "piped",
+        stderr: "piped",
+        env: {
+            VF_DISABLE_LRU_INTERVAL: "1",
+            SSR_TRANSFORM_PER_PROJECT_LIMIT: "0",
+            REVALIDATION_PER_PROJECT_LIMIT: "0",
+            NODE_ENV: "production",
+            LOG_FORMAT: "text",
+        },
+    });
+    const result = await cmd.output();
+    const stdout = new TextDecoder().decode(result.stdout);
+    const stderr = new TextDecoder().decode(result.stderr);
+    const fullOutput = stdout + "\n" + stderr;
+    if (isJsonMode()) {
+        const parsed = parseTestOutput(fullOutput, result.code);
+        if (parsed.success) {
+            await outputJson(createSuccessEnvelope("test", parsed));
+        }
+        else {
+            await outputJson(createErrorEnvelope("test", {
+                code: "TEST_FAILURE",
+                slug: "tests-failed",
+                message: `${parsed.summary.failed} test(s) failed`,
+                context: parsed,
+            }));
+        }
+    }
+    else {
+        if (stdout)
+            console.log(stdout);
+        if (stderr)
+            console.error(stderr);
+    }
+    dntShim.Deno.exit(result.code);
+}

package/esm/cli/commands/up/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/up/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,MAAM,EAAE,WAqBpB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/up/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,MAAM,EAAE,WAsBpB,CAAC"}

package/esm/cli/commands/up/command-help.js

@@ -1,5 +1,6 @@
 export const upHelp = {
     name: "up",
+    category: "deploy",
     description: "Deploy your app with one command (login, create, push, deploy)",
     usage: "veryfront up [options]",
     options: [

package/esm/cli/commands/uploads/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/uploads/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,WAAW,EAAE,WA0CzB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/uploads/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,WAAW,EAAE,WA2CzB,CAAC"}

package/esm/cli/commands/uploads/command-help.js

@@ -1,5 +1,6 @@
 export const uploadsHelp = {
     name: "uploads",
+    category: "files",
     description: "List, pull, upload, and delete project uploads",
     usage: "veryfront uploads <command> [options]",
     options: [

package/esm/cli/commands/whoami/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/whoami/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAUxB,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/whoami/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,UAAU,EAAE,WAWxB,CAAC"}

package/esm/cli/commands/whoami/command-help.js

@@ -1,5 +1,6 @@
 export const whoamiHelp = {
     name: "whoami",
+    category: "auth",
     description: "Show current authenticated user",
     usage: "veryfront whoami",
     options: [],

package/esm/cli/commands/workflow/command-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/workflow/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,WAkB1B,CAAC"}
+{"version":3,"file":"command-help.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/workflow/command-help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,YAAY,EAAE,WAmB1B,CAAC"}

package/esm/cli/commands/workflow/command-help.js

@@ -1,5 +1,6 @@
 export const workflowHelp = {
     name: "workflow",
+    category: "ai",
     description: "Run a workflow from the app/workflows directory",
     usage: "veryfront workflow run <id> [options]",
     options: [

package/esm/cli/help/command-definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAkClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAgCtB,CAAC"}
+{"version":3,"file":"command-definitions.d.ts","sourceRoot":"","sources":["../../../src/cli/help/command-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAuClD;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,eAqCtB,CAAC"}

package/esm/cli/help/command-definitions.js

@@ -35,6 +35,11 @@ import { issuesHelp } from "../commands/issues/command-help.js";
 import { startHelp } from "../commands/start/command-help.js";
 import { taskHelp } from "../commands/task/command-help.js";
 import { workflowHelp } from "../commands/workflow/command-help.js";
+import { schemaHelp } from "../commands/schema/command-help.js";
+import { testHelp } from "../commands/test/command-help.js";
+import { lintHelp } from "../commands/lint/command-help.js";
+import { skillsHelp } from "../commands/skills/command-help.js";
+import { completionsHelp } from "../commands/completions/command-help.js";
 /**
  * Central registry of all command help definitions.
  * Each command's help is imported from its respective command-help.ts file.
@@ -71,4 +76,9 @@ export const COMMANDS = {
     start: startHelp,
     task: taskHelp,
     workflow: workflowHelp,
+    schema: schemaHelp,
+    test: testHelp,
+    lint: lintHelp,
+    skills: skillsHelp,
+    completions: completionsHelp,
 };

package/esm/cli/help/main-help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main-help.d.ts","sourceRoot":"","sources":["../../../src/cli/help/main-help.ts"],"names":[],"mappings":"AAWA,wBAAgB,YAAY,IAAI,IAAI,CAwCnC"}
+{"version":3,"file":"main-help.d.ts","sourceRoot":"","sources":["../../../src/cli/help/main-help.ts"],"names":[],"mappings":"AAwCA,wBAAgB,YAAY,IAAI,IAAI,CAsDnC"}

package/esm/cli/help/main-help.js

@@ -1,6 +1,31 @@
 import { COMMANDS } from "./command-definitions.js";
 import { calculateMaxLength, formatCommandList, formatCommandName, formatDescription, formatHeader, formatSectionHeader, } from "./formatters.js";
 import { bold, dim } from "../ui/colors.js";
+const CATEGORY_LABELS = {
+    development: "Development",
+    deploy: "Deploy & Sync",
+    project: "Project",
+    files: "Files & Data",
+    ai: "AI & Automation",
+    auth: "Auth",
+};
+const CATEGORY_ORDER = [
+    "development",
+    "deploy",
+    "project",
+    "files",
+    "ai",
+    "auth",
+];
+function groupByCategory(commands) {
+    const groups = new Map();
+    for (const cmd of commands) {
+        const group = groups.get(cmd.category) ?? [];
+        group.push(cmd);
+        groups.set(cmd.category, group);
+    }
+    return groups;
+}
 export function showMainHelp() {
     console.log(formatHeader());
     console.log();
@@ -8,14 +33,22 @@ export function showMainHelp() {
     console.log();
     const commands = Object.values(COMMANDS);
     const maxLength = calculateMaxLength(commands.map((c) => ({ length: c.name.length })));
-    console.log(`  ${formatSectionHeader("Commands")}`);
-    for (const line of formatCommandList(commands, maxLength)) {
-        console.log(line);
+    const grouped = groupByCategory(commands);
+    for (const category of CATEGORY_ORDER) {
+        const cmds = grouped.get(category);
+        if (!cmds || cmds.length === 0)
+            continue;
+        console.log(`  ${formatSectionHeader(CATEGORY_LABELS[category])}`);
+        for (const line of formatCommandList(cmds, maxLength)) {
+            console.log(line);
+        }
+        console.log();
     }
-    console.log();
     console.log(`  ${formatSectionHeader("Global Options")}`);
     console.log(`    ${formatCommandName("-h, --help", maxLength)} ${formatDescription("Show help")}`);
     console.log(`    ${formatCommandName("-v, --version", maxLength)} ${formatDescription("Show version")}`);
+    console.log(`    ${formatCommandName("--json", maxLength)} ${formatDescription("Output as JSON")}`);
+    console.log(`    ${formatCommandName("--yes", maxLength)} ${formatDescription("Skip confirmation prompts")}`);
     console.log();
     console.log(`  ${formatSectionHeader("Quick Start")}`);
     console.log(`    ${dim("$")} veryfront init my-app`);
@@ -25,7 +58,7 @@ export function showMainHelp() {
     console.log(`  ${formatSectionHeader("Coding Agents (MCP)")}`);
     console.log(`    ${dim("HTTP:")}   MCP auto-starts on port 9999 with dev server`);
     console.log(`    ${dim("stdio:")}  veryfront mcp`);
-    console.log(`    ${dim("Tools:")}  vf_list_templates, vf_create_project, vf_scaffold, ...`);
+    console.log(`    ${dim("Schema:")} veryfront schema --json`);
     console.log();
     console.log(`  ${formatSectionHeader("Learn More")}`);
     console.log(`    ${dim("Docs:")}  https://github.com/veryfront/veryfront`);

package/esm/cli/help/types.d.ts

@@ -1,3 +1,4 @@
+export type CommandCategory = "development" | "deploy" | "project" | "files" | "ai" | "auth";
 export interface CommandOption {
     flag: string;
     description: string;
@@ -5,6 +6,7 @@ export interface CommandOption {
 }
 export interface CommandHelp {
     name: string;
+    category: CommandCategory;
     description: string;
     usage: string;
     options?: CommandOption[];

package/esm/cli/help/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/help/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/help/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,QAAQ,GACR,SAAS,GACT,OAAO,GACP,IAAI,GACJ,MAAM,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC"}

package/esm/cli/mcp/advanced-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"advanced-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/advanced-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA0B1C,eAAO,MAAM,aAAa,EAAE,OAAO,EAoBlC,CAAC"}
+{"version":3,"file":"advanced-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/advanced-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA4B1C,eAAO,MAAM,aAAa,EAAE,OAAO,EAsBlC,CAAC"}

package/esm/cli/mcp/advanced-tools.js

@@ -3,7 +3,11 @@ import { vfGetDebugContext, vfGetFlywheelStatus, vfHotReload, vfPreviewRoute, vf
 import { vfGetComponentTree, vfGetProjectContext, vfListLocalProjects, vfListRoutes, } from "./tools/project-tools.js";
 import { vfGetConventions, vfScaffold } from "./tools/scaffold-tools.js";
 import { vfGetSkillReference, vfGetSkills } from "./tools/skill-tools.js";
+import { cicdTools } from "./tools/cicd-tools.js";
+import { introspectionTools } from "./tools/introspection-tools.js";
 export const advancedTools = [
+    ...cicdTools,
+    ...introspectionTools,
     vfGetSkills,
     vfGetSkillReference,
     vfListLocalProjects,

package/esm/cli/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/server.ts"],"names":[],"mappings":"AA6CA,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA2B;gBAEjC,MAAM,GAAE,eAAoB;IAWxC,KAAK,IAAI,IAAI;IAeP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,SAAS;IAkDjB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,mBAAmB;IA+B3B,OAAO,CAAC,mBAAmB;IAqF3B,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,eAAe;CA+DxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAIrE;AAED,cAAc,kCAAkC,CAAC;AACjD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/server.ts"],"names":[],"mappings":"AA6CA,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA2B;gBAEjC,MAAM,GAAE,eAAoB;IAWxC,KAAK,IAAI,IAAI;IAeP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,SAAS;IAkDjB,OAAO,CAAC,aAAa;IAiBrB,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,mBAAmB;IAuD3B,OAAO,CAAC,mBAAmB;IAqI3B,OAAO,CAAC,iBAAiB;IAiCzB,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,eAAe;CA+DxB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAIrE;AAED,cAAc,kCAAkC,CAAC;AACjD,cAAc,YAAY,CAAC"}

package/esm/cli/mcp/server.js

@@ -194,6 +194,30 @@ export class MCPDevServer {
                     description: "File-based issues, tasks, and plans",
                     mimeType: "application/json",
                 },
+                {
+                    uri: "veryfront://schema",
+                    name: "CLI Schema",
+                    description: "Full CLI command schema for agent discovery",
+                    mimeType: "application/json",
+                },
+                {
+                    uri: "veryfront://agents-md",
+                    name: "Root AGENTS.md",
+                    description: "Agent onboarding documentation",
+                    mimeType: "text/markdown",
+                },
+                {
+                    uri: "veryfront://config",
+                    name: "Project Config",
+                    description: "Resolved project configuration",
+                    mimeType: "application/json",
+                },
+                {
+                    uri: "veryfront://skills",
+                    name: "Available Skills",
+                    description: "List of all available agent skills",
+                    mimeType: "application/json",
+                },
             ],
         };
     }
@@ -242,6 +266,50 @@ export class MCPDevServer {
                     ],
                 };
             }
+            if (uri === "veryfront://schema") {
+                const { generateSchema } = await import("../commands/schema/command.js");
+                return {
+                    contents: [{
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(generateSchema()),
+                        }],
+                };
+            }
+            if (uri === "veryfront://agents-md") {
+                const content = await readTextFile("AGENTS.md").catch(() => "AGENTS.md not found");
+                return {
+                    contents: [{ uri, mimeType: "text/markdown", text: content }],
+                };
+            }
+            if (uri === "veryfront://config") {
+                const { getEnvironmentConfig } = await import("../../src/config/index.js");
+                const config = getEnvironmentConfig();
+                return {
+                    contents: [{
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(config, null, 2),
+                        }],
+                };
+            }
+            if (uri === "veryfront://skills") {
+                const { listCoreSkills } = await import("../skills/loader.js");
+                const skills = await listCoreSkills();
+                const data = skills.map((s) => ({
+                    name: s.manifest.name,
+                    version: s.manifest.version,
+                    description: s.manifest.description,
+                    requires: s.manifest.requires,
+                }));
+                return {
+                    contents: [{
+                            uri,
+                            mimeType: "application/json",
+                            text: JSON.stringify(data, null, 2),
+                        }],
+                };
+            }
             if (!uri.startsWith("issues://"))
                 throw new Error(`Unknown resource: ${uri}`);
             const manager = createIssuesManager(cwd());

package/esm/cli/mcp/standalone.d.ts

@@ -19,6 +19,8 @@ export declare class StandaloneMCPServer {
     private handleRequest;
     private dispatchMethod;
     private handleToolsCall;
+    private handleResourcesList;
+    private handleResourcesRead;
     private handlePromptsList;
     private handlePromptsGet;
     private createTools;

package/esm/cli/mcp/standalone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2BH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,mBAAwB;IAM5C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAME,aAAa;IAW3B,OAAO,CAAC,cAAc;YA6BR,eAAe;IAU7B,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;IAwB9B,OAAO,CAAC,WAAW;CAqGpB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,mBAAmB,CAI/F"}
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAA4B;gBAEnC,MAAM,GAAE,mBAAwB;IAM5C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;YAME,aAAa;IAW3B,OAAO,CAAC,cAAc;YAiCR,eAAe;IAU7B,OAAO,CAAC,mBAAmB;YAyBb,mBAAmB;IA6CjC,OAAO,CAAC,iBAAiB;YAkBX,gBAAgB;IAwB9B,OAAO,CAAC,WAAW;CA8JpB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,GAAE,mBAAwB,GAAG,mBAAmB,CAI/F"}