altitude-design 0.2.0 → 0.3.0

package/dist/guidance/app-skeleton.md

@@ -0,0 +1,17 @@
+# App skeleton
+
+Start from the task: [screen layout](patterns/screen-layout.md) chooses a screen's frame from what the person came to do. This skeleton is the records frame, for finding, comparing and acting on many similar records; a focused editor, a decision or a report is laid out differently.
+
+A starting point for a records app, with Altitude's parts composed the way they're meant to be: copy it, then replace the data and the services. It's the Storybook preview "Patterns/AppSkeleton", and its source is `build/fixtures/patterns/app-skeleton.jsx` in the repository, type-checked against the public declarations.
+
+## What it composes
+
+- **The frame**: `AppShell` with a `Sidebar` of destinations (the current one on a raised pill) and a top bar with search. The shell is on the ground; nothing in it rises except what's pointed at.
+- **A list page**: `PageHeader` with the view's one primary action ("Add customer") and a secondary one; a `FilterBar`; a `DataTable` with selection (a counted action for the selected rows) and server pagination. Follow the [async collection](patterns/async-collection.md) contract for loading, empty and failure states.
+- **A record**: clicking a row opens it in a `Sheet` with a `PropertyList` whose values are edited in place. Closing the sheet returns focus to the row.
+- **Settings**: `SettingsSection` and `SettingsRow`, fields saved together with the `SaveBar`, and a switch that applies immediately. See the [settings](patterns/settings.md) contract.
+- **An empty view**: an `EmptyState` with its one action.
+
+## Rules it keeps
+
+One primary action per view (`ALT-VISUAL-002`); the single summit (only a dialog or sheet reaches the top level, one at a time); states that don't rise (`ALT-VISUAL-003`). `build/checks/app-skeleton.mjs` checks the composition in a browser: one primary per view, keyboard navigation through the sidebar, filtering, paging, selection, the sheet and its focus return, and the SaveBar. Replace its demo services with yours and keep those behaviours.

package/dist/guidance/evidence.json

@@ -0,0 +1,95 @@
+{
+  "schemaVersion": 1,
+  "sources": [
+    {
+      "id": "wcag22",
+      "authority": "normative-standard",
+      "title": "W3C WCAG 2.2",
+      "url": "https://www.w3.org/TR/WCAG22/",
+      "status": "published-standard",
+      "applicability": "Complete pages and processes; individual success criteria have distinct applicability and exceptions.",
+      "reviewed": "2026-10-23"
+    },
+    {
+      "id": "apg-dialog",
+      "authority": "contextual-pattern",
+      "title": "WAI-ARIA APG modal dialog",
+      "url": "https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/",
+      "status": "informative-guidance",
+      "applicability": "Modal dialogs; test supported browser and assistive-technology combinations.",
+      "reviewed": "2026-10-23"
+    },
+    {
+      "id": "govuk-validation",
+      "authority": "contextual-pattern",
+      "title": "GOV.UK validation",
+      "url": "https://design-system.service.gov.uk/patterns/validation/",
+      "status": "practice-guidance",
+      "applicability": "Service forms; earlier validation requires task-specific justification.",
+      "reviewed": "2026-10-23"
+    },
+    {
+      "id": "altitude-elevation",
+      "authority": "altitude-policy",
+      "title": "Altitude Elevation",
+      "url": "visual/Elevation.md",
+      "status": "implemented-policy",
+      "applicability": "Altitude visual language; not evidence of improved human performance.",
+      "reviewed": "2026-10-23"
+    },
+    {
+      "id": "task-review",
+      "authority": "heuristic",
+      "title": "Task-context review",
+      "url": "principles.md",
+      "status": "expert-judgment",
+      "applicability": "Actual audience, terminology and consequences require review.",
+      "reviewed": "2026-10-23"
+    },
+    {
+      "id": "hold-hypothesis",
+      "authority": "experimental-hypothesis",
+      "title": "Hold-to-confirm task benefit",
+      "url": "visual/Research.md",
+      "status": "unvalidated-hypothesis",
+      "applicability": "Scoped option only; no universal destructive-action mandate.",
+      "reviewed": "2026-10-23"
+    },
+    {
+      "id": "nng-toggle",
+      "authority": "contextual-pattern",
+      "title": "Nielsen Norman Group: toggle-switch guidelines",
+      "url": "https://www.nngroup.com/articles/toggle-switch-guidelines/",
+      "status": "practice-guidance",
+      "applicability": "Binary settings that take effect immediately; settings saved with a form use checkboxes or other controls submitted together.",
+      "reviewed": "2026-10-30"
+    },
+    {
+      "id": "owasp-auth",
+      "authority": "contextual-pattern",
+      "title": "OWASP Authentication Cheat Sheet",
+      "url": "https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html",
+      "status": "practice-guidance",
+      "applicability": "Authentication responses, error messages and rate limiting; implementation security remains the application's.",
+      "reviewed": "2026-10-30"
+    },
+    {
+      "id": "altitude-fundamentals",
+      "authority": "altitude-policy",
+      "title": "Altitude Fundamentals",
+      "url": "visual/Fundamentals.md",
+      "status": "implemented-policy",
+      "applicability": "The established design laws generated interfaces break, and the Altitude rule that answers each; not evidence of improved human performance.",
+      "reviewed": "2026-11-01"
+    },
+    {
+      "id": "deceptive-patterns-llm",
+      "authority": "heuristic",
+      "title": "Deceptive designs in LLM-generated interfaces (Chen et al., arXiv 2502.13499; Krauß et al., CHI 2025)",
+      "url": "https://arxiv.org/abs/2502.13499v1",
+      "status": "research-preprint",
+      "applicability": "Ecommerce and sign-up components generated by language models; prevalence findings, not a complete taxonomy.",
+      "reviewed": "2026-11-01"
+    }
+  ]
+}

