mythik 0.1.4 → 0.2.0

package/dist/reveal/types.d.ts

@@ -0,0 +1,104 @@
+export type RevealRendererKind = 'react' | 'react-native' | 'server' | 'unknown';
+export type RevealRequestKind = 'context' | 'current' | 'screen' | 'element';
+export type RevealEventKind = 'action' | 'transaction' | 'dataSource' | 'renderError' | 'navigation' | 'lifecycle';
+export interface RevealRedactionPolicy {
+    sensitiveKeys?: string[];
+    includePaths?: string[];
+    redactPaths?: string[];
+}
+export interface RevealLimits {
+    maxBytes?: number;
+    maxEvents?: number;
+    maxStateValueBytes?: number;
+}
+export interface RevealContextRequestSummary {
+    kind: RevealRequestKind;
+    screenId?: string;
+    elementId?: string;
+}
+export interface RevealRuntimeSummary {
+    renderer: RevealRendererKind;
+    appName?: string;
+    dev: boolean;
+    url?: string;
+    platform?: string;
+}
+export interface RevealEnvironmentSummary {
+    id: string;
+    label?: string;
+    source: 'host' | 'store' | 'implicit';
+    storeKind?: string;
+    specId?: string;
+    loadedVersion?: number | string;
+    pointerVersion?: number | string;
+}
+export interface RevealSpecSummary {
+    root: string;
+    screenId?: string;
+    elementCount: number;
+    templateCount?: number;
+    dataSourceCount?: number;
+    editorSessionCount?: number;
+}
+export interface RevealElementSummary {
+    id: string;
+    type: string;
+    childIds: string[];
+    dependencies: string[];
+    resolvedProps?: Record<string, unknown>;
+    visible?: unknown;
+}
+export interface RevealStateSummary {
+    included: Record<string, unknown>;
+    omitted: string[];
+}
+export interface RevealDiagnosticsSummary {
+    renderErrors: unknown[];
+    warnings: string[];
+}
+export interface RevealEventSummary {
+    id: string;
+    kind: RevealEventKind;
+    at: string;
+    label: string;
+    status?: 'start' | 'success' | 'error' | 'rollback' | 'deferred';
+    details?: Record<string, unknown>;
+}
+export interface RevealPatchTarget {
+    canPatch: boolean;
+    screenId?: string;
+    environmentId?: string;
+    baseVersion?: number | string;
+    reason?: string;
+}
+export interface RevealRedactionSummary {
+    redactedPaths: string[];
+    redactedKeys: string[];
+}
+export interface RevealLimitsSummary {
+    maxBytes: number;
+    maxEvents: number;
+    truncated: boolean;
+    reason?: string;
+}
+export interface RevealContext {
+    kind: 'mythik.reveal.context';
+    schemaVersion: 1;
+    generatedAt: string;
+    request: RevealContextRequestSummary;
+    runtime: RevealRuntimeSummary;
+    environment: RevealEnvironmentSummary;
+    spec: RevealSpecSummary;
+    screen?: {
+        id: string;
+        root: string;
+    };
+    element?: RevealElementSummary;
+    state: RevealStateSummary;
+    diagnostics: RevealDiagnosticsSummary;
+    events: unknown[];
+    patchTarget: RevealPatchTarget;
+    redaction: RevealRedactionSummary;
+    limits: RevealLimitsSummary;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/reveal/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/reveal/types.ts"],"names":[],"mappings":"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"}

package/dist/reveal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/reveal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reveal/types.ts"],"names":[],"mappings":""}

package/dist/runtime/mount-spec-runtime.d.ts

@@ -1,3 +1,4 @@
+import { type DataSourcesObserver } from '../data/data-sources.js';
 import type { EditorSessionEngine } from '../editor-session/types.js';
 import type { Spec } from '../types.js';
 import type { StateStore } from '../state/store.js';
@@ -50,6 +51,10 @@ export interface MountSpecRuntimeDeps {
         json: () => Promise<unknown>;
     }>;
     urlGuard?: UrlGuard;
+    reveal?: RevealRuntimeHooks;
+}
+export interface RevealRuntimeHooks {
+    dataSources?: DataSourcesObserver;
 }
 export interface SpecRuntime {
     unmount: () => void;

package/dist/runtime/mount-spec-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-spec-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/mount-spec-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,wBAAwB,CAAC;IACrC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACzH,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,GAAG,WAAW,CA4EpF"}
+{"version":3,"file":"mount-spec-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/mount-spec-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAmD,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEpH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAG7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,wBAAwB,CAAC;IACrC,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IACzH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAoB,GAAG,WAAW,CA6EpF"}

package/dist/runtime/mount-spec-runtime.js

@@ -45,6 +45,7 @@ export function mountSpecRuntime(spec, deps) {
             resolver,
             dataSources: spec.dataSources,
             fetcher,
+            observer: deps.reveal?.dataSources,
         });
         // Register refreshDataSource action with the per-renderer dispatcher
         // (silent overwrite via Map.set — safe across re-mounts within same renderer).

