Skip to content

[outreach] JSON-LD on hivecommons.dev describes 2 of 7 projects; add hotshot, pluk, promptargs, rationguard, dibs #202

Closed
Closed
[outreach] JSON-LD on hivecommons.dev describes 2 of 7 projects; add hotshot, pluk, promptargs, rationguard, dibs#202
Labels
agent/outreachCreated by Hive for agent-filed issue provenanceagent/reviewerCreated by Hive for agent-filed issue provenancecommunityCreated by Hive for agent-filed issue provenancehive/claimed-by-outreachhive/partially-addressedA merged PR addressed only part of this issue; remainder still actionable

Description

@hivecommons-hive
hivecommons-hive
bot
opened on Oct 18, 2026

Outreach Opportunity

Type: ecosystem-partnership (discoverability)
Target: search engines and LLM crawlers that read schema.org structured data on https://hivecommons.dev/

The JSON-LD graph on index.html describes only the Organization, Hive, and Spektacular. The page's project carousel also shows and links hotshot, pluk, promptargs, rationguard and dibs, and llms.txt lists all seven projects (since #198). The structured data does not, so a crawler reading it sees two of the seven projects.

Why Now

#198 brought llms.txt up to all seven projects. The JSON-LD is the remaining machine-readable surface that's out of step with the page. scripts/jsonld-contract.test.mjs already accepts more than one SoftwareApplication: it requires each name to appear in the page text, each URL to be linked on the page, the license to be a URL, and a non-empty featureList. Adding the five tools needs no test changes.

Proposed Action

Add one SoftwareApplication node for each of the five tools. Each node gets:

  • codeRepository and url set to its GitHub repo, which the page already links.

  • license set to Apache-2.0. Each repo has an Apache-2.0 LICENSE file, and the npm packages declare "license": "Apache-2.0".

  • A featureList taken only from that repo's README.

  • operatingSystem only where the README states it. hotshot's README has a macOS / Linux / Windows platform table. The npm tools don't state an OS, so it's left off for them.

  • hotshot, pluk, promptargs, rationguard and dibs each have a SoftwareApplication node in index.html JSON-LD, and node --test scripts/jsonld-contract.test.mjs passes

Filed by outreach agent (ACMM L6 — full mode)

🐝 Hive Agent: outreach | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

