Skip to content

skills: encode validated Mac-port + onboarding gotchas - #47

Closed
KDwevedi wants to merge 2 commits into
ChakshuGautam:chore/ansible-config-driven-deployfrom
KDwevedi:skills/validated-mac-onboard
Closed

skills: encode validated Mac-port + onboarding gotchas#47
KDwevedi wants to merge 2 commits into
ChakshuGautam:chore/ansible-config-driven-deployfrom
KDwevedi:skills/validated-mac-onboard

Conversation

@KDwevedi

Copy link
Copy Markdown
Collaborator

Updates the two onboarding skills with what the faithful end-to-end ./deploy.sh validation (#46) and the Feliciano Maputo dump proved. Prompt/doc only — no playbook or code change.

digit-ansible-onboard

  • macOS is now a first-class target (thin Mac-port, Thin macOS target for the canonical deploy (Apple-Silicon/Rosetta) #46). Added a "macOS target" section: the exact host_vars recipe (ansible_connection: local, deploy_become: false, docker_default_platform, digit_ui_mode: container, enable_mcp: false, configurator via npx vite build --base=/configurator/), Docker-Desktop/OrbStack probe, ≥40 GB VM disk, ~25–35 min Rosetta self-converge. Removed the obsolete "Mac → spin up an Ubuntu VM" guidance.
  • db_fast_path pins THREE secrets, not one. IRON-LAW exception + Q9 + Step-4 now state postgres_password: egov123 and minio_root_*: minioadmin are pinned alongside elasticsearch_master_password — a custom value is the single most common cause of "stack comes up, then the post-OpenBao recreate fails password authentication failed" (took a 10-iteration validation to isolate).
  • Step-6: MCP SKIPPED (disabled) is expected with enable_mcp:false, not a failure to flag.

digit-xlsx-onboard

  • Step-2 pre-clean of the recurring partner-dump defects (boundary dedupe + whitespace-trim, Designation.department list, ServiceDefs.keywords String-not-array, Phase-1 local-machine logo path) — the exact fixes hand-applied to Feliciano's dump, now part of the recipe.
  • Step-5b: explicit conditional tenant_bootstrap for a brand-new state root before the wizard (else Phase 3–4 fail SCHEMA_DEFINITION_NOT_FOUND_ERR).
  • Step-6: prefer the forthcoming onboard_city composite (PR-B) that bakes these in; the skill becomes the narrative around it.

🤖 Generated with Claude Code

From the 10-iteration faithful ./deploy.sh validation (PR
ChakshuGautam/CCRS#46) and the Feliciano Maputo dump.

digit-ansible-onboard:
- macOS is now a first-class target (thin Mac-port): added the Mac
  host_vars recipe (ansible_connection:local, deploy_become:false,
  docker_default_platform, digit_ui_mode:container, enable_mcp:false,
  configurator via vite v8.0.13 building client environment for production...
�[2K
transforming...✓ 1 modules transformed.), Rosetta deploy time, Mac probe.
  Removed the obsolete 'Mac → Ubuntu VM' framing.
- IRON LAW exception + Q9 + Step-4: db_fast_path pins THREE secrets
  (elasticsearch_master_password, postgres_password=egov123,
  minio_root_*=minioadmin), not just elasticsearch — a custom value is
  the #1 cause of a stack that comes up then fails the post-OpenBao
  recreate (cost the whole validation to pin down).
- Step-6: 'MCP SKIPPED (disabled)' is expected when enable_mcp:false,
  not a failure.

digit-xlsx-onboard:
- Step-2: pre-clean the recurring partner-dump defects (boundary
  dedupe+whitespace, Designation.department list, ServiceDefs.keywords
  string, Phase-1 local logo path).
- Step-5b: explicit conditional new-root tenant_bootstrap BEFORE the
  wizard (brand-new state root => zero schemas => Phase 3-4 fail).
- Step-6: prefer the forthcoming onboard_city composite; this skill
  becomes the narrative around it.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented May 19, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 8cbab7fc-b492-4b3f-b627-520840cda0fa

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Encodes the 5-hr live-spiral lessons: preflight-first, confirm runtime
(OrbStack vs Docker Desktop), never SKIP_DOWN for recovery + leaked-
endpoint engine-restart, the mdms-v2 _create platform defect (CCRS#49,
canonical MCP confirms) → SQL keystone is mandatory, nginx container
branch (CCRS#46), ansible-buffering progress file, citizen OTP handshake,
employeeCode-as-username (egovernments#67), Phase-2 reconcile (egovernments#68).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@KDwevedi

Copy link
Copy Markdown
Collaborator Author

Superseded by #52 (consolidated Mac bring-up — 16 commits absorbing this PR + 5 others into one canonical path on nairobi). Closing.

@KDwevedi KDwevedi closed this May 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant