@researai/meos 0.1.0

package/SKILL/references/correction-policy.md

@@ -0,0 +1,22 @@
+# Correction Policy
+
+## Principle
+
+Corrections have the highest priority in MeOS maintenance.
+
+## What counts as a correction
+
+- explicit user rejection of a prior assumption
+- explicit refinement of a previous rule
+- explicit statement that a former pattern was overfit, too specific, or wrong
+
+## Correction behavior
+
+1. preserve the previous claim in `evidence/` if it matters historically
+2. write the new preferred rule into `assets/corrections/overrides.md`
+3. update the affected asset file if the correction is strong enough to replace the old rule
+4. do not leave two contradictory "active" rules without annotation
+
+## Output rule
+
+If a correction changes actual task behavior, mention that the active operating rule has been updated.

package/SKILL/references/extraction-sop.md

@@ -0,0 +1,76 @@
+# Extraction SOP
+
+## Goal
+
+Convert local history into stable, reusable operating assets without overfitting to noise.
+
+## Procedure
+
+1. Identify the source type.
+2. Extract only high-signal candidate facts.
+3. Classify each candidate into one of:
+   - work
+   - thought style
+   - workflow
+   - principles
+   - taste
+   - knowledge
+   - preferences
+   - corrections
+4. Decide whether the candidate belongs in:
+   - `evidence/`
+   - `assets/`
+5. Record confidence and source linkage.
+
+## Transcript-aware extraction
+
+When the source is a conversation or agent transcript, do not just summarize content.
+Extract this triple:
+
+1. user requirement or correction
+2. assistant behavior or output pattern
+3. user reaction:
+   - accepted
+   - corrected
+   - redirected
+   - unresolved
+
+This is critical because stable operating rules often come from:
+
+- repeated user corrections
+- repeated approval of a certain answer shape
+- repeated rejection of a certain framing mistake
+
+## High-signal extraction patterns
+
+- explicit constraints
+- repeated decision rules
+- repeated workflow sequences
+- repeated correction patterns
+- stable acceptance or rejection criteria
+- durable writing or UI taste
+- explicit audit output formats
+- explicit acceptance gates such as throughput, batch size, page count, or experiment count
+- repeated cross-layer requirements such as frontend/backend consistency
+
+## Low-signal patterns
+
+- one-off emotional phrasing
+- context-specific project details
+- temporary urgency language
+- tool chatter without reusable lesson
+- isolated casual approval with no reusable content
+- private identifiers that do not change future task behavior
+
+## Default stance
+
+Be conservative.
+It is better to keep a fact in `evidence/` than to promote a false rule into `assets/`.
+
+## Promotion bias by source type
+
+- explicit user instruction: high promotion priority
+- explicit user correction: highest promotion priority
+- repeated accepted pattern: medium promotion priority
+- assistant-only narration with no user response: low promotion priority
+- project-specific runtime detail: evidence-first, promote only if cross-project reusable

package/SKILL/references/import-policy.md

@@ -0,0 +1,35 @@
+# Import Policy
+
+## Goal
+
+Allow offline history import without forcing replay of the original interaction.
+
+## Supported import classes
+
+- archived agent conversations
+- local quest histories
+- local coding-assistant transcripts
+- user-provided document bundles
+- future communication exports explicitly approved by the owner
+
+## Import stages
+
+1. `discover`
+   - locate candidate source files
+2. `classify`
+   - identify source type and expected signal density
+3. `sanitize`
+   - remove or mask private secrets and unnecessary identifiers
+4. `stage`
+   - copy into `private/imported/` or `private/raw/`
+5. `extract`
+   - produce evidence candidates
+6. `promote`
+   - move only stable rules into `assets/`
+
+## Import rules
+
+- Do not promote directly from a raw import into `assets/`.
+- Keep original imported material local-only by default.
+- Record source provenance in `evidence/source-map.json`.
+- When two imports disagree, create a conflict record instead of forcing a merge.

package/SKILL/references/maintenance-policy.md

