Discovery journal → WordPress
Post every discovery you encounter to WordPress using the existing REST API (_WordPress::CreatePost).
Related: BrainstormIntegrations.md · LuaBrainstormAPI.md · ChatSession-Features.md · IisPhpIntegration.md
Overview
| Piece | Role |
|---|---|
_DiscoveryJournal |
Record, seed, list, post, auto-post |
_WordPress::CreatePost |
Live REST publish |
| Dry-run mode | Local HTML only; does not mark posted |
| Seeds | Paper + v11 session discovery packs |
| Plugin | discoverykit (status/seed/list/post/doctor/selftest) |
Post title format: [Discovery] <title>
Body: category · epistemic · source · UTC · summary · detail HTML · journal id.
Configure WordPress once
wordpress config site https://yoursite.example
wordpress config username YOUR_WP_USER
wordpress config password xxxx xxxx xxxx xxxx # Application Password
wordpress config enabled on
wordpress config status draft # or publish
wordpress test
Application Passwords: WP Admin → Users → Profile → Application Passwords.
Settings keys: wordpress_site_url, wordpress_username, wordpress_app_password, wordpress_enabled, wordpress_default_status.
Password may also use the Active Directory secret slot wordpress_app_password.
Seed discoveries then publish
discovery seed all # paper + v11 session discoveries
discovery list pending
discovery dry-run off # only when credentials work
discovery post pending # one WP post per unposted entry
Seed variants:
| Command | Content |
|---|---|
discovery seed paper |
Epistemic / perception / RSI / multi-agent / knowledge paper exemplars |
discovery seed session |
v11 session findings (Minecraft, CAD/DCC, weather, body, NeMo, TF, layers, suggest, …) |
discovery seed all |
Both |
Auto-post every new encounter
discovery wordpress on # also sets wordpress_auto_report_enabled
discovery dry-run off
discovery encounter title My finding summary We observed X when Y category perception
Short form:
discovery add GPU thermal kills vision routing -- Vision backend fails after throttle
Flag form fields: title, summary, category, detail, source, epistemic.
With auto-post on, each encounter/add triggers a WordPress create (or dry-run HTML under data/discoveries/).
Commands reference
| Command | Effect |
|---|---|
discovery status |
Journal counters + WP status line |
discovery doctor |
Checklist + optional WP connection test |
discovery selftest |
Offline seed + dry post self-test |
discovery help |
Command help |
discovery seed paper\|session\|all |
Load known discoveries |
discovery list [pending] |
Show journal |
discovery show <id> |
Full entry |
discovery encounter … / add … / log … |
Record new discovery |
discovery wordpress on\|off |
Auto-post toggle |
discovery dry-run on\|off |
Live REST vs local HTML only |
discovery wp-status draft\|publish\|pending\|private |
Default WP status |
discovery post pending\|all\|<id> |
Publish |
wordpress discovery … |
Same umbrella (delegated early) |
discoverykit … |
Plugin alias subset |
In-app: help discovery.
Entry fields
| Field | Meaning |
|---|---|
id |
disc-<seq>-<slug> |
title |
Short name |
category |
perception, memory, rl, cad, weather, cognitive, platform, … |
summary |
One-line finding |
detail |
Longer body (markdown-ish → HTML) |
source |
paper / session / operator / system / lua |
epistemic |
empirical / instrument / simulation / method / anecdote |
posted |
True only after live successful WP post |
wp_post_id, wp_link, wp_status |
REST result |
Duplicate titles from the same source are skipped (returns existing id).
Storage
| Path | Content |
|---|---|
data/discoveries/journal.json |
Full journal + auto_post / dry_run / wp_status / seq |
data/discoveries/<id>.html |
Dry-run artifact only |
Safety
- Default dry-run is on — seed/selftest do not spam a live site.
- Dry-run success does not set
posted=true(backfill withpost pendinglater). - Prefer draft until content review is complete.
- Live post requires
wordpress_enabledand valid credentials. - Auto-post respects dry-run and enabled flags.
Lua
discovery_status()
discovery_seed_all()
discovery_list(true) -- pending only
discovery_record("title", "summary", "category", "detail") → id, auto_posted
discovery_wordpress(true)
discovery_dry_run(false)
discovery_post_pending() → count, note
Also run: lua_scripts/Brainstorm-Integrations.lua or integrate lua.
Full table: LuaBrainstormAPI.md.
Graphs of discoveries
graphs discovery
graphs export
PHP portal Graphs section charts categories and posted vs pending.
See PhpGraphs.md.
Files
| File | Role |
|---|---|
DiscoveryJournal.hpp / .cpp |
Core journal |
WordPress.cpp |
REST client + wordpress discovery delegate |
BuiltinPlugins.cpp |
discoverykit |
BrainstormIntegrations.cpp |
Lua + graphs export of journal |
SpeechCommands.cpp |
Early route for discovery |
SpeechCommandsHelp.cpp |
help discovery |
data/discoveries/ |
Runtime store |