@open-agent-toolkit/cli 0.2.41 → 0.2.46

package/dist/commands/config/index.js

@@ -2,13 +2,14 @@ import { readFile as readFileDefault } from 'node:fs/promises';
 import { isAbsolute, join } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
 import { resolveProjectsRoot } from '../shared/oat-paths.js';
+import { PROJECT_SCOPES } from '../shared/project-scope.js';
 import { confirmAction, } from '../shared/shared.prompts.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
 import { compileDispatchCeilingPreset } from '../../config/dispatch-ceiling-preset.js';
 import { normalizeDispatchMatrix, validateDispatchRouteTarget, walkDispatchMatrix, } from '../../config/dispatch-matrix.js';
 import { formatDispatchNotices, terminalReviewerNoticesForMatrix, } from '../../config/dispatch-notices.js';
 import { dispatchPolicyModeDescription, dispatchPolicyPolicyDescription, managedDispatchPolicyValueList, } from '../../config/dispatch-policy-options.js';
-import { VALID_DISPATCH_POLICY_MODES, VALID_MANAGED_DISPATCH_POLICIES, MAX_GATE_TIMEOUT_MS, MIN_GATE_TIMEOUT_MS, isValidGateTimeoutMs, normalizeWorkflowPostImplementSequence, readOatConfig, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, } from '../../config/oat-config.js';
+import { VALID_DISPATCH_POLICY_MODES, VALID_MANAGED_DISPATCH_POLICIES, MAX_GATE_TIMEOUT_MS, MIN_GATE_TIMEOUT_MS, isValidGateTimeoutMs, normalizeWorkflowPostImplementSequence, readOatConfig, readOatConfigForDefaultScopeRepair, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, } from '../../config/oat-config.js';
 import { resolveEffectiveConfig, } from '../../config/resolve.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
@@ -50,6 +51,7 @@ const KEY_ORDER = [
     'explainers.publish.awsProfile',
     'git.defaultBranch',
     'projects.root',
+    'projects.defaultScope',
     'tools.brainstorm',
     'tools.core',
     'tools.docs',
@@ -98,6 +100,17 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set projects.root <value>',
         description: 'Root directory for tracked OAT projects in this repository.',
     },
