vibe-coding-master 0.2.11 → 0.2.13

package/README.md

@@ -50,9 +50,18 @@ From npm:
 
 ```bash
 npm install -g vibe-coding-master
+vcm --version
 vcm
 ```
 
+Useful CLI flags:
+
+```bash
+vcm --help
+vcm --version
+vcm --host=127.0.0.1 --port=4173
+```
+
 From source:
 
 ```bash

package/dist/backend/templates/harness/project-manager-agent.js

@@ -16,6 +16,15 @@ export function renderProjectManagerHarnessRules() {
 - Keep only one active role handoff at a time.
 - Ask the user when user intent, priority, or approval is unclear.
 - Ask the user when architect or reviewer reports a conflict with durable docs that requires user approval.
+- Send bug reports, failing validation, runtime errors, and unclear defects to architect Debug Mode rather than coder or reviewer diagnosis.
+
+### Debug Routing
+
+- Route bugs, failing checks, build/runtime errors, unclear defects, and reviewer failure evidence to architect Debug Mode.
+- Do not diagnose root cause or judge fix size; provide symptom, reproduction steps, failing command or log, expected vs actual behavior, task/worktree, and user constraints.
+- If architect completes a Debug Mode fix, route to reviewer for independent final validation before final acceptance.
+- If architect reports that the fix exceeds Debug Mode limits or requires new module, new public surface, or new cross-file callable surface, resume the normal code-change flow: architect plan -> coder -> reviewer.
+- If Debug Mode finds durable docs or known-issues impact, keep the normal docs-sync gate after reviewer.
 
 ### Worktree
 

package/dist/main.js

@@ -10,9 +10,15 @@ export function parseMainArgs(argv) {
         if (arg === "--dev") {
             options.dev = true;
         }
+        else if (arg === "--help" || arg === "-h") {
+            options.help = true;
+        }
         else if (arg === "--open") {
             options.open = true;
         }
+        else if (arg === "--version" || arg === "-v") {
+            options.version = true;
+        }
         else if (arg.startsWith("--host=")) {
             options.host = arg.slice("--host=".length);
         }
@@ -24,6 +30,14 @@ export function parseMainArgs(argv) {
 }
 export async function main(argv = process.argv.slice(2)) {
     const options = parseMainArgs(argv);
+    if (options.version) {
+        console.log(readPackageVersion());
+        return;
+    }
+    if (options.help) {
+        console.log(renderHelp());
+        return;
+    }
     const backendPort = options.port ?? DEFAULT_BACKEND_PORT;
     const host = options.host ?? "127.0.0.1";
     const backend = await startServer({
@@ -60,6 +74,31 @@ export async function main(argv = process.argv.slice(2)) {
         process.exit(0);
     });
 }
+function readPackageVersion() {
+    const packageJsonPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    try {
+        const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf8"));
+        if (typeof packageJson.version === "string" && packageJson.version.trim()) {
+            return packageJson.version;
+        }
+    }
+    catch {
+        // Fall through to an explicit unknown version instead of starting the server.
+    }
+    return "unknown";
+}
+function renderHelp() {
+    return `Usage:
+  vcm [options]
+
+Options:
+  --host=<host>     Host to bind. Default: 127.0.0.1
+  --port=<port>     Backend port. Default: ${DEFAULT_BACKEND_PORT}
+  --open            Open behavior flag for compatible launchers.
+  --dev             Start with Vite dev frontend.
+  -v, --version     Print VCM version and exit.
+  -h, --help        Print this help and exit.`;
+}
 function isMainModule() {
     const argvPath = process.argv[1];
     if (!argvPath) {

package/docs/product-design.md

@@ -168,12 +168,13 @@ The project manager owns:
 - user communication
 - task clarification
 - role routing
+- Debug Mode routing for bugs, failing checks, build/runtime errors, unclear defects, and reviewer failure evidence
 - message dispatch
 - handoff verification
 - final acceptance
 - commit and PR preparation after gates pass
 
-The project manager must not become the architect, coder, and reviewer for non-trivial work.
+The project manager must not become the architect, coder, reviewer, or debugger for non-trivial work. PM routes debug evidence to architect and resumes normal gates after architect reports the debug disposition.
 
 ### Architect
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-coding-master",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Local GUI session cockpit for Claude Code role sessions.",
   "type": "module",
   "files": [