@@ -0,0 +1,56 @@
+# Maintenance Policy
+
+## Goal
+
+Keep MeOS evolving without turning it into a pile of duplicated prompts.
+
+## Maintenance actions
+
+- `add`
+- `merge`
+- `downgrade`
+- `discard`
+
+## Action rules
+
+### `add`
+
+Use when:
+
+- a truly new stable capability or rule appears
+- it does not overlap strongly with an existing asset
+
+### `merge`
+
+Use when:
+
+- new evidence strengthens or refines an existing asset
+- creating a second asset would cause duplication
+
+### `downgrade`
+
+Use when:
+
+- a formerly strong rule becomes uncertain
+- a newer correction weakens confidence
+
+Downgraded content should move back toward `evidence/` or be clearly marked as lower-confidence.
+
+### `discard`
+
+Use when:
+
+- the content was one-off noise
+- the content was superseded by correction
+- the content is too private or too context-specific to remain reusable
+
+## Versioning rule
+
+MeOS assets should evolve as maintained files, not as a growing pile of similar prompts.
+
+Preferred behavior:
+
+- revise the existing asset
+- preserve important evidence
+- append conflict history when needed
+- update timestamps and confidence

package/SKILL/references/privacy-policy.md

@@ -0,0 +1,39 @@
+# Privacy Policy
+
+## Core rule
+
+MeOS should preserve reusable working knowledge without leaking unnecessary private detail.
+
+## Do not promote by default
+
+- tokens
+- API keys
+- raw connector ids
+- personal contact ids
+- workstation-specific private paths when a semantic path is enough
+- copied private messages that are not required for the reusable rule
+
+## Safe defaults
+
+- prefer semantic labels over personal identifiers
+- prefer relative paths over personal absolute paths when possible
+- prefer summarized evidence over raw sensitive content
+
+## Commit boundary
+
+Default git-safe content:
+
+- `SKILL.md`
+- `references/`
+- `schemas/`
+- sanitized assets
+
+Default local-only content:
+
+- `private/`
+- `evidence/`
+- `runtime/`
+
+## Escalation rule
+
+If a detail is both sensitive and not essential to future reuse, exclude it.

package/SKILL/references/promotion-policy.md

@@ -0,0 +1,42 @@
+# Promotion Policy
+
+## Core principle
+
+Not every observed behavior should become a durable operating rule.
+
+## Promotion ladder
+
+### Stay in `evidence/`
+
+Keep a candidate in `evidence/` when:
+
+- it appears only once
+- it conflicts with later corrections
+- it depends on one narrow project context
+- it contains sensitive details that are not yet sanitized
+- the pattern is plausible but not yet stable
+
+### Promote to `assets/`
+
+Promote when at least one of these is true:
+
+- the user stated the rule explicitly
+- the same pattern appears repeatedly across independent contexts
+- the user later reinforced the same rule by correction or acceptance
+
+### Promote to `assets/corrections/`
+
+Use `corrections/` for:
+
+- explicit user reversals
+- explicit "not this, use that instead"
+- strong overrides that should outrank older inferences
+
+## Conflict handling
+
+When old and new evidence conflict:
+
+1. do not overwrite silently
+2. append a conflict record to `evidence/conflicts.jsonl`
+3. prefer explicit correction over implicit inference
+4. downgrade stale rules if needed

package/SKILL/references/source-locations.md

@@ -0,0 +1,93 @@
+# Source Locations
+
+Use this file to decide where MeOS may read from.
+
+## Priority order
+
+1. Existing MeOS assets and corrections
+2. Durable local project history and quest history
+3. Agent transcript history
+4. User-provided local documents
+5. Additional communication exports explicitly provided by the user
+
+## Default local source classes
+
+- local quest conversations
+- local agent transcripts
+- local project documentation
+- local correction notes
+
+## Recommended source families
+
+### A. Codex-style local sessions
+
+Typical location shape:
+
+- `$HOME/.codex/sessions/`
+
+Use these mainly for:
+
+- direct user instructions
+- durable preference and correction signals
+- accepted or rejected answer patterns
+
+### B. Claude Code local history
+
+Typical location shapes:
+
+- `$HOME/.claude/history.jsonl`
+- `$HOME/.claude/projects/**/*.jsonl`
+
+Use these mainly for:
+
+- user-side workflow and planning signals
+- structured audit expectations
+- implementation and verification habits
+- full `user` / `assistant` transcript pairs when available in project session logs
+
+### C. DeepScientist quest history
+
+Typical location shape:
+
+- `<DEEPSCIENTIST_HOME>/quests/*/.ds/`
+
+High-value files often include:
+
+- `conversations/main.jsonl`
+- `events.jsonl`
+- `interaction_journal.jsonl`
+- local run or history folders
+
+Use these mainly for:
+
+- research workflow patterns
+- continuation and interruption behavior
+- what kinds of progress updates the owner accepts or rejects
+- paper and experiment evidence-management habits
+
+## Reading rule
+
+Prefer owner-authored or owner-corrected material over generic assistant narration when both exist.
+
+Prefer:
+
+- explicit instructions
+- corrections
+- planning documents
+- review / decision notes
+
+When transcript pairs are available, distinguish:
+
+- what the user asked for
+- how the assistant responded
+- whether the user accepted, corrected, or redirected that response
+
+over:
+
+- generic progress chatter
+- one-off casual messages
+- low-signal acknowledgements
+
+## Privacy rule
+
+Raw imports and sensitive source material belong under `private/` and should not be committed by default.

