@structured-vibe-coding/core 0.19.0 → 0.21.0

package/defaults/teams/software/routing.yaml

@@ -1,28 +1,4 @@
 rules:
-  - id: requirements
-    stage: requirements
-    role: product-manager
-  - id: architecture
-    stage: architecture
-    role: architect
-  - id: stories
-    stage: stories
-    role: product-owner
-  - id: plan
-    stage: plan
-    role: dev-lead
-  - id: tasks
-    stage: tasks
-    role: dev-lead
-  - id: implement
-    stage: implement
-    role: developer
-  - id: pr-review
-    stage: pr_review
-    role: architect
-  - id: acceptance
-    stage: acceptance
-    role: product-owner
   - id: lead
     skill: name the next owner
     role: dev-lead

package/defaults/templates/qa-testing.md

@@ -0,0 +1,11 @@
+# QA testing
+
+> **{{title}}** · `{{id}}`
+
+## Tried
+
+-
+
+## Not tried
+
+-

package/defaults/templates/signoff.md

@@ -0,0 +1,7 @@
+# Sign-off
+
+> **{{title}}** · `{{id}}`
+
+## Ask
+
+-

package/defaults/workflows/team-software.yaml

@@ -1,7 +1,8 @@
 name: team-software
 description: >
-  Software team — requirements, architecture, stories, plan, tasks,
-  implement, pull-request review, acceptance
+  Software team sign-off — requirements, clarifications, high-level design,
+  low-level design, plan, test plan, development, pull-request review,
+  QA testing, QA sign-off, product-owner review, and product-owner sign-off
 version: 1
 recommendation:
   priority: 10
@@ -14,7 +15,7 @@ stages:
     kind: standard
     skippable: false
     owner: product-manager
-    collaborates: [architect]
+    collaborates: [architect, research-assistant]
     artifacts:
       - id: requirements
         path: requirements.md
@@ -25,46 +26,83 @@ stages:
       mode: human_approval
       approvers: [human]
       checklist:
-        - "The person accepted the reading"
+        - "The person signed the reading"
     agent_context:
       instructions: |
         Write the short reading in requirements.md. Do not accept the spec.
-        The person signs this gate.
+        The person signs this stage.
 
-  - id: architecture
-    title: Architecture
-    summary: Module boundaries for this change
+  - id: clarifications
+    title: Clarifications
+    summary: Questions the reading still needs answered
+    kind: standard
+    skippable: false
+    owner: product-manager
+    collaborates: [research-assistant]
+    artifacts:
+      - id: clarifications
+        path: clarifications.md
+        template: clarify.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the clarifications"
+    agent_context:
+      instructions: |
+        Write the open questions and the answers the person gave.
+        A role does not sign this stage.
+
+  - id: hld
+    title: High-level design
+    summary: Modules and the seams between them
     kind: standard
     skippable: false
     owner: architect
     collaborates: [product-manager]
     artifacts:
-      - id: architecture
-        path: architecture.md
-        template: greenfield-architecture.md
+      - id: hld
+        path: hld.md
+        template: hl-design.md
         required: true
     gate:
-      type: soft
-      approvers: [architect]
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the high-level design"
+    agent_context:
+      instructions: |
+        Name the modules. Do not accept the spec.
+        The person signs this stage.
 
-  - id: stories
-    title: Stories
-    summary: One story file the product owner can ask about
+  - id: lld
+    title: Low-level design
+    summary: How one module does the change
     kind: standard
     skippable: false
-    owner: product-owner
-    collaborates: [dev-lead]
+    owner: architect
+    collaborates: [developer]
     artifacts:
-      - id: story
-        path: stories/S-001.md
-        template: story.md
+      - id: lld
+        path: lld.md
+        template: lld.md
         required: true
     gate:
-      type: soft
-      approvers: [product-owner]
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the low-level design"
+    agent_context:
+      instructions: |
+        Name the functions and the data for this change.
+        A role does not sign this stage.
 
   - id: plan
-    title: Plan
+    title: Plan approval
     summary: How the work is split
     kind: standard
     skippable: false
@@ -75,39 +113,64 @@ stages:
         path: plan.md
         template: plan.md
         required: true
