@open-agent-toolkit/cli 0.2.50 → 0.2.52

package/dist/commands/tools/shared/pack-evidence.d.ts

@@ -0,0 +1,66 @@
+import type { ConcreteScope } from '../../../shared/types.js';
+import type { PackInventory, ScopedPackInventory } from './pack-inventory.js';
+import type { PackCompleteness, PackName } from './types.js';
+export type ScopeRealization = 'present' | 'absent' | 'unknown';
+export type RealizedPackPlacement = 'project' | 'user' | 'both' | 'none' | 'unknown';
+export type PackHealth = 'absent' | 'current' | 'drifted' | 'newer' | 'mixed' | 'unknown';
+export interface PackScopeFacts {
+    scope: ConcreteScope;
+    intent: ScopedPackInventory['intent'];
+    inventory: {
+        state: 'available' | 'unavailable';
+        source: 'pack-inventory';
+        reason?: string;
+    };
+    completeness: PackCompleteness | 'unknown';
+    health: PackHealth;
+    realization: ScopeRealization;
+}
+export interface RecoveryAction {
+    code: string;
+    command?: string;
+    message: string;
+}
+export interface PackEvidenceDiagnostic {
+    code: 'inventory-unavailable' | 'declared-only' | 'partial-placement' | 'duplicate-placement' | 'provider-inactive' | 'provider-unsupported' | 'provider-materialization-missing' | 'provider-materialization-failed' | 'visibility-unknown' | 'refresh-required' | 'restart-required';
+    severity: 'info' | 'warning' | 'error';
+    pack: PackName;
+    scope?: ConcreteScope;
+    provider?: string;
+    contentKind?: 'skill' | 'agent' | 'rule' | 'directory';
+    affectedAssets: readonly string[];
+    source: string;
+    detail: string;
+    recovery: readonly RecoveryAction[];
+}
+export interface ProviderReachabilityEvidence {
+    provider: string;
+    scope: ConcreteScope;
+    contentKind: 'skill' | 'agent' | 'rule' | 'directory';
+    assets: readonly string[];
+    [key: string]: unknown;
+}
+export interface ToolPackEvidence {
+    schemaVersion: 1;
+    pack: PackName;
+    canonical: PackInventory | null;
+    scopes: readonly PackScopeFacts[];
+    knownRealizedScopes: readonly ConcreteScope[];
+    unknownScopes: readonly ConcreteScope[];
+    realizedPlacement: RealizedPackPlacement;
+    providers: readonly ProviderReachabilityEvidence[];
+    diagnostics: readonly PackEvidenceDiagnostic[];
+}
+export declare function packScopeFactsFromInventory(inventory: ScopedPackInventory): PackScopeFacts;
+export declare function unavailablePackScopeFacts(input: {
+    scope: ConcreteScope;
+    intent: ScopedPackInventory['intent'];
+    reason: string;
+}): PackScopeFacts;
+export declare function hasScopedPackRealizationEvidence(inventory: ScopedPackInventory): boolean;
+export declare function projectPackEvidence(input: {
+    canonical: PackInventory | null;
+    scopes: readonly PackScopeFacts[];
+    providers?: readonly ProviderReachabilityEvidence[];
+}): ToolPackEvidence;
+//# sourceMappingURL=pack-evidence.d.ts.map

package/dist/commands/tools/shared/pack-evidence.d.ts.map

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

package/dist/commands/tools/shared/pack-evidence.js

