@alecsibilia/luca 13.0.0-alpha.9 → 13.0.0

package/dist/chunks/brain.mjs

@@ -0,0 +1,77 @@
+import { defineCommand } from 'citty';
+import { r as rejectUnknownFlags, a as runWriteHandler } from '../shared/luca.CIYP8N2e.mjs';
+import 'zod';
+import '../shared/luca.CWvhdASW.mjs';
+import 'node:fs';
+import 'node:fs/promises';
+import 'node:path';
+import 'node:crypto';
+import 'node:module';
+import 'node:url';
+import 'node:child_process';
+import { t as lucaBrainRecallRootTool, u as lucaBrainSetRootTool } from '../shared/luca.E5xdUA-2.mjs';
+import '../shared/luca.LXh1v8zr.mjs';
+import '../shared/luca.raYjreBY.mjs';
+import 'node:os';
+import '../shared/luca.CQ3g1xrD.mjs';
+import '../shared/luca.Dqloj2-2.mjs';
+import '../shared/luca.DdFkobL1.mjs';
+import '../shared/luca.BpClq9Sj.mjs';
+import '../shared/luca.F3D90t11.mjs';
+
+const setRootCommand = defineCommand({
+  meta: {
+    name: "set-root",
+    description: "Persist a brain tree root engram ULID (returned by muninn_remember_tree) to .luca/config.json#muninn.brainRoots for the current vault. Local write \u2014 run once per brain tree at creation (project-new / seed-memory) so readers resolve the root by ULID. Phase-agnostic."
+  },
+  args: {
+    concept: {
+      type: "string",
+      required: true,
+      description: 'The brain tree root concept (e.g. "brain:project-identity", "brain:project-requirements").'
+    },
+    id: {
+      type: "string",
+      required: true,
+      description: "The brain tree root engram ULID (the root_id returned by muninn_remember_tree)."
+    }
+  },
+  async run({ args, rawArgs, cmd }) {
+    rejectUnknownFlags("brain set-root", cmd, rawArgs);
+    await runWriteHandler("brain set-root", lucaBrainSetRootTool, {
+      concept: args.concept,
+      id: args.id
+    });
+  }
+});
+const recallRootCommand = defineCommand({
+  meta: {
+    name: "recall-root",
+    description: 'Emit a muninn_recall_tree procedure for a brain tree, resolved by its cached root ULID (replaces the broken recall_tree(id="brain:project-identity")). Uninitialized \u2192 a plain notice. Phase-agnostic.'
+  },
+  args: {
+    concept: {
+      type: "string",
+      required: true,
+      description: 'The brain tree root concept to recall (e.g. "brain:project-identity").'
+    }
+  },
+  async run({ args, rawArgs, cmd }) {
+    rejectUnknownFlags("brain recall-root", cmd, rawArgs);
+    await runWriteHandler("brain recall-root", lucaBrainRecallRootTool, {
+      concept: args.concept
+    });
+  }
+});
+const brainCommand = defineCommand({
+  meta: {
+    name: "brain",
+    description: "Resolve MuninnDB brain trees (project identity) by cached root ULID"
+  },
+  subCommands: {
+    "set-root": setRootCommand,
+    "recall-root": recallRootCommand
+  }
+});
+
+export { brainCommand };

package/dist/chunks/branch.mjs

@@ -1,6 +1,7 @@
 import { defineCommand } from 'citty';
+import { r as rejectUnknownFlags, a as runWriteHandler } from '../shared/luca.CIYP8N2e.mjs';
 import 'zod';
-import '../shared/luca.DhWPHlqL.mjs';
+import '../shared/luca.CWvhdASW.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +9,15 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { r as runWriteHandler, u as lucaBranchGuardTool } from '../shared/luca.Cah4kvKS.mjs';
-import '../shared/luca.CvfK4ZaL.mjs';
+import { A as lucaBranchGuardTool } from '../shared/luca.E5xdUA-2.mjs';
+import '../shared/luca.LXh1v8zr.mjs';
+import '../shared/luca.raYjreBY.mjs';
 import 'node:os';
