npm - vibe-coding-master - Versions diffs - 0.4.0 → 0.4.2 - Mend

vibe-coding-master 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (20) hide show

package/README.md +3 -3
package/dist/backend/cli/install-vcm-harness.js +1 -1
package/dist/backend/server.js +8 -8
package/dist/backend/services/claude-hook-service.js +5 -0
package/dist/backend/services/harness-service.js +119 -174
package/dist/backend/services/message-service.js +0 -32
package/dist/backend/templates/harness/architect-agent.js +1 -1
package/dist/backend/templates/harness/claude-root.js +1 -1
package/dist/backend/templates/harness/coder-agent.js +1 -1
package/dist/backend/templates/harness/vcm-harness-bootstrap-skill.js +1 -1
package/dist-frontend/assets/{index-CMuJhDdX.js → index-uYhgIwNK.js} +22 -22
package/dist-frontend/index.html +1 -1
package/docs/full-harness-baseline.md +5 -5
package/docs/product-design.md +1 -1
package/docs/vcm-cc-best-practices.md +12 -18
package/package.json +1 -1
package/scripts/harness-tools/__pycache__/generate-module-indexcpython-314.pyc +0 -0
package/scripts/harness-tools/__pycache__/generate-public-surfacecpython-314.pyc +0 -0
package/scripts/harness-tools/generate-module-index +225 -5
package/scripts/harness-tools/generate-public-surface +388 -3

package/dist-frontend/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>VibeCodingMaster</title>
-    <script type="module" crossorigin src="/assets/index-CMuJhDdX.js"></script>
+    <script type="module" crossorigin src="/assets/index-uYhgIwNK.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-kJDZAzjD.css">
   </head>
   <body>

package/docs/full-harness-baseline.md CHANGED Viewed

@@ -101,10 +101,10 @@ Directory roots created by the installer:
 .ai/tools/vcm-bash-guard
 ```
-`generate-module-index` and `generate-public-surface` currently target Rust
-projects. Non-Rust repositories can still install the fixed harness, but
-generated context should be treated as unsupported until project-specific
-generators exist.
+`generate-module-index` and `generate-public-surface` support Rust/Cargo
+projects and npm workspace TypeScript/JavaScript projects. Other repository
+shapes can still install the fixed harness, but generated context should be
+treated as unsupported until project-specific generators exist.
 ## Runtime State
@@ -130,9 +130,9 @@ Project-scoped runtime state lives in the base repository:
 ```text
 <baseRepoRoot>/.ai/vcm/gate-reviewer/session.json
+<baseRepoRoot>/.ai/vcm/harness-engineer/session.json
 <baseRepoRoot>/.ai/vcm/translations/
 <baseRepoRoot>/.ai/vcm/bootstrap/session.json
-<baseRepoRoot>/.ai/vcm/bootstrap/bootstrap.log
 ```
 App-local state lives under `vcmDataDir`:

package/docs/product-design.md CHANGED Viewed

@@ -825,9 +825,9 @@ Project-scoped local files:
 ```text
 .ai/vcm/gate-reviewer/session.json
+.ai/vcm/harness-engineer/session.json
 .ai/vcm/translations/
 .ai/vcm/bootstrap/session.json
-.ai/vcm/bootstrap/bootstrap.log
 ```
 External Claude transcripts:

package/docs/vcm-cc-best-practices.md CHANGED Viewed

@@ -171,8 +171,8 @@ Current runtime files and directories:
 .ai/vcm/handoffs/known-issues.md
 .ai/vcm/gate-reviews/
 .ai/vcm/jobs/<job-id>/
+.ai/vcm/harness-engineer/session.json
 .ai/vcm/bootstrap/session.json
-.ai/vcm/bootstrap/bootstrap.log
 ```
 App-local VCM task records live outside the connected repository:
@@ -363,13 +363,12 @@ The current example has two generated artifacts:
 `module-index.json` helps agents find layers, modules, manifests, module docs,
 source files, test files, and workspace dependencies.
