@agents-inc/cli 0.35.0 → 0.38.0

package/dist/config/skills-matrix.yaml

@@ -103,7 +103,7 @@ categories:
     displayName: Error Handling
     description: Error boundaries, result types, and error patterns
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 11
@@ -122,7 +122,7 @@ categories:
     displayName: File Upload
     description: File upload patterns and handling
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 13
@@ -132,7 +132,7 @@ categories:
     displayName: Files & Images
     description: Image handling and file processing
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 14
@@ -142,7 +142,7 @@ categories:
     displayName: Utilities
     description: Utility libraries (date-fns, native JS patterns)
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 15
@@ -152,7 +152,7 @@ categories:
     displayName: Realtime
     description: WebSockets, SSE, and real-time communication
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: true
     required: false
     order: 16
@@ -162,7 +162,7 @@ categories:
     displayName: Animation
     description: Animation libraries and CSS animations
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 17
@@ -172,7 +172,7 @@ categories:
     displayName: Progressive Web App
     description: Service workers, offline-first patterns, and PWA features
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 18
@@ -182,7 +182,7 @@ categories:
     displayName: Accessibility
     description: WCAG compliance, ARIA, and keyboard navigation
     domain: web-extras
-    parent_domain: web
+    parentDomain: web
     exclusive: false
     required: false
     order: 19
@@ -597,12 +597,12 @@ relationships:
     # React-specific libraries (note: these libraries have vanilla/other-framework options, but our skills teach React patterns)
     - skill: zustand
       needs: [react, react-native]
-      needs_any: true
+      needsAny: true
       reason: "Our Zustand skill covers React/React Native patterns (zustand/vanilla exists for other frameworks)"
 
     - skill: redux-toolkit
       needs: [react, react-native]
-      needs_any: true
+      needsAny: true
       reason: "Our Redux Toolkit skill covers React/React Native patterns (RTK core is framework-agnostic)"
 
     - skill: mobx
@@ -611,17 +611,17 @@ relationships:
 
     - skill: react-query
       needs: [react, react-native]
-      needs_any: true
+      needsAny: true
       reason: "TanStack Query's React adapter. Note: TanStack Query also supports Vue, Solid, Svelte via separate adapters."
 
     - skill: swr
       needs: [react, react-native]
-      needs_any: true
+      needsAny: true
       reason: "SWR is a React Hooks library. For React Native, requires @nandorojo/swr-react-native wrapper."
 
     - skill: react-hook-form
       needs: [react, react-native]
-      needs_any: true
+      needsAny: true
       reason: "React Hook Form is React only"
 
     - skill: react-testing-library
@@ -659,7 +659,7 @@ relationships:
     # Backend dependencies
     - skill: better-auth
       needs: [drizzle, prisma]
-      needs_any: true
+      needsAny: true
       reason: "Better Auth supports multiple database adapters (Drizzle, Prisma, Kysely, MongoDB). Our skill uses Drizzle adapter."
 
     # NOTE: Removed drizzle/prisma requires API framework - ORMs work standalone for scripts, CLI tools, workers, etc.
@@ -672,12 +672,12 @@ relationships:
     # GraphQL clients need a framework
     - skill: graphql-apollo
       needs: [react, vue, angular]
-      needs_any: true
+      needsAny: true
       reason: "Apollo Client - first-party React support, community-maintained Vue/Angular integrations. Note: Svelte/Solid bindings exist but are stale (2020-2022)."
 
     - skill: graphql-urql
       needs: [react, vue, solidjs]
-      needs_any: true
+      needsAny: true
       reason: "URQL has first-party support for React, Vue, and Solid (no Angular support). Svelte support exists but skill not yet created."
 
   # ─────────────────────────────────────────────────────────────────
@@ -759,7 +759,7 @@ relationships:
 # - Lowercase
 # =============================================================================
 
-skill_aliases:
+skillAliases:
   # ─────────────────────────────────────────────────────────────────
   # Frameworks - normalized skill IDs
   # ─────────────────────────────────────────────────────────────────

package/dist/hooks/init.js

@@ -2,10 +2,10 @@
 import {
   loadDefaultMappings,
   resolveSource
-} from "../chunk-WMVGRAFB.js";
+} from "../chunk-U5OB5ADP.js";
 import "../chunk-T4EXUIBY.js";
-import "../chunk-OI4WBRC7.js";
-import "../chunk-YCS7GF6Y.js";
+import "../chunk-YJIJTBSX.js";
+import "../chunk-ZBJQXDQN.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";

package/dist/{source-manager-PTK4P6BF.js → source-manager-FEGVYDFZ.js}

@@ -3,14 +3,14 @@ import {
   addSource,
   getSourceSummary,
   removeSource
-} from "./chunk-WMVGRAFB.js";
+} from "./chunk-U5OB5ADP.js";
 import "./chunk-T4EXUIBY.js";
