@open-agent-toolkit/cli 0.1.32 → 0.1.34

package/dist/commands/internal/validate-oat-skills.js

@@ -1,11 +1,30 @@
+import { join } from 'node:path';
 import { buildCommandContext, } from '../../app/command-context.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
+import { resolveEffectiveConfig as defaultResolveEffectiveConfig, } from '../../config/resolve.js';
 import { validateOatSkills as defaultValidateOatSkills, } from '../../validation/index.js';
 import { Command } from 'commander';
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     validateOatSkills: defaultValidateOatSkills,
+    resolveEffectiveConfig: defaultResolveEffectiveConfig,
 };
+function collectConfiguredGateSkillNames(effective) {
+    const names = new Set();
+    for (const layer of [effective.shared, effective.local, effective.user]) {
+        const skills = layer.workflow?.gates?.skills;
+        if (!skills) {
+            continue;
+        }
+        for (const skillName of Object.keys(skills)) {
+            names.add(skillName);
+        }
+    }
+    return [...names].sort();
+}
+function isBlockingFinding(finding) {
+    return finding.severity !== 'warning';
+}
 function reportFindings(context, result) {
     if (context.json) {
         context.logger.json({
@@ -21,14 +40,37 @@ function reportFindings(context, result) {
     }
     context.logger.error('\nFix the issues above, then re-run: pnpm oat:validate-skills');
 }
+function reportWarnings(context, result) {
+    if (context.json) {
+        context.logger.json({
+            status: 'ok',
+            validatedSkillCount: result.validatedSkillCount,
+            findings: result.findings,
+        });
+        return;
+    }
+    context.logger.warn('OAT skill validation warnings:\n');
+    for (const finding of result.findings) {
+        context.logger.warn(`- ${finding.file}: ${finding.message}`);
+    }
+    context.logger.info(`OK: validated ${result.validatedSkillCount} oat-* skills`);
+}
 async function runValidateOatSkills(context, options, dependencies) {
     try {
-        const result = await dependencies.validateOatSkills(context.cwd, options);
-        if (result.findings.length > 0) {
+        const effectiveConfig = await dependencies.resolveEffectiveConfig(context.cwd, join(context.home, '.oat'), dependencies.env ?? process.env);
+        const gateSkillNames = collectConfiguredGateSkillNames(effectiveConfig);
+        const validationOptions = gateSkillNames.length > 0 ? { ...options, gateSkillNames } : options;
+        const result = await dependencies.validateOatSkills(context.cwd, validationOptions);
+        if (result.findings.some(isBlockingFinding)) {
             reportFindings(context, result);
             process.exitCode = 1;
             return;
         }
+        if (result.findings.length > 0) {
+            reportWarnings(context, result);
+            process.exitCode = 0;
+            return;
+        }
         if (context.json) {
             context.logger.json({
                 status: 'ok',

package/dist/commands/pjm/doctor.d.ts

@@ -1,3 +1,7 @@
 import type { DoctorCheck } from '../../ui/output.js';
-export declare function runPjmDoctorChecks(repoRoot: string): Promise<DoctorCheck[]>;
+export interface PjmDoctorOptions {
+    projectManagementEnabled?: boolean;
+}
+export declare function createPjmDisabledCheck(): DoctorCheck;
+export declare function runPjmDoctorChecks(repoRoot: string, options?: PjmDoctorOptions): Promise<DoctorCheck[]>;
 //# sourceMappingURL=doctor.d.ts.map

package/dist/commands/pjm/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0I9C,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC,CAqJxB"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0I9C,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,wBAAgB,sBAAsB,IAAI,WAAW,CAQpD;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,EAAE,CAAC,CAyJxB"}

package/dist/commands/pjm/doctor.js

@@ -114,7 +114,19 @@ function checkStatus(missing) {
 function warnStatus(items) {
     return items.length === 0 ? 'pass' : 'warn';
 }
-export async function runPjmDoctorChecks(repoRoot) {
+export function createPjmDisabledCheck() {
+    return {
+        name: 'pjm:disabled',
+        description: 'Project-management pack enablement',
+        status: 'pass',
+        message: 'Project-management pack is disabled; PJM checks skipped.',
+        fix: 'Run `oat init tools project-management` to install and enable PJM checks.',
+    };
+}
+export async function runPjmDoctorChecks(repoRoot, options = {}) {
+    if (options.projectManagementEnabled === false) {
+        return [createPjmDisabledCheck()];
+    }
     const checks = [];
     const missingCanonical = [];
     for (const relativePath of CANONICAL_REPO_REFERENCE_PATHS) {

package/dist/commands/pjm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAiBnE,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA6FD,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAkJT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAiBnE,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA6FD,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAsJT"}

package/dist/commands/pjm/index.js

@@ -120,14 +120,17 @@ export function createPjmCommand(overrides = {}) {
     });
     cmd
         .command('doctor')
-        .description('Run PJM repo reference diagnostics')
+        .description('Run PJM repo reference diagnostics when enabled')
         .option('--repo-root <path>', 'PJM repo reference root directory (defaults to .oat/repo)')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         try {
             const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
             const repoRoot = await resolveRepoRoot(context, projectRoot, options.repoRoot);
-            const checks = await dependencies.runPjmDoctorChecks(repoRoot);
+            const config = await dependencies.readOatConfig(projectRoot);
+            const checks = await dependencies.runPjmDoctorChecks(repoRoot, {
+                projectManagementEnabled: config.tools?.['project-management'] === true,
+            });
             const status = doctorStatus(checks);
             if (context.json) {
                 context.logger.json({ status, repoRoot, checks });

package/dist/commands/sync/apply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAgEtB,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,aAAa,EAAE,EAC3B,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,IAAI,CAAC,CAwEf"}
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EACV,aAAa,EACb,uBAAuB,EAExB,MAAM,cAAc,CAAC;AAgEtB,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,aAAa,EAAE,EAC3B,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,IAAI,CAAC,CA8Ef"}

package/dist/commands/sync/apply.js

@@ -1,3 +1,4 @@
+import { OAT_VERSION } from '../../shared/oat-version.js';
 import { countPlannedOperations } from './sync.utils.js';
 function countSkippedEntries(scopePlans) {
     return scopePlans.reduce((total, scopePlan) => {
@@ -45,10 +46,13 @@ export async function runSyncApply(context, scopePlans, dependencies) {
     for (const scopePlan of scopePlans) {
         const hasSyncEntries = scopePlan.plan.entries.length > 0 || scopePlan.plan.removals.length > 0;
         const hasCodexPlannedOperations = scopePlan.codexExtensionPlan?.operations.some((operation) => operation.action !== 'skip') ?? false;
-        if (!hasSyncEntries && !hasCodexPlannedOperations) {
+        const shouldRefreshManifestVersion = scopePlan.manifest.oatVersion !== OAT_VERSION;
+        if (!hasSyncEntries &&
+            !hasCodexPlannedOperations &&
+            !shouldRefreshManifestVersion) {
             continue;
         }
-        if (hasSyncEntries) {
+        if (hasSyncEntries || shouldRefreshManifestVersion) {
             const result = await dependencies.executeSyncPlan(scopePlan.plan, scopePlan.manifest, scopePlan.manifestPath);
             applied += result.applied;
             failed += result.failed;

package/dist/config/oat-config.d.ts

@@ -23,6 +23,8 @@ export type WorkflowDesignMode = 'collaborative' | 'selective' | 'draft';
 export type WorkflowCodexDispatchCeiling = 'low' | 'medium' | 'high' | 'xhigh';
 export type WorkflowClaudeDispatchCeiling = 'haiku' | 'sonnet' | 'opus';
 export type WorkflowDispatchCeilingPreset = 'balanced' | 'maximum' | 'cost-conscious';
+export type GateOnFailure = 'block' | 'prompt' | 'warn';
+export type GateAvoid = 'same-runtime' | 'none';
 export interface WorkflowDispatchCeiling {
     preset?: WorkflowDispatchCeilingPreset;
     providers?: {
@@ -34,6 +36,24 @@ export interface WorkflowAutoArtifactReview {
     plan?: boolean;
     analysis?: boolean;
 }
+export interface GateConfig {
+    command: string;
+    onFailure: GateOnFailure;
+    description?: string;
+    maxAttempts?: number;
+}
+export interface ExecTarget {
+    runtime: string;
+    baseCommand: string[];
+    hostDetectionCommand?: string[];
+    availabilityCommand?: string[];
+    priority: number;
+}
+export type ExecTargetConfig = Partial<ExecTarget>;
+export interface WorkflowGatesConfig {
+    execTargets?: Record<string, ExecTargetConfig | null>;
+    skills?: Record<string, GateConfig | null>;
+}
 export interface OatWorkflowConfig {
     hillCheckpointDefault?: WorkflowHillCheckpointDefault;
     archiveOnComplete?: boolean;
@@ -45,10 +65,12 @@ export interface OatWorkflowConfig {
     autoArtifactReview?: WorkflowAutoArtifactReview;
     designMode?: WorkflowDesignMode;
     dispatchCeiling?: WorkflowDispatchCeiling;
+    gates?: WorkflowGatesConfig;
 }
 export declare const VALID_CODEX_DISPATCH_CEILINGS: readonly WorkflowCodexDispatchCeiling[];
 export declare const VALID_CLAUDE_DISPATCH_CEILINGS: readonly WorkflowClaudeDispatchCeiling[];
 export declare const VALID_DISPATCH_CEILING_PRESETS: readonly WorkflowDispatchCeilingPreset[];
+export declare const BUILTIN_EXEC_TARGETS: Readonly<Record<string, ExecTarget>>;
 export type OatToolsConfig = Partial<Record<'core' | 'ideas' | 'docs' | 'workflows' | 'utility' | 'project-management' | 'research' | 'brainstorm', boolean>>;
 export interface OatConfig {
     version: number;

package/dist/config/oat-config.d.ts.map

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

package/dist/config/oat-config.js

@@ -19,6 +19,128 @@ const VALID_DESIGN_MODES = [
 export const VALID_CODEX_DISPATCH_CEILINGS = ['low', 'medium', 'high', 'xhigh'];
 export const VALID_CLAUDE_DISPATCH_CEILINGS = ['haiku', 'sonnet', 'opus'];
 export const VALID_DISPATCH_CEILING_PRESETS = ['balanced', 'maximum', 'cost-conscious'];
+const VALID_GATE_ON_FAILURES = [
+    'block',
+    'prompt',
+    'warn',
+];
+export const BUILTIN_EXEC_TARGETS = {
+    'codex-default': {
+        runtime: 'codex',
+        baseCommand: ['codex', 'exec'],
+        hostDetectionCommand: [
+            'sh',
+            '-c',
+            '[ -n "$CODEX_THREAD_ID" ] || [ -n "$CODEX_SESSION_ID" ]',
+        ],
+        availabilityCommand: ['codex', '--version'],
+        priority: 100,
+    },
+    'claude-default': {
+        runtime: 'claude',
+        baseCommand: ['claude', '-p'],
+        hostDetectionCommand: ['sh', '-c', 'test -n "$CLAUDECODE"'],
+        availabilityCommand: ['claude', '--version'],
+        priority: 100,
+    },
+    'cursor-default': {
+        runtime: 'cursor',
+        baseCommand: ['cursor-agent', '-p', '--force'],
+        hostDetectionCommand: ['sh', '-c', 'test -n "$CURSOR_AGENT"'],
+        availabilityCommand: ['cursor-agent', '--version'],
+        priority: 70,
+    },
+};
+function normalizeMaxAttempts(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        return 2;
+    }
+    const attempts = Math.trunc(value);
+    return attempts >= 1 ? attempts : 2;
+}
+function normalizeArgv(value) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        !value.every((item) => typeof item === 'string')) {
+        return undefined;
+    }
+    const [executable] = value;
+    if (executable === undefined || !executable.trim()) {
+        return undefined;
+    }
+    return [...value];
+}
+function normalizeGateConfig(value) {
+    if (value === null) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const command = trimNonEmptyString(value.command);
+    if (command === undefined ||
+        typeof value.onFailure !== 'string' ||
+        !VALID_GATE_ON_FAILURES.includes(value.onFailure)) {
+        return undefined;
+    }
+    const gate = {
+        command,
+        onFailure: value.onFailure,
+        maxAttempts: normalizeMaxAttempts(value.maxAttempts),
+    };
+    const description = trimNonEmptyString(value.description);
+    if (description !== undefined) {
+        gate.description = description;
+    }
+    return gate;
+}
+function normalizeExecTarget(value) {
+    if (value === null) {
+        return null;
+    }
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const target = {};
+    const runtime = trimNonEmptyString(value.runtime);
+    if (runtime !== undefined) {
+        target.runtime = runtime;
+    }
+    const baseCommand = normalizeArgv(value.baseCommand);
+    if (baseCommand !== undefined) {
+        target.baseCommand = baseCommand;
+    }
+    if ('priority' in value) {
+        if (typeof value.priority === 'number' && Number.isFinite(value.priority)) {
+            target.priority = value.priority;
+        }
+    }
+    const hostDetectionCommand = normalizeArgv(value.hostDetectionCommand);
+    if (hostDetectionCommand !== undefined) {
+        target.hostDetectionCommand = hostDetectionCommand;
+    }
+    const availabilityCommand = normalizeArgv(value.availabilityCommand);
+    if (availabilityCommand !== undefined) {
+        target.availabilityCommand = availabilityCommand;
+    }
+    return Object.keys(target).length > 0 ? target : undefined;
+}
+function normalizeRecordMap(value, normalizeValue) {
+    if (!isRecord(value)) {
+        return undefined;
+    }
+    const next = {};
+    for (const [key, rawEntry] of Object.entries(value)) {
+        if (!key.trim()) {
+            continue;
+        }
+        const normalized = normalizeValue(rawEntry);
+        if (normalized !== undefined) {
+            next[key] = normalized;
+        }
+    }
+    return Object.keys(next).length > 0 ? next : undefined;
+}
 function normalizeWorkflowConfig(parsed) {
     if (!isRecord(parsed)) {
         return undefined;
@@ -94,6 +216,20 @@ function normalizeWorkflowConfig(parsed) {
             next.dispatchCeiling = dispatchCeiling;
         }
     }
+    if (isRecord(parsed.gates)) {
+        const gates = {};
+        const execTargets = normalizeRecordMap(parsed.gates.execTargets, normalizeExecTarget);
+        if (execTargets !== undefined) {
+            gates.execTargets = execTargets;
+        }
+        const skills = normalizeRecordMap(parsed.gates.skills, normalizeGateConfig);
+        if (skills !== undefined) {
+            gates.skills = skills;
+        }
+        if (Object.keys(gates).length > 0) {
+            next.gates = gates;
+        }
+    }
     return Object.keys(next).length > 0 ? next : undefined;
 }
 const DEFAULT_OAT_CONFIG = { version: 1 };

package/dist/config/resolve.d.ts

@@ -1,4 +1,4 @@
-import { type OatConfig, type OatLocalConfig, type UserConfig } from './oat-config.js';
+import { type ExecTarget, type GateConfig, type OatConfig, type OatLocalConfig, type UserConfig } from './oat-config.js';
 export type ResolvedConfigSource = 'shared' | 'local' | 'user' | 'env' | 'default';
 export interface ResolvedKeyEntry {
     value: unknown;
@@ -16,4 +16,6 @@ export interface ResolveEffectiveConfigDependencies {
     readUserConfig: (userConfigDir: string) => Promise<UserConfig>;
 }
 export declare function resolveEffectiveConfig(repoRoot: string, userConfigDir: string, env?: NodeJS.ProcessEnv, overrides?: Partial<ResolveEffectiveConfigDependencies>): Promise<ResolvedConfig>;
+export declare function resolveGate(effective: ResolvedConfig, skillName: string): GateConfig | null;
+export declare function resolveExecTargets(effective: ResolvedConfig): Record<string, ExecTarget>;
 //# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AA+ED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgFzB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AA+ED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAgFzB;AAED,wBAAgB,WAAW,CACzB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,MAAM,GAChB,UAAU,GAAG,IAAI,CAcnB;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,cAAc,GACxB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAY5B"}

package/dist/config/resolve.js

@@ -1,4 +1,4 @@
-import { readOatConfig, readOatLocalConfig, readUserConfig, } from './oat-config.js';
+import { BUILTIN_EXEC_TARGETS, readOatConfig, readOatLocalConfig, readUserConfig, } from './oat-config.js';
 const DEFAULT_DEPENDENCIES = {
     readOatConfig,
     readOatLocalConfig,
@@ -139,6 +139,105 @@ export async function resolveEffectiveConfig(repoRoot, userConfigDir, env = proc
         resolved,
     };
 }
+export function resolveGate(effective, skillName) {
+    for (const skills of [
+        effective.local.workflow?.gates?.skills,
+        effective.shared.workflow?.gates?.skills,
+        effective.user.workflow?.gates?.skills,
+    ]) {
+        if (!skills || !hasOwn(skills, skillName)) {
+            continue;
+        }
+        return skills[skillName] ?? null;
+    }
+    return null;
+}
+export function resolveExecTargets(effective) {
+    const targets = cloneExecTargetRegistry(BUILTIN_EXEC_TARGETS);
+    for (const execTargets of [
+        effective.user.workflow?.gates?.execTargets,
+        effective.shared.workflow?.gates?.execTargets,
+        effective.local.workflow?.gates?.execTargets,
+    ]) {
+        mergeExecTargetLayer(targets, execTargets);
+    }
+    return targets;
+}
+function mergeExecTargetLayer(targets, layer) {
+    if (!layer) {
+        return;
+    }
+    for (const [id, override] of Object.entries(layer)) {
+        if (override === null) {
+            delete targets[id];
+            continue;
+        }
+        const existing = targets[id];
+        if (existing) {
+            targets[id] = cloneExecTarget({
+                runtime: override.runtime ?? existing.runtime,
+                baseCommand: override.baseCommand ?? existing.baseCommand,
+                hostDetectionCommand: override.hostDetectionCommand ?? existing.hostDetectionCommand,
+                availabilityCommand: override.availabilityCommand ?? existing.availabilityCommand,
+                priority: override.priority ?? existing.priority,
+            });
+            continue;
+        }
+        const completeTarget = toCompleteExecTarget(override);
+        if (completeTarget) {
+            targets[id] = completeTarget;
+        }
+    }
+}
+function cloneExecTargetRegistry(registry) {
+    return Object.fromEntries(Object.entries(registry).map(([id, target]) => [
+        id,
+        cloneExecTarget(target),
+    ]));
+}
+function cloneExecTarget(target) {
+    const next = {
+        runtime: target.runtime,
+        baseCommand: [...target.baseCommand],
+        priority: target.priority,
+    };
+    if (target.hostDetectionCommand) {
+        next.hostDetectionCommand = [...target.hostDetectionCommand];
+    }
+    if (target.availabilityCommand) {
+        next.availabilityCommand = [...target.availabilityCommand];
+    }
+    return next;
+}
+function toCompleteExecTarget(target) {
+    const runtime = typeof target.runtime === 'string' ? target.runtime.trim() : '';
+    if (!runtime || !isValidArgv(target.baseCommand)) {
+        return null;
+    }
+    const completeTarget = {
+        runtime,
+        baseCommand: [...target.baseCommand],
+        priority: typeof target.priority === 'number' && Number.isFinite(target.priority)
+            ? target.priority
+            : 0,
+    };
+    if (isValidArgv(target.hostDetectionCommand)) {
+        completeTarget.hostDetectionCommand = [...target.hostDetectionCommand];
+    }
+    if (isValidArgv(target.availabilityCommand)) {
+        completeTarget.availabilityCommand = [...target.availabilityCommand];
+    }
+    return completeTarget;
+}
+function isValidArgv(value) {
+    if (!Array.isArray(value) ||
+        value.length === 0 ||
+        !value.every((part) => typeof part === 'string')) {
+        return false;
+    }
+    const [executable] = value;
+    return executable !== undefined && executable.trim().length > 0;
+}
 function flattenConfig(value, prefix = '') {
     if (!isRecord(value)) {
         return {};
@@ -168,6 +267,9 @@ function resolveEnvOverride(key, env) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
 function isResolvedValue(value) {
     return value !== undefined && value !== null;
 }

package/dist/manifest/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/manifest/manager.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAa1B,wBAAgB,mBAAmB,IAAI,QAAQ,CAO9C;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6C1E;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,aAAa,GAAG,SAAS,CAK3B;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ,CAc3E;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,QAAQ,CAeV"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/manifest/manager.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAa1B,wBAAgB,mBAAmB,IAAI,QAAQ,CAO9C;AAED,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6C1E;AAED,wBAAsB,YAAY,CAChC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,wBAAgB,SAAS,CACvB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,aAAa,GAAG,SAAS,CAK3B;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,GAAG,QAAQ,CAc3E;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,QAAQ,CAeV"}

package/dist/manifest/manager.js

@@ -54,7 +54,10 @@ export async function loadManifest(manifestPath) {
     }
 }
 export async function saveManifest(manifestPath, manifest) {
-    const validated = ManifestSchema.parse(manifest);
+    const validated = ManifestSchema.parse({
+        ...manifest,
+        oatVersion: OAT_VERSION,
+    });
     const dir = dirname(manifestPath);
     const tempPath = `${manifestPath}.${randomUUID()}.tmp`;
     await mkdir(dir, { recursive: true });

package/dist/validation/skills.d.ts

@@ -1,6 +1,7 @@
 export interface ValidationFinding {
     file: string;
     message: string;
+    severity?: 'error' | 'warning';
 }
 export interface ValidateOatSkillsResult {
     validatedSkillCount: number;
@@ -15,6 +16,7 @@ export interface ValidateChangedSkillVersionBumpsResult {
 }
 export interface ValidateOatSkillsOptions {
     baseRef?: string;
+    gateSkillNames?: readonly string[];
 }
 export type ExecFileResult = {
     stdout: string;

package/dist/validation/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/validation/skills.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,UAAU,6BAA6B;IACrC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAmPD,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uCAAuC,EAChD,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,sCAAsC,CAAC,CAoBjD;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CA6HlC"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/validation/skills.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sCAAsC;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,KAChD,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,UAAU,6BAA6B;IACrC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAuSD,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uCAAuC,EAChD,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,sCAAsC,CAAC,CAoBjD;AAED,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,EACtC,YAAY,GAAE,6BAAkC,GAC/C,OAAO,CAAC,uBAAuB,CAAC,CAmIlC"}

package/dist/validation/skills.js

@@ -22,6 +22,10 @@ function getFrontmatterScalar(frontmatter, key) {
     const match = frontmatter.match(re);
     return match?.[1]?.trim() ?? null;
 }
+function hasTrueFrontmatterValue(frontmatter, key) {
+    return (frontmatterHasKey(frontmatter, key) &&
+        getFrontmatterScalar(frontmatter, key) === 'true');
+}
 function isValidSemver(value) {
     return /^\d+\.\d+\.\d+$/.test(value);
 }
@@ -87,6 +91,40 @@ function validateQuickStartSemantics(skillPath, content, findings) {
         });
     }
 }
+function normalizeGateSkillNames(gateSkillNames) {
+    if (!gateSkillNames) {
+        return [];
+    }
+    return [
+        ...new Set(gateSkillNames.map((name) => name.trim()).filter(Boolean)),
+    ].sort();
+}
+async function collectGateabilityFindings(skillsRoot, gateSkillNames, findings) {
+    for (const skillName of normalizeGateSkillNames(gateSkillNames)) {
+        const skillPath = join(skillsRoot, skillName, 'SKILL.md');
+        let content;
+        try {
+            content = await readFile(skillPath, 'utf8');
+        }
+        catch {
+            findings.push({
+                file: skillPath,
+                message: `Configured gate targets unknown skill: ${skillName}`,
+                severity: 'warning',
+            });
+            continue;
+        }
+        const frontmatter = getFrontmatterBlock(content);
+        if (frontmatter === null ||
+            !hasTrueFrontmatterValue(frontmatter, 'oat_gateable')) {
+            findings.push({
+                file: skillPath,
+                message: 'Configured gate targets skill without oat_gateable: true',
+                severity: 'warning',
+            });
+        }
+    }
+}
 async function listChangedSkillFiles(repoRoot, baseRef, dependencies) {
     const execFile = dependencies.gitExecFile ?? execFileAsync;
     const { stdout } = await execFile('git', [
@@ -261,6 +299,7 @@ export async function validateOatSkills(repoRoot, options = {}, dependencies = {
             validateQuickStartSemantics(skillPath, content, findings);
         }
     }
+    await collectGateabilityFindings(skillsRoot, options.gateSkillNames, findings);
     if (options.baseRef) {
         const changedSkillFiles = await listChangedSkillFiles(repoRoot, options.baseRef, dependencies);
         await collectChangedSkillVersionBumpFindings(repoRoot, options.baseRef, changedSkillFiles, findings, dependencies);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.1.32"
+    "@open-agent-toolkit/control-plane": "0.1.34"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",