@kuznai/inception-engine 0.16.0 → 0.18.0

package/dist/core/validation.js

@@ -1,6 +1,7 @@
 import { lstat, readFile, realpath, stat } from "node:fs/promises";
 import path from "node:path";
 import { UserError } from "../errors.js";
+import { parseFrontmatterDocument } from "./adapters/frontmatter.js";
 export function sourceAccessError(err, sourcePath) {
     const code = err.code;
     if (code === "ENOENT")
@@ -147,23 +148,6 @@ export function validateAgentRuleMarkdownPath(manifestPath, agentId) {
         throw new UserError("DEPLOY_FAILED", `agentRules entry "${manifestPath}" for agent "${agentId}" must point to a Markdown source file`);
     }
 }
-function trimMatchingQuotes(value) {
-    if ((value.startsWith('"') && value.endsWith('"')) ||
-        (value.startsWith("'") && value.endsWith("'"))) {
-        return value.slice(1, -1).trim();
-    }
-    return value;
-}
-function parseSimpleFrontmatterValue(field, rawValue, manifestPath) {
-    const value = trimMatchingQuotes(rawValue.trim());
-    if (value.length === 0) {
-        throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter field "${field}" must be a non-empty string`);
-    }
-    if (rawValue.trim() === "|" || rawValue.trim() === ">") {
-        throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter field "${field}" must be a single-line string`);
-    }
-    return value;
-}
 export async function validateSkillDefinitionFile(sourcePath, manifestPath) {
     await validateSourceFile(sourcePath, `${manifestPath}/SKILL.md`);
     let raw;
@@ -181,27 +165,26 @@ export async function validateSkillDefinitionFile(sourcePath, manifestPath) {
     if (closingIndex === -1) {
         throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md is missing the closing --- frontmatter delimiter`);
     }
-    let name = null;
-    let description = null;
-    for (const line of lines.slice(1, closingIndex)) {
-        const trimmed = line.trim();
-        if (trimmed.length === 0 || trimmed.startsWith("#"))
-            continue;
-        const match = /^([A-Za-z0-9_-]+)\s*:\s*(.*)$/.exec(line);
-        if (!match)
-            continue;
-        const [, key, rawValue] = match;
-        if (key === "name") {
-            name = parseSimpleFrontmatterValue("name", rawValue, manifestPath);
-        }
-        else if (key === "description") {
-            description = parseSimpleFrontmatterValue("description", rawValue, manifestPath);
-        }
-    }
-    if (name === null) {
-        throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter must include a non-empty "name" field`);
+    let attributes;
+    try {
+        const parsed = parseFrontmatterDocument(raw);
+        attributes = parsed.attributes;
     }
-    if (description === null) {
-        throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter must include a non-empty "description" field`);
+    catch (err) {
+        throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md has malformed YAML frontmatter: ${err instanceof Error ? err.message : String(err)}`);
     }
+    const validateField = (field) => {
+        const value = attributes[field];
+        if (value === undefined || value === null) {
+            throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter must include a non-empty "${field}" field`);
+        }
+        if (typeof value !== "string" || value.trim().length === 0) {
+            throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter field "${field}" must be a non-empty string`);
+        }
+        if (value.includes("\n") || value.includes("\r")) {
+            throw new UserError("DEPLOY_FAILED", `Skill "${manifestPath}" SKILL.md frontmatter field "${field}" must be a single-line string`);
+        }
+    };
+    validateField("name");
+    validateField("description");
 }

package/dist/schemas/manifest.d.ts

