@compilr-dev/sdk 0.10.2 → 0.10.3

package/dist/index.d.ts

@@ -68,7 +68,8 @@ export { createPlatformTools, createProjectTools, createWorkItemTools, createDoc
 export type { ProjectAnchorStoreConfig, ImageToolsConfig, ImageResizer } from './platform/index.js';
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
 export type { CustomSkill, CompilrSkillExtension, ForkedFromMarker, SkillEligibilityContext, SkillCollision, SkillDiffLine, SkillValidationIssue, ScopeConfig, SkillResolution, } from './skills/index.js';
-export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, } from './skills/index.js';
+export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readSkillScopeConfig, readSkillScopeConfigSync, writeSkillScopeConfig, getSkillBindings, resolveSkillBinding, } from './skills/index.js';
+export type { SkillScope } from './skills/index.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './skills/index.js';
 export { ACTION_REGISTRY, getActionsForContext, getActionById, resolveActionPrompt, buildContextSummary, getSuggestedRole, } from './actions/index.js';
 export type { ActionContext, ActionDefinition } from './actions/index.js';

package/dist/index.js

@@ -152,7 +152,7 @@ export { createPlatformTools, createProjectTools, createWorkItemTools, createDoc
 // Platform Workflow (pure step-criteria logic)
 // =============================================================================
 export { STEP_ORDER, GUIDED_STEP_CRITERIA, getNextStep, isValidTransition, getStepCriteria, formatStepDisplay, getStepNumber, } from './platform/index.js';
-export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, } from './skills/index.js';
+export { RESERVED_SKILL_NAMES, isReservedSkillName, parseSkillMarkdown, loadSkillsFromDir, resolveLayeredSkills, resolveSkillsForAgent, detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill as validateSkillQuality, getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readSkillScopeConfig, readSkillScopeConfigSync, writeSkillScopeConfig, getSkillBindings, resolveSkillBinding, } from './skills/index.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './skills/index.js';
 // =============================================================================
 // Contextual Actions (skill invocations with context)

package/dist/skills/index.d.ts

@@ -8,4 +8,6 @@ export type { SkillEligibilityContext } from './resolver.js';
 export { resolveLayeredSkills, resolveSkillsForAgent } from './resolver.js';
 export type { SkillCollision, SkillDiffLine, SkillValidationIssue, ScopeConfig, SkillResolution, } from './operations.js';
 export { detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill, } from './operations.js';
+export type { SkillScope } from './paths.js';
+export { getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readScopeConfig as readSkillScopeConfig, readScopeConfigSync as readSkillScopeConfigSync, writeScopeConfig as writeSkillScopeConfig, getAllBindings as getSkillBindings, resolveBinding as resolveSkillBinding, } from './paths.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './platform-skills.js';

package/dist/skills/index.js

@@ -2,4 +2,5 @@ export { RESERVED_SKILL_NAMES, isReservedSkillName } from './types.js';
 export { parseSkillMarkdown, loadSkillsFromDir } from './loader.js';
 export { resolveLayeredSkills, resolveSkillsForAgent } from './resolver.js';
 export { detectCollisions, formatCollisionWarnings, diffForkVsUpstream, buildForkContent, buildNewSkillContent, validateSkill, } from './operations.js';
+export { getSkillsDir, getSkillFolder, getSkillFile, ensureSkillsDir, isValidSkillName, getScopeConfigPath, readScopeConfig as readSkillScopeConfig, readScopeConfigSync as readSkillScopeConfigSync, writeScopeConfig as writeSkillScopeConfig, getAllBindings as getSkillBindings, resolveBinding as resolveSkillBinding, } from './paths.js';
 export { platformSkills, designSkill, sketchSkill, prdSkill, refineSkill, refineItemSkill, architectureSkill, sessionNotesSkill, buildSkill, scaffoldSkill, outlineSkill, literatureReviewSkill, draftSectionSkill, peerReviewSkill, researchScaffoldSkill, businessVisionSkill, marketAnalysisSkill, competitorAnalysisSkill, financialModelSkill, pitchOutlineSkill, businessReviewSkill, brandSetupSkill, contentStrategySkill, contentCalendarSkill, createContentSkill, contentReviewSkill, curriculumDesignSkill, lessonPlanSkill, assessmentDesignSkill, courseReviewSkill, bookOutlineSkill, characterDesignSkill, plotThreadsSkill, sceneBreakdownSkill, bookReviewSkill, } from './platform-skills.js';

