@structured-vibe-coding/core 0.4.0 → 0.5.0

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

@@ -1,20 +1,28 @@
 import {
   AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
+  DEFAULT_INIT_INTEGRATION,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
+  integrationKeyFor,
+  optionForTarget,
   parseAgentTargets,
+  parseIntegration,
   refreshActiveAgentContext,
   renderThinAgent
-} from "./chunk-BP54LEAD.js";
+} from "./chunk-32PIFJ2Y.js";
 export {
   AGENT_TARGET_OPTIONS,
   ALL_AGENT_TARGETS,
+  DEFAULT_INIT_INTEGRATION,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
+  integrationKeyFor,
+  optionForTarget,
   parseAgentTargets,
+  parseIntegration,
   refreshActiveAgentContext,
   renderThinAgent
 };

package/dist/{chunk-BP54LEAD.js → chunk-32PIFJ2Y.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-2ONGBIGG.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-SVTCSTX4.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -738,7 +738,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-2ONGBIGG.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-SVTCSTX4.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -960,38 +960,59 @@ 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 DEFAULT_INIT_INTEGRATION = "copilot";
 var AGENT_TARGET_OPTIONS = [
   {
     id: "copilot",
+    key: "copilot",
     label: "GitHub Copilot",
-    hint: ".github/agents/*.agent.md"
+    hint: ".github/agents/*.agent.md (VS Code, Cursor, JetBrains, \u2026)",
+    requiresCli: false,
+    installUrl: "https://github.com/features/copilot"
   },
   {
     id: "claude-code",
+    key: "claude",
     label: "Claude Code",
-    hint: ".claude/agents/*.md"
-  },
-  {
-    id: "intellij",
-    label: "IntelliJ / JetBrains",
-    hint: ".idea/sdd-agent-notes.md"
+    hint: ".claude/agents/*.md (terminal agent)",
+    requiresCli: true,
+    installUrl: "https://docs.anthropic.com/en/docs/claude-code"
   }
 ];
+function integrationKeyFor(target) {
+  return AGENT_TARGET_OPTIONS.find((o) => o.id === target)?.key ?? target;
+}
+function optionForTarget(target) {
+  return AGENT_TARGET_OPTIONS.find((o) => o.id === target);
+}
 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)) {
+    if (p === "intellij" || p === "idea" || p === "jetbrains" || p === "vscode" || p === "vs-code" || p === "cursor") {
       throw new Error(
-        `Unknown agent platform "${p}". Choose one of: ${ALL_AGENT_TARGETS.join(", ")}`
+        `"${p}" is an IDE, not an AI coding agent. Choose: copilot or claude (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)) {
+      const keys = AGENT_TARGET_OPTIONS.map((o) => o.key).join(", ");
+      throw new Error(`Unknown AI coding agent "${p}". Choose from: ${keys}`);
+    }
     if (!out.includes(id)) out.push(id);
   }
   return out;
 }
+function parseIntegration(raw) {
+  const list = parseAgentTargets(raw);
+  if (list.length !== 1) {
+    throw new Error(
+      `Expected one AI coding agent (like Speckit --integration), got: ${raw}`
+    );
+  }
+  return list[0];
+}
 var SDD_AGENT_ROLES = [
   {
     id: "sdd",
@@ -1034,7 +1055,7 @@ var SDD_AGENT_ROLES = [
 async function installAgentIntegrations(opts) {
   if (!opts.targets?.length) {
     throw new Error(
-      `Specify at least one agent platform: ${ALL_AGENT_TARGETS.join(", ")} (do not install all by default)`
+      `Specify at least one AI coding agent: ${ALL_AGENT_TARGETS.join(", ")} (not an IDE; do not install all by default)`
     );
   }
   const targets = opts.targets;
@@ -1053,23 +1074,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(
@@ -1080,6 +1094,21 @@ async function installAgentIntegrations(opts) {
         activeContext: ".sdd/active-context.md",
         roles: SDD_AGENT_ROLES.map((r) => r.id),
         installed: targets,
+        /** Speckit-style primary integration key (first target). */
+        integration: targets[0] ? integrationKeyFor(targets[0]) : null,
+        updated: (/* @__PURE__ */ new Date()).toISOString()
+      },
+      null,
+      2
+    ) + "\n"
+  );
+  await write(
+    join4(".sdd", "init-options.json"),
+    JSON.stringify(
+      {
+        ai: targets[0] ? integrationKeyFor(targets[0]) : null,
+        integration: targets[0] ? integrationKeyFor(targets[0]) : null,
+        installed: targets.map(integrationKeyFor),
         updated: (/* @__PURE__ */ new Date()).toISOString()
       },
       null,
@@ -1214,31 +1243,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,
@@ -1293,8 +1327,12 @@ export {
   changeDirName,
   uniqueChangeDirName,
   ALL_AGENT_TARGETS,
+  DEFAULT_INIT_INTEGRATION,
   AGENT_TARGET_OPTIONS,
+  integrationKeyFor,
+  optionForTarget,
   parseAgentTargets,
+  parseIntegration,
   SDD_AGENT_ROLES,
   installAgentIntegrations,
   renderThinAgent,

package/dist/index.d.ts

@@ -1164,16 +1164,39 @@ 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.
+ *
+ * Speckit-style: one integration at a time; public keys are short (`copilot`, `claude`).
+ */
+type AgentTarget = "copilot" | "claude-code";
 declare const ALL_AGENT_TARGETS: AgentTarget[];
-/** Human-facing labels for interactive platform pick (CLI / IDE). */
-declare const AGENT_TARGET_OPTIONS: {
+/** Default when non-interactive and no --ai / --integration (matches Speckit). */
+declare const DEFAULT_INIT_INTEGRATION: AgentTarget;
+interface AgentTargetOption {
+    /** Internal install id (file paths / agents.json). */
     id: AgentTarget;
+    /** Speckit-style public key used with --ai / --integration. */
+    key: string;
     label: string;
     hint: string;
-}[];
-/** Parse `copilot`, `claude-code,copilot`, etc. Throws on unknown ids. */
+    /** If true, CLI may check that the agent binary is on PATH. */
+    requiresCli: boolean;
+    installUrl: string;
+}
+/** Human-facing options for interactive AI-agent pick (CLI / IDE). */
+declare const AGENT_TARGET_OPTIONS: AgentTargetOption[];
+/** Public CLI keys → internal targets (Speckit uses `claude`, not `claude-code`). */
+declare function integrationKeyFor(target: AgentTarget): string;
+declare function optionForTarget(target: AgentTarget): AgentTargetOption | undefined;
+/**
+ * Parse Speckit-style integration keys: `copilot`, `claude`, `claude-code`, …
+ * Throws on unknown ids or IDE names.
+ */
 declare function parseAgentTargets(raw: string | string[]): AgentTarget[];
+/** Parse a single Speckit-style integration (exactly one). */
+declare function parseIntegration(raw: string): AgentTarget;
 /** Roles emitted as thin agents (shared body generator — no skill files). */
 type SddAgentRoleId = "sdd" | "sdd-planner" | "sdd-implementer" | "sdd-reviewer";
 interface SddAgentRole {
@@ -1214,9 +1237,10 @@ interface InitOptions {
     force?: boolean;
     pack?: "default" | "enterprise";
     /**
-     * Agent platforms to install. Opt-in only — never defaults to all platforms.
+     * 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 hosts
+     * - `AgentTarget[]` — install only those AI agents
      */
     agents?: false | AgentTarget[];
 }
@@ -1276,4 +1300,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 { 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 };
+export { AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdvanceResult, type AgentTarget, type AgentTargetOption, type ArtifactDef, ArtifactDefSchema, type ChangeContext, type ChangeMeta, ChangeMetaSchema, type Complexity, type Config, ConfigSchema, type CreateChangeInput, DEFAULT_INIT_INTEGRATION, 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, integrationKeyFor, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, optionForTarget, parseAgentTargets, parseIntegration, 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

@@ -4,6 +4,7 @@ import {
   ArtifactDefSchema,
   ChangeMetaSchema,
   ConfigSchema,
+  DEFAULT_INIT_INTEGRATION,
   GateSchema,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
@@ -37,6 +38,7 @@ import {
   getStage,
   inferComplexity,
   installAgentIntegrations,
+  integrationKeyFor,
   isInitialized,
   isStageSkipped,
   listChanges,
@@ -49,7 +51,9 @@ import {
   memoryDir,
   nextStageId,
   nowIso,
+  optionForTarget,
   parseAgentTargets,
+  parseIntegration,
   pathExists,
   previousStageId,
   projectPaths,
@@ -75,7 +79,7 @@ import {
   workflowsDir,
   writeText,
   writeYaml
-} from "./chunk-BP54LEAD.js";
+} from "./chunk-32PIFJ2Y.js";
 
 // src/init.ts
 import { join as join2 } from "pathe";
@@ -342,6 +346,7 @@ export {
   ArtifactDefSchema,
   ChangeMetaSchema,
   ConfigSchema,
+  DEFAULT_INIT_INTEGRATION,
   GateSchema,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
@@ -380,6 +385,7 @@ export {
   inferComplexity,
   initProject,
   installAgentIntegrations,
+  integrationKeyFor,
   isInitialized,
   isStageSkipped,
   listChanges,
@@ -392,7 +398,9 @@ export {
   memoryDir,
   nextStageId,
   nowIso,
+  optionForTarget,
   parseAgentTargets,
+  parseIntegration,
   pathExists,
   previousStageId,
   projectPaths,

package/package.json

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