package/dist/guidance/index.json

@@ -0,0 +1,493 @@
+{
+  "schemaVersion": 1,
+  "package": "altitude-design",
+  "version": "0.3.0",
+  "entry": "README.md",
+  "patterns": [
+    {
+      "id": "agent-action",
+      "title": "Agent action",
+      "intents": [
+        "agent",
+        "ai assistant",
+        "assistant",
+        "tool approval",
+        "human in the loop",
+        "copilot",
+        "ai action"
+      ],
+      "purpose": "Let an agent propose, wait for approval, run, recover and leave provenance, with each state drawn as one reading.",
+      "document": "patterns/agent-action.md",
+      "metadata": "patterns/agent-action.json",
+      "rules": [
+        "ALT-AGENT-001",
+        "ALT-ACTION-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "assistant-conversation",
+      "title": "Assistant conversation",
+      "intents": [
+        "chat",
+        "assistant",
+        "copilot",
+        "chatbot",
+        "agent conversation",
+        "ai chat"
+      ],
+      "purpose": "Send, stream, stop, retry and recover in a conversation with an assistant, without losing the person's words or claiming an answer is complete before it is.",
+      "document": "patterns/assistant-conversation.md",
+      "metadata": "patterns/assistant-conversation.json",
+      "rules": [
+        "ALT-CONVO-001",
+        "ALT-AGENT-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "async-collection",
+      "title": "Async collection",
+      "intents": [
+        "search",
+        "filter",
+        "browse",
+        "list",
+        "records",
+        "collection"
+      ],
+      "purpose": "Find records while understanding loading, empty and failure states.",
+      "document": "patterns/async-collection.md",
+      "metadata": "patterns/async-collection.json",
+      "rules": [
+        "ALT-COLLECTION-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-001"
+      ]
+    },
+    {
+      "id": "audit-log",
+      "title": "Audit log",
+      "intents": [
+        "audit log",
+        "audit",
+        "activity",
+        "history",
+        "events",
+        "security log"
+      ],
+      "purpose": "Find who did what, to which resource, when and from where, and export it.",
+      "document": "patterns/audit-log.md",
+      "metadata": "patterns/audit-log.json",
+      "rules": [
+        "ALT-AUDIT-001",
+        "ALT-COLLECTION-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "auth",
+      "title": "Auth",
+      "intents": [
+        "sign in",
+        "login",
+        "log in",
+        "sign up",
+        "signup",
+        "register",
+        "two-factor",
+        "2fa",
+        "mfa",
+        "reset password",
+        "forgot password",
+        "magic link",
+        "sso"
+      ],
+      "purpose": "Sign in, sign up, verify, pass two-factor and reset a password without revealing whether an account exists.",
+      "document": "patterns/auth.md",
+      "metadata": "patterns/auth.json",
+      "rules": [
+        "ALT-AUTH-001",
+        "ALT-EDIT-002",
+        "ALT-STATUS-001"
+      ]
+    },
+    {
+      "id": "billing",
+      "title": "Billing",
+      "intents": [
+        "billing",
+        "change plan",
+        "upgrade",
+        "downgrade",
+        "usage",
+        "invoices",
+        "subscription",
+        "pricing"
+      ],
+      "purpose": "Show usage against limits as readings and change plan with the cost reviewed before it's confirmed.",
+      "document": "patterns/billing.md",
+      "metadata": "patterns/billing.json",
+      "rules": [
+        "ALT-BILLING-001",
+        "ALT-REVIEW-001",
+        "ALT-ACTION-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "consequential-action",
+      "title": "Consequential action",
+      "intents": [
+        "delete",
+        "remove",
+        "revoke",
+        "publish",
+        "undo",
+        "recover",
+        "approve"
+      ],
+      "purpose": "Complete a consequential operation with appropriate review or real recovery.",
+      "document": "patterns/consequential-action.md",
+      "metadata": "patterns/consequential-action.json",
+      "rules": [
+        "ALT-ACTION-001",
+        "ALT-STATUS-001",
+        "ALT-EXP-001"
+      ]
+    },
+    {
+      "id": "developer-settings",
+      "title": "Developer settings",
+      "intents": [
+        "api keys",
+        "api key",
+        "webhooks",
+        "webhook",
+        "integrations",
+        "developer settings",
+        "developers",
+        "oauth"
+      ],
+      "purpose": "Create, roll and revoke API keys, manage webhooks and connect integrations without treating them as ordinary forms.",
+      "document": "patterns/developer-settings.md",
+      "metadata": "patterns/developer-settings.json",
+      "rules": [
+        "ALT-DEV-001",
+        "ALT-ACTION-001",
+        "ALT-STATUS-001"
+      ]
+    },
+    {
+      "id": "edit-record",
+      "title": "Edit record",
+      "intents": [
+        "edit",
+        "settings",
+        "form",
+        "save",
+        "record",
+        "profile"
+      ],
+      "purpose": "Edit a durable record without losing work.",
+      "document": "patterns/edit-record.md",
+      "metadata": "patterns/edit-record.json",
+      "rules": [
+        "ALT-EDIT-001",
+        "ALT-EDIT-002",
+        "ALT-EDIT-003",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-001"
+      ]
+    },
+    {
+      "id": "import",
+      "title": "Import",
+      "intents": [
+        "import",
+        "upload csv",
+        "csv",
+        "bulk import",
+        "map columns",
+        "spreadsheet upload"
+      ],
+      "purpose": "Upload a file, map its columns, fix the rows with problems, review and import with a receipt.",
+      "document": "patterns/import.md",
+      "metadata": "patterns/import.json",
+      "rules": [
+        "ALT-IMPORT-001",
+        "ALT-REVIEW-001",
+        "ALT-STATUS-001"
+      ]
+    },
+    {
+      "id": "members",
+      "title": "Members",
+      "intents": [
+        "members",
+        "invite teammates",
+        "invite",
+        "roles",
+        "permissions",
+        "team"
+      ],
+      "purpose": "Invite people, change roles and remove access without misdrawing invitations or breaking ownership.",
+      "document": "patterns/members.md",
+      "metadata": "patterns/members.json",
+      "rules": [
+        "ALT-MEMBERS-001",
+        "ALT-ACTION-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "onboarding",
+      "title": "Onboarding",
+      "intents": [
+        "onboarding",
+        "getting started",
+        "setup checklist",
+        "product tour",
+        "tour",
+        "what's new",
+        "whats new",
+        "first run",
+        "empty state"
+      ],
+      "purpose": "Get someone new to value with a stamped setup checklist, empty states before tours, and what's new.",
+      "document": "patterns/onboarding.md",
+      "metadata": "patterns/onboarding.json",
+      "rules": [
+        "ALT-ONBOARD-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "review-submit",
+      "title": "Review and submit",
+      "intents": [
+        "review",
+        "submit",
+        "process",
+        "application",
+        "wizard",
+        "answers"
+      ],
+      "purpose": "Review and correct answers before final commitment.",
+      "document": "patterns/review-submit.md",
+      "metadata": "patterns/review-submit.json",
+      "rules": [
+        "ALT-REVIEW-001",
+        "ALT-EDIT-001",
+        "ALT-EDIT-002",
+        "ALT-STATUS-001"
+      ]
+    },
+    {
+      "id": "screen-layout",
+      "title": "Screen layout",
+      "intents": [
+        "screen layout",
+        "page layout",
+        "new screen",
+        "new page",
+        "compose a screen",
+        "dashboard",
+        "focused editor",
+        "approve",
+        "approval",
+        "report",
+        "triage",
+        "inbox",
+        "setup flow"
+      ],
+      "purpose": "Choose a screen's frame from the person's task, the one thing that leads and the one primary action, instead of inheriting a sidebar, a top bar and a grid of cards.",
+      "document": "patterns/screen-layout.md",
+      "metadata": "patterns/screen-layout.json",
+      "rules": [
+        "ALT-LAYOUT-001",
+        "ALT-VISUAL-002",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "settings",
+      "title": "Settings",
+      "intents": [
+        "settings",
+        "preferences",
+        "workspace settings",
+        "account settings",
+        "danger zone"
+      ],
+      "purpose": "Change how a workspace or account behaves, deciding per section whether changes apply now or save together.",
+      "document": "patterns/settings.md",
+      "metadata": "patterns/settings.json",
+      "rules": [
+        "ALT-SETTINGS-001",
+        "ALT-EDIT-001",
+        "ALT-EDIT-002",
+        "ALT-ACTION-001",
+        "ALT-STATUS-001",
+        "ALT-VISUAL-003"
+      ]
+    },
+    {
+      "id": "sync",
+      "title": "Sync",
+      "intents": [
+        "autosave",
+        "offline",
+        "sync",
+        "conflict",
+        "session timeout",
+        "session expiry",
+        "local-first",
+        "optimistic"
+      ],
+      "purpose": "Say truthfully what has reached the server, through offline queues, conflicts and expiring sessions.",
+      "document": "patterns/sync.md",
+      "metadata": "patterns/sync.json",
+      "rules": [
+        "ALT-SYNC-001",
+        "ALT-EDIT-001",
+        "ALT-STATUS-001"
+      ]
+    }
+  ],
+  "references": {
+    "build/checks/agent-action-pattern.mjs": "references/build/checks/agent-action-pattern.mjs",
+    "build/checks/agent-setup.mjs": "references/build/checks/agent-setup.mjs",
+    "build/checks/assistant-conversation-pattern.mjs": "references/build/checks/assistant-conversation-pattern.mjs",
+    "build/checks/audit-log-pattern.mjs": "references/build/checks/audit-log-pattern.mjs",
+    "build/checks/auth-pattern.mjs": "references/build/checks/auth-pattern.mjs",
+    "build/checks/billing-pattern.mjs": "references/build/checks/billing-pattern.mjs",
+    "build/checks/developer-settings-pattern.mjs": "references/build/checks/developer-settings-pattern.mjs",
+    "build/checks/guidance.mjs": "references/build/checks/guidance.mjs",
+    "build/checks/import-pattern.mjs": "references/build/checks/import-pattern.mjs",
+    "build/checks/members-pattern.mjs": "references/build/checks/members-pattern.mjs",
+    "build/checks/onboarding-pattern.mjs": "references/build/checks/onboarding-pattern.mjs",
+    "build/checks/pattern-types.mjs": "references/build/checks/pattern-types.mjs",
+    "build/checks/pattern-workflows.mjs": "references/build/checks/pattern-workflows.mjs",
+    "build/checks/primary-scope.mjs": "references/build/checks/primary-scope.mjs",
+    "build/checks/render-tells.mjs": "references/build/checks/render-tells.mjs",
+    "build/checks/screen-layout-pattern.mjs": "references/build/checks/screen-layout-pattern.mjs",
+    "build/checks/semantics.mjs": "references/build/checks/semantics.mjs",
+    "build/checks/settings-pattern.mjs": "references/build/checks/settings-pattern.mjs",
+    "build/checks/sync-pattern.mjs": "references/build/checks/sync-pattern.mjs",
+    "build/checks/tells-lint.mjs": "references/build/checks/tells-lint.mjs",
+    "build/fixtures/pattern-workflows.tsx": "references/build/fixtures/pattern-workflows.tsx",
+    "build/fixtures/patterns/agent-action.jsx": "references/build/fixtures/patterns/agent-action.jsx",
+    "build/fixtures/patterns/app-skeleton.jsx": "references/build/fixtures/patterns/app-skeleton.jsx",
+    "build/fixtures/patterns/assistant-conversation.jsx": "references/build/fixtures/patterns/assistant-conversation.jsx",
+    "build/fixtures/patterns/audit-log.jsx": "references/build/fixtures/patterns/audit-log.jsx",
+    "build/fixtures/patterns/auth.jsx": "references/build/fixtures/patterns/auth.jsx",
+    "build/fixtures/patterns/billing.jsx": "references/build/fixtures/patterns/billing.jsx",
+    "build/fixtures/patterns/developer-settings.jsx": "references/build/fixtures/patterns/developer-settings.jsx",
+    "build/fixtures/patterns/import.jsx": "references/build/fixtures/patterns/import.jsx",
+    "build/fixtures/patterns/members.jsx": "references/build/fixtures/patterns/members.jsx",
+    "build/fixtures/patterns/onboarding.jsx": "references/build/fixtures/patterns/onboarding.jsx",
+    "build/fixtures/patterns/screen-layout-decision.jsx": "references/build/fixtures/patterns/screen-layout-decision.jsx",
+    "build/fixtures/patterns/screen-layout-editor.jsx": "references/build/fixtures/patterns/screen-layout-editor.jsx",
+    "build/fixtures/patterns/screen-layout-report.jsx": "references/build/fixtures/patterns/screen-layout-report.jsx",
+    "build/fixtures/patterns/settings.jsx": "references/build/fixtures/patterns/settings.jsx",
+    "build/fixtures/patterns/sync.jsx": "references/build/fixtures/patterns/sync.jsx",
+    "project/components/src/pattern-async-collection.tsx": "references/project/components/src/pattern-async-collection.tsx",
+    "project/components/src/pattern-consequential-action.tsx": "references/project/components/src/pattern-consequential-action.tsx",
+    "project/components/src/pattern-edit-record.tsx": "references/project/components/src/pattern-edit-record.tsx",
+    "project/components/src/pattern-review-submit.tsx": "references/project/components/src/pattern-review-submit.tsx",
+    "project/components/src/settings.tsx": "references/project/components/src/settings.tsx",
+    "scripts/build-framework-fixture.mjs": "references/scripts/build-framework-fixture.mjs"
+  },
+  "sourceHashes": {
+    "build/checks/agent-action-pattern.mjs": "166f5765839d2f60e7bd84cda2a834100306b3d5a80b4b45b79f2c2d33fce1e7",
+    "build/checks/agent-setup.mjs": "670c0786bdfc5739fceae14bd234a2a2c9c6672fbe6fd4e72b15f85647f4a1dd",
+    "build/checks/assistant-conversation-pattern.mjs": "f289529c2ee594ad28269337da762f00ae1143f8bb217cf36b1596a5a5363618",
+    "build/checks/audit-log-pattern.mjs": "af7770e7bf08caa9e1875161e4fc39509e4f0a84e612cdf79cb547cb6046af74",
+    "build/checks/auth-pattern.mjs": "7406cfa7c29c3bb3ac9075c8af079c6f7fd0bc296e81fef1c62667ec245c660b",
+    "build/checks/billing-pattern.mjs": "75e1809769420bc4c714ba0ddb1298489af7152603018d980182e6131182edc2",
+    "build/checks/developer-settings-pattern.mjs": "946cf163177db4aa4dfa30dac754d0229bc4b703ef1eac17a17dc35d19e2f093",
+    "build/checks/guidance.mjs": "65bca118879294288c14f296db3ba225ed953fb295e4010487fb7bae16c1bf51",
+    "build/checks/import-pattern.mjs": "6b98c0533bb0d8584ba0d677e579a0fdfdbdb5bd4663f261ecbdfb39181c45f6",
+    "build/checks/members-pattern.mjs": "bd550c7315dd6298efc1d524364dcfb505884a2e32bb9ed7c4995b53cc61a2a5",
+    "build/checks/onboarding-pattern.mjs": "721ef5a202365d3597985bff9ade68bf3312c309687e846ce9a1669dcc00cae2",
+    "build/checks/pattern-types.mjs": "858431d8b622af096b8a41f35df1789343f96aa07433e8a98185b8740a1ded19",
+    "build/checks/pattern-workflows.mjs": "72e708399c0141c2b62ca94ab96382eb0e000df9d5a54045be814e261d9a9bdc",
+    "build/checks/primary-scope.mjs": "b70634020cd8480ca97e7ee6350fdc9231684888009a6bd8d9ed216505aa2349",
+    "build/checks/render-tells.mjs": "93eae3f005f2a93654e111627a343440a7d87fa4b11c7c9403283b627fc1834c",
+    "build/checks/screen-layout-pattern.mjs": "c744bb32b29da50e2a1d852c1005b42addc0e1d7a98297e168f8ce7d51e4ad93",
+    "build/checks/semantics.mjs": "2ee7689b0472dba2e782ff19304e01018ca470b252fe7137e82bb36a3e0042c0",
+    "build/checks/settings-pattern.mjs": "77a8d8e431e5e25e4f4af5c92e7be1e664dbab5aac9f587b7819bd9c196b3907",
+    "build/checks/sync-pattern.mjs": "2cf9f1ac96be6c48948dea0ffab0fda0a909b5ff19e3e3f9835b6d8bcdd7fbef",
+    "build/checks/tells-lint.mjs": "f254fa9166f65a085d78cecf7ca66145151cd8b7868c732c25c44bbec2c2deac",
+    "build/fixtures/pattern-workflows.tsx": "6781938d83aa85f48c63fff98f9eb5b45fcb5531b6a49f902ec9d497f6e65265",
+    "build/fixtures/patterns/agent-action.jsx": "96d07566b1eb498be16436b9ce1d8b4148c0841cb73b3d421c8ab240bd115559",
+    "build/fixtures/patterns/app-skeleton.jsx": "d2d8e7d5373ee4d65c2e0ecc69451f35d9dfd4bed9f04cf66405cbe9c9478825",
+    "build/fixtures/patterns/assistant-conversation.jsx": "fda1f5ce21a8eb2f0f5da730cad9eb0ab65c91c9e46d69a88f9f6715434eda8a",
+    "build/fixtures/patterns/audit-log.jsx": "ec1183de4c94c0309824b4187c082f7ea76d50a09953224e4164b4fc5fa70780",
+    "build/fixtures/patterns/auth.jsx": "1b41c43b734deb75acd8bfd34dae445e627381884abd23512e37bfb1d644eabe",
+    "build/fixtures/patterns/billing.jsx": "8f56ab9e6d09d73f1ae9ad5d690ff20372f9279d23010d6db7ef5e2a79d0100a",
+    "build/fixtures/patterns/developer-settings.jsx": "7803d792f516b5a1ee823436c505802954865720f7c8dbae0742a1adc0b2d490",
+    "build/fixtures/patterns/import.jsx": "3b4148a99bf90a477ae01a0905cae75200bc53427ea197cc2bcda0a9c2469ca2",
+    "build/fixtures/patterns/members.jsx": "2b25e2f0734a273b6d7366c746573a906b90d613164b7003fe6fd3e426496286",
+    "build/fixtures/patterns/onboarding.jsx": "3ae1325880efa862b84b5d9bcc0691bf6029e1f1ac031bb99adb6c0527c498a9",
+    "build/fixtures/patterns/screen-layout-decision.jsx": "409d5ce48ddef3ca5de3427155e901f06d142938474894e9eabbc167c910c47a",
+    "build/fixtures/patterns/screen-layout-editor.jsx": "a93c41d7590fd98fae48403c49e4d4e793b4e92e4cf5b8cc66e30ed0aa55ba68",
+    "build/fixtures/patterns/screen-layout-report.jsx": "5de2691104456175ef51d2e1d11c85b4075341457e8acd3d5495615c2fbeb0a9",
+    "build/fixtures/patterns/settings.jsx": "92b9b472351f9a8a3479ab04f7890b1b3cbc356cf81926ff0c280f1bdbf0c435",
+    "build/fixtures/patterns/sync.jsx": "8474f762f7c63c4bd99fd337b080df1a788b4b92b2ced7fac5aaa1379b1a1eaf",
+    "docs/framework/AGENT-SETUP.md": "5b300079b150d6416b6dd00280a42110559c85d50b84a13ac6cf9e0329be9a21",
+    "project/Elevation.md": "100532c631803e9a97018b9da5ffff60acf7d80559f9f162ba9e371f5510371f",
+    "project/Fundamentals.md": "65120fd170ff8ea9f50b1498bfedc8c45dbe1a616bfccc32664213e5404d3a32",
+    "project/Research.md": "ca9931eb15547b86cff525126cba2a09e6e0751ad2739a60f453c83ed8d84216",
+    "project/components/src/pattern-async-collection.tsx": "9e4df2265d1de6f269278eb4a42d8d63b3ef74a881a455eb17102be477ecbf4d",
+    "project/components/src/pattern-consequential-action.tsx": "ffe49b7a9fa978e9177c6f3d839d311bdd3da913a6eeedc241800b10fc3287f7",
+    "project/components/src/pattern-edit-record.tsx": "7e83cfdfdb85f6927667dae58f7392c1738dd05ff7a53c75209a875779c9db9d",
+    "project/components/src/pattern-review-submit.tsx": "b452f90e7a160774678aa886626aa48dea535211bc367a17d628ac84bed5ee58",
+    "project/components/src/settings.tsx": "957a04e37936746f2b6b4086d8e2f866ce71f7fb9dded8ba81fff56840206e01",
+    "project/framework/README.md": "2b37096e2c13fbff4578c53ebbc38329f49a4050b9d1757125a42ab778785125",
+    "project/framework/app-skeleton.md": "bc70896a86f4c1dbd3467620562eec62ccf99a9356ff72a7eab8621f492554d9",
+    "project/framework/evidence.json": "ac99cfcca61219a4a25c75adf84c89f6c3e47b3713a8fb8209180c824d565b1b",
+    "project/framework/pattern.schema.json": "abcb37bd5de4a74f27ac079e587e5d288b23e491569a73971f1a31131a37d309",
+    "project/framework/patterns/agent-action.json": "532915c25183d1a6093d9e14b929f3e49d29e400b116ef0612d933d70d49b09a",
+    "project/framework/patterns/agent-action.md": "a11e9d98a84d8a0fae755bae3e618e7daa2608f1f853cfe88e2e58ee74cc01e7",
+    "project/framework/patterns/assistant-conversation.json": "63d7321b87e90f0bbeaf75f12dcb6ffd5cee40dccd769b2b2062932f0b40f226",
+    "project/framework/patterns/assistant-conversation.md": "41fa199f874b1849b3afe19d5c6cc498ddfd20c7cae198b4a2a1feac6747849d",
+    "project/framework/patterns/async-collection.json": "b004d1edd6d9b5f03f4db5092bcd896914d66c8575da9efde47c9654ca3b83e6",
+    "project/framework/patterns/async-collection.md": "4bcb8612436af5b730999d5a31e1f25eaad2ded4862c7639136a2f83b11cac4a",
+    "project/framework/patterns/audit-log.json": "661471f05d07fae8ae0b920c5e1e674906e98829a3e6eed4f01b39c8d053d58a",
+    "project/framework/patterns/audit-log.md": "2d245c2537fd874e09a44004c11a57a6a6b9504330df86263842a84afb0541af",
+    "project/framework/patterns/auth.json": "c9439ecf8196750d887d7a99b135de89d926b365acfecc9a6f7b66d2bbb8c679",
+    "project/framework/patterns/auth.md": "aba431dd58284485f6ae8472056342f72c643eeb7d77edd1eb92336f5bf1d5da",
+    "project/framework/patterns/billing.json": "8a72249c29ebb5b5eefbd98294e3fcfe45b5ddcebf4f7f7e8aa409388bc882e5",
+    "project/framework/patterns/billing.md": "9b9c639d868a0735d8be88d030fdec1db1f43e2bedb9dcb014e39ca79c1fe5bf",
+    "project/framework/patterns/consequential-action.json": "e5a61a89753efed1408cf0b1a5826b607b19c3fbbabf7d3f0b1b2586df24b506",
+    "project/framework/patterns/consequential-action.md": "f4efb5000325416d1b44c7f2ea906420cf8c1fd7b330e7754fac0ba5025c1fc4",
+    "project/framework/patterns/developer-settings.json": "54443991d65410c20b2285caa2265b1662d60188b084969cad3dc6fe6a681fa1",
+    "project/framework/patterns/developer-settings.md": "22eb20642649ad872a53771fd56bfd8051d18bb8cdf4756ccb6581c886db319b",
+    "project/framework/patterns/edit-record.json": "7d4249bbbd1c0c09afc8e4f3d1e6e688d2404db29e17db44cd5445427c570537",
+    "project/framework/patterns/edit-record.md": "a999de3810380ac20ae4045e5cb2dc3fae9d4d654f55a8d7da2fea4dfc3e746f",
+    "project/framework/patterns/import.json": "d1a47a24a15bee87d177b173327d0ba4f9791b7345e3d33f3c97aa960816761f",
+    "project/framework/patterns/import.md": "c44373f9639707b7b8e4ededdf3c3426dc3a75cd5e2b62577fdac4853c3cbaa1",
+    "project/framework/patterns/members.json": "f2567081cd05f65c64f92890a79afd64864992ec66903755a20a7c1d4411702a",
+    "project/framework/patterns/members.md": "b2a42c5f470ce8fd6d96d9630b5c6be452716053f9085cbc6ce87372087d5a43",
+    "project/framework/patterns/onboarding.json": "e831f904db32cb01a48f11cba9ef77704d986e0adb8d53a139a54bd4124704ba",
+    "project/framework/patterns/onboarding.md": "6948c0d7bc99334af1132d41f28b6ea9399b7491115160d5e664280131bad4c4",
+    "project/framework/patterns/review-submit.json": "79b15332acc57fb48b0b99ba98a195d5f913e7875293b0acb6aa42f5425a982b",
+    "project/framework/patterns/review-submit.md": "6a9d1886a48cad9e82da5c8b04d179425ec4fa925105d6f9ee50d4605dab3d87",
+    "project/framework/patterns/screen-layout.json": "199ca3f20a7af1983bc7211406bbf87e43328e3d57c48d29524191de86507782",
+    "project/framework/patterns/screen-layout.md": "7a6dd92249e1b8acbb5ab16afb15f5d3aa25e46fedf8d59eb40a4d892b22310e",
+    "project/framework/patterns/settings.json": "9ae72e95cb61b5f41a22053d408c2a634c18746661fa1c2e41e98a5ef2b6e08f",
+    "project/framework/patterns/settings.md": "dea76175e2b1b4347414c3716f0ff61fd584bf10b8fd45548449694c86027bbf",
+    "project/framework/patterns/sync.json": "e127992aaba5ad797a0c27ff0f7903619511e9a02379b6932c66084d3690660e",
+    "project/framework/patterns/sync.md": "9b6c6928fe19c6f28b88bd092997c0c0645aedddf02a25327a1c7c60969e3729",
+    "project/framework/principles.md": "1c57c684c4b0029012a79d6a38b26b8821abf75852b14db2b18b7e7f6d364b32",
+    "project/framework/rules.json": "607eed605aa834ab2e6557b44df0899a3851b684060566c73fbe1639df4575ae",
+    "scripts/build-framework-fixture.mjs": "1b4a2d7ece0459d2c4df2ec067d8d3b9d00110f2af1cef3be6042ab8f9ea90c9"
+  }
+}

package/dist/guidance/llms.txt

@@ -0,0 +1,20 @@
+# Altitude 0.3.0
+
+Read README.md, then only the relevant contract.
+
+- [Agent action](patterns/agent-action.md): Let an agent propose, wait for approval, run, recover and leave provenance, with each state drawn as one reading.
+- [Assistant conversation](patterns/assistant-conversation.md): Send, stream, stop, retry and recover in a conversation with an assistant, without losing the person's words or claiming an answer is complete before it is.
+- [Async collection](patterns/async-collection.md): Find records while understanding loading, empty and failure states.
+- [Audit log](patterns/audit-log.md): Find who did what, to which resource, when and from where, and export it.
+- [Auth](patterns/auth.md): Sign in, sign up, verify, pass two-factor and reset a password without revealing whether an account exists.
+- [Billing](patterns/billing.md): Show usage against limits as readings and change plan with the cost reviewed before it's confirmed.
+- [Consequential action](patterns/consequential-action.md): Complete a consequential operation with appropriate review or real recovery.
+- [Developer settings](patterns/developer-settings.md): Create, roll and revoke API keys, manage webhooks and connect integrations without treating them as ordinary forms.
+- [Edit record](patterns/edit-record.md): Edit a durable record without losing work.
+- [Import](patterns/import.md): Upload a file, map its columns, fix the rows with problems, review and import with a receipt.
+- [Members](patterns/members.md): Invite people, change roles and remove access without misdrawing invitations or breaking ownership.
+- [Onboarding](patterns/onboarding.md): Get someone new to value with a stamped setup checklist, empty states before tours, and what's new.
+- [Review and submit](patterns/review-submit.md): Review and correct answers before final commitment.
+- [Screen layout](patterns/screen-layout.md): Choose a screen's frame from the person's task, the one thing that leads and the one primary action, instead of inheriting a sidebar, a top bar and a grid of cards.
+- [Settings](patterns/settings.md): Change how a workspace or account behaves, deciding per section whether changes apply now or save together.
+- [Sync](patterns/sync.md): Say truthfully what has reached the server, through offline queues, conflicts and expiring sessions.