@hashicorp/kits 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,461 @@
+/**
+ * Core type definitions for the Kit Installer.
+ *
+ * These types define the harness-agnostic kit format and supporting structures.
+ */
+/**
+ * Supported primitive types that can be installed into AI agent harnesses.
+ */
+export type PrimitiveType = "commands" | "skills" | "subagents" | "mcp" | "hooks";
+/**
+ * All primitive types as an array for iteration.
+ */
+export declare const PRIMITIVE_TYPES: readonly PrimitiveType[];
+/**
+ * Supported AI agent harness identifiers.
+ */
+export type HarnessName = "claude-code" | "codex" | "gemini-cli" | "github-copilot" | "opencode";
+/**
+ * Installation scope determines where kits are installed.
+ * - "global": User-level installation, available in all projects (~/.agents/)
+ * - "project": Repository-level installation, version-controllable (.agents/)
+ */
+export type InstallationScope = "global" | "project";
+/**
+ * All installation scopes as an array for iteration.
+ */
+export declare const INSTALLATION_SCOPES: readonly InstallationScope[];
+/**
+ * All harness names as an array for iteration.
+ */
+export declare const HARNESS_NAMES: readonly HarnessName[];
+/**
+ * Product or platform identifiers for kits.
+ */
+export type ProductId = string;
+/**
+ * Kit registry entry in kits.json.
+ */
+export interface KitRegistryEntry {
+    name: string;
+    path: string;
+    description?: string;
+    version: string;
+    keywords?: string[];
+    products?: ProductId[];
+}
+/**
+ * Kit registry (kits.json) structure.
+ */
+export interface KitRegistry {
+    $schema?: string;
+    schemaVersion: string;
+    name: string;
+    description?: string;
+    version: string;
+    owner?: {
+        name: string;
+        url?: string;
+    };
+    repository?: string;
+    license?: string;
+    kits: KitRegistryEntry[];
+}
+/**
+ * Author information for a kit.
+ */
+export interface KitAuthor {
+    name: string;
+    email?: string;
+    url?: string;
+}
+/**
+ * Referenced primitive declaration using the ref syntax.
+ */
+export interface ReferencedPrimitive {
+    ref: string;
+    instanceName?: string;
+}
+/**
+ * Inline primitive declaration with entrypoint.
+ */
+export interface InlinePrimitive {
+    name: string;
+    description?: string;
+    entrypoint: string;
+    instanceName?: string;
+}
+/**
+ * A primitive declaration can be either referenced or inline.
+ */
+export type PrimitiveDeclaration = ReferencedPrimitive | InlinePrimitive;
+/**
+ * Hook primitive declaration (program + binding).
+ */
+export type HookPrimitiveDeclaration = (ReferencedPrimitive | InlinePrimitive) & {
+    binding: HookBinding;
+};
+/**
+ * Type guard for referenced primitives.
+ */
+export declare function isReferencedPrimitive(p: PrimitiveDeclaration): p is ReferencedPrimitive;
+/**
+ * Type guard for inline primitives.
+ */
+export declare function isInlinePrimitive(p: PrimitiveDeclaration): p is InlinePrimitive;
+/**
+ * Kit primitives organized by type.
+ */
+export interface KitPrimitives {
+    commands?: PrimitiveDeclaration[];
+    skills?: PrimitiveDeclaration[];
+    subagents?: PrimitiveDeclaration[];
+    mcp?: PrimitiveDeclaration[];
+    hooks?: HookPrimitiveDeclaration[];
+}
+/**
+ * Kit requirements declaration.
+ */
+export interface KitRequirements {
+    primitives: PrimitiveType[];
+}
+/**
+ * Kit manifest (kit.json) structure.
+ */
+export interface KitManifest {
+    $schema?: string;
+    schemaVersion: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: KitAuthor;
+    license?: string;
+    repository?: string;
+    homepage?: string;
+    keywords?: string[];
+    products?: ProductId[];
+    requires: KitRequirements;
+    primitives: KitPrimitives;
+}
+/**
+ * Primitive version entry in primitives.json.
+ */
+export interface PrimitiveVersionEntry {
+    version: string;
+    released: string;
+    changelog: string;
+    path: string;
+}
+/**
+ * Primitive entry in the primitives registry.
+ */
+export interface PrimitiveEntry {
+    description: string;
+    path: string;
+    versions: PrimitiveVersionEntry[];
+    latest: string;
+}
+/**
+ * Primitives organized by type in the registry.
+ */
+export interface PrimitivesByType {
+    commands?: Record<string, PrimitiveEntry>;
+    skills?: Record<string, PrimitiveEntry>;
+    subagents?: Record<string, PrimitiveEntry>;
+    mcp?: Record<string, PrimitiveEntry>;
+    hooks?: Record<string, PrimitiveEntry>;
+}
+/**
+ * Primitives registry (primitives.json) structure.
+ */
+export interface PrimitivesRegistry {
+    $schema?: string;
+    schemaVersion: string;
+    primitives: PrimitivesByType;
+}
+/**
+ * Resolved primitive after version resolution.
+ */
+export interface ResolvedPrimitive {
+    kitName?: string;
+    name: string;
+    type: PrimitiveType;
+    ref?: string;
+    resolvedVersion?: string;
+    sourcePath: string;
+    isInline: boolean;
+    metadata: PrimitiveMetadata;
+    instanceName?: string;
+    hookBinding?: HookBinding;
+    hookProgram?: HookProgramConfig;
+    hookProgramDir?: string;
+    hookEntryPath?: string;
+}
+/**
+ * Metadata extracted from primitive files.
+ */
+export interface PrimitiveMetadata {
+    description?: string;
+    [key: string]: unknown;
+}
+/**
+ * Command-specific metadata from frontmatter.
+ *
+ * Commands use the canonical format:
+ *
+ * ```markdown
+ * ---
+ * description: Brief description of the command (required)
+ * argumentHint: [OPTIONAL_ARGS] (optional)
+ * ---
+ *
+ * Command prompt content here.
+ * ```
+ *
+ * The `description` field is required and describes the command's purpose.
+ * The `argumentHint` field is optional and shows expected arguments (e.g., "[WORKSPACE]").
+ *
+ * Note: In YAML frontmatter, the field is `argumentHint` (camelCase).
+ */
+export interface CommandMetadata extends PrimitiveMetadata {
+    /**
+     * Required description of the command's purpose.
+     * Extracted from YAML frontmatter `description` field.
+     */
+    description: string;
+    /**
+     * Optional hint showing expected arguments.
+     * Extracted from YAML frontmatter `argumentHint` field.
+     * Example: "[WORKSPACE]", "<target>", "[FLAGS...]"
+     */
+    argumentHint?: string;
+}
+/**
+ * Skill-specific metadata from frontmatter.
+ */
+export interface SkillMetadata extends PrimitiveMetadata {
+    name: string;
+    description?: string;
+    allowedTools?: string[] | string;
+    hooks?: Record<string, unknown> | unknown[];
+}
+/**
+ * Subagent-specific metadata from frontmatter.
+ */
+export interface SubagentMetadata extends PrimitiveMetadata {
+    name: string;
+    description?: string;
+    allowedTools?: string[] | string;
+    disallowedTools?: string[] | string;
+    model?: string;
+    maxTurns?: number;
+    timeout?: number;
+    skills?: string[];
+    hooks?: Record<string, unknown> | unknown[];
+}
+/**
+ * Environment variable definition as declared in MCP server config.
+ * Matches schemas/mcp-server.schema.json envVarDefinition.
+ */
+export interface McpEnvVarDefinition {
+    description: string;
+    required: boolean;
+    sensitive: boolean;
+    default?: string;
+}
+/**
+ * HTTP header definition as declared in MCP server config.
+ * Matches schemas/mcp-server.schema.json headerDefinition.
+ */
+export interface McpHeaderDefinition {
+    description: string;
+    sensitive: boolean;
+    envVar?: string;
+    value?: string;
+    required?: boolean;
+}
+/**
+ * Resolved environment variable ready for adapter transformation.
+ * See PRD-001 FR-20.1.
+ */
+export interface ResolvedEnvVar {
+    name: string;
+    description: string;
+    required: boolean;
+    sensitive: boolean;
+    value?: string;
+    usePassthrough: boolean;
+    defaultValue?: string;
+    source: "default" | "cli-flag" | "user-input" | "environment" | "passthrough";
+}
+/**
+ * Resolved HTTP header ready for adapter transformation.
+ * See PRD-001 FR-21.1.
+ */
+export interface ResolvedHeader {
+    name: string;
+    description: string;
+    sensitive: boolean;
+    envVar?: string;
+    value?: string;
+    usePassthrough: boolean;
+}
+/**
+ * Adapter output for environment variables.
+ * Structure varies by harness - see PRD-001 FR-20.
+ */
+export interface EnvVarOutput {
+    [key: string]: unknown;
+}
+/**
+ * Adapter output for HTTP headers.
+ * Structure varies by harness - see PRD-001 FR-21.
+ */
+export interface HeaderOutput {
+    [key: string]: unknown;
+}
+/**
+ * Warning about environment variable status.
+ */
+export interface EnvVarWarning {
+    name: string;
+    message: string;
+    type: "missing-sensitive" | "missing-required";
+}
+/**
+ * Result of environment variable resolution for an MCP server.
+ */
+export interface EnvVarResolutionResult {
+    mcpServer: string;
+    resolved: ResolvedEnvVar[];
+    resolvedHeaders: ResolvedHeader[];
+    missingRequired: string[];
+    warnings: EnvVarWarning[];
+}
+/**
+ * STDIO transport configuration.
+ */
+export interface McpStdioTransport {
+    type: "stdio";
+    command: string;
+    args?: string[];
+    cwd?: string;
+}
+/**
+ * HTTP transport configuration with headers.
+ */
+export interface McpHttpTransport {
+    type: "http";
+    url: string;
+    headers?: Record<string, McpHeaderDefinition>;
+}
+/**
+ * MCP server transport can be stdio or HTTP.
+ */
+export type McpTransport = McpStdioTransport | McpHttpTransport;
+/**
+ * MCP server configuration with typed env and transport.
+ */
+export interface McpServerConfig {
+    name: string;
+    version: string;
+    description: string;
+    transport: McpTransport;
+    env?: Record<string, McpEnvVarDefinition>;
+    tools?: Record<string, {
+        description: string;
+    }>;
+    resources?: Record<string, {
+        description: string;
+        mimeType?: string;
+    }>;
+    prompts?: Record<string, {
+        description: string;
+    }>;
+    capabilities?: {
+        tools?: boolean;
+        resources?: boolean;
+        prompts?: boolean;
+    };
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Hook program runtime type.
+ */
+export type HookRuntimeType = "command" | "prompt" | "opencode-plugin";
+/**
+ * Hook program runtime configuration.
+ */
+export interface HookProgramRuntime {
+    type: HookRuntimeType;
+    entrypoint: string;
+    shell?: string;
+    working_directory?: string;
+    args?: string[];
+    timeout_ms?: number;
+}
+/**
+ * Hook program IO configuration.
+ */
+export interface HookProgramIO {
+    stdin: "json" | "none";
+    stdout: "json" | "none";
+    error_codes?: {
+        success?: number[];
+        warn?: number[];
+        block?: number[];
+    };
+}
+/**
+ * Hook program configuration.
+ */
+export interface HookProgramConfig {
+    name: string;
+    version: string;
+    description: string;
+    runtime: HookProgramRuntime;
+    io: HookProgramIO;
+    env?: Record<string, string>;
+    inputs?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Canonical hook events.
+ */
+export type HookEvent = "session.start" | "session.end" | "prompt.submit" | "tool.before" | "tool.after" | "permission.request" | "notification" | "compaction.before" | "subagent.start" | "subagent.stop" | "error";
+/**
+ * Hook binding matcher configuration.
+ */
+export interface HookBindingMatcher {
+    tool?: string;
+    command_pattern?: string;
+    file_pattern?: string;
+    prompt_pattern?: string;
+}
+/**
+ * Hook binding policy configuration.
+ */
+export interface HookBindingPolicy {
+    on_success?: "continue" | "warn" | "block";
+    on_failure?: "continue" | "warn" | "block";
+    on_timeout?: "continue" | "warn" | "block";
+}
+/**
+ * Hook binding runtime overrides.
+ */
+export interface HookBindingRuntime {
+    timeout_ms?: number;
+    working_directory?: string;
+    args?: string[];
+}
+/**
+ * Hook binding definition.
+ */
+export interface HookBinding {
+    event: HookEvent;
+    matcher?: HookBindingMatcher;
+    policy?: HookBindingPolicy;
+    runtime?: HookBindingRuntime;
+    env?: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/core/types.js

@@ -0,0 +1,42 @@
+/**
+ * Core type definitions for the Kit Installer.
+ *
+ * These types define the harness-agnostic kit format and supporting structures.
+ */
+/**
+ * All primitive types as an array for iteration.
+ */
+export const PRIMITIVE_TYPES = [
+    "commands",
+    "skills",
+    "subagents",
+    "mcp",
+    "hooks",
+];
+/**
+ * All installation scopes as an array for iteration.
+ */
+export const INSTALLATION_SCOPES = ["global", "project"];
+/**
+ * All harness names as an array for iteration.
+ */
+export const HARNESS_NAMES = [
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "github-copilot",
+    "opencode",
+];
+/**
+ * Type guard for referenced primitives.
+ */
+export function isReferencedPrimitive(p) {
+    return "ref" in p;
+}
+/**
+ * Type guard for inline primitives.
+ */
+export function isInlinePrimitive(p) {
+    return "name" in p && "entrypoint" in p;
+}
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,UAAU;IACV,QAAQ;IACR,WAAW;IACX,KAAK;IACL,OAAO;CACC,CAAC;AAcX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiC,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AAEhG;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,aAAa;IACb,OAAO;IACP,YAAY;IACZ,gBAAgB;IAChB,UAAU;CACF,CAAC;AA4EX;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAuB;IAC3D,OAAO,KAAK,IAAI,CAAC,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAuB;IACvD,OAAO,MAAM,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/core/upgrade-executor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Upgrade executor module.
+ *
+ * Handles the execution of primitive upgrades including backup, installation,
+ * manifest updates, and rollback on failure.
+ */
+import type { KitAdapter } from "../adapters/interface.js";
+import type { UpgradeCheck } from "../manifest/types.js";
+import type { InstallationManifest } from "../manifest/types.js";
+import type { PrimitivesRegistryLoader } from "../resolution/primitives-registry.js";
+import type { HarnessName, PrimitiveType } from "../core/types.js";
+/**
+ * Options for upgrade execution.
+ */
+export interface UpgradeOptions {
+    dryRun?: boolean;
+    onProgress?: (progress: UpgradeProgress) => void;
+    verbose?: boolean;
+}
+/**
+ * Progress information during upgrade.
+ */
+export interface UpgradeProgress {
+    phase: "backup" | "install" | "manifest" | "verify";
+    harness: HarnessName;
+    kit: string;
+    primitive: string;
+    currentVersion: string;
+    newVersion: string;
+    operation?: string | undefined;
+    destination?: string | undefined;
+}
+/**
+ * Result of a single primitive upgrade.
+ */
+export interface PrimitiveUpgradeResult {
+    primitive: string;
+    type: PrimitiveType;
+    harness: HarnessName;
+    kit: string;
+    currentVersion: string;
+    newVersion: string;
+    success: boolean;
+    backupPath?: string | undefined;
+    installedPath?: string | undefined;
+    error?: string | undefined;
+}
+/**
+ * Result of upgrade execution.
+ */
+export interface UpgradeExecutionResult {
+    success: boolean;
+    upgraded: PrimitiveUpgradeResult[];
+    failed: PrimitiveUpgradeResult[];
+    backupPaths: string[];
+    manifestUpdated: boolean;
+    error?: string;
+}
+/**
+ * Execute upgrades for selected primitives.
+ *
+ * @param upgrades - Array of upgrade checks to apply
+ * @param adapters - Map of adapter instances by harness name
+ * @param registry - Primitives registry loader
+ * @param manifest - Current installation manifest
+ * @param options - Upgrade options
+ * @returns Upgrade execution result
+ */
+export declare function executeUpgrades(upgrades: UpgradeCheck[], adapters: Map<HarnessName, KitAdapter>, registry: PrimitivesRegistryLoader, manifest: InstallationManifest, options?: UpgradeOptions): Promise<UpgradeExecutionResult>;
+//# sourceMappingURL=upgrade-executor.d.ts.map

package/dist/core/upgrade-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-executor.d.ts","sourceRoot":"","sources":["../../src/core/upgrade-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,sBAAsB,CAAC;AAG/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAe,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpD,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACnC,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAYD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,GAAG,CAAC,WAAW,EAAE,UAAU,CAAC,EACtC,QAAQ,EAAE,wBAAwB,EAClC,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAoGjC"}