@open-agent-toolkit/cli 0.0.10

package/dist/commands/shared/codex-strays.js

@@ -0,0 +1,116 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import TOML from '@iarna/toml';
+function canonicalRoleNames(canonicalEntries) {
+    return new Set(canonicalEntries
+        .filter((entry) => entry.type === 'agent' && entry.isFile)
+        .map((entry) => entry.name.replace(/\.md$/i, '')));
+}
+function toRoleNameFromTomlPath(path) {
+    if (!path.startsWith('agents/') || !path.endsWith('.toml')) {
+        return null;
+    }
+    return path.replace(/^agents\//, '').replace(/\.toml$/i, '');
+}
+async function fileExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function detectFromConfig(scopeRoot, existingCanonicalRoles) {
+    const configPath = join(scopeRoot, '.codex', 'config.toml');
+    if (!(await fileExists(configPath))) {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = TOML.parse(await readFile(configPath, 'utf8'));
+    }
+    catch {
+        return [];
+    }
+    const agents = parsed.agents;
+    if (!agents || typeof agents !== 'object' || Array.isArray(agents)) {
+        return [];
+    }
+    const strays = [];
+    for (const [roleName, value] of Object.entries(agents)) {
+        if (existingCanonicalRoles.has(roleName)) {
+            continue;
+        }
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            continue;
+        }
+        const roleConfig = value;
+        const configFile = roleConfig.config_file;
+        if (typeof configFile !== 'string') {
+            continue;
+        }
+        const roleFromFile = toRoleNameFromTomlPath(configFile);
+        if (!roleFromFile) {
+            continue;
+        }
+        const providerPath = `.codex/${configFile}`;
+        const absoluteRolePath = join(scopeRoot, providerPath);
+        if (!(await fileExists(absoluteRolePath))) {
+            continue;
+        }
+        strays.push({
+            roleName,
+            providerPath,
+            description: typeof roleConfig.description === 'string'
+                ? roleConfig.description
+                : undefined,
+        });
+    }
+    return strays;
+}
+async function detectFromAgentsDirectory(scopeRoot, existingCanonicalRoles) {
+    const agentsDir = join(scopeRoot, '.codex', 'agents');
+    let entries;
+    try {
+        entries = await readdir(agentsDir, {
+            withFileTypes: true,
+            encoding: 'utf8',
+        });
+    }
+    catch {
+        return [];
+    }
+    const strays = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.toml')) {
+            continue;
+        }
+        const roleName = entry.name.replace(/\.toml$/i, '');
+        if (existingCanonicalRoles.has(roleName)) {
+            continue;
+        }
+        strays.push({
+            roleName,
+            providerPath: `.codex/agents/${entry.name}`,
+        });
+    }
+    return strays;
+}
+export async function detectCodexRoleStrays(scopeRoot, canonicalEntries) {
+    const roleNames = canonicalRoleNames(canonicalEntries);
+    const configStrays = await detectFromConfig(scopeRoot, roleNames);
+    const dirStrays = await detectFromAgentsDirectory(scopeRoot, roleNames);
+    const merged = new Map();
+    for (const stray of [...configStrays, ...dirStrays]) {
+        if (!merged.has(stray.providerPath)) {
+            merged.set(stray.providerPath, stray);
+        }
+    }
+    return Array.from(merged.values()).sort((left, right) => left.providerPath.localeCompare(right.providerPath));
+}
+export async function regenerateCodexAfterAdoption({ scopeRoot, scanCanonical, computeExtensionPlan, applyExtensionPlan, }) {
+    const canonicalEntries = await scanCanonical();
+    const extensionPlan = await computeExtensionPlan(scopeRoot, canonicalEntries);
+    await applyExtensionPlan(scopeRoot, extensionPlan);
+}

package/dist/commands/shared/frontmatter-write.d.ts

@@ -0,0 +1,8 @@
+export declare function upsertFrontmatterField(block: string, field: string, value: string, overwrite: boolean): {
+    nextBlock: string;
+    changed: boolean;
+    added: boolean;
+};
+export declare function replaceFrontmatter(content: string, nextBlock: string): string;
+export declare function removeFrontmatterField(block: string, field: string): string;
+//# sourceMappingURL=frontmatter-write.d.ts.map

package/dist/commands/shared/frontmatter-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-write.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/frontmatter-write.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GACjB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAoBzD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3E"}

package/dist/commands/shared/frontmatter-write.js