-`public-surface.json` indexes crate-external Rust public APIs. It is a machine
-index, not an architecture document.
+`public-surface.json` indexes project public APIs, routes, and externally
+consumed surfaces. It is a machine index, not an architecture document.
-Current generated-context support is Rust-only. The fixed installer provides
-Rust generator tools as the default baseline, but it does not generate trusted
-context by itself. Non-Rust projects must use project-specific generators before
-`.ai/generated/*` is considered reliable.
+Current generated-context support covers Rust/Cargo projects and npm workspace
+TypeScript/JavaScript projects. Other repository shapes must use
+project-specific generators before `.ai/generated/*` is considered reliable.
 There is no `test-map.json`. Rust unit tests live with source where appropriate;
 integration tests use Cargo's normal test layout. Test files are discoverable
@@ -402,22 +401,17 @@ during bootstrap.
 Important claims should be marked as verified, inferred, unknown, or needing
 human confirmation.
-VCM should launch bootstrap as a visible temporary Claude Code terminal, not as
-an invisible background task:
+VCM should run bootstrap through the project-scoped `harness-engineer` session,
+not through a separate temporary terminal or invisible background task:
 - run the deterministic fixed installer first
-- start Claude Code in the connected repository root without a role agent
-- set `VCM_TASK_REPO_ROOT`, `VCM_HARNESS_BOOTSTRAP=1`, `VCM_SESSION_ID`, and
-  `VCM_API_URL`
+- start or resume the `harness-engineer` role in the connected repository root
 - send a prompt that explicitly requires using `vcm-harness-bootstrap`
-- log terminal output under `.ai/vcm/bootstrap/bootstrap.log`
-- persist session metadata under `.ai/vcm/bootstrap/session.json`
-- mark bootstrap complete only when project context, generated context,
-  project architecture docs, module architecture docs, and testing docs are
-  present and non-empty
+- persist the bootstrap run marker under `.ai/vcm/bootstrap/session.json`
+- mark the bootstrap run complete when the `harness-engineer` Stop hook arrives
 The UI should expose both stages: fixed install status and bootstrap completion
-status. A failed or disconnected bootstrap terminal should be restartable
+status. A failed or disconnected Harness Engineer session should be restartable
 without treating project-owned durable docs as VCM-owned harness files.
 ## 12. Final Acceptance

package/package.json CHANGED Viewed

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

package/scripts/harness-tools/__pycache__/generate-module-indexcpython-314.pyc ADDED Viewed

Binary file

package/scripts/harness-tools/__pycache__/generate-public-surfacecpython-314.pyc ADDED Viewed

Binary file

package/scripts/harness-tools/generate-module-index CHANGED Viewed

@@ -12,6 +12,12 @@ except ModuleNotFoundError:
     tomllib = None
+NODE_SOURCE_EXTENSIONS = (".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs")
+NODE_EXCLUDED_DIRS = {"node_modules", "dist", "build", "coverage", ".next", ".turbo", ".vite"}
+NODE_DEPENDENCY_TABLES = ("dependencies", "devDependencies", "peerDependencies", "optionalDependencies")
+NODE_TEST_MARKERS = (".test.", ".spec.")
 def relative_path(path: Path, root: Path) -> str:
     try:
         rel = path.absolute().relative_to(root.absolute())
@@ -20,7 +26,7 @@ def relative_path(path: Path, root: Path) -> str:
     return "." if str(rel) == "." else rel.as_posix()
-def find_cargo_root(project_root: Path) -> Path:
+def maybe_find_cargo_root(project_root: Path) -> Path | None:
     if (project_root / "Cargo.toml").is_file():
         return project_root
@@ -28,7 +34,18 @@ def find_cargo_root(project_root: Path) -> Path:
         if child.is_dir() and (child / "Cargo.toml").is_file():
             return child
-    raise SystemExit(f"Could not find Cargo.toml in {project_root} or its direct child directories.")
+    return None
+def find_cargo_root(project_root: Path) -> Path:
+    cargo_root = maybe_find_cargo_root(project_root)
+    if cargo_root is None:
+        raise SystemExit(f"Could not find Cargo.toml in {project_root} or its direct child directories.")
+    return cargo_root
+def load_json(path: Path) -> dict:
+    return json.loads(path.read_text())
 def load_toml(path: Path) -> dict:
@@ -149,6 +166,196 @@ def rust_files_under(module_dir: Path, project_root: Path, child: str) -> list[s
     )