-import "./chunk-OI4WBRC7.js";
-import "./chunk-YCS7GF6Y.js";
+import "./chunk-YJIJTBSX.js";
+import "./chunk-ZBJQXDQN.js";
 import "./chunk-DHET7RCE.js";
 export {
   addSource,
   getSourceSummary,
   removeSource
 };
-//# sourceMappingURL=source-manager-PTK4P6BF.js.map
+//# sourceMappingURL=source-manager-FEGVYDFZ.js.map

package/dist/source-manager-FEGVYDFZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/stores/wizard-store.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import {
   useWizardStore
-} from "../chunk-OGXSTJP2.js";
-import "../chunk-WMVGRAFB.js";
+} from "../chunk-HRMQ2RGY.js";
+import "../chunk-WSGGJKD5.js";
+import "../chunk-U5OB5ADP.js";
 import "../chunk-T4EXUIBY.js";
-import "../chunk-OI4WBRC7.js";
-import "../chunk-YCS7GF6Y.js";
+import "../chunk-YJIJTBSX.js";
+import "../chunk-ZBJQXDQN.js";
 import "../chunk-DHET7RCE.js";
 export {
   useWizardStore

package/dist/stores/wizard-store.test.js

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
 import {
-  createMockCategory
-} from "../chunk-YN35L5NE.js";
+  createMockCategory,
+  createMockMatrix,
+  createMockSkill
+} from "../chunk-FWQK3HWB.js";
 import {
+  afterEach,
   beforeEach,
   describe,
   globalExpect,
@@ -10,13 +13,19 @@ import {
 } from "../chunk-XY3XDVMI.js";
 import {
   useWizardStore
-} from "../chunk-OGXSTJP2.js";
-import "../chunk-WMVGRAFB.js";
-import "../chunk-T4EXUIBY.js";
-import "../chunk-OI4WBRC7.js";
+} from "../chunk-HRMQ2RGY.js";
+import "../chunk-WSGGJKD5.js";
+import {
+  clearDefaultsCache,
+  loadDefaultMappings
+} from "../chunk-U5OB5ADP.js";
+import {
+  typedKeys
+} from "../chunk-T4EXUIBY.js";
+import "../chunk-YJIJTBSX.js";
 import {
   DEFAULT_PRESELECTED_SKILLS
-} from "../chunk-YCS7GF6Y.js";
+} from "../chunk-ZBJQXDQN.js";
 import {
   init_esm_shims
 } from "../chunk-DHET7RCE.js";
@@ -261,11 +270,11 @@ describe("WizardStore", () => {
       const { installMode } = useWizardStore.getState();
       globalExpect(installMode).toBe("local");
     });
