@open-agent-toolkit/cli 0.0.23 → 0.0.24

package/README.md

@@ -27,9 +27,20 @@ Additional useful entry points:
 
 - `oat tools install`
 - `oat docs init --app-name my-docs`
+- `oat config dump --json`
+- `oat project status --json`
+- `oat project list --json`
 - `oat project archive sync`
 - `oat doctor`
 
+## Inspection Commands
+
+Use these commands when you want structured runtime/project state out of the CLI:
+
+- `oat config dump --json` - emit merged OAT config with per-key source attribution
+- `oat project status --json` - emit the active project's full parsed control-plane state
+- `oat project list --json` - emit summary state for tracked projects under the configured projects root
+
 ## Requirements
 
 - Node.js `>=22.17.0`

package/assets/docs/cli-utilities/config-and-local-state.md

@@ -45,9 +45,12 @@ Use `oat config` for repo runtime config inspection and supported key mutation.
 - `oat config get <key>` - read one resolved config value
 - `oat config set <key> <value>` - update a supported shared or repo-local key
 - `oat config list` - show the resolved command-surface values with source information
+- `oat config dump --json` - emit the full merged config payload with per-key source attribution, suitable for automation and debugging
 - `oat config describe` - list supported config surfaces and keys across shared repo, repo-local, user, and sync/provider config
 - `oat config describe <key>` - show file location, scope, default, mutability, and owning command for one key
 
+Use `oat config dump --json` when you need the whole resolved config in one machine-readable response rather than a single key or a human-oriented list view.
+
 Archive lifecycle settings live here as shared repo config:
 
 - `archive.s3Uri`

package/assets/docs/reference/cli-reference.md