@@ -71,6 +71,10 @@ export declare const AgentRuleEntrySchema: z.ZodObject<{
         "github-copilot": "github-copilot";
     }>>>, z.ZodTransform<("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[], ("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[]>>;
     path: z.ZodString;
+    scope: z.ZodDefault<z.ZodEnum<{
+        global: "global";
+        repo: "repo";
+    }>>;
 }, z.core.$strip>;
 export declare const PermissionsEntrySchema: z.ZodObject<{
     name: z.ZodString;
@@ -84,6 +88,18 @@ export declare const PermissionsEntrySchema: z.ZodObject<{
     }>>>, z.ZodTransform<("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[], ("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[]>>;
     config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strip>;
+export declare const AgentDefinitionEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    agents: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+        "gemini-cli": "gemini-cli";
+        antigravity: "antigravity";
+        opencode: "opencode";
+        "github-copilot": "github-copilot";
+    }>>>, z.ZodTransform<("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[], ("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[]>>;
+    path: z.ZodString;
+}, z.core.$strip>;
 export declare const ManifestSchema: z.ZodObject<{
     skills: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -146,6 +162,10 @@ export declare const ManifestSchema: z.ZodObject<{
             "github-copilot": "github-copilot";
         }>>>, z.ZodTransform<("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[], ("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[]>>;
         path: z.ZodString;
+        scope: z.ZodDefault<z.ZodEnum<{
+            global: "global";
+            repo: "repo";
+        }>>;
     }, z.core.$strip>>>;
     permissions: z.ZodDefault<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
@@ -159,6 +179,18 @@ export declare const ManifestSchema: z.ZodObject<{
         }>>>, z.ZodTransform<("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[], ("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[]>>;
         config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     }, z.core.$strip>>>;
+    agentDefinitions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        agents: z.ZodPipe<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+            "gemini-cli": "gemini-cli";
+            antigravity: "antigravity";
+            opencode: "opencode";
+            "github-copilot": "github-copilot";
+        }>>>, z.ZodTransform<("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[], ("claude-code" | "codex" | "gemini-cli" | "antigravity" | "opencode" | "github-copilot")[]>>;
+        path: z.ZodString;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type SkillEntry = z.infer<typeof SkillEntrySchema>;
 export type FileEntry = z.infer<typeof FileEntrySchema>;
@@ -166,6 +198,7 @@ export type ConfigEntry = z.infer<typeof ConfigEntrySchema>;
 export type McpServerEntry = z.infer<typeof McpServerEntrySchema>;
 export type AgentRuleEntry = z.infer<typeof AgentRuleEntrySchema>;
 export type PermissionsEntry = z.infer<typeof PermissionsEntrySchema>;
+export type AgentDefinitionEntry = z.infer<typeof AgentDefinitionEntrySchema>;
 export type Manifest = z.infer<typeof ManifestSchema>;
 export declare const AgentListSchema: z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>, z.ZodArray<z.ZodPipe<z.ZodString, z.ZodEnum<{
     "claude-code": "claude-code";

package/dist/schemas/manifest.js

@@ -89,6 +89,10 @@ export const AgentRuleEntrySchema = z.object({
     agents: agentsField,
     // Relative path to the rules/instruction file within the source bundle.
     path: sourcePathField,
+    // Deployment scope: "global" targets the agent's home-directory instruction
+    // file (default), "repo" targets the project-root instruction file within the
+    // deployed repository (e.g. {repo}/CLAUDE.md for claude-code).
+    scope: z.enum(["global", "repo"]).default("global"),
 });
 export const PermissionsEntrySchema = z.object({
     name: nameField,
@@ -98,6 +102,14 @@ export const PermissionsEntrySchema = z.object({
     // For codex: { approval_policy?: "auto" | "manual" | "suggest" | "on-failure" }
     config: z.record(z.string(), z.unknown()),
 });
+export const AgentDefinitionEntrySchema = z.object({
+    name: nameField,
+    agents: agentsField,
+    // Relative path to the agent definition Markdown file within the source bundle.
+    // Must be a .md or .markdown file. Content and frontmatter structure are not
+    // validated by inception-engine — format requirements are agent-specific.
+    path: sourcePathField,
+});
 export const ManifestSchema = z.object({
     skills: z.array(SkillEntrySchema).superRefine((skills, ctx) => {
         const seen = new Set();
@@ -117,6 +129,7 @@ export const ManifestSchema = z.object({
     mcpServers: z.array(McpServerEntrySchema).default([]),
     agentRules: z.array(AgentRuleEntrySchema).default([]),
     permissions: z.array(PermissionsEntrySchema).default([]),
+    agentDefinitions: z.array(AgentDefinitionEntrySchema).default([]),
 });
 // Parses the --agents CLI flag: comma-separated agent IDs → AgentId[]
 export const AgentListSchema = z

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { AgentId } from "./schemas/manifest.ts";
-export type { AgentId, ConfigEntry, FileEntry, Manifest, SkillEntry, } from "./schemas/manifest.ts";
+export type { AgentDefinitionEntry, AgentId, ConfigEntry, FileEntry, Manifest, SkillEntry, } from "./schemas/manifest.ts";
 export interface AgentPaths {
     posix: string[];
     windows: string[];
@@ -16,25 +16,48 @@ export interface UnsupportedAgentSurface {
     schemaLabel: string;
     reason: string;
 }
-export type AgentSurfaceSupport = SupportedAgentSurface | UnsupportedAgentSurface;
+/**
+ * A surface that is confirmed as Copilot-specific and genuinely justified for
+ * future dedicated implementation, but not yet supported. Distinct from
+ * "unsupported" (which means the surface is either covered by another target or
+ * will never be added) so adapters can emit a forward-looking "planned" notice
+ * rather than a blocking skip warning.
+ */
+export interface PlannedAgentSurface {
+    status: "planned";
+    schemaLabel: string;
+    /** Short description of the concrete file / config surface to be implemented. */
+    plannedSurface: string;
+    reason: string;
+}
+export type AgentSurfaceSupport = SupportedAgentSurface | UnsupportedAgentSurface | PlannedAgentSurface;
 export interface AgentProvenance {
-    skills: Confidence;
+    /** Omit when the agent has no separate skill deployment path. */
+    skills?: Confidence;
     detectPaths: Confidence;
     detectBinary: Confidence;
     mcpConfig?: Confidence;
     agentRules?: Confidence;
     permissions?: Confidence;
+    agentDefinitions?: Confidence;
 }
 export interface AgentConfig {
     id: AgentId;
     displayName: string;
-    skills: AgentPaths;
+    /**
+     * The on-disk path template for deploying skills to this agent.
+     * Omit for agents that consume skills from another agent's path natively
+     * (e.g. GitHub Copilot reads `.claude/skills/` directly).
+     */
+    skills?: AgentPaths;
     detectPaths: AgentPaths;
     detectBinary: string | null;
     provenance: AgentProvenance;
     mcpSupport?: AgentSurfaceSupport;
     agentRulesSupport?: AgentSurfaceSupport;
+    agentRulesRepoSupport?: AgentSurfaceSupport;
     permissionsSupport?: AgentSurfaceSupport;
+    agentDefinitionsSupport?: AgentSurfaceSupport;
     policyNote?: string;
 }
 export interface PlanWarning {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuznai/inception-engine",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "description": "Deploy AI agent skills from a git repo to user home directories",
   "license": "MIT",
   "author": "Damian Piątkowski",
@@ -47,8 +47,8 @@
     "test:posix": "node --test --test-isolation=none test/unit/*.test.ts test/os/cross-platform/*.test.ts test/os/posix/*.test.ts"
   },
   "dependencies": {
-    "front-matter": "^4.0.2",
     "smol-toml": "^1.6.1",
+    "yaml": "^2.8.3",
     "zod": "^4.0.0"
   },
   "devDependencies": {