+      - id: task
+        path: tasks/T-001.md
+        template: task.md
+        required: true
     gate:
-      type: soft
-      approvers: [dev-lead]
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the plan"
+    agent_context:
+      instructions: |
+        Write the order of work and the first task file.
+        A role does not sign this stage.
 
-  - id: tasks
-    title: Tasks
-    summary: One file per task
+  - id: test_plan
+    title: Test plan
+    summary: What QA will try before the change is called done
     kind: standard
     skippable: false
-    owner: dev-lead
+    owner: qa
     collaborates: [developer]
     artifacts:
-      - id: task
-        path: tasks/T-001.md
-        template: task.md
+      - id: test-plan
+        path: test-plan.md
+        template: local-test-plan.md
         required: true
     gate:
-      type: soft
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the test plan"
+    agent_context:
+      instructions: |
+        Write what to try. Do not record a result.
+        The person signs this stage.
 
   - id: implement
-    title: Implement
+    title: Development
     summary: One item for each task file
     kind: standard
     skippable: false
     owner: developer
+    collaborates: [dev-lead]
     items_from: tasks/T-*.md
     artifacts: []
     gate:
-      type: soft
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the development"
     agent_context:
       instructions: |
         When this stage starts, items.yaml has one row per tasks/T-*.md file.
         Build those tasks. Do not accept a spec.
+        The person signs this stage.
 
   - id: pr_review
     title: Pull request review
@@ -122,31 +185,108 @@ stages:
         template: review.md
         required: true
     gate:
-      type: soft
-      approvers: [architect, dev-lead]
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the pull-request review"
+    agent_context:
+      instructions: |
+        Write the review. Do not merge.
+        The person signs this stage.
+
+  - id: qa_testing
+    title: QA testing
+    summary: What QA tried on this commit
+    kind: standard
+    skippable: false
+    owner: qa
+    collaborates: [developer]
+    artifacts:
+      - id: qa-testing
+        path: qa-testing.md
+        template: qa-testing.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the QA testing note"
+    agent_context:
+      instructions: |
+        Write what was tried. Do not record a pass, and do not sign.
+        The person signs this stage.
+
+  - id: qa_signoff
+    title: QA sign-off
+    summary: The person's QA words for this commit
+    kind: standard
+    skippable: false
+    owner: qa
+    collaborates: [product-owner]
+    artifacts:
+      - id: qa-signoff
+        path: qa-signoff.md
+        template: signoff.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed QA for this commit"
+    agent_context:
+      instructions: |
+        Prepare what the person is asked to sign.
+        A role cannot sign. The sign-off stores the person's words and the git SHA.
+
+  - id: po_review
+    title: Product-owner review
+    summary: Whether the change matches the reading
+    kind: standard
+    skippable: false
+    owner: product-owner
+    collaborates: [product-manager]
+    artifacts:
+      - id: po-review
+        path: po-review.md
+        template: review.md
+        required: true
+    gate:
+      type: hard
+      mode: human_approval
+      approvers: [human]
+      checklist:
+        - "The person signed the product-owner review"
+    agent_context:
+      instructions: |
+        Write whether the change matches the reading. Do not accept it.
+        The person signs this stage.
 
-  - id: acceptance
-    title: Acceptance
-    summary: The person tries the change and keeps the final say
+  - id: po_signoff
+    title: Product-owner sign-off
+    summary: The person's final words for this commit
     kind: standard
     skippable: false
     owner: product-owner
-    collaborates: [product-manager, architect]
+    collaborates: [qa]
     artifacts:
-      - id: acceptance
-        path: acceptance.md
-        template: acceptance.md
+      - id: po-signoff
+        path: po-signoff.md
+        template: signoff.md
         required: true
     gate:
       type: hard
       mode: human_approval
       approvers: [human]
       checklist:
-        - "The person recorded what they saw"
+        - "The person signed off for this commit"
     agent_context:
       instructions: |
-        Write what the person can try. Do not record the QA result.
-        The person signs this gate.
+        Prepare what the person is asked to sign.
+        A role cannot sign. The sign-off stores the person's words and the git SHA.
+        Merge stays a person action after this sign-off.
 
 on_complete:
   archive: false

package/dist/{agents-PSIOQEYH.js → agents-U5RVEZTX.js}

