FeaturePilot

Smart Cucumber support for .feature files in VS Code: autocomplete, step index, missing-step diagnostics, and formatter.

Why FeaturePilot

FeaturePilot is designed for teams writing large Gherkin suites, especially with shared step libraries in npm packages and project-local step definitions.

It helps you:

• find and reuse the right steps faster
• keep .feature files consistently formatted
• catch undefined steps immediately with red squiggles

Key Features

• Step autocomplete for .feature files
• strict Gherkin-aware matching (Given/When/Then/And/But)
• optional-parameter variants (for example ( {string})? => with/without parameter suggestions)
• smart snippet placeholders for parameters
• dual-source step scanning:
  • current project: src/**/*.ts
  • package steps: node_modules/@lighthouse/lighthouse-implementation/src/step-definitions/<platform>/**/*.ts
• sidebar Step Explorer:
  • tree view by source/platform/file/step
  • quick search and jump to definition
  • one-click refresh
  • switch Lighthouse platform folder
• missing-step diagnostics (red squiggle underline)
• formatter for .feature:
  • full document / selection / optional on-type format
  • table alignment (including CJK width)
  • DocString strategy controls
  • JSON beautify inside """

Quick Start

1. Install FeaturePilot.
2. Open a workspace containing .feature files.
3. Ensure dependency exists when using Lighthouse step packs:
   • node_modules/@lighthouse/lighthouse-implementation
4. Open the FeaturePilot activity bar view.
5. Use:
   • Refresh Step Index
   • Switch Lighthouse Platform
   • Search Step Definitions

Commands

• FeaturePilot: Refresh Step Index
• FeaturePilot: Search Step Definitions
• FeaturePilot: Switch Lighthouse Platform

Configuration

All settings use the featurepilot.* prefix.

• featurepilot.steps
• featurepilot.pages
• featurepilot.syncfeatures
• featurepilot.strictGherkinCompletion
• featurepilot.strictGherkinValidation
• featurepilot.smartSnippets
• featurepilot.stepsInvariants
• featurepilot.customParameters
• featurepilot.skipDocStringsFormat
• featurepilot.formatConfOverride
• featurepilot.onTypeFormat
• featurepilot.gherkinDefinitionPart
• featurepilot.stepRegExSymbol
• featurepilot.pureTextSteps
• featurepilot.parameterSymbols
• featurepilot.stepsSource
• featurepilot.stepsJsonFiles
• featurepilot.aiConfig
• featurepilot.enableEnterKeyNewlineMode
• featurepilot.wikiOutputDir
• featurepilot.lighthousePlatforms (default: ["durandal-platform"])

Notes

• Step scanning is enabled when Lighthouse package directory exists in workspace node_modules.
• For duplicate step text + Gherkin type, project src definitions take priority over package definitions.

Troubleshooting

• If Step Explorer shows language server not running:
  1. Run Developer: Reload Window
  2. Re-open workspace root (single-root recommended)
  3. Check Output panel for FeaturePilot logs

License

MIT