@structured-vibe-coding/core 0.18.0 → 0.19.0

package/dist/{chunk-4PIRWYRA.js → chunk-26YG6A4M.js}

@@ -1,13 +1,17 @@
 import {
   buildAgentPrompt,
+  canonicalRoleName,
   defaultConfig,
   formatStatus,
-  loadConfig
-} from "./chunk-44LQ5BKZ.js";
+  loadConfig,
+  readRole,
+  readTeamConfig
+} from "./chunk-TGRV6WGS.js";
 import {
   buildContext,
+  defaultMemoryDir,
   getActiveChangeId
-} from "./chunk-QHV5KZKX.js";
+} from "./chunk-HG7TPW5V.js";
 import {
   SddError
 } from "./chunk-MHODNFIL.js";
@@ -26,7 +30,7 @@ import {
 // src/agents.ts
 import { constants } from "fs";
 import { access, lstat as lstat2, readdir, rmdir, unlink } from "fs/promises";
-import { dirname as dirname2, join as join4 } from "pathe";
+import { dirname, join as join4 } from "pathe";
 
 // src/generated.ts
 import { createHash } from "crypto";
@@ -152,12 +156,17 @@ async function reconcileGeneratedTree(projectRoot, sourceDir, destinationDir, de
       kept.push({ path: projectRelative, reason: "unreadable" });
       continue;
     }
-    const previousHash = manifest.files[projectRelative];
+    const currentHash = contentHash(current);
+    let previousHash = manifest.files[projectRelative];
     if (!previousHash) {
-      kept.push({ path: projectRelative, reason: "not-generated" });
-      continue;
+      if (currentHash !== generatedHash) {
+        kept.push({ path: projectRelative, reason: "not-generated" });
+        continue;
+      }
+      manifest.files[projectRelative] = generatedHash;
+      previousHash = generatedHash;
     }
-    if (contentHash(current) !== previousHash) {
+    if (currentHash !== previousHash) {
       kept.push({ path: projectRelative, reason: "edited" });
       continue;
     }
@@ -184,47 +193,7 @@ function describeKept(k) {
 }
 
 // src/guidance.ts
-import { join as join3 } from "pathe";
-
-// src/defaults.ts
-import { existsSync } from "fs";
-import { fileURLToPath } from "url";
-import { dirname, join as join2 } from "pathe";
-function defaultsRoot() {
-  const here = dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    join2(here, "..", "defaults"),
-    // npm package: dist/../defaults
-    join2(here, "defaults"),
-    // same-dir defaults if present
-    join2(here, "..", "..", "defaults")
-    // src/ during some test runners
-  ];
-  for (const c of candidates) {
-    if (existsSync(c)) return c;
-  }
-  return candidates[0];
-}
-function defaultWorkflowsDir() {
-  return join2(defaultsRoot(), "workflows");
-}
-function defaultTemplatesDir() {
-  return join2(defaultsRoot(), "templates");
-}
-function defaultMemoryDir() {
-  return join2(defaultsRoot(), "memory");
-}
-function defaultMcpYamlPath() {
-  return join2(defaultsRoot(), "mcp.yaml");
-}
-function defaultPricesYamlPath() {
-  return join2(defaultsRoot(), "prices.yaml");
-}
-function defaultSearchYamlPath() {
-  return join2(defaultsRoot(), "search.yaml");
-}
-
-// src/guidance.ts
+import { join as join2 } from "pathe";
 function renderSddReadme(config) {
   const paths = guidancePaths(config);
   return `# Structured Vibe Coding (SDD)
@@ -302,14 +271,14 @@ async function refreshConfiguredGuidance(projectRoot, config) {
   await writeConfiguredReadme(projectRoot, config);
 }
 async function writeConfiguredMemoryIndex(memoryRoot, config) {
-  const indexPath = join3(memoryRoot, "index.md");
+  const indexPath = join2(memoryRoot, "index.md");
   const paths = guidancePaths(config);
   if (paths.memory === "memory" && paths.changes === "changes") return;
   if (!await pathExists(indexPath)) return;
   const existing = await readText(indexPath);
   const state = generatedState(existing);
   if (state === "edited") return;
-  const shippedPath = join3(defaultMemoryDir(), "index.md");
+  const shippedPath = join2(defaultMemoryDir(), "index.md");
   const shipped = await pathExists(shippedPath) ? await readText(shippedPath) : "";
   if (state !== "unmodified" && existing.replace(/\r\n/g, "\n").trim() !== shipped.trim()) return;
   const body = renderMemoryIndex(config);
@@ -317,7 +286,7 @@ async function writeConfiguredMemoryIndex(memoryRoot, config) {
   await writeText(indexPath, markGenerated(body));
 }
 async function writeConfiguredReadme(projectRoot, config) {
-  const readmePath = join3(sddRoot(projectRoot), "README.md");
+  const readmePath = join2(sddRoot(projectRoot), "README.md");
   if (!await pathExists(readmePath)) return;
   const existing = await readText(readmePath);
   if (generatedState(existing) !== "unmodified") return;
@@ -327,6 +296,95 @@ async function writeConfiguredReadme(projectRoot, config) {
   await writeText(readmePath, marked);
 }
 
+// src/role/entrypoint-team.ts
+import { homedir } from "os";
+import { join as join3 } from "pathe";
+function productTeamHome() {
+  const fromEnv = process.env.SDD_HOME?.trim();
+  if (fromEnv) return fromEnv;
+  return homedir();
+}
+function oneLine(value) {
+  const text = value.replace(/\s+/g, " ").replaceAll("|", "/").trim();
+  return text || "not named";
+}
+function toMember(role, name, order, source) {
+  return {
+    order,
+    name,
+    job: oneLine(role?.job ?? ""),
+    accepts: role && role.approvers.length > 0 ? oneLine(role.approvers.join(", ")) : "not named",
+    file: source === "repo" ? `.sdd/roles/${name}.md` : `~/.sdd/roles/${name}.md`,
+    source
+  };
+}
+async function listedRoles(root) {
+  const dir = join3(root, ".sdd", "roles");
+  if (!await pathExists(dir)) return [];
+  const listed = [];
+  for (const file of await listFiles(dir)) {
+    if (!file.endsWith(".md")) continue;
+    const name = file.slice(0, -".md".length);
+    if (canonicalRoleName(name) !== name) continue;
+    listed.push({ name, role: await readRole(root, name) });
+  }
+  return listed;
+}
+function byName(listed) {
+  return listed.filter((item) => !item.role?.hidden).map((item) => item.name).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+}
+async function membersFrom(root, source) {
+  const listed = await listedRoles(root);
+  const teamFile = await pathExists(join3(root, ".sdd", "team.yaml"));
+  if (!teamFile && listed.length === 0) return null;
+  const known = new Map(listed.map((item) => [item.name, item.role]));
+  let names;
+  if (teamFile) {
+    const loaded = await readTeamConfig(root);
+    if ("team" in loaded) {
+      const seen = /* @__PURE__ */ new Set();
+      names = [];
+      for (const bot of loaded.team.bots) {
+        if (seen.has(bot.role)) continue;
+        seen.add(bot.role);
+        names.push(bot.role);
+      }
+    } else {
+      names = byName(listed);
+    }
+  } else {
+    names = byName(listed);
+  }
+  return names.map((name, index) => toMember(known.get(name) ?? null, name, index + 1, source));
+}
+async function loadProductTeam(projectRoot) {
+  const repo = await membersFrom(projectRoot, "repo");
+  if (repo) return repo;
+  const user = await membersFrom(productTeamHome(), "user");
+  return user ?? [];
+}
+function renderProductTeamSection(members) {
+  if (members.length === 0) return "";
+  const lines = [
+    "## Product team",
+    "",
+    "Run these product roles in order. The stage hat (planner, implementer, reviewer) is how the host behaves inside one role's turn. It does not replace this team. Do not ask the human to repeat this roster.",
+    ""
+  ];
+  if (members[0]?.source === "user") {
+    lines.push(
+      "Source: user default (`~/.sdd`). It applies only because this repo has no product team.",
+      ""
+    );
+  }
+  for (const member of members) {
+    lines.push(
+      `${member.order}. \`${member.name}\` \u2014 ${member.job}. Accepts: ${member.accepts}. File: \`${member.file}\``
+    );
+  }
+  return lines.join("\n");
+}
+
 // src/agents.ts
 var AGENT_INTEGRATIONS = [
   {
@@ -546,7 +604,7 @@ async function planOtherHostRemoval(projectRoot, keep) {
 async function removalProblems(projectRoot, plan) {
   const problems = [];
   for (const rel of plan.remove) {
-    const dir = dirname2(rel);
+    const dir = dirname(rel);
     if (!await canAccess(join4(projectRoot, dir), constants.W_OK)) {
       problems.push(
         `Cannot remove ${rel} (another host's sdd file): ${dir}/ is not writable (permission denied). Make it writable or delete the file yourself.`
@@ -565,12 +623,12 @@ async function executeRemoval(projectRoot, plan) {
       throw new SddError(describeFsError(err, "remove", rel), { cause: err });
     }
     removed.push(rel);
-    let dir = dirname2(rel);
+    let dir = dirname(rel);
     while (dir !== "." && dir !== "") {
       const top = !dir.includes("/");
       if (top && !PRUNABLE_PARENTS.includes(dir)) break;
       ancestors.add(dir);
-      dir = dirname2(dir);
+      dir = dirname(dir);
     }
   }
   const dirs = [...ancestors].sort((a, b) => b.split("/").length - a.split("/").length);
@@ -633,11 +691,13 @@ var SDD_AGENT_ROLES = [
   {
     id: "sdd",
     description: "Default SDD agent. Use for any Spec-Driven Development work on the active change pack.",
-    roleLine: "Router: inspect stage in active-context; plan or implement accordingly.",
+    roleLine: "Router: send the stage to the role that owns it, one item at a time.",
     roleRules: [
-      "If stage is intent/feature/design/tasks/stories/research: act as planner (artifacts, little or no product code).",
-      "If stage is implement: act as implementer (scoped code only).",
-      "If stage is local_verify: act as reviewer (gaps vs acceptance; fixes only).",
+      "Owns: which role works this stage.",
+      "Never: accept a spec or record a decision.",
+      "Checks: the stage matches the work.",
+      "Ask when: the stage is missing or a hard gate is blocked.",
+      "Route with sdd role route. Rules in .sdd/routing.yaml win, then a role owns list. One item at a time. No owner asks the human.",
       "If kickoff/brief says refine or analyze: follow <changes_path>/<id>/refine-brief.md \u2014 stage-scoped refine; never edit constitution; do not sdd next."
     ]
   },
@@ -646,6 +706,10 @@ var SDD_AGENT_ROLES = [
     description: "SDD planner. Use when filling intent, design, research, stories, or tasks \u2014 not large code changes.",
     roleLine: "Planner: produce/update stage markdown only.",
     roleRules: [
+      "Owns: stage markdown, not product code.",
+      "Never: accept a spec.",
+      "Checks: the artifact says what changes and how to tell.",
+      "Ask when: the scope is missing.",
       "Do not make large product code changes unless the user explicitly overrides.",
       "Keep artifacts short and actionable."
     ]
@@ -655,6 +719,10 @@ var SDD_AGENT_ROLES = [
     description: "SDD implementer. Use when coding the active change (implement stage).",
     roleLine: "Implementer: code only for the active change pack.",
     roleRules: [
+      "Owns: code for this change pack.",
+      "Never: accept a spec or widen the change.",
+      "Checks: the diff matches the tasks and acceptance.",
+      "Ask when: a task or a design constraint is missing.",
       "Follow tasks.md / acceptance; honor arb-decision and design constraints.",
       "Do not expand scope beyond the change title/intent."
     ]
@@ -664,20 +732,24 @@ var SDD_AGENT_ROLES = [
     description: "SDD reviewer. Use before verify/complete or to check work against the change pack.",
     roleLine: "Reviewer: compare work to acceptance and stage artifacts.",
     roleRules: [
+      "Owns: the gap list.",
+      "Never: accept a spec or treat a claim as evidence.",
+      "Checks: the change matches acceptance.",
+      "Ask when: acceptance does not say how to tell it worked.",
       "List gaps; suggest minimal fixes only.",
       "Remind user to run sdd verify before sdd complete."
     ]
   }
 ];
-function agentFiles(integ, config) {
+function agentFiles(integ, config, team = []) {
   const roles = integ.rolesToInstall?.length ? SDD_AGENT_ROLES.filter((r) => integ.rolesToInstall.includes(r.id)) : SDD_AGENT_ROLES;
   return [
-    { rel: join4(".sdd", "protocol.md"), content: renderProtocolMd(config) },
+    { rel: join4(".sdd", "protocol.md"), content: renderProtocolMd(config, team) },
     ...roles.map((role) => ({
       rel: integ.rolePath(role.id),
-      content: renderThinAgent(role, config)
+      content: renderThinAgent(role, config, team)
     })),
-    { rel: "AGENTS.md", content: renderAgentsMd(integ, config) }
+    { rel: "AGENTS.md", content: renderAgentsMd(integ, config, team) }
   ];
 }
 async function planAgentIntegration(opts) {
@@ -687,7 +759,8 @@ async function planAgentIntegration(opts) {
   const problems = [];
   const writes = [];
   const config = await pathExists(configPath(root)) ? await loadConfig(root) : defaultConfig();
-  for (const { rel, content } of agentFiles(integ, config)) {
+  const team = await loadProductTeam(root);
+  for (const { rel, content } of agentFiles(integ, config, team)) {
     const full = join4(root, rel);
     if (!rel.startsWith(".sdd/")) {
       const link = await symlinkOnPath(root, rel);
@@ -698,8 +771,8 @@ async function planAgentIntegration(opts) {
     }
     const kind = await pathKind(full);
     if (kind === "missing") {
-      let anc = dirname2(rel);
-      while (anc !== "." && await pathKind(join4(root, anc)) === "missing") anc = dirname2(anc);
+      let anc = dirname(rel);
+      while (anc !== "." && await pathKind(join4(root, anc)) === "missing") anc = dirname(anc);
       const ancFull = anc === "." ? root : join4(root, anc);
       const ancKind = await pathKind(ancFull);
       if (ancKind !== "dir" && ancKind !== "symlink") {
@@ -834,9 +907,12 @@ async function installAgentIntegrations(opts) {
   }
   return { created, skipped, targets: opts.targets };
 }
-function renderThinAgent(role, config) {
+function renderThinAgent(role, config, team = []) {
   const paths = guidancePaths(config ?? { memory_path: "memory", changes_path: "changes" });
   const rules = role.roleRules.map((r) => `- ${r.replaceAll("<changes_path>", paths.changes)}`).join("\n");
+  const productTeam = team.length > 0 ? `
+${renderProductTeamSection(team)}
+` : "";
   return `---
 name: ${role.id}
 description: ${role.description}
@@ -856,7 +932,7 @@ ${role.roleLine}
 ## Role rules
 
 ${rules}
-
+${productTeam}
 ## Done
 
 Remind the human: \`sdd verify\` then \`sdd next\` / \`sdd complete\` as appropriate.
@@ -879,6 +955,7 @@ async function loadInstalledAgent(projectRoot) {
 async function writeAgentHandoff(projectRoot, config, changeId, budget, runtime) {
   const ctx = await buildContext(projectRoot, config, changeId);
   const body = await buildAgentPrompt(ctx, config, projectRoot, budget, runtime);
+  const team = renderProductTeamSection(await loadProductTeam(projectRoot));
   const outPath = join4(sddRoot(projectRoot), "handoff.md");
   const header = `# SDD handoff (auto)
 
@@ -890,7 +967,10 @@ Also read: \`.sdd/active-context.md\`, \`.sdd/protocol.md\`, \`${guidancePaths(c
 ---
 
 `;
-  await writeText(outPath, header + body + "\n");
+  const teamBlock = team ? `
+${team}
+` : "";
+  await writeText(outPath, header + teamBlock + body + "\n");
   return outPath;
 }
 function agentKickoffMessage(opts) {
@@ -920,7 +1000,8 @@ function agentKickoffMessage(opts) {
 }
 async function refreshGeneratedAgentFiles(projectRoot, config) {
   const installed = await loadInstalledAgent(projectRoot);
-  const files = installed ? agentFiles(installed.integration, config) : [{ rel: join4(".sdd", "protocol.md"), content: renderProtocolMd(config) }];
+  const team = await loadProductTeam(projectRoot);
+  const files = installed ? agentFiles(installed.integration, config, team) : [{ rel: join4(".sdd", "protocol.md"), content: renderProtocolMd(config, team) }];
   for (const { rel, content } of files) {
     const full = join4(projectRoot, rel);
     if (!await pathExists(full)) {
@@ -945,6 +1026,10 @@ async function refreshActiveAgentContext(projectRoot) {
   await refreshGeneratedAgentFiles(projectRoot, config);
   const activeId = await getActiveChangeId(projectRoot, config);
   const outPath = join4(markerDir, "active-context.md");
+  const team = renderProductTeamSection(await loadProductTeam(projectRoot));
+  const teamBlock = team ? `
+${team}
+` : "";
   if (!activeId) {
     const empty = `# SDD active context
 
@@ -953,7 +1038,7 @@ _No active change._ Run \`sdd new "\u2026"\` or **SDD: New Change** in the IDE.
 Then re-run \`sdd agents refresh\` (or advance a stage) to update this file.
 
 Protocol: \`.sdd/protocol.md\`
-`;
+${teamBlock}`;
     await writeText(outPath, empty);
     return outPath;
   }
@@ -971,16 +1056,17 @@ Protocol: \`.sdd/protocol.md\`
 \`\`\`
 ${status}
 \`\`\`
-
+${teamBlock}
 ${handoff}
 `;
   await writeText(outPath, body);
   return outPath;
 }
 var PROTOCOL_MD = renderProtocolMd({ memory_path: "memory", changes_path: "changes" });
-function renderProtocolMd(config) {
+function renderProtocolMd(config, team = []) {
   const paths = guidancePaths(config);
   const fence = "```";
+  const teamLines = team.length > 0 ? ["", ...renderProductTeamSection(team).split("\n")] : [];
   return [
     "# SDD protocol",
     "",
@@ -1003,6 +1089,7 @@ function renderProtocolMd(config) {
     `3. \`${paths.constitution}\` if present (non-negotiables agents must not violate)`,
     "4. `meta.yaml` + artifacts for the **current stage** (and prior stages if needed)",
     `5. \`${paths.memoryIndex}\` (documentation map) if present, then linked memory pages when architecture or conventions matter`,
+    ...teamLines,
     "",
     "## Stage behavior",
     "",
@@ -1051,8 +1138,9 @@ function renderProtocolMd(config) {
     ""
   ].join("\n");
 }
-function renderAgentsMd(integ, config) {
+function renderAgentsMd(integ, config, team = []) {
   const paths = guidancePaths(config ?? { memory_path: "memory", changes_path: "changes" });
+  const teamLines = team.length > 0 ? ["", ...renderProductTeamSection(team).split("\n")] : [];
   return [
     "# Agents",
     "",
@@ -1067,6 +1155,7 @@ function renderAgentsMd(integ, config) {
     `| Constitution | \`${paths.constitution}\` if present |`,
     `| Doc map (stable) | \`${paths.memoryIndex}\` if present |`,
     `| Active change | \`${paths.changes}/<id>/\` |`,
+    ...teamLines,
     "",
     "| AI agent | Files |",
     "|----------|--------|",
@@ -1085,16 +1174,12 @@ export {
   saveGeneratedManifest,
   reconcileGeneratedTree,
   describeKept,
-  defaultsRoot,
-  defaultWorkflowsDir,
-  defaultTemplatesDir,
-  defaultMemoryDir,
-  defaultMcpYamlPath,
-  defaultPricesYamlPath,
-  defaultSearchYamlPath,
   renderSddReadme,
   renderMemoryIndex,
   refreshConfiguredGuidance,
+  productTeamHome,
+  loadProductTeam,
+  renderProductTeamSection,
   AGENT_INTEGRATIONS,
   ALL_AGENT_TARGETS,
   DEFAULT_INIT_INTEGRATION,