Record hosted browser readback and close synchronized discovery work
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
ci / validate-registry (push) Successful in 1m7s

Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a13690-1c84-77a2-aeee-7f517ec60f5d
This commit is contained in:
tegwick 2026-10-13 20:52:04 +02:00
parent 50077c9bea
commit a6da9f2c5c
7 changed files with 186 additions and 22 deletions

View file

@ -2,23 +2,12 @@
# Custodian Brief — reuse-surface
**Domain:** infotech
**Last synced:** 2026-10-13 18:43 UTC
**Last synced:** 2026-10-13 18:50 UTC
**State Hub:** http://127.0.0.1:8000 *(adjust if running on a remote machine)*
## Active Workstreams
### Resolve browser discovery relevance and publish verified provider consumption
Progress: 0/3 done | workplan_id: `3d62d0af-5deb-55b5-b570-e62f05a43666`
**Open tasks:**
- ► Publish the verified provider path `dd75f033`
- · Fix short-intent relevance `a689bc2a`
- · Validate, publish and synchronize `0be283ba`
## Inbox Hygiene
**Stale unread:** 2 message(s) older than 3 day(s) — triage at session start.
**Missing thread_id:** 2 unread message(s) lack supersession chains.
*(none — repo may need first-session setup)*
---
## MCP Orientation (when available)

View file

@ -10,12 +10,12 @@
| --- | --- | --- | --- | --- |
| workplan | ADHOC-2026-10-13 | finished | — | workplans/ADHOC-2026-10-13.md |
| workplan | REUSE-WP-0023 | finished | — | workplans/REUSE-WP-0023-access-engine-source-rename.md |
| workplan | REUSE-WP-0024 | active | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| workplan | REUSE-WP-0024 | finished | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| task | ADHOC-2026-10-13-T01 | done | — | workplans/ADHOC-2026-10-13.md |
| task | ADHOC-2026-10-13-T02 | done | — | workplans/ADHOC-2026-10-13.md |
| task | REUSE-WP-0023-T01 | done | — | workplans/REUSE-WP-0023-access-engine-source-rename.md |
| task | REUSE-WP-0023-T02 | done | — | workplans/REUSE-WP-0023-access-engine-source-rename.md |
| task | REUSE-WP-0024-T01 | progress | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| task | REUSE-WP-0024-T02 | todo | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| task | REUSE-WP-0024-T03 | todo | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| intake | REUSE-IN-0001 | open | green | intakes/REUSE-IN-0001-headless-browser-runnable-answer.md |
| task | REUSE-WP-0024-T01 | done | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| task | REUSE-WP-0024-T02 | done | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| task | REUSE-WP-0024-T03 | done | — | workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md |
| intake | REUSE-IN-0001 | closed | green | intakes/REUSE-IN-0001-headless-browser-runnable-answer.md |

View file

@ -81,4 +81,35 @@ two capabilities.
- `validate --relations --fail-on-warnings`: **3 entries valid**.
- `catalog`, `graph --check`, and `federation compose`: generated successfully;
**66 federated capabilities**, preserving one browser capability.
- `git diff --check`: clean.
- Whitespace check passed apart from intentional Markdown hard breaks in the
generated Custodian brief.
## Publication and hosted readback
Implementation commit **`50077c9`** pushed to `origin/main`. Public raw capability
and index documents matched the committed files byte for byte. Refreshed
`https://reuse.coulomb.social/v1/federated?refresh=true` at **18:49:02 UTC**:
`stale: false`, no federation warnings, **66 capabilities**, exactly one browser
entry at **D3 / A5 / C2 / R2**.
The updated local CLI queried this hosted snapshot with `--intent "headless
browser" --no-llm`: browser first, score **0.6667**, verdict **reuse**, with the
client and conditional availability guidance in the returned summary. Matching
runs in the CLI against the hosted index; no server code deployment was needed.
- [Hosted entry readback](2026-10-13-browser-discovery/hosted-readback.json)
- [Hosted-snapshot plan-check](2026-10-13-browser-discovery/hosted-plan-check.json)
REUSE-IN-0001 is closed for registry discovery/consumption concerns. Provider
managed admission and consumer application acceptance remain outside this closure.
`statehub fix-consistency --repo reuse-surface --json` synchronized the finished
workplan and all three done tasks with zero failures or automation errors. Its
generated brief/index are included with the closure commit; the automatic
generated-only commit was refused by the existing Git hook. Four pre-existing
repository-classification advisories remain. A plain intake status PATCH returned
HTTP 500 because closure requires an outcome. Used the supported intake `/close`
transition with `outcome: promoted`, `promoted_to: REUSE-WP-0024` after recording
those fields in the canonical file.
Inbox handoffs and standing notices were read/acknowledged. Progress receipt:
`898a9638-09b8-44fa-8e04-5970c7cd2bbc`.

