vibe-coding-master 0.7.43 → 0.7.44

package/README.md

@@ -190,6 +190,12 @@ restart, but it does not infer transitions or choose the next role. Current
 artifacts, Gate Review state, Round/Turn state, and the role rules remain
 authoritative.
 
+Whenever Project Manager asks the user a question, it first uses
+`vcm-ask-user`. VCM records the wait and cancels any pending role dispatch in
+one state update. Stop Hook then ends the PM turn without route scanning. Only
+a new direct user message clears the wait, and the next role dispatch requires
+a fresh Workflow Review.
+
 Typical flow:
 
 ```text
@@ -329,7 +335,8 @@ strict `workflow-progress.md` transition through `vcm-workflow-review`. VCM
 checks the confirmed dispatch history and current task artifacts, then grants
 one matching route. The target role's `UserPromptSubmit` consumes that approval
 and appends the confirmed transition. A rejected transition can be bypassed
-only by an exact one-time user authorization recorded through the VCM dialog.
+only by the user's exact one-time authorization recorded in the next Workflow
+Progress submission.
 
 If the flow stops, VCM always shows a blocking pause alert. `Pause alert sound`
 only controls the looping sound. Enabling Gateway turns that preference off once;
@@ -479,7 +486,10 @@ including CCR launches. The project environment must still
 provide the language server for each detected language: `rust-analyzer`,
 `typescript-language-server`, `pyright-langserver`, `gopls`, `clangd`, or
 `jdtls`. Architect preloads `vcm-code-navigation` and uses LSP for semantic
-relationships; other roles use generated context and ordinary source reads.
+relationships. Accessors, backing fields, trait items, implementations, wrappers,
+and aliases are queried as separate symbols; a bounded source-text fallback may
+only locate candidates after the correct LSP query is demonstrably partial.
+Other roles use generated context and ordinary source reads.
 Harness Studio reports
 whether the server executable and plugin can run; the role Session performs the
 real workspace indexing and semantic query retries. VCM uses Claude Code progress
@@ -498,10 +508,11 @@ files.
 `Auto memory` is the switch for the entire automated memory workflow. During
 Review Task Harness after Final Acceptance, Project Manager, Architect, Coder,
 Tester, and an enabled Reviewer submit proposals in sequence through
-`vcm-propose-memory`. Harness Engineer verifies and consolidates them before VCM
-records the result as part of the same Task Harness Retrospective. Workflow roles
-cannot edit active memory directly; Harness Engineer edits it only during the
-assigned Auto Memory Retrospective.
+`vcm-propose-memory`. Harness Engineer verifies and consolidates them, commits
+the reviewed memory, and writes the assigned machine-readable review result as
+part of the same Task Harness Retrospective. Workflow roles cannot edit active
+memory directly; Harness Engineer edits it only during the assigned Auto Memory
+Retrospective.
 
 When Auto Memory is enabled, the planning Architect writes a provisional memory
 candidate before its post-planning Session restart. VCM snapshots that candidate
@@ -528,7 +539,10 @@ Final Acceptance
        -> Review pending Harness Feedback
        -> Review Auto Memory proposals, when Auto Memory is enabled
        -> Harness Engineer updates and commits memory, when Auto Memory is enabled
-  -> VCM records the committed memory result
+       -> Harness Engineer writes review-result.json, when Auto Memory is enabled
+  -> VCM validates and records the committed memory result
+  -> VCM dispatches durable-document assignments one at a time
+  -> Complete Task Harness Retrospective after every assignment completes
 ```
 
 Memory proposal prompts sent to Project Manager, Architect, Coder, Tester, and
@@ -542,16 +556,29 @@ impact, and durable-document disposition, then evaluates every proposal item
 independently. Each Add or Update decision records why the memory is necessary,
 what happens if it is absent, whether it belongs in memory or a durable
 document, and the exact final memory content when retained. VCM validates that