@@ -0,0 +1,132 @@
+function healthForStatuses(statuses) {
+    const present = statuses.filter((status) => status !== 'missing');
+    if (present.length === 0)
+        return 'absent';
+    const states = new Set(present);
+    if (states.size === 1 && states.has('current'))
+        return 'current';
+    if (states.size === 1 && states.has('newer'))
+        return 'newer';
+    if (states.has('outdated'))
+        return states.size === 1 ? 'drifted' : 'mixed';
+    return states.size === 1 ? 'current' : 'mixed';
+}
+export function packScopeFactsFromInventory(inventory) {
+    return {
+        scope: inventory.scope,
+        intent: inventory.intent,
+        inventory: { state: 'available', source: 'pack-inventory' },
+        completeness: inventory.completeness,
+        health: healthForStatuses(inventory.assets
+            .filter(({ definition }) => definition.ownership[inventory.scope] === 'managed')
+            .map(({ status }) => status)),
+        realization: hasScopedPackRealizationEvidence(inventory)
+            ? 'present'
+            : 'absent',
+    };
+}
+export function unavailablePackScopeFacts(input) {
+    return {
+        scope: input.scope,
+        intent: input.intent,
+        inventory: {
+            state: 'unavailable',
+            source: 'pack-inventory',
+            reason: input.reason,
+        },
+        completeness: 'unknown',
+        health: 'unknown',
+        realization: 'unknown',
+    };
+}
+export function hasScopedPackRealizationEvidence(inventory) {
+    return inventory.assets.some(({ definition, status }) => definition.sharedOwner === undefined &&
+        definition.ownership[inventory.scope] === 'managed' &&
+        status !== 'missing');
+}
+function placementForScopes(scopes) {
+    if (scopes.some(({ realization }) => realization === 'unknown')) {
+        return 'unknown';
+    }
+    const realized = scopes
+        .filter(({ realization }) => realization === 'present')
+        .map(({ scope }) => scope);
+    if (realized.includes('project') && realized.includes('user'))
+        return 'both';
+    return realized[0] ?? 'none';
+}
+function canonicalDiagnostics(pack, scopes) {
+    const diagnostics = [];
+    for (const facts of scopes) {
+        if (facts.inventory.state === 'unavailable') {
+            diagnostics.push({
+                code: 'inventory-unavailable',
+                severity: 'error',
+                pack,
+                scope: facts.scope,
+                affectedAssets: [],
+                source: facts.inventory.source,
+                detail: facts.inventory.reason ?? `${facts.scope} inventory unavailable`,
+                recovery: [],
+            });
+        }
+        else if (facts.intent.enabled && facts.realization === 'absent') {
+            diagnostics.push({
+                code: 'declared-only',
+                severity: 'warning',
+                pack,
+                scope: facts.scope,
+                affectedAssets: [],
+                source: 'pack-inventory',
+                detail: `Pack ${pack} is declared at ${facts.scope} scope but has no realized managed assets`,
+                recovery: [],
+            });
+        }
+        if (facts.completeness === 'partial') {
+            diagnostics.push({
+                code: 'partial-placement',
+                severity: 'warning',
+                pack,
+                scope: facts.scope,
+                affectedAssets: [],
+                source: 'pack-inventory',
+                detail: `Pack ${pack} is only partially realized at ${facts.scope} scope`,
+                recovery: [],
+            });
+        }
+    }
+    if (scopes.filter(({ realization }) => realization === 'present').length === 2) {
+        diagnostics.push({
+            code: 'duplicate-placement',
+            severity: 'warning',
+            pack,
+            affectedAssets: [],
+            source: 'pack-inventory',
+            detail: `Pack ${pack} is realized at project and user scope`,
+            recovery: [],
+        });
+    }
+    return diagnostics;
+}
+export function projectPackEvidence(input) {
+    const pack = input.canonical?.pack ??
+        input.scopes[0]?.intent.pack ??
+        (() => {
+            throw new Error('Pack evidence requires canonical inventory or scope facts');
+        })();
+    return {
+        schemaVersion: 1,
+        pack,
+        canonical: input.canonical,
+        scopes: input.scopes,
+        knownRealizedScopes: input.scopes
+            .filter(({ realization }) => realization === 'present')
+            .map(({ scope }) => scope),
+        unknownScopes: input.scopes
+            .filter(({ realization }) => realization === 'unknown')
+            .map(({ scope }) => scope),
+        realizedPlacement: placementForScopes(input.scopes),
+        providers: input.providers ?? [],
+        diagnostics: canonicalDiagnostics(pack, input.scopes),
+    };
+}

package/dist/commands/tools/shared/pack-inventory.d.ts

