mewkit 1.14.1 → 1.16.0

package/dist/core/capability.d.ts

@@ -0,0 +1,519 @@
+import { z } from "zod";
+/** Capability kinds. Disk-enumerated: skill/agent/command/workflow/hook. Authored-only
+ * (no disk artifact, no frontmatter): tool/context-service/state-service. `rule` artifacts
+ * are inventory-only context and are deliberately NOT capabilities. */
+export declare const CapabilityKindSchema: z.ZodEnum<["skill", "agent", "command", "workflow", "hook", "tool", "context-service", "state-service"]>;
+export type CapabilityKind = z.infer<typeof CapabilityKindSchema>;
+/** Where a field's value came from. `unknown` is surfaced, never invented. */
+export declare const ProvenanceSchema: z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>;
+export type Provenance = z.infer<typeof ProvenanceSchema>;
+/** Typed logical requirement. `id` is a logical identifier (e.g. an external_binary maps
+ * to a system-dependency ID), never an executable command. */
+export declare const TypedRequirementSchema: z.ZodObject<{
+    type: z.ZodEnum<["host_tool", "mcp_or_app", "external_binary", "subagent_surface", "skill_script", "lifecycle_event", "file_or_config"]>;
+    id: z.ZodString;
+    provenance: z.ZodDefault<z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+    id: string;
+    provenance: "unknown" | "authored" | "inferred" | "adapter";
+}, {
+    type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+    id: string;
+    provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
+}>;
+export type TypedRequirement = z.infer<typeof TypedRequirementSchema>;
+/** A logical invocation contract. `id` must be a known logical invocation ID; adapters
+ * map it to a constant provider operation. `none` = not directly invocable (e.g. a hook). */
+export declare const InvocationSchema: z.ZodObject<{
+    kind: z.ZodEnum<["skill", "agent", "command", "workflow", "hook", "none"]>;
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+}, {
+    id: string;
+    kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+}>;
+export type Invocation = z.infer<typeof InvocationSchema>;
+/** The four independent host-support levels, per provider. Populated from adapter
+ * evidence only; absence ⇒ unknown. `invocable` at rest is static adapter capability —
+ * the resolver reports runtime invocability as pending until Phase 3's host snapshot. */
+export declare const SupportLevelsSchema: z.ZodObject<{
+    discoverable: z.ZodBoolean;
+    selectable: z.ZodBoolean;
+    invocable: z.ZodBoolean;
+    enforceable: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    discoverable: boolean;
+    selectable: boolean;
+    invocable: boolean;
+    enforceable: boolean;
+}, {
+    discoverable: boolean;
+    selectable: boolean;
+    invocable: boolean;
+    enforceable: boolean;
+}>;
+export type SupportLevels = z.infer<typeof SupportLevelsSchema>;
+/** Declares that a capability needs a bounded task-scoped repository-context envelope acquired
+ * BEFORE source-grounded work (Phase 5). This is an ORCHESTRATION precondition, not a host
+ * dependency: the envelope is acquired on demand (host-native read/search) and recorded, never
+ * probed for presence — so it is deliberately NOT a `TypedRequirement` (those feed availability
+ * adapters). `scope: "task-repo"` = evidence resolved per owning repo under the task boundary
+ * (multi-repo aware; see repo-context.ts). */
+export declare const ContextRequirementSchema: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodLiteral<"task-repo">>;
+    reason: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: "task-repo";
+    reason: string;
+}, {
+    scope?: "task-repo" | undefined;
+    reason?: string | undefined;
+}>;
+export type ContextRequirement = z.infer<typeof ContextRequirementSchema>;
+/** How to verify the capability did its job. `unknown` is explicit, not a silent gap. */
+export declare const VerificationSchema: z.ZodObject<{
+    kind: z.ZodEnum<["command", "file", "runtime", "none", "unknown"]>;
+    id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "unknown" | "none" | "command" | "file" | "runtime";
+    id?: string | undefined;
+}, {
+    kind: "unknown" | "none" | "command" | "file" | "runtime";
+    id?: string | undefined;
+}>;
+export type Verification = z.infer<typeof VerificationSchema>;
+export declare const CapabilityEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<["skill", "agent", "command", "workflow", "hook", "tool", "context-service", "state-service"]>;
+    description: z.ZodDefault<z.ZodString>;
+    aliases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    /** `.claude/`-relative source path, or null for authored kinds with no disk artifact. */
+    sourcePath: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Cross-reference to the matching InventoryEntry.id, or null for authored-only kinds. */
+    inventoryId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Denormalized from inventory for self-contained output; agreement is validated. */
+    owner: z.ZodDefault<z.ZodString>;
+    installedState: z.ZodDefault<z.ZodEnum<["installed", "absent", "unknown"]>>;
+    /** Bounded selection terms — authored for flagship flows, else inferred from keywords. */
+    intents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    whenToUse: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    invocation: z.ZodObject<{
+        kind: z.ZodEnum<["skill", "agent", "command", "workflow", "hook", "none"]>;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+    }, {
+        id: string;
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+    }>;
+    requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["host_tool", "mcp_or_app", "external_binary", "subagent_surface", "skill_script", "lifecycle_event", "file_or_config"]>;
+        id: z.ZodString;
+        provenance: z.ZodDefault<z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
+        provenance: "unknown" | "authored" | "inferred" | "adapter";
+    }, {
+        type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
+        provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
+    }>, "many">>;
+    /** Set when this capability must acquire a task-scoped repo-context envelope before
+     * source-grounded work (Phase 5). Null = no repo grounding needed. Orchestration-only —
+     * never fed to availability adapters. */
+    contextRequirement: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        scope: z.ZodDefault<z.ZodLiteral<"task-repo">>;
+        reason: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        scope: "task-repo";
+        reason: string;
+    }, {
+        scope?: "task-repo" | undefined;
+        reason?: string | undefined;
+    }>>>;
+    /** Per-provider support levels; absent provider ⇒ unknown support for that provider. */
+    support: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        discoverable: z.ZodBoolean;
+        selectable: z.ZodBoolean;
+        invocable: z.ZodBoolean;
+        enforceable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        discoverable: boolean;
+        selectable: boolean;
+        invocable: boolean;
+        enforceable: boolean;
+    }, {
+        discoverable: boolean;
+        selectable: boolean;
+        invocable: boolean;
+        enforceable: boolean;
+    }>>>;
+    verification: z.ZodDefault<z.ZodObject<{
+        kind: z.ZodEnum<["command", "file", "runtime", "none", "unknown"]>;
+        id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
+        id?: string | undefined;
+    }, {
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
+        id?: string | undefined;
+    }>>;
+    dependencies: z.ZodDefault<z.ZodObject<{
+        upstream: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        downstream: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        upstream: string[];
+        downstream: string[];
+    }, {
+        upstream?: string[] | undefined;
+        downstream?: string[] | undefined;
+    }>>;
+    /** field name → where that field's value came from. */
+    provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>>;
+}, "strip", z.ZodTypeAny, {
+    owner: string;
+    description: string;
+    verification: {
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
+        id?: string | undefined;
+    };
+    id: string;
+    provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
+    kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
+    aliases: string[];
+    sourcePath: string | null;
+    inventoryId: string | null;
+    installedState: "unknown" | "installed" | "absent";
+    intents: string[];
+    whenToUse: string | null;
+    invocation: {
+        id: string;
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+    };
+    requirements: {
+        type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
+        provenance: "unknown" | "authored" | "inferred" | "adapter";
+    }[];
+    contextRequirement: {
+        scope: "task-repo";
+        reason: string;
+    } | null;
+    support: Record<string, {
+        discoverable: boolean;
+        selectable: boolean;
+        invocable: boolean;
+        enforceable: boolean;
+    }>;
+    dependencies: {
+        upstream: string[];
+        downstream: string[];
+    };
+}, {
+    id: string;
+    kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
+    invocation: {
+        id: string;
+        kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+    };
+    owner?: string | undefined;
+    description?: string | undefined;
+    verification?: {
+        kind: "unknown" | "none" | "command" | "file" | "runtime";
+        id?: string | undefined;
+    } | undefined;
+    provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
+    aliases?: string[] | undefined;
+    sourcePath?: string | null | undefined;
+    inventoryId?: string | null | undefined;
+    installedState?: "unknown" | "installed" | "absent" | undefined;
+    intents?: string[] | undefined;
+    whenToUse?: string | null | undefined;
+    requirements?: {
+        type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+        id: string;
+        provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
+    }[] | undefined;
+    contextRequirement?: {
+        scope?: "task-repo" | undefined;
+        reason?: string | undefined;
+    } | null | undefined;
+    support?: Record<string, {
+        discoverable: boolean;
+        selectable: boolean;
+        invocable: boolean;
+        enforceable: boolean;
+    }> | undefined;
+    dependencies?: {
+        upstream?: string[] | undefined;
+        downstream?: string[] | undefined;
+    } | undefined;
+}>;
+export type CapabilityEntry = z.infer<typeof CapabilityEntrySchema>;
+export declare const CapabilityManifestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"1.0">;
+    entries: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<["skill", "agent", "command", "workflow", "hook", "tool", "context-service", "state-service"]>;
+        description: z.ZodDefault<z.ZodString>;
+        aliases: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        /** `.claude/`-relative source path, or null for authored kinds with no disk artifact. */
+        sourcePath: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** Cross-reference to the matching InventoryEntry.id, or null for authored-only kinds. */
+        inventoryId: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** Denormalized from inventory for self-contained output; agreement is validated. */
+        owner: z.ZodDefault<z.ZodString>;
+        installedState: z.ZodDefault<z.ZodEnum<["installed", "absent", "unknown"]>>;
+        /** Bounded selection terms — authored for flagship flows, else inferred from keywords. */
+        intents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        whenToUse: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        invocation: z.ZodObject<{
+            kind: z.ZodEnum<["skill", "agent", "command", "workflow", "hook", "none"]>;
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+        }, {
+            id: string;
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+        }>;
+        requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["host_tool", "mcp_or_app", "external_binary", "subagent_surface", "skill_script", "lifecycle_event", "file_or_config"]>;
+            id: z.ZodString;
+            provenance: z.ZodDefault<z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
+            provenance: "unknown" | "authored" | "inferred" | "adapter";
+        }, {
+            type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
+            provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
+        }>, "many">>;
+        /** Set when this capability must acquire a task-scoped repo-context envelope before
+         * source-grounded work (Phase 5). Null = no repo grounding needed. Orchestration-only —
+         * never fed to availability adapters. */
+        contextRequirement: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            scope: z.ZodDefault<z.ZodLiteral<"task-repo">>;
+            reason: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            scope: "task-repo";
+            reason: string;
+        }, {
+            scope?: "task-repo" | undefined;
+            reason?: string | undefined;
+        }>>>;
+        /** Per-provider support levels; absent provider ⇒ unknown support for that provider. */
+        support: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            discoverable: z.ZodBoolean;
+            selectable: z.ZodBoolean;
+            invocable: z.ZodBoolean;
+            enforceable: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            discoverable: boolean;
+            selectable: boolean;
+            invocable: boolean;
+            enforceable: boolean;
+        }, {
+            discoverable: boolean;
+            selectable: boolean;
+            invocable: boolean;
+            enforceable: boolean;
+        }>>>;
+        verification: z.ZodDefault<z.ZodObject<{
+            kind: z.ZodEnum<["command", "file", "runtime", "none", "unknown"]>;
+            id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        }, {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        }>>;
+        dependencies: z.ZodDefault<z.ZodObject<{
+            upstream: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+            downstream: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            upstream: string[];
+            downstream: string[];
+        }, {
+            upstream?: string[] | undefined;
+            downstream?: string[] | undefined;
+        }>>;
+        /** field name → where that field's value came from. */
+        provenance: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["authored", "inferred", "adapter", "unknown"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        owner: string;
+        description: string;
+        verification: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        };
+        id: string;
+        provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
+        aliases: string[];
+        sourcePath: string | null;
+        inventoryId: string | null;
+        installedState: "unknown" | "installed" | "absent";
+        intents: string[];
+        whenToUse: string | null;
+        invocation: {
+            id: string;
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+        };
+        requirements: {
+            type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
+            provenance: "unknown" | "authored" | "inferred" | "adapter";
+        }[];
+        contextRequirement: {
+            scope: "task-repo";
+            reason: string;
+        } | null;
+        support: Record<string, {
+            discoverable: boolean;
+            selectable: boolean;
+            invocable: boolean;
+            enforceable: boolean;
+        }>;
+        dependencies: {
+            upstream: string[];
+            downstream: string[];
+        };
+    }, {
+        id: string;
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
+        invocation: {
+            id: string;
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+        };
+        owner?: string | undefined;
+        description?: string | undefined;
+        verification?: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        } | undefined;
+        provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
+        aliases?: string[] | undefined;
+        sourcePath?: string | null | undefined;
+        inventoryId?: string | null | undefined;
+        installedState?: "unknown" | "installed" | "absent" | undefined;
+        intents?: string[] | undefined;
+        whenToUse?: string | null | undefined;
+        requirements?: {
+            type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
+            provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
+        }[] | undefined;
+        contextRequirement?: {
+            scope?: "task-repo" | undefined;
+            reason?: string | undefined;
+        } | null | undefined;
+        support?: Record<string, {
+            discoverable: boolean;
+            selectable: boolean;
+            invocable: boolean;
+            enforceable: boolean;
+        }> | undefined;
+        dependencies?: {
+            upstream?: string[] | undefined;
+            downstream?: string[] | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        owner: string;
+        description: string;
+        verification: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        };
+        id: string;
+        provenance: Record<string, "unknown" | "authored" | "inferred" | "adapter">;
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
+        aliases: string[];
+        sourcePath: string | null;
+        inventoryId: string | null;
+        installedState: "unknown" | "installed" | "absent";
+        intents: string[];
+        whenToUse: string | null;
+        invocation: {
+            id: string;
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+        };
+        requirements: {
+            type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
+            provenance: "unknown" | "authored" | "inferred" | "adapter";
+        }[];
+        contextRequirement: {
+            scope: "task-repo";
+            reason: string;
+        } | null;
+        support: Record<string, {
+            discoverable: boolean;
+            selectable: boolean;
+            invocable: boolean;
+            enforceable: boolean;
+        }>;
+        dependencies: {
+            upstream: string[];
+            downstream: string[];
+        };
+    }[];
+    schemaVersion: "1.0";
+}, {
+    entries: {
+        id: string;
+        kind: "skill" | "tool" | "agent" | "command" | "workflow" | "hook" | "context-service" | "state-service";
+        invocation: {
+            id: string;
+            kind: "skill" | "none" | "agent" | "command" | "workflow" | "hook";
+        };
+        owner?: string | undefined;
+        description?: string | undefined;
+        verification?: {
+            kind: "unknown" | "none" | "command" | "file" | "runtime";
+            id?: string | undefined;
+        } | undefined;
+        provenance?: Record<string, "unknown" | "authored" | "inferred" | "adapter"> | undefined;
+        aliases?: string[] | undefined;
+        sourcePath?: string | null | undefined;
+        inventoryId?: string | null | undefined;
+        installedState?: "unknown" | "installed" | "absent" | undefined;
+        intents?: string[] | undefined;
+        whenToUse?: string | null | undefined;
+        requirements?: {
+            type: "host_tool" | "mcp_or_app" | "external_binary" | "subagent_surface" | "skill_script" | "lifecycle_event" | "file_or_config";
+            id: string;
+            provenance?: "unknown" | "authored" | "inferred" | "adapter" | undefined;
+        }[] | undefined;
+        contextRequirement?: {
+            scope?: "task-repo" | undefined;
+            reason?: string | undefined;
+        } | null | undefined;
+        support?: Record<string, {
+            discoverable: boolean;
+            selectable: boolean;
+            invocable: boolean;
+            enforceable: boolean;
+        }> | undefined;
+        dependencies?: {
+            upstream?: string[] | undefined;
+            downstream?: string[] | undefined;
+        } | undefined;
+    }[];
+    schemaVersion: "1.0";
+}>;
+export type CapabilityManifest = z.infer<typeof CapabilityManifestSchema>;
+/** Known logical invocation IDs. Frontmatter may reference only these; adapter code maps
+ * each to a constant provider operation. A capability naming an ID outside this set is a
+ * validation error — hostile frontmatter cannot smuggle an executable string through. */
+export declare const KNOWN_INVOCATION_IDS: ReadonlySet<string>;
+//# sourceMappingURL=capability.d.ts.map

