@lesliechan721/aw 0.1.0-beta.15 → 0.1.0-beta.17

package/dist/src/commands/review-inspection.d.ts

@@ -0,0 +1,169 @@
+import { type CatalogManifestV7Entry, type Scope } from '@lesliechan721/aw-plugin-core';
+import { type AwSkillEvalManifestV1Suite } from '../eval/manifest-v1.js';
+import { type CatalogWorkspaceResolvedFrom } from './catalog-workspace-resolution.js';
+import { type AwSourceBindingProfile, type AwSourceBindingEvalInput, type AwSourceBindingSource, type AwSourceBindingSubject, type AwSourceBindingVerifiedOutput } from '../review/source-binding.js';
+export type ReviewInspectionIssueCategory = 'missing' | 'invalid' | 'unsupported' | 'unknown';
+export type ReviewInspectionFinalProfile = 'codex-user' | 'codex-project' | 'claude-user' | 'claude-project' | 'agent-skills-user' | 'agent-skills-project';
+export interface ReviewInspectionIssue {
+    category: ReviewInspectionIssueCategory;
+    code: string;
+    message: string;
+    blocking: boolean;
+    subjectKey?: string;
+    path?: string;
+}
+export interface ReviewInspectionSubject {
+    key: string;
+    kind: 'catalog-source' | 'catalog-snapshot' | 'aw-plugin-source' | 'aw-plugin' | 'source-skill' | 'portable-source-skill' | 'artifact-source' | 'materialized-skill';
+    plugin: string | null;
+    skill: string | null;
+    path: string;
+    profile: ReviewInspectionFinalProfile | null;
+    digest: string;
+    origin: 'workspace' | 'catalog-snapshot' | 'source-binding';
+    targetId?: string;
+    materializationProfile?: {
+        kind: 'eval' | 'portable';
+        id: string;
+        scope: Scope;
+        inputDigest: string;
+    };
+}
+export interface ReviewInspectionRequiredFinal {
+    key: string;
+    kind: 'materialized-skill';
+    plugin: string;
+    skill: string;
+    path: string | null;
+    profile: ReviewInspectionFinalProfile;
+    digest: string | null;
+    targetId: string | null;
+    sourceSubjectKey: string;
+    status: 'resolved' | 'missing' | 'invalid' | 'unknown';
+    matchedFinalKeys: string[];
+}
+export interface ReviewInspectionRequiredEval {
+    key: string;
+    plugin: string;
+    skill: string;
+    finalProfile: ReviewInspectionFinalProfile;
+    requiredFinalKey: string;
+    evalProfile: {
+        id: string;
+        scope: Scope;
+        inputDigest: string;
+        plugins: string[];
+    };
+    suite: {
+        id: string;
+        kind: AwSkillEvalManifestV1Suite['kind'];
+        provider: AwSkillEvalManifestV1Suite['provider'] | null;
+        suiteDefaultsDigest: string;
+    };
+    cases: {
+        sourcePath: string;
+        sourceCorpusDigest: string;
+        selectedCasesDigest: string;
+        selected: Array<{
+            id: string;
+            split: string;
+            minimumRuns: number;
+        }>;
+    };
+    runs: number;
+    timeoutMs: number | null;
+    minimumPassRate: number;
+    processManagement: 'managed-only' | 'allow-unmanaged-confirmed';
+    materializedFinalKeys: string[];
+    verifiedBindingPaths: string[];
+}
+export interface ReviewInspectionPlugin {
+    id: string;
+    name: string;
+    version: string;
+    path: string;
+    sourceContainerKey: string;
+    finalContainerKey: string | null;
+    dependencies: string[];
+    supportedPlatforms: Array<'claude' | 'codex'>;
+    finalProfiles: ReviewInspectionFinalProfile[];
+    imports: Array<{
+        purpose: 'build' | 'skill-runtime-file' | 'artifact-runtime';
+        provider: string;
+        export: string;
+        consumer: string;
+    }>;
+    snapshotEntry: Pick<CatalogManifestV7Entry, 'artifactDigest' | 'manifestDigest' | 'contentDigest'> | null;
+    sourceSubjectKeys: string[];
+    requiredFinalKeys: string[];
+    requiredEvalKeys: string[];
+}
+export interface ReviewInspectionMaterialization {
+    path: string;
+    state: 'verified' | 'incomplete' | 'invalid' | 'drifted' | 'unsupported';
+    plugin: string | null;
+    skill: string | null;
+    profile: ReviewInspectionFinalProfile | null;
+    finalKeys: string[];
+    verifiedBinding: {
+        source: AwSourceBindingSource;
+        subject: AwSourceBindingSubject;
+        profile: AwSourceBindingProfile;
+        evalInput: AwSourceBindingEvalInput | null;
+        finalDigest: string;
+        artifacts: AwSourceBindingVerifiedOutput[];
+    } | null;
+    issues: string[];
+}
+export interface ReviewInspectionReceipt {
+    schemaVersion: 1;
+    command: 'review:inspect';
+    ok: boolean;
+    completeness: 'complete' | 'incomplete';
+    target: {
+        kind: 'catalog' | 'plugin';
+        id: string;
+        path: string;
+    };
+    workspace: {
+        root: string;
+        resolvedFrom: CatalogWorkspaceResolvedFrom;
+        identity: string;
+        sourceIdentity: string;
+        catalogVersion: string;
+    };
+    snapshot: {
+        path: string;
+        state: 'absent' | 'current' | 'stale' | 'invalid';
+        catalogVersion: string | null;
+        snapshotDigest: string | null;
+        workspaceIdentity: string | null;
+        sourceIdentity: string | null;
+    };
+    plugins: ReviewInspectionPlugin[];
+    subjects: ReviewInspectionSubject[];
+    requiredFinals: ReviewInspectionRequiredFinal[];
+    finalMappings: Array<{
+        requiredFinalKey: string;
+        sourceSubjectKey: string;
+        finalSubjectKeys: string[];
+        status: ReviewInspectionRequiredFinal['status'];
+    }>;
+    requiredEvals: ReviewInspectionRequiredEval[];
+    materializations: ReviewInspectionMaterialization[];
+    issues: ReviewInspectionIssue[];
+}
+export declare function inspectReviewTarget(options: {
+    cwd: string;
+    target: string;
+    workspaceRoot?: string;
+    materializations?: readonly string[];
+    env?: NodeJS.ProcessEnv;
+}): Promise<ReviewInspectionReceipt>;
+export declare function createReviewInspectionFailure(error: unknown, code?: string): {
+    schemaVersion: 1;
+    command: 'review:inspect';
+    ok: false;
+    completeness: 'incomplete';
+    issues: ReviewInspectionIssue[];
+};