package/dist/runtime/mount-spec-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"mount-spec-runtime.js","sourceRoot":"","sources":["../../src/runtime/mount-spec-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mount-spec-runtime.js","sourceRoot":"","sources":["../../src/runtime/mount-spec-runtime.ts"],"names":[],"mappings":"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"}

package/docs/consumer/README.md

@@ -15,6 +15,17 @@ Everything an AI or developer building apps with Mythik needs. **This is the pub
 | `reference-doc.md` | Full rule catalog — exhaustive consumer-facing reference |
 | `WHERE-TO-LOOK.md` | Source navigation map — which framework file to read for deep-customization or runtime-debugging cases the docs above do not fully cover. Fallback only; check the relevant `ai-context-*.md` first. |
 
+Mythik Reveal is documented in `ai-context.md` and `reference-doc.md`.
+For runtime debugging, agents should use Reveal before guessing from
+source files: it exposes the running app's live contract, selected
+state, events, diagnostics, and render errors as structured context.
+
+Mythik Agent Context and Agent Protocol are documented in `ai-context.md`
+and `reference-doc.md`. Fresh agents should run `mythik agent init ...`
+and `mythik agent context ...` before editing specs so the active store,
+required CLI loop, lint scope, TOON guidance, and local-file source-of-truth
+rules are explicit in the project.
+
 ## Reading order
 
 For first-time spec generation: `ai-context.md` is the entry point. It declares the other files as companion modules to read on demand.

package/docs/consumer/WHERE-TO-LOOK.md

@@ -16,14 +16,14 @@ This file maps **"I need to understand or customize X"** to which framework sour
 - Rule lookup → `reference-doc.md`.
 - ApiSpec / server contract surface → `ai-context-api.md`.
 - Runtime behavior reference (timing matrix, reserved state paths, store coordination) → `ai-context-runtime-semantics.md`. **Read this before reaching for source.**
-- Routine edits to an existing persisted spec. Use the CLI loop instead: `mythik manifest <id>` -> `mythik elements <id> <ids>` -> `mythik patch <id> --from-file patch.json` -> verify. Source reading is not a substitute for inspecting the live persisted spec.
+- Routine edits to an existing persisted spec. Use the CLI loop instead: `mythik manifest <id>` -> `mythik elements <id> <ids>` -> `mythik patch <id> --from-file patch.json --author <agent>` -> validate -> verify. Source reading is not a substitute for inspecting the live persisted spec.
 
 ## How source paths in this file work
 
 Paths are relative to the framework repo root and use the layout the framework publishes in.
 
 - **In the framework repo (or unpacked tarball):** `packages/<package>/src/<path>` — TypeScript source. Authoritative for behavior questions.
-- **In `node_modules/<public-mythik-package>/`:** the published artifact ships `dist/` only (compiled `.js` + `.d.ts`). `.d.ts` is enough for type-shape questions; for behavior questions, fetch the `src/` from the GitHub repo or the unpacked tarball. Public package names are unscoped (`mythik`, `mythik-react`, `mythik-cli`, and `mythik-server`). React Native work is a repository preview track, not part of the supported npm publish surface yet.
+- **In `node_modules/<public-mythik-package>/`:** the published artifact ships `dist/` only (compiled `.js` + `.d.ts`). `.d.ts` is enough for type-shape questions; for behavior questions, fetch the `src/` from the GitHub repo or the unpacked tarball. Public package names are unscoped (`mythik`, `mythik-react`, `mythik-cli`, `mythik-server`, and `mythik-react-native`). React Native support has an explicit primitive support matrix; do not assume unsupported web primitives render natively.
 
 When in doubt, prefer reading `src/`. `dist/` is generated and may obscure intent (minified, stripped comments, transpiled control flow).
 

