@treeseed/cli 0.4.7 → 0.4.9

package/README.md

@@ -19,6 +19,14 @@ npm install @treeseed/cli @treeseed/core @treeseed/sdk
 
 `@treeseed/cli` is a thin installable wrapper over `@treeseed/sdk` workflow and operations interfaces plus the `@treeseed/core` runtime namespaces. `treeseed dev` and `treeseed agents ...` resolve and delegate to the tenant-installed or sibling-workspace `@treeseed/core` runtime. In normal consumer installs, npm resolves the runtime dependencies automatically.
 
+Workflow guarantees:
+
+- `treeseed init`, `treeseed config`, and `treeseed release` resolve the project from nested directories and do not rely on the currently checked-out task branch.
+- `treeseed switch` requires a clean worktree before leaving the current branch and creates new task branches from the latest `staging`.
+- `treeseed save` is the canonical checkpoint command: it syncs the current branch with origin, succeeds even when no new changes exist, and can create or refresh preview deployments with `--preview`.
+- `treeseed stage` and `treeseed close` auto-save meaningful uncommitted task-branch changes before merge or cleanup, then leave the repository on `staging`.
+- `treeseed release` completes on `staging` after promoting `staging` into `main` and pushing the release tag.
+
 After installation, the published binary is available as:
 
 ```bash
@@ -34,7 +42,7 @@ The main workflow commands exposed by the current CLI are:
 - `treeseed tasks [--json]`
 - `treeseed switch <branch-name> [--preview]`
 - `treeseed dev`
-- `treeseed save "<commit message>"`
+- `treeseed save [--preview] "<commit message>"`
 - `treeseed stage "<resolution message>"`
 - `treeseed close "<close reason>"`
 - `treeseed release --major|--minor|--patch`
@@ -51,7 +59,7 @@ treeseed status
 treeseed config
 treeseed switch feature/search-improvements --preview
 treeseed dev
-treeseed save "feat: add search filters"
+treeseed save --preview "feat: add search filters"
 treeseed stage "feat: add search filters"
 treeseed release --patch
 treeseed status --json

package/dist/cli/handlers/close.js

@@ -11,8 +11,10 @@ const handleClose = async (invocation, context) => {
       summary: "Treeseed close completed successfully.",
       facts: [
         { label: "Closed branch", value: payload.branchName },
+        { label: "Auto-saved", value: payload.autoSaved ? "yes" : "no" },
         { label: "Deprecated tag", value: payload.deprecatedTag.tagName },
-        { label: "Preview cleanup", value: payload.previewCleanup.performed ? "performed" : "not needed" }
+        { label: "Preview cleanup", value: payload.previewCleanup.performed ? "performed" : "not needed" },
+        { label: "Final branch", value: payload.finalBranch }
       ],
       nextSteps: renderWorkflowNextSteps(result),
       report: payload

package/dist/cli/handlers/config-ui.d.ts

@@ -0,0 +1,72 @@
+import { type UiViewportLayout } from '../ui/framework.js';
+type ConfigScope = 'all' | 'local' | 'staging' | 'prod';
+export type ConfigViewMode = 'startup' | 'full';
+type ConfigEntry = {
+    id: string;
+    label: string;
+    group: string;
+    description: string;
+    howToGet: string;
+    sensitivity: 'secret' | 'plain' | 'derived';
+    targets: string[];
+    purposes: string[];
+    storage: 'shared' | 'scoped';
+    scope: Exclude<ConfigScope, 'all'>;
+    sharedScopes: Array<Exclude<ConfigScope, 'all'>>;
+    required: boolean;
+    currentValue: string;
+    suggestedValue: string;
+    effectiveValue: string;
+};
+type ConfigContextSnapshot = {
+    project: {
+        name: string;
+        slug: string;
+    };
+    scopes: Array<Exclude<ConfigScope, 'all'>>;
+    entriesByScope: Record<Exclude<ConfigScope, 'all'>, ConfigEntry[]>;
+    authStatusByScope: Record<Exclude<ConfigScope, 'all'>, {
+        gh: {
+            authenticated: boolean;
+        };
+        wrangler: {
+            authenticated: boolean;
+        };
+        railway: {
+            authenticated: boolean;
+        };
+    }>;
+};
+export type ConfigPage = {
+    key: string;
+    entry: ConfigEntry;
+    scope: Exclude<ConfigScope, 'all'>;
+    scopes: Array<Exclude<ConfigScope, 'all'>>;
+    required: boolean;
+    currentValue: string;
+    suggestedValue: string;
+    finalValue: string;
+    wizardRequiredMissing: boolean;
+};
+export type ConfigWizardStep = ConfigPage & {
+    index: number;
+    total: number;
+};
+export type ConfigEditorResult = {
+    overrides: Record<string, string>;
+    viewMode: ConfigViewMode;
+};
+export type ConfigViewportLayout = UiViewportLayout & {
+    sidebarWidth: number;
+    contentWidth: number;
+    detailHeight: number;
+    detailViewportHeight: number;
+    inputHeight: number;
+    actionRowHeight: number;
+};
+export declare function computeConfigViewportLayout(rows: number, columns: number): ConfigViewportLayout;
+export declare function buildCliConfigPages(context: ConfigContextSnapshot, selectedFilter: ConfigScope, overrides?: Record<string, string>, viewMode?: ConfigViewMode): ConfigPage[];
+export declare function runCliConfigEditor(context: ConfigContextSnapshot, options?: {
+    initialViewMode?: ConfigViewMode;
+}): Promise<ConfigEditorResult | null>;
+export {};