@@ -26,9 +26,9 @@ import {
   renderProtocolMd,
   renderThinAgent,
   writeAgentHandoff
-} from "./chunk-26YG6A4M.js";
-import "./chunk-TGRV6WGS.js";
-import "./chunk-HG7TPW5V.js";
+} from "./chunk-5GLH6ZWU.js";
+import "./chunk-AERAWOAK.js";
+import "./chunk-TNWFMRIA.js";
 import "./chunk-MHODNFIL.js";
 import "./chunk-O5SP6X5R.js";
 export {

package/dist/{change-context-EZJMSGSP.js → change-context-CZT3U7MZ.js}

@@ -7,7 +7,7 @@ import {
   resolveChangeId,
   saveChangeMeta,
   setActiveChange
-} from "./chunk-HG7TPW5V.js";
+} from "./chunk-TNWFMRIA.js";
 import "./chunk-O5SP6X5R.js";
 export {
   buildContext,

package/dist/{chunk-26YG6A4M.js → chunk-5GLH6ZWU.js}

@@ -6,12 +6,12 @@ import {
   loadConfig,
   readRole,
   readTeamConfig
-} from "./chunk-TGRV6WGS.js";
+} from "./chunk-AERAWOAK.js";
 import {
   buildContext,
   defaultMemoryDir,
   getActiveChangeId
-} from "./chunk-HG7TPW5V.js";
+} from "./chunk-TNWFMRIA.js";
 import {
   SddError
 } from "./chunk-MHODNFIL.js";

package/dist/{chunk-TGRV6WGS.js → chunk-AERAWOAK.js}

@@ -4,7 +4,7 @@ import {
   getStage,
   isStageSkipped,
   shouldAutoSkip
-} from "./chunk-HG7TPW5V.js";
+} from "./chunk-TNWFMRIA.js";
 import {
   SddError
 } from "./chunk-MHODNFIL.js";