package/docs/consumer/ai-context-runtime-semantics.md

@@ -375,7 +375,7 @@ The framework auto-tracks device context and writes to `/ui/device/*`:
 - `/ui/device/orientation` — `"portrait"` | `"landscape"` (updated on orientation change)
 - `/ui/device/colorScheme` — `"light"` | `"dark"` (OS color scheme)
 
-**Read pattern:** prefer the dedicated expressions `$breakpoint` (for responsive values), `$platform` (for cross-platform branching) over direct state reads. These expressions abstract over the paths and handle default fallbacks (reference-doc rule 37).
+**Read pattern:** prefer the dedicated expressions `$breakpoint` (for responsive values), `$platform` (for cross-platform branching) over direct state reads. These expressions abstract over the device paths and participate in render-cache invalidation (reference-doc rule 37). `$platform` matches exact platform keys first, falls back from `ios`/`android` to `native`, and resolves to `undefined` when no key matches; it does not have a `default` key.
 
 **Write-owner:** device context hook (React-side). Not configurable by consumer specs.
 
@@ -755,12 +755,12 @@ The persistence layer has distinct paths used at different levels. Understanding
 - **`store.save(id, doc)`** - low-level persistence primitive. Accepts `doc: unknown`. No validation. Called by validated orchestration after checks succeed. **Never called from application code** - treat as `@internal`. Calling `store.save()` from your app bypasses validation and produces silently-broken specs.
 - **`store.saveVersion(id, doc, meta)`** - versioned write. Writes a row to `screen_versions` table and updates the current spec. Enables diff/rollback/promote/bisect.
 - **`SpecEngine.patch(id, patches)`** - validated orchestration. Applies RFC-6902 patches, runs DocumentHandler validation, short-circuits on error, and persists the patched document through `store.save`.
-- **CLI/API `mythik push` / `runPush`** - validates and handles `--author` / `author` by writing through `saveVersion` when the resolved store is versioned.
-- **CLI/API `mythik patch` / `runPatch`** - uses `SpecEngine.patch` for patch application + validation. Without `author`, it persists through the normal `store.save` path. With a versioned store + `author`, it captures the patched document and writes once through `saveVersion`, so lazy bootstrap preserves the pre-patch current spec as v1 and the patch becomes the next version. JSON/TOON success output includes `versioned: boolean` and `version?: number`.
+- **CLI/API `mythik push` / `runPush`** - validates and handles `--author` / `author` by writing through `saveVersion` when the resolved store is versioned. Existing specs require explicit `--replace` for full replacement.
+- **CLI/API `mythik patch` / `runPatch`** - uses `SpecEngine.patch` for patch application + validation. With a versioned store + `author`, it captures the patched document and writes once through `saveVersion`, so lazy bootstrap preserves the pre-patch current spec as v1 and the patch becomes the next version. JSON/TOON success output includes `versioned: boolean` and `version?: number`. Without `author`, persisted writes are rejected unless `allowUnversioned` / `--allow-unversioned` is explicit.
 
 **Consumer rule (to be enforced by Item I linter):** never call `store.save()` from application code. Use:
 
-- `mythik push <id>` / `mythik patch <id>` for interactive/shell work
+- `mythik push <id> --from-file spec.json --author <name>` / `mythik patch <id> --from-file patch.json --author <name>` for interactive/shell work
 - `runPush` / `runPatch` from `mythik-cli/api` for programmatic work (Item F exposes these as public exports)
 
 Implementation:
