veryfront 0.1.854 → 0.1.855

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

@@ -1,66 +1,41 @@
 /**
- * Skills validate command — validate a skill directory
+ * 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";
+import { basename } from "../../../deps/jsr.io/@std/path/1.1.4/mod.js";
+import { parseSkillFrontmatter, validateSkillMetadata } from "../../../src/skill/index.js";
 export async function validateSkill(args) {
     const dir = args._[2] ?? ".";
+    const issues = await validateSkillDirectory(dir);
+    return outputResults(dir, issues);
+}
+export async function validateSkillDirectory(dir) {
     const issues = [];
     const fs = createFileSystem();
-    // Check skill.json exists and parses
-    let manifestRaw;
+    let content;
     try {
-        manifestRaw = await fs.readTextFile(`${dir}/skill.json`);
+        content = await fs.readTextFile(`${dir}/SKILL.md`);
     }
     catch {
-        issues.push({ severity: "error", message: "skill.json not found" });
-        return outputResults(dir, issues);
+        return [{ severity: "error", message: "SKILL.md not found" }];
     }
-    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" });
+        const parsed = await parseSkillFrontmatter(content);
+        validateSkillMetadata(parsed.frontmatter, basename(dir));
+        if (!parsed.body.trim()) {
+            issues.push({ severity: "warning", message: "SKILL.md body is empty" });
         }
     }
-    catch {
-        issues.push({ severity: "error", message: "SKILL.md not found" });
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        issues.push({ severity: "error", message });
     }
-    // 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);
+    return issues;
 }
 async function outputResults(dir, issues) {
     const hasErrors = issues.some((i) => i.severity === "error");

package/esm/cli/mcp/server.js

@@ -325,10 +325,10 @@ export class MCPDevServer {
                 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,
+                    name: s.metadata.name,
+                    description: s.metadata.description,
+                    allowedTools: s.metadata.allowedTools,
+                    directory: s.directory,
                 }));
                 return {
                     contents: [{

package/esm/cli/mcp/standalone.js

@@ -154,10 +154,10 @@ export class StandaloneMCPServer {
             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,
+                name: s.metadata.name,
+                description: s.metadata.description,
+                allowedTools: s.metadata.allowedTools,
+                directory: s.directory,
             }));
             return {
                 contents: [{

package/esm/cli/mcp/tools/helpers.d.ts

@@ -29,14 +29,6 @@ export interface ProjectContext {
     integrations: string[];
     features: string[];
 }
-export interface ScaffoldResult {
-    success: boolean;
-    files: Array<{
-        path: string;
-        created: boolean;
-    }>;
-    message: string;
-}
 export declare function getProjectDir(projectPath?: string): string;
 export declare function scanDirectory(dir: string, baseRoute: string, routes: RouteInfo[], fs: FileSystem): Promise<void>;
 export declare const ROUTE_FILTER_MAP: Record<string, RouteType[]>;

package/esm/cli/mcp/tools/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAG3F,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;AAEvF,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAMD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE;QACX,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AA0CD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,EAAE,EACnB,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAIxD,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAwB,MAAM,uBAAuB,CAAC;AAG3F,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;AAEvF,qDAAqD;AACrD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAMD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEtF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC;IACxB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,WAAW,EAAE;QACX,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AA0CD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,EAAE,EACnB,EAAE,EAAE,UAAU,GACb,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAIxD,CAAC"}

package/esm/cli/mcp/tools/scaffold-tools.d.ts

@@ -3,9 +3,9 @@
  */
 import type { InferSchema } from "../../../src/extensions/schema/index.js";
 import type { MCPTool } from "../tools.js";
