a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
84 lines
3.4 KiB
TypeScript
84 lines
3.4 KiB
TypeScript
/**
|
|
* Thin adapter — sources schema data from the manifest via the generated
|
|
* Configuration Module. All inline literals have been removed; the manifest
|
|
* at msd-core/bin/shared/config-schema.manifest.json is the single source of truth.
|
|
*
|
|
* Imported by:
|
|
* - config.cjs (isValidConfigKey validator)
|
|
* - many tests (config-schema.property.test.cjs, bug-*, feat-*, etc.)
|
|
* (core.cjs re-export spine retired in epic #1267)
|
|
*
|
|
* See Phase 2 Cycle 5 (#3536) — schema manifest migration.
|
|
*
|
|
* ADR-457 build-at-publish: the hand-written bin/lib/config-schema.cjs collapsed
|
|
* to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour from
|
|
* the prior hand-written .cjs; only types are added.
|
|
*/
|
|
|
|
import {
|
|
VALID_CONFIG_KEYS,
|
|
RUNTIME_STATE_KEYS,
|
|
DYNAMIC_KEY_PATTERNS,
|
|
} from './configuration.cjs';
|
|
|
|
// Frozen first-party capability config-schema — the fallback when no project cwd
|
|
// is available (cwd-agnostic call sites).
|
|
// eslint-disable-next-line @typescript-eslint/no-require-imports
|
|
const capabilityRegistry = require('./capability-registry.cjs') as {
|
|
configSchema?: Record<string, unknown>;
|
|
};
|
|
|
|
// Resolve the capability config-schema for a project (ADR-1244 D2). When a cwd is
|
|
// supplied, compose installed overlay capabilities for THAT project — LAZILY (never
|
|
// at module load: a bare require of this module never scans the filesystem) —
|
|
// falling back to the frozen first-party schema. Without a cwd, first-party only.
|
|
function _capabilityConfigSchema(cwd?: string): Record<string, unknown> {
|
|
if (typeof cwd === 'string' && cwd) {
|
|
try {
|
|
// eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-unsafe-assignment
|
|
const loaderMod: { loadRegistry: (o?: Record<string, unknown>) => { configSchema?: Record<string, unknown> } } = require('./capability-loader.cjs');
|
|
// #1459 IC-04: thread the consent home explicitly so a consented project cap's config key
|
|
// federates at the SAME user-owned home that gated its activation.
|
|
const schema = loaderMod.loadRegistry({ includeInstalled: true, cwd, msdHome: process.env['MSD_HOME'] }).configSchema;
|
|
if (schema && typeof schema === 'object') return schema;
|
|
} catch { /* fall back to first-party */ }
|
|
}
|
|
const fp = capabilityRegistry.configSchema;
|
|
return fp && typeof fp === 'object' ? fp : {};
|
|
}
|
|
|
|
function isCapabilityConfigKey(keyPath: string, cwd?: string): boolean {
|
|
if (typeof keyPath !== 'string') return false;
|
|
return Object.prototype.hasOwnProperty.call(_capabilityConfigSchema(cwd), keyPath);
|
|
}
|
|
|
|
/**
|
|
* Returns true for keys owned by the central schema adapter rather than a
|
|
* federated Capability config slice.
|
|
*/
|
|
function isCentralConfigKey(keyPath: string): boolean {
|
|
if (typeof keyPath !== 'string') return false;
|
|
if (VALID_CONFIG_KEYS.has(keyPath)) return true;
|
|
if (RUNTIME_STATE_KEYS.has(keyPath)) return true;
|
|
return DYNAMIC_KEY_PATTERNS.some((p) => p.test(keyPath));
|
|
}
|
|
|
|
/**
|
|
* Returns true if keyPath is a valid central, runtime-state, dynamic, or
|
|
* federated Capability config key.
|
|
*/
|
|
function isValidConfigKey(keyPath: string, cwd?: string): boolean {
|
|
if (isCentralConfigKey(keyPath)) return true;
|
|
return isCapabilityConfigKey(keyPath, cwd);
|
|
}
|
|
|
|
export = {
|
|
VALID_CONFIG_KEYS,
|
|
RUNTIME_STATE_KEYS,
|
|
DYNAMIC_KEY_PATTERNS,
|
|
isCapabilityConfigKey,
|
|
isCentralConfigKey,
|
|
isValidConfigKey,
|
|
getCapabilityConfigSchema: _capabilityConfigSchema,
|
|
};
|