@daemux/store-automator 0.10.13 → 0.10.15

package/.claude-plugin/marketplace.json

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

package/README.md

@@ -8,7 +8,7 @@ This package installs three Claude Code agents and a complete CI/CD template sui
 
 - **appstore-reviewer** -- Reviews metadata, screenshots, and tests compliance with Apple App Store and Google Play guidelines
 - **appstore-meta-creator** -- Creates all store metadata texts (names, descriptions, keywords) for all available languages
-- **app-designer** -- Designs complete app UI, creates ASO-optimized store screenshots, and designs marketing web pages — all in Stitch MCP
+- **app-designer** -- Designs complete app UI, creates ASO-optimized store screenshots, and designs marketing web pages -- all in Stitch MCP
 
 Plus CI/CD templates for GitHub Actions, Fastlane, web pages, and scripts.
 
@@ -25,21 +25,31 @@ cd your-flutter-project
 npm install @daemux/store-automator@latest
 ```
 
-The postinstall script will:
+The postinstall script runs an interactive setup with five sections:
 
-1. Prompt for bundle ID and MCP server tokens (Stitch, Cloudflare)
-2. Configure `.mcp.json` with MCP servers (Playwright, mobile-mcp, Stitch, Cloudflare)
-3. Install the plugin marketplace and register agents
-4. Copy `CLAUDE.md` template to `.claude/CLAUDE.md`
-5. Copy CI/CD templates (Fastlane, scripts, web pages, ci.config.yaml)
-6. Configure `.claude/settings.json` with required env vars
+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
+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:
+
+- 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
+
+Re-running the installer reads existing `ci.config.yaml` values as defaults, so you can update individual fields without re-entering everything.
 
 ## After Installation
 
-1. Fill `ci.config.yaml` with your app details (bundle ID, credentials paths, etc.)
-2. Add credential files:
+1. Add any credential files not configured during the guided setup:
    - `creds/AuthKey.p8` -- Apple App Store Connect API key
    - `creds/play-service-account.json` -- Google Play service account
+   - `creds/upload-keystore.jks` -- Android upload keystore
+2. Verify `ci.config.yaml` has all required values filled in
 3. Start Claude Code and use the agents
 
 ## Manual Setup
@@ -50,6 +60,186 @@ If postinstall was skipped (CI environment), run manually:
 npx store-automator
 ```
 
