@open-agent-toolkit/cli 0.0.10

package/dist/commands/repo/pr-comments/collect/graphql-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-queries.d.ts","sourceRoot":"","sources":["../../../../../src/commands/repo/pr-comments/collect/graphql-queries.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,mpBAgCnC,CAAC;AAEF,eAAO,MAAM,0BAA0B,gfAsBtC,CAAC"}

package/dist/commands/repo/pr-comments/collect/graphql-queries.js

@@ -0,0 +1,56 @@
+export const SEARCH_MERGED_PRS_QUERY = `
+query($searchQuery: String!, $first: Int!, $after: String) {
+  search(query: $searchQuery, type: ISSUE, first: $first, after: $after) {
+    nodes {
+      ... on PullRequest {
+        number
+        title
+        mergedAt
+        author { login }
+        reviewComments(first: 100) {
+          nodes {
+            id
+            body
+            createdAt
+            url
+            path
+            line
+            author { login __typename }
+          }
+          pageInfo {
+            hasNextPage
+            endCursor
+          }
+        }
+      }
+    }
+    pageInfo {
+      hasNextPage
+      endCursor
+    }
+  }
+}
+`;
+export const REVIEW_COMMENTS_PAGE_QUERY = `
+query($prNumber: Int!, $owner: String!, $name: String!, $first: Int!, $after: String) {
+  repository(owner: $owner, name: $name) {
+    pullRequest(number: $prNumber) {
+      reviewComments(first: $first, after: $after) {
+        nodes {
+          id
+          body
+          createdAt
+          url
+          path
+          line
+          author { login __typename }
+        }
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+      }
+    }
+  }
+}
+`;

package/dist/commands/repo/pr-comments/collect/index.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { type CollectDependencies } from './collect-comments.js';
+export declare function createPrCommentsCollectCommand(deps?: CollectDependencies): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/repo/pr-comments/collect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/repo/pr-comments/collect/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,mBAAmB,EAGzB,MAAM,oBAAoB,CAAC;AAG5B,wBAAgB,8BAA8B,CAC5C,IAAI,GAAE,mBAAgD,GACrD,OAAO,CAkCT"}

package/dist/commands/repo/pr-comments/collect/index.js

@@ -0,0 +1,25 @@
+import { buildCommandContext } from '../../../../app/command-context.js';
+import { readGlobalOptions } from '../../../shared/shared.utils.js';
+import { Command } from 'commander';
+import { defaultCollectDependencies, runCollectComments, } from './collect-comments.js';
+export function createPrCommentsCollectCommand(deps = defaultCollectDependencies) {
+    return new Command('collect')
+        .description('Collect PR review comments from merged pull requests via GitHub GraphQL API')
+        .requiredOption('--since <date>', 'Start date for merged PRs (YYYY-MM-DD)')
+        .option('--until <date>', 'End date for merged PRs (YYYY-MM-DD, defaults to today)')
+        .option('--out-dir <path>', 'Output directory for collected comments', '.oat/review-comments')
+        .option('--repo <owner/name>', 'GitHub repository (defaults to current repo)')
+        .option('--no-ignore-bots', 'Include bot comments')
+        .action(async (opts, command) => {
+        const globalOptions = readGlobalOptions(command);
+        const context = buildCommandContext(globalOptions);
+        const options = {
+            since: opts.since,
+            until: opts.until,
+            outDir: opts.outDir,
+            repo: opts.repo,
+            ignoreBots: opts.ignoreBots,
+        };
+        await runCollectComments(context, options, deps);
+    });
+}

package/dist/commands/repo/pr-comments/collect/pr-comments.types.d.ts

