@open-agent-toolkit/cli 0.0.10

package/dist/commands/docs/migrate/index.js

@@ -0,0 +1,138 @@
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { fileExists } from '../../../fs/io.js';
+import { Command, Option } from 'commander';
+import { convertAdmonitions } from './codemod.js';
+import { injectFrontmatter } from './frontmatter.js';
+function parseMkdocsNavTitles(yamlContent) {
+    const titles = new Map();
+    const lineRe = /^\s*-\s+(?:'([^']+)'|"([^"]+)")\s*:\s*(.+)\s*$/gm;
+    for (const match of yamlContent.matchAll(lineRe)) {
+        const title = match[1] ?? match[2];
+        const path = match[3].trim().replace(/^['"]|['"]$/g, '');
+        titles.set(path, title);
+    }
+    return titles;
+}
+async function migrateFiles(cwd, options, deps) {
+    const docsDir = join(cwd, options.docsDir);
+    const changes = [];
+    let navTitles = new Map();
+    if (options.config) {
+        const configPath = join(cwd, options.config);
+        if (await deps.fileExists(configPath)) {
+            const yamlContent = await deps.readFile(configPath, 'utf8');
+            navTitles = parseMkdocsNavTitles(yamlContent);
+        }
+    }
+    const entries = await deps.readdir(docsDir, {
+        withFileTypes: true,
+        recursive: true,
+    });
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.md')) {
+            continue;
+        }
+        const parentPath = entry.parentPath ?? entry.path;
+        const filePath = join(parentPath, entry.name);
+        const relativePath = filePath.slice(docsDir.length + 1);
+        const content = await deps.readFile(filePath, 'utf8');
+        const admonitionResult = convertAdmonitions(content);
+        const mkdocsTitle = navTitles.get(relativePath);
+        const frontmatterResult = injectFrontmatter(admonitionResult.content, {
+            mkdocsTitle,
+            fileName: basename(filePath),
+        });
+        const hasChanges = admonitionResult.admonitionsConverted > 0 ||
+            frontmatterResult.titleInjected ||
+            frontmatterResult.descriptionSeeded;
+        if (hasChanges) {
+            if (options.apply) {
+                await deps.writeFile(filePath, frontmatterResult.content, 'utf8');
+            }
+            changes.push({
+                path: relativePath,
+                admonitionsConverted: admonitionResult.admonitionsConverted,
+                titleInjected: frontmatterResult.titleInjected,
+                descriptionSeeded: frontmatterResult.descriptionSeeded,
+            });
+        }
+    }
+    return changes;
+}
+const DEFAULT_FILE_DEPS = {
+    readFile,
+    writeFile,
+    readdir: readdir,
+    fileExists,
+};
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    fileDeps: DEFAULT_FILE_DEPS,
+};
+async function runMigrateCommand(context, options, dependencies) {
+    try {
+        const changes = await migrateFiles(context.cwd, options, dependencies.fileDeps);
+        const mode = options.apply ? 'applied' : 'dry-run';
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                mode,
+                filesScanned: changes.length,
+                changes,
+            });
+            process.exitCode = 0;
+            return;
+        }
+        if (changes.length === 0) {
+            context.logger.info('No files need migration.');
+            process.exitCode = 0;
+            return;
+        }
+        context.logger.info(`Migration ${mode}: ${changes.length} file(s) changed`);
+        for (const change of changes) {
+            const parts = [];
+            if (change.admonitionsConverted > 0) {
+                parts.push(`${change.admonitionsConverted} admonition(s)`);
+            }
+            if (change.titleInjected) {
+                parts.push('title injected');
+            }
+            if (change.descriptionSeeded) {
+                parts.push('description seeded');
+            }
+            context.logger.info(`  ${change.path}: ${parts.join(', ')}`);
+        }
+        if (!options.apply) {
+            context.logger.info('\nRe-run with --apply to write changes.');
+        }
+        process.exitCode = 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (context.json) {
+            context.logger.json({ status: 'error', message });
+        }
+        else {
+            context.logger.error(message);
+        }
+        process.exitCode = 1;
+    }
+}
+export function createDocsMigrateCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('migrate')
+        .description('Migrate MkDocs markdown to Fumadocs format (admonitions, frontmatter)')
+        .addOption(new Option('--docs-dir <path>', 'Documentation source directory').default('docs'))
+        .addOption(new Option('--config <path>', 'Path to mkdocs.yml for nav title lookup'))
+        .option('--apply', 'Apply changes (default: dry-run)', false)
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runMigrateCommand(context, options, dependencies);
+    });
+}

