argsbarg 6.1.6 → 6.1.8

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [6.1.8] - 2026-07-27
+
+### Changed
+
+- **JSON Schema validation** — `inputSchema` and `program.appConfig` validation uses `@cfworker/json-schema`; draft is resolved from each schema’s `$schema` (default Draft-07). Hand-written schemas may opt into 2019-09 or 2020-12 (`$defs` supported). Docs updated for multi-draft and Zod interop.
+
+## [6.1.7] - 2026-07-24
+
+### Changed
+
+- **Internal imports** — argsbarg `src/` uses relative paths instead of the `~/` tsconfig alias, so the published package resolves correctly from `node_modules` without a consumer-side tsconfig workaround.
+
 ## [6.1.6] - 2026-07-24
 
 
@@ -853,7 +865,9 @@ const cli = { ... } satisfies CliProgram;  // or : CliProgram
 - Migrate schemas: rename every `children` property to **`commands`**; move positional definitions to **`CliPositional`** objects on `positionals` and strip `positional` / `argMin` / `argMax` from flag definitions under `options` (flags only carry `name`, `description`, `kind`, and optional `shortName`).
 - Imports: use `CliPositional` where needed; replace `CliOptionDef` with `CliOption` or `CliPositional` as appropriate.
 
-[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v6.1.6...HEAD
+[Unreleased]: https://github.com/bdombro/bun-argsbarg/compare/v6.1.8...HEAD
+[6.1.8]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.1.8
+[6.1.7]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.1.7
 [6.1.6]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.1.6
 [6.1.5]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.1.5
 [6.1.4]: https://github.com/bdombro/bun-argsbarg/releases/tag/v6.1.4

package/docs/README.md

@@ -8,7 +8,7 @@ Start here to pick the right guide.
 | **Authoring a `CliProgram`** (humans or agents) | [cli-program.md](cli-program.md) — schema, formats, headless, `read*Flags` |
 | **JSON stdout / `outputSchema`** | [output-schema.md](output-schema.md) — codegen pipeline, JSDoc, narrowing |
 | **App config / `program.appConfig`** | [config-schema.md](config-schema.md) — flat JSON file, `ctx.appConfig`, codegen |
-| **JSON Schema subset (validation)** | [json-schema-subset.md](json-schema-subset.md) — supported keywords for config and `inputSchema` |
+| **JSON Schema validation** | [json-schema-subset.md](json-schema-subset.md) — Draft-07 / 2019-09 / 2020-12 (`$schema` on each schema; default Draft-07) |
 | **Exposing MCP tools** | [mcp.md](mcp.md) — stdio server, `inputSchema`, varargs, `configure --sync` |
 | **HTTP tool server** | [http-server.md](http-server.md) — `myapp http`, endpoints, curl examples |
 | **Shipping configure / agent artifacts** | [configure.md](configure.md) — Homebrew + `myapp configure --sync` |

package/docs/cli-program.md

@@ -111,7 +111,7 @@ Descriptions and schemas are copied into MCP tools, HTTP OpenAPI, and generated
 - For shape discovery: HTTP agents load **`docs openapi`** or `GET /openapi.json`; MCP agents use **`docs cli-schema`**; load full **`docs cli`** only when prose is needed.
 - Skill **`reference.md`** uses a compact CLI guide (no inline `outputSchema` JSON) — see [bundled-docs.md](bundled-docs.md#agent-artifact-contract).
 
-Validation keywords: [json-schema-subset.md](json-schema-subset.md).
+Validation: [json-schema-subset.md](json-schema-subset.md) (Draft-07 default; 2019-09 / 2020-12 when `$schema` is set — including Zod-generated schemas).
 
 ## Well-known option names
 
@@ -293,7 +293,7 @@ For nested tool bodies (e.g. invoice template data), declare a matching property
 
 **Precedence:** if `--invoice` is set, the flag value wins and stdin is not read.
 
-Use **`ctx.jsonOpt("invoice")`**, **`ctx.inputs`**, or **`ctx.inputsAs<MyInput>()`** — all synchronous. Argsbarg reads piped stdin before calling the handler when a `pipable` Json flag is omitted. When `leaf.inputSchema` is set, argsbarg validates merged inputs **before the handler runs** (same JSON Schema subset as `program.appConfig`); `ctx.inputs` returns the cached result.
+Use **`ctx.jsonOpt("invoice")`**, **`ctx.inputs`**, or **`ctx.inputsAs<MyInput>()`** — all synchronous. Argsbarg reads piped stdin before calling the handler when a `pipable` Json flag is omitted. When `leaf.inputSchema` is set, argsbarg validates merged inputs **before the handler runs** (same engine as `program.appConfig`; draft from `$schema` on the schema object); `ctx.inputs` returns the cached result.
 
 At most one `pipable` Json option per leaf. Json option names must appear in `inputSchema.properties` when a custom `inputSchema` is set.
 
@@ -321,7 +321,7 @@ When the entire tool body is JSON (no CLI flags), set **`kind: "json"`** on the
 
 Example CLI: `jq '{format:"pdf", invoice:.}' data.json | myapp render-invoice`
 
-See [output-schema.md](output-schema.md) for schemagen `inputType`, [http-server.md](http-server.md) for HTTP tool bodies, and [json-schema-subset.md](json-schema-subset.md) for supported schema keywords.
+See [output-schema.md](output-schema.md) for schemagen `inputType`, [http-server.md](http-server.md) for HTTP tool bodies, and [json-schema-subset.md](json-schema-subset.md) for validation drafts, Zod interop, and keyword notes.
 
 `CliLeafInputs` is intentionally untyped at the framework level. Narrow in your app (`read*Flags(ctx)` returning a typed struct) rather than expecting inference from `satisfies CliLeaf`.
 

package/docs/config-schema.md

@@ -48,7 +48,7 @@ await cli.run();
 
 **`_bindings`** — reserved top-level metadata: `{ "_bindings": { "apiToken": "env" } }`. Set via wizard (Enter to use env), `configure set --from-env`, or `ctx.appConfig.set` (marks `file`). Optional keys can be bound to `skip`.
 
-**Validation at runtime** — argsbarg validates the config file and `configure set` / `ctx.appConfig.set` against the effective JSON Schema ([supported subset](json-schema-subset.md)). Partial writes (bindings only, single-key updates) skip required-property checks.
+**Validation at runtime** — argsbarg validates the config file and `configure set` / `ctx.appConfig.set` against the effective JSON Schema ([validation](json-schema-subset.md)). Draft is chosen from `jsonSchema.$schema` (default Draft-07). Partial writes (bindings only, single-key updates) skip required-property checks.
 
 See [cli-program.md — Configuration](cli-program.md#configuration-programappconfig) for resolution order, bootstrap timing, and `configure get`/`set`.
 
@@ -67,7 +67,7 @@ export interface CliAppConfigEntry {
 
 export interface CliAppConfig {
   commands?: boolean | { enabled?: boolean; mcpSet?: boolean };
-  jsonSchema?: Record<string, unknown>;  // draft-07 block schema
+  jsonSchema?: Record<string, unknown>;  // JSON Schema block; include $schema to opt into 2019-09 / 2020-12
   entries: Record<string, CliAppConfigEntry>;
 }
 ```
@@ -155,7 +155,7 @@ flowchart LR
   end
   subgraph runtime [Runtime]
     Program["program.appConfig.jsonSchema"]
-    Validate["argsbarg runtime subset validator"]
+    Validate["@cfworker/json-schema (draft from $schema)"]
   end
   src --> Script --> Gen --> Json
   Gen --> Index --> Program --> Validate
@@ -180,16 +180,19 @@ export interface AppConfig {
 
 Wire on the program root: `import { AppConfigSchema } from "./config/__generated__"`.
 
-### Supported AppConfig shapes (argsbarg runtime validator)
+### Supported AppConfig shapes (runtime validation)
 
-| Supported (v1) | Deferred |
+Validation is [@cfworker/json-schema](https://www.npmjs.com/package/@cfworker/json-schema) with draft from `$schema` (default Draft-07). See [json-schema-subset.md](json-schema-subset.md) for drafts, Zod interop, and limits.
+
+| Commonly used | Notes |
 | --- | --- |
-| `type`, `properties`, `required`, `additionalProperties` | remote `$ref` |
-| `enum`, `const`, `default` | complex `if`/`then`/`else` |
-| local `#/definitions` + `$ref` | full draft-2020-12 |
-| `anyOf` / `oneOf` (basic) | |
+| `type`, `properties`, `required`, `additionalProperties` | |
+| `enum`, `const` | `default` is not applied at validation time |
+| local `#/definitions` + `$ref` (Draft-07) or `#/$defs` + `$ref` (2020-12) | remote `$ref` not supported |
+| `anyOf` / `oneOf` / `allOf` | |
 | `items`, `minItems`, `maxItems` | |
 | `minimum`, `maximum`, `minLength`, `maxLength`, `pattern` | |
+| `format` | includes argsbarg `comma-list` |
 
 ## Minimal example (no schemagen)
 

package/docs/decisions.md

@@ -33,7 +33,7 @@ Zod may actually cause more complexity and little/no gain for consumers.
 Yes Zod implements some features we do custom for JSON-SCHEMA, but is opinionated, less flexible, and would actually explode complexity in some situations. Zod could be a win for consumers if they require substantial, complex validation -- but then that may not convert well to json-schema anyways and json-schema generation is a big win.
 
 1. Argsbarg does a lot of schema patching/manipulation to create different schemas per target (cli-schema.json, MCP contract, openapi.json). This would be harder with Zod
-2. Consumers can already use zod if they want by using Zod's to-json-schema features to convert when passing to Argsbarg. So we aren't actually alienating / thwarting consumers from using Zod anyways.
+2. Consumers can use Zod by converting to JSON Schema (`zod-to-json-schema`, `z.toJSONSchema()`) and passing the result to `inputSchema` / `appConfig.jsonSchema`. Argsbarg resolves the validator draft from each schema’s `$schema` (Draft-07 default; 2019-09 / 2020-12 when set).
 3. For uses like API pass-through, proxy, dynamic schemas, Zod may actually explode complexity for consumers.
 4. Our TS->json-schema approach is actually easier and better in many cases
   - Just write plain typescript, done.

package/docs/json-schema-subset.md

@@ -1,39 +1,65 @@
-# JSON Schema subset
+# JSON Schema validation
 
-Argsbarg validates `program.appConfig`, leaf `inputSchema`, and related documents with a **custom Draft-07 subset** in [`src/config/validate.ts`](../src/config/validate.ts). There is no runtime dependency on a full JSON Schema validator.
+Argsbarg validates `program.appConfig`, leaf `inputSchema`, and related documents with [**@cfworker/json-schema**](https://www.npmjs.com/package/@cfworker/json-schema). The validator draft is chosen from each schema’s `$schema` URI (default **Draft-07** when omitted). Use this page when authoring schemas for config files, `inputSchema` on leaves, or `@sg` schemagen output.
 
-Use this page when authoring schemas for config files, `inputSchema` on leaves, or `@sg` schemagen output.
+## Schema draft
+
+| `$schema` (examples) | Validator draft |
+| --- | --- |
+| *(omitted)* | Draft-07 (schemagen default) |
+| `http://json-schema.org/draft-07/schema#` | Draft-07 |
+| `https://json-schema.org/draft/2019-09/schema` | 2019-09 |
+| `https://json-schema.org/draft/2020-12/schema` | 2020-12 |
+
+Hand-written schemas may use **2020-12** with `$defs` and `#/$defs/...` `$ref`s. Schemagen (`ts-json-schema-generator`) still emits Draft-07 with `definitions`.
+
+## From Zod (or other generators)
+
+You can pass JSON Schema from **`zod-to-json-schema`**, Zod v4 **`z.toJSONSchema()`**, or any tool that emits a root schema with `$schema`:
+
+| Source | Typical `$schema` | Works with argsbarg |
+| --- | --- | --- |
+| `zod-to-json-schema` (default) | Draft-07 | Yes — matches default when `$schema` omitted |
+| `z.toJSONSchema()` (default) | 2020-12 | Yes — draft resolved from `$schema` |
+| argsbarg schemagen | Draft-07 | Yes |
+
+Set the result on `leaf.inputSchema` or `program.appConfig.jsonSchema`. Validation uses the schema object and its `$schema` URI; not every Zod feature survives JSON Schema conversion (refinements, transforms, etc.).
 
 ## Supported constructs
 
+Validation uses [@cfworker/json-schema](https://www.npmjs.com/package/@cfworker/json-schema) for the draft declared by `$schema`. Schemas from schemagen and typical Zod exports commonly use:
+
 | Feature | Notes |
 | --- | --- |
 | `type` | `object`, `array`, `string`, `integer`, `number`, `boolean`, `null` |
 | `properties` / `required` | Object keys; `additionalProperties: false` enforced when set |
 | `items` | Homogeneous arrays; comma-separated CLI strings coerced when `items` is a primitive |
 | `enum` / `const` | Exact value checks |
-| `anyOf` / `oneOf` | First matching branch wins; errors surface when none match |
-| `$ref` | **Local only** — `#/definitions/Name` resolved within the same root document |
-| `definitions` | Companion to local `$ref` |
-| `format` | `date`, `date-time`, `duration`, `comma-list` (and related string coercions) |
+| `anyOf` / `oneOf` / `allOf` | Combinators (validator-native) |
+| `$ref` | **Local only** — `#/definitions/Name` (Draft-07) or `#/$defs/Name` (2019-09 / 2020-12) |
+| `definitions` / `$defs` | Companion to local `$ref` (draft-dependent) |
+| `format` | Built-ins include `date`, `date-time`, `duration`; argsbarg registers `comma-list` |
 | `minimum` / `maximum` | Numbers and integers |
 | `minLength` / `maxLength` | Strings |
 | `pattern` | String regex (ECMAScript) |
 
 ## Partial validation
 
-`validateConfigDocumentPartial` validates **present keys only** — root `required` is skipped. Used for `configure set` partial writes and bootstrap flows.
+`validateConfigDocumentPartial` validates **present keys only** — all `required` arrays are stripped before validation. Used for `configure set` partial writes and bootstrap flows.
 
 Leaf `inputSchema` validation uses full validation (including `required`) before the handler runs.
 
-## Not supported (today)
+## Argsbarg-specific behavior
+
+- Framework keys (`_bindings`, etc.) are omitted before config validation when `additionalProperties: false`.
+- CLI `configure set` still coerces comma-separated primitives, booleans, and numbers before validation (`parseConfigSetValue`).
+
+## Not guaranteed
 
 - Remote `$ref` (`http://…`, other files)
-- `allOf`, conditional (`if`/`then`/`else`), `not`
-- Unevaluated / dynamic references
 - `default` application at validation time (defaults come from CLI option `default` or config bindings)
 
-If schemagen emits an unsupported keyword, simplify the TypeScript type or post-process the generated JSON Schema.
+If schemagen emits keywords the validator rejects, simplify the TypeScript type or post-process the generated JSON Schema.
 
 ## Where validation runs
 

package/docs/output-schema.md

@@ -29,7 +29,7 @@ export const status = {
 
 **Set on the leaf only** — not under `mcpTool`.
 
-**Draft version** — argsbarg accepts any JSON Schema object (`type`, `properties`, `definitions`, etc.). Generators may emit draft-07 or draft 2020-12; docgen embeds the object as-is.
+**Draft version** — for **`inputSchema`** and **`appConfig.jsonSchema`**, argsbarg validates using the draft declared in `$schema` (default Draft-07 when omitted). Schemas from schemagen, `zod-to-json-schema`, or `z.toJSONSchema()` may use Draft-07 or 2020-12. **`outputSchema`** is embedded in docs/MCP/OpenAPI as-is and is not runtime-validated.
 
 See [cli-program.md — Structured stdout](cli-program.md#structured-stdout) for when to use `outputSchema` vs `notes`, and [mcp.md](mcp.md) for how MCP returns parsed JSON as `structuredContent`.
 

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "argsbarg",
-  "version": "6.1.6",
+  "version": "6.1.8",
   "main": "./src/index.ts",
   "module": "./src/index.ts",
   "dependencies": {
+    "@cfworker/json-schema": "^4",
     "ts-json-schema-generator": "^2.3.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.0",
+    "@biomejs/biome": "^2.5.5",
     "@types/bun": "^1.3.12",
     "dts-bundle-generator": "^9.5.1",
     "typescript": "^5.9.3"

package/src/builtins/builtins.test.ts

@@ -3,10 +3,10 @@ Tests for builtins/builtins module behavior.
 */
 
 import { describe, expect, test } from "bun:test";
-import { ParseKind, parse, postParseValidate } from "~/core/parse.ts";
-import type { CliProgram } from "~/core/types.ts";
-import { cliBuiltinDocsGroup } from "~/docs/builtin.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+import { ParseKind, parse, postParseValidate } from "../core/parse.ts";
+import type { CliProgram } from "../core/types.ts";
+import { cliBuiltinDocsGroup } from "../docs/builtin.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 import { completionBashScript, completionFishScript, completionZshScript } from ".";
 import { cliBuiltinConfigureCommand, configureBuiltinOptions } from "./configure.ts";
 import { configureCommandDescription, configureSyncOptionDescription } from "./configure-copy.ts";

package/src/builtins/completion-bash.ts

@@ -1,4 +1,4 @@
-import { CliOptionKind, type CliRouter } from "~/core/types.ts";
+import { CliOptionKind, type CliRouter } from "../core/types.ts";
 import { emitConsumeLong, emitConsumeShort, emitMatchChild } from "./completion-simulate-shared.ts";
 import { collectScopes, type ScopeRec } from "./scopes.ts";
 import { escShellSingleQuoted, identToken, kHelpLong, kHelpShort, mainName } from "./shell-helpers.ts";

package/src/builtins/completion-fish.ts

@@ -1,4 +1,4 @@
-import { CliOptionKind, type CliRouter } from "~/core/types.ts";
+import { CliOptionKind, type CliRouter } from "../core/types.ts";
 import { collectScopes } from "./scopes.ts";
 import { escFishSingleQuoted, identToken } from "./shell-helpers.ts";
 

package/src/builtins/completion-group.ts

@@ -1,11 +1,11 @@
-import type { CliProgram } from "~/core/types.ts";
+import type { CliProgram } from "../core/types.ts";
 
 /**
  * Builds the static `completion` / `bash` / `zsh` / `fish` command subtree (merged into the program root at runtime).
  */
-export function cliBuiltinCompletionGroup(program: CliProgram): import("~/core/types.ts").CliRouter {
+export function cliBuiltinCompletionGroup(program: CliProgram): import("../core/types.ts").CliRouter {
   const appName = program.key;
-  const router: import("~/core/types.ts").CliRouter = {
+  const router: import("../core/types.ts").CliRouter = {
     key: "completion",
     cli: { hidden: true },
     description: "Generate the autocompletion script for shells.",

package/src/builtins/completion-zsh.ts

@@ -1,4 +1,4 @@
-import { CliOptionKind, type CliRouter } from "~/core/types.ts";
+import { CliOptionKind, type CliRouter } from "../core/types.ts";
 import { emitConsumeLong, emitConsumeShort, emitMatchChild } from "./completion-simulate-shared.ts";
 import { collectScopes, type ScopeRec } from "./scopes.ts";
 import { escShellSingleQuoted, identToken, kHelpLong, kHelpShort, mainName } from "./shell-helpers.ts";

package/src/builtins/config.test.ts

@@ -6,9 +6,9 @@ import { describe, expect, test } from "bun:test";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
-import { readBindings } from "~/config/bindings.ts";
-import { resolveAppConfigPath, writeAppConfigFile } from "~/config/file.ts";
-import { Cli, type CliProgram } from "~/index";
+import { readBindings } from "../config/bindings.ts";
+import { resolveAppConfigPath, writeAppConfigFile } from "../config/file.ts";
+import { Cli, type CliProgram } from "../index.ts";
 
 function configFixture(): CliProgram {
   return {

package/src/builtins/config.ts

@@ -2,20 +2,20 @@
 Built-in `configure get` / `configure set` subcommands.
 */
 
-import { clearFileValue, setBinding } from "~/config/bindings.ts";
-import { bootstrapAppConfig } from "~/config/bootstrap.ts";
+import { clearFileValue, setBinding } from "../config/bindings.ts";
+import { bootstrapAppConfig } from "../config/bootstrap.ts";
 import {
   configCommandsEnabled,
   configEntrySensitive,
   configMcpSetEnabled,
   defaultConfigEntryTitle,
-} from "~/config/entry.ts";
-import { writeAppConfigFile } from "~/config/file.ts";
-import { captureMappedHostEnv, exportConfigToEnv, resolveAppConfig } from "~/config/resolve.ts";
-import { configPropertySchema, effectiveJsonSchema } from "~/config/schema.ts";
-import { parseConfigSetValue } from "~/config/validate.ts";
-import type { CliLeaf, CliOption, CliProgram } from "~/core/types.ts";
-import { CliOptionKind } from "~/core/types.ts";
+} from "../config/entry.ts";
+import { writeAppConfigFile } from "../config/file.ts";
+import { captureMappedHostEnv, exportConfigToEnv, resolveAppConfig } from "../config/resolve.ts";
+import { configPropertySchema, effectiveJsonSchema } from "../config/schema.ts";
+import { parseConfigSetValue } from "../config/validate.ts";
+import type { CliLeaf, CliOption, CliProgram } from "../core/types.ts";
+import { CliOptionKind } from "../core/types.ts";
 
 const JSON_OPTION: CliOption = {
   name: "json",

package/src/builtins/configure-copy.ts

@@ -1,7 +1,7 @@
 /** Capability-aware labels for configure builtin and docs copy. */
 
-import type { CliProgram } from "~/core/types.ts";
-import type { CliCapabilities } from "~/runtime/capabilities.ts";
+import type { CliProgram } from "../core/types.ts";
+import type { CliCapabilities } from "../runtime/capabilities.ts";
 
 type Kind = "skills" | "mcp" | "config";
 

package/src/builtins/configure.ts

@@ -1,4 +1,4 @@
-import { configCommandsEnabled, configMcpSetEnabled } from "~/config/entry.ts";
+import { configCommandsEnabled, configMcpSetEnabled } from "../config/entry.ts";
 import {
   CliFallbackMode,
   type CliLeaf,
@@ -6,8 +6,8 @@ import {
   CliOptionKind,
   type CliProgram,
   type CliRouter,
-} from "~/core/types.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+} from "../core/types.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 import { configureConfigSubcommands } from "./config.ts";
 import {
   configureCommandDescription,

package/src/builtins/dispatch.ts

@@ -1,13 +1,13 @@
-import { cliConfigure } from "~/configure";
-import type { ParseResult } from "~/core/parse.ts";
-import { ParseKind } from "~/core/parse.ts";
-import type { CliNode, CliProgram, CliRouter } from "~/core/types.ts";
-import { isCliLeaf } from "~/core/types.ts";
-import { cliBuiltinDocsGroupIfEnabled } from "~/docs/builtin.ts";
-import { runMcpBundle } from "~/mcp/bundle.ts";
-import { capabilityDeniedMessage, resolveCapabilities } from "~/runtime/capabilities.ts";
-import { Cli } from "~/runtime/cli.ts";
-import { serveOverridesFromOpts } from "~/server/overrides.ts";
+import { cliConfigure } from "../configure/index.ts";
+import type { ParseResult } from "../core/parse.ts";
+import { ParseKind } from "../core/parse.ts";
+import type { CliNode, CliProgram, CliRouter } from "../core/types.ts";
+import { isCliLeaf } from "../core/types.ts";
+import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
+import { runMcpBundle } from "../mcp/bundle.ts";
+import { capabilityDeniedMessage, resolveCapabilities } from "../runtime/capabilities.ts";
+import { Cli } from "../runtime/cli.ts";
+import { serveOverridesFromOpts } from "../server/overrides.ts";
 import { completionBashScript } from "./completion-bash.ts";
 import { completionFishScript } from "./completion-fish.ts";
 import { cliBuiltinCompletionGroup as completionGroup } from "./completion-group.ts";

package/src/builtins/export.ts

@@ -1,7 +1,7 @@
-import type { CliFallbackMode, CliNode, CliOption, CliPositional, CliProgram } from "~/core/types.ts";
-import { isCliRouter } from "~/core/types.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
-import { isCliSchemaHidden, visibleOptions } from "~/runtime/exposure.ts";
+import type { CliFallbackMode, CliNode, CliOption, CliPositional, CliProgram } from "../core/types.ts";
+import { isCliRouter } from "../core/types.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
+import { isCliSchemaHidden, visibleOptions } from "../runtime/exposure.ts";
 import { resolveBuiltins } from "./registry.ts";
 
 /** JSON-safe command node (no handlers). */

package/src/builtins/http.ts

@@ -5,11 +5,11 @@ import {
   CliOptionKind,
   type CliProgram,
   type CliRouter,
-} from "~/core/types.ts";
-import { docsEnabled } from "~/docs/resolve.ts";
-import { httpUserPathGlob, resolveHttpPathPrefix } from "~/http/paths.ts";
-import { resolveHttpListenAddress } from "~/http/server.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+} from "../core/types.ts";
+import { docsEnabled } from "../docs/resolve.ts";
+import { httpUserPathGlob, resolveHttpPathPrefix } from "../http/paths.ts";
+import { resolveHttpListenAddress } from "../http/server.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 
 const HTTP_SERVE_OPTIONS: CliOption[] = [
   { name: "host", description: "Listen host.", kind: CliOptionKind.String },

package/src/builtins/mcp.ts

@@ -5,9 +5,9 @@ import {
   CliOptionKind,
   type CliProgram,
   type CliRouter,
-} from "~/core/types.ts";
-import { docsEnabled } from "~/docs/resolve.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+} from "../core/types.ts";
+import { docsEnabled } from "../docs/resolve.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 
 const MCP_SERVE_OPTIONS: CliOption[] = [
   { name: "obscure-errors", description: "Hide unexpected errors from clients.", kind: CliOptionKind.Presence },

package/src/builtins/presentation.ts

@@ -1,8 +1,8 @@
-import type { CliLeaf, CliNode, CliProgram, CliRouter } from "~/core/types.ts";
-import { isCliLeaf } from "~/core/types.ts";
-import type { CliCapabilities } from "~/runtime/capabilities.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
-import { isCliHidden, presentationNode, visibleOptions } from "~/runtime/exposure.ts";
+import type { CliLeaf, CliNode, CliProgram, CliRouter } from "../core/types.ts";
+import { isCliLeaf } from "../core/types.ts";
+import type { CliCapabilities } from "../runtime/capabilities.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
+import { isCliHidden, presentationNode, visibleOptions } from "../runtime/exposure.ts";
 import { resolveBuiltins } from "./registry.ts";
 
 /** All built-in command nodes for argv parsing (includes hidden builtins). */

package/src/builtins/registry.ts

@@ -1,6 +1,6 @@
-import type { CliNode, CliProgram } from "~/core/types.ts";
-import { cliBuiltinDocsGroupIfEnabled } from "~/docs/builtin.ts";
-import type { CliCapabilities } from "~/runtime/capabilities.ts";
+import type { CliNode, CliProgram } from "../core/types.ts";
+import { cliBuiltinDocsGroupIfEnabled } from "../docs/builtin.ts";
+import type { CliCapabilities } from "../runtime/capabilities.ts";
 import { cliBuiltinCompletionGroup } from "./completion-group.ts";
 import { cliBuiltinConfigureCommand } from "./configure.ts";
 import { cliBuiltinHttpCommand } from "./http.ts";

package/src/builtins/scopes.ts

@@ -2,12 +2,12 @@
 Shared completion scope walk used by bash, zsh, and fish emitters.
 */
 
-import { type CliNode, type CliRouter, isCliLeaf, isCliRouter } from "~/core/types.ts";
+import { type CliNode, type CliRouter, isCliLeaf, isCliRouter } from "../core/types.ts";
 
 /** One tab-completion scope: child commands, options, and path key for the schema walk. */
 export interface ScopeRec {
   kids: CliNode[];
-  opts: import("~/core/types.ts").CliOption[];
+  opts: import("../core/types.ts").CliOption[];
   path: string;
   wantsFiles: boolean;
 }

package/src/builtins/version.ts

@@ -1,4 +1,4 @@
-import type { CliLeaf } from "~/core/types.ts";
+import type { CliLeaf } from "../core/types.ts";
 
 /** Top-level `version` built-in (leaf). */
 export function cliBuiltinVersionCommand(): CliLeaf {

package/src/cli-tool/full-example-capabilities.test.ts

@@ -5,8 +5,8 @@ Tests for cli-tool/full-example-capabilities module behavior.
 import { describe, expect, test } from "bun:test";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
-import { CliOptionKind, type CliProgram } from "~/core/types.ts";
-import { resolveCapabilities } from "~/runtime/capabilities.ts";
+import { CliOptionKind, type CliProgram } from "../core/types.ts";
+import { resolveCapabilities } from "../runtime/capabilities.ts";
 
 const exampleRoot = join(import.meta.dir, "../../examples/full-example");
 const programSource = readFileSync(join(exampleRoot, "src/program.ts"), "utf8");

package/src/cli-tool/main.ts

@@ -1,7 +1,7 @@
 #!/usr/bin/env bun
 /** Argsbarg package CLI (`bunx argsbarg`) — bootstrap and tooling; library API is `import from "argsbarg"`. */
 
-import { Cli } from "~/index";
+import { Cli } from "../index.ts";
 import { program } from "./program.ts";
 
 const cli = new Cli(program);

package/src/cli-tool/program.ts

@@ -2,8 +2,8 @@
 Argsbarg developer tools — bootstrap consumer CLIs via `create`.
 */
 
-import { CliOptionKind, type CliProgram } from "~/index";
 import pkg from "../../package.json" with { type: "json" };
+import { CliOptionKind, type CliProgram } from "../index.ts";
 import { runCreate } from "./run-create.ts";
 import { runSchemagenCli } from "./run-schemagen.ts";
 

package/src/cli-tool/prompt.ts

@@ -1,6 +1,6 @@
 /** Interactive prompts for `argsbarg create`. */
 
-import { readPromptLine as readStdinLine } from "~/prompt.ts";
+import { readPromptLine as readStdinLine } from "../prompt.ts";
 
 export function readPromptLine(prompt: string): string {
   process.stderr.write(prompt);

package/src/config/bindings.test.ts

@@ -3,7 +3,7 @@ Tests for config/bindings module.
 */
 
 import { describe, expect, test } from "bun:test";
-import type { CliAppConfigEntry } from "~/core/types.ts";
+import type { CliAppConfigEntry } from "../core/types.ts";
 import {
   bindingForKey,
   CONFIG_BINDINGS_KEY,

package/src/config/bindings.ts

@@ -2,7 +2,7 @@
 Per-key config binding metadata (`_bindings`) — records how each schema key is satisfied.
 */
 
-import type { CliAppConfigEntry } from "~/core/types.ts";
+import type { CliAppConfigEntry } from "../core/types.ts";
 
 /** Reserved top-level config file key for per-entry binding metadata. */
 export const CONFIG_BINDINGS_KEY = "_bindings";

package/src/config/bootstrap.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from "bun:test";
-import type { CliAppConfigEntry } from "~/core/types.ts";
+import type { CliAppConfigEntry } from "../core/types.ts";
 import { shouldWizardPromptConfigKey } from "./bootstrap.ts";
 
 const requiredEntry: CliAppConfigEntry = {

package/src/config/bootstrap.ts

@@ -4,9 +4,9 @@ settings are present before the CLI or MCP server handles a request.
 */
 
 import { readSync } from "node:fs";
-import type { CliAppConfigEntry, CliProgram, ServerRuntime } from "~/core/types.ts";
-import type { LogEmitter } from "~/log/emitter.ts";
-import { readPromptLine as readStdinLine } from "~/prompt.ts";
+import type { CliAppConfigEntry, CliProgram, ServerRuntime } from "../core/types.ts";
+import type { LogEmitter } from "../log/emitter.ts";
+import { readPromptLine as readStdinLine } from "../prompt.ts";
 import { bindingForKey, clearFileValue, isKeyAddressed, readBindings, setBinding } from "./bindings.ts";
 import { configEntryRequired, configEntrySensitive, defaultConfigEntryTitle, jsonSchemaRequiredKeys } from "./entry.ts";
 import {

package/src/config/context.test.ts

@@ -6,7 +6,7 @@ import { describe, expect, test } from "bun:test";
 import { mkdtempSync, rmSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { dirname, join } from "node:path";
-import type { CliProgram } from "~/core/types.ts";
+import type { CliProgram } from "../core/types.ts";
 import { createAppConfigSnapshot } from "./context.ts";
 import { resolveAppConfigDir, resolveAppConfigPath } from "./file.ts";
 import { resolveAppConfig } from "./resolve.ts";

package/src/config/context.ts

@@ -2,7 +2,7 @@
 Handler-facing resolved app config snapshot (ctx.appConfig).
 */
 
-import type { CliProgram } from "~/core/types.ts";
+import type { CliProgram } from "../core/types.ts";
 import { isFrameworkConfigKey, setBinding } from "./bindings.ts";
 import {
   readAppConfigFileRaw,

package/src/config/entry.ts

@@ -2,7 +2,7 @@
 Shared helpers for program.appConfig schema entries.
 */
 
-import type { CliAppConfigEntry, CliProgram } from "~/core/types.ts";
+import type { CliAppConfigEntry, CliProgram } from "../core/types.ts";
 
 /** Default title when `CliAppConfigEntry.title` is omitted. */
 export function defaultConfigEntryTitle(key: string): string {