@@ -0,0 +1,62 @@
+export interface CollectOptions {
+    readonly since: string;
+    readonly until?: string;
+    readonly outDir: string;
+    readonly repo?: string;
+    readonly ignoreBots: boolean;
+}
+export interface PrReviewComment {
+    readonly id: string;
+    readonly prNumber: number;
+    readonly prTitle: string;
+    readonly prAuthor: string;
+    readonly prMergedAt: string;
+    readonly filePath: string;
+    readonly line: number | null;
+    readonly author: string;
+    readonly body: string;
+    readonly createdAt: string;
+    readonly url: string;
+}
+export interface CollectionChunk {
+    readonly month: string;
+    readonly comments: IndexedComment[];
+}
+export interface IndexedComment extends PrReviewComment {
+    readonly rcId: string;
+}
+export interface GraphQLPageInfo {
+    readonly hasNextPage: boolean;
+    readonly endCursor: string | null;
+}
+export interface GraphQLReviewComment {
+    readonly id: string;
+    readonly body: string;
+    readonly createdAt: string;
+    readonly url: string;
+    readonly path: string;
+    readonly line: number | null;
+    readonly author: {
+        readonly login: string;
+        readonly __typename: string;
+    } | null;
+}
+export interface GraphQLPullRequest {
+    readonly number: number;
+    readonly title: string;
+    readonly mergedAt: string;
+    readonly author: {
+        readonly login: string;
+    } | null;
+    readonly reviewComments: {
+        readonly nodes: GraphQLReviewComment[];
+        readonly pageInfo: GraphQLPageInfo;
+    };
+}
+export interface GraphQLSearchResult {
+    readonly search: {
+        readonly nodes: GraphQLPullRequest[];
+        readonly pageInfo: GraphQLPageInfo;
+    };
+}
+//# sourceMappingURL=pr-comments.types.d.ts.map

package/dist/commands/repo/pr-comments/collect/pr-comments.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-comments.types.d.ts","sourceRoot":"","sources":["../../../../../src/commands/repo/pr-comments/collect/pr-comments.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,cAAc,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;KAC7B,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE;QACvB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,EAAE,CAAC;QACvC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;KACpC,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC;QACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;KACpC,CAAC;CACH"}

package/dist/commands/repo/pr-comments/collect/pr-comments.types.js

@@ -0,0 +1 @@
+export {};

package/dist/commands/repo/pr-comments/index.d.ts

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

package/dist/commands/repo/pr-comments/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/repo/pr-comments/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,uBAAuB,IAAI,OAAO,CASjD"}

package/dist/commands/repo/pr-comments/index.js

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+import { createPrCommentsCollectCommand } from './collect/index.js';
+import { createPrCommentsTriageCommand } from './triage-collection/index.js';
+export function createPrCommentsCommand() {
+    const cmd = new Command('pr-comments').description('Collect and triage PR review comments for analysis');
+    cmd.addCommand(createPrCommentsCollectCommand());
+    cmd.addCommand(createPrCommentsTriageCommand());
+    return cmd;
+}

package/dist/commands/repo/pr-comments/triage-collection/index.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { type TriageDependencies } from './triage-comments.js';
+export declare function createPrCommentsTriageCommand(deps?: TriageDependencies): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/repo/pr-comments/triage-collection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/repo/pr-comments/triage-collection/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,mBAAmB,CAAC;AAG3B,wBAAgB,6BAA6B,CAC3C,IAAI,GAAE,kBAA8C,GACnD,OAAO,CA4BT"}

package/dist/commands/repo/pr-comments/triage-collection/index.js

@@ -0,0 +1,21 @@
+import { buildCommandContext } from '../../../../app/command-context.js';
+import { readGlobalOptions } from '../../../shared/shared.utils.js';
+import { Command } from 'commander';
+import { defaultTriageDependencies, runTriageComments, } from './triage-comments.js';
+export function createPrCommentsTriageCommand(deps = defaultTriageDependencies) {
+    return new Command('triage-collection')
+        .description('Interactively triage collected PR review comments (keep/discard)')
+        .requiredOption('--month <YYYY-MM>', 'Month chunk to triage')
+        .option('--input-dir <path>', 'Directory containing collected JSON', '.oat/review-comments')
+        .option('--output-dir <path>', 'Output directory for triaged results', '.oat/review-comments')
+        .action(async (opts, command) => {
+        const globalOptions = readGlobalOptions(command);
+        const context = buildCommandContext(globalOptions);
+        const options = {
+            inputDir: opts.inputDir,
+            outputDir: opts.outputDir,
+            month: opts.month,
+        };
+        await runTriageComments(context, options, deps);
+    });
+}

package/dist/commands/repo/pr-comments/triage-collection/triage-comments.d.ts

@@ -0,0 +1,13 @@
+import type { CommandContext } from '../../../../app/command-context.js';
+import type { CollectionChunk } from '../collect/pr-comments.types.js';
+export interface TriageOptions {
+    readonly inputDir: string;
+    readonly outputDir: string;
+    readonly month: string;
+}
+export interface TriageDependencies {
+    readJsonFile: (path: string) => Promise<CollectionChunk>;
+}
+export declare const defaultTriageDependencies: TriageDependencies;
+export declare function runTriageComments(context: CommandContext, options: TriageOptions, deps?: TriageDependencies): Promise<void>;
+//# sourceMappingURL=triage-comments.d.ts.map