+## CLI Reference
+
+### General Options
+
+| Flag | Description |
+|------|-------------|
+| `-g`, `--global` | Install globally (~/.claude) instead of project scope |
+| `-u`, `--uninstall` | Uninstall plugin and remove files |
+| `--postinstall` | Run as postinstall hook (auto-detected) |
+| `-v`, `--version` | Show version number |
+| `-h`, `--help` | Show help |
+
+### App Identity
+
+| Flag | Description |
+|------|-------------|
+| `--app-name=NAME` | App display name |
+| `--bundle-id=ID` | Bundle ID / Package Name (e.g., com.company.app) |
+| `--sku=SKU` | App Store Connect SKU |
+| `--apple-id=EMAIL` | Apple Developer Account email |
+
+### Credentials
+
+| Flag | Description |
+|------|-------------|
+| `--key-id=ID` | App Store Connect Key ID |
+| `--issuer-id=ID` | App Store Connect Issuer ID |
+| `--keystore-password=PASS` | Android keystore password |
+| `--match-deploy-key-path=PATH` | Path to Match deploy key |
+| `--match-git-url=URL` | Match certificates Git URL (SSH) |
+
+### iOS Store Settings
+
+| Flag | Description |
+|------|-------------|
+| `--primary-category=CAT` | Primary category (e.g., UTILITIES) |
+| `--secondary-category=CAT` | Secondary category (e.g., PRODUCTIVITY) |
+| `--price-tier=N` | Price tier (0 = free) |
+| `--submit-for-review=BOOL` | Auto-submit for review (true/false) |
+| `--automatic-release=BOOL` | Auto-release after approval (true/false) |
+
+### Android Store Settings
+
+| Flag | Description |
+|------|-------------|
+| `--track=TRACK` | Release track (internal/alpha/beta/production) |
+| `--rollout-fraction=N` | Rollout fraction (0.0-1.0) |
+| `--in-app-update-priority=N` | In-app update priority (0-5) |
+
+### Web Settings
+
+| Flag | Description |
+|------|-------------|
+| `--domain=DOMAIN` | Web domain (e.g., myapp-pages.pages.dev) |
+| `--cf-project-name=NAME` | Cloudflare Pages project name |
+| `--tagline=TEXT` | App tagline |
+| `--primary-color=HEX` | Primary color (e.g., #2563EB) |
+| `--secondary-color=HEX` | Secondary color (e.g., #7C3AED) |
+| `--company-name=NAME` | Company name |
+| `--contact-email=EMAIL` | Contact email |
+| `--support-email=EMAIL` | Support email |
+| `--jurisdiction=TEXT` | Legal jurisdiction (e.g., Delaware, USA) |
+
+### Languages
+
+| Flag | Description |
+|------|-------------|
+| `--languages=LANGS` | Comma-separated language codes (e.g., en-US,de-DE,ja) |
+
+### MCP Tokens
+
+| Flag | Description |
+|------|-------------|
+| `--stitch-key=KEY` | Stitch MCP API key |
+| `--cloudflare-token=TOKEN` | Cloudflare API token |
+| `--cloudflare-account-id=ID` | Cloudflare account ID |
+
+### GitHub Actions CI
+
+| Flag | Description |
+|------|-------------|
+| `--github-actions` | GitHub Actions CI mode (requires --bundle-id, --match-deploy-key, --match-git-url) |
+| `--match-deploy-key=PATH` | Path to Match deploy key file |
+| `--match-git-url=URL` | Git URL for Match certificates repo (SSH) |
+
+## Full Non-Interactive Example
+
+Pass all flags to skip every interactive prompt:
+
+```bash
+npx @daemux/store-automator \
+  --app-name="My Amazing App" \
+  --bundle-id=com.mycompany.amazingapp \
+  --sku=MY_AMAZING_APP \
+  --apple-id=developer@mycompany.com \
+  --key-id=ABC123DEF4 \
+  --issuer-id=12345678-1234-1234-1234-123456789012 \
+  --keystore-password=my-secure-password \
+  --match-deploy-key-path=creds/match_deploy_key \
+  --match-git-url=git@github.com:mycompany/certificates.git \
+  --primary-category=UTILITIES \
+  --secondary-category=PRODUCTIVITY \
+  --price-tier=0 \
+  --submit-for-review=true \
+  --automatic-release=true \
+  --track=internal \
+  --rollout-fraction=1.0 \
+  --in-app-update-priority=3 \
+  --domain=amazingapp-pages.pages.dev \
+  --cf-project-name=amazingapp-pages \
+  --tagline="The best utility app ever" \
+  --primary-color="#2563EB" \
+  --secondary-color="#7C3AED" \
+  --company-name="My Company LLC" \
+  --contact-email=hello@mycompany.com \
+  --support-email=support@mycompany.com \
+  --jurisdiction="Delaware, USA" \
+  --languages=en-US,de-DE,ja \
+  --stitch-key=sk-stitch-xxx \
+  --cloudflare-token=cf-token-xxx \
+  --cloudflare-account-id=abc123def456
+```
+
+## ci.config.yaml Reference
+
+The installer writes all configuration to `ci.config.yaml`. Below is the full structure with the corresponding CLI flag for each field.
+
+```yaml
+flutter_root: "."                              # Subdirectory if Flutter project is not at repo root
+
+credentials:
+  apple:
+    p8_key_path: creds/AuthKey.p8              # Path to AuthKey .p8 file (manual)
+    key_id: ""                                 # --key-id
+    issuer_id: ""                              # --issuer-id
+  google:
+    service_account_json_path: creds/play-service-account.json  # Manual
+  android:
+    keystore_password: ""                      # --keystore-password
+  match:
+    deploy_key_path: ""                        # --match-deploy-key-path
+    git_url: ""                                # --match-git-url
+
+app:
+  name: ""                                     # --app-name
+  bundle_id: ""                                # --bundle-id
+  package_name: ""                             # --bundle-id (same value)
+  sku: ""                                      # --sku
+  apple_id: ""                                 # --apple-id
+
+ios:
+  primary_category: "UTILITIES"                # --primary-category
+  secondary_category: "PRODUCTIVITY"           # --secondary-category
+  price_tier: 0                                # --price-tier
+  submit_for_review: true                      # --submit-for-review
+  automatic_release: true                      # --automatic-release
+
+android:
+  track: "internal"                            # --track
+  rollout_fraction: "1.0"                      # --rollout-fraction
+  in_app_update_priority: 3                    # --in-app-update-priority
+
+metadata:
+  languages:                                   # --languages (comma-separated)
+    - en-US
+
+web:
+  domain: ""                                   # --domain
+  cloudflare_project_name: ""                  # --cf-project-name
+  tagline: ""                                  # --tagline
+  primary_color: "#2563EB"                     # --primary-color
+  secondary_color: "#7C3AED"                   # --secondary-color
+  company_name: ""                             # --company-name
+  contact_email: ""                            # --contact-email
+  support_email: ""                            # --support-email
+  jurisdiction: ""                             # --jurisdiction
+  app_store_url: ""                            # Filled after first iOS publish
+  google_play_url: ""                          # Filled after first Android publish
+```
+
 ## Usage
 
 ### Global Install
@@ -94,8 +284,8 @@ The package installs these templates to your project:
 
 ## Workflow
 
-1. Install the package
-2. Fill `ci.config.yaml`
+1. Install the package (interactive setup fills `ci.config.yaml`)
+2. Add any remaining credential files
 3. Use `app-designer` to design app UI + create screenshots + design web page
 4. Use `appstore-meta-creator` to generate metadata
 5. Use `appstore-reviewer` to verify compliance
@@ -112,40 +302,15 @@ 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 |
 
-## Non-interactive Install
+## Idempotency
 
-For CI/CD environments or scripted setups, pass tokens as CLI flags to skip interactive prompts:
+The installer is idempotent. Re-running it reads existing values from `ci.config.yaml` as defaults for each prompt. This means you can:
 
-```bash
-npx @daemux/store-automator \
-  --bundle-id=com.company.app \
-  --stitch-key=YOUR_STITCH_KEY \
-  --cloudflare-token=YOUR_CF_TOKEN \
-  --cloudflare-account-id=YOUR_CF_ACCOUNT_ID
-```
+- Update a single field by re-running and pressing Enter through unchanged fields
+- Add credentials you skipped during the first run
+- Change store settings without losing other configuration
 
-Any tokens provided via flags will skip the corresponding interactive prompt. If all three tokens are provided, the entire interactive session is skipped. The bundle ID, if provided, is automatically written to `bundle_id` and `package_name` in `ci.config.yaml`.
-
-## CLI Options
-
-```
-Usage: npx @daemux/store-automator [options]
-
-Options:
-  -g, --global                   Install globally (~/.claude) instead of project scope
-  -u, --uninstall                Uninstall plugin and remove files
-  --postinstall                  Run as postinstall hook (auto-detected)
-  -v, --version                  Show version number
-  -h, --help                     Show help
-
-App Configuration:
-  --bundle-id=ID                 Bundle ID / Package Name (e.g., com.company.app)
-
-MCP Token Flags (skip interactive prompts):
-  --stitch-key=KEY               Stitch MCP API key
-  --cloudflare-token=TOKEN       Cloudflare API token
-  --cloudflare-account-id=ID     Cloudflare account ID
-```
+CLI flags override both the existing config and the interactive prompt for that field.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daemux/store-automator",
-  "version": "0.10.13",
+  "version": "0.10.15",
   "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.13",
+  "version": "0.10.15",
   "description": "App Store & Google Play automation agents for Flutter app publishing",
   "author": {
     "name": "Daemux"

package/templates/scripts/ci/android/upload-metadata.sh

@@ -63,24 +63,26 @@ if [ $FASTLANE_EXIT -ne 0 ]; then
     echo "::warning title=Google Play Draft App::First manual release required. See job summary for instructions."
     if [ -n "${GITHUB_STEP_SUMMARY:-}" ]; then
       cat >> "$GITHUB_STEP_SUMMARY" << 'SUMMARY'
-## :warning: Google Play Draft App - Manual Action Required
-
-Metadata upload could not be committed because the app is still in **draft state** on Google Play.
-
-### How to fix:
-
-1. Go to [Google Play Console](https://play.google.com/console)
-2. Select your app
-3. Navigate to **Release > Production** (or **Internal testing**)
-4. Click **Create new release**
-5. The AAB was already uploaded by CI -- select it
-6. Fill in release notes
-7. Complete **Store listing** (description, screenshots -- already uploaded by CI)
-8. Complete **Content rating** questionnaire
-9. Complete **Pricing & distribution** settings
-10. Click **Review release** then **Start rollout**
-
-> After the first manual release, all subsequent CI metadata uploads will commit successfully without this error.
+## :warning: Google Play Draft App — First-Time Setup Required
+
+Metadata and screenshots were uploaded by CI but **could not be saved** because the app hasn't completed its initial setup on Google Play Console. This is a [Google Play API limitation](https://developers.google.com/android-publisher/edits) — all API edits are rejected until the first manual release.
+
+### One-time setup steps:
+
+1. Go to [Google Play Console](https://play.google.com/console) → Select your app
+2. **Dashboard** → Complete all required setup tasks shown in the checklist
+3. **Store listing** → Create your default store listing (title, description, screenshots)
+   - *Note: CI uploaded this data but it was discarded. After completing setup, re-run CI to auto-upload.*
+4. **Content rating** → Complete the content rating questionnaire
+5. **App pricing** → Set pricing and distribution countries
+6. **Release** → Go to **Testing → Internal testing** (or **Production**)
+   - Click **Create new release**
+   - The AAB was already uploaded by CI — select it
+   - Add release notes
+   - Click **Review release** → **Start rollout**
+
+### After first release:
+All subsequent CI runs will automatically upload metadata, screenshots, and new builds without manual intervention. Re-trigger the CI workflow after completing the steps above.
 SUMMARY
     fi
     ci_skip "App is in draft status — manual first release required on Google Play Console"