vibe-coding-master 0.0.1 → 0.0.3

package/README.md

@@ -40,7 +40,7 @@ Current V1 capabilities:
 
 ## Requirements
 
-- Node.js 20+.
+- Node.js 20 LTS or 22+.
 - npm.
 - Git.
 - Claude Code installed and available as `claude` in the runtime environment.
@@ -52,6 +52,22 @@ python3 make g++ git bash
 
 ## Install
 
+From npm:
+
+```bash
+npm install -g vibe-coding-master
+```
+
+Then start the packaged app:
+
+```bash
+vcm
+```
+
+The published package also installs `vcmctl`, which Claude Code role sessions use internally for VCM message bus commands.
+
+From source:
+
 ```bash
 npm install
 ```
@@ -91,6 +107,12 @@ Then open:
 http://127.0.0.1:4173/
 ```
 
+If installed globally from npm, `vcm` runs the production-style app and serves the GUI from the backend port:
+
+```text
+http://127.0.0.1:4173/
+```
+
 ## Run In VS Code Dev Containers
 
 VCM works well inside a VS Code `devContainer` as long as VCM, Claude Code, and the target repository are all inside the same container filesystem.
@@ -125,6 +147,8 @@ Important container notes:
 - Install Claude Code inside the container, or make the `claude` command available in the container PATH.
 - Make sure Claude Code authentication works inside the container.
 - Make sure the container has network access to Claude services.
+- Use the path as seen from inside the container, for example `/workspace`.
+- If Git still reports dubious ownership for the mounted repository, run inside the container: `git config --global --add safe.directory /workspace`.
 - Keep the user project, `.vcm`, and `.ai/handoffs` on the same mounted workspace so paths are consistent.
 - Treat the container as the sandbox boundary, especially when using relaxed Claude Code permission modes.
 

package/dist/backend/adapters/git-adapter.js

@@ -1,12 +1,19 @@
+import fs from "node:fs/promises";
 import { VcmError } from "../errors.js";
 export function createGitAdapter(runner) {
     return {
+        async checkRepo(repoRoot) {
+            const result = await runGit(runner, repoRoot, ["rev-parse", "--is-inside-work-tree"]);
+            return {
+                isRepo: result.exitCode === 0 && result.stdout.trim() === "true",
+                hint: result.exitCode === 0 ? undefined : formatGitHint(result.stderr)
+            };
+        },
         async isRepo(repoRoot) {
-            const result = await runner.run("git", ["rev-parse", "--is-inside-work-tree"], { cwd: repoRoot });
-            return result.exitCode === 0 && result.stdout.trim() === "true";
+            return (await this.checkRepo(repoRoot)).isRepo;
         },
         async getCurrentBranch(repoRoot) {
-            const result = await runner.run("git", ["branch", "--show-current"], { cwd: repoRoot });
+            const result = await runGit(runner, repoRoot, ["branch", "--show-current"]);
             if (result.exitCode !== 0) {
                 throw new VcmError({
                     code: "GIT_ERROR",
@@ -18,7 +25,7 @@ export function createGitAdapter(runner) {
             return result.stdout.trim() || "detached";
         },
         async isDirty(repoRoot) {
-            const result = await runner.run("git", ["status", "--porcelain"], { cwd: repoRoot });
+            const result = await runGit(runner, repoRoot, ["status", "--porcelain"]);
             if (result.exitCode !== 0) {
                 throw new VcmError({
                     code: "GIT_ERROR",
@@ -31,3 +38,26 @@ export function createGitAdapter(runner) {
         }
     };
 }
+async function runGit(runner, repoRoot, args) {
+    return runner.run("git", [...await buildSafeDirectoryArgs(repoRoot), ...args], { cwd: repoRoot });
+}
+async function buildSafeDirectoryArgs(repoRoot) {
+    const safeDirs = new Set([repoRoot]);
+    try {
+        safeDirs.add(await fs.realpath(repoRoot));
+    }
+    catch {
+        // The main Git command will return the actionable path error.
+    }
+    return [...safeDirs].flatMap((safeDir) => ["-c", `safe.directory=${safeDir}`]);
+}
+function formatGitHint(stderr) {
+    const hint = stderr.trim();
+    if (!hint) {
+        return undefined;
+    }
+    if (hint.includes("detected dubious ownership")) {
+        return `${hint} If this is a devContainer mount, run inside the container: git config --global --add safe.directory <repo-path>`;
+    }
+    return hint;
+}

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

@@ -5,11 +5,24 @@ export function createProjectService(deps) {
     let currentProject = null;
     return {
         async connectProject(input) {
-            const repoRoot = path.resolve(input.repoPath);
-            if (!(await deps.git.isRepo(repoRoot))) {
+            const requestedPath = input.repoPath.trim();
+            const repoRoot = path.resolve(requestedPath);
+            if (!requestedPath || !(await deps.fs.pathExists(repoRoot))) {
                 throw new VcmError({
                     code: "INVALID_REPO",
                     message: "Selected path is not a Git repository.",
+                    hint: requestedPath
+                        ? `Path does not exist inside the VCM runtime: ${repoRoot}`
+                        : "Repository path cannot be empty.",
+                    statusCode: 400
+                });
+            }
+            const repoCheck = await deps.git.checkRepo(repoRoot);
+            if (!repoCheck.isRepo) {
+                throw new VcmError({
+                    code: "INVALID_REPO",
+                    message: "Selected path is not a Git repository.",
+                    hint: repoCheck.hint,
                     statusCode: 400
                 });
             }

package/dist/main.js

@@ -1,6 +1,7 @@
+#!/usr/bin/env node
+import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import { createServer as createViteDevServer } from "vite";
 import { DEFAULT_BACKEND_PORT, DEFAULT_FRONTEND_PORT } from "./shared/constants.js";
 import { getDefaultStaticDir, startServer } from "./backend/server.js";
 export function parseMainArgs(argv) {
@@ -33,6 +34,7 @@ export async function main(argv = process.argv.slice(2)) {
     });
     let vite;
     if (options.dev) {
+        const { createServer: createViteDevServer } = await import("vite");
         vite = await createViteDevServer({
             server: {
                 host,
@@ -58,6 +60,19 @@ export async function main(argv = process.argv.slice(2)) {
         process.exit(0);
     });
 }
-if (fileURLToPath(import.meta.url) === path.resolve(process.argv[1] ?? "")) {
+function isMainModule() {
+    const argvPath = process.argv[1];
+    if (!argvPath) {
+        return false;
+    }
+    const modulePath = fileURLToPath(import.meta.url);
+    try {
+        return fs.realpathSync(argvPath) === fs.realpathSync(modulePath);
+    }
+    catch {
+        return path.resolve(argvPath) === modulePath;
+    }
+}
+if (isMainModule()) {
     void main();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-coding-master",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Local GUI session cockpit for Claude Code role sessions.",
   "type": "module",
   "files": [
@@ -15,7 +15,7 @@
     "vcmctl": "dist/cli/vcmctl.js"
   },
   "engines": {
-    "node": ">=20"
+    "node": "^20.0.0 || >=22.0.0"
   },
   "publishConfig": {
     "access": "public"
@@ -33,7 +33,7 @@
     "e2e": "playwright test"
   },
   "dependencies": {
-    "@fastify/static": "^7.0.4",
+    "@fastify/static": "^9.1.3",
     "@xterm/addon-fit": "^0.10.0",
     "@xterm/addon-web-links": "^0.11.0",
     "@xterm/xterm": "^5.5.0",