package/dist/commands/repo/pr-comments/triage-collection/triage-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage-comments.d.ts","sourceRoot":"","sources":["../../../../../src/commands/repo/pr-comments/triage-collection/triage-comments.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1D;AAED,eAAO,MAAM,yBAAyB,EAAE,kBAKvC,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,kBAA8C,GACnD,OAAO,CAAC,IAAI,CAAC,CAsEf"}

package/dist/commands/repo/pr-comments/triage-collection/triage-comments.js

@@ -0,0 +1,81 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { createInterface } from 'node:readline';
+import { CliError } from '../../../../errors/cli-error.js';
+import { ensureDir, fileExists } from '../../../../fs/io.js';
+export const defaultTriageDependencies = {
+    readJsonFile: async (path) => {
+        const content = await readFile(path, 'utf8');
+        return JSON.parse(content);
+    },
+};
+export async function runTriageComments(context, options, deps = defaultTriageDependencies) {
+    const { logger } = context;
+    const { inputDir, outputDir, month } = options;
+    const inputPath = join(inputDir, `${month}.json`);
+    if (!(await fileExists(inputPath))) {
+        throw new CliError(`Collection file not found: ${inputPath}`);
+    }
+    const chunk = await deps.readJsonFile(inputPath);
+    if (chunk.comments.length === 0) {
+        logger.warn(`No comments in ${month} to triage.`);
+        return;
+    }
+    if (!context.interactive) {
+        throw new CliError('Triage requires an interactive terminal. Remove --json flag or run in a TTY.');
+    }
+    logger.info(`Triaging ${chunk.comments.length} comments from ${month}...`);
+    logger.info('For each comment, enter [k]eep or [d]iscard (default: keep).\n');
+    const kept = [];
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        for (const comment of chunk.comments) {
+            printCommentSummary(comment);
+            const answer = await askQuestion(rl, `  ${comment.rcId} [k/d]? `);
+            const choice = answer.trim().toLowerCase();
+            if (choice === 'd' || choice === 'discard') {
+                logger.info(`  → Discarded ${comment.rcId}`);
+            }
+            else {
+                kept.push(comment);
+                logger.info(`  → Kept ${comment.rcId}`);
+            }
+            logger.info('');
+        }
+    }
+    finally {
+        rl.close();
+    }
+    await ensureDir(outputDir);
+    const outputChunk = { month, comments: kept };
+    const outputPath = join(outputDir, `${month}.triaged.json`);
+    await writeFile(outputPath, `${JSON.stringify(outputChunk, null, 2)}\n`, 'utf8');
+    logger.success(`Triage complete: kept ${kept.length}/${chunk.comments.length} comments → ${outputPath}`);
+    if (context.json) {
+        logger.json({
+            status: 'ok',
+            month,
+            total: chunk.comments.length,
+            kept: kept.length,
+            discarded: chunk.comments.length - kept.length,
+            outputPath,
+        });
+    }
+}
+function printCommentSummary(comment) {
+    const lines = [
+        `  ──── ${comment.rcId} ────`,
+        `  PR #${comment.prNumber}: ${comment.prTitle}`,
+        `  File: ${comment.filePath}${comment.line ? `:${comment.line}` : ''}`,
+        `  Author: ${comment.author} (${comment.createdAt.slice(0, 10)})`,
+        `  ${comment.body.length > 200 ? `${comment.body.slice(0, 200)}...` : comment.body}`,
+    ];
+    for (const line of lines) {
+        process.stderr.write(`${line}\n`);
+    }
+}
+function askQuestion(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, resolve);
+    });
+}

package/dist/commands/shared/adopt-stray.d.ts

