@corvus-tools/skill-manager-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Corvus Skill Manager contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/agents/AgentAdapter.d.ts

@@ -0,0 +1,11 @@
+export type AgentId = 'codex' | 'claude' | 'copilot' | 'opencode' | 'pi' | 'custom' | 'gemini';
+export type AgentSupportStatus = 'supported' | 'deferred' | 'custom' | 'unavailable';
+export interface AgentAdapter {
+    id: AgentId;
+    displayName: string;
+    supportStatus: AgentSupportStatus;
+    defaultTargetPath?: string;
+    notes?: string[];
+    warnings?: string[];
+}
+//# sourceMappingURL=AgentAdapter.d.ts.map

package/dist/agents/AgentAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentAdapter.d.ts","sourceRoot":"","sources":["../../src/agents/AgentAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/F,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC;AAErF,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,kBAAkB,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/agents/AgentAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AgentAdapter.js.map

package/dist/agents/AgentAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentAdapter.js","sourceRoot":"","sources":["../../src/agents/AgentAdapter.ts"],"names":[],"mappings":""}

package/dist/agents/adapters.d.ts

@@ -0,0 +1,44 @@
+import type { AgentAdapter, AgentId } from './AgentAdapter.js';
+export declare const agentAdapters: [{
+    readonly id: "codex";
+    readonly displayName: "OpenAI Codex CLI";
+    readonly supportStatus: "supported";
+    readonly defaultTargetPath: "~/.agents/skills";
+}, {
+    readonly id: "claude";
+    readonly displayName: "Claude Code";
+    readonly supportStatus: "supported";
+    readonly defaultTargetPath: "~/.claude/skills";
+}, {
+    readonly id: "copilot";
+    readonly displayName: "GitHub Copilot CLI";
+    readonly supportStatus: "supported";
+    readonly defaultTargetPath: "~/.copilot/skills";
+    readonly notes: ["Uses the implementation-plan Copilot CLI skill path strategy."];
+}, {
+    readonly id: "opencode";
+    readonly displayName: "OpenCode";
+    readonly supportStatus: "supported";
+    readonly defaultTargetPath: "~/.config/opencode/skills";
+    readonly notes: ["Uses the implementation-plan OpenCode skill path strategy."];
+}, {
+    readonly id: "pi";
+    readonly displayName: "Pi Agent";
+    readonly supportStatus: "supported";
+    readonly defaultTargetPath: "~/.pi/agent/skills";
+    readonly notes: ["Uses the implementation-plan Pi Agent skill path strategy."];
+}, {
+    readonly id: "custom";
+    readonly displayName: "Custom Agent";
+    readonly supportStatus: "custom";
+    readonly notes: ["Set a target path before planning links."];
+}, {
+    readonly id: "gemini";
+    readonly displayName: "Gemini CLI";
+    readonly supportStatus: "deferred";
+    readonly notes: ["Gemini custom command generation is deferred for MVP."];
+    readonly warnings: ["No .toml wrappers are generated in this MVP."];
+}];
+export declare function getAgentAdapters(): AgentAdapter[];
+export declare function getAgentAdapter(agentId: AgentId): AgentAdapter | undefined;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/agents/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,OAAO,EAAC,MAAM,mBAAmB,CAAC;AAE7D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CS,CAAC;AAEpC,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAG1E"}

package/dist/agents/adapters.js