+    {
+        key: 'projects.defaultScope',
+        group: 'Shared Repo (.oat/config.json)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'enum',
+        defaultValue: 'synced',
+        mutability: 'read/write',
+        owningCommand: 'oat config set projects.defaultScope <shared|local|synced>',
+        description: 'Scope used by `oat project new` when `--scope` is omitted.',
+    },
     {
         key: 'worktrees.root',
         group: 'Shared Repo (.oat/config.json)',
@@ -840,6 +853,7 @@ const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     resolveProjectRoot,
     readOatConfig,
+    readOatConfigForDefaultScopeRepair,
     writeOatConfig,
     readOatLocalConfig,
     writeOatLocalConfig,
@@ -953,6 +967,7 @@ function parseExplainerValue(key, rawValue, surface) {
     return value;
 }
 const WORKFLOW_ENUM_VALUES = {
+    'projects.defaultScope': PROJECT_SCOPES,
     'workflow.hillCheckpointDefault': ['every', 'final'],
     'workflow.postImplementSequence': ['wait', 'summary', 'pr', 'docs-pr'],
     'workflow.reviewExecutionModel': ['subagent', 'inline', 'fresh-session'],
@@ -1006,6 +1021,7 @@ function isStateKey(key) {
 }
 function isStructuralKey(key) {
     return (key === 'projects.root' ||
+        key === 'projects.defaultScope' ||
         key === 'worktrees.root' ||
         key === 'git.defaultBranch' ||
         key.startsWith('documentation.') ||
@@ -1605,6 +1621,18 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
         });
         return { key, value: nextValue, source: 'shared' };
     }
+    if (key === 'projects.defaultScope') {
+        const defaultScope = parseWorkflowValue(key, rawValue);
+        const config = await dependencies.readOatConfigForDefaultScopeRepair(repoRoot);
+        await dependencies.writeOatConfig(repoRoot, {
+            ...config,
+            projects: {
+                ...config.projects,
+                defaultScope,
+            },
+        });
+        return { key, value: defaultScope, source: 'shared' };
+    }
     const config = await dependencies.readOatConfig(repoRoot);
     if (key.startsWith('documentation.')) {
         const doc = { ...config.documentation };
@@ -1673,8 +1701,11 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
     }
     if (key.startsWith('tools.')) {
         const packName = key.slice('tools.'.length);
+        if (rawValue.trim().toLowerCase() !== 'true') {
+            throw new Error(`Pack intent '${key}' can only be declared with true. To remove the pack and clear its intent, run: oat tools remove --pack ${packName} --scope project`);
+        }
         const tools = { ...config.tools };
-        tools[packName] = rawValue.trim().toLowerCase() === 'true';
+        tools[packName] = true;
         await dependencies.writeOatConfig(repoRoot, {
             ...config,
             tools,
@@ -1719,7 +1750,7 @@ async function setConfigValue(repoRoot, userConfigDir, key, rawValue, surface, d
     if (key === 'projects.root') {
         await dependencies.writeOatConfig(repoRoot, {
             ...config,
-            projects: { root: normalizedValue },
+            projects: { ...config.projects, root: normalizedValue },
         });
     }
     else {

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

@@ -23,6 +23,7 @@ interface DoctorDependencies {
     readFile: (path: string) => Promise<string>;
     resolveAssetsRoot: () => Promise<string>;
     readOatConfig: (repoRoot: string) => Promise<OatConfig>;
+    readOatConfigForDefaultScopeRepair: (repoRoot: string) => Promise<OatConfig>;
     readOatLocalConfig: (repoRoot: string) => Promise<OatLocalConfig>;
     readUserConfig: (userConfigDir: string) => Promise<UserConfig>;
     validateMatrixCell: (provider: string, value: string, options: ValidateMatrixCellOptions) => Promise<MatrixCellAvailabilityResponse>;
@@ -35,6 +36,7 @@ interface DoctorDependencies {
     inventoryPack: (input: InventoryPackInput) => Promise<PackInventory>;
     checkSkillVersions: (scopeRoot: string, assetsRoot: string, pathExists: (path: string) => Promise<boolean>) => Promise<SkillVersionReport>;
     checkStaleInvocations: (repoRoot: string) => Promise<DoctorCheck>;
+    checkSyncedProjects: (repoRoot: string) => Promise<DoctorCheck[]>;
 }
 interface OutdatedSkillVersion {
     skill: string;

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

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

package/dist/commands/doctor/index.js

@@ -12,7 +12,7 @@ import { hasScopedPackPlacementEvidence, inventoryPack, } from '../tools/shared/
 import { PACK_NAMES } from '../tools/shared/pack-manifest.js';
 import { formatPackPaths, updatePackRecovery, } from '../tools/shared/pack-paths.js';
 import { walkDispatchMatrix, } from '../../config/dispatch-matrix.js';
-import { readOatConfig, readOatLocalConfig, readUserConfig, } from '../../config/oat-config.js';
+import { readOatConfig, readOatConfigForDefaultScopeRepair, readOatLocalConfig, readUserConfig, } from '../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../fs/paths.js';
 import TOML from '@iarna/toml';
@@ -29,6 +29,7 @@ import { createDispatchValidationPassContext, validateDispatchMatrixRefs, } from
 import { formatDoctorResults } from '../../ui/output.js';
 import { Command } from 'commander';
 import { checkStaleInvocations } from './stale-invocations.js';
+import { checkSyncedProjects } from './synced-projects.js';
 async function pathExistsDefault(path) {
     try {
         await access(path);
@@ -139,6 +140,7 @@ function createDependencies() {
         readFile: async (path) => readFile(path, 'utf8'),
         resolveAssetsRoot,
         readOatConfig,
+        readOatConfigForDefaultScopeRepair,
         readOatLocalConfig,
         readUserConfig,
         validateMatrixCell,
@@ -153,6 +155,7 @@ function createDependencies() {
         // provided pathExists dependency from runChecksForScope when available.
         checkSkillVersions: (scopeRoot, assetsRoot, pathExists = pathExistsDefault) => checkSkillVersionsDefault(scopeRoot, assetsRoot, pathExists),
         checkStaleInvocations,
+        checkSyncedProjects,
     };
 }
 async function createCursorMaterializedModelsCheck(scopeRoot, dependencies) {
@@ -763,6 +766,7 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
     checks.push(...(await runCodexChecksForScope(scope, scopeRoot, dirname(userConfigDir), dependencies)));
     if (scope === 'project') {
         checks.push(await dependencies.checkStaleInvocations(scopeRoot));
+        checks.push(...(await dependencies.checkSyncedProjects(scopeRoot)));
         try {
             const assetsRoot = await dependencies.resolveAssetsRoot();
             const skillVersions = await dependencies.checkSkillVersions(scopeRoot, assetsRoot, dependencies.pathExists);
@@ -812,11 +816,30 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
             });
         }
         const repoReferenceRoot = join(scopeRoot, '.oat', 'repo');
-        const [userConfig, config, localConfig] = await Promise.all([
+        const [userConfig, configResult, localConfig] = await Promise.all([
             dependencies.readUserConfig(userConfigDir),
-            dependencies.readOatConfig(scopeRoot),
+            dependencies.readOatConfig(scopeRoot).then((config) => ({ config }), async (error) => {
+                if (!(error instanceof Error) ||
+                    !error.message.startsWith('Invalid projects.defaultScope in ')) {
+                    throw error;
+                }
+                return {
+                    config: await dependencies.readOatConfigForDefaultScopeRepair(scopeRoot),
+                    defaultScopeError: error.message,
+                };
+            }),
             dependencies.readOatLocalConfig(scopeRoot),
         ]);
+        if ('defaultScopeError' in configResult) {
+            checks.push({
+                name: 'project:projects_default_scope',
+                description: 'Project creation default scope',
+                status: 'fail',
+                message: configResult.defaultScopeError,
+                fix: 'Run `oat config set projects.defaultScope <shared|local|synced>`.',
+            });
+        }
+        const config = configResult.config;
         checks.push(await createDispatchMatrixDoctorCheck(scopeRoot, [
             { source: 'user-config', config: userConfig },
             { source: 'repo-config', config },
@@ -834,6 +857,7 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
         const adoption = await dependencies.resolvePjmAdoption({
             projectRoot: scopeRoot,
             repoRoot: repoReferenceRoot,
+            config,
         });
         if (adoption.state !== 'none') {
             checks.push(...(await dependencies.runPjmDoctorChecks(repoReferenceRoot, {

package/dist/commands/doctor/synced-projects.d.ts

@@ -0,0 +1,12 @@
+import { type GitRunner } from '../project/sync/git.js';
+import { resolveProjectsRoot } from '../shared/oat-paths.js';
+import type { DoctorCheck } from '../../ui/output.js';
+interface SyncedDoctorDependencies {
+    git: GitRunner;
+    resolveProjectsRoot: typeof resolveProjectsRoot;
+    env: NodeJS.ProcessEnv;
+}
+export declare function syncedRecordSlug(recordPath: string): string;
+export declare function checkSyncedProjects(repoRoot: string, overrides?: Partial<SyncedDoctorDependencies>): Promise<DoctorCheck[]>;
+export {};
+//# sourceMappingURL=synced-projects.d.ts.map

package/dist/commands/doctor/synced-projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synced-projects.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/synced-projects.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAK9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,UAAU,wBAAwB;IAChC,GAAG,EAAE,SAAS,CAAC;IACf,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAsBD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAqDD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,OAAO,CAAC,wBAAwB,CAAM,GAChD,OAAO,CAAC,WAAW,EAAE,CAAC,CAsMxB"}

package/dist/commands/doctor/synced-projects.js

@@ -0,0 +1,208 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { basename, join, relative, resolve, sep } from 'node:path';
+import { defaultGitRunner } from '../project/sync/git.js';
+import { readSyncedRecord, } from '../project/sync/record.js';
+import { resolveProjectsRoot } from '../shared/oat-paths.js';
+import { resolveScopeRoot } from '../shared/project-scope.js';
+import { readOatConfigForDefaultScopeRepair } from '../../config/oat-config.js';
+const DEFAULT_DEPENDENCIES = {
+    git: defaultGitRunner,
+    resolveProjectsRoot: (repoRoot, env) => resolveProjectsRoot(repoRoot, env, readOatConfigForDefaultScopeRepair),
+    env: process.env,
+};
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function repoRelative(repoRoot, path) {
+    return relative(resolve(repoRoot), resolve(path)).split(sep).join('/');
+}
+export function syncedRecordSlug(recordPath) {
+    return basename(recordPath.replaceAll('\\', sep), '.json');
+}
+function check(slug, kind, status, message, fix) {
+    return {
+        name: `project:synced_${slug}_${kind}`,
+        description: `Synced project ${slug}: ${kind.replaceAll('_', ' ')}`,
+        status,
+        message,
+        ...(fix ? { fix } : {}),
+    };
+}
+async function recordEntries(syncedRoot) {
+    try {
+        return (await readdir(syncedRoot, { withFileTypes: true }))
+            .filter((entry) => entry.isFile() && entry.name.endsWith('.json'))
+            .map((entry) => join(syncedRoot, entry.name))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+async function editorHint(repoRoot) {
+    for (const editorDirectory of ['.vscode', '.cursor']) {
+        const directory = join(repoRoot, editorDirectory);
+        if (!(await pathExists(directory)))
+            continue;
+        let settings = {};
+        try {
+            settings = JSON.parse(await readFile(join(directory, 'settings.json'), 'utf8'));
+        }
+        catch {
+            // Missing or non-JSON settings still receive the non-blocking hint.
+        }
+        if (!('git.scanRepositories' in settings)) {
+            return {
+                name: 'project:synced_editor_hint',
+                description: 'Nested synced-project repository discovery',
+                status: 'pass',
+                message: `${editorDirectory} can set git.scanRepositories to include nested synced project checkouts.`,
+            };
+        }
+    }
+    return null;
+}
+export async function checkSyncedProjects(repoRoot, overrides = {}) {
+    const dependencies = { ...DEFAULT_DEPENDENCIES, ...overrides };
+    const projectsRoot = await dependencies.resolveProjectsRoot(repoRoot, dependencies.env);
+    const syncedRoot = resolveScopeRoot(repoRoot, projectsRoot, 'synced');
+    const syncedRelative = repoRelative(repoRoot, syncedRoot);
+    const checks = [];
+    const tracked = await dependencies.git.run(['ls-files', '--', syncedRelative], { cwd: repoRoot, allowFailure: true });
+    const missingRepository = tracked.code !== 0 &&
+        /not a git repository/i.test(`${tracked.stderr}\n${tracked.stdout}`);
+    const trackedCheckoutArtifacts = tracked.stdout
+        .split('\n')
+        .map((path) => path.trim())
+        .filter((path) => {
+        const nestedPath = path.slice(`${syncedRelative}/`.length);
+        return path.startsWith(`${syncedRelative}/`) && nestedPath.includes('/');
+    });
+    if (tracked.code !== 0 && !missingRepository) {
+        checks.push({
+            name: 'project:synced_tracked_artifacts',
+            description: 'Synced artifacts excluded from the parent branch',
+            status: 'fail',
+            message: `Unable to inspect tracked synced artifacts: ${tracked.stderr || tracked.stdout || `git ls-files exited ${tracked.code}`}.`,
+            fix: 'Resolve the Git error, then rerun `oat doctor --scope project`.',
+        });
+    }
+    else if (tracked.code === 0 && trackedCheckoutArtifacts.length > 0) {
+        checks.push({
+            name: 'project:synced_tracked_artifacts',
+            description: 'Synced artifacts excluded from the parent branch',
+            status: 'fail',
+            message: `Tracked synced artifact files: ${trackedCheckoutArtifacts.join(', ')}`,
+            fix: 'Run `oat project migrate` or remove them with `git rm --cached`.',
+        });
+    }
+    const entries = (await pathExists(syncedRoot))
+        ? await recordEntries(syncedRoot)
+        : [];
+    const ignoreProbeSlug = entries[0]
+        ? syncedRecordSlug(entries[0])
+        : '__probe__';
+    const ignored = await dependencies.git.run([
+        'check-ignore',
+        '--quiet',
+        '--no-index',
+        `${syncedRelative}/${ignoreProbeSlug}/`,
+    ], { cwd: repoRoot, allowFailure: true });
+    if (ignored.code === 1) {
+        checks.push({
+            name: 'project:synced_gitignore',
+            description: 'Managed synced-project gitignore rule',
+            status: 'warn',
+            message: 'The managed gitignore block does not ignore synced project directories.',
+            fix: 'Run `oat tools update`.',
+        });
+    }
+    const hint = await editorHint(repoRoot);
+    if (hint)
+        checks.push(hint);
+    if (entries.length === 0 && checks.length === 0) {
+        return [
+            {
+                name: 'project:synced_projects',
+                description: 'Synced project health',
+                status: 'pass',
+                message: 'No synced projects found.',
+            },
+        ];
+    }
+    const records = [];
+    for (const entry of entries) {
+        const slug = syncedRecordSlug(entry);
+        try {
+            const record = await readSyncedRecord(entry);
+            if (record)
+                records.push(record);
+        }
+        catch (error) {
+            checks.push(check(slug, 'record_schema', 'fail', error instanceof Error ? error.message : String(error), 'Upgrade the OAT CLI before reading this synced project record.'));
+        }
+    }
+    for (const record of records) {
+        const checkoutPath = join(syncedRoot, record.slug);
+        const checkoutExists = await pathExists(checkoutPath);
+        if (!checkoutExists) {
+            checks.push(check(record.slug, 'checkout', 'warn', `Synced project ${record.slug} checkout is absent.`, `Run \`oat project pull ${record.slug}\`.`));
+        }
+        else {
+            const status = await dependencies.git.run(['status', '--porcelain'], {
+                cwd: checkoutPath,
+                allowFailure: true,
+            });
+            if (status.code === 0 && status.stdout.trim()) {
+                checks.push(check(record.slug, 'working_tree', 'warn', `Synced project ${record.slug} has uncommitted changes.`, `Run \`oat project push ${record.slug}\`.`));
+            }
+        }
+        const [local, remote] = await Promise.all([
+            dependencies.git.run(['show-ref', '--hash', record.ref], {
+                cwd: repoRoot,
+                allowFailure: true,
+            }),
+            dependencies.git.run(['ls-remote', record.remote, record.ref], {
+                cwd: repoRoot,
+                allowFailure: true,
+            }),
+        ]);
+        const localQuerySucceeded = local.code === 0 || local.code === 1;
+        if (!localQuerySucceeded) {
+            checks.push(check(record.slug, 'local_ref', 'pass', `Local ref comparison skipped: ${local.stderr || local.stdout || `git show-ref exited ${local.code}`}.`));
+        }
+        if (remote.code !== 0) {
+            checks.push(check(record.slug, 'remote_ref', 'pass', `Remote comparison skipped: ${remote.stderr || remote.stdout || 'offline'}.`));
+        }
+        else {
+            const remoteSha = remote.stdout.trim().split(/\s+/)[0] ?? '';
+            const localSha = local.code === 0 ? local.stdout.trim() : '';
+            if (localQuerySucceeded &&
+                (localSha || remoteSha) &&
+                localSha !== remoteSha) {
+                const relation = localSha
+                    ? remoteSha
+                        ? 'differs from origin'
+                        : 'exists locally but is absent from origin'
+                    : 'is absent locally but exists on origin';
+                checks.push(check(record.slug, 'ref_sync', 'warn', `Local ref for ${record.slug} ${relation}.`, `Run \`oat project pull ${record.slug}\` or \`oat project push ${record.slug}\`.`));
+            }
+        }
+    }
+    return checks.length > 0
+        ? checks
+        : [
+            {
+                name: 'project:synced_projects',
+                description: 'Synced project health',
+                status: 'pass',
+                message: `Checked ${records.length} synced project(s).`,
+            },
+        ];
+}

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

@@ -0,0 +1,4 @@
+import { type ApplyManagedBlockResult } from './managed-block.js';
+export type ApplyOatCoreGitattributesResult = ApplyManagedBlockResult;
+export declare function applyOatCoreGitattributes(repoRoot: string): Promise<ApplyOatCoreGitattributesResult>;
+//# sourceMappingURL=gitattributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitattributes.d.ts","sourceRoot":"","sources":["../../../src/commands/init/gitattributes.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAMzB,MAAM,MAAM,+BAA+B,GAAG,uBAAuB,CAAC;AAEtE,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,+BAA+B,CAAC,CAM1C"}

package/dist/commands/init/gitattributes.js

@@ -0,0 +1,12 @@
+import { join } from 'node:path';
+import { applyManagedBlock, } from './managed-block.js';
+const GITATTRIBUTES_ENTRIES = [
+    '.oat/projects/shared/** linguist-generated=true',
+];
+export async function applyOatCoreGitattributes(repoRoot) {
+    return applyManagedBlock(join(repoRoot, '.gitattributes'), {
+        start: '# OAT core',
+        end: '# END OAT core',
+        entries: GITATTRIBUTES_ENTRIES,
+    });
+}

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

@@ -1,9 +1,16 @@
+import type { GitRunner } from '../project/sync/git.js';
 export interface ApplyOatCoreResult {
     action: 'created' | 'updated' | 'no-change';
     entries: string[];
     stateDashboardIndexAction: 'untracked' | 'not-tracked' | 'not-git-repo';
 }
-export declare function applyOatCoreGitignore(repoRoot: string): Promise<ApplyOatCoreResult>;
+export interface EnsureScopedRootGitignoreResult {
+    before: string | null | undefined;
+    changed: boolean;
+}
+export declare function isSyncedRuleApplied(repoRoot: string): Promise<boolean>;
+export declare function applyOatCoreGitignore(repoRoot: string, additionalEntries?: readonly string[]): Promise<ApplyOatCoreResult>;
+export declare function ensureScopedRootGitignore(repoRoot: string, scopeRoot: string, scope: 'local' | 'synced', git: GitRunner, dirtyMessage?: string | null): Promise<EnsureScopedRootGitignoreResult>;
 /**
  * Removes the generated repo dashboard from the git index once the OAT core
  * ignore rule is present, while leaving the working-tree file intact.

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

@@ -1 +1 @@
-{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../../src/commands/init/gitignore.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB,EAAE,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;CACzE;AAMD,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAgD7B;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,2BAA2B,CAAC,CAAC,CAyB1D"}
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../../src/commands/init/gitignore.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAkC5D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yBAAyB,EAAE,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;CACzE;AAED,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;CAClB;AA0BD,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB5E;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,iBAAiB,GAAE,SAAS,MAAM,EAAO,GACxC,OAAO,CAAC,kBAAkB,CAAC,CAoB7B;AAED,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,GAAG,QAAQ,EACzB,GAAG,EAAE,SAAS,EACd,YAAY,GACR,MAAM,GACN,IAAqJ,GACxJ,OAAO,CAAC,+BAA+B,CAAC,CAyG1C;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,2BAA2B,CAAC,CAAC,CAyB1D"}