@open-agent-toolkit/cli 0.1.18 → 0.1.20

package/assets/skills/oat-wrap-up/references/automation-recipes.md

@@ -35,7 +35,7 @@ The generic pattern:
 
 1. Create a scheduled trigger whose prompt is `/oat-wrap-up --past-week` (or a named range that matches your cadence).
 2. Configure the trigger to run in a workspace where the OAT repository is the current working directory.
-3. Ensure the workspace has `gh` authenticated and, for cross-teammate visibility, a recent run of `oat project archive sync` (this can be a pre-prompt step in the trigger).
+3. Ensure the workspace has `gh` authenticated and, for cross-teammate visibility, a recent run of `oat repo archive sync` (this can be a pre-prompt step in the trigger).
 
 If your Codex host does not expose scheduled triggers, fall through to Pattern 3.
 
@@ -48,7 +48,7 @@ When neither Claude Code's `CronCreate` nor Codex host scheduling is available,
 ```cron
 # Every Monday at 09:00 local time, generate a past-week wrap-up and commit it.
 0 9 * * 1 cd /path/to/repo && \
-  oat project archive sync --dry-run > /dev/null && \
+  oat repo archive sync --dry-run > /dev/null && \
   claude -p "/oat-wrap-up --past-week" && \
   git add .oat/repo/reference/wrap-ups && \
   git -c user.name="wrapup-bot" -c user.email="wrapup-bot@example.com" commit -m "chore: weekly wrap-up $(date -u +%Y-%m-%d)" >/dev/null 2>&1 || true
@@ -57,7 +57,7 @@ When neither Claude Code's `CronCreate` nor Codex host scheduling is available,
 Notes:
 
 - Replace `claude -p ...` with your host's headless invocation (`codex -p ...`, etc.) if using a different host.
-- The `oat project archive sync --dry-run` call is a preflight check — it surfaces auth or config problems early. Change it to `oat project archive sync` if you want to actively pull teammates' archives before each run.
+- The `oat repo archive sync --dry-run` call is a preflight check — it surfaces auth or config problems early. Change it to `oat repo archive sync` if you want to actively pull teammates' archives before each run.
 - The trailing `|| true` keeps cron quiet when there is nothing new to commit (e.g., the wrap-up matched a previous one).
 
 ### systemd timer example
@@ -71,7 +71,7 @@ Description=Generate weekly OAT wrap-up
 [Service]
 Type=oneshot
 WorkingDirectory=/path/to/repo
-ExecStart=/bin/sh -c 'oat project archive sync --dry-run && claude -p "/oat-wrap-up --past-week"'
+ExecStart=/bin/sh -c 'oat repo archive sync --dry-run && claude -p "/oat-wrap-up --past-week"'
 User=wrapup-bot
 ```
 