@@ -0,0 +1,56 @@
+export const agentAdapters = [
+    {
+        id: 'codex',
+        displayName: 'OpenAI Codex CLI',
+        supportStatus: 'supported',
+        defaultTargetPath: '~/.agents/skills'
+    },
+    {
+        id: 'claude',
+        displayName: 'Claude Code',
+        supportStatus: 'supported',
+        defaultTargetPath: '~/.claude/skills'
+    },
+    {
+        id: 'copilot',
+        displayName: 'GitHub Copilot CLI',
+        supportStatus: 'supported',
+        defaultTargetPath: '~/.copilot/skills',
+        notes: ['Uses the implementation-plan Copilot CLI skill path strategy.']
+    },
+    {
+        id: 'opencode',
+        displayName: 'OpenCode',
+        supportStatus: 'supported',
+        defaultTargetPath: '~/.config/opencode/skills',
+        notes: ['Uses the implementation-plan OpenCode skill path strategy.']
+    },
+    {
+        id: 'pi',
+        displayName: 'Pi Agent',
+        supportStatus: 'supported',
+        defaultTargetPath: '~/.pi/agent/skills',
+        notes: ['Uses the implementation-plan Pi Agent skill path strategy.']
+    },
+    {
+        id: 'custom',
+        displayName: 'Custom Agent',
+        supportStatus: 'custom',
+        notes: ['Set a target path before planning links.']
+    },
+    {
+        id: 'gemini',
+        displayName: 'Gemini CLI',
+        supportStatus: 'deferred',
+        notes: ['Gemini custom command generation is deferred for MVP.'],
+        warnings: ['No .toml wrappers are generated in this MVP.']
+    }
+];
+export function getAgentAdapters() {
+    return agentAdapters.map((adapter) => ({ ...adapter }));
+}
+export function getAgentAdapter(agentId) {
+    const adapter = agentAdapters.find((candidate) => candidate.id === agentId);
+    return adapter === undefined ? undefined : { ...adapter };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/agents/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,kBAAkB;QAC/B,aAAa,EAAE,WAAW;QAC1B,iBAAiB,EAAE,kBAAkB;KACtC;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,aAAa;QAC1B,aAAa,EAAE,WAAW;QAC1B,iBAAiB,EAAE,kBAAkB;KACtC;IACD;QACE,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,oBAAoB;QACjC,aAAa,EAAE,WAAW;QAC1B,iBAAiB,EAAE,mBAAmB;QACtC,KAAK,EAAE,CAAC,+DAA+D,CAAC;KACzE;IACD;QACE,EAAE,EAAE,UAAU;QACd,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,WAAW;QAC1B,iBAAiB,EAAE,2BAA2B;QAC9C,KAAK,EAAE,CAAC,4DAA4D,CAAC;KACtE;IACD;QACE,EAAE,EAAE,IAAI;QACR,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,WAAW;QAC1B,iBAAiB,EAAE,oBAAoB;QACvC,KAAK,EAAE,CAAC,4DAA4D,CAAC;KACtE;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,cAAc;QAC3B,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,CAAC,0CAA0C,CAAC;KACpD;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,YAAY;QACzB,aAAa,EAAE,UAAU;QACzB,KAAK,EAAE,CAAC,uDAAuD,CAAC;QAChE,QAAQ,EAAE,CAAC,8CAA8C,CAAC;KAC3D;CACgC,CAAC;AAEpC,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAC,GAAG,OAAO,EAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC5E,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAC,GAAG,OAAO,EAAC,CAAC;AAC1D,CAAC"}

package/dist/config/configSchema.d.ts

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+export declare const agentIdSchema: z.ZodEnum<["codex", "claude", "copilot", "opencode", "pi", "custom", "gemini"]>;
+export declare const skillpackConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    repositoryUrl: z.ZodString;
+    branch: z.ZodString;
+    checkoutPath: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    repositoryUrl: string;
+    branch: string;
+    checkoutPath: string;
+}, {
+    id: string;
+    repositoryUrl: string;
+    branch: string;
+    checkoutPath: string;
+}>;
+export declare const agentConfigSchema: z.ZodObject<{
+    enabled: z.ZodBoolean;
+    targetPath: z.ZodOptional<z.ZodString>;
+    selectedSkillIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    enabled: boolean;
+    selectedSkillIds: string[];
+    targetPath?: string | undefined;
+}, {
+    enabled: boolean;
+    targetPath?: string | undefined;
+    selectedSkillIds?: string[] | undefined;
+}>;
+export declare const managerConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    managerStateDir: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    skillpack: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        repositoryUrl: z.ZodString;
+        branch: z.ZodString;
+        checkoutPath: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        repositoryUrl: string;
+        branch: string;
+        checkoutPath: string;
+    }, {
+        id: string;
+        repositoryUrl: string;
+        branch: string;
+        checkoutPath: string;
+    }>>;
+    agents: z.ZodOptional<z.ZodRecord<z.ZodEnum<["codex", "claude", "copilot", "opencode", "pi", "custom", "gemini"]>, z.ZodObject<{
+        enabled: z.ZodBoolean;
+        targetPath: z.ZodOptional<z.ZodString>;
+        selectedSkillIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        enabled: boolean;
+        selectedSkillIds: string[];
+        targetPath?: string | undefined;
+    }, {
+        enabled: boolean;
+        targetPath?: string | undefined;
+        selectedSkillIds?: string[] | undefined;
+    }>>>;
+}, "strict", z.ZodTypeAny, {
+    version: 1;
+    managerStateDir: string;
+    createdAt: string;
+    updatedAt: string;
+    skillpack?: {
+        id: string;
+        repositoryUrl: string;
+        branch: string;
+        checkoutPath: string;
+    } | undefined;
+    agents?: Partial<Record<"codex" | "claude" | "copilot" | "opencode" | "pi" | "custom" | "gemini", {
+        enabled: boolean;
+        selectedSkillIds: string[];
+        targetPath?: string | undefined;
+    }>> | undefined;
+}, {
+    version: 1;
+    managerStateDir: string;
+    createdAt: string;
+    updatedAt: string;
+    skillpack?: {
+        id: string;
+        repositoryUrl: string;
+        branch: string;
+        checkoutPath: string;
+    } | undefined;
+    agents?: Partial<Record<"codex" | "claude" | "copilot" | "opencode" | "pi" | "custom" | "gemini", {
+        enabled: boolean;
+        targetPath?: string | undefined;
+        selectedSkillIds?: string[] | undefined;
+    }>> | undefined;
+}>;
+export type AgentConfig = z.infer<typeof agentConfigSchema>;
+export type AgentIdConfig = z.infer<typeof agentIdSchema>;
+export type SkillpackConfig = z.infer<typeof skillpackConfigSchema>;
+export type ManagerConfig = z.infer<typeof managerConfigSchema>;
+export declare function parseManagerConfig(value: unknown): ManagerConfig;
+export declare function parseSkillpackConfig(value: unknown): SkillpackConfig;
+export declare function createDefaultManagerConfig(options: {
+    managerStateDir: string;
+    now?: Date;
+}): ManagerConfig;
+//# sourceMappingURL=configSchema.d.ts.map

