@agentxm/extension-lifecycle 0.28.12 → 0.28.13

package/dist/src/workflows/install-command/workflow.d.ts

@@ -1,56 +0,0 @@
-/**
- * Shared install command workflow orchestration.
- *
- * Defines the `InstallExtensionCommandWorkflowActions` interface and
- * `runInstallCommandWorkflow` function shared by all install command handlers.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import type * as Scope from "effect/Scope";
-import type { Plan } from "@agentxm/workspace-operations";
-import type { OperationResolution } from "@agentxm/workspace-operations";
-import type { PlanExecution } from "@agentxm/workspace-operations";
-/**
- * Type-specific actions for install command workflows.
- *
- * Each extension type provides its own implementation of these actions.
- * The generic type parameters allow full type safety per extension type.
- *
- * @typeParam Args - Raw command arguments from the active CLI parser
- * @typeParam Parsed - Parsed/validated arguments
- * @typeParam Req - Source request type (for resolution)
- * @typeParam Ref - Extension ref type (discovery output)
- * @typeParam Intent - Command-specific install intent
- * @typeParam ParseError - Failures the argument/plan phases surface
- * @typeParam ResolveError - Failures the interactive resolution phases surface
- */
-export interface InstallExtensionCommandWorkflowActions<Args, Parsed, Req, Ref, Intent, ParseError, ResolveError = ParseError> {
-    readonly parseArgs: (args: Args) => Effect.Effect<Parsed, ParseError>;
-    readonly resolveSourceRequests: (parsed: Parsed) => Effect.Effect<ReadonlyArray<Req>, ResolveError>;
-    readonly discoverRefs: (reqs: ReadonlyArray<Req>) => Effect.Effect<ReadonlyArray<Ref>, ParseError, Scope.Scope>;
-    readonly finalizeIntent: (parsed: Parsed, refs: ReadonlyArray<Ref>) => Effect.Effect<Intent, ResolveError>;
-    readonly buildPlan: (intent: Intent) => Effect.Effect<Plan, ParseError>;
-}
-/**
- * Run the canonical install command workflow.
- *
- * Executes phases in order: parse -> resolveSource -> discover ->
- * finalizeIntent -> buildPlan -> previewOrApplyPlan.
- */
-export declare const buildInstallCommandPlan: <Args, Parsed, Req, Ref, Intent, ParseError, ResolveError, TransformError = never, TransformRequirements = never>(args: Args, actions: InstallExtensionCommandWorkflowActions<Args, Parsed, Req, Ref, Intent, ParseError, ResolveError>, options?: {
-    readonly transformIntent?: (intent: Intent) => Intent;
-    readonly transformPlan?: (plan: Plan) => Effect.Effect<Plan, TransformError, TransformRequirements>;
-}) => Effect.Effect<Plan<never, never>, ParseError | ResolveError | TransformError, import("@agentxm/workspace-state").WorkspaceMutations | import("effect/FileSystem").FileSystem | import("effect/Path").Path | Scope.Scope | TransformRequirements>;
-/**
- * Run the canonical install command workflow.
- *
- * Executes phases in order: parse -> resolveSource -> discover ->
- * finalizeIntent -> buildPlan -> previewOrApplyPlan.
- */
-export declare const runInstallCommandWorkflow: <Args, Parsed, Req, Ref, Intent, ParseError, ResolveError, TransformError = never, TransformRequirements = never>(args: Args, actions: InstallExtensionCommandWorkflowActions<Args, Parsed, Req, Ref, Intent, ParseError, ResolveError>, options: {
-    readonly execution: PlanExecution;
-    readonly transformIntent?: (intent: Intent) => Intent;
-    readonly transformPlan?: (plan: Plan) => Effect.Effect<Plan, TransformError, TransformRequirements>;
-}) => Effect.Effect<OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | ParseError | ResolveError | TransformError | import("@agentxm/workspace-operations").CandidateFingerprintFailed | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-state").WorkspaceTransitionAcquireFailure | import("@agentxm/workspace-state").LockfileValidationError, import("@agentxm/workspace-state").WorkspaceMutations | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-operations").ResolvePlanInteraction | Exclude<TransformRequirements, Scope.Scope>>;
-//# sourceMappingURL=workflow.d.ts.map

package/dist/src/workflows/install-command/workflow.js

