incur 0.4.7 → 0.4.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "incur",
   "type": "module",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "license": "MIT",
   "repository": {
     "type": "git",

package/src/Cli.test-d.ts

@@ -351,6 +351,43 @@ test('run() context exposes format metadata', () => {
   })
 })
 
+test('command mcp metadata accepts instructions and annotations', () => {
+  Cli.create('test').command('read', {
+    mcp: {
+      annotations: {
+        title: 'Read data',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+      },
+      instructions: 'Only pass validated input.',
+    },
+    run: () => ({ ok: true }),
+  })
+
+  Cli.create('test', {
+    mcp: {
+      instructions: 'Use this server for test commands.',
+      stateless: false,
+      // @ts-expect-error -- annotations belong on command definitions
+      annotations: { readOnlyHint: true },
+    },
+  })
+})
+
+test('command metadata accepts destructive flag', () => {
+  Cli.create('test').command('destroy', {
+    destructive: true,
+    run: () => ({ ok: true }),
+  })
+
+  Cli.create('destroy', {
+    destructive: true,
+    run: () => ({ ok: true }),
+  })
+})
+
 test('root run() context exposes displayName', () => {
   Cli.create('test', {
     run(c) {
@@ -360,6 +397,19 @@ test('root run() context exposes displayName', () => {
   })
 })
 
+test('create() accepts root command hint', () => {
+  Cli.create('test', {
+    hint: 'Fetch immediately before sending the transaction.',
+    run: () => ({ ok: true }),
+  })
+
+  Cli.create({
+    name: 'test',
+    hint: 'Fetch immediately before sending the transaction.',
+    run: () => ({ ok: true }),
+  })
+})
+
 test('create() accepts config-file defaults options', () => {
   Cli.create('test', {
     config: {},
@@ -398,3 +448,24 @@ test('create() accepts config-file defaults options', () => {
     config: { files: [42] },
   })
 })
+
+test('globals type flows to middleware context', () => {
+  Cli.create('test', {
+    globals: z.object({ apiKey: z.string().optional() }),
+  }).use(async (c, next) => {
+    expectTypeOf(c.globals.apiKey).toEqualTypeOf<string | undefined>()
+    await next()
+  })
+})
+
+test('globalAlias keys are constrained to globals schema keys', () => {
+  Cli.create('test', {
+    globals: z.object({ apiKey: z.string() }),
+    globalAlias: { apiKey: 'k' },
+  })
+
+  const globals = z.object({ apiKey: z.string() })
+  // @ts-expect-error — 'foo' is not a key of the globals schema
+  const badAlias: Partial<Record<keyof z.output<typeof globals>, string>> = { foo: 'f' }
+  void badAlias
+})