incur 0.4.0 → 0.4.2

package/dist/internal/helpers.d.ts

@@ -0,0 +1,9 @@
+/** Checks whether a value is a plain object record. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** Converts a camelCase string to kebab-case. */
+export declare function toKebab(value: string): string;
+/** Computes the Levenshtein edit distance between two strings. */
+export declare function levenshtein(a: string, b: string): number;
+/** Suggests the closest command name from a set, returning it if within a reasonable edit distance. */
+export declare function suggest(input: string, candidates: Iterable<string>): string | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/internal/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/internal/helpers.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,iDAAiD;AACjD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAcxD;AAED,uGAAuG;AACvG,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,SAAS,CA8BvF"}

package/dist/internal/helpers.js

@@ -0,0 +1,54 @@
+/** Checks whether a value is a plain object record. */
+export function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** Converts a camelCase string to kebab-case. */
+export function toKebab(value) {
+    return value.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
+}
+/** Computes the Levenshtein edit distance between two strings. */
+export function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: n + 1 }, (_, i) => i);
+    for (let i = 1; i <= m; i++) {
+        let prev = dp[0];
+        dp[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const tmp = dp[j];
+            dp[j] = a[i - 1] === b[j - 1] ? prev : 1 + Math.min(prev, dp[j], dp[j - 1]);
+            prev = tmp;
+        }
+    }
+    return dp[n];
+}
+/** Suggests the closest command name from a set, returning it if within a reasonable edit distance. */
+export function suggest(input, candidates) {
+    const threshold = input.length <= 4 ? 2 : Math.floor(input.length / 2);
+    const lower = input.toLowerCase();
+    const all = Array.isArray(candidates) ? candidates : [...candidates];
+    let best;
+    let bestScore = Infinity;
+    for (const c of all) {
+        const lc = c.toLowerCase();
+        const dist = levenshtein(lower, lc);
+        let score;
+        if (lc.startsWith(lower) && lc !== lower)
+            // prefix match — best tier
+            score = dist;
+        else if (lc.includes(lower))
+            // contains match — middle tier
+            score = 100 + dist;
+        else if (dist <= threshold)
+            // fuzzy match — last tier
+            score = 200 + dist;
+        else
+            continue;
+        if (score < bestScore) {
+            bestScore = score;
+            best = c;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/internal/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/internal/helpers.ts"],"names":[],"mappings":"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"}

package/dist/middleware.d.ts

@@ -4,10 +4,8 @@ import type * as Formatter from './Formatter.js';
 type InferVars<vars extends z.ZodObject<any> | undefined> = vars extends z.ZodObject<any> ? z.output<vars> : {};
 /** @internal Infers the output type of an env schema, or `{}` if undefined. */
 type InferEnv<env extends z.ZodObject<any> | undefined> = env extends z.ZodObject<any> ? z.output<env> : {};
-/** @internal Infers the output type of an options schema, or `{}` if undefined. */
-type InferOptions<options extends z.ZodObject<any> | undefined> = options extends z.ZodObject<any> ? z.output<options> : {};
 /** Middleware handler that runs before/after command execution. */
-export type Handler<vars extends z.ZodObject<any> | undefined = undefined, env extends z.ZodObject<any> | undefined = undefined, options extends z.ZodObject<any> | undefined = undefined> = (context: Context<vars, env, options>, next: () => Promise<void>) => Promise<void> | void;
+export type Handler<vars extends z.ZodObject<any> | undefined = undefined, env extends z.ZodObject<any> | undefined = undefined> = (context: Context<vars, env>, next: () => Promise<void>) => Promise<void> | void;
 /** CTA block for middleware error/ok responses. */
 type CtaBlock = {
     /** Commands to suggest. */
@@ -19,11 +17,13 @@ type CtaBlock = {
     description?: string | undefined;
 };
 /** Context available inside middleware. */
-export type Context<vars extends z.ZodObject<any> | undefined = undefined, env extends z.ZodObject<any> | undefined = undefined, options extends z.ZodObject<any> | undefined = undefined> = {
+export type Context<vars extends z.ZodObject<any> | undefined = undefined, env extends z.ZodObject<any> | undefined = undefined> = {
     /** Whether the consumer is an agent (stdout is not a TTY). */
     agent: boolean;
     /** The resolved command path. */
     command: string;
+    /** The binary name the user invoked (e.g. an alias). Falls back to `name` when not resolvable. */
+    displayName: string;
     /** Parsed environment variables from the CLI-level env schema. */
     env: InferEnv<env>;
     /** Return an error result, short-circuiting the middleware chain. */
@@ -40,8 +40,6 @@ export type Context<vars extends z.ZodObject<any> | undefined = undefined, env e
     formatExplicit: boolean;
     /** The CLI name. */
     name: string;
-    /** Parsed options from the root CLI-level options schema. */
-    options: InferOptions<options>;
     /** Set a typed variable for downstream middleware and handlers. */
     set<key extends string & keyof InferVars<vars>>(key: key, value: InferVars<vars>[key]): void;
     /** Variables set by upstream middleware. */
@@ -49,7 +47,7 @@ export type Context<vars extends z.ZodObject<any> | undefined = undefined, env e
     /** The CLI version string. */
     version: string | undefined;
 };
-/** Creates a strictly typed middleware handler. Pass the vars schema as a generic for typed `c.set()` and `c.var`, the env schema for typed `c.env`, and the options schema for typed `c.options`. */
-export default function middleware<const vars extends z.ZodObject<any> | undefined = undefined, const env extends z.ZodObject<any> | undefined = undefined, const options extends z.ZodObject<any> | undefined = undefined>(handler: Handler<vars, env, options>): Handler<vars, env, options>;
+/** Creates a strictly typed middleware handler. Pass the vars schema as a generic for typed `c.set()` and `c.var`, and the env schema for typed `c.env`. */
+export default function middleware<const vars extends z.ZodObject<any> | undefined = undefined, const env extends z.ZodObject<any> | undefined = undefined>(handler: Handler<vars, env>): Handler<vars, env>;
 export {};
 //# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"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"}

package/dist/middleware.js

@@ -1,4 +1,4 @@
-/** Creates a strictly typed middleware handler. Pass the vars schema as a generic for typed `c.set()` and `c.var`, the env schema for typed `c.env`, and the options schema for typed `c.options`. */
+/** Creates a strictly typed middleware handler. Pass the vars schema as a generic for typed `c.set()` and `c.var`, and the env schema for typed `c.env`. */
 export default function middleware(handler) {
     return handler;
 }

package/dist/middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAmEA,sMAAsM;AACtM,MAAM,CAAC,OAAO,UAAU,UAAU,CAIhC,OAAoC;IACpC,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AA6DA,4JAA4J;AAC5J,MAAM,CAAC,OAAO,UAAU,UAAU,CAGhC,OAA2B;IAC3B,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/examples/npm/.npmrc.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "./config.schema.json",
+  "commands": {
+    "install": {
+      "options": {
+        "saveExact": true
+      }
+    },
+    "publish": {
+      "options": {
+        "access": "public",
+        "tag": "latest"
+      }
+    },
+    "outdated": {
+      "options": {
+        "long": true
+      }
+    }
+  }
+}

package/examples/npm/config.schema.json

@@ -0,0 +1,134 @@
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "commands": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "install": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "options": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "saveDev": {
+                  "description": "Save as dev dependency",
+                  "type": "boolean"
+                },
+                "saveExact": {
+                  "description": "Save exact version",
+                  "type": "boolean"
+                },
+                "global": {
+                  "description": "Install globally",
+                  "type": "boolean"
+                }
+              }
+            }
+          }
+        },
+        "info": {
+          "type": "object",
+          "additionalProperties": false
+        },
+        "init": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "options": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "yes": {
+                  "type": "boolean",
+                  "description": "Skip prompts and use defaults"
+                },
+                "scope": {
+                  "description": "Package scope",
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "publish": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "options": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "tag": {
+                  "default": "latest",
+                  "description": "Distribution tag",
+                  "type": "string"
+                },
+                "access": {
+                  "default": "public",
+                  "description": "Package access level",
+                  "type": "string",
+                  "enum": ["public", "restricted"]
+                },
+                "dryRun": {
+                  "type": "boolean",
+                  "description": "Report what would be published"
+                },
+                "otp": {
+                  "description": "One-time password for 2FA",
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "run": {
+          "type": "object",
+          "additionalProperties": false
+        },
+        "uninstall": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "options": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "global": {
+                  "type": "boolean",
+                  "description": "Remove global package"
+                }
+              }
+            }
+          }
+        },
+        "outdated": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "options": {
+              "type": "object",
+              "additionalProperties": false,
+              "properties": {
+                "global": {
+                  "type": "boolean",
+                  "description": "Check global packages"
+                },
+                "long": {
+                  "type": "boolean",
+                  "description": "Show extended information"
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -1,22 +1,7 @@
 {
-  "devDependencies": {
-    "@changesets/cli": "latest",
-    "@hono/zod-openapi": "^1.2.2",
-    "@types/node": "latest",
-    "@vitest/coverage-v8": "^4.0.18",
-    "bun": "^1.3.10",
-    "hono": "^4.12.5",
-    "oxfmt": "^0.35.0",
-    "oxlint": "^1.50.0",
-    "tsx": "^4.21.0",
-    "typescript": "latest",
-    "vitest": "latest",
-    "zile": "latest"
-  },
-  "[!start-pkg]": "",
   "name": "incur",
   "type": "module",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -29,13 +14,16 @@
     "SKILL.md"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "@readme/openapi-parser": "^6.0.0",
+    "@cfworker/json-schema": "^4.1.1",
+    "@modelcontextprotocol/server": "^2.0.0-alpha.2",
     "@toon-format/toon": "^2.1.0",
     "tokenx": "^1.3.0",
     "yaml": "^2.8.2",
     "zod": "^4.3.6"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "sideEffects": false,
   "bin": {
     "incur": "./dist/bin.js",
@@ -50,16 +38,5 @@
       "src": "./src/index.ts",
       "default": "./dist/index.js"
     }
-  },
-  "scripts": {
-    "build": "zile",
-    "changeset:publish": "zile publish:prepare && changeset publish && zile publish:post",
-    "changeset:version": "changeset version",
-    "check": "oxlint --fix --ignore-pattern package.json && oxfmt",
-    "check:types": "tsc -b",
-    "incur": "node --import tsx src/bin.ts",
-    "cli:skills": "pnpm incur skills add",
-    "dev": "zile dev",
-    "test": "vitest"
   }
 }

package/src/Cli.test-d.ts

@@ -279,50 +279,61 @@ test('env is typed in per-command middleware', () => {
   })
 })
 
