novahiz 0.2.2 → 0.2.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/NOTICE.md +25 -15
- package/README.md +353 -355
- package/adapters/README.md +1 -1
- package/adapters/opencode/agent/novahiz.md +1 -2
- package/adapters/opencode/commands/novahiz-init.md +10 -0
- package/adapters/opencode/instructions.md +1 -1
- package/adapters/opencode/novahiz.ts +182 -4
- package/bin/novahiz.cmd +2 -2
- package/catalog/categories.json +1085 -1093
- package/catalog/overrides.json +12 -13
- package/catalog/providers.json +18 -34
- package/catalog/rules.json +15 -22
- package/docs/ARCHITECTURE.md +2 -2
- package/docs/CATALOG.md +7 -6
- package/docs/CONFIGURATION.md +5 -5
- package/docs/CONSTITUTION.md +4 -4
- package/docs/GATE.md +7 -11
- package/docs/HARNESSES.md +11 -0
- package/docs/INSTALL.md +7 -5
- package/docs/PLUGIN.md +24 -6
- package/docs/PROVIDERS.md +12 -10
- package/docs/ROADMAPS.md +4 -3
- package/docs/RULES.md +11 -10
- package/install/bootstrap.mjs +9 -19
- package/install/install.mjs +23 -41
- package/mcp/novahiz-tools/index.mjs +35 -6
- package/novahiz.config.example.json +1 -5
- package/package.json +6 -7
- package/skills/apple-ui-audit/SKILL.md +95 -0
- package/skills/apple-ui-audit/references/screen-walkthrough.md +29 -0
- package/skills/browser-session/SKILL.md +61 -0
- package/skills/browser-session/references/session-run-sheet.md +30 -0
- package/skills/browser-session/scripts/browser_session_preflight.mjs +74 -0
- package/skills/browser-session/scripts/sample-run.json +5 -0
- package/skills/code-standards/SKILL.md +85 -0
- package/skills/code-standards/references/pr-review-worksheet.md +35 -0
- package/skills/design-token-pipeline/SKILL.md +85 -0
- package/skills/design-token-pipeline/references/dtcg-sample.json +37 -0
- package/skills/llm-threat-review/SKILL.md +99 -0
- package/skills/llm-threat-review/references/review-worksheet.md +34 -0
- package/skills/llm-threat-review/scripts/llm_risk_lint.mjs +105 -0
- package/skills/novahiz-audit/SKILL.md +1 -1
- package/skills/novahiz-gate/SKILL.md +7 -6
- package/skills/novahiz-humanizer/SKILL.md +1 -1
- package/skills/novahiz-implement/SKILL.md +1 -1
- package/skills/novahiz-init/SKILL.md +112 -0
- package/skills/novahiz-planner/SKILL.md +1 -2
- package/skills/openapi-mcp-server/SKILL.md +76 -0
- package/skills/openapi-mcp-server/references/mcp-ship-checklist.md +30 -0
- package/skills/openapi-mcp-server/references/tool-worksheet.md +30 -0
- package/skills/openapi-mcp-server/scripts/openapi_mcp_lint.mjs +133 -0
- package/skills/package-risk-audit/SKILL.md +83 -0
- package/skills/package-risk-audit/references/intake-worksheet.md +19 -0
- package/skills/package-risk-audit/scripts/dep_risk_lint.mjs +131 -0
- package/skills/secrets-hygiene/SKILL.md +62 -0
- package/skills/secrets-hygiene/references/rotation-playbook.md +27 -0
- package/skills/secrets-hygiene/scripts/secret_scan.mjs +120 -0
- package/skills/skill-authoring/SKILL.md +93 -0
- package/skills/skill-authoring/references/skill-template.md +59 -0
- package/skills/skill-authoring/scripts/skill_frontmatter_lint.mjs +65 -0
- package/skills/skill-eval-loop/SKILL.md +103 -0
- package/skills/skill-eval-loop/references/negative-patterns.md +12 -0
- package/skills/skill-eval-loop/references/run-sheet.md +40 -0
- package/skills/skill-eval-loop/scripts/skill_structure_check.mjs +100 -0
- package/skills/ui-craft-rules/SKILL.md +96 -0
- package/skills/ui-slop-remover/SKILL.md +110 -0
- package/skills/ui-slop-remover/references/tell-catalogue.md +58 -0
- package/skills/ui-slop-remover/scripts/slop_lint.mjs +119 -0
- package/src/autodocs.ts +192 -0
- package/src/cli.ts +8 -1
- package/src/commands/autodocs.ts +250 -0
- package/src/commands/doctor.ts +226 -217
- package/src/commands/gate.ts +16 -5
- package/src/commands/init.ts +356 -0
- package/src/commands/task.ts +20 -7
- package/src/gate.ts +401 -401
- package/src/ledger.ts +39 -0
- package/src/targets.ts +43 -7
- package/bundled-skills/ab-testing/SKILL.md +0 -353
- package/bundled-skills/ab-testing/evals/evals.json +0 -105
- package/bundled-skills/ab-testing/references/sample-size-guide.md +0 -263
- package/bundled-skills/ab-testing/references/test-templates.md +0 -277
- package/bundled-skills/ad-creative/SKILL.md +0 -425
- package/bundled-skills/ad-creative/assets/creative-review-template.html +0 -400
- package/bundled-skills/ad-creative/evals/evals.json +0 -217
- package/bundled-skills/ad-creative/references/creative-review-page.md +0 -106
- package/bundled-skills/ad-creative/references/creative-roadmap.md +0 -118
- package/bundled-skills/ad-creative/references/generative-tools.md +0 -637
- package/bundled-skills/ad-creative/references/hook-system.md +0 -115
- package/bundled-skills/ad-creative/references/imessage-video-ads.md +0 -201
- package/bundled-skills/ad-creative/references/meta-creative-formats.md +0 -114
- package/bundled-skills/ad-creative/references/motion-video-ads.md +0 -126
- package/bundled-skills/ad-creative/references/platform-specs.md +0 -213
- package/bundled-skills/ad-creative/references/short-form-video-specs.md +0 -213
- package/bundled-skills/ad-creative/references/static-ad-templates.md +0 -308
- package/bundled-skills/ads/SKILL.md +0 -499
- package/bundled-skills/ads/evals/evals.json +0 -157
- package/bundled-skills/ads/references/abm-playbook.md +0 -93
- package/bundled-skills/ads/references/ad-copy-templates.md +0 -207
- package/bundled-skills/ads/references/audience-targeting.md +0 -243
- package/bundled-skills/ads/references/audit-guardrails.md +0 -83
- package/bundled-skills/ads/references/b2b-paid-playbook.md +0 -115
- package/bundled-skills/ads/references/conversion-tracking.md +0 -361
- package/bundled-skills/ads/references/creative-research-automation.md +0 -103
- package/bundled-skills/ads/references/google-ads-audit-checklist.md +0 -84
- package/bundled-skills/ads/references/google-search-playbook.md +0 -120
- package/bundled-skills/ads/references/linkedin-b2b-playbook.md +0 -107
- package/bundled-skills/ads/references/meta-decision-system.md +0 -176
- package/bundled-skills/ads/references/payback-period.md +0 -69
- package/bundled-skills/ads/references/platform-setup-checklists.md +0 -277
- package/bundled-skills/ads/references/rsa-output-spec.md +0 -88
- package/bundled-skills/agent-device/SKILL.md +0 -20
- package/bundled-skills/ai-seo/SKILL.md +0 -488
- package/bundled-skills/ai-seo/evals/evals.json +0 -135
- package/bundled-skills/ai-seo/references/agent-readiness.md +0 -57
- package/bundled-skills/ai-seo/references/citations-vs-recommendations.md +0 -85
- package/bundled-skills/ai-seo/references/content-patterns.md +0 -287
- package/bundled-skills/ai-seo/references/content-types.md +0 -71
- package/bundled-skills/ai-seo/references/format-volatility.md +0 -98
- package/bundled-skills/ai-seo/references/okf.md +0 -104
- package/bundled-skills/ai-seo/references/platform-ranking-factors.md +0 -154
- package/bundled-skills/ai-seo/references/youtube-ai-citations.md +0 -60
- package/bundled-skills/analytics/SKILL.md +0 -310
- package/bundled-skills/analytics/evals/evals.json +0 -90
- package/bundled-skills/analytics/references/event-library.md +0 -260
- package/bundled-skills/analytics/references/ga4-implementation.md +0 -300
- package/bundled-skills/analytics/references/gtm-implementation.md +0 -390
- package/bundled-skills/android-emulator/SKILL.md +0 -32
- package/bundled-skills/android-reverse-engineering/LICENSE +0 -190
- package/bundled-skills/android-reverse-engineering/SKILL.md +0 -313
- package/bundled-skills/android-reverse-engineering/references/api-extraction-patterns.md +0 -197
- package/bundled-skills/android-reverse-engineering/references/call-flow-analysis.md +0 -210
- package/bundled-skills/android-reverse-engineering/references/fernflower-usage.md +0 -115
- package/bundled-skills/android-reverse-engineering/references/jadx-usage.md +0 -116
- package/bundled-skills/android-reverse-engineering/references/kotlin-name-recovery.md +0 -108
- package/bundled-skills/android-reverse-engineering/references/setup-guide.md +0 -221
- package/bundled-skills/android-reverse-engineering/references/third_party_hosts.txt +0 -122
- package/bundled-skills/android-reverse-engineering/scripts/check-deps.ps1 +0 -165
- package/bundled-skills/android-reverse-engineering/scripts/check-deps.sh +0 -129
- package/bundled-skills/android-reverse-engineering/scripts/decompile.ps1 +0 -400
- package/bundled-skills/android-reverse-engineering/scripts/decompile.sh +0 -578
- package/bundled-skills/android-reverse-engineering/scripts/find-api-calls.ps1 +0 -121
- package/bundled-skills/android-reverse-engineering/scripts/find-api-calls.sh +0 -339
- package/bundled-skills/android-reverse-engineering/scripts/fingerprint.sh +0 -241
- package/bundled-skills/android-reverse-engineering/scripts/install-dep.ps1 +0 -345
- package/bundled-skills/android-reverse-engineering/scripts/install-dep.sh +0 -448
- package/bundled-skills/android-reverse-engineering/scripts/lookup-name.sh +0 -85
- package/bundled-skills/android-reverse-engineering/scripts/recover-kotlin-names.sh +0 -140
- package/bundled-skills/build-graph/SKILL.md +0 -38
- package/bundled-skills/claude-history-ingest/SKILL.md +0 -463
- package/bundled-skills/claude-history-ingest/references/claude-data-format.md +0 -118
- package/bundled-skills/codex-history-ingest/SKILL.md +0 -248
- package/bundled-skills/codex-history-ingest/references/codex-data-format.md +0 -82
- package/bundled-skills/cold-email/SKILL.md +0 -159
- package/bundled-skills/cold-email/evals/evals.json +0 -94
- package/bundled-skills/cold-email/references/benchmarks.md +0 -83
- package/bundled-skills/cold-email/references/follow-up-sequences.md +0 -81
- package/bundled-skills/cold-email/references/frameworks.md +0 -90
- package/bundled-skills/cold-email/references/personalization.md +0 -79
- package/bundled-skills/cold-email/references/subject-lines.md +0 -53
- package/bundled-skills/competitor-profiling/SKILL.md +0 -415
- package/bundled-skills/competitor-profiling/evals/evals.json +0 -85
- package/bundled-skills/competitor-profiling/references/templates.md +0 -167
- package/bundled-skills/competitor-profiling/references/tool-reference.md +0 -179
- package/bundled-skills/computer-use/SKILL.md +0 -41
- package/bundled-skills/content-strategy/SKILL.md +0 -439
- package/bundled-skills/content-strategy/evals/evals.json +0 -116
- package/bundled-skills/content-strategy/references/content-distribution.md +0 -83
- package/bundled-skills/content-strategy/references/headless-cms.md +0 -194
- package/bundled-skills/copilot-history-ingest/SKILL.md +0 -376
- package/bundled-skills/copilot-history-ingest/references/copilot-data-format.md +0 -321
- package/bundled-skills/copy-editing/SKILL.md +0 -457
- package/bundled-skills/copy-editing/evals/evals.json +0 -89
- package/bundled-skills/copy-editing/references/checklist.md +0 -66
- package/bundled-skills/copy-editing/references/content-refresh.md +0 -38
- package/bundled-skills/copy-editing/references/plain-english-alternatives.md +0 -394
- package/bundled-skills/copywriting/SKILL.md +0 -256
- package/bundled-skills/copywriting/evals/evals.json +0 -126
- package/bundled-skills/copywriting/references/copy-frameworks.md +0 -433
- package/bundled-skills/copywriting/references/natural-transitions.md +0 -272
- package/bundled-skills/cro/SKILL.md +0 -187
- package/bundled-skills/cro/evals/evals.json +0 -111
- package/bundled-skills/cro/references/experiments.md +0 -248
- package/bundled-skills/cro/references/form.md +0 -422
- package/bundled-skills/cross-linker/SKILL.md +0 -309
- package/bundled-skills/customer-research/SKILL.md +0 -305
- package/bundled-skills/customer-research/evals/evals.json +0 -176
- package/bundled-skills/customer-research/references/interviews-and-surveys.md +0 -155
- package/bundled-skills/customer-research/references/source-guides.md +0 -401
- package/bundled-skills/daily-update/SKILL.md +0 -223
- package/bundled-skills/dart-add-unit-test/SKILL.md +0 -122
- package/bundled-skills/dart-build-cli-app/SKILL.md +0 -185
- package/bundled-skills/dart-collect-coverage/SKILL.md +0 -141
- package/bundled-skills/dart-fix-runtime-errors/SKILL.md +0 -166
- package/bundled-skills/dart-generate-test-mocks/SKILL.md +0 -155
- package/bundled-skills/dart-migrate-to-checks-package/SKILL.md +0 -528
- package/bundled-skills/dart-resolve-package-conflicts/SKILL.md +0 -116
- package/bundled-skills/dart-run-static-analysis/SKILL.md +0 -104
- package/bundled-skills/dart-setup-ffi-assets/SKILL.md +0 -419
- package/bundled-skills/dart-use-doc-examples/SKILL.md +0 -96
- package/bundled-skills/dart-use-ffigen/SKILL.md +0 -218
- package/bundled-skills/dart-use-pattern-matching/SKILL.md +0 -146
- package/bundled-skills/dart-use-primary-constructors/SKILL.md +0 -262
- package/bundled-skills/dart-write-documentation/SKILL.md +0 -136
- package/bundled-skills/debug-issue/SKILL.md +0 -28
- package/bundled-skills/dogfood/SKILL.md +0 -27
- package/bundled-skills/eas-app-stores/SKILL.md +0 -176
- package/bundled-skills/eas-app-stores/agents/openai.yaml +0 -4
- package/bundled-skills/eas-app-stores/references/app-store-metadata.md +0 -497
- package/bundled-skills/eas-app-stores/references/ios-app-store.md +0 -376
- package/bundled-skills/eas-app-stores/references/native-ios.md +0 -167
- package/bundled-skills/eas-app-stores/references/play-store.md +0 -244
- package/bundled-skills/eas-app-stores/references/testflight.md +0 -62
- package/bundled-skills/eas-app-stores/references/workflows.md +0 -120
- package/bundled-skills/eas-hosting/SKILL.md +0 -431
- package/bundled-skills/eas-hosting/agents/openai.yaml +0 -4
- package/bundled-skills/eas-observe/SKILL.md +0 -54
- package/bundled-skills/eas-observe/agents/openai.yaml +0 -4
- package/bundled-skills/eas-observe/references/metrics.md +0 -98
- package/bundled-skills/eas-observe/references/queries.md +0 -403
- package/bundled-skills/eas-observe/references/setup.md +0 -476
- package/bundled-skills/eas-observe/references/third-party.md +0 -136
- package/bundled-skills/eas-simulator/SKILL.md +0 -208
- package/bundled-skills/eas-simulator/agents/openai.yaml +0 -4
- package/bundled-skills/eas-simulator/references/controllers.md +0 -106
- package/bundled-skills/eas-simulator/references/run-your-app.md +0 -224
- package/bundled-skills/eas-simulator/references/troubleshooting.md +0 -44
- package/bundled-skills/eas-update/SKILL.md +0 -146
- package/bundled-skills/eas-update/agents/openai.yaml +0 -4
- package/bundled-skills/eas-update-insights/SKILL.md +0 -238
- package/bundled-skills/eas-update-insights/agents/openai.yaml +0 -4
- package/bundled-skills/eas-update-insights/references/channel-insights-schema.md +0 -47
- package/bundled-skills/eas-update-insights/references/update-insights-schema.md +0 -69
- package/bundled-skills/eas-workflows/SKILL.md +0 -99
- package/bundled-skills/eas-workflows/agents/openai.yaml +0 -4
- package/bundled-skills/eas-workflows/scripts/fetch.js +0 -109
- package/bundled-skills/eas-workflows/scripts/package.json +0 -6
- package/bundled-skills/emails/SKILL.md +0 -311
- package/bundled-skills/emails/evals/evals.json +0 -93
- package/bundled-skills/emails/references/copy-guidelines.md +0 -113
- package/bundled-skills/emails/references/email-types.md +0 -515
- package/bundled-skills/emails/references/sequence-templates.md +0 -168
- package/bundled-skills/explore-codebase/SKILL.md +0 -29
- package/bundled-skills/expo-animation/LICENSE +0 -21
- package/bundled-skills/expo-animation/RECIPES.md +0 -385
- package/bundled-skills/expo-animation/SKILL.md +0 -267
- package/bundled-skills/expo-animation/agents/openai.yaml +0 -4
- package/bundled-skills/expo-app-clip/SKILL.md +0 -290
- package/bundled-skills/expo-app-clip/agents/openai.yaml +0 -4
- package/bundled-skills/expo-app-clip/references/native-module.md +0 -96
- package/bundled-skills/expo-brownfield/SKILL.md +0 -62
- package/bundled-skills/expo-brownfield/agents/openai.yaml +0 -4
- package/bundled-skills/expo-brownfield/references/brownfield-integrated.md +0 -526
- package/bundled-skills/expo-brownfield/references/brownfield-isolated.md +0 -451
- package/bundled-skills/expo-brownfield/references/comparison.md +0 -63
- package/bundled-skills/expo-brownfield/references/troubleshooting.md +0 -88
- package/bundled-skills/expo-data-fetching/SKILL.md +0 -478
- package/bundled-skills/expo-data-fetching/agents/openai.yaml +0 -4
- package/bundled-skills/expo-data-fetching/references/expo-router-loaders.md +0 -341
- package/bundled-skills/expo-data-fetching/references/offline-and-cancellation.md +0 -68
- package/bundled-skills/expo-design-system/SKILL.md +0 -376
- package/bundled-skills/expo-design-system/agents/openai.yaml +0 -4
- package/bundled-skills/expo-design-system/references/audit.md +0 -190
- package/bundled-skills/expo-design-system/references/native-slop.md +0 -74
- package/bundled-skills/expo-dev-client/SKILL.md +0 -182
- package/bundled-skills/expo-dev-client/agents/openai.yaml +0 -4
- package/bundled-skills/expo-dom/SKILL.md +0 -425
- package/bundled-skills/expo-dom/agents/openai.yaml +0 -4
- package/bundled-skills/expo-examples/SKILL.md +0 -106
- package/bundled-skills/expo-examples/agents/openai.yaml +0 -4
- package/bundled-skills/expo-examples/references/catalog.md +0 -105
- package/bundled-skills/expo-migrate-module/SKILL.md +0 -113
- package/bundled-skills/expo-migrate-module/agents/openai.yaml +0 -4
- package/bundled-skills/expo-migrate-module/references/compatibility.md +0 -73
- package/bundled-skills/expo-migrate-module/references/example.md +0 -212
- package/bundled-skills/expo-migrate-module/references/migration-map.md +0 -306
- package/bundled-skills/expo-module/SKILL.md +0 -151
- package/bundled-skills/expo-module/agents/openai.yaml +0 -4
- package/bundled-skills/expo-module/references/config-plugin.md +0 -90
- package/bundled-skills/expo-module/references/create-expo-module.md +0 -206
- package/bundled-skills/expo-module/references/lifecycle.md +0 -127
- package/bundled-skills/expo-module/references/module-config.md +0 -48
- package/bundled-skills/expo-module/references/native-module.md +0 -286
- package/bundled-skills/expo-module/references/native-view.md +0 -171
- package/bundled-skills/expo-native-ui/SKILL.md +0 -201
- package/bundled-skills/expo-native-ui/agents/openai.yaml +0 -4
- package/bundled-skills/expo-native-ui/references/controls.md +0 -231
- package/bundled-skills/expo-native-ui/references/gradients.md +0 -106
- package/bundled-skills/expo-native-ui/references/icons.md +0 -232
- package/bundled-skills/expo-native-ui/references/media.md +0 -193
- package/bundled-skills/expo-native-ui/references/storage.md +0 -121
- package/bundled-skills/expo-native-ui/references/visual-effects.md +0 -198
- package/bundled-skills/expo-native-ui/references/webgpu-three.md +0 -605
- package/bundled-skills/expo-overview/SKILL.md +0 -115
- package/bundled-skills/expo-overview/agents/openai.yaml +0 -4
- package/bundled-skills/expo-project-structure/SKILL.md +0 -114
- package/bundled-skills/expo-project-structure/agents/openai.yaml +0 -4
- package/bundled-skills/expo-router/SKILL.md +0 -240
- package/bundled-skills/expo-router/agents/openai.yaml +0 -4
- package/bundled-skills/expo-router/references/form-sheet.md +0 -253
- package/bundled-skills/expo-router/references/route-structure.md +0 -229
- package/bundled-skills/expo-router/references/search.md +0 -248
- package/bundled-skills/expo-router/references/tabs.md +0 -433
- package/bundled-skills/expo-router/references/toolbar-and-headers.md +0 -284
- package/bundled-skills/expo-router/references/zoom-transitions.md +0 -158
- package/bundled-skills/expo-skill-eval/SKILL.md +0 -314
- package/bundled-skills/expo-skill-eval/agents/visual-grader.md +0 -52
- package/bundled-skills/expo-skill-eval/references/design-rubric.md +0 -45
- package/bundled-skills/expo-skill-eval/references/runtime-matrix.md +0 -34
- package/bundled-skills/expo-skill-eval/scripts/check-static.sh +0 -64
- package/bundled-skills/expo-skill-eval/scripts/clean-fixture.sh +0 -56
- package/bundled-skills/expo-skill-eval/scripts/generate_viewer.py +0 -450
- package/bundled-skills/expo-skill-eval/scripts/latest-sdk.sh +0 -46
- package/bundled-skills/expo-skill-eval/scripts/make-fixture.sh +0 -95
- package/bundled-skills/expo-skill-eval/scripts/make-workspace.sh +0 -31
- package/bundled-skills/expo-skill-eval/scripts/snapshot-android.sh +0 -284
- package/bundled-skills/expo-skill-eval/scripts/snapshot-ios.sh +0 -132
- package/bundled-skills/expo-skill-eval/scripts/snapshot-web.sh +0 -61
- package/bundled-skills/expo-skill-feedback/SKILL.md +0 -87
- package/bundled-skills/expo-skill-feedback/agents/openai.yaml +0 -4
- package/bundled-skills/expo-skill-feedback/scripts/skill-event.cjs +0 -180
- package/bundled-skills/expo-skill-feedback/scripts/telemetry.cjs +0 -65
- package/bundled-skills/expo-skill-feedback/scripts/telemetry_common.cjs +0 -171
- package/bundled-skills/expo-ui/SKILL.md +0 -101
- package/bundled-skills/expo-ui/agents/openai.yaml +0 -4
- package/bundled-skills/expo-ui/references/drop-in-replacements.md +0 -27
- package/bundled-skills/expo-ui/references/jetpack-compose.md +0 -73
- package/bundled-skills/expo-ui/references/swift-ui.md +0 -73
- package/bundled-skills/expo-ui/references/universal.md +0 -104
- package/bundled-skills/expo-ui/scripts/list-components.js +0 -193
- package/bundled-skills/expo-upgrade/SKILL.md +0 -150
- package/bundled-skills/expo-upgrade/agents/openai.yaml +0 -4
- package/bundled-skills/expo-upgrade/references/expo-av-to-audio.md +0 -132
- package/bundled-skills/expo-upgrade/references/expo-av-to-video.md +0 -160
- package/bundled-skills/expo-upgrade/references/native-tabs.md +0 -124
- package/bundled-skills/expo-upgrade/references/new-architecture.md +0 -79
- package/bundled-skills/expo-upgrade/references/react-19.md +0 -79
- package/bundled-skills/expo-upgrade/references/react-compiler.md +0 -59
- package/bundled-skills/expo-upgrade/references/react-navigation-to-expo-router.md +0 -61
- package/bundled-skills/expo-web-to-native/SKILL.md +0 -91
- package/bundled-skills/expo-web-to-native/agents/openai.yaml +0 -4
- package/bundled-skills/expo-web-to-native/references/false-friends.md +0 -119
- package/bundled-skills/expo-web-to-native/references/native-patterns.md +0 -39
- package/bundled-skills/expo-web-to-native/references/run-as-goal.md +0 -48
- package/bundled-skills/expo-web-to-native/references/verify-on-device.md +0 -45
- package/bundled-skills/find-skills/SKILL.md +0 -141
- package/bundled-skills/flutter-add-integration-test/SKILL.md +0 -163
- package/bundled-skills/flutter-add-widget-preview/SKILL.md +0 -145
- package/bundled-skills/flutter-add-widget-test/SKILL.md +0 -154
- package/bundled-skills/flutter-apply-architecture-best-practices/SKILL.md +0 -162
- package/bundled-skills/flutter-build-responsive-layout/SKILL.md +0 -139
- package/bundled-skills/flutter-fix-layout-issues/SKILL.md +0 -130
- package/bundled-skills/flutter-implement-json-serialization/SKILL.md +0 -153
- package/bundled-skills/flutter-setup-declarative-routing/SKILL.md +0 -255
- package/bundled-skills/flutter-setup-localization/SKILL.md +0 -210
- package/bundled-skills/flutter-use-http-package/SKILL.md +0 -174
- package/bundled-skills/graph-colorize/SKILL.md +0 -180
- package/bundled-skills/hermes-history-ingest/SKILL.md +0 -239
- package/bundled-skills/hermes-history-ingest/references/hermes-data-format.md +0 -131
- package/bundled-skills/impl-validator/SKILL.md +0 -118
- package/bundled-skills/ios-simulator/SKILL.md +0 -32
- package/bundled-skills/json-canvas/SKILL.md +0 -244
- package/bundled-skills/json-canvas/references/EXAMPLES.md +0 -329
- package/bundled-skills/launch/SKILL.md +0 -381
- package/bundled-skills/launch/evals/evals.json +0 -106
- package/bundled-skills/llm-wiki/SKILL.md +0 -661
- package/bundled-skills/llm-wiki/references/WRITING.md +0 -28
- package/bundled-skills/llm-wiki/references/karpathy-pattern.md +0 -45
- package/bundled-skills/marketing-plan/SKILL.md +0 -300
- package/bundled-skills/marketing-plan/evals/evals.json +0 -112
- package/bundled-skills/marketing-plan/references/aarrr-framework.md +0 -180
- package/bundled-skills/marketing-plan/references/budget-planning.md +0 -168
- package/bundled-skills/marketing-plan/references/client-types.md +0 -373
- package/bundled-skills/marketing-plan/references/current-state-rubric.md +0 -255
- package/bundled-skills/marketing-plan/references/example-quietude.md +0 -972
- package/bundled-skills/marketing-plan/references/funding-stage-unlocks.md +0 -230
- package/bundled-skills/marketing-plan/references/growth-patterns.md +0 -190
- package/bundled-skills/marketing-plan/references/idea-cross-reference.md +0 -265
- package/bundled-skills/marketing-plan/references/measurement-framework.md +0 -213
- package/bundled-skills/marketing-plan/references/methodology.md +0 -363
- package/bundled-skills/marketing-plan/references/ops-stack-mapping.md +0 -197
- package/bundled-skills/marketing-plan/references/plan-template.md +0 -494
- package/bundled-skills/marketing-plan/references/team-and-agency-model.md +0 -278
- package/bundled-skills/marketing-psychology/SKILL.md +0 -455
- package/bundled-skills/marketing-psychology/evals/evals.json +0 -88
- package/bundled-skills/memory-bridge/SKILL.md +0 -163
- package/bundled-skills/memory-save/SKILL.md +0 -88
- package/bundled-skills/obsidian-bases/SKILL.md +0 -499
- package/bundled-skills/obsidian-bases/references/FUNCTIONS_REFERENCE.md +0 -173
- package/bundled-skills/obsidian-cli/SKILL.md +0 -106
- package/bundled-skills/obsidian-layout-adjustment/SKILL.md +0 -226
- package/bundled-skills/obsidian-layout-adjustment/evals/evals.json +0 -53
- package/bundled-skills/obsidian-layout-adjustment/references/workflow-reference.md +0 -212
- package/bundled-skills/obsidian-markdown/SKILL.md +0 -196
- package/bundled-skills/obsidian-markdown/references/CALLOUTS.md +0 -58
- package/bundled-skills/obsidian-markdown/references/EMBEDS.md +0 -70
- package/bundled-skills/obsidian-markdown/references/PROPERTIES.md +0 -61
- package/bundled-skills/offers/SKILL.md +0 -155
- package/bundled-skills/offers/evals/evals.json +0 -21
- package/bundled-skills/offers/references/bonus-stacking.md +0 -150
- package/bundled-skills/offers/references/examples.md +0 -215
- package/bundled-skills/offers/references/guarantee-design.md +0 -172
- package/bundled-skills/offers/references/offer-anatomy.md +0 -203
- package/bundled-skills/offers/references/offer-formats.md +0 -240
- package/bundled-skills/offers/references/saas-offers.md +0 -116
- package/bundled-skills/offers/references/scarcity-urgency.md +0 -175
- package/bundled-skills/offers/references/value-equation.md +0 -134
- package/bundled-skills/onboarding/SKILL.md +0 -261
- package/bundled-skills/onboarding/evals/evals.json +0 -108
- package/bundled-skills/onboarding/references/activation-models.md +0 -57
- package/bundled-skills/onboarding/references/experiments.md +0 -258
- package/bundled-skills/onboarding/references/minimum-path-to-value.md +0 -49
- package/bundled-skills/openclaw-history-ingest/SKILL.md +0 -257
- package/bundled-skills/openclaw-history-ingest/references/openclaw-data-format.md +0 -154
- package/bundled-skills/orchestration/SKILL.md +0 -69
- package/bundled-skills/pi-history-ingest/SKILL.md +0 -312
- package/bundled-skills/pricing/SKILL.md +0 -295
- package/bundled-skills/pricing/evals/evals.json +0 -119
- package/bundled-skills/pricing/references/pricing-models.md +0 -66
- package/bundled-skills/pricing/references/pricing-page-teardown.md +0 -85
- package/bundled-skills/pricing/references/research-methods.md +0 -152
- package/bundled-skills/pricing/references/tier-structure.md +0 -232
- package/bundled-skills/product-marketing/SKILL.md +0 -255
- package/bundled-skills/product-marketing/evals/evals.json +0 -98
- package/bundled-skills/prospecting/SKILL.md +0 -262
- package/bundled-skills/prospecting/evals/evals.json +0 -122
- package/bundled-skills/prospecting/references/b2b-prospecting.md +0 -106
- package/bundled-skills/prospecting/references/compliance.md +0 -123
- package/bundled-skills/prospecting/references/data-sources.md +0 -287
- package/bundled-skills/prospecting/references/demand-signals.md +0 -129
- package/bundled-skills/prospecting/references/local-prospecting.md +0 -165
- package/bundled-skills/prospecting/references/saas-prospecting.md +0 -123
- package/bundled-skills/refactor-safely/SKILL.md +0 -29
- package/bundled-skills/review-delta/SKILL.md +0 -46
- package/bundled-skills/review-pr/SKILL.md +0 -66
- package/bundled-skills/sales-enablement/SKILL.md +0 -359
- package/bundled-skills/sales-enablement/evals/evals.json +0 -91
- package/bundled-skills/sales-enablement/references/deck-frameworks.md +0 -263
- package/bundled-skills/sales-enablement/references/demo-scripts.md +0 -355
- package/bundled-skills/sales-enablement/references/objection-library.md +0 -270
- package/bundled-skills/sales-enablement/references/one-pager-templates.md +0 -208
- package/bundled-skills/seo-audit/SKILL.md +0 -499
- package/bundled-skills/seo-audit/evals/evals.json +0 -136
- package/bundled-skills/seo-audit/references/ai-writing-detection.md +0 -200
- package/bundled-skills/seo-audit/references/international-seo.md +0 -230
- package/bundled-skills/session-brain/SKILL.md +0 -101
- package/bundled-skills/session-search/SKILL.md +0 -97
- package/bundled-skills/social/SKILL.md +0 -413
- package/bundled-skills/social/evals/evals.json +0 -107
- package/bundled-skills/social/references/carousel-frameworks.md +0 -141
- package/bundled-skills/social/references/listening-sources-template.md +0 -123
- package/bundled-skills/social/references/listening.md +0 -283
- package/bundled-skills/social/references/platform-limits.md +0 -110
- package/bundled-skills/social/references/platforms.md +0 -170
- package/bundled-skills/social/references/post-templates.md +0 -179
- package/bundled-skills/social/references/reverse-engineering.md +0 -195
- package/bundled-skills/social/references/short-form-video.md +0 -237
- package/bundled-skills/tag-taxonomy/SKILL.md +0 -218
- package/bundled-skills/vault-skill-factory/SKILL.md +0 -143
- package/bundled-skills/video/SKILL.md +0 -346
- package/bundled-skills/video/evals/evals.json +0 -103
- package/bundled-skills/video/references/ai-video-prompting.md +0 -175
- package/bundled-skills/video/references/edit-anatomy.md +0 -84
- package/bundled-skills/wiki-agent/SKILL.md +0 -322
- package/bundled-skills/wiki-capture/SKILL.md +0 -337
- package/bundled-skills/wiki-capture/references/RAW-FORMAT.md +0 -115
- package/bundled-skills/wiki-context-pack/SKILL.md +0 -89
- package/bundled-skills/wiki-dashboard/SKILL.md +0 -472
- package/bundled-skills/wiki-dedup/SKILL.md +0 -320
- package/bundled-skills/wiki-digest/SKILL.md +0 -243
- package/bundled-skills/wiki-export/SKILL.md +0 -445
- package/bundled-skills/wiki-history-ingest/SKILL.md +0 -61
- package/bundled-skills/wiki-import/SKILL.md +0 -276
- package/bundled-skills/wiki-ingest/SKILL.md +0 -563
- package/bundled-skills/wiki-ingest/references/ingest-prompts.md +0 -54
- package/bundled-skills/wiki-ingest/references/pageindex.md +0 -72
- package/bundled-skills/wiki-ingest/references/url-sources.md +0 -295
- package/bundled-skills/wiki-lint/SKILL.md +0 -643
- package/bundled-skills/wiki-narrate/SKILL.md +0 -120
- package/bundled-skills/wiki-narrate/references/voices.md +0 -29
- package/bundled-skills/wiki-query/SKILL.md +0 -307
- package/bundled-skills/wiki-rebuild/SKILL.md +0 -212
- package/bundled-skills/wiki-research/SKILL.md +0 -319
- package/bundled-skills/wiki-setup/SKILL.md +0 -359
- package/bundled-skills/wiki-stage-commit/SKILL.md +0 -164
- package/bundled-skills/wiki-status/SKILL.md +0 -556
- package/bundled-skills/wiki-switch/SKILL.md +0 -115
- package/bundled-skills/wiki-synthesize/SKILL.md +0 -212
- package/bundled-skills/wiki-update/SKILL.md +0 -271
- package/skills/ai-security/SKILL.md +0 -132
- package/skills/ai-security/references/atlas-coverage.md +0 -60
- package/skills/ai-security/scripts/ai_threat_scanner.py +0 -373
- package/skills/anti-AI-design/SKILL.md +0 -72
- package/skills/apple-hig-audit/SKILL.md +0 -64
- package/skills/apple-hig-audit/references/accessibility.md +0 -78
- package/skills/apple-hig-audit/references/platform-specifics.md +0 -57
- package/skills/apple-hig-audit/references/visual-design.md +0 -68
- package/skills/apple-hig-audit/scripts/hig_checker.py +0 -115
- package/skills/apple-hig-audit/templates/hig-audit-template.md +0 -114
- package/skills/dependency-auditor/README.md +0 -98
- package/skills/dependency-auditor/SKILL.md +0 -114
- package/skills/dependency-auditor/assets/sample_go.mod +0 -53
- package/skills/dependency-auditor/assets/sample_package.json +0 -72
- package/skills/dependency-auditor/assets/sample_requirements.txt +0 -71
- package/skills/dependency-auditor/expected_outputs/sample_license_report.txt +0 -37
- package/skills/dependency-auditor/expected_outputs/sample_upgrade_plan.txt +0 -59
- package/skills/dependency-auditor/expected_outputs/sample_vulnerability_report.json +0 -71
- package/skills/dependency-auditor/references/dependency_management_best_practices.md +0 -46
- package/skills/dependency-auditor/references/license_compatibility_matrix.md +0 -57
- package/skills/dependency-auditor/references/vulnerability_assessment_guide.md +0 -62
- package/skills/dependency-auditor/scripts/dep_scanner.py +0 -595
- package/skills/dependency-auditor/scripts/license_checker.py +0 -442
- package/skills/dependency-auditor/scripts/upgrade_planner.py +0 -490
- package/skills/dependency-auditor/test-inventory.json +0 -421
- package/skills/dependency-auditor/test-project/package.json +0 -72
- package/skills/design-system-tokens/SKILL.md +0 -90
- package/skills/design-system-tokens/assets/design_system_doc_template.md +0 -129
- package/skills/design-system-tokens/references/component-architecture.md +0 -88
- package/skills/design-system-tokens/references/developer-handoff.md +0 -61
- package/skills/design-system-tokens/references/responsive-calculations.md +0 -72
- package/skills/design-system-tokens/references/token-generation.md +0 -62
- package/skills/design-system-tokens/scripts/design_token_generator.py +0 -315
- package/skills/engineering-code-standards/SKILL.md +0 -174
- package/skills/env-secrets-manager/SKILL.md +0 -102
- package/skills/env-secrets-manager/references/secret-patterns.md +0 -56
- package/skills/env-secrets-manager/references/validation-detection-rotation.md +0 -76
- package/skills/env-secrets-manager/scripts/env_auditor.py +0 -340
- package/skills/frontend-design-taste/SKILL.md +0 -62
- package/skills/mcp-server-builder/README.md +0 -42
- package/skills/mcp-server-builder/SKILL.md +0 -144
- package/skills/mcp-server-builder/references/openapi-extraction-guide.md +0 -34
- package/skills/mcp-server-builder/references/production-hardening-guide.md +0 -80
- package/skills/mcp-server-builder/references/python-server-template.md +0 -22
- package/skills/mcp-server-builder/references/spec-compatibility.md +0 -129
- package/skills/mcp-server-builder/references/typescript-server-template.md +0 -19
- package/skills/mcp-server-builder/references/validation-checklist.md +0 -30
- package/skills/mcp-server-builder/scripts/mcp_validator.py +0 -180
- package/skills/mcp-server-builder/scripts/openapi_to_mcp.py +0 -279
- package/skills/playwright-agent/SKILL.md +0 -147
- package/skills/skill-creator/LICENSE.txt +0 -14
- package/skills/skill-creator/SKILL.md +0 -471
- package/skills/skill-creator/agents/analyzer.md +0 -274
- package/skills/skill-creator/agents/comparator.md +0 -202
- package/skills/skill-creator/agents/grader.md +0 -223
- package/skills/skill-creator/assets/eval_review.html +0 -143
- package/skills/skill-creator/eval-viewer/generate_review.py +0 -471
- package/skills/skill-creator/eval-viewer/viewer.html +0 -1321
- package/skills/skill-creator/references/schemas.md +0 -430
- package/skills/skill-creator/scripts/__init__.py +0 -0
- package/skills/skill-creator/scripts/aggregate_benchmark.py +0 -401
- package/skills/skill-creator/scripts/generate_report.py +0 -322
- package/skills/skill-creator/scripts/improve_description.py +0 -247
- package/skills/skill-creator/scripts/package_skill.py +0 -136
- package/skills/skill-creator/scripts/quick_validate.py +0 -103
- package/skills/skill-creator/scripts/run_eval.py +0 -310
- package/skills/skill-creator/scripts/run_loop.py +0 -328
- package/skills/skill-creator/scripts/utils.py +0 -47
- package/skills/write-a-skill/SKILL.md +0 -111
- package/skills/write-a-skill/references/companion_tooling.md +0 -61
- package/skills/write-a-skill/references/description_design_patterns.md +0 -136
- package/skills/write-a-skill/references/progressive_disclosure_principles.md +0 -87
- package/skills/write-a-skill/references/quality_gates_for_skills.md +0 -158
- package/skills/write-a-skill/scripts/skill_description_validator.py +0 -241
- package/skills/write-a-skill/scripts/skill_review_checklist_runner.py +0 -257
- package/skills/write-a-skill/scripts/skill_structure_validator.py +0 -265
|
@@ -1,262 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dart-use-primary-constructors
|
|
3
|
-
description: >
|
|
4
|
-
Help users write syntactically and semantically correct primary constructors in Dart, and migrate/use the new constructor syntax, empty-body semicolon syntax, in-body initializer list syntax, and abbreviated concise constructor syntax.
|
|
5
|
-
metadata:
|
|
6
|
-
model: models/gemini-3.1-pro-preview
|
|
7
|
-
last_modified: Thu, 09 Jul 2026 23:13:25 GMT
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
# Dart Primary Constructors & New Constructor Syntax Skill
|
|
11
|
-
|
|
12
|
-
Use this skill when helping users write, refactor, or debug code using Dart's **Primary Constructors** feature.
|
|
13
|
-
|
|
14
|
-
### Dart Version Requirements
|
|
15
|
-
* **Dart 3.13 and above**: Primary constructors are enabled by default.
|
|
16
|
-
* **Dart 3.12**: The feature is available but experimental. Users must explicitly enable the experiment flag `primary-constructors` via `--enable-experiment=primary-constructors` or in `analysis_options.yaml`:
|
|
17
|
-
```yaml
|
|
18
|
-
analyzer:
|
|
19
|
-
enable-experiment:
|
|
20
|
-
- primary-constructors
|
|
21
|
-
```
|
|
22
|
-
* **Dart 3.11 and earlier**: Primary constructors are not supported.
|
|
23
|
-
|
|
24
|
-
---
|
|
25
|
-
|
|
26
|
-
## 1. Overview
|
|
27
|
-
Primary Constructors allow developers to declare a non-redirecting generative constructor as well as a set of instance variables directly in the class header. This significantly reduces boilerplate and improves code readability.
|
|
28
|
-
|
|
29
|
-
### Key Benefits
|
|
30
|
-
- Combines field declaration, parameter declaration, and initialization into a single declaration known as a declaring parameter declaration.
|
|
31
|
-
- Enables safe reference to constructor parameters in non-late field initializers (Primary Initializer Scope).
|
|
32
|
-
- Allows empty declaration bodies to be represented concisely with a semicolon (`;`).
|
|
33
|
-
- Introduces abbreviated concise syntax for in-body constructors.
|
|
34
|
-
|
|
35
|
-
---
|
|
36
|
-
|
|
37
|
-
## 2. Syntax Reference
|
|
38
|
-
|
|
39
|
-
### 2.1 Basic Class Header Syntax
|
|
40
|
-
To declare a primary constructor, place a parameter list immediately after the type name (and optional type parameters):
|
|
41
|
-
|
|
42
|
-
```dart
|
|
43
|
-
// Declares fields x and y, and a generative constructor Point(this.x, this.y)
|
|
44
|
-
class Point(var int x, var int y);
|
|
45
|
-
|
|
46
|
-
// Declares final fields
|
|
47
|
-
class PointFinal(final int x, final int y);
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
### 2.2 Declaring, Initializing, and Plain Parameters
|
|
51
|
-
A primary constructor parameter list distinguishes between three types of parameters:
|
|
52
|
-
1. **Declaring Parameters**: Indicated by the `var` or `final` modifier (e.g., `final int x`). They implicitly create a corresponding instance field in the class.
|
|
53
|
-
2. **Initializing Parameters**: Indicated by the `this.` or `super.` prefix (e.g., `this.x` or `super.x`). They initialize an existing field or a super constructor parameter, respectively.
|
|
54
|
-
3. **Regular Parameters**: Declared without modifiers (e.g., `int y`). They do not become fields and are only available during initialization (e.g., in field initializers or the `this :` initializer list in the class body).
|
|
55
|
-
|
|
56
|
-
```dart
|
|
57
|
-
// `x` is a field and a parameter because it has the keyword `final`. In particular, we can use the name `x` in the initializer list in the in-body part of the primary constructor. 'y' is a only parameter because it has neither of the keywords `final` or `var`, but `y` is passed to the super constructor via the `this :` initializer list.
|
|
58
|
-
class C(final int x, int y) extends Base {
|
|
59
|
-
this : super(y);
|
|
60
|
-
}
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
Declaring parameters and initializing parameters are two ways of achieving the same goal: declaring a class with instance fields which are set in the constructor. Regular parameters are different in that their values are not automatically routed to an instance field.
|
|
64
|
-
|
|
65
|
-
### 2.3 Constant Primary Constructors
|
|
66
|
-
To make a primary constructor `const`, place the `const` keyword before the class/type name in the declaration header:
|
|
67
|
-
|
|
68
|
-
```dart
|
|
69
|
-
class const Point(final int x, final int y);
|
|
70
|
-
extension type const Ext(int x);
|
|
71
|
-
enum const MyEnum(final int x) {
|
|
72
|
-
entry(1);
|
|
73
|
-
}
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
### 2.4 Extension Types
|
|
77
|
-
Extension types **must** use primary constructors.
|
|
78
|
-
- The single parameter in the header is the representation field.
|
|
79
|
-
- The representation variable cannot use the `var` modifier (using `var` triggers the `representation_field_modifier` error).
|
|
80
|
-
- The representation variable can optionally use the `final` modifier. If `final` is not present then it is inferred; that is, the parameter is declaring whether or not it's explicitly `final`.
|
|
81
|
-
|
|
82
|
-
### 2.5 Empty Body Semicolon Shorthand (`;`)
|
|
83
|
-
When a class, mixin class, mixin, extension or extension type has an empty body, the `{}` braces can be replaced by a semicolon (`;`):
|
|
84
|
-
|
|
85
|
-
```dart
|
|
86
|
-
class C(int x);
|
|
87
|
-
mixin class MC;
|
|
88
|
-
extension type ET(int x);
|
|
89
|
-
mixin M;
|
|
90
|
-
extension Ext on C;
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### 2.6 The In-Body Part of a Primary Constructor (`this ...`)
|
|
94
|
-
If a primary constructor requires assertions or custom field initializations, they can be declared in the body using the `this :` syntax:
|
|
95
|
-
|
|
96
|
-
```dart
|
|
97
|
-
class Point(var int x, var int y) {
|
|
98
|
-
// Initializer list in class body
|
|
99
|
-
this : assert(x >= 0), y = y * 2;
|
|
100
|
-
}
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
You can also write a constructor body with this syntax (`this {...}`).
|
|
104
|
-
|
|
105
|
-
### 2.7 Abbreviated Concise Constructor Syntax
|
|
106
|
-
For constructors declared within the class body, the class name can be omitted and replaced with the `new` or `factory` keywords:
|
|
107
|
-
|
|
108
|
-
| Traditional Syntax | Abbreviated Concise Syntax |
|
|
109
|
-
| :--- | :--- |
|
|
110
|
-
| `MyClass() {}` | `new() {}` |
|
|
111
|
-
| `MyClass.name() {}` | `new name() {}` |
|
|
112
|
-
| `const MyClass();` | `const new();` |
|
|
113
|
-
| `const MyClass.name();` | `const new name();` |
|
|
114
|
-
| `factory MyClass() => ...` | `factory() => ...` |
|
|
115
|
-
| `factory MyClass.name() => ...` | `factory name() => ...` |
|
|
116
|
-
|
|
117
|
-
---
|
|
118
|
-
|
|
119
|
-
## 3. Semantics & Scoping Rules
|
|
120
|
-
|
|
121
|
-
### 3.1 Primary Initializer Scope
|
|
122
|
-
When a primary constructor is declared, its formal parameters are introduced into the **Primary Initializer Scope**. This scope is the current scope for non-late field initializers in the class body and the primary constructor's initializer list (after `this :`).
|
|
123
|
-
This allows non-late fields to reference constructor parameters directly during declaration:
|
|
124
|
-
```dart
|
|
125
|
-
class DeltaPoint(final int x, int delta) {
|
|
126
|
-
// 'x' and 'delta' are in scope here
|
|
127
|
-
final int y = x + delta;
|
|
128
|
-
}
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
### 3.2 Late Instance Variables Restriction
|
|
132
|
-
The primary initializer scope is **not** active for `late` instance variable initializers.
|
|
133
|
-
- Since `late` variables can be evaluated after construction has completed, their initializers cannot safely access constructor parameters.
|
|
134
|
-
- Attempting to access a primary constructor parameter in a `late` field initializer results in a compile-time error.
|
|
135
|
-
|
|
136
|
-
### 3.3 Shadowing
|
|
137
|
-
Primary constructor parameters shadow class members (fields) of the same name within the primary initializer scope:
|
|
138
|
-
- In a non-late initializer: `int y = x` refers to parameter `x`.
|
|
139
|
-
- In a `late` initializer: `late int y = x` refers to field `x` (if it exists) because the parameter `x` is out of scope.
|
|
140
|
-
|
|
141
|
-
### 3.4 Generative Constructor Restrictions
|
|
142
|
-
To guarantee that the primary constructor (and the associated initializer scope) always executes:
|
|
143
|
-
- A class, mixin class, or enum declaration with a primary constructor **cannot** declare any other non-redirecting generative constructors (except extension types).
|
|
144
|
-
- All other generative constructors declared in the body **must** redirect (directly or indirectly) to the primary constructor.
|
|
145
|
-
|
|
146
|
-
### 3.5 Parameter Mutation Errors
|
|
147
|
-
Primary constructor parameters are non-assignable inside the initialization phase.
|
|
148
|
-
- Any assignment to a parameter (e.g., `p = value`, `p++`) inside field initializers or the `this :` initializer list is a compile-time error.
|
|
149
|
-
|
|
150
|
-
### 3.6 Double Initialization Errors
|
|
151
|
-
Initializing a field twice (e.g., once in the field declaration/initializer and once in the `this :` initializer list or as an initializing formal) is a compile-time error.
|
|
152
|
-
|
|
153
|
-
---
|
|
154
|
-
|
|
155
|
-
## 4. Diagnostics & Troubleshooting
|
|
156
|
-
|
|
157
|
-
Most errors and lints have quick-fixes, run `dart fix` to fix those violations. For other common errors, fix them using the following table:
|
|
158
|
-
|
|
159
|
-
| Error / Lint Code | Common Cause | Resolution |
|
|
160
|
-
| :--- | :--- | :--- |
|
|
161
|
-
| **Invalid Late Access** | Referencing a primary constructor parameter inside a `late` field initializer. | Make the field non-late, or pass the value through another non-late field. |
|
|
162
|
-
| `fieldInitializedInInitializerAndDeclaration` | Initializing a variable both in its declaration and in the `this :` list. | Remove one of the initializations. |
|
|
163
|
-
| `nonRedirectingGenerativeConstructorWithPrimary` | Declaring a in-body generative constructor in the body without redirecting to the primary. | Change the in-body constructor such that it is redirecting (e.g. `this(...)`) or remove the in-body constructor. |
|
|
164
|
-
|
|
165
|
-
---
|
|
166
|
-
|
|
167
|
-
## 5. Step-by-Step Refactoring Workflows
|
|
168
|
-
|
|
169
|
-
### Workflow 5.1: Migrating a Class to a Primary Constructor
|
|
170
|
-
|
|
171
|
-
Follow these steps to migrate a verbose class to the new primary constructor syntax:
|
|
172
|
-
|
|
173
|
-
1. **Identify Candidate Fields and Constructor**:
|
|
174
|
-
Locate generative constructors and the fields they initialize. In this case, this would be the `name` and `age` fields.
|
|
175
|
-
```dart
|
|
176
|
-
// Before
|
|
177
|
-
class User {
|
|
178
|
-
final String name;
|
|
179
|
-
final int age;
|
|
180
|
-
User(this.name, this.age);
|
|
181
|
-
}
|
|
182
|
-
```
|
|
183
|
-
|
|
184
|
-
2. **Move Fields to the Header**:
|
|
185
|
-
Place fields in the header with `final` or `var` modifiers and append a semicolon (`;`) if the body is empty. The `name` and `age` fields are now written the primary constructor as declaring parameters `final String name` and `final int age`, respectively.
|
|
186
|
-
```dart
|
|
187
|
-
// After
|
|
188
|
-
class User(final String name, final int age);
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
3. **Handle Custom Initializers and Assertions**:
|
|
192
|
-
If there is an initializer list or assert block, move it to a `this` block inside the body:
|
|
193
|
-
```dart
|
|
194
|
-
// Before
|
|
195
|
-
class Point {
|
|
196
|
-
final int x;
|
|
197
|
-
final int y;
|
|
198
|
-
Point(this.x, this.y) : assert(x >= 0);
|
|
199
|
-
}
|
|
200
|
-
|
|
201
|
-
// After
|
|
202
|
-
class Point(final int x, final int y) {
|
|
203
|
-
this : assert(x >= 0);
|
|
204
|
-
}
|
|
205
|
-
```
|
|
206
|
-
|
|
207
|
-
4. **Leverage Primary Initializer Scope for Calculations**:
|
|
208
|
-
If a field value is calculated from parameters, declare it inside the body and assign it directly using the parameters:
|
|
209
|
-
```dart
|
|
210
|
-
// Before
|
|
211
|
-
class Rect {
|
|
212
|
-
final double width;
|
|
213
|
-
final double height;
|
|
214
|
-
final double area;
|
|
215
|
-
Rect(this.width, this.height) : area = width * height;
|
|
216
|
-
}
|
|
217
|
-
|
|
218
|
-
// After
|
|
219
|
-
class Rect(final double width, final double height) {
|
|
220
|
-
// 'width' and 'height' are in scope here
|
|
221
|
-
final double area = width * height;
|
|
222
|
-
}
|
|
223
|
-
```
|
|
224
|
-
|
|
225
|
-
5. **Convert In-Body Constructors to Redirecting**:
|
|
226
|
-
Ensure all in-body generative constructors redirect to the primary constructor:
|
|
227
|
-
```dart
|
|
228
|
-
// Before
|
|
229
|
-
class Point {
|
|
230
|
-
final int x;
|
|
231
|
-
final int y;
|
|
232
|
-
Point(this.x, this.y);
|
|
233
|
-
Point.zero() : x = 0, y = 0;
|
|
234
|
-
}
|
|
235
|
-
|
|
236
|
-
// After
|
|
237
|
-
class Point(final int x, final int y) {
|
|
238
|
-
new zero() : this(0, 0); // Redirects to primary
|
|
239
|
-
}
|
|
240
|
-
```
|
|
241
|
-
|
|
242
|
-
### Workflow 5.2: Applying Abbreviated (Concise) In-Body Constructors
|
|
243
|
-
|
|
244
|
-
When the user prefers to keep the constructor in the class body but wants to reduce verbosity, suggest the abbreviated constructor syntax:
|
|
245
|
-
|
|
246
|
-
```dart
|
|
247
|
-
// Before
|
|
248
|
-
class DatabaseService {
|
|
249
|
-
final String url;
|
|
250
|
-
DatabaseService(this.url);
|
|
251
|
-
DatabaseService.local() : url = 'localhost';
|
|
252
|
-
factory DatabaseService.create() => DatabaseService('default');
|
|
253
|
-
}
|
|
254
|
-
|
|
255
|
-
// After
|
|
256
|
-
class DatabaseService {
|
|
257
|
-
final String url;
|
|
258
|
-
new(this.url); // Omit class name, use 'new'
|
|
259
|
-
new local() : url = 'localhost'; // Use 'new local' for named constructors
|
|
260
|
-
factory create() => DatabaseService('default'); // Omit class name from factory
|
|
261
|
-
}
|
|
262
|
-
```
|
|
@@ -1,136 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dart-write-documentation
|
|
3
|
-
description: "Rules and formatting guidelines for writing Dart /// API documentation and doc comments. Use when documenting Dart code, writing doc comments for any Dart declaration (libraries, classes, methods, variables, etc.), or when instructed to follow the Effective Dart documentation guidelines."
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
# Writing Dart API Documentation
|
|
7
|
-
|
|
8
|
-
## Contents
|
|
9
|
-
* [1. Scope and Structure](#1-scope-and-structure)
|
|
10
|
-
* [2. Tone and Openers](#2-tone-and-openers)
|
|
11
|
-
* [3. Strict Anti-Patterns (Banned)](#3-strict-anti-patterns-banned)
|
|
12
|
-
* [4. Technical Placement & Resolution](#4-technical-placement--resolution)
|
|
13
|
-
* [5. Linking and Markdown](#5-linking-and-markdown)
|
|
14
|
-
* [6. Verification](#6-verification)
|
|
15
|
-
* [Examples](#examples)
|
|
16
|
-
|
|
17
|
-
When asked to write or update documentation for Dart code, you must strictly follow these formatting rules based on the "Effective Dart: Documentation" guidelines.
|
|
18
|
-
|
|
19
|
-
## 1. Scope and Structure
|
|
20
|
-
* **Target Public APIs:** Focus your documentation efforts on public declarations. Do not document private members (those starting with an underscore `_`) unless explicitly instructed, as they do not appear in generated API reference sites.
|
|
21
|
-
* **Always use `///`:** Use `///` consecutive line comments for all API documentation. Never use `/** ... */` block comments.
|
|
22
|
-
* **Proper Sentences:** Format all comments like proper sentences. Capitalize the first word (unless it's a lowercase identifier) and end with a period.
|
|
23
|
-
* **The First Paragraph:** The first paragraph of a doc comment must be a single, concise sentence that summarizes the element. End it with a period. Dartdoc extracts this verbatim for list views.
|
|
24
|
-
* **Separation:** Always separate the first sentence summary from the rest of the documentation with a blank line containing `///`. Never output a completely empty newline (e.g., a `\n` without `///`), as this terminates the doc comment block.
|
|
25
|
-
|
|
26
|
-
## 2. Tone and Openers
|
|
27
|
-
* **Noun phrases for properties:** Start descriptions of variables, getters, or setters with a noun phrase.
|
|
28
|
-
`/// The radius of the sphere.` (Not "Gets the radius...")
|
|
29
|
-
* **"Whether" for booleans:** Start documentation for boolean properties with "Whether".
|
|
30
|
-
`/// Whether the connection is active.`
|
|
31
|
-
* **Third-person verbs for methods:** Start descriptions of methods or functions with a third-person verb that describes what it does.
|
|
32
|
-
`/// Initializes the database.` (Not "Initialize" or "This method initializes").
|
|
33
|
-
* **Avoid redundancy:** Do not restate the signature or the element name. Do not say "This class is a..." or "The foo method does...".
|
|
34
|
-
|
|
35
|
-
## 3. Strict Anti-Patterns (Banned)
|
|
36
|
-
* **No Javadoc/TSDoc Tags (`@param`, `@return`, `@throws`, etc.):** Never use Javadoc-style tags (`@param`, `@return`, `@returns`, `@throws`, `@exception`, `@see`, `@type`). Instead, weave parameter names, return behavior, and exceptions into the prose.
|
|
37
|
-
|
|
38
|
-
## 4. Technical Placement & Resolution
|
|
39
|
-
* **Annotations (`@override`, etc.):** Doc comments must be placed before metadata annotations.
|
|
40
|
-
* **Inherited Documentation:** Avoid duplicating doc comments on `@override` members if the behavior does not differ from the superclass or interface. Dartdoc automatically inherits the base documentation.
|
|
41
|
-
* **Getter/Setter Pairs:** If a property has both a getter and a setter, place the documentation only on the getter. Tooling will emit a warning if both are documented.
|
|
42
|
-
* **Default Constructors:** To link to a default, unnamed constructor in doc comments, you must use the `.new` syntax (e.g., `[ClassName.new]`).
|
|
43
|
-
|
|
44
|
-
## 5. Linking and Markdown
|
|
45
|
-
* **Square brackets (`[identifier]`) for in-scope symbols:** Use square brackets to link to any in-scope identifier (parameters, classes, methods, fields, and top-level functions) so dartdoc can resolve them. Never use backticks for parameters.
|
|
46
|
-
* **No parentheses in method links:** Avoid parentheses in links (e.g., use `[String.contains]`, not `[String.contains()]`).
|
|
47
|
-
* **Backticks for keywords & literals:** Use backticks for keywords, literals, and arbitrary expressions (e.g. `` `null` ``, `` `true` ``, `` `void` ``). Never put keywords in square brackets (avoid `[null]` or `[true]`).
|
|
48
|
-
* **Out-of-Scope Links:** If you need to link to a symbol that is not imported by the current library, use the `@docImport` directive at the top of the file (on the `library;` declaration) rather than adding a standard `import`.
|
|
49
|
-
* **Code Blocks:** For code samples, always label the language fence. Use ```` ```dart ```` for Dart, or ```` ```sh ```` for shell commands. Do not leave code blocks unlabelled, as Dartdoc will attempt to auto-detect the language and frequently guesses wrong.
|
|
50
|
-
* **Formatting:** Use standard Markdown (bold, lists, etc.) after the first paragraph to fully explain edge cases, exceptions thrown, and internal behavior the caller cannot see.
|
|
51
|
-
|
|
52
|
-
## 6. Verification
|
|
53
|
-
After writing or updating doc comments:
|
|
54
|
-
1. Run `dart analyze` to ensure all bracketed references resolve properly without triggering `comment_references` warnings.
|
|
55
|
-
2. (Optional) Run `dart doc` to verify the generated documentation renders cleanly.
|
|
56
|
-
|
|
57
|
-
## Examples
|
|
58
|
-
|
|
59
|
-
### 1. Banned Tags vs. Prose
|
|
60
|
-
**Bad:**
|
|
61
|
-
```dart
|
|
62
|
-
/// This method fetches data.
|
|
63
|
-
/// @param force true to force reload.
|
|
64
|
-
/// @return the data
|
|
65
|
-
/// @throws NetworkException if host is unreachable.
|
|
66
|
-
Data load(bool force) { ... }
|
|
67
|
-
```
|
|
68
|
-
**Good:**
|
|
69
|
-
```dart
|
|
70
|
-
/// Fetches the remote data.
|
|
71
|
-
///
|
|
72
|
-
/// If [force] is true, this bypasses the local cache and forces a
|
|
73
|
-
/// network request.
|
|
74
|
-
///
|
|
75
|
-
/// Throws a [NetworkException] if the host is unreachable.
|
|
76
|
-
Data load(bool force) { ... }
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
### 2. The Annotation Placement Trap
|
|
80
|
-
**Bad:**
|
|
81
|
-
```dart
|
|
82
|
-
@override
|
|
83
|
-
/// Renders the widget to the screen.
|
|
84
|
-
Widget build(BuildContext context) { ... }
|
|
85
|
-
```
|
|
86
|
-
**Good:**
|
|
87
|
-
```dart
|
|
88
|
-
/// Renders the widget to the screen.
|
|
89
|
-
@override
|
|
90
|
-
Widget build(BuildContext context) { ... }
|
|
91
|
-
```
|
|
92
|
-
|
|
93
|
-
### 3. Openers and Tone
|
|
94
|
-
**Bad:**
|
|
95
|
-
```dart
|
|
96
|
-
/// Gets if the connection is active.
|
|
97
|
-
bool get isActive => _active;
|
|
98
|
-
|
|
99
|
-
/// This method initializes the connection.
|
|
100
|
-
void init() { ... }
|
|
101
|
-
```
|
|
102
|
-
**Good:**
|
|
103
|
-
```dart
|
|
104
|
-
/// Whether the connection is active.
|
|
105
|
-
bool get isActive => _active;
|
|
106
|
-
|
|
107
|
-
/// Initializes the connection.
|
|
108
|
-
void init() { ... }
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
### 4. Constructor Linking
|
|
112
|
-
**Bad:**
|
|
113
|
-
```dart
|
|
114
|
-
/// Creates a new user. Similar to calling [User()].
|
|
115
|
-
User.create() { ... }
|
|
116
|
-
```
|
|
117
|
-
**Good:**
|
|
118
|
-
```dart
|
|
119
|
-
/// Creates a new user. Similar to calling [User.new].
|
|
120
|
-
User.create() { ... }
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
### 5. Out-of-Scope Links (@docImport)
|
|
124
|
-
**Bad:**
|
|
125
|
-
```dart
|
|
126
|
-
import 'package:http/http.dart'; // Adds unnecessary runtime dependency just for docs
|
|
127
|
-
|
|
128
|
-
/// To use this, you must pass a [Client].
|
|
129
|
-
```
|
|
130
|
-
**Good:**
|
|
131
|
-
```dart
|
|
132
|
-
/// @docImport 'package:http/http.dart';
|
|
133
|
-
library;
|
|
134
|
-
|
|
135
|
-
/// To use this, you must pass a [Client].
|
|
136
|
-
```
|
|
@@ -1,28 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: debug-issue
|
|
3
|
-
description: Systematically debug issues using graph-powered code navigation
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
## Debug Issue
|
|
7
|
-
|
|
8
|
-
Use the knowledge graph to systematically trace and debug issues.
|
|
9
|
-
|
|
10
|
-
### Steps
|
|
11
|
-
|
|
12
|
-
1. Use `semantic_search_nodes_tool` to find code related to the issue.
|
|
13
|
-
2. Use `query_graph_tool` with `callers_of` and `callees_of` to trace call chains.
|
|
14
|
-
3. Use `get_flow_tool` to see full execution paths through suspected areas.
|
|
15
|
-
4. Run `detect_changes_tool` to check if recent changes caused the issue.
|
|
16
|
-
5. Use `get_impact_radius_tool` on suspected files to see what else is affected.
|
|
17
|
-
|
|
18
|
-
### Tips
|
|
19
|
-
|
|
20
|
-
- Check both callers and callees to understand the full context.
|
|
21
|
-
- Look at affected flows to find the entry point that triggers the bug.
|
|
22
|
-
- Recent changes are the most common source of new issues.
|
|
23
|
-
|
|
24
|
-
## Token Efficiency Rules
|
|
25
|
-
- Start with `get_minimal_context_tool(task="<your task>")` before other graph tools.
|
|
26
|
-
- Use `detail_level="minimal"` on all calls. Only escalate to "standard" when minimal is insufficient.
|
|
27
|
-
- Target: complete any review/debug/refactor task in ≤5 tool calls and ≤800 total output tokens.
|
|
28
|
-
- Read the implementation and its tests before changing code. The graph narrows scope; it does not replace the source.
|
|
@@ -1,27 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dogfood
|
|
3
|
-
description: Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to dogfood, QA, exploratory test, find issues, bug hunt, or test this app on mobile.
|
|
4
|
-
allowed-tools: Bash(agent-device:*), Bash(npx agent-device:*)
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# Dogfood
|
|
8
|
-
|
|
9
|
-
Router for exploratory QA. Private setup before using this skill:
|
|
10
|
-
|
|
11
|
-
```bash
|
|
12
|
-
agent-device --version
|
|
13
|
-
```
|
|
14
|
-
|
|
15
|
-
If that fails, stop and tell the user to expose a trusted `agent-device` binary on PATH or approve an exact-version npm command. This skill intentionally keeps allowed tools restricted to `agent-device` and `npx agent-device`.
|
|
16
|
-
|
|
17
|
-
Require `agent-device >= 0.14.0`; older CLIs lack these help topics. If older, stop and tell the user to upgrade the trusted install or approve an exact-version npm command. Do not run `npm install -g agent-device@latest` or `npx -y agent-device@latest` autonomously, and do not include version/upgrade commands in final plans.
|
|
18
|
-
|
|
19
|
-
Read current CLI guidance:
|
|
20
|
-
|
|
21
|
-
```bash
|
|
22
|
-
agent-device help dogfood
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
Loop: open app -> snapshot -i + screenshot -> explore flows -> capture evidence per issue -> close.
|
|
26
|
-
|
|
27
|
-
Target app is required; infer platform or ask. Findings must come from runtime behavior, not source reads. Let `help dogfood` provide exact report shape, evidence commands, and current workflow guidance.
|
|
@@ -1,176 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: eas-app-stores
|
|
3
|
-
description: EAS service (paid). Build and submit iOS and Android apps with EAS to TestFlight, the App Store, or Google Play. Supports Expo and other React Native projects, plus existing native apps. Use for eas.json setup, release pipelines, signing, app versions and build numbers, store submissions, and listing metadata. For Expo websites and API routes, use eas-hosting; for adding React Native screens to a native app, use expo-brownfield.
|
|
4
|
-
version: 1.1.0
|
|
5
|
-
license: MIT
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
# App Store Deployment
|
|
9
|
-
|
|
10
|
-
> **EAS service - costs apply.** Cloud builds use EAS plan resources, and EAS services have free-tier and paid-plan limits. Apple Developer and Google Play memberships are separate. Check https://expo.dev/pricing for the requested service.
|
|
11
|
-
|
|
12
|
-
This skill covers building and releasing iOS and Android apps with EAS: Expo and other React Native projects, plus existing native apps. EAS is a delivery service; native apps can use it without adding Expo or React Native to their runtime. The native setup walkthrough currently covers SwiftUI/UIKit on iOS.
|
|
13
|
-
|
|
14
|
-
## Choose the project path
|
|
15
|
-
|
|
16
|
-
- **SwiftUI/UIKit app with no React Native runtime:** read [references/native-ios.md](references/native-ios.md) before changing its build configuration. Keep the Xcode project and Swift code as the app's source of truth. The Expo/React Native quick-start and development-client examples below do not apply to this path.
|
|
17
|
-
- **Native Android app with no React Native runtime:** preserve its existing native build setup. See [references/play-store.md](references/play-store.md) for submission; the Swift/iOS setup instructions do not apply. A dedicated native Android setup walkthrough is not yet included.
|
|
18
|
-
- **Expo/React Native app:** use the quick-start below, then the relevant store reference.
|
|
19
|
-
- **Adding React Native screens to an existing native app:** use `expo-brownfield` for that integration; return here for distribution.
|
|
20
|
-
|
|
21
|
-
Use the archive and icon checks in [references/native-ios.md](references/native-ios.md) during initial native iOS setup, after changing versioning, bundle IDs, or icons, or when diagnosing a rejected upload. Routine releases follow the EAS build/submit flow and the processing and availability checks in [references/testflight.md](references/testflight.md). A successful EAS build or a queued submission does not establish Apple acceptance, tester access, or an App Store release.
|
|
22
|
-
|
|
23
|
-
## References
|
|
24
|
-
|
|
25
|
-
Consult these resources as needed:
|
|
26
|
-
|
|
27
|
-
- ./references/workflows.md -- CI/CD workflows for automated store releases and PR previews
|
|
28
|
-
- ./references/testflight.md -- Submitting iOS builds to TestFlight for beta testing
|
|
29
|
-
- ./references/app-store-metadata.md -- Managing App Store metadata and ASO optimization
|
|
30
|
-
- ./references/play-store.md -- Submitting Android builds to Google Play Store
|
|
31
|
-
- ./references/ios-app-store.md -- iOS App Store submission and review process
|
|
32
|
-
- ./references/native-ios.md -- Native Swift/SwiftUI/UIKit setup, versioning, and archive verification without an Expo runtime
|
|
33
|
-
|
|
34
|
-
## Expo / React Native Quick Start
|
|
35
|
-
|
|
36
|
-
### Install EAS CLI
|
|
37
|
-
|
|
38
|
-
```bash
|
|
39
|
-
npm install -g eas-cli
|
|
40
|
-
eas login
|
|
41
|
-
```
|
|
42
|
-
|
|
43
|
-
### Initialize EAS
|
|
44
|
-
|
|
45
|
-
```bash
|
|
46
|
-
npx eas-cli@latest init
|
|
47
|
-
```
|
|
48
|
-
|
|
49
|
-
`eas init` links or creates the EAS project. Run `eas build:configure` to create build profiles in `eas.json`; preserve existing project and store identifiers when a release setup already exists.
|
|
50
|
-
|
|
51
|
-
## Build Commands
|
|
52
|
-
|
|
53
|
-
### Production Builds
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
# iOS App Store build
|
|
57
|
-
npx eas-cli@latest build -p ios --profile production
|
|
58
|
-
|
|
59
|
-
# Android Play Store build
|
|
60
|
-
npx eas-cli@latest build -p android --profile production
|
|
61
|
-
|
|
62
|
-
# Both platforms
|
|
63
|
-
npx eas-cli@latest build --profile production
|
|
64
|
-
```
|
|
65
|
-
|
|
66
|
-
### Submit to Stores
|
|
67
|
-
|
|
68
|
-
```bash
|
|
69
|
-
# iOS: Build and submit to App Store Connect
|
|
70
|
-
npx eas-cli@latest build -p ios --profile production --auto-submit
|
|
71
|
-
|
|
72
|
-
# Android: Build and submit to Play Store
|
|
73
|
-
npx eas-cli@latest build -p android --profile production --auto-submit
|
|
74
|
-
|
|
75
|
-
# Expo / React Native shortcut for iOS TestFlight
|
|
76
|
-
npx testflight
|
|
77
|
-
```
|
|
78
|
-
|
|
79
|
-
## Web & API Route Hosting
|
|
80
|
-
|
|
81
|
-
Deploying an Expo website or Expo Router API routes to EAS Hosting (`npx expo export -p web` then `eas deploy`) is covered by the `eas-hosting` skill. This skill focuses on native app store releases.
|
|
82
|
-
|
|
83
|
-
## EAS Configuration
|
|
84
|
-
|
|
85
|
-
Example for an Expo / React Native project (native Swift profiles are in `references/native-ios.md`):
|
|
86
|
-
|
|
87
|
-
```json
|
|
88
|
-
{
|
|
89
|
-
"cli": {
|
|
90
|
-
"version": ">= 16.0.1",
|
|
91
|
-
"appVersionSource": "remote"
|
|
92
|
-
},
|
|
93
|
-
"build": {
|
|
94
|
-
"production": {
|
|
95
|
-
"autoIncrement": true,
|
|
96
|
-
"ios": {
|
|
97
|
-
"resourceClass": "m-medium"
|
|
98
|
-
}
|
|
99
|
-
},
|
|
100
|
-
"development": {
|
|
101
|
-
"developmentClient": true,
|
|
102
|
-
"distribution": "internal"
|
|
103
|
-
}
|
|
104
|
-
},
|
|
105
|
-
"submit": {
|
|
106
|
-
"production": {
|
|
107
|
-
"ios": {
|
|
108
|
-
"appleId": "your@email.com",
|
|
109
|
-
"ascAppId": "1234567890"
|
|
110
|
-
},
|
|
111
|
-
"android": {
|
|
112
|
-
"serviceAccountKeyPath": "./google-service-account.json",
|
|
113
|
-
"track": "internal"
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
}
|
|
117
|
-
}
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
## Platform-Specific Guides
|
|
121
|
-
|
|
122
|
-
### iOS
|
|
123
|
-
|
|
124
|
-
- For native Swift apps, use the explicit build/submit flow in `references/native-ios.md`
|
|
125
|
-
- For Expo / React Native apps, `npx testflight` provides a quick TestFlight flow
|
|
126
|
-
- Configure Apple credentials via `eas credentials`
|
|
127
|
-
- See ./references/testflight.md for credential setup
|
|
128
|
-
- See ./references/ios-app-store.md for App Store submission
|
|
129
|
-
|
|
130
|
-
### Android
|
|
131
|
-
|
|
132
|
-
- Set up Google Play Console service account
|
|
133
|
-
- Configure tracks: internal → closed → open → production
|
|
134
|
-
- See ./references/play-store.md for detailed setup
|
|
135
|
-
|
|
136
|
-
## Automated Releases
|
|
137
|
-
|
|
138
|
-
EAS Workflows automate the build → submit → update pipeline for CI/CD. See ./references/workflows.md for store-release examples. To author or validate workflow YAML, use the `eas-workflows` skill - it works from the live workflow schema.
|
|
139
|
-
|
|
140
|
-
## Version Management
|
|
141
|
-
|
|
142
|
-
EAS manages version numbers automatically with `appVersionSource: "remote"`:
|
|
143
|
-
|
|
144
|
-
```bash
|
|
145
|
-
# Check current versions
|
|
146
|
-
eas build:version:get
|
|
147
|
-
|
|
148
|
-
# Manually set version
|
|
149
|
-
eas build:version:set -p ios
|
|
150
|
-
```
|
|
151
|
-
|
|
152
|
-
The version-set command prompts for the value. When setting up or changing native iOS versioning, or diagnosing a duplicate build number, inspect the archived `CFBundleVersion`: the remote counter alone does not prove that Xcode used it.
|
|
153
|
-
|
|
154
|
-
## Monitoring
|
|
155
|
-
|
|
156
|
-
```bash
|
|
157
|
-
# List recent builds
|
|
158
|
-
eas build:list
|
|
159
|
-
|
|
160
|
-
# Check build status
|
|
161
|
-
eas build:view BUILD_ID
|
|
162
|
-
|
|
163
|
-
# Inspect submissions (verified with EAS CLI 23.2.0)
|
|
164
|
-
eas submit:list -p ios --json
|
|
165
|
-
eas submit:view SUBMISSION_ID --json
|
|
166
|
-
```
|
|
167
|
-
|
|
168
|
-
Check the CLI version before interpreting a missing command: these submission commands are available in 23.2.0 but not in the tested 18.6.0 installation. A pinned `npx eas-cli@23.2.0` invocation can use them without changing the global installation. See `references/testflight.md` for live Apple status and retry guidance. Follow the returned log URLs when the JSON result omits the underlying failure. Report the exact build ID/version and the furthest verified release state.
|
|
169
|
-
|
|
170
|
-
## Submitting Feedback
|
|
171
|
-
If you encounter errors, misleading or outdated information in this skill, report it so Expo can improve:
|
|
172
|
-
```bash
|
|
173
|
-
npx --yes submit-expo-feedback@latest --category skills --subject "eas-app-stores" "<actionable feedback>"
|
|
174
|
-
```
|
|
175
|
-
Only submit when you have something specific and actionable to report. Include as much relevant context as possible.
|
|
176
|
-
If an AI agent repeatedly failed or the user had to take over an Expo task, load the expo-skill-feedback skill and follow its eval-candidate flow instead of reusing the command above.
|
|
@@ -1,4 +0,0 @@
|
|
|
1
|
-
interface:
|
|
2
|
-
display_name: "EAS App Stores"
|
|
3
|
-
short_description: "Paid EAS service. Build and submit iOS and Android apps."
|
|
4
|
-
default_prompt: "Use $eas-app-stores to set up or verify EAS builds, TestFlight and store submissions, signing, versioning, and store metadata for iOS and Android apps: Expo and other React Native projects, plus existing native apps."
|