@structured-vibe-coding/core 0.4.1 → 0.5.0

package/dist/{agents-ADF5FNBS.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-M7DQT3X4.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-M7DQT3X4.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-ADF5FNBS.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-ADF5FNBS.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-SVTCSTX4.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -961,37 +961,58 @@ async function buildAgentPrompt(ctx, config, projectRoot) {
 
 // src/agents.ts
 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 \u2014 works in VS Code, Cursor, JetBrains, \u2026"
+    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 \u2014 CLI / terminal agent"
+    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) {
     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.`
+        `"${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)) {
-      throw new Error(
-        `Unknown AI coding agent "${p}". Choose one of: ${ALL_AGENT_TARGETS.join(", ")}`
-      );
+      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",
@@ -1073,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,
@@ -1291,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

@@ -1167,17 +1167,36 @@ declare function buildAgentPrompt(ctx: ChangeContext, config: Config, projectRoo
 /**
  * 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 AI-agent 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 {
@@ -1281,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-M7DQT3X4.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.1",
+  "version": "0.5.0",
   "description": "Core engine for structured vibe coding (local-first Spec-Driven Development)",
   "type": "module",
   "main": "./dist/index.js",