climaybe 1.0.0 → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Electric Maybe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -26,10 +26,12 @@ Interactive setup that configures your repo for CI/CD.
 1. Prompts for your store URL (e.g., `voldt-staging.myshopify.com`)
 2. Extracts subdomain as alias, lets you override
 3. Asks if you want to add more stores
-4. Based on store count, sets up **single-store** or **multi-store** mode
-5. Writes `package.json` config
-6. Scaffolds GitHub Actions workflows
-7. Creates git branches and store directories (multi-store)
+4. Asks whether to enable optional **preview + cleanup** workflows
+5. Asks whether to enable optional **build + Lighthouse** workflows
+6. Based on store count, sets up **single-store** or **multi-store** mode
+7. Writes `package.json` config
+8. Scaffolds GitHub Actions workflows
+9. Creates git branches and store directories (multi-store)
 
 ### `climaybe add-store`
 
@@ -83,6 +85,8 @@ The CLI writes config into the `config` field of your `package.json`:
   "config": {
     "port": 9295,
     "default_store": "voldt-staging.myshopify.com",
+    "preview_workflows": true,
+    "build_workflows": true,
     "stores": {
       "voldt-staging": "voldt-staging.myshopify.com",
       "voldt-norway": "voldt-norway.myshopify.com"
@@ -115,6 +119,8 @@ staging → main → staging-<store> → live-<store>
 - `staging-<store>` — per-store staging with store-specific JSON data
 - `live-<store>` — per-store production
 
+Direct pushes to `staging-<store>` or `live-<store>` are automatically synced back to `main` (no PR; multistore-hotfix-to-main merges the branch into main).
+
 ## Workflows
 
 ### Shared (both modes)
@@ -129,27 +135,55 @@ staging → main → staging-<store> → live-<store>
 | Workflow | Trigger | What it does |
 |----------|---------|-------------|
 | `release-pr-check.yml` | PR from `staging` to `main` | Generates changelog, creates pre-release patch tag, posts PR comment |
-| `post-merge-tag.yml` | Push to `main` (merged PR) | Detects release version from PR title, bumps minor version |
+| `post-merge-tag.yml` | Push to `main` (merged PR) | Staging→main: minor bump (e.g. v3.2.0). Hotfix sync: patch bump (e.g. v3.2.1) |
 | `nightly-hotfix.yml` | Cron 02:00 US Eastern | Tags untagged hotfix commits with patch version |
 
 ### Multi-store (additional)
 
 | Workflow | Trigger | What it does |
 |----------|---------|-------------|
-| `main-to-staging-stores.yml` | Push to `main` | Opens PRs to each `staging-<alias>` branch |
+| `main-to-staging-stores.yml` (main-to-staging-&lt;store&gt;) | Push to `main` | Opens PRs from main to each `staging-<alias>` branch |
 | `stores-to-root.yml` | Push to `staging-*` | Copies `stores/<alias>/` JSONs to repo root |
 | `pr-to-live.yml` | After stores-to-root | Opens PR from `staging-<alias>` to `live-<alias>` |
 | `root-to-stores.yml` | Push to `live-*` (hotfix) | Syncs root JSONs back to `stores/<alias>/` |
-| `hotfix-backport.yml` | After root-to-stores | Creates backport PR to `main` |
+| `multistore-hotfix-to-main.yml` | Push to `staging-*` or `live-*` (and after root-to-stores) | Automatically merges store branch into main (no PR); everything is synced back to main |
+
+### Optional preview + cleanup package
+
+Enabled via `climaybe init` prompt (`Enable preview + cleanup workflows?`).
+
+| Workflow | Trigger | What it does |
+|----------|---------|-------------|
+| `pr-update.yml` | PR opened/synchronize/reopened | Shares draft theme, renames with `-PR<number>`, comments preview + customize URLs |
+| `pr-close.yml` | PR closed | Deletes matching preview themes and comments deleted count + names |
+| `reusable-share-theme.yml` | workflow_call | Shares Shopify draft theme and returns `theme_id` |
+| `reusable-rename-theme.yml` | workflow_call | Renames shared theme to include `PR<number>` (fails job on rename failure) |
+| `reusable-comment-on-pr.yml` | workflow_call | Posts preview comment including Customize URL |
+| `reusable-cleanup-themes.yml` | workflow_call | Deletes preview themes by PR number and exposes cleanup outputs |
+| `reusable-extract-pr-number.yml` | workflow_call | Extracts padded/unpadded PR number outputs for naming and API-safe usage |
+
+### Optional build + Lighthouse package
+
+Enabled via `climaybe init` prompt (`Enable build + Lighthouse workflows?`).
+
+| Workflow | Trigger | What it does |
+|----------|---------|-------------|
+| `build-pipeline.yml` | Push to `main/staging/develop` | Runs reusable build and Lighthouse checks (when required secrets exist) |
+| `reusable-build.yml` | workflow_call | Runs Node build + Tailwind compile, then commits compiled assets when changed |
+| `create-release.yml` | Push tag `v*` | Builds release archive and creates GitHub Release using `release-notes.md` |
 
 ## Versioning
 
-- **Release merge** (`staging` → `main`): Minor bump (e.g., `v3.1.x` → `v3.2.0`)
-- **Hotfix** (direct commit to `main` or `live-*`): Patch bump (e.g., `v3.2.0` → `v3.2.1`)
-- **PR title convention**: `Release v3.2` — the workflow extracts the version from this
+- **Version format**: Always three-part (e.g. `v3.2.0`). No two-part tags.
+- **Release merge** (`staging` → `main`): Minor bump (e.g. `v3.1.12` → `v3.2.0`)
+- **Hotfix sync** (`staging-<store>` or `live-<store>` → main via multistore-hotfix-to-main): Patch bump runs immediately (e.g. `v3.2.0` → `v3.2.1`)
+- **Other hotfixes** (direct commit to `main`): Patch bump via nightly workflow or manual run
+- **PR title convention**: `Release v3.2` or `Release v3.2.0` — the workflow normalizes to three-part
 
 All version bumps update `config/settings_schema.json` automatically.
 
+**Full specification:** For detailed versioning rules, local dev flow, hotfix behavior, and alignment with the external CI/CD doc, see **[CI/CD Reference](docs/CI_CD_REFERENCE.md)**.
+
 ## File Sync Rules (Multi-store)
 
 **Synced between root and `stores/<alias>/`:**
@@ -163,18 +197,27 @@ All version bumps update `config/settings_schema.json` automatically.
 
 ## Recursive Trigger Prevention
 
-- Hotfix backport commits contain `[hotfix-backport]` in the message
+- Hotfix sync merge commits (multistore-hotfix-to-main) contain `[hotfix-backport]` in the message
 - Store sync commits contain `[stores-to-root]` or `[root-to-stores]`
 - Version bump commits contain `chore(release): bump version`
 - All workflows check for these flags and skip accordingly
 
 ## GitHub Secrets
 
-Add the following secret to your GitHub repository:
+Add the following secrets to your GitHub repository (or use **GitLab CI/CD variables** if you use GitLab). You can configure them during `climaybe init` via the GitHub or GitLab CLI.
 
 | Secret | Required | Description |
 |--------|----------|-------------|
 | `GEMINI_API_KEY` | Yes | Google Gemini API key for changelog generation |
+| `SHOPIFY_STORE_URL` | Set from config | Store URL is set automatically from the store domain(s) you add during init (no prompt). |
+| `SHOPIFY_CLI_THEME_TOKEN` | Yes* | Theme access token for preview workflows (required when preview is enabled). |
+| `SHOP_ACCESS_TOKEN` | Optional* | Required only when optional build workflows are enabled (Lighthouse) |
+| `LHCI_GITHUB_APP_TOKEN` | Optional* | Required only when optional build workflows are enabled (Lighthouse) |
+| `SHOP_PASSWORD` | Optional | Used by Lighthouse action when your store requires password auth |
+
+**Store URL:** During `climaybe init` (or `add-store`), store URL secret(s) are set from your configured store domain(s); you are only prompted for the theme token.
+
+**Multi-store:** Per-store secrets `SHOPIFY_STORE_URL_<ALIAS>` and `SHOPIFY_CLI_THEME_TOKEN_<ALIAS>` — the URL is set from config; you must provide the theme token per store. `<ALIAS>` is uppercase with hyphens as underscores (e.g. `voldt-norway` → `SHOPIFY_STORE_URL_VOLDT_NORWAY`).
 
 ## Directory Structure (Multi-store)
 
@@ -199,6 +242,15 @@ Add the following secret to your GitHub repository:
 └── .github/workflows/
 ```
 
+## Releases and versioning
+
+- **Branch:** Single default branch `main`. Feature branches open as PRs into `main`.
+- **Versioning:** [SemVer](https://semver.org/). Versions are **bumped automatically** when PRs are merged to `main` using [conventional commits](https://www.conventionalcommits.org/): `fix:` → patch, `feat:` → minor, `BREAKING CHANGE` or `feat!:` → major.
+- **Flow:** Merge to `main` → [Release version](.github/workflows/release-version.yml) runs semantic-release (bumps `package.json`, pushes tag) → tag push triggers [Release](.github/workflows/release.yml) (tests + publish to npm). Requires `NPM_TOKEN` secret for npm publish.
+- **CI:** Every PR and push to `main` runs tests on Node 20 and 22 ([CI workflow](.github/workflows/ci.yml)).
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for branch, PR, and conventional-commit details.
+
 ## License
 
 MIT — Electric Maybe

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "climaybe",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "Shopify CI/CD CLI — scaffolds workflows, branch strategy, and store config for single-store and multi-store theme repos",
   "type": "module",
   "bin": {
@@ -23,9 +23,52 @@
   ],
   "author": "Electric Maybe",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/electricmaybe/climaybe.git"
+  },
+  "bugs": "https://github.com/electricmaybe/climaybe/issues",
+  "homepage": "https://github.com/electricmaybe/climaybe#readme",
+  "scripts": {
+    "test": "node scripts/run-tests.js 2>&1 | tee test.log",
+    "prepare": "husky"
+  },
+  "release": {
+    "branches": [
+      "main"
+    ],
+    "plugins": [
+      "@semantic-release/commit-analyzer",
+      "@semantic-release/release-notes-generator",
+      [
+        "@semantic-release/npm",
+        {
+          "npmPublish": false
+        }
+      ],
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json",
+            "package-lock.json"
+          ],
+          "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+        }
+      ]
+    ]
+  },
   "dependencies": {
-    "commander": "^13.1.0",
+    "commander": "^14.0.3",
     "picocolors": "^1.1.1",
     "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.4.4",
+    "@commitlint/config-conventional": "^20.4.4",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/npm": "^13.1.5",
+    "husky": "^9.1.7",
+    "semantic-release": "^25.0.3"
   }
 }

package/src/commands/add-store.js

@@ -1,9 +1,21 @@
 import pc from 'picocolors';
-import { promptNewStore } from '../lib/prompts.js';
-import { readConfig, addStoreToConfig, getStoreAliases, getMode } from '../lib/config.js';
+import { promptNewStore, promptConfigureCISecrets, promptUpdateExistingSecrets, promptSecretValue } from '../lib/prompts.js';
+import { readConfig, addStoreToConfig, getStoreAliases, getMode, isPreviewWorkflowsEnabled, isBuildWorkflowsEnabled } from '../lib/config.js';
 import { createStoreBranches } from '../lib/git.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
 import { createStoreDirectories } from '../lib/store-sync.js';
+import {
+  isGhAvailable,
+  hasGitHubRemote,
+  isGlabAvailable,
+  hasGitLabRemote,
+  listGitHubSecrets,
+  listGitLabVariables,
+  getStoreUrlSecretForNewStore,
+  getSecretsToPromptForNewStore,
+  setSecret,
+  setGitLabVariable,
+} from '../lib/github-secrets.js';
 
 export async function addStoreCommand() {
   console.log(pc.bold('\n  climaybe — Add Store\n'));
@@ -17,6 +29,8 @@ export async function addStoreCommand() {
 
   const existingAliases = getStoreAliases();
   const previousMode = getMode();
+  const includePreview = isPreviewWorkflowsEnabled();
+  const includeBuild = isBuildWorkflowsEnabled();
 
   // Prompt for new store
   const store = await promptNewStore(existingAliases);
@@ -42,14 +56,73 @@ export async function addStoreCommand() {
     createStoreDirectories(originalAlias);
 
     // Re-scaffold workflows for multi mode
-    scaffoldWorkflows('multi');
+    scaffoldWorkflows('multi', { includePreview, includeBuild });
     console.log(pc.green('  Migration complete — workflows updated to multi-store mode.'));
   } else if (newMode === 'multi') {
     // Already multi, just make sure workflows are current
-    scaffoldWorkflows('multi');
+    scaffoldWorkflows('multi', { includePreview, includeBuild });
   }
 
   console.log(pc.bold(pc.green('\n  Store added successfully!\n')));
   console.log(pc.dim(`  New branches: staging-${store.alias}, live-${store.alias}`));
   console.log(pc.dim(`  Store dir: stores/${store.alias}/\n`));
+
+  // If preview workflows are on, offer to set this store's CI secrets (multi-store uses per-store secrets)
+  if (includePreview) {
+    const ciHost = await promptConfigureCISecrets();
+    if (ciHost !== 'skip') {
+      const setter =
+        ciHost === 'github'
+          ? { check: isGhAvailable, checkRemote: hasGitHubRemote, set: setSecret, name: 'GitHub' }
+          : { check: isGlabAvailable, checkRemote: hasGitLabRemote, set: setGitLabVariable, name: 'GitLab' };
+
+      if (!setter.check()) {
+        console.log(pc.yellow(`  ${setter.name} CLI is not installed or not logged in. Add secrets manually in repo Settings.`));
+      } else if (!setter.checkRemote()) {
+        console.log(pc.yellow('  No ' + setter.name + ' remote (origin). Add secrets manually after pushing.'));
+      } else {
+        let setCount = 0;
+        const { name: urlName, value: urlValue } = getStoreUrlSecretForNewStore(store);
+        try {
+          await setter.set(urlName, urlValue);
+          console.log(pc.green(`  Set ${urlName} (from store config).`));
+          setCount++;
+        } catch (err) {
+          console.log(pc.red(`  Failed to set ${urlName}: ${err.message}`));
+        }
+
+        const secretsToPrompt = getSecretsToPromptForNewStore(store);
+        const existingNames = ciHost === 'github' ? listGitHubSecrets() : listGitLabVariables();
+        const namesWeWillPrompt = new Set(secretsToPrompt.map((s) => s.name));
+        const alreadySet = existingNames.filter((n) => namesWeWillPrompt.has(n));
+        if (alreadySet.length > 0) {
+          const doUpdate = await promptUpdateExistingSecrets(alreadySet);
+          if (!doUpdate) {
+            if (setCount > 0) {
+              console.log(pc.green(`\n  Done. ${setCount} secret(s) set for store "${store.alias}".\n`));
+            }
+            return;
+          }
+        }
+        const total = secretsToPrompt.length;
+        console.log(pc.cyan(`\n  Configure ${total} secret(s) for store "${store.alias}" (theme token required).\n`));
+        for (let i = 0; i < secretsToPrompt.length; i++) {
+          const secret = secretsToPrompt[i];
+          const value = await promptSecretValue(secret, i, total);
+          if (value) {
+            try {
+              await setter.set(secret.name, value);
+              console.log(pc.green(`  Set ${secret.name}.`));
+              setCount++;
+            } catch (err) {
+              console.log(pc.red(`  Failed to set ${secret.name}: ${err.message}`));
+            }
+          }
+        }
+        if (setCount > 0) {
+          console.log(pc.green(`\n  Done. ${setCount} secret(s) set for store "${store.alias}".\n`));
+        }
+      }
+    }
+  }
 }

package/src/commands/init.js

@@ -1,25 +1,40 @@
+import prompts from 'prompts';
 import pc from 'picocolors';
-import { promptStoreLoop } from '../lib/prompts.js';
+import {
+  promptStoreLoop,
+  promptPreviewWorkflows,
+  promptBuildWorkflows,
+  promptConfigureCISecrets,
+  promptUpdateExistingSecrets,
+  promptSecretValue,
+} from '../lib/prompts.js';
 import { readConfig, writeConfig } from '../lib/config.js';
 import { ensureGitRepo, ensureInitialCommit, ensureStagingBranch, createStoreBranches } from '../lib/git.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
 import { createStoreDirectories } from '../lib/store-sync.js';
+import {
+  isGhAvailable,
+  hasGitHubRemote,
+  isGlabAvailable,
+  hasGitLabRemote,
+  listGitHubSecrets,
+  listGitLabVariables,
+  getStoreUrlSecretsFromConfig,
+  getSecretsToPrompt,
+  setSecret,
+  setGitLabVariable,
+} from '../lib/github-secrets.js';
 
-export async function initCommand() {
-  console.log(pc.bold('\n  climaybe — Shopify CI/CD Setup\n'));
-
-  // Guard: check if already initialized
-  const existing = readConfig();
-  if (existing?.stores && Object.keys(existing.stores).length > 0) {
-    console.log(pc.yellow('  This repo already has a climaybe config.'));
-    console.log(pc.dim('  Use "climaybe add-store" to add more stores.'));
-    console.log(pc.dim('  Use "climaybe update-workflows" to refresh workflows.\n'));
-    return;
-  }
-
+/**
+ * Run the full init flow: prompts, config write, git, branches, workflows.
+ * Used by both init (when not already inited or user confirms reinit) and reinit.
+ */
+async function runInitFlow() {
   // 1. Collect stores from user
   const stores = await promptStoreLoop();
   const mode = stores.length > 1 ? 'multi' : 'single';
+  const enablePreviewWorkflows = await promptPreviewWorkflows();
+  const enableBuildWorkflows = await promptBuildWorkflows();
 
   console.log(pc.dim(`\n  Mode: ${mode}-store (${stores.length} store(s))`));
 
@@ -27,6 +42,8 @@ export async function initCommand() {
   const config = {
     port: 9295,
     default_store: stores[0].domain,
+    preview_workflows: enablePreviewWorkflows,
+    build_workflows: enableBuildWorkflows,
     stores: {},
   };
 
@@ -55,7 +72,10 @@ export async function initCommand() {
   }
 
   // 6. Scaffold workflows
-  scaffoldWorkflows(mode);
+  scaffoldWorkflows(mode, {
+    includePreview: enablePreviewWorkflows,
+    includeBuild: enableBuildWorkflows,
+  });
 
   // Done
   console.log(pc.bold(pc.green('\n  Setup complete!\n')));
@@ -70,9 +90,123 @@ export async function initCommand() {
     }
     console.log(pc.dim('  Workflow: staging → main → staging-<store> → live-<store>'));
   }
+  console.log(pc.dim(`  Preview workflows: ${enablePreviewWorkflows ? 'enabled' : 'disabled'}`));
+  console.log(pc.dim(`  Build workflows: ${enableBuildWorkflows ? 'enabled' : 'disabled'}`));
 
   console.log(pc.dim('\n  Next steps:'));
-  console.log(pc.dim('    1. Add GEMINI_API_KEY to your GitHub repo secrets'));
-  console.log(pc.dim('    2. Push to GitHub and start using the branching workflow'));
+  console.log(pc.dim('    1. Add GEMINI_API_KEY to your CI secrets (or configure below)'));
+  console.log(pc.dim('    2. Push to GitHub/GitLab and start using the branching workflow'));
   console.log(pc.dim('    3. Tag your first release: git tag v1.0.0\n'));
+
+  const ciHost = await promptConfigureCISecrets();
+  if (ciHost === 'skip') return;
+
+  const secretsToPrompt = getSecretsToPrompt({
+    enablePreviewWorkflows,
+    enableBuildWorkflows,
+    mode,
+    stores,
+  });
+  const total = secretsToPrompt.length;
+  const setter =
+    ciHost === 'github'
+      ? { check: isGhAvailable, checkRemote: hasGitHubRemote, set: setSecret, name: 'GitHub' }
+      : { check: isGlabAvailable, checkRemote: hasGitLabRemote, set: setGitLabVariable, name: 'GitLab' };
+
+  if (!setter.check()) {
+    const installUrl = ciHost === 'github' ? 'https://cli.github.com/' : 'https://gitlab.com/gitlab-org/cli';
+    console.log(pc.yellow(`  ${setter.name} CLI is not installed or not logged in.`));
+    console.log(pc.dim(`  Install: ${installUrl} — then run ${ciHost === 'github' ? 'gh' : 'glab'} auth login`));
+    console.log(
+      pc.dim(
+        ciHost === 'github'
+          ? '  You can add secrets later in the repo: Settings → Secrets and variables → Actions.\n'
+          : '  You can add variables later in the repo: Settings → CI/CD → Variables.\n'
+      )
+    );
+    return;
+  }
+  if (!setter.checkRemote()) {
+    console.log(pc.yellow('  This repo has no ' + setter.name + ' remote (origin).'));
+    console.log(pc.dim('  Add a remote and push first, then add secrets/variables in the repo Settings.\n'));
+    return;
+  }
+
+  const existingNames =
+    ciHost === 'github' ? listGitHubSecrets() : listGitLabVariables();
+  const namesWeWillPrompt = new Set(secretsToPrompt.map((s) => s.name));
+  const alreadySet = existingNames.filter((n) => namesWeWillPrompt.has(n));
+  if (alreadySet.length > 0) {
+    const doUpdate = await promptUpdateExistingSecrets(alreadySet);
+    if (!doUpdate) {
+      console.log(pc.dim('\n  Skipping. Existing secrets left unchanged.\n'));
+      return;
+    }
+  }
+
+  let setCount = 0;
+
+  // Set store URL(s) from config (domains already added during init) — no prompt
+  const storeUrlSecrets = getStoreUrlSecretsFromConfig({
+    enablePreviewWorkflows,
+    enableBuildWorkflows,
+    mode,
+    stores,
+  });
+  for (const { name, value } of storeUrlSecrets) {
+    try {
+      await setter.set(name, value);
+      console.log(pc.green(`  Set ${name} (from store config).`));
+      setCount++;
+    } catch (err) {
+      console.log(pc.red(`  Failed to set ${name}: ${err.message}`));
+    }
+  }
+
+  console.log(pc.cyan(`\n  Configure ${total} ${setter.name} secret(s)/variable(s). Leave optional ones blank to skip.\n`));
+  for (let i = 0; i < secretsToPrompt.length; i++) {
+    const secret = secretsToPrompt[i];
+    const value = await promptSecretValue(secret, i, total);
+    if (value) {
+      try {
+        await setter.set(secret.name, value);
+        console.log(pc.green(`  Set ${secret.name}.`));
+        setCount++;
+      } catch (err) {
+        console.log(pc.red(`  Failed to set ${secret.name}: ${err.message}`));
+      }
+    }
+  }
+  if (setCount > 0) {
+    console.log(pc.green(`\n  Done. ${setCount} secret(s) set for this repository.\n`));
+  }
+}
+
+export async function initCommand() {
+  console.log(pc.bold('\n  climaybe — Shopify CI/CD Setup\n'));
+
+  const existing = readConfig();
+  const alreadyInited = existing?.stores && Object.keys(existing.stores).length > 0;
+
+  if (alreadyInited) {
+    const { reinit } = await prompts({
+      type: 'confirm',
+      name: 'reinit',
+      message: 'This repo already has a climaybe config. Reinitialize? This will remove your current stores and workflow settings.',
+      initial: false,
+    });
+    if (!reinit) {
+      console.log(pc.dim('  Use "climaybe add-store" to add more stores.'));
+      console.log(pc.dim('  Use "climaybe update-workflows" to refresh workflows.'));
+      console.log(pc.dim('  Use "climaybe reinit" to reinitialize from scratch.\n'));
+      return;
+    }
+  }
+
+  await runInitFlow();
+}
+
+export async function reinitCommand() {
+  console.log(pc.bold('\n  climaybe — Reinitialize CI/CD Setup\n'));
+  await runInitFlow();
 }

package/src/commands/update-workflows.js

@@ -1,5 +1,5 @@
 import pc from 'picocolors';
-import { getMode, readConfig } from '../lib/config.js';
+import { getMode, isBuildWorkflowsEnabled, isPreviewWorkflowsEnabled, readConfig } from '../lib/config.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
 
 export async function updateWorkflowsCommand() {
@@ -12,7 +12,9 @@ export async function updateWorkflowsCommand() {
   }
 
   const mode = getMode();
-  scaffoldWorkflows(mode);
+  const includePreview = isPreviewWorkflowsEnabled();
+  const includeBuild = isBuildWorkflowsEnabled();
+  scaffoldWorkflows(mode, { includePreview, includeBuild });
 
   console.log(pc.bold(pc.green('\n  Workflows updated!\n')));
 }

package/src/index.js

@@ -1,11 +1,14 @@
 import { Command } from 'commander';
-import { initCommand } from './commands/init.js';
+import { initCommand, reinitCommand } from './commands/init.js';
 import { addStoreCommand } from './commands/add-store.js';
 import { switchCommand } from './commands/switch.js';
 import { syncCommand } from './commands/sync.js';
 import { updateWorkflowsCommand } from './commands/update-workflows.js';
 
-export function run(argv) {
+/**
+ * Create the CLI program (for testing and for run).
+ */
+export function createProgram() {
   const program = new Command();
 
   program
@@ -18,6 +21,11 @@ export function run(argv) {
     .description('Initialize CI/CD setup for a Shopify theme repo')
     .action(initCommand);
 
+  program
+    .command('reinit')
+    .description('Reinitialize CI/CD setup (removes existing config and re-scaffolds workflows)')
+    .action(reinitCommand);
+
   program
     .command('add-store')
     .description('Add a new store to an existing multi-store config')
@@ -40,5 +48,9 @@ export function run(argv) {
     .description('Refresh GitHub Actions workflows from latest bundled templates')
     .action(updateWorkflowsCommand);
 
-  program.parse(argv);
+  return program;
+}
+
+export function run(argv) {
+  createProgram().parse(argv);
 }

package/src/lib/config.js

@@ -14,6 +14,7 @@ function pkgPath(cwd = process.cwd()) {
 /**
  * Read the full package.json from a target repo.
  * Returns null if it doesn't exist.
+ * @public (used by tests)
  */
 export function readPkg(cwd = process.cwd()) {
   const p = pkgPath(cwd);
@@ -72,6 +73,22 @@ export function getMode(cwd = process.cwd()) {
   return aliases.length > 1 ? 'multi' : 'single';
 }
 
+/**
+ * Whether optional preview/cleanup workflows are enabled.
+ */
+export function isPreviewWorkflowsEnabled(cwd = process.cwd()) {
+  const config = readConfig(cwd);
+  return config?.preview_workflows === true;
+}
+
+/**
+ * Whether optional build/Lighthouse workflows are enabled.
+ */
+export function isBuildWorkflowsEnabled(cwd = process.cwd()) {
+  const config = readConfig(cwd);
+  return config?.build_workflows === true;
+}
+
 /**
  * Add a store entry to the config.
  * Returns the updated config.

package/src/lib/git.js

@@ -4,6 +4,11 @@ import pc from 'picocolors';
 const exec = (cmd, cwd = process.cwd()) =>
   execSync(cmd, { cwd, encoding: 'utf-8', stdio: 'pipe' }).trim();
 
+function isExpectedGitError(err, patterns) {
+  const text = [err.message, err.stderr].filter(Boolean).join(' ');
+  return patterns.some((p) => text.includes(p));
+}
+
 /**
  * Check if current directory is a git repo.
  */
@@ -11,7 +16,10 @@ export function isGitRepo(cwd = process.cwd()) {
   try {
     exec('git rev-parse --is-inside-work-tree', cwd);
     return true;
-  } catch {
+  } catch (err) {
+    if (!isExpectedGitError(err, ['not a git repository'])) {
+      console.error(err);
+    }
     return false;
   }
 }
@@ -30,7 +38,10 @@ export function branchExists(name, cwd = process.cwd()) {
   try {
     exec(`git rev-parse --verify ${name}`, cwd);
     return true;
-  } catch {
+  } catch (err) {
+    if (!isExpectedGitError(err, ['Needed a single revision'])) {
+      console.error(err);
+    }
     return false;
   }
 }
@@ -71,7 +82,14 @@ export function ensureStagingBranch(cwd = process.cwd()) {
 export function ensureInitialCommit(cwd = process.cwd()) {
   try {
     exec('git rev-parse HEAD', cwd);
-  } catch {
+  } catch (err) {
+    const expectedNoCommit = isExpectedGitError(err, [
+      'unknown revision',
+      'path not in the working tree',
+    ]);
+    if (!expectedNoCommit) {
+      console.error(err);
+    }
     // No commits yet — create an initial one
     exec('git add -A', cwd);
     exec('git commit -m "chore: initial commit" --allow-empty', cwd);