@@ -0,0 +1,22 @@
+import { CliError } from '../../errors/index.js';
+import type { Manifest } from '../../manifest/manifest.types.js';
+import type { PathMapping } from '../../providers/shared/adapter.types.js';
+interface StrayAdoptionCandidate {
+    provider: string;
+    report: {
+        providerPath: string;
+    };
+    mapping: PathMapping;
+    adoption?: {
+        kind: 'codex_role';
+        roleName: string;
+        description?: string;
+    };
+}
+interface AdoptStrayOptions {
+    replaceCanonical?: boolean;
+}
+export declare function isAdoptionConflictError(error: unknown): error is CliError;
+export declare function adoptStrayToCanonical<TCandidate extends StrayAdoptionCandidate>(scopeRoot: string, stray: TCandidate, manifest: Manifest, options?: AdoptStrayOptions): Promise<Manifest>;
+export {};
+//# sourceMappingURL=adopt-stray.d.ts.map

package/dist/commands/shared/adopt-stray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adopt-stray.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/adopt-stray.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAKzC,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,0BAA0B,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAGnE,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,YAAY,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,UAAU,iBAAiB;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAEzE;AAWD,wBAAsB,qBAAqB,CACzC,UAAU,SAAS,sBAAsB,EAEzC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CA0EnB"}

package/dist/commands/shared/adopt-stray.js

