@open-agent-toolkit/cli 0.0.10

package/dist/commands/backlog/index.js

@@ -0,0 +1,80 @@
+import { resolve } from 'node:path';
+import { buildCommandContext } from '../../app/command-context.js';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { Command } from 'commander';
+import { initializeBacklog } from './init.js';
+import { regenerateBacklogIndex } from './regenerate-index.js';
+import { generateUniqueBacklogId, readExistingBacklogIds, } from './shared/generate-id.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    initializeBacklog,
+    regenerateBacklogIndex,
+};
+async function resolveBacklogRoot(context, configuredRoot, dependencies = DEFAULT_DEPENDENCIES) {
+    if (configuredRoot) {
+        return resolve(context.cwd, configuredRoot);
+    }
+    const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
+    return resolve(projectRoot, '.oat', 'repo', 'reference', 'backlog');
+}
+export function createBacklogCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    const cmd = new Command('backlog').description('Manage file-backed backlog items and indexes');
+    cmd
+        .command('init')
+        .description('Scaffold the canonical backlog directory structure and starter files')
+        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/reference/backlog)')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        const backlogRoot = await resolveBacklogRoot(context, options.backlogRoot, dependencies);
+        await dependencies.initializeBacklog(backlogRoot);
+        if (context.json) {
+            context.logger.json({ status: 'ok', backlogRoot });
+        }
+        else {
+            context.logger.info(`Initialized backlog scaffold at ${backlogRoot}`);
+        }
+        process.exitCode = 0;
+    });
+    cmd
+        .command('regenerate-index')
+        .description('Regenerate the managed backlog index table')
+        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/reference/backlog)')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        const backlogRoot = await resolveBacklogRoot(context, options.backlogRoot, dependencies);
+        await dependencies.regenerateBacklogIndex(backlogRoot);
+        if (context.json) {
+            context.logger.json({ status: 'ok', backlogRoot });
+        }
+        else {
+            context.logger.info(`Regenerated backlog index at ${backlogRoot}`);
+        }
+        process.exitCode = 0;
+    });
+    cmd
+        .command('generate-id')
+        .description('Generate a backlog item identifier from a filename seed')
+        .argument('<filename>', 'Filename or slug seed for the backlog item')
+        .option('--created-at <timestamp>', 'Creation timestamp seed for reproducible ID generation')
+        .action(async (filename, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        const backlogRoot = await resolveBacklogRoot(context, undefined, dependencies);
+        const createdAt = options.createdAt ?? new Date().toISOString();
+        const existingIds = await readExistingBacklogIds(backlogRoot);
+        const id = generateUniqueBacklogId(filename, createdAt, existingIds);
+        if (context.json) {
+            context.logger.json({ status: 'ok', id, filename, createdAt });
+        }
+        else {
+            context.logger.info(id);
+        }
+        process.exitCode = 0;
+    });
+    return cmd;
+}

package/dist/commands/backlog/init.d.ts

@@ -0,0 +1,2 @@
+export declare function initializeBacklog(backlogRoot: string): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/backlog/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/init.ts"],"names":[],"mappings":"AAqEA,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB1E"}

package/dist/commands/backlog/init.js

