@soulcraft/sdk 3.4.2 → 3.6.0

package/dist/modules/skills/types.d.ts

@@ -2,120 +2,97 @@
  * @module modules/skills/types
  * @description Type definitions for `sdk.skills.*` — the skill loading and registry system.
  *
- * Skills are Markdown files (SKILL.md convention) that define an AI persona,
- * capabilities, glossary, and workflow steps for a specific domain. They drive
- * Brainy AI system prompt construction and define what Claude knows how to do
- * within a kit's context.
+ * Skills are SKILL.md files stored at `/.soulcraft/skills/{id}/SKILL.md` in the Brainy VFS.
+ * Each skill is a directory containing a SKILL.md with YAML frontmatter and markdown
+ * instructions that define an AI persona, capabilities, or workflow.
  *
- * Skills are stored in the Brainy VFS at `/skills/{kitId}/{skillId}.md`,
- * installed by the kit initialization pipeline or via `sdk.skills.install()`.
+ * Skills are workspace-scoped — seeded from the kit at creation time and customizable
+ * per workspace. All products (Workshop, Venue, Academy, Pulse) read from the same path.
  *
- * ## Skill ID convention
+ * ## Skill types (via `type:` frontmatter)
+ * - `background` — passive knowledge, always loaded into AI context
+ * - `active` — user and/or AI can invoke
  *
- * Skill IDs are kebab-case strings matching the `id:` frontmatter field in the
- * SKILL.md file. Examples: `'inventory-health'`, `'session-flow'`, `'daily-brief'`.
+ * ## Path convention
+ * ```
+ * /.soulcraft/skills/{skill-id}/SKILL.md
+ * ```
  */
 /**
- * A parsed skill loaded from VFS or an in-memory test registry.
+ * @description A parsed skill loaded from VFS or an in-memory test registry.
  */
 export interface Skill {
-    /** Kebab-case skill identifier (matches the `id:` frontmatter field). */
+    /** Kebab-case skill identifier (matches the directory name and `id:` frontmatter). */
     id: string;
-    /** The kit this skill belongs to (`null` for global/shared skills). */
-    kitId: string | null;
-    /** The full SKILL.md content including YAML frontmatter. */
+    /** The full SKILL.md content including YAML frontmatter and markdown instructions. */
     content: string;
     /** Where this skill was loaded from. */
     source: 'vfs' | 'bundled';
 }
 /**
- * Options for listing skills.
+ * @description Options for listing skills.
  */
 export interface SkillListOptions {
-    /**
-     * Filter by kit ID. When omitted, all skills across all kits are returned.
-     */
-    kitId?: string;
-    /**
-     * Whether to include VFS-installed skills in the results.
-     *
-     * @default true
-     */
-    includeVfs?: boolean;
-    /**
-     * Whether to include skills from the test registry (when provided) in results.
-     *
-     * @default true
-     */
-    includeBundled?: boolean;
+    /** Reserved for future filtering. */
+    _?: never;
 }
 /**
- * Options for installing a skill into the VFS.
+ * @description Options for installing a skill into the VFS.
  */
 export interface SkillInstallOptions {
-    /** The skill ID (kebab-case). */
+    /** The skill ID (kebab-case). Becomes the directory name. */
     id: string;
-    /** The kit this skill belongs to. */
-    kitId: string;
     /** The full SKILL.md content including YAML frontmatter. */
     content: string;
 }
 /**
- * The `sdk.skills` namespace.
+ * @description The `sdk.skills` namespace.
  *
  * Provides a unified interface for loading, listing, and installing skills
- * from the Brainy VFS.
+ * from the Brainy VFS at `/.soulcraft/skills/`.
  *
  * @example Loading a specific skill
  * ```typescript
- * const skill = await sdk.skills.load('inventory-health', 'wicks-and-whiskers')
+ * const skill = await sdk.skills.load('candle-expertise')
  * if (skill) {
- *   const systemPrompt = buildSystemPrompt(kit, [skill.content])
+ *   const systemPrompt = buildSystemPrompt([skill.content])
  * }
  * ```
  *
- * @example Listing all skills for a kit
+ * @example Listing all skills
  * ```typescript
- * const skills = await sdk.skills.list({ kitId: 'wicks-and-whiskers' })
- * const systemPrompt = buildSystemPrompt(kit, skills.map(s => s.content))
+ * const skills = await sdk.skills.list()
+ * const systemPrompt = buildSystemPrompt(skills.map(s => s.content))
  * ```
  *
- * @example Installing a skill into VFS
+ * @example Installing a skill
  * ```typescript
  * await sdk.skills.install({
  *   id: 'custom-flow',
- *   kitId: 'wicks-and-whiskers',
- *   content: `---\nid: custom-flow\ntitle: Custom Flow\n---\n...`,
+ *   content: '---\nid: custom-flow\nname: Custom Flow\ntype: active\n---\n...',
  * })
  * ```
  */
 export interface SkillsModule {
     /**
-     * Load a single skill by ID, searching VFS first then bundled registry.
+     * @description Load a single skill by ID from `/.soulcraft/skills/{id}/SKILL.md`.
      *
-     * @param id - Kebab-case skill ID (e.g. `'inventory-health'`).
-     * @param kitId - The kit the skill belongs to.
-     * @returns The skill, or `null` if not found in VFS or bundled registry.
+     * @param id - Kebab-case skill ID (e.g. `'candle-expertise'`).
+     * @returns The skill, or `null` if not found.
      */
-    load(id: string, kitId: string): Promise<Skill | null>;
+    load(id: string): Promise<Skill | null>;
     /**
-     * List skills matching the given options.
-     *
-     * Skills are returned from VFS. When a test registry is provided, VFS skills
-     * appear first, followed by test registry skills (no deduplication).
+     * @description List all skills in the workspace.
      *
-     * @param options - Filtering options.
-     * @returns An array of matching skills.
+     * @param options - Optional filtering (reserved for future use).
+     * @returns Array of all installed skills.
      */
     list(options?: SkillListOptions): Promise<Skill[]>;
     /**
-     * Install a skill into the VFS, making it available to all future `load()` calls.
-     *
-     * Writes the skill content to `/skills/{kitId}/{id}.md` in the Brainy VFS.
-     * Overwrites any existing skill at that path.
+     * @description Install a skill into `/.soulcraft/skills/{id}/SKILL.md`.
+     * Creates the directory if it doesn't exist. Overwrites if it does.
      *
-     * @param options - The skill to install.
-     * @throws {Error} If the VFS is not available on this SDK instance.
+     * @param options - The skill ID and content to install.
      */
     install(options: SkillInstallOptions): Promise<void>;
 }

