@kuznai/inception-engine 0.18.0 → 0.19.0

package/dist/schemas/manifest.js

@@ -15,7 +15,7 @@ const SAFE_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
 // is valid, while "{home}/../.ssh/config" is rejected.
 // {repo} resolves to the manifest directory at deploy time, enabling repo-local
 // targets (e.g. Antigravity's .agents/rules/ surface).
-const TARGET_TEMPLATE_RE = /^\{(home|appdata|xdg_config|repo)\}(?:[\\/].*)?$/;
+const TARGET_TEMPLATE_RE = /^\{(home|appdata|xdg_config|repo|workspace)\}(?:[\\/].*)?$/;
 // Standalone schema used for type derivation and single-ID validation (e.g. index.ts).
 export const AgentIdSchema = z.enum(AGENT_IDS);
 // Used inside SkillEntrySchema.agents so that enum failures embed the received
@@ -88,11 +88,14 @@ export const AgentRuleEntrySchema = z.object({
     name: nameField,
     agents: agentsField,
     // Relative path to the rules/instruction file within the source bundle.
+    // Must be a .md or .markdown file. Structural requirements (e.g. YAML
+    // frontmatter) are validated per agent requirements by the adapter.
     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"),
+    // deployed repository (e.g. {repo}/CLAUDE.md for claude-code), and "workspace"
+    // targets the agent's workspace-local instruction surface.
+    scope: z.enum(["global", "repo", "workspace"]).default("global"),
 });
 export const PermissionsEntrySchema = z.object({
     name: nameField,
@@ -106,8 +109,8 @@ 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.
+    // Must be a .md or .markdown file. Structural requirements (e.g. YAML
+    // frontmatter) are validated per agent requirements by the adapter.
     path: sourcePathField,
 });
 export const ManifestSchema = z.object({

package/dist/schemas/registry.d.ts

@@ -46,6 +46,19 @@ declare const ConfigPatchRegistryEntrySchema: z.ZodObject<{
     }>;
     deployed: z.ZodString;
 }, z.core.$strip>;
+declare const FrontmatterEmitRegistryEntrySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"frontmatter-emit">;
+    skill: z.ZodString;
+    agent: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+        "gemini-cli": "gemini-cli";
+        antigravity: "antigravity";
+        opencode: "opencode";
+        "github-copilot": "github-copilot";
+    }>;
+    deployed: z.ZodString;
+}, z.core.$strip>;
 export declare const RegistryEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"skill-dir">;
     source: z.ZodString;
@@ -90,6 +103,18 @@ export declare const RegistryEntrySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "github-copilot": "github-copilot";
     }>;
     deployed: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"frontmatter-emit">;
+    skill: z.ZodString;
+    agent: z.ZodEnum<{
+        "claude-code": "claude-code";
+        codex: "codex";
+        "gemini-cli": "gemini-cli";
+        antigravity: "antigravity";
+        opencode: "opencode";
+        "github-copilot": "github-copilot";
+    }>;
+    deployed: z.ZodString;
 }, z.core.$strip>], "kind">;
 export declare const RegistrySchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
@@ -137,11 +162,24 @@ export declare const RegistrySchema: z.ZodObject<{
             "github-copilot": "github-copilot";
         }>;
         deployed: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"frontmatter-emit">;
+        skill: z.ZodString;
+        agent: z.ZodEnum<{
+            "claude-code": "claude-code";
+            codex: "codex";
+            "gemini-cli": "gemini-cli";
+            antigravity: "antigravity";
+            opencode: "opencode";
+            "github-copilot": "github-copilot";
+        }>;
+        deployed: z.ZodString;
     }, z.core.$strip>], "kind">>;
 }, z.core.$strip>;
 export type SkillDirRegistryEntry = z.infer<typeof SkillDirRegistryEntrySchema>;
 export type FileWriteRegistryEntry = z.infer<typeof FileWriteRegistryEntrySchema>;
 export type ConfigPatchRegistryEntry = z.infer<typeof ConfigPatchRegistryEntrySchema>;
