Repository navigation
π§π§βπ» - Bootstrap reproducible toolchains architecture checks and CI CheckΒ #4
Description
Is there an existing issue for this?
- I have searched the existing issues.
What area does this task affect?
CI/CD
Task description
Start the M1 development foundation after the documentation foundation in PR #3 was merged into develop at 0833f63.
Establish reproducible development tooling and executable quality gates before domain application work:
- Add reviewed Python/uv and Node/pnpm workspace configuration, dependency locks and documented setup/check commands for the selected Python/FastAPI and Lit/TypeScript/Vite direction.
- Establish meaningful tests for first-party tooling from its first implementation. Enforce 100% supported first-party coverage metrics and keep tooling, backend, frontend and HA integration scope explicit; do not describe an absent suite as executed application coverage.
- Configure executable Clean Architecture import/cycle checks and exercise allowed/forbidden fixture projects so the checks demonstrably reject boundary violations rather than merely matching directory names.
- Add a project-owned GitHub workflow named CI Check. Run every applicable suite on every PR head update, including drafts and documentation-only updates, without path filters. A required aggregate fails when a required job fails, is cancelled or is unexpectedly skipped. Use locked installs and read-only credentials; publication and deployment are separate operations.
- Update the contributor guide, relevant SDD evidence and catalog paths only where real tooling, entrypoints and tests now exist. Keep all other prospective capabilities truthful and Draft.
This task owns internal dependencies, test infrastructure, architecture enforcement and CI. Household use cases, HA authentication/administrator proof, native HA runtime integration, UI product workflows and channel publication remain sequenced implementation work under their owning contracts.
Current issues or inefficiencies
The merged repository has eleven Draft SDDs but no application development workspace, dependency locks, test commands or project CI Check workflow. The owner requires Clean Architecture and maximum meaningful coverage from the first implemented code, so these controls must exist before domain implementation expands.
Copilot's separate proposed-capability catalog limitation and progress-assessment diagnostics are already reported upstream. They remain visible constraints and are not grounds to edit or weaken Copilot.
Expected impact
A contributor can reproduce the environment from locked dependencies, execute the same documented checks locally and in CI, and see forbidden dependency/cycle fixtures fail. Every implemented first-party tooling behavior has meaningful tests and supported coverage is enforced. Future backend, frontend and HA integration work inherits an executable foundation while the full first-release scope remains intact.
Acceptance:
- Clean checkout setup and verification commands run successfully with recorded runtime/dependency versions.
- Architecture fixtures distinguish valid dependency direction, forbidden framework/adapter imports and cycles.
- First-party tooling has 100% supported line/branch or statement/function metrics as exposed by the selected tools, without broad exclusions or dummy application code.
- CI Check is a separate project workflow with every-PR triggering, complete applicable checks and a strict aggregate.
- Copilot implementation, installed workflows/forms/profiles/guidance and the existing gateway are unchanged.
- Documentation distinguishes implemented tooling evidence from the remaining prospective product and planned acceptance cases.
Alternatives considered
Use the already-selected runtime and frontend families, with uv/pnpm locks and established test/import-analysis tools. Keep the first task focused on development infrastructure; domain capability implementation follows its own SDD and lifecycle.
Additional context or comments
- Merged foundation: docs: establish Domus SDD foundationΒ #3
- Development sequence: https://github.com/vypdev/domus/blob/0833f630aeff1b48558e0192e19ef3a42c328986/docs/roadmap.md
- Quality contract: https://github.com/vypdev/domus/blob/0833f630aeff1b48558e0192e19ef3a42c328986/specs/delivery-quality.md
- Architecture: https://github.com/vypdev/domus/blob/0833f630aeff1b48558e0192e19ef3a42c328986/docs/architecture.md
- Upstream reports: ππ§βπ» - Expose completed progress assessment validation failures instead of opaque agent.failedΒ copilot#774 and ππ§βπ» - SDK proposed capability catalogs have no truthful greenfield SDD bootstrap route without implementation evidenceΒ copilot#777
The owner explicitly authorized merging PR #3 and beginning implementation. All repository content, code, tests and issue text are English. Spanish is used only in conversation with the owner. Follow the installed chore form and Action-managed branch lifecycle; no invented branch, force-push, Copilot change, release or deployment is part of this task.
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fieldsDone
Activity
[-]Bootstrap reproducible toolchains architecture checks and CI Check[/-][+]π§ - Bootstrap reproducible toolchains architecture checks and CI Check[/+]vypbot commentedon Oct 29, 2026
Hi! Iβm @vypbot, the Copilot assistant for this repository.
I can answer questions, explain the codebase, propose implementation and test plans, review issues and pull requests for potential bugs or security problems, and help authorized maintainers apply changes.
Try
/copilot helpto see the available commands, or mention @vypbot with your question.[-]π§ - Bootstrap reproducible toolchains architecture checks and CI Check[/-][+]π§π§βπ» - Bootstrap reproducible toolchains architecture checks and CI Check[/+]vypbot commentedon Oct 29, 2026
Implementation plan
Acceptance: A clean checkout can run the documented locked setup and checks; allowed architecture fixtures pass while forbidden imports and cycles fail; first-party tooling meets its supported 100% coverage metrics; and the separate CI Check workflow runs applicable checks on every pull request update with a strict aggregate. Documentation accurately distinguishes implemented tooling from prospective product scope.
Need something else? Mention the bot with a question or use
/copilot help.vypbot commentedon Oct 29, 2026
Issue closed β historical progress
Current status: closed as completed.
The last estimate is retained below as history. Closure does not certify a new percentage, tests, or branch alignment.
Action required: none for this closed issue. If work continues, reopen the issue; a fresh assessment can update this same card.
Last assessment before closure (historical)