@treeseed/cli 0.1.1

package/dist/cli/registry.js

@@ -0,0 +1,445 @@
+import { handleInit } from "./handlers/init.js";
+import { handleConfig } from "./handlers/config.js";
+import { handleStart } from "./handlers/start.js";
+import { handleClose } from "./handlers/close.js";
+import { handleDeploy } from "./handlers/deploy.js";
+import { handleSave } from "./handlers/save.js";
+import { handleRelease } from "./handlers/release.js";
+import { handleDestroy } from "./handlers/destroy.js";
+import { handleStatus } from "./handlers/status.js";
+import { handleNext } from "./handlers/next.js";
+import { handleDoctor } from "./handlers/doctor.js";
+import { handleSetup } from "./handlers/setup.js";
+import { handleWork } from "./handlers/work.js";
+import { handleShip } from "./handlers/ship.js";
+import { handlePrepare } from "./handlers/prepare.js";
+import { handlePublish } from "./handlers/publish.js";
+import { handlePromote } from "./handlers/promote.js";
+import { handleTeardown } from "./handlers/teardown.js";
+import { handleContinue } from "./handlers/continue.js";
+import { handleRollback } from "./handlers/rollback.js";
+const COMMAND_HANDLERS = {
+  init: handleInit,
+  config: handleConfig,
+  start: handleStart,
+  close: handleClose,
+  deploy: handleDeploy,
+  save: handleSave,
+  release: handleRelease,
+  destroy: handleDestroy,
+  status: handleStatus,
+  next: handleNext,
+  doctor: handleDoctor,
+  setup: handleSetup,
+  work: handleWork,
+  ship: handleShip,
+  prepare: handlePrepare,
+  publish: handlePublish,
+  promote: handlePromote,
+  teardown: handleTeardown,
+  continue: handleContinue,
+  rollback: handleRollback
+};
+function command(spec) {
+  return spec;
+}
+const TRESEED_COMMAND_SPECS = [
+  command({
+    name: "setup",
+    aliases: [],
+    group: "Workflow",
+    summary: "Bootstrap the local Treeseed workspace and environments.",
+    description: "Run safe local repairs, initialize local configuration, and prepare the selected environments for development and release work.",
+    usage: "treeseed setup [--environment <local|staging|prod>]... [--sync <none|github|cloudflare|all>] [--json]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Limit setup to local, staging, or prod.", kind: "enum", repeatable: true, values: ["local", "staging", "prod"] },
+      { name: "sync", flags: "--sync <mode>", description: "Optionally sync GitHub or Cloudflare settings.", kind: "enum", values: ["none", "github", "cloudflare", "all"] },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed setup", "treeseed setup --environment local --environment staging"],
+    related: ["doctor", "prepare", "dev"],
+    executionMode: "handler",
+    handlerName: "setup"
+  }),
+  command({
+    name: "work",
+    aliases: [],
+    group: "Workflow",
+    summary: "Create or resume a feature branch from the workflow state.",
+    description: "Create a new feature branch from staging or resume an existing branch, optionally provisioning a preview deployment.",
+    usage: "treeseed work <branch-name> [--preview] [--json]",
+    arguments: [{ name: "branch-name", description: "Feature branch to create or resume.", required: true }],
+    options: [
+      { name: "preview", flags: "--preview", description: "Provision or refresh a branch-scoped Cloudflare preview environment.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed work feature/search-improvements", "treeseed work feature/search-improvements --preview"],
+    related: ["ship", "publish", "teardown"],
+    executionMode: "handler",
+    handlerName: "work"
+  }),
+  command({
+    name: "ship",
+    aliases: [],
+    group: "Workflow",
+    summary: "Persist and publish the current branch at the intent level.",
+    description: "Commit and push the current branch, refreshing a branch preview when one is enabled.",
+    usage: "treeseed ship [--hotfix] <message> [--json]",
+    arguments: [{ name: "message", description: "Git commit message for the ship operation.", required: true, kind: "message_tail" }],
+    options: [
+      { name: "hotfix", flags: "--hotfix", description: "Allow ship on main for an explicit hotfix.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ['treeseed ship "feat: add search filters"'],
+    related: ["work", "publish", "promote"],
+    executionMode: "handler",
+    handlerName: "ship"
+  }),
+  command({
+    name: "prepare",
+    aliases: [],
+    group: "Workflow",
+    summary: "Prepare persistent environments for later publication.",
+    description: "Alias for persistent environment setup and validation.",
+    usage: "treeseed prepare [--environment <local|staging|prod>]... [--sync <none|github|cloudflare|all>] [--json]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Limit preparation to local, staging, or prod.", kind: "enum", repeatable: true, values: ["local", "staging", "prod"] },
+      { name: "sync", flags: "--sync <mode>", description: "Optionally sync GitHub or Cloudflare settings.", kind: "enum", values: ["none", "github", "cloudflare", "all"] },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed prepare --environment staging --environment prod"],
+    related: ["setup", "publish", "config"],
+    executionMode: "handler",
+    handlerName: "prepare"
+  }),
+  command({
+    name: "publish",
+    aliases: [],
+    group: "Workflow",
+    summary: "Publish the current site or preview target.",
+    description: "Alias for environment or branch publication using an already initialized target.",
+    usage: "treeseed publish --environment <local|staging|prod> [--dry-run] [--only <migrate|build|publish>] [--json]\n  treeseed publish --target-branch <branch> [--dry-run] [--only <migrate|build|publish>] [--json]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Publish to local, staging, or prod.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "targetBranch", flags: "--target-branch <branch>", description: "Publish a branch preview target.", kind: "string" },
+      { name: "dryRun", flags: "--dry-run", description: "Show what would run without publishing changes.", kind: "boolean" },
+      { name: "only", flags: "--only <step>", description: "Limit execution to migrate, build, or publish.", kind: "enum", values: ["migrate", "build", "publish"] },
+      { name: "name", flags: "--name <label>", description: "Attach a friendly label to the publish run.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed publish --environment staging", "treeseed publish --target-branch feature/search-improvements"],
+    related: ["prepare", "ship", "rollback"],
+    executionMode: "handler",
+    handlerName: "publish"
+  }),
+  command({
+    name: "promote",
+    aliases: [],
+    group: "Workflow",
+    summary: "Promote staging to production with a version bump.",
+    description: "Alias for the production promotion workflow built on top of Treeseed release.",
+    usage: "treeseed promote --major|--minor|--patch [--json]",
+    options: [
+      { name: "major", flags: "--major", description: "Bump to the next major version.", kind: "boolean" },
+      { name: "minor", flags: "--minor", description: "Bump to the next minor version.", kind: "boolean" },
+      { name: "patch", flags: "--patch", description: "Bump to the next patch version.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed promote --patch"],
+    related: ["publish", "rollback", "release"],
+    executionMode: "handler",
+    handlerName: "promote"
+  }),
+  command({
+    name: "rollback",
+    aliases: [],
+    group: "Workflow",
+    summary: "Roll back staging or production to a recorded deployment.",
+    description: "Redeploy a previously recorded staging or production commit using a temporary checkout of that revision.",
+    usage: "treeseed rollback <staging|prod> [--to <deploy-id|commit>] [--json]",
+    arguments: [{ name: "environment", description: "The persistent environment to roll back.", required: true }],
+    options: [
+      { name: "to", flags: "--to <deploy-id|commit>", description: "Explicit commit to roll back to. Defaults to the previous recorded deployment when omitted.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed rollback staging", "treeseed rollback prod --to abc1234"],
+    related: ["publish", "promote", "status"],
+    executionMode: "handler",
+    handlerName: "rollback"
+  }),
+  command({
+    name: "teardown",
+    aliases: [],
+    group: "Workflow",
+    summary: "Clean up a feature branch or destroy a persistent environment.",
+    description: "Close the current feature branch or destroy a selected persistent environment when `--environment` is provided.",
+    usage: "treeseed teardown [--environment <local|staging|prod>] [--dry-run] [--json]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Destroy a persistent environment instead of closing the current feature branch.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "dryRun", flags: "--dry-run", description: "Preview the teardown operation without mutating state.", kind: "boolean" },
+      { name: "force", flags: "--force", description: "Force worker deletion when supported.", kind: "boolean" },
+      { name: "skipConfirmation", flags: "--skip-confirmation", description: "Skip the interactive confirmation prompt for persistent destroys.", kind: "boolean" },
+      { name: "confirm", flags: "--confirm <slug>", description: "Provide the expected slug confirmation non-interactively.", kind: "string" },
+      { name: "removeBuildArtifacts", flags: "--remove-build-artifacts", description: "Also remove local build artifacts after destroy.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed teardown", "treeseed teardown --environment staging --dry-run"],
+    related: ["work", "rollback", "destroy"],
+    executionMode: "handler",
+    handlerName: "teardown"
+  }),
+  command({
+    name: "continue",
+    aliases: [],
+    group: "Workflow",
+    summary: "Show the safest next Treeseed step from the current state.",
+    description: "Use the workflow-state resolver to return the top recommended next action.",
+    usage: "treeseed continue [--json]",
+    options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
+    examples: ["treeseed continue"],
+    related: ["status", "next", "doctor"],
+    executionMode: "handler",
+    handlerName: "continue"
+  }),
+  command({
+    name: "status",
+    aliases: [],
+    group: "Workflow",
+    summary: "Show the current Treeseed workflow state.",
+    description: "Report the current branch, environment mapping, initialization state, preview state, and auth readiness.",
+    usage: "treeseed status [--json]",
+    options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
+    examples: ["treeseed status", "treeseed status --json"],
+    related: ["next", "continue", "doctor"],
+    executionMode: "handler",
+    handlerName: "status"
+  }),
+  command({
+    name: "next",
+    aliases: [],
+    group: "Workflow",
+    summary: "Recommend the next Treeseed commands for the current state.",
+    description: "Inspect the current branch and environment state, then suggest the most likely next commands.",
+    usage: "treeseed next [--json]",
+    options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
+    examples: ["treeseed next", "treeseed next --json"],
+    related: ["status", "continue", "work"],
+    executionMode: "handler",
+    handlerName: "next"
+  }),
+  command({
+    name: "doctor",
+    aliases: [],
+    group: "Validation",
+    summary: "Diagnose Treeseed tooling, auth, and workflow readiness.",
+    description: "Validate local prerequisites, auth state, repository shape, and generated Treeseed files needed for development and release work.",
+    usage: "treeseed doctor [--fix] [--json]",
+    options: [
+      { name: "fix", flags: "--fix", description: "Apply safe local repairs before rerunning diagnostics.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed doctor", "treeseed doctor --fix --json"],
+    related: ["status", "next", "setup"],
+    executionMode: "handler",
+    handlerName: "doctor"
+  }),
+  command({
+    name: "init",
+    aliases: [],
+    group: "Workflow",
+    summary: "Scaffold a new Treeseed tenant project.",
+    description: "Create a new Treeseed tenant directory with starter files and recommended next steps.",
+    usage: "treeseed init <directory> [--template <starter-id>] [--name <site-name>] [--slug <slug>] [--site-url <url>] [--contact-email <email>] [--repo <url>] [--discord <url>]",
+    arguments: [{ name: "directory", description: "Target directory for the new tenant.", required: true }],
+    options: [
+      { name: "template", flags: "--template <starter-id>", description: "Select the starter template id to generate. Defaults to starter-basic.", kind: "string" },
+      { name: "name", flags: "--name <site-name>", description: "Override the generated site name.", kind: "string" },
+      { name: "slug", flags: "--slug <slug>", description: "Override the generated package and tenant slug.", kind: "string" },
+      { name: "siteUrl", flags: "--site-url <url>", description: "Set the initial public site URL.", kind: "string" },
+      { name: "contactEmail", flags: "--contact-email <email>", description: "Set the site contact address.", kind: "string" },
+      { name: "repo", flags: "--repo <url>", description: "Set the repository URL.", kind: "string" },
+      { name: "discord", flags: "--discord <url>", description: "Set the Discord/community URL.", kind: "string" }
+    ],
+    examples: ['treeseed init docs-site --template starter-basic --name "Docs Site" --site-url https://docs.example.com'],
+    notes: ["Runs outside an existing repo or from any branch."],
+    related: ["config", "start", "deploy"],
+    executionMode: "handler",
+    handlerName: "init"
+  }),
+  command({
+    name: "config",
+    aliases: [],
+    group: "Workflow",
+    summary: "Validate and initialize persistent environments.",
+    description: "Collect environment values, write local machine config, generate local env files, and perform phase-1 initialization.",
+    usage: "treeseed config [--environment <local|staging|prod>]... [--sync <none|github|cloudflare|all>]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Limit configuration to local, staging, or prod.", kind: "enum", repeatable: true, values: ["local", "staging", "prod"] },
+      { name: "sync", flags: "--sync <mode>", description: "Optionally sync GitHub or Cloudflare settings.", kind: "enum", values: ["none", "github", "cloudflare", "all"] },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed config --environment local", "treeseed config --environment staging --environment prod", "treeseed config --environment prod --sync all"],
+    notes: ["Compatibility command. Prefer `treeseed prepare` or `treeseed setup` for the simplified workflow.", "Does not create branch preview deployments."],
+    related: ["prepare", "setup", "publish"],
+    executionMode: "handler",
+    handlerName: "config"
+  }),
+  command({
+    name: "start",
+    aliases: [],
+    group: "Workflow",
+    summary: "Create a feature branch from the latest staging commit.",
+    description: "Switch to the latest staging branch, create a feature branch, and optionally provision a preview deployment.",
+    usage: "treeseed start <branch-name> [--preview]",
+    arguments: [{ name: "branch-name", description: "Feature branch to create from staging.", required: true }],
+    options: [
+      { name: "preview", flags: "--preview", description: "Create and publish a branch-scoped Cloudflare preview environment.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed start feature/search-improvements", "treeseed start feature/search-improvements --preview"],
+    notes: ["Compatibility command. Prefer `treeseed work` for the simplified workflow.", "Refuses to run with a dirty worktree or if the branch already exists."],
+    related: ["work", "ship", "publish"],
+    executionMode: "handler",
+    handlerName: "start"
+  }),
+  command({
+    name: "close",
+    aliases: [],
+    group: "Workflow",
+    summary: "Merge the current feature branch into staging and clean it up.",
+    description: "Validate the current feature branch, merge it into staging, and remove any preview artifacts for that branch.",
+    usage: "treeseed close",
+    options: [{ name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }],
+    examples: ["treeseed close"],
+    notes: ["Compatibility command. Prefer `treeseed teardown` for the simplified workflow.", "Only works on feature branches.", "Refuses to run on staging or main."],
+    related: ["work", "ship", "teardown"],
+    executionMode: "handler",
+    handlerName: "close"
+  }),
+  command({
+    name: "deploy",
+    aliases: [],
+    group: "Workflow",
+    summary: "Run phase-2 deploy for an initialized target.",
+    description: "Validate readiness, run migrations, build, and publish to an initialized persistent environment or branch preview.",
+    usage: "treeseed deploy --environment <local|staging|prod> [--dry-run] [--only <migrate|build|publish>] [--name <label>]\n  treeseed deploy --target-branch <branch> [--dry-run] [--only <migrate|build|publish>]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Deploy to local, staging, or prod.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "targetBranch", flags: "--target-branch <branch>", description: "Deploy a previously initialized branch preview target.", kind: "string" },
+      { name: "dryRun", flags: "--dry-run", description: "Show what would run without publishing changes.", kind: "boolean" },
+      { name: "only", flags: "--only <step>", description: "Limit execution to migrate, build, or publish.", kind: "enum", values: ["migrate", "build", "publish"] },
+      { name: "name", flags: "--name <label>", description: "Attach a friendly label to the deploy run.", kind: "string" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed deploy --environment staging", "treeseed deploy --environment prod --dry-run", "treeseed deploy --target-branch feature/search-improvements"],
+    notes: ["Compatibility command. Prefer `treeseed publish` for the simplified workflow.", "Persistent environments must already be initialized by treeseed config.", "CI may infer staging from `staging` and production from `main`."],
+    related: ["publish", "prepare", "rollback"],
+    executionMode: "handler",
+    handlerName: "deploy"
+  }),
+  command({
+    name: "save",
+    aliases: [],
+    group: "Workflow",
+    summary: "Commit and push the current branch.",
+    description: "Run validation, create a git commit from the current branch, and push that branch without performing merges or releases.",
+    usage: "treeseed save [--hotfix] <message>",
+    arguments: [{ name: "message", description: "Git commit message for the save operation.", required: true, kind: "message_tail" }],
+    options: [
+      { name: "hotfix", flags: "--hotfix", description: "Allow save on main for an explicit hotfix.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ['treeseed save "feat: add search filters"', 'treeseed save --hotfix "fix: unblock production form submit"'],
+    notes: ["Compatibility command. Prefer `treeseed ship` for the simplified workflow.", "Blocked on main unless --hotfix is provided."],
+    related: ["ship", "work", "promote"],
+    executionMode: "handler",
+    handlerName: "save"
+  }),
+  command({
+    name: "release",
+    aliases: [],
+    group: "Workflow",
+    summary: "Promote staging to production with a version bump.",
+    description: "Validate staging, apply exactly one version bump, merge staging into main, and rely on CI to deploy production.",
+    usage: "treeseed release --major|--minor|--patch",
+    options: [
+      { name: "major", flags: "--major", description: "Bump to the next major version.", kind: "boolean" },
+      { name: "minor", flags: "--minor", description: "Bump to the next minor version.", kind: "boolean" },
+      { name: "patch", flags: "--patch", description: "Bump to the next patch version.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed release --patch", "treeseed release --minor"],
+    notes: ["Compatibility command. Prefer `treeseed promote` for the simplified workflow.", "Requires exactly one bump flag."],
+    related: ["promote", "publish", "rollback"],
+    executionMode: "handler",
+    handlerName: "release"
+  }),
+  command({
+    name: "destroy",
+    aliases: [],
+    group: "Workflow",
+    summary: "Destroy a persistent environment and its local state.",
+    description: "Delete the selected persistent environment resources and remove the local deploy state after confirmation.",
+    usage: "treeseed destroy --environment <local|staging|prod> [--dry-run] [--force] [--skip-confirmation] [--confirm <slug>] [--remove-build-artifacts]",
+    options: [
+      { name: "environment", flags: "--environment <scope>", description: "Select the persistent environment to destroy.", kind: "enum", values: ["local", "staging", "prod"] },
+      { name: "dryRun", flags: "--dry-run", description: "Preview the destroy operation.", kind: "boolean" },
+      { name: "force", flags: "--force", description: "Force worker deletion when supported.", kind: "boolean" },
+      { name: "skipConfirmation", flags: "--skip-confirmation", description: "Skip the interactive confirmation prompt.", kind: "boolean" },
+      { name: "confirm", flags: "--confirm <slug>", description: "Provide the expected slug confirmation non-interactively.", kind: "string" },
+      { name: "removeBuildArtifacts", flags: "--remove-build-artifacts", description: "Also remove local build artifacts after destroy.", kind: "boolean" },
+      { name: "json", flags: "--json", description: "Emit machine-readable JSON instead of human-readable text.", kind: "boolean" }
+    ],
+    examples: ["treeseed destroy --environment staging --dry-run", "treeseed destroy --environment prod --confirm example --skip-confirmation"],
+    notes: ["Compatibility command. Prefer `treeseed teardown --environment ...` for the simplified workflow.", "Only for persistent environments. Branch cleanup belongs to treeseed close.", "This command is destructive and requires explicit confirmation."],
+    related: ["teardown", "prepare", "publish"],
+    executionMode: "handler",
+    handlerName: "destroy"
+  }),
+  command({ name: "dev", aliases: [], group: "Local Development", summary: "Start the unified local Treeseed development environment.", description: "Start the unified local Treeseed development environment.", examples: ["treeseed dev"], executionMode: "adapter", adapter: { script: "tenant-dev" } }),
+  command({ name: "dev:watch", aliases: [], group: "Local Development", summary: "Start local development with rebuild/watch mode.", description: "Start local development with rebuild/watch mode.", examples: ["treeseed dev:watch"], executionMode: "adapter", adapter: { script: "tenant-dev", rewriteArgs: (args) => ["--watch", ...args] } }),
+  command({ name: "build", aliases: [], group: "Local Development", summary: "Build the tenant site and generated worker artifacts.", description: "Build the tenant site and generated worker artifacts.", examples: ["treeseed build"], executionMode: "adapter", adapter: { script: "tenant-build" } }),
+  command({ name: "check", aliases: [], group: "Local Development", summary: "Run the tenant check flow.", description: "Run the tenant check flow.", examples: ["treeseed check"], executionMode: "adapter", adapter: { script: "tenant-check" } }),
+  command({ name: "preview", aliases: [], group: "Local Development", summary: "Preview the built tenant site locally.", description: "Preview the built tenant site locally.", examples: ["treeseed preview"], executionMode: "adapter", adapter: { script: "tenant-astro-command", passthroughArgs: true } }),
+  command({ name: "lint", aliases: [], group: "Validation", summary: "Run Treeseed lint checks.", description: "Run Treeseed lint checks.", examples: ["treeseed lint"], executionMode: "adapter", adapter: { directScript: "tenant-lint", workspaceScript: "workspace-lint" } }),
+  command({ name: "test", aliases: [], group: "Validation", summary: "Run Treeseed tests.", description: "Run Treeseed tests.", examples: ["treeseed test"], executionMode: "adapter", adapter: { directScript: "tenant-test", workspaceScript: "workspace-test" } }),
+  command({ name: "test:unit", aliases: [], group: "Validation", summary: "Run workspace unit tests in dependency order.", description: "Run workspace unit tests in dependency order.", examples: ["treeseed test:unit"], executionMode: "adapter", adapter: { script: "workspace-test-unit", requireWorkspaceRoot: true } }),
+  command({ name: "preflight", aliases: [], group: "Validation", summary: "Check local CLI prerequisites and authentication state.", description: "Check local CLI prerequisites and authentication state.", examples: ["treeseed preflight"], executionMode: "adapter", adapter: { script: "workspace-preflight", requireWorkspaceRoot: true } }),
+  command({ name: "auth:check", aliases: [], group: "Validation", summary: "Check CLI prerequisites and require authenticated tooling.", description: "Check CLI prerequisites and require authenticated tooling.", examples: ["treeseed auth:check"], executionMode: "adapter", adapter: { script: "workspace-preflight", extraArgs: ["--require-auth"], requireWorkspaceRoot: true } }),
+  command({ name: "test:e2e", aliases: [], group: "Release Utilities", summary: "Run Treeseed end-to-end command tests.", description: "Run Treeseed end-to-end command tests.", examples: ["treeseed test:e2e"], executionMode: "adapter", adapter: { script: "workspace-command-e2e", requireWorkspaceRoot: true } }),
+  command({ name: "test:e2e:local", aliases: [], group: "Release Utilities", summary: "Run local-mode Treeseed end-to-end command tests.", description: "Run local-mode Treeseed end-to-end command tests.", examples: ["treeseed test:e2e:local"], executionMode: "adapter", adapter: { script: "workspace-command-e2e", extraArgs: ["--mode=local"], requireWorkspaceRoot: true } }),
+  command({ name: "test:e2e:staging", aliases: [], group: "Release Utilities", summary: "Run staging-mode Treeseed end-to-end command tests.", description: "Run staging-mode Treeseed end-to-end command tests.", examples: ["treeseed test:e2e:staging"], executionMode: "adapter", adapter: { script: "workspace-command-e2e", extraArgs: ["--mode=staging"], requireWorkspaceRoot: true } }),
+  command({ name: "test:e2e:full", aliases: [], group: "Release Utilities", summary: "Run the full Treeseed end-to-end command suite.", description: "Run the full Treeseed end-to-end command suite.", examples: ["treeseed test:e2e:full"], executionMode: "adapter", adapter: { script: "workspace-command-e2e", extraArgs: ["--mode=full"], requireWorkspaceRoot: true } }),
+  command({ name: "test:release", aliases: [], group: "Release Utilities", summary: "Run the fast release verification path.", description: "Run the fast release verification path.", examples: ["treeseed test:release"], executionMode: "adapter", adapter: { script: "workspace-release-verify", requireWorkspaceRoot: true } }),
+  command({ name: "test:release:full", aliases: [], group: "Release Utilities", summary: "Run the full release verification path.", description: "Run the full release verification path.", examples: ["treeseed test:release:full"], executionMode: "adapter", adapter: { script: "workspace-release-verify", extraArgs: ["--full-smoke"], requireWorkspaceRoot: true } }),
+  command({ name: "release:verify", aliases: [], group: "Release Utilities", summary: "Run the release verification workflow.", description: "Run the release verification workflow.", examples: ["treeseed release:verify"], executionMode: "adapter", adapter: { script: "workspace-release-verify", extraArgs: ["--full-smoke"], requireWorkspaceRoot: true } }),
+  command({ name: "release:publish:changed", aliases: [], group: "Release Utilities", summary: "Publish changed Treeseed workspace packages.", description: "Publish changed Treeseed workspace packages.", examples: ["treeseed release:publish:changed"], executionMode: "adapter", adapter: { script: "workspace-publish-changed-packages", requireWorkspaceRoot: true } }),
+  command({ name: "astro", aliases: [], group: "Passthrough", summary: "Pass through to the packaged Astro CLI wrapper.", description: "Pass through to the packaged Astro CLI wrapper.", examples: ["treeseed astro -- --help"], executionMode: "adapter", adapter: { script: "tenant-astro-command", passthroughArgs: true } }),
+  command({ name: "sync:devvars", aliases: [], group: "Utilities", summary: "Regenerate .dev.vars from local configuration.", description: "Regenerate .dev.vars from local configuration.", examples: ["treeseed sync:devvars"], executionMode: "adapter", adapter: { script: "sync-dev-vars" } }),
+  command({ name: "mailpit:up", aliases: [], group: "Utilities", summary: "Start the package-managed Mailpit service.", description: "Start the package-managed Mailpit service.", examples: ["treeseed mailpit:up"], executionMode: "adapter", adapter: { script: "ensure-mailpit" } }),
+  command({ name: "mailpit:down", aliases: [], group: "Utilities", summary: "Stop the package-managed Mailpit service.", description: "Stop the package-managed Mailpit service.", examples: ["treeseed mailpit:down"], executionMode: "adapter", adapter: { script: "stop-mailpit" } }),
+  command({ name: "mailpit:logs", aliases: [], group: "Utilities", summary: "Show Mailpit logs.", description: "Show Mailpit logs.", examples: ["treeseed mailpit:logs"], executionMode: "adapter", adapter: { script: "logs-mailpit" } }),
+  command({ name: "d1:migrate:local", aliases: [], group: "Utilities", summary: "Apply local D1 migrations.", description: "Apply local D1 migrations.", examples: ["treeseed d1:migrate:local"], executionMode: "adapter", adapter: { script: "tenant-d1-migrate-local" } }),
+  command({ name: "cleanup:markdown", aliases: [], group: "Utilities", summary: "Normalize Markdown and MDX files.", description: "Normalize Markdown and MDX files.", examples: ["treeseed cleanup:markdown docs/README.md"], executionMode: "adapter", adapter: { script: "cleanup-markdown", rewriteArgs: (args) => ["--write", ...args] } }),
+  command({ name: "cleanup:markdown:check", aliases: [], group: "Utilities", summary: "Check Markdown and MDX formatting without rewriting files.", description: "Check Markdown and MDX formatting without rewriting files.", examples: ["treeseed cleanup:markdown:check docs/README.md"], executionMode: "adapter", adapter: { script: "cleanup-markdown", rewriteArgs: (args) => ["--check", ...args] } }),
+  command({ name: "starlight:patch", aliases: [], group: "Utilities", summary: "Apply the Starlight content path patch.", description: "Apply the Starlight content path patch.", examples: ["treeseed starlight:patch"], executionMode: "adapter", adapter: { script: "patch-starlight-content-path" } })
+];
+const TRESEED_COMMAND_INDEX = /* @__PURE__ */ new Map();
+for (const spec of TRESEED_COMMAND_SPECS) {
+  TRESEED_COMMAND_INDEX.set(spec.name, spec);
+  for (const alias of spec.aliases) TRESEED_COMMAND_INDEX.set(alias, spec);
+}
+function findCommandSpec(name) {
+  if (!name) return null;
+  return TRESEED_COMMAND_INDEX.get(name) ?? null;
+}
+function listCommandNames() {
+  return [...new Set(TRESEED_COMMAND_SPECS.map((spec) => spec.name))];
+}
+export {
+  COMMAND_HANDLERS,
+  TRESEED_COMMAND_INDEX,
+  TRESEED_COMMAND_SPECS,
+  findCommandSpec,
+  listCommandNames
+};

package/dist/cli/repair.js

@@ -0,0 +1,89 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import {
+  createDefaultTreeseedMachineConfig,
+  ensureTreeseedGitignoreEntries,
+  getTreeseedMachineConfigPaths,
+  loadTreeseedMachineConfig,
+  resolveTreeseedMachineEnvironmentValues,
+  writeTreeseedLocalEnvironmentFiles,
+  writeTreeseedMachineConfig
+} from "../scripts/config-runtime-lib.js";
+import { createPersistentDeployTarget, ensureGeneratedWranglerConfig, loadDeployState } from "../scripts/deploy-lib.js";
+import { loadCliDeployConfig } from "../scripts/package-tools.js";
+function applyTreeseedSafeRepairs(tenantRoot) {
+  const actions = [];
+  ensureTreeseedGitignoreEntries(tenantRoot);
+  actions.push({ id: "gitignore", detail: "Ensured Treeseed gitignore entries are present." });
+  const envLocalPath = resolve(tenantRoot, ".env.local");
+  const envLocalExamplePath = resolve(tenantRoot, ".env.local.example");
+  if (!existsSync(envLocalPath) && existsSync(envLocalExamplePath)) {
+    copyFileSync(envLocalExamplePath, envLocalPath);
+    actions.push({ id: "env-local", detail: "Created .env.local from .env.local.example." });
+  }
+  const deployConfig = loadCliDeployConfig(tenantRoot);
+  const { configPath } = getTreeseedMachineConfigPaths(tenantRoot);
+  if (!existsSync(configPath)) {
+    const machineConfig2 = createDefaultTreeseedMachineConfig({
+      tenantRoot,
+      deployConfig,
+      tenantConfig: void 0
+    });
+    writeTreeseedMachineConfig(tenantRoot, machineConfig2);
+    actions.push({ id: "machine-config", detail: "Created the default Treeseed machine config." });
+  }
+  resolveTreeseedMachineEnvironmentValues(tenantRoot, "local");
+  actions.push({ id: "machine-key", detail: "Ensured the Treeseed machine key exists." });
+  const machineConfig = loadTreeseedMachineConfig(tenantRoot);
+  writeTreeseedMachineConfig(tenantRoot, machineConfig);
+  writeTreeseedLocalEnvironmentFiles(tenantRoot);
+  actions.push({ id: "local-env", detail: "Regenerated .env.local and .dev.vars from the current machine config." });
+  const stateRoot = resolve(tenantRoot, ".treeseed", "state", "environments");
+  if (existsSync(stateRoot)) {
+    for (const scope of ["local", "staging", "prod"]) {
+      const target = createPersistentDeployTarget(scope);
+      const state = loadDeployState(tenantRoot, deployConfig, { target });
+      if (state.readiness?.initialized || scope === "local") {
+        ensureGeneratedWranglerConfig(tenantRoot, { target });
+        actions.push({ id: `wrangler-${scope}`, detail: `Regenerated the ${scope} generated Wrangler config.` });
+      }
+    }
+  }
+  return dedupeRepairActions(actions);
+}
+function dedupeRepairActions(actions) {
+  const seen = /* @__PURE__ */ new Set();
+  return actions.filter((action) => {
+    if (seen.has(action.id)) return false;
+    seen.add(action.id);
+    return true;
+  });
+}
+function copyTreeseedOperationalState(sourceRoot, targetRoot) {
+  const sourceTreeseedRoot = resolve(sourceRoot, ".treeseed");
+  if (!existsSync(sourceTreeseedRoot)) {
+    return;
+  }
+  const targetTreeseedRoot = resolve(targetRoot, ".treeseed");
+  mkdirSync(targetTreeseedRoot, { recursive: true });
+  copyDirectory(sourceTreeseedRoot, targetTreeseedRoot);
+}
+function copyDirectory(sourceDir, targetDir) {
+  mkdirSync(targetDir, { recursive: true });
+  for (const entry of readdirSafe(sourceDir)) {
+    const sourcePath = resolve(sourceDir, entry.name);
+    const targetPath = resolve(targetDir, entry.name);
+    if (entry.isDirectory()) {
+      copyDirectory(sourcePath, targetPath);
+      continue;
+    }
+    writeFileSync(targetPath, readFileSync(sourcePath));
+  }
+}
+function readdirSafe(sourceDir) {
+  return existsSync(sourceDir) ? readdirSync(sourceDir, { withFileTypes: true }) : [];
+}
+export {
+  applyTreeseedSafeRepairs,
+  copyTreeseedOperationalState
+};