Skip to content

feat: enrich SITE.md with structure, roles, plugin descriptions, REST namespaces#876

Merged
chubes4 merged 1 commit intomainfrom
feature/872-enrich-site-md
Mar 19, 2026
Merged

feat: enrich SITE.md with structure, roles, plugin descriptions, REST namespaces#876
chubes4 merged 1 commit intomainfrom
feature/872-enrich-site-md

Conversation

@chubes4
Copy link
Member

@chubes4 chubes4 commented Mar 19, 2026

Summary

Completes the SITE.md enrichment requested in #872. Builds on #875 (which added post counts, taxonomy details, language, timezone, permalinks).

  • Site Structure — key pages (front page, blog page, privacy page from wp_options), homepage display mode, registered nav menus with assigned menu names
  • User Roles — all roles listed, custom roles marked. Section only appears when custom roles exist.
  • Plugin descriptions — brief descriptions from plugin headers, truncated to 120 chars
  • REST API — custom namespaces (filters out wp/, oembed/, wp-site-health/)
  • New invalidation hookspage_on_front, page_for_posts, show_on_front option changes + menu CRUD hooks

Sample output

# SITE

## Identity
- **name:** chubes.net
- **url:** https://chubes.net
- **theme:** Chubes
- **language:** en_US
- **timezone:** America/Chicago
- **permalinks:** /%postname%/
- **multisite:** false

## Site Structure
- **Front page:** Home (ID 2)
- **Blog page:** Blog (ID 10)
- **Privacy page:** Privacy Policy (ID 3)
- **Homepage displays:** static page

### Menus
- **Primary Menu** (primary): Main Navigation
- **Footer Menu** (footer): Footer Links

## Post Types
| Label | Slug | Published | Type |
|-------|------|-----------|------|
| Posts | post | 42 | flat |
| Pages | page | 12 | hierarchical |

## Taxonomies
| Label | Slug | Terms | Type | Post Types |
|-------|------|-------|------|------------|
| Categories | category | 8 | hierarchical | post |
| Tags | post_tag | 24 | flat | post |

## User Roles
- Administrator (`administrator`)
- Editor (`editor`)
- Agent (`agent`) (custom)

## Active Plugins
- **FluentSMTP** — WP Mail SMTP plugin with various SMTP service integrations
- **DocSync** — Sync documentation from GitHub repositories to WordPress
- **Yoast SEO** — The first true all-in-one SEO solution for WordPress...

## REST API
- **Custom namespaces:** docsync/v1, datamachine/v1, yoast/v1

Testing

  • php -l passes
  • PHPUnit: 906 tests, same pass/fail as main

Closes #872.

… namespaces (#872)

Adds the remaining SITE.md enrichments beyond what SiteContext provided:

- Site Structure: key pages (front page, blog page, privacy page from
  wp_options), homepage display mode, registered nav menus with
  assigned menu names
- User Roles: lists all roles with custom role markers (only shown
  when custom roles exist)
- Plugin descriptions: truncated to 120 chars from plugin headers,
  shown inline after plugin name
- REST API: custom namespaces (excludes wp/, oembed/, wp-site-health/)

Also adds invalidation hooks for the new data sources:
- page_on_front, page_for_posts, show_on_front option changes
- wp_update_nav_menu, wp_delete_nav_menu, wp_update_nav_menu_item

Closes #872.
@github-actions
Copy link

github-actions bot commented Mar 19, 2026

Homeboy Results — data-machine

Lint

Failure Digest

Lint Failure Digest

Autofixability classification

  • Overall: human_needed
  • Autofix enabled: no
  • Autofix attempted this run: no
  • Human-needed failed commands:
    • lint
  • Failed commands with available automated fixes:
    • lint
  • Automated fixes are disabled for this step. Commands with available fix support in this run: lint

Machine-readable artifacts

  • homeboy-lint-summary.json
  • homeboy-test-failures.json
  • homeboy-audit-summary.json
  • homeboy-autofixability.json

⚡ Scope: changed files only

lint (changed files only)

Test

⚡ Scope: changed files only

test (changed files only)

Audit

⚡ Scope: changed files only

audit (changed files only)

Tooling versions
  • Homeboy CLI: homeboy 0.81.1+b97c8215
  • Extension: wordpress from https://github.com/Extra-Chill/homeboy-extensions
  • Extension revision: unknown
  • Action: Extra-Chill/homeboy-action@v1

Homeboy Action v1

@chubes4 chubes4 merged commit 4cc1108 into main Mar 19, 2026
2 of 3 checks passed
@chubes4 chubes4 deleted the feature/872-enrich-site-md branch March 19, 2026 03:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Enrich SITE.md with content stats, structure, and integration details

1 participant