+def maybe_find_node_root(project_root: Path) -> Path | None:
+    if (project_root / "package.json").is_file():
+        return project_root
+    for child in sorted(project_root.iterdir(), key=lambda path: path.name):
+        if child.is_dir() and (child / "package.json").is_file():
+            return child
+    return None
+def workspace_patterns(package_data: dict) -> list[str]:
+    workspaces = package_data.get("workspaces")
+    if isinstance(workspaces, list):
+        return [pattern for pattern in workspaces if isinstance(pattern, str)]
+    if isinstance(workspaces, dict):
+        packages = workspaces.get("packages", [])
+        if isinstance(packages, list):
+            return [pattern for pattern in packages if isinstance(pattern, str)]
+    return []
+def node_workspace_manifests(node_root: Path) -> list[Path]:
+    root_manifest = node_root / "package.json"
+    root_data = load_json(root_manifest)
+    patterns = workspace_patterns(root_data)
+    if not patterns:
+        return [root_manifest]
+    manifests: list[Path] = []
+    seen: set[Path] = set()
+    for pattern in patterns:
+        if pattern.startswith("!") or pattern.startswith("/") or ".." in Path(pattern).parts:
+            continue
+        for candidate in sorted(node_root.glob(pattern), key=lambda path: path.as_posix()):
+            manifest = candidate / "package.json"
+            if not candidate.is_dir() or not manifest.is_file() or manifest in seen:
+                continue
+            if any(part in NODE_EXCLUDED_DIRS for part in relative_path(candidate, node_root).split("/")):
+                continue
+            manifests.append(manifest)
+            seen.add(manifest)
+    if root_data.get("name") and (root_data.get("main") or root_data.get("exports") or (node_root / "src").is_dir()):
+        manifests.insert(0, root_manifest)
+    return manifests
+def node_dependency_names(manifest: Path) -> set[str]:
+    data = load_json(manifest)
+    names: set[str] = set()
+    for table_name in NODE_DEPENDENCY_TABLES:
+        table = data.get(table_name, {})
+        if isinstance(table, dict):
+            names.update(name for name in table.keys() if isinstance(name, str))
+    return names
+def node_source_files_under(module_dir: Path, project_root: Path) -> tuple[list[str], list[str]]:
+    source_root = module_dir / "src"
+    if not source_root.is_dir():
+        return ([], [])
+    source_files: list[str] = []
+    test_files: list[str] = []
+    for path in sorted(source_root.rglob("*"), key=lambda item: item.as_posix()):
+        if not path.is_file():
+            continue
+        if path.suffix not in NODE_SOURCE_EXTENSIONS or path.name.endswith(".d.ts"):
+            continue
+        if any(part in NODE_EXCLUDED_DIRS for part in path.relative_to(module_dir).parts):
+            continue
+        rel = relative_path(path, project_root)
+        if any(marker in path.name for marker in NODE_TEST_MARKERS):
+            test_files.append(rel)
+        else:
+            source_files.append(rel)
+    tests_root = module_dir / "tests"
+    if tests_root.is_dir():
+        for path in sorted(tests_root.rglob("*"), key=lambda item: item.as_posix()):
+            if (
+                path.is_file()
+                and path.suffix in NODE_SOURCE_EXTENSIONS
+                and not path.name.endswith(".d.ts")
+                and not any(part in NODE_EXCLUDED_DIRS for part in path.relative_to(module_dir).parts)
+            ):
+                test_files.append(relative_path(path, project_root))
+    return (source_files, sorted(set(test_files)))
+def infer_node_layer(module_path: str, node_root: Path, project_root: Path) -> tuple[str, str]:
+    node_root_rel = relative_path(node_root, project_root)
+    if module_path == node_root_rel:
+        return ("root", node_root_rel)
+    relative_to_node_root = relative_path(project_root / module_path, node_root)
+    first = relative_to_node_root.split("/", 1)[0]
+    return (first, relative_path(node_root / first, project_root))
+def node_package_records(node_root: Path) -> list[dict]:
+    manifests = node_workspace_manifests(node_root)
+    records: list[dict] = []
+    names_by_manifest: dict[Path, str] = {}
+    for manifest in manifests:
+        data = load_json(manifest)
+        name = data.get("name")
+        if isinstance(name, str) and name:
+            names_by_manifest[manifest] = name
+    workspace_names = set(names_by_manifest.values())
+    for manifest, name in names_by_manifest.items():
+        dependency_names = node_dependency_names(manifest) & workspace_names
+        records.append(
+            {
+                "name": name,
+                "manifest": manifest,
+                "workspaceDependencies": sorted(dependency_names),
+            }
+        )
+    return records
+def build_node_index(project_root: Path, node_root: Path) -> dict:
+    records = node_package_records(node_root)
+    has_workspaces = bool(workspace_patterns(load_json(node_root / "package.json")))
+    layers: list[dict] = []
+    layer_by_name: dict[str, dict] = {}
+    for record in records:
+        manifest_path = record["manifest"]
+        module_dir = manifest_path.parent
+        module_path = relative_path(module_dir, project_root)
+        manifest_rel = relative_path(manifest_path, project_root)
+        layer_name, layer_path = infer_node_layer(module_path, node_root, project_root)
+        source_files, test_files = node_source_files_under(module_dir, project_root)
+        if layer_name not in layer_by_name:
+            layer = {
+                "name": layer_name,
+                "path": layer_path,
+                "modules": [],
+            }
+            layer_by_name[layer_name] = layer
+            layers.append(layer)
+        layer_by_name[layer_name]["modules"].append(
+            {
+                "name": record["name"],
+                "path": module_path,
+                "manifest": manifest_rel,
+                "architectureDoc": f"{module_path}/ARCHITECTURE.md"
+                if module_path != "."
+                else "ARCHITECTURE.md",
+                "workspaceDependencies": record["workspaceDependencies"],
+                "language": "typescript",
+                "files": {
+                    "source": source_files,
+                    "tests": test_files,
+                },
+            }
+        )
+    return {
+        "schemaVersion": 1,
+        "kind": "module-index",
+        "generatedBy": ".ai/tools/generate-module-index",
+        "workspace": {
+            "type": "npm-workspaces" if has_workspaces else "npm-package",
+            "root": relative_path(node_root, project_root),
+            "manifest": relative_path(node_root / "package.json", project_root),
+        },
+        "layerInference": {
+            "method": "path-first-segment-from-workspace-root",
+            "rootPackageLayer": "root",
+        },
+        "layers": layers,
+    }
 def package_records_from_metadata(project_root: Path, cargo_root: Path, metadata: dict) -> list[dict]:
     workspace_root = Path(metadata["workspace_root"])
     workspace_member_ids = set(metadata["workspace_members"])