-import '../shared/luca.BiCFpsE9.mjs';
-import '../shared/luca.CgZgNO4A.mjs';
-import '../shared/luca.Dtt-5Dh0.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
+import '../shared/luca.Dqloj2-2.mjs';
+import '../shared/luca.DdFkobL1.mjs';
+import '../shared/luca.BpClq9Sj.mjs';
+import '../shared/luca.F3D90t11.mjs';
 
 const guardCommand = defineCommand({
   meta: {
@@ -28,7 +31,8 @@ const guardCommand = defineCommand({
       description: 'Branch name that must NOT equal the current branch (typically the repository default branch, default "main").'
     }
   },
-  async run({ args }) {
+  async run({ args, rawArgs, cmd }) {
+    rejectUnknownFlags("branch guard", cmd, rawArgs);
     await runWriteHandler("branch guard", lucaBranchGuardTool, {
       default_branch: args["default-branch"]
     });

package/dist/chunks/checks.mjs

@@ -1,6 +1,7 @@
 import { defineCommand } from 'citty';
+import { r as rejectUnknownFlags, b as readJsonPayload, a as runWriteHandler } from '../shared/luca.CIYP8N2e.mjs';
 import 'zod';
-import '../shared/luca.DhWPHlqL.mjs';
+import '../shared/luca.CWvhdASW.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +9,15 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { f as readJsonPayload, r as runWriteHandler, t as lucaChecksRunTool } from '../shared/luca.Cah4kvKS.mjs';
-import '../shared/luca.CvfK4ZaL.mjs';
+import { z as lucaChecksRunTool } from '../shared/luca.E5xdUA-2.mjs';
+import '../shared/luca.LXh1v8zr.mjs';
+import '../shared/luca.raYjreBY.mjs';
 import 'node:os';
-import '../shared/luca.BiCFpsE9.mjs';
-import '../shared/luca.CgZgNO4A.mjs';
-import '../shared/luca.Dtt-5Dh0.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
+import '../shared/luca.Dqloj2-2.mjs';
+import '../shared/luca.DdFkobL1.mjs';
+import '../shared/luca.BpClq9Sj.mjs';
+import '../shared/luca.F3D90t11.mjs';
 
 const runCommand = defineCommand({
   meta: {
@@ -32,7 +35,8 @@ const runCommand = defineCommand({
       description: "Per-command timeout in milliseconds (range 100-600000, default 90000). On timeout the process is killed."
     }
   },
-  async run({ args }) {
+  async run({ args, rawArgs, cmd }) {
+    rejectUnknownFlags("checks run", cmd, rawArgs);
     const commands = await readJsonPayload("checks run", args.file);
     await runWriteHandler("checks run", lucaChecksRunTool, {
       commands,

package/dist/chunks/claim-verify.mjs

@@ -1,420 +1,19 @@
-import { defineCommand } from 'citty';
-import { resolve } from 'pathe';
-import '../shared/luca.DhWPHlqL.mjs';
-import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
+import { v as verifyFile } from '../shared/luca.CWvhdASW.mjs';
+import 'node:fs';
 import 'node:fs/promises';
-import { join } from 'node:path';
+import 'node:path';
 import 'node:crypto';
 import 'node:module';
 import 'node:url';
-import { spawnSync } from 'node:child_process';
+import 'node:child_process';
+import { defineCommand } from 'citty';
+import { resolve } from 'pathe';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
+import { s as sanitizeControlChars } from '../shared/luca.BpClq9Sj.mjs';
 import 'zod';
 import 'node:os';
 import 'consola';
 
-const SYMBOL_STOPWORDS = /* @__PURE__ */ new Set([
-  "true",
-  "false",
-  "null",
-  "undefined",
-  "void",
-  "any",
-  "unknown",
-  "never",
-  "string",
-  "number",
-  "boolean",
-  "object",
-  "array",
-  "bun",
-  "npm",
-  "pnpm",
-  "yarn",
-  "git",
-  "gh",
-  "pr",
-  "ci",
-  "cd",
-  "repo",
-  "main",
-  "master",
-  "dev",
-  "build",
-  "test",
-  "lint",
-  "tsc",
-  "eslint",
-  "todo",
-  "fixme",
-  "note",
-  "warn",
-  "info",
-  "log",
-  "http",
-  "https",
-  "json",
-  "yaml",
-  "toml",
-  "env",
-  "src",
-  "dist",
-  "lib",
-  "app",
-  "apps"
-]);
-const COUNTABLE_NOUNS = /* @__PURE__ */ new Set([
-  "file",
-  "files",
-  "test",
-  "tests",
-  "table",
-  "tables",
-  "index",
-  "indexes",
-  "indices",
-  "function",
-  "functions",
-  "endpoint",
-  "endpoints",
-  "route",
-  "routes",
-  "mutation",
-  "mutations",
-  "query",
-  "queries",
-  "action",
-  "actions",
-  "tool",
-  "tools",
-  "mode",
-  "modes",
-  "phase",
-  "phases",
-  "wave",
-  "waves",
-  "commit",
-  "commits",
-  "package",
-  "packages",
-  "module",
-  "modules",
-  "class",
-  "classes",
-  "method",
-  "methods",
-  "component",
-  "components",
-  "hook",
-  "hooks"
-]);
-function singularize(noun) {
-  const lower = noun.toLowerCase();
-  if (lower === "indices") return "index";
-  if (lower === "queries") return "query";
-  if (lower === "classes") return "class";
-  if (lower === "indexes") return "index";
-  if (lower.endsWith("ies") && lower.length > 3) {
-    return `${lower.slice(0, -3)}y`;
-  }
-  if (lower.endsWith("s") && !lower.endsWith("ss")) return lower.slice(0, -1);
-  return lower;
-}
-const BACKTICK_RE = /`([^`\n]+)`/g;
-const FILE_PATH_RE = /(?:^|[\s(`'"])((?:packages|src|apps|lib|tests?|docs?|\.planning|\.luca|\.changeset|\.github)\/[\w./-]+\.[\w]+)(?=[\s)`'".,;!?]|$)/g;
-const QUANTITATIVE_RE = /\b(\d+)\s+([a-zA-Z]+)\b/g;
-const IDENTIFIER_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
-function extractClaims(text) {
-  if (!text) return [];
-  const lines = text.split("\n");
-  const seen = /* @__PURE__ */ new Set();
-  const claims = [];
-  const pushIfNew = (key, claim) => {
-    if (seen.has(key)) return;
-    seen.add(key);
-    claims.push(claim);
-  };
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    const sourceLine = i + 1;
-    const sourceContext = line.trim().slice(0, 240);
-    for (const match of line.matchAll(BACKTICK_RE)) {
-      const inner = (match[1] ?? "").trim();
-      if (inner.includes("/") && /\.\w+(?:[#?:]|$)/.test(inner)) continue;
-      if (!IDENTIFIER_RE.test(inner)) continue;
-      if (inner.length < 3) continue;
-      if (SYMBOL_STOPWORDS.has(inner.toLowerCase())) continue;
-      pushIfNew(`symbol:${inner}`, {
-        type: "symbol",
-        text: match[0],
-        identifier: inner,
-        sourceLine,
-        sourceContext
-      });
-    }
-    for (const match of line.matchAll(FILE_PATH_RE)) {
-      const path = match[1];
-      if (!path) continue;
-      pushIfNew(`path:${path}`, {
-        type: "file-path",
-        text: path,
-        path,
-        sourceLine,
-        sourceContext
-      });
-    }
-    for (const match of line.matchAll(QUANTITATIVE_RE)) {
-      const numStr = match[1];
-      const noun = match[2];
-      if (!numStr || !noun) continue;
-      if (numStr.length === 4) {
-        const n = Number(numStr);
-        if (n >= 1900 && n <= 2200) continue;
-      }
-      const lowerNoun = noun.toLowerCase();
-      if (!COUNTABLE_NOUNS.has(lowerNoun)) continue;
-      const num = Number(numStr);
-      if (!Number.isFinite(num)) continue;
-      pushIfNew(`count:${num}:${lowerNoun}`, {
-        type: "quantitative",
-        text: `${numStr} ${noun}`,
-        number: num,
-        noun: singularize(lowerNoun),
-        sourceLine,
-        sourceContext
-      });
-    }
-  }
-  return claims;
-}
-function gitAvailable(repoRoot) {
-  const r = spawnSync(
-    "git",
-    ["-C", repoRoot, "rev-parse", "--is-inside-work-tree"],
-    { encoding: "utf-8" }
-  );
-  return r.status === 0;
-}
-function gitGrepFiles(repoRoot, needle, timeoutMs) {
-  const r = spawnSync(
-    "git",
-    ["-C", repoRoot, "grep", "--untracked", "-l", "--fixed-strings", needle],
-    { encoding: "utf-8", timeout: timeoutMs }
-  );
-  if (r.signal === "SIGTERM" || r.error?.message?.includes("ETIMEDOUT")) {
-    return { ok: false, matchedFiles: [], timedOut: true };
-  }
-  if (r.status === 1) return { ok: true, matchedFiles: [], timedOut: false };
-  if (r.status !== 0) return { ok: false, matchedFiles: [], timedOut: false };
-  const matchedFiles = (r.stdout ?? "").split("\n").map((s) => s.trim()).filter(Boolean);
-  return { ok: true, matchedFiles, timedOut: false };
-}
-const FS_SKIP_DIRS = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".git",
-  "dist",
-  "build",
-  ".next",
-  ".turbo",
-  "coverage",
-  ".cache"
-]);
-const FS_SKIP_EXTENSIONS = /* @__PURE__ */ new Set([
-  ".png",
-  ".jpg",
-  ".jpeg",
-  ".gif",
-  ".webp",
-  ".ico",
-  ".pdf",
-  ".zip",
-  ".tar",
-  ".gz",
-  ".lock",
-  ".lockb"
-]);
-const FS_MAX_FILE_BYTES = 5 * 1024 * 1024;
-function fsGrepFiles(repoRoot, needle, timeoutMs) {
-  const start = Date.now();
-  const matchedFiles = [];
-  const stack = [repoRoot];
-  while (stack.length > 0) {
-    if (Date.now() - start > timeoutMs) {
-      return { ok: false, matchedFiles, timedOut: true };
-    }
-    const dir = stack.pop();
-    if (dir === void 0) break;
-    let entries;
-    try {
-      entries = readdirSync(dir);
-    } catch {
-      continue;
-    }
-    for (const name of entries) {
-      const full = join(dir, name);
-      let info;
-      try {
-        info = statSync(full);
-      } catch {
-        continue;
-      }
-      if (info.isDirectory()) {
-        if (FS_SKIP_DIRS.has(name)) continue;
-        stack.push(full);
-        continue;
-      }
-      if (!info.isFile()) continue;
-      const dotIdx = name.lastIndexOf(".");
-      if (dotIdx >= 0) {
-        const ext = name.slice(dotIdx).toLowerCase();
-        if (FS_SKIP_EXTENSIONS.has(ext)) continue;
-      }
-      if (info.size > FS_MAX_FILE_BYTES) continue;
-      try {
-        if (readFileSync(full).includes(needle)) {
-          matchedFiles.push(full);
-        }
-      } catch {
-      }
-    }
-  }
-  return { ok: true, matchedFiles, timedOut: false };
-}
-function searchFiles(repoRoot, needle, timeoutMs, useGit) {
-  return useGit ? gitGrepFiles(repoRoot, needle, timeoutMs) : fsGrepFiles(repoRoot, needle, timeoutMs);
-}
-function verifyClaims(claims, opts) {
-  const totalBudgetMs = opts.totalBudgetMs ?? 3e4;
-  const perClaimBudgetMs = opts.perClaimBudgetMs ?? 5e3;
-  const useGit = gitAvailable(opts.repoRoot);
-  const start = Date.now();
-  const failures = [];
-  let timedOut = false;
-  const breakdown = { symbols: 0, filePaths: 0, quantitative: 0 };
-  for (const claim of claims) {
-    if (claim.type === "symbol") breakdown.symbols++;
-    else if (claim.type === "file-path") breakdown.filePaths++;
-    else breakdown.quantitative++;
-    if (Date.now() - start > totalBudgetMs) {
-      timedOut = true;
-      failures.push({
-        claim,
-        reason: "timeout",
-        evidence: `Total budget ${totalBudgetMs}ms exhausted before this claim was checked.`
-      });
-      continue;
-    }
-    if (claim.type === "symbol" && claim.identifier) {
-      const r = searchFiles(
-        opts.repoRoot,
-        claim.identifier,
-        perClaimBudgetMs,
-        useGit
-      );
-      if (r.timedOut) {
-        timedOut = true;
-        failures.push({
-          claim,
-          reason: "timeout",
-          evidence: `Search for symbol "${claim.identifier}" exceeded ${perClaimBudgetMs}ms.`
-        });
-        continue;
-      }
-      if (!r.ok || r.matchedFiles.length === 0) {
-        failures.push({
-          claim,
-          reason: "symbol-not-found",
-          evidence: `git grep for "${claim.identifier}" returned 0 hits.`
-        });
-      }
-      continue;
-    }
-    if (claim.type === "file-path" && claim.path) {
-      const abs = join(opts.repoRoot, claim.path);
-      if (!existsSync(abs)) {
-        failures.push({
-          claim,
-          reason: "file-not-found",
-          evidence: `Path "${claim.path}" does not exist (resolved to ${abs}).`
-        });
-      }
-      continue;
-    }
-    if (claim.type === "quantitative" && claim.noun && typeof claim.number === "number") {
-      const r = searchFiles(
-        opts.repoRoot,
-        claim.noun,
-        perClaimBudgetMs,
-        useGit
-      );
-      if (r.timedOut) {
-        timedOut = true;
-        failures.push({
-          claim,
-          reason: "timeout",
-          evidence: `Search for noun "${claim.noun}" exceeded ${perClaimBudgetMs}ms.`
-        });
-        continue;
-      }
-      if (!r.ok) {
-        failures.push({
-          claim,
-          reason: "count-mismatch",
-          evidence: `grep for "${claim.noun}" failed; cannot verify "${claim.text}".`
-        });
-        continue;
-      }
-      const found = r.matchedFiles.length;
-      if (Math.abs(found - claim.number) > 1) {
-        failures.push({
-          claim,
-          reason: "count-mismatch",
-          evidence: `Claim says "${claim.text}", repo has ${found} file(s) mentioning "${claim.noun}" (tolerance \xB11).`
-        });
-      }
-      continue;
-    }
-  }
-  return {
-    passed: failures.length === 0,
-    totalClaims: claims.length,
-    failures,
-    extractedBreakdown: breakdown,
-    timedOut
-  };
-}
-function verifyTextArtifact(text, opts) {
-  return verifyClaims(extractClaims(text), opts);
-}
-function verifyFile(filePath, opts) {
-  let text;
-  try {
-    text = readFileSync(filePath, "utf-8");
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return {
-      passed: false,
-      totalClaims: 0,
-      failures: [
-        {
-          claim: {
-            type: "file-path",
-            text: filePath,
-            path: filePath,
-            sourceLine: 0,
-            sourceContext: ""
-          },
-          reason: "artifact-unreadable",
-          evidence: `Could not read "${filePath}": ${msg}`
-        }
-      ],
-      extractedBreakdown: { symbols: 0, filePaths: 0, quantitative: 0 },
-      timedOut: false
-    };
-  }
-  return verifyTextArtifact(text, opts);
-}
-
 const claimVerifyCommand = defineCommand({
   meta: {
     name: "claim-verify",
@@ -446,8 +45,14 @@ const claimVerifyCommand = defineCommand({
     for (const failure of report.failures) {
       const loc = failure.claim.sourceLine > 0 ? ` (line ${failure.claim.sourceLine})` : "";
       logger.error(
-        `${failure.reason}: ${failure.claim.text}${loc}
-  ${failure.evidence}`
+        `${failure.reason}: ${sanitizeControlChars(failure.claim.text)}${loc}
+  ${sanitizeControlChars(failure.evidence)}`
+      );
+    }
+    for (const warning of report.forbiddenLanguage) {
+      logger.warn(
+        `forbidden-language: "${warning.phrase}" (line ${warning.sourceLine}) has no nearby probe evidence
+  ${sanitizeControlChars(warning.sourceContext)}`
       );
     }
     if (report.passed) {

package/dist/chunks/classify.mjs

@@ -1,5 +1,4 @@
-import { defineCommand } from 'citty';
-import { C as ClassifyComplexityInputSchema } from '../shared/luca.DhWPHlqL.mjs';
+import { C as ClassifyComplexityInputSchema } from '../shared/luca.CWvhdASW.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -7,6 +6,7 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
+import { defineCommand } from 'citty';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
 import 'zod';
 import 'node:os';