@structured-vibe-coding/core 0.6.2 → 0.8.0

package/dist/{agents-TYGI6EX3.js → agents-UCNZSN5M.js}

@@ -6,17 +6,20 @@ import {
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   agentHostPaths,
+  agentKickoffMessage,
   getIntegration,
   installAgentIntegration,
   installAgentIntegrations,
   integrationKeyFor,
+  loadInstalledAgent,
   optionForTarget,
   parseAgentTargets,
   parseIntegration,
   refreshActiveAgentContext,
   removeOtherAgentHosts,
-  renderThinAgent
-} from "./chunk-74AHVIH4.js";
+  renderThinAgent,
+  writeAgentHandoff
+} from "./chunk-AIFRZY2E.js";
 export {
   AGENT_INTEGRATIONS,
   AGENT_TARGET_OPTIONS,
@@ -25,14 +28,17 @@ export {
   PROTOCOL_MD,
   SDD_AGENT_ROLES,
   agentHostPaths,
+  agentKickoffMessage,
   getIntegration,
   installAgentIntegration,
   installAgentIntegrations,
   integrationKeyFor,
+  loadInstalledAgent,
   optionForTarget,
   parseAgentTargets,
   parseIntegration,
   refreshActiveAgentContext,
   removeOtherAgentHosts,
-  renderThinAgent
+  renderThinAgent,
+  writeAgentHandoff
 };

package/dist/{chunk-74AHVIH4.js → chunk-AIFRZY2E.js}

@@ -896,6 +896,48 @@ 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) {
+  const event = opts.event ?? "context updated";
+  return [
+    `SDD: ${event}.`,
+    `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).`,
+    `Do the work for the current stage only under changes/${opts.changeId}/. Do not expand scope.`,
+    `When the stage is done, tell the human to run: sdd next (or sdd verify / sdd complete as appropriate).`
+  ].join(" ");
+}
 async function refreshActiveAgentContext(projectRoot) {
   const markerDir = sddRoot(projectRoot);
   if (!await pathExists(join4(markerDir, "config.yaml"))) {
@@ -1091,6 +1133,9 @@ export {
   installAgentIntegration,
   installAgentIntegrations,
   renderThinAgent,
+  loadInstalledAgent,
+  writeAgentHandoff,
+  agentKickoffMessage,
   refreshActiveAgentContext,
   PROTOCOL_MD
 };

package/dist/index.d.ts

@@ -1258,6 +1258,27 @@ 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;
+    /** What just happened, e.g. "new change", "advanced to implement" */
+    event?: 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. */
@@ -1329,4 +1350,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, agentHostPaths, 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, removeOtherAgentHosts, 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

@@ -16,6 +16,7 @@ import {
   activePointerPath,
   activeStages,
   agentHostPaths,
+  agentKickoffMessage,
   archiveDir,
   buildAgentPrompt,
   buildContext,
@@ -46,6 +47,7 @@ import {
   listWorkflowNames,
   loadChangeMeta,
   loadConfig,
+  loadInstalledAgent,
   loadWorkflow,
   memoryDir,
   nextStageId,
@@ -73,9 +75,10 @@ import {
   todayIsoDate,
   uniqueChangeDirName,
   workflowsDir,
+  writeAgentHandoff,
   writeText,
   writeYaml
-} from "./chunk-74AHVIH4.js";
+} from "./chunk-AIFRZY2E.js";
 
 // src/change.ts
 import { join as join2 } from "pathe";
@@ -187,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-TYGI6EX3.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-UCNZSN5M.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -283,7 +286,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-TYGI6EX3.js");
+    const { refreshActiveAgentContext: refreshActiveAgentContext2 } = await import("./agents-UCNZSN5M.js");
     await refreshActiveAgentContext2(projectRoot);
   } catch {
   }
@@ -711,6 +714,7 @@ export {
   activeStages,
   advanceStage,
   agentHostPaths,
+  agentKickoffMessage,
   approveGate,
   archiveDir,
   buildAgentPrompt,
@@ -750,6 +754,7 @@ export {
   listWorkflowNames,
   loadChangeMeta,
   loadConfig,
+  loadInstalledAgent,
   loadWorkflow,
   memoryDir,
   nextStageId,
@@ -780,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.2",
+  "version": "0.8.0",
   "description": "Core engine for structured vibe coding (local-first Spec-Driven Development)",
   "type": "module",
   "main": "./dist/index.js",