incur 0.4.0 → 0.4.1

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.1",
   "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] },
+  })
 })