package/SKILL/references/writeback-policy.md

@@ -0,0 +1,33 @@
+# Writeback Policy
+
+## Goal
+
+Keep MeOS assets current without turning every run into noisy profile churn.
+
+## When to write back
+
+Write back only when the new information is:
+
+- stable
+- reusable
+- task-relevant beyond the current moment
+
+## Where to write back
+
+- stable operating pattern -> `assets/`
+- explicit override -> `assets/corrections/`
+- uncertain fact -> `evidence/`
+- raw source material -> `private/`
+
+## Writeback steps
+
+1. identify the correct asset category
+2. sanitize the content
+3. record source linkage in `evidence/source-map.json`
+4. append fact or conflict records when needed
+5. only then update the asset file
+
+## Anti-pattern
+
+Do not dump session summaries directly into assets.
+Assets should hold durable rules, not raw narrative.

package/SKILL/runtime/README.md

@@ -0,0 +1,11 @@
+# Runtime Layer
+
+This directory is for local runtime state only.
+
+Examples of local files that may appear here later:
+
+- `imported.json`
+- temporary extraction state
+- maintenance checkpoints
+
+By default, this directory stays out of version control except for this README.

package/SKILL/schemas/asset-entry.schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MeOS Asset Entry",
+  "type": "object",
+  "required": [
+    "id",
+    "category",
+    "title",
+    "content",
+    "confidence",
+    "evidence_count",
+    "sources",
+    "last_confirmed_at"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "category": {
+      "type": "string"
+    },
+    "title": {
+      "type": "string"
+    },
+    "content": {
+      "type": "string"
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["low", "medium", "high"]
+    },
+    "evidence_count": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "last_confirmed_at": {
+      "type": "string"
+    },
+    "notes": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/SKILL/schemas/conflict-entry.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MeOS Conflict Entry",
+  "type": "object",
+  "required": [
+    "id",
+    "category",
+    "old_claim",
+    "new_claim",
+    "reason",
+    "created_at"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "category": {
+      "type": "string"
+    },
+    "old_claim": {
+      "type": "string"
+    },
+    "new_claim": {
+      "type": "string"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "created_at": {
+      "type": "string"
+    },
+    "resolved": {
+      "type": "boolean"
+    }
+  },
+  "additionalProperties": true
+}

package/SKILL/schemas/correction-entry.schema.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MeOS Correction Entry",
+  "type": "object",
+  "required": [
+    "id",
+    "target",
+    "old_claim",
+    "new_claim",
+    "reason",
+    "created_at"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "target": {
+      "type": "string"
+    },
+    "old_claim": {
+      "type": "string"
+    },
+    "new_claim": {
+      "type": "string"
+    },
+    "reason": {
+      "type": "string"
+    },
+    "created_at": {
+      "type": "string"
+    }
+  },
+  "additionalProperties": true
+}

package/SKILL/schemas/evidence-entry.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MeOS Evidence Entry",
+  "type": "object",
+  "required": [
+    "id",
+    "source",
+    "category",
+    "summary",
+    "created_at"
+  ],
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "source": {
+      "type": "string"
+    },
+    "category": {
+      "type": "string"
+    },
+    "summary": {
+      "type": "string"
+    },
+    "created_at": {
+      "type": "string"
+    },
+    "sensitive": {
+      "type": "boolean"
+    },
+    "confidence": {
+      "type": "string",
+      "enum": ["low", "medium", "high"]
+    }
+  },
+  "additionalProperties": true
+}