@@ -0,0 +1,66 @@
+import { access, mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const INDEX_START = '<!-- OAT BACKLOG-INDEX -->';
+const INDEX_END = '<!-- END OAT BACKLOG-INDEX -->';
+const DIRECTORY_PLACEHOLDER = '.gitkeep';
+const EMPTY_MANAGED_TABLE = [
+    INDEX_START,
+    '',
+    '| ID | Title | Status | Priority | Scope | Estimate |',
+    '| --- | --- | --- | --- | --- | --- |',
+    '| _No backlog items yet_ | - | - | - | - | - |',
+    '',
+    INDEX_END,
+].join('\n');
+const STARTER_INDEX = [
+    '# OAT Backlog Index',
+    '',
+    '> Generated backlog table lives inside the managed section below. Keep curated narrative updates in the overview section so CLI regeneration stays safe.',
+    '',
+    '## Curated Overview',
+    '',
+    '- Add brief narrative summaries here as backlog items are created and reprioritized.',
+    '',
+    EMPTY_MANAGED_TABLE,
+    '',
+    '## Notes',
+    '',
+    '- Active item files live in `backlog/items/`',
+    '- Archived item files live in `backlog/archived/`',
+    '- Historical completions are summarized in `backlog/completed.md`',
+    '',
+].join('\n');
+const STARTER_COMPLETED = [
+    '# OAT Backlog Completed',
+    '',
+    '> Summary archive for completed backlog work. Keep newest entries first. Use `backlog/archived/` for full file-per-item historical records when a completed item still needs rich context.',
+    '',
+    '## Entry Format',
+    '',
+    '- `YYYY-MM-DD — bl-XXXX — Title — one-line outcome summary`',
+    '',
+    '## Completed Items',
+    '',
+].join('\n');
+async function writeFileIfMissing(filePath, content) {
+    try {
+        await access(filePath);
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : null;
+        if (code !== 'ENOENT') {
+            throw error;
+        }
+        await writeFile(filePath, content, 'utf8');
+    }
+}
+export async function initializeBacklog(backlogRoot) {
+    await mkdir(join(backlogRoot, 'items'), { recursive: true });
+    await mkdir(join(backlogRoot, 'archived'), { recursive: true });
+    await writeFileIfMissing(join(backlogRoot, 'items', DIRECTORY_PLACEHOLDER), '');
+    await writeFileIfMissing(join(backlogRoot, 'archived', DIRECTORY_PLACEHOLDER), '');
+    await writeFileIfMissing(join(backlogRoot, 'index.md'), STARTER_INDEX);
+    await writeFileIfMissing(join(backlogRoot, 'completed.md'), STARTER_COMPLETED);
+}

package/dist/commands/backlog/regenerate-index.d.ts

@@ -0,0 +1,2 @@
+export declare function regenerateBacklogIndex(backlogRoot: string): Promise<void>;
+//# sourceMappingURL=regenerate-index.d.ts.map

package/dist/commands/backlog/regenerate-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerate-index.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/regenerate-index.ts"],"names":[],"mappings":"AAkFA,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/commands/backlog/regenerate-index.js

@@ -0,0 +1,78 @@
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getFrontmatterBlock } from '../shared/frontmatter.js';
+import YAML from 'yaml';
+const INDEX_START = '<!-- OAT BACKLOG-INDEX -->';
+const INDEX_END = '<!-- END OAT BACKLOG-INDEX -->';
+const PRIORITY_ORDER = {
+    urgent: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+    none: 4,
+};
+function parseItemFrontmatter(content, filePath) {
+    const rawFrontmatter = getFrontmatterBlock(content);
+    if (!rawFrontmatter) {
+        return null;
+    }
+    const parsed = YAML.parse(rawFrontmatter);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Frontmatter in ${filePath} must be a YAML object.`);
+    }
+    const frontmatter = parsed;
+    return {
+        id: String(frontmatter.id ?? ''),
+        title: String(frontmatter.title ?? ''),
+        status: String(frontmatter.status ?? ''),
+        priority: String(frontmatter.priority ?? ''),
+        scope: String(frontmatter.scope ?? ''),
+        scopeEstimate: String(frontmatter.scope_estimate ?? ''),
+    };
+}
+function compareItems(a, b) {
+    const priorityDiff = (PRIORITY_ORDER[a.priority] ?? Number.MAX_SAFE_INTEGER) -
+        (PRIORITY_ORDER[b.priority] ?? Number.MAX_SAFE_INTEGER);
+    if (priorityDiff !== 0) {
+        return priorityDiff;
+    }
+    return a.title.localeCompare(b.title);
+}
+function renderManagedSection(items) {
+    const rows = items.length > 0
+        ? items.map((item) => `| ${item.id} | ${item.title} | ${item.status} | ${item.priority} | ${item.scope} | ${item.scopeEstimate} |`)
+        : ['| _No backlog items yet_ | - | - | - | - | - |'];
+    return [
+        INDEX_START,
+        '| ID | Title | Status | Priority | Scope | Estimate |',
+        '| --- | --- | --- | --- | --- | --- |',
+        ...rows,
+        INDEX_END,
+    ].join('\n');
+}
+export async function regenerateBacklogIndex(backlogRoot) {
+    const itemsDir = join(backlogRoot, 'items');
+    const indexPath = join(backlogRoot, 'index.md');
+    const entries = (await readdir(itemsDir, { withFileTypes: true }))
+        .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
+        .map((entry) => entry.name);
+    const items = [];
+    for (const entry of entries) {
+        const filePath = join(itemsDir, entry);
+        const item = parseItemFrontmatter(await readFile(filePath, 'utf8'), filePath);
+        if (item) {
+            items.push(item);
+        }
+    }
+    items.sort(compareItems);
+    const content = await readFile(indexPath, 'utf8');
+    const startIndex = content.indexOf(INDEX_START);
+    const endIndex = content.indexOf(INDEX_END);
+    if (startIndex === -1 || endIndex === -1) {
+        throw new Error(`Managed backlog index markers missing in ${indexPath}. Expected the exact marker pair:\n${INDEX_START}\n${INDEX_END}\nRun \`oat backlog init\` if the backlog scaffold is missing, or restore those exact markers in \`backlog/index.md\` before rerunning \`oat backlog regenerate-index\`.`);
+    }
+    const before = content.slice(0, startIndex);
+    const after = content.slice(endIndex + INDEX_END.length);
+    const updated = `${before}${renderManagedSection(items)}${after}`;
+    await writeFile(indexPath, updated, 'utf8');
+}

package/dist/commands/backlog/shared/generate-id.d.ts

@@ -0,0 +1,4 @@
+export declare function generateBacklogId(filename: string, createdAt: string, nonce?: number): string;
+export declare function generateUniqueBacklogId(filename: string, createdAt: string, existingIds: Iterable<string>): string;
+export declare function readExistingBacklogIds(backlogRoot: string): Promise<Set<string>>;
+//# sourceMappingURL=generate-id.d.ts.map