package/dist/commands/docs/nav/contents.d.ts

@@ -0,0 +1,14 @@
+export interface DocsContentsEntry {
+    title: string;
+    href: string;
+}
+export declare function parseIndexContents(markdown: string, sourcePath?: string): DocsContentsEntry[];
+export type DocsNavTree = Array<Record<string, DocsNavTree | string> | string>;
+interface BuildDocsNavTreeOptions {
+    docsRoot: string;
+    dirRelativePath?: string;
+    visitedDirectories?: Set<string>;
+}
+export declare function buildDocsNavTree(options: BuildDocsNavTreeOptions): Promise<DocsNavTree>;
+export {};
+//# sourceMappingURL=contents.d.ts.map

package/dist/commands/docs/nav/contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/nav/contents.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,SAAa,GACtB,iBAAiB,EAAE,CAqCrB;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;AAE/E,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAClC;AAgFD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,WAAW,CAAC,CA8DtB"}

package/dist/commands/docs/nav/contents.js

@@ -0,0 +1,106 @@
+import { readFile } from 'node:fs/promises';
+import { basename, dirname, extname, join, relative, resolve } from 'node:path';
+import { dirExists, fileExists } from '../../../fs/io.js';
+export function parseIndexContents(markdown, sourcePath = 'index.md') {
+    const lines = markdown.split(/\r?\n/);
+    const contentsHeadingIndex = lines.findIndex((line) => /^##\s+Contents\s*$/.test(line.trim()));
+    if (contentsHeadingIndex < 0) {
+        throw new Error(`Missing required ## Contents section in ${sourcePath}`);
+    }
+    const sectionLines = lines.slice(contentsHeadingIndex + 1);
+    const nextHeadingIndex = sectionLines.findIndex((line) => /^##\s+/.test(line.trim()));
+    const contentsLines = nextHeadingIndex >= 0
+        ? sectionLines.slice(0, nextHeadingIndex)
+        : sectionLines;
+    const entries = contentsLines
+        .map((line) => line.match(/^\s*-\s+\[([^\]]+)\]\(([^)]+)\)/))
+        .filter((match) => match !== null)
+        .map((match) => {
+        const [, title = '', href = ''] = match;
+        return {
+            title: title.trim(),
+            href: href.trim(),
+        };
+    });
+    if (entries.length === 0) {
+        throw new Error(`No machine-readable links found under ## Contents in ${sourcePath}`);
+    }
+    return entries;
+}
+function toPosixPath(path) {
+    return path.replaceAll('\\', '/');
+}
+async function resolveEntryTarget(docsRoot, directoryPath, dirRelativePath, entry) {
+    const href = entry.href.split('#', 1)[0]?.trim() ?? '';
+    if (!href) {
+        throw new Error(`Invalid contents link "${entry.href}" in ${join(docsRoot, dirRelativePath, 'index.md')}`);
+    }
+    let targetPath = resolve(directoryPath, href);
+    if (!href.endsWith('.md')) {
+        const directoryTarget = resolve(directoryPath, href);
+        if (await dirExists(directoryTarget)) {
+            targetPath = join(directoryTarget, 'index.md');
+        }
+    }
+    const relativeTargetPath = toPosixPath(relative(docsRoot, targetPath));
+    if (relativeTargetPath.startsWith('../') ||
+        relativeTargetPath === '..' ||
+        relativeTargetPath.length === 0) {
+        throw new Error(`Contents link "${entry.href}" escapes the docs directory from ${join(docsRoot, dirRelativePath, 'index.md')}`);
+    }
+    if (!(await fileExists(targetPath))) {
+        throw new Error(`Contents link "${entry.href}" in ${join(docsRoot, dirRelativePath, 'index.md')} does not resolve to a Markdown file`);
+    }
+    if (extname(targetPath) !== '.md') {
+        throw new Error(`Contents link "${entry.href}" in ${join(docsRoot, dirRelativePath, 'index.md')} must point to a Markdown file or directory index`);
+    }
+    if (basename(targetPath) === 'index.md') {
+        return {
+            kind: 'section',
+            path: relativeTargetPath,
+        };
+    }
+    return {
+        kind: 'page',
+        path: relativeTargetPath,
+    };
+}
+export async function buildDocsNavTree(options) {
+    const dirRelativePath = options.dirRelativePath ?? '.';
+    const visitedDirectories = options.visitedDirectories ?? new Set([dirRelativePath]);
+    const directoryPath = resolve(options.docsRoot, dirRelativePath);
+    const indexPath = join(directoryPath, 'index.md');
+    if (!(await fileExists(indexPath))) {
+        throw new Error(`Missing required index.md at ${indexPath}`);
+    }
+    const indexMarkdown = await readFile(indexPath, 'utf8');
+    const contentsEntries = parseIndexContents(indexMarkdown, indexPath);
+    const nav = dirRelativePath === '.'
+        ? [{ Home: 'index.md' }]
+        : [toPosixPath(join(dirRelativePath, 'index.md'))];
+    for (const entry of contentsEntries) {
+        const resolvedTarget = await resolveEntryTarget(options.docsRoot, directoryPath, dirRelativePath, entry);
+        if (resolvedTarget.kind === 'section' &&
+            resolvedTarget.path === toPosixPath(join(dirRelativePath, 'index.md'))) {
+            continue;
+        }
+        if (resolvedTarget.kind === 'page') {
+            nav.push({ [entry.title]: resolvedTarget.path });
+            continue;
+        }
+        const childDirRelativePath = toPosixPath(dirname(resolvedTarget.path));
+        if (visitedDirectories.has(childDirRelativePath)) {
+            throw new Error(`Circular docs navigation detected at ${join(options.docsRoot, childDirRelativePath, 'index.md')}`);
+        }
+        const childVisitedDirectories = new Set(visitedDirectories);
+        childVisitedDirectories.add(childDirRelativePath);
+        nav.push({
+            [entry.title]: await buildDocsNavTree({
+                docsRoot: options.docsRoot,
+                dirRelativePath: childDirRelativePath,
+                visitedDirectories: childVisitedDirectories,
+            }),
+        });
+    }
+    return nav;
+}