@@ -0,0 +1,135 @@
+import { access, readFile, rename, rm, stat, writeFile, } from 'node:fs/promises';
+import { basename, dirname, relative, resolve } from 'node:path';
+import { renderCanonicalAgentMarkdown } from '../../agents/canonical/index.js';
+import { CliError } from '../../errors/index.js';
+import { createSymlink, ensureDir } from '../../fs/io.js';
+import { toPosixPath } from '../../fs/paths.js';
+import { computeContentHash } from '../../manifest/hash.js';
+import { addEntry } from '../../manifest/manager.js';
+import { importCanonicalAgentFromCodexRole } from '../../providers/codex/codec/import-from-codex.js';
+import { canonicalRuleNameForProviderEntry } from '../../rules/canonical/index.js';
+export function isAdoptionConflictError(error) {
+    return error instanceof CliError && error.message.startsWith('Cannot adopt ');
+}
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function adoptStrayToCanonical(scopeRoot, stray, manifest, options = {}) {
+    if (stray.adoption?.kind === 'codex_role') {
+        return adoptCodexRoleStrayToCanonical(scopeRoot, stray, manifest, options);
+    }
+    const providerAbsolutePath = resolve(scopeRoot, stray.report.providerPath);
+    const providerStat = await stat(providerAbsolutePath);
+    const isFile = providerStat.isFile();
+    if (isFile && stray.mapping.contentType === 'rule') {
+        return adoptRuleStrayToCanonical(scopeRoot, stray, manifest, options);
+    }
+    const entryName = basename(stray.report.providerPath);
+    const canonicalAbsolutePath = resolve(scopeRoot, stray.mapping.canonicalDir, entryName);
+    await ensureDir(dirname(canonicalAbsolutePath));
+    const canonicalAlreadyExists = await pathExists(canonicalAbsolutePath);
+    if (canonicalAlreadyExists) {
+        const canonicalHash = await computeContentHash(canonicalAbsolutePath, isFile);
+        const providerHash = await computeContentHash(providerAbsolutePath, isFile);
+        if (canonicalHash !== providerHash) {
+            if (options.replaceCanonical) {
+                await rm(canonicalAbsolutePath, { recursive: true, force: true });
+                await rename(providerAbsolutePath, canonicalAbsolutePath);
+            }
+            else {
+                throw new CliError(`Cannot adopt ${toPosixPath(relative(scopeRoot, providerAbsolutePath))}: canonical path ${toPosixPath(relative(scopeRoot, canonicalAbsolutePath))} already exists with different content.`);
+            }
+        }
+        else {
+            await rm(providerAbsolutePath, { recursive: true, force: true });
+        }
+    }
+    else {
+        await rename(providerAbsolutePath, canonicalAbsolutePath);
+    }
+    const strategy = await createSymlink(canonicalAbsolutePath, providerAbsolutePath, undefined, isFile);
+    const canonicalPath = toPosixPath(relative(scopeRoot, canonicalAbsolutePath));
+    const providerPath = toPosixPath(relative(scopeRoot, providerAbsolutePath));
+    const manifestEntry = {
+        canonicalPath,
+        providerPath,
+        provider: stray.provider,
+        contentType: stray.mapping.contentType,
+        strategy,
+        contentHash: strategy === 'copy'
+            ? await computeContentHash(canonicalAbsolutePath, isFile)
+            : null,
+        isFile,
+        lastSynced: new Date().toISOString(),
+    };
+    return addEntry(manifest, manifestEntry);
+}
+async function adoptRuleStrayToCanonical(scopeRoot, stray, manifest, options) {
+    const providerAbsolutePath = resolve(scopeRoot, stray.report.providerPath);
+    const providerContent = await readFile(providerAbsolutePath, 'utf8');
+    const canonicalEntryName = canonicalRuleNameForProviderEntry(basename(stray.report.providerPath), stray.mapping);
+    const canonicalAbsolutePath = resolve(scopeRoot, stray.mapping.canonicalDir, canonicalEntryName);
+    const canonicalRelativePath = toPosixPath(relative(scopeRoot, canonicalAbsolutePath));
+    const canonicalContent = stray.mapping.parseToCanonical
+        ? stray.mapping.parseToCanonical(providerContent, stray.report.providerPath)
+        : providerContent;
+    await ensureDir(dirname(canonicalAbsolutePath));
+    const canonicalAlreadyExists = await pathExists(canonicalAbsolutePath);
+    if (canonicalAlreadyExists) {
+        const existing = await readFile(canonicalAbsolutePath, 'utf8');
+        if (existing.trimEnd() !== canonicalContent.trimEnd()) {
+            if (!options.replaceCanonical) {
+                throw new CliError(`Cannot adopt ${toPosixPath(relative(scopeRoot, providerAbsolutePath))}: canonical path ${toPosixPath(relative(scopeRoot, canonicalAbsolutePath))} already exists with different content.`);
+            }
+        }
+    }
+    await writeFile(canonicalAbsolutePath, canonicalContent, 'utf8');
+    const renderedProviderContent = stray.mapping.transformCanonical
+        ? stray.mapping.transformCanonical(canonicalContent, canonicalRelativePath)
+        : providerContent;
+    await writeFile(providerAbsolutePath, renderedProviderContent, 'utf8');
+    const manifestEntry = {
+        canonicalPath: canonicalRelativePath,
+        providerPath: toPosixPath(relative(scopeRoot, providerAbsolutePath)),
+        provider: stray.provider,
+        contentType: stray.mapping.contentType,
+        strategy: 'copy',
+        contentHash: await computeContentHash(providerAbsolutePath, true),
+        isFile: true,
+        lastSynced: new Date().toISOString(),
+    };
+    return addEntry(manifest, manifestEntry);
+}
+async function adoptCodexRoleStrayToCanonical(scopeRoot, stray, manifest, options) {
+    const roleName = stray.adoption?.roleName;
+    if (!roleName) {
+        throw new CliError('Cannot adopt Codex stray without role metadata.');
+    }
+    const providerAbsolutePath = resolve(scopeRoot, stray.report.providerPath);
+    const providerContent = await readFile(providerAbsolutePath, 'utf8');
+    const imported = importCanonicalAgentFromCodexRole({
+        roleName,
+        roleContent: providerContent,
+        description: stray.adoption?.description,
+    });
+    const canonicalContent = renderCanonicalAgentMarkdown(imported);
+    const canonicalAbsolutePath = resolve(scopeRoot, stray.mapping.canonicalDir, `${roleName}.md`);
+    await ensureDir(dirname(canonicalAbsolutePath));
+    const canonicalAlreadyExists = await pathExists(canonicalAbsolutePath);
+    if (canonicalAlreadyExists) {
+        const existing = await readFile(canonicalAbsolutePath, 'utf8');
+        if (existing.trimEnd() !== canonicalContent.trimEnd()) {
+            if (!options.replaceCanonical) {
+                throw new CliError(`Cannot adopt ${toPosixPath(relative(scopeRoot, providerAbsolutePath))}: canonical path ${toPosixPath(relative(scopeRoot, canonicalAbsolutePath))} already exists with different content.`);
+            }
+        }
+    }
+    await writeFile(canonicalAbsolutePath, canonicalContent, 'utf8');
+    return manifest;
+}

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

@@ -0,0 +1,18 @@
+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>;
+/**
+ * Remove a managed section from AGENTS.md if it exists.
+ *
+ * Returns true if the section was found and removed, false otherwise.
+ */
+export declare function removeAgentsMdSection(repoRoot: string, key: string): Promise<boolean>;
+//# sourceMappingURL=agents-md.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/shared/agents-md.js

