ai-jue 1.3.2 → 1.5.0

package/dist/capability-source/index.d.ts

@@ -0,0 +1,26 @@
+import { CapabilityRef } from 'ai-jue-core';
+import { MergedConfig } from '../config';
+export interface CapabilityLockEntry {
+    type: CapabilityRef['type'];
+    contentHash: string;
+    locatorHash: string;
+    sourceType: 'file' | 'npm' | 'github';
+}
+export interface CapabilitySourceOptions {
+    cacheDir?: string;
+    fetch?: typeof fetch;
+    frozen?: boolean;
+    mirrorDir?: string;
+    /** `true` forces every Capability to bypass the cache; a name set scopes the bypass to those Capabilities only. */
+    forceRefresh?: boolean | ReadonlySet<string>;
+}
+export interface LoadedCapabilities {
+    config: MergedConfig;
+    lock: {
+        version: 1;
+        capabilities: Record<string, CapabilityLockEntry>;
+    };
+}
+export declare function capabilityCacheDestination(ref: Pick<CapabilityRef, 'source' | 'ref' | 'path'>, cacheRoot: string): string;
+export declare function loadCapabilityRefs(refs: unknown, baseDir: string, userLanguage?: string, options?: CapabilitySourceOptions): Promise<LoadedCapabilities>;
+export declare function mergeCapabilityLocks(...locks: Array<LoadedCapabilities['lock']>): LoadedCapabilities['lock'];

package/dist/capability-source/index.js

