mythik 0.0.1 → 0.1.0

package/dist/versioning/structural-diff.js

@@ -0,0 +1,287 @@
+/**
+ * Compute a semantic structural diff between two specs.
+ * Type-aware: understands elements (screen/app), endpoints (api), navigation (app).
+ * Shows before/after values for all changes.
+ */
+export function computeStructuralDiff(before, after, fromVersion, toVersion) {
+    const changes = [];
+    const b = (before ?? {});
+    const a = (after ?? {});
+    const specType = detectSpecType(a) || detectSpecType(b) || 'screen';
+    // Diff elements (screen specs and app layout)
+    if (specType === 'screen' || specType === 'app') {
+        const bElements = getElements(b, specType);
+        const aElements = getElements(a, specType);
+        diffElements(bElements, aElements, changes);
+    }
+    // Diff API spec sub-items (endpoints, catalogs) at item level
+    if (specType === 'api') {
+        diffNamedItems(b, a, 'endpoints', changes);
+        diffNamedItems(b, a, 'catalogs', changes);
+    }
+    // Diff top-level sections (generic — for sections not handled above)
+    const sectionKeys = getSectionKeys(specType);
+    for (const key of sectionKeys) {
+        if (JSON.stringify(b[key]) !== JSON.stringify(a[key])) {
+            if (b[key] === undefined && a[key] !== undefined) {
+                changes.push({ kind: 'section-changed', path: key, detail: `"${key}" added` });
+            }
+            else if (b[key] !== undefined && a[key] === undefined) {
+                changes.push({ kind: 'section-changed', path: key, detail: `"${key}" removed` });
+            }
+            else {
+                changes.push({ kind: 'section-changed', path: key, detail: `"${key}" changed` });
+            }
+        }
+    }
+    return {
+        fromVersion,
+        toVersion,
+        changes,
+        summary: buildSummary(changes),
+    };
+}
+function detectSpecType(spec) {
+    const type = spec.type;
+    if (type === 'api')
+        return 'api';
+    if (type === 'app')
+        return 'app';
+    if (spec.elements || spec.root)
+        return 'screen';
+    return null;
+}
+function getElements(spec, specType) {
+    if (specType === 'app') {
+        const layout = spec.layout;
+        return (layout?.elements ?? {});
+    }
+    return (spec.elements ?? {});
+}
+function getSectionKeys(specType) {
+    switch (specType) {
+        case 'screen':
+            return ['dataSources', 'initialActions', 'forms', 'derive', 'templates', 'tokens', 'translations', 'globalStyles'];
+        case 'api':
+            return ['auth', 'handlers']; // endpoints and catalogs are diffed at item level
+        case 'app':
+            return ['navigation', 'screens', 'sharedState', 'tokens', 'translations', 'templates'];
+        default:
+            return [];
+    }
+}
+/** Format a value for display — short string for primitives, summary for objects */
+function fmtVal(value) {
+    if (value === undefined)
+        return 'undefined';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return `"${value.length > 60 ? value.slice(0, 57) + '...' : value}"`;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (Array.isArray(value))
+        return `[${value.length} items]`;
+    if (typeof value === 'object') {
+        const keys = Object.keys(value);
+        if (keys.length <= 3)
+            return `{${keys.join(', ')}}`;
+        return `{${keys.slice(0, 3).join(', ')}, ...${keys.length} keys}`;
+    }
+    return String(value);
+}
+/** Diff named sub-items within a section (e.g., endpoints, catalogs in api specs) */
+function diffNamedItems(before, after, sectionKey, changes) {
+    const bSection = (before[sectionKey] ?? {});
+    const aSection = (after[sectionKey] ?? {});
+    const bKeys = new Set(Object.keys(bSection));
+    const aKeys = new Set(Object.keys(aSection));
+    for (const name of aKeys) {
+        if (!bKeys.has(name)) {
+            const item = aSection[name];
+            const extra = item?.path && item?.method ? ` (${item.method} ${item.path})` : '';
+            changes.push({
+                kind: 'section-changed',
+                path: `${sectionKey}/${name}`,
+                detail: `${sectionKey} "${name}" added${extra}`,
+            });
+        }
+    }
+    for (const name of bKeys) {
+        if (!aKeys.has(name)) {
+            changes.push({
+                kind: 'section-changed',
+                path: `${sectionKey}/${name}`,
+                detail: `${sectionKey} "${name}" removed`,
+            });
+        }
+    }
+    for (const name of bKeys) {
+        if (!aKeys.has(name))
+            continue;
+        const bItem = bSection[name];
+        const aItem = aSection[name];
+        if (JSON.stringify(bItem) === JSON.stringify(aItem))
+            continue;
+        // Show which fields changed within the item
+        const fieldChanges = diffFields(bItem, aItem);
+        if (fieldChanges.length > 0) {
+            for (const fc of fieldChanges) {
+                changes.push({
+                    kind: 'section-changed',
+                    path: `${sectionKey}/${name}/${fc.field}`,
+                    detail: `${sectionKey} "${name}" ${fc.detail}`,
+                });
+            }
+        }
+        else {
+            changes.push({
+                kind: 'section-changed',
+                path: `${sectionKey}/${name}`,
+                detail: `${sectionKey} "${name}" changed`,
+            });
+        }
+    }
+}
+/** Diff fields within an object and return per-field change descriptions */
+function diffFields(before, after) {
+    const result = [];
+    const allKeys = new Set([...Object.keys(before), ...Object.keys(after)]);
+    for (const key of allKeys) {
+        const bVal = before[key];
+        const aVal = after[key];
+        if (JSON.stringify(bVal) === JSON.stringify(aVal))
+            continue;
+        if (bVal === undefined) {
+            result.push({ field: key, detail: `${key}: added ${fmtVal(aVal)}` });
+        }
+        else if (aVal === undefined) {
+            result.push({ field: key, detail: `${key}: removed (was ${fmtVal(bVal)})` });
+        }
+        else {
+            result.push({ field: key, detail: `${key}: ${fmtVal(bVal)} → ${fmtVal(aVal)}` });
+        }
+    }
+    return result;
+}
+function diffElements(before, after, changes) {
+    const bKeys = new Set(Object.keys(before));
+    const aKeys = new Set(Object.keys(after));
+    for (const id of aKeys) {
+        if (!bKeys.has(id)) {
+            const type = after[id].type ?? 'unknown';
+            changes.push({
+                kind: 'element-added',
+                elementId: id,
+                path: `elements/${id}`,
+                detail: `element "${id}" (${type}) added`,
+            });
+        }
+    }
+    for (const id of bKeys) {
+        if (!aKeys.has(id)) {
+            const type = before[id].type ?? 'unknown';
+            changes.push({
+                kind: 'element-removed',
+                elementId: id,
+                path: `elements/${id}`,
+                detail: `element "${id}" (${type}) removed`,
+            });
+        }
+    }
+    for (const id of bKeys) {
+        if (!aKeys.has(id))
+            continue;
+        const bEl = before[id];
+        const aEl = after[id];
+        if (JSON.stringify(bEl) === JSON.stringify(aEl))
+            continue;
+        // Collect all field-level changes for this element
+        const elementChanges = diffFields(bEl, aEl);
+        // For actions (on.*), show which events changed
+        const bOn = bEl.on;
+        const aOn = aEl.on;
+        if (JSON.stringify(bOn) !== JSON.stringify(aOn)) {
+            const onChanges = diffFields(bOn ?? {}, aOn ?? {});
+            for (const oc of onChanges) {
+                changes.push({
+                    kind: 'action-changed',
+                    elementId: id,
+                    path: `elements/${id}/on/${oc.field}`,
+                    detail: `element "${id}" on.${oc.detail}`,
+                });
+            }
+            // Don't double-report — remove 'on' from elementChanges
+            const remaining = elementChanges.filter(c => c.field !== 'on');
+            for (const rc of remaining) {
+                if (rc.field === 'props') {
+                    // Dig into props for specifics
+                    const propChanges = diffFields((bEl.props ?? {}), (aEl.props ?? {}));
+                    for (const pc of propChanges) {
+                        changes.push({
+                            kind: 'prop-changed',
+                            elementId: id,
+                            path: `elements/${id}/props/${pc.field}`,
+                            detail: `element "${id}" prop ${pc.detail}`,
+                        });
+                    }
+                }
+                else {
+                    changes.push({
+                        kind: 'prop-changed',
+                        elementId: id,
+                        path: `elements/${id}/${rc.field}`,
+                        detail: `element "${id}" ${rc.detail}`,
+                    });
+                }
+            }
+            continue;
+        }
+        // No action changes — report prop and other changes
+        for (const ec of elementChanges) {
+            if (ec.field === 'props') {
+                const propChanges = diffFields((bEl.props ?? {}), (aEl.props ?? {}));
+                for (const pc of propChanges) {
+                    changes.push({
+                        kind: 'prop-changed',
+                        elementId: id,
+                        path: `elements/${id}/props/${pc.field}`,
+                        detail: `element "${id}" prop ${pc.detail}`,
+                    });
+                }
+            }
+            else if (ec.field === 'type') {
+                changes.push({
+                    kind: 'prop-changed',
+                    elementId: id,
+                    path: `elements/${id}/type`,
+                    detail: `element "${id}" type: ${fmtVal(bEl.type)} → ${fmtVal(aEl.type)}`,
+                });
+            }
+            else {
+                changes.push({
+                    kind: 'prop-changed',
+                    elementId: id,
+                    path: `elements/${id}/${ec.field}`,
+                    detail: `element "${id}" ${ec.detail}`,
+                });
+            }
+        }
+    }
+}
+function buildSummary(changes) {
+    if (changes.length === 0)
+        return 'No changes';
+    const added = changes.filter(c => c.kind === 'element-added').length;
+    const removed = changes.filter(c => c.kind === 'element-removed').length;
+    const changed = changes.filter(c => c.kind !== 'element-added' && c.kind !== 'element-removed').length;
+    const parts = [];
+    if (added > 0)
+        parts.push(`+${added} element${added > 1 ? 's' : ''}`);
+    if (changed > 0)
+        parts.push(`~${changed} change${changed > 1 ? 's' : ''}`);
+    if (removed > 0)
+        parts.push(`-${removed} element${removed > 1 ? 's' : ''}`);
+    return parts.join(', ');
+}
+//# sourceMappingURL=structural-diff.js.map

