@structured-vibe-coding/core 0.12.2 → 0.13.0

package/dist/{chunk-24S2YWWL.js → chunk-S7SHVKG4.js}

@@ -1,413 +1,26 @@
 import {
-  ChangeMetaSchema,
-  WorkflowSchema,
   loadConfig
-} from "./chunk-KZHNYGD6.js";
+} from "./chunk-OJFMJHNL.js";
 import {
-  activePointerPath,
-  changeMetaPath,
-  changePath,
-  changesDir,
-  sddRoot,
-  workflowsDir
+  buildAgentPrompt,
+  formatStatus
+} from "./chunk-C725DWSB.js";
+import {
+  buildContext,
+  getActiveChangeId
+} from "./chunk-A752UVPF.js";
+import {
+  sddRoot
 } from "./chunk-7MJYPJMR.js";
 import {
-  ensureDir,
-  listDirs,
-  listFiles,
   pathExists,
   readText,
-  readYaml,
   removePath,
-  writeText,
-  writeYaml
+  writeText
 } from "./chunk-EPFURATC.js";
 
 // src/agents.ts
-import { join as join3 } from "pathe";
-
-// src/slug.ts
-function slugify(input) {
-  return input.toLowerCase().trim().replace(/['"]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60).replace(/-+$/g, "");
-}
-function todayIsoDate(d = /* @__PURE__ */ new Date()) {
-  return d.toISOString().slice(0, 10);
-}
-function nowIso(d = /* @__PURE__ */ new Date()) {
-  return d.toISOString();
-}
-function changeDirName(title, d = /* @__PURE__ */ new Date()) {
-  const slug = slugify(title) || "change";
-  return `${todayIsoDate(d)}-${slug}`;
-}
-function uniqueChangeDirName(base, taken) {
-  if (!taken.has(base)) return base;
-  let n = 2;
-  while (taken.has(`${base}-${n}`)) n += 1;
-  return `${base}-${n}`;
-}
-
-// src/workflow.ts
 import { join } from "pathe";
-async function listWorkflowNames(projectRoot) {
-  const dir = workflowsDir(projectRoot);
-  const files = await listFiles(dir);
-  return files.filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).map((f) => f.replace(/\.ya?ml$/, "")).sort();
-}
-async function loadWorkflow(projectRoot, name) {
-  const dir = workflowsDir(projectRoot);
-  const candidates = [`${name}.yaml`, `${name}.yml`];
-  for (const file of candidates) {
-    const path = join(dir, file);
-    if (await pathExists(path)) {
-      const raw = await readYaml(path);
-      const workflow = WorkflowSchema.parse(raw);
-      if (workflow.name !== name) {
-      }
-      return workflow;
-    }
-  }
-  throw new Error(
-    `Workflow "${name}" not found in ${dir}. Available: ${(await listWorkflowNames(projectRoot)).join(", ") || "(none)"}`
-  );
-}
-function resolveStages(workflow, meta) {
-  const base = [...workflow.stages];
-  const extra = meta.overrides?.extra_stages ?? [];
-  const stages = [...base, ...extra];
-  return stages.map((stage) => {
-    const gateOverride = meta.overrides?.gates?.[stage.id];
-    if (!gateOverride) return stage;
-    return {
-      ...stage,
-      gate: {
-        ...stage.gate,
-        type: gateOverride
-      }
-    };
-  });
-}
-function isStageSkipped(meta, stageId) {
-  if (meta.overrides?.skip_stages?.includes(stageId)) return true;
-  if (meta.skipped?.some((s) => s.stage === stageId)) return true;
-  return false;
-}
-function shouldAutoSkip(stage, meta) {
-  const flags = stage.skip_when?.flags ?? [];
-  for (const flag of flags) {
-    if (meta.flags?.[flag] === true || meta.flags?.[flag] === "true") {
-      return true;
-    }
-  }
-  return false;
-}
-function activeStages(workflow, meta) {
-  return resolveStages(workflow, meta).filter((s) => {
-    if (isStageSkipped(meta, s.id)) return false;
-    if (shouldAutoSkip(s, meta)) return false;
-    return true;
-  });
-}
-function getStage(workflow, meta, stageId) {
-  return resolveStages(workflow, meta).find((s) => s.id === stageId);
-}
-function nextStageId(workflow, meta) {
-  const all = resolveStages(workflow, meta);
-  const activeIds = new Set(activeStages(workflow, meta).map((s) => s.id));
-  let start = all.findIndex((s) => s.id === meta.stage);
-  if (start === -1) start = -1;
-  for (let i = start + 1; i < all.length; i++) {
-    const id = all[i].id;
-    if (activeIds.has(id)) return id;
-  }
-  return null;
-}
-function firstActiveStageId(workflow, meta) {
-  return activeStages(workflow, meta)[0]?.id ?? null;
-}
-function inferComplexity(title, hints) {
-  const text = `${title} ${(hints?.keywords ?? []).join(" ")}`.toLowerCase();
-  const hotfixHints = ["typo", "hotfix", "nit", "rename", "bump", "chore", "readme", "docs"];
-  const highHints = [
-    "architecture",
-    "migration",
-    "auth",
-    "payment",
-    "billing",
-    "redesign",
-    "platform",
-    "arb",
-    "epic"
-  ];
-  if (hotfixHints.some((h) => text.includes(h))) return "low";
-  if (highHints.some((h) => text.includes(h))) return "high";
-  if (text.length > 80) return "medium";
-  return "medium";
-}
-async function recommendWorkflow(projectRoot, title, config, opts) {
-  const available = await listWorkflowNames(projectRoot);
-  const allowed = config.allowed_workflows?.length ? available.filter((n) => config.allowed_workflows.includes(n)) : available;
-  if (opts?.preferred) {
-    if (!available.includes(opts.preferred)) {
-      throw new Error(
-        `Workflow "${opts.preferred}" is not available. Available: ${available.join(", ") || "(none)"}`
-      );
-    }
-    if (config.allowed_workflows?.length && !config.allowed_workflows.includes(opts.preferred)) {
-      throw new Error(
-        `Workflow "${opts.preferred}" is not in allowed_workflows: ${config.allowed_workflows.join(", ")}`
-      );
-    }
-    return {
-      name: opts.preferred,
-      reason: "Explicitly selected",
-      alternatives: allowed.filter((n) => n !== opts.preferred)
-    };
-  }
-  if (config.default_workflow !== "recommend" && allowed.includes(config.default_workflow)) {
-    return {
-      name: config.default_workflow,
-      reason: `Repo default_workflow=${config.default_workflow}`,
-      alternatives: allowed.filter((n) => n !== config.default_workflow)
-    };
-  }
-  const complexity = opts?.complexity ?? inferComplexity(title);
-  const scored = [];
-  for (const name of allowed) {
-    try {
-      const wf = await loadWorkflow(projectRoot, name);
-      let score = wf.recommendation?.priority ?? 0;
-      let reason = `workflow priority ${score}`;
-      const when = wf.recommendation?.when;
-      if (complexity === "low" && name === "hotfix") {
-        score += 50;
-        reason = "Low complexity \u2192 hotfix";
-      } else if (complexity === "low" && name === "patch") {
-        score += 40;
-        reason = "Low complexity \u2192 patch";
-      } else if (complexity === "medium" && name === "feature") {
-        score += 45;
-        reason = "Medium complexity \u2192 feature";
-      } else if (complexity === "medium" && name === "patch") {
-        score += 30;
-        reason = "Medium complexity \u2192 patch";
-      } else if (complexity === "high" && name === "enterprise-feature") {
-        score += 50;
-        reason = "High complexity \u2192 enterprise-feature";
-      } else if (complexity === "high" && name === "feature") {
-        score += 35;
-        reason = "High complexity \u2192 feature";
-      }
-      const keywords = when?.keywords ?? [];
-      const titleLower = title.toLowerCase();
-      if (keywords.some((k) => titleLower.includes(k.toLowerCase()))) {
-        score += 20;
-        reason = `Keyword match for ${name}`;
-      }
-      scored.push({ name, score, reason });
-    } catch {
-    }
-  }
-  scored.sort((a, b) => b.score - a.score);
-  const best = scored[0];
-  if (!best) {
-    throw new Error("No workflows available. Run `sdd init` or add files under .sdd/workflows/");
-  }
-  return {
-    name: best.name,
-    reason: best.reason,
-    alternatives: scored.slice(1).map((s) => s.name)
-  };
-}
-
-// src/change-context.ts
-async function loadChangeMeta(projectRoot, config, changeId) {
-  const path = changeMetaPath(projectRoot, config, changeId);
-  if (!await pathExists(path)) {
-    throw new Error(`Change not found: ${changeId}`);
-  }
-  return ChangeMetaSchema.parse(await readYaml(path));
-}
-async function saveChangeMeta(projectRoot, config, meta) {
-  meta.updated = nowIso();
-  await writeYaml(changeMetaPath(projectRoot, config, meta.id), ChangeMetaSchema.parse(meta));
-}
-async function buildContext(projectRoot, config, changeId) {
-  const meta = await loadChangeMeta(projectRoot, config, changeId);
-  const workflow = await loadWorkflow(projectRoot, meta.workflow);
-  return {
-    id: changeId,
-    path: changePath(projectRoot, config, changeId),
-    meta,
-    workflow,
-    stages: resolveStages(workflow, meta),
-    active: activeStages(workflow, meta)
-  };
-}
-async function listChanges(projectRoot, config) {
-  return listDirs(changesDir(projectRoot, config));
-}
-async function getActiveChangeId(projectRoot, config) {
-  const pointer = activePointerPath(projectRoot, config);
-  if (await pathExists(pointer)) {
-    const id = (await readText(pointer)).trim();
-    if (id && await pathExists(changePath(projectRoot, config, id))) {
-      return id;
-    }
-    if (id) {
-      await writeText(pointer, "");
-    }
-  }
-  const all = await listChanges(projectRoot, config);
-  const inProgress = [];
-  for (const id of all) {
-    try {
-      const meta = await loadChangeMeta(projectRoot, config, id);
-      if (meta.status === "in_progress" || meta.status === "blocked") {
-        inProgress.push({ id, updated: meta.updated ?? meta.created });
-      }
-    } catch {
-    }
-  }
-  if (!inProgress.length) return null;
-  inProgress.sort((a, b) => b.updated.localeCompare(a.updated));
-  return inProgress[0].id;
-}
-async function clearActiveIf(projectRoot, config, changeId) {
-  const pointer = activePointerPath(projectRoot, config);
-  if (!await pathExists(pointer)) return;
-  const id = (await readText(pointer)).trim();
-  if (id === changeId) {
-    await writeText(pointer, "");
-  }
-}
-async function setActiveChange(projectRoot, config, changeId) {
-  await ensureDir(changesDir(projectRoot, config));
-  await writeText(activePointerPath(projectRoot, config), `${changeId}
-`);
-}
-async function resolveChangeId(projectRoot, config, changeId) {
-  if (changeId) return changeId;
-  const active = await getActiveChangeId(projectRoot, config);
-  if (!active) {
-    throw new Error("No active change. Pass --change <id> or run `sdd new`.");
-  }
-  return active;
-}
-
-// src/agent-handoff.ts
-import { join as join2 } 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 = join2(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(`- ${join2(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");
-}
-
-// src/agents.ts
 var AGENT_INTEGRATIONS = [
   {
     id: "copilot",
@@ -512,7 +125,7 @@ async function removeOtherAgentHosts(projectRoot, keep) {
   for (const integ of AGENT_INTEGRATIONS) {
     if (integ.id === keep) continue;
     for (const rel of agentHostPaths(integ.id)) {
-      const full = join3(projectRoot, rel);
+      const full = join(projectRoot, rel);
       if (await pathExists(full)) {
         await removePath(full);
         removed.push(rel);
@@ -520,7 +133,7 @@ async function removeOtherAgentHosts(projectRoot, keep) {
     }
   }
   for (const rel of LEGACY_AGENT_PATHS) {
-    const full = join3(projectRoot, rel);
+    const full = join(projectRoot, rel);
     if (await pathExists(full)) {
       await removePath(full);
       removed.push(rel);
@@ -529,7 +142,7 @@ async function removeOtherAgentHosts(projectRoot, keep) {
   for (const parent of [".claude", ".idea", ".grok", ".ollama"]) {
     if (keep === "grok" && parent === ".grok") continue;
     if (keep === "ollama" && parent === ".ollama") continue;
-    const full = join3(projectRoot, parent);
+    const full = join(projectRoot, parent);
     if (!await pathExists(full)) continue;
     try {
       const { readdir } = await import("fs/promises");
@@ -624,7 +237,7 @@ async function installAgentIntegration(opts) {
   const force = opts.force ?? false;
   await removeOtherAgentHosts(root, opts.target);
   const write = async (rel, content) => {
-    const full = join3(root, rel);
+    const full = join(root, rel);
     if (await pathExists(full) && !force) {
       skipped.push(rel);
       return;
@@ -632,7 +245,7 @@ async function installAgentIntegration(opts) {
     await writeText(full, content);
     created.push(rel);
   };
-  await write(join3(".sdd", "protocol.md"), PROTOCOL_MD);
+  await write(join(".sdd", "protocol.md"), PROTOCOL_MD);
   await refreshActiveAgentContext(root);
   const roles = integ.rolesToInstall?.length ? SDD_AGENT_ROLES.filter((r) => integ.rolesToInstall.includes(r.id)) : SDD_AGENT_ROLES;
   for (const role of roles) {
@@ -640,7 +253,7 @@ async function installAgentIntegration(opts) {
   }
   await write("AGENTS.md", renderAgentsMd(integ));
   await write(
-    join3(".sdd", "agents.json"),
+    join(".sdd", "agents.json"),
     JSON.stringify(
       {
         version: 3,
@@ -708,7 +321,7 @@ Do not claim the change is complete without local verification when the workflow
 `;
 }
 async function loadInstalledAgent(projectRoot) {
-  const path = join3(sddRoot(projectRoot), "agents.json");
+  const path = join(sddRoot(projectRoot), "agents.json");
   if (!await pathExists(path)) return null;
   try {
     const raw = JSON.parse(await readText(path));
@@ -723,7 +336,7 @@ async function loadInstalledAgent(projectRoot) {
 async function writeAgentHandoff(projectRoot, config, changeId) {
   const ctx = await buildContext(projectRoot, config, changeId);
   const body = await buildAgentPrompt(ctx, config, projectRoot);
-  const outPath = join3(sddRoot(projectRoot), "handoff.md");
+  const outPath = join(sddRoot(projectRoot), "handoff.md");
   const header = `# SDD handoff (auto)
 
 > Generated for the AI coding agent configured at init.  
@@ -760,16 +373,16 @@ function agentKickoffMessage(opts) {
 }
 async function refreshActiveAgentContext(projectRoot) {
   const markerDir = sddRoot(projectRoot);
-  if (!await pathExists(join3(markerDir, "config.yaml"))) {
+  if (!await pathExists(join(markerDir, "config.yaml"))) {
     return null;
   }
-  const protocolPath = join3(markerDir, "protocol.md");
+  const protocolPath = join(markerDir, "protocol.md");
   if (!await pathExists(protocolPath)) {
     await writeText(protocolPath, PROTOCOL_MD);
   }
   const config = await loadConfig(projectRoot);
   const activeId = await getActiveChangeId(projectRoot, config);
-  const outPath = join3(markerDir, "active-context.md");
+  const outPath = join(markerDir, "active-context.md");
   if (!activeId) {
     const empty = `# SDD active context
 
@@ -892,32 +505,6 @@ Refresh context: \`sdd agents refresh\`.
 }
 
 export {
-  listWorkflowNames,
-  loadWorkflow,
-  resolveStages,
-  isStageSkipped,
-  shouldAutoSkip,
-  activeStages,
-  getStage,
-  nextStageId,
-  firstActiveStageId,
-  inferComplexity,
-  recommendWorkflow,
-  slugify,
-  todayIsoDate,
-  nowIso,
-  changeDirName,
-  uniqueChangeDirName,
-  loadChangeMeta,
-  saveChangeMeta,
-  buildContext,
-  listChanges,
-  getActiveChangeId,
-  clearActiveIf,
-  setActiveChange,
-  resolveChangeId,
-  formatStatus,
-  buildAgentPrompt,
   AGENT_INTEGRATIONS,
   ALL_AGENT_TARGETS,
   DEFAULT_INIT_INTEGRATION,