@grainulation/wheat 1.0.3 → 1.0.4

package/lib/install-prompt.js

@@ -13,12 +13,12 @@
  * nudging. This is an unclaimed UX innovation.
  */
 
-import { readFileSync, writeFileSync, mkdirSync } from 'fs';
-import path from 'path';
-import { homedir } from 'os';
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import path from "path";
+import { homedir } from "os";
 
-const USAGE_DIR = path.join(homedir(), '.grainulation');
-const USAGE_FILE = path.join(USAGE_DIR, 'usage.json');
+const USAGE_DIR = path.join(homedir(), ".grainulation");
+const USAGE_FILE = path.join(USAGE_DIR, "usage.json");
 
 const THRESHOLDS = {
   suggest_global: 3,
@@ -30,7 +30,7 @@ const THRESHOLDS = {
 
 function readUsage() {
   try {
-    return JSON.parse(readFileSync(USAGE_FILE, 'utf8'));
+    return JSON.parse(readFileSync(USAGE_FILE, "utf8"));
   } catch {
     return { commands: {}, prompted: false, installed: false };
   }
@@ -39,7 +39,7 @@ function readUsage() {
 function writeUsage(data) {
   try {
     mkdirSync(USAGE_DIR, { recursive: true });
-    writeFileSync(USAGE_FILE, JSON.stringify(data, null, 2) + '\n', 'utf8');
+    writeFileSync(USAGE_FILE, JSON.stringify(data, null, 2) + "\n", "utf8");
   } catch {
     // fail silently
   }
@@ -50,8 +50,8 @@ function writeUsage(data) {
  * npx stores executables in a temporary _npx cache directory.
  */
 function isNpxInvocation() {
-  const execPath = process.argv[1] || '';
-  return execPath.includes('_npx');
+  const execPath = process.argv[1] || "";
+  return execPath.includes("_npx");
 }
 
 /**
@@ -66,23 +66,23 @@ function isNpxInvocation() {
  * (isNpxInvocation returns false, so prompts are already suppressed).
  */
 function isInstalled() {
-  const execPath = process.argv[1] || '';
+  const execPath = process.argv[1] || "";
 
   // Local install: running from node_modules
-  if (execPath.includes('node_modules') && !execPath.includes('_npx')) {
+  if (execPath.includes("node_modules") && !execPath.includes("_npx")) {
     return true;
   }
 
   // Global install: binary is in a well-known global prefix
   // (not npx, not node_modules — must be a permanent install)
-  if (!execPath.includes('_npx') && !execPath.includes('node_modules')) {
+  if (!execPath.includes("_npx") && !execPath.includes("node_modules")) {
     const knownGlobalDirs = [
-      '/usr/local/bin',
-      '/usr/bin',
-      path.join(homedir(), '.npm-global'),
-      path.join(homedir(), '.nvm'),
-      path.join(homedir(), '.volta'),
-      path.join(homedir(), '.local', 'bin'),
+      "/usr/local/bin",
+      "/usr/bin",
+      path.join(homedir(), ".npm-global"),
+      path.join(homedir(), ".nvm"),
+      path.join(homedir(), ".volta"),
+      path.join(homedir(), ".local", "bin"),
     ];
     for (const prefix of knownGlobalDirs) {
       if (execPath.startsWith(prefix)) return true;
@@ -141,8 +141,8 @@ export function track(command) {
  */
 export function maybePrompt(command) {
   try {
-    if (process.env.WHEAT_NO_INSTALL_PROMPT === '1') return;
-    if (process.argv.includes('--quiet')) return;
+    if (process.env.WHEAT_NO_INSTALL_PROMPT === "1") return;
+    if (process.argv.includes("--quiet")) return;
     if (isInstalled()) return;
     if (!isNpxInvocation()) return;
     if (!command) return;
@@ -162,22 +162,22 @@ export function maybePrompt(command) {
       // 10+ invocations: more visible, but still non-blocking
       process.stderr.write(
         `\n  wheat: You've used npx ${total} times (${command}: ${count}).` +
-        `\n         Install for instant startup and offline use:` +
-        `\n           npm i -g @grainulation/wheat    (global)` +
-        `\n           npm i -D @grainulation/wheat    (project dev dep)\n\n`
+          `\n         Install for instant startup and offline use:` +
+          `\n           npm i -g @grainulation/wheat    (global)` +
+          `\n           npm i -D @grainulation/wheat    (project dev dep)\n\n`
       );
     } else if (effective >= THRESHOLDS.suggest_local) {
       // 5-9 invocations: suggest both global and local
       process.stderr.write(
         `  wheat: You've run wheat via npx ${total} times. ` +
-        `For instant startup: npm i -g @grainulation/wheat\n` +
-        `  Or add to this project: npm i -D @grainulation/wheat\n`
+          `For instant startup: npm i -g @grainulation/wheat\n` +
+          `  Or add to this project: npm i -D @grainulation/wheat\n`
       );
     } else if (effective >= THRESHOLDS.suggest_global) {
       // 3-4 invocations: one-liner, suggest global only
       process.stderr.write(
         `  wheat: You've run wheat via npx ${count} times. ` +
-        `For instant startup: npm i -g @grainulation/wheat\n`
+          `For instant startup: npm i -g @grainulation/wheat\n`
       );
     }
   } catch {

package/lib/load-claims.js

@@ -0,0 +1,88 @@
+/**
+ * Shared claims.json loader with schema migration
+ *
+ * All consumers that read claims.json should use this helper to ensure
+ * the data is migrated to the current schema version before processing.
+ *
+ * Zero npm dependencies.
+ */
+
+import fs from "fs";
+import path from "path";
+import { checkAndMigrateSchema } from "../compiler/wheat-compiler.js";
+
+/**
+ * Load and migrate claims.json from a directory.
+ *
+ * @param {string} dir - Directory containing claims.json
+ * @param {object} [opts] - Options
+ * @param {string} [opts.filename='claims.json'] - Claims filename override
+ * @returns {{ data: object|null, errors: Array<{code: string, message: string}>, path: string }}
+ *   - data: the full claims object (with schema_version, meta, claims) or null if file missing/invalid
+ *   - errors: migration errors (empty array on success)
+ *   - path: resolved file path
+ */
+export function loadClaims(dir, opts = {}) {
+  const filename = opts.filename || "claims.json";
+  const claimsPath = path.join(dir, filename);
+
+  if (!fs.existsSync(claimsPath)) {
+    return { data: null, errors: [], path: claimsPath };
+  }
+
+  let raw;
+  try {
+    raw = fs.readFileSync(claimsPath, "utf8");
+  } catch (err) {
+    return {
+      data: null,
+      errors: [
+        {
+          code: "E_READ",
+          message: `Failed to read ${filename}: ${err.message}`,
+        },
+      ],
+      path: claimsPath,
+    };
+  }
+
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    return {
+      data: null,
+      errors: [
+        {
+          code: "E_PARSE",
+          message: `${filename} is not valid JSON: ${err.message}`,
+        },
+      ],
+      path: claimsPath,
+    };
+  }
+
+  // Run schema migration
+  const result = checkAndMigrateSchema(parsed);
+
+  // Write migrated data back to disk so downstream tools that read the file
+  // directly (bypassing loadClaims) see the current schema version.
+  // Only write if migration actually changed something (avoid unnecessary I/O).
+  if (result.errors.length === 0 && result.data) {
+    const migrated = JSON.stringify(result.data, null, 2);
+    if (migrated !== raw) {
+      try {
+        fs.writeFileSync(claimsPath, migrated + "\n", "utf8");
+      } catch (err) {
+        // Non-fatal: migration write-back failure should not block reads.
+        // The in-memory data is still correct.
+      }
+    }
+  }
+
+  return {
+    data: result.errors.length > 0 ? null : result.data,
+    errors: result.errors,
+    path: claimsPath,
+  };
+}