View file

@ -0,0 +1,66 @@
{
"query": {
"source": "intent",
"text": "headless browser",
"workplan_id": null,
"workplan_path": null
},
"verdict": "reuse",
"top_score": 0.6667,
"matches": [
{
"id": "capability.infotech.headless-browser",
"score": 0.6667,
"vector": "D3 / A5 / C2 / R2",
"owner": "reuse-surface",
"summary": "Headless browser automation, screenshots and keyboard trials through rapp-playwright 0.1.0 (Playwright 1.64.0, Chromium 156.0.8078.4). Published A5 local container; managed Railiance admission is pending. Download the Python 3.10+ standalone client from https://forgejo.coulomb.social/coulomb/rapp-playwright/raw/commit/8831a05aeba5ce588f3b395ade676dde2a151c5d/client/rapp_playwright.py and run `python3 rapp_playwright.py --url http://127.0.0.1:18083 preflight`, then `python3 rapp_playwright.py --url http://127.0.0.1:18083 trial --out trial-01` with a fresh output directory. This endpoint was verified locally on 2026-10-13 and is ephemeral; it installs no browser for the caller. If unreachable, follow the local container setup in the capability card or adapt its A2 source examples; this is an availability gap on the existing capability. Contract: https://forgejo.coulomb.social/coulomb/rapp-playwright/src/commit/8831a05aeba5ce588f3b395ade676dde2a151c5d/docs/consumer-contract.md.",
"kind": "deterministic"
},
{
"id": "capability.identity.user-engine",
"score": 0.2,
"vector": "D4 / A1 / C2 / R0",
"owner": "user-engine",
"summary": "Headless, multi-application, multi-tenant user management engine covering registration, identity/factor models, entitlement claims, hats/realms/services/assets access profiles, and onboarding journeys.",
"kind": "deterministic"
},
{
"id": "capability.infotech.pdf-evidence-ingest",
"score": 0.2,
"vector": "D2 / A1 / C1 / R1",
"owner": "evidence-source",
"summary": "Turns raw PDF bytes into an engine-shaped Document + DocumentRepresentation \u2014 SHA-256 fingerprint, canonical text, page map, and gap-free offset map \u2014 as a runtime-agnostic library with no viewer, persistence, or React coupling.",
"kind": "deterministic"
},
{
"id": "capability.communication.context-engine",
"score": 0.0476,
"vector": "D4 / A1 / C1 / R0",
"owner": "kontextual-engine",
"summary": "Headless knowledge-operations engine turning heterogeneous information assets into persistent, contextual, governed, retrievable, transformable, and agent-operable knowledge.",
"kind": "deterministic"
},
{
"id": "capability.infotech.email-connector",
"score": 0.0476,
"vector": "D2 / A1 / C1 / R0",
"owner": "email-connect",
"summary": "Headless, provider-neutral email communication and evidence service; first slice scans a mailbox or fixture directory and produces timestamped CSV evidence reports.",
"kind": "deterministic"
}
],
"federated_index_updated": "2026-10-13",
"federated_index_stale_warning": null,
"index_source": {
"kind": "hosted",
"url": "https://reuse.coulomb.social/v1/federated",
"fetched_at": "2026-10-13T18:49:10.789378+00:00",
"composed_at": "2026-10-13T18:49:02+00:00",
"capability_count": 66,
"sha256": "59d5c247ac2a769e07f7ac6e464242bc0d3af78bc838b7f31ff995a8a36671e7",
"digest_format": "response-bytes",
"max_age_hours": 24,
"stale": false,
"federation_warnings": false
}
}

View file

