@techierathore/techieflow 1.0.0

package/scripts/validate.mjs

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+// scripts/validate.mjs — the checks that run before every publish and on every push.
+//
+//   1. Mirror parity: every file under .claude/commands/TechieFlow/<sub>/ is byte-identical
+//      to .tfcore/<sub>/. Claude Code only reads the mirror, so drift means Claude Code and
+//      OpenCode run different instructions.
+//   2. OpenCode references: every {file:...} in opencode.jsonc points at a file that exists.
+//      One dead reference makes OpenCode reject the whole config.
+//   3. Shell syntax: `bash -n` on every .sh file in the repository.
+//   4. Package contents: `npm pack --dry-run` succeeds, ships every file the shell scripts
+//      deploy, and ships none of the local-only or per-machine files.
+//
+// Exit code 0 means every check passed. Any failure exits 1 and names the problem.
+
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const problems = [];
+let passed = 0;
+
+function check(name, fn) {
+  try {
+    fn();
+    passed++;
+    console.log(`ok    ${name}`);
+  } catch (error) {
+    problems.push(`${name}: ${error.message}`);
+    console.log(`FAIL  ${name}\n      ${error.message.split("\n").join("\n      ")}`);
+  }
+}
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+const skipDirectories = new Set([".git", "node_modules"]);
+
+function filesUnder(directory) {
+  const out = [];
+  const walk = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      if (entry.isDirectory()) { if (!skipDirectories.has(entry.name)) walk(join(current, entry.name)); }
+      else if (entry.isFile()) out.push(join(current, entry.name));
+    }
+  };
+  if (existsSync(directory)) walk(directory);
+  return out;
+}
+
+const rel = (path) => relative(root, path).split("\\").join("/");
+
+// ---- 1. mirror parity
+check("Claude mirror is byte-identical to .tfcore/", () => {
+  const mirror = join(root, ".claude", "commands", "TechieFlow");
+  const differences = [];
+  for (const sub of readdirSync(mirror)) {
+    const coreFiles = new Map(filesUnder(join(root, ".tfcore", sub)).map((f) => [relative(join(root, ".tfcore", sub), f), f]));
+    const mirrorFiles = new Map(filesUnder(join(mirror, sub)).map((f) => [relative(join(mirror, sub), f), f]));
+    for (const [name, corePath] of coreFiles) {
+      if (!mirrorFiles.has(name)) differences.push(`missing from mirror: ${sub}/${name}`);
+      else if (!readFileSync(corePath).equals(readFileSync(mirrorFiles.get(name)))) differences.push(`content differs: ${sub}/${name}`);
+    }
+    for (const name of mirrorFiles.keys()) if (!coreFiles.has(name)) differences.push(`only in mirror: ${sub}/${name}`);
+  }
+  assert(differences.length === 0, `${differences.length} difference(s) between .tfcore/ and .claude/commands/TechieFlow/:\n${differences.join("\n")}\nFix: copy the changed files from .tfcore/ over the mirror, or re-run the scaffold's agent sync for every folder.`);
+});
+
+// ---- 2. OpenCode references
+check("every {file:} reference in opencode.jsonc resolves", () => {
+  const text = readFileSync(join(root, "opencode.jsonc"), "utf8");
+  const refs = [...new Set([...text.matchAll(/\{file:([^}]*)\}/g)].map((m) => m[1]))];
+  assert(refs.length > 0, "opencode.jsonc contains no {file:} references at all");
+  const dead = refs.filter((ref) => !existsSync(join(root, ref)));
+  assert(dead.length === 0, `dead references:\n${dead.join("\n")}`);
+});
+
+// ---- 3. shell syntax
+check("bash -n passes on every .sh file", () => {
+  const scripts = filesUnder(root).filter((f) => f.endsWith(".sh"));
+  assert(scripts.length > 0, "no .sh files found");
+  const broken = [];
+  for (const script of scripts) {
+    const result = spawnSync("bash", ["-n", script], { encoding: "utf8" });
+    if (result.error) throw new Error(`bash could not be started: ${result.error.message}`);
+    if (result.status !== 0) broken.push(`${rel(script)}: ${result.stderr.trim()}`);
+  }
+  assert(broken.length === 0, broken.join("\n"));
+  console.log(`      ${scripts.length} script(s) checked`);
+});
+
+// ---- 4. package contents
+const libraryPersonas = new Set(["trblazeui.md", "techierag.md"]);
+
+// What the three shell scripts copy out of this repository into a project.
+function deployedFiles() {
+  const out = [];
+  for (const f of filesUnder(join(root, ".tfcore"))) {
+    const r = rel(f);
+    if (!r.startsWith(".tfcore/.session/")) out.push(r);
+  }
+  for (const f of filesUnder(join(root, ".claude", "commands"))) {
+    if (!libraryPersonas.has(f.split("/").pop())) out.push(rel(f));
+  }
+  for (const f of filesUnder(join(root, ".opencode", "plugin"))) if (f.endsWith(".js")) out.push(rel(f));
+  for (const f of filesUnder(join(root, ".opencode", "command"))) {
+    if (f.endsWith(".md") && !libraryPersonas.has(f.split("/").pop())) out.push(rel(f));
+  }
+  out.push(".codex/config.toml", ".codex/hooks.json");
+  for (const f of filesUnder(join(root, ".codex", "rules"))) out.push(rel(f));
+  out.push("opencode.jsonc", "WORKFLOW.html");
+  return out.filter((r) => !/(^|\/)(\.DS_Store|Thumbs\.db|desktop\.ini)$/.test(r) && !r.endsWith(".bak"));
+}
+
+const mustNotShip = [
+  ".tfcore/.session", ".claude/settings.json", ".claude/settings.local.json",
+  ".claude/trblazeui.md", ".claude/techierag.md",
+  ".claude/commands/trblazeui.md", ".claude/commands/techierag.md",
+  ".opencode/command/trblazeui.md", ".opencode/command/techierag.md",
+  ".opencode/node_modules", ".opencode/package.json", ".opencode/package-lock.json", ".opencode/.gitignore",
+  ".codex/agents", ".agents", ".techierag", ".trblazeui", ".github",
+  "scaffold-brownfield.sh", "scaffold-greenfield.sh", "update-framework.sh",
+  "docs/TechieFlow-Requirements.md", "docs/TechieFlow-How-It-Works.md", "docs/metrics",
+  "DECISIONS.md", "WorkFlow-Context.md", "CodexChanges.md",
+];
+const mustShip = [
+  "package.json", "LICENSE", "README.md", "docs/TechieFlow-Installation.md",
+  "scripts/install.mjs", "scripts/test-install.mjs", "scripts/validate.mjs",
+];
+
+check("npm pack --dry-run succeeds and ships the right files", () => {
+  const onWindows = process.platform === "win32";
+  const result = process.env.npm_execpath
+    ? spawnSync(process.execPath, [process.env.npm_execpath, "pack", "--dry-run", "--json"], { cwd: root, encoding: "utf8" })
+    : spawnSync(onWindows ? "npm.cmd" : "npm", ["pack", "--dry-run", "--json"], { cwd: root, encoding: "utf8", shell: onWindows });
+  if (result.error) throw new Error(`npm could not be started: ${result.error.message}`);
+  assert(result.status === 0, `npm pack --dry-run failed:\n${result.stdout}${result.stderr}`);
+  const packed = new Set(JSON.parse(result.stdout)[0].files.map((f) => f.path));
+  const missing = [...deployedFiles(), ...mustShip].filter((f) => !packed.has(f));
+  const leaked = [...packed].filter((p) => mustNotShip.some((bad) => p === bad || p.startsWith(`${bad}/`)));
+  const report = [];
+  if (missing.length) report.push(`files the shell scripts deploy but the package does not ship:\n${missing.join("\n")}`);
+  if (leaked.length) report.push(`files that must not ship:\n${leaked.join("\n")}`);
+  assert(report.length === 0, report.join("\n"));
+  console.log(`      ${packed.size} file(s) in the package`);
+});
+
+console.log("");
+if (problems.length) {
+  console.log(`${passed} check(s) passed, ${problems.length} failed`);
+  process.exit(1);
+}
+console.log(`validation passed (${passed} checks)`);