package/dist/skills/paths.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Skill path resolution and config I/O.
+ *
+ * Portable across CLI and Desktop — takes explicit paths instead of
+ * relying on CLI-specific project detection.
+ */
+export type SkillScope = 'user' | 'project';
+/** Resolve the skills directory for a given scope. */
+export declare function getSkillsDir(scope: SkillScope, projectDir?: string): string;
+/** Ensure the skills directory exists. Returns the path. */
+export declare function ensureSkillsDir(scope: SkillScope, projectDir?: string): Promise<string>;
+/** Path to a single skill folder (no creation). */
+export declare function getSkillFolder(name: string, scope: SkillScope, projectDir?: string): string;
+/** Path to a skill's SKILL.md file. */
+export declare function getSkillFile(name: string, scope: SkillScope, projectDir?: string): string;
+/**
+ * Validate a skill name. Lowercase letters, digits, and hyphens only.
+ */
+export declare function isValidSkillName(name: string): boolean;
+/** Shape of <scope>/.compilr/config.json */
+export interface ScopeConfig {
+    slashCommands?: Record<string, string>;
+}
+/** Path to the scope config file. */
+export declare function getScopeConfigPath(scope: SkillScope, projectDir?: string): string;
+/** Read the scope config asynchronously. Returns empty object if file doesn't exist. */
+export declare function readScopeConfig(scope: SkillScope, projectDir?: string): Promise<ScopeConfig>;
+/** Read the scope config synchronously. Returns empty object if file doesn't exist. */
+export declare function readScopeConfigSync(scope: SkillScope, projectDir?: string): ScopeConfig;
+/** Write the scope config. Creates parent directories if needed. */
+export declare function writeScopeConfig(scope: SkillScope, config: ScopeConfig, projectDir?: string): Promise<void>;
+/** Get all bindings across both scopes (project takes priority). */
+export declare function getAllBindings(projectDir?: string): Promise<Record<string, {
+    skillName: string;
+    scope: SkillScope;
+}>>;
+/**
+ * Resolve a command name to a bound skill name via config.json.
+ * Synchronous — config files are tiny.
+ */
+export declare function resolveBinding(commandName: string, projectDir?: string): string | null;

package/dist/skills/paths.js

@@ -0,0 +1,118 @@
+/**
+ * Skill path resolution and config I/O.
+ *
+ * Portable across CLI and Desktop — takes explicit paths instead of
+ * relying on CLI-specific project detection.
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { readFileSync } from 'node:fs';
+// =============================================================================
+// Path Resolution
+// =============================================================================
+/** Resolve the skills directory for a given scope. */
+export function getSkillsDir(scope, projectDir) {
+    if (scope === 'user') {
+        return path.join(os.homedir(), '.compilr-dev', 'skills');
+    }
+    if (!projectDir)
+        throw new Error('projectDir required for project scope');
+    return path.join(projectDir, '.compilr', 'skills');
+}
+/** Ensure the skills directory exists. Returns the path. */
+export async function ensureSkillsDir(scope, projectDir) {
+    const dir = getSkillsDir(scope, projectDir);
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/** Path to a single skill folder (no creation). */
+export function getSkillFolder(name, scope, projectDir) {
+    return path.join(getSkillsDir(scope, projectDir), name);
+}
+/** Path to a skill's SKILL.md file. */
+export function getSkillFile(name, scope, projectDir) {
+    return path.join(getSkillFolder(name, scope, projectDir), 'SKILL.md');
+}
+/**
+ * Validate a skill name. Lowercase letters, digits, and hyphens only.
+ */
+export function isValidSkillName(name) {
+    if (!name || name.length === 0 || name.length > 64)
+        return false;
+    return /^[a-z][a-z0-9-]*$/.test(name);
+}
+/** Path to the scope config file. */
+export function getScopeConfigPath(scope, projectDir) {
+    if (scope === 'user') {
+        return path.join(os.homedir(), '.compilr-dev', 'config.json');
+    }
+    if (!projectDir)
+        throw new Error('projectDir required for project scope');
+    return path.join(projectDir, '.compilr', 'config.json');
+}
+/** Read the scope config asynchronously. Returns empty object if file doesn't exist. */
+export async function readScopeConfig(scope, projectDir) {
+    try {
+        const content = await fs.readFile(getScopeConfigPath(scope, projectDir), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/** Read the scope config synchronously. Returns empty object if file doesn't exist. */
+export function readScopeConfigSync(scope, projectDir) {
+    try {
+        const content = readFileSync(getScopeConfigPath(scope, projectDir), 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/** Write the scope config. Creates parent directories if needed. */
+export async function writeScopeConfig(scope, config, projectDir) {
+    const configPath = getScopeConfigPath(scope, projectDir);
+    await fs.mkdir(path.dirname(configPath), { recursive: true });
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2) + '\n');
+}
+/** Get all bindings across both scopes (project takes priority). */
+export async function getAllBindings(projectDir) {
+    const result = {};
+    const userConfig = await readScopeConfig('user');
+    if (userConfig.slashCommands) {
+        for (const [cmd, skill] of Object.entries(userConfig.slashCommands)) {
+            result[cmd] = { skillName: skill, scope: 'user' };
+        }
+    }
+    if (projectDir) {
+        const projectConfig = await readScopeConfig('project', projectDir);
+        if (projectConfig.slashCommands) {
+            for (const [cmd, skill] of Object.entries(projectConfig.slashCommands)) {
+                result[cmd] = { skillName: skill, scope: 'project' };
+            }
+        }
+    }
+    return result;
+}
+// =============================================================================
+// Binding Resolution
+// =============================================================================
+/**
+ * Resolve a command name to a bound skill name via config.json.
+ * Synchronous — config files are tiny.
+ */
+export function resolveBinding(commandName, projectDir) {
+    if (projectDir) {
+        const projectConfig = readScopeConfigSync('project', projectDir);
+        if (projectConfig.slashCommands?.[commandName]) {
+            return projectConfig.slashCommands[commandName];
+        }
+    }
+    const userConfig = readScopeConfigSync('user');
+    if (userConfig.slashCommands?.[commandName]) {
+        return userConfig.slashCommands[commandName];
+    }
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",
@@ -58,6 +58,7 @@
   "dependencies": {
     "@compilr-dev/agents": "^0.5.7",
     "@compilr-dev/logger": "^0.1.0",
+    "@compilr-dev/sdk": "^0.10.2",
     "ajv": "^6.14.0",
     "yaml": "^2.8.4"
   },