@sleepy-hollow/framework 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to Sleepy Hollow are documented in this file.
 
+## 0.3.1 - 2026-08-20
+
+### Changed: local Fly deployment preparation
+
+`hollow deploy` no longer attempts to authenticate with Fly, upload an image,
+or run live health and smoke checks. Use `hollow deploy prepare` to create or
+validate a managed `Dockerfile`, `.dockerignore`, and `fly.toml` locally, then
+review them and run Fly's own commands yourself.
+
+The SQLite profile prepares one `data` volume mounted at `/data`; the PostgreSQL
+profile names `DATABASE_URL` as an operator-provided secret without writing its
+value. This keeps Fly-specific scaling, Machines, regions, release behavior,
+and account actions in Fly's tools while preserving a portable container and
+database boundary for future hosts.
+
 ## 0.3.0 - 2026-08-19
 
 ### Breaking: Node and Bun platform migration

package/README.md

@@ -65,14 +65,14 @@ explicit file path in production; the Todo example demonstrates that profile.
 For multi-instance or externally managed storage, configure the optional
 PostgreSQL profile through `DATABASE_URL`.
 
-`hollow deploy` is provider-oriented. Fly.io is the first adapter and uses a
-Docker image plus `flyctl`; its persistent volume is suitable for SQLite. The
-application/server boundary and OCI image are portable, so future adapters can
-target other hosts without changing route or database code.
+`hollow deploy prepare` creates local, reviewable deployment artifacts for
+Fly.io; it never reads a Fly token, calls Fly, or deploys. The generated
+Dockerfile keeps the application boundary portable, so future preparation
+targets can support other hosts without changing route or database code.
 
 ```bash
-export FLY_API_TOKEN=your-app-scoped-token
-hollow deploy --target fly:my-api
+hollow deploy prepare --target fly:my-api --database sqlite --region iad
+# Review Dockerfile, .dockerignore, and fly.toml, then run the printed Fly commands.
 ```
 
 ## Documentation

package/dist/cli.d.ts

@@ -44,7 +44,6 @@ interface GenerationResult {
     readonly wrote: boolean;
 }
 
-type CheckPhase = "governance" | "runner" | "traceability" | "routes" | "schemas" | "security" | "data" | "configuration" | "generated" | "changes" | "eligibility";
 type RequestedCheckScope = {
     readonly kind: "full";
 } | {
@@ -55,30 +54,6 @@ type RequestedCheckScope = {
     readonly method: string;
     readonly path: string;
 };
-interface CheckLocation {
-    readonly path?: string;
-    readonly route?: string;
-    readonly requirementId?: string;
-    readonly criterionId?: string;
-    readonly field?: string;
-    readonly operation?: string;
-    readonly configKey?: string;
-}
-interface CheckDiagnostic {
-    readonly code: string;
-    readonly severity: "error" | "warning";
-    readonly phase: CheckPhase;
-    readonly summary: string;
-    readonly location: CheckLocation;
-    readonly evidence: Readonly<Record<string, unknown>>;
-    readonly correction: string;
-}
-interface VerificationCheck {
-    readonly id: string;
-    readonly phase: CheckPhase;
-    readonly status: "passed" | "failed" | "skipped";
-    readonly evidence: readonly string[];
-}
 interface CheckRequirement extends RequirementEvidence {
     readonly path: string;
     readonly routePath?: string;
@@ -171,78 +146,6 @@ interface VerificationInventory {
     readonly hasUnownedSharedChange?: boolean;
     readonly sourceClaims?: Readonly<Record<string, unknown>>;
 }
-interface CheckResult {
-    readonly schema: "sleepy-hollow-check-result/v1";
-    readonly ok: boolean;
-    readonly command: "check";
-    readonly projectRoot: string;
-    readonly requestedScope: RequestedCheckScope;
-    readonly effectiveScope: "full" | "targeted";
-    readonly selectedRequirements: readonly string[];
-    readonly selectedTests: readonly string[];
-    readonly checks: readonly VerificationCheck[];
-    readonly diagnostics: readonly CheckDiagnostic[];
-    readonly summary: {
-        readonly passed: number;
-        readonly failed: number;
-        readonly skipped: number;
-        readonly errors: number;
-        readonly warnings: number;
-    };
-}
-
-declare const DEPLOY_TARGET_KINDS: readonly ["fly"];
-type DeployTargetKind = (typeof DEPLOY_TARGET_KINDS)[number];
-interface DeployTarget {
-    readonly kind: DeployTargetKind;
-    readonly project: string;
-}
-interface SmokeTestDefinition {
-    readonly id: string;
-    readonly description: string;
-    readonly method: string;
-    readonly path: string;
-    readonly expectedStatus: number;
-    readonly required: boolean;
-}
-interface SmokeTestOutcome {
-    readonly id: string;
-    readonly status: "passed" | "failed";
-    readonly observedStatus?: number;
-    readonly evidence: string;
-}
-interface DeployInventory {
-    readonly projectRootDisplay: string;
-    readonly target: DeployTarget;
-    readonly revision: string;
-    readonly deployedRevision?: string;
-    readonly verification: CheckResult;
-    readonly environmentKeys: readonly string[];
-    readonly deployedEnvironmentKeys: readonly string[];
-    readonly contractChanges: readonly ContractChange[];
-    readonly openApiPath: string;
-    readonly documentationPath: string;
-    readonly smokeTests: readonly SmokeTestDefinition[];
-    readonly firstExternalDeployment: boolean;
-}
-interface DeployUpload {
-    readonly url: string;
-    readonly revision: string;
-}
-interface DeployAdapter {
-    upload(options: {
-        readonly target: DeployTarget;
-        readonly revision: string;
-        readonly token: string;
-    }): DeployUpload | Promise<DeployUpload>;
-    health(options: {
-        readonly url: string;
-    }): SmokeTestOutcome | Promise<SmokeTestOutcome>;
-    smoke(options: {
-        readonly url: string;
-        readonly test: SmokeTestDefinition;
-    }): SmokeTestOutcome | Promise<SmokeTestOutcome>;
-}
 
 type RequestedTestScope = {
     readonly kind: "full";
@@ -384,11 +287,6 @@ interface CliDependencies {
         readonly scope: VerificationInventory["requestedScope"];
     }) => VerificationInventory | Promise<VerificationInventory>;
     readonly testInventoryLoader?: TestInventoryLoader;
-    readonly deployInventoryLoader?: (options: {
-        readonly projectRoot: string;
-    }) => DeployInventory | Promise<DeployInventory>;
-    readonly deployAdapter?: DeployAdapter;
-    readonly deployToken?: () => string;
     readonly testRunner?: TestRunner;
     readonly commands?: Partial<Record<CliCommandName, CliCommandHandler>>;
 }
@@ -409,7 +307,7 @@ interface CliDependencies {
  */
 
 /** Version of the CLI, reported by `hollow --version`. */
-declare const VERSION = "0.3.0";
+declare const VERSION = "0.3.1";
 /**
  * Runs one CLI invocation against caller-supplied I/O.
  *