@open-agent-toolkit/cli 0.2.36 → 0.2.38

package/dist/commands/status/index.js

@@ -1,15 +1,20 @@
 import { basename, join, relative } from 'node:path';
 import { buildCommandContext, } from '../../app/command-context.js';
+import { resolvePjmAdoption, } from '../pjm/adoption.js';
 import { adoptStrayToCanonical, isAdoptionConflictError, isAdoptionSourceUnavailableError, } from '../shared/adopt-stray.js';
 import { detectCodexRoleStrays, filterMaterializationManagedStrays, regenerateCodexAfterAdoption, } from '../shared/codex-strays.js';
 import { applyNativeSkillDisposition, getNativeSkillProviderDetails, isNativeSkillCandidate, } from '../shared/native-skill-disposition.js';
 import { withScopeOption } from '../shared/scope-option.js';
 import { confirmAction, selectManyWithAbort, selectWithAbort, } from '../shared/shared.prompts.js';
 import { readGlobalOptions, resolveConcreteScopes, } from '../shared/shared.utils.js';
+import { hasScopedPackPlacementEvidence, inventoryPack, } from '../tools/shared/pack-inventory.js';
+import { PACK_NAMES } from '../tools/shared/pack-manifest.js';
+import { formatPackPath, formatPackPaths, updatePackRecovery, } from '../tools/shared/pack-paths.js';
 import { DEFAULT_SYNC_CONFIG, loadSyncConfig, } from '../../config/index.js';
 import { resolveUserSyncConfig } from '../../config/user-sync-config.js';
 import { detectDrift, detectStrays, filterKnownStrays, } from '../../drift/index.js';
 import { HOOK_DRIFT_WARNING, HOOK_STRAY_INFO, scanBundledManagedAgents, scanCanonical, } from '../../engine/index.js';
+import { resolveAssetsRoot } from '../../fs/assets.js';
 import { normalizeToPosixPath, resolveProjectRoot, resolveScopeRoot, } from '../../fs/paths.js';
 import { loadManifest, saveManifest } from '../../manifest/manager.js';
 import { claudeAdapter } from '../../providers/claude/index.js';
