@ontrails/config 1.0.0-beta.14 → 1.0.0-beta.15

package/dist/trails/config-explain.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-explain.js","sourceRoot":"","sources":["../../src/trails/config-explain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;CACnB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACxC,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,YAAY,GAAG,CACnB,OAA6C,EAC7C,MAAc,EACwB,EAAE,CACxC,MAAM;IACJ,CAAC,CAAC,OAAO,CAAC,MAAM,CACZ,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CACxE;IACH,CAAC,CAAC,OAAO,CAAC;AAEd,wFAAwF;AACxF,MAAM,gBAAgB,GAAG,CACvB,KAAkB,EACyB,EAAE;IAC7C,MAAM,IAAI,GAA8C;QACtD,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,uEAAuE;AACvE,MAAM,aAAa,GAAG,CACpB,KAAkB,EAClB,OAAkD,EACP,EAAE;IAC7C,IAAI,QAAQ,GAAG,OAAO,CAAC;IACvB,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,gBAAgB,EAAE;IACnD,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,oBAAoB;SAC3B;KACF;IACD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CAAC,iDAAiD,CAAC;aAC3D,OAAO,CAAC,EAAE,CAAC;KACf,CAAC;IACF,MAAM,EAAE,MAAM;IACd,IAAI,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;IACpC,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,CAAC,eAAe,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"config-explain.js","sourceRoot":"","sources":["../../src/trails/config-explain.ts"],"names":[],"mappings":"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"}

package/dist/trails/config-init.d.ts

@@ -5,5 +5,5 @@ export declare const configInit: import("@ontrails/core").Trail<{
     content: string;
     format: string;
     writtenFiles?: string[] | undefined;
-}>;
+}, never>;
 //# sourceMappingURL=config-init.d.ts.map

package/dist/trails/config-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-init.d.ts","sourceRoot":"","sources":["../../src/trails/config-init.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,UAAU;;;;;;;EAgCrB,CAAC"}
+{"version":3,"file":"config-init.d.ts","sourceRoot":"","sources":["../../src/trails/config-init.ts"],"names":[],"mappings":"AA+DA,eAAO,MAAM,UAAU;;;;;;;SAgCrB,CAAC"}

package/dist/trails/config-init.js

@@ -11,8 +11,8 @@ import { join } from 'node:path';
 import { mkdir } from 'node:fs/promises';
 import { Result, trail } from '@ontrails/core';
 import { z as zod } from 'zod';
