@series-inc/rundot-3d-engine 0.4.0 → 0.4.2

package/package.json

@@ -1,12 +1,11 @@
 {
     "name": "@series-inc/rundot-3d-engine",
-    "version": "0.4.0",
+    "version": "0.4.2",
     "type": "module",
     "types": "./dist/index.d.ts",
     "scripts": {
         "build": "tsup",
         "dev": "tsup --watch",
-        "publish": "npm publish",
         "lint": "eslint src",
         "lint:fix": "eslint src --fix",
         "format": "prettier --write .",

package/scripts/gen-docs-index.mjs

@@ -0,0 +1,49 @@
+import { readdirSync, statSync, writeFileSync } from "fs";
+import { join, relative, resolve, sep } from "path";
+
+export function genDocsIndex(
+  label = "Docs Index",
+  root = "docs",
+  srcDir = resolve(import.meta.dirname, "..", "docs"),
+  outPath = resolve(import.meta.dirname, "..", "docs-index.txt"),
+) {
+  const src = resolve(srcDir);
+  const dest = resolve(outPath);
+
+  function walk(dir) {
+    const entries = [];
+    for (const e of readdirSync(dir)) {
+      const p = join(dir, e);
+      if (statSync(p).isDirectory()) entries.push(...walk(p));
+      else if (e.endsWith(".md")) entries.push(relative(src, p).replaceAll(sep, "/"));
+    }
+    return entries.sort();
+  }
+
+  const files = walk(src);
+
+  // Build compact tree: group by directory
+  const tree = {};
+  for (const f of files) {
+    const i = f.lastIndexOf("/");
+    const dir = i === -1 ? "." : f.slice(0, i);
+    const name = f.slice(i + 1);
+    (tree[dir] ??= []).push(name);
+  }
+
+  let out = `[${label}]|root:${root}`;
+  for (const [dir, names] of Object.entries(tree)) {
+    out += `|${dir}:{${names.join(",")}}`;
+  }
+  out += "\n";
+
+  writeFileSync(dest, out);
+  return files.length;
+}
+
+// CLI usage: node gen-docs-index.mjs [label] [root] [srcDir] [outPath]
+if (process.argv[1]?.endsWith("gen-docs-index.mjs")) {
+  const args = process.argv.slice(2);
+  const count = genDocsIndex(args[0], args[1], args[2], args[3]);
+  console.log(`Wrote ${count} files to docs-index.txt`);
+}

package/scripts/postinstall.mjs

@@ -10,19 +10,36 @@ if (!existsSync(docsSource)) {
   process.exit(0);
 }
 
-// Walk up from the package root to find the consuming project root.
-// If we're inside node_modules, exit out of it. Otherwise (e.g. local dev), use packageRoot.
+// Find the project root where docs and .gitignore should live.
+// 1. INIT_CWD — set by npm/yarn/pnpm to where `npm install` was invoked (best for monorepos)
+// 2. Walk up to find .git directory (reliable fallback)
+// 3. Walk up to exit node_modules (legacy fallback)
+// 4. Local dev — packageRoot itself
 function findProjectRoot() {
+  // INIT_CWD is the directory where the user ran `npm install`
+  if (process.env.INIT_CWD && existsSync(process.env.INIT_CWD)) {
+    return resolve(process.env.INIT_CWD);
+  }
+
+  // Walk up looking for .git (repo root)
   let dir = packageRoot;
   while (true) {
+    if (existsSync(join(dir, ".git"))) return dir;
     const parent = dirname(dir);
     if (parent === dir) break; // filesystem root
+    dir = parent;
+  }
+
+  // Legacy: walk up to exit node_modules
+  dir = packageRoot;
+  while (true) {
+    const parent = dirname(dir);
+    if (parent === dir) break;
     const baseName = dir.split(/[\\/]/).pop();
-    if (baseName === "node_modules") {
-      return parent;
-    }
+    if (baseName === "node_modules") return parent;
     dir = parent;
   }
+
   // Not inside node_modules — running locally in the package itself
   return packageRoot;
 }
@@ -61,3 +78,11 @@ if (existsSync(gitignorePath)) {
     appendFileSync(gitignorePath, (needsNewline ? "\n" : "") + entry + "\n");
   }
 }
+
+// Generate docs index from the copied docs and splice into the consumer's AGENTS.md/CLAUDE.md
+const { genDocsIndex } = await import("./gen-docs-index.mjs");
+const { updateDocsIndex } = await import("./update-docs-index.mjs");
+
+const indexPath = join(projectRoot, "docs-index.txt");
+genDocsIndex("Run.3DEngine Docs Index", ".rundot/3d-engine-docs", docsDest, indexPath);
+updateDocsIndex(projectRoot);

package/scripts/update-docs-index.mjs

@@ -0,0 +1,44 @@
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { resolve } from "path";
+
+export function updateDocsIndex(cwd = resolve(import.meta.dirname, "..")) {
+  const indexPath = resolve(cwd, "docs-index.txt");
+  if (!existsSync(indexPath)) {
+    console.warn("docs-index.txt not found, skipping update");
+    return;
+  }
+
+  const fresh = readFileSync(indexPath, "utf-8").trimEnd();
+  const label = "Docs Index";
+  const escaped = label.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const re = new RegExp(`\\[${escaped}\\][^\\n]*(?:\\n(?![\\[<])[^\\n]*)*`);
+
+  const targets = ["AGENTS.md", "CLAUDE.md"];
+
+  for (const file of targets) {
+    const filePath = resolve(cwd, file);
+    if (!existsSync(filePath)) {
+      console.log(`${file} not found, skipping`);
+      continue;
+    }
+
+    let content = readFileSync(filePath, "utf-8");
+
+    if (re.test(content)) {
+      content = content.replace(re, fresh);
+    } else {
+      content = content.trimEnd() + "\n" + fresh + "\n";
+    }
+
+    writeFileSync(filePath, content);
+    console.log(`Updated ${file}`);
+  }
+
+  unlinkSync(indexPath);
+  console.log("Deleted docs-index.txt");
+}
+
+// CLI usage
+if (process.argv[1]?.endsWith("update-docs-index.mjs")) {
+  updateDocsIndex();
+}