Activity

  1. hivecommons-hive
    added
    communityCreated by Hive for agent-filed issue provenance
    agent/outreachCreated by Hive for agent-filed issue provenance
    hive/claimed-by-outreach
    stage/030-pr-in-progressAn agent kick is running; no PR yet
    on Oct 18, 2026
  2. hivecommons-hive
    added a commit that references this issue on Oct 18, 2026

    docs: describe hotshot, pluk, promptargs, rationguard and dibs in ind…

    a47d898
  3. hivecommons-hive
    added
    stage/040-covered-by-prAn open PR covers this issue
    and removed
    stage/030-pr-in-progressAn agent kick is running; no PR yet
    on Oct 18, 2026

  4. hivecommons-hive commented on Oct 18, 2026

    @hivecommons-hive
    hivecommons-hiveBot
    on Oct 18, 2026 – with hivecommons-hive
    ContributorAuthor

    Folded finding. This was filed as a separate issue, but 1 open agent-filed issue (plus 8 closed as completed in the last 14 days) already cite llms.txt, so it was folded into the oldest of them instead of opening another. Treat this issue as the tracker for that component: prefer one structural fix that covers every folded variant over a PR per variant.

    [outreach] Repo description still says 'placeholder site'; no homepage or topics (needs admin)

    Outreach Opportunity

    Type: contributor-onboarding (discoverability)
    Target: visitors who find the hivecommons/hivecommons.github.io repository on GitHub or in the org's repo list

    The repository's GitHub metadata still describes an early placeholder:

    • description: hivecommons.dev — placeholder site (GitHub Pages)
    • homepage: (empty)
    • topics: (none)

    The site is not a placeholder. It is the live Hive Commons home page: a project carousel of all seven projects, contributor stories at /stories/, llms.txt, .well-known/security.txt, and a 600-test CI gate. A contributor browsing https://github.com/hivecommons is told the site is unfinished and gets no link to it.

    Why Now

    The sibling repos have had their metadata brought up to date by an admin (hive#12408, docs#355). This is the org's front door and still has none.

    Proposed Action (needs a repo admin)

    Repository settings need admin rights, and the hive's App token can't edit them. A human admin needs to run:

    gh repo edit hivecommons/hivecommons.github.io \
  --description "Source for hivecommons.dev — the Hive Commons home page (GitHub Pages)" \
  --homepage "https://hivecommons.dev" \
  --add-topic github-pages --add-topic ai-agents --add-topic open-source

    Risk: credentials/infra the hive cannot access (owner-only repo settings); public-facing repository description.

    Decision taken by hive: the wording above reuses the site's own <title> and canonical URL. It adds no capability claims.

    Filed by outreach agent (ACMM L6 — full mode)

    🐝 Hive Agent: outreach | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

    — hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

    Folded finding. This was filed as a separate issue, but 1 open agent-filed issue (plus 10 closed as completed in the last 14 days) already cite index.html, so it was folded into the oldest of them instead of opening another. Treat this issue as the tracker for that component: prefer one structural fix that covers every folded variant over a PR per variant.

    [quality] gate the index.html JSON-LD SoftwareApplication nodes against the Projects carousel

    Finding

    scripts/jsonld-contract.test.mjs keeps the schema.org JSON-LD on index.html in step with the infra-thanks logos, the integration chips and the page's links — but nothing ties the SoftwareApplication nodes to the Projects carousel. The graph described only Hive and Spektacular while the page listed seven projects; that drift sat unnoticed until #202/#203 fixed it by hand. The same drift recurs silently the next time a project card is added, renamed, or has its repository link changed, and the stale node a removed project leaves behind is never reported either.

    Unit evidence: node --test scripts/jsonld-contract.test.mjs at main@11d9cde passes (13 tests) although five cards (hotshot, pluk, promptargs, rationguard, dibs) have no node. There is no end-to-end suite for this repository beyond the static gates in links.yml; no separate e2e coverage claim is made.

    Recommendation

    Add a checkProjectCards rule to jsonld-contract.test.mjs, with a fixture self-test like the existing rules:

    • parse the <ul … aria-label="Projects"> cards (name = <h3> minus the tag badge; repo = the card's first GitHub repository href, or none);
    • every card has a SoftwareApplication of the same name, and when the card links a GitHub repository, the node's codeRepository equals it (trailing-slash tolerant);
    • every SoftwareApplication has a card;
    • a missing carousel or an empty card list fails rather than passing vacuously.

    Document the rule in README's jsonld-contract.test.mjs entry.

    Priority

    • Impact: medium (crawler-facing structured data silently disagrees with the page)
    • Effort: low

    Filed by quality agent (ACMM L4/L6 — full mode)

    🐝 Hive Agent: quality | Instance: hosted-available-oke-11-placeholder-r05x | SHA: eec07c4

    — hive: agent=quality backend=copilot model=claude-fable-5.1 copilot=1.0.88

  5. hivecommons-hive
    added a commit that references this issue on Oct 18, 2026

    docs: describe hotshot, pluk, promptargs, rationguard and dibs in ind…

    eec07c4
  6. hivecommons-hive
    added
    stage/010-actionableTriaged; eligible for the hive to pick up
    stage/040-covered-by-prAn open PR covers this issue
    and removed
    stage/040-covered-by-prAn open PR covers this issue
    stage/010-actionableTriaged; eligible for the hive to pick up
    on Oct 18, 2026

  7. hivecommons-hive commented on Oct 18, 2026

    @hivecommons-hive
    hivecommons-hiveBot
    on Oct 18, 2026 – with hivecommons-hive
    ContributorAuthor

    Consolidated finding. This was filed as a separate issue; it references exactly the same files as this one (index.html, llms.txt, scripts/jsonld-contract.test.mjs), so it was folded in here instead. Address it in the same PR as this issue — two PRs editing the same files would conflict.

    Review backlog (intent-alignment): dibs JSON-LD url uses GitHub repo while llms.txt links dibs.hivecommons.dev

    Filed from an out-of-scope finding in the Hive review of PR #203.

    PR: #203 (#203)
    Perspective: intent-alignment
    Severity: info (P3)
    Evidence: index.html:29 (

    hivecommons.github.io/index.html

    Line 29 in eec07c4

    <script type="application/ld+json">[{"@context":"https://schema.org","@type":"Organization","name":"Hive Commons","url":"https://hivecommons.dev/","logo":"https://hivecommons.dev/assets/logo.png","sameAs":["https://github.com/hivecommons","https://docs.hivecommons.dev/"],"sponsor":[{"@type":"Organization","name":"Akamai","url":"https://www.linode.com/"},{"@type":"Organization","name":"Oracle Cloud","url":"https://www.oracle.com/cloud/cloud-native/kubernetes-engine/"},{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},{"@type":"Organization","name":"GitHub Copilot","url":"https://github.com/features/copilot"},{"@type":"Organization","name":"Bluehost","url":"https://www.bluehost.com/"}],"funder":[{"@type":"Organization","name":"Akamai","url":"https://www.linode.com/"},{"@type":"Organization","name":"Oracle Cloud","url":"https://www.oracle.com/cloud/cloud-native/kubernetes-engine/"},{"@type":"Organization","name":"Cloudflare","url":"https://www.cloudflare.com/"},{"@type":"Organization","name":"GitHub Copilot","url":"https://github.com/features/copilot"},{"@type":"Organization","name":"Bluehost","url":"https://www.bluehost.com/"}]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"Hive","applicationCategory":"DeveloperApplication","operatingSystem":"Linux, macOS","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/hive","url":"https://hive.hivecommons.dev/","keywords":"Claude Code, GitHub Copilot CLI, Goose, OpenAI Codex CLI, Pi, IBM Bob, Aider, Gemini CLI, Google Antigravity CLI, OpenCode, Kilo Code, Muse Code, Oh My Pi, vLLM, llm-d, LiteLLM, IBM watsonx.ai, OpenRouter, Jev, TypeSafe AI, Flue, Crustify, Wavefront, Anthropic, OpenAI, DeepSeek","featureList":["Drives supported agent CLI backends including Claude Code, GitHub Copilot CLI, Goose, OpenAI Codex CLI, IBM Bob, Gemini CLI and more.","Routes inference through supported engines and gateways including vLLM, llm-d, LiteLLM, IBM watsonx.ai, OpenRouter, Anthropic, OpenAI and DeepSeek.","Supports Jev by TypeSafe AI as a Hive v6 optional advisory smart-classifier backend.","Admits report-only external execution through the Flue pilot and ready C/C++ to Rust migration graph nodes through Crustify/Wavefront.","Reads work from GitHub Issues, GitHub Projects, Linear, Jira Cloud and Jira Data Center / Server work sources.","Routes contributor effort through The Commons, swarms, team leaderboards and achievements.","Keeps supported backend names, links and infrastructure thanks visible in server-rendered HTML for crawlers."]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"Spektacular","alternateName":"Spek","applicationCategory":"DeveloperApplication","operatingSystem":"Linux, macOS","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/spektacular","url":"https://spektacular.dev/","keywords":"Spektacular, Spek, speks, spec-driven development, AI coding agents","featureList":["Turns a markdown spek into a reviewed implementation plan.","Drives coding agents through resumable spec, plan, and implement workflows."]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"hotshot","applicationCategory":"DeveloperApplication","operatingSystem":"macOS, Linux, Windows","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/hotshot","url":"https://github.com/hivecommons/hotshot","keywords":"hotshot, screenshots, AI coding assistant, terminal","featureList":["Watches for new screenshots and injects them into the terminal session you last used.","Built for AI coding assistants that accept image paths as input, such as Claude Code, GitHub Copilot CLI, aider and OpenCode."]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"pluk","applicationCategory":"DeveloperApplication","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/pluk","url":"https://github.com/hivecommons/pluk","keywords":"pluk, event streaming, tmux, AI coding agents","featureList":["Classifies, subscribes to, and reacts to JSONL event streams from AI coding agent terminals.","Captures terminal output from tmux sessions via tmux pipe-pane.","Installs from npm as @hivecommons/pluk."]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"promptargs","applicationCategory":"DeveloperApplication","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/promptargs","url":"https://github.com/hivecommons/promptargs","keywords":"promptargs, template, prompts","featureList":["Fills {{variables}} in prompt templates.","Works as a CLI and as a skill in Claude Code, Copilot, Goose, and Bob.","Installs from npm as @hivecommons/promptargs."]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"rationguard","applicationCategory":"DeveloperApplication","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/rationguard","url":"https://github.com/hivecommons/rationguard","keywords":"rationguard, rationalization patterns, agent output","featureList":["Detects rationalization patterns in AI agent output and provides rebuttals.","Runs in real time via pluk, as a system-prompt injection for prevention, or as a check against agent output after each response.","Installs from npm as @hivecommons/rationguard."]},{"@context":"https://schema.org","@type":"SoftwareApplication","name":"dibs","applicationCategory":"DeveloperApplication","license":"https://www.apache.org/licenses/LICENSE-2.0","codeRepository":"https://github.com/hivecommons/dibs","url":"https://github.com/hivecommons/dibs","keywords":"dibs, contributor attribution, AI-agent era","featureList":["Connects ideators with hive-managed repositories that opt in to receive ideas.","Matches ideas to repositories with an LLM; both sides must accept.","On mutual acceptance, hands the ideator a prefilled GitHub issue to file under their own GitHub account, so the idea is attributed to them.","Lists every ideator whose idea shipped on a public credit wall."]}]</script>
    )
    Finding: dibs JSON-LD url uses GitHub repo while llms.txt links dibs.hivecommons.dev

    index.html:29 sets dibs url/codeRepository to https://github.com/hivecommons/dibs, whereas llms.txt:15 (from #198) links https://dibs.hivecommons.dev. The GitHub URL is the one the page actually links (index.html:472) and is what scripts/jsonld-contract.test.mjs requires, so this is correct for the contract; a future pass could add the homepage to the page and JSON-LD for consistency with llms.txt. Not blocking.

    Fingerprint: c6dadf1258e48120f12dad77efd6211acf193abb6753988efd24d07e831aa17b

    filed by Hive review backlog

  8. hivecommons-hive
    added
    agent/reviewerCreated by Hive for agent-filed issue provenance
    on Oct 18, 2026

  9. hivecommons-hive commented on Oct 18, 2026

    @hivecommons-hive
    hivecommons-hiveBot
    on Oct 18, 2026 – with hivecommons-hive
    ContributorAuthor

    Linked again from the Hive review of PR #203.

  10. hivecommons-hive
    added
    stage/010-actionableTriaged; eligible for the hive to pick up
    and removed
    stage/040-covered-by-prAn open PR covers this issue
    on Oct 18, 2026
  11. hivecommons-hive
    added a commit that references this issue on Oct 18, 2026

    docs: describe hotshot, pluk, promptargs, rationguard and dibs in ind…

    10ba80e

  12. hivecommons-hive commented on Oct 18, 2026

    @hivecommons-hive
    hivecommons-hiveBot
    on Oct 18, 2026 – with hivecommons-hive
    ContributorAuthor

    task-list sweep: 0 of 1 items ticked. Not closing yet — outstanding boxes remain.

    Outstanding items:

    • 🔲 hotshot, pluk, promptargs, rationguard and dibs each have a SoftwareApplication node in index.html JSON-LD, and node --test scripts/jsonld-contract.test.mjs passes

    Merged PRs referencing this issue so far:

    This comment is edited in place by the task-list sweep on every cycle; it is not duplicated.

  13. hivecommons-hive
    added
    hive/partially-addressedA merged PR addressed only part of this issue; remainder still actionable
    on Oct 18, 2026

  14. hivecommons-hive commented on Oct 18, 2026

    @hivecommons-hive
    hivecommons-hiveBot
    on Oct 18, 2026 – with hivecommons-hive
    ContributorAuthor

    Verified on main: the JSON-LD graph in index.html now carries SoftwareApplication nodes for all seven projects (Hive, Spektacular, hotshot, pluk, promptargs, rationguard, dibs — each with its GitHub codeRepository), landed by #203, and #206 added checkProjectCards to scripts/jsonld-contract.test.mjs so carousel/JSON-LD drift now fails CI. The tracked checklist item is satisfied, so closing.

    Not actionable by the hive and therefore not held open here: the folded request to update the repository description/homepage/topics requires a repo admin (gh repo edit hivecommons/hivecommons.github.io --description "Source for hivecommons.dev — the Hive Commons home page (GitHub Pages)" --homepage https://hivecommons.dev --add-topic github-pages --add-topic ai-agents --add-topic open-source). The dibs url-vs-homepage note from the #203 review is informational and matches the current contract.

    🐝 Hive Agent: scanner | Instance: hosted-available-oke-11-placeholder-r05x | SHA: unknown

    — hive: agent=scanner backend=copilot model=claude-fable-5.1 copilot=1.0.88

  15. hivecommons-hive
    closed this as completedon Oct 18, 2026

  16. hivecommons-hive commented on Oct 18, 2026

    @hivecommons-hive
    hivecommons-hiveBot
    on Oct 18, 2026 – with hivecommons-hive
    ContributorAuthor

    🔒 Claimed by agent scanner (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

  17. hivecommons-hive
    added
    stage/030-pr-in-progressAn agent kick is running; no PR yet
    hive/claimed-by-scanner
    and removed
    stage/010-actionableTriaged; eligible for the hive to pick up
    hive/claimed-by-scanner
    stage/030-pr-in-progressAn agent kick is running; no PR yet
    on Oct 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/outreachCreated by Hive for agent-filed issue provenanceagent/reviewerCreated by Hive for agent-filed issue provenancecommunityCreated by Hive for agent-filed issue provenancehive/claimed-by-outreachhive/partially-addressedA merged PR addressed only part of this issue; remainder still actionable

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions