@lesliechan721/aw 0.1.0-beta.10

package/dist/src/commands/status-v6.d.ts

@@ -0,0 +1,206 @@
+import type { CatalogSource, PlatformName, PluginConfigSchemaField, Scope } from '../types.js';
+import { type CodexExtensionKind } from '../utils/codex-surface-analysis.js';
+import { inventoryCatalogSourceReferences } from '../utils/catalog-source-references.js';
+import type { CatalogOperationContext } from '../utils/catalog-operation-context.js';
+import { type NativeCliRunner } from '../utils/native-cli.js';
+import type { ArtifactCollisionEvidence } from '../utils/ownership.js';
+import { type SystemCodexFilesystemInspection } from '../utils/codex-manager.js';
+export interface StatusV7CatalogSource {
+    id: string;
+    identity: string;
+    type: CatalogSource['type'];
+    primary: boolean;
+    requestedRef: string;
+    resolvedCommit?: string;
+    catalogVersion?: string;
+    channel?: string;
+    freshness?: 'active';
+    error?: string;
+    errorCode?: string;
+}
+export interface StatusV7Target {
+    pluginName: string;
+    sourceId: string;
+    sourceIdentity: string;
+    pluginId: string;
+    version?: string;
+    platform: PlatformName;
+    scope: Scope;
+    cwd: string;
+    state: StatusV7State;
+    components: StatusV7Component[];
+    reasons: StatusV7Reason[];
+    recoveryActions: StatusV7RecoveryAction[];
+}
+export type StatusV7State = 'absent' | 'ready' | 'needsSync' | 'orphaned' | 'blocked';
+export interface StatusV7RecoveryAction {
+    command: 'sync' | 'cleanup' | 'reinstall' | 'uninstall' | 'manual';
+    scope?: Scope;
+    description: string;
+}
+export type StatusV7DependencyReadinessState = 'ready' | 'absent' | 'blockedByCollision' | 'incomplete' | 'error';
+export interface StatusV7Component {
+    kind: 'intent' | 'ownership' | 'sharedNative' | 'activation' | 'extension' | 'dependency' | 'systemConsumer';
+    key: string;
+    state: string;
+    metadata?: Record<string, string | number | boolean | string[]>;
+}
+export interface StatusV7Reason {
+    code: string;
+    message: string;
+    severity: 'warning' | 'blocking';
+    collision?: ArtifactCollisionEvidence;
+    dependencyPluginId?: string;
+    dependencyPlatform?: PlatformName;
+    dependencyScope?: Scope;
+    dependencyProject?: 'current' | null;
+    rootIssueId?: string;
+    rootIssueCode?: string;
+}
+type StatusOwnershipState = 'present' | 'absent' | 'partial' | 'error';
+export interface StatusSharedNativeProjection {
+    pluginId: string;
+    state: 'missing' | 'usable' | 'replaceable' | 'blocked' | 'unobserved';
+    reason?: 'outdated' | 'damaged' | 'renderDrift' | 'foreign' | 'unreadable';
+    version?: string;
+    desiredVersion?: string;
+    diagnostic?: string;
+    staleCacheObserved?: boolean;
+}
+export declare function projectStatusSharedNativeReasons(sharedNative: StatusSharedNativeProjection | undefined, existingReasonCodes?: readonly string[], desiredEnabled?: boolean): StatusV7Reason[];
+export interface StatusActivationProjection {
+    user?: boolean;
+    project?: boolean;
+    effective?: boolean;
+    evidence: 'observed' | 'assumed' | 'unobserved';
+    systemConsumer?: SystemCodexFilesystemInspection;
+}
+export interface StatusExtensionProjection {
+    state: 'ready' | 'missing' | 'drifted' | 'conflict';
+    kinds: CodexExtensionKind[];
+}
+export interface StatusIntentProjection {
+    enabled: boolean;
+    scopes: Scope[];
+    relation: 'root' | 'dependency' | 'managed' | 'none';
+}
+export declare function statusTargetIntent(target: StatusV7Target): StatusIntentProjection;
+export declare function statusTargetOwnershipState(target: StatusV7Target): StatusOwnershipState;
+export declare function statusTargetSharedNative(target: StatusV7Target): StatusSharedNativeProjection | undefined;
+export declare function statusTargetActivation(target: StatusV7Target): StatusActivationProjection | undefined;
+export declare function statusTargetExtensions(target: StatusV7Target): StatusExtensionProjection | undefined;
+export interface StatusV7Payload {
+    schemaVersion: 7;
+    catalog: {
+        primarySourceId: string;
+        configDigest: string;
+        compositeDigest: string;
+        generationSetDigest?: string;
+        sources: StatusV7CatalogSource[];
+    };
+    filters: {
+        plugins: string[];
+        platform: PlatformName | 'both';
+        scope?: Scope;
+        cwd: string;
+    };
+    targets: StatusV7Target[];
+    errors: Array<{
+        code: string;
+        message: string;
+    }>;
+}
+export type TargetRevisionState = {
+    state: 'current';
+    availableVersion: string;
+    installedVersion?: string;
+} | {
+    state: 'upgradeAvailable';
+    availableVersion: string;
+    installedVersion?: string;
+} | {
+    state: 'unknown';
+    availableVersion?: string;
+    installedVersion?: string;
+};
+export interface StatusTargetRevision {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+    revision: TargetRevisionState;
+}
+export interface StatusV7PluginSummary {
+    pluginName: string;
+    pluginId: string;
+    displayName?: string;
+    description: string;
+    version?: string;
+    supportedTargets?: Record<PlatformName, Scope[]>;
+    configFieldCount?: number;
+    configSchema?: Record<string, PluginConfigSchemaField>;
+    configIssues?: Array<{
+        scope: Scope;
+        type: 'missing-required' | 'invalid-config' | 'sharedCompositeContainsLocalPath';
+        key: string;
+        title: string;
+        source: 'default' | 'user' | 'project' | 'missing';
+    }>;
+    configDiagnostic?: {
+        scope: Scope;
+        code: 'configReadFailed';
+        message: string;
+    };
+    dependencyDirectCount?: number;
+    dependencyTotalCount?: number;
+    dependencyIssueCount?: number;
+    missingCapabilities?: string[];
+}
+export interface LiveConsoleItem {
+    pluginName: string;
+    version?: string;
+    pluginSummary?: Omit<StatusV7PluginSummary, 'pluginName' | 'pluginId'>;
+    targets: StatusV7Target[];
+}
+export interface ConsoleItemsLoadResult {
+    items: LiveConsoleItem[];
+    catalogUnavailable: boolean;
+    status: StatusV7Payload;
+}
+export declare function setStatusDependencyInspectionHookForTests(hook: (() => void) | undefined): void;
+export declare function loadConsoleItemsResult(options?: {
+    cwd?: string;
+    platform?: string;
+    scope?: string;
+    verbose?: boolean;
+}, runtime?: {
+    env?: NodeJS.ProcessEnv;
+}): Promise<ConsoleItemsLoadResult>;
+export declare function loadConsoleItems(options?: {
+    cwd?: string;
+    platform?: string;
+    scope?: string;
+    verbose?: boolean;
+}, runtime?: {
+    env?: NodeJS.ProcessEnv;
+}): Promise<LiveConsoleItem[]>;
+export declare function projectTargetRevision(availableVersion: string | undefined, installedVersion: string | undefined): TargetRevisionState;
+export declare function statusCommandV7(options: {
+    plugins?: string[];
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    nativeCliRunner?: NativeCliRunner;
+    cliVersion?: string;
+    platform?: string;
+    scope?: string;
+    json?: boolean;
+    verbose?: boolean;
+    catalogOperationContext?: CatalogOperationContext;
+    inventoryCatalogSourceReferences?: typeof inventoryCatalogSourceReferences;
+}): Promise<{
+    payload: StatusV7Payload;
+    output: string;
+    hasErrors: boolean;
+    pluginSummaries: StatusV7PluginSummary[];
+    targetRevisions: StatusTargetRevision[];
+}>;
+export {};