+export type FrontmatterEmitRegistryEntry = z.infer<typeof FrontmatterEmitRegistryEntrySchema>;
 export type RegistryEntry = z.infer<typeof RegistryEntrySchema>;
 export type Registry = z.infer<typeof RegistrySchema>;
 export {};

package/dist/schemas/registry.js

@@ -23,10 +23,17 @@ const ConfigPatchRegistryEntrySchema = z.object({
     agent: AgentIdSchema,
     deployed: z.string(),
 });
+const FrontmatterEmitRegistryEntrySchema = z.object({
+    kind: z.literal("frontmatter-emit"),
+    skill: z.string(),
+    agent: AgentIdSchema,
+    deployed: z.string(),
+});
 export const RegistryEntrySchema = z.discriminatedUnion("kind", [
     SkillDirRegistryEntrySchema,
     FileWriteRegistryEntrySchema,
     ConfigPatchRegistryEntrySchema,
+    FrontmatterEmitRegistryEntrySchema,
 ]);
 export const RegistrySchema = z.object({
     version: z.literal(1),

package/dist/types.d.ts

@@ -7,6 +7,33 @@ export interface AgentPaths {
 export type Confidence = "documented" | "implementation-only" | "provisional";
 export interface SupportedAgentSurface {
     status: "supported";
+    /**
+     * Declares how this agent relates to the surface:
+     * - "agent-specific" (default when absent): the agent owns this surface
+     *   independently and deploy emits a normal action.
+     * - "native": the agent reads this surface autonomously without any deploy
+     *   action from inception-engine; no action is emitted.
+     * - "shared-via": this agent rides another agent's deployment. When the
+     *   primary agent (`via`) is also in the target list, deploy skips this
+     *   agent's action (the primary writes the shared file). When the primary
+     *   is absent, a guidance warning is emitted instead.
+     */
+    surfaceKind?: {
+        kind: "agent-specific";
+    } | {
+        kind: "native";
+    } | {
+        kind: "shared-via";
+        via: AgentId;
+        /**
+         * When true, this agent cannot deploy to the surface independently —
+         * the primary agent (`via`) must also be in the target list. If the
+         * primary is absent, a guidance warning is emitted and no action is
+         * generated. When false or absent, the agent can deploy to the surface
+         * on its own if the primary is not present.
+         */
+        requiresPrimary?: boolean;
+    };
     path: AgentPaths;
     schemaLabel: string;
     mcpPatchKey?: string;
@@ -50,15 +77,35 @@ export interface AgentConfig {
      * (e.g. GitHub Copilot reads `.claude/skills/` directly).
      */
     skills?: AgentPaths;
+    /**
+     * When `skills` is absent, this field explains why. Currently only
+     * "shared-via" is used — the agent reads skills from the `via` agent's
+     * deployment path natively and needs no separate skills deploy action.
+     */
+    skillsSurfaceKind?: {
+        kind: "shared-via";
+        via: AgentId;
+    };
     detectPaths: AgentPaths;
     detectBinary: string | null;
     provenance: AgentProvenance;
     mcpSupport?: AgentSurfaceSupport;
     agentRulesSupport?: AgentSurfaceSupport;
     agentRulesRepoSupport?: AgentSurfaceSupport;
+    agentRulesWorkspaceSupport?: AgentSurfaceSupport;
     permissionsSupport?: AgentSurfaceSupport;
     agentDefinitionsSupport?: AgentSurfaceSupport;
     policyNote?: string;
+    /**
+     * When true, instruction files deployed to this agent must include valid
+     * YAML frontmatter. Drives validateInstructionFileRequirements without
+     * hardcoded agent-ID checks.
+     */
+    instructionFrontmatterRequired?: boolean;
+    /**
+     * When true, preflight runs enterprise-policy detection for this agent.
+     */
+    enterprisePolicyDetection?: boolean;
 }
 export interface PlanWarning {
     kind: "confidence" | "collision" | "ambiguity";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuznai/inception-engine",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Deploy AI agent skills from a git repo to user home directories",
   "license": "MIT",
   "author": "Damian Piątkowski",