@structured-vibe-coding/core 0.6.1 → 0.7.0

package/dist/{agents-O5ABMQJQ.js → agents-TN7TOYF7.js}

@@ -5,16 +5,21 @@ import {
   DEFAULT_INIT_INTEGRATION,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
+  agentHostPaths,
+  agentKickoffMessage,
   getIntegration,
   installAgentIntegration,
   installAgentIntegrations,
   integrationKeyFor,
+  loadInstalledAgent,
   optionForTarget,
   parseAgentTargets,
   parseIntegration,
   refreshActiveAgentContext,
-  renderThinAgent
-} from "./chunk-QTHYRKMK.js";
+  removeOtherAgentHosts,
+  renderThinAgent,
+  writeAgentHandoff
+} from "./chunk-4ZDPIYEB.js";
 export {
   AGENT_INTEGRATIONS,
   AGENT_TARGET_OPTIONS,
@@ -22,13 +27,18 @@ export {
   DEFAULT_INIT_INTEGRATION,
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
+  agentHostPaths,
+  agentKickoffMessage,
   getIntegration,
   installAgentIntegration,
   installAgentIntegrations,
   integrationKeyFor,
+  loadInstalledAgent,
   optionForTarget,
   parseAgentTargets,
   parseIntegration,
   refreshActiveAgentContext,
-  renderThinAgent
+  removeOtherAgentHosts,
+  renderThinAgent,
+  writeAgentHandoff
 };

package/dist/{chunk-QTHYRKMK.js → chunk-4ZDPIYEB.js}

@@ -686,6 +686,54 @@ function integrationKeyFor(target) {
 function optionForTarget(target) {
   return getIntegration(target);
 }
+function agentHostPaths(target) {
+  switch (target) {
+    case "copilot":
+      return [".github/agents"];
+    case "claude-code":
+      return [".claude/agents"];
+    case "grok":
+      return [".grok/rules"];
+    default:
+      return [];
+  }
+}
+var LEGACY_AGENT_PATHS = [".idea/sdd-agent-notes.md"];
+async function removeOtherAgentHosts(projectRoot, keep) {
+  const removed = [];
+  for (const integ of AGENT_INTEGRATIONS) {
+    if (integ.id === keep) continue;
+    for (const rel of agentHostPaths(integ.id)) {
+      const full = join4(projectRoot, rel);
+      if (await pathExists(full)) {
+        await removePath(full);
+        removed.push(rel);
+      }
+    }
+  }
+  for (const rel of LEGACY_AGENT_PATHS) {
+    const full = join4(projectRoot, rel);
+    if (await pathExists(full)) {
+      await removePath(full);
+      removed.push(rel);
+    }
+  }
+  for (const parent of [".claude", ".idea", ".grok"]) {
+    if (keep === "grok" && parent === ".grok") continue;
+    const full = join4(projectRoot, parent);
+    if (!await pathExists(full)) continue;
+    try {
+      const { readdir } = await import("fs/promises");
+      const kids = await readdir(full);
+      if (kids.length === 0) {
+        await removePath(full);
+        removed.push(parent);
+      }
+    } catch {
+    }
+  }
+  return removed;
+}
 function parseIntegration(raw) {
   const p = raw.trim().toLowerCase();
   if (!p) {
@@ -764,6 +812,7 @@ async function installAgentIntegration(opts) {
   const skipped = [];
   const root = opts.projectRoot;
   const force = opts.force ?? false;
+  await removeOtherAgentHosts(root, opts.target);
   const write = async (rel, content) => {
     const full = join4(root, rel);
     if (await pathExists(full) && !force) {
@@ -847,6 +896,47 @@ Remind the human: \`sdd verify\` then \`sdd next\` / \`sdd complete\` as appropr
 Do not claim the change is complete without local verification when the workflow requires it.
 `;
 }
+async function loadInstalledAgent(projectRoot) {
+  const path = join4(sddRoot(projectRoot), "agents.json");
+  if (!await pathExists(path)) return null;
+  try {
+    const raw = JSON.parse(await readText(path));
+    const key = raw.ai ?? raw.integration ?? raw.installed?.[0];
+    if (!key || typeof key !== "string") return null;
+    const target = parseIntegration(key);
+    return { ai: integrationKeyFor(target), target, integration: getIntegration(target) };
+  } catch {
+    return null;
+  }
+}
+async function writeAgentHandoff(projectRoot, config, changeId) {
+  const ctx = await buildContext(projectRoot, config, changeId);
+  const body = await buildAgentPrompt(ctx, config, projectRoot);
+  const outPath = join4(sddRoot(projectRoot), "handoff.md");
+  const header = `# SDD handoff (auto)
+
+> Generated for the AI coding agent configured at init.  
+> Change: **${ctx.meta.title}** \xB7 \`${ctx.id}\` \xB7 stage **${ctx.meta.stage}**
+
+Also read: \`.sdd/active-context.md\`, \`.sdd/protocol.md\`, \`memory/constitution.md\` if present.
+
+---
+
+`;
+  await writeText(outPath, header + body + "\n");
+  return outPath;
+}
+function agentKickoffMessage(opts) {
+  return [
+    `SDD: new change started.`,
+    `Title: ${opts.title}`,
+    `Change: ${opts.changeId}`,
+    `Stage: ${opts.stage}`,
+    `Read in order: .sdd/active-context.md, .sdd/handoff.md, .sdd/protocol.md, memory/constitution.md (if present).`,
+    `Fill/update current stage artifacts only under changes/${opts.changeId}/. Do not expand scope.`,
+    `When the stage is done, tell the human to run: sdd next`
+  ].join(" ");
+}
 async function refreshActiveAgentContext(projectRoot) {
   const markerDir = sddRoot(projectRoot);
   if (!await pathExists(join4(markerDir, "config.yaml"))) {
@@ -1034,12 +1124,17 @@ export {
   getIntegration,
   integrationKeyFor,
   optionForTarget,
+  agentHostPaths,
+  removeOtherAgentHosts,
   parseIntegration,
   parseAgentTargets,
   SDD_AGENT_ROLES,
   installAgentIntegration,
   installAgentIntegrations,
   renderThinAgent,
+  loadInstalledAgent,
+  writeAgentHandoff,
+  agentKickoffMessage,
   refreshActiveAgentContext,
   PROTOCOL_MD
 };

package/dist/index.d.ts

@@ -1197,6 +1197,16 @@ declare const AGENT_TARGET_OPTIONS: AgentTargetOption[];
 declare function getIntegration(target: AgentTarget): AgentIntegration;
 declare function integrationKeyFor(target: AgentTarget): string;
 declare function optionForTarget(target: AgentTarget): AgentTargetOption;
+/**
+ * Paths this integration owns (safe to delete when switching agents).
+ * Never includes shared SDD dirs (memory, changes, .sdd) or whole .github (workflows stay).
+ */
+declare function agentHostPaths(target: AgentTarget): string[];
+/**
+ * Remove agent files for hosts other than `keep` (and legacy IntelliJ notes).
+ * Does not touch .sdd/, memory/, changes/, or non-agent .github content.
+ */
+declare function removeOtherAgentHosts(projectRoot: string, keep: AgentTarget): Promise<string[]>;
 /** Parse one Speckit-style integration key. */
 declare function parseIntegration(raw: string): AgentTarget;
 /**
@@ -1248,6 +1258,25 @@ declare function installAgentIntegration(opts: InstallAgentOptions): Promise<Ins
 declare function installAgentIntegrations(opts: InstallAgentsOptions): Promise<InstallAgentsResult>;
 /** Thin agent body shared across hosts (same text). */
 declare function renderThinAgent(role: SddAgentRole): string;
+interface InstalledAgentSnapshot {
+    /** Public key: copilot | claude | grok */
+    ai: string;
+    target: AgentTarget;
+    integration: AgentIntegration;
+}
+/** Read which AI agent was configured at `sdd init` / last agents install. */
+declare function loadInstalledAgent(projectRoot: string): Promise<InstalledAgentSnapshot | null>;
+/**
+ * Write `.sdd/handoff.md` for the active (or given) change — full agent brief.
+ * Used by `sdd agent` and auto-launch after `sdd new`.
+ */
+declare function writeAgentHandoff(projectRoot: string, config: Config, changeId: string): Promise<string>;
+/** Short kickoff line to pass into agent CLIs (full brief is in handoff.md). */
+declare function agentKickoffMessage(opts: {
+    title: string;
+    stage: string;
+    changeId: string;
+}): string;
 /** Write .sdd/active-context.md for the current change. */
 declare function refreshActiveAgentContext(projectRoot: string): Promise<string | null>;
 /** Single playbook — only long agent-facing content we author once. */
@@ -1319,4 +1348,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_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdvanceResult, type AgentIntegration, 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 InstallAgentOptions, type InstallAgentResult, 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, getIntegration, getStage, inferComplexity, initProject, installAgentIntegration, installAgentIntegrations, integrationKeyFor, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadWorkflow, memoryDir, nextStageId, nowIso, optionForTarget, parseAgentTargets, parseIntegration, pathExists, 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_INTEGRATIONS, AGENT_TARGET_OPTIONS, ALL_AGENT_TARGETS, type AdvanceResult, type AgentIntegration, 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 InstallAgentOptions, type InstallAgentResult, type InstallAgentsOptions, type InstallAgentsResult, type InstalledAgentSnapshot, PROTOCOL_MD, SDD_AGENT_ROLES, SDD_DIR, type SddAgentRole, type SddAgentRoleId, type Stage, StageSchema, VerifyCommandSchema, type VerifyResult, type Workflow, WorkflowSchema, activePointerPath, activeStages, advanceStage, agentHostPaths, agentKickoffMessage, approveGate, archiveDir, buildAgentPrompt, buildContext, canLeaveStage, changeDirName, changeMetaPath, changePath, changesDir, clearActiveIf, completeChange, configPath, copyDir, createChange, defaultConfig, defaultMemoryDir, defaultTemplatesDir, defaultWorkflowsDir, defaultsRoot, domainsDir, ensureDir, firstActiveStageId, formatStatus, getActiveChangeId, getIntegration, getStage, inferComplexity, initProject, installAgentIntegration, installAgentIntegrations, integrationKeyFor, isInitialized, isStageSkipped, listChanges, listDirs, listFiles, listWorkflowNames, loadChangeMeta, loadConfig, loadInstalledAgent, loadWorkflow, memoryDir, nextStageId, nowIso, optionForTarget, parseAgentTargets, parseIntegration, pathExists, readText, readYaml, recommendWorkflow, refreshActiveAgentContext, removeOtherAgentHosts, removePath, renderThinAgent, resolveChangeId, resolveStages, runLocalVerify, saveChangeMeta, saveConfig, sddRoot, setActiveChange, shouldAutoSkip, skipStage, slugify, switchWorkflow, templatesDir, todayIsoDate, uniqueChangeDirName, workflowsDir, writeAgentHandoff, writeText, writeYaml };

package/dist/index.js

@@ -15,6 +15,8 @@ import {
   WorkflowSchema,
   activePointerPath,
   activeStages,
+  agentHostPaths,
+  agentKickoffMessage,
   archiveDir,
   buildAgentPrompt,
   buildContext,
@@ -45,6 +47,7 @@ import {
   listWorkflowNames,
   loadChangeMeta,
   loadConfig,
+  loadInstalledAgent,
   loadWorkflow,
   memoryDir,
   nextStageId,
@@ -57,6 +60,7 @@ import {
   readYaml,
   recommendWorkflow,
   refreshActiveAgentContext,
+  removeOtherAgentHosts,
   removePath,
   renderThinAgent,
   resolveChangeId,
@@ -71,9 +75,10 @@ import {
   todayIsoDate,
   uniqueChangeDirName,
   workflowsDir,
+  writeAgentHandoff,
   writeText,
   writeYaml
-} from "./chunk-QTHYRKMK.js";
+} from "./chunk-4ZDPIYEB.js";
 
 // src/change.ts
 import { join as join2 } from "pathe";
@@ -185,7 +190,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-O5ABMQJQ.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-TN7TOYF7.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -281,7 +286,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-O5ABMQJQ.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-TN7TOYF7.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -708,6 +713,8 @@ export {
   activePointerPath,
   activeStages,
   advanceStage,
+  agentHostPaths,
+  agentKickoffMessage,
   approveGate,
   archiveDir,
   buildAgentPrompt,
@@ -747,6 +754,7 @@ export {
   listWorkflowNames,
   loadChangeMeta,
   loadConfig,
+  loadInstalledAgent,
   loadWorkflow,
   memoryDir,
   nextStageId,
@@ -759,6 +767,7 @@ export {
   readYaml,
   recommendWorkflow,
   refreshActiveAgentContext,
+  removeOtherAgentHosts,
   removePath,
   renderThinAgent,
   resolveChangeId,
@@ -776,6 +785,7 @@ export {
   todayIsoDate,
   uniqueChangeDirName,
   workflowsDir,
+  writeAgentHandoff,
   writeText,
   writeYaml
 };

package/package.json

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