@almadar/skills 2.0.2 → 2.0.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { OrbitalSchema } from '@almadar/core';
+import { OrbitalSchema, ServiceContract } from '@almadar/core';
 
 /**
  * Skill Generator Types
@@ -668,4 +668,77 @@ interface ProviderComparison {
  */
 declare function generateComparisonMatrix(comparisons: ProviderComparison[]): string;
 
-export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
+/**
+ * Skills Service Contract
+ *
+ * Defines the call-service-compatible actions for the Skills service.
+ * Skills are stateless generators that produce Orbital schemas and
+ * domain language definitions from natural-language prompts.
+ *
+ * These actions can be invoked from `.orb` schemas via
+ * `["call-service", "skills", "<action>", {...}]`.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * All call-service actions exposed by the Skills service.
+ */
+type SkillsServiceActions = {
+    /** Generate Orbital schemas from a natural-language prompt. */
+    generateOrbitals: {
+        params: {
+            prompt: string;
+            compact?: boolean;
+        };
+        result: {
+            skill: {
+                name: string;
+                content: string;
+            };
+        };
+    };
+    /** Generate a fix for an existing schema given validation errors. */
+    generateFix: {
+        params: {
+            schema: string;
+            errors: string[];
+        };
+        result: {
+            skill: {
+                name: string;
+                content: string;
+            };
+        };
+    };
+    /** Generate a domain language definition from a description. */
+    generateDomainLanguage: {
+        params: {
+            description: string;
+        };
+        result: {
+            skill: {
+                name: string;
+                content: string;
+            };
+        };
+    };
+    /** Generate all available skills. */
+    generateAll: {
+        params: Record<string, never>;
+        result: {
+            skills: Array<{
+                name: string;
+                content: string;
+            }>;
+        };
+    };
+};
+/**
+ * The full service contract for the Skills service.
+ * Implementations must provide an `execute(action, params)` method
+ * that dispatches to the correct action handler.
+ */
+type SkillsServiceContract = ServiceContract<SkillsServiceActions>;
+
+export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, type SkillsServiceActions, type SkillsServiceContract, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };

package/dist/index.js

@@ -1,9 +1,9 @@
 import { existsSync, mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
 import { generateBehaviorsDocs, getAllBehaviors, generateModulesDocs, getAllStdOperators } from '@almadar/std';
-import { OPERATORS, UI_SLOTS, PATTERN_TYPES, ViewTypeSchema } from '@almadar/core/types';
+import { OPERATORS, UI_SLOTS, PATTERN_TYPES, ViewTypeSchema, isInlineTrait as isInlineTrait$1 } from '@almadar/core/types';
 import { getPatternPropsCompact, getPatternActionsRef, getAllPatternTypes } from '@almadar/patterns';
-import { BINDING_DOCS, CORE_BINDINGS } from '@almadar/core';
+import { BINDING_DOCS, CORE_BINDINGS, isInlineTrait } from '@almadar/core';
 import { generateDomainLanguageReference } from '@almadar/core/domain-language';
 
 // src/generators/utils.ts
@@ -120,19 +120,21 @@ function getStdBehaviorsWithStateMachines() {
   const behaviors = getAllBehaviors();
   const nonGameBehaviors = behaviors.filter((b) => {
     const traits = b.orbitals?.[0]?.traits ?? [];
-    const hasGameCategory = traits.some((t) => t.category?.includes("game"));
-    const hasStateMachine = traits.some((t) => t.stateMachine);
+    const inlineTraits = traits.filter(isInlineTrait$1);
+    const hasGameCategory = inlineTraits.some((t) => t.category?.includes("game"));
+    const hasStateMachine = inlineTraits.some((t) => t.stateMachine);
     return !hasGameCategory && hasStateMachine;
   });
   return `## Standard Behaviors
 
 ${nonGameBehaviors.map((behavior) => {
-    const trait = (behavior.orbitals?.[0]?.traits ?? []).find((t) => t.stateMachine);
+    const inlineTraits = (behavior.orbitals?.[0]?.traits ?? []).filter(isInlineTrait$1);
+    const trait = inlineTraits.find((t) => t.stateMachine);
     const sm = trait?.stateMachine;
     return `### ${behavior.name}
 
 **States**: ${sm?.states?.map((s) => s.name).join(", ") ?? "N/A"}
-**Events**: ${sm?.events?.map((e) => e.key ?? e.name ?? e).join(", ") ?? "N/A"}
+**Events**: ${sm?.events?.map((e) => e.key ?? e.name).join(", ") ?? "N/A"}
 
 \`\`\`json
 ${JSON.stringify(behavior, null, 2)}
@@ -4636,8 +4638,6 @@ ${cat.behaviors.map((b) => `- **${b.name}**: ${b.description}`).join("\n")}
 Use with: \`uses: [{ from: "std/behaviors/crud", as: "CRUD" }]\`
 `;
 }
-
-// src/evals/composition-quality.ts
 var EVAL_CASES = [
   {
     name: "task-management-basic",
@@ -4746,9 +4746,9 @@ function analyzeComposition(schema) {
   };
   for (const orbital of schema.orbitals) {
     for (const trait of orbital.traits) {
-      const t = trait;
-      if (!t.stateMachine?.transitions) continue;
-      for (const transition of t.stateMachine.transitions) {
+      if (!isInlineTrait(trait)) continue;
+      if (!trait.stateMachine?.transitions) continue;
+      for (const transition of trait.stateMachine.transitions) {
         if (!transition.effects) continue;
         for (const effect of transition.effects) {
           if (!Array.isArray(effect)) continue;
@@ -4902,9 +4902,9 @@ function countTransitions(schema) {
   let count = 0;
   for (const orbital of schema.orbitals) {
     for (const trait of orbital.traits) {
-      const t = trait;
-      if (t.stateMachine?.transitions) {
-        count += t.stateMachine.transitions.length;
+      if (!isInlineTrait(trait)) continue;
+      if (trait.stateMachine?.transitions) {
+        count += trait.stateMachine.transitions.length;
       }
     }
   }
@@ -4913,17 +4913,17 @@ function countTransitions(schema) {
 function hasClosedCircuit(schema) {
   for (const orbital of schema.orbitals) {
     for (const trait of orbital.traits) {
-      const t = trait;
-      if (!t.stateMachine) continue;
-      const states = new Set((t.stateMachine.states || []).map((s) => s.name));
+      if (!isInlineTrait(trait)) continue;
+      if (!trait.stateMachine) continue;
+      const states = new Set((trait.stateMachine.states || []).map((s) => s.name));
       const incomingStates = /* @__PURE__ */ new Set();
       const outgoingStates = /* @__PURE__ */ new Set();
-      for (const transition of t.stateMachine.transitions || []) {
+      for (const transition of trait.stateMachine.transitions || []) {
         incomingStates.add(transition.to);
         outgoingStates.add(transition.from);
       }
       for (const state of states) {
-        const stateObj = (t.stateMachine.states || []).find((s) => s.name === state);
+        const stateObj = (trait.stateMachine.states || []).find((s) => s.name === state);
         if (!stateObj?.isInitial && !incomingStates.has(state)) {
           return false;
         }