@@ -22,14 +22,20 @@ The CLI is also a standalone value path. You can use `oat init`, `oat sync`, `oa
 
 ## Command Groups
 
-| Command group                                   | What it covers                                                                            | Go deeper                                                            |
-| ----------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| `oat init`                                      | Bootstrap canonical OAT directories, sync config, optional hooks, and guided setup.       | [CLI Bootstrap](../cli-utilities/bootstrap.md)                       |
-| `oat tools ...`                                 | Install, inspect, update, and remove bundled OAT tool packs and assets.                   | [Tool Packs](../cli-utilities/tool-packs.md)                         |
-| `oat backlog ...` / `oat local ...`             | File-backed backlog helpers, local path sync, and local-only operational support.         | [Config and Local State](../cli-utilities/config-and-local-state.md) |
-| `oat config ...` / `oat instructions ...`       | Config discovery, supported mutations, and instruction-integrity helpers.                 | [Config and Local State](../cli-utilities/config-and-local-state.md) |
-| `oat state ...` / `oat index ...` / `internal`  | Repo dashboard refresh, repo indexing, validation helpers, and diagnostics.               | [Config and Local State](../cli-utilities/config-and-local-state.md) |
-| `oat docs ...`                                  | Docs app bootstrap, migration, index generation, nav sync, and docs workflow entrypoints. | [Docs Tooling Commands](../docs-tooling/commands.md)                 |
-| `oat status` / `oat sync` / `oat providers ...` | Provider sync, drift inspection, provider configuration, and adoption behavior.           | [Provider Sync](../provider-sync/index.md)                           |
-| `oat project ...` / `oat cleanup ...`           | Project scaffolding, execution mode, and project/artifact cleanup commands.               | [Workflow & Projects](../workflows/projects/index.md)                |
-| `oat repo ...`                                  | Repository-level analysis workflows, currently centered on PR comments.                   | [Repository Analysis](../workflows/projects/repo-analysis.md)        |
+| Command group                                   | What it covers                                                                                                                         | Go deeper                                                            |
+| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `oat init`                                      | Bootstrap canonical OAT directories, sync config, optional hooks, and guided setup.                                                    | [CLI Bootstrap](../cli-utilities/bootstrap.md)                       |
+| `oat tools ...`                                 | Install, inspect, update, and remove bundled OAT tool packs and assets.                                                                | [Tool Packs](../cli-utilities/tool-packs.md)                         |
+| `oat backlog ...` / `oat local ...`             | File-backed backlog helpers, local path sync, and local-only operational support.                                                      | [Config and Local State](../cli-utilities/config-and-local-state.md) |
+| `oat config ...` / `oat instructions ...`       | Config discovery, source-aware config dumps, supported mutations, and instruction-integrity helpers.                                   | [Config and Local State](../cli-utilities/config-and-local-state.md) |
+| `oat state ...` / `oat index ...` / `internal`  | Repo dashboard refresh, repo indexing, validation helpers, and diagnostics.                                                            | [Config and Local State](../cli-utilities/config-and-local-state.md) |
+| `oat docs ...`                                  | Docs app bootstrap, migration, index generation, nav sync, and docs workflow entrypoints.                                              | [Docs Tooling Commands](../docs-tooling/commands.md)                 |
+| `oat status` / `oat sync` / `oat providers ...` | Provider sync, drift inspection, provider configuration, and adoption behavior.                                                        | [Provider Sync](../provider-sync/index.md)                           |
+| `oat project ...` / `oat cleanup ...`           | Project scaffolding, active-project status inspection, tracked-project listing, execution mode, and project/artifact cleanup commands. | [Workflow & Projects](../workflows/projects/index.md)                |
+| `oat repo ...`                                  | Repository-level analysis workflows, currently centered on PR comments.                                                                | [Repository Analysis](../workflows/projects/repo-analysis.md)        |
+
+Notable inspection commands introduced in the current CLI surface:
+
+- `oat config dump --json` - merged config with source attribution
+- `oat project status --json` - full parsed state for the active tracked project
+- `oat project list --json` - summary state for tracked projects under the configured projects root

package/assets/docs/reference/file-locations.md

@@ -80,6 +80,7 @@ Archive sync surfaces:
 
 ## CLI code
 
+- `packages/control-plane/` - read-only control-plane library for project-state parsing and recommendation
 - `packages/cli/src/commands/`
 - `packages/cli/src/commands/cleanup/`
 - `packages/cli/src/commands/cleanup/project/`

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.0.23",
-  "docs-config": "0.0.23",
-  "docs-theme": "0.0.23",
-  "docs-transforms": "0.0.23"
+  "cli": "0.0.24",
+  "docs-config": "0.0.24",
+  "docs-theme": "0.0.24",
+  "docs-transforms": "0.0.24"
 }

package/dist/app/create-program.js

@@ -1,7 +1,7 @@
 import { Command, Option } from 'commander';
 const PROGRAM_NAME = 'oat';
 const PROGRAM_DESCRIPTION = 'Open Agent Toolkit CLI for provider interoperability';
-const PROGRAM_VERSION = '0.0.18';
+const PROGRAM_VERSION = '0.0.24';
 const SCOPE_CHOICES = ['project', 'user', 'all'];
 export function createProgram() {
     return new Command()

package/dist/commands/config/dump.d.ts

@@ -0,0 +1,12 @@
+import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { type ResolvedConfig } from '../../config/resolve.js';
+import { Command } from 'commander';
+interface ConfigDumpDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveEffectiveConfig: (repoRoot: string, userConfigDir: string, env: NodeJS.ProcessEnv) => Promise<ResolvedConfig>;
+    processEnv: NodeJS.ProcessEnv;
+}
+export declare function createConfigDumpCommand(overrides?: Partial<ConfigDumpDependencies>): Command;
+export {};
+//# sourceMappingURL=dump.d.ts.map

package/dist/commands/config/dump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dump.d.ts","sourceRoot":"","sources":["../../../src/commands/config/dump.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AA2ED,wBAAgB,uBAAuB,CACrC,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAcT"}

package/dist/commands/config/dump.js

@@ -0,0 +1,76 @@
+import { join } from 'node:path';
+import { buildCommandContext, } from '../../app/command-context.js';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { resolveEffectiveConfig } from '../../config/resolve.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { Command } from 'commander';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveEffectiveConfig,
+    processEnv: process.env,
+};
+function formatConfigDump(result) {
+    const lines = [];
+    const grouped = new Map();
+    for (const [key, entry] of Object.entries(result.resolved).sort(([a], [b]) => a.localeCompare(b))) {
+        const items = grouped.get(entry.source) ?? [];
+        items.push(`${key} = ${String(entry.value)}`);
+        grouped.set(entry.source, items);
+    }
+    for (const source of ['shared', 'local', 'user', 'env', 'default']) {
+        const items = grouped.get(source);
+        if (!items || items.length === 0) {
+            continue;
+        }
+        if (lines.length > 0) {
+            lines.push('');
+        }
+        lines.push(`${source}:`);
+        for (const item of items) {
+            lines.push(`  ${item}`);
+        }
+    }
+    return lines;
+}
+async function runConfigDump(context, dependencies) {
+    try {
+        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const userConfigDir = join(context.home, '.oat');
+        const result = await dependencies.resolveEffectiveConfig(repoRoot, userConfigDir, dependencies.processEnv);
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                ...result,
+            });
+        }
+        else {
+            for (const line of formatConfigDump(result)) {
+                context.logger.info(line);
+            }
+        }
+        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 = 1;
+    }
+}
+export function createConfigDumpCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('dump')
+        .description('Dump merged OAT config with source attribution')
+        .action(async (_options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runConfigDump(context, dependencies);
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAMpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CpC,UAAU,yBAAyB;IACjC,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,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAk3BD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAiET"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAMpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6CpC,UAAU,yBAAyB;IACjC,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,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAk3BD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAwET"}

package/dist/commands/config/index.js

@@ -4,6 +4,7 @@ import { readGlobalOptions } from '../shared/shared.utils.js';
 import { readOatConfig, readOatLocalConfig, writeOatConfig, writeOatLocalConfig, } from '../../config/oat-config.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
 import { Command } from 'commander';
+import { createConfigDumpCommand } from './dump.js';
 const KEY_ORDER = [
     'activeIdea',
     'activeProject',
@@ -797,6 +798,11 @@ export function createConfigCommand(overrides = {}) {
         .action(async (_options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         await runList(context, dependencies);
+    }))
+        .addCommand(createConfigDumpCommand({
+        buildCommandContext: dependencies.buildCommandContext,
+        resolveProjectRoot: dependencies.resolveProjectRoot,
+        processEnv: dependencies.processEnv,
     }))
         .addCommand(new Command('describe')
         .description('Describe supported OAT config surfaces and keys')

package/dist/commands/docs/init/scaffold.js

@@ -71,7 +71,7 @@ const OAT_DEP_PACKAGES = [
     'docs-theme',
     'docs-transforms',
 ];
-const DEFAULT_OAT_PUBLISHED_VERSION = '0.0.18';
+const DEFAULT_OAT_PUBLISHED_VERSION = '0.0.24';
 const PUBLIC_PACKAGE_VERSIONS_FILE = 'public-package-versions.json';
 export async function detectIsOatRepo(repoRoot) {
     for (const pkg of OAT_DEP_PACKAGES) {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,oBAAoB,IAAI,OAAO,CAQ9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,oBAAoB,IAAI,OAAO,CAU9C"}

package/dist/commands/project/index.js

@@ -1,15 +1,19 @@
 import { Command } from 'commander';
 import { createProjectArchiveCommand } from './archive/index.js';
+import { createProjectListCommand } from './list.js';
 import { createProjectNewCommand } from './new/index.js';
 import { createProjectOpenCommand } from './open/index.js';
 import { createProjectPauseCommand } from './pause/index.js';
 import { createProjectSetModeCommand } from './set-mode/index.js';
+import { createProjectStatusCommand } from './status.js';
 export function createProjectCommand() {
     return new Command('project')
         .description('Manage OAT project workflows')
         .addCommand(createProjectArchiveCommand())
+        .addCommand(createProjectListCommand())
         .addCommand(createProjectNewCommand())
         .addCommand(createProjectOpenCommand())
         .addCommand(createProjectPauseCommand())
-        .addCommand(createProjectSetModeCommand());
+        .addCommand(createProjectSetModeCommand())
+        .addCommand(createProjectStatusCommand());
 }

package/dist/commands/project/list.d.ts

@@ -0,0 +1,13 @@
+import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { type ProjectSummary } from '@open-agent-toolkit/control-plane';
+import { Command } from 'commander';
+interface ProjectListDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveProjectsRoot: (repoRoot: string, env: NodeJS.ProcessEnv) => Promise<string>;
+    listProjects: (projectsRoot: string) => Promise<ProjectSummary[]>;
+    processEnv: NodeJS.ProcessEnv;
+}
+export declare function createProjectListCommand(overrides?: Partial<ProjectListDependencies>): Command;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/project/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/project/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,uBAAuB;IAC/B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAClE,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAgGD,wBAAgB,wBAAwB,CACtC,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAcT"}

package/dist/commands/project/list.js

@@ -0,0 +1,91 @@
+import { isAbsolute, join } from 'node:path';
+import { buildCommandContext, } from '../../app/command-context.js';
+import { resolveProjectsRoot } from '../shared/oat-paths.js';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { listProjects, } from '@open-agent-toolkit/control-plane';
+import { Command } from 'commander';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveProjectsRoot,
+    listProjects,
+    processEnv: process.env,
+};
+function formatProjectTable(projects) {
+    if (projects.length === 0) {
+        return ['No tracked projects found.'];
+    }
+    const rows = projects.map((project) => ({
+        name: project.name,
+        phase: `${project.phase} (${project.phaseStatus})`,
+        progress: `${project.progress.completed}/${project.progress.total}`,
+        recommendation: project.recommendation.skill,
+    }));
+    const widths = {
+        name: Math.max('NAME'.length, ...rows.map((row) => row.name.length)),
+        phase: Math.max('PHASE'.length, ...rows.map((row) => row.phase.length)),
+        progress: Math.max('PROGRESS'.length, ...rows.map((row) => row.progress.length)),
+        recommendation: Math.max('RECOMMENDATION'.length, ...rows.map((row) => row.recommendation.length)),
+    };
+    const header = [
+        'NAME'.padEnd(widths.name),
+        'PHASE'.padEnd(widths.phase),
+        'PROGRESS'.padEnd(widths.progress),
+        'RECOMMENDATION'.padEnd(widths.recommendation),
+    ].join('  ');
+    const divider = [
+        '-'.repeat(widths.name),
+        '-'.repeat(widths.phase),
+        '-'.repeat(widths.progress),
+        '-'.repeat(widths.recommendation),
+    ].join('  ');
+    const lines = rows.map((row) => [
+        row.name.padEnd(widths.name),
+        row.phase.padEnd(widths.phase),
+        row.progress.padEnd(widths.progress),
+        row.recommendation.padEnd(widths.recommendation),
+    ].join('  '));
+    return [header, divider, ...lines];
+}
+async function runProjectList(context, dependencies) {
+    try {
+        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const projectsRoot = await dependencies.resolveProjectsRoot(repoRoot, dependencies.processEnv);
+        const absoluteProjectsRoot = isAbsolute(projectsRoot)
+            ? projectsRoot
+            : join(repoRoot, projectsRoot);
+        const projects = await dependencies.listProjects(absoluteProjectsRoot);
+        if (context.json) {
+            context.logger.json({ status: 'ok', projects });
+        }
+        else {
+            for (const line of formatProjectTable(projects)) {
+                context.logger.info(line);
+            }
+        }
+        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 = 1;
+    }
+}
+export function createProjectListCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('list')
+        .description('List tracked OAT projects')
+        .action(async (_options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runProjectList(context, dependencies);
+    });
+}

package/dist/commands/project/status.d.ts

@@ -0,0 +1,13 @@
+import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { type ActiveProjectResolution } from '../../config/oat-config.js';
+import { type ProjectState } from '@open-agent-toolkit/control-plane';
+import { Command } from 'commander';
+interface ProjectStatusDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveActiveProject: (repoRoot: string) => Promise<ActiveProjectResolution>;
+    getProjectState: (projectPath: string) => Promise<ProjectState>;
+}
+export declare function createProjectStatusCommand(overrides?: Partial<ProjectStatusDependencies>): Command;
+export {};
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/project/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/project/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAC7E,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CACjE;AAmFD,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAcT"}

package/dist/commands/project/status.js

@@ -0,0 +1,91 @@
+import { join } from 'node:path';
+import { buildCommandContext, } from '../../app/command-context.js';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { resolveActiveProject, } from '../../config/oat-config.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { getProjectState, } from '@open-agent-toolkit/control-plane';
+import { Command } from 'commander';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveActiveProject,
+    getProjectState,
+};
+function formatProjectStatusLines(project) {
+    return [
+        `Project: ${project.name}`,
+        `Path: ${project.path}`,
+        `Phase: ${project.phase} (${project.phaseStatus})`,
+        `Progress: ${project.progress.completed}/${project.progress.total}`,
+        `Current task: ${project.progress.currentTaskId ?? 'none'}`,
+        `Recommendation: ${project.recommendation.skill}`,
+        `Reason: ${project.recommendation.reason}`,
+    ];
+}
+async function runProjectStatus(context, dependencies) {
+    try {
+        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const activeProject = await dependencies.resolveActiveProject(repoRoot);
+        if (activeProject.status === 'unset') {
+            const message = 'No active project set (.oat/config.local.json has no activeProject).';
+            if (context.json) {
+                context.logger.json({ status: 'unset', message });
+            }
+            else {
+                context.logger.error(message);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        if (activeProject.status === 'missing' || !activeProject.path) {
+            const message = activeProject.path
+                ? `Active project path is missing or invalid: ${activeProject.path}`
+                : 'Active project path is missing or invalid.';
+            if (context.json) {
+                context.logger.json({
+                    status: 'missing',
+                    projectName: activeProject.name,
+                    projectPath: activeProject.path,
+                    message,
+                });
+            }
+            else {
+                context.logger.error(message);
+            }
+            process.exitCode = 1;
+            return;
+        }
+        const project = await dependencies.getProjectState(join(repoRoot, activeProject.path));
+        if (context.json) {
+            context.logger.json({ status: 'ok', project });
+        }
+        else {
+            for (const line of formatProjectStatusLines(project)) {
+                context.logger.info(line);
+            }
+        }
+        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 = 1;
+    }
+}
+export function createProjectStatusCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('status')
+        .description('Show the current OAT project state')
+        .action(async (_options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runProjectStatus(context, dependencies);
+    });
+}

package/dist/config/resolve.d.ts

@@ -0,0 +1,19 @@
+import { type OatConfig, type OatLocalConfig, type UserConfig } from './oat-config.js';
+export type ResolvedConfigSource = 'shared' | 'local' | 'user' | 'env' | 'default';
+export interface ResolvedKeyEntry {
+    value: unknown;
+    source: ResolvedConfigSource;
+}
+export interface ResolvedConfig {
+    shared: OatConfig;
+    local: OatLocalConfig;
+    user: UserConfig;
+    resolved: Record<string, ResolvedKeyEntry>;
+}
+export interface ResolveEffectiveConfigDependencies {
+    readOatConfig: (repoRoot: string) => Promise<OatConfig>;
+    readOatLocalConfig: (repoRoot: string) => Promise<OatLocalConfig>;
+    readUserConfig: (userConfigDir: string) => Promise<UserConfig>;
+}
+export declare function resolveEffectiveConfig(repoRoot: string, userConfigDir: string, env?: NodeJS.ProcessEnv, overrides?: Partial<ResolveEffectiveConfigDependencies>): Promise<ResolvedConfig>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/config/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/config/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,OAAO,GACP,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CAChE;AA0CD,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,SAAS,GAAE,OAAO,CAAC,kCAAkC,CAAM,GAC1D,OAAO,CAAC,cAAc,CAAC,CAoEzB"}

package/dist/config/resolve.js

@@ -0,0 +1,128 @@
+import { readOatConfig, readOatLocalConfig, readUserConfig, } from './oat-config.js';
+const DEFAULT_DEPENDENCIES = {
+    readOatConfig,
+    readOatLocalConfig,
+    readUserConfig,
+};
+const DEFAULT_SHARED_CONFIG = {
+    projects: { root: '.oat/projects/shared' },
+    worktrees: { root: '.worktrees' },
+    git: { defaultBranch: 'main' },
+    archive: {
+        s3Uri: null,
+        s3SyncOnComplete: false,
+        summaryExportPath: null,
+    },
+    documentation: {
+        root: null,
+        tooling: null,
+        config: null,
+        index: null,
+        requireForProjectCompletion: false,
+    },
+    autoReviewAtCheckpoints: false,
+};
+const DEFAULT_LOCAL_CONFIG = {
+    activeProject: null,
+    lastPausedProject: null,
+    activeIdea: null,
+};
+const DEFAULT_USER_CONFIG = {
+    activeIdea: null,
+};
+const ENV_OVERRIDE_MAP = {
+    'projects.root': 'OAT_PROJECTS_ROOT',
+    'worktrees.root': 'OAT_WORKTREES_ROOT',
+};
+export async function resolveEffectiveConfig(repoRoot, userConfigDir, env = process.env, overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    const [shared, local, user] = await Promise.all([
+        dependencies.readOatConfig(repoRoot),
+        dependencies.readOatLocalConfig(repoRoot),
+        dependencies.readUserConfig(userConfigDir),
+    ]);
+    const sharedValues = flattenConfig(shared);
+    const localValues = flattenConfig(local);
+    const userValues = flattenConfig(user);
+    const defaultValues = {
+        ...flattenConfig(DEFAULT_SHARED_CONFIG),
+        ...flattenConfig(DEFAULT_LOCAL_CONFIG),
+        ...flattenConfig(DEFAULT_USER_CONFIG),
+    };
+    const keys = new Set([
+        ...Object.keys(defaultValues),
+        ...Object.keys(sharedValues),
+        ...Object.keys(localValues),
+        ...Object.keys(userValues),
+    ]);
+    const resolved = {};
+    for (const key of [...keys].sort()) {
+        const envValue = resolveEnvOverride(key, env);
+        if (envValue !== undefined) {
+            resolved[key] = { value: envValue, source: 'env' };
+            continue;
+        }
+        const localValue = localValues[key];
+        if (isResolvedValue(localValue)) {
+            resolved[key] = { value: localValue, source: 'local' };
+            continue;
+        }
+        const sharedValue = sharedValues[key];
+        if (isResolvedValue(sharedValue)) {
+            resolved[key] = { value: sharedValue, source: 'shared' };
+            continue;
+        }
+        const userValue = userValues[key];
+        if (isResolvedValue(userValue)) {
+            resolved[key] = { value: userValue, source: 'user' };
+            continue;
+        }
+        if (key in defaultValues) {
+            resolved[key] = {
+                value: defaultValues[key] ?? null,
+                source: 'default',
+            };
+        }
+    }
+    return {
+        shared,
+        local,
+        user,
+        resolved,
+    };
+}
+function flattenConfig(value, prefix = '') {
+    if (!isRecord(value)) {
+        return {};
+    }
+    const flattened = {};
+    for (const [key, nestedValue] of Object.entries(value)) {
+        if (key === 'version') {
+            continue;
+        }
+        const nextKey = prefix ? `${prefix}.${key}` : key;
+        if (isRecord(nestedValue)) {
+            Object.assign(flattened, flattenConfig(nestedValue, nextKey));
+            continue;
+        }
+        flattened[nextKey] = nestedValue;
+    }
+    return flattened;
+}
+function resolveEnvOverride(key, env) {
+    const envKey = ENV_OVERRIDE_MAP[key];
+    if (!envKey) {
+        return undefined;
+    }
+    const value = env[envKey]?.trim();
+    return value ? value.replace(/\/+$/, '') : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isResolvedValue(value) {
+    return value !== undefined && value !== null;
+}

package/dist/manifest/manager.js

@@ -3,7 +3,7 @@ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
 import { dirname } from 'node:path';
 import { CliError } from '../errors/index.js';
 import { ManifestSchema, } from './manifest.types.js';
-const OAT_VERSION = '0.0.18';
+const OAT_VERSION = '0.0.24';
 function formatIssuePath(path) {
     if (path.length === 0) {
         return '(root)';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.0.23",
+  "version": "0.0.24",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -32,7 +32,8 @@
     "commander": "^12.1.0",
     "ora": "^9.0.0",
     "yaml": "2.8.2",
-    "zod": "^3.25.76"
+    "zod": "^3.25.76",
+    "@open-agent-toolkit/control-plane": "0.0.1"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",