@zodal/dials-codegen 0.1.0

package/README.md

@@ -0,0 +1,30 @@
+# @zodal/dials-codegen
+
+Machine-interface emit for [zodal-dials](https://github.com/i2mint/zodal-dials): a **JSON Schema** (editor autocomplete/validation for the settings file), an **AI prompt**, and **CLI helpers**.
+
+```bash
+npm i @zodal/dials-codegen @zodal/dials-core
+```
+
+```ts
+import { toJsonSchema, toPrompt, runCli } from '@zodal/dials-codegen';
+
+// 1. JSON Schema — point a settings file's "$schema" at it for autocomplete (flat dotted keyspace,
+//    secret values redacted, $schema pointer allowed):
+writeFile('dials.schema.json', JSON.stringify(toJsonSchema(dials, { $id: 'https://x/dials.schema.json' })));
+
+// 2. AI prompt — let an assistant help the user configure:
+toPrompt(dials); // "# Settings\n- `editor.theme` (enum: light | dark | system, default "system") — …"
+
+// 3. CLI — get/set/list with provenance, secrets masked:
+runCli(['list', '--show-origin'], { dials, stack, layer });
+// editor.fontSize = 16   (user)
+// editor.theme = "dark"  (workspace)
+runCli(['set', 'editor.fontSize', '18'], ctx); // validates against the field; returns a new layer
+```
+
+- **`toJsonSchema`** — secret defaults/enums/consts redacted; `required` dropped (overrides are optional); a `$schema` property added so the file's own pointer validates.
+- **`toPrompt`** — secrets marked `[secret]`, never carrying their value.
+- **CLI** (`runCli`/`formatList`/`formatGet`/`coerceByType`) — pure & IO-free; `list --show-origin` surfaces cascade provenance (à la `git config --show-origin`); `set` validates and never echoes a secret; secrets always masked.
+
+Part of the [zodal-dials](https://github.com/i2mint/zodal-dials) ecosystem.

package/dist/index.cjs

@@ -0,0 +1,249 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  coerceByType: () => coerceByType,
+  describeForCodegen: () => describeForCodegen,
+  formatGet: () => formatGet,
+  formatList: () => formatList,
+  runCli: () => runCli,
+  toJsonSchema: () => toJsonSchema,
+  toPrompt: () => toPrompt
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/json-schema.ts
+var import_zod = require("zod");
+
+// src/introspect.ts
+var import_dials_core = require("@zodal/dials-core");
+var import_core = require("@zodal/core");
+function safe(fn) {
+  try {
+    return fn();
+  } catch {
+    return void 0;
+  }
+}
+function describeForCodegen(dials) {
+  const shape = (0, import_dials_core.getObjectShape)(dials.schema);
+  return dials.keys.map((key) => {
+    const field = shape[key];
+    const meta = field ? (0, import_dials_core.readMeta)(field) : {};
+    const enumValues = field ? safe(() => (0, import_core.getEnumValues)(field)) : void 0;
+    return {
+      key,
+      type: field ? (0, import_dials_core.baseType)(field) : "unknown",
+      default: dials.defaults[key],
+      enumValues: enumValues && enumValues.length > 0 ? enumValues : void 0,
+      description: typeof meta.description === "string" ? meta.description : void 0,
+      sensitivity: dials.sensitivityFor(key)
+    };
+  });
+}
+
+// src/json-schema.ts
+function fallbackSchema(dials) {
+  const properties = {};
+  for (const field of describeForCodegen(dials)) {
+    const prop = {};
+    if (field.type === "number" || field.type === "boolean") prop.type = field.type;
+    else if (field.type === "enum") {
+      prop.type = "string";
+      if (field.enumValues) prop.enum = field.enumValues;
+    } else if (field.type === "array") prop.type = "array";
+    else if (field.type === "object") prop.type = "object";
+    else prop.type = "string";
+    if (field.default !== void 0) prop.default = field.default;
+    if (field.description) prop.description = field.description;
+    properties[field.key] = prop;
+  }
+  return { $schema: "https://json-schema.org/draft/2020-12/schema", type: "object", properties };
+}
+function toJsonSchema(dials, options = {}) {
+  let schema;
+  try {
+    schema = import_zod.z.toJSONSchema(dials.schema);
+  } catch {
+    schema = fallbackSchema(dials);
+  }
+  if (!options.keepRequired) delete schema.required;
+  schema.additionalProperties = options.additionalProperties ?? false;
+  if (options.$id) schema.$id = options.$id;
+  if (options.title) schema.title = options.title;
+  const properties = schema.properties;
+  if (properties) {
+    for (const key of Object.keys(properties)) {
+      if (dials.sensitivityFor(key) === "secret") {
+        const prop = properties[key];
+        delete prop.default;
+        delete prop.const;
+        delete prop.enum;
+        delete prop.examples;
+      }
+    }
+    if (schema.additionalProperties === false && !properties["$schema"]) {
+      properties["$schema"] = { type: "string" };
+    }
+  }
+  return schema;
+}
+
+// src/prompt.ts
+function toPrompt(dials, options = {}) {
+  const fields = describeForCodegen(dials);
+  const lines = [];
+  lines.push(`# ${options.title ?? "Settings"}`);
+  lines.push("");
+  lines.push(
+    `This system exposes ${fields.length} settings. Each is a typed, named parameter identified by a dotted key. To change one, supply its key and a value of the stated type (for enums, one of the listed values).`
+  );
+  lines.push("");
+  for (const field of fields) {
+    let line = `- \`${field.key}\` (${field.type}`;
+    if (field.enumValues) line += `: ${field.enumValues.join(" | ")}`;
+    if (field.sensitivity !== "secret" && field.default !== void 0) line += `, default ${JSON.stringify(field.default)}`;
+    line += ")";
+    if (field.sensitivity === "secret") line += " [secret]";
+    if (field.description) line += ` \u2014 ${field.description}`;
+    lines.push(line);
+  }
+  return lines.join("\n");
+}
+
+// src/cli.ts
+var import_dials_core2 = require("@zodal/dials-core");
+function coerceByType(type, raw) {
+  switch (type) {
+    case "number": {
+      const n = Number(raw);
+      if (Number.isNaN(n)) throw new Error(`"${raw}" is not a number`);
+      return n;
+    }
+    case "boolean": {
+      const t = raw.toLowerCase();
+      if (t === "true" || t === "1" || t === "yes") return true;
+      if (t === "false" || t === "0" || t === "no") return false;
+      throw new Error(`"${raw}" is not a boolean (use true/false)`);
+    }
+    case "object":
+    case "array":
+      return JSON.parse(raw);
+    case "string":
+    case "enum":
+      return raw;
+    default:
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return raw;
+      }
+  }
+}
+function typeOf(dials, key) {
+  const field = (0, import_dials_core2.getObjectShape)(dials.schema)[key];
+  return field ? (0, import_dials_core2.baseType)(field) : "unknown";
+}
+function formatValue(value) {
+  if ((0, import_dials_core2.isSecretRef)(value)) return value.masked;
+  return JSON.stringify(value);
+}
+function resolveContext(ctx) {
+  const stack = [...ctx.stack ?? [], { scope: ctx.scope ?? "user", layer: ctx.layer }];
+  return ctx.dials.resolve(stack, { maskSecrets: true });
+}
+function formatList(ctx, options = {}) {
+  const result = resolveContext(ctx);
+  const lines = [];
+  const extras = Object.keys(result.provenance).filter((k) => !ctx.dials.keys.includes(k));
+  for (const key of [...ctx.dials.keys, ...extras]) {
+    const prov = result.provenance[key];
+    if (!prov) continue;
+    if (options.modifiedOnly && prov.winningScope === "default") continue;
+    let line = `${key} = ${formatValue(result.effective[key])}`;
+    if (options.showOrigin) line += `	(${prov.winningScope}${prov.managed ? ", policy" : ""})`;
+    lines.push(line);
+  }
+  return lines.join("\n");
+}
+function formatGet(ctx, key) {
+  if (!ctx.dials.keys.includes(key)) return `unknown setting: ${key}`;
+  const result = resolveContext(ctx);
+  const prov = result.provenance[key];
+  if (!prov) return `${key} is unset`;
+  const shadow = prov.shadowed.length > 0 ? ` [shadows ${prov.shadowed.map((s) => s.scope).join(", ")}]` : "";
+  return `${key} = ${formatValue(result.effective[key])}	(${prov.winningScope}${prov.managed ? ", policy" : ""})${shadow}`;
+}
+function runCli(argv, ctx) {
+  const [command, ...rest] = argv;
+  const flags = new Set(rest.filter((a) => a.startsWith("--")));
+  const positional = rest.filter((a) => !a.startsWith("--"));
+  const layer = ctx.layer;
+  switch (command) {
+    case "list":
+      return { output: formatList(ctx, { showOrigin: flags.has("--show-origin"), modifiedOnly: flags.has("--modified") }), layer };
+    case "get": {
+      const key = positional[0];
+      if (!key) return { output: "usage: get <key>", layer };
+      return { output: formatGet(ctx, key), layer };
+    }
+    case "set": {
+      const [key, raw] = positional;
+      if (key === void 0 || raw === void 0) return { output: "usage: set <key> <value>", layer };
+      if (!ctx.dials.keys.includes(key)) return { output: `unknown setting: ${key}`, layer };
+      let value;
+      try {
+        value = coerceByType(typeOf(ctx.dials, key), raw);
+      } catch (error) {
+        return { output: `invalid value for ${key}: ${error.message}`, layer };
+      }
+      const field = (0, import_dials_core2.getObjectShape)(ctx.dials.schema)[key];
+      if (field) {
+        const parsed = field.safeParse(value);
+        if (!parsed.success) {
+          return { output: `invalid value for ${key}: ${parsed.error.issues[0]?.message ?? "validation failed"}`, layer };
+        }
+      }
+      const shown = ctx.dials.sensitivityFor(key) === "secret" ? "\u2022\u2022\u2022\u2022 (set)" : JSON.stringify(value);
+      return { output: `set ${key} = ${shown}`, layer: { ...layer, [key]: value } };
+    }
+    case "unset": {
+      const key = positional[0];
+      if (!key) return { output: "usage: unset <key>", layer };
+      const next = { ...layer };
+      delete next[key];
+      return { output: `unset ${key}`, layer: next };
+    }
+    default:
+      return { output: `usage: dials <list|get|set|unset> [...] (got "${command ?? ""}")`, layer };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  coerceByType,
+  describeForCodegen,
+  formatGet,
+  formatList,
+  runCli,
+  toJsonSchema,
+  toPrompt
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/json-schema.ts","../src/introspect.ts","../src/prompt.ts","../src/cli.ts"],"sourcesContent":["/**\n * @zodal/dials-codegen — machine-interface emit for zodal-dials.\n *\n * - `toJsonSchema(dials, options?)` — a JSON Schema for editor autocomplete/validation of a settings\n *   file (`$schema` target; flat dotted keyspace; secret defaults redacted).\n * - `toPrompt(dials, options?)` — an AI/LLM-consumable description of the settings.\n * - CLI helpers — `runCli`/`formatList`/`formatGet`/`coerceByType`: the logic behind a\n *   `dials get|set|list --show-origin|unset` command (provenance-aware, secrets masked, IO-free).\n */\n\nexport { toJsonSchema } from './json-schema.js';\nexport type { ToJsonSchemaOptions } from './json-schema.js';\n\nexport { toPrompt } from './prompt.js';\nexport type { ToPromptOptions } from './prompt.js';\n\nexport { runCli, formatList, formatGet, coerceByType } from './cli.js';\nexport type { CliContext, RunCliResult, ListOptions } from './cli.js';\n\nexport { describeForCodegen } from './introspect.js';\nexport type { CodegenField } from './introspect.js';\n","/**\n * Emit a JSON Schema for a settings surface — point a settings file's `$schema` at it and any editor\n * gives autocomplete + validation (the VS Code `settings.json` experience). The schema describes the\n * FLAT dotted keyspace; `required` is dropped by default (a settings file is a sparse override, every\n * key optional) and secret defaults are redacted (the schema carries structure, not secret values).\n */\n\nimport { z } from 'zod';\nimport type { DialsDefinition } from '@zodal/dials-core';\nimport { describeForCodegen } from './introspect.js';\n\nexport interface ToJsonSchemaOptions {\n  $id?: string;\n  title?: string;\n  /** Allow keys not in the schema. Default: false (flags typos in a settings file). */\n  additionalProperties?: boolean;\n  /** Keep `required` (default: false — settings overrides are all optional). */\n  keepRequired?: boolean;\n}\n\nfunction fallbackSchema<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>): Record<string, unknown> {\n  const properties: Record<string, Record<string, unknown>> = {};\n  for (const field of describeForCodegen(dials)) {\n    const prop: Record<string, unknown> = {};\n    if (field.type === 'number' || field.type === 'boolean') prop.type = field.type;\n    else if (field.type === 'enum') {\n      prop.type = 'string';\n      if (field.enumValues) prop.enum = field.enumValues;\n    } else if (field.type === 'array') prop.type = 'array';\n    else if (field.type === 'object') prop.type = 'object';\n    else prop.type = 'string';\n    if (field.default !== undefined) prop.default = field.default;\n    if (field.description) prop.description = field.description;\n    properties[field.key] = prop;\n  }\n  return { $schema: 'https://json-schema.org/draft/2020-12/schema', type: 'object', properties };\n}\n\n/** Build a JSON Schema describing the settings (for editor autocomplete/validation). */\nexport function toJsonSchema<T extends z.ZodObject<z.ZodRawShape>>(\n  dials: DialsDefinition<T>,\n  options: ToJsonSchemaOptions = {},\n): Record<string, unknown> {\n  let schema: Record<string, unknown>;\n  try {\n    // z.toJSONSchema throws on unrepresentable types — fall back to a hand-built schema.\n    schema = z.toJSONSchema(dials.schema) as Record<string, unknown>;\n  } catch {\n    schema = fallbackSchema(dials);\n  }\n\n  if (!options.keepRequired) delete schema.required;\n  schema.additionalProperties = options.additionalProperties ?? false;\n  if (options.$id) schema.$id = options.$id;\n  if (options.title) schema.title = options.title;\n\n  const properties = schema.properties as Record<string, Record<string, unknown>> | undefined;\n  if (properties) {\n    // Redact ALL value-bearing keywords for secret keys — not just `default`, but `const`/`enum`/\n    // `examples` too — so a secret's value (or value set) never appears in the emitted schema.\n    for (const key of Object.keys(properties)) {\n      if (dials.sensitivityFor(key) === 'secret') {\n        const prop = properties[key];\n        delete prop.default;\n        delete prop.const;\n        delete prop.enum;\n        delete prop.examples;\n      }\n    }\n    // Allow the conventional `\"$schema\": \"…\"` pointer the settings file carries, so the schema does\n    // not reject the very file it is meant to validate under `additionalProperties: false`.\n    if (schema.additionalProperties === false && !properties['$schema']) {\n      properties['$schema'] = { type: 'string' };\n    }\n  }\n  return schema;\n}\n","/**\n * Internal per-key descriptor for codegen (type, default, enum values, description, sensitivity),\n * derived from a `DialsDefinition` via dials-core introspection + `@zodal/core` enum extraction.\n */\n\nimport type { z } from 'zod';\nimport { baseType, getObjectShape, readMeta } from '@zodal/dials-core';\nimport type { DialsDefinition, Sensitivity } from '@zodal/dials-core';\nimport { getEnumValues } from '@zodal/core';\n\nexport interface CodegenField {\n  key: string;\n  type: string;\n  default: unknown;\n  enumValues?: string[];\n  description?: string;\n  sensitivity: Sensitivity;\n}\n\nfunction safe<R>(fn: () => R): R | undefined {\n  try {\n    return fn();\n  } catch {\n    return undefined;\n  }\n}\n\n/** Describe every setting for codegen consumers (schema/prompt/CLI). */\nexport function describeForCodegen<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>): CodegenField[] {\n  const shape = getObjectShape(dials.schema);\n  return dials.keys.map((key) => {\n    const field = shape[key];\n    const meta = field ? readMeta(field) : {};\n    const enumValues = field ? safe(() => getEnumValues(field) as unknown as string[]) : undefined;\n    return {\n      key,\n      type: field ? baseType(field) : 'unknown',\n      default: dials.defaults[key],\n      enumValues: enumValues && enumValues.length > 0 ? enumValues : undefined,\n      description: typeof meta.description === 'string' ? meta.description : undefined,\n      sensitivity: dials.sensitivityFor(key),\n    };\n  });\n}\n","/**\n * Emit an AI/LLM-consumable description of a settings surface — so an assistant can help a user\n * configure the system (\"set the editor theme to dark\", \"what controls connection pooling?\"). Lists\n * each setting with its type, allowed values, default, and description. Secrets are marked `[secret]`\n * and never carry their default value.\n */\n\nimport type { z } from 'zod';\nimport type { DialsDefinition } from '@zodal/dials-core';\nimport { describeForCodegen } from './introspect.js';\n\nexport interface ToPromptOptions {\n  /** A heading for the settings block. Default: 'Settings'. */\n  title?: string;\n}\n\n/** Build an LLM-consumable description of the settings. */\nexport function toPrompt<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, options: ToPromptOptions = {}): string {\n  const fields = describeForCodegen(dials);\n  const lines: string[] = [];\n  lines.push(`# ${options.title ?? 'Settings'}`);\n  lines.push('');\n  lines.push(\n    `This system exposes ${fields.length} settings. Each is a typed, named parameter identified by a dotted key. ` +\n      'To change one, supply its key and a value of the stated type (for enums, one of the listed values).',\n  );\n  lines.push('');\n  for (const field of fields) {\n    let line = `- \\`${field.key}\\` (${field.type}`;\n    if (field.enumValues) line += `: ${field.enumValues.join(' | ')}`;\n    if (field.sensitivity !== 'secret' && field.default !== undefined) line += `, default ${JSON.stringify(field.default)}`;\n    line += ')';\n    if (field.sensitivity === 'secret') line += ' [secret]';\n    if (field.description) line += ` — ${field.description}`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n","/**\n * Headless CLI helpers for zodal-dials — the logic behind a `dials get|set|list|unset` command,\n * pure and IO-free (the consumer wires stores + argv + stdout). `list --show-origin` surfaces the\n * cascade's PROVENANCE per key (the differentiator, à la `git config --show-origin`). Secrets are\n * always shown masked. `set`/`unset` return a NEW editable layer; they never mutate the input.\n */\n\nimport type { z } from 'zod';\nimport { baseType, getObjectShape, isSecretRef } from '@zodal/dials-core';\nimport type { DialsDefinition, Layer, ScopedLayer, SettingKey } from '@zodal/dials-core';\n\nexport interface CliContext<T extends z.ZodObject<z.ZodRawShape>> {\n  dials: DialsDefinition<T>;\n  /** The ordered scope stack BELOW the editable layer (defaults are prepended by resolve). */\n  stack?: ScopedLayer[];\n  /** The editable (user) layer being get/set. */\n  layer: Layer;\n  /** The scope id of the editable layer. Default: 'user'. */\n  scope?: string;\n}\n\nexport interface RunCliResult {\n  output: string;\n  /** The (possibly updated) editable layer — changed by `set`/`unset`, unchanged otherwise. */\n  layer: Layer;\n}\n\n/** Coerce a raw CLI string to a value of the given base type. Throws on a malformed number/JSON. */\nexport function coerceByType(type: string, raw: string): unknown {\n  switch (type) {\n    case 'number': {\n      const n = Number(raw);\n      if (Number.isNaN(n)) throw new Error(`\"${raw}\" is not a number`);\n      return n;\n    }\n    case 'boolean': {\n      const t = raw.toLowerCase();\n      if (t === 'true' || t === '1' || t === 'yes') return true;\n      if (t === 'false' || t === '0' || t === 'no') return false;\n      throw new Error(`\"${raw}\" is not a boolean (use true/false)`);\n    }\n    case 'object':\n    case 'array':\n      return JSON.parse(raw);\n    case 'string':\n    case 'enum':\n      return raw;\n    default:\n      try {\n        return JSON.parse(raw);\n      } catch {\n        return raw;\n      }\n  }\n}\n\nfunction typeOf<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, key: SettingKey): string {\n  const field = getObjectShape(dials.schema)[key];\n  return field ? baseType(field) : 'unknown';\n}\n\nfunction formatValue(value: unknown): string {\n  if (isSecretRef(value)) return value.masked;\n  return JSON.stringify(value);\n}\n\nfunction resolveContext<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>): ReturnType<DialsDefinition<T>['resolve']> {\n  const stack: ScopedLayer[] = [...(ctx.stack ?? []), { scope: ctx.scope ?? 'user', layer: ctx.layer }];\n  return ctx.dials.resolve(stack, { maskSecrets: true });\n}\n\nexport interface ListOptions {\n  showOrigin?: boolean;\n  modifiedOnly?: boolean;\n}\n\n/** Format the effective settings as lines (`key = value`, optionally `(scope)`). Secrets masked. */\nexport function formatList<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, options: ListOptions = {}): string {\n  const result = resolveContext(ctx);\n  const lines: string[] = [];\n  // schema keys first, then any ad-hoc (out-of-schema) keys that resolved — so nothing is hidden.\n  const extras = Object.keys(result.provenance).filter((k) => !ctx.dials.keys.includes(k));\n  for (const key of [...ctx.dials.keys, ...extras]) {\n    const prov = result.provenance[key];\n    if (!prov) continue; // unset\n    if (options.modifiedOnly && prov.winningScope === 'default') continue;\n    let line = `${key} = ${formatValue(result.effective[key])}`;\n    if (options.showOrigin) line += `\\t(${prov.winningScope}${prov.managed ? ', policy' : ''})`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n\n/** Format a single setting's effective value + origin. */\nexport function formatGet<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, key: SettingKey): string {\n  if (!ctx.dials.keys.includes(key)) return `unknown setting: ${key}`;\n  const result = resolveContext(ctx);\n  const prov = result.provenance[key];\n  if (!prov) return `${key} is unset`;\n  const shadow = prov.shadowed.length > 0 ? ` [shadows ${prov.shadowed.map((s) => s.scope).join(', ')}]` : '';\n  return `${key} = ${formatValue(result.effective[key])}\\t(${prov.winningScope}${prov.managed ? ', policy' : ''})${shadow}`;\n}\n\n/**\n * Dispatch a CLI command against the context. `argv` is the command + args (e.g. `['set',\n * 'editor.fontSize', '16']`). Returns the output text and the (possibly new) editable layer. Pure.\n */\nexport function runCli<T extends z.ZodObject<z.ZodRawShape>>(argv: string[], ctx: CliContext<T>): RunCliResult {\n  const [command, ...rest] = argv;\n  const flags = new Set(rest.filter((a) => a.startsWith('--')));\n  const positional = rest.filter((a) => !a.startsWith('--'));\n  const layer = ctx.layer;\n\n  switch (command) {\n    case 'list':\n      return { output: formatList(ctx, { showOrigin: flags.has('--show-origin'), modifiedOnly: flags.has('--modified') }), layer };\n    case 'get': {\n      const key = positional[0];\n      if (!key) return { output: 'usage: get <key>', layer };\n      return { output: formatGet(ctx, key), layer };\n    }\n    case 'set': {\n      const [key, raw] = positional;\n      if (key === undefined || raw === undefined) return { output: 'usage: set <key> <value>', layer };\n      if (!ctx.dials.keys.includes(key)) return { output: `unknown setting: ${key}`, layer };\n      let value: unknown;\n      try {\n        value = coerceByType(typeOf(ctx.dials, key), raw);\n      } catch (error) {\n        return { output: `invalid value for ${key}: ${(error as Error).message}`, layer };\n      }\n      // Validate the coerced value against the field schema (rejects out-of-enum / out-of-range).\n      const field = getObjectShape(ctx.dials.schema)[key];\n      if (field) {\n        const parsed = field.safeParse(value);\n        if (!parsed.success) {\n          return { output: `invalid value for ${key}: ${parsed.error.issues[0]?.message ?? 'validation failed'}`, layer };\n        }\n      }\n      // Never echo a secret's value back to stdout/history — confirm with a mask.\n      const shown = ctx.dials.sensitivityFor(key) === 'secret' ? '•••• (set)' : JSON.stringify(value);\n      return { output: `set ${key} = ${shown}`, layer: { ...layer, [key]: value } };\n    }\n    case 'unset': {\n      const key = positional[0];\n      if (!key) return { output: 'usage: unset <key>', layer };\n      const next = { ...layer };\n      delete next[key];\n      return { output: `unset ${key}`, layer: next };\n    }\n    default:\n      return { output: `usage: dials <list|get|set|unset> [...] (got \"${command ?? ''}\")`, layer };\n  }\n}\n"],"mappings":"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","names":["import_dials_core"]}

package/dist/index.d.cts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { DialsDefinition, ScopedLayer, Layer, SettingKey, Sensitivity } from '@zodal/dials-core';
+
+/**
+ * Emit a JSON Schema for a settings surface — point a settings file's `$schema` at it and any editor
+ * gives autocomplete + validation (the VS Code `settings.json` experience). The schema describes the
+ * FLAT dotted keyspace; `required` is dropped by default (a settings file is a sparse override, every
+ * key optional) and secret defaults are redacted (the schema carries structure, not secret values).
+ */
+
+interface ToJsonSchemaOptions {
+    $id?: string;
+    title?: string;
+    /** Allow keys not in the schema. Default: false (flags typos in a settings file). */
+    additionalProperties?: boolean;
+    /** Keep `required` (default: false — settings overrides are all optional). */
+    keepRequired?: boolean;
+}
+/** Build a JSON Schema describing the settings (for editor autocomplete/validation). */
+declare function toJsonSchema<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, options?: ToJsonSchemaOptions): Record<string, unknown>;
+
+/**
+ * Emit an AI/LLM-consumable description of a settings surface — so an assistant can help a user
+ * configure the system ("set the editor theme to dark", "what controls connection pooling?"). Lists
+ * each setting with its type, allowed values, default, and description. Secrets are marked `[secret]`
+ * and never carry their default value.
+ */
+
+interface ToPromptOptions {
+    /** A heading for the settings block. Default: 'Settings'. */
+    title?: string;
+}
+/** Build an LLM-consumable description of the settings. */
+declare function toPrompt<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, options?: ToPromptOptions): string;
+
+/**
+ * Headless CLI helpers for zodal-dials — the logic behind a `dials get|set|list|unset` command,
+ * pure and IO-free (the consumer wires stores + argv + stdout). `list --show-origin` surfaces the
+ * cascade's PROVENANCE per key (the differentiator, à la `git config --show-origin`). Secrets are
+ * always shown masked. `set`/`unset` return a NEW editable layer; they never mutate the input.
+ */
+
+interface CliContext<T extends z.ZodObject<z.ZodRawShape>> {
+    dials: DialsDefinition<T>;
+    /** The ordered scope stack BELOW the editable layer (defaults are prepended by resolve). */
+    stack?: ScopedLayer[];
+    /** The editable (user) layer being get/set. */
+    layer: Layer;
+    /** The scope id of the editable layer. Default: 'user'. */
+    scope?: string;
+}
+interface RunCliResult {
+    output: string;
+    /** The (possibly updated) editable layer — changed by `set`/`unset`, unchanged otherwise. */
+    layer: Layer;
+}
+/** Coerce a raw CLI string to a value of the given base type. Throws on a malformed number/JSON. */
+declare function coerceByType(type: string, raw: string): unknown;
+interface ListOptions {
+    showOrigin?: boolean;
+    modifiedOnly?: boolean;
+}
+/** Format the effective settings as lines (`key = value`, optionally `(scope)`). Secrets masked. */
+declare function formatList<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, options?: ListOptions): string;
+/** Format a single setting's effective value + origin. */
+declare function formatGet<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, key: SettingKey): string;
+/**
+ * Dispatch a CLI command against the context. `argv` is the command + args (e.g. `['set',
+ * 'editor.fontSize', '16']`). Returns the output text and the (possibly new) editable layer. Pure.
+ */
+declare function runCli<T extends z.ZodObject<z.ZodRawShape>>(argv: string[], ctx: CliContext<T>): RunCliResult;
+
+/**
+ * Internal per-key descriptor for codegen (type, default, enum values, description, sensitivity),
+ * derived from a `DialsDefinition` via dials-core introspection + `@zodal/core` enum extraction.
+ */
+
+interface CodegenField {
+    key: string;
+    type: string;
+    default: unknown;
+    enumValues?: string[];
+    description?: string;
+    sensitivity: Sensitivity;
+}
+/** Describe every setting for codegen consumers (schema/prompt/CLI). */
+declare function describeForCodegen<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>): CodegenField[];
+
+export { type CliContext, type CodegenField, type ListOptions, type RunCliResult, type ToJsonSchemaOptions, type ToPromptOptions, coerceByType, describeForCodegen, formatGet, formatList, runCli, toJsonSchema, toPrompt };

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { DialsDefinition, ScopedLayer, Layer, SettingKey, Sensitivity } from '@zodal/dials-core';
+
+/**
+ * Emit a JSON Schema for a settings surface — point a settings file's `$schema` at it and any editor
+ * gives autocomplete + validation (the VS Code `settings.json` experience). The schema describes the
+ * FLAT dotted keyspace; `required` is dropped by default (a settings file is a sparse override, every
+ * key optional) and secret defaults are redacted (the schema carries structure, not secret values).
+ */
+
+interface ToJsonSchemaOptions {
+    $id?: string;
+    title?: string;
+    /** Allow keys not in the schema. Default: false (flags typos in a settings file). */
+    additionalProperties?: boolean;
+    /** Keep `required` (default: false — settings overrides are all optional). */
+    keepRequired?: boolean;
+}
+/** Build a JSON Schema describing the settings (for editor autocomplete/validation). */
+declare function toJsonSchema<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, options?: ToJsonSchemaOptions): Record<string, unknown>;
+
+/**
+ * Emit an AI/LLM-consumable description of a settings surface — so an assistant can help a user
+ * configure the system ("set the editor theme to dark", "what controls connection pooling?"). Lists
+ * each setting with its type, allowed values, default, and description. Secrets are marked `[secret]`
+ * and never carry their default value.
+ */
+
+interface ToPromptOptions {
+    /** A heading for the settings block. Default: 'Settings'. */
+    title?: string;
+}
+/** Build an LLM-consumable description of the settings. */
+declare function toPrompt<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, options?: ToPromptOptions): string;
+
+/**
+ * Headless CLI helpers for zodal-dials — the logic behind a `dials get|set|list|unset` command,
+ * pure and IO-free (the consumer wires stores + argv + stdout). `list --show-origin` surfaces the
+ * cascade's PROVENANCE per key (the differentiator, à la `git config --show-origin`). Secrets are
+ * always shown masked. `set`/`unset` return a NEW editable layer; they never mutate the input.
+ */
+
+interface CliContext<T extends z.ZodObject<z.ZodRawShape>> {
+    dials: DialsDefinition<T>;
+    /** The ordered scope stack BELOW the editable layer (defaults are prepended by resolve). */
+    stack?: ScopedLayer[];
+    /** The editable (user) layer being get/set. */
+    layer: Layer;
+    /** The scope id of the editable layer. Default: 'user'. */
+    scope?: string;
+}
+interface RunCliResult {
+    output: string;
+    /** The (possibly updated) editable layer — changed by `set`/`unset`, unchanged otherwise. */
+    layer: Layer;
+}
+/** Coerce a raw CLI string to a value of the given base type. Throws on a malformed number/JSON. */
+declare function coerceByType(type: string, raw: string): unknown;
+interface ListOptions {
+    showOrigin?: boolean;
+    modifiedOnly?: boolean;
+}
+/** Format the effective settings as lines (`key = value`, optionally `(scope)`). Secrets masked. */
+declare function formatList<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, options?: ListOptions): string;
+/** Format a single setting's effective value + origin. */
+declare function formatGet<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, key: SettingKey): string;
+/**
+ * Dispatch a CLI command against the context. `argv` is the command + args (e.g. `['set',
+ * 'editor.fontSize', '16']`). Returns the output text and the (possibly new) editable layer. Pure.
+ */
+declare function runCli<T extends z.ZodObject<z.ZodRawShape>>(argv: string[], ctx: CliContext<T>): RunCliResult;
+
+/**
+ * Internal per-key descriptor for codegen (type, default, enum values, description, sensitivity),
+ * derived from a `DialsDefinition` via dials-core introspection + `@zodal/core` enum extraction.
+ */
+
+interface CodegenField {
+    key: string;
+    type: string;
+    default: unknown;
+    enumValues?: string[];
+    description?: string;
+    sensitivity: Sensitivity;
+}
+/** Describe every setting for codegen consumers (schema/prompt/CLI). */
+declare function describeForCodegen<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>): CodegenField[];
+
+export { type CliContext, type CodegenField, type ListOptions, type RunCliResult, type ToJsonSchemaOptions, type ToPromptOptions, coerceByType, describeForCodegen, formatGet, formatList, runCli, toJsonSchema, toPrompt };

