@drawbridge/drawbridge-agents 0.1.5 → 0.1.7

package/.root-template/npmrc

@@ -0,0 +1 @@
+save-exact=true

package/README.md

@@ -24,11 +24,13 @@ claude/
   skills/                   ← shared skills (drawbridge-ship-feature, -asana-ship-handoff, ...)
   hooks/  agents/  commands/
 
-.root-template/             ← mirrored into each consumer repo's root (identical everywhere)
-  .mcp.json                 ← project-level MCP servers (Sentry, Asana)
-  .editorconfig             ← family-wide editor defaults (tabs, lf, utf-8)
-  .npmrc                    ← save-exact=true (enforces the exact-pin convention)
-  .nvmrc                    ← family-standard node version (v22.23.1)
+.root-template/             ← mirrored to each consumer repo's root; files are stored DOTLESS
+                              and the mirror restores the leading dot (one rule; also required
+                              for npmrc since npm strips a literal .npmrc from tarballs)
+  mcp.json                  → .mcp.json    project-level MCP servers (Sentry, Asana)
+  editorconfig              → .editorconfig family-wide editor defaults (tabs, lf, utf-8)
+  npmrc                     → .npmrc        save-exact=true (exact-pin convention)
+  nvmrc                     → .nvmrc        family-standard node version (v22.23.1)
 
 bin/
   sync-claude.js            ← drawbridge-agents-sync — mirrors templates + graphify preflight

package/bin/preflight-graphify.js

@@ -1,14 +1,22 @@
 #!/usr/bin/env node
-// Ensures the graphify runtime is installed (required for the family knowledge graph) and
-// registers its MCP server with the local assistant. Called by drawbridge-agents-sync.
-// Set DRAWBRIDGE_SKIP_GRAPHIFY=1 to skip in CI / headless environments.
+// Ensures the graphify runtime is available for the family knowledge graph. NON-FATAL by design:
+// if graphify can't be found or installed, warn and continue — `npm run sync` must never be
+// blocked by it (the drift hook nudges separately, and the graph is built on demand).
+// Set DRAWBRIDGE_SKIP_GRAPHIFY=1 to skip silently.
 const { execFileSync } = require('child_process')
+const os = require('os')
+const path = require('path')
 
 if (process.env.DRAWBRIDGE_SKIP_GRAPHIFY === '1') {
   console.log('drawbridge-agents-sync: DRAWBRIDGE_SKIP_GRAPHIFY set — skipping graphify preflight')
   process.exit(0)
 }
 
+// npm runs scripts under a minimal shell (sh), so tools installed by uv/pipx into ~/.local/bin
+// are often not on PATH. Add common user-bin dirs so an installed graphify is still found.
+const extra = [ path.join(os.homedir(), '.local', 'bin'), '/opt/homebrew/bin' ]
+process.env.PATH = [ ...extra, process.env.PATH || '' ].join(path.delimiter)
+
 const has = (cmd) => {
   try {
     execFileSync(cmd, [ '--version' ], { stdio: 'ignore' })
@@ -18,37 +26,30 @@ const has = (cmd) => {
   }
 }
 
-if (!has('graphify')) {
-  console.log('drawbridge-agents-sync: graphify runtime not found, attempting install...')
-  const attempts = [
-    [ 'uv', [ 'tool', 'install', 'graphifyy' ] ],
-    [ 'pipx', [ 'install', 'graphifyy' ] ],
-    [ 'pip', [ 'install', '--user', 'graphifyy' ] ],
-    [ 'pip3', [ 'install', '--user', 'graphifyy' ] ]
-  ]
-  for (const [ cmd, args ] of attempts) {
-    if (!has(cmd)) continue
-    try {
-      execFileSync(cmd, args, { stdio: 'inherit' })
-      break
-    } catch (error) {
-      // try the next installer
-    }
-  }
-  if (!has('graphify')) {
-    console.error([
-      'drawbridge-agents-sync: could not install the graphify runtime automatically.',
-      'Install it, then re-run npm run sync:',
-      '  uv tool install graphifyy   (recommended)',
-      '  pipx install graphifyy',
-      '  pip install --user graphifyy',
-      'Or set DRAWBRIDGE_SKIP_GRAPHIFY=1 to skip (CI / headless only).'
-    ].join('\n'))
-    process.exit(1)
+if (has('graphify')) {
+  console.log('drawbridge-agents-sync: graphify runtime ready')
+  process.exit(0)
+}
+
+// Best-effort install if a Python tool installer is available; never fail if none is.
+for (const [ cmd, args ] of [
+  [ 'uv', [ 'tool', 'install', 'graphifyy' ] ],
+  [ 'pipx', [ 'install', 'graphifyy' ] ],
+  [ 'pip', [ 'install', '--user', 'graphifyy' ] ],
+  [ 'pip3', [ 'install', '--user', 'graphifyy' ] ]
+]) {
+  if (!has(cmd)) continue
+  try {
+    execFileSync(cmd, args, { stdio: 'inherit' })
+    break
+  } catch (error) {
+    // try the next installer
   }
 }
 
-// Note: we deliberately do NOT run `graphify install` — it writes a graphify section into the
-// repo's CLAUDE.md and a PreToolUse hook, which would mutate a committed file and clash with the
-// shared CLAUDE.md. Agents use the graphify CLI directly (see conventions/graphify.md).
-console.log('drawbridge-agents-sync: graphify runtime ready (run `npx drawbridge-agents-graph` to build the graph)')
+if (has('graphify')) {
+  console.log('drawbridge-agents-sync: graphify runtime installed')
+} else {
+  console.warn('drawbridge-agents-sync: graphify not found (optional) — install with `uv tool install graphifyy` to enable the family knowledge graph. Continuing.')
+}
+process.exit(0)

package/bin/sync-claude.js

@@ -16,11 +16,21 @@ const rmrf = (p) => {
 
 const copied = []
 
+// Root-template files are stored dotless and the leading dot is restored on mirror. This is
+// required for `npmrc` (npm strips a literal `.npmrc` from published tarballs) and applied to
+// the rest for one consistent rule: template files never start with a dot.
+const RENAME = {
+  editorconfig: '.editorconfig',
+  'mcp.json': '.mcp.json',
+  nvmrc: '.nvmrc',
+  npmrc: '.npmrc'
+}
+
 const mirror = (src, dst) => {
   fs.mkdirSync(dst, { recursive: true })
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     const s = path.join(src, entry.name)
-    const d = path.join(dst, entry.name)
+    const d = path.join(dst, RENAME[entry.name] || entry.name)
     if (entry.isDirectory()) {
       mirror(s, d)
     } else {
@@ -80,9 +90,13 @@ const migrateOldDelivery = () => {
   }
 }
 
-// 3. Ensure the graphify runtime is present + reachable (hard-fails if it can't be).
+// 3. Ensure the graphify runtime is present (best-effort, never blocks sync).
 const graphifyPreflight = () => {
-  execFileSync('node', [ path.join(packageRoot, 'bin', 'preflight-graphify.js') ], { stdio: 'inherit' })
+  try {
+    execFileSync('node', [ path.join(packageRoot, 'bin', 'preflight-graphify.js') ], { stdio: 'inherit' })
+  } catch (error) {
+    console.warn('drawbridge-agents-sync: graphify preflight skipped (' + error.message + ')')
+  }
 }
 
 mirrorTemplates()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawbridge/drawbridge-agents",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Shared agent-instruction content (rules, code style, conventions) for the drawbridge-* monorepo.",
   "license": "UNLICENSED",
   "publishConfig": {