@garygentry/system1 0.3.2 → 0.4.0

package/dist/bundle/chunks/{chunk-4ZZ3ZSJN.mjs → chunk-WZIVOY5Q.mjs}

@@ -71,7 +71,11 @@ var EXIT = {
   budgetGuard: 4,
   providerError: 5,
   replayMiss: 6,
-  /** `spec check --strict` only: the check ran, and an example did not pass. */
+  /**
+   * The check ran and did not pass: `spec check --strict` (an example missed),
+   * or `spec lint` (an error-level finding or invalid spec; with `--strict`, any
+   * warning).
+   */
   checkFailed: 7
 };
 var BY_CODE = {
@@ -147,7 +151,7 @@ function extractFormat(argv, fallback) {
 }
 
 // ../core/dist/version.js
-var VERSION = "0.3.2";
+var VERSION = "0.4.0";
 var CLI_PACKAGE = "@garygentry/system1";
 
 export {

package/dist/bundle/chunks/{chunk-BGL272OK.mjs → chunk-XNRV73UE.mjs}

@@ -2,10 +2,10 @@ import { createRequire as __decideRequire } from "node:module"; const require =
 import {
   parseFileRef,
   parseQuestionSet
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-QYUSJUFX.mjs";
 import {
   DecisionsError
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.mjs";
 
 // src/args.ts
 import { readFileSync } from "node:fs";
@@ -23,9 +23,11 @@ var DECIDE_OPTIONS = {
   staged: { type: "boolean" },
   text: { type: "string" },
   stdin: { type: "boolean" },
+  exclude: { type: "string", multiple: true },
   "allow-outside": { type: "boolean" },
   split: { type: "string" },
   keep: { type: "string", multiple: true },
+  "keep-any": { type: "string", multiple: true },
   sort: { type: "string" },
   limit: { type: "string" },
   fields: { type: "string" },
@@ -104,8 +106,10 @@ function buildInput(values, readStdin, cwd = process.cwd()) {
     );
   }
   if (sources.length) input.sources = sources;
+  set("exclude", values.exclude?.length ? values.exclude : void 0);
   set("split", values.split);
   set("keep", values.keep?.length ? values.keep : void 0);
+  set("keepAny", values["keep-any"]?.length ? values["keep-any"] : void 0);
   set("sort", values.sort);
   set("limit", int(values.limit, "--limit"));
   set(

package/dist/bundle/chunks/{config-UUPD2JL4.mjs → config-KXGUNAJR.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-XNRV73UE.mjs";
 import {
   DEFAULT_EXCLUDES,
   activeTriggers,
@@ -10,11 +10,11 @@ import {
   loadConfig,
   repoConfigPath,
   setConsent
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-QYUSJUFX.mjs";
 import {
   DecisionsError,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.mjs";
 
 // src/commands/config.ts
 function runConfigCommand(argv, io, format) {

package/dist/bundle/chunks/{decide-AAXD3ITT.mjs → decide-HI5CUH3C.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-XNRV73UE.mjs";
 import {
   createContext,
   runAsk,
   runMany
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-QYUSJUFX.mjs";
 import {
   DecisionsError,
   ENVELOPE_VERSION,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.mjs";
 
 // src/commands/decide.ts
 import { readFileSync } from "node:fs";

package/dist/bundle/chunks/{doctor-KPJ5KVLS.mjs → doctor-NDV3Y6T7.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-QYUSJUFX.mjs";
 import {
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.mjs";
 
 // src/commands/doctor.ts
 import { execFile } from "node:child_process";

package/dist/bundle/chunks/{misc-IW4I3SO6.mjs → misc-6SDKH2PI.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-XNRV73UE.mjs";
 import {
   TOOL_SCHEMAS,
   createContext,
@@ -10,13 +10,13 @@ import {
   probeUrl,
   resolveConnection,
   runUsage
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-QYUSJUFX.mjs";
 import {
   DecisionsError,
   EXIT,
   emit,
   isDecisionsError
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.mjs";
 
 // src/commands/misc.ts
 function runSchemaCommand(argv, io, format) {

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

@@ -0,0 +1,144 @@
+import { createRequire as __decideRequire } from "node:module"; const require = __decideRequire(import.meta.url);
+import {
+  typedParse
+} from "./chunk-XNRV73UE.mjs";
+import {
+  createContext,
+  runOpportunitiesAdd,
+  runOpportunitiesCheck,
+  runOpportunitiesList
+} from "./chunk-QYUSJUFX.mjs";
+import {
+  DecisionsError,
+  emit
+} from "./chunk-WZIVOY5Q.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-BF5J2NLU.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-XNRV73UE.mjs";
 import {
   runRoute
-} from "./chunk-5TUBFH7M.mjs";
+} from "./chunk-QYUSJUFX.mjs";
 import {
   DecisionsError,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.mjs";
 
 // src/commands/route.ts
 import { readFileSync } from "node:fs";

package/dist/bundle/chunks/{spec-RKA3K6ZZ.mjs → spec-GLTPEEON.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-XNRV73UE.mjs";
 import {
   assertExamples,
   createContext,
   exampleProblems,
   listSpecs,
   loadSpec,
-  runSpecCheck
-} from "./chunk-5TUBFH7M.mjs";
+  runSpecCheck,
+  runSpecLint
+} from "./chunk-QYUSJUFX.mjs";
 import {
   DecisionsError,
   EXIT,
   emit
-} from "./chunk-4ZZ3ZSJN.mjs";
+} from "./chunk-WZIVOY5Q.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-TIEUYIP3.mjs");

package/package.json

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