-    it("should toggle show descriptions", () => {
+    it("should toggle show labels", () => {
       const store = useWizardStore.getState();
-      store.toggleShowDescriptions();
-      const { showDescriptions } = useWizardStore.getState();
-      globalExpect(showDescriptions).toBe(true);
+      store.toggleShowLabels();
+      const { showLabels } = useWizardStore.getState();
+      globalExpect(showLabels).toBe(true);
     });
     it("should toggle help on", () => {
       const store = useWizardStore.getState();
@@ -431,7 +440,7 @@ describe("WizardStore", () => {
       categories: {
         "error-handling": createMockCategory("error-handling", "Error Handling", {
           domain: "web-extras",
-          parent_domain: "web",
+          parentDomain: "web",
           exclusive: false
         }),
         framework: createMockCategory("framework", "Framework", {
@@ -446,7 +455,7 @@ describe("WizardStore", () => {
         })
       }
     };
-    it("should find parent domain for a domain with parent_domain", () => {
+    it("should find parent domain for a domain with parentDomain", () => {
       const store = useWizardStore.getState();
       const parent = store.getParentDomain(
         "web-extras",
@@ -454,7 +463,7 @@ describe("WizardStore", () => {
       );
       globalExpect(parent).toBe("web");
     });
-    it("should return undefined for a domain without parent_domain", () => {
+    it("should return undefined for a domain without parentDomain", () => {
       const store = useWizardStore.getState();
       const parent = store.getParentDomain("web", matrixWithoutParent);
       globalExpect(parent).toBeUndefined();
@@ -556,7 +565,7 @@ describe("WizardStore", () => {
       };
       store.populateFromStack(stack, categories);
       const { domainSelections } = useWizardStore.getState();
-      globalExpect(Object.keys(domainSelections)).toHaveLength(0);
+      globalExpect(typedKeys(domainSelections)).toHaveLength(0);
     });
     it("should populate multiple skills from array-valued subcategories", () => {
       const store = useWizardStore.getState();
@@ -685,5 +694,268 @@ describe("WizardStore", () => {
       globalExpect(state.domainSelections.web.framework).toEqual(["web-framework-react"]);
     });
   });
+  describe("buildSourceRows sort order", () => {
+    function makeSource(overrides) {
+      return {
+        type: "private",
+        installed: false,
+        ...overrides
+      };
+    }
+    it("should sort local sources before scoped marketplace sources", () => {
+      const store = useWizardStore.getState();
+      const skill = createMockSkill("web-framework-react", "framework", {
+        displayName: "react",
+        availableSources: [
+          makeSource({ name: "Photoroom", type: "private", primary: true }),
+          makeSource({ name: "local", type: "local", installed: true, installMode: "local" })
+        ]
+      });
+      const matrix = createMockMatrix(
+        { "web-framework-react": skill },
+        {
+          displayNames: { "web-framework-react": "react" }
+        }
+      );
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      const rows = store.buildSourceRows(matrix);
+      globalExpect(rows).toHaveLength(1);
+      globalExpect(rows[0].options[0].id).toBe("local");
+      globalExpect(rows[0].options[1].id).toBe("Photoroom");
+    });
+    it("should sort scoped marketplace before default public marketplace", () => {
+      const store = useWizardStore.getState();
+      const skill = createMockSkill("web-framework-react", "framework", {
+        displayName: "react",
+        availableSources: [
+          makeSource({ name: "Agents Inc", type: "public" }),
+          makeSource({ name: "Photoroom", type: "private", primary: true })
+        ]
+      });
+      const matrix = createMockMatrix(
+        { "web-framework-react": skill },
+        {
+          displayNames: { "web-framework-react": "react" }
+        }
+      );
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      const rows = store.buildSourceRows(matrix);
+      globalExpect(rows).toHaveLength(1);
+      globalExpect(rows[0].options[0].id).toBe("Photoroom");
+      globalExpect(rows[0].options[1].id).toBe("Agents Inc");
+    });
+    it("should sort default public marketplace before third-party sources", () => {
+      const store = useWizardStore.getState();
+      const skill = createMockSkill("web-framework-react", "framework", {
+        displayName: "react",
+        availableSources: [
+          makeSource({ name: "Extra Corp", type: "private" }),
+          makeSource({ name: "Agents Inc", type: "public" })
+        ]
+      });
+      const matrix = createMockMatrix(
+        { "web-framework-react": skill },
+        {
+          displayNames: { "web-framework-react": "react" }
+        }
+      );
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      const rows = store.buildSourceRows(matrix);
+      globalExpect(rows).toHaveLength(1);
+      globalExpect(rows[0].options[0].id).toBe("Agents Inc");
+      globalExpect(rows[0].options[1].id).toBe("Extra Corp");
+    });
+    it("should sort all four tiers in correct order", () => {
+      const store = useWizardStore.getState();
+      const skill = createMockSkill("web-framework-react", "framework", {
+        displayName: "react",
+        availableSources: [
+          makeSource({ name: "Extra Corp", type: "private" }),
+          makeSource({ name: "Agents Inc", type: "public" }),
+          makeSource({ name: "Photoroom", type: "private", primary: true }),
+          makeSource({ name: "local", type: "local", installed: true, installMode: "local" })
+        ]
+      });
+      const matrix = createMockMatrix(
+        { "web-framework-react": skill },
+        {
+          displayNames: { "web-framework-react": "react" }
+        }
+      );
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      const rows = store.buildSourceRows(matrix);
+      globalExpect(rows).toHaveLength(1);
+      const sourceNames = rows[0].options.map((opt) => opt.id);
+      globalExpect(sourceNames).toEqual(["local", "Photoroom", "Agents Inc", "Extra Corp"]);
+    });
+  });
+  describe("agent selection", () => {
+    it("should start with empty selectedAgents", () => {
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toEqual([]);
+    });
+    it("should toggle agent on", () => {
+      const store = useWizardStore.getState();
+      store.toggleAgent("web-developer");
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toContain("web-developer");
+    });
+    it("should toggle agent off", () => {
+      const store = useWizardStore.getState();
+      store.toggleAgent("web-developer");
+      store.toggleAgent("web-developer");
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).not.toContain("web-developer");
+    });
+    it("should allow multiple agents to be selected", () => {
+      const store = useWizardStore.getState();
+      store.toggleAgent("web-developer");
+      store.toggleAgent("api-developer");
+      store.toggleAgent("web-reviewer");
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toEqual(["web-developer", "api-developer", "web-reviewer"]);
+    });
+    it("should reset selectedAgents on reset", () => {
+      const store = useWizardStore.getState();
+      store.toggleAgent("web-developer");
+      store.reset();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toEqual([]);
+    });
+  });
+  describe("preselectAgentsFromSkills", () => {
+    beforeEach(async () => {
+      clearDefaultsCache();
+      await loadDefaultMappings();
+    });
+    afterEach(() => {
+      clearDefaultsCache();
+    });
+    it("should preselect web-related agents when web skills are selected", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toContain("web-developer");
+      globalExpect(selectedAgents).toContain("web-reviewer");
+      globalExpect(selectedAgents).toContain("web-researcher");
+      globalExpect(selectedAgents).toContain("web-tester");
+      globalExpect(selectedAgents).toContain("web-pm");
+      globalExpect(selectedAgents).toContain("web-architecture");
+    });
+    it("should preselect api-related agents when api skills are selected", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("api", "api", "api-framework-hono", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toContain("api-developer");
+      globalExpect(selectedAgents).toContain("api-reviewer");
+      globalExpect(selectedAgents).toContain("api-researcher");
+      globalExpect(selectedAgents).not.toContain("web-developer");
+    });
+    it("should never include optional agents regardless of skills", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      store.toggleTechnology("api", "api", "api-framework-hono", true);
+      store.toggleTechnology("cli", "framework", "cli-framework-oclif-ink", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).not.toContain("agent-summoner");
+      globalExpect(selectedAgents).not.toContain("skill-summoner");
+      globalExpect(selectedAgents).not.toContain("documentor");
+      globalExpect(selectedAgents).not.toContain("pattern-scout");
+      globalExpect(selectedAgents).not.toContain("web-pattern-critique");
+    });
+    it("should return empty agents when no skills are selected", () => {
+      const store = useWizardStore.getState();
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toEqual([]);
+    });
+    it("should produce union of agents for skills across multiple domains", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      store.toggleTechnology("api", "api", "api-framework-hono", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toContain("web-developer");
+      globalExpect(selectedAgents).toContain("api-developer");
+      globalExpect(selectedAgents).toContain("web-reviewer");
+      globalExpect(selectedAgents).toContain("api-reviewer");
+    });
+    it("should preselect cli agents when cli skills are selected", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("cli", "framework", "cli-framework-oclif-ink", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toContain("cli-developer");
+      globalExpect(selectedAgents).toContain("cli-tester");
+      globalExpect(selectedAgents).toContain("cli-reviewer");
+      globalExpect(selectedAgents).toContain("cli-migrator");
+    });
+    it("should not preselect api agents when only web skills are selected", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      store.toggleTechnology("web", "styling", "web-styling-scss-modules", false);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).toContain("web-developer");
+      globalExpect(selectedAgents).not.toContain("api-developer");
+      globalExpect(selectedAgents).not.toContain("api-reviewer");
+    });
+    it("should return sorted agents", () => {
+      const store = useWizardStore.getState();
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      store.toggleTechnology("api", "api", "api-framework-hono", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      const sorted = [...selectedAgents].sort();
+      globalExpect(selectedAgents).toEqual(sorted);
+    });
+    it("should replace previous agent selection", () => {
+      const store = useWizardStore.getState();
+      store.toggleAgent("documentor");
+      store.toggleTechnology("web", "framework", "web-framework-react", true);
+      store.preselectAgentsFromSkills();
+      const { selectedAgents } = useWizardStore.getState();
+      globalExpect(selectedAgents).not.toContain("documentor");
+    });
+  });
+  describe("step progress with agents step", () => {
+    it("should include agents in completed steps when on confirm", () => {
+      const store = useWizardStore.getState();
+      store.setApproach("scratch");
+      store.setStep("build");
+      store.setStep("sources");
+      store.setStep("agents");
+      store.setStep("confirm");
+      const { completedSteps } = store.getStepProgress();
+      globalExpect(completedSteps).toContain("agents");
+      globalExpect(completedSteps).toContain("sources");
+      globalExpect(completedSteps).toContain("build");
+    });
+    it("should include sources in completed steps when on agents step", () => {
+      const store = useWizardStore.getState();
+      store.setApproach("scratch");
+      store.setStep("build");
+      store.setStep("sources");
+      store.setStep("agents");
+      const { completedSteps } = store.getStepProgress();
+      globalExpect(completedSteps).toContain("build");
+      globalExpect(completedSteps).toContain("sources");
+      globalExpect(completedSteps).not.toContain("agents");
+    });
+    it("should skip agents step when using stack defaults", () => {
+      const store = useWizardStore.getState();
+      store.setApproach("stack");
+      store.selectStack("nextjs-fullstack");
+      store.setStackAction("defaults");
+      store.setStep("confirm");
+      const { skippedSteps } = store.getStepProgress();
+      globalExpect(skippedSteps).toContain("agents");
+      globalExpect(skippedSteps).toContain("build");
+      globalExpect(skippedSteps).toContain("sources");
+    });
+  });
 });
 //# sourceMappingURL=wizard-store.test.js.map