-import { type ScaffoldResult } from "./helpers.js";
+import { type ScaffoldResult } from "../../scaffold/engine.js";
 declare const getScaffoldInput: () => import("../../../src/internal-agents/schema.js").Schema<import("../../../src/extensions/schema/schema-validator.js").InferShape<{
-    type: import("../../../src/internal-agents/schema.js").Schema<string>;
+    type: import("../../../src/internal-agents/schema.js").Schema<"prompt" | "page" | "api" | "agent" | "layout" | "resource" | "component" | "task" | "tool" | "skill" | "workflow">;
     name: import("../../../src/internal-agents/schema.js").Schema<string>;
     methods: import("../../../src/internal-agents/schema.js").Schema<string[] | undefined>;
     projectPath: import("../../../src/internal-agents/schema.js").Schema<string | undefined>;

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

@@ -1 +1 @@
-{"version":3,"file":"scaffold-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/scaffold-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAG3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAML,KAAK,cAAc,EAGpB,MAAM,cAAc,CAAC;AAsItB,QAAA,MAAM,gBAAgB;;;;;GAerB,CAAC;AAGF,KAAK,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AA+CtE,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,aAAa,EAAE,cAAc,CAiD7D,CAAC;AAMF,QAAA,MAAM,sBAAsB;;GAQ3B,CAAC;AAGF,KAAK,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC;AAElF,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAgID,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,mBAAmB,EAAE,UAAU,EAAE,CAevE,CAAC"}
+{"version":3,"file":"scaffold-tools.d.ts","sourceRoot":"","sources":["../../../../src/cli/mcp/tools/scaffold-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,0BAA0B,CAAC;AAOlC,QAAA,MAAM,gBAAgB;;;;;GAarB,CAAC;AAGF,KAAK,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AAEtE,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,aAAa,EAAE,cAAc,CA6B7D,CAAC;AAMF,QAAA,MAAM,sBAAsB;;GAQ3B,CAAC;AAGF,KAAK,mBAAmB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC;AAElF,UAAU,UAAU;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAkID,eAAO,MAAM,gBAAgB,EAAE,OAAO,CAAC,mBAAmB,EAAE,UAAU,EAAE,CAevE,CAAC"}

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

@@ -2,205 +2,34 @@
  * MCP tools for scaffolding and conventions.
  */
 import { defineSchema, lazySchema } from "../../../src/schemas/index.js";
-import { join } from "../../../src/platform/compat/path/index.js";
 import { withSpan } from "../../../src/observability/tracing/otlp-setup.js";
-import { ensureDir, fileExists, formatError, getFs, getProjectDir, toComponentName, toSlug, } from "./helpers.js";
-// ============================================================================
-// Scaffold Templates
-// ============================================================================
-function generatePageTemplate(name, componentName) {
-    return `export default function ${componentName}() {
-  return (
-    <div>
-      <h1>${name}</h1>
-      <p>This is the ${name} page.</p>
-    </div>
-  );
-}
-`;
-}
-function generateLayoutTemplate(name, componentName) {
-    return `export default function ${componentName}Layout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <section className="${name}-layout">
-      {children}
-    </section>
-  );
-}
-`;
-}
-function generateApiTemplate(methods) {
-    const handlers = methods.map((method) => {
-        if (method === "GET") {
-            return `export function GET(req: Request) {
-  return Response.json({ ok: true });
-}`;
-        }
-        return `export async function ${method}(req: Request) {
-  const body = await req.json();
-  return Response.json({ ok: true, received: body });
-}`;
-    });
-    return `${handlers.join("\n\n")}\n`;
-}
-function generateComponentTemplate(componentName) {
-    return `interface ${componentName}Props {
-  children?: React.ReactNode;
-}
-
-export function ${componentName}({ children }: ${componentName}Props) {
-  return (
-    <div className="${componentName.toLowerCase()}">
-      {children}
-    </div>
-  );
-}
-`;
-}
-function generateToolTemplate(name) {
-    return `import { tool } from "veryfront/tool";
-import { defineSchema, lazySchema } from "veryfront/schemas";
-
-const getParameters = defineSchema((v) => v.object({
-  // Add your parameters here
-  input: v.string().describe("Input parameter"),
-}));
-
-export default tool({
-  id: "${name}",
-  description: "Description of what this tool does",
-  parameters: lazySchema(getParameters),
-  execute: async ({ input }) => {
-    // Implement your tool logic here
-    return { result: input };
-  },
-});
-`;
-}
-function generateAgentTemplate(name, className) {
-    return `import { agent } from "veryfront/agent";
-
-export default agent({
-  id: "${className.toLowerCase()}",
-  name: "${name}",
-  description: "Description of this agent's capabilities",
-  instructions: \`
-    You are an AI assistant specialized in ${name}.
-
-    Your capabilities:
-    - List your agent's capabilities here
-
-    Guidelines:
-    - Be helpful and accurate
-    - Ask for clarification when needed
-  \`,
-  tools: [
-    // Add tools this agent can use
-  ],
-});
-`;
-}
-function generatePromptTemplate(name) {
-    return `import { prompt } from "veryfront/prompt";
-import { defineSchema, lazySchema } from "veryfront/schemas";
-
-const getArgsSchema = defineSchema((v) => v.object({
-  input: v.string().describe("User input"),
-}));
-
-export default prompt({
-  id: "${name}",
-  description: "Description of this prompt template",
-  argsSchema: lazySchema(getArgsSchema),
-  getContent: ({ input }) => [
-    { role: "system", content: "Role: describe what this assistant should do and its limits." },
-    { role: "user", content: input },
-  ],
-});
-`;
-}
+import { SCAFFOLD_TYPES, scaffoldProjectFile, } from "../../scaffold/engine.js";
+import { formatError, getProjectDir } from "./helpers.js";
 // ============================================================================
 // Scaffold Configuration
 // ============================================================================
 const getScaffoldInput = defineSchema((v) => v.object({
-    type: v.enum(["page", "api", "layout", "component", "tool", "agent", "prompt"]).describe("Type of entity to scaffold"),
+    type: v.enum(SCAFFOLD_TYPES).describe("Type of project file to scaffold"),
     name: v.string().describe("Name/path of the entity (e.g., 'users', 'api/users', 'dashboard/settings')"),
     methods: v.array(v.enum(["GET", "POST", "PUT", "DELETE", "PATCH"])).optional().describe("HTTP methods for API routes (defaults to GET)"),
     projectPath: v.string().optional().describe("Project directory (defaults to current working directory)"),
 }));
 const scaffoldInput = lazySchema(getScaffoldInput);
-const SCAFFOLD_CONFIGS = {
-    page: {
-        getDirectory: (projectDir, slug) => join(projectDir, "app", slug),
-        getFilename: () => "page.tsx",
-        getContent: (name, _slug, componentName) => generatePageTemplate(name, componentName),
-    },
-    api: {
-        getDirectory: (projectDir, slug) => join(projectDir, "app", slug),
-        getFilename: () => "route.ts",
-        getContent: (_name, _slug, _componentName, methods) => generateApiTemplate(methods ?? ["GET"]),
-    },
-    layout: {
-        getDirectory: (projectDir, slug) => join(projectDir, "app", slug),
-        getFilename: () => "layout.tsx",
-        getContent: (name, _slug, componentName) => generateLayoutTemplate(name, componentName),
-    },
-    component: {
-        getDirectory: (projectDir) => join(projectDir, "components"),
-        getFilename: (_slug, componentName) => `${componentName}.tsx`,
-        getContent: (_name, _slug, componentName) => generateComponentTemplate(componentName),
-    },
-    tool: {
-        getDirectory: (projectDir) => join(projectDir, "ai", "tools"),
-        getFilename: (slug) => `${slug}.ts`,
-        getContent: (name) => generateToolTemplate(name),
-    },
-    agent: {
-        getDirectory: (projectDir) => join(projectDir, "ai", "agents"),
-        getFilename: (slug) => `${slug}.ts`,
-        getContent: (name, _slug, componentName) => generateAgentTemplate(name, componentName),
-    },
-    prompt: {
-        getDirectory: (projectDir) => join(projectDir, "ai", "prompts"),
-        getFilename: (slug) => `${slug}.ts`,
-        getContent: (_name, slug) => generatePromptTemplate(slug.replace(/-/g, "_")),
-    },
-};
 export const vfScaffold = {
     name: "vf_scaffold",
     title: "Scaffold Code",
     annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
-    description: "Use this when you need to generate new pages, API routes, layouts, components, AI tools, agents, or prompts with proper Veryfront conventions. Returns the created file path and content. May overwrite existing files at the target path. Do not use for creating entire projects — use vf_create_project instead.",
+    description: "Use this when you need to generate new pages, API routes, layouts, components, tools, agents, prompts, workflows, tasks, resources, or skills with Veryfront conventions. Returns created file paths and refuses existing target files. Do not use for creating entire projects. Use vf_create_project instead.",
     inputSchema: scaffoldInput,
     execute: (input) => withSpan("cli.mcp.tool.vf_scaffold", async () => {
         const projectDir = getProjectDir(input.projectPath);
-        const fs = getFs();
-        const slug = toSlug(input.name);
-        const componentName = toComponentName(input.name);
-        const config = SCAFFOLD_CONFIGS[input.type];
-        const directory = config.getDirectory(projectDir, slug);
-        const filename = config.getFilename(slug, componentName);
-        const filePath = join(directory, filename);
         try {
-            if (await fileExists(filePath)) {
-                return {
-                    success: false,
-                    files: [],
-                    message: `${input.type} already exists at ${filePath}`,
-                };
-            }
-            await ensureDir(directory);
-            const content = config.getContent(input.name, slug, componentName, input.methods);
-            await fs.writeTextFile(filePath, content);
-            return {
-                success: true,
-                files: [{ path: filePath, created: true }],
-                message: `Created ${input.type} "${input.name}" successfully`,
-            };
+            return await scaffoldProjectFile({
+                projectDir,
+                type: input.type,
+                name: input.name,
+                methods: input.methods,
+            });
         }
         catch (error) {
             return {
@@ -303,29 +132,31 @@ const CONVENTIONS = {
     ai: {
         topic: "AI / Agents",
         rules: [
-            "AI tools go in ai/tools/ directory",
-            "Agents go in ai/agents/ directory",
-            "Prompts go in ai/prompts/ directory",
+            "AI primitives live at the project root",
+            "Tools go in tools/ directory",
+            "Agents go in agents/ directory",
+            "Prompts go in prompts/ directory",
+            "Workflows go in workflows/ directory",
+            "Tasks go in tasks/ directory",
+            "Resources go in resources/ directory",
+            "Skills go in skills/<id>/SKILL.md",
             "Use defineSchema for tool parameter validation",
             "Tools should be focused on a single capability",
             "Agents combine tools with instructions for complex tasks",
         ],
         examples: [
             {
-                good: "ai/tools/search-docs.ts",
+                good: "tools/search-docs.ts",
                 explanation: "Tools in dedicated directory with descriptive names",
             },
             {
-                good: `const getParameters = defineSchema((v) => v.object({
+                good: `export default tool({
+  inputSchema: defineSchema((v) => v.object({
   query: v.string(),
-}));
-
-export const searchTool = {
-  name: "search_docs",
-  parameters: lazySchema(getParameters),
+}))(),
   execute: async ({ query }) => { /* ... */ }
-};`,
-                explanation: "Tool with lazy schema parameters and typed execute function",
+});`,
+                explanation: "Tool with schema-backed input and typed execute function",
             },
         ],
     },

package/esm/cli/scaffold/engine.d.ts

@@ -0,0 +1,33 @@
+export type ScaffoldRouter = "app-router" | "pages-router";
+export declare const SCAFFOLD_TYPES: readonly ["page", "api", "layout", "component", "tool", "agent", "prompt", "workflow", "task", "resource", "skill"];
+export type ScaffoldType = typeof SCAFFOLD_TYPES[number];
+export type ScaffoldHttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+export interface ScaffoldInput {
+    projectDir: string;
+    type: ScaffoldType;
+    name: string;
+    router?: ScaffoldRouter;
+    methods?: ScaffoldHttpMethod[];
+}
+export interface ScaffoldFilePlan {
+    path: string;
+    content: string;
+}
+export interface ScaffoldPlan {
+    type: ScaffoldType;
+    name: string;
+    files: ScaffoldFilePlan[];
+}
+export interface ScaffoldResult {
+    success: boolean;
+    files: Array<{
+        path: string;
+        created: boolean;
+    }>;
+    message: string;
+}
+export declare function isScaffoldType(type: string): type is ScaffoldType;
+export declare function planScaffold(input: ScaffoldInput): ScaffoldPlan;
+export declare function writeScaffoldPlan(plan: ScaffoldPlan): Promise<ScaffoldResult>;
+export declare function scaffoldProjectFile(input: ScaffoldInput): Promise<ScaffoldResult>;
+//# sourceMappingURL=engine.d.ts.map

package/esm/cli/scaffold/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/cli/scaffold/engine.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,cAAc,CAAC;AAC3D,eAAO,MAAM,cAAc,qHAYjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;CACjB;AA+ED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,YAAY,CAEjE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAa/D;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA2BnF;AAED,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAEvF"}