---
id: REUSE-WP-0010
type: workplan
title: "Network federation for remote indexes"
domain: helix_forge
repo: reuse-surface
status: finished
owner: codex
topic_slug: helix-forge
created: "2026-06-15"
updated: "2026-06-15"
state_hub_workstream_id: "da812165-d56e-47fa-9901-bb3747522ec4"
---

# Network federation for remote indexes

Close gap analysis priority 15. Extend federation beyond filesystem paths to
fetch capability indexes from HTTP URLs or git raw endpoints.

## Extend Federation Schema For URLs

```task
id: REUSE-WP-0010-T01
status: done
priority: medium
state_hub_task_id: "6f181057-e0f7-4879-9eb9-928a527a01ee"
```

Extend `schemas/federation.schema.yaml` and manifest format to support `url`
sources alongside `index` file paths, with optional auth and TTL metadata.

## Implement Remote Index Fetch

```task
id: REUSE-WP-0010-T02
status: done
priority: medium
state_hub_task_id: "a2fac7d5-9383-4a42-bd23-3e8dbc7d550b"
```

Add HTTP fetch to `federation compose` with local cache under
`registry/federation/cache/`. Clear errors when remote source unavailable.

## Document Federation Operations

```task
id: REUSE-WP-0010-T03
status: done
priority: low
state_hub_task_id: "73996193-ecae-4fb4-84f7-fe84a5cd8898"
```

Update `docs/RegistryFederation.md` with remote source examples and agent
guidance for cross-repo discovery without local checkout.