@ -0,0 +1,43 @@
{
"composed_at": "2026-10-13T18:49:02+00:00",
"updated": "2026-10-13",
"stale": false,
"capability_count": 66,
"federation_warnings": null,
"browser": {
"id": "capability.infotech.headless-browser",
"name": "Headless Browser Automation",
"summary": "Headless browser automation, screenshots and keyboard trials through rapp-playwright 0.1.0 (Playwright 1.64.0, Chromium 156.0.8078.4). Published A5 local container; managed Railiance admission is pending. Download the Python 3.10+ standalone client from https://forgejo.coulomb.social/coulomb/rapp-playwright/raw/commit/8831a05aeba5ce588f3b395ade676dde2a151c5d/client/rapp_playwright.py and run `python3 rapp_playwright.py --url http://127.0.0.1:18083 preflight`, then `python3 rapp_playwright.py --url http://127.0.0.1:18083 trial --out trial-01` with a fresh output directory. This endpoint was verified locally on 2026-10-13 and is ephemeral; it installs no browser for the caller. If unreachable, follow the local container setup in the capability card or adapt its A2 source examples; this is an availability gap on the existing capability. Contract: https://forgejo.coulomb.social/coulomb/rapp-playwright/src/commit/8831a05aeba5ce588f3b395ade676dde2a151c5d/docs/consumer-contract.md.",
"vector": "D3 / A5 / C2 / R2",
"domain": "infotech",
"status": "reviewed",
"owner": "reuse-surface",
"path": "registry/capabilities/capability.infotech.headless-browser.md",
"tags": [
"headless",
"browser",
"automation",
"playwright",
"chromium",
"testing",
"screenshots",
"extraction",
"firefox",
"webkit",
"selenium",
"puppeteer"
],
"consumption_modes": [
"informational",
"source adaptation",
"JavaScript library",
"Python library",
"cli",
"service API",
"container"
],
"source_repo": "reuse-surface",
"source_url": "https://forgejo.coulomb.social/coulomb/reuse-surface/raw/branch/main/registry/indexes/capabilities.yaml",
"source_index": "/data/cache/reuse-surface.yaml"
}
}

View file

@ -4,7 +4,9 @@
id: REUSE-IN-0001
kind: intake
title: "Answer a headless-browser request with a runnable trial, or say the gap is availability"
status: open
status: closed
outcome: promoted
promoted_to: REUSE-WP-0024
lane: green
flavor: implementation
origin: cross-repo
@ -81,3 +83,28 @@ description: >
the consumer's task and is not completed by this announcement.
state_hub_intake_id: "01a13530-89a8-77b0-bb95-ef16d74bb29b"
```
## Registry resolution — 2026-10-13
Implemented under REUSE-WP-0024 and published in commit `50077c9`.
The original description above is retained as the intake history.
- The same browser capability now includes a pinned, downloadable standalone
client, exact preflight/trial commands in the query summary, immutable local
container setup and conditional managed instructions. No sibling checkout or
consumer browser installation is needed for the provider path.
- A fresh local client-only trial passed all 14 fixture steps; four downloaded
PNGs passed independent hash/dimension checks at desktop and narrow sizes.
Availability is A5 for the published container, with A2 source reuse retained.
The endpoint is ephemeral and managed Railiance admission remains pending.
- Short-name scoring fixes relevance and false-new behavior. Plan-check using
the published hosted snapshot ranks the browser first at 0.6667, verdict
`reuse`. Relevance is explicitly separate from runtime readiness; an unavailable
provider is an availability gap on this entry.
- Hosted federation readback at 18:49:02 UTC is fresh, warning-free, and includes
one browser capability among 66 entries. Public capability/index bytes match
the published commit.
[Review, trial and publication evidence](../docs/evidence/2026-10-13-browser-discovery.md).
This closes the registry-owned intake, not CONTENT-WP-0000-T04, platform
admission or consumer application acceptance.

View file

@ -4,7 +4,7 @@ type: workplan
title: "Resolve browser discovery relevance and publish verified provider consumption"
domain: infotech
repo: reuse-surface
status: active
status: finished
owner: codex
origin: cross-repo
origin_ref: REUSE-IN-0001
@ -56,7 +56,7 @@ Verify the same behavior against the hosted snapshot using the local CLI.
```task
id: REUSE-WP-0024-T03
status: progress
status: done
priority: medium
state_hub_task_id: "0be283ba-12da-52a1-b1af-0c2d6dcb58f1"
```
@ -74,3 +74,11 @@ checked screenshots. Availability is now A5 for the published local container;
A6 managed admission remains pending. Name scoring ranks the browser first at
0.6667 instead of returning false-new. Replaced stale live-registry stats
assumptions with a controlled fixture after the full suite exposed them.
Completed publication: implementation commit `50077c9` pushed to `origin/main`;
public capability and index bytes match. Hosted readback at 18:49:02 UTC is fresh
and warning-free, with 66 capabilities and one browser entry. The updated local
CLI against that snapshot returns browser first, 0.6667, `reuse`; no server code
deployment was required. All **212 tests** pass, registry validation and graph
checks pass. REUSE-IN-0001 is closed for the registry-owned concerns. Managed
admission and consumer acceptance remain with their existing owners.