@@ -0,0 +1,27 @@
+export function upsertFrontmatterField(block, field, value, overwrite) {
+    const matcher = new RegExp(`^${field}:\\s*([^\\n]*?)(\\s*#.*)?$`, 'm');
+    const match = block.match(matcher);
+    if (match) {
+        if (!overwrite) {
+            return { nextBlock: block, changed: false, added: false };
+        }
+        const comment = match[2] ?? '';
+        const nextBlock = block.replace(matcher, `${field}: ${value}${comment}`);
+        return { nextBlock, changed: nextBlock !== block, added: false };
+    }
+    const normalized = block.endsWith('\n') ? block : `${block}\n`;
+    return {
+        nextBlock: `${normalized}${field}: ${value}`,
+        changed: true,
+        added: true,
+    };
+}
+export function replaceFrontmatter(content, nextBlock) {
+    return content.replace(/^---\n([\s\S]*?)\n---/, `---\n${nextBlock}\n---`);
+}
+export function removeFrontmatterField(block, field) {
+    return block
+        .split('\n')
+        .filter((line) => !line.startsWith(`${field}:`))
+        .join('\n');
+}

package/dist/commands/shared/frontmatter.d.ts

@@ -0,0 +1,6 @@
+export declare function getFrontmatterBlock(content: string): string | null;
+export declare function getFrontmatterField(frontmatter: string, field: string): string | null;
+export declare function parseFrontmatterField(filePath: string, field: string): Promise<string>;
+export declare function getSkillVersion(skillDir: string): Promise<string | null>;
+export declare function getAgentVersion(agentPath: string): Promise<string | null>;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/commands/shared/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/frontmatter.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAKf;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CASjB;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQxB;AAED,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/commands/shared/frontmatter.js

