@structured-vibe-coding/core 0.3.1 → 0.4.0

package/dist/{agents-AIH2DNH3.js → agents-2ONGBIGG.js}

@@ -1,16 +1,20 @@
 import {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
+  parseAgentTargets,
   refreshActiveAgentContext,
   renderThinAgent
-} from "./chunk-ANNG5SIL.js";
+} from "./chunk-BP54LEAD.js";
 export {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
+  parseAgentTargets,
   refreshActiveAgentContext,
   renderThinAgent
 };

package/dist/{chunk-ANNG5SIL.js → chunk-BP54LEAD.js}

@@ -518,7 +518,7 @@ async function createChange(input) {
   await materializeStageArtifacts(projectRoot, config, id, workflow, meta, firstStage);
   await setActiveChange(projectRoot, config, id);
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-AIH2DNH3.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-2ONGBIGG.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -738,7 +738,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-AIH2DNH3.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-2ONGBIGG.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -961,6 +961,37 @@ async function buildAgentPrompt(ctx, config, projectRoot) {
 
 // src/agents.ts
 var ALL_AGENT_TARGETS = ["copilot", "claude-code", "intellij"];
+var AGENT_TARGET_OPTIONS = [
+  {
+    id: "copilot",
+    label: "GitHub Copilot",
+    hint: ".github/agents/*.agent.md"
+  },
+  {
+    id: "claude-code",
+    label: "Claude Code",
+    hint: ".claude/agents/*.md"
+  },
+  {
+    id: "intellij",
+    label: "IntelliJ / JetBrains",
+    hint: ".idea/sdd-agent-notes.md"
+  }
+];
+function parseAgentTargets(raw) {
+  const parts = (Array.isArray(raw) ? raw : [raw]).flatMap((s) => String(s).split(",")).map((s) => s.trim().toLowerCase()).filter(Boolean);
+  const out = [];
+  for (const p of parts) {
+    const id = p === "claude" || p === "claude-code" || p === "claudecode" ? "claude-code" : p === "github-copilot" || p === "gh-copilot" || p === "copilot" ? "copilot" : p === "jetbrains" || p === "idea" || p === "intellij" ? "intellij" : p;
+    if (!ALL_AGENT_TARGETS.includes(id)) {
+      throw new Error(
+        `Unknown agent platform "${p}". Choose one of: ${ALL_AGENT_TARGETS.join(", ")}`
+      );
+    }
+    if (!out.includes(id)) out.push(id);
+  }
+  return out;
+}
 var SDD_AGENT_ROLES = [
   {
     id: "sdd",
@@ -1001,7 +1032,12 @@ var SDD_AGENT_ROLES = [
   }
 ];
 async function installAgentIntegrations(opts) {
-  const targets = opts.targets?.length ? opts.targets : ALL_AGENT_TARGETS;
+  if (!opts.targets?.length) {
+    throw new Error(
+      `Specify at least one agent platform: ${ALL_AGENT_TARGETS.join(", ")} (do not install all by default)`
+    );
+  }
+  const targets = opts.targets;
   const created = [];
   const skipped = [];
   const root = opts.projectRoot;
@@ -1257,6 +1293,8 @@ export {
   changeDirName,
   uniqueChangeDirName,
   ALL_AGENT_TARGETS,
+  AGENT_TARGET_OPTIONS,
+  parseAgentTargets,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
   renderThinAgent,

package/dist/index.d.ts

@@ -1166,6 +1166,14 @@ declare function buildAgentPrompt(ctx: ChangeContext, config: Config, projectRoo
 
 type AgentTarget = "copilot" | "claude-code" | "intellij";
 declare const ALL_AGENT_TARGETS: AgentTarget[];
+/** Human-facing labels for interactive platform pick (CLI / IDE). */
+declare const AGENT_TARGET_OPTIONS: {
+    id: AgentTarget;
+    label: string;
+    hint: string;
+}[];
+/** Parse `copilot`, `claude-code,copilot`, etc. Throws on unknown ids. */
+declare function parseAgentTargets(raw: string | string[]): AgentTarget[];
 /** Roles emitted as thin agents (shared body generator — no skill files). */
 type SddAgentRoleId = "sdd" | "sdd-planner" | "sdd-implementer" | "sdd-reviewer";
 interface SddAgentRole {
@@ -1205,8 +1213,12 @@ interface InitOptions {
     projectRoot: string;
     force?: boolean;
     pack?: "default" | "enterprise";
-    /** Install Copilot / Claude Code / IntelliJ agent files (default: all). */
-    agents?: boolean | AgentTarget[];
+    /**
+     * Agent platforms to install. Opt-in only — never defaults to all platforms.
+     * - omit / `false` — no agent files
+     * - `AgentTarget[]` — install only those hosts
+     */
+    agents?: false | AgentTarget[];
 }
 interface InitResult {
     created: string[];
@@ -1264,4 +1276,4 @@ declare function listFiles(path: string): Promise<string[]>;
 declare function copyDir(src: string, dest: string): Promise<void>;
 declare function removePath(path: string): Promise<void>;
 
-export { ALL_AGENT_TARGETS, type AdvanceResult, type AgentTarget, type ArtifactDef, ArtifactDefSchema, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type Complexity, type Config, ConfigSchema, type CreateChangeInput, type Gate, GateSchema, type InitOptions, type InitResult, type InstallAgentsOptions, type InstallAgentsResult, PROTOCOL_MD, SDD_AGENT_ROLES, SDD_DIR, type SddAgentRole, type SddAgentRoleId, type Stage, StageSchema, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, advanceStage, approveGate, archiveDir, buildAgentPrompt, buildContext, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, clearActiveIf, completeChange, configPath, copyDir, createChange, defaultConfig, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, firstActiveStageId, formatStatus, getActiveChangeId, getStage, inferComplexity, initProject, installAgentIntegrations, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, pathExists, previousStageId, projectPaths, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removePath, renderThinAgent, resolveChangeId, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, switchWorkflow, templatesDir, todayIsoDate, uniqueChangeDirName, workflowsDir, writeText, writeYaml };
+export { AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdvanceResult, type AgentTarget, type ArtifactDef, ArtifactDefSchema, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type Complexity, type Config, ConfigSchema, type CreateChangeInput, type Gate, GateSchema, type InitOptions, type InitResult, type InstallAgentsOptions, type InstallAgentsResult, PROTOCOL_MD, SDD_AGENT_ROLES, SDD_DIR, type SddAgentRole, type SddAgentRoleId, type Stage, StageSchema, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, advanceStage, approveGate, archiveDir, buildAgentPrompt, buildContext, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, clearActiveIf, completeChange, configPath, copyDir, createChange, defaultConfig, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, firstActiveStageId, formatStatus, getActiveChangeId, getStage, inferComplexity, initProject, installAgentIntegrations, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, parseAgentTargets, pathExists, previousStageId, projectPaths, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removePath, renderThinAgent, resolveChangeId, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, switchWorkflow, templatesDir, todayIsoDate, uniqueChangeDirName, workflowsDir, writeText, writeYaml };

package/dist/index.js

@@ -1,4 +1,5 @@
 import {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   ArtifactDefSchema,
   ChangeMetaSchema,
@@ -48,6 +49,7 @@ import {
   memoryDir,
   nextStageId,
   nowIso,
+  parseAgentTargets,
   pathExists,
   previousStageId,
   projectPaths,
@@ -73,7 +75,7 @@ import {
   workflowsDir,
   writeText,
   writeYaml
-} from "./chunk-ANNG5SIL.js";
+} from "./chunk-BP54LEAD.js";
 
 // src/init.ts
 import { join as join2 } from "pathe";
@@ -192,11 +194,10 @@ sdd complete
     created.push(sddReadme);
   }
   let agentsResult;
-  if (opts.agents !== false) {
-    const targets = Array.isArray(opts.agents) && opts.agents.length ? opts.agents : void 0;
+  if (Array.isArray(opts.agents) && opts.agents.length > 0) {
     const ag = await installAgentIntegrations({
       projectRoot,
-      targets,
+      targets: opts.agents,
       force
     });
     created.push(...ag.created);
@@ -336,6 +337,7 @@ ${output}`
   };
 }
 export {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   ArtifactDefSchema,
   ChangeMetaSchema,
@@ -390,6 +392,7 @@ export {
   memoryDir,
   nextStageId,
   nowIso,
+  parseAgentTargets,
   pathExists,
   previousStageId,
   projectPaths,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structured-vibe-coding/core",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Core engine for structured vibe coding (local-first Spec-Driven Development)",
   "type": "module",
   "main": "./dist/index.js",