package/dist/modules/skills/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,yEAAyE;IACzE,EAAE,EAAE,MAAM,CAAA;IACV,uEAAuE;IACvE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAA;CAChB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IAEtD;;;;;;;;OAQG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IAElD;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/modules/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAA;IACV,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,CAAC,CAAC,EAAE,KAAK,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAA;IACV,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IAEvC;;;;;OAKG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;IAElD;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACrD"}

package/dist/modules/skills/types.js

@@ -2,18 +2,21 @@
  * @module modules/skills/types
  * @description Type definitions for `sdk.skills.*` — the skill loading and registry system.
  *
- * Skills are Markdown files (SKILL.md convention) that define an AI persona,
- * capabilities, glossary, and workflow steps for a specific domain. They drive
- * Brainy AI system prompt construction and define what Claude knows how to do
- * within a kit's context.
+ * Skills are SKILL.md files stored at `/.soulcraft/skills/{id}/SKILL.md` in the Brainy VFS.
+ * Each skill is a directory containing a SKILL.md with YAML frontmatter and markdown
+ * instructions that define an AI persona, capabilities, or workflow.
  *
- * Skills are stored in the Brainy VFS at `/skills/{kitId}/{skillId}.md`,
- * installed by the kit initialization pipeline or via `sdk.skills.install()`.
+ * Skills are workspace-scoped — seeded from the kit at creation time and customizable
+ * per workspace. All products (Workshop, Venue, Academy, Pulse) read from the same path.
  *
- * ## Skill ID convention
+ * ## Skill types (via `type:` frontmatter)
+ * - `background` — passive knowledge, always loaded into AI context
+ * - `active` — user and/or AI can invoke
  *
- * Skill IDs are kebab-case strings matching the `id:` frontmatter field in the
- * SKILL.md file. Examples: `'inventory-health'`, `'session-flow'`, `'daily-brief'`.
+ * ## Path convention
+ * ```
+ * /.soulcraft/skills/{skill-id}/SKILL.md
+ * ```
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/modules/skills/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/modules/skills/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/sdk",
-  "version": "3.4.2",
+  "version": "3.6.0",
   "description": "The unified Soulcraft platform SDK — data, auth, AI, billing, and notifications",
   "type": "module",
   "publishConfig": {