@daemux/store-automator 0.10.62 → 0.10.63

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "App Store & Google Play automation for Flutter apps",
-    "version": "0.10.62"
+    "version": "0.10.63"
   },
   "plugins": [
     {
       "name": "store-automator",
       "source": "./plugins/store-automator",
       "description": "3 agents for app store publishing: reviewer, meta-creator, media-designer",
-      "version": "0.10.62",
+      "version": "0.10.63",
       "keywords": [
         "flutter",
         "app-store",

package/README.md

@@ -20,30 +20,46 @@ Plus CI/CD templates for GitHub Actions, Fastlane, web pages, and scripts.
 
 ## Installation
 
+**Project (default):** Full install into your Flutter project -- agents, CI/CD templates, MCP servers, and interactive setup:
+
 ```bash
 cd your-flutter-project
-npm install @daemux/store-automator@latest
+npx --yes @daemux/store-automator
 ```
 
-The postinstall script runs an interactive setup with five sections:
+The installer runs an interactive setup with five sections:
 
 1. **App Identity** -- App name, bundle ID, package name, SKU, Apple ID
-2. **Credentials** -- Guided steps for App Store Connect API key, Google Play service account, Android keystore, and Match code signing
+2. **Credentials** -- App Store Connect API key, Google Play service account, Android keystore, Match code signing
 3. **Store Settings** -- iOS categories/pricing, Android track/rollout, metadata languages
 4. **Web Settings** -- Domain, colors, company info, legal jurisdiction
-5. **MCP Tokens** -- Stitch and Cloudflare API keys (optional, press Enter to skip)
-
-All values are written to `ci.config.yaml`. The installer also:
+5. **MCP Tokens** -- Stitch and Cloudflare API keys (optional)
 
-- Configures `.mcp.json` with MCP servers (Playwright, mobile-mcp, Stitch, Cloudflare)
-- Installs `.claude/CLAUDE.md` with your app name and agent configurations
-- Copies CI/CD templates (Fastlane, scripts, web pages, GitHub Actions)
-- Configures `.claude/settings.json` with required env vars
-- Runs post-install guides for GitHub repo setup, secrets, and Firebase
+All values are written to `ci.config.yaml`. The installer also configures `.mcp.json`, installs `.claude/CLAUDE.md`, copies CI/CD templates, and configures `.claude/settings.json`.
 
 Re-running the installer reads existing `ci.config.yaml` values as defaults, so you can update individual fields without re-entering everything.
 
-## After Installation
+**Global (agents only):** Install the plugin into `~/.claude` for use across all projects, without touching the current directory:
+
+```bash
+npx --yes @daemux/store-automator --global
+```
+
+Global install:
+
+- Registers the marketplace and installs the plugin at user scope
+- Writes `~/.claude/CLAUDE.md` with agent configurations
+- Adds required env vars and statusLine to `~/.claude/settings.json`
+
+Global install does NOT:
+
+- Create `ci.config.yaml`, `fastlane/`, `scripts/`, `web/`, `Gemfile`, `.github/workflows/`, or any other project files
+- Write or modify `.mcp.json` in the current directory
+- Run any interactive prompts or post-install guides
+
+Use project install for any Flutter app you are actually publishing. Global install is for agent-only access from arbitrary directories.
+
+## After Installation _(project scope only)_
 
 1. Add any credential files not configured during the guided setup:
    - `creds/AuthKey.p8` -- Apple App Store Connect API key
@@ -52,7 +68,7 @@ Re-running the installer reads existing `ci.config.yaml` values as defaults, so
 2. Verify `ci.config.yaml` has all required values filled in
 3. Start Claude Code and use the agents
 
-## Manual Setup
+## Manual Setup _(project scope only)_
 
 If postinstall was skipped (CI environment), run manually:
 
@@ -240,19 +256,18 @@ web:
   google_play_url: ""                          # Filled after first Android publish
 ```
 
-## Usage
+## Uninstall
 
-### Global Install
+**Project uninstall:** Removes CI templates, `ci.config.yaml`, `.mcp.json` entries, `.claude/CLAUDE.md`, and settings from the current project. Marketplace files remain in `~/.claude/plugins/`.
 
 ```bash
-npx @daemux/store-automator -g
+npx --yes @daemux/store-automator --uninstall
 ```
 
-### Uninstall
+**Global uninstall:** Removes the plugin from `~/.claude` and clears the marketplace. Does NOT touch the current project's `ci.config.yaml`, CI templates, or `.mcp.json`.
 
 ```bash
-npx @daemux/store-automator -u         # project scope
-npx @daemux/store-automator -g -u      # global scope
+npx --yes @daemux/store-automator --global --uninstall
 ```
 
 ## Agents
@@ -269,7 +284,7 @@ Designs complete app UI screens, creates ASO-optimized store screenshots for all
 
 Reviews all metadata, screenshots, privacy policy, and IAP configuration against Apple and Google guidelines. Returns APPROVED or REJECTED with specific issues.
 
-## CI/CD Templates
+## CI/CD Templates _(project scope only)_
 
 The package installs these templates to your project:
 
@@ -282,7 +297,7 @@ The package installs these templates to your project:
 | `web/` | Marketing, privacy, terms, and support page templates |
 | `Gemfile` | Ruby gems for Fastlane |
 
-## Workflow
+## Workflow _(project scope only)_
 
 1. Install the package (interactive setup fills `ci.config.yaml`)
 2. Add any remaining credential files
@@ -291,7 +306,7 @@ The package installs these templates to your project:
 5. Use `appstore-reviewer` to verify compliance
 6. Push to GitHub -- GitHub Actions builds and publishes automatically
 
-## MCP Servers
+## MCP Servers _(project scope only)_
 
 The package configures these MCP servers in `.mcp.json`:
 
@@ -302,7 +317,7 @@ The package configures these MCP servers in `.mcp.json`:
 | stitch | AI design tool for screenshot generation | `STITCH_API_KEY` |
 | cloudflare | Cloudflare Pages deployment | `CLOUDFLARE_API_TOKEN` + Account ID |
 
-## Idempotency
+## Idempotency _(project scope only)_
 
 The installer is idempotent. Re-running it reads existing values from `ci.config.yaml` as defaults for each prompt. This means you can:
 

package/bin/cli.mjs

@@ -9,8 +9,6 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
 
-const notifier = updateNotifier({ pkg });
-
 const args = process.argv.slice(2);
 let scope = 'project';
 let action = 'install';
@@ -146,6 +144,13 @@ Examples:
   }
 }
 
+if (scope === 'user' && cliTokens.githubActions) {
+  console.error('Error: --github-actions and --global are mutually exclusive.');
+  console.error('  --global targets ~/.claude (no CI templates).');
+  console.error('  --github-actions targets a project repo. Pick one.');
+  process.exit(1);
+}
+
 if (cliTokens.githubActions) {
   const missing = [];
   if (!cliTokens.matchDeployKey) missing.push('--match-deploy-key');
@@ -163,7 +168,9 @@ if (cliTokens.githubActions) {
   }
 }
 
-notifier.notify();
+if (!isPostinstall) {
+  updateNotifier({ pkg }).notify();
+}
 
 try {
   if (action === 'uninstall') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daemux/store-automator",
-  "version": "0.10.62",
+  "version": "0.10.63",
   "description": "Full App Store & Google Play automation for Flutter apps with Claude Code agents",
   "type": "module",
   "bin": {

package/plugins/store-automator/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "store-automator",
-  "version": "0.10.62",
+  "version": "0.10.63",
   "description": "App Store & Google Play automation agents for Flutter app publishing",
   "author": {
     "name": "Daemux"

package/src/install.mjs

@@ -152,7 +152,39 @@ function printNextSteps(prompted) {
   }
 }
 
+async function withReadline(fn) {
+  const { createInterface } = await import('node:readline');
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    return await fn(rl);
+  } finally {
+    rl.close();
+  }
+}
+
+function configureScopedSettings(baseDir, packageDir, appName, scopeLabel) {
+  ensureDir(baseDir);
+  installClaudeMd(join(baseDir, 'CLAUDE.md'), packageDir, appName);
+  console.log(`Configuring ${scopeLabel} settings...`);
+  const settingsPath = join(baseDir, 'settings.json');
+  injectEnvVars(settingsPath);
+  injectStatusLine(settingsPath);
+}
+
+function printGlobalNote() {
+  console.log('');
+  console.log('Note: Global install registers the marketplace and installs ~/.claude/CLAUDE.md only.');
+  console.log('To generate CI/CD templates, MCP config, and ci.config.yaml, run `npx @daemux/store-automator` inside a project directory.');
+}
+
 export async function runInstall(scope, isPostinstall = false, cliTokens = {}) {
+  const isGlobal = scope === 'user';
+
+  if (isPostinstall && isGlobal) {
+    console.log('Skipping postinstall in global scope.');
+    return;
+  }
+
   checkClaudeCli();
 
   console.log('Installing/updating Daemux Store Automator...');
@@ -160,102 +192,71 @@ export async function runInstall(scope, isPostinstall = false, cliTokens = {}) {
   const isGitHubActions = Boolean(cliTokens.githubActions);
   const nonInteractive = Boolean(process.env.npm_config_yes) || process.argv.includes('--postinstall');
   const projectDir = process.cwd();
-  const oldVersion = readMarketplaceVersion();
   const packageDir = getPackageDir();
+  const oldVersion = readMarketplaceVersion();
 
-  // 1. Copy plugin files + register marketplace
   copyPluginFiles(packageDir);
   clearCache();
   registerMarketplace();
   runClaudeInstall(scope);
-
   const newVersion = readMarketplaceVersion('unknown');
 
-  // 2. Install CI templates (creates ci.config.yaml if missing)
-  installCiTemplates(projectDir, packageDir);
-  installFirebaseTemplates(projectDir, packageDir);
-
-  // 3. Read current ci.config.yaml values
-  const currentConfig = readCiConfig(projectDir);
+  let prompted = {};
+  if (!isGlobal) {
+    installCiTemplates(projectDir, packageDir);
+    installFirebaseTemplates(projectDir, packageDir);
+    const currentConfig = readCiConfig(projectDir);
 
-  // 4. Run interactive prompts (or use CLI flags / skip in non-interactive)
-  let prompted;
-  if (isGitHubActions) {
-    prompted = {
-      bundleId: cliTokens.bundleId ?? '',
-      matchDeployKeyPath: cliTokens.matchDeployKey,
-      matchGitUrl: cliTokens.matchGitUrl,
-    };
-  } else if (nonInteractive) {
-    prompted = { ...cliTokens };
-  } else {
-    const { createInterface } = await import('node:readline');
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-      prompted = await promptAll(rl, cliTokens, currentConfig, projectDir);
-    } finally {
-      rl.close();
+    if (isGitHubActions) {
+      prompted = {
+        bundleId: cliTokens.bundleId ?? '',
+        matchDeployKeyPath: cliTokens.matchDeployKey,
+        matchGitUrl: cliTokens.matchGitUrl,
+      };
+    } else if (nonInteractive) {
+      prompted = { ...cliTokens };
+    } else {
+      prompted = await withReadline((rl) => promptAll(rl, cliTokens, currentConfig, projectDir));
     }
-  }
-
-  // 5. Write all prompted values to ci.config.yaml
-  const ciFields = mapPromptsToCiFields(prompted);
-  const wrote = writeCiFields(projectDir, ciFields);
-  if (wrote) console.log('Configuration written to ci.config.yaml');
-
-  if (prompted.matchDeployKeyPath || prompted.matchGitUrl) {
-    const wroteMatch = writeMatchConfig(projectDir, {
-      deployKeyPath: prompted.matchDeployKeyPath,
-      gitUrl: prompted.matchGitUrl,
-    });
-    if (wroteMatch) console.log('Match credentials written to ci.config.yaml');
-  }
 
-  // 6. Handle languages separately
-  if (prompted.languages) {
-    const langStr = Array.isArray(prompted.languages)
-      ? prompted.languages.join(',')
-      : prompted.languages;
-    if (writeCiLanguages(projectDir, langStr)) {
-      console.log('Languages updated in ci.config.yaml');
+    if (writeCiFields(projectDir, mapPromptsToCiFields(prompted))) {
+      console.log('Configuration written to ci.config.yaml');
     }
-  }
-
-  // 7. Configure MCP, CLAUDE.md, settings
-  if (!isGitHubActions) {
-    const servers = getMcpServers(prompted);
-    writeMcpJson(projectDir, servers);
-  }
 
-  const baseDir = scope === 'user'
-    ? join(homedir(), '.claude')
-    : join(process.cwd(), '.claude');
-
-  ensureDir(baseDir);
-
-  installClaudeMd(join(baseDir, 'CLAUDE.md'), packageDir, prompted.appName);
+    if (prompted.matchDeployKeyPath || prompted.matchGitUrl) {
+      const wroteMatch = writeMatchConfig(projectDir, {
+        deployKeyPath: prompted.matchDeployKeyPath,
+        gitUrl: prompted.matchGitUrl,
+      });
+      if (wroteMatch) console.log('Match credentials written to ci.config.yaml');
+    }
 
-  installGitHubActionsPath(projectDir, packageDir, prompted);
+    if (prompted.languages) {
+      const langStr = Array.isArray(prompted.languages) ? prompted.languages.join(',') : prompted.languages;
+      if (writeCiLanguages(projectDir, langStr)) {
+        console.log('Languages updated in ci.config.yaml');
+      }
+    }
 
-  const scopeLabel = scope === 'user' ? 'global' : 'project';
-  console.log(`Configuring ${scopeLabel} settings...`);
-  const settingsPath = join(baseDir, 'settings.json');
-  injectEnvVars(settingsPath);
-  injectStatusLine(settingsPath);
+    if (!isGitHubActions) writeMcpJson(projectDir, getMcpServers(prompted));
+    installGitHubActionsPath(projectDir, packageDir, prompted);
 
-  // 8. Run post-install guides (interactive only)
-  if (!isGitHubActions && !nonInteractive) {
-    const { createInterface } = await import('node:readline');
-    const guideRl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-      const { runPostInstallGuides } = await import('./prompts/store-settings.mjs');
-      await runPostInstallGuides(guideRl, currentConfig);
-    } finally {
-      guideRl.close();
+    if (!isGitHubActions && !nonInteractive) {
+      await withReadline(async (rl) => {
+        const { runPostInstallGuides } = await import('./prompts/store-settings.mjs');
+        await runPostInstallGuides(rl, currentConfig);
+      });
     }
   }
 
-  // 9. Summary + dynamic next steps
+  const baseDir = isGlobal ? join(homedir(), '.claude') : join(projectDir, '.claude');
+  const appName = prompted.appName || (isGlobal ? 'your app' : undefined);
+  configureScopedSettings(baseDir, packageDir, appName, isGlobal ? 'global' : 'project');
+
   printSummary(scope, oldVersion, newVersion);
-  printNextSteps(prompted);
+  if (isGlobal) {
+    printGlobalNote();
+  } else {
+    printNextSteps(prompted);
+  }
 }

package/src/templates.mjs

@@ -55,7 +55,7 @@ export function installClaudeMd(targetPath, packageDir, appName) {
 
   let content = readFileSync(template, 'utf8');
   if (appName) {
-    content = content.replace(/\{APP_NAME\}/g, appName);
+    content = content.split('{APP_NAME}').join(appName);
   }
   writeFileSync(targetPath, content, 'utf8');
 }

package/src/uninstall.mjs

@@ -86,11 +86,15 @@ export async function runUninstall(scope) {
 
   runClaudeUninstall(scope);
 
+  let doneMessage;
   if (scope === 'user') {
     console.log('Removing marketplace...');
     rmSync(MARKETPLACE_DIR, { recursive: true, force: true });
     rmSync(CACHE_DIR, { recursive: true, force: true });
     unregisterMarketplace();
+    doneMessage = '\nDone! store-automator uninstalled globally.';
+  } else {
+    doneMessage = '\nDone! store-automator uninstalled from this project.\n\nNote: Marketplace files remain under ~/.claude/plugins/marketplaces.\nRun with --global --uninstall to remove marketplace completely.';
   }
 
   const isGlobal = scope === 'user';
@@ -98,15 +102,15 @@ export async function runUninstall(scope) {
   const scopeLabel = isGlobal ? 'global' : 'project';
 
   removeFileIfExists(join(baseDir, 'CLAUDE.md'), `${scopeLabel} CLAUDE.md`);
-  removeCiTemplates(process.cwd());
-  removeMcpServers(process.cwd());
+
+  if (!isGlobal) {
+    removeCiTemplates(process.cwd());
+    removeMcpServers(process.cwd());
+  }
 
   console.log(`Cleaning ${scopeLabel} settings...`);
   removeEnvVars(join(baseDir, 'settings.json'));
   removeStatusLine(join(baseDir, 'settings.json'));
 
-  console.log(isGlobal
-    ? '\nDone! store-automator uninstalled globally.'
-    : `\nDone! store-automator uninstalled from this project.\n\nNote: Marketplace files remain in ${MARKETPLACE_DIR}\nRun with --global --uninstall to remove marketplace completely.`
-  );
+  console.log(doneMessage);
 }