@bigsteele/the-big-sean 0.4.3 → 0.4.4

package/dist/cli.js

@@ -146,13 +146,45 @@ async function aiReadinessLine(reportDir) {
         return null;
     }
 }
+/** The files this tool leaves behind are working artifacts, not source. An
+ *  untracked THE-BIG-SEAN.md at the root is one `git add .` away from being
+ *  committed, and the report folder can carry findings about a live system.
+ *  Ignore them locally, in .git/info/exclude, so we never edit a file the
+ *  repository tracks. */
+async function ignoreArtifacts(root, log) {
+    const marker = "# added by @bigsteele/the-big-sean";
+    const entries = ["THE-BIG-SEAN.md", ".planning/launch-audit/", "The Big Sean - *.md", "The Big Sean - *.html"];
+    const exclude = join(root, ".git", "info", "exclude");
+    try {
+        let current = "";
+        try {
+            current = await readFile(exclude, "utf8");
+        }
+        catch { /* no exclude file yet */ }
+        if (current.includes(marker))
+            return;
+        const missing = entries.filter((e) => !current.split("\n").some((l) => l.trim() === e));
+        if (missing.length === 0)
+            return;
+        const addition = `${current.endsWith("\n") || current === "" ? "" : "\n"}${marker}\n${missing.join("\n")}\n`;
+        await writeFile(exclude, current + addition, "utf8");
+        log(`Ignored locally (.git/info/exclude): ${missing.join(", ")}`);
+    }
+    catch {
+        log(`Note: not a git repository, or .git/info/exclude is unwritable. THE-BIG-SEAN.md and .planning/launch-audit/ are untracked; add them to .gitignore before you commit.`);
+    }
+}
 async function writeProtocol(root, log) {
     const file = join(root, "THE-BIG-SEAN.md");
     await writeFile(file, await loadPrompt(), "utf8");
+    await ignoreArtifacts(root, log);
     log(`Wrote ${file}`);
     log(``);
     log(WARNING);
     log(``);
+    log(``);
+    log(`What just ran is the AI Audit: a deterministic file scan, seconds, no model involved.`);
+    log(`The report card is the other half, and it is a long agent session, not a scan.`);
     log(`Next: open Claude Code in this folder and paste the whole file in (or run big-sean --run).`);
     log(`When it finishes, "The Big Sean - <App Name>.md" and .html are at the repo root and the card opens itself.`);
     log(`Then prove the number:   big-sean --check`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bigsteele/the-big-sean",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "The Big Sean: the Launch Report Card, by Big Steele and LaSean Pickens. Runs the Big Steele AI Audit, drops a 140-check launch-readiness and autonomy audit protocol into a repo for Claude Code to run, names the deliverable after the app, and independently re-computes any report's math from its grade.json so the number on the card can be proven, not trusted.",
   "type": "module",
   "license": "UNLICENSED",