@@ -0,0 +1,290 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capabilityCacheDestination = capabilityCacheDestination;
+exports.loadCapabilityRefs = loadCapabilityRefs;
+exports.mergeCapabilityLocks = mergeCapabilityLocks;
+const crypto_1 = __importDefault(require("crypto"));
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const ai_jue_core_1 = require("ai-jue-core");
+const merge_1 = require("../merge");
+const preset_1 = require("../preset");
+const SAFE_ARCHIVE_ENTRY = /^(?!\/)(?!.*(?:^|\/)\.\.(?:\/|$)).+$/;
+function sha256(value) {
+    return crypto_1.default.createHash('sha256').update(value).digest('hex');
+}
+function sourceType(source) {
+    return source.slice(0, source.indexOf(':'));
+}
+function capabilityCacheDestination(ref, cacheRoot) {
+    return path_1.default.join(cacheRoot, sourceType(ref.source), sha256(`${ref.source}\0${ref.ref || ''}\0${ref.path || ''}`));
+}
+function extractedRoot(destination) {
+    const entries = fs_1.default
+        .readdirSync(destination, { withFileTypes: true })
+        .filter((entry) => entry.name !== 'source.tgz');
+    return entries.length === 1 && entries[0].isDirectory()
+        ? path_1.default.join(destination, entries[0].name)
+        : destination;
+}
+function isPopulated(destination) {
+    return fs_1.default.existsSync(destination) && fs_1.default.readdirSync(destination).length > 0;
+}
+function safeChild(baseDir, relativePath) {
+    const base = path_1.default.resolve(baseDir);
+    const target = path_1.default.resolve(base, relativePath);
+    if (target !== base && !target.startsWith(`${base}${path_1.default.sep}`)) {
+        throw new Error(`Capability path must stay inside its source: ${relativePath}`);
+    }
+    return target;
+}
+function runTar(args, cwd) {
+    const result = (0, child_process_1.spawnSync)('tar', args, {
+        cwd,
+        encoding: 'utf8',
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    if (result.status !== 0) {
+        throw new Error(`Unable to read Capability archive: ${result.stderr.trim()}`);
+    }
+    return result.stdout;
+}
+function extractArchive(archivePath, destination) {
+    const entries = runTar(['-tzf', archivePath])
+        .split('\n')
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    if (entries.length === 0 || entries.some((entry) => !SAFE_ARCHIVE_ENTRY.test(entry))) {
+        throw new Error('Capability archive contains an invalid or unsafe path');
+    }
+    const verboseEntries = runTar(['-tvzf', archivePath]).split('\n').filter(Boolean);
+    if (verboseEntries.some((entry) => /^[lh]/.test(entry))) {
+        throw new Error('Capability archive must not contain symbolic or hard links');
+    }
+    // Extract into a sibling temp directory and only rename it into place once
+    // extraction fully succeeds. If the process dies mid-extraction (Ctrl-C, CI
+    // timeout, OOM), `destination` itself is never created/touched, so a later
+    // run's cache-hit check correctly treats it as missing instead of silently
+    // trusting a truncated result forever.
+    const tmpDestination = `${destination}.tmp-${process.pid}-${Date.now()}`;
+    fs_1.default.mkdirSync(tmpDestination, { recursive: true });
+    try {
+        runTar(['-xzf', archivePath, '-C', tmpDestination]);
+    }
+    catch (error) {
+        fs_1.default.rmSync(tmpDestination, { recursive: true, force: true });
+        throw error;
+    }
+    fs_1.default.rmSync(destination, { recursive: true, force: true });
+    fs_1.default.renameSync(tmpDestination, destination);
+    return extractedRoot(destination);
+}
+function hashDirectory(rootDir) {
+    const hash = crypto_1.default.createHash('sha256');
+    const visit = (dir) => {
+        for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+            const absolute = path_1.default.join(dir, entry.name);
+            const relative = path_1.default.relative(rootDir, absolute).split(path_1.default.sep).join('/');
+            hash.update(entry.isDirectory() ? `d:${relative}\0` : `f:${relative}\0`);
+            if (entry.isDirectory())
+                visit(absolute);
+            if (entry.isFile())
+                hash.update(fs_1.default.readFileSync(absolute));
+        }
+    };
+    visit(rootDir);
+    return hash.digest('hex');
+}
+function resolveFile(ref, baseDir) {
+    const locator = ref.source.slice('file:'.length);
+    if (!locator)
+        throw new Error('file: Capability source must include a path');
+    const resolved = path_1.default.resolve(baseDir, locator);
+    if (!fs_1.default.existsSync(resolved)) {
+        throw new Error('file: Capability source does not exist');
+    }
+    return resolved;
+}
+function resolveLocalNpmArchive(ref, baseDir, cacheDir) {
+    const locator = ref.source.slice('npm:'.length);
+    if (!locator.startsWith('file:'))
+        return null;
+    const archivePath = path_1.default.resolve(baseDir, locator.slice('file:'.length));
+    if (!fs_1.default.existsSync(archivePath) || !archivePath.endsWith('.tgz')) {
+        throw new Error('Local npm Capability source must reference an existing .tgz file');
+    }
+    return extractArchive(archivePath, cacheDir);
+}
+function assertExactNpmSpecifier(specifier) {
+    const match = specifier.match(/^(?:@[^/]+\/[^@]+|[^@/]+)@([^@]+)$/);
+    if (!match || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(match[1])) {
+        throw new Error('npm: Capability source must include an exact version');
+    }
+}
+function resolveNpm(ref, baseDir, cacheDir, options) {
+    const local = resolveLocalNpmArchive(ref, baseDir, cacheDir);
+    if (local)
+        return local;
+    const specifier = ref.source.slice('npm:'.length);
+    assertExactNpmSpecifier(specifier);
+    if (!options.forceRefresh && isPopulated(cacheDir)) {
+        return extractedRoot(cacheDir);
+    }
+    const packDir = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'ai-jue-npm-pack-'));
+    try {
+        const result = (0, child_process_1.spawnSync)('npm', ['pack', specifier, '--ignore-scripts', '--json', '--pack-destination', packDir], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] });
+        if (result.status !== 0) {
+            throw new Error(`Unable to pack npm Capability: ${result.stderr.trim()}`);
+        }
+        const output = JSON.parse(result.stdout);
+        const filename = output?.[0]?.filename;
+        if (typeof filename !== 'string') {
+            throw new Error('npm pack did not return an archive filename');
+        }
+        return extractArchive(path_1.default.join(packDir, filename), cacheDir);
+    }
+    finally {
+        fs_1.default.rmSync(packDir, { recursive: true, force: true });
+    }
+}
+async function resolveGithub(name, ref, cacheDir, options) {
+    const repository = ref.source.slice('github:'.length);
+    if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(repository)) {
+        throw new Error('github: Capability source must use owner/repository');
+    }
+    if (!ref.ref) {
+        if (options.frozen) {
+            throw new Error('Frozen resolution requires github: Capability sources to declare ref');
+        }
+        console.warn('[WARN] A github: Capability has no pinned ref; resolving against the '
+            + 'floating default branch. Pin a ref or run `jue apply --frozen` in CI.');
+    }
+    const unpackedDir = path_1.default.join(cacheDir, 'unpacked');
+    if (!options.forceRefresh && isPopulated(unpackedDir)) {
+        return extractedRoot(unpackedDir);
+    }
+    const revision = ref.ref || 'HEAD';
+    const fetchImpl = options.fetch || globalThis.fetch;
+    if (typeof fetchImpl !== 'function') {
+        throw new Error('github: Capability resolution requires a fetch implementation');
+    }
+    const response = await fetchImpl(`https://codeload.github.com/${repository}/tar.gz/${encodeURIComponent(revision)}`, { method: 'GET', redirect: 'error' });
+    if (!response.ok) {
+        throw new Error(`Unable to fetch github: Capability archive (${response.status})`);
+    }
+    const archive = Buffer.from(await response.arrayBuffer());
+    const archivePath = path_1.default.join(cacheDir, 'source.tgz');
+    fs_1.default.mkdirSync(cacheDir, { recursive: true });
+    fs_1.default.writeFileSync(archivePath, archive);
+    return extractArchive(archivePath, path_1.default.join(cacheDir, 'unpacked'));
+}
+async function resolveSource(name, ref, baseDir, options) {
+    // `AI_JUE_CACHE_DIR` mirrors `AI_JUE_SOURCE_MIRROR_DIR`: without it, a test
+    // run using an offline mirror (synthetic/stub archives) still extracts
+    // into the real, globally-shared `~/.cache/ai-jue`, keyed only by
+    // sha256(source+ref+path) — a real npm/github locator used by a stubbed
+    // test run would then permanently shadow the real content for every
+    // future real resolution of that same locator on this machine.
+    const cacheRoot = options.cacheDir || process.env.AI_JUE_CACHE_DIR || path_1.default.join(os_1.default.homedir(), '.cache', 'ai-jue');
+    const destination = capabilityCacheDestination(ref, cacheRoot);
+    const mirrorDir = options.mirrorDir || process.env.AI_JUE_SOURCE_MIRROR_DIR;
+    const mirrorArchive = mirrorDir
+        ? path_1.default.join(mirrorDir, `${path_1.default.basename(destination)}.tgz`)
+        : '';
+    let root;
+    if (mirrorArchive && fs_1.default.existsSync(mirrorArchive)) {
+        root = extractArchive(mirrorArchive, destination);
+    }
+    else if (ref.source.startsWith('file:')) {
+        root = resolveFile(ref, baseDir);
+    }
+    else if (ref.source.startsWith('npm:')) {
+        root = resolveNpm(ref, baseDir, destination, options);
+    }
+    else {
+        root = await resolveGithub(name, ref, destination, options);
+    }
+    const selected = ref.path ? safeChild(root, ref.path) : root;
+    if (!fs_1.default.existsSync(selected)) {
+        throw new Error('Capability source path does not exist');
+    }
+    return selected;
+}
+async function loadMcpCapability({ name, ref, sourceDir }) {
+    const manifestPath = fs_1.default.existsSync(path_1.default.join(sourceDir, 'mcp.json'))
+        ? path_1.default.join(sourceDir, 'mcp.json')
+        : path_1.default.join(sourceDir, 'package.json');
+    if (!fs_1.default.existsSync(manifestPath)) {
+        throw new Error(`mcp Capability "${name}" is missing mcp.json or package.json`);
+    }
+    const manifest = JSON.parse(fs_1.default.readFileSync(manifestPath, 'utf8'));
+    const declared = manifest.servers || manifest.mcp?.servers || manifest.ai?.mcp?.servers;
+    const server = declared?.[name] ||
+        (manifest.bin
+            ? {
+                command: 'npx',
+                args: ['-y', manifest.name],
+                ...(ref.config || {}),
+            }
+            : null);
+    if (!server || typeof server.command !== 'string') {
+        throw new Error(`mcp Capability "${name}" has no valid server declaration`);
+    }
+    (0, ai_jue_core_1.assertNoLiteralCredentials)(server, `mcp Capability "${name}"`);
+    return { mcp: { servers: { [name]: server } } };
+}
+/**
+ * One loader per Canonical leaf type. A lookup table (rather than an
+ * if/else chain) keeps adding a type a single-line change and makes the
+ * "one CapabilityRef -> one leaf Capability" mapping visible at a glance.
+ */
+const CAPABILITY_LOADERS = {
+    skill: ({ name, sourceDir, userLanguage }) => (0, preset_1.loadSkillFromDir)(name, sourceDir, userLanguage),
+    rule: ({ name, sourceDir, userLanguage }) => (0, preset_1.loadRuleFromDir)(name, sourceDir, userLanguage),
+    command: ({ name, sourceDir, userLanguage }) => (0, preset_1.loadCommandFromDir)(name, sourceDir, userLanguage),
+    agent: ({ name, sourceDir, userLanguage }) => (0, preset_1.loadAgentFromDir)(name, sourceDir, userLanguage),
+    hook: ({ name, sourceDir, userLanguage }) => (0, preset_1.loadHookFromDir)(name, sourceDir, userLanguage),
+    mcp: loadMcpCapability,
+};
+function convertCapability(name, ref, sourceDir, userLanguage) {
+    return CAPABILITY_LOADERS[ref.type]({ name, ref, sourceDir, userLanguage });
+}
+async function loadCapabilityRefs(refs, baseDir, userLanguage, options = {}) {
+    if (refs === undefined) {
+        return { config: {}, lock: { version: 1, capabilities: {} } };
+    }
+    if (!refs || typeof refs !== 'object' || Array.isArray(refs)) {
+        throw new Error('ai.capabilities must be an object');
+    }
+    let config = {};
+    const capabilities = {};
+    for (const name of Object.keys(refs).sort()) {
+        const value = refs[name];
+        (0, ai_jue_core_1.assertCapabilityRef)(name, value);
+        const forceRefresh = options.forceRefresh instanceof Set
+            ? options.forceRefresh.has(name)
+            : Boolean(options.forceRefresh);
+        const resolved = await resolveSource(name, value, baseDir, { ...options, forceRefresh });
+        const converted = await convertCapability(name, value, resolved, userLanguage);
+        config = (0, merge_1.mergeConfigWithLayeredContext)(config, converted);
+        capabilities[name] = {
+            type: value.type,
+            contentHash: hashDirectory(resolved),
+            locatorHash: sha256(`${value.source}\0${value.ref || ''}\0${value.path || ''}`),
+            sourceType: sourceType(value.source),
+        };
+    }
+    return { config, lock: { version: 1, capabilities } };
+}
+function mergeCapabilityLocks(...locks) {
+    return {
+        version: 1,
+        capabilities: Object.assign({}, ...locks.map((lock) => lock.capabilities)),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/capability-source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capability-source/index.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -13,6 +13,9 @@ const check_1 = require("./commands/check");
 const validate_1 = require("./commands/validate");
 const list_1 = require("./commands/list");
 const format_1 = require("./commands/format");
+const capability_1 = require("./commands/capability");
+const extension_1 = require("./commands/extension");
+const inspect_1 = require("./commands/inspect");
 const logger_1 = require("./logger");
 const i18n_1 = require("./i18n");
 const config_1 = require("./config");
@@ -69,6 +72,15 @@ async function main() {
         .command(validate_1.command, (0, i18n_1.t)("commands.validate.describe"), validate_1.builder, validate_1.handler)
         .command(list_1.command, (0, i18n_1.t)("commands.list.describe"), list_1.builder, list_1.handler)
         .command(format_1.command, (0, i18n_1.t)("commands.format.describe", { defaultValue: "Migrate AI tool configs to .ai directory" }), format_1.builder, format_1.handler)
+        .command(capability_1.command, (0, i18n_1.t)("commands.capability.describe", {
+        defaultValue: "Manage ai.capabilities Capability Source references",
+    }), capability_1.builder, capability_1.handler)
+        .command(extension_1.command, (0, i18n_1.t)("commands.extension.describe", {
+        defaultValue: "Author commands for Extension packages",
+    }), extension_1.builder, extension_1.handler)
+        .command(inspect_1.command, (0, i18n_1.t)("commands.inspect.describe", {
+        defaultValue: "Read-only inspection of Presets, Capabilities, Adapters, and Artifacts",
+    }), inspect_1.builder, inspect_1.handler)
         .demandCommand(1, (0, i18n_1.t)("common.demand_command", {
         defaultValue: "You need at least one command before moving on",
     }))

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/apply.d.ts

@@ -2,4 +2,6 @@ import { Arguments, CommandBuilder } from "yargs";
 export declare const command = "apply";
 export declare const describe = "";
 export declare const builder: CommandBuilder;
+export declare function resolveAdapterAlias(name: string): string;
+export declare function parseRequestedAdapters(raw: unknown): string[];
 export declare const handler: (argv: Arguments) => Promise<void>;

package/dist/commands/apply.js

@@ -37,6 +37,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handler = exports.builder = exports.describe = exports.command = void 0;
+exports.resolveAdapterAlias = resolveAdapterAlias;
+exports.parseRequestedAdapters = parseRequestedAdapters;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
 const chokidar_1 = __importDefault(require("chokidar"));
@@ -50,6 +52,7 @@ const promises_1 = require("readline/promises");
 const logger_1 = require("../logger");
 const i18n_1 = require("../i18n");
 const init_1 = require("./init");
+const core_apply_1 = require("../core-apply");
 exports.command = "apply";
 exports.describe = ""; // Managed in cli.ts for dynamic translation
 const builder = (yargs) => {
@@ -75,35 +78,62 @@ const builder = (yargs) => {
         type: "boolean",
         description: (0, i18n_1.t)("commands.apply.all_describe"),
         default: false,
+    })
+        .option("frozen", {
+        type: "boolean",
+        description: "Require immutable Capability Source references",
+        default: false,
+    })
+        .option("dry-run", {
+        type: "boolean",
+        description: (0, i18n_1.t)("commands.apply.dry_run_describe"),
+        default: false,
+    })
+        .option("check", {
+        type: "boolean",
+        description: (0, i18n_1.t)("commands.apply.check_describe"),
+        default: false,
     });
 };
 exports.builder = builder;
 const ADAPTER_ALIAS_MAP = {
+    codex: "ai-jue-adapter-codex",
     claude: "ai-jue-adapter-claude",
     "claude-code": "ai-jue-adapter-claude",
     cursor: "ai-jue-adapter-cursor",
-    gemini: "ai-jue-adapter-gemini",
-    copilot: "ai-jue-adapter-copilot",
+    openclaw: "ai-jue-adapter-openclaw",
+    hermes: "ai-jue-adapter-hermes",
 };
 const KNOWN_ADAPTERS = [...new Set(Object.values(ADAPTER_ALIAS_MAP))];
 const ADAPTER_INDICATORS = {
+    "ai-jue-adapter-codex": [
+        "AGENTS.md",
+        ".agents/skills",
+        ".codex",
+    ],
     "ai-jue-adapter-cursor": [
         ".cursor",
     ],
-    "ai-jue-adapter-gemini": [
-        ".gemini",
-        ".gemini/settings.json",
-        "GEMINI.md",
-    ],
     "ai-jue-adapter-claude": [
         ".claude",
         "CLAUDE.md",
     ],
-    "ai-jue-adapter-copilot": [
-        ".github/copilot-instructions.md",
-        ".github/copilot-settings.json",
+    "ai-jue-adapter-openclaw": [
+        "openclaw.json",
+    ],
+    "ai-jue-adapter-hermes": [
+        // Not `config.yaml`: that filename is common across many unrelated
+        // tools (Docusaurus, mkdocs, Ansible, Serverless, etc.) and would
+        // false-positive-detect Hermes on unrelated projects, silently
+        // triggering an `npm install -D ai-jue-adapter-hermes` and an apply
+        // run against files it was never meant to read. `MEMORY.md` matches
+        // the specificity of the other Adapters' indicators (e.g. `CLAUDE.md`).
+        "MEMORY.md",
     ],
 };
+function resolveAdapterAlias(name) {
+    return ADAPTER_ALIAS_MAP[name.toLowerCase()] || name;
+}
 const CONFIG_SEARCH_PATHS = [
     "ai.config.js",
     "ai.config.cjs",
@@ -124,7 +154,7 @@ function parseRequestedAdapters(raw) {
         .flatMap((item) => String(item).split(","))
         .map((item) => item.trim())
         .filter(Boolean)
-        .map((item) => ADAPTER_ALIAS_MAP[item.toLowerCase()] || item);
+        .map((item) => resolveAdapterAlias(item));
     return [...new Set(expanded)];
 }
 function autoDetectAdapters(discoveredAdapters, cwd) {
@@ -158,8 +188,10 @@ function parseManualSelection(raw, discoveredAdapters) {
             return discoveredAdapters[idx];
         }
         const normalized = token.toLowerCase();
-        return (ADAPTER_ALIAS_MAP[normalized] ||
-            discoveredAdapters.find((name) => name === token || toAdapterShortName(name) === normalized));
+        const aliased = resolveAdapterAlias(normalized);
+        return (aliased !== normalized
+            ? aliased
+            : discoveredAdapters.find((name) => name === token || toAdapterShortName(name) === normalized));
     })
         .filter((item) => Boolean(item));
     return [...new Set(resolved)];
@@ -342,13 +374,22 @@ function discoverAvailableAdapters(discoveredAdapters) {
     const resolvableKnownAdapters = KNOWN_ADAPTERS.filter((name) => canResolveAdapter(name));
     return [...new Set([...discoveredAdapters, ...resolvableKnownAdapters])];
 }
-async function runSingleAdapter(adapterName, config, outputDir) {
+async function runSingleAdapter(adapterName, config, outputDir, coreOptions = {}) {
     const adapterSpinner = (0, ora_1.default)((0, i18n_1.t)("commands.apply.running_adapter", { name: adapterName })).start();
     try {
         const adapterPath = require.resolve(adapterName, {
             paths: [process.cwd(), __dirname],
         });
         const adapter = require(adapterPath);
+        if ((0, core_apply_1.isCoreCapableAdapter)(adapter)) {
+            adapterSpinner.stop();
+            await (0, core_apply_1.runCoreAdapter)(adapterName, adapter, config, outputDir, coreOptions);
+            return;
+        }
+        if (coreOptions.dryRun || coreOptions.check) {
+            adapterSpinner.warn(picocolors_1.default.yellow((0, i18n_1.t)("commands.apply.core_unsupported", { name: adapterName })));
+            return;
+        }
         if (adapter.generate && typeof adapter.generate === "function") {
             await adapter.generate(config, outputDir);
             adapterSpinner.succeed(picocolors_1.default.green((0, i18n_1.t)("commands.apply.adapter_success", { name: adapterName })));
@@ -365,7 +406,7 @@ async function runSingleAdapter(adapterName, config, outputDir) {
         process.exitCode = 1;
     }
 }
-async function runAdapterList(adapterNames, config, outputDir) {
+async function runAdapterList(adapterNames, config, outputDir, coreOptions = {}) {
     const readyAdapters = await ensureAdaptersInstalled(adapterNames);
     if (readyAdapters.length === 0) {
         logger_1.logger.warn(picocolors_1.default.yellow((0, i18n_1.t)("commands.apply.no_adapter_selected")));
@@ -373,10 +414,11 @@ async function runAdapterList(adapterNames, config, outputDir) {
         return;
     }
     for (const adapterName of readyAdapters) {
-        await runSingleAdapter(adapterName, config, outputDir);
+        await runSingleAdapter(adapterName, config, outputDir, coreOptions);
     }
 }
 async function runAdapters(config, outputDir, options) {
+    const coreOptions = { dryRun: options.dryRun, check: options.check };
     const spinner = (0, ora_1.default)((0, i18n_1.t)("commands.apply.finding_adapters")).start();
     const discoveredAdapters = await findAdapters();
     const availableAdapters = discoverAvailableAdapters(discoveredAdapters);
@@ -389,7 +431,7 @@ async function runAdapters(config, outputDir, options) {
                     count: footprintDetected.length,
                     names: footprintDetected.join(", "),
                 })));
-                await runAdapterList(footprintDetected, config, outputDir);
+                await runAdapterList(footprintDetected, config, outputDir, coreOptions);
                 return;
             }
             const manualSelected = await promptManualAdapterSelection(KNOWN_ADAPTERS);
@@ -401,15 +443,15 @@ async function runAdapters(config, outputDir, options) {
                 count: manualSelected.length,
                 names: manualSelected.join(", "),
             })));
-            await runAdapterList(manualSelected, config, outputDir);
+            await runAdapterList(manualSelected, config, outputDir, coreOptions);
             return;
         }
         if (options.requestedAdapters.length > 0) {
-            await runAdapterList(options.requestedAdapters, config, outputDir);
+            await runAdapterList(options.requestedAdapters, config, outputDir, coreOptions);
             return;
         }
         if (options.all) {
-            await runAdapterList(KNOWN_ADAPTERS, config, outputDir);
+            await runAdapterList(KNOWN_ADAPTERS, config, outputDir, coreOptions);
             return;
         }
         return;
@@ -469,7 +511,7 @@ async function runAdapters(config, outputDir, options) {
         names: runnableAdapters.join(", "),
     })));
     for (const adapterName of runnableAdapters) {
-        await runSingleAdapter(adapterName, config, outputDir);
+        await runSingleAdapter(adapterName, config, outputDir, coreOptions);
     }
 }
 const handler = async (argv) => {
@@ -485,6 +527,8 @@ const handler = async (argv) => {
     const applyOptions = {
         all: Boolean(argv.all),
         requestedAdapters: mergedRequestedAdapters,
+        dryRun: Boolean(argv["dry-run"]),
+        check: Boolean(argv.check),
     };
     const runApply = async () => {
         logger_1.logger.info(picocolors_1.default.bold(picocolors_1.default.blue((0, i18n_1.t)("commands.apply.running"))));
@@ -518,7 +562,9 @@ const handler = async (argv) => {
                 config.language = runtimeLang;
             }
             logger_1.logger.debug(picocolors_1.default.dim((0, i18n_1.t)("commands.apply.loaded_config")));
-            const finalConfig = await (0, resolver_1.resolveFinalConfig)(config);
+            const finalConfig = await (0, resolver_1.resolveFinalConfig)(config, {
+                frozen: Boolean(argv.frozen),
+            });
             await runAdapters(finalConfig, process.cwd(), applyOptions);
             logger_1.logger.success(picocolors_1.default.bold(picocolors_1.default.green((0, i18n_1.t)("commands.apply.finished"))));
         }