@@ -66,6 +71,9 @@ const DEFAULT_DEPENDENCIES = {
     adoptStray: adoptStrayDefault,
     applyNativeSkillDisposition,
     formatStatusTable,
+    resolveAssetsRoot,
+    inventoryPack,
+    resolvePjmAdoption,
 };
 function entryInsideMapping(entryProviderPath, mappingProviderDir) {
     const normalizedEntryPath = normalizeToPosixPath(entryProviderPath);
@@ -125,6 +133,177 @@ function formatPathForScope(scope, providerPath) {
 function formatStrayChoiceLabel(scope, providerPath, provider) {
     return `[${scope}] ${basename(providerPath)} (${provider})`;
 }
+function packDiagnosticRecovery(pack, diagnostic, scope) {
+    if (diagnostic.code === 'duplicate-scope') {
+        return `oat tools migrate --pack ${pack} --from project --to user`;
+    }
+    if (diagnostic.code === 'legacy-false-conflict' && scope) {
+        return updatePackRecovery(pack, scope);
+    }
+    return null;
+}
+function toStatusPackDiagnostic(pack, diagnostic, scope, roots) {
+    return {
+        code: diagnostic.code,
+        message: diagnostic.message,
+        paths: diagnostic.paths.map((path) => formatPackPath(path, roots)),
+        recovery: packDiagnosticRecovery(pack, diagnostic, scope),
+    };
+}
+function toStatusPackScopeState(pack, scoped, roots) {
+    const { scope } = scoped;
+    const missing = scoped.assets.filter((asset) => asset.definition.ownership[scope] === 'managed' &&
+        asset.status === 'missing');
+    const stale = scoped.assets.filter(({ status }) => status === 'outdated');
+    const newer = scoped.assets.filter(({ status }) => status === 'newer');
+    const retainedOverrides = scoped.assets.filter((asset) => asset.definition.ownership[scope] === 'seed-if-missing' &&
+        asset.status === 'present');
+    const needsRepair = scoped.completeness !== 'complete' || stale.length > 0;
+    return {
+        scope,
+        intent: scoped.intent.source,
+        completeness: scoped.completeness,
+        stale: stale.length,
+        newer: newer.length,
+        retainedOverrides: retainedOverrides.length,
+        missing: missing.map(({ path }) => formatPackPath(path, roots)),
+        diagnostics: scoped.diagnostics.map((diagnostic) => toStatusPackDiagnostic(pack, diagnostic, scope, roots)),
+        recovery: needsRepair ? updatePackRecovery(pack, scope) : null,
+    };
+}
+/**
+ * Only scope-level diagnostics carry a known scope. Pack-level diagnostics
+ * (cross-scope duplication, shared-owner observations) are reported once on
+ * the pack itself so no diagnostic is silently dropped or double counted.
+ */
+function collectPackLevelDiagnostics(inventory, roots) {
+    const scopedMessages = new Set(inventory.scopes.flatMap(({ diagnostics }) => diagnostics.map(({ message }) => message)));
+    return inventory.diagnostics
+        .filter(({ message }) => !scopedMessages.has(message))
+        .map((diagnostic) => toStatusPackDiagnostic(inventory.pack, diagnostic, null, roots));
+}
+function toStatusPackState(inventory, roots) {
+    const scopes = inventory.scopes.filter(hasScopedPackPlacementEvidence);
+    const diagnostics = collectPackLevelDiagnostics(inventory, roots);
+    if (scopes.length === 0 && diagnostics.length === 0) {
+        return null;
+    }
+    return {
+        pack: inventory.pack,
+        placement: inventory.placement,
+        scopes: scopes.map((scoped) => toStatusPackScopeState(inventory.pack, scoped, roots)),
+        diagnostics,
+    };
+}
+/**
+ * Repository PJM adoption is only actionable when this repository shows PJM
+ * intent. User-scope PJM capability is now the default, so an unadopted
+ * repository with no project-scope PJM evidence is normal and stays silent.
+ */
+function shouldReportPjmAdoption(adoption, states) {
+    if (adoption.state === 'partial-initialization') {
+        return true;
+    }
+    if (adoption.state !== 'none') {
+        return false;
+    }
+    const pjm = states.find(({ pack }) => pack === 'project-management');
+    return (pjm?.scopes ?? []).some(({ scope }) => scope === 'project');
+}
+async function collectPackReport(scopeRoots, unavailableScopes, dependencies) {
+    const roots = {
+        ...(scopeRoots.has('project')
+            ? { projectRoot: scopeRoots.get('project') }
+            : {}),
+        ...(scopeRoots.has('user') ? { userRoot: scopeRoots.get('user') } : {}),
+    };
+    if (scopeRoots.size === 0) {
+        return { states: [], unavailableScopes, pjm: null };
+    }
+    const assetsRoot = await dependencies.resolveAssetsRoot();
+    const inventories = await Promise.all(PACK_NAMES.map((pack) => dependencies.inventoryPack({ pack, assetsRoot, ...roots })));
+    const states = inventories
+        .map((inventory) => toStatusPackState(inventory, roots))
+        .filter((state) => state !== null);
+    const projectRoot = scopeRoots.get('project');
+    if (!projectRoot) {
+        return { states, unavailableScopes, pjm: null };
+    }
+    const adoption = await dependencies.resolvePjmAdoption({
+        projectRoot,
+        repoRoot: join(projectRoot, '.oat', 'repo'),
+    });
+    return {
+        states,
+        unavailableScopes,
+        pjm: {
+            state: adoption.state,
+            // Every other path in this payload is redacted through `formatPackPath`;
+            // the PJM repo root follows the same contract rather than emitting a raw
+            // absolute path.
+            repoRoot: formatPackPath(adoption.repoRoot, roots),
+            recovery: adoption.recovery,
+        },
+    };
+}
+function describePackScope(state) {
+    const details = [state.completeness];
+    if (state.missing.length > 0) {
+        details.push(`${state.missing.length} missing`);
+    }
+    if (state.stale > 0)
+        details.push(`${state.stale} stale`);
+    if (state.newer > 0)
+        details.push(`${state.newer} newer`);
+    if (state.retainedOverrides > 0) {
+        details.push(`${state.retainedOverrides} retained override(s)`);
+    }
+    return `${state.scope} (${details.join(', ')})`;
+}
+function formatPackReport(report) {
+    const lines = [];
+    if (report.states.length > 0) {
+        lines.push('Pack state:');
+        for (const state of report.states) {
+            const scopeSummary = state.scopes.length > 0
+                ? state.scopes.map(describePackScope).join(', ')
+                : 'no installed scope';
+            lines.push(`  ${state.pack}: ${scopeSummary}`);
+            for (const scope of state.scopes) {
+                if (scope.missing.length > 0) {
+                    lines.push(`    Missing: ${formatPackPaths(scope.missing, {})}`);
+                }
+                for (const diagnostic of scope.diagnostics) {
+                    lines.push(`    ${diagnostic.code}: ${diagnostic.message}`);
+                    if (diagnostic.recovery) {
+                        lines.push(`    Fix: ${diagnostic.recovery}`);
+                    }
+                }
+                if (scope.recovery) {
+                    lines.push(`    Fix: ${scope.recovery}`);
+                }
+            }
+            for (const diagnostic of state.diagnostics) {
+                lines.push(`    ${diagnostic.code}: ${diagnostic.message}`);
+                if (diagnostic.recovery) {
+                    lines.push(`    Fix: ${diagnostic.recovery}`);
+                }
+            }
+        }
+    }
+    for (const scope of report.unavailableScopes) {
+        lines.push(`${scope} scope is unavailable here; pack state is reported for the remaining scope(s).`);
+    }
+    if (report.pjm && shouldReportPjmAdoption(report.pjm, report.states)) {
+        lines.push(report.pjm.state === 'partial-initialization'
+            ? 'PJM: this repository has a partial PJM scaffold and has not adopted PJM.'
+            : 'PJM: this repository has not adopted PJM.');
+        if (report.pjm.recovery) {
+            lines.push(`  Fix: ${report.pjm.recovery}`);
+        }
+    }
+    return lines.length > 0 ? lines.join('\n') : null;
+}
 async function collectScopeReports(scope, context, dependencies) {
     const scopeRoot = await dependencies.resolveScopeRoot(scope, context);
     const manifestPath = join(scopeRoot, '.oat', 'sync', 'manifest.json');
@@ -310,10 +489,26 @@ async function collectScopeReports(scope, context, dependencies) {
 async function runStatusCommand(context, dependencies, options = {}) {
     const reports = [];
     const scopeCollections = [];
-    for (const scope of resolveConcreteScopes(context.scope)) {
-        const scopeReportCollection = await collectScopeReports(scope, context, dependencies);
+    const scopes = resolveConcreteScopes(context.scope);
+    const scopeRoots = new Map();
+    const unavailableScopes = [];
+    for (const scope of scopes) {
+        let scopeReportCollection;
+        try {
+            scopeReportCollection = await collectScopeReports(scope, context, dependencies);
+        }
+        catch (error) {
+            // `--scope all` outside a Git repository still reports user scope; an
+            // explicitly requested scope stays a hard failure.
+            if (scope === 'project' && scopes.includes('user')) {
+                unavailableScopes.push(scope);
+                continue;
+            }
+            throw error;
+        }
         reports.push(...scopeReportCollection.reports);
         scopeCollections.push(scopeReportCollection);
+        scopeRoots.set(scope, scopeReportCollection.scopeRoot);
     }
     const summary = summarizeReports(reports);
     const hasIssues = summary.total > 0 && summary.inSync !== summary.total;
@@ -331,11 +526,13 @@ async function runStatusCommand(context, dependencies, options = {}) {
         }
         return;
     }
+    const packReport = await collectPackReport(scopeRoots, unavailableScopes, dependencies);
     if (context.json) {
         const payload = {
             scope: context.scope,
             reports,
             summary,
+            packs: packReport,
         };
         if (!context.interactive && summary.stray > 0) {
             payload.remediation = DEFAULT_REMEDIATION;
@@ -344,6 +541,10 @@ async function runStatusCommand(context, dependencies, options = {}) {
     }
     else {
         context.logger.info(dependencies.formatStatusTable(reports));
+        const packSummary = formatPackReport(packReport);
+        if (packSummary) {
+            context.logger.info(packSummary);
+        }
     }
     if (summary.stray > 0) {
         if (context.interactive) {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AA2CA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EAEV,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AA4XtB,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CA6BT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/index.ts"],"names":[],"mappings":"AA2CA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,OAAO,KAAK,EAGV,uBAAuB,EAGxB,MAAM,cAAc,CAAC;AAoZtB,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAuDT"}

package/dist/commands/sync/index.js

@@ -1,4 +1,4 @@
-import { join } from 'node:path';
+import { join, relative } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
 import { PROVIDER_CONFIG_REMEDIATION } from '../shared/messages.js';
 import { withScopeOption } from '../shared/scope-option.js';
@@ -76,6 +76,16 @@ function validateInstallCanonicalPaths(paths) {
     }
     return paths;
 }
+function validateRemoveCanonicalPaths(paths) {
+    if (!paths?.length)
+        return undefined;
+    for (const path of paths) {
+        if (!INSTALL_CANONICAL_PATH_PATTERN.test(path)) {
+            throw new CliError(`Invalid --remove-canonical path: ${path}`, 1);
+        }
+    }
+    return paths;
+}
 function hasProviderMismatches(mismatches) {
     return (mismatches.detectedUnset.length > 0 ||
         mismatches.detectedDisabled.length > 0);
@@ -172,7 +182,7 @@ function detectVersionSkew(scope, manifest) {
     }
     return { scope, producingVersion, invokingVersion };
 }
-async function computePlans(context, dependencies, allowedCanonicalPaths) {
+async function computePlans(context, dependencies, canonicalFilter) {
     const scopePlans = [];
     for (const scope of resolveConcreteScopes(context.scope)) {
         const scopeRoot = await dependencies.resolveScopeRoot(scope, context);
@@ -183,6 +193,13 @@ async function computePlans(context, dependencies, allowedCanonicalPaths) {
             dependencies.loadSyncConfig(configPath),
             dependencies.scanCanonical(scopeRoot, scope),
         ]);
+        if (canonicalFilter?.mode === 'remove') {
+            const existing = new Set(canonical.map(({ canonicalPath }) => relative(scopeRoot, canonicalPath).replaceAll('\\', '/')));
+            const stillPresent = canonicalFilter.paths.filter((path) => existing.has(path));
+            if (stillPresent.length > 0) {
+                throw new CliError(`Cannot remove canonical provider views while source exists: ${stillPresent.join(', ')}`, 1);
+            }
+        }
         const adapters = dependencies.getAdapters();
         const initialResolution = await dependencies.getConfigAwareAdapters(adapters, scopeRoot, config);
         const resolved = await maybeResolveProviderMismatches(context, scope, scopeRoot, configPath, config, adapters, {
@@ -196,7 +213,7 @@ async function computePlans(context, dependencies, allowedCanonicalPaths) {
             scope,
             config: resolved.config,
             scopeRoot,
-            allowedCanonicalPaths,
+            allowedCanonicalPaths: canonicalFilter?.paths,
         });
         const activeAdapterNames = resolved.activeAdapters.map((adapter) => adapter.name);
         const enabledExtensions = dependencies
@@ -208,7 +225,7 @@ async function computePlans(context, dependencies, allowedCanonicalPaths) {
         const materializationExtensionPlans = await Promise.all(enabledExtensions.map((extension) => extension.computePlan({
             scopeRoot,
             canonicalEntries: extensionCanonical,
-            allowedCanonicalPaths,
+            allowedCanonicalPaths: canonicalFilter?.paths,
             options: { userConfigDir: join(context.home, '.oat') },
         })));
         const materializationExtensions = materializationExtensionPlans.map((extensionPlan) => ({
@@ -270,8 +287,8 @@ function logVersionSkewWarnings(context, scopePlans) {
         context.logger.warn(`Sync manifest version skew [${skew.scope}]: manifest produced by oat "${skew.producingVersion}" but invoked by oat "${skew.invokingVersion}".`);
     }
 }
-async function runSyncCommand(context, dependencies, allowedCanonicalPaths) {
-    const scopePlans = await computePlans(context, dependencies, allowedCanonicalPaths);
+async function runSyncCommand(context, dependencies, canonicalFilter) {
+    const scopePlans = await computePlans(context, dependencies, canonicalFilter);
     logNonInteractiveMismatchGuidance(context, scopePlans);
     logVersionSkewWarnings(context, scopePlans);
     if (context.dryRun) {
@@ -294,10 +311,26 @@ export function createSyncCommand(overrides = {}) {
         .argParser((value, previous) => [
         ...(previous ?? []),
         value,
+    ]))
+        .addOption(new Option('--remove-canonical <path>', 'Internal removal sync filter')
+        .hideHelp()
+        .default([])
+        .argParser((value, previous) => [
+        ...(previous ?? []),
+        value,
     ]))
         .action(async (_options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         const options = command.opts();
-        await runSyncCommand(context, dependencies, validateInstallCanonicalPaths(options.installCanonical));
+        const installPaths = validateInstallCanonicalPaths(options.installCanonical);
+        const removePaths = validateRemoveCanonicalPaths(options.removeCanonical);
+        if (installPaths?.length && removePaths?.length) {
+            throw new CliError('--install-canonical and --remove-canonical cannot be combined', 1);
+        }
+        await runSyncCommand(context, dependencies, installPaths?.length
+            ? { mode: 'install', paths: installPaths }
+            : removePaths?.length
+                ? { mode: 'remove', paths: removePaths }
+                : undefined);
     });
 }

package/dist/commands/sync/sync.types.d.ts

@@ -9,6 +9,10 @@ export interface SyncProviderMismatches {
     detectedUnset: string[];
     detectedDisabled: string[];
 }
+export interface CanonicalSyncFilter {
+    mode: 'install' | 'remove';
+    paths: string[];
+}
 /**
  * Advisory diagnostic emitted when the CLI version that produced a scope's sync
  * manifest differs from the CLI version invoking sync. Comparison is symmetric

package/dist/commands/sync/sync.types.d.ts.map

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

package/dist/commands/tools/has/has-pack.d.ts

@@ -1,18 +1,27 @@
 import type { CommandContext } from '../../../app/command-context.js';
+import { type InventoryScopedPackInput, type ScopedPackInventory } from '../../tools/shared/pack-inventory.js';
+import { isPackName, PACK_NAMES } from '../../tools/shared/pack-manifest.js';
 import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
 import type { PackName, ToolInfo } from '../../tools/shared/types.js';
 import type { ConcreteScope } from '../../../shared/types.js';
-export declare const PACK_NAMES: readonly ["core", "ideas", "docs", "workflows", "utility", "project-management", "research", "brainstorm"];
+export { isPackName, PACK_NAMES };
 export interface PackAvailability {
     pack: PackName;
     available: boolean;
     scopes: ConcreteScope[];
+    unavailableScopes: ConcreteScope[];
+    completeness: Partial<Record<ConcreteScope, ScopedPackInventory['completeness']>>;
+    missing: Array<{
+        scope: ConcreteScope;
+        asset: string;
+        path: string;
+    }>;
 }
 export interface PackAvailabilityDependencies {
     scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
     resolveScopeRoot: (scope: ConcreteScope, cwd: string, home: string) => Promise<string>;
     resolveAssetsRoot: () => Promise<string>;
+    inventoryScopedPack?: (input: InventoryScopedPackInput) => Promise<ScopedPackInventory>;
 }
-export declare function isPackName(value: string): value is PackName;
 export declare function resolvePackAvailability(pack: PackName, scopes: ConcreteScope[], context: CommandContext, dependencies: PackAvailabilityDependencies): Promise<PackAvailability>;
 //# sourceMappingURL=has-pack.d.ts.map

package/dist/commands/tools/has/has-pack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"has-pack.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/has/has-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,eAAO,MAAM,UAAU,4GASiB,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,4BAA4B,GACzC,OAAO,CAAC,gBAAgB,CAAC,CAyB3B"}
+{"version":3,"file":"has-pack.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/has/has-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACzB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAEL,UAAU,EACV,UAAU,EACX,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;AAElC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,YAAY,EAAE,OAAO,CACnB,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,cAAc,CAAC,CAAC,CAC3D,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,mBAAmB,CAAC,EAAE,CACpB,KAAK,EAAE,wBAAwB,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AAED,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,4BAA4B,GACzC,OAAO,CAAC,gBAAgB,CAAC,CAqD3B"}

package/dist/commands/tools/has/has-pack.js

@@ -1,27 +1,37 @@
-export const PACK_NAMES = [
-    'core',
-    'ideas',
-    'docs',
-    'workflows',
-    'utility',
-    'project-management',
-    'research',
-    'brainstorm',
-];
-export function isPackName(value) {
-    return PACK_NAMES.includes(value);
-}
+import { inventoryScopedPack, } from '../../tools/shared/pack-inventory.js';
+import { getPackDefinition, isPackName, PACK_NAMES, } from '../../tools/shared/pack-manifest.js';
+export { isPackName, PACK_NAMES };
 export async function resolvePackAvailability(pack, scopes, context, dependencies) {
     const assetsRoot = await dependencies.resolveAssetsRoot();
     const matchingScopes = [];
+    const completeness = {};
+    const missing = [];
+    const allowedScopes = new Set(getPackDefinition(pack).allowedScopes);
+    const unavailableScopes = scopes.filter((scope) => !allowedScopes.has(scope));
     for (const scope of scopes) {
-        const scopeRoot = await dependencies.resolveScopeRoot(scope, context.cwd, context.home);
-        const tools = await dependencies.scanTools({
-            scope,
-            scopeRoot,
-            assetsRoot,
-        });
-        if (tools.some((tool) => tool.pack === pack)) {
+        if (!allowedScopes.has(scope))
+            continue;
+        let scopeRoot;
+        try {
+            scopeRoot = await dependencies.resolveScopeRoot(scope, context.cwd, context.home);
+        }
+        catch (error) {
+            // `has` is an availability probe, and user scope is now the default
+            // install target, so a query that spans both scopes still has a complete
+            // answer outside a Git repository. An explicitly requested project scope
+            // stays a hard failure.
+            if (scope === 'project' && scopes.includes('user')) {
+                unavailableScopes.push(scope);
+                continue;
+            }
+            throw error;
+        }
+        const inventory = await (dependencies.inventoryScopedPack ?? inventoryScopedPack)({ pack, scope, scopeRoot, assetsRoot });
+        completeness[scope] = inventory.completeness;
+        missing.push(...inventory.assets
+            .filter(({ definition, status }) => definition.ownership[scope] === 'managed' && status === 'missing')
+            .map(({ definition, path }) => ({ scope, asset: definition.id, path })));
+        if (inventory.completeness === 'complete') {
             matchingScopes.push(scope);
         }
     }
@@ -29,5 +39,8 @@ export async function resolvePackAvailability(pack, scopes, context, dependencie
         pack,
         available: matchingScopes.length > 0,
         scopes: matchingScopes,
+        unavailableScopes,
+        completeness,
+        missing,
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,kBAAkB,IAAI,OAAO,CAc5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,kBAAkB,IAAI,OAAO,CAe5C"}

package/dist/commands/tools/index.js

@@ -3,16 +3,18 @@ import { createToolsHasCommand } from './has/index.js';
 import { createToolsInfoCommand } from './info/index.js';
 import { createToolsInstallCommand } from './install/index.js';
 import { createToolsListCommand } from './list/index.js';
+import { createToolsMigrateCommand } from './migrate/index.js';
 import { createToolsOutdatedCommand } from './outdated/index.js';
 import { createToolsRemoveCommand } from './remove/index.js';
 import { createToolsUpdateCommand } from './update/index.js';
 export function createToolsCommand() {
-    const cmd = new Command('tools').description('Manage OAT tool packs (install, update, remove, list)');
+    const cmd = new Command('tools').description('Manage OAT tool packs (install, update, migrate, remove, list)');
     cmd.addCommand(createToolsListCommand());
     cmd.addCommand(createToolsOutdatedCommand());
     cmd.addCommand(createToolsInfoCommand());
     cmd.addCommand(createToolsHasCommand());
     cmd.addCommand(createToolsUpdateCommand());
+    cmd.addCommand(createToolsMigrateCommand());
     cmd.addCommand(createToolsRemoveCommand());
     cmd.addCommand(createToolsInstallCommand());
     return cmd;

package/dist/commands/tools/info/info-tool.d.ts

@@ -1,4 +1,5 @@
 import type { CommandContext } from '../../../app/command-context.js';
+import { type InventoryPackInput, type PackInventory } from '../../tools/shared/pack-inventory.js';
 import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
 import type { ToolInfo } from '../../tools/shared/types.js';
 export interface ToolDetail extends ToolInfo {
@@ -12,10 +13,12 @@ export interface InfoToolDependencies {
     resolveScopeRoot: (scope: 'project' | 'user', cwd: string, home: string) => Promise<string>;
     resolveAssetsRoot: () => Promise<string>;
     getToolDetail: (tool: ToolInfo, scopeRoot: string) => Promise<Omit<ToolDetail, keyof ToolInfo>>;
+    inventoryPack?: (input: InventoryPackInput) => Promise<PackInventory>;
 }
 export interface InfoToolResult {
     found: boolean;
     tool: ToolDetail | null;
+    pack: PackInventory | null;
 }
 export declare function runInfoTool(context: CommandContext, name: string, dependencies: InfoToolDependencies): Promise<InfoToolResult>;
 //# sourceMappingURL=info-tool.d.ts.map

package/dist/commands/tools/info/info-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"info-tool.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/info-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CACb,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC,cAAc,CAAC,CA6DzB"}
+{"version":3,"file":"info-tool.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/info-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CACb,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC,cAAc,CAAC,CAmFzB"}

package/dist/commands/tools/info/info-tool.js

@@ -1,10 +1,35 @@
 import { resolveConcreteScopes } from '../../shared/shared.utils.js';
+import { formatPackInventoryDetails } from '../../tools/shared/format-pack-inventory.js';
+import { inventoryPack, } from '../../tools/shared/pack-inventory.js';
+import { PACK_MANIFEST } from '../../tools/shared/pack-manifest.js';
 export async function runInfoTool(context, name, dependencies) {
     const { logger } = context;
     const scopes = resolveConcreteScopes(context.scope);
     const assetsRoot = await dependencies.resolveAssetsRoot();
+    const roots = {};
     for (const scope of scopes) {
-        const scopeRoot = await dependencies.resolveScopeRoot(scope, context.cwd, context.home);
+        roots[scope] = await dependencies.resolveScopeRoot(scope, context.cwd, context.home);
+    }
+    const packName = PACK_MANIFEST.find(({ name: candidate }) => candidate === name)?.name;
+    if (packName) {
+        const pack = await (dependencies.inventoryPack ?? inventoryPack)({
+            pack: packName,
+            assetsRoot,
+            projectRoot: roots.project,
+            userRoot: roots.user,
+        });
+        if (context.json)
+            logger.json({ tool: null, pack });
+        else {
+            logger.info(`${pack.pack}`);
+            logger.info(`  Placement:   ${pack.placement}`);
+            for (const line of formatPackInventoryDetails(pack))
+                logger.info(line);
+        }
+        return { found: true, tool: null, pack };
+    }
+    for (const scope of scopes) {
+        const scopeRoot = roots[scope];
         const tools = await dependencies.scanTools({
             scope,
             scopeRoot,
@@ -17,7 +42,7 @@ export async function runInfoTool(context, name, dependencies) {
         const toolDetail = { ...match, ...detail };
         if (context.json) {
             logger.json({ tool: toolDetail });
-            return { found: true, tool: toolDetail };
+            return { found: true, tool: toolDetail, pack: null };
         }
         logger.info(`${toolDetail.name}`);
         logger.info(`  Type:        ${toolDetail.type}`);
@@ -40,7 +65,7 @@ export async function runInfoTool(context, name, dependencies) {
         if (toolDetail.status === 'outdated') {
             logger.warn(`  Update available: ${toolDetail.version ?? '?'} -> ${toolDetail.bundledVersion ?? '?'}`);
         }
-        return { found: true, tool: toolDetail };
+        return { found: true, tool: toolDetail, pack: null };
     }
     if (context.json) {
         logger.json({ tool: null, error: `Tool '${name}' not found` });
@@ -48,5 +73,5 @@ export async function runInfoTool(context, name, dependencies) {
     else {
         logger.error(`Tool '${name}' not found.`);
     }
-    return { found: false, tool: null };
+    return { found: false, tool: null, pack: null };
 }

package/dist/commands/tools/list/list-tools.d.ts

@@ -1,13 +1,16 @@
 import type { CommandContext } from '../../../app/command-context.js';
+import { type InventoryPackInput, type PackInventory } from '../../tools/shared/pack-inventory.js';
 import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
 import type { ToolInfo } from '../../tools/shared/types.js';
 export interface ListToolsDependencies {
     scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
     resolveScopeRoot: (scope: 'project' | 'user', cwd: string, home: string) => Promise<string>;
     resolveAssetsRoot: () => Promise<string>;
+    inventoryPack?: (input: InventoryPackInput) => Promise<PackInventory>;
 }
 export interface ListToolsResult {
     tools: ToolInfo[];
+    packs: PackInventory[];
 }
 export declare function runListTools(context: CommandContext, dependencies: ListToolsDependencies): Promise<ListToolsResult>;
 //# sourceMappingURL=list-tools.d.ts.map

package/dist/commands/tools/list/list-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/list/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,qBAAqB,GAClC,OAAO,CAAC,eAAe,CAAC,CAiE1B"}
+{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/list/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,qBAAqB,GAClC,OAAO,CAAC,eAAe,CAAC,CAiG1B"}