openlogos merge

Scan delta files in a change proposal, map them to their target resource directories, and generate a MERGE_PROMPT.md that AI can read and execute.

Synopsis

openlogos merge <slug>

Arguments

Argument	Required	Description
`slug`	Yes	The change proposal slug (must exist in `logos/changes/`)

What it does

Scans logos/changes/<slug>/deltas/ for files organized by category
Maps each category to a target resource directory:

Delta category	Target directory
`deltas/prd/`	`logos/resources/prd/`
`deltas/api/`	`logos/resources/api/`
`deltas/database/`	`logos/resources/database/`
`deltas/scenario/`	`logos/resources/scenario/`

Reads proposal.md content for context
Generates logos/changes/<slug>/MERGE_PROMPT.md with structured merge instructions

Example output

📋 Merge Summary:
  - Change proposal: fix-redirect-bug
  - Delta files: 3
    deltas/prd/01-requirements-delta.md → logos/resources/prd/
    deltas/api/openapi-delta.yaml → logos/resources/api/
    deltas/scenario/S02-redirect-delta.json → logos/resources/scenario/

  ✓ logos/changes/fix-redirect-bug/MERGE_PROMPT.md

💡 Tell AI: "Read logos/changes/fix-redirect-bug/MERGE_PROMPT.md and execute merge"

After merge, run `openlogos archive fix-redirect-bug` to archive the proposal.

The generated MERGE_PROMPT.md

The prompt contains:

Proposal context — the full content of proposal.md
Delta file list — each delta with its source path, target directory, and action
Execution requirements for the AI:
- Process each delta file one by one
- Handle ADDED / MODIFIED / REMOVED markers
- Preserve original formatting and style
- Update timestamps
- Report a summary after each file
- Remind the user to run openlogos archive

Delta file format

Delta files use markers to indicate what should change in the target document:

## ADDED: Section Name
[New content to insert]

## MODIFIED: Section Name
[Replacement content for an existing section]

## REMOVED: Section Name
[This section should be deleted from the main document]

Errors

Error	Cause	Fix
`Missing change proposal name`	No slug provided	Provide a slug: `openlogos merge fix-redirect-bug`
`Change proposal 'X' not found`	No directory at `logos/changes/<slug>/`	Check spelling, or create with `openlogos change` first
`No delta files found`	`deltas/` is empty or only contains empty subdirectories	Add delta files to `deltas/prd/`, `deltas/api/`, etc. before running merge
`logos/logos.config.json not found`	Not in project root	`cd` to project root

change — Previous step: create the proposal and delta structure
archive — Next step: archive the proposal after AI executes the merge