package/dist/config/configSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchema.d.ts","sourceRoot":"","sources":["../../src/config/configSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,aAAa,iFAA+E,CAAC;AAE1G,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAUvB,CAAC;AAEZ,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAMnB,CAAC;AAEZ,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASrB,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAEhE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAEpE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,aAAa,CAShB"}

package/dist/config/configSchema.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+export const agentIdSchema = z.enum(['codex', 'claude', 'copilot', 'opencode', 'pi', 'custom', 'gemini']);
+export const skillpackConfigSchema = z
+    .object({
+    id: z
+        .string()
+        .min(1)
+        .regex(/^[a-zA-Z0-9._-]+$/, 'Use only letters, numbers, dots, underscores, and hyphens.'),
+    repositoryUrl: z.string().min(1),
+    branch: z.string().min(1),
+    checkoutPath: z.string().min(1)
+})
+    .strict();
+export const agentConfigSchema = z
+    .object({
+    enabled: z.boolean(),
+    targetPath: z.string().min(1).optional(),
+    selectedSkillIds: z.array(z.string().min(1)).default([])
+})
+    .strict();
+export const managerConfigSchema = z
+    .object({
+    version: z.literal(1),
+    managerStateDir: z.string().min(1),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    skillpack: skillpackConfigSchema.optional(),
+    agents: z.record(agentIdSchema, agentConfigSchema).optional()
+})
+    .strict();
+export function parseManagerConfig(value) {
+    return managerConfigSchema.parse(value);
+}
+export function parseSkillpackConfig(value) {
+    return skillpackConfigSchema.parse(value);
+}
+export function createDefaultManagerConfig(options) {
+    const timestamp = (options.now ?? new Date()).toISOString();
+    return {
+        version: 1,
+        managerStateDir: options.managerStateDir,
+        createdAt: timestamp,
+        updatedAt: timestamp
+    };
+}
+//# sourceMappingURL=configSchema.js.map

