@lesliechan721/aw 0.1.0-beta.7 → 0.1.0-beta.9

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

@@ -0,0 +1,202 @@
+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 { ArtifactCollisionEvidence, OwnershipInspection } from '../utils/ownership.js';
+import { type SystemCodexFilesystemInspection } from '../utils/codex-manager.js';
+export interface StatusV6CatalogSource {
+    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 StatusV6Target {
+    pluginName: string;
+    sourceId: string;
+    sourceIdentity: string;
+    pluginId: string;
+    version?: string;
+    platform: PlatformName;
+    /** TUI placement adapter. Codex shared-native identity is still emitted only once. */
+    scope: Scope;
+    cwd: string;
+    desired: {
+        enabled: boolean;
+        scopes: Scope[];
+        relation: 'root' | 'dependency' | 'managed' | 'none';
+    };
+    actual: {
+        state: StatusV6ActualState;
+    };
+    state: 'present' | 'absent' | 'partial' | 'error';
+    components: StatusV6Component[];
+    errors: StatusV6TargetError[];
+    recovery: StatusV6RecoveryAction[];
+    sharedNative?: {
+        pluginId: string;
+        state: 'present' | 'missing' | 'outdated' | 'corrupt' | 'foreign';
+        version?: string;
+        shared: true;
+    };
+    activation?: {
+        user?: boolean;
+        project?: boolean;
+        effective?: boolean;
+        evidence: 'observed' | 'assumed' | 'unobserved';
+        systemConsumer?: SystemCodexFilesystemInspection;
+    };
+    extensions?: {
+        state: 'ready' | 'missing' | 'drifted' | 'conflict';
+        kinds: CodexExtensionKind[];
+    };
+    dependency?: {
+        directCount: number;
+        issueCount: number;
+    };
+    dependencyReadiness?: StatusV6DependencyReadiness[];
+}
+export type StatusV6ActualState = 'ready' | 'needsSync' | 'drifted' | 'conflict' | 'orphaned' | 'unresolved' | 'absent';
+export interface StatusV6RecoveryAction {
+    command: 'sync' | 'cleanup' | 'reinstall' | 'uninstall' | 'manual';
+    scope?: Scope;
+    description: string;
+}
+export type StatusV6DependencyReadinessState = 'ready' | 'absent' | 'blockedByCollision' | 'incomplete' | 'error';
+export interface StatusV6DependencyReadiness {
+    dependencyPluginId: string;
+    state: StatusV6DependencyReadinessState;
+    rootIssueId?: string;
+    rootIssueCode?: string;
+}
+export interface StatusV6Component {
+    key: string;
+    state: OwnershipInspection['components'][number]['state'];
+    error?: StatusV6TargetError;
+}
+export interface StatusV6TargetError {
+    code: string;
+    message: string;
+    severity: 'warning' | 'blocking';
+    collision?: ArtifactCollisionEvidence;
+    dependencyPluginId?: string;
+    rootIssueId?: string;
+    rootIssueCode?: string;
+}
+export interface StatusV6Payload {
+    schemaVersion: 6;
+    catalog: {
+        primarySourceId: string;
+        configDigest: string;
+        compositeDigest: string;
+        generationSetDigest?: string;
+        sources: StatusV6CatalogSource[];
+    };
+    filters: {
+        plugins: string[];
+        platform: PlatformName | 'both';
+        scope?: Scope;
+        cwd: string;
+    };
+    targets: StatusV6Target[];
+    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 StatusV6PluginSummary {
+    pluginName: string;
+    pluginId: string;
+    displayName?: string;
+    description: string;
+    version?: string;
+    supportedTargets?: Record<PlatformName, Scope[]>;
+    configFieldCount?: number;
+    configSchema?: Record<string, PluginConfigSchemaField>;
+    configIssues?: Array<{
+        type: 'missing-required' | 'invalid-config';
+        key: string;
+        title: string;
+        source: 'default' | 'user' | 'project' | 'projectLocal' | 'missing';
+    }>;
+    configDiagnostic?: {
+        code: 'configReadFailed';
+        message: string;
+    };
+    dependencyDirectCount?: number;
+    dependencyTotalCount?: number;
+    dependencyIssueCount?: number;
+    missingCapabilities?: string[];
+}
+export interface LiveConsoleItem {
+    pluginName: string;
+    version?: string;
+    pluginSummary?: Omit<StatusV6PluginSummary, 'pluginName' | 'pluginId'>;
+    targets: StatusV6Target[];
+}
+export interface ConsoleItemsLoadResult {
+    items: LiveConsoleItem[];
+    catalogUnavailable: boolean;
+    status: StatusV6Payload;
+}
+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 statusCommandV6(options: {
+    plugins?: string[];
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    cliVersion?: string;
+    platform?: string;
+    scope?: string;
+    json?: boolean;
+    verbose?: boolean;
+    catalogOperationContext?: CatalogOperationContext;
+    inventoryCatalogSourceReferences?: typeof inventoryCatalogSourceReferences;
+}): Promise<{
+    payload: StatusV6Payload;
+    output: string;
+    hasErrors: boolean;
+    pluginSummaries: StatusV6PluginSummary[];
+    targetRevisions: StatusTargetRevision[];
+}>;