package/dist/core/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/core/capability.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;uEAEuE;AACvE,eAAO,MAAM,oBAAoB,0GAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,2DAAyD,CAAC;AACvF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;8DAC8D;AAC9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAYjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;6FAC6F;AAC7F,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D;;yFAEyF;AACzF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;8CAK8C;AAC9C,eAAO,MAAM,wBAAwB;;;;;;;;;EAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,yFAAyF;AACzF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;;;;IAKjC,yFAAyF;;IAEzF,0FAA0F;;IAE1F,qFAAqF;;;IAGrF,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;IAK1F;;6CAEyC;;;;;;;;;;;IAEzC,wFAAwF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMxF,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtD,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,wBAAwB;;;;;;;QA3BpC,yFAAyF;;QAEzF,0FAA0F;;QAE1F,qFAAqF;;;QAGrF,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;;;;QAK1F;;iDAEyC;;;;;;;;;;;QAEzC,wFAAwF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAMxF,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQtD,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;yFAEyF;AACzF,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAOnD,CAAC"}

package/dist/core/capability.js

@@ -0,0 +1,114 @@
+// Model-agnostic capability contract: one semantic entry per installed artifact (plus
+// authored external tools / repo-context-state services), mapping an artifact to safe
+// selection, logical invocation requirements, and verification. This is the resolution
+// view; `InventoryEntry` (build-inventory.ts) stays the installation/governance view and
+// the two reference each other by ID. Security invariant: frontmatter may name LOGICAL
+// requirement/invocation IDs only — never a command string or a provider-native tool
+// name. Trusted adapter code maps logical IDs to constant provider operations.
+import { z } from "zod";
+/** Capability kinds. Disk-enumerated: skill/agent/command/workflow/hook. Authored-only
+ * (no disk artifact, no frontmatter): tool/context-service/state-service. `rule` artifacts
+ * are inventory-only context and are deliberately NOT capabilities. */
+export const CapabilityKindSchema = z.enum([
+    "skill",
+    "agent",
+    "command",
+    "workflow",
+    "hook",
+    "tool",
+    "context-service",
+    "state-service",
+]);
+/** Where a field's value came from. `unknown` is surfaced, never invented. */
+export const ProvenanceSchema = z.enum(["authored", "inferred", "adapter", "unknown"]);
+/** Typed logical requirement. `id` is a logical identifier (e.g. an external_binary maps
+ * to a system-dependency ID), never an executable command. */
+export const TypedRequirementSchema = z.object({
+    type: z.enum([
+        "host_tool",
+        "mcp_or_app",
+        "external_binary",
+        "subagent_surface",
+        "skill_script",
+        "lifecycle_event",
+        "file_or_config",
+    ]),
+    id: z.string(),
+    provenance: ProvenanceSchema.default("inferred"),
+});
+/** A logical invocation contract. `id` must be a known logical invocation ID; adapters
+ * map it to a constant provider operation. `none` = not directly invocable (e.g. a hook). */
+export const InvocationSchema = z.object({
+    kind: z.enum(["skill", "agent", "command", "workflow", "hook", "none"]),
+    id: z.string(),
+});
+/** The four independent host-support levels, per provider. Populated from adapter
+ * evidence only; absence ⇒ unknown. `invocable` at rest is static adapter capability —
+ * the resolver reports runtime invocability as pending until Phase 3's host snapshot. */
+export const SupportLevelsSchema = z.object({
+    discoverable: z.boolean(),
+    selectable: z.boolean(),
+    invocable: z.boolean(),
+    enforceable: z.boolean(),
+});
+/** Declares that a capability needs a bounded task-scoped repository-context envelope acquired
+ * BEFORE source-grounded work (Phase 5). This is an ORCHESTRATION precondition, not a host
+ * dependency: the envelope is acquired on demand (host-native read/search) and recorded, never
+ * probed for presence — so it is deliberately NOT a `TypedRequirement` (those feed availability
+ * adapters). `scope: "task-repo"` = evidence resolved per owning repo under the task boundary
+ * (multi-repo aware; see repo-context.ts). */
+export const ContextRequirementSchema = z.object({
+    scope: z.literal("task-repo").default("task-repo"),
+    reason: z.string().default(""),
+});
+/** How to verify the capability did its job. `unknown` is explicit, not a silent gap. */
+export const VerificationSchema = z.object({
+    kind: z.enum(["command", "file", "runtime", "none", "unknown"]),
+    id: z.string().optional(),
+});
+export const CapabilityEntrySchema = z.object({
+    id: z.string(),
+    kind: CapabilityKindSchema,
+    description: z.string().default(""),
+    aliases: z.array(z.string()).default([]),
+    /** `.claude/`-relative source path, or null for authored kinds with no disk artifact. */
+    sourcePath: z.string().nullable().default(null),
+    /** Cross-reference to the matching InventoryEntry.id, or null for authored-only kinds. */
+    inventoryId: z.string().nullable().default(null),
+    /** Denormalized from inventory for self-contained output; agreement is validated. */
+    owner: z.string().default(""),
+    installedState: z.enum(["installed", "absent", "unknown"]).default("unknown"),
+    /** Bounded selection terms — authored for flagship flows, else inferred from keywords. */
+    intents: z.array(z.string()).default([]),
+    whenToUse: z.string().nullable().default(null),
+    invocation: InvocationSchema,
+    requirements: z.array(TypedRequirementSchema).default([]),
+    /** Set when this capability must acquire a task-scoped repo-context envelope before
+     * source-grounded work (Phase 5). Null = no repo grounding needed. Orchestration-only —
+     * never fed to availability adapters. */
+    contextRequirement: ContextRequirementSchema.nullable().default(null),
+    /** Per-provider support levels; absent provider ⇒ unknown support for that provider. */
+    support: z.record(z.string(), SupportLevelsSchema).default({}),
+    verification: VerificationSchema.default({ kind: "unknown" }),
+    dependencies: z
+        .object({ upstream: z.array(z.string()).default([]), downstream: z.array(z.string()).default([]) })
+        .default({ upstream: [], downstream: [] }),
+    /** field name → where that field's value came from. */
+    provenance: z.record(z.string(), ProvenanceSchema).default({}),
+});
+export const CapabilityManifestSchema = z.object({
+    schemaVersion: z.literal("1.0"),
+    entries: z.array(CapabilityEntrySchema),
+});
+/** Known logical invocation IDs. Frontmatter may reference only these; adapter code maps
+ * each to a constant provider operation. A capability naming an ID outside this set is a
+ * validation error — hostile frontmatter cannot smuggle an executable string through. */
+export const KNOWN_INVOCATION_IDS = new Set([
+    "invoke-skill",
+    "invoke-agent",
+    "invoke-command",
+    "invoke-workflow",
+    "lifecycle-hook",
+    "none",
+]);
+//# sourceMappingURL=capability.js.map

package/dist/core/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../src/core/capability.ts"],"names":[],"mappings":"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"}

package/dist/core/compute-checksums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compute-checksums.d.ts","sourceRoot":"","sources":["../../src/core/compute-checksums.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAsBD,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAe7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAyBnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CA0BzD;AAED,6BAA6B;AAC7B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGzE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ/D"}
+{"version":3,"file":"compute-checksums.d.ts","sourceRoot":"","sources":["../../src/core/compute-checksums.ts"],"names":[],"mappings":"AAIA,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,kBAAkB,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACzC;AAsBD,qCAAqC;AACrC,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAe7D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,CA0BzD;AAED,6BAA6B;AAC7B,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGzE;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ/D"}