@garygentry/system1 0.3.2 → 0.4.1

package/dist/bundle/chunks/{chunk-5LVOFZF3.mjs → chunk-FU3D2MBS.mjs}

@@ -87,20 +87,48 @@ function briefSpecCheck(r) {
     }
   }
   lines.push(...withheld(r.skipped, { total: 0, items: 0 }));
+  if (r.lint.length) {
+    lines.push(
+      `lint: ${r.lint.length} finding(s), not part of PASSED/FAILED (decide spec lint ${r.spec})`
+    );
+    lines.push(...r.lint.map(briefFinding));
+  }
   return lines.join("\n");
 }
+function briefSpecLint(r) {
+  const c = r.counts;
+  const lines = [
+    `decide spec lint: ${r.passed ? "PASSED" : "FAILED"} \xB7 ${c.specs} spec(s) \xB7 ${c.errors} error(s) \xB7 ${c.warnings} warning(s)${c.invalid ? ` \xB7 ${c.invalid} invalid` : ""}`
+  ];
+  for (const s of r.specs) {
+    if (s.invalid) lines.push(`  INVALID  ${s.name}  ${s.invalid.split("\n")[0]}`);
+    else if (s.findings.length === 0) lines.push(`  ok  ${s.name}`);
+    else {
+      lines.push(`  ${s.name}  (${s.file})`);
+      lines.push(...s.findings.map(briefFinding));
+    }
+  }
+  return lines.join("\n");
+}
+function briefFinding(f) {
+  return `    ${f.severity} ${f.check}: ${f.message}
+      fix: ${f.fix}`;
+}
 function distribution(probabilities) {
   return Object.entries(probabilities).sort((a, b) => b[1] - a[1]).map(([k, p]) => `${k} ${fix(p)}`).join(" \xB7 ");
 }
 function withheld(skipped, redactions) {
   const lines = [];
-  if (skipped.total > 0) {
-    const reasons = Object.entries(skipped.byReason).map(([k, v]) => `${k} ${v}`).join(", ");
+  const filtered = skipped.byReason.filtered ?? 0;
+  const held = skipped.total - filtered;
+  if (held > 0) {
+    const reasons = Object.entries(skipped.byReason).filter(([k]) => k !== "filtered").map(([k, v]) => `${k} ${v}`).join(", ");
     const excluded = skipped.sample.filter((s) => s.reason === "excluded").map((s) => s.path);
     lines.push(
-      `withheld: ${skipped.total} (${reasons})${excluded.length ? ` e.g. ${excluded.join(", ")}` : ""}`
+      `withheld: ${held} (${reasons})${excluded.length ? ` e.g. ${excluded.join(", ")}` : ""}`
     );
   }
+  if (filtered > 0) lines.push(`left out by --exclude: ${filtered}`);
   if (redactions.total > 0)
     lines.push(
       `redacted: ${redactions.total} secret(s) in ${redactions.items} item(s) before sending`
@@ -126,5 +154,6 @@ function firstLine(text) {
 export {
   briefMany,
   briefAsk,
-  briefSpecCheck
+  briefSpecCheck,
+  briefSpecLint
 };

package/dist/bundle/chunks/{config-UUPD2JL4.mjs → config-7OESN6WC.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
 import {
   typedParse
-} from "./chunk-BGL272OK.mjs";
+} from "./chunk-A7OWKSHE.mjs";
 import {
   DEFAULT_EXCLUDES,
   activeTriggers,
@@ -10,11 +10,11 @@ import {
   loadConfig,
   repoConfigPath,
   setConsent
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-CUKOJ7OM.mjs";
 import {
   DecisionsError,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-B62DSXC3.mjs";
 
 // src/commands/config.ts
 function runConfigCommand(argv, io, format) {

package/dist/bundle/chunks/{decide-AAXD3ITT.mjs → decide-QXDMZDNT.mjs}

@@ -2,21 +2,21 @@ import { createRequire as __decideRequire } from "node:module"; const require =
 import {
   briefAsk,
   briefMany
-} from "./chunk-5LVOFZF3.mjs";
+} from "./chunk-FU3D2MBS.mjs";
 import {
   buildInput,
   parseDecideFlags
-} from "./chunk-BGL272OK.mjs";
+} from "./chunk-A7OWKSHE.mjs";
 import {
   createContext,
   runAsk,
   runMany
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-CUKOJ7OM.mjs";
 import {
   DecisionsError,
   ENVELOPE_VERSION,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-B62DSXC3.mjs";
 
 // src/commands/decide.ts
 import { readFileSync } from "node:fs";

package/dist/bundle/chunks/{doctor-KPJ5KVLS.mjs → doctor-EXJQQ7NY.mjs}

@@ -1,10 +1,10 @@
 import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
 import {
   runDoctor
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-CUKOJ7OM.mjs";
 import {
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-B62DSXC3.mjs";
 
 // src/commands/doctor.ts
 import { execFile } from "node:child_process";
@@ -35,7 +35,7 @@ function brief(r) {
 }
 function headline(r) {
   if (!r.healthy) return "PROBLEMS FOUND";
-  const missing = r.checks.filter((c) => c.status === "warn").map((c) => c.name);
+  const missing = r.checks.filter((c) => c.status === "warn" && !c.advisory).map((c) => c.name);
   return !r.live && missing.length > 0 ? `SETUP NEEDED (${missing.join(", ")})` : "healthy";
 }
 function probeVersion(path, env, timeoutMs = 2e3) {

package/dist/bundle/chunks/{misc-IW4I3SO6.mjs → misc-2SNIZHU6.mjs}

@@ -1,7 +1,7 @@
 import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
 import {
   typedParse
-} from "./chunk-BGL272OK.mjs";
+} from "./chunk-A7OWKSHE.mjs";
 import {
   TOOL_SCHEMAS,
   createContext,
@@ -10,13 +10,13 @@ import {
   probeUrl,
   resolveConnection,
   runUsage
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-CUKOJ7OM.mjs";
 import {
   DecisionsError,
   EXIT,
   emit,
   isDecisionsError
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-B62DSXC3.mjs";
 
 // src/commands/misc.ts
 function runSchemaCommand(argv, io, format) {

package/dist/bundle/chunks/opportunities-I6VON6X7.mjs

@@ -0,0 +1,144 @@
+import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
+import {
+  typedParse
+} from "./chunk-A7OWKSHE.mjs";
+import {
+  createContext,
+  runOpportunitiesAdd,
+  runOpportunitiesCheck,
+  runOpportunitiesList
+} from "./chunk-CUKOJ7OM.mjs";
+import {
+  DecisionsError,
+  emit
+} from "./chunk-B62DSXC3.mjs";
+
+// src/commands/opportunities.ts
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+var OPPORTUNITIES_OPTIONS = {
+  file: { type: "string" },
+  keep: { type: "string", multiple: true },
+  sort: { type: "string" },
+  limit: { type: "string" },
+  fields: { type: "string" }
+};
+var USAGE = "Usage: decide opportunities add --file <candidates.json> | list [--keep \u2026] [--sort \u2026] [--limit N] [--fields a,b] | check";
+function runOpportunitiesCommand(argv, io, format) {
+  const [action, ...rest] = argv;
+  const ctx = () => createContext({ ...io, cwd: io.cwd ?? process.cwd(), env: io.env });
+  const cwd = io.cwd ?? process.cwd();
+  switch (action) {
+    case "add":
+      return emit(
+        io,
+        "opportunities",
+        format,
+        () => {
+          const { values } = parse(rest, ["file"]);
+          if (!values.file) throw new DecisionsError("invalid-request", USAGE);
+          return runOpportunitiesAdd(ctx(), {
+            candidates: readCandidates(resolve(cwd, values.file), values.file)
+          });
+        },
+        (r, f) => f === "brief" ? `decide opportunities add: ${r.added.length} added \xB7 ${r.updated.length} updated \xB7 ${r.staled.length} marked stale \xB7 ${r.total} in ${r.file}` : void 0
+      );
+    case "list":
+      return emit(
+        io,
+        "opportunities",
+        format,
+        () => {
+          const { values } = parse(rest, ["keep", "sort", "limit", "fields"]);
+          if (values.limit !== void 0 && !/^\d+$/.test(values.limit)) {
+            throw new DecisionsError("invalid-request", "--limit must be a whole number");
+          }
+          return runOpportunitiesList(ctx(), {
+            ...values.keep?.length ? { keep: values.keep } : {},
+            ...values.sort ? { sort: values.sort } : {},
+            ...values.limit !== void 0 ? { limit: Number(values.limit) } : {},
+            ...values.fields ? {
+              fields: values.fields.split(",").map((s) => s.trim()).filter(Boolean)
+            } : {}
+          });
+        },
+        (r, f) => f === "brief" ? briefList(r) : void 0
+      );
+    case "check":
+      return emit(
+        io,
+        "opportunities",
+        format,
+        () => {
+          parse(rest, []);
+          return runOpportunitiesCheck(ctx());
+        },
+        (r, f) => f === "brief" ? r.exists ? `decide opportunities check: valid \xB7 ${r.entries} entr${r.entries === 1 ? "y" : "ies"}${Object.keys(r.byStatus).length ? ` (${Object.entries(r.byStatus).map(([s, n]) => `${n} ${s}`).join(", ")})` : ""} \xB7 ${r.file}` : `decide opportunities check: no backlog yet (${r.file})` : void 0
+      );
+    default:
+      return emit(io, "opportunities", format, () => {
+        throw new DecisionsError("invalid-request", USAGE);
+      });
+  }
+}
+function parse(argv, allowed) {
+  const options = Object.fromEntries(allowed.map((k) => [k, OPPORTUNITIES_OPTIONS[k]]));
+  return typedParse({ args: argv, options, strict: true });
+}
+function readCandidates(path, ref) {
+  let text;
+  try {
+    text = readFileSync(path, "utf8");
+  } catch {
+    throw new DecisionsError("invalid-request", `--file: cannot read ${ref}`);
+  }
+  let value;
+  try {
+    value = JSON.parse(text);
+  } catch (error) {
+    throw new DecisionsError(
+      "invalid-request",
+      `--file ${ref}: not JSON (${error.message})`
+    );
+  }
+  if (Array.isArray(value)) return value;
+  if (value && typeof value === "object" && "candidates" in value) {
+    const extra = Object.keys(value).filter((k) => k !== "candidates");
+    if (extra.length) {
+      throw new DecisionsError(
+        "invalid-request",
+        `--file ${ref}: unknown key(s) ${extra.join(", ")}; only "candidates" is read`
+      );
+    }
+    return value.candidates;
+  }
+  throw new DecisionsError(
+    "invalid-request",
+    `--file ${ref}: expected a JSON array of candidates, or {"candidates": [...]}`
+  );
+}
+function briefList(r) {
+  const lines = [
+    `decide opportunities list: ${r.opportunities.length} shown \xB7 ${r.matched} matched \xB7 ${r.total} total \xB7 savings projected`
+  ];
+  for (const o of r.opportunities) {
+    const where = o.location ? `${o.location.path}${o.location.lines ? `:${o.location.lines.start}-${o.location.lines.end}` : ""}` : "";
+    const saving = o.projected ? ` \xB7 $${o.projected.savingUsd} per ${o.projected.per} (projected)` : "";
+    const head = [
+      o.id,
+      o.status,
+      o.mode,
+      o.shape,
+      o.benefit,
+      o.risk ? `risk ${o.risk.level}` : void 0
+    ].filter(Boolean).join(" \xB7 ");
+    lines.push(`  ${head}${saving}${where ? `  ${where}` : ""}`);
+    if (o.mechanism) lines.push(`      ${o.mechanism}`);
+    if (o.statusReason) lines.push(`      ${o.status}: ${o.statusReason}`);
+  }
+  return lines.join("\n");
+}
+export {
+  OPPORTUNITIES_OPTIONS,
+  runOpportunitiesCommand
+};

package/dist/bundle/chunks/{route-7N3J5NP6.mjs → route-JQO5EDAN.mjs}

@@ -1,14 +1,14 @@
 import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
 import {
   typedParse
-} from "./chunk-BGL272OK.mjs";
+} from "./chunk-A7OWKSHE.mjs";
 import {
   runRoute
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-CUKOJ7OM.mjs";
 import {
   DecisionsError,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-B62DSXC3.mjs";
 
 // src/commands/route.ts
 import { readFileSync } from "node:fs";

package/dist/bundle/chunks/{spec-RKA3K6ZZ.mjs → spec-56ZXLEYW.mjs}

@@ -1,23 +1,25 @@
 import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
 import {
-  briefSpecCheck
-} from "./chunk-5LVOFZF3.mjs";
+  briefSpecCheck,
+  briefSpecLint
+} from "./chunk-FU3D2MBS.mjs";
 import {
   typedParse
-} from "./chunk-BGL272OK.mjs";
+} from "./chunk-A7OWKSHE.mjs";
 import {
   assertExamples,
   createContext,
   exampleProblems,
   listSpecs,
   loadSpec,
-  runSpecCheck
-} from "./chunk-5TUBFH7M.mjs";
+  runSpecCheck,
+  runSpecLint
+} from "./chunk-CUKOJ7OM.mjs";
 import {
   DecisionsError,
   EXIT,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-B62DSXC3.mjs";
 
 // src/commands/spec.ts
 function runSpecCommand(argv, io, format) {
@@ -72,11 +74,13 @@ function runSpecCommand(argv, io, format) {
       );
     case "check":
       return check(argv.slice(1), io, format, ctx);
+    case "lint":
+      return lint(argv.slice(1), io, format, ctx);
     default:
       return emit(io, "spec", format, () => {
         throw new DecisionsError(
           "invalid-request",
-          `Unknown spec action "${action}". Use: list, show, validate, check`
+          `Unknown spec action "${action}". Use: list, show, validate, lint, check`
         );
       });
   }
@@ -96,6 +100,37 @@ async function check(argv, io, format, ctx) {
   );
   return code === EXIT.ok && failed && parse(argv).values.strict ? EXIT.checkFailed : code;
 }
+async function lint(argv, io, format, ctx) {
+  let failed = false;
+  let strict = false;
+  const code = await emit(
+    io,
+    "spec",
+    format,
+    () => {
+      const { values, positionals } = typedParse({
+        args: argv,
+        allowPositionals: true,
+        strict: true,
+        options: LINT_OPTIONS
+      });
+      const [spec, extra] = positionals;
+      if (extra !== void 0) {
+        throw new DecisionsError(
+          "invalid-request",
+          "Usage: decide spec lint [name|path] [--strict]"
+        );
+      }
+      strict = values.strict ?? false;
+      const result = runSpecLint(ctx(), spec ? { spec } : {});
+      failed = !result.passed || strict && result.counts.warnings > 0;
+      return result;
+    },
+    (r, f) => f === "brief" ? briefSpecLint(r) : void 0
+  );
+  return code === EXIT.ok && failed ? EXIT.checkFailed : code;
+}
+var LINT_OPTIONS = { strict: { type: "boolean" } };
 function checkInput(argv) {
   const { values, positionals } = parse(argv);
   const [spec, extra] = positionals;

package/dist/bundle/decide.mjs

@@ -4,4 +4,4 @@ import { createRequire as __decideRequire } from "node:module"; const require =
 // src/entry.ts
 import module from "node:module";
 module.enableCompileCache?.();
-await import("./chunks/bin-3EWFISFQ.mjs");
+await import("./chunks/bin-NJIZOMS4.mjs");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garygentry/system1",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "The `decide` CLI: typed, calibrated decisions for coding agents, hooks and CI.",
   "type": "module",
   "license": "MIT",