package/dist/config/configSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configSchema.js","sourceRoot":"","sources":["../../src/config/configSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE1G,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,KAAK,CAAC,mBAAmB,EAAE,4DAA4D,CAAC;IAC3F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAChC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACzD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC;KACD,MAAM,EAAE,CAAC;AAOZ,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,OAG1C;IACC,MAAM,SAAS,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE5D,OAAO;QACL,OAAO,EAAE,CAAC;QACV,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,SAAS,EAAE,SAAS;QACpB,SAAS,EAAE,SAAS;KACrB,CAAC;AACJ,CAAC"}

package/dist/config/configStore.d.ts

@@ -0,0 +1,24 @@
+import { type ManagerConfig } from './configSchema.js';
+export interface ConfigStoreOptions {
+    homeDir?: string;
+    managerStateDir?: string;
+    configPath?: string;
+    now?: Date;
+}
+export interface ConfigLoadResult {
+    config: ManagerConfig;
+    configPath: string;
+    managerStateDir: string;
+    created: boolean;
+    migrated: boolean;
+}
+interface ConfigMigrationResult {
+    config: ManagerConfig;
+    migrated: boolean;
+}
+export declare function loadConfig(configPath: string): Promise<ManagerConfig>;
+export declare function saveConfig(config: ManagerConfig, options?: Pick<ConfigStoreOptions, 'configPath'>): Promise<void>;
+export declare function ensureDefaultConfig(options?: ConfigStoreOptions): Promise<ConfigLoadResult>;
+export declare function migrateLoadedConfig(config: ManagerConfig, options?: Pick<ConfigStoreOptions, 'homeDir' | 'now'>): ConfigMigrationResult;
+export {};
+//# sourceMappingURL=configStore.d.ts.map

package/dist/config/configStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.d.ts","sourceRoot":"","sources":["../../src/config/configStore.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,qBAAqB;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAqBD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAG3E;AAED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAM,GACnD,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAsB,mBAAmB,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiCrG;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,KAAK,CAAM,GACxD,qBAAqB,CA0BvB"}

package/dist/config/configStore.js

