vibe-coding-master 0.0.17 → 0.2.1

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

@@ -1,10 +1,26 @@
+import { randomUUID } from "node:crypto";
+import { execFile } from "node:child_process";
 import path from "node:path";
+import { promisify } from "node:util";
 import { renderArchitectHarnessRules } from "../templates/harness/architect-agent.js";
 import { renderCoderHarnessRules } from "../templates/harness/coder-agent.js";
 import { renderRootClaudeHarnessRules } from "../templates/harness/claude-root.js";
 import { renderGitignoreHarnessRules } from "../templates/harness/gitignore.js";
+import { renderKnownIssuesDocHarnessRules } from "../templates/harness/known-issues-doc.js";
 import { renderProjectManagerHarnessRules } from "../templates/harness/project-manager-agent.js";
+import { renderPullRequestTemplateHarnessRules } from "../templates/harness/pull-request-template.js";
 import { renderReviewerHarnessRules } from "../templates/harness/reviewer-agent.js";
+import { renderVcmFinalAcceptanceSkillRules } from "../templates/harness/vcm-final-acceptance-skill.js";
+import { renderVcmHarnessBootstrapSkillRules } from "../templates/harness/vcm-harness-bootstrap-skill.js";
+import { renderVcmLongRunningValidationSkillRules } from "../templates/harness/vcm-long-running-validation-skill.js";
+import { renderVcmRouteMessageSkillRules } from "../templates/harness/vcm-route-message-skill.js";
+import { submitTerminalInput } from "../runtime/terminal-submit.js";
+import { VcmError } from "../errors.js";
+const execFileAsync = promisify(execFile);
+const BOOTSTRAP_TASK_SLUG = "__vcm-harness-bootstrap__";
+const BOOTSTRAP_RUNTIME_ROLE = "project-manager";
+const BOOTSTRAP_LOG_PATH = ".ai/vcm/bootstrap/bootstrap.log";
+const BOOTSTRAP_SESSION_PATH = ".ai/vcm/bootstrap/session.json";
 export const VCM_HARNESS_VERSION = 1;
 const MANAGED_BLOCK_PATTERN = /<!-- VCM:BEGIN(?:\s+version=(\d+))? -->[\s\S]*?<!-- VCM:END -->/m;
 const HASH_MANAGED_BLOCK_PATTERN = /# VCM:BEGIN(?:\s+version=(\d+))?\n[\s\S]*?# VCM:END/m;
@@ -25,6 +41,50 @@ const HARNESS_FILES = [
         commentStyle: "hash",
         renderRules: renderGitignoreHarnessRules
     },