@@ -0,0 +1,81 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileExists } from '../../fs/io.js';
+/**
+ * Manages HTML-comment-delimited sections in AGENTS.md.
+ *
+ * Section markers follow the pattern:
+ *   <!-- OAT <key> -->
+ *   ... content ...
+ *   <!-- END OAT <key> -->
+ */
+function sectionStart(key) {
+    return `<!-- OAT ${key} -->`;
+}
+function sectionEnd(key) {
+    return `<!-- END OAT ${key} -->`;
+}
+function buildSection(key, body) {
+    return `${sectionStart(key)}\n${body}\n${sectionEnd(key)}`;
+}
+/**
+ * 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 async function upsertAgentsMdSection(repoRoot, key, body) {
+    const agentsMdPath = join(repoRoot, 'AGENTS.md');
+    const section = buildSection(key, body);
+    const exists = await fileExists(agentsMdPath);
+    if (!exists) {
+        await writeFile(agentsMdPath, `${section}\n`, 'utf8');
+        return { action: 'created' };
+    }
+    const content = await readFile(agentsMdPath, 'utf8');
+    const start = sectionStart(key);
+    const end = sectionEnd(key);
+    const startIdx = content.indexOf(start);
+    const endIdx = content.indexOf(end);
+    if (startIdx !== -1 && endIdx !== -1) {
+        const existingSection = content.slice(startIdx, endIdx + end.length);
+        if (existingSection === section) {
+            return { action: 'no-change' };
+        }
+        const before = content.slice(0, startIdx);
+        const after = content.slice(endIdx + end.length);
+        await writeFile(agentsMdPath, `${before}${section}${after}`, 'utf8');
+        return { action: 'updated' };
+    }
+    // Append to end
+    const separator = content.endsWith('\n') ? '\n' : '\n\n';
+    await writeFile(agentsMdPath, `${content}${separator}${section}\n`, 'utf8');
+    return { action: 'updated' };
+}
+/**
+ * Remove a managed section from AGENTS.md if it exists.
+ *
+ * Returns true if the section was found and removed, false otherwise.
+ */
+export async function removeAgentsMdSection(repoRoot, key) {
+    const agentsMdPath = join(repoRoot, 'AGENTS.md');
+    const exists = await fileExists(agentsMdPath);
+    if (!exists) {
+        return false;
+    }
+    const content = await readFile(agentsMdPath, 'utf8');
+    const start = sectionStart(key);
+    const end = sectionEnd(key);
+    const startIdx = content.indexOf(start);
+    const endIdx = content.indexOf(end);
+    if (startIdx === -1 || endIdx === -1) {
+        return false;
+    }
+    const before = content.slice(0, startIdx);
+    const after = content.slice(endIdx + end.length);
+    // Collapse extra blank lines left by removal
+    const cleaned = (before + after).replace(/\n{3,}/g, '\n\n');
+    await writeFile(agentsMdPath, cleaned, 'utf8');
+    return true;
+}

package/dist/commands/shared/codex-strays.d.ts

@@ -0,0 +1,16 @@
+import type { CanonicalEntry } from '../../engine/index.js';
+import type { CodexExtensionPlan } from '../../providers/codex/codec/sync-extension.js';
+export interface CodexRoleStray {
+    roleName: string;
+    providerPath: string;
+    description?: string;
+}
+export interface CodexRegenerationDependencies {
+    scopeRoot: string;
+    scanCanonical: () => Promise<CanonicalEntry[]>;
+    computeExtensionPlan: (scopeRoot: string, canonicalEntries: CanonicalEntry[]) => Promise<CodexExtensionPlan>;
+    applyExtensionPlan: (scopeRoot: string, plan: CodexExtensionPlan) => Promise<unknown>;
+}
+export declare function detectCodexRoleStrays(scopeRoot: string, canonicalEntries: CanonicalEntry[]): Promise<CodexRoleStray[]>;
+export declare function regenerateCodexAfterAdoption({ scopeRoot, scanCanonical, computeExtensionPlan, applyExtensionPlan, }: CodexRegenerationDependencies): Promise<void>;
+//# sourceMappingURL=codex-strays.d.ts.map

package/dist/commands/shared/codex-strays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-strays.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/codex-strays.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/C,oBAAoB,EAAE,CACpB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,cAAc,EAAE,KAC/B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjC,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,kBAAkB,KACrB,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AA+HD,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,cAAc,EAAE,GACjC,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B;AAED,wBAAsB,4BAA4B,CAAC,EACjD,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,kBAAkB,GACnB,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C"}