Add BeDoc core implementation with action discovery and processing pipeline

[gesslar]

This pull request introduces the core BeDoc documentation generation system with a complete modular architecture.

New Core Components:

• BeDoc class as the main orchestrator that handles configuration validation, action discovery, contract negotiation, and file processing
• Configuration class for validating and merging options from multiple sources (CLI, config files, environment variables, package.json)
• Discovery class for finding and loading parser/formatter actions from node_modules and custom paths
• Conveyor class implementing a pipeline-based file processing system with concurrency support

Action System:

• Defines action types (parser, formatter) with metadata requirements
• JSON schema validation for BeDoc actions at dist/schema/bedoc.action.json
• Contract negotiation between parsers and formatters using the negotiator library

Configuration Management:

• Comprehensive parameter definitions in ConfigurationParameters.js with validation rules
• Support for priority-based option processing and exclusive options
• Environment variable support with BEDOC_* prefix
• Subconfiguration support for different project setups

CLI Interface:

• Updated cli.js with proper error handling using Tantrum/Sass error system
• Integration with commander.js for argument parsing
• Schema validation loading and BeDoc instance creation

Infrastructure:

• TypeScript declaration files generated for all components
• Logging system with debug levels and colored output
• Hook system for custom parsing and formatting extensions
• File processing with glob pattern support and concurrent execution

The system provides a complete plugin-based documentation generation framework that can discover and coordinate between different parsers and formatters while maintaining strict contract validation.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

[gesslar]

Warning

This pull request is not mergeable via GitHub because a downstack PR is open. Once all requirements are satisfied, merge this PR as a stack on Graphite.
Learn more

• chore: trim example source files to minimal set #491
• Add chokidar-as-cli example and implement Lua library functions #490
• Add chokidar examples, update hooks API, refactor parsers/formatters, and enhance configuration #489
• Major dependency overhaul and project restructure #488
• Remove TypeScript definitions and core implementation files #487
• Add BeDoc core implementation with action discovery and processing pipeline #486 👈 (View in Graphite)
• Update VS Code configs, add Unlicense, and refactor ESLint to use @gesslar/uglier #485
• Replace custom workflows with reusable Quality and Release workflows #484
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.