package/dist/index.js

@@ -0,0 +1,216 @@
+// src/json-schema.ts
+import { z } from "zod";
+
+// src/introspect.ts
+import { baseType, getObjectShape, readMeta } from "@zodal/dials-core";
+import { getEnumValues } from "@zodal/core";
+function safe(fn) {
+  try {
+    return fn();
+  } catch {
+    return void 0;
+  }
+}
+function describeForCodegen(dials) {
+  const shape = getObjectShape(dials.schema);
+  return dials.keys.map((key) => {
+    const field = shape[key];
+    const meta = field ? readMeta(field) : {};
+    const enumValues = field ? safe(() => getEnumValues(field)) : void 0;
+    return {
+      key,
+      type: field ? baseType(field) : "unknown",
+      default: dials.defaults[key],
+      enumValues: enumValues && enumValues.length > 0 ? enumValues : void 0,
+      description: typeof meta.description === "string" ? meta.description : void 0,
+      sensitivity: dials.sensitivityFor(key)
+    };
+  });
+}
+
+// src/json-schema.ts
+function fallbackSchema(dials) {
+  const properties = {};
+  for (const field of describeForCodegen(dials)) {
+    const prop = {};
+    if (field.type === "number" || field.type === "boolean") prop.type = field.type;
+    else if (field.type === "enum") {
+      prop.type = "string";
+      if (field.enumValues) prop.enum = field.enumValues;
+    } else if (field.type === "array") prop.type = "array";
+    else if (field.type === "object") prop.type = "object";
+    else prop.type = "string";
+    if (field.default !== void 0) prop.default = field.default;
+    if (field.description) prop.description = field.description;
+    properties[field.key] = prop;
+  }
+  return { $schema: "https://json-schema.org/draft/2020-12/schema", type: "object", properties };
+}
+function toJsonSchema(dials, options = {}) {
+  let schema;
+  try {
+    schema = z.toJSONSchema(dials.schema);
+  } catch {
+    schema = fallbackSchema(dials);
+  }
+  if (!options.keepRequired) delete schema.required;
+  schema.additionalProperties = options.additionalProperties ?? false;
+  if (options.$id) schema.$id = options.$id;
+  if (options.title) schema.title = options.title;
+  const properties = schema.properties;
+  if (properties) {
+    for (const key of Object.keys(properties)) {
+      if (dials.sensitivityFor(key) === "secret") {
+        const prop = properties[key];
+        delete prop.default;
+        delete prop.const;
+        delete prop.enum;
+        delete prop.examples;
+      }
+    }
+    if (schema.additionalProperties === false && !properties["$schema"]) {
+      properties["$schema"] = { type: "string" };
+    }
+  }
+  return schema;
+}
+
+// src/prompt.ts
+function toPrompt(dials, options = {}) {
+  const fields = describeForCodegen(dials);
+  const lines = [];
+  lines.push(`# ${options.title ?? "Settings"}`);
+  lines.push("");
+  lines.push(
+    `This system exposes ${fields.length} settings. Each is a typed, named parameter identified by a dotted key. To change one, supply its key and a value of the stated type (for enums, one of the listed values).`
+  );
+  lines.push("");
+  for (const field of fields) {
+    let line = `- \`${field.key}\` (${field.type}`;
+    if (field.enumValues) line += `: ${field.enumValues.join(" | ")}`;
+    if (field.sensitivity !== "secret" && field.default !== void 0) line += `, default ${JSON.stringify(field.default)}`;
+    line += ")";
+    if (field.sensitivity === "secret") line += " [secret]";
+    if (field.description) line += ` \u2014 ${field.description}`;
+    lines.push(line);
+  }
+  return lines.join("\n");
+}
+
+// src/cli.ts
+import { baseType as baseType2, getObjectShape as getObjectShape2, isSecretRef } from "@zodal/dials-core";
+function coerceByType(type, raw) {
+  switch (type) {
+    case "number": {
+      const n = Number(raw);
+      if (Number.isNaN(n)) throw new Error(`"${raw}" is not a number`);
+      return n;
+    }
+    case "boolean": {
+      const t = raw.toLowerCase();
+      if (t === "true" || t === "1" || t === "yes") return true;
+      if (t === "false" || t === "0" || t === "no") return false;
+      throw new Error(`"${raw}" is not a boolean (use true/false)`);
+    }
+    case "object":
+    case "array":
+      return JSON.parse(raw);
+    case "string":
+    case "enum":
+      return raw;
+    default:
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return raw;
+      }
+  }
+}
+function typeOf(dials, key) {
+  const field = getObjectShape2(dials.schema)[key];
+  return field ? baseType2(field) : "unknown";
+}
+function formatValue(value) {
+  if (isSecretRef(value)) return value.masked;
+  return JSON.stringify(value);
+}
+function resolveContext(ctx) {
+  const stack = [...ctx.stack ?? [], { scope: ctx.scope ?? "user", layer: ctx.layer }];
+  return ctx.dials.resolve(stack, { maskSecrets: true });
+}
+function formatList(ctx, options = {}) {
+  const result = resolveContext(ctx);
+  const lines = [];
+  const extras = Object.keys(result.provenance).filter((k) => !ctx.dials.keys.includes(k));
+  for (const key of [...ctx.dials.keys, ...extras]) {
+    const prov = result.provenance[key];
+    if (!prov) continue;
+    if (options.modifiedOnly && prov.winningScope === "default") continue;
+    let line = `${key} = ${formatValue(result.effective[key])}`;
+    if (options.showOrigin) line += `	(${prov.winningScope}${prov.managed ? ", policy" : ""})`;
+    lines.push(line);
+  }
+  return lines.join("\n");
+}
+function formatGet(ctx, key) {
+  if (!ctx.dials.keys.includes(key)) return `unknown setting: ${key}`;
+  const result = resolveContext(ctx);
+  const prov = result.provenance[key];
+  if (!prov) return `${key} is unset`;
+  const shadow = prov.shadowed.length > 0 ? ` [shadows ${prov.shadowed.map((s) => s.scope).join(", ")}]` : "";
+  return `${key} = ${formatValue(result.effective[key])}	(${prov.winningScope}${prov.managed ? ", policy" : ""})${shadow}`;
+}
+function runCli(argv, ctx) {
+  const [command, ...rest] = argv;
+  const flags = new Set(rest.filter((a) => a.startsWith("--")));
+  const positional = rest.filter((a) => !a.startsWith("--"));
+  const layer = ctx.layer;
+  switch (command) {
+    case "list":
+      return { output: formatList(ctx, { showOrigin: flags.has("--show-origin"), modifiedOnly: flags.has("--modified") }), layer };
+    case "get": {
+      const key = positional[0];
+      if (!key) return { output: "usage: get <key>", layer };
+      return { output: formatGet(ctx, key), layer };
+    }
+    case "set": {
+      const [key, raw] = positional;
+      if (key === void 0 || raw === void 0) return { output: "usage: set <key> <value>", layer };
+      if (!ctx.dials.keys.includes(key)) return { output: `unknown setting: ${key}`, layer };
+      let value;
+      try {
+        value = coerceByType(typeOf(ctx.dials, key), raw);
+      } catch (error) {
+        return { output: `invalid value for ${key}: ${error.message}`, layer };
+      }
+      const field = getObjectShape2(ctx.dials.schema)[key];
+      if (field) {
+        const parsed = field.safeParse(value);
+        if (!parsed.success) {
+          return { output: `invalid value for ${key}: ${parsed.error.issues[0]?.message ?? "validation failed"}`, layer };
+        }
+      }
+      const shown = ctx.dials.sensitivityFor(key) === "secret" ? "\u2022\u2022\u2022\u2022 (set)" : JSON.stringify(value);
+      return { output: `set ${key} = ${shown}`, layer: { ...layer, [key]: value } };
+    }
+    case "unset": {
+      const key = positional[0];
+      if (!key) return { output: "usage: unset <key>", layer };
+      const next = { ...layer };
+      delete next[key];
+      return { output: `unset ${key}`, layer: next };
+    }
+    default:
+      return { output: `usage: dials <list|get|set|unset> [...] (got "${command ?? ""}")`, layer };
+  }
+}
+export {
+  coerceByType,
+  describeForCodegen,
+  formatGet,
+  formatList,
+  runCli,
+  toJsonSchema,
+  toPrompt
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/json-schema.ts","../src/introspect.ts","../src/prompt.ts","../src/cli.ts"],"sourcesContent":["/**\n * Emit a JSON Schema for a settings surface — point a settings file's `$schema` at it and any editor\n * gives autocomplete + validation (the VS Code `settings.json` experience). The schema describes the\n * FLAT dotted keyspace; `required` is dropped by default (a settings file is a sparse override, every\n * key optional) and secret defaults are redacted (the schema carries structure, not secret values).\n */\n\nimport { z } from 'zod';\nimport type { DialsDefinition } from '@zodal/dials-core';\nimport { describeForCodegen } from './introspect.js';\n\nexport interface ToJsonSchemaOptions {\n  $id?: string;\n  title?: string;\n  /** Allow keys not in the schema. Default: false (flags typos in a settings file). */\n  additionalProperties?: boolean;\n  /** Keep `required` (default: false — settings overrides are all optional). */\n  keepRequired?: boolean;\n}\n\nfunction fallbackSchema<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>): Record<string, unknown> {\n  const properties: Record<string, Record<string, unknown>> = {};\n  for (const field of describeForCodegen(dials)) {\n    const prop: Record<string, unknown> = {};\n    if (field.type === 'number' || field.type === 'boolean') prop.type = field.type;\n    else if (field.type === 'enum') {\n      prop.type = 'string';\n      if (field.enumValues) prop.enum = field.enumValues;\n    } else if (field.type === 'array') prop.type = 'array';\n    else if (field.type === 'object') prop.type = 'object';\n    else prop.type = 'string';\n    if (field.default !== undefined) prop.default = field.default;\n    if (field.description) prop.description = field.description;\n    properties[field.key] = prop;\n  }\n  return { $schema: 'https://json-schema.org/draft/2020-12/schema', type: 'object', properties };\n}\n\n/** Build a JSON Schema describing the settings (for editor autocomplete/validation). */\nexport function toJsonSchema<T extends z.ZodObject<z.ZodRawShape>>(\n  dials: DialsDefinition<T>,\n  options: ToJsonSchemaOptions = {},\n): Record<string, unknown> {\n  let schema: Record<string, unknown>;\n  try {\n    // z.toJSONSchema throws on unrepresentable types — fall back to a hand-built schema.\n    schema = z.toJSONSchema(dials.schema) as Record<string, unknown>;\n  } catch {\n    schema = fallbackSchema(dials);\n  }\n\n  if (!options.keepRequired) delete schema.required;\n  schema.additionalProperties = options.additionalProperties ?? false;\n  if (options.$id) schema.$id = options.$id;\n  if (options.title) schema.title = options.title;\n\n  const properties = schema.properties as Record<string, Record<string, unknown>> | undefined;\n  if (properties) {\n    // Redact ALL value-bearing keywords for secret keys — not just `default`, but `const`/`enum`/\n    // `examples` too — so a secret's value (or value set) never appears in the emitted schema.\n    for (const key of Object.keys(properties)) {\n      if (dials.sensitivityFor(key) === 'secret') {\n        const prop = properties[key];\n        delete prop.default;\n        delete prop.const;\n        delete prop.enum;\n        delete prop.examples;\n      }\n    }\n    // Allow the conventional `\"$schema\": \"…\"` pointer the settings file carries, so the schema does\n    // not reject the very file it is meant to validate under `additionalProperties: false`.\n    if (schema.additionalProperties === false && !properties['$schema']) {\n      properties['$schema'] = { type: 'string' };\n    }\n  }\n  return schema;\n}\n","/**\n * Internal per-key descriptor for codegen (type, default, enum values, description, sensitivity),\n * derived from a `DialsDefinition` via dials-core introspection + `@zodal/core` enum extraction.\n */\n\nimport type { z } from 'zod';\nimport { baseType, getObjectShape, readMeta } from '@zodal/dials-core';\nimport type { DialsDefinition, Sensitivity } from '@zodal/dials-core';\nimport { getEnumValues } from '@zodal/core';\n\nexport interface CodegenField {\n  key: string;\n  type: string;\n  default: unknown;\n  enumValues?: string[];\n  description?: string;\n  sensitivity: Sensitivity;\n}\n\nfunction safe<R>(fn: () => R): R | undefined {\n  try {\n    return fn();\n  } catch {\n    return undefined;\n  }\n}\n\n/** Describe every setting for codegen consumers (schema/prompt/CLI). */\nexport function describeForCodegen<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>): CodegenField[] {\n  const shape = getObjectShape(dials.schema);\n  return dials.keys.map((key) => {\n    const field = shape[key];\n    const meta = field ? readMeta(field) : {};\n    const enumValues = field ? safe(() => getEnumValues(field) as unknown as string[]) : undefined;\n    return {\n      key,\n      type: field ? baseType(field) : 'unknown',\n      default: dials.defaults[key],\n      enumValues: enumValues && enumValues.length > 0 ? enumValues : undefined,\n      description: typeof meta.description === 'string' ? meta.description : undefined,\n      sensitivity: dials.sensitivityFor(key),\n    };\n  });\n}\n","/**\n * Emit an AI/LLM-consumable description of a settings surface — so an assistant can help a user\n * configure the system (\"set the editor theme to dark\", \"what controls connection pooling?\"). Lists\n * each setting with its type, allowed values, default, and description. Secrets are marked `[secret]`\n * and never carry their default value.\n */\n\nimport type { z } from 'zod';\nimport type { DialsDefinition } from '@zodal/dials-core';\nimport { describeForCodegen } from './introspect.js';\n\nexport interface ToPromptOptions {\n  /** A heading for the settings block. Default: 'Settings'. */\n  title?: string;\n}\n\n/** Build an LLM-consumable description of the settings. */\nexport function toPrompt<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, options: ToPromptOptions = {}): string {\n  const fields = describeForCodegen(dials);\n  const lines: string[] = [];\n  lines.push(`# ${options.title ?? 'Settings'}`);\n  lines.push('');\n  lines.push(\n    `This system exposes ${fields.length} settings. Each is a typed, named parameter identified by a dotted key. ` +\n      'To change one, supply its key and a value of the stated type (for enums, one of the listed values).',\n  );\n  lines.push('');\n  for (const field of fields) {\n    let line = `- \\`${field.key}\\` (${field.type}`;\n    if (field.enumValues) line += `: ${field.enumValues.join(' | ')}`;\n    if (field.sensitivity !== 'secret' && field.default !== undefined) line += `, default ${JSON.stringify(field.default)}`;\n    line += ')';\n    if (field.sensitivity === 'secret') line += ' [secret]';\n    if (field.description) line += ` — ${field.description}`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n","/**\n * Headless CLI helpers for zodal-dials — the logic behind a `dials get|set|list|unset` command,\n * pure and IO-free (the consumer wires stores + argv + stdout). `list --show-origin` surfaces the\n * cascade's PROVENANCE per key (the differentiator, à la `git config --show-origin`). Secrets are\n * always shown masked. `set`/`unset` return a NEW editable layer; they never mutate the input.\n */\n\nimport type { z } from 'zod';\nimport { baseType, getObjectShape, isSecretRef } from '@zodal/dials-core';\nimport type { DialsDefinition, Layer, ScopedLayer, SettingKey } from '@zodal/dials-core';\n\nexport interface CliContext<T extends z.ZodObject<z.ZodRawShape>> {\n  dials: DialsDefinition<T>;\n  /** The ordered scope stack BELOW the editable layer (defaults are prepended by resolve). */\n  stack?: ScopedLayer[];\n  /** The editable (user) layer being get/set. */\n  layer: Layer;\n  /** The scope id of the editable layer. Default: 'user'. */\n  scope?: string;\n}\n\nexport interface RunCliResult {\n  output: string;\n  /** The (possibly updated) editable layer — changed by `set`/`unset`, unchanged otherwise. */\n  layer: Layer;\n}\n\n/** Coerce a raw CLI string to a value of the given base type. Throws on a malformed number/JSON. */\nexport function coerceByType(type: string, raw: string): unknown {\n  switch (type) {\n    case 'number': {\n      const n = Number(raw);\n      if (Number.isNaN(n)) throw new Error(`\"${raw}\" is not a number`);\n      return n;\n    }\n    case 'boolean': {\n      const t = raw.toLowerCase();\n      if (t === 'true' || t === '1' || t === 'yes') return true;\n      if (t === 'false' || t === '0' || t === 'no') return false;\n      throw new Error(`\"${raw}\" is not a boolean (use true/false)`);\n    }\n    case 'object':\n    case 'array':\n      return JSON.parse(raw);\n    case 'string':\n    case 'enum':\n      return raw;\n    default:\n      try {\n        return JSON.parse(raw);\n      } catch {\n        return raw;\n      }\n  }\n}\n\nfunction typeOf<T extends z.ZodObject<z.ZodRawShape>>(dials: DialsDefinition<T>, key: SettingKey): string {\n  const field = getObjectShape(dials.schema)[key];\n  return field ? baseType(field) : 'unknown';\n}\n\nfunction formatValue(value: unknown): string {\n  if (isSecretRef(value)) return value.masked;\n  return JSON.stringify(value);\n}\n\nfunction resolveContext<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>): ReturnType<DialsDefinition<T>['resolve']> {\n  const stack: ScopedLayer[] = [...(ctx.stack ?? []), { scope: ctx.scope ?? 'user', layer: ctx.layer }];\n  return ctx.dials.resolve(stack, { maskSecrets: true });\n}\n\nexport interface ListOptions {\n  showOrigin?: boolean;\n  modifiedOnly?: boolean;\n}\n\n/** Format the effective settings as lines (`key = value`, optionally `(scope)`). Secrets masked. */\nexport function formatList<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, options: ListOptions = {}): string {\n  const result = resolveContext(ctx);\n  const lines: string[] = [];\n  // schema keys first, then any ad-hoc (out-of-schema) keys that resolved — so nothing is hidden.\n  const extras = Object.keys(result.provenance).filter((k) => !ctx.dials.keys.includes(k));\n  for (const key of [...ctx.dials.keys, ...extras]) {\n    const prov = result.provenance[key];\n    if (!prov) continue; // unset\n    if (options.modifiedOnly && prov.winningScope === 'default') continue;\n    let line = `${key} = ${formatValue(result.effective[key])}`;\n    if (options.showOrigin) line += `\\t(${prov.winningScope}${prov.managed ? ', policy' : ''})`;\n    lines.push(line);\n  }\n  return lines.join('\\n');\n}\n\n/** Format a single setting's effective value + origin. */\nexport function formatGet<T extends z.ZodObject<z.ZodRawShape>>(ctx: CliContext<T>, key: SettingKey): string {\n  if (!ctx.dials.keys.includes(key)) return `unknown setting: ${key}`;\n  const result = resolveContext(ctx);\n  const prov = result.provenance[key];\n  if (!prov) return `${key} is unset`;\n  const shadow = prov.shadowed.length > 0 ? ` [shadows ${prov.shadowed.map((s) => s.scope).join(', ')}]` : '';\n  return `${key} = ${formatValue(result.effective[key])}\\t(${prov.winningScope}${prov.managed ? ', policy' : ''})${shadow}`;\n}\n\n/**\n * Dispatch a CLI command against the context. `argv` is the command + args (e.g. `['set',\n * 'editor.fontSize', '16']`). Returns the output text and the (possibly new) editable layer. Pure.\n */\nexport function runCli<T extends z.ZodObject<z.ZodRawShape>>(argv: string[], ctx: CliContext<T>): RunCliResult {\n  const [command, ...rest] = argv;\n  const flags = new Set(rest.filter((a) => a.startsWith('--')));\n  const positional = rest.filter((a) => !a.startsWith('--'));\n  const layer = ctx.layer;\n\n  switch (command) {\n    case 'list':\n      return { output: formatList(ctx, { showOrigin: flags.has('--show-origin'), modifiedOnly: flags.has('--modified') }), layer };\n    case 'get': {\n      const key = positional[0];\n      if (!key) return { output: 'usage: get <key>', layer };\n      return { output: formatGet(ctx, key), layer };\n    }\n    case 'set': {\n      const [key, raw] = positional;\n      if (key === undefined || raw === undefined) return { output: 'usage: set <key> <value>', layer };\n      if (!ctx.dials.keys.includes(key)) return { output: `unknown setting: ${key}`, layer };\n      let value: unknown;\n      try {\n        value = coerceByType(typeOf(ctx.dials, key), raw);\n      } catch (error) {\n        return { output: `invalid value for ${key}: ${(error as Error).message}`, layer };\n      }\n      // Validate the coerced value against the field schema (rejects out-of-enum / out-of-range).\n      const field = getObjectShape(ctx.dials.schema)[key];\n      if (field) {\n        const parsed = field.safeParse(value);\n        if (!parsed.success) {\n          return { output: `invalid value for ${key}: ${parsed.error.issues[0]?.message ?? 'validation failed'}`, layer };\n        }\n      }\n      // Never echo a secret's value back to stdout/history — confirm with a mask.\n      const shown = ctx.dials.sensitivityFor(key) === 'secret' ? '•••• (set)' : JSON.stringify(value);\n      return { output: `set ${key} = ${shown}`, layer: { ...layer, [key]: value } };\n    }\n    case 'unset': {\n      const key = positional[0];\n      if (!key) return { output: 'usage: unset <key>', layer };\n      const next = { ...layer };\n      delete next[key];\n      return { output: `unset ${key}`, layer: next };\n    }\n    default:\n      return { output: `usage: dials <list|get|set|unset> [...] (got \"${command ?? ''}\")`, layer };\n  }\n}\n"],"mappings":"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","names":["baseType","getObjectShape"]}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@zodal/dials-codegen",
+  "version": "0.1.0",
+  "description": "Machine-interface emit for zodal-dials: JSON Schema (editor autocomplete), toPrompt (AI), and CLI helpers (get/set/list --show-origin)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@zodal/core": "^0.1.2",
+    "@zodal/dials-core": "^0.1.0",
+    "zod": ">=4.1.13"
+  },
+  "devDependencies": {
+    "@zodal/core": "^0.1.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0",
+    "zod": "^4.4.0",
+    "@zodal/dials-core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}