@lesliechan721/aw 0.1.0-beta.6 → 0.1.0-beta.60

package/dist/src/commands/catalog-publish.d.ts

@@ -1,49 +1,107 @@
-import { type CatalogPublicationDescriptor } from './catalog-publication-inspection.js';
+import { type CatalogManifestV7Entry } from '@lesliechan721/aw-plugin-core';
+import { type CatalogPublicationPreparation } from './catalog-publication-inspection.js';
+import { type CatalogPublicationDescriptor, type CatalogPublicationJournal } from './catalog-publication-journal.js';
+import { type CatalogBranchResolvedFrom, type CatalogRemoteResolvedFrom } from './catalog-publication-target.js';
+import { type CatalogWorkspaceResolvedFrom } from './catalog-workspace-resolution.js';
+export { catalogPublicationPlanDigest, parseCatalogPublicationJournal, } from './catalog-publication-journal.js';
+export type { CatalogPublicationDescriptor, CatalogPublicationJournal, } from './catalog-publication-journal.js';
 export { safeRemoteIdentity, sanitizedGitEnvironment } from './catalog-publication-inspection.js';
 export interface CatalogPublishIo {
     stdout(text: string): void;
     stderr(text: string): void;
 }
-export interface CatalogPublishReceipt {
-    command: 'catalog:publish';
+interface CatalogPublishReceiptBase {
     ok: true;
+    workspaceRoot: string;
+    workspaceRootResolvedFrom: CatalogWorkspaceResolvedFrom;
     workspaceIdentity: string;
     catalogVersion: string;
     channel: 'latest' | 'beta';
     remote: string;
+    remoteResolvedFrom: CatalogRemoteResolvedFrom;
     remoteUrl: string;
     fetchUrl: string;
     pushUrl: string;
     branch: string;
+    branchResolvedFrom: CatalogBranchResolvedFrom;
     parent: string | null;
     tag: string;
-    commit: string;
+    expectedCommit: string;
     sourceHead: string;
     pluginCount: number;
     snapshotDigest: string;
-    planId: string;
-    descriptorDigest: string;
+    planDigest: string;
+    descriptor: CatalogPublicationDescriptor;
+    journalPath: string;
+    repositoryPath: string | null;
+}
+export interface CatalogPublishPlanReceipt extends CatalogPublishReceiptBase {
+    command: 'catalog:publish:plan';
+    state: CatalogPublicationJournal['state'];
 }
-export declare function catalogPublicationDescriptorDigest(descriptor: CatalogPublicationDescriptor): string;
-export declare function publishPreparedCatalogPublication(options: {
+export interface CatalogPublishApplyReceipt extends CatalogPublishReceiptBase {
+    command: 'catalog:publish:apply';
+    state: 'published';
+    commit: string;
+    reconciliation: 'already-published' | 'already-remote' | 'atomic' | 'tag' | 'branch';
+    warnings: string[];
+}
+export declare const CATALOG_PUBLICATION_CLEANUP_WARNING = "Catalog publication succeeded, but local repository cleanup did not complete. Retry apply with the same plan digest.";
+interface ReceiptResolution {
+    workspaceRootResolvedFrom?: CatalogWorkspaceResolvedFrom;
+    remoteResolvedFrom?: CatalogRemoteResolvedFrom;
+    branchResolvedFrom?: CatalogBranchResolvedFrom;
+}
+interface PublicationTargetOptions {
     workspaceRoot: string;
     remote?: string;
     remoteUrl?: string;
     branch?: string;
-    descriptor: CatalogPublicationDescriptor;
-    snapshotRoot: string;
     env: NodeJS.ProcessEnv;
+}
+interface PersistPlanHooks {
+    beforeFinalRename?: (paths: {
+        temporaryStateRoot: string;
+        finalStateRoot: string;
+    }) => Promise<void>;
+}
+interface ApplyPlanHooks {
     beforeRemoteWrite?: () => Promise<void>;
-}): Promise<CatalogPublishReceipt>;
-export declare function runCatalogPublishCommand(options: {
-    workspaceRoot: string;
+    removeRepository?: (repositoryPath: string) => Promise<void>;
+}
+export declare function persistCatalogPublicationPlan(options: {
+    preparation: CatalogPublicationPreparation;
+    descriptor?: CatalogPublicationDescriptor;
+    snapshotRoot?: string;
+    workspaceRootResolvedFrom?: CatalogWorkspaceResolvedFrom;
+    remoteResolvedFrom?: CatalogRemoteResolvedFrom;
+    branchResolvedFrom?: CatalogBranchResolvedFrom;
+} & PersistPlanHooks): Promise<CatalogPublishPlanReceipt>;
+export declare function prepareCatalogPublicationPlan(options: PublicationTargetOptions & ReceiptResolution & PersistPlanHooks & {
+    officialPluginHistory?: readonly CatalogManifestV7Entry[];
+    sourcePluginVersionsAtBaseline?: Readonly<Record<string, string>>;
+}): Promise<CatalogPublishPlanReceipt>;
+export declare function applyCatalogPublicationPlan(options: PublicationTargetOptions & {
+    expectedPlanDigest: string;
+} & ReceiptResolution & ApplyPlanHooks): Promise<CatalogPublishApplyReceipt>;
+export declare function runCatalogPublishPlanCommand(options: {
+    cwd: string;
+    workspaceRoot?: string;
+    remote?: string;
+    branch?: string;
+    env: NodeJS.ProcessEnv;
+    io: CatalogPublishIo;
+}): Promise<CatalogPublishPlanReceipt>;
+export declare function runCatalogPublishApplyCommand(options: {
+    cwd: string;
+    workspaceRoot?: string;
     remote?: string;
     branch?: string;
-    expectedDescriptorDigest?: string;
+    expectedPlanDigest?: string;
     yes?: boolean;
     json?: boolean;
     env: NodeJS.ProcessEnv;
     interactive: boolean;
     confirm?: (message: string) => Promise<boolean>;
     io: CatalogPublishIo;
-}): Promise<CatalogPublishReceipt | null>;
+}): Promise<CatalogPublishApplyReceipt | null>;