-the commit changes only assigned memory host files and only their
-`<VCM-memory>` blocks; it does not parse or apply Harness Engineer's semantic
-decisions. Harness Engineer review and retrospective work remain tool role
-activity and do not participate in Round completion.
+every existing entry and proposal has one structurally valid decision, every
+move decision has one durable-document assignment, moved content has already
+been removed from memory, and the commit changes only assigned memory host
+files and only their `<VCM-memory>` blocks. VCM does not decide whether the
+Harness Engineer's semantic judgment is correct. Harness Engineer review and
+retrospective work remain tool role activity and do not participate in Round
+completion.
+
+For `move-to-durable-doc`, memory is removed in the Harness Engineer commit
+before documentation work starts. VCM assigns architecture and known-issues
+documents to Architect and testing documentation to Tester. For another target,
+PM selects Architect, Coder, or Tester and asks the user only when ownership
+cannot be determined. These assignments are backend-dispatched work rather than
+a Docs-Only Flow. Each owner updates and commits the document, submits the exact
+assignment ID in `docs-update-report.md`, and finishes before the next assignment
+starts. Harness Studio shows assignment status and allows failed work to be
+retried.
 
 When Auto Memory is disabled, Review Task Harness does not collect proposals or
 ask Harness Engineer to update memory. When enabled, both automatic and manual
 review requests collect proposals before starting the retrospective. A failed
-proposal collection or combined retrospective memory review must be retried
-from Harness Studio.
+proposal collection, combined retrospective memory review, or durable-document
+assignment must be retried from Harness Studio.
 
 ## Closing a Task
 

package/dist/backend/api/artifact-routes.js

@@ -144,6 +144,9 @@ function artifactNameToPath(paths, artifactName) {
     if (artifactName === "test-report.md") {
         return paths.testReportPath;
     }
+    if (artifactName === "docs-update-report.md") {
+        return paths.docsUpdateReportPath;
+    }
     if (artifactName === "docs-sync-report.md") {
         return paths.docsSyncReportPath;
     }

package/dist/backend/api/harness-routes.js

@@ -208,6 +208,22 @@ export function registerHarnessRoutes(app, deps) {
         const { project, task } = await requireHarnessTaskContext(deps, request.body?.taskSlug);
         return deps.autoMemoryService.retryFailedReview(project.repoRoot, task.worktreePath);
     });