package/dist/commands/backlog/shared/generate-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-id.d.ts","sourceRoot":"","sources":["../../../../src/commands/backlog/shared/generate-id.ts"],"names":[],"mappings":"AAeA,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,SAAI,GACR,MAAM,CAQR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC5B,MAAM,CAWR;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAgDtB"}

package/dist/commands/backlog/shared/generate-id.js

@@ -0,0 +1,65 @@
+import { createHash } from 'node:crypto';
+import { readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getFrontmatterBlock } from '../../shared/frontmatter.js';
+import YAML from 'yaml';
+function buildBacklogHashInput(filename, createdAt, nonce) {
+    return nonce === 0 ? filename : `${filename}#${nonce}`;
+}
+export function generateBacklogId(filename, createdAt, nonce = 0) {
+    const hash = createHash('sha256')
+        .update(buildBacklogHashInput(filename, createdAt, nonce))
+        .update('\0')
+        .update(createdAt)
+        .digest('hex');
+    return `bl-${hash.slice(0, 4)}`;
+}
+export function generateUniqueBacklogId(filename, createdAt, existingIds) {
+    const ids = new Set(existingIds);
+    for (let nonce = 0; nonce < Number.MAX_SAFE_INTEGER; nonce += 1) {
+        const candidate = generateBacklogId(filename, createdAt, nonce);
+        if (!ids.has(candidate)) {
+            return candidate;
+        }
+    }
+    throw new Error('Unable to generate a unique backlog ID.');
+}
+export async function readExistingBacklogIds(backlogRoot) {
+    const ids = new Set();
+    const sourceDirs = ['items', 'archived'];
+    for (const dirName of sourceDirs) {
+        const sourceDir = join(backlogRoot, dirName);
+        try {
+            const entries = await readdir(sourceDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile() || !entry.name.endsWith('.md')) {
+                    continue;
+                }
+                const content = await readFile(join(sourceDir, entry.name), 'utf8');
+                const rawFrontmatter = getFrontmatterBlock(content);
+                if (!rawFrontmatter) {
+                    continue;
+                }
+                const parsed = YAML.parse(rawFrontmatter);
+                if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                    continue;
+                }
+                const id = parsed.id;
+                if (typeof id === 'string' && id.length > 0) {
+                    ids.add(id);
+                }
+            }
+            continue;
+        }
+        catch (error) {
+            const code = error && typeof error === 'object' && 'code' in error
+                ? String(error.code)
+                : null;
+            if (code === 'ENOENT') {
+                continue;
+            }
+            throw error;
+        }
+    }
+    return ids;
+}

package/dist/commands/cleanup/artifacts/artifacts.d.ts

@@ -0,0 +1,44 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { type MultiSelectChoice, type PromptContext } from '../../shared/shared.prompts.js';
+import { Command } from 'commander';
+import type { CleanupActionRecord, CleanupJsonPayload } from '../cleanup.types.js';
+import type { ArtifactCleanupCandidate } from './artifacts.types.js';
+export interface CleanupArtifactsRunOptions {
+    repoRoot: string;
+    dryRun?: boolean;
+    allCandidates?: boolean;
+    yes?: boolean;
+    interactive?: boolean;
+    timestamp?: string;
+}
+interface CleanupArtifactsCommandDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    runCleanupArtifacts: (options: CleanupArtifactsRunOptions) => Promise<CleanupJsonPayload>;
+}
+interface CleanupArtifactsRunDependencies {
+    runInteractiveStaleTriage: typeof runInteractiveStaleTriage;
+}
+export declare function planDuplicatePruneActions(candidates: string[]): CleanupActionRecord[];
+export declare function discoverArtifactCandidates(repoRoot: string, excludedTargets?: string[]): Promise<string[]>;
+export declare function findReferencedArtifactCandidates(repoRoot: string, candidates: string[]): Promise<Set<string>>;
+export interface NonInteractiveDeleteOptions {
+    allCandidates: boolean;
+    yes: boolean;
+}
+export declare function planNonInteractiveArtifactActions(candidates: ArtifactCleanupCandidate[], options: NonInteractiveDeleteOptions): CleanupActionRecord[];
+export declare function planArchiveActions(targets: string[], existingTargets: Set<string>, timestamp: string): CleanupActionRecord[];
+export interface InteractiveTriageResult {
+    keep: string[];
+    archive: string[];
+    delete: string[];
+}
+interface InteractiveTriageDependencies {
+    selectManyOrEmpty: <T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext) => Promise<T[]>;
+    confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+}
+export declare function runInteractiveStaleTriage(candidates: ArtifactCleanupCandidate[], ctx: PromptContext, overrides?: Partial<InteractiveTriageDependencies>): Promise<InteractiveTriageResult>;
+export declare function runCleanupArtifacts({ repoRoot, dryRun, allCandidates, yes, interactive, timestamp, }: CleanupArtifactsRunOptions, overrides?: Partial<CleanupArtifactsRunDependencies>): Promise<CleanupJsonPayload>;
+export declare function createCleanupArtifactsCommand(overrides?: Partial<CleanupArtifactsCommandDependencies>): Command;
+export {};
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/commands/cleanup/artifacts/artifacts.d.ts.map

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