@structured-vibe-coding/core 0.12.1 → 0.13.0

package/dist/chunk-C725DWSB.js

@@ -0,0 +1,122 @@
+import {
+  getStage,
+  isStageSkipped,
+  shouldAutoSkip
+} from "./chunk-A752UVPF.js";
+
+// src/agent-handoff.ts
+import { join } from "pathe";
+function formatStatus(ctx) {
+  const lines = [];
+  lines.push(`Change: ${ctx.meta.title}`);
+  lines.push(`ID:     ${ctx.id}`);
+  lines.push(`Status: ${ctx.meta.status}`);
+  lines.push(`Workflow: ${ctx.meta.workflow}`);
+  lines.push(`Path: ${ctx.path}`);
+  lines.push("");
+  lines.push("Stages:");
+  for (const stage of ctx.stages) {
+    const skipped = isStageSkipped(ctx.meta, stage.id) || shouldAutoSkip(stage, ctx.meta);
+    let mark = " ";
+    if (skipped) mark = "\xB7";
+    else if (stage.id === ctx.meta.stage) mark = "\u25CF";
+    else {
+      const order = ctx.active.map((s) => s.id);
+      const cur = order.indexOf(ctx.meta.stage);
+      const idx = order.indexOf(stage.id);
+      if (idx >= 0 && cur >= 0 && idx < cur) mark = "\u2713";
+    }
+    const gate = ctx.meta.gates?.[stage.id];
+    const gateInfo = gate ? ` [${gate.status}]` : "";
+    const skipInfo = skipped ? " (skipped)" : "";
+    lines.push(
+      `  [${mark}] ${stage.id}${stage.title ? ` \u2014 ${stage.title}` : ""}${gateInfo}${skipInfo}`
+    );
+  }
+  if (ctx.meta.overrides?.skip_stages?.length) {
+    lines.push("");
+    lines.push(`Overrides: skip=${ctx.meta.overrides.skip_stages.join(", ")}`);
+  }
+  return lines.join("\n");
+}
+async function buildAgentPrompt(ctx, config, projectRoot) {
+  const stage = getStage(ctx.workflow, ctx.meta, ctx.meta.stage);
+  const parts = [];
+  parts.push(`# SDD Agent Handoff`);
+  parts.push("");
+  parts.push(`You are implementing a change under Structured Vibe Coding (local SDD).`);
+  parts.push("");
+  parts.push(`## Change`);
+  parts.push(`- Title: ${ctx.meta.title}`);
+  parts.push(`- ID: ${ctx.id}`);
+  parts.push(`- Workflow: ${ctx.meta.workflow}`);
+  parts.push(
+    `- Current stage: ${ctx.meta.stage}${stage?.title ? ` (${stage.title})` : ""}`
+  );
+  parts.push(`- Change path: ${ctx.path}`);
+  parts.push("");
+  if (stage?.summary) {
+    parts.push(`## Stage goal`);
+    parts.push(stage.summary);
+    parts.push("");
+  }
+  if (stage?.agent_context?.instructions) {
+    parts.push(`## Instructions`);
+    parts.push(stage.agent_context.instructions);
+    parts.push("");
+  }
+  parts.push(`## Constraints`);
+  parts.push(`- Follow artifacts in the change directory as source of truth.`);
+  parts.push(`- Honor \`memory/constitution.md\` when present (non-negotiables).`);
+  parts.push(`- Do not skip ARB/decision constraints if present.`);
+  parts.push(`- Local development only \u2014 verify on this machine.`);
+  parts.push(`- Prefer small, reviewable commits.`);
+  parts.push("");
+  parts.push(`## Artifacts to read`);
+  const memoryHint = join(projectRoot, config.memory_path);
+  parts.push(`- Documentation map (if present): ${memoryHint}/index.md`);
+  parts.push(`- Memory: ${memoryHint}/`);
+  for (const s of ctx.stages) {
+    for (const a of s.artifacts) {
+      parts.push(`- ${join(ctx.path, a.path)}`);
+    }
+  }
+  parts.push("");
+  parts.push(`## Current stage artifacts`);
+  if (stage) {
+    for (const a of stage.artifacts) {
+      parts.push(`- ${a.path}${a.required ? " (required)" : ""}`);
+    }
+  }
+  parts.push("");
+  const stageId = ctx.meta.stage;
+  if (stageId === "implement" || stageId === "local_verify") {
+    parts.push(`## Code context (product code)`);
+    parts.push("");
+    parts.push(
+      `Process context above is not enough for product code structure.`
+    );
+    parts.push(
+      `When you need symbols, callers, or package-boundary context:`
+    );
+    parts.push(
+      `1. Run: \`sdd context\` (optional: \`--path \u2026\`, \`--symbol \u2026\`, \`--out change\`)`
+    );
+    parts.push(
+      `2. If present, read: \`changes/${ctx.id}/code-context.md\` (regenerate if stale)`
+    );
+    parts.push(
+      `Do not dump unbounded source into the prompt; prefer the sliced output.`
+    );
+    parts.push("");
+  }
+  parts.push(
+    `When done with this stage, the human will run \`sdd next\` or \`sdd verify\` / \`sdd complete\`.`
+  );
+  return parts.join("\n");
+}
+
+export {
+  formatStatus,
+  buildAgentPrompt
+};

package/dist/chunk-OJFMJHNL.js

@@ -0,0 +1,42 @@
+import {
+  ConfigSchema
+} from "./chunk-67AUAGNV.js";
+import {
+  configPath,
+  sddRoot
+} from "./chunk-7MJYPJMR.js";
+import {
+  ensureDir,
+  pathExists,
+  readYaml,
+  writeYaml
+} from "./chunk-EPFURATC.js";
+
+// src/config.ts
+async function isInitialized(projectRoot) {
+  return pathExists(configPath(projectRoot));
+}
+async function loadConfig(projectRoot) {
+  const path = configPath(projectRoot);
+  if (!await pathExists(path)) {
+    throw new Error(
+      `SDD is not initialized in ${projectRoot}. Run \`sdd init\` first.`
+    );
+  }
+  const raw = await readYaml(path);
+  return ConfigSchema.parse(raw);
+}
+async function saveConfig(projectRoot, config) {
+  await ensureDir(sddRoot(projectRoot));
+  await writeYaml(configPath(projectRoot), ConfigSchema.parse(config));
+}
+function defaultConfig() {
+  return ConfigSchema.parse({});
+}
+
+export {
+  isInitialized,
+  loadConfig,
+  saveConfig,
+  defaultConfig
+};