Feature (Init Command): initialized the project & created init command logic

[RepoRover]

This pull request introduces foundational project standards and automation for the bfloo codebase. It adds comprehensive documentation for project conventions, establishes TypeScript JSDoc guidelines, and sets up automated workflows for CI, release, and code quality enforcement. These changes lay the groundwork for consistent development practices, enforce code quality, and streamline releases.

Documentation and Guidelines

• Added a detailed project overview and agent guidelines in AGENTS.md, including project structure, coding conventions, error handling, and testing practices.
• Introduced a standardized TypeScript JSDoc documentation guide in .github/prompts/ts-jsdoc.prompt.md to ensure consistent and clear code documentation across the codebase.

Continuous Integration and Release Automation

• Added a GitHub Actions workflow in .github/workflows/ci.yml for linting, formatting, type checking, testing, and building on push and pull requests to main and dev branches.
• Added a release workflow in .github/workflows/release.yml to build binaries for multiple platforms and publish them as GitHub releases on version tag pushes.

Code Quality and Commit Standards

• Configured Prettier via .prettierrc and .prettierignore to enforce formatting standards and ignore appropriate files. [1] [2]
• Added Husky hooks:
  • .husky/commit-msg to enforce conventional commit message formats, improving commit history clarity.
  • .husky/pre-commit to run lint-staged, formatting, linting, and type checking before commits.

[Copilot]

Pull request overview

This PR establishes the foundational project infrastructure for the bfloo CLI, introducing comprehensive test coverage for schema validation, filesystem operations, error handling, and command execution. The changes add automated testing across multiple layers of the application, from low-level utility functions to high-level integration tests, ensuring code quality and establishing a solid foundation for future development.

Key Changes

• Added extensive unit tests for PostgreSQL v15.0 schema validation (tables, columns, constraints)
• Implemented integration tests for the init command with real filesystem operations and rollback behavior
• Added comprehensive test coverage for error handling, constants, and filesystem utilities

Reviewed changes

Copilot reviewed 124 out of 141 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
tests/schemas/postgresql/v15.0/table/props.test.ts	Tests for PostgreSQL table property schemas (ID, name, description, columns, constraints)
tests/schemas/postgresql/v15.0/schema.test.ts	Tests for PostgreSQL schema validation including foreign key cross-table validation
tests/schemas/postgresql/v15.0/constraint/schema.test.ts	Tests for constraint schema validation (primary key, unique, foreign key)
tests/schemas/postgresql/v15.0/constraint/props.test.ts	Tests for constraint property schemas and referential actions
tests/schemas/postgresql/v15.0/column/schema.test.ts	Tests for column schema validation including type-specific constraints
tests/schemas/postgresql/v15.0/column/props.test.ts	Tests for column property schemas including default values and constraints
tests/schemas/manifest/schema.test.ts	Tests for manifest schema validation and snapshot entries
tests/schemas/manifest/props.test.ts	Tests for manifest property schemas (IDs, versions, sync states)
tests/schemas/config/schema.test.ts	Tests for configuration schema validation
tests/schemas/config/props.test.ts	Tests for configuration property schemas
tests/schemas/config/postgresql/schema.test.ts	Tests for PostgreSQL-specific configuration schema
tests/schemas/config/postgresql/props.test.ts	Tests for PostgreSQL connection properties
tests/schemas/config/postgresql/env.test.ts	Tests for PostgreSQL environment configuration
tests/fs/yaml.test.ts	Tests for YAML formatting utilities
tests/fs/snapshot.test.ts	Tests for snapshot file operations (read/write/exists)
tests/fs/paths.test.ts	Tests for path resolution and project root finding
tests/fs/manifest.test.ts	Tests for manifest file operations and snapshot building
tests/fs/config.test.ts	Tests for config file operations and schema name normalization
tests/execution/ExecutionPlan.test.ts	Tests for execution plan with rollback and SIGINT handling
tests/error/outputOptions.test.ts	Tests for error output mode configuration
tests/error/handlers.test.ts	Tests for root error handler with different error types
tests/error/constants.test.ts	Tests for error codes and exit codes
tests/error/CliError.test.ts	Tests for CliError class including JSON serialization
tests/constants/paths.test.ts	Tests for path constants and structure validation
tests/constants/databaseRegistry.test.ts	Tests for database engine registry and version support
tests/constants/api.test.ts	Tests for API constants (key format, timeouts)
tests/commands/init/handlers.integration.test.ts	Integration tests for init command handler with real filesystem
tests/commands/init/cmd.test.ts	Tests for init command structure and options
tests/api/client.test.ts	Tests for API client structure and router organization
src/utils/index.ts	Re-exports utility modules for convenient imports
src/ui/index.ts	Re-exports UI module for convenient imports
src/schemas/schemaSnapshot/index.ts	Re-exports schema snapshot modules
src/schemas/schema/index.ts	Re-exports schema modules

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.