+    app.post("/api/projects/harness/memory/assignments/retry", async (request) => {
+        const { project, task } = await requireHarnessTaskContext(deps, request.body?.taskSlug);
+        return deps.autoMemoryService.retryDurableDocAssignment(project.repoRoot, task.worktreePath, request.body?.assignmentId ?? "");
+    });
+    app.post("/api/projects/harness/memory/assignments/owner", async (request) => {
+        const { project, task } = await requireHarnessTaskContext(deps, request.body?.taskSlug);
+        const owner = request.body?.owner;
+        if (owner !== "architect" && owner !== "coder" && owner !== "tester") {
+            throw new VcmError({
+                code: "DURABLE_DOC_OWNER_INVALID",
+                message: "Durable-document owner must be architect, coder, or tester.",
+                statusCode: 400
+            });
+        }
+        return deps.autoMemoryService.resolveDurableDocAssignmentOwner(project.repoRoot, task.worktreePath, request.body?.assignmentId ?? "", owner);
+    });
 }
 async function persistHarnessEngineerDefaults(appSettings, session) {
     const defaults = createDefaultToolSessionDefaults()["harness-engineer"];

package/dist/backend/api/task-routes.js

@@ -235,6 +235,7 @@ function degradedArtifactSummary(handoffDir) {
             architectDebugPath: `${handoffDir}/architect-debug.md`,
             architectureDiagnosisPath: `${handoffDir}/architecture-diagnosis.md`,
             testReportPath: `${handoffDir}/test-report.md`,
+            docsUpdateReportPath: `${handoffDir}/docs-update-report.md`,
             docsSyncReportPath: `${handoffDir}/docs-sync-report.md`,
             workflowProgressPath: `${handoffDir}/workflow-progress.md`,
             finalAcceptancePath: `${handoffDir}/final-acceptance.md`

package/dist/backend/api/workflow-control-routes.js

@@ -5,6 +5,18 @@ export function registerWorkflowControlRoutes(app, deps) {
         const context = await getContext(deps, request.params.taskSlug);
         return deps.workflowControlService.getState(context);
     });
+    app.post("/api/tasks/:taskSlug/ask-user", async (request) => {
+        const context = await getContext(deps, request.params.taskSlug);
+        const question = typeof request.body?.question === "string" ? request.body.question.trim() : "";
+        if (!question) {
+            throw new VcmError({
+                code: "WORKFLOW_USER_QUESTION_REQUIRED",
+                message: "A non-empty user question is required.",
+                statusCode: 400
+            });
+        }
+        return deps.workflowControlService.requestUserInput(context, question);
+    });
 }
 async function getContext(deps, taskSlug) {
     const project = await deps.projectService.getCurrentProject();

package/dist/backend/cli/install-vcm-harness.js

@@ -28,10 +28,12 @@ import { renderVcmLongRunningValidationSkillRules } from "../templates/harness/v
 import { renderVcmProposeMemorySkillRules } from "../templates/harness/vcm-propose-memory-skill.js";
 import { renderVcmReportHarnessIssueSkillRules } from "../templates/harness/vcm-report-harness-issue-skill.js";
 import { renderVcmRouteMessageSkillRules } from "../templates/harness/vcm-route-message-skill.js";
+import { renderAskUserTool, renderVcmAskUserSkillRules } from "../templates/harness/vcm-ask-user-skill.js";
 import { renderUpdateTaskStateTool, renderVcmTaskStateSkillRules } from "../templates/harness/vcm-task-state-skill.js";
 import { renderVcmWorkflowReviewSkillRules } from "../templates/harness/vcm-workflow-review-skill.js";
 import { renderCheckScaffoldLedgerTool } from "../templates/harness/check-scaffold-ledger.js";
 import { renderRequestArchitectRestartTool, renderRestartArchitectSkillRules } from "../templates/harness/restart-architect-skill.js";
+import { renderResolveDurableDocAssignmentTool } from "../templates/harness/resolve-durable-doc-assignment.js";
 import { readVcmPackageVersion } from "../app-version.js";
 const CLI_DIR = path.dirname(fileURLToPath(import.meta.url));
 const APP_ROOT = path.resolve(CLI_DIR, "../../..");
@@ -318,6 +320,12 @@ const WHOLE_FILES = [
         mode: 0o644,
         content: renderSkillFile("VCM Route Message Skill", "vcm-route-message", "Use when project-manager dispatches a VCM role or when a VCM role reports a question, result, blocker, or finding back to project-manager.", renderVcmRouteMessageSkillRules())
     },
+    {
+        path: ".claude/skills/vcm-ask-user/SKILL.md",
+        category: "skill",
+        mode: 0o644,
+        content: renderSkillFile("VCM Ask User Skill", "vcm-ask-user", "Use whenever project-manager asks the user a question and must pause the workflow.", renderVcmAskUserSkillRules())
+    },
     {
         path: ".claude/skills/vcm-task-state/SKILL.md",
         category: "skill",
@@ -360,6 +368,12 @@ const WHOLE_FILES = [
         mode: 0o755,
         content: renderRequestGateReviewTool()
     },
+    {
+        path: ".ai/tools/vcm-ask-user",
+        category: "runtime-tool",
+        mode: 0o755,
+        content: renderAskUserTool()
+    },
     {
         path: ".ai/tools/update-task-state",
         category: "runtime-tool",
@@ -378,6 +392,12 @@ const WHOLE_FILES = [
         mode: 0o755,
         content: renderRequestArchitectRestartTool()
     },
+    {
+        path: ".ai/tools/resolve-durable-doc-assignment",
+        category: "runtime-tool",
+        mode: 0o755,
+        content: renderResolveDurableDocAssignmentTool()
+    },
     {
         path: ".ai/tools/run-long-check",
         category: "runtime-tool",
@@ -642,6 +662,7 @@ function fixedDirectories() {
         ".claude/skills/vcm-harness-bootstrap/",
         ".claude/skills/vcm-long-running-validation/",
         ".claude/skills/vcm-route-message/",
+        ".claude/skills/vcm-ask-user/",
         ".claude/skills/vcm-task-state/",
         ".claude/skills/vcm-workflow-review/",
         ".claude/skills/vcm-gate-review/",

package/dist/backend/server.js

@@ -332,6 +332,7 @@ export function createDefaultServerDeps(options = {}) {
         appSettings,
         sessionService,
         roundService,
+        workflowControlService,
         onArchitecturePlanDisposition: ({ repoRoot, taskSlug, accepted }) => architectRestartService.recordArchitectureGateDisposition(repoRoot, taskSlug, accepted)
     });
     const translationWorkerService = createTranslationWorkerService({
@@ -416,7 +417,8 @@ export function createDefaultServerDeps(options = {}) {
         jobGuard: createJobGuardService(),
         translationWorkerService,
         architectRestartService,
-        roleStallDetector
+        roleStallDetector,
+        workflowControlService
     });
     const runtimeCoordinator = createRuntimeCoordinatorService({
         appSettings,

package/dist/backend/services/artifact-service.js

@@ -4,7 +4,7 @@ import { checkMarkdownArtifact } from "../../shared/validation/artifact-check.js
 import { getArtifactDefinition, isArtifactKind } from "../../shared/validation/artifact-registry.js";
 import { VcmError } from "../errors.js";
 import { resolveRepoPath } from "../adapters/filesystem.js";
-import { renderArchitectureBriefTemplate, renderArchitectureDiagnosisTemplate, renderArchitectureEvidenceTemplate, renderArchitecturePlanTemplate, renderArchitectDebugTemplate, renderCoderCompletionTemplate, renderDocsSyncReportTemplate, renderFinalAcceptanceTemplate, renderKnownIssuesTemplate, renderPlanningProgressTemplate, renderMessageRouteTemplate, renderTestReportTemplate, renderWorkflowProgressTemplate } from "../templates/handoff.js";
+import { renderArchitectureBriefTemplate, renderArchitectureDiagnosisTemplate, renderArchitectureEvidenceTemplate, renderArchitecturePlanTemplate, renderArchitectDebugTemplate, renderCoderCompletionTemplate, renderDocsUpdateReportTemplate, renderDocsSyncReportTemplate, renderFinalAcceptanceTemplate, renderKnownIssuesTemplate, renderPlanningProgressTemplate, renderMessageRouteTemplate, renderTestReportTemplate, renderWorkflowProgressTemplate } from "../templates/handoff.js";
 import { renderRoleCommandTemplate } from "../templates/role-command.js";
 import { validateMemoryProposal } from "./memory-proposal-validation.js";
 import { isMemoryProposalSubmissionPath } from "./memory-review-paths.js";
@@ -18,6 +18,7 @@ const ARTIFACT_PATH_KEYS = [
     ["architect-debug", "architectDebugPath"],
     ["architecture-diagnosis", "architectureDiagnosisPath"],
     ["test-report", "testReportPath"],
+    ["docs-update-report", "docsUpdateReportPath"],
     ["docs-sync-report", "docsSyncReportPath"],
     ["workflow-progress", "workflowProgressPath"],
     ["final-acceptance", "finalAcceptancePath"]
@@ -55,6 +56,7 @@ export function createArtifactService(fs, deps = {}) {
                 architectDebugPath: path.posix.join(handoffDir, "architect-debug.md"),
                 architectureDiagnosisPath: path.posix.join(handoffDir, "architecture-diagnosis.md"),
                 testReportPath: path.posix.join(handoffDir, "test-report.md"),
+                docsUpdateReportPath: path.posix.join(handoffDir, "docs-update-report.md"),
                 docsSyncReportPath: path.posix.join(handoffDir, "docs-sync-report.md"),
                 workflowProgressPath: path.posix.join(handoffDir, "workflow-progress.md"),
                 finalAcceptancePath: path.posix.join(handoffDir, "final-acceptance.md")
@@ -85,6 +87,7 @@ export function createArtifactService(fs, deps = {}) {
                 [paths.architectDebugPath, renderArchitectDebugTemplate(input.taskSlug)],
                 [paths.architectureDiagnosisPath, renderArchitectureDiagnosisTemplate(input.taskSlug)],
                 [paths.testReportPath, renderTestReportTemplate(input.taskSlug)],
+                [paths.docsUpdateReportPath, renderDocsUpdateReportTemplate(input.taskSlug)],
                 [paths.docsSyncReportPath, renderDocsSyncReportTemplate(input.taskSlug)],
                 [paths.workflowProgressPath, renderWorkflowProgressTemplate(input.taskSlug)],
                 [paths.finalAcceptancePath, renderFinalAcceptanceTemplate(input.taskSlug)],
@@ -190,10 +193,11 @@ export function createArtifactService(fs, deps = {}) {
             }
             if (isArtifactKind(input.kind)) {
                 const definition = getArtifactDefinition(input.kind);
-                if (definition.owner !== input.role) {
+                const owners = Array.isArray(definition.owner) ? definition.owner : [definition.owner];
+                if (!owners.includes(input.role)) {
                     throw new VcmError({
                         code: "ARTIFACT_OWNER_MISMATCH",
-                        message: `${input.kind} is owned by ${definition.owner}, not ${input.role}.`,
+                        message: `${input.kind} is owned by ${owners.join("|")}, not ${input.role}.`,
                         statusCode: 403
                     });
                 }
@@ -334,39 +338,12 @@ async function validateDynamicArtifact(fs, input, content, workflowControlServic
         validateHarnessFeedback(content);
         return { kind: input.kind, root: input.baseRepoRoot, path: artifactPath };
     }
-    if (input.kind === "retrospective-report") {
-        if (input.role !== "harness-engineer") {
-            throw artifactRejected(input.kind, ["Only Harness Engineer may submit a retrospective report."]);
-        }
-        if (!/^\.ai\/vcm\/harness-feedback\/task-retrospectives\/[A-Za-z0-9._-]+\.md$/.test(artifactPath)) {
-            throw artifactRejected(input.kind, ["Retrospective report path must be under .ai/vcm/harness-feedback/task-retrospectives/."]);
-        }
-        validateRetrospectiveReport(content);
-        return { kind: input.kind, root: input.baseRepoRoot, path: artifactPath };
-    }
     throw new VcmError({
         code: "ARTIFACT_KIND_INVALID",
         message: `Unknown managed artifact kind: ${input.kind}`,
         statusCode: 400
     });
 }
-function validateRetrospectiveReport(content) {
-    const errors = getRetrospectiveReportErrors(content);
-    if (errors.length > 0)
-        throw artifactRejected("retrospective-report", errors);
-}
-export function getRetrospectiveReportErrors(content) {
-    const errors = [];
-    if (!/^# Task Harness Retrospective(?::\s*.+)?\s*$/m.test(content)) {
-        errors.push("Retrospective report requires '# Task Harness Retrospective: <task>'.");
-    }
-    for (const heading of ["Findings", "Feedback Dispositions", "Recommended Harness Changes", "VCM Issue Drafts"]) {
-        if (!new RegExp(`^## ${escapeRegExp(heading)}\\s*$`, "m").test(content)) {
-            errors.push(`Missing required section: ${heading}.`);
-        }
-    }
-    return errors;
-}
 function validateCoderWorkerReport(content) {
     const errors = [];
     if (!/^# Coder Worker Report:\s*\S.+$/m.test(content)) {