package/dist/versioning/structural-diff.js.map

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

package/dist/versioning/types.d.ts

@@ -0,0 +1,90 @@
+import type { SpecStore } from '../spec-engine/types.js';
+import type { JsonPatch } from '../streaming/patch.js';
+import type { ValidationError } from '../security/spec-validator.js';
+export interface VersionMeta {
+    author: string;
+    source: 'push' | 'patch' | 'rollback' | 'promote';
+    description?: string;
+}
+export interface VersionEntry {
+    version: number;
+    timestamp: string;
+    author: string;
+    source: string;
+    description?: string;
+    isSnapshot: boolean;
+}
+/** Internal storage entry — includes patches or full spec */
+export interface VersionRecord extends VersionEntry {
+    patches?: JsonPatch[];
+    spec?: unknown;
+}
+export interface EnvironmentPointer {
+    name: string;
+    version: number;
+    promotedAt: string;
+    promotedBy: string;
+}
+export type StructuralChangeKind = 'element-added' | 'element-removed' | 'prop-changed' | 'action-changed' | 'section-changed';
+export interface StructuralChange {
+    kind: StructuralChangeKind;
+    elementId?: string;
+    path: string;
+    detail: string;
+}
+export interface StructuralDiff {
+    fromVersion: number;
+    toVersion: number;
+    changes: StructuralChange[];
+    summary: string;
+}
+export interface PromoteResult {
+    success: boolean;
+    specs: Array<{
+        id: string;
+        fromVersion: number;
+        toVersion: number;
+        diff: StructuralDiff;
+    }>;
+    environment: string;
+    validation: {
+        specValid: boolean;
+        crossScreenValid: boolean;
+        contractValid?: boolean;
+        contractSkipped?: boolean;
+        errors: ValidationError[];
+        warnings: ValidationError[];
+    };
+}
+export interface RollbackImpact {
+    lostChanges: Array<{
+        change: StructuralChange;
+        version: number;
+        author: string;
+    }>;
+    affectedEnvironments: Array<{
+        name: string;
+        currentVersion: number;
+        affected: boolean;
+    }>;
+}
+export interface RollbackResult {
+    success: boolean;
+    fromVersion: number;
+    toVersion: number;
+    newVersion: number;
+    impact: RollbackImpact;
+    errors?: ValidationError[];
+}
+export interface VersionedSpecStore extends SpecStore {
+    saveVersion(id: string, doc: unknown, meta: VersionMeta): Promise<number>;
+    loadVersion(id: string, version: number): Promise<unknown>;
+    listVersions(id: string, limit?: number): Promise<VersionEntry[]>;
+    currentVersion(id: string): Promise<number>;
+}
+export interface EnvironmentStore {
+    getEnvironments(specId: string): Promise<EnvironmentPointer[]>;
+    getEnvironment(specId: string, env: string): Promise<EnvironmentPointer | null>;
+    setEnvironment(specId: string, env: string, version: number, author: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/versioning/types.js

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

package/dist/versioning/types.js.map

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

package/dist/visibility/evaluator.d.ts

@@ -0,0 +1,12 @@
+import type { ResolveFn } from '../types.js';
+/**
+ * Evaluate a visibility expression. Supports:
+ * - boolean: true/false
+ * - single condition: { $state: "/path", eq: "value" }
+ * - array (implicit AND): [cond1, cond2]
+ * - $and: { $and: [cond1, cond2] }
+ * - $or: { $or: [cond1, cond2] }
+ * - nested: { $or: [{ $and: [c1, c2] }, c3] }
+ */
+export declare function evaluateVisibility(expr: unknown, resolve: ResolveFn): boolean;
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/visibility/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../src/visibility/evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,aAAa,CAAC;AA2C9D;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,SAAS,GACjB,OAAO,CA2BT"}

package/dist/visibility/evaluator.js

@@ -0,0 +1,76 @@
+/**
+ * Evaluates a single comparison condition.
+ * Supports: $state, $item, $index, $ref with eq/neq/gt/gte/lt/lte/not
+ */
+/** Comparison operator keys */
+const COMPARISON_KEYS = new Set(['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'not']);
+function evaluateSingle(condition, resolve) {
+    // Find the $-key that represents the value source
+    const exprKey = Object.keys(condition).find((k) => k.startsWith('$'));
+    let value;
+    if (exprKey) {
+        // Build an expression object with the $-key and non-comparison properties
+        const exprObj = {};
+        for (const [k, v] of Object.entries(condition)) {
+            if (!COMPARISON_KEYS.has(k)) {
+                exprObj[k] = v;
+            }
+        }
+        value = resolve(exprObj);
+    }
+    else {
+        value = condition;
+    }
+    // Apply comparison operators
+    let result;
+    if ('eq' in condition)
+        result = value === resolve(condition.eq);
+    else if ('neq' in condition)
+        result = value !== resolve(condition.neq);
+    else if ('gt' in condition)
+        result = value > resolve(condition.gt);
+    else if ('gte' in condition)
+        result = value >= resolve(condition.gte);
+    else if ('lt' in condition)
+        result = value < resolve(condition.lt);
+    else if ('lte' in condition)
+        result = value <= resolve(condition.lte);
+    else
+        result = Boolean(value);
+    return condition.not === true ? !result : result;
+}
+/**
+ * Evaluate a visibility expression. Supports:
+ * - boolean: true/false
+ * - single condition: { $state: "/path", eq: "value" }
+ * - array (implicit AND): [cond1, cond2]
+ * - $and: { $and: [cond1, cond2] }
+ * - $or: { $or: [cond1, cond2] }
+ * - nested: { $or: [{ $and: [c1, c2] }, c3] }
+ */
+export function evaluateVisibility(expr, resolve) {
+    if (expr === undefined || expr === null)
+        return true;
+    if (typeof expr === 'boolean')
+        return expr;
+    // Array = implicit AND
+    if (Array.isArray(expr)) {
+        return expr.every((item) => evaluateVisibility(item, resolve));
+    }
+    if (typeof expr !== 'object')
+        return Boolean(expr);
+    const obj = expr;
+    // $or
+    if ('$or' in obj) {
+        const conditions = obj.$or;
+        return conditions.some((c) => evaluateVisibility(c, resolve));
+    }
+    // $and
+    if ('$and' in obj) {
+        const conditions = obj.$and;
+        return conditions.every((c) => evaluateVisibility(c, resolve));
+    }
+    // Single comparison condition
+    return evaluateSingle(obj, resolve);
+}
+//# sourceMappingURL=evaluator.js.map

package/dist/visibility/evaluator.js.map

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

package/dist/watchers/engine.d.ts

@@ -0,0 +1,19 @@
+import type { StateStore } from '../state/store.js';
+import type { ActionBinding, ResolveFn } from '../types.js';
+export interface WatcherConfig {
+    /** JSON Pointer path → list of actions to trigger on change */
+    watch: Record<string, ActionBinding[]>;
+}
+export interface ActionDispatcher {
+    dispatch: (binding: ActionBinding, resolve: ResolveFn) => void | Promise<void>;
+}
+export interface WatcherEngine {
+    /** Start watching. Returns cleanup function. */
+    start: () => () => void;
+}
+/**
+ * Creates a watcher engine that subscribes to state paths
+ * and dispatches actions when values change.
+ */
+export declare function createWatcherEngine(store: StateStore, config: WatcherConfig, dispatcher: ActionDispatcher, resolve: ResolveFn): WatcherEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/watchers/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/watchers/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAED,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,EAAE,MAAM,MAAM,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,gBAAgB,EAC5B,OAAO,EAAE,SAAS,GACjB,aAAa,CAoBf"}

package/dist/watchers/engine.js

@@ -0,0 +1,24 @@
+/**
+ * Creates a watcher engine that subscribes to state paths
+ * and dispatches actions when values change.
+ */
+export function createWatcherEngine(store, config, dispatcher, resolve) {
+    function start() {
+        const cleanups = [];
+        for (const [path, bindings] of Object.entries(config.watch)) {
+            const unsub = store.subscribePath(path, () => {
+                // Fire all actions for this path sequentially
+                for (const binding of bindings) {
+                    dispatcher.dispatch(binding, resolve);
+                }
+            });
+            cleanups.push(unsub);
+        }
+        return () => {
+            for (const cleanup of cleanups)
+                cleanup();
+        };
+    }
+    return { start };
+}
+//# sourceMappingURL=engine.js.map

package/dist/watchers/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/watchers/engine.ts"],"names":[],"mappings":"AAiBA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAiB,EACjB,MAAqB,EACrB,UAA4B,EAC5B,OAAkB;IAElB,SAAS,KAAK;QACZ,MAAM,QAAQ,GAAmB,EAAE,CAAC;QAEpC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE;gBAC3C,8CAA8C;gBAC9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;QAED,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,OAAO,EAAE,CAAC;QAC5C,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/docs/consumer/README.md

@@ -0,0 +1,44 @@
+# Mythik — Consumer Documentation
+
+Everything an AI or developer building apps with Mythik needs. **This is the publish surface** — when Mythik publishes to a clean repo, this folder ships verbatim. Nothing outside `docs/consumer/` is part of the public framework distribution.
+
+## What's here
+
+| File | Purpose |
+|---|---|
+| `ai-context.md` | Core spec-gen reference — expressions, actions, primitives, transactions, forms, derive, dataSources, AppSpec, design tokens, versioning storage setup |
+| `ai-context-api.md` | ApiSpec server section — catalogs, endpoints, auth, audit |
+| `ai-context-custom-elements.md` | Layer 3 custom element authoring — ElementDefinition, variants, black-box contract |
+| `ai-context-patterns.md` | Composition patterns + anti-patterns when combining 2+ features |
+| `ai-context-primitives.md` | Per-primitive props tables (38 primitives) |
+| `ai-context-runtime-semantics.md` | Runtime behavior reference — expression timing, reserved state paths, server contracts, store coordination |
+| `reference-doc.md` | Full rule catalog (283 rules) — 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. |
+
+## 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.
+
+For full rule lookup: `reference-doc.md` is the comprehensive catalog.
+
+For deep customization or "why does X happen" debugging that the other files do not answer: `WHERE-TO-LOOK.md` maps question types to canonical framework source files.
+
+## Bucket criterion (where new docs go)
+
+A document goes in `docs/consumer/` if and only if **a consumer (AI or human) building apps with Mythik needs to read it to do their job**. Examples:
+
+- Spec syntax, primitives, expressions → `docs/consumer/`
+- Storage setup specs (e.g., versioning tables) → `docs/consumer/`
+
+A document goes in `docs/` (framework-dev / not in this folder) if it's only useful for **framework contributors, maintainers, or testers**:
+
+- Internal session notes, internal sweeps, audit reports → `docs/`
+- Framework roadmap, production-gaps analyses → `docs/`
+- Test scenarios + test results for framework validation → `docs/`
+- Marketing material, executive overviews → `docs/`
+- Design specs and implementation notes → internal docs
+- Internal feedback → internal docs
+
+## What's NOT here
+
+The framework's working repo keeps internals — session notes, design specs, implementation notes, feedback, analyses — at `docs/` (parent of this folder). That material does not publish.