@@ -810,14 +810,14 @@ The framework supports two axes of workflow choice: **how you modify specs** (pu
 **Push paradigm:**
 
 - Specs live in git under `specs/*.json`
-- Modify locally, run `mythik push <id>`, CLI sends the full spec doc to the DB
+- Modify locally, run `mythik push <id> --from-file spec.json --author <name>`, CLI sends the full spec doc to the DB
 - Diff-reviewable in CI (normal git diff on the JSON file)
 - Full-spec bandwidth cost per write
 
 **Patch paradigm:**
 
 - Specs live in the DB; local files are optional (working copy)
-- Modify via `mythik patch <id> --from-file patch.json` for shell-safe surgical writes
+- Modify via `mythik patch <id> --from-file patch.json --author <name>` for shell-safe surgical writes
 - ~11x token efficiency vs full push (framework-internal measurement for typical single-element edits)
 - Requires `mythik pull <id>` to sync any local `specs/*.json` snapshot after a DB patch
 
@@ -837,12 +837,15 @@ The framework supports two axes of workflow choice: **how you modify specs** (pu
 
 ### 6.2 Git-backed vs DB-versioned history
 
-**Git-backed history:**
-
-- Specs in repo, `git log` + `git blame` serve as audit trail
-- No `--author` flag needed on push/patch
-- CLI writes via `store.save` (unversioned path, see §5.4)
-- Best for: single-env apps, dev-loop iteration, specs-as-code
+**Git-backed history:**
+
+- Specs in repo, `git log` + `git blame` serve as audit trail
+- Persisted CLI writes must still be explicit: use `--author <name>`
+  whenever the resolved store supports versioning, or
+  `--allow-unversioned` only when the project intentionally uses a
+  non-versioned store
+- CLI writes via `store.save` only on the explicit unversioned path (see §5.4)
+- Best for: single-env apps, dev-loop iteration, specs-as-code
 
 **DB-versioned history:**
 

package/docs/consumer/ai-context.md

@@ -108,10 +108,17 @@ mythik init-store --dialect postgres --dry-run           # Print SQL store DDL f
 mythik init-store --dialect sqlserver --server localhost --database Mythik --user "$DB_USER" --password "$DB_PASSWORD" --encrypt false --trust-server-certificate
 mythik manifest <screen>               # See structural tree
 mythik elements <screen> <id1,id2>     # Get element details
-mythik patch <screen> --from-file patch.json  # Apply RFC 6902 patches
-mythik pull <screen>                    # Export full spec for backup/review
-mythik push <screen>                    # Create or intentionally replace a full spec
-mythik validate <screen>               # Validate spec
+mythik patch <screen> --from-file patch.json --author <agent>  # Apply versioned RFC 6902 patches
+mythik pull <screen>                    # Export full spec for backup/review
+mythik push <screen> --from-file spec.json --author <agent>  # Create a new spec
+mythik push <screen> --from-file spec.json --replace --author <agent>  # Intentional full replacement
+mythik validate <screen>               # Validate spec
+mythik reveal start                    # Start local runtime context bridge
+mythik reveal apps --json              # List connected running apps
+mythik reveal context --app <name>     # Read live app contract/state/diagnostics
+mythik reveal element <id> --app <name>  # Inspect one live element
+mythik agent init codex|claude|all      # Install project-local AI operating protocol
+mythik agent context --app <app-id> --include-screens --out .mythik/agent/context.md
 ```
 
 ### Required edit loop for existing specs
@@ -121,20 +128,76 @@ When an AI agent modifies an existing Mythik spec, use this loop by default:
 1. `mythik manifest <screen>` - inspect the current structure and identify candidate element IDs.
 2. `mythik elements <screen> <id1,id2,...>` - inspect only the exact elements and nearby containers that will change.
 3. Write a small RFC 6902 patch file.
-4. `mythik patch <screen> --from-file patch.json` - apply the surgical change through the validated CLI path.
-5. Re-run `mythik manifest <screen>` or `mythik elements <screen> <ids>` to verify the changed surface.
+4. `mythik patch <screen> --from-file patch.json --author <agent>` - apply the surgical change through the validated, versioned CLI path.
+5. Run `mythik validate <screen>`.
+6. Re-run `mythik manifest <screen>` or `mythik elements <screen> <ids>` to verify the changed surface.
+
+Do not edit database rows directly, do not call `SpecStore.save()` from app code, and do not replace a whole screen with `push` when a targeted `patch` can express the change. `pull` is for backup, migration, review, or full-spec creation workflows; it is not the normal first step for a small edit.
 
-Do not edit database rows directly, do not call `SpecStore.save()` from app code, and do not replace a whole screen with `push` when a targeted `patch` can express the change. `pull` is for backup, migration, review, or full-spec creation workflows; it is not the normal first step for a small edit.
+**Patch rules:** `"op": "add"` with numeric index **inserts before** (not replace). Use `/-` to append. Use `"op": "replace"` to overwrite. Prefer `mythik patch <id> --from-file patch.json --author <agent>` for any patch containing `$state`, `$template`, `$auth`, or other shell-sensitive strings.
 
-**Patch rules:** `"op": "add"` with numeric index **inserts before** (not replace). Use `/-` to append. Use `"op": "replace"` to overwrite. Prefer `mythik patch <id> --from-file patch.json` for any patch containing `$state`, `$template`, `$auth`, or other shell-sensitive strings.
-
-**Patch input precedence:** explicit sources win. `--from-file <path>` reads that file even if the host process has non-TTY stdin (common in PowerShell/agent runners). Stdin still works via `--from-file -` or by piping without `--from-file`: `cat patch.json | mythik patch <id>`.
+**Patch input precedence:** explicit sources win. `--from-file <path>` reads that file even if the host process has non-TTY stdin (common in PowerShell/agent runners). Stdin still works via `--from-file -` or by piping without `--from-file`: `cat patch.json | mythik patch <id> --author <agent>`.
 
 All commands accept `--json`, `--table <name>`, `--store`, `--url`, `--key`. Never pass API keys inline — use `.mythikrc` + env vars.
 
+### Mythik Reveal: live context for AI agents
+
+Use Mythik Reveal when debugging or changing a running app. Lint,
+validate, `manifest`, and `elements` inspect stored specs; Reveal
+inspects the live runtime. It exposes the active renderer, environment,
+mounted spec summary, selected screen/element, resolved public props,
+included state paths, render errors, warnings, and action/dataSource
+events as structured JSON.
+
+Start the local bridge:
+
+```bash
+mythik reveal start --port 17373
+```
+
+Pass the printed `MYTHIK_REVEAL_URL` and `MYTHIK_REVEAL_TOKEN` to the
+host app's `reveal` config. In React, memoize the object so the bridge
+client is stable:
+
+```tsx
+const reveal = React.useMemo(() => ({
+  enabled: import.meta.env.DEV,
+  appName: 'my-app',
+  bridgeUrl: import.meta.env.VITE_MYTHIK_REVEAL_URL,
+  token: import.meta.env.VITE_MYTHIK_REVEAL_TOKEN,
+  environment: { id: 'dev', source: 'host' as const },
+  includeStatePaths: ['/ui', '/form'],
+  redactStatePaths: ['/auth', '/secrets'],
+}), []);
+
+<MythikApp appSpec={appSpec} specStore={specStore} reveal={reveal} />
+```
+
+Then inspect the running app:
+
+```bash
+mythik reveal apps --json
+mythik reveal context --app my-app
+mythik reveal current --app my-app
+mythik reveal screen dashboard --app my-app
+mythik reveal element save-button --app my-app
+```
+
+For React Native Android emulator smoke, reverse the bridge port:
+
+```bash
+adb reverse tcp:17373 tcp:17373
+```
+
+Reveal is development tooling. Do not enable it in production, do not
+commit tokens, and expose only the state paths the agent needs.
+Redact auth, secrets, tokens, passwords, API keys, and session values.
+When a runtime symptom is visible but the cause is unknown, agents
+should ask Reveal before proposing a patch.
+
 ### CLI store configuration
 
-The CLI can read and write specs from `memory`, `file`, `supabase`, `sqlserver`, `postgres`, `mysql`, and `sqlite` stores. SQL stores share the same commands and the same required edit loop: `manifest -> elements -> patch -> validate`.
+The CLI can read and write specs from `memory`, `file`, `supabase`, `sqlserver`, `postgres`, `mysql`, and `sqlite` stores. SQL stores share the same commands and the same required edit loop: `manifest -> elements -> patch --from-file --author -> validate -> verify`.
 
 ```bash
 # SQLite: local development, tests, demos, lightweight deployments
@@ -166,11 +229,13 @@ Environment equivalents: `MYTHIK_STORE`, `MYTHIK_DATABASE_URL`, `MYTHIK_SQLITE_F
 
 Per reference-doc rule 248: three approved forms.
 
-- **Shell**: `mythik push <id> --from-file spec.json` and `mythik patch <id> --from-file patch.json` (cross-shell ergonomic for any spec/patch containing `$state`, `$template`, `$auth`, or `$row`)
-- **Bulk**: `mythik push --from-dir <folder>` — sequential per-file push of every `*.json`. Continue-on-error: failures don't stop subsequent specs. No rollback. Partial state recovers by fixing failures and re-running.
-- **Programmatic**: `import { runPush, runPatch, parsePatchInput, type PushResult } from 'mythik-cli/api'` — same code path as the binary, no shell. Pass `json: true` in options to receive structured command output via `JSON.parse(result.output)`. `runPatch` success output includes `versioned: boolean` and `version?: number` when a versioned store + `author` creates history.
-
-`SpecStore.save()` is `@internal` — calling it from application code skips validation and produces runtime errors only at render time. The three forms above are the only validated paths.
+- **Shell**: `mythik push <id> --from-file spec.json --author <agent>` and `mythik patch <id> --from-file patch.json --author <agent>` (cross-shell ergonomic for any spec/patch containing `$state`, `$template`, `$auth`, or `$row`)
+- **Bulk**: `mythik push --from-dir <folder> --author <agent>` — sequential per-file push of every `*.json`. Continue-on-error: failures don't stop subsequent specs. No rollback. Partial state recovers by fixing failures and re-running.
+- **Programmatic**: `import { runPush, runPatch, parsePatchInput, type PushResult } from 'mythik-cli/api'` — same code path as the binary, no shell. Pass `json: true` in options to receive structured command output via `JSON.parse(result.output)`. `runPatch` success output includes `versioned: boolean` and `version?: number` when a versioned store + `author` creates history.
+
+`SpecStore.save()` is `@internal` — calling it from application code skips validation and produces runtime errors only at render time. The three forms above are the only validated paths.
+
+Existing persisted specs are protected by the Agent Protocol: full replacements require `--replace`, and persisted writes require `--author <name>` for versioned stores or explicit `--allow-unversioned` for intentionally unversioned stores.
 
 ### Pre-push linting
 
@@ -271,18 +336,26 @@ Resolves by current platform. `"native"` alias matches ios and android. Specific
 - `$breakpoint`: Layout adaptation (columns, gaps, padding, direction) — same component, different sizing
 - `$platform`: Platform-specific techniques (CSS blur vs native BlurView, hover vs press, web sidebar vs native tabs) — different implementation, same feature
 
-**Root-level `$platform`** — for fundamentally different platform layouts:
+**Keep `root` stable.** The top-level `root` value is a string element id. Do not put `$platform` directly in `root`. For platform differences, branch at localized props/children/style points, or create separate screen specs when the platform experience is fundamentally different:
 ```json
 {
-  "root": { "$platform": { "web": "layout-web", "native": "layout-native" } },
+  "root": "layout",
   "elements": {
-    "layout-web": { "type": "stack", "style": { "backdropFilter": "blur(24px)" } },
-    "layout-native": { "type": "screen", "props": { "title": "Dashboard" } },
+    "layout": {
+      "type": "stack",
+      "props": {
+        "direction": { "$platform": { "web": "horizontal", "native": "vertical" } }
+      },
+      "style": {
+        "backdropFilter": { "$platform": { "web": "blur(24px)", "native": null } }
+      },
+      "children": ["shared-form"]
+    },
     "shared-form": { "type": "stack", "children": ["..."] }
   }
 }
 ```
-State, initialActions, and forms are shared — only presentation branches per platform.
+State, initialActions, and forms stay shared while only the presentation technique branches per platform.
 
 ### Math & Data
 
@@ -1448,12 +1521,12 @@ When the framework changes the schema in a future version, this section will gai
 82. Use `editorSessions.<id>.persistence` plus `editorSave` for generic editor document persistence. The AI should not hand-compose `transaction` + `editorMarkSaved` for normal editor saves. `editorSave` captures the tracked paths snapshot, persists it through the host fetcher with URL-guard checks, and marks only the sent snapshot as saved after success. Failed saves keep `dirty: true` and expose save metadata under `/ui/editorSessions/<id>`.
 83. Use `navigation.editorSessionGuard` for generic unsaved-changes protection in app specs instead of hand-rolled JSON dirty checks. Configure `sessions`, render your own JSON modal from `/ui/navigationGuard/pending`, call `navigationGuardCancel`, `navigationGuardSaveAndProceed`, `navigationGuardProceed`, or `navigationGuardDiscardAndProceed`, and keep `pendingPath` under a consumer-owned `/ui/<segment>` path that does not collide with reserved framework paths. `navigationGuardSaveAndProceed` is the normal save-first UX for persisted editor sessions; `navigationGuardProceed` is a low-level non-destructive retry that only resumes after the pending editor sessions are already clean; use `navigationGuardDiscardAndProceed` when the user explicitly chooses to abandon unsaved tracked-path changes.
 84. In React apps without auth framework fetch, pass `fetcher` to `MythikApp` when editor sessions use `editorSave` or `navigationGuardSaveAndProceed`. Auth-enabled apps continue to use the framework fetch produced by auth interceptors. Do not route save-and-continue through `/ui/lastError` or a hand-composed fetch action; the editor session engine owns save metadata under `/ui/editorSessions/<id>`.
-85. For existing spec edits, the required AI loop is `mythik manifest` -> `mythik elements` -> `mythik patch --from-file` -> verify. Manifest tells you the structure; elements gives the exact JSON you are changing; patch is the validated write path. Do not skip directly to full-spec `pull`/rewrite/push for a local change, do not mutate DB rows manually, and do not call `SpecStore.save()` from app code. Use `push` for new specs or intentional full replacement only.
+85. For existing spec edits, the required AI loop is `mythik manifest` -> `mythik elements` -> `mythik patch --from-file --author` -> `mythik validate` -> verify. Manifest tells you the structure; elements gives the exact JSON you are changing; patch is the validated write path. Do not skip directly to full-spec `pull`/rewrite/push for a local change, do not mutate DB rows manually, and do not call `SpecStore.save()` from app code. Use `push` for new specs or intentional full replacement only; existing specs require explicit `--replace`.
 86. Mythik's AI documentation ships with the `mythik` npm package. Before generating or modifying specs, locate it with `mythik docs path` and start from `docs/llms.txt`, `docs/consumer/ai-context.md`, and `docs/wiki/compiled/README.md`. Use `mythik docs copy ./mythik-docs` when a project-local copy is easier to hand to an AI agent.
 87. DNA numeric seeds (`roundness`, `density`, `depth`, `formality`) are canonical `0–1` values. Generate `0.7`, not `70`. The runtime tolerates legacy `0–100` values by normalizing any numeric seed greater than `1` with `/100` during DNA derivation, including initial AppSpec load and runtime `updateTokens`.
 88. API query endpoints can combine `pagination: "offset"` with `scopeFilter`. For generated counts, Mythik applies the scope filter to the source query before `COUNT(*)`, so paginated totals remain tenant-scoped. Prefer generated counts. If a custom `endpoint.count` is truly needed with `scopeFilter`, include `{{scopeWhere[:alias]}}` or `{{scopeAnd[:alias]}}`; Mythik expands the macro to the correct scope predicate and removes it for bypass roles. Other custom count SQL is left verbatim. Use `:alias` for JOIN/subquery counts, and do not reference internal scope params directly.
 89. Transaction `confirm` failures from `fetch` preserve backend error details for `onError`. Read `/tx/error/message` for the best available message; when the backend returns `{ error: { code, message } }`, Mythik keeps that message, `code`, HTTP `status`, and raw `data` after rollback. Do not parse `/ui/lastError` from transaction specs.
-90. For SQL-backed stores and servers, use the generic `mythik/server` SQL boundary. Initialize tables with `mythik init-store --dialect <sqlserver|postgres|mysql|sqlite>` or inspect DDL with `--dry-run`; configure the CLI with `--store`, `--url`/`--filename`/SQL Server flags, or `MYTHIK_*` environment variables; and keep spec edits on the required `manifest -> elements -> patch --from-file -> validate` loop. Write custom API SQL in the selected dialect with Mythik named params (`@name`); Mythik does not translate custom SQL between dialects.
+90. For SQL-backed stores and servers, use the generic `mythik/server` SQL boundary. Initialize tables with `mythik init-store --dialect <sqlserver|postgres|mysql|sqlite>` or inspect DDL with `--dry-run`; configure the CLI with `--store`, `--url`/`--filename`/SQL Server flags, or `MYTHIK_*` environment variables; and keep spec edits on the required `manifest -> elements -> patch --from-file --author -> validate -> verify` loop. Write custom API SQL in the selected dialect with Mythik named params (`@name`); Mythik does not translate custom SQL between dialects.
 91. Event arrays may mix normal actions and transaction bindings. Mythik executes them sequentially and awaits each transaction before continuing. Use this when a flow needs a small action before or after an optimistic transaction; do not wrap a transaction inside another transaction phase.
 92. `$ref` and `$template` placeholders can read nested values from `$let` object bindings with dot notation, for example `{ "$ref": "user.name" }` or `${user.name}`. If a dotted `$ref` segment is missing, runtime throws an unknown `$ref` error rather than silently returning undefined.
 93. Use `params.skipIf` for a dispatch-time action guard when an action should be skipped but the surrounding action chain should continue. `skipIf` is resolved before other params and is removed before the action handler runs. Do not use `skipIf` as a substitute for form validation or transaction rollback.
@@ -1461,3 +1534,6 @@ When the framework changes the schema in a future version, this section will gai
 95. `select.options` accepts strings, `{ label, value }` objects, or catalog-shaped objects when `labelKey` and `valueKey` are provided. Example: `{ "options": { "$state": "/cat/services/data" }, "labelKey": "name", "valueKey": "id" }`. Values are emitted as strings from `on.change`; malformed option data renders disabled diagnostics instead of blank clickable rows or crashes.
 96. SQL adapters are optional peer dependencies, not installed-by-default runtime payload. Browser-only apps install `mythik mythik-react` without database drivers. SQL-backed stores/servers must install exactly one selected adapter: `mssql`, `pg`, `mysql2`, or `better-sqlite3`. SQLite uses native `better-sqlite3`; native-build helper warnings from that adapter are not Mythik runtime failures.
 97. Missing SQL adapter errors are actionable. The thrown `SqlDriverError` includes `packageName`, `installCommand`, and a message with the exact `npm install ...` command for the selected dialect.
+98. For native Expo apps, install renderer peer packages with `npx expo install react-native-svg react-native-reanimated react-native-worklets ...` before installing `mythik mythik-react-native`, so Expo selects native module versions that match the app SDK. Keep `react-native-reanimated/plugin` last in the app Babel config. Keep `root` as a stable string element id; use `$platform` only inside localized props, style, children, or values. `$platform` matches exact platform keys first, then falls back from `ios`/`android` to `native`; it has no `default` key. Before using a primitive in native specs, check `REACT_NATIVE_PRIMITIVE_SUPPORT` or `getReactNativePrimitiveSupport` from `mythik-react-native`; native-milestone primitives should fail visibly instead of being treated as supported.
+99. Use Mythik Reveal before guessing about running-app behavior. Start `mythik reveal start`, wire the host `reveal` config in development, then inspect with `mythik reveal apps`, `context`, `current`, `screen`, or `element`. Reveal returns live renderer/environment/spec/state/diagnostics/events with redaction, so agents can diagnose runtime behavior from structured context instead of screenshots, stale pulled specs, or source-code assumptions. Never enable Reveal in production, never commit the token, and include/redact state paths deliberately.
+100. **Use Mythik Agent Context and Agent Protocol for fresh AI agents**. Run `mythik agent init codex`, `mythik agent init claude`, or `mythik agent init all` to install project-local agent instructions. `codex` creates/updates `AGENTS.md`, `claude` creates/updates `CLAUDE.md`, and `all` updates both; existing file content outside the Mythik-managed `<!-- mythik-agent-protocol:start -->` / `<!-- mythik-agent-protocol:end -->` block is preserved. Generate live project context with `mythik agent context --app <id> --include-screens --out .mythik/agent/context.md`. Existing stored specs stay on `manifest -> elements -> patch --from-file --author -> validate -> verify`. The active store is the source of truth; local spec files are drafts/snapshots/migrations/fixtures unless a file store is intentionally configured. Use TOON for large reads when supported, and use `mythik lint` for new local drafts, replacement files, bulk imports/migrations, and relevant consumer code changes.