Skip to content

feat: register sourceos-devtools in canonical topology#71

Merged
mdheller merged 2 commits intomainfrom
copilot/create-sourceos-devtools-repo
Apr 30, 2026
Merged

feat: register sourceos-devtools in canonical topology#71
mdheller merged 2 commits intomainfrom
copilot/create-sourceos-devtools-repo

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 30, 2026

Tracks the SourceOS-Linux/sourceos-devtools repo creation at the spec layer by registering it in the canonical topology and establishing its boundary via ADR. No devtools implementation enters sourceos-spec.

Changes

  • New roleroleDeveloperToolchain added to semantic/repo-ontology.jsonld and mapped in semantic/context.jsonld (srcos:role/DeveloperToolchain)
  • New descriptorexamples/repo-descriptor.sourceos-devtools.jsonld registers the repo with topology role, connectsTo, and notThisRepo guards
  • Topology linkssemantic/repo.jsonld and examples/repo-descriptor.sourceos-spec.jsonld both gain urn:sourceos:repo:SourceOS-Linux:sourceos-devtools in connectsTo
  • ADRdocs/adr/ADR-2026-04-devtools-boundary.md establishes the devtools/spec split: devtools owns Nix flakes, NLBoot operator tooling, lab-profile selection, release tooling, local AI governance CLIs, and workstation bootstrap; spec stays normative-only
  • Guide updatedocs/REPO_DESCRIPTOR_GUIDE.md lists roleDeveloperToolchain in the canonical role set and adds sourceos-devtools to the near-term semantic/repo.jsonld follow-up list

Known gaps

Actual repo creation (gh repo create SourceOS-Linux/sourceos-devtools …) and seeding its scaffold files (README.md, AGENTS.md, docs/DEVTOOLS_SCOPE.md, repo.maturity.yaml, Makefile) require org-admin access and must happen in the target repo, not here.

- Add roleDeveloperToolchain to semantic/repo-ontology.jsonld and context.jsonld
- Add examples/repo-descriptor.sourceos-devtools.jsonld
- Update semantic/repo.jsonld and examples/repo-descriptor.sourceos-spec.jsonld to connect to devtools
- Add docs/adr/ADR-2026-04-devtools-boundary.md establishing the devtools boundary
- Update docs/REPO_DESCRIPTOR_GUIDE.md with new role and near-term follow-up entry

Closes #70

Agent-Logs-Url: https://github.com/SourceOS-Linux/sourceos-spec/sessions/03c8a0b2-521b-4d59-a431-5d7818e058cd

Co-authored-by: mdheller <21163552+mdheller@users.noreply.github.com>
Copilot AI changed the title [WIP] Create and bootstrap sourceos-devtools repo feat: register sourceos-devtools in canonical topology Apr 30, 2026
Copilot AI requested a review from mdheller April 30, 2026 13:07
@mdheller mdheller marked this pull request as ready for review April 30, 2026 13:08
Copy link
Copy Markdown
Contributor

Agent triage: scope is bounded to topology, semantic descriptors, and ADR/docs, but this PR is stale against current main and has no workflow evidence.

Please refresh or rebase against current main and rerun repo-native validation. Keep scope unchanged.

@mdheller mdheller merged commit 53860db into main Apr 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Admin task: create and bootstrap sourceos-devtools repo

2 participants