@structured-vibe-coding/core 0.3.1 → 0.4.1

package/dist/{agents-AIH2DNH3.js → agents-ADF5FNBS.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-M7DQT3X4.js";
 export {
+  AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
+  parseAgentTargets,
   refreshActiveAgentContext,
   renderThinAgent
 };

package/dist/{chunk-ANNG5SIL.js → chunk-M7DQT3X4.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-ADF5FNBS.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-ADF5FNBS.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -960,7 +960,38 @@ async function buildAgentPrompt(ctx, config, projectRoot) {
 }
 
 // src/agents.ts
-var ALL_AGENT_TARGETS = ["copilot", "claude-code", "intellij"];
+var ALL_AGENT_TARGETS = ["copilot", "claude-code"];
+var AGENT_TARGET_OPTIONS = [
+  {
+    id: "copilot",
+    label: "GitHub Copilot",
+    hint: ".github/agents/*.agent.md \u2014 works in VS Code, Cursor, JetBrains, \u2026"
+  },
+  {
+    id: "claude-code",
+    label: "Claude Code",
+    hint: ".claude/agents/*.md \u2014 CLI / terminal agent"
+  }
+];
+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) {
+    if (p === "intellij" || p === "idea" || p === "jetbrains" || p === "vscode" || p === "vs-code" || p === "cursor") {
+      throw new Error(
+        `"${p}" is an IDE, not an AI coding agent. Choose: copilot (GitHub Copilot in any IDE) or claude-code.`
+      );
+    }
+    const id = p === "claude" || p === "claude-code" || p === "claudecode" ? "claude-code" : p === "github-copilot" || p === "gh-copilot" || p === "copilot" ? "copilot" : p;
+    if (!ALL_AGENT_TARGETS.includes(id)) {
+      throw new Error(
+        `Unknown AI coding agent "${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 AI coding agent: ${ALL_AGENT_TARGETS.join(", ")} (not an IDE; do not install all by default)`
+    );
+  }
+  const targets = opts.targets;
   const created = [];
   const skipped = [];
   const root = opts.projectRoot;
@@ -1017,23 +1053,16 @@ async function installAgentIntegrations(opts) {
   };
   await write(join4(".sdd", "protocol.md"), PROTOCOL_MD);
   await refreshActiveAgentContext(root);
-  if (targets.includes("copilot") || targets.includes("claude-code")) {
-    for (const role of SDD_AGENT_ROLES) {
-      const body = renderThinAgent(role);
-      if (targets.includes("claude-code")) {
-        await write(`.claude/agents/${role.id}.md`, body);
-      }
-      if (targets.includes("copilot")) {
-        await write(`.github/agents/${role.id}.agent.md`, body);
-      }
+  for (const role of SDD_AGENT_ROLES) {
+    const body = renderThinAgent(role);
+    if (targets.includes("claude-code")) {
+      await write(`.claude/agents/${role.id}.md`, body);
+    }
+    if (targets.includes("copilot")) {
+      await write(`.github/agents/${role.id}.agent.md`, body);
     }
   }
-  if (targets.includes("intellij")) {
-    await write(".idea/sdd-agent-notes.md", INTELLIJ_NOTES);
-  }
-  if (targets.includes("copilot") || targets.includes("claude-code") || targets.includes("intellij")) {
-    await write("AGENTS.md", AGENTS_MD_THIN);
-  }
+  await write("AGENTS.md", renderAgentsMd(targets));
   await write(
     join4(".sdd", "agents.json"),
     JSON.stringify(
@@ -1178,31 +1207,36 @@ sdd complete
 - Deleting \`.sdd\` / archive history
 - Claiming complete without verify when required
 `;
-var AGENTS_MD_THIN = `# Agents
+function renderAgentsMd(targets) {
+  const rows = [];
+  if (targets.includes("claude-code")) {
+    rows.push(
+      "| Claude Code | `.claude/agents/` (`sdd`, `sdd-planner`, `sdd-implementer`, `sdd-reviewer`) |"
+    );
+  }
+  if (targets.includes("copilot")) {
+    rows.push(
+      "| GitHub Copilot | `.github/agents/*.agent.md` (same roles; any IDE that supports Copilot agents) |"
+    );
+  }
+  return `# Agents
 
 This repo uses **SDD agents only** (no skills).
 
+AI coding agents are **not** the same as IDEs: VS Code, Cursor, and IntelliJ host tools like Copilot or Claude Code.
+
 | Read first | |
 |------------|--|
 | Live task | \`.sdd/active-context.md\` |
 | Playbook | \`.sdd/protocol.md\` |
 
-| Host | Agents |
-|------|--------|
-| Claude Code | \`.claude/agents/\` (\`sdd\`, \`sdd-planner\`, \`sdd-implementer\`, \`sdd-reviewer\`) |
-| GitHub Copilot | \`.github/agents/*.agent.md\` (same roles) |
+| AI agent | Files |
+|----------|--------|
+${rows.join("\n")}
 
 Refresh context: \`sdd agents refresh\`.
 `;
-var INTELLIJ_NOTES = `# SDD + IntelliJ
-
-Agents only. Playbook: \`.sdd/protocol.md\`. Live: \`.sdd/active-context.md\`.
-
-1. Install \`sdd\` on PATH: \`npm i -g @structured-vibe-coding/cli\`
-2. Tools \u2192 SDD \u2192 Initialize / Install Agent Integrations
-3. GitHub Copilot uses \`.github/agents/*\` + active-context (same as VS Code)
-4. After stage changes: **Refresh Agent Context**
-`;
+}
 
 export {
   GateSchema,
@@ -1257,6 +1291,8 @@ export {
   changeDirName,
   uniqueChangeDirName,
   ALL_AGENT_TARGETS,
+  AGENT_TARGET_OPTIONS,
+  parseAgentTargets,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
   renderThinAgent,

package/dist/index.d.ts

@@ -1164,8 +1164,20 @@ declare function completeChange(projectRoot: string, config: Config, changeId: s
 declare function formatStatus(ctx: ChangeContext): string;
 declare function buildAgentPrompt(ctx: ChangeContext, config: Config, projectRoot: string): Promise<string>;
 
-type AgentTarget = "copilot" | "claude-code" | "intellij";
+/**
+ * AI coding agents (not IDEs).
+ * VS Code / Cursor / IntelliJ are editors; they host tools like Copilot or Claude Code.
+ */
+type AgentTarget = "copilot" | "claude-code";
 declare const ALL_AGENT_TARGETS: AgentTarget[];
+/** Human-facing labels for interactive AI-agent 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 +1217,13 @@ interface InitOptions {
     projectRoot: string;
     force?: boolean;
     pack?: "default" | "enterprise";
-    /** Install Copilot / Claude Code / IntelliJ agent files (default: all). */
-    agents?: boolean | AgentTarget[];
+    /**
+     * AI coding agents to install (copilot | claude-code). Not IDEs.
+     * Opt-in only — never defaults to all agents.
+     * - omit / `false` — no agent files
+     * - `AgentTarget[]` — install only those AI agents
+     */
+    agents?: false | AgentTarget[];
 }
 interface InitResult {
     created: string[];
@@ -1264,4 +1281,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-M7DQT3X4.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.1",
   "description": "Core engine for structured vibe coding (local-first Spec-Driven Development)",
   "type": "module",
   "main": "./dist/index.js",