package/dist/commands/docs/nav/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createDocsNavCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/docs/nav/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/nav/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,oBAAoB,IAAI,OAAO,CAI9C"}

package/dist/commands/docs/nav/index.js

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+import { createDocsNavSyncCommand } from './sync.js';
+export function createDocsNavCommand() {
+    return new Command('nav')
+        .description('Docs navigation commands')
+        .addCommand(createDocsNavSyncCommand());
+}

package/dist/commands/docs/nav/sync.d.ts

@@ -0,0 +1,20 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { Command } from 'commander';
+import { type DocsNavTree } from './contents.js';
+interface SyncDocsNavigationOptions {
+    appRoot: string;
+}
+interface SyncDocsNavigationResult {
+    appRoot: string;
+    docsRoot: string;
+    mkdocsPath: string;
+    nav: DocsNavTree;
+}
+interface DocsNavSyncDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    syncDocsNavigation: (options: SyncDocsNavigationOptions) => Promise<SyncDocsNavigationResult>;
+}
+export declare function syncDocsNavigation(options: SyncDocsNavigationOptions): Promise<SyncDocsNavigationResult>;
+export declare function createDocsNavSyncCommand(overrides?: Partial<DocsNavSyncDependencies>): Command;
+export {};
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/docs/nav/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/nav/sync.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAMhE,UAAU,yBAAyB;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,UAAU,uBAAuB;IAC/B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAClB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACxC;AAmCD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CAmBnC;AAuCD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAoBT"}

package/dist/commands/docs/nav/sync.js

