@open-agent-toolkit/cli 0.2.51 → 0.2.53

package/dist/commands/providers/set/index.js

@@ -1,16 +1,11 @@
 import { join } from 'node:path';
 import { buildCommandContext } from '../../../app/command-context.js';
-import { withScopeOption } from '../../shared/scope-option.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { DEFAULT_SYNC_CONFIG, loadSyncConfig, saveSyncConfig, } from '../../../config/index.js';
-import { resolveProjectRoot } from '../../../fs/paths.js';
-import { claudeAdapter } from '../../../providers/claude/index.js';
-import { codexAdapter } from '../../../providers/codex/index.js';
-import { copilotAdapter } from '../../../providers/copilot/index.js';
-import { cursorAdapter } from '../../../providers/cursor/index.js';
-import { geminiAdapter } from '../../../providers/gemini/index.js';
-import { Command } from 'commander';
-const PROJECT_SCOPE_ONLY_MESSAGE = 'oat providers set only supports project scope. Remove --scope or pass --scope project.';
+import { getUserSyncConfigPath, resolveUserSyncConfig, updateUserSyncConfig, } from '../../../config/user-sync-config.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../../fs/paths.js';
+import { getProviderRegistrations, resolveProviderScopeContext, } from '../../../providers/shared/index.js';
+import { Command, Option } from 'commander';
 function parseCsvList(raw) {
     if (!raw) {
         return [];
@@ -31,21 +26,18 @@ function createDependencies() {
             if (scope === 'project') {
                 return resolveProjectRoot(context.cwd);
             }
-            throw new Error(PROJECT_SCOPE_ONLY_MESSAGE);
+            return resolveScopeRoot(scope, context.cwd, context.home);
         },
         getAdapters() {
-            return [
-                claudeAdapter,
-                cursorAdapter,
-                codexAdapter,
-                copilotAdapter,
-                geminiAdapter,
-            ];
+            return getProviderRegistrations().map(({ adapter }) => adapter);
         },
         async loadSyncConfig(configPath) {
             return loadSyncConfig(configPath, DEFAULT_SYNC_CONFIG);
         },
         saveSyncConfig,
+        resolveProviderScopeContext,
+        resolveUserSyncConfig,
+        updateUserSyncConfig,
     };
 }
 function buildUpdatedConfig(config, enabledProviders, disabledProviders) {
@@ -71,8 +63,8 @@ function buildUpdatedConfig(config, enabledProviders, disabledProviders) {
 }
 async function runProvidersSetCommand(context, options, dependencies) {
     try {
-        if (context.scope !== 'project') {
-            throw new Error(PROJECT_SCOPE_ONLY_MESSAGE);
+        if (context.scope === 'all') {
+            throw new Error('oat providers set requires one concrete scope. Pass --scope project or --scope user.');
         }
         const enabledProviders = parseCsvList(options.enabled);
         const disabledProviders = parseCsvList(options.disabled);
@@ -83,22 +75,36 @@ async function runProvidersSetCommand(context, options, dependencies) {
         if (overlap.length > 0) {
             throw new Error(`Providers cannot be both enabled and disabled: ${overlap.join(', ')}`);
         }
-        const knownProviders = dependencies
-            .getAdapters()
-            .map((adapter) => adapter.name);
+        const scope = context.scope;
+        const scopeRoot = await dependencies.resolveScopeRoot(scope, context);
+        const userConfigDir = join(scopeRoot, '.oat');
+        const configPath = scope === 'user'
+            ? getUserSyncConfigPath(userConfigDir)
+            : join(scopeRoot, '.oat', 'sync', 'config.json');
+        const config = scope === 'user' && dependencies.resolveUserSyncConfig
+            ? await dependencies.resolveUserSyncConfig(userConfigDir)
+            : await dependencies.loadSyncConfig(configPath);
+        const providerContext = dependencies.resolveProviderScopeContext
+            ? await dependencies.resolveProviderScopeContext({
+                scope,
+                scopeRoot,
+                config,
+            })
+            : undefined;
+        const knownProviders = providerContext
+            ? providerContext.registrations.map(({ adapter }) => adapter.name)
+            : dependencies.getAdapters().map((adapter) => adapter.name);
         const unknown = [...enabledProviders, ...disabledProviders].filter((provider) => !knownProviders.includes(provider));
         if (unknown.length > 0) {
             throw new Error(`Unknown providers: ${[...new Set(unknown)].join(', ')}. Known providers: ${knownProviders.join(', ')}`);
         }
-        const scopeRoot = await dependencies.resolveScopeRoot('project', context);
-        const configPath = join(scopeRoot, '.oat', 'sync', 'config.json');
-        const config = await dependencies.loadSyncConfig(configPath);
-        const updated = buildUpdatedConfig(config, enabledProviders, disabledProviders);
-        const saved = await dependencies.saveSyncConfig(configPath, updated);
+        const saved = scope === 'user' && dependencies.updateUserSyncConfig
+            ? await dependencies.updateUserSyncConfig(userConfigDir, (current) => buildUpdatedConfig(current, enabledProviders, disabledProviders))
+            : await dependencies.saveSyncConfig(configPath, buildUpdatedConfig(config, enabledProviders, disabledProviders));
         if (context.json) {
             context.logger.json({
                 status: 'ok',
-                scope: 'project',
+                scope,
                 configPath,
                 enabled: enabledProviders,
                 disabled: disabledProviders,
@@ -128,11 +134,15 @@ export function createProvidersSetCommand(overrides = {}) {
         ...createDependencies(),
         ...overrides,
     };
-    // Default to 'project' scope: providers set only supports project scope, so
-    // a bare `oat providers set --enabled X` should succeed without requiring
-    // an explicit --scope project flag.
-    return withScopeOption(new Command('set'), 'project')
-        .description('Enable or disable project providers in sync config')
+    if (overrides.resolveProviderScopeContext === undefined &&
+        overrides.getAdapters !== undefined) {
+        dependencies.resolveProviderScopeContext = undefined;
+    }
+    return new Command('set')
+        .description("Enable or disable providers in the selected scope's sync config (project by default)")
+        .addOption(new Option('--scope <scope>', 'Sync config scope: project or user')
+        .choices(['project', 'user'])
+        .default('project'))
         .option('--enabled <providers>', 'Comma-separated providers to enable')
         .option('--disabled <providers>', 'Comma-separated providers to disable')
         .action(async (options, command) => {

package/dist/commands/remove/skill/remove-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove-skill.d.ts","sourceRoot":"","sources":["../../../../src/commands/remove/skill/remove-skill.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EACL,iBAAiB,EAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,aAAa,EAGnB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,KAAK,yBAAyB,EAG9B,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAC1C,cAAc,CAAC;IACpB,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,WAAW,EAAE,MAAM,eAAe,EAAE,CAAC;IACrC,sBAAsB,EAAE,CACtB,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;IAC3E,kBAAkB,EAAE,CAClB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,KACT,cAAc,EAAE,CAAC;IACtB,iCAAiC,EAAE,CACjC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,wBAAgB,oCAAoC,IAAI,uBAAuB,CA0C9E;AAwND,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,OAAO,CAAC,CAsDlB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAwCT"}
+{"version":3,"file":"remove-skill.d.ts","sourceRoot":"","sources":["../../../../src/commands/remove/skill/remove-skill.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EACL,iBAAiB,EAElB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAGL,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,aAAa,EAInB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,KAAK,yBAAyB,EAG9B,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,MAAM,WAAW,uBAAuB;IACtC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,KAC1C,cAAc,CAAC;IACpB,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,WAAW,EAAE,MAAM,eAAe,EAAE,CAAC;IACrC,sBAAsB,EAAE,CACtB,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,KAAK,WAAW,EAAE,CAAC;IAC3E,kBAAkB,EAAE,CAClB,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,KAAK,KACT,cAAc,EAAE,CAAC;IACtB,iCAAiC,EAAE,CACjC,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,wBAAgB,oCAAoC,IAAI,uBAAuB,CA0C9E;AA2OD,wBAAsB,cAAc,CAClC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,uBAAuB,GACpC,OAAO,CAAC,OAAO,CAAC,CAsDlB;AAED,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAwCT"}

package/dist/commands/remove/skill/remove-skill.js

@@ -89,6 +89,12 @@ async function buildScopePlan(scope, scopeRoot, skillName, dependencies) {
     const managedProviderViews = [];
     const unmanagedProviderViews = [];
     const manifestProvidersToRemove = new Set();
+    for (const entry of manifest.entries) {
+        if (entry.canonicalPath === canonicalRelativePath &&
+            entry.strategy === 'collection') {
+            manifestProvidersToRemove.add(entry.provider);
+        }
+    }
     for (const adapter of activeAdapters) {
         const syncMappings = dependencies
             .getSyncMappings(adapter, scope)
@@ -101,6 +107,11 @@ async function buildScopePlan(scope, scopeRoot, skillName, dependencies) {
             const providerPathExists = await dependencies.pathExists(absolutePath);
             if (hasManifestEntry) {
                 manifestProvidersToRemove.add(adapter.name);
+                const manifestEntry = manifest.entries.find((entry) => entry.canonicalPath === canonicalRelativePath &&
+                    entry.provider === adapter.name);
+                if (manifestEntry?.strategy === 'collection') {
+                    continue;
+                }
                 managedProviderViews.push({
                     provider: adapter.name,
                     absolutePath,

package/dist/commands/shared/agents-md.d.ts

@@ -1,18 +1,46 @@
-export interface UpsertSectionResult {
-    action: 'created' | 'updated' | 'no-change';
-}
-/**
- * Insert or replace a managed section in AGENTS.md.
- *
- * - If AGENTS.md doesn't exist, creates it with the section.
- * - If the section markers exist, replaces the content between them.
- * - If AGENTS.md exists but the section markers don't, appends.
- */
-export declare function upsertAgentsMdSection(repoRoot: string, key: string, body: string): Promise<UpsertSectionResult>;
+import { lstat, readFile, readlink, realpath, writeFile } from 'node:fs/promises';
 /**
- * Remove a managed section from AGENTS.md if it exists.
+ * Plans repository AGENTS.md guidance without replacing existing paths.
  *
- * Returns true if the section was found and removed, false otherwise.
+ * An absent root file may be created with one exclusive write. Existing files
+ * and contained symlinks are read only: matching content returns no-change and
+ * every required change is returned as a copy-pasteable manual patch.
  */
-export declare function removeAgentsMdSection(repoRoot: string, key: string): Promise<boolean>;
+export interface AgentsMdFileSystem {
+    lstat: typeof lstat;
+    readFile: typeof readFile;
+    readlink: typeof readlink;
+    realpath: typeof realpath;
+    writeFile: typeof writeFile;
+}
+export interface AgentsMdMutationOptions {
+    fileSystem?: AgentsMdFileSystem;
+    removeSectionKeys?: readonly string[];
+}
+export interface AgentsMdManualPatch {
+    target: string;
+    managedBlock: string;
+    legacyBlockAction: 'preserve' | 'remove-manually';
+    instructions: readonly string[];
+}
+export interface AgentsMdBlocked {
+    code: 'blocked';
+    target: string;
+    reason: string;
+    action: string;
+}
+export interface UpsertSectionResult {
+    action: 'created' | 'no-change' | 'manual-required' | 'blocked';
+    manualPatch?: AgentsMdManualPatch;
+    blocked?: AgentsMdBlocked;
+}
+export interface AgentsMdSectionInput {
+    key: string;
+    body: string;
+}
+export declare function formatAgentsMdMutationFailure(error: unknown): string;
+export declare function formatAgentsMdGuidanceResult(result: UpsertSectionResult): readonly string[];
+export declare function upsertAgentsMdSections(repoRoot: string, sections: readonly AgentsMdSectionInput[], options?: Pick<AgentsMdMutationOptions, 'fileSystem'>): Promise<Record<string, UpsertSectionResult>>;
+export declare function upsertAgentsMdSection(repoRoot: string, key: string, body: string, options?: AgentsMdMutationOptions): Promise<UpsertSectionResult>;
+export declare function removeAgentsMdSection(repoRoot: string, key: string, options?: Pick<AgentsMdMutationOptions, 'fileSystem'>): Promise<boolean | 'manual-required' | 'blocked'>;
 //# sourceMappingURL=agents-md.d.ts.map

package/dist/commands/shared/agents-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/agents-md.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAgC9B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAwBlB"}
+{"version":3,"file":"agents-md.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/agents-md.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACV,MAAM,kBAAkB,CAAC;AAG1B;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,QAAQ,EAAE,OAAO,QAAQ,CAAC;IAC1B,SAAS,EAAE,OAAO,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAgCD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,UAAU,GAAG,iBAAiB,CAAC;IAClD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAChE,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAmTD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpE;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,mBAAmB,GAC1B,SAAS,MAAM,EAAE,CAoBnB;AA4ID,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,SAAS,oBAAoB,EAAE,EACzC,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAM,GACxD,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAS9C;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAS9B;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAM,GACxD,OAAO,CAAC,OAAO,GAAG,iBAAiB,GAAG,SAAS,CAAC,CAYlD"}