@@ -0,0 +1,77 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { assertPathInside, configFileName, defaultManagerStateDir, defaultSkillpackCheckoutPath, resolveUserPath } from '../paths.js';
+import { defaultSkillpackId, defaultSkillpackRepositoryUrl } from '../skillpackDefaults.js';
+import { createDefaultManagerConfig, parseManagerConfig } from './configSchema.js';
+function resolveStorePaths(options = {}) {
+    const homeDir = options.homeDir;
+    const managerStateDir = resolveUserPath(options.managerStateDir ?? (homeDir === undefined ? defaultManagerStateDir() : defaultManagerStateDir(homeDir)), homeDir);
+    const configPath = resolveUserPath(options.configPath ?? path.join(managerStateDir, configFileName), homeDir);
+    assertPathInside(managerStateDir, configPath);
+    return { managerStateDir, configPath };
+}
+export async function loadConfig(configPath) {
+    const rawConfig = await fs.readFile(configPath, 'utf8');
+    return parseManagerConfig(JSON.parse(rawConfig));
+}
+export async function saveConfig(config, options = {}) {
+    const parsedConfig = parseManagerConfig(config);
+    const configPath = resolveUserPath(options.configPath ?? path.join(parsedConfig.managerStateDir, configFileName));
+    assertPathInside(parsedConfig.managerStateDir, configPath);
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, `${JSON.stringify(parsedConfig, null, 2)}\n`, 'utf8');
+}
+export async function ensureDefaultConfig(options = {}) {
+    const { managerStateDir, configPath } = resolveStorePaths(options);
+    try {
+        const config = await loadConfig(configPath);
+        const migrationOptions = {};
+        if (options.homeDir !== undefined) {
+            migrationOptions.homeDir = options.homeDir;
+        }
+        if (options.now !== undefined) {
+            migrationOptions.now = options.now;
+        }
+        const migration = migrateLoadedConfig(config, migrationOptions);
+        if (migration.migrated) {
+            await saveConfig(migration.config, { configPath });
+        }
+        return { config: migration.config, configPath, managerStateDir, created: false, migrated: migration.migrated };
+    }
+    catch (error) {
+        if (!isMissingFileError(error)) {
+            throw error;
+        }
+    }
+    const config = createDefaultManagerConfig(options.now === undefined ? { managerStateDir } : { managerStateDir, now: options.now });
+    await saveConfig(config, { configPath });
+    return { config, configPath, managerStateDir, created: true, migrated: false };
+}
+export function migrateLoadedConfig(config, options = {}) {
+    if (config.skillpack === undefined) {
+        return { config, migrated: false };
+    }
+    const legacyCheckoutPath = path.join(resolveUserPath(config.managerStateDir, options.homeDir), 'skills');
+    const configuredCheckoutPath = resolveUserPath(config.skillpack.checkoutPath, options.homeDir);
+    const shouldMigrateLegacyDefaultSkillpack = config.skillpack.id === defaultSkillpackId &&
+        config.skillpack.repositoryUrl === defaultSkillpackRepositoryUrl &&
+        configuredCheckoutPath === legacyCheckoutPath;
+    if (!shouldMigrateLegacyDefaultSkillpack) {
+        return { config, migrated: false };
+    }
+    const nextConfig = {
+        ...config,
+        updatedAt: (options.now ?? new Date()).toISOString(),
+        skillpack: {
+            ...config.skillpack,
+            checkoutPath: defaultSkillpackCheckoutPath(config.skillpack.id, options.homeDir)
+        }
+    };
+    return { config: nextConfig, migrated: true };
+}
+function isMissingFileError(error) {
+    return (error instanceof Error &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+//# sourceMappingURL=configStore.js.map

package/dist/config/configStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configStore.js","sourceRoot":"","sources":["../../src/config/configStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,IAAI,EAAE,EAAC,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,cAAc,EAEd,sBAAsB,EACtB,4BAA4B,EAC5B,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,kBAAkB,EAClB,6BAA6B,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,0BAA0B,EAC1B,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAsB3B,SAAS,iBAAiB,CAAC,UAA8B,EAAE;IAIzD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,eAAe,GAAG,eAAe,CACrC,OAAO,CAAC,eAAe,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,EAC/G,OAAO,CACR,CAAC;IACF,MAAM,UAAU,GAAG,eAAe,CAChC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,cAAc,CAAC,EAChE,OAAO,CACR,CAAC;IAEF,gBAAgB,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAE9C,OAAO,EAAC,eAAe,EAAE,UAAU,EAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACxD,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAqB,EACrB,UAAkD,EAAE;IAEpD,MAAM,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,eAAe,CAChC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,eAAe,EAAE,cAAc,CAAC,CAC9E,CAAC;IAEF,gBAAgB,CAAC,YAAY,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,UAA8B,EAAE;IACxE,MAAM,EAAC,eAAe,EAAE,UAAU,EAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAEjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,gBAAgB,GAAgD,EAAE,CAAC;QAEzE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,gBAAgB,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC7C,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC9B,gBAAgB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACrC,CAAC;QAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAEhE,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,UAAU,CAAC,SAAS,CAAC,MAAM,EAAE,EAAC,UAAU,EAAC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,EAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAC,CAAC;IAC/G,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,0BAA0B,CACvC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAC,eAAe,EAAC,CAAC,CAAC,CAAC,EAAC,eAAe,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAC,CACpF,CAAC;IACF,MAAM,UAAU,CAAC,MAAM,EAAE,EAAC,UAAU,EAAC,CAAC,CAAC;IACvC,OAAO,EAAC,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAqB,EACrB,UAAuD,EAAE;IAEzD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;IACnC,CAAC;IAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IACzG,MAAM,sBAAsB,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/F,MAAM,mCAAmC,GACvC,MAAM,CAAC,SAAS,CAAC,EAAE,KAAK,kBAAkB;QAC1C,MAAM,CAAC,SAAS,CAAC,aAAa,KAAK,6BAA6B;QAChE,sBAAsB,KAAK,kBAAkB,CAAC;IAEhD,IAAI,CAAC,mCAAmC,EAAE,CAAC;QACzC,OAAO,EAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC;IACnC,CAAC;IAED,MAAM,UAAU,GAAkB;QAChC,GAAG,MAAM;QACT,SAAS,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;QACpD,SAAS,EAAE;YACT,GAAG,MAAM,CAAC,SAAS;YACnB,YAAY,EAAE,4BAA4B,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC;SACjF;KACF,CAAC;IAEF,OAAO,EAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC;AAC9C,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,CACL,KAAK,YAAY,KAAK;QACtB,MAAM,IAAI,KAAK;QACd,KAA+B,CAAC,IAAI,KAAK,QAAQ,CACnD,CAAC;AACJ,CAAC"}

package/dist/git/gitRunner.d.ts

@@ -0,0 +1,10 @@
+export interface GitRunOptions {
+    cwd?: string;
+}
+export interface GitRunResult {
+    stdout: string;
+    stderr: string;
+}
+export type GitRunner = (args: string[], options?: GitRunOptions) => Promise<GitRunResult>;
+export declare const runGit: GitRunner;
+//# sourceMappingURL=gitRunner.d.ts.map

package/dist/git/gitRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitRunner.d.ts","sourceRoot":"","sources":["../../src/git/gitRunner.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3F,eAAO,MAAM,MAAM,EAAE,SAsBpB,CAAC"}

package/dist/git/gitRunner.js

@@ -0,0 +1,23 @@
+import { execa } from 'execa';
+export const runGit = async (args, options = {}) => {
+    const execaOptions = options.cwd === undefined ?
+        {
+            env: {
+                GIT_OPTIONAL_LOCKS: '0'
+            }
+        } :
+        {
+            cwd: options.cwd,
+            env: {
+                GIT_OPTIONAL_LOCKS: '0'
+            }
+        };
+    const result = await execa('git', args, {
+        ...execaOptions
+    });
+    return {
+        stdout: result.stdout,
+        stderr: result.stderr
+    };
+};
+//# sourceMappingURL=gitRunner.js.map

package/dist/git/gitRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitRunner.js","sourceRoot":"","sources":["../../src/git/gitRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAC,MAAM,OAAO,CAAC;AAa5B,MAAM,CAAC,MAAM,MAAM,GAAc,KAAK,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE;IAC5D,MAAM,YAAY,GAChB,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;QACzB;YACE,GAAG,EAAE;gBACH,kBAAkB,EAAE,GAAG;aACxB;SACF,CAAC,CAAC;QACH;YACE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE;gBACH,kBAAkB,EAAE,GAAG;aACxB;SACF,CAAC;IACN,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;QACtC,GAAG,YAAY;KAChB,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC,CAAC"}

package/dist/git/skillpackSetup.d.ts

@@ -0,0 +1,37 @@
+import { type SkillpackConfig } from '../config/configSchema.js';
+import { type GitRunner } from './gitRunner.js';
+export type CheckoutStatus = 'checkout-missing' | 'checkout-readable' | 'checkout-dirty' | 'checkout-unreadable';
+export interface SkillpackInspection {
+    status: CheckoutStatus;
+    checkoutPath: string;
+    exists: boolean;
+    readable: boolean;
+    commitHash?: string;
+    dirty: boolean;
+    dirtyFiles: string[];
+    message: string;
+}
+export type SkillpackSetupStatus = CheckoutStatus | 'clone-complete' | 'clone-failed';
+export interface SkillpackSetupResult {
+    status: SkillpackSetupStatus;
+    config: SkillpackConfig;
+    checkoutPath: string;
+    lockPath?: string;
+    commitHash?: string;
+    dirty: boolean;
+    dirtyFiles: string[];
+    message: string;
+}
+export interface SkillpackSetupOptions {
+    config: SkillpackConfig;
+    managerStateDir: string;
+    homeDir?: string;
+    git?: GitRunner;
+    now?: Date;
+}
+export declare function inspectSkillpackCheckout(checkoutPath: string, options?: {
+    homeDir?: string;
+    git?: GitRunner;
+}): Promise<SkillpackInspection>;
+export declare function applyInitialSkillpackSetup(options: SkillpackSetupOptions): Promise<SkillpackSetupResult>;
+//# sourceMappingURL=skillpackSetup.d.ts.map

package/dist/git/skillpackSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillpackSetup.d.ts","sourceRoot":"","sources":["../../src/git/skillpackSetup.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,EAAC,KAAK,SAAS,EAAS,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,mBAAmB,GACnB,gBAAgB,GAChB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,SAAS,CAAA;CAAM,GAChD,OAAO,CAAC,mBAAmB,CAAC,CAkE9B;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAwF/B"}