@@ -110,6 +110,7 @@ async function getHeadSha(projectRoot, runGit = runGitHead) {
 // src/role/types.ts
 function emptyRoleLists() {
   return {
+    stages: [],
     owns: [],
     inputs: [],
     outputs: [],
@@ -2621,6 +2622,9 @@ function canonicalRoleName(input) {
 function roleFilePath(root, name) {
   return join7(root, ".sdd", "roles", `${name}.md`);
 }
+function roleContextDir(root, name) {
+  return join7(root, ".sdd", "role-context", name);
+}
 function conversationDir(root, name) {
   return join7(root, ".sdd", "role-runs", "conversation", name);
 }
@@ -2641,6 +2645,7 @@ function asText(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 var LIST_FIELDS = [
+  ["stages", "stages"],
   ["owns", "owns"],
   ["inputs", "inputs"],
   ["outputs", "outputs"],
@@ -2720,6 +2725,18 @@ ${front}
 ${description}
 `;
 }
+async function rolesListingStage(root, stageId) {
+  const dir = join7(root, ".sdd", "roles");
+  if (!await pathExists(dir)) return [];
+  const names = [];
+  for (const file of (await listFiles(dir)).filter((item) => item.endsWith(".md")).sort()) {
+    const name = file.slice(0, -".md".length);
+    const role = await readRole(root, name);
+    if (!role) return { error: `Role file is invalid: ${name}.` };
+    if (role.stages.includes(stageId)) names.push(role.name);
+  }
+  return names;
+}
 async function readRole(root, name) {
   const canonical = canonicalRoleName(name);
   if (!canonical) return null;
@@ -2766,6 +2783,7 @@ async function editRole(root, nameInput, patch) {
   if (patch.job !== void 0) role.job = patch.job.trim();
   if (patch.description !== void 0) role.description = patch.description.trim();
   if (patch.askFirst !== void 0) role.askFirst = patch.askFirst;
+  if (patch.stages !== void 0) role.stages = patch.stages;
   await writeRole(root, role);
   return ok();
 }
@@ -2828,6 +2846,7 @@ async function deleteRole(root, nameInput) {
   if (!await pathExists(path)) return fail(ROLE_TEXT.notFound);
   await removePath(path);
   await removePath(conversationDir(root, name));
+  await removePath(roleContextDir(root, name));
   await removeBotBrain(root, name);
   await removePath(memoryDir(root, name));
   await removeAllowKey(root, name);
@@ -3303,7 +3322,7 @@ async function buildAgentPrompt(ctx, config, projectRoot, budget, runtime) {
   }
   try {
     const { loadMcpConfig } = await import("./sources-3TXUPU6V.js");
-    const { gatherMcpContextForChange, formatMcpContextForHandoff } = await import("./gather-7TSVKQO2.js");
+    const { gatherMcpContextForChange, formatMcpContextForHandoff } = await import("./gather-A3Q4WSPH.js");
     const mcpCfg = await loadMcpConfig(projectRoot);
     if (mcpCfg.auto_fetch_on_handoff && mcpCfg.sources.length) {
       const fetched = await gatherMcpContextForChange(projectRoot, ctx);
@@ -3406,10 +3425,12 @@ export {
   checkModels,
   canonicalRoleName,
   roleFilePath,
+  roleContextDir,
   conversationDir,
   memoryDir,
   allowFilePath,
   parseRoleDocument,
+  rolesListingStage,
   readRole,
   createRole,
   editRole,

package/dist/{chunk-H55RFAEI.js → chunk-ICRQOQWE.js}

@@ -26,7 +26,7 @@ function toProcessEnv(base, extra) {
 }
 
 // src/version.ts
-var SDD_CORE_VERSION = "0.19.0" ? "0.19.0" : "0.0.0-dev";
+var SDD_CORE_VERSION = "0.21.0" ? "0.21.0" : "0.0.0-dev";
 
 // src/mcp/client.ts
 function mcpTimeoutMs() {

package/dist/{chunk-HG7TPW5V.js → chunk-TNWFMRIA.js}

@@ -181,11 +181,55 @@ var ChangeMetaSchema = z.object({
 
 // src/slug.ts
 var SLUG_MAX = 60;
+function isSpace(ch) {
+  if (ch.length !== 1) return false;
+  const code = ch.charCodeAt(0);
+  return code === 9 || code === 10 || code === 11 || code === 12 || code === 13 || code === 32 || code === 160 || code === 5760 || code >= 8192 && code <= 8202 || code === 8232 || code === 8233 || code === 8239 || code === 8287 || code === 12288 || code === 65279;
+}
+function isDigit(ch) {
+  return ch.length === 1 && ch >= "0" && ch <= "9";
+}
+function isSlugChar(ch) {
+  return ch.length === 1 && (ch >= "a" && ch <= "z" || ch >= "0" && ch <= "9");
+}
 function trailingIssueRef(input) {
-  return input.match(/#\s*(\d+)\s*\)?\s*$/)?.[1];
+  let i = input.length - 1;
+  while (i >= 0 && isSpace(input[i] ?? "")) i -= 1;
+  if (i >= 0 && input[i] === ")") {
+    i -= 1;
+    while (i >= 0 && isSpace(input[i] ?? "")) i -= 1;
+  }
+  const digits = [];
+  while (i >= 0 && isDigit(input[i] ?? "")) {
+    digits.push(input[i] ?? "");
+    i -= 1;
+  }
+  if (digits.length === 0) return void 0;
+  while (i >= 0 && isSpace(input[i] ?? "")) i -= 1;
+  if (input[i] !== "#") return void 0;
+  digits.reverse();
+  return digits.join("");
+}
+function collapse(input) {
+  let out = "";
+  let dash = false;
+  for (const ch of input) {
+    if (ch === "'" || ch === '"') continue;
+    if (isSlugChar(ch)) {
+      out += ch;
+      dash = false;
+      continue;
+    }
+    if (!dash && out.length > 0) {
+      out += "-";
+      dash = true;
+    }
+  }
+  if (out.endsWith("-")) return out.slice(0, -1);
+  return out;
 }
 function slugify(input) {
-  const normalized = input.toLowerCase().trim().replace(/['"]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  const normalized = collapse(input.toLowerCase().trim());
   if (normalized.length <= SLUG_MAX) return normalized;
   const issue = trailingIssueRef(input);
   const tokens = normalized.split("-").filter(Boolean);

package/dist/{chunk-2FJBFYVJ.js → chunk-Z2ULYVHO.js}

@@ -4,7 +4,7 @@ import {
   gitUserName,
   loadConfig,
   readTeamConfig
-} from "./chunk-TGRV6WGS.js";
+} from "./chunk-AERAWOAK.js";
 import {
   ChangeMetaSchema,
   activeStages,
@@ -22,7 +22,7 @@ import {
   setActiveChange,
   shouldAutoSkip,
   uniqueChangeDirName
-} from "./chunk-HG7TPW5V.js";
+} from "./chunk-TNWFMRIA.js";
 import {
   archiveDir,
   changeMetaPath,
@@ -970,7 +970,7 @@ async function createChange(input) {
   await materializeStageArtifacts(projectRoot, config, id, workflow, meta, firstStage);
   await setActiveChange(projectRoot, config, id);
   try {
-    const { refreshActiveAgentContext } = await import("./agents-PSIOQEYH.js");
+    const { refreshActiveAgentContext } = await import("./agents-U5RVEZTX.js");
     await refreshActiveAgentContext(projectRoot);
   } catch {
   }
@@ -1072,7 +1072,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
         stage2
       );
       try {
-        const { refreshActiveAgentContext } = await import("./agents-PSIOQEYH.js");
+        const { refreshActiveAgentContext } = await import("./agents-U5RVEZTX.js");
         await refreshActiveAgentContext(projectRoot);
       } catch {
       }
@@ -1129,7 +1129,7 @@ async function advanceStage(projectRoot, config, changeId, opts) {
     stage
   );
   try {
-    const { refreshActiveAgentContext } = await import("./agents-PSIOQEYH.js");
+    const { refreshActiveAgentContext } = await import("./agents-U5RVEZTX.js");
     await refreshActiveAgentContext(projectRoot);
   } catch {
   }
@@ -1262,7 +1262,7 @@ async function completeChange(projectRoot, config, changeId) {
   let promoted;
   if (ctx.meta.workflow === "greenfield" || ctx.meta.flags?.greenfield === true) {
     try {
-      const { promoteGreenfieldToMemory: promoteGreenfieldToMemory2 } = await import("./greenfield-QFA5WVHE.js");
+      const { promoteGreenfieldToMemory: promoteGreenfieldToMemory2 } = await import("./greenfield-QTMU2MH6.js");
       promoted = await promoteGreenfieldToMemory2(projectRoot, config, changeId);
     } catch {
     }
@@ -1391,7 +1391,7 @@ function parseFeaturesBacklog(markdown, sourcePath) {
 async function findFeaturesBacklogPath(projectRoot, config) {
   const mem = join6(memoryDir(projectRoot, config), "features.md");
   if (await pathExists(mem)) return mem;
-  const { getActiveChangeId: getActiveChangeId2 } = await import("./change-context-EZJMSGSP.js");
+  const { getActiveChangeId: getActiveChangeId2 } = await import("./change-context-CZT3U7MZ.js");
   const active = await getActiveChangeId2(projectRoot, config);
   if (active) {
     const p = join6(changePath(projectRoot, config, active), "features.md");

package/dist/{gather-7TSVKQO2.js → gather-A3Q4WSPH.js}

@@ -3,7 +3,7 @@ import {
   gatherMcpContext,
   gatherMcpContextForChange,
   listMatchingSourceIds
-} from "./chunk-H55RFAEI.js";
+} from "./chunk-ICRQOQWE.js";
 import "./chunk-4BRO7BOJ.js";
 import "./chunk-MHODNFIL.js";
 import "./chunk-O5SP6X5R.js";

package/dist/{greenfield-QFA5WVHE.js → greenfield-QTMU2MH6.js}

@@ -6,9 +6,9 @@ import {
   startFeatureFromBacklog,
   startGreenfield,
   updateFeatureStatus
-} from "./chunk-2FJBFYVJ.js";
-import "./chunk-TGRV6WGS.js";
-import "./chunk-HG7TPW5V.js";
+} from "./chunk-Z2ULYVHO.js";
+import "./chunk-AERAWOAK.js";
+import "./chunk-TNWFMRIA.js";
 import "./chunk-MHODNFIL.js";
 import "./chunk-O5SP6X5R.js";
 export {