package/SKILL/schemas/source-map.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "MeOS Source Map",
+  "type": "object",
+  "patternProperties": {
+    ".*": {
+      "type": "object",
+      "properties": {
+        "source": {
+          "type": "string"
+        },
+        "category": {
+          "type": "string"
+        },
+        "imported_at": {
+          "type": "string"
+        },
+        "sensitive": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/assets/branding/logo.svg

@@ -0,0 +1,37 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="790" height="670" viewBox="-66 -56 790 670">
+<defs><filter id="haloBlur" x="-50%" y="-50%" width="200%" height="200%"><feGaussianBlur stdDeviation="6" result="blur" /><feMerge><feMergeNode in="blur" /><feMergeNode in="SourceGraphic" /></feMerge></filter></defs><g fill="#2f2f2f" fill-rule="evenodd">
+<g id="orbits"><g transform="matrix(1.000000 0.000000 -0.000000 1.000000 0.000 0.000)">
+<g transform="translate(80.000 199.000) rotate(148.944) scale(1.00000 1.00000) rotate(-148.944) translate(-80.000 -199.000)">
+<path d="M 76 233 L 78 241 L 81 247 L 86 252 L 89 252 L 93 246 L 99 223 L 106 208 L 111 201 L 122 190 L 134 182 L 156 173 L 177 168 L 191 167 L 192 166 L 203 166 L 204 165 L 229 165 L 230 166 L 257 167 L 258 168 L 283 170 L 284 171 L 290 171 L 302 174 L 313 175 L 366 188 L 404 201 L 437 215 L 440 214 L 440 212 L 423 195 L 393 176 L 368 164 L 329 150 L 304 144 L 274 140 L 273 139 L 265 139 L 264 138 L 240 137 L 239 136 L 201 136 L 200 137 L 189 137 L 188 138 L 174 139 L 144 146 L 122 155 L 104 167 L 92 179 L 85 189 L 80 199 L 76 212 Z" opacity="1.0000" />
+</g>
+</g>
+<g transform="matrix(1.000000 0.000000 -0.000000 1.000000 0.000 0.000)">
+<g transform="translate(586.000 331.000) rotate(-58.207) scale(1.00000 1.00000) rotate(58.207) translate(-586.000 -331.000)">
+<path d="M 463 147 L 461 149 L 461 168 L 462 169 L 462 180 L 463 181 L 463 233 L 462 234 L 461 253 L 456 276 L 450 293 L 434 320 L 414 342 L 393 360 L 393 362 L 403 362 L 422 356 L 438 348 L 457 334 L 471 319 L 479 307 L 489 286 L 490 280 L 493 273 L 496 257 L 498 230 L 497 229 L 496 206 L 493 193 L 494 189 L 507 204 L 521 225 L 526 236 L 528 238 L 537 259 L 546 290 L 548 308 L 549 309 L 549 332 L 545 352 L 538 369 L 538 375 L 543 377 L 558 372 L 569 365 L 578 355 L 582 347 L 586 331 L 586 302 L 585 301 L 585 295 L 581 275 L 573 252 L 565 235 L 551 212 L 534 190 L 517 173 L 503 162 L 486 152 L 471 147 Z M 492 189 L 493 188 L 494 189 L 493 190 Z" opacity="1.0000" />
+</g>
+</g>
+<g transform="matrix(1.000000 0.000000 -0.000000 1.000000 0.000 0.000)">
+<g transform="translate(648.000 338.000) rotate(-70.227) scale(1.00000 1.00000) rotate(70.227) translate(-648.000 -338.000)">
+<path d="M 647 319 L 644 309 L 633 291 L 620 279 L 612 274 L 603 271 L 599 273 L 599 279 L 607 301 L 609 310 L 609 330 L 605 343 L 599 353 L 589 364 L 572 376 L 551 387 L 517 399 L 489 406 L 459 410 L 458 411 L 440 412 L 439 413 L 424 413 L 423 414 L 386 414 L 385 413 L 357 412 L 356 411 L 349 411 L 348 410 L 341 410 L 340 409 L 333 409 L 332 408 L 314 406 L 282 399 L 279 399 L 278 403 L 282 409 L 289 415 L 298 421 L 317 430 L 347 439 L 373 443 L 374 444 L 393 445 L 394 446 L 409 446 L 410 447 L 450 446 L 451 445 L 462 445 L 463 444 L 478 443 L 479 442 L 511 437 L 544 428 L 583 413 L 604 401 L 622 387 L 633 375 L 640 364 L 644 355 L 648 338 Z" opacity="1.0000" />
+</g>
+</g>
+<g transform="matrix(1.000000 0.000000 -0.000000 1.000000 0.000 0.000)">
+<g transform="translate(19.000 346.000) rotate(80.065) scale(1.00000 1.00000) rotate(-80.065) translate(-19.000 -346.000)">
+<path d="M 367 234 L 362 230 L 356 228 L 328 222 L 295 220 L 294 219 L 255 219 L 254 220 L 241 220 L 240 221 L 222 222 L 221 223 L 215 223 L 214 224 L 188 228 L 172 233 L 161 235 L 127 246 L 95 259 L 70 272 L 50 285 L 31 303 L 22 318 L 19 329 L 19 346 L 22 356 L 29 368 L 41 380 L 48 385 L 60 391 L 69 393 L 73 389 L 62 368 L 57 353 L 58 335 L 63 325 L 75 312 L 87 303 L 99 296 L 126 283 L 159 270 L 162 270 L 177 264 L 221 252 L 251 246 L 257 246 L 258 245 L 285 242 L 286 241 L 308 240 L 309 239 L 327 239 L 328 238 L 352 238 L 353 237 L 358 238 L 359 237 L 364 237 Z" opacity="1.0000" />
+</g>
+</g>
+<g transform="matrix(1.000000 0.000000 -0.000000 1.000000 0.000 0.000)">
+<g transform="translate(80.000 358.000) rotate(84.548) scale(1.00000 1.00000) rotate(-84.548) translate(-80.000 -358.000)">
+<path d="M 100 309 L 89 320 L 82 332 L 79 345 L 80 358 L 86 376 L 94 392 L 121 432 L 136 450 L 167 481 L 203 509 L 231 526 L 251 536 L 266 541 L 271 541 L 272 542 L 278 541 L 282 536 L 282 527 L 260 490 L 243 456 L 232 427 L 228 408 L 228 386 L 229 385 L 230 375 L 238 355 L 256 326 L 257 320 L 248 321 L 238 326 L 224 336 L 208 353 L 200 365 L 192 384 L 189 399 L 189 414 L 190 415 L 191 426 L 198 446 L 204 458 L 216 475 L 214 477 L 193 460 L 165 432 L 148 411 L 135 392 L 122 367 L 118 351 L 118 343 L 120 333 L 127 318 L 144 296 L 146 291 L 137 291 L 127 294 L 110 302 Z M 216 478 L 217 477 L 218 478 L 217 479 Z M 215 477 L 216 476 L 217 477 L 216 478 Z" opacity="1.0000" />
+</g>
+</g>
+<g transform="matrix(1.000000 0.000000 -0.000000 1.000000 0.000 0.000)">
+<g transform="translate(519.000 502.000) rotate(-7.836) scale(1.00000 1.00000) rotate(7.836) translate(-519.000 -502.000)">
+<path d="M 553 445 L 550 441 L 547 440 L 535 442 L 521 450 L 501 470 L 483 482 L 458 492 L 444 495 L 437 495 L 436 496 L 408 496 L 407 495 L 399 495 L 372 489 L 347 480 L 315 465 L 312 465 L 312 468 L 316 475 L 327 486 L 349 502 L 375 516 L 400 525 L 418 529 L 433 530 L 434 531 L 452 531 L 453 530 L 460 530 L 470 528 L 486 523 L 500 516 L 519 502 L 531 489 L 544 471 L 551 457 L 551 454 L 553 450 Z" opacity="1.0000" />
+</g>
+</g>
+</g><g id="core" transform="translate(331.500 306.000) scale(1.00000) translate(-331.500 -306.000)"><path d="M 317 273 L 308 278 L 299 288 L 295 300 L 295 313 L 297 320 L 300 326 L 308 334 L 317 339 L 326 341 L 337 341 L 348 338 L 355 334 L 361 328 L 367 317 L 368 302 L 365 291 L 362 286 L 354 278 L 347 274 L 337 271 L 326 271 Z" />
+</g><path d="M 462 58 L 452 57 L 445 61 L 440 66 L 425 90 L 396 123 L 393 129 L 395 131 L 408 129 L 426 120 L 440 110 L 455 95 L 460 88 L 466 76 L 467 71 L 466 62 Z" fill="#B69B4A" />
+<path d="M 252 37 L 247 42 L 246 52 L 249 59 L 276 95 L 284 103 L 297 109 L 306 108 L 307 106 L 306 96 L 293 72 L 277 48 L 269 40 L 260 36 Z" fill="#B69B4A" />
+<path d="M 362 9 L 357 14 L 353 26 L 352 40 L 351 41 L 351 61 L 352 62 L 353 76 L 356 87 L 359 93 L 361 95 L 365 96 L 368 94 L 373 82 L 376 66 L 377 48 L 376 47 L 375 30 L 372 18 L 367 10 Z" fill="#B69B4A" />
+</g></svg>

package/assets/readme/00-overview.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 640" role="img" aria-label="MeOS overview placeholder">
+  <rect width="1200" height="640" fill="#F7F2EA"/>
+  <rect x="70" y="70" width="1060" height="500" rx="28" fill="#FFFFFF" stroke="#D6CEC1" stroke-width="3"/>
+  <text x="120" y="150" font-size="44" fill="#4F5B6D" font-family="Arial, sans-serif">MeOS Overview</text>
+  <text x="120" y="205" font-size="24" fill="#7A7A7A" font-family="Arial, sans-serif">Public core + local private layer + extraction and promotion flow</text>
+  <rect x="120" y="260" width="260" height="180" rx="22" fill="#ECE4D8"/>
+  <rect x="470" y="260" width="260" height="180" rx="22" fill="#E8EEDF"/>
+  <rect x="820" y="260" width="260" height="180" rx="22" fill="#E5E9F2"/>
+  <text x="160" y="320" font-size="26" fill="#4F5B6D" font-family="Arial, sans-serif">Public Core</text>
+  <text x="510" y="320" font-size="26" fill="#4F5B6D" font-family="Arial, sans-serif">Evidence Layer</text>
+  <text x="860" y="320" font-size="26" fill="#4F5B6D" font-family="Arial, sans-serif">Live Assets</text>
+  <text x="160" y="360" font-size="18" fill="#6F6F6F" font-family="Arial, sans-serif">SKILL/SKILL.md · references · schemas</text>
+  <text x="510" y="360" font-size="18" fill="#6F6F6F" font-family="Arial, sans-serif">candidate facts · conflicts · source map</text>
+  <text x="860" y="360" font-size="18" fill="#6F6F6F" font-family="Arial, sans-serif">promoted operating-layer assets</text>
+</svg>

package/assets/readme/01-lifecycle.svg

@@ -0,0 +1,11 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 360" role="img" aria-label="MeOS lifecycle placeholder">
+  <rect width="1200" height="360" fill="#F7F2EA"/>
+  <text x="80" y="90" font-size="40" fill="#4F5B6D" font-family="Arial, sans-serif">Lifecycle</text>
+  <g font-family="Arial, sans-serif" fill="#4F5B6D">
+    <rect x="80" y="150" width="180" height="90" rx="18" fill="#ECE4D8"/><text x="128" y="205" font-size="24">Collect</text>
+    <rect x="300" y="150" width="180" height="90" rx="18" fill="#E8EEDF"/><text x="352" y="205" font-size="24">Extract</text>
+    <rect x="520" y="150" width="180" height="90" rx="18" fill="#E5E9F2"/><text x="565" y="205" font-size="24">Promote</text>
+    <rect x="740" y="150" width="180" height="90" rx="18" fill="#ECE4D8"/><text x="792" y="205" font-size="24">Apply</text>
+    <rect x="960" y="150" width="180" height="90" rx="18" fill="#E8EEDF"/><text x="1000" y="205" font-size="24">Refresh</text>
+  </g>
+</svg>