@bitflower/va-mcp 1.0.0 → 1.0.2

package/README.md

@@ -61,9 +61,8 @@ grep -qxF '.claude/settings.local.json' .gitignore || echo '.claude/settings.loc
 
 The check is deliberately conservative: it recognizes only an exact-path or
 directory-prefix entry — glob patterns (e.g. `.claude/*`), `!`-negation lines,
-and nested `.gitignore` files are **not** evaluated. See the
-[full guide](../../documentation/mcp-installer-guide.md) for the exact matcher
-semantics. The check is skipped for non-git directories. In a monorepo, put
+and nested `.gitignore` files are **not** evaluated. The check is skipped for
+non-git directories. In a monorepo, put
 the entry in the **project-local** `.gitignore` (the one in the target
 directory), not the repo-root `.gitignore` — the installer reads only the
 target directory's file.
@@ -82,9 +81,6 @@ without outbound network access (beyond `npx` fetching the package itself).
   release.
 - **Bearer token:** your API key is passed only to the `claude` CLI and is
   never written to any file the installer creates.
-
-## Full guide
-
-See **[documentation/mcp-installer-guide.md](../../documentation/mcp-installer-guide.md)**
-for prerequisites in depth, the data-flow and bearer-exposure warnings,
-verification steps, key rotation, and LAN access.
+- **Full setup guide:** in-depth prerequisites, data-flow and bearer-exposure
+  warnings, verification, key rotation, and LAN access are documented for
+  Virtual Architect users as part of the platform docs.

package/dist/index.js

@@ -8,7 +8,7 @@ import { Command, CommanderError } from "commander";
 // package.json
 var package_default = {
   name: "@bitflower/va-mcp",
-  version: "1.0.0",
+  version: "1.0.2",
   description: "Install the Virtual Architect MCP server and SessionStart playbook into a Claude Code project.",
   repository: {
     type: "git",
@@ -17,7 +17,7 @@ var package_default = {
   },
   type: "module",
   bin: {
-    "va-mcp": "./dist/index.js"
+    "va-mcp": "dist/index.js"
   },
   files: [
     "dist"
@@ -34,8 +34,12 @@ var package_default = {
   },
   keywords: [
     "mcp",
-    "claude-code",
-    "virtual-architect"
+    "virtual-architect",
+    "knowledge-management",
+    "knowledge-base",
+    "sdlc",
+    "architecture",
+    "infrastructure"
   ],
   license: "MIT",
   publishConfig: {
@@ -279,6 +283,7 @@ function pruneSettingsLocal(projectDir) {
 }
 
 // src/gitignore-check.ts
+import { spawnSync as spawnSync2 } from "child_process";
 import * as fs3 from "fs";
 import * as path3 from "path";
 var SETTINGS_RELPATH = ".claude/settings.local.json";
@@ -317,8 +322,34 @@ function isPathIgnored(projectDir, relpath) {
   }
   return ignored;
 }
+var GIT_CHECK_IGNORE_TIMEOUT_MS = 5e3;
+function gitConfirmsIgnored(projectDir, relpath) {
+  const probe = spawnSync2("git", ["check-ignore", "-q", "--", relpath], {
+    cwd: projectDir,
+    timeout: GIT_CHECK_IGNORE_TIMEOUT_MS,
+    windowsHide: true
+  });
+  if (probe.error) return null;
+  if (probe.status === 0) return true;
+  if (probe.status === 1) return false;
+  return null;
+}
 function checkGitignorePrecondition(projectDir) {
   if (!isInsideGitWorkTree(projectDir)) return;
+  const gitVerdict = gitConfirmsIgnored(projectDir, SETTINGS_RELPATH);
+  if (gitVerdict === true) return;
+  if (gitVerdict === false) {
+    throw new InstallerError(
+      `refusing to write ${SETTINGS_RELPATH} into a git work tree \u2014 git reports it is not ignored, so it could be committed. Add an entry that ignores it to a \`.gitignore\` (in a monorepo the repo-root file works too):
+
+    ${SETTINGS_RELPATH}
+
+If the file is already tracked, a .gitignore entry will not help \u2014 untrack it first:
+
+    git rm --cached ${SETTINGS_RELPATH}
+`
+    );
+  }
   if (isPathIgnored(projectDir, SETTINGS_RELPATH)) return;
   throw new InstallerError(
     `refusing to write ${SETTINGS_RELPATH} into a git work tree. The installer's plain-text gitignore scan found no exact-path or directory-prefix entry that ignores it (globs like '.claude/*' and '!' negation lines are NOT evaluated \u2014 we err on the safe side and refuse if there is any chance the file ends up tracked). To proceed, add an exact entry to ${path3.join(projectDir, ".gitignore")}:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitflower/va-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Install the Virtual Architect MCP server and SessionStart playbook into a Claude Code project.",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   },
   "type": "module",
   "bin": {
-    "va-mcp": "./dist/index.js"
+    "va-mcp": "dist/index.js"
   },
   "files": [
     "dist"
@@ -26,8 +26,12 @@
   },
   "keywords": [
     "mcp",
-    "claude-code",
-    "virtual-architect"
+    "virtual-architect",
+    "knowledge-management",
+    "knowledge-base",
+    "sdlc",
+    "architecture",
+    "infrastructure"
   ],
   "license": "MIT",
   "publishConfig": {