Catalog schema: migrate dependsOn to scheme-less URLs and drop providesApis, #433 fan-out #8

New issue

Closed

opened 2026-05-28 04:38:07 +00:00 by coilysiren · 0 comments

coilysiren commented

2026-05-28 04:38:07 +00:00

Owner

Parent: coilysiren/agentic-os-kai#433 collapses the catalog-graph indirection layer. dependsOn becomes a flat list of scheme-less URLs and providesApis is removed entirely. This issue migrates this repo's catalog block only - a single-file change.

What to change

Edit the top-level catalog: block in whichever file contains it: .agent-guard/agent-guard.yaml for external-facing repos, otherwise .coily/coily.yaml.

Bump the agentic-os hook rev first. In .pre-commit-config.yaml, inside the block repo: https://github.com/coilysiren/agentic-os, change rev: v0.4.0 (or whatever it currently pins) to rev: v0.6.0. This is REQUIRED before step 2 - the older hook still lists providesApis as a required catalog key and will block its removal. v0.6.0 makes providesApis optional. pre-commit reads the working-tree config at commit time, so the bump takes effect for this same commit. Stage and commit it together with the catalog change.
Rewrite every dependsOn entry to a scheme-less URL of the form <host>/<org>/<repo> (the dependency URL with https:// stripped):
- Targets in the coilysiren org use the canonical Forgejo forge: forgejo.coilysiren.me/coilysiren/<repo>.
- Targets in another org use GitHub: github.com/<org>/<repo>.
- A bare slug like coilysiren/eco-mods becomes forgejo.coilysiren.me/coilysiren/eco-mods.
- If a dependsOn entry is an API id rather than a slug, map it to its provider repo first, then URL-ify. API id to provider repo:
  - cli-guard-go-pkg -> cli-guard
  - coily-cli, audit-log -> coily
  - agent-guard-hook -> agent-guard
  - agents-md, claude-skills, mcp-config -> agentic-os-kai
  - shared-scripts -> agentic-os
  - modes-framework -> backend
  - eco-jobs-tracker-http, eco-jobs-tracker-mod -> eco-jobs-tracker
  - eco-mcp-server -> eco-mcp-app
  - eco-mods-private -> eco-mods
  - eco-mods-public -> eco-mods-public
  - eco-otel-spans -> eco-telemetry
  - galaxy-gen-web -> galaxy-gen
  - gauntlet-mcp -> gauntlet
  - k3s-cluster, systemd-units -> infrastructure
  - personal-dashboard-web -> personal-dashboard
  - recall-api, recall-mcp -> repo-recall
  - scoop-manifests -> scoop-bucket
  - session-lattice-views -> session-lattice
  - coilysiren-me -> website
- Only reformat. Do not add or drop dependencies - the set of edges must stay identical, just expressed as URLs.
Delete the entire providesApis field from the catalog block.

Do NOT

Do not touch any other repo.
Do not edit scripts/build-catalog-graph.py or scripts/check-catalog-cross-org.py (those live in agentic-os-kai under #433).
Do not run build-catalog-graph or regenerate any data/catalog-graph.* artifact.
Do not change any other catalog field (org, deployed, archived, kind, type, owner, lifecycle, description, system).

Done when

The catalog block's dependsOn is a flat list of scheme-less URLs and providesApis is gone. Commit and push (or land per the git-workflow footer).

**Parent: coilysiren/agentic-os-kai#433** collapses the catalog-graph indirection layer. dependsOn becomes a flat list of scheme-less URLs and `providesApis` is removed entirely. This issue migrates **this repo's catalog block only** - a single-file change. ## What to change Edit the top-level `catalog:` block in whichever file contains it: `.agent-guard/agent-guard.yaml` for external-facing repos, otherwise `.coily/coily.yaml`. 0. **Bump the agentic-os hook rev first.** In `.pre-commit-config.yaml`, inside the block `repo: https://github.com/coilysiren/agentic-os`, change `rev: v0.4.0` (or whatever it currently pins) to `rev: v0.6.0`. This is REQUIRED before step 2 - the older hook still lists `providesApis` as a required catalog key and will block its removal. v0.6.0 makes `providesApis` optional. pre-commit reads the working-tree config at commit time, so the bump takes effect for this same commit. Stage and commit it together with the catalog change. 1. **Rewrite every `dependsOn` entry to a scheme-less URL** of the form `<host>/<org>/<repo>` (the dependency URL with `https://` stripped): - Targets in the `coilysiren` org use the canonical Forgejo forge: `forgejo.coilysiren.me/coilysiren/<repo>`. - Targets in another org use GitHub: `github.com/<org>/<repo>`. - A bare slug like `coilysiren/eco-mods` becomes `forgejo.coilysiren.me/coilysiren/eco-mods`. - If a `dependsOn` entry is an **API id** rather than a slug, map it to its provider repo first, then URL-ify. API id to provider repo: - `cli-guard-go-pkg` -> cli-guard - `coily-cli`, `audit-log` -> coily - `agent-guard-hook` -> agent-guard - `agents-md`, `claude-skills`, `mcp-config` -> agentic-os-kai - `shared-scripts` -> agentic-os - `modes-framework` -> backend - `eco-jobs-tracker-http`, `eco-jobs-tracker-mod` -> eco-jobs-tracker - `eco-mcp-server` -> eco-mcp-app - `eco-mods-private` -> eco-mods - `eco-mods-public` -> eco-mods-public - `eco-otel-spans` -> eco-telemetry - `galaxy-gen-web` -> galaxy-gen - `gauntlet-mcp` -> gauntlet - `k3s-cluster`, `systemd-units` -> infrastructure - `personal-dashboard-web` -> personal-dashboard - `recall-api`, `recall-mcp` -> repo-recall - `scoop-manifests` -> scoop-bucket - `session-lattice-views` -> session-lattice - `coilysiren-me` -> website - **Only reformat. Do not add or drop dependencies** - the set of edges must stay identical, just expressed as URLs. 2. **Delete the entire `providesApis` field** from the catalog block. ## Do NOT - Do not touch any other repo. - Do not edit `scripts/build-catalog-graph.py` or `scripts/check-catalog-cross-org.py` (those live in agentic-os-kai under #433). - Do not run `build-catalog-graph` or regenerate any `data/catalog-graph.*` artifact. - Do not change any other catalog field (`org`, `deployed`, `archived`, `kind`, `type`, `owner`, `lifecycle`, `description`, `system`). ## Done when The catalog block's `dependsOn` is a flat list of scheme-less URLs and `providesApis` is gone. Commit and push (or land per the git-workflow footer).

coilysiren referenced this issue from a commit

2026-05-28 04:48:10 +00:00

chore(catalog): scheme-less dependsOn URLs, drop providesApis

coilysiren closed this issue

2026-05-28 04:48:10 +00:00

coilysiren referenced this issue

2026-05-28 04:49:58 +00:00

Doc compliance: remove .agentic-os.toml hook opt-outs added for v0.6.0 bump #9