# Provenance label

> Says where a proposal came from, in words, and stays with it until a person makes it their own.

Source: https://kwark.space/designSystem/components/provenance-label

## Usage

### What it is
The words that travel with a proposal and name its source, in the same order every time: **what happened** (Suggested, The script mentions, Converted), then **from where** (your outline, Act 2; Scene 12; Tamil). After a person accepts or edits it, the label leaves the page and a quiet history line keeps the origin.

| Form | Look | When |
|---|---|---|
| On the page | dashed pill in `--k-rev`, leading asterisk | while the proposal is still the machine’s |
| In history | quiet text with a glyph | after a person accepted or edited it |

### When to use
- On every proposal, found item, conversion or imported machine-made image (the storyboard pack’s *Imported image*), until a person makes it theirs.

### When not to use
- On the writer’s own words, ever. Kwark never labels human writing as human, and never shows *AI-written* on text a person has changed.
- As confidence. No percentages, no *high confidence*: a guess is labelled a guess.

### Writing
- Use Kwark’s names: *your outline, Act 2*, *Scene 12*, *Casting photos*. Never *AI-generated* or *Magic*.
- The breakdown’s own words are the model: *The script mentions*, *Read off the page, never assumed.*

## Style

### Anatomy

1. **Pill**: 22px tall, 0 8px, 999px corners, `--k-rev-bg`, `--k-rev` text, 1px dashed `--k-rev-line`, 12px Poppins 600, a leading asterisk (the margin mark of a revised script).
2. **History line**: 12px Poppins, `--k-text-2`, 14px glyph, no fill.

### Tokens

| Token | Light | Dark |
|---|---|---|
| `--k-rev` | #346a58 | #9fd4bf |
| `--k-rev-bg` | #e4f1eb | #1b2b25 |
| `--k-rev-line` | #8cc3ae | #4f8a74 |
| `--k-text-2` | #5b6779 | #9ca3af |
| `--k-line` | #e2e8f0 | rgba(255, 255, 255, .1) |
| `--k-radius-pill` | 999px |  |
| `--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
<span class="kw-rev-label">* Suggested · from your outline, Act 2</span>
<span class="kw-rev-label">* The script mentions · Scene 12</span>
<span class="kw-rev-label">* Converted · Tamil</span>
<span class="kw-prov"><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.2 6.8a1 1 0 0 0-4-4L3.8 16.2a2 2 0 0 0-.5.8l-1.3 4.4a.5.5 0 0 0 .6.6l4.4-1.3a2 2 0 0 0 .8-.5z"/></svg>Edited by Mira · from a suggestion</span>
<span class="kw-prov"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="8" y="8" width="14" height="14" rx="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/></svg>Imported image · storyboard pack</span>
```

## Accessibility

### Keyboard
Not interactive. If it opens details (when, from which file), make it a button named *Where this came from*.

### ARIA
- Link it to the proposal with `aria-describedby`. The asterisk is decoration; the words say *Suggested*.

## For agents

### Rules

- **Must** label every machine proposal with what happened and where from, until a person accepts or edits it.
- **Never** label a person’s writing, and never show confidence scores.
- **Never** use sparkles or the word *AI* as the label; name the source.
- **Always** keep the origin in history after acceptance.

### AI readiness test

**Task:** Label locations Kwark found in the screenplay for the Locations list.

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

**Constraint:** Two locations were inferred from action lines, not headings.

**A reliable answer:**
- Shows "* The script mentions · Scene 4" on items read from headings
- Says "inferred from the action" plainly on the two guesses
- Drops the pill once the location manager edits an item
- No percentages