@@ -0,0 +1,35 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export function getFrontmatterBlock(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    return match?.[1] ?? null;
+}
+export function getFrontmatterField(frontmatter, field) {
+    const regex = new RegExp(`^${field}:\\s*(.+)$`, 'm');
+    const match = frontmatter.match(regex);
+    if (!match)
+        return null;
+    return match[1].replace(/\s*#.*$/, '').trim();
+}
+export async function parseFrontmatterField(filePath, field) {
+    try {
+        const content = await readFile(filePath, 'utf8');
+        const block = getFrontmatterBlock(content);
+        if (!block)
+            return '';
+        return getFrontmatterField(block, field) ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+export async function getSkillVersion(skillDir) {
+    // parseFrontmatterField() returns '' when SKILL.md is missing or unreadable,
+    // so read failures are normalized to null here.
+    const version = await parseFrontmatterField(join(skillDir, 'SKILL.md'), 'version');
+    return version.length > 0 ? version : null;
+}
+export async function getAgentVersion(agentPath) {
+    const version = await parseFrontmatterField(agentPath, 'version');
+    return version.length > 0 ? version : null;
+}

package/dist/commands/shared/messages.d.ts

@@ -0,0 +1,2 @@
+export declare const PROVIDER_CONFIG_REMEDIATION = "Run \"oat providers set --scope project --enabled <providers> --disabled <providers>\" to configure supported providers.";
+//# sourceMappingURL=messages.d.ts.map

package/dist/commands/shared/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/messages.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,6HACkF,CAAC"}

package/dist/commands/shared/messages.js

@@ -0,0 +1 @@
+export const PROVIDER_CONFIG_REMEDIATION = 'Run "oat providers set --scope project --enabled <providers> --disabled <providers>" to configure supported providers.';

package/dist/commands/shared/oat-paths.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveProjectsRoot(repoRoot: string, env: NodeJS.ProcessEnv): Promise<string>;
+//# sourceMappingURL=oat-paths.d.ts.map

package/dist/commands/shared/oat-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oat-paths.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/oat-paths.ts"],"names":[],"mappings":"AAEA,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/commands/shared/oat-paths.js

@@ -0,0 +1,13 @@
+import { readOatConfig } from '../../config/oat-config.js';
+export async function resolveProjectsRoot(repoRoot, env) {
+    const envRoot = env.OAT_PROJECTS_ROOT?.trim();
+    if (envRoot) {
+        return envRoot.replace(/\/+$/, '');
+    }
+    const config = await readOatConfig(repoRoot);
+    const configRoot = config.projects?.root?.trim();
+    if (configRoot) {
+        return configRoot.replace(/\/+$/, '');
+    }
+    return '.oat/projects/shared';
+}

package/dist/commands/shared/shared.prompts.d.ts

@@ -0,0 +1,21 @@
+export interface PromptContext {
+    interactive: boolean;
+}
+export interface SelectChoice<T extends string = string> {
+    label: string;
+    value: T;
+    description?: string;
+}
+export interface MultiSelectChoice<T extends string = string> {
+    label: string;
+    value: T;
+    description?: string;
+    checked?: boolean;
+}
+export declare function confirmAction(message: string, ctx: PromptContext): Promise<boolean>;
+export declare function inputRequired(message: string, ctx: PromptContext): Promise<string | null>;
+export declare function inputWithDefault(message: string, defaultValue: string, ctx: PromptContext): Promise<string | null>;
+export declare function selectWithAbort<T extends string>(message: string, choices: SelectChoice<T>[], ctx: PromptContext): Promise<T | null>;
+export declare function selectManyWithAbort<T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext): Promise<T[] | null>;
+export declare function selectManyOrEmpty<T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext): Promise<T[]>;
+//# sourceMappingURL=shared.prompts.d.ts.map

package/dist/commands/shared/shared.prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.prompts.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/shared.prompts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAUD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB;AAED,wBAAsB,eAAe,CAAC,CAAC,SAAS,MAAM,EACpD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAqBnB;AAED,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EACxD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAC/B,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAuBrB;AAED,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EACtD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAC/B,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC,CAGd"}

package/dist/commands/shared/shared.prompts.js

@@ -0,0 +1,107 @@
+import { CliError } from '../../errors/index.js';
+import { checkbox, confirm, input, select } from '@inquirer/prompts';
+function isAbortError(error) {
+    return (error instanceof Error &&
+        (error.name === 'ExitPromptError' ||
+            error.message.includes('User force closed')));
+}
+export async function confirmAction(message, ctx) {
+    if (!ctx.interactive) {
+        return false;
+    }
+    try {
+        return await confirm({ message, default: false });
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return false;
+        }
+        throw error;
+    }
+}
+export async function inputRequired(message, ctx) {
+    if (!ctx.interactive) {
+        throw new CliError('Input prompt requires interactive mode.', 1);
+    }
+    try {
+        const value = (await input({ message })).trim();
+        if (value.length === 0) {
+            throw new CliError('Input is required.', 1);
+        }
+        return value;
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function inputWithDefault(message, defaultValue, ctx) {
+    if (!ctx.interactive) {
+        throw new CliError('Input prompt requires interactive mode.', 1);
+    }
+    try {
+        const value = (await input({
+            message,
+            default: defaultValue,
+        })).trim();
+        return value.length === 0 ? defaultValue : value;
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function selectWithAbort(message, choices, ctx) {
+    if (!ctx.interactive) {
+        throw new CliError('Selection prompt requires interactive mode.', 1);
+    }
+    try {
+        const selected = await select({
+            message,
+            choices: choices.map((choice) => ({
+                name: choice.label,
+                value: choice.value,
+                description: choice.description,
+            })),
+        });
+        return selected;
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function selectManyWithAbort(message, choices, ctx) {
+    if (!ctx.interactive) {
+        throw new CliError('Selection prompt requires interactive mode.', 1);
+    }
+    try {
+        const selected = await checkbox({
+            message,
+            choices: choices.map((choice) => ({
+                name: choice.label,
+                value: choice.value,
+                description: choice.description,
+                checked: choice.checked,
+            })),
+            required: false,
+        });
+        return selected;
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function selectManyOrEmpty(message, choices, ctx) {
+    const selected = await selectManyWithAbort(message, choices, ctx);
+    return selected ?? [];
+}

package/dist/commands/shared/shared.utils.d.ts

@@ -0,0 +1,6 @@
+import type { GlobalOptions } from '../../app/command-context.js';
+import type { ConcreteScope, Scope } from '../../shared/types.js';
+import type { Command } from 'commander';
+export declare function readGlobalOptions(command: Command): GlobalOptions;
+export declare function resolveConcreteScopes(scope: Scope): ConcreteScope[];
+//# sourceMappingURL=shared.utils.d.ts.map

package/dist/commands/shared/shared.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.utils.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAEjE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,EAAE,CAKnE"}

package/dist/commands/shared/shared.utils.js

@@ -0,0 +1,9 @@
+export function readGlobalOptions(command) {
+    return command.optsWithGlobals();
+}
+export function resolveConcreteScopes(scope) {
+    if (scope === 'all') {
+        return ['project', 'user'];
+    }
+    return [scope];
+}

package/dist/commands/state/generate.d.ts

@@ -0,0 +1,21 @@
+export interface GitOperations {
+    isGitRepo(root: string): boolean;
+    diffFileCount(root: string, sha: string): number;
+}
+export interface GenerateStateOptions {
+    repoRoot: string;
+    env?: NodeJS.ProcessEnv;
+    today?: string;
+    git?: GitOperations;
+}
+export interface GenerateStateResult {
+    dashboardPath: string;
+    projectName: string | null;
+    projectStatus: string;
+    stalenessStatus: string;
+    recommendedStep: string;
+    recommendedReason: string;
+}
+export declare function phaseInHillList(phase: string, listStr: string): boolean;
+export declare function generateStateDashboard(options: GenerateStateOptions): Promise<GenerateStateResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/state/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/state/generate.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACjC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAClD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA4GD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvE;AAqaD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA2C9B"}