microsoft / microsoft/hve-core

Consolidate collection manifests to single source of truth

Open
#2,046 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement infrastructure
Dominant language
Python
Stars
1.5k
Forks
301
Avg merge
3d 3h
Merged PRs (30d)
92

Description

Summary

Consolidate collection infrastructure from multiple *.collection.yml and *.collection.md files into a single core-manifest.yml that serves as the source of truth for all collection membership, maturity, and metadata.

Motivation

  • Multiple collection files created duplication and drift risk
  • Collection membership and maturity tracking was scattered
  • Plugin generation required scanning multiple sources

Changes

  • Introduce collections/core-manifest.yml as canonical registry
  • Project *.collection.yml / *.collection.md in-memory from manifest (no longer committed)
  • Add maturity-dependency validation to prevent experimental artifacts from being bundled in stable collections
  • Update plugin generation tooling to consume single manifest
  • Add plugin parity check and test fixtures

Acceptance Criteria

  • core-manifest.yml contains all artifact paths, kinds, collection membership, and maturity
  • npm run plugin:generate produces correct outputs from manifest
  • npm run lint:collections-metadata validates manifest structure
  • Documentation updated to reflect new architecture

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the proposed collections/core-manifest.yml and inspect the existing collection files and plugin generation tooling. Run npm run plugin:generate and npm run lint:collections-metadata to understand current outputs and validation. Done means the manifest contains all required metadata, generation and parity checks pass, and the architecture documentation is updated.

Written by the indexing model from the issue text.

Assessment

Tech stack
python, yaml
Domain
build-system, tooling
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.