@@ -0,0 +1,92 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { buildCommandContext, } from '../../../app/command-context.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { Command, Option } from 'commander';
+import YAML from 'yaml';
+import { buildDocsNavTree } from './contents.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    syncDocsNavigation,
+};
+function replaceTopLevelYamlSection(source, key, replacement) {
+    const lines = source.split(/\r?\n/);
+    const startIndex = lines.findIndex((line) => line.startsWith(`${key}:`));
+    if (startIndex < 0) {
+        return `${source.trimEnd()}\n\n${replacement.trimEnd()}\n`;
+    }
+    let endIndex = startIndex + 1;
+    while (endIndex < lines.length) {
+        const line = lines[endIndex] ?? '';
+        if (line.length > 0 && /^\S/.test(line)) {
+            break;
+        }
+        endIndex += 1;
+    }
+    return [
+        ...lines.slice(0, startIndex),
+        ...replacement.trimEnd().split('\n'),
+        ...lines.slice(endIndex),
+    ].join('\n');
+}
+export async function syncDocsNavigation(options) {
+    const mkdocsPath = join(options.appRoot, 'mkdocs.yml');
+    const docsRoot = join(options.appRoot, 'docs');
+    const nav = await buildDocsNavTree({ docsRoot });
+    const mkdocsSource = await readFile(mkdocsPath, 'utf8');
+    const navSection = YAML.stringify({ nav }).trimEnd();
+    const updatedMkdocsSource = replaceTopLevelYamlSection(mkdocsSource, 'nav', navSection);
+    await writeFile(mkdocsPath, `${updatedMkdocsSource.trimEnd()}\n`, 'utf8');
+    return {
+        appRoot: options.appRoot,
+        docsRoot,
+        mkdocsPath,
+        nav,
+    };
+}
+async function runDocsNavSyncCommand(context, options, dependencies) {
+    try {
+        const targetDir = options.targetDir ?? '.';
+        const result = await dependencies.syncDocsNavigation({
+            appRoot: resolve(context.cwd, targetDir),
+        });
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                appRoot: result.appRoot,
+                docsRoot: result.docsRoot,
+                mkdocsPath: result.mkdocsPath,
+                nav: result.nav,
+            });
+        }
+        else {
+            context.logger.info(`Synced docs navigation in ${targetDir}`);
+            context.logger.info(`  MkDocs config: ${result.mkdocsPath}`);
+            context.logger.info(`  Docs root: ${result.docsRoot}`);
+        }
+        process.exitCode = 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (context.json) {
+            context.logger.json({ status: 'error', message });
+        }
+        else {
+            context.logger.error(message);
+        }
+        process.exitCode = 1;
+    }
+}
+export function createDocsNavSyncCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('sync')
+        .description('Regenerate docs navigation from index.md contents')
+        .addOption(new Option('--target-dir <path>', 'Docs app directory containing mkdocs.yml'))
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runDocsNavSyncCommand(context, options, dependencies);
+    });
+}

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

@@ -0,0 +1,32 @@
+import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { type Manifest } from '../../manifest/index.js';
+import type { ConcreteScope } from '../../shared/types.js';
+import { Command } from 'commander';
+interface DoctorDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveScopeRoot: (scope: ConcreteScope, context: CommandContext) => Promise<string>;
+    pathExists: (path: string) => Promise<boolean>;
+    loadManifest: (manifestPath: string) => Promise<Manifest>;
+    checkSymlinkSupport: (scopeRoot: string) => Promise<boolean>;
+    checkProviders: (scopeRoot: string) => Promise<Array<{
+        name: string;
+        detected: boolean;
+        version: string | null;
+    }>>;
+    readFile: (path: string) => Promise<string>;
+    resolveAssetsRoot: () => Promise<string>;
+    checkSkillVersions: (scopeRoot: string, assetsRoot: string, pathExists: (path: string) => Promise<boolean>) => Promise<SkillVersionReport>;
+}
+interface OutdatedSkillVersion {
+    skill: string;
+    installedVersion: string | null;
+    bundledVersion: string | null;
+}
+interface SkillVersionReport {
+    installedSkillCount: number;
+    skippedMissingBundledCount: number;
+    outdatedSkills: OutdatedSkillVersion[];
+}
+export declare function createDoctorCommand(overrides?: Partial<DoctorDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,KACd,OAAO,CACV,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CACnE,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAsaD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,OAAO,CAcT"}