# AI result review

> A batch of proposals drawn from the writer’s own material, each shown in place with its source and its own Use or Not needed.

Source: https://kwark.space/designSystem/components/ai-review

## Usage

### What it is
Where a batch of machine proposals is decided, one by one. Every row is something the [AI and authorship](https://kwark.space/designSystem/foundations/ai-and-authorship.md) *May* list allows: a heading moved from the writer’s outline beat, a phrase converted into the script the writer types in, a cast list carried onto a call sheet. Each row shows where it lands (*Scene 12*), what it is (*heading from your outline*), the words removed if any (struck, on `--k-danger-bg`) and the words proposed (wearing the revision mark), with its own answer.

### Rules of the decision
- **Per item, every time.** There is no *Accept all* for anything that reaches the script. *Not needed for all* is allowed: saying no in bulk changes nothing.
- **Use** puts the row into the work; the mark leaves the page and the origin stays in [history](https://kwark.space/designSystem/components/ai-undo-entry.md).
- **Not needed** (or *Keep Roman* for a conversion) leaves the page exactly as it was, and is remembered.
- **Changed since**: if the writer edited the place a proposal was made for, the row says so and offers only Not needed.
- The review never contains new dialogue, action or story, and never a verdict on the work (Decision 0002).

### When to use
- More than about five proposals at once, or proposals across several scenes.

### When not to use
- One or two proposals beside a scene: [Suggestion panel](https://kwark.space/designSystem/components/suggestion-panel.md).
- Anything issued to other people. A call sheet revision is reviewed as a draft; issuing stays its own act (Decision 0020).

### Writing
Header: count and scope, *3 proposals · Act 2*. No *improvements*, no summary of quality.

## Style

### Anatomy

1. **Panel**: `--k-surface`, 1px `--k-line`, 10px corners.
2. **Header**: 14px 600 title; *Not needed for all* quiet. No Use all.
3. **Row**: 12px 16px, 1px `--k-line` between rows; place line 12px `--k-text-2`; the proposal in the material’s own type (Courier Prime for script).
4. **Removed**: strike-through, `--k-danger` on `--k-danger-bg`. **Proposed**: `.kw-rev` tint and dotted rule.
5. **Reason**: 12px `--k-text-2`; a changed-since row shows a 14px warning glyph in `--k-warn`.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-surface` | #ffffff | #1a1a1a |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-text` | #0f172a | #e3e3e3 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-danger` | #b4382c | #e0685c |
| `--k-danger-bg` | #fbe9e7 | #321b19 |
| `--k-rev` | #346a58 | #9fd4bf |
| `--k-rev-bg` | #e4f1eb | #1b2b25 |
| `--k-rev-line` | #8cc3ae | #4f8a74 |
| `--k-warn` | #8a5a00 | #d8a44a |
| `--k-ok` | #2c6e49 | #6cc08a |
| `--k-font-screenplay` | 'Courier Prime', 'Courier New', monospace |  |
| `--k-radius-card` | 10px |  |
| `--k-fs-meta` | 12px |  |

## Code

### React

Use the HTML below with `kwark.css`. The example shows the markup and styling. Supply any application behavior described on this page.

### HTML and CSS

Works anywhere with `kwark.css`.

```html
<section class="kw-review" aria-label="Proposals to review">
  <header><h3>3 proposals · Act 2</h3><span class="kw-review__all"><button class="kw-button kw-button--sm kw-button--quiet" type="button">Not needed for all</button></span></header>
  <ol>
    <li class="kw-review__change"><span class="kw-review__where">Scene 12 · heading from your outline</span><p class="kw-review__diff"><ins class="kw-rev">INT. EDIT SUITE – NIGHT</ins></p><span class="kw-review__why">From the beat “Mira finds the splice in the edit suite, night.”</span><span class="kw-review__acts"><button class="kw-button kw-button--sm kw-button--quiet" type="button">Not needed</button><button class="kw-button kw-button--sm kw-button--primary" type="button">Use</button></span></li>
    <li class="kw-review__change"><span class="kw-review__where">Scene 14 · converted to Tamil</span><p class="kw-review__diff"><del>naan ingey irukken</del><ins class="kw-rev">நான் இங்கே இருக்கேன்</ins></p><span class="kw-review__acts"><button class="kw-button kw-button--sm kw-button--quiet" type="button">Keep Roman</button><button class="kw-button kw-button--sm kw-button--primary" type="button">Use</button></span></li>
    <li class="kw-review__change is-stale"><span class="kw-review__where">Scene 18 · heading from your outline</span><p class="kw-review__diff"><ins class="kw-rev">EXT. RAO FARM – DAWN</ins></p><span class="kw-review__why"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m21.7 18-8-14a2 2 0 0 0-3.5 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.7-3M12 9v4M12 17h.01"/></svg>This scene changed since. Review it again from the outline.</span><span class="kw-review__acts"><button class="kw-button kw-button--sm kw-button--quiet" type="button">Not needed</button></span></li>
  </ol>
</section>
```

## Accessibility

### Keyboard
| Key | Does |
|---|---|
| Tab | Each row’s Not needed, then Use. |
| Cmd + Z | Undoes the last decision while the review is open. |

### ARIA
- `<del>` and `<ins>` so screen readers announce deletion and insertion; hidden text *Suggested from your outline* or *Converted* on the insertion.
- Buttons name their row: *Use heading for Scene 12*. Announce *Added. 2 left.* politely.

## For agents

### Rules

- **Must** give every proposal its own Use and Not needed; never offer Accept all into the script.
- **Must** show removed and proposed words, with the source of each row.
- **Never** include new story words, rewritten dialogue or any judgement (Decision 0002).
- **Must** refuse to apply a proposal whose place changed since it was made.
- **Always** keep Undo for what was used.

### AI readiness test

**Task:** Review 12 headings Kwark proposed for Act 2 from the outline beats.

**Give the agent:** This page, Revision mark, AI undo history, Foundations › AI and authorship.

**Constraint:** The writer edited Scene 18 after the proposals were made.

**A reliable answer:**
- Shows 12 rows, each with its beat as the reason
- Has no Use all
- Marks Scene 18 as changed since and offers only Not needed
- Records each Use in history with Undo
