Data Machine Editor

Editor integration extension for Data Machine. Inline diff visualization, accept/reject review workflow, and Gutenberg editor tools for AI-powered content editing.

What it does

When an AI agent edits post content through Data Machine, changes are presented as inline diffs inside the Gutenberg block editor. Each change shows word-level additions (<ins>) and removals (<del>) that the user can accept or reject individually.

Diff modes

Mode	Description
edit	Surgical text replacement within an existing block. Shows word-level changes.
write	Full block replacement. Shows before/after with word-level diff.
insert	New content added between existing blocks.

Review workflow

1. AI makes edits via Data Machine content abilities (edit-post-blocks, replace-post-blocks)
2. Changes appear as datamachine/diff blocks with inline <ins>/<del> tags
3. User reviews each change and clicks Accept or Reject
4. On resolution, the diff wrapper is removed and clean content remains
5. When all diffs are resolved, chat continuation fires automatically

Architecture

src/
  types.ts                  # Shared TypeScript types
  globals.d.ts              # WordPress global declarations
  diff/
    index.ts                # Block registration entry point
    edit.tsx                 # Block editor component
    save.tsx                 # Returns null (server-managed content)
    DiffRenderer.ts          # Applies <ins>/<del> tags to block content
    DiffActions.ts           # Accept/reject with DM REST API communication
    ContentUpdater.ts        # Surgical cleanup of diff tags on resolution
    FindDiffBlocks.ts        # Query utility for diff blocks in the editor
    HandleAcceptAll.ts       # Bulk accept/reject operations
    style.css                # Diff block styles
  editor/
    DiffTracker.ts           # Singleton state manager, wires to /chat/continue
    InlineDiffManager.tsx    # Applies backend diff wrappers to editor blocks

inc/
  Abilities/
    DiffAbilities.php        # datamachine/resolve-diff ability + REST endpoint
  Blocks/
    Diff/
      block.json             # Block metadata

Backend

REST endpoint

POST /datamachine/v1/editor/diff/resolve

Parameter	Type	Description
decision	'accepted' | 'rejected'	User's decision
diff_id	string	The diff block identifier
tool_call_id	string	Originating tool call
post_id	integer	Post being edited

Ability

datamachine/resolve-diff — registered via the WordPress Abilities API. Fires the datamachine_editor_diff_resolved action hook.

Context memory

Registers contexts/editor.md via the datamachine_default_context_files filter. This file is scaffolded once and then owned by the agent — editable in the Data Machine admin UI under Agent > Memory > Contexts.

Requirements

• WordPress 6.5+
• PHP 8.2+
• Data Machine plugin (core)

Development

npm install
npm run build       # Production build
npm run start       # Watch mode
npm run typecheck   # TypeScript type checking

Uses @wordpress/scripts with TypeScript support.

License

GPL v2 or later