diff --git a/.custodian-brief.md b/.custodian-brief.md index acae414..ade9bcf 100644 --- a/.custodian-brief.md +++ b/.custodian-brief.md @@ -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) diff --git a/WORK-RECORDS.md b/WORK-RECORDS.md index 2b2c7aa..e2a1123 100644 --- a/WORK-RECORDS.md +++ b/WORK-RECORDS.md @@ -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 | diff --git a/docs/evidence/2026-10-13-browser-discovery.md b/docs/evidence/2026-10-13-browser-discovery.md index d2c3287..edc34b9 100644 --- a/docs/evidence/2026-10-13-browser-discovery.md +++ b/docs/evidence/2026-10-13-browser-discovery.md @@ -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`. diff --git a/docs/evidence/2026-10-13-browser-discovery/hosted-plan-check.json b/docs/evidence/2026-10-13-browser-discovery/hosted-plan-check.json new file mode 100644 index 0000000..62732b7 --- /dev/null +++ b/docs/evidence/2026-10-13-browser-discovery/hosted-plan-check.json @@ -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 + } +} diff --git a/docs/evidence/2026-10-13-browser-discovery/hosted-readback.json b/docs/evidence/2026-10-13-browser-discovery/hosted-readback.json new file mode 100644 index 0000000..ae2e8d2 --- /dev/null +++ b/docs/evidence/2026-10-13-browser-discovery/hosted-readback.json @@ -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" + } +} diff --git a/intakes/REUSE-IN-0001-headless-browser-runnable-answer.md b/intakes/REUSE-IN-0001-headless-browser-runnable-answer.md index 15cd89f..145f407 100644 --- a/intakes/REUSE-IN-0001-headless-browser-runnable-answer.md +++ b/intakes/REUSE-IN-0001-headless-browser-runnable-answer.md @@ -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. diff --git a/workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md b/workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md index cf3decd..5641340 100644 --- a/workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md +++ b/workplans/REUSE-WP-0024-browser-discovery-and-provider-evidence.md @@ -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.