@@ -24,6 +24,7 @@ export interface ScopedPackInventory {
 }
 export interface PackInventory {
     pack: PackName;
+    /** @deprecated Use ToolPackEvidence.realizedPlacement for truthful placement. */
     placement: 'project' | 'user' | 'both' | 'unavailable';
     scopes: ScopedPackInventory[];
     diagnostics: PackDiagnostic[];

package/dist/commands/tools/shared/pack-inventory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pack-inventory.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-inventory.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,uBAAuB,GACvB,iBAAiB,GACjB,0BAA0B,GAC1B,2BAA2B,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACvD,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAiRD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,aAAa,EAAE,GAC3B,aAAa,EAAE,CAgEjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAiDxB"}
+{"version":3,"file":"pack-inventory.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-inventory.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,KAAK,aAAa,EAEnB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAEL,KAAK,gBAAgB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,mBAAmB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,uBAAuB,GACvB,iBAAiB,GACjB,0BAA0B,GAC1B,2BAA2B,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,iFAAiF;IACjF,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;IACvD,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAiRD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAwC9B;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,mBAAmB,GAC7B,OAAO,CAUT;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,aAAa,EAAE,GAC3B,aAAa,EAAE,CAgEjB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAiDxB"}

package/dist/commands/tools/shared/pack-lifecycle-outcome.d.ts

@@ -0,0 +1,44 @@
+import type { ConcreteScope } from '../../../shared/types.js';
+import type { AutoSyncResult } from './auto-sync.js';
+import { type ProviderReachabilityEvidence, type RecoveryAction, type ToolPackEvidence } from './pack-evidence.js';
+import type { PackLifecycleResult } from './pack-lifecycle.js';
+import type { PackName } from './types.js';
+export interface PackScopeSelection {
+    pack: PackName;
+    requested: ConcreteScope | 'both';
+    retainedRealizedScopes: readonly ConcreteScope[];
+    targetScopes: readonly ConcreteScope[];
+}
+export interface ProviderSyncOutcome {
+    scopes: readonly ConcreteScope[];
+    status: 'not-run' | 'complete' | 'partial' | 'failed';
+    providers: readonly ProviderReachabilityEvidence[];
+    error?: string;
+}
+export interface PackLifecycleOutcome {
+    schemaVersion: 1;
+    selection: PackScopeSelection;
+    canonical: {
+        status: 'unchanged' | 'applied' | 'failed' | 'verification-failed';
+        results: readonly PackLifecycleResult[];
+    };
+    sync: ProviderSyncOutcome;
+    finalEvidence: ToolPackEvidence | null;
+    status: 'complete' | 'partial' | 'failed';
+    recovery: readonly RecoveryAction[];
+}
+export declare function resolveAdditivePackScopeSelection(input: {
+    pack: PackName;
+    requested: ConcreteScope | 'both';
+    knownRealizedScopes: readonly ConcreteScope[];
+    unknownScopes: readonly ConcreteScope[];
+}): PackScopeSelection;
+export declare function providerSyncOutcomeFromAutoSync(result: AutoSyncResult, providers?: readonly ProviderReachabilityEvidence[]): ProviderSyncOutcome;
+export declare function evaluatePackLifecycleOutcome(input: {
+    selection: PackScopeSelection;
+    lifecycle: readonly PackLifecycleResult[];
+    sync: ProviderSyncOutcome;
+    finalEvidence: ToolPackEvidence | null;
+    canonicalFailure?: string;
+}): PackLifecycleOutcome;
+//# sourceMappingURL=pack-lifecycle-outcome.d.ts.map

package/dist/commands/tools/shared/pack-lifecycle-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-lifecycle-outcome.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/shared/pack-lifecycle-outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,aAAa,GAAG,MAAM,CAAC;IAClC,sBAAsB,EAAE,SAAS,aAAa,EAAE,CAAC;IACjD,YAAY,EAAE,SAAS,aAAa,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtD,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,CAAC,CAAC;IACjB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE;QACT,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,qBAAqB,CAAC;QACnE,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;KACzC,CAAC;IACF,IAAI,EAAE,mBAAmB,CAAC;IAC1B,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1C,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;CACrC;AASD,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,aAAa,GAAG,MAAM,CAAC;IAClC,mBAAmB,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,aAAa,EAAE,SAAS,aAAa,EAAE,CAAC;CACzC,GAAG,kBAAkB,CAkBrB;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,cAAc,EACtB,SAAS,GAAE,SAAS,4BAA4B,EAAO,GACtD,mBAAmB,CAYrB;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,aAAa,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,oBAAoB,CAqEvB"}

package/dist/commands/tools/shared/pack-lifecycle-outcome.js

@@ -0,0 +1,91 @@
+import { hasScopedPackRealizationEvidence, } from './pack-evidence.js';
+const SCOPE_ORDER = ['project', 'user'];
+function orderedScopes(scopes) {
+    const selected = new Set(scopes);
+    return SCOPE_ORDER.filter((scope) => selected.has(scope));
+}
+export function resolveAdditivePackScopeSelection(input) {
+    if (input.unknownScopes.length > 0) {
+        throw new Error(`Cannot select scope for ${input.pack}: inventory is unknown at ${input.unknownScopes.join(', ')} scope`);
+    }
+    const retainedRealizedScopes = orderedScopes(input.knownRealizedScopes);
+    const requestedScopes = input.requested === 'both' ? SCOPE_ORDER : [input.requested];
+    return {
+        pack: input.pack,
+        requested: input.requested,
+        retainedRealizedScopes,
+        targetScopes: orderedScopes([
+            ...retainedRealizedScopes,
+            ...requestedScopes,
+        ]),
+    };
+}
+export function providerSyncOutcomeFromAutoSync(result, providers = []) {
+    return {
+        scopes: result.scopes,
+        status: result.scopes.length === 0
+            ? 'not-run'
+            : result.synced
+                ? 'complete'
+                : 'failed',
+        providers,
+        ...(result.error ? { error: result.error } : {}),
+    };
+}
+export function evaluatePackLifecycleOutcome(input) {
+    const recovery = [];
+    let canonicalStatus;
+    if (input.canonicalFailure) {
+        canonicalStatus = 'failed';
+        recovery.push({
+            code: 'canonical-apply-failed',
+            message: input.canonicalFailure,
+        });
+    }
+    else if (input.lifecycle.length === 0) {
+        canonicalStatus = 'unchanged';
+    }
+    else if (input.lifecycle.some(({ apply }) => apply !== null && !hasScopedPackRealizationEvidence(apply.inventory))) {
+        canonicalStatus = 'verification-failed';
+        recovery.push({
+            code: 'canonical-verification-failed',
+            message: `Re-run installation for ${input.selection.pack} and inspect pack status`,
+        });
+    }
+    else {
+        canonicalStatus = input.lifecycle.some(({ apply }) => apply && apply.applied.length > 0)
+            ? 'applied'
+            : 'unchanged';
+    }
+    const verified = input.finalEvidence !== null &&
+        input.finalEvidence.unknownScopes.length === 0 &&
+        input.selection.targetScopes.every((scope) => input.finalEvidence.knownRealizedScopes.includes(scope));
+    if (!verified && canonicalStatus !== 'failed') {
+        canonicalStatus = 'verification-failed';
+        recovery.push({
+            code: 'final-inventory-unverified',
+            message: `Re-run status for ${input.selection.pack}; final placement could not be verified`,
+        });
+    }
+    if (input.sync.status === 'partial' || input.sync.status === 'failed') {
+        recovery.push({
+            code: 'provider-sync-incomplete',
+            message: input.sync.error ??
+                `Run oat sync for ${input.sync.scopes.join(', ') || 'the selected'} scope`,
+        });
+    }
+    const status = canonicalStatus === 'failed' || canonicalStatus === 'verification-failed'
+        ? 'failed'
+        : input.sync.status === 'partial' || input.sync.status === 'failed'
+            ? 'partial'
+            : 'complete';
+    return {
+        schemaVersion: 1,
+        selection: input.selection,
+        canonical: { status: canonicalStatus, results: input.lifecycle },
+        sync: input.sync,
+        finalEvidence: input.finalEvidence,
+        status,
+        recovery,
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/update/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,kCAAkC,CAAC;AAK1C,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAE7B,MAAM,gBAAgB,CAAC;AAmBxB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GAClD,MAAM,EAAE,CAaV;AAgCD,wBAAgB,wBAAwB,CACtC,YAAY,GAAE,uBAA6C,EAC3D,gBAAgB,GAAE,oBAA8C,GAC/D,OAAO,CA8MT;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAS7E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAOT;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,GACd,MAAM,CAMR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/update/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,kCAAkC,CAAC;AAS1C,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAG7B,MAAM,gBAAgB,CAAC;AAmBxB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GAClD,MAAM,EAAE,CAaV;AAgCD,wBAAgB,wBAAwB,CACtC,YAAY,GAAE,uBAA6C,EAC3D,gBAAgB,GAAE,oBAA8C,GAC/D,OAAO,CAkPT;AAwCD;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAS7E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAOT;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,GACd,MAAM,CAMR"}

package/dist/commands/tools/update/index.js

@@ -10,6 +10,7 @@ import { readGlobalOptions, resolveConcreteScopes, } from '../../shared/shared.u
 import { autoSync, } from '../../tools/shared/auto-sync.js';
 import { inventoryScopedPack } from '../../tools/shared/pack-inventory.js';
 import { reconcilePackLifecycles } from '../../tools/shared/pack-lifecycle.js';
+import { evaluatePackLifecycleOutcome, } from '../../tools/shared/pack-lifecycle-outcome.js';
 import { reconcileProjectToolsConfig } from '../../tools/shared/project-tools-config.js';
 import { scanTools } from '../../tools/shared/scan-tools.js';
 import { readOatConfig, writeOatConfig } from '../../../config/oat-config.js';
@@ -17,7 +18,7 @@ import { resolveAssetsRoot } from '../../../fs/assets.js';
 import { fileExists } from '../../../fs/io.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../../fs/paths.js';
 import { Command } from 'commander';
-import { updateTools, } from './update-tools.js';
+import { failedUpdateLifecycleOutcomes, updateTools, } from './update-tools.js';
 const defaultDependencies = {
     scanTools,
     resolveScopeRoot: async (scope, cwd, home) => {
@@ -95,7 +96,29 @@ export function createToolsUpdateCommand(dependencies = defaultDependencies, syn
         const target = targetResolution.target;
         const scopes = resolveConcreteScopes(context.scope);
         const dryRun = opts.dryRun ?? false;
-        const result = await updateTools(target, scopes, context.cwd, context.home, dryRun, dependencies);
+        let result;
+        try {
+            result = await updateTools(target, scopes, context.cwd, context.home, dryRun, dependencies);
+        }
+        catch (error) {
+            if (target.kind === 'name')
+                throw error;
+            const lifecycle = failedUpdateLifecycleOutcomes(target, scopes, error);
+            const message = error instanceof Error ? error.message : String(error);
+            if (context.json) {
+                logger.json({
+                    target: describeTarget(target),
+                    dryRun,
+                    result: createEmptyUpdateResult(),
+                    lifecycle,
+                });
+            }
+            else {
+                logger.error(`Pack update failed: ${message}`);
+            }
+            process.exitCode = 1;
+            return;
+        }
         const assetsRoot = dryRun ? null : await dependencies.resolveAssetsRoot();
         if (!dryRun && shouldBackfillWorkflowGitignore(result)) {
             const repoRoot = await resolveProjectRoot(context.cwd);
@@ -162,6 +185,7 @@ export function createToolsUpdateCommand(dependencies = defaultDependencies, syn
             return;
         }
         // Auto-sync after mutations (before output so sync errors are captured)
+        const syncResults = [];
         if (!dryRun && opts.sync !== false) {
             for (const scope of scopes) {
                 const installedCanonicalPaths = [
@@ -172,16 +196,23 @@ export function createToolsUpdateCommand(dependencies = defaultDependencies, syn
                 const updatedAtScope = result.updated.some((tool) => tool.scope === scope);
                 if (!updatedAtScope && installedCanonicalPaths.length === 0)
                     continue;
-                await autoSync([scope], context.cwd, context.home, logger, syncDependencies, { installedCanonicalPaths });
+                syncResults.push(await autoSync([scope], context.cwd, context.home, logger, syncDependencies, { installedCanonicalPaths }));
             }
         }
+        const lifecycle = finalizeUpdateLifecycle(result.lifecycle, syncResults);
+        const legacyResult = { ...result };
+        delete legacyResult.lifecycle;
         if (context.json) {
             logger.json({
                 target: describeTarget(target),
                 dryRun,
-                result,
+                result: legacyResult,
                 ...(adoptedPacks.length > 0 ? { adoptedPacks } : {}),
+                ...(lifecycle ? { lifecycle } : {}),
             });
+            if (lifecycle?.some(({ status }) => status !== 'complete')) {
+                process.exitCode = 1;
+            }
             return;
         }
         for (const pack of adoptedPacks) {
@@ -213,6 +244,45 @@ export function createToolsUpdateCommand(dependencies = defaultDependencies, syn
         if (result.updated.length === 0 && result.assetRefreshes.length === 0) {
             logger.info('No tools to update.');
         }
+        for (const outcome of lifecycle ?? []) {
+            if (outcome.status === 'complete')
+                continue;
+            logger.warn(`Pack ${outcome.selection.pack} update ${outcome.status}: ${outcome.recovery.map(({ message }) => message).join('; ')}`);
+            process.exitCode = 1;
+        }
+    });
+}
+function createEmptyUpdateResult() {
+    return {
+        updated: [],
+        current: [],
+        newer: [],
+        notInstalled: [],
+        notBundled: [],
+        assetRefreshes: [],
+        plans: [],
+    };
+}
+function finalizeUpdateLifecycle(lifecycle, syncResults) {
+    if (!lifecycle || syncResults.length === 0)
+        return lifecycle;
+    return lifecycle.map((outcome) => {
+        const relevant = syncResults.filter(({ scopes }) => scopes.some((scope) => outcome.selection.targetScopes.includes(scope)));
+        if (relevant.length === 0)
+            return outcome;
+        return evaluatePackLifecycleOutcome({
+            selection: outcome.selection,
+            lifecycle: outcome.canonical.results,
+            sync: {
+                scopes: [...new Set(relevant.flatMap(({ scopes }) => scopes))],
+                status: relevant.every(({ synced }) => synced) ? 'complete' : 'failed',
+                providers: [],
+                ...(relevant.find(({ error }) => error)?.error
+                    ? { error: relevant.find(({ error }) => error).error }
+                    : {}),
+            },
+            finalEvidence: outcome.finalEvidence,
+        });
     });
 }
 /**

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

@@ -3,6 +3,7 @@ import type { ApplyOatCoreResult } from '../../init/gitignore.js';
 import type { CopyStatus } from '../../init/tools/shared/copy-helpers.js';
 import type { InventoryScopedPackInput, ScopedPackInventory } from '../../tools/shared/pack-inventory.js';
 import { type PackLifecycleRequest, type PackLifecycleResult } from '../../tools/shared/pack-lifecycle.js';
+import { type PackLifecycleOutcome } from '../../tools/shared/pack-lifecycle-outcome.js';
 import type { PackReconcilePlan } from '../../tools/shared/pack-reconcile.js';
 import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
 import type { PackName, ToolInfo } from '../../tools/shared/types.js';
@@ -31,6 +32,7 @@ export interface UpdateResult {
     notBundled: ToolInfo[];
     assetRefreshes: PackAssetRefresh[];
     plans: PackReconcilePlan[];
+    lifecycle?: PackLifecycleOutcome[];
 }
 export interface UpdateToolsDependencies {
     scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
@@ -48,4 +50,7 @@ export interface UpdateToolsDependencies {
     }) => Promise<PackLifecycleResult[]>;
 }
 export declare function updateTools(target: UpdateTarget, scopes: ConcreteScope[], cwd: string, home: string, dryRun: boolean, dependencies: UpdateToolsDependencies): Promise<UpdateResult>;
+export declare function failedUpdateLifecycleOutcomes(target: Exclude<UpdateTarget, {
+    kind: 'name';
+}>, scopes: readonly ConcreteScope[], error: unknown): PackLifecycleOutcome[];
 //# sourceMappingURL=update-tools.d.ts.map

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

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

package/dist/commands/tools/update/update-tools.js

@@ -1,6 +1,8 @@
 import { join } from 'node:path';
-import { hasScopedPackPlacementEvidence, inventoryScopedPack, } from '../../tools/shared/pack-inventory.js';
+import { hasScopedPackRealizationEvidence, packScopeFactsFromInventory, projectPackEvidence, } from '../../tools/shared/pack-evidence.js';
+import { inventoryScopedPack } from '../../tools/shared/pack-inventory.js';
 import {} from '../../tools/shared/pack-lifecycle.js';
+import { evaluatePackLifecycleOutcome, resolveAdditivePackScopeSelection, } from '../../tools/shared/pack-lifecycle-outcome.js';
 import { getPackDefinition } from '../../tools/shared/pack-manifest.js';
 function getBundledPackAssets(pack, scope) {
     const assets = getPackDefinition(pack).assets.filter(({ scopes, ownership }) => scopes.includes(scope) && ownership[scope] === 'managed');
@@ -47,7 +49,7 @@ export async function updateTools(target, scopes, cwd, home, dryRun, dependencie
                     scopeRoot,
                     assetsRoot,
                 });
-                if (!hasScopedPackPlacementEvidence(before))
+                if (!hasScopedPackRealizationEvidence(before))
                     continue;
                 requests.push({
                     pack: definition.name,
@@ -63,6 +65,7 @@ export async function updateTools(target, scopes, cwd, home, dryRun, dependencie
             return result;
         }
         const lifecycle = await dependencies.reconcilePacks(requests, { dryRun });
+        result.lifecycle = updateLifecycleOutcomes(lifecycle);
         result.plans.push(...lifecycle.map(({ plan }) => plan));
         for (const entry of lifecycle) {
             const definition = getPackDefinition(entry.request.pack);
@@ -243,6 +246,65 @@ export async function updateTools(target, scopes, cwd, home, dryRun, dependencie
     }
     return result;
 }
+function updateLifecycleOutcomes(results) {
+    const verifiable = results.filter(({ apply }) => apply === null || ('inventory' in apply && apply.inventory !== undefined));
+    const packs = [...new Set(verifiable.map(({ request }) => request.pack))];
+    return packs.map((pack) => {
+        const lifecycle = verifiable.filter(({ request }) => request.pack === pack);
+        const requestedScopes = lifecycle.map(({ request }) => request.scope);
+        const finalScopes = lifecycle.map(({ apply, before }) => apply?.inventory ?? before);
+        const finalEvidence = projectPackEvidence({
+            canonical: null,
+            scopes: finalScopes.map(packScopeFactsFromInventory),
+        });
+        const selection = resolveAdditivePackScopeSelection({
+            pack,
+            requested: requestedScopes.includes('project') && requestedScopes.includes('user')
+                ? 'both'
+                : requestedScopes[0],
+            knownRealizedScopes: lifecycle
+                .filter(({ before }) => hasScopedPackRealizationEvidence(before))
+                .map(({ request }) => request.scope),
+            unknownScopes: [],
+        });
+        if (lifecycle.every(({ apply }) => apply === null)) {
+            return {
+                schemaVersion: 1,
+                selection,
+                canonical: { status: 'unchanged', results: lifecycle },
+                sync: { scopes: [], status: 'not-run', providers: [] },
+                finalEvidence,
+                status: 'complete',
+                recovery: [],
+            };
+        }
+        return evaluatePackLifecycleOutcome({
+            selection,
+            lifecycle,
+            sync: { scopes: [], status: 'not-run', providers: [] },
+            finalEvidence,
+        });
+    });
+}
+export function failedUpdateLifecycleOutcomes(target, scopes, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return getSelectedDefinitions(target).map(({ name: pack }) => ({
+        schemaVersion: 1,
+        selection: {
+            pack,
+            requested: scopes.includes('project') && scopes.includes('user')
+                ? 'both'
+                : scopes[0],
+            retainedRealizedScopes: [],
+            targetScopes: scopes,
+        },
+        canonical: { status: 'failed', results: [] },
+        sync: { scopes: [], status: 'not-run', providers: [] },
+        finalEvidence: null,
+        status: 'failed',
+        recovery: [{ code: 'canonical-apply-failed', message }],
+    }));
+}
 function getSelectedDefinitions(target) {
     return target.kind === 'pack'
         ? [getPackDefinition(target.pack)]

package/dist/config/oat-config.d.ts

@@ -10,6 +10,11 @@ export interface OatDocumentationConfig {
 export interface OatGitConfig {
     defaultBranch?: string;
 }
+/**
+ * Known project config keys. Unknown siblings written by a newer OAT are not
+ * described here, but they are preserved verbatim across read-mutate-write:
+ * see the FR10 merge in `normalizeOatConfig`.
+ */
 export interface OatProjectsConfig {
     root?: string;
     defaultScope?: 'shared' | 'local' | 'synced';