-import { configProvision } from '../config-provision.js';
-import { generateEnvExample, generateExample, generateJsonSchema, } from '../generate/index.js';
+import { configResource } from '../config-resource.js';
+import { deriveConfigEnvExample, deriveConfigExample, deriveConfigJsonSchema, } from '../derive/index.js';
 const formatEnum = zod.enum(['toml', 'json', 'jsonc', 'yaml']);
 const outputSchema = zod.object({
     content: zod.string(),
@@ -22,13 +22,13 @@ const outputSchema = zod.object({
 /** Collect artifacts to write: [relativeName, content] pairs. */
 const collectArtifacts = (schema) => {
     const artifacts = [];
-    const envContent = generateEnvExample(schema);
+    const envContent = deriveConfigEnvExample(schema);
     if (envContent.length > 0) {
         artifacts.push(['.env.example', envContent]);
     }
     artifacts.push([
         '.schema.json',
-        JSON.stringify(generateJsonSchema(schema), null, 2),
+        JSON.stringify(deriveConfigJsonSchema(schema), null, 2),
     ]);
     return artifacts;
 };
@@ -46,9 +46,9 @@ const writeArtifacts = async (dir, schema) => {
 };
 export const configInit = trail('config.init', {
     blaze: async (input, ctx) => {
-        const state = configProvision.from(ctx);
+        const state = configResource.from(ctx);
         const schema = state.schema;
-        const content = generateExample(schema, input.format);
+        const content = deriveConfigExample(schema, input.format);
         if (input.dir) {
             const writtenFiles = await writeArtifacts(input.dir, schema);
             return Result.ok({ content, format: input.format, writtenFiles });
@@ -73,6 +73,6 @@ export const configInit = trail('config.init', {
     intent: 'write',
     meta: { category: 'infrastructure' },
     output: outputSchema,
-    provisions: [configProvision],
+    resources: [configResource],
 });
 //# sourceMappingURL=config-init.js.map

package/dist/trails/config-init.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-init.js","sourceRoot":"","sources":["../../src/trails/config-init.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,CAAC,IAAI,GAAG,EAAE,MAAM,KAAK,CAAC;AAE/B,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC;IAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC;AAEH,iEAAiE;AACjE,MAAM,gBAAgB,GAAG,CACvB,MAA8C,EAC1B,EAAE;IACtB,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,SAAS,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,SAAS,CAAC,IAAI,CAAC;QACb,cAAc;QACd,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;KACpD,CAAC,CAAC;IACH,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,cAAc,GAAG,KAAK,EAC1B,GAAW,EACX,MAA8C,EAC3B,EAAE;IACrB,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,SAAS,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC,aAAa,EAAE;IAC7C,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAgD,CAAC;QACtE,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEtD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,QAAQ,EAAE;QACR;YACE,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,uBAAuB;SAC9B;KACF;IACD,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC;QAChB,GAAG,EAAE,GAAG;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,2CAA2C,CAAC;aACrD,QAAQ,EAAE;QACb,MAAM,EAAE,UAAU;aACf,QAAQ,CAAC,2CAA2C,CAAC;aACrD,OAAO,CAAC,MAAM,CAAC;KACnB,CAAC;IACF,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE;IACpC,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,CAAC,eAAe,CAAC;CAC9B,CAAC,CAAC"}
+{"version":3,"file":"config-init.js","sourceRoot":"","sources":["../../src/trails/config-init.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/config",
-  "version": "1.0.0-beta.14",
+  "version": "1.0.0-beta.15",
   "type": "module",
   "exports": {
     ".": "./src/index.ts",
@@ -14,7 +14,7 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "peerDependencies": {
-    "@ontrails/core": "^1.0.0-beta.13",
+    "@ontrails/core": "^1.0.0-beta.14",
     "zod": "^4.3.5"
   }
 }

package/src/__tests__/app-config.test.ts

@@ -6,7 +6,7 @@ import { z } from 'zod';
 
 import type { AppConfig } from '../app-config.js';
 import { appConfig } from '../app-config.js';
-import { describeConfig } from '../describe.js';
+import { deriveConfigFields } from '../derive-fields.js';
 import { checkConfig } from '../doctor.js';
 import { configRef } from '../ref.js';
 
@@ -45,9 +45,9 @@ describe('appConfig()', () => {
       expect(config.schema).toBe(testSchema);
     });
 
-    test('defaults formats to toml, json, yaml when not specified', () => {
+    test('defaults formats to toml, json, jsonc, yaml when not specified', () => {
       const config = appConfig('myapp', { schema: testSchema });
-      expect(config.formats).toEqual(['toml', 'json', 'yaml']);
+      expect(config.formats).toEqual(['toml', 'json', 'jsonc', 'yaml']);
     });
 
     test('uses provided formats', () => {
@@ -218,6 +218,19 @@ describe('appConfig()', () => {
       expect(result.unwrap().output).toBe('./from-toml');
     });
 
+    test('includes jsonc in the default discovery set', async () => {
+      await Bun.write(
+        join(tempDir, 'myapp.config.jsonc'),
+        '{\n  // comment\n  "output": "./from-jsonc"\n}\n'
+      );
+
+      const config = appConfig('myapp', { schema: testSchema });
+      const result = await config.resolve({ cwd: tempDir });
+
+      expect(result.isOk()).toBe(true);
+      expect(result.unwrap().output).toBe('./from-jsonc');
+    });
+
     test('returns Result.err when no config file found', async () => {
       const config = appConfig('myapp', { schema: testSchema });
       const result = await config.resolve({ cwd: tempDir });
@@ -289,10 +302,10 @@ describe('appConfig()', () => {
   });
 
   describe('method delegations', () => {
-    test('describe() returns same result as describeConfig(schema)', () => {
+    test('describe() returns same result as deriveConfigFields(schema)', () => {
       const config = appConfig('myapp', { schema: testSchema });
       const methodResult = config.describe();
-      const standaloneResult = describeConfig(testSchema);
+      const standaloneResult = deriveConfigFields(testSchema);
 
       expect(methodResult).toEqual(standaloneResult);
     });
@@ -315,7 +328,7 @@ describe('appConfig()', () => {
       expect(methodResult).toEqual(standaloneResult);
     });
 
-    test('explain() delegates to explainConfig with bound schema', () => {
+    test('explain() delegates to deriveConfigProvenance with bound schema', () => {
       const config = appConfig('myapp', { schema: testSchema });
       const resolved = { output: './dist', verbose: true };
 

package/src/__tests__/compose.test.ts

@@ -2,57 +2,57 @@ import { describe, expect, test } from 'bun:test';
 
 import { z } from 'zod';
 
-import { collectProvisionConfigs } from '../compose.js';
+import { collectResourceConfigs } from '../compose.js';
 
 // ---------------------------------------------------------------------------
 // Tests
 // ---------------------------------------------------------------------------
 
-describe('collectProvisionConfigs', () => {
-  test('extracts config schemas from provisions that declare them', () => {
+describe('collectResourceConfigs', () => {
+  test('extracts config schemas from resources that declare them', () => {
     const dbSchema = z.object({ url: z.string().url() });
     const cacheSchema = z.object({ ttl: z.number() });
 
-    const provisions = [
+    const resources = [
       { config: dbSchema, id: 'db.main' },
       { config: cacheSchema, id: 'cache.main' },
     ];
 
-    const entries = collectProvisionConfigs(provisions);
+    const entries = collectResourceConfigs(resources);
 
     expect(entries).toHaveLength(2);
-    expect(entries[0]).toEqual({ provisionId: 'db.main', schema: dbSchema });
+    expect(entries[0]).toEqual({ resourceId: 'db.main', schema: dbSchema });
     expect(entries[1]).toEqual({
-      provisionId: 'cache.main',
+      resourceId: 'cache.main',
       schema: cacheSchema,
     });
   });
 
-  test('excludes provisions without config', () => {
+  test('excludes resources without config', () => {
     const schema = z.object({ url: z.string() });
 
-    const provisions = [
+    const resources = [
       { config: schema, id: 'db.main' },
       { id: 'counter.main' },
       { config: undefined, id: 'logger.main' },
     ];
 
-    const entries = collectProvisionConfigs(provisions);
+    const entries = collectResourceConfigs(resources);
 
     expect(entries).toHaveLength(1);
-    expect(entries[0]?.provisionId).toBe('db.main');
+    expect(entries[0]?.resourceId).toBe('db.main');
   });
 
-  test('returns empty array when no provisions have config', () => {
-    const provisions = [{ id: 'counter.main' }, { id: 'logger.main' }];
+  test('returns empty array when no resources have config', () => {
+    const resources = [{ id: 'counter.main' }, { id: 'logger.main' }];
 
-    const entries = collectProvisionConfigs(provisions);
+    const entries = collectResourceConfigs(resources);
 
     expect(entries).toEqual([]);
   });
 
   test('returns empty array for empty input', () => {
-    const entries = collectProvisionConfigs([]);
+    const entries = collectResourceConfigs([]);
 
     expect(entries).toEqual([]);
   });

package/src/__tests__/config-check.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test';
-import { createProvisionLookup } from '@ontrails/core';
+import { createResourceLookup } from '@ontrails/core';
 import type { TrailContext } from '@ontrails/core';
 import { z } from 'zod';
 
@@ -7,7 +7,7 @@ import { configCheck } from '../trails/config-check.js';
 import type { ConfigState } from '../registry.js';
 
 /**
- * Build a TrailContext with configProvision resolved in extensions.
+ * Build a TrailContext with configResource resolved in extensions.
  */
 const buildCtx = (state: ConfigState): TrailContext => {
   const extensions = { config: state };
@@ -16,13 +16,13 @@ const buildCtx = (state: ConfigState): TrailContext => {
     cwd: '/tmp',
     env: {},
     extensions,
-    provision: undefined as unknown as TrailContext['provision'],
     requestId: 'test',
+    resource: undefined as unknown as TrailContext['resource'],
     workspaceRoot: '/tmp',
   };
   const withLookup = {
     ...ctx,
-    provision: createProvisionLookup(() => withLookup),
+    resource: createResourceLookup(() => withLookup),
   };
   return withLookup;
 };
@@ -49,9 +49,9 @@ describe('config.check trail', () => {
       expect(configCheck.output).toBeDefined();
     });
 
-    test('declares configProvision dependency', () => {
-      expect(configCheck.provisions).toBeDefined();
-      expect(configCheck.provisions?.length).toBe(1);
+    test('declares configResource dependency', () => {
+      expect(configCheck.resources).toBeDefined();
+      expect(configCheck.resources?.length).toBe(1);
     });
   });
 

package/src/__tests__/config-describe.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test';
-import { createProvisionLookup } from '@ontrails/core';
+import { createResourceLookup } from '@ontrails/core';
 import type { TrailContext } from '@ontrails/core';
 import { z } from 'zod';
 
@@ -8,7 +8,7 @@ import { env, secret } from '../extensions.js';
 import type { ConfigState } from '../registry.js';
 
 /**
- * Build a TrailContext with configProvision resolved in extensions.
+ * Build a TrailContext with configResource resolved in extensions.
  */
 const buildCtx = (state: ConfigState): TrailContext => {
   const extensions = { config: state };
@@ -17,13 +17,13 @@ const buildCtx = (state: ConfigState): TrailContext => {
     cwd: '/tmp',
     env: {},
     extensions,
-    provision: undefined as unknown as TrailContext['provision'],
     requestId: 'test',
+    resource: undefined as unknown as TrailContext['resource'],
     workspaceRoot: '/tmp',
   };
   const withLookup = {
     ...ctx,
-    provision: createProvisionLookup(() => withLookup),
+    resource: createResourceLookup(() => withLookup),
   };
   return withLookup;
 };
@@ -50,9 +50,9 @@ describe('config.describe trail', () => {
       expect(configDescribe.output).toBeDefined();
     });
 
-    test('declares configProvision dependency', () => {
-      expect(configDescribe.provisions).toBeDefined();
-      expect(configDescribe.provisions?.length).toBe(1);
+    test('declares configResource dependency', () => {
+      expect(configDescribe.resources).toBeDefined();
+      expect(configDescribe.resources?.length).toBe(1);
     });
   });
 

package/src/__tests__/config-explain.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test';
-import { createProvisionLookup } from '@ontrails/core';
+import { createResourceLookup } from '@ontrails/core';
 import type { TrailContext } from '@ontrails/core';
 import { z } from 'zod';
 
@@ -8,7 +8,7 @@ import { env } from '../extensions.js';
 import type { ConfigState } from '../registry.js';
 
 /**
- * Build a TrailContext with configProvision resolved in extensions.
+ * Build a TrailContext with configResource resolved in extensions.
  */
 const buildCtx = (state: ConfigState): TrailContext => {
   const extensions = { config: state };
@@ -17,13 +17,13 @@ const buildCtx = (state: ConfigState): TrailContext => {
     cwd: '/tmp',
     env: {},
     extensions,
-    provision: undefined as unknown as TrailContext['provision'],
     requestId: 'test',
+    resource: undefined as unknown as TrailContext['resource'],
     workspaceRoot: '/tmp',
   };
   const withLookup = {
     ...ctx,
-    provision: createProvisionLookup(() => withLookup),
+    resource: createResourceLookup(() => withLookup),
   };
   return withLookup;
 };
@@ -50,9 +50,9 @@ describe('config.explain trail', () => {
       expect(configExplain.output).toBeDefined();
     });
 
-    test('declares configProvision dependency', () => {
-      expect(configExplain.provisions).toBeDefined();
-      expect(configExplain.provisions?.length).toBe(1);
+    test('declares configResource dependency', () => {
+      expect(configExplain.resources).toBeDefined();
+      expect(configExplain.resources?.length).toBe(1);
     });
   });
 

package/src/__tests__/config-init.test.ts

@@ -2,7 +2,7 @@ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
 import { mkdtemp, readFile, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { createProvisionLookup } from '@ontrails/core';
+import { createResourceLookup } from '@ontrails/core';
 import type { TrailContext } from '@ontrails/core';
 import { z } from 'zod';
 
@@ -11,7 +11,7 @@ import type { ConfigState } from '../registry.js';
 import { configInit } from '../trails/config-init.js';
 
 /**
- * Build a TrailContext with configProvision resolved in extensions.
+ * Build a TrailContext with configResource resolved in extensions.
  */
 const buildCtx = (state: ConfigState): TrailContext => {
   const extensions = { config: state };
@@ -20,13 +20,13 @@ const buildCtx = (state: ConfigState): TrailContext => {
     cwd: '/tmp',
     env: {},
     extensions,
-    provision: undefined as unknown as TrailContext['provision'],
     requestId: 'test',
+    resource: undefined as unknown as TrailContext['resource'],
     workspaceRoot: '/tmp',
   };
   const withLookup = {
     ...ctx,
-    provision: createProvisionLookup(() => withLookup),
+    resource: createResourceLookup(() => withLookup),
   };
   return withLookup;
 };
@@ -63,9 +63,9 @@ describe('config.init trail', () => {
       expect(configInit.output).toBeDefined();
     });
 
-    test('declares configProvision dependency', () => {
-      expect(configInit.provisions).toBeDefined();
-      expect(configInit.provisions?.length).toBe(1);
+    test('declares configResource dependency', () => {
+      expect(configInit.resources).toBeDefined();
+      expect(configInit.resources?.length).toBe(1);
     });
   });
 

package/src/__tests__/{config-provision.test.ts → config-resource.test.ts}

@@ -1,11 +1,11 @@
 import { afterEach, describe, expect, test } from 'bun:test';
 import { z } from 'zod';
 
-import { configProvision } from '../config-provision.js';
+import { configResource } from '../config-resource.js';
 import type { ConfigState } from '../registry.js';
 import { clearConfigState, registerConfigState } from '../registry.js';
 
-/** Stub ProvisionContext for create calls. */
+/** Stub ResourceContext for create calls. */
 const stubSvcCtx = {
   config: undefined,
   cwd: '/tmp',
@@ -13,32 +13,32 @@ const stubSvcCtx = {
   workspaceRoot: '/tmp',
 };
 
-describe('configProvision', () => {
+describe('configResource', () => {
   afterEach(() => {
     clearConfigState();
   });
 
   describe('identity', () => {
     test('has id "config"', () => {
-      expect(configProvision.id).toBe('config');
+      expect(configResource.id).toBe('config');
     });
 
-    test('has kind "provision"', () => {
-      expect(configProvision.kind).toBe('provision');
+    test('has kind "resource"', () => {
+      expect(configResource.kind).toBe('resource');
     });
 
     test('has infrastructure meta', () => {
-      expect(configProvision.meta).toEqual({ category: 'infrastructure' });
+      expect(configResource.meta).toEqual({ category: 'infrastructure' });
     });
 
     test('has description', () => {
-      expect(configProvision.description).toBeDefined();
+      expect(configResource.description).toBeDefined();
     });
   });
 
   describe('mock', () => {
     test('returns a ConfigState with empty schema and resolved', () => {
-      const value = configProvision.mock?.() as ConfigState;
+      const value = configResource.mock?.() as ConfigState;
       expect(value).toBeDefined();
       expect(value.resolved).toEqual({});
       expect(value.schema).toBeDefined();
@@ -51,7 +51,7 @@ describe('configProvision', () => {
       const state: ConfigState = { resolved: { port: 3000 }, schema };
       registerConfigState(state);
 
-      const result = await configProvision.create(stubSvcCtx);
+      const result = await configResource.create(stubSvcCtx);
 
       expect(result.isOk()).toBe(true);
       const value = result.unwrap() as ConfigState;
@@ -69,7 +69,7 @@ describe('configProvision', () => {
       };
       registerConfigState(state);
 
-      const result = await configProvision.create(stubSvcCtx);
+      const result = await configResource.create(stubSvcCtx);
 
       expect(result.isOk()).toBe(true);
       const value = result.unwrap() as ConfigState;
@@ -78,7 +78,7 @@ describe('configProvision', () => {
     });
 
     test('returns Result.err when no state is registered', async () => {
-      const result = await configProvision.create(stubSvcCtx);
+      const result = await configResource.create(stubSvcCtx);
 
       expect(result.isErr()).toBe(true);
       expect(result.error.message).toContain('Config state not registered');

package/src/__tests__/define-config.test.ts

@@ -46,21 +46,21 @@ const restoreEnv = (snapshot: EnvSnapshot): void => {
 };
 
 describe('defineConfig', () => {
-  test('returns an object with schema, base, and loadouts', () => {
+  test('returns an object with schema, base, and profiles', () => {
     const base = { host: 'example.com' };
-    const loadouts = { production: { port: 443 } };
+    const profiles = { production: { port: 443 } };
 
-    const config = defineConfig({ base, loadouts, schema });
+    const config = defineConfig({ base, profiles, schema });
 
     expect(config.schema).toBe(schema);
     expect(config.base).toBe(base);
-    expect(config.loadouts).toBe(loadouts);
+    expect(config.profiles).toBe(profiles);
   });
 
-  test('resolve() uses TRAILS_ENV to select loadout', async () => {
+  test('resolve() uses TRAILS_ENV to select profile', async () => {
     const config = defineConfig({
       base: { host: 'example.com' },
-      loadouts: {
+      profiles: {
         production: { host: 'prod.example.com', port: 443 },
         test: { host: 'test.example.com', port: 9999 },
       },
@@ -76,10 +76,10 @@ describe('defineConfig', () => {
     expect(result.unwrap().port).toBe(443);
   });
 
-  test('resolve() with explicit loadout option overrides TRAILS_ENV', async () => {
+  test('resolve() with explicit profile option overrides TRAILS_ENV', async () => {
     const config = defineConfig({
       base: { host: 'example.com' },
-      loadouts: {
+      profiles: {
         production: { host: 'prod.example.com' },
         test: { host: 'test.example.com' },
       },
@@ -88,7 +88,7 @@ describe('defineConfig', () => {
 
     const result = await config.resolve({
       env: { TRAILS_ENV: 'production' },
-      loadout: 'test',
+      profile: 'test',
     });
 
     expect(result.isOk()).toBe(true);
@@ -99,7 +99,7 @@ describe('defineConfig', () => {
     const config = defineConfig({
       base: { host: 'example.com' },
       envFromNodeEnv: true,
-      loadouts: {
+      profiles: {
         production: { host: 'prod.example.com', port: 443 },
       },
       schema,
@@ -123,7 +123,7 @@ describe('defineConfig', () => {
       const config = defineConfig({
         base: { host: 'example.com' },
         envFromNodeEnv: true,
-        loadouts: {
+        profiles: {
           production: { host: 'prod.example.com', port: 443 },
         },
         schema,
@@ -143,7 +143,7 @@ describe('defineConfig', () => {
     const config = defineConfig({
       base: { host: 'example.com' },
       envFromNodeEnv: true,
-      loadouts: {
+      profiles: {
         production: { host: 'prod.example.com' },
         test: { host: 'test.example.com' },
       },
@@ -158,10 +158,10 @@ describe('defineConfig', () => {
     expect(result.unwrap().host).toBe('test.example.com');
   });
 
-  test('test loadout works when TRAILS_ENV=test', async () => {
+  test('test profile works when TRAILS_ENV=test', async () => {
     const config = defineConfig({
       base: { port: 8080 },
-      loadouts: {
+      profiles: {
         test: { debug: true, port: 0 },
       },
       schema,
@@ -177,6 +177,12 @@ describe('defineConfig', () => {
     expect(value.port).toBe(0);
   });
 
+  test('inherits the canonical appConfig format list, including jsonc', () => {
+    const config = defineConfig({ schema });
+
+    expect(config.formats).toEqual(['toml', 'json', 'jsonc', 'yaml']);
+  });
+
   describe('local overrides', () => {
     let tempDir: string;
 
@@ -210,7 +216,7 @@ describe('defineConfig', () => {
       expect(result.unwrap().port).toBe(4444);
     });
 
-    test('local overrides applied between loadout and env', async () => {
+    test('local overrides applied between profile and env', async () => {
       const configDir = join(tempDir, '.trails', 'config');
       await mkdir(configDir, { recursive: true });
       await Bun.write(
@@ -220,17 +226,17 @@ describe('defineConfig', () => {
 
       const config = defineConfig({
         base: { port: 8080 },
-        loadouts: {
+        profiles: {
           dev: { port: 9090 },
         },
         schema,
       });
 
-      // Local overrides should win over loadout (9090)
+      // Local overrides should win over profile (9090)
       const result = await config.resolve({
         cwd: tempDir,
         env: { TRAILS_ENV: 'dev' },
-        loadout: 'dev',
+        profile: 'dev',
       });
 
       expect(result.isOk()).toBe(true);