@@ -1,46 +0,0 @@
-/**
- * Shared install command workflow orchestration.
- *
- * Defines the `InstallExtensionCommandWorkflowActions` interface and
- * `runInstallCommandWorkflow` function shared by all install command handlers.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import { observeUnit, previewOrApplyPlan, publishPhaseStarted, } from "@agentxm/workspace-operations";
-import { withPublisherTrust } from "../../publisher-binding.js";
-// -----------------------------------------------------------------------------
-// Install Command Workflow
-// -----------------------------------------------------------------------------
-/**
- * Run the canonical install command workflow.
- *
- * Executes phases in order: parse -> resolveSource -> discover ->
- * finalizeIntent -> buildPlan -> previewOrApplyPlan.
- */
-export const buildInstallCommandPlan = (args, actions, options) => Effect.gen(function* () {
-    const parsed = yield* actions.parseArgs(args);
-    // Source resolution is the first lifecycle phase: requested sources become
-    // concrete refs, observed as one unit under `resolution`.
-    yield* publishPhaseStarted("resolution");
-    const refs = yield* observeUnit({ id: "extension-sources", label: "extension sources" }, Effect.flatMap(actions.resolveSourceRequests(parsed), (sourceRequests) => actions.discoverRefs(sourceRequests)));
-    const finalizedIntent = yield* actions.finalizeIntent(parsed, refs);
-    const intent = options?.transformIntent?.(finalizedIntent) ?? finalizedIntent;
-    const plan = yield* actions.buildPlan(intent);
-    const transformed = options?.transformPlan === undefined ? plan : yield* options.transformPlan(plan);
-    // Every acceptance the plan proposes is classified against the accepted
-    // resolution here, so root, type, reinstall, and closure routes share one
-    // publisher-trust rule.
-    return yield* withPublisherTrust(transformed);
-});
-/**
- * Run the canonical install command workflow.
- *
- * Executes phases in order: parse -> resolveSource -> discover ->
- * finalizeIntent -> buildPlan -> previewOrApplyPlan.
- */
-export const runInstallCommandWorkflow = (args, actions, options) => Effect.gen(function* () {
-    const plan = yield* buildInstallCommandPlan(args, actions, options);
-    return yield* previewOrApplyPlan(plan, { execution: options.execution });
-}).pipe(Effect.scoped, Effect.map((resolution) => resolution));
-//# sourceMappingURL=workflow.js.map

package/dist/src/workflows/uninstall-command/workflow.d.ts

@@ -1,42 +0,0 @@
-/**
- * Shared uninstall command workflow orchestration.
- *
- * Defines the `UninstallExtensionCommandWorkflowActions` interface and
- * `runUninstallCommandWorkflow` function shared by all uninstall command handlers.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import type { Plan } from "@agentxm/workspace-operations";
-import type { StepFailure } from "@agentxm/workspace-operations";
-import type { OperationResolution } from "@agentxm/workspace-operations";
-import type { PlanExecution } from "@agentxm/workspace-operations";
-/**
- * Type-specific actions for uninstall command workflows.
- *
- * Each extension type provides its own implementation of these actions.
- * The generic type parameters allow full type safety per extension type.
- *
- * @typeParam Args - Raw command arguments from the active CLI parser
- * @typeParam Parsed - Parsed/validated arguments
- * @typeParam Intent - Command-specific uninstall intent
- * @typeParam E - Failures the phases surface
- */
-export interface UninstallExtensionCommandWorkflowActions<Args, Parsed, Intent, E> {
-    readonly parseArgs: (args: Args) => Effect.Effect<Parsed, E>;
-    readonly finalizeIntent: (parsed: Parsed) => Effect.Effect<Intent, E>;
-    readonly buildUninstallPlan: (intent: Intent, flags: UninstallWorkflowFlags) => Effect.Effect<Plan, E>;
-}
-export interface UninstallWorkflowFlags {
-    readonly execution: PlanExecution;
-    /** Optional delayed gate; candidate freshness is checked again after it completes. */
-    readonly beforeApply?: () => Effect.Effect<void, StepFailure>;
-}
-/**
- * Run the canonical uninstall command workflow.
- *
- * Executes phases in order: parse -> finalizeIntent -> buildUninstallPlan ->
- * previewOrApplyPlan.
- */
-export declare const runUninstallCommandWorkflow: <Args, Parsed, Intent, E>(args: Args, actions: UninstallExtensionCommandWorkflowActions<Args, Parsed, Intent, E>, flags: UninstallWorkflowFlags) => Effect.Effect<OperationResolution<never>, import("@agentxm/workspace-state").WorkspaceSettingsReadFailure | import("@agentxm/workspace-operations").CandidateFingerprintFailed | import("@agentxm/workspace-operations").ApprovalRecoveryMissing | import("@agentxm/workspace-operations").PlanInteractionFailed | import("@agentxm/workspace-state").WorkspaceTransitionAcquireFailure | import("@agentxm/workspace-state").LockfileValidationError | E, import("@agentxm/workspace-state").WorkspaceMutations | import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("@agentxm/workspace-operations").ResolvePlanInteraction>;
-//# sourceMappingURL=workflow.d.ts.map

package/dist/src/workflows/uninstall-command/workflow.js

@@ -1,29 +0,0 @@
-/**
- * Shared uninstall command workflow orchestration.
- *
- * Defines the `UninstallExtensionCommandWorkflowActions` interface and
- * `runUninstallCommandWorkflow` function shared by all uninstall command handlers.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import { previewOrApplyPlan } from "@agentxm/workspace-operations";
-// -----------------------------------------------------------------------------
-// Uninstall Command Workflow
-// -----------------------------------------------------------------------------
-/**
- * Run the canonical uninstall command workflow.
- *
- * Executes phases in order: parse -> finalizeIntent -> buildUninstallPlan ->
- * previewOrApplyPlan.
- */
-export const runUninstallCommandWorkflow = (args, actions, flags) => Effect.gen(function* () {
-    const parsed = yield* actions.parseArgs(args);
-    const intent = yield* actions.finalizeIntent(parsed);
-    const plan = yield* actions.buildUninstallPlan(intent, flags);
-    return yield* previewOrApplyPlan(plan, {
-        execution: flags.execution,
-        ...(flags.beforeApply === undefined ? {} : { beforeApply: flags.beforeApply }),
-    });
-}).pipe(Effect.map((resolution) => resolution));
-//# sourceMappingURL=workflow.js.map