Skip to content

πŸ“– Document Inbox voice sources - #17895

Closed
Karibhou wants to merge 8 commits into
hivecommons:inbox-voice-sourcesfrom
Karibhou:docs/inbox-17882
Closed

Karibhou wants to merge 8 commits into
hivecommons:inbox-voice-sourcesfrom
Karibhou:docs/inbox-17882

Conversation

@Karibhou

@Karibhou Karibhou commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Closes #17882

Verification

  • go generate ./pkg/dashboard/webstatic/
  • Rendered the Plaud Integrations card without a configured connector and checked that other integrations do not display the link.

β€” hive: backend=omp model=openai-codex/gpt-6.1-terra

actions-user and others added 5 commits November 12, 2026 07:05
Automated release commit. Compiles changelog.d/ fragments and moves
the CHANGELOG.md Unreleased section into a dated v5.228.6 entry.
See src/docs/releases.md.

Signed-off-by: hive-release-bot <actions@github.com>
…ashboard (hivecommons#17886)

* ✨ workflows: owner toggle for model-based stage derivation from the dashboard

workflow.enabled gates rules-based stage derivation and bound-model label
provisioning, but could only be set by editing hive.yaml, which hosted
hives cannot do. Add PUT /api/workflows/enabled {enabled} (owner-gated,
persists hive.yaml, audited workflow_enabled / workflow_disabled) and a
"Derive stages from bound models" switch in Settings β†’ Workflows β†’ Library
that confirms before turning on. The stage engine and the tracker already
read cfg.Workflow.Enabled live and the reloader mutates the same *Config
in place, so no reload hook is needed. Turning on also provisions every
bound repository's model labels at once through the sweep's memoised
ensureStageLabels path (new automerge.Engine.EnsureStageLabels, wired as
Dependencies.WorkflowProvisionLabels); failures come back as warnings and
the next sweep retries. The Repos binding row says "columns only β€” turn
on derivation in Workflows" when a binding exists while the flag is off.

Refs hivecommons#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

* chore: move changelog fragment to root changelog.d/

Refs hivecommons#17620

Signed-off-by: Andrew Anderson <andy@clubanderson.com>

---------

Signed-off-by: Andrew Anderson <andy@clubanderson.com>
Hive-Run: hivecommons#17859
Hive-Plan: classify repeated proxy forward failures
Hive-Spec: fleet-report#runtime-classes

Signed-off-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: Karibhou <Karibhou@users.noreply.github.com>
Co-authored-by: hivecommons-hive[bot] <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Hive-Run: hivecommons#17882
Hive-Plan: inbox voice sources documentation
Hive-Spec: voice-recorders#docs-quickstart
Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.com>
@kubestellar-prow kubestellar-prow Bot added the dco-signoff: yes Indicates the PR's author has signed the DCO. label Nov 12, 2026
@kubestellar-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign kellyaa for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubestellar-prow kubestellar-prow Bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Nov 12, 2026
@hivecommons-hive

hivecommons-hive Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

@Karibhou this PR is back in your court (stage/072-returned-to-contributor). The hive will not merge it until the head changes.

Review asks:

  • the review swarm requested changes

Reply here or push a new head to this branch (same sign-off); CI and the review swarm re-run automatically and the PR returns to the normal path.

Queued in your relay fix queue (1 waiting): fixes are handed out before new work as soon as you have capacity.

Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.com>

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correctness review (head b2730bf, read against merge-base 2bfebf1).

1. static/index.html not regenerated β†’ TestIndexHTMLIsGenerated fails

The PR edits src/pkg/dashboard/static-src/js/knowledge.js:1981 but does not touch src/pkg/dashboard/static/index.html. src/pkg/dashboard/webstatic/indexgen_test.go:15-29 requires the committed bundle to be the byte-exact concatenation of static-src/ and fails otherwise ("Edit the per-area sources in static-src/, then run make dashboard-gen … and commit both"). At the base, static/index.html has 0 occurrences of inbox-voice-sources. CI job test (rest 3/4) is red on this head; I could not fetch its log to confirm this is the failing test, but the drift is deterministic.

Fix: make dashboard-gen (cd src && go generate ./pkg/dashboard/webstatic/) and commit the regenerated static/index.html alongside knowledge.js.

2. Three of four files duplicate #17885, which must land first anyway

  • src/docs/inbox-voice-sources.md is byte-identical to the one in #17885 (same blob bb5c95792f).
  • src/docs/documentation-map.md:175 β€” #17885 inserts a line at the same spot with different text ("triage Plaud/Wispr Flow recordings into spektacular RFCs…"), so whichever merges second conflicts.
  • changelog.d/added-inbox-voice-quickstart.md + #17885's changelog.d/added-inbox-voice-sources.md describe the same feature β†’ duplicate release notes.
  • The doc's API section points at api-reference/knowledge.md for GET /api/inbox etc.; at base that file has 0 mentions of /api/inbox or auth/complete β€” the pointer only resolves once #17885 merges.

Suggested remediation: rebase this PR onto #17885's branch (or wait for it to land) and reduce it to the unique delta β€” the knowledge.js quickstart link plus the regenerated index.html β€” dropping the duplicated doc file, map line and changelog fragment (or rewording the fragment to only "Added a quickstart link from the Plaud source card").

3. Link placement vs. #17882

#17882 asks for "a link from the Integrations Plaud card". The diff adds it to the Knowledge β†’ Sources "πŸŽ™οΈ Plaud voice notes" <details> (knowledge.js:1981), not to the Integrations modal card rendered by kbRenderIntegrationsModal (knowledge.js:2389, Plaud line at kbPlaudAuthLine, :2567). The changelog wording ("Plaud knowledge source setup") matches the diff, not the issue. Minor; consider also emitting the link next to kbPlaudAuthLine(c.name) at :2436.

β€” hive: agent=adjudicator backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Hive status β€” updated in place; edits do not notify. Full history is in the Activity Monitor.

Review findings from reviewer-2 (folded here because this head already carries its hive review):

Conclusion: this is a strict subset of #17885 and documents behaviour that does not exist on v5 yet. I'd recommend not merging it ahead of #17885.

What I verified (read both branches, not just the diffs):

The body acknowledges this ("merge #17885 first… will need reconciliation"), so this isn't a mismatch between claim and diff β€” it's a sequencing/duplication call. If #17885 lands first, this PR reduces to the knowledge.js link line (or a merge conflict on the doc file); if this lands first, v5 ships a reference page for endpoints and config keys that 404 / are ignored until #17885 merges.

Linked issue #17882 is labelled hive/claimed-by-human and is a child of the RFC tracker #17875 that #17885 implements.

I have not closed anything.

Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.com>

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Summary: this PR is a strict subset of #17885, and on its own it documents a feature v5 does not have. I'd recommend holding it (or closing it in favour of #17885) rather than landing it first β€” a maintainer should decide which; I have not closed anything.

What I verified

  • src/docs/inbox-voice-sources.md here (head b2730bf) is byte-identical to the same file in #17885 (head f5620c2): diff of the two is empty, 94 lines each. #17885 also carries the same documentation-map.md entry, a knowledge.js change to the Plaud card, and its own changelog.d/added-inbox-voice-sources.md. So once #17885 merges, everything in this PR except the one-line blob link at knowledge.js:1981 and the second changelog fragment is a no-op, and the second fragment plus the differing knowledge.js hunk will need manual reconciliation (the PR body already acknowledges this).
  • On v5 today there is no api/inbox anywhere in the repository (code search returns 0 hits), and src/docs/api-reference/knowledge.md at v5 has no inbox or auth/complete rows. Yet inbox-voice-sources.md:90-94 tells the reader "See api-reference/knowledge.md for GET /api/inbox, POST /api/inbox/route, …" β€” that section points at routes the referenced page does not list, and :40-58 documents an inbox: config block and POST /api/inbox/settings that nothing on v5 reads. If this lands before #17885, the docs are wrong for every reader until the implementation catches up.
  • #17882 asks for exactly this page plus the two links, so intent matches the issue; the issue is just already covered by #17885 (and is labelled stage/040-covered-by-pr).

Suggested path: let #17885 (currently changes_requested) land with the page, then rebase this to only the delta β€” the Plaud-card quickstart link at knowledge.js:1981, if #17885's card rework still wants it β€” and drop the duplicate page and fragment. Alternatively close this and move that single link into #17885.

Not a finding: test (rest 3/4) shows FAILURE on this head; I could not retrieve the job log, so I have not attributed it to this change.

β€” hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

Signed-off-by: Karibhou <157208370+Karibhou@users.noreply.github.com>
@Karibhou
Karibhou changed the base branch from v5 to inbox-voice-sources November 12, 2026 08:00
@kubestellar-prow kubestellar-prow Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Nov 12, 2026
@kubestellar-prow
kubestellar-prow Bot deleted the branch hivecommons:inbox-voice-sources November 12, 2026 08:00
@kubestellar-prow kubestellar-prow Bot closed this Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Indicates the PR's author has signed the DCO. size/XL Denotes a PR that changes 500-999 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ Inbox: Docs page + quickstart link

3 participants