@@ -96,5 +96,5 @@ Enable with `systemctl enable --now oat-wrap-up.timer`.
 - **Timezones**: The skill resolves named ranges against `today` in the local timezone of the host running the skill. Always pin the timezone at the scheduler layer (cron `TZ=`, systemd `OnCalendar=Mon 09:00 America/Los_Angeles`, or the Claude Code trigger's `timezone` field) so reports are reproducible across re-runs.
 - **Cadence vs window length**: A weekly cadence usually pairs with `--past-week`. A biweekly cadence with `--past-2-weeks`. Running a weekly cadence with `--past-2-weeks` overlaps every report — fine if you want a rolling window, confusing if you expect discrete chunks.
 - **Commit + push**: The skill itself never commits. If you want the report to land in the repo automatically, the automation wrapper owns the `git add && git commit && git push` step. Keep that wrapper out of the skill so the skill stays portable.
-- **Failure handling**: If `gh` auth expires or `oat project archive sync` fails, the cron run should log the failure and exit non-zero rather than producing an empty wrap-up. Prefer pinning the shell to `set -euo pipefail` or an equivalent in the wrapper.
+- **Failure handling**: If `gh` auth expires or `oat repo archive sync` fails, the cron run should log the failure and exit non-zero rather than producing an empty wrap-up. Prefer pinning the shell to `set -euo pipefail` or an equivalent in the wrapper.
 - **Idempotence**: Running the same window twice produces the same report content (modulo `generated_at`). Overwriting is safe; appending duplicate commits is usually not — coalesce with a pre-check (`git diff --quiet` on the wrap-ups directory) if your cadence might cause no-op runs.

package/dist/commands/config/index.js

@@ -188,7 +188,7 @@ const CONFIG_CATALOG = [
         defaultValue: 'unset',
         mutability: 'read/write',
         owningCommand: 'oat config set archive.awsProfile <value>',
-        description: 'AWS named profile forwarded as AWS_PROFILE to every `aws` invocation made by the archive S3 sync (completion + `oat project archive sync`). Precedence: per-invocation flag > existing shell env > this config value.',
+        description: 'AWS named profile forwarded as AWS_PROFILE to every `aws` invocation made by the archive S3 sync (completion + `oat repo archive sync`). Precedence: per-invocation flag > this config value > existing shell env.',
     },
     {
         key: 'archive.awsRegion',
@@ -199,7 +199,7 @@ const CONFIG_CATALOG = [
         defaultValue: 'unset',
         mutability: 'read/write',
         owningCommand: 'oat config set archive.awsRegion <value>',
-        description: 'AWS region forwarded as AWS_REGION to every `aws` invocation made by the archive S3 sync (completion + `oat project archive sync`). Precedence: per-invocation flag > existing shell env > this config value.',
+        description: 'AWS region forwarded as AWS_REGION to every `aws` invocation made by the archive S3 sync (completion + `oat repo archive sync`). Precedence: per-invocation flag > this config value > existing shell env.',
     },
     {
         key: 'tools.brainstorm',

package/dist/commands/project/archive/archive-utils.d.ts

@@ -60,6 +60,23 @@ export interface ResolvePrimaryRepoRootDependencies {
     dirExists?: typeof dirExists;
     env?: NodeJS.ProcessEnv;
 }
+export interface ResolveArchiveProjectTargetOptions {
+    repoRoot: string;
+    projectsRoot: string;
+    projectName: string;
+}
+export interface ResolveArchiveProjectTargetDependencies extends ResolvePrimaryRepoRootDependencies {
+    timestamp?: () => string;
+}
+export interface ArchiveProjectTarget {
+    archiveProjectPath: string;
+    archiveRepoRoot: string;
+    archivePath: string;
+    archivePathIsGitignored: boolean;
+    primaryRepoRoot: string | null;
+    primaryRepoRootAvailable: boolean;
+    localOnlyWarning: string | null;
+}
 interface ArchiveProjectOnCompletionDependencies extends EnsureS3ArchiveAccessDependencies, ResolvePrimaryRepoRootDependencies {
     ensureS3ArchiveAccess?: typeof ensureS3ArchiveAccess;
     execFile?: ExecFileLike;
@@ -120,6 +137,8 @@ export declare function parseArchiveSnapshotName(snapshotName: string): {
 };
 export declare function resolveLocalArchiveProjectPath(projectsRoot: string, projectName: string): string;
 export declare function resolvePrimaryRepoRoot(repoRoot: string, dependencies?: ResolvePrimaryRepoRootDependencies): Promise<string>;
+export declare function resolveArchiveProjectTarget(options: ResolveArchiveProjectTargetOptions, dependencies?: ResolveArchiveProjectTargetDependencies): Promise<ArchiveProjectTarget>;
+export declare function assertDurableArchiveProjectTarget(target: ArchiveProjectTarget): void;
 export declare function archiveProjectOnCompletion(options: ArchiveProjectOnCompletionOptions, dependencies?: ArchiveProjectOnCompletionDependencies): Promise<ArchiveProjectOnCompletionResult>;
 export declare function ensureS3ArchiveAccess(options: EnsureS3ArchiveAccessOptions, dependencies?: EnsureS3ArchiveAccessDependencies): Promise<EnsureS3ArchiveAccessResult>;
 export {};

package/dist/commands/project/archive/archive-utils.d.ts.map

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

package/dist/commands/project/archive/archive-utils.js

@@ -1,6 +1,6 @@
 import { execFile as execFileCallback } from 'node:child_process';
 import { rm, writeFile } from 'node:fs/promises';
-import { basename, dirname, isAbsolute, join, posix as path } from 'node:path';
+import { basename, dirname, isAbsolute, join, posix as path, relative, resolve, sep, } from 'node:path';
 import { promisify } from 'node:util';
 import { CliError } from '../../../errors/cli-error.js';
 import { copyDirectory, copySingleFile, dirExists, ensureDir, fileExists, } from '../../../fs/io.js';
@@ -112,8 +112,32 @@ export function resolveLocalArchiveProjectPath(projectsRoot, projectName) {
     const projectsBase = path.dirname(normalizedProjectsRoot);
     return path.join(projectsBase, 'archived', projectName);
 }
-function resolveCompletionArchivePath(archiveRepoRoot, projectsRoot, projectName) {
-    return join(archiveRepoRoot, resolveLocalArchiveProjectPath(projectsRoot, projectName));
+function normalizePathForConfig(pathValue) {
+    return pathValue.replaceAll('\\', '/');
+}
+function isInsidePath(parentPath, childPath) {
+    const relativePath = relative(parentPath, childPath);
+    return (relativePath === '' ||
+        (!relativePath.startsWith(`..${sep}`) &&
+            relativePath !== '..' &&
+            !isAbsolute(relativePath)));
+}
+function resolveArchiveProjectPath(repoRoot, projectsRoot, projectName) {
+    const archiveProjectPath = resolveLocalArchiveProjectPath(projectsRoot, projectName);
+    if (!isAbsolute(archiveProjectPath)) {
+        return archiveProjectPath;
+    }
+    const resolvedRepoRoot = resolve(repoRoot);
+    const resolvedArchiveProjectPath = resolve(archiveProjectPath);
+    if (!isInsidePath(resolvedRepoRoot, resolvedArchiveProjectPath)) {
+        return resolvedArchiveProjectPath;
+    }
+    return normalizePathForConfig(relative(resolvedRepoRoot, resolvedArchiveProjectPath));
+}
+function resolveCompletionArchivePath(archiveRepoRoot, archiveProjectPath) {
+    return isAbsolute(archiveProjectPath)
+        ? archiveProjectPath
+        : join(archiveRepoRoot, archiveProjectPath);
 }
 function resolveGitPath(repoRoot, gitPath) {
     const normalizedPath = gitPath.trim();
@@ -150,7 +174,7 @@ async function isGitignoredArchivePath(repoRoot, archiveProjectPath, dependencie
         throw error;
     }
 }
-export async function resolvePrimaryRepoRoot(repoRoot, dependencies = {}) {
+async function resolvePrimaryRepoRootResolution(repoRoot, dependencies = {}) {
     const execFile = dependencies.gitExecFile ?? execFileAsync;
     try {
         const [{ stdout: commonDir }, { stdout: gitDir }] = await Promise.all([
@@ -166,30 +190,22 @@ export async function resolvePrimaryRepoRoot(repoRoot, dependencies = {}) {
         const resolvedCommonDir = resolveGitPath(repoRoot, commonDir);
         const resolvedGitDir = resolveGitPath(repoRoot, gitDir);
         if (resolvedCommonDir === resolvedGitDir) {
-            return repoRoot;
+            return { repoRoot, available: true };
         }
         const primaryRepoRoot = dirname(resolvedCommonDir);
         const directoryExists = dependencies.dirExists ?? dirExists;
         if (await directoryExists(primaryRepoRoot)) {
-            return primaryRepoRoot;
+            return { repoRoot: primaryRepoRoot, available: true };
         }
+        return { repoRoot: primaryRepoRoot, available: false };
     }
     catch {
-        return repoRoot;
+        return { repoRoot, available: false };
     }
-    return repoRoot;
 }
-async function resolveArchiveRepoRoot(repoRoot, archiveProjectPath, dependencies) {
-    try {
-        const archivePathIsGitignored = await isGitignoredArchivePath(repoRoot, archiveProjectPath, dependencies);
-        if (!archivePathIsGitignored) {
-            return repoRoot;
-        }
-    }
-    catch {
-        return repoRoot;
-    }
-    return resolvePrimaryRepoRoot(repoRoot, dependencies);
+export async function resolvePrimaryRepoRoot(repoRoot, dependencies = {}) {
+    const resolution = await resolvePrimaryRepoRootResolution(repoRoot, dependencies);
+    return resolution.available ? resolution.repoRoot : repoRoot;
 }
 async function resolveUniqueArchivePath(archivePath, dependencies) {
     const directoryExists = dependencies.dirExists ?? dirExists;
@@ -200,6 +216,56 @@ async function resolveUniqueArchivePath(archivePath, dependencies) {
     const suffix = timestamp.replace(/[-:TZ.]/g, '').slice(0, 15);
     return `${archivePath}-${suffix}`;
 }
+function buildLocalOnlyArchiveWarning(projectName, archiveProjectPath, primaryRepoRoot) {
+    const primaryMessage = primaryRepoRoot
+        ? `the primary checkout \`${primaryRepoRoot}\` is unavailable`
+        : 'the primary checkout could not be resolved';
+    return `Refusing to archive project \`${projectName}\` because \`${archiveProjectPath}\` is gitignored in this worktree and ${primaryMessage}. Run \`oat project archive\` from the primary checkout or restore that checkout before retrying.`;
+}
+export async function resolveArchiveProjectTarget(options, dependencies = {}) {
+    const archiveProjectPath = resolveArchiveProjectPath(options.repoRoot, options.projectsRoot, options.projectName);
+    let archivePathIsGitignored = false;
+    let archiveRepoRoot = options.repoRoot;
+    let primaryRepoRoot = null;
+    let primaryRepoRootAvailable = true;
+    let localOnlyWarning = null;
+    try {
+        archivePathIsGitignored = await isGitignoredArchivePath(options.repoRoot, archiveProjectPath, dependencies);
+    }
+    catch {
+        archivePathIsGitignored = false;
+    }
+    if (archivePathIsGitignored) {
+        const primaryResolution = await resolvePrimaryRepoRootResolution(options.repoRoot, dependencies);
+        primaryRepoRoot = primaryResolution.repoRoot;
+        primaryRepoRootAvailable = primaryResolution.available;
+        if (primaryResolution.available) {
+            archiveRepoRoot = primaryResolution.repoRoot;
+        }
+        else {
+            localOnlyWarning = buildLocalOnlyArchiveWarning(options.projectName, archiveProjectPath, primaryRepoRoot);
+        }
+    }
+    const archiveBasePath = resolveCompletionArchivePath(archiveRepoRoot, archiveProjectPath);
+    const archivePath = await resolveUniqueArchivePath(archiveBasePath, {
+        dirExists: dependencies.dirExists,
+        timestamp: dependencies.timestamp,
+    });
+    return {
+        archiveProjectPath,
+        archiveRepoRoot,
+        archivePath,
+        archivePathIsGitignored,
+        primaryRepoRoot,
+        primaryRepoRootAvailable,
+        localOnlyWarning,
+    };
+}
+export function assertDurableArchiveProjectTarget(target) {
+    if (target.localOnlyWarning) {
+        throw new CliError(target.localOnlyWarning);
+    }
+}
 async function writeArchiveSnapshotMetadata(archivePath, metadata) {
     await writeFile(join(archivePath, ARCHIVE_SNAPSHOT_METADATA_FILENAME), `${JSON.stringify(metadata, null, 2)}\n`, 'utf8');
 }
@@ -223,10 +289,13 @@ export async function archiveProjectOnCompletion(options, dependencies = {}) {
     const execFile = dependencies.execFile ?? execFileAsync;
     const timestamp = dependencies.timestamp?.() ?? new Date().toISOString();
     const snapshotName = buildArchiveSnapshotName(options.projectName, timestamp);
-    const archiveProjectPath = resolveLocalArchiveProjectPath(options.projectsRoot, options.projectName);
-    const archiveRepoRoot = await resolveArchiveRepoRoot(options.repoRoot, archiveProjectPath, dependencies);
-    const archiveBasePath = resolveCompletionArchivePath(archiveRepoRoot, options.projectsRoot, options.projectName);
-    const archivePath = await resolveUniqueArchivePath(archiveBasePath, dependencies);
+    const archiveTarget = await resolveArchiveProjectTarget({
+        repoRoot: options.repoRoot,
+        projectsRoot: options.projectsRoot,
+        projectName: options.projectName,
+    }, dependencies);
+    assertDurableArchiveProjectTarget(archiveTarget);
+    const archivePath = archiveTarget.archivePath;
     await makeDir(dirname(archivePath));
     await copyProjectDirectory(options.projectPath, archivePath);
     await writeArchiveSnapshotMetadata(archivePath, {
@@ -310,7 +379,7 @@ export async function ensureS3ArchiveAccess(options, dependencies = {}) {
             if (options.mode === 'completion') {
                 return buildCompletionWarning('Archive S3 sync is enabled via `archive.s3SyncOnComplete`, but AWS CLI was not found on PATH. Skipping S3 archive sync.');
             }
-            throw buildSyncError('AWS CLI is required for `oat project archive sync`, but it was not found on PATH. Install `aws` and retry.');
+            throw buildSyncError('AWS CLI is required for `oat repo archive sync`, but it was not found on PATH. Install `aws` and retry.');
         }
         throw error;
     }
@@ -322,6 +391,6 @@ export async function ensureS3ArchiveAccess(options, dependencies = {}) {
         if (options.mode === 'completion') {
             return buildCompletionWarning('Archive S3 sync is enabled via `archive.s3SyncOnComplete` and `archive.s3Uri`, but AWS CLI is not configured for access. Skipping S3 archive sync.');
         }
-        throw buildSyncError('AWS CLI is required for `oat project archive sync`, but it is not configured for access to `archive.s3Uri`. Configure AWS credentials or profile settings and retry.');
+        throw buildSyncError('AWS CLI is required for `oat repo archive sync`, but it is not configured for access to `archive.s3Uri`. Configure AWS credentials or profile settings and retry.');
     }
 }

package/dist/commands/project/archive/index.d.ts

@@ -1,21 +1,8 @@
-import { rm } from 'node:fs/promises';
-import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
-import { type OatConfig } from '../../../config/oat-config.js';
 import { Command } from 'commander';
-import { buildProjectArchiveS3Uri, buildRepoArchiveS3Uri, ensureS3ArchiveAccess, type ExecFileLike, resolveLocalArchiveProjectPath, resolvePrimaryRepoRoot } from './archive-utils.js';
-export interface ProjectArchiveCommandDependencies {
-    buildCommandContext: (options: Parameters<typeof buildCommandContext>[0]) => CommandContext;
-    resolveProjectRoot: (cwd: string) => Promise<string>;
-    readOatConfig: (repoRoot: string) => Promise<OatConfig>;
-    resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
-    ensureS3ArchiveAccess: typeof ensureS3ArchiveAccess;
-    buildRepoArchiveS3Uri: typeof buildRepoArchiveS3Uri;
-    buildProjectArchiveS3Uri: typeof buildProjectArchiveS3Uri;
-    resolveLocalArchiveProjectPath: typeof resolveLocalArchiveProjectPath;
-    resolvePrimaryRepoRoot: typeof resolvePrimaryRepoRoot;
-    execFile: ExecFileLike;
-    removeDirectory: typeof rm;
-    processEnv: NodeJS.ProcessEnv;
-}
-export declare function createProjectArchiveCommand(overrides?: Partial<ProjectArchiveCommandDependencies>): Command;
+import { type ProjectArchivePushCommandDependencies } from './push-runner.js';
+import { type ProjectArchiveCommandDependencies } from './sync-runner.js';
+export type { ArchiveSyncOptions, ProjectArchiveCommandDependencies, } from './sync-runner.js';
+export type { ArchivePushOptions, ProjectArchivePushCommandDependencies, } from './push-runner.js';
+type ProjectArchiveDependencies = ProjectArchiveCommandDependencies & ProjectArchivePushCommandDependencies;
+export declare function createProjectArchiveCommand(overrides?: Partial<ProjectArchiveDependencies>): Command;
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/project/archive/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAIhD,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,oBAAoB,CAAC;AAGnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAIL,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,YAAY,EAEjB,8BAA8B,EAC9B,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AA8DzB,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;IACpD,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;IACpD,wBAAwB,EAAE,OAAO,wBAAwB,CAAC;IAC1D,8BAA8B,EAAE,OAAO,8BAA8B,CAAC;IACtE,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,EAAE,OAAO,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAoMD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,iCAAiC,CAAM,GACzD,OAAO,CA4LT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/archive/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAIL,KAAK,qCAAqC,EAC3C,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,iCAAiC,EACvC,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,kBAAkB,EAClB,iCAAiC,GAClC,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,qCAAqC,GACtC,MAAM,eAAe,CAAC;AAEvB,KAAK,0BAA0B,GAAG,iCAAiC,GACjE,qCAAqC,CAAC;AAKxC,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAyET"}

package/dist/commands/project/archive/index.js

@@ -1,269 +1,37 @@
-import { execFile as execFileCallback } from 'node:child_process';
-import { readFile, rm } from 'node:fs/promises';
-import { join, posix as path } from 'node:path';
-import { promisify } from 'node:util';
-import { buildCommandContext } from '../../../app/command-context.js';
-import { resolveProjectsRoot } from '../../shared/oat-paths.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
-import { readOatConfig } from '../../../config/oat-config.js';
-import { CliError } from '../../../errors/cli-error.js';
-import { resolveProjectRoot } from '../../../fs/paths.js';
 import { Command } from 'commander';
-import { ARCHIVE_SNAPSHOT_METADATA_FILENAME, S3_ARCHIVE_SYNC_EXCLUDES, buildAwsEnv, buildProjectArchiveS3Uri, buildRepoArchiveS3Uri, ensureS3ArchiveAccess, parseArchiveSnapshotName, resolveLocalArchiveProjectPath, resolvePrimaryRepoRoot, } from './archive-utils.js';
-const execFileAsync = promisify(execFileCallback);
-/**
- * Resolve effective AWS profile/region for an archive sync invocation.
- *
- * Precedence (highest first): `--profile`/`--region` flag > `archive.awsProfile`/`archive.awsRegion`
- * config > parent shell `AWS_PROFILE`/`AWS_REGION` env. Repo config is treated
- * as deliberate, OAT-archive-scoped intent and wins over ambient shell state —
- * users who explicitly set `archive.awsProfile` for the repo don't have to
- * remember to unset `AWS_PROFILE` in every shell. Flag still beats config for
- * one-off overrides.
- *
- * The returned `env` is suitable for passing into every `aws` spawn in this
- * command. The returned `awsProfile`/`awsRegion` are also forwarded to
- * `ensureS3ArchiveAccess` so its preflight `aws sts get-caller-identity` runs
- * against the same identity.
- */
-function resolveSyncAwsEnv(processEnv, options, config) {
-    const flagProfile = typeof options.profile === 'string' && options.profile.trim().length > 0
-        ? options.profile.trim()
-        : undefined;
-    const flagRegion = typeof options.region === 'string' && options.region.trim().length > 0
-        ? options.region.trim()
-        : undefined;
-    const configProfile = config.archive?.awsProfile;
-    const configRegion = config.archive?.awsRegion;
-    // Flag beats config; either is forwarded to buildAwsEnv, which clobbers the
-    // parent env entry with the resolved value. When neither flag nor config is
-    // set, awsProfile/awsRegion stay undefined and the parent env passes through
-    // untouched — letting the AWS CLI's own resolution chain take over.
-    const awsProfile = flagProfile ?? configProfile ?? undefined;
-    const awsRegion = flagRegion ?? configRegion ?? undefined;
-    const env = buildAwsEnv(processEnv, {
-        awsProfile,
-        awsRegion,
-    });
-    return { env, awsProfile, awsRegion };
-}
-function defaultDependencies() {
-    return {
-        buildCommandContext,
-        resolveProjectRoot,
-        readOatConfig,
-        resolveProjectsRoot,
-        ensureS3ArchiveAccess,
-        buildRepoArchiveS3Uri,
-        buildProjectArchiveS3Uri,
-        resolveLocalArchiveProjectPath,
-        resolvePrimaryRepoRoot,
-        execFile: execFileAsync,
-        removeDirectory: rm,
-        processEnv: process.env,
-    };
-}
-function resolveLocalArchiveRoot(projectsRoot) {
-    return path.join(path.dirname(projectsRoot.replace(/\/+$/, '')), 'archived');
-}
-function buildArchiveSyncArgs(source, target, options) {
-    const args = ['s3', 'sync', source, target];
-    for (const pattern of S3_ARCHIVE_SYNC_EXCLUDES) {
-        args.push('--exclude', pattern);
-    }
-    if (options.dryRun) {
-        args.push('--dryrun');
-    }
-    return args;
-}
-async function runArchiveSync(repoRoot, source, target, options, awsEnv, dependencies) {
-    await dependencies.execFile('aws', buildArchiveSyncArgs(source, target, options), {
-        cwd: repoRoot,
-        env: awsEnv,
-    });
-}
-async function listArchiveSnapshots(repoRoot, projectsRoot, s3Uri, awsEnv, dependencies) {
-    const remoteRepoRoot = await dependencies.resolvePrimaryRepoRoot(repoRoot, {
-        gitExecFile: dependencies.execFile,
-        env: awsEnv,
-    });
-    const repoPrefix = `${dependencies.buildRepoArchiveS3Uri(s3Uri, remoteRepoRoot)}/`;
-    const { stdout } = await dependencies.execFile('aws', ['s3', 'ls', repoPrefix], {
-        cwd: repoRoot,
-        env: awsEnv,
-    });
-    return stdout
-        .split('\n')
-        .map((line) => line.match(/PRE\s+(.+?)\/?\s*$/)?.[1] ?? null)
-        .filter((snapshotName) => Boolean(snapshotName))
-        .map((snapshotName) => {
-        const parsed = parseArchiveSnapshotName(snapshotName);
-        return {
-            ...parsed,
-            source: dependencies.buildProjectArchiveS3Uri(s3Uri, remoteRepoRoot, snapshotName),
-            target: dependencies.resolveLocalArchiveProjectPath(projectsRoot, parsed.projectName),
-        };
-    });
-}
-function compareSnapshotEntries(left, right) {
-    if (left.dateStamp && right.dateStamp && left.dateStamp !== right.dateStamp) {
-        return left.dateStamp.localeCompare(right.dateStamp);
-    }
-    if (left.dateStamp && !right.dateStamp) {
-        return 1;
-    }
-    if (!left.dateStamp && right.dateStamp) {
-        return -1;
-    }
-    return left.snapshotName.localeCompare(right.snapshotName);
-}
-function selectLatestSnapshots(snapshots) {
-    const latestByProject = new Map();
-    for (const snapshot of snapshots) {
-        const current = latestByProject.get(snapshot.projectName);
-        if (!current || compareSnapshotEntries(snapshot, current) > 0) {
-            latestByProject.set(snapshot.projectName, snapshot);
-        }
-    }
-    return [...latestByProject.values()];
-}
-async function readLocalSnapshotName(repoRoot, target) {
-    try {
-        const content = await readFile(join(repoRoot, target, ARCHIVE_SNAPSHOT_METADATA_FILENAME), 'utf8');
-        const parsed = JSON.parse(content);
-        return typeof parsed.snapshotName === 'string' ? parsed.snapshotName : null;
-    }
-    catch {
-        return null;
-    }
-}
-async function syncArchiveSnapshot(repoRoot, snapshot, options, awsEnv, dependencies) {
-    const currentSnapshotName = await readLocalSnapshotName(repoRoot, snapshot.target);
-    if (!options.force && currentSnapshotName === snapshot.snapshotName) {
-        return false;
-    }
-    if (!options.dryRun) {
-        await dependencies.removeDirectory(join(repoRoot, snapshot.target), {
-            recursive: true,
-            force: true,
-        });
-    }
-    await runArchiveSync(repoRoot, snapshot.source, snapshot.target, options, awsEnv, dependencies);
-    return true;
-}
+import { defaultProjectArchivePushCommandDependencies, runArchivePushCommand, } from './push-runner.js';
+import { defaultProjectArchiveCommandDependencies, runArchiveSyncCommand, } from './sync-runner.js';
+const PROJECT_ARCHIVE_SYNC_DEPRECATION_NOTICE = 'oat project archive sync is deprecated; use oat repo archive sync';
 export function createProjectArchiveCommand(overrides = {}) {
     const dependencies = {
-        ...defaultDependencies(),
+        ...defaultProjectArchiveCommandDependencies(),
+        ...defaultProjectArchivePushCommandDependencies(),
         ...overrides,
     };
     return new Command('archive')
         .description('Manage archived project data')
+        .argument('[project-path]', 'Project path to archive')
+        .option('--dry-run', 'Preview archive without moving files or syncing S3')
+        .addHelpText('afterAll', '\nPull archived project data with `oat repo archive sync [project-name]`; `oat project archive sync` is deprecated.')
+        .action(async (projectPath, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runArchivePushCommand(dependencies, projectPath, options, context);
+    })
         .addCommand(new Command('sync')
-        .description('Sync archived project data from S3 into the local archive')
+        .description('[deprecated] Sync archived project data from S3 into the local archive')
         .argument('[project-name]', 'Archived project name to sync')
         .option('--dry-run', 'Preview archive sync without downloading')
         .option('--force', 'Replace the named local archive before syncing it from S3')
         .option('--profile <profile>', 'AWS profile override for this sync')
         .option('--region <region>', 'AWS region override for this sync')
         .action(async (projectName, options, command) => {
+        process.stderr.write(`${PROJECT_ARCHIVE_SYNC_DEPRECATION_NOTICE}\n`);
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
-        try {
-            if (options.force && !projectName) {
-                throw new CliError('`--force` requires a project name for `oat project archive sync`.');
-            }
-            const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
-            const config = await dependencies.readOatConfig(repoRoot);
-            const s3Uri = config.archive?.s3Uri;
-            if (!s3Uri) {
-                throw new CliError('Archive sync requires `archive.s3Uri` to be configured. Set it with `oat config set archive.s3Uri <s3://...>` and retry.');
-            }
-            const { env: awsEnv, awsProfile, awsRegion, } = resolveSyncAwsEnv(dependencies.processEnv, options, config);
-            await dependencies.ensureS3ArchiveAccess({
-                mode: 'sync',
-                s3Uri,
-                syncOnComplete: config.archive?.s3SyncOnComplete ?? false,
-                awsProfile,
-                awsRegion,
-            }, { env: awsEnv });
-            const projectsRoot = await dependencies.resolveProjectsRoot(repoRoot, dependencies.processEnv);
-            const snapshots = await listArchiveSnapshots(repoRoot, projectsRoot, s3Uri, awsEnv, dependencies);
-            const targets = projectName
-                ? snapshots.filter((snapshot) => snapshot.projectName === projectName ||
-                    snapshot.snapshotName === projectName)
-                : selectLatestSnapshots(snapshots);
-            if (projectName && targets.length === 0) {
-                throw new CliError(`No archived snapshot found in S3 for project \`${projectName}\`.`);
-            }
-            const latestTarget = projectName
-                ? targets.reduce((latest, snapshot) => {
-                    if (!latest) {
-                        return snapshot;
-                    }
-                    return compareSnapshotEntries(snapshot, latest) > 0
-                        ? snapshot
-                        : latest;
-                }, null)
-                : null;
-            const snapshotsToSync = projectName
-                ? latestTarget
-                    ? [latestTarget]
-                    : []
-                : targets;
-            const appliedTargets = [];
-            const appliedSources = [];
-            for (const snapshot of snapshotsToSync) {
-                if (!snapshot) {
-                    continue;
-                }
-                const synced = await syncArchiveSnapshot(repoRoot, snapshot, options, awsEnv, dependencies);
-                if (synced) {
-                    appliedTargets.push(snapshot.target);
-                    appliedSources.push(snapshot.source);
-                }
-            }
-            const subject = projectName
-                ? `archived project \`${projectName}\``
-                : 'archived projects';
-            const targetSummary = appliedTargets.length > 0
-                ? appliedTargets.join(', ')
-                : resolveLocalArchiveRoot(projectsRoot);
-            const sourceSummary = appliedSources.length > 0
-                ? appliedSources.join(', ')
-                : dependencies.buildRepoArchiveS3Uri(s3Uri, await dependencies.resolvePrimaryRepoRoot(repoRoot, {
-                    gitExecFile: dependencies.execFile,
-                    env: awsEnv,
-                }));
-            if (context.json) {
-                context.logger.json({
-                    status: 'ok',
-                    mode: options.dryRun ? 'dry-run' : 'apply',
-                    projectName: projectName ?? null,
-                    sources: appliedSources,
-                    targets: appliedTargets,
-                    skipped: appliedTargets.length === 0,
-                    force: options.force ?? false,
-                });
-            }
-            else if (options.dryRun) {
-                context.logger.info(`Dry-run: would sync ${subject} from ${sourceSummary} to ${targetSummary}.`);
-            }
-            else if (appliedTargets.length === 0) {
-                context.logger.info(`Skipped ${subject}; local archive is already using the latest remote snapshot.`);
-            }
-            else {
-                context.logger.info(`Synced ${subject} from ${sourceSummary} to ${targetSummary}.`);
-            }
-            process.exitCode = 0;
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            if (context.json) {
-                context.logger.json({ status: 'error', message });
-            }
-            else {
-                context.logger.error(message);
-            }
-            process.exitCode = error instanceof CliError ? error.exitCode : 1;
-        }
+        const syncOptions = {
+            ...options,
+            dryRun: options.dryRun ?? context.dryRun,
+        };
+        await runArchiveSyncCommand(dependencies, projectName, syncOptions, context, 'oat project archive sync');
     }));
 }

package/dist/commands/project/archive/push-runner.d.ts

@@ -0,0 +1,21 @@
+import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
+import { type OatConfig, type OatLocalConfig } from '../../../config/oat-config.js';
+import { resolveArchiveProjectTarget, resolvePrimaryRepoRoot, type ArchiveProjectOnCompletionOptions, type ArchiveProjectOnCompletionResult } from './archive-utils.js';
+export interface ArchivePushOptions {
+    dryRun?: boolean;
+}
+export interface ProjectArchivePushCommandDependencies {
+    buildCommandContext: (options: Parameters<typeof buildCommandContext>[0]) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    readOatConfig: (repoRoot: string) => Promise<OatConfig>;
+    readOatLocalConfig: (repoRoot: string) => Promise<OatLocalConfig>;
+    resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
+    resolvePrimaryRepoRoot: typeof resolvePrimaryRepoRoot;
+    resolveArchiveProjectTarget: typeof resolveArchiveProjectTarget;
+    archiveProjectOnCompletion: (options: ArchiveProjectOnCompletionOptions) => Promise<ArchiveProjectOnCompletionResult>;
+    processEnv: NodeJS.ProcessEnv;
+    timestamp: () => string;
+}
+export declare function defaultProjectArchivePushCommandDependencies(): ProjectArchivePushCommandDependencies;
+export declare function runArchivePushCommand(dependencies: ProjectArchivePushCommandDependencies, projectPathArg: string | undefined, options: ArchivePushOptions, context: CommandContext): Promise<void>;
+//# sourceMappingURL=push-runner.d.ts.map