-test('options are typed in middleware via .use()', () => {
-  Cli.create('test', {
-    options: z.object({
-      token: z.string(),
-      verbose: z.boolean().default(false),
-    }),
-  }).use((c, _next) => {
-    expectTypeOf(c.options.token).toEqualTypeOf<string>()
-    expectTypeOf(c.options.verbose).toEqualTypeOf<boolean>()
+test('run() context exposes format metadata', () => {
+  const cli = Cli.create('test')
+  cli.command('ping', {
+    run(c) {
+      expectTypeOf(c.format).toEqualTypeOf<'toon' | 'json' | 'yaml' | 'md' | 'jsonl'>()
+      expectTypeOf(c.formatExplicit).toEqualTypeOf<boolean>()
+      return { pong: true }
+    },
   })
 })
 
-test('without options, c.options is empty object in middleware', () => {
-  Cli.create('test').use((c, _next) => {
-    expectTypeOf(c.options).toEqualTypeOf<{}>()
+test('root run() context exposes displayName', () => {
+  Cli.create('test', {
+    run(c) {
+      expectTypeOf(c.displayName).toEqualTypeOf<string>()
+      return { pong: true }
+    },
   })
 })
 
-test('middleware<vars, env, options>() infers all three types', () => {
-  const cli = Cli.create('test', {
-    env: z.object({ API_TOKEN: z.string() }),
-    options: z.object({ token: z.string() }),
-    vars: z.object({ user: z.string() }),
+test('create() accepts config-file defaults options', () => {
+  Cli.create('test', {
+    config: {},
   })
 
-  const mw = middleware<typeof cli.vars, typeof cli.env, typeof cli.options>((c, _next) => {
-    expectTypeOf(c.env.API_TOKEN).toEqualTypeOf<string>()
-    expectTypeOf(c.options.token).toEqualTypeOf<string>()
-    expectTypeOf(c.var.user).toEqualTypeOf<string>()
-    c.set('user', 'alice')
+  Cli.create('test', {
+    config: { flag: 'config' },
   })
 
-  expectTypeOf(mw).toEqualTypeOf<
-    MiddlewareHandler<typeof cli.vars, typeof cli.env, typeof cli.options>
-  >()
-})
+  Cli.create('test', {
+    config: { files: ['.myrc.json', '~/.config/my/config.json'] },
+  })
 
-test('run() context exposes format metadata', () => {
-  const cli = Cli.create('test')
-  cli.command('ping', {
-    run(c) {
-      expectTypeOf(c.format).toEqualTypeOf<'toon' | 'json' | 'yaml' | 'md' | 'jsonl'>()
-      expectTypeOf(c.formatExplicit).toEqualTypeOf<boolean>()
-      return { pong: true }
+  Cli.create('test', {
+    config: {
+      flag: 'config',
+      files: ['config.toml'],
+      loader: async (path) => {
+        if (!path) return undefined
+        return { key: 'value' }
+      },
     },
   })
+
+  Cli.create('test', {
+    config: { loader: async () => ({ key: 'value' }) },
+  })
+
+  Cli.create('test', {
+    // @ts-expect-error — flag must be a string
+    config: { flag: true },
+  })
+
+  Cli.create('test', {
+    // @ts-expect-error — files must be string[]
+    config: { files: [42] },
+  })
 })