+    {
+        kind: "docs-known-issues",
+        path: "docs/known-issues.md",
+        title: "Known Issues",
+        renderRules: renderKnownIssuesDocHarnessRules
+    },
+    {
+        kind: "pull-request-template",
+        path: ".github/pull_request_template.md",
+        title: "Pull Request Template",
+        renderRules: renderPullRequestTemplateHarnessRules
+    },
+    {
+        kind: "skill-vcm-route-message",
+        path: ".claude/skills/vcm-route-message/SKILL.md",
+        title: "VCM Route Message Skill",
+        frontmatter: renderSkillFrontmatter("vcm-route-message", "Use when a VCM role needs to hand off work, ask a question, report a result, report a blocker, or raise a finding to another VCM role."),
+        ownership: "whole-file",
+        renderRules: renderVcmRouteMessageSkillRules
+    },
+    {
+        kind: "skill-vcm-final-acceptance",
+        path: ".claude/skills/vcm-final-acceptance/SKILL.md",
+        title: "VCM Final Acceptance Skill",
+        frontmatter: renderSkillFrontmatter("vcm-final-acceptance", "Use when project-manager is ready to decide whether a VCM-managed task can be accepted, returned for follow-up, or blocked for a decision."),
+        ownership: "whole-file",
+        renderRules: renderVcmFinalAcceptanceSkillRules
+    },
+    {
+        kind: "skill-vcm-harness-bootstrap",
+        path: ".claude/skills/vcm-harness-bootstrap/SKILL.md",
+        title: "VCM Harness Bootstrap Skill",
+        frontmatter: renderSkillFrontmatter("vcm-harness-bootstrap", "Use when VCM needs AI-assisted project understanding to finish or refresh project-specific harness content."),
+        ownership: "whole-file",
+        renderRules: renderVcmHarnessBootstrapSkillRules
+    },
+    {
+        kind: "skill-vcm-long-running-validation",
+        path: ".claude/skills/vcm-long-running-validation/SKILL.md",
+        title: "VCM Long-Running Validation Skill",
+        frontmatter: renderSkillFrontmatter("vcm-long-running-validation", "Use for builds, browser checks, E2E tests, release suites, or any validation command that may take long enough for shell-completion callbacks to become unreliable."),
+        ownership: "whole-file",
+        renderRules: renderVcmLongRunningValidationSkillRules
+    },
     {
         kind: "agent-project-manager",
         path: ".claude/agents/project-manager.md",
@@ -36,14 +96,14 @@ const HARNESS_FILES = [
         kind: "agent-architect",
         path: ".claude/agents/architect.md",
         title: "Architect Agent",
-        frontmatter: renderAgentFrontmatter("architect", "VCM architecture role for plans, module boundaries, public contracts, test contracts, and post-review docs sync."),
+        frontmatter: renderAgentFrontmatter("architect", "VCM architecture role for plans, module boundaries, public contracts, verifiable behavior, and docs sync."),
         renderRules: renderArchitectHarnessRules
     },
     {
         kind: "agent-coder",
         path: ".claude/agents/coder.md",
         title: "Coder Agent",
-        frontmatter: renderAgentFrontmatter("coder", "VCM implementation role for scoped code changes, focused tests, implementation logs, and validation evidence."),
+        frontmatter: renderAgentFrontmatter("coder", "VCM implementation role for scoped code changes and focused tests."),
         renderRules: renderCoderHarnessRules
     },
     {
@@ -55,12 +115,16 @@ const HARNESS_FILES = [
     }
 ];
 export function createHarnessService(deps) {
+    const now = deps.now ?? (() => new Date().toISOString());
     return {
         async getHarnessStatus(repoRoot) {
             const analyses = await analyzeHarnessFiles(deps.fs, repoRoot);
             return renderHarnessStatus(analyses);
         },
         async applyHarness(repoRoot) {
+            if (deps.runFixedInstaller) {
+                return deps.runFixedInstaller(repoRoot);
+            }
             const analyses = await analyzeHarnessFiles(deps.fs, repoRoot);
             const changedFiles = [];
             for (const analysis of analyses) {
@@ -79,6 +143,78 @@ export function createHarnessService(deps) {
                     ? "VCM Harness is already up to date."
                     : "VCM Harness updated. Review these files and commit the harness changes before starting long-running work."
             };
+        },
+        async getBootstrapStatus(repoRoot) {
+            return getHarnessBootstrapStatus(deps, repoRoot, now);
+        },
+        async startHarnessBootstrap(repoRoot, input = {}) {
+            if (!deps.runtime || !deps.projectService) {
+                throw new VcmError({
+                    code: "HARNESS_BOOTSTRAP_UNAVAILABLE",
+                    message: "Harness bootstrap sessions are not available in this VCM runtime.",
+                    statusCode: 501
+                });
+            }
+            const currentStatus = await getHarnessBootstrapStatus(deps, repoRoot, now);
+            if (currentStatus.session?.status === "running") {
+                return {
+                    status: currentStatus,
+                    session: currentStatus.session,
+                    prompt: buildHarnessBootstrapPrompt(repoRoot)
+                };
+            }
+            if (!currentStatus.canStart) {
+                throw new VcmError({
+                    code: "HARNESS_BOOTSTRAP_NOT_READY",
+                    message: "Install the fixed VCM harness before running harness bootstrap.",
+                    statusCode: 409
+                });
+            }
+            const config = await deps.projectService.loadConfig(repoRoot);
+            const claudeSessionId = randomUUID();
+            const command = buildClaudeStartCommand(config.claudeCommand, "default", claudeSessionId);
+            const logPath = path.join(repoRoot, BOOTSTRAP_LOG_PATH);
+            const runtimeSession = await deps.runtime.createSession({
+                taskSlug: BOOTSTRAP_TASK_SLUG,
+                role: BOOTSTRAP_RUNTIME_ROLE,
+                command: command.command,
+                args: command.args,
+                cwd: repoRoot,
+                env: {
+                    VCM_API_URL: deps.apiUrl,
+                    VCM_TASK_REPO_ROOT: repoRoot,
+                    VCM_HARNESS_BOOTSTRAP: "1",
+                    VCM_SESSION_ID: claudeSessionId
+                },
+                cols: input.cols,
+                rows: input.rows,
+                logPath
+            });
+            const timestamp = now();
+            const session = {
+                id: runtimeSession.id,
+                claudeSessionId,
+                status: runtimeSession.status === "crashed" ? "crashed" : runtimeSession.status === "exited" ? "exited" : "running",
+                command: command.display,
+                cwd: repoRoot,
+                logPath: BOOTSTRAP_LOG_PATH,
+                startedAt: runtimeSession.startedAt,
+                updatedAt: timestamp,
+                lastOutputAt: runtimeSession.lastOutputAt,
+                exitCode: runtimeSession.exitCode
+            };
+            await persistHarnessBootstrapSession(deps.fs, repoRoot, session);
+            const prompt = buildHarnessBootstrapPrompt(repoRoot);
+            await submitTerminalInput(deps.runtime, runtimeSession.id, prompt);
+            const nextStatus = await getHarnessBootstrapStatus(deps, repoRoot, now);
+            return {
+                status: {
+                    ...nextStatus,
+                    session
+                },
+                session,
+                prompt
+            };
         }
     };
 }
@@ -92,8 +228,15 @@ async function analyzeHarnessFiles(fs, repoRoot) {
 }
 async function analyzeHarnessFile(fs, repoRoot, definition) {
     const absolutePath = resolveHarnessPath(repoRoot, definition.path);
-    const expectedBlock = renderManagedBlock(definition, definition.renderRules());
-    const managedBlockPattern = getManagedBlockPattern(definition);
+    const expectedContent = definition.ownership === "whole-file"
+        ? renderWholeHarnessFile(definition)
+        : undefined;
+    const expectedBlock = definition.ownership === "whole-file"
+        ? undefined
+        : renderManagedBlock(definition, definition.renderRules());
+    const managedBlockPattern = definition.ownership === "whole-file"
+        ? undefined
+        : getManagedBlockPattern(definition);
     const exists = await fs.pathExists(absolutePath);
     if (!exists) {
         return {
@@ -110,10 +253,34 @@ async function analyzeHarnessFile(fs, repoRoot, definition) {
                 action: "create",
                 reason: "File is missing; VCM will create a recommended default."
             },
-            nextContent: renderNewHarnessFile(definition, expectedBlock)
+            nextContent: expectedContent ?? renderNewHarnessFile(definition, expectedBlock ?? "")
         };
     }
     const currentContent = await fs.readText(absolutePath);
+    if (expectedContent !== undefined) {
+        const action = currentContent === expectedContent ? "ok" : "update";
+        return {
+            definition,
+            status: {
+                kind: definition.kind,
+                path: definition.path,
+                exists: true,
+                hasManagedBlock: false,
+                action
+            },
+            plannedChange: action === "ok"
+                ? undefined
+                : {
+                    path: definition.path,
+                    action,
+                    reason: "VCM whole-file content differs from the recommended baseline."
+                },
+            nextContent: action === "ok" ? undefined : expectedContent
+        };
+    }
+    if (!expectedBlock || !managedBlockPattern) {
+        throw new Error(`Invalid harness definition: ${definition.path}`);
+    }
     const match = currentContent.match(managedBlockPattern);
     if (!match) {
         return {
@@ -192,6 +359,9 @@ function renderNewHarnessFile(definition, block) {
         : "";
     return `${frontmatter}# ${definition.title}\n\n${block}\n`;
 }
+function renderWholeHarnessFile(definition) {
+    return ensureTrailingNewline(renderNewHarnessFile(definition, definition.renderRules().trimEnd()));
+}
 async function analyzeClaudeSettingsFile(fs, repoRoot) {
     const definition = {
         kind: "claude-settings",
@@ -303,6 +473,417 @@ function isPlainObject(value) {
 function renderAgentFrontmatter(name, description) {
     return `---\nname: ${name}\ndescription: ${description}\ntools: Read, Grep, Glob, Bash, Edit, Write\n---`;
 }
+function renderSkillFrontmatter(name, description) {
+    return `---\nname: ${name}\ndescription: ${description}\n---`;
+}
 function resolveHarnessPath(repoRoot, relativePath) {
     return path.join(repoRoot, relativePath);
 }
+function ensureTrailingNewline(content) {
+    return content.endsWith("\n") ? content : `${content}\n`;
+}
+async function getHarnessBootstrapStatus(deps, repoRoot, now) {
+    const moduleIndex = await readOptionalJsonObject(deps.fs, repoRoot, ".ai/generated/module-index.json");
+    const checks = [
+        await checkFixedHarness(deps.fs, repoRoot),
+        await checkProjectContext(deps.fs, repoRoot),
+        checkGeneratedJson(moduleIndex, ".ai/generated/module-index.json", "module-index", "Module index"),
+        checkGeneratedJson(await readOptionalJsonObject(deps.fs, repoRoot, ".ai/generated/public-surface.json"), ".ai/generated/public-surface.json", "public-surface", "Public surface"),
+        await checkFilledMarkdown(deps.fs, repoRoot, "docs/ARCHITECTURE.md", "Project architecture", "project-architecture"),
+        await checkModuleArchitectureDocs(deps.fs, repoRoot, moduleIndex),
+        await checkFilledMarkdown(deps.fs, repoRoot, "docs/TESTING.md", "Testing doc", "testing-doc")
+    ];
+    const session = await getCurrentHarnessBootstrapSession(deps, repoRoot, now);
+    const fixedHarnessReady = checks[0]?.status === "ok";
+    const projectChecks = checks.slice(1);
+    const projectComplete = projectChecks.every((check) => check.status === "ok");
+    const projectStarted = projectChecks.some((check) => check.status === "ok" || check.status === "incomplete");
+    const status = !fixedHarnessReady
+        ? "not_ready"
+        : session?.status === "running"
+            ? "running"
+            : projectComplete
+                ? "complete"
+                : projectStarted
+                    ? "incomplete"
+                    : "not_started";
+    return {
+        status,
+        canStart: fixedHarnessReady && session?.status !== "running",
+        checks,
+        session,
+        warnings: bootstrapWarnings(status, checks, session)
+    };
+}
+async function checkFixedHarness(fs, repoRoot) {
+    const requiredPaths = [
+        "CLAUDE.md",
+        ".ai/vcm-harness-manifest.json",
+        ".claude/skills/vcm-harness-bootstrap/SKILL.md",
+        ".ai/tools/generate-module-index",
+        ".ai/tools/generate-public-surface"
+    ];
+    const missing = [];
+    for (const relativePath of requiredPaths) {
+        if (!await fs.pathExists(resolveHarnessPath(repoRoot, relativePath))) {
+            missing.push(relativePath);
+        }
+    }
+    if (missing.length > 0) {
+        return {
+            key: "fixed-harness",
+            label: "Fixed harness",
+            status: "missing",
+            detail: `Missing ${missing.length}: ${missing.join(", ")}`
+        };
+    }
+    const rootClaude = await readOptionalText(fs, repoRoot, "CLAUDE.md");
+    if (!rootClaude?.includes("<!-- VCM:BEGIN")) {
+        return {
+            key: "fixed-harness",
+            label: "Fixed harness",
+            status: "incomplete",
+            path: "CLAUDE.md",
+            detail: "CLAUDE.md is missing the VCM managed block."
+        };
+    }
+    return {
+        key: "fixed-harness",
+        label: "Fixed harness",
+        status: "ok",
+        detail: "Fixed VCM files are installed."
+    };
+}
+async function checkProjectContext(fs, repoRoot) {
+    const content = await readOptionalText(fs, repoRoot, "CLAUDE.md");
+    if (!content) {
+        return {
+            key: "project-context",
+            label: "Project context",
+            status: "missing",
+            path: "CLAUDE.md"
+        };
+    }
+    const projectOwnedContent = content.split("<!-- VCM:BEGIN")[0]?.trim() ?? "";
+    if (!projectOwnedContent) {
+        return {
+            key: "project-context",
+            label: "Project context",
+            status: "missing",
+            path: "CLAUDE.md",
+            detail: "No project-specific content above the VCM managed block."
+        };
+    }
+    if (!/^## Project Context\b/m.test(projectOwnedContent)) {
+        return {
+            key: "project-context",
+            label: "Project context",
+            status: "incomplete",
+            path: "CLAUDE.md",
+            detail: "Add a Project Context section above the VCM managed block."
+        };
+    }
+    return {
+        key: "project-context",
+        label: "Project context",
+        status: isFilledMarkdown(projectOwnedContent) ? "ok" : "incomplete",
+        path: "CLAUDE.md"
+    };
+}
+function checkGeneratedJson(payload, relativePath, kind, label) {
+    const key = kind === "module-index" ? "module-index" : "public-surface";
+    if (!payload) {
+        return {
+            key,
+            label,
+            status: "missing",
+            path: relativePath
+        };
+    }
+    if (payload.kind !== kind) {
+        return {
+            key,
+            label,
+            status: "incomplete",
+            path: relativePath,
+            detail: `Expected kind "${kind}".`
+        };
+    }
+    if (typeof payload.generatedBy !== "string" || !payload.generatedBy) {
+        return {
+            key,
+            label,
+            status: "incomplete",
+            path: relativePath,
+            detail: "Missing generatedBy."
+        };
+    }
+    return {
+        key,
+        label,
+        status: "ok",
+        path: relativePath
+    };
+}
+async function checkFilledMarkdown(fs, repoRoot, relativePath, label, key) {
+    const content = await readOptionalText(fs, repoRoot, relativePath);
+    if (!content) {
+        return {
+            key,
+            label,
+            status: "missing",
+            path: relativePath
+        };
+    }
+    return {
+        key,
+        label,
+        status: isFilledMarkdown(content) ? "ok" : "incomplete",
+        path: relativePath,
+        detail: isFilledMarkdown(content) ? undefined : "Only a blank or very short template was found."
+    };
+}
+async function checkModuleArchitectureDocs(fs, repoRoot, moduleIndex) {
+    if (!moduleIndex) {
+        return {
+            key: "module-architecture",
+            label: "Module architecture docs",
+            status: "unknown",
+            detail: "Run module-index generation first."
+        };
+    }
+    const moduleDocs = getModuleArchitectureDocPaths(moduleIndex);
+    if (moduleDocs.length === 0) {
+        return {
+            key: "module-architecture",
+            label: "Module architecture docs",
+            status: "unknown",
+            detail: "module-index.json does not list module architecture docs."
+        };
+    }
+    let missing = 0;
+    let incomplete = 0;
+    for (const relativePath of moduleDocs) {
+        const content = await readOptionalText(fs, repoRoot, relativePath);
+        if (!content) {
+            missing += 1;
+        }
+        else if (!isFilledMarkdown(content)) {
+            incomplete += 1;
+        }
+    }
+    if (missing === 0 && incomplete === 0) {
+        return {
+            key: "module-architecture",
+            label: "Module architecture docs",
+            status: "ok",
+            detail: `${moduleDocs.length} module docs found.`
+        };
+    }
+    return {
+        key: "module-architecture",
+        label: "Module architecture docs",
+        status: "incomplete",
+        detail: `${missing} missing, ${incomplete} incomplete, ${moduleDocs.length} expected.`
+    };
+}
+function getModuleArchitectureDocPaths(moduleIndex) {
+    const layers = Array.isArray(moduleIndex.layers) ? moduleIndex.layers : [];
+    const paths = new Set();
+    for (const layer of layers) {
+        if (!isPlainObject(layer) || !Array.isArray(layer.modules)) {
+            continue;
+        }
+        for (const moduleEntry of layer.modules) {
+            if (!isPlainObject(moduleEntry)) {
+                continue;
+            }
+            const architectureDoc = moduleEntry.architectureDoc;
+            if (typeof architectureDoc === "string" && architectureDoc.trim()) {
+                paths.add(architectureDoc);
+            }
+        }
+    }
+    return [...paths].sort();
+}
+function isFilledMarkdown(content) {
+    const meaningfulLines = content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith("#"));
+    return meaningfulLines.join("\n").length >= 120;
+}
+async function getCurrentHarnessBootstrapSession(deps, repoRoot, now) {
+    const persisted = await loadPersistedHarnessBootstrapSession(deps.fs, repoRoot);
+    const runtimeSession = deps.runtime
+        ?.listSessions(BOOTSTRAP_TASK_SLUG)
+        .find((session) => session.id === persisted?.id || session.status === "running");
+    if (runtimeSession) {
+        const session = {
+            id: runtimeSession.id,
+            claudeSessionId: persisted?.claudeSessionId ?? runtimeSession.id,
+            status: runtimeSession.status === "crashed" ? "crashed" : runtimeSession.status === "exited" ? "exited" : "running",
+            command: persisted?.command ?? "claude",
+            cwd: persisted?.cwd ?? repoRoot,
+            logPath: persisted?.logPath ?? BOOTSTRAP_LOG_PATH,
+            startedAt: runtimeSession.startedAt,
+            updatedAt: now(),
+            lastOutputAt: runtimeSession.lastOutputAt,
+            exitCode: runtimeSession.exitCode
+        };
+        await persistHarnessBootstrapSession(deps.fs, repoRoot, session);
+        return session;
+    }
+    if (persisted?.status === "running") {
+        return {
+            ...persisted,
+            status: "resumable",
+            updatedAt: now()
+        };
+    }
+    return undefined;
+}
+async function loadPersistedHarnessBootstrapSession(fs, repoRoot) {
+    const payload = await readOptionalJsonObject(fs, repoRoot, BOOTSTRAP_SESSION_PATH);
+    if (!payload) {
+        return undefined;
+    }
+    if (typeof payload.id !== "string" ||
+        typeof payload.claudeSessionId !== "string" ||
+        typeof payload.command !== "string" ||
+        typeof payload.cwd !== "string" ||
+        typeof payload.logPath !== "string" ||
+        typeof payload.updatedAt !== "string") {
+        return undefined;
+    }
+    const status = payload.status;
+    if (status !== "running" && status !== "exited" && status !== "crashed" && status !== "resumable") {
+        return undefined;
+    }
+    return {
+        id: payload.id,
+        claudeSessionId: payload.claudeSessionId,
+        status,
+        command: payload.command,
+        cwd: payload.cwd,
+        logPath: payload.logPath,
+        startedAt: typeof payload.startedAt === "string" ? payload.startedAt : undefined,
+        updatedAt: payload.updatedAt,
+        lastOutputAt: typeof payload.lastOutputAt === "string" ? payload.lastOutputAt : undefined,
+        exitCode: typeof payload.exitCode === "number" || payload.exitCode === null ? payload.exitCode : undefined
+    };
+}
+async function persistHarnessBootstrapSession(fs, repoRoot, session) {
+    await fs.writeJsonAtomic(resolveHarnessPath(repoRoot, BOOTSTRAP_SESSION_PATH), session);
+}
+async function readOptionalText(fs, repoRoot, relativePath) {
+    const absolutePath = resolveHarnessPath(repoRoot, relativePath);
+    try {
+        return await fs.readText(absolutePath);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function readOptionalJsonObject(fs, repoRoot, relativePath) {
+    const content = await readOptionalText(fs, repoRoot, relativePath);
+    if (!content?.trim()) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(content);
+        return isPlainObject(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function bootstrapWarnings(status, checks, session) {
+    const warnings = [];
+    if (status === "not_ready") {
+        warnings.push("Install or update the fixed VCM harness before running harness bootstrap.");
+    }
+    if (session?.status === "resumable") {
+        warnings.push("The previous bootstrap terminal is no longer active; start bootstrap again or finish the remaining files manually.");
+    }
+    const unknownChecks = checks.filter((check) => check.status === "unknown");
+    if (unknownChecks.length > 0) {
+        warnings.push(`Some bootstrap checks are waiting on generated context: ${unknownChecks.map((check) => check.label).join(", ")}.`);
+    }
+    return warnings;
+}
+function buildClaudeStartCommand(command = "claude", permissionMode = "default", claudeSessionId) {
+    const args = ["--session-id", claudeSessionId];
+    if (permissionMode === "bypassPermissions") {
+        args.push("--permission-mode", "bypassPermissions");
+    }
+    else if (permissionMode === "dangerously-skip-permissions") {
+        args.push("--dangerously-skip-permissions");
+    }
+    return {
+        command,
+        args,
+        display: `${command} ${args.join(" ")}`
+    };
+}
+function buildHarnessBootstrapPrompt(repoRoot) {
+    return `Use the vcm-harness-bootstrap skill to finish the VCM harness bootstrap for this repository.
+
+Repository root:
+${repoRoot}
+
+Required work:
+- Run .ai/tools/generate-module-index when available.
+- Run .ai/tools/generate-public-surface after module-index.json exists.
+- Add or update project-specific Project Context and Project Constraints in CLAUDE.md above the VCM managed block.
+- Fill docs/ARCHITECTURE.md with project-level module overview, responsibilities, relationships, dependency direction, project-wide constraints, and links to module-level architecture docs.
+- Create or update module-level ARCHITECTURE.md files for clear module boundaries listed by module-index.json.
+- Fill docs/TESTING.md with project-native validation levels, commands, test layout, generated-context freshness checks, and known testing gaps.
+
+Boundaries:
+- Do not edit product source, product tests, package manifests, lockfiles, deployment config, secrets, or VCM managed blocks.
+- Preserve user-authored content.
+- Do not create new validation wrapper tools.
+
+Final response:
+Summarize files reviewed, files updated, generated artifacts, verified claims, inferred claims, unknowns, confirmation-needed items, and suggested validation commands.`;
+}
+export function createScriptFixedHarnessInstaller(scriptPath = path.resolve(process.cwd(), "scripts/install-vcm-harness.mjs")) {
+    return async (repoRoot) => {
+        try {
+            const { stdout, stderr } = await execFileAsync(process.execPath, [scriptPath, repoRoot], {
+                cwd: process.cwd(),
+                maxBuffer: 10 * 1024 * 1024
+            });
+            const output = `${String(stdout).trim()}${String(stderr).trim() ? `\n${String(stderr).trim()}` : ""}`.trim();
+            return {
+                version: VCM_HARNESS_VERSION,
+                changedFiles: parseFixedInstallerChanges(String(stdout)),
+                message: output || "VCM fixed harness install completed."
+            };
+        }
+        catch (caught) {
+            const error = caught;
+            const details = [error.message, String(error.stdout ?? "").trim(), String(error.stderr ?? "").trim()]
+                .filter(Boolean)
+                .join("\n");
+            throw new VcmError({
+                code: "HARNESS_INSTALL_FAILED",
+                message: "VCM fixed harness install failed.",
+                statusCode: 500,
+                hint: details || undefined
+            });
+        }
+    };
+}
+function parseFixedInstallerChanges(output) {
+    return output
+        .split(/\r?\n/)
+        .map((line) => line.match(/^DONE\s+(.+?)\s+-\s+(.+)$/))
+        .filter((match) => Boolean(match))
+        .map((match) => ({
+        path: match[1],
+        action: match[2].includes("create") || match[2].includes("created") ? "create" : "update",
+        reason: match[2]
+    }));
+}

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

@@ -30,7 +30,7 @@ export function createProjectService(deps) {
             }
             const config = await this.loadConfig(repoRoot);
             await deps.fs.ensureDir(path.join(repoRoot, config.handoffRoot));
-            await deps.fs.ensureDir(path.join(repoRoot, config.stateRoot, "tasks"));
+            await deps.fs.ensureDir(path.join(this.getProjectDataRoot(repoRoot), "tasks"));
             await deps.fs.ensureDir(path.join(repoRoot, ".claude", "worktrees"));
             await this.saveConfig(config, true);
             const warnings = [];
@@ -87,6 +87,9 @@ export function createProjectService(deps) {
         },
         getConfigPath(repoRoot) {
             return deps.appSettings.getProjectConfigPath(repoRoot);
+        },
+        getProjectDataRoot(repoRoot) {
+            return path.dirname(deps.appSettings.getProjectConfigPath(repoRoot));
         }
     };
 }