@@ -201,8 +408,7 @@ def package_records_from_manifests(cargo_root: Path) -> list[dict]:
     return records
-def build_index(project_root: Path) -> dict:
-    cargo_root = find_cargo_root(project_root)
+def build_cargo_index(project_root: Path, cargo_root: Path) -> dict:
     metadata = load_cargo_metadata(cargo_root)
     records = (
         package_records_from_metadata(project_root, cargo_root, metadata)
@@ -262,8 +468,22 @@ def build_index(project_root: Path) -> dict:
     }
+def build_index(project_root: Path) -> dict:
+    cargo_root = maybe_find_cargo_root(project_root)
+    if cargo_root is not None:
+        return build_cargo_index(project_root, cargo_root)
+    node_root = maybe_find_node_root(project_root)
+    if node_root is not None:
+        return build_node_index(project_root, node_root)
+    raise SystemExit(
+        f"Could not find Cargo.toml or package.json in {project_root} or its direct child directories."
+    )
 def main() -> int:
-    parser = argparse.ArgumentParser(description="Generate .ai/generated/module-index.json from cargo metadata.")
+    parser = argparse.ArgumentParser(description="Generate .ai/generated/module-index.json from Cargo or npm workspace metadata.")
     parser.add_argument("--check", action="store_true", help="Fail if the generated module index differs from the current file.")
     parser.add_argument("--print", action="store_true", help="Print generated JSON instead of writing it.")
     parser.add_argument("--output", default=".ai/generated/module-index.json", help="Output path relative to the project root.")