{"id":"@lssm-tech/app.web-landing","slug":"app.web-landing","name":"@lssm-tech/app.web-landing","version":"3.9.6","path":"packages/apps/web-landing","manifestPath":"packages/apps/web-landing/package.json","manifestBlobSha":"ddce590b14f138588de74b1d9b04c04c0749ab91","layer":"apps","physicalArea":null,"primaryArea":"app-composition","classification":{"privateDeclared":true,"catalogFamily":null,"catalogKind":null,"catalogStatus":null,"adoptionMode":null,"stability":null},"description":null,"descriptionOrigin":"package.json","catalog":{"visualTesting":{"status":"deferred","owner":"@contractspec-core","targetWave":"wave-2-core-ui","rationale":"Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates."}},"canonicalImports":[],"scripts":{"clean":"rimraf .next dist .turbo","llms:generate":"bun scripts/generate-llms-full.mjs","build":"bun --bun next build","build:types":"bun --bun x tsgo --project tsconfig.build.json --noEmit","typecheck":"bun run build:types","dev":"bun --bun next dev","e2e":"playwright test","lint":"bun run lint:fix","lint:fix":"node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .","lint:check":"node ../../../scripts/biome.cjs check .","test":"bun run test:unit && bun run test:companyos-route","test:companyos-route":"CONTRACTSPEC_RUN_COMPANYOS_ROUTE_BROWSER_TESTS=1 bun test --config ./bunfig.companyos-route.toml src/lib/companyos-ai-solutions-engineer-poc-runtime-client.test.ts 'src/app/api/examples/companyos-ai-solutions-engineer-poc/[operation]/route.test.ts' && CONTRACTSPEC_RUN_COMPANYOS_ROUTE_BROWSER_TESTS=1 bun test --config ./bunfig.companyos-route.toml src/lib/companyos-ai-solutions-engineer-poc-runtime.test.ts","test:unit":"bun test --cwd ../../.. ./packages/apps/web-landing","start":"bun --bun next start","prebuild":"bun --bun x tsgo --project tsconfig.build.json --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"ai":"catalog:ai","@hookform/resolvers":"catalog:ui","@lssm-tech/bundle.library":"workspace:*","@lssm-tech/bundle.marketing":"workspace:*","@lssm-tech/example.agent-console":"workspace:*","@lssm-tech/example.ai-chat-assistant":"workspace:*","@lssm-tech/example.analytics-dashboard":"workspace:*","@lssm-tech/example.communication-os":"workspace:*","@lssm-tech/example.companyos-ai-solutions-engineer-poc":"workspace:*","@lssm-tech/example.companyos-ai-os-proofs":"workspace:*","@lssm-tech/example.companyos-voiceops-workbench":"workspace:*","@lssm-tech/example.crm-pipeline":"workspace:*","@lssm-tech/example.data-grid-showcase":"workspace:*","@lssm-tech/example.finance-ops-ai-workflows":"workspace:*","@lssm-tech/example.form-showcase":"workspace:*","@lssm-tech/example.graph-showcase":"workspace:*","@lssm-tech/example.in-app-docs":"workspace:*","@lssm-tech/example.integration-hub":"workspace:*","@lssm-tech/example.learning-journey-registry":"workspace:*","@lssm-tech/example.marketplace":"workspace:*","@lssm-tech/example.pocket-family-office":"workspace:*","@lssm-tech/example.policy-safe-knowledge-assistant":"workspace:*","@lssm-tech/example.saas-boilerplate":"workspace:*","@lssm-tech/example.special-ops-cockpit":"workspace:*","@lssm-tech/example.visualization-showcase":"workspace:*","@lssm-tech/example.voiceops-operating-graph":"workspace:*","@lssm-tech/example.wealth-snapshot":"workspace:*","@lssm-tech/example.workflow-system":"workspace:*","@lssm-tech/integration.provider-claude-code":"workspace:*","@lssm-tech/integration.provider-codex":"workspace:*","@lssm-tech/integration.provider-copilot":"workspace:*","@lssm-tech/integration.provider-gemini":"workspace:*","@lssm-tech/integration.provider-local-model":"workspace:*","@lssm-tech/integration.provider-stt":"workspace:*","@lssm-tech/integration.runtime-hybrid":"workspace:*","@lssm-tech/integration.runtime-local":"workspace:*","@lssm-tech/integration.runtime-managed":"workspace:*","@lssm-tech/lib.ai-providers":"workspace:*","@lssm-tech/lib.builder-spec":"workspace:*","@lssm-tech/lib.content-gen":"workspace:*","@lssm-tech/lib.contracts-spec":"workspace:*","@lssm-tech/lib.design-system":"workspace:*","@lssm-tech/lib.example-shared-ui":"workspace:*","@lssm-tech/lib.observability":"workspace:*","@lssm-tech/lib.presentation-runtime-core":"workspace:*","@lssm-tech/lib.presentation-runtime-next":"workspace:*","@lssm-tech/lib.progressive-delivery":"workspace:*","@lssm-tech/lib.translation-runtime":"workspace:*","@lssm-tech/lib.provider-spec":"workspace:*","@lssm-tech/lib.surface-runtime":"workspace:*","@lssm-tech/lib.ui-kit":"workspace:*","@lssm-tech/lib.ui-kit-core":"workspace:*","@lssm-tech/lib.ui-kit-web":"workspace:*","@lssm-tech/lib.ui-link":"workspace:*","@lssm-tech/module.ai-chat":"workspace:*","@lssm-tech/module.builder-workbench":"workspace:*","@lssm-tech/module.examples":"workspace:*","@lssm-tech/module.mobile-review":"workspace:*","@posthog/react":"^1.11.1","@tanstack/react-query":"^5.103.1","@vercel/analytics":"2.0.1","autoprefixer":"^10.6.1","better-auth":"1.7.5","browserify-fs":"^1.0.0","class-variance-authority":"catalog:ui","clsx":"catalog:ui","elysia":"catalog:server","lucide-react":"catalog:ui","next":"catalog:","next-themes":"^0.4.6","posthog-js":"^1.434.0","react":"catalog:","react-dom":"catalog:","react-hook-form":"^7.86.0","react-icons":"^5.7.0","react-native-css":"^3.0.7","resend":"^6.28.1","shiki":"^4.4.3","sonner":"^2.0.8","tailwind-merge":"catalog:ui","tailwindcss-animate":"catalog:ui","@lssm-tech/example.organization-planning-agenda":"workspace:*","@lssm-tech/example.project-management-sync":"workspace:*","@lssm-tech/bundle.marketing-operations":"workspace:*"},"devDependencies":{"@lssm-tech/lib.builder-runtime":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","@playwright/test":"^1.63.0","@tailwindcss/postcss":"4.3.3","@types/node":"catalog:types","@types/react":"catalog:types","@types/react-dom":"catalog:types","postcss":"catalog:build","postcss-load-config":"^6.0.1","string-replace-loader":"^3.3.0","tailwindcss":"catalog:build","tw-animate-css":"1.4.0","typescript":"catalog:"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts"},"publishExports":null,"types":null,"files":null,"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/app.web-landing","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/apps/web-landing/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/src/index.ts","sourceStatus":"verified source file"}]}],"entryCount":1,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/app.web-landing.txt"},"readme":{"status":"available","body":"# @lssm-tech/app.web-landing\n\n**Next.js delivery shell for the public ContractSpec website: technical substrate marketing, docs, registry pages, `/llms*`, and selected operate/sandbox surfaces.**\n\n## What It Does\n\n- Owns the app shell, metadata, OG generation, route wrappers, and public site delivery.\n- Publishes the marketing experience while delegating most page-body composition to `@lssm-tech/bundle.marketing`.\n- Serves docs, registry, sandbox, and operate surfaces while keeping their shared shell consistent with the public brand system.\n- Shares example preview rendering across docs, `/templates`, and `/sandbox`, with rich UI for UI-backed examples and fallback cards for the rest of the discoverable catalog.\n- Hosts the CompanyOS adaptive Request-to-Verified-Proof journey through an\n  app-owned preview override, allowlisted same-origin no-store operation route,\n  and browser-safe fetch client while keeping runtime composition server-only\n  and Playwright outside the client graph.\n- Publishes `/llms`, `/llms.txt`, `/llms-full`, `/llms-full.txt`, and package-specific `/llms/[slug]` endpoints for agent-friendly repo guidance.\n- Keeps Managed CompanyOS agent guidance aligned with the real-organization rollout runbook: Better Auth membership and active organization are authoritative, NDconsulting history is preserved, and rollout/canary/rollback remain operator-gated.\n- Documents design-system adoption guidance for shared interaction patterns such as `ObjectReferenceHandler` and `AdaptivePanel`, including human-readable docs and agent-facing `/llms*` prompts.\n- Documents ContractSpec translation runtime guidance, including the optional i18next adapter, SSR/hydration rules, production checks, and an agent implementation prompt.\n- Documents data-exchange flexible import-template guidance at `/docs/guides/data-exchange-import-templates`, including developer templates, user remapping flows, server dry-runs, format profiles, verification commands, and copy-ready prompts.\n\n## Template preview and LLMS sync workflow\n\nPublic example preview changes must keep human and agent-facing surfaces aligned:\n\n- `/templates`, `/docs/examples/<key>`, and `/sandbox?template=<key>` consume the same module examples preview surface so inline UI and fallback behavior stay consistent.\n- `/llms`, `/llms.txt`, `/llms-full`, `/llms-full.txt`, and `/llms/[slug]` must be regenerated or verified after README changes that document example exports, preview support, route inventory, or release workflow expectations.\n- Rich previews are deterministic local fixtures by default. The CompanyOS\n  proof demo is the explicit governed exception: the host override injects the\n  same-origin runtime client into the generic preview. Live mode starts an\n  ephemeral loopback fixture and never targets production. The reliable public\n  path is the committed validated recording; live Chromium is opt-in and must\n  pass a real preflight.\n- Public key or alias changes are compatibility-sensitive. Preserve existing `examples.*` and normalized lookup behavior unless a release capsule explicitly documents and tests the migration.\n\n## Architecture\n\n- `src/app/` contains route groups for marketing, docs, sandbox, operate, registry, and API endpoints.\n- `src/components/` contains app-local shell concerns such as header, footer, SEO helpers, and local route UI.\n- `public/llms*.txt` contains machine-readable monorepo guidance exposed directly from the site.\n- `scripts/generate-llms-full.mjs` regenerates the public aggregated README corpus used by `/llms-full.txt`.\n\nThis package should stay thin:\n- marketing page narratives belong in `@lssm-tech/bundle.marketing`\n- docs and library composition belong in `@lssm-tech/bundle.library`\n- shared reusable UI primitives belong in lower layers\n\n## Public Entry Points and Topics\n\nStatic and generated public surfaces currently delivered by this app:\n\n- **Marketing and conversion**: `/`, `/product`, `/pricing`, `/templates`, `/contact`, `/cofounder`, `/contribute`, `/design-partner`, plus legal pages at `/legal/privacy` and `/legal/terms`.\n- **Release and registry**: `/changelog`, `/changelog/[version]`, `/registry/featured`, `/registry/packs`, `/registry/packs/[name]`, `/registry/packs/[name]/versions/[version]`, and `/registry/publish`.\n- **Feature catalog**: `/features`, `/features/[key]`, and feature detail routes for operations, events, forms, presentations, and DataViews.\n- **Docs shell**: `/docs` and topic groups for getting started, specs, guides,\n  libraries, the first-class Agent Ecosystem at `/docs/agents`, domains,\n  safety, knowledge, integrations, architecture, advanced operation,\n  comparisons, ecosystem, examples, Studio, intent pages, generated reference,\n  manifesto, and ops.\n- **Agent Ecosystem docs**: `/docs/agents` plus focused guides for getting\n  started, two all-in-one examples, multi-agent operation, governed\n  self-improvement, durable runtime, self-maintaining APIs, replaceable\n  deployment topologies, and production readiness. The Release Steward guide\n  covers verified, human-approved migration pull requests. The Company\n  Intelligence Scout guide covers bounded public-web research, source\n  citations, 30-day person/contact retention, and policy-controlled recruiting\n  or sales drafts and sends.\n- **Docs guide topics**: installation, private registry access, Hello World, compatibility, developer tools, DataViews, troubleshooting, Next.js endpoint adoption, imported codebases, contract intelligence, codebase graphs, validation/typing, ContractSpec theme, contract-driven forms, i18n, Drizzle database setup, data-exchange import templates, docs/client/schema generation, docs pipeline, module bundles, mobile navigation, Builder workbench/spec packs/intelligence, Connect, provider-backed knowledge, release capsules, and CI diff gating.\n- **Docs library topics**: contracts, schema, runtime, translation runtime, UI kit, UI kit web, design system, application shell, cross-platform UI, data views, personalization, observability, resilience, multi-tenancy, workflow composer, workflows, AI agent, analytics, content generation, cost tracking, data backend, evolution, GraphQL, growth, overlay engine, SLO, support bot, and testing.\n- **Docs integration topics**: setup/model docs plus OpenAI, Mistral, Qdrant, Gmail, Google Drive, Google Calendar, Stripe, Twilio, GitHub, Slack, Postmark, Powens, Resend, S3, ElevenLabs, WhatsApp Meta, WhatsApp Twilio, circuit breakers, and health routing.\n- **Examples and sandbox**: `/docs/examples`, `/docs/examples/[exampleKey]`, `/docs/examples/data-grid-showcase`, `/templates`, `/sandbox`, and `/graph-showcase`.\n- **Operate surfaces**: `/operate/builder/workspaces/[workspaceId]`, `/operate/builder/workspaces/[workspaceId]/mobile-review/[cardId]`, `/operate/pm/issues/[issueId]`, and API proxy routes under `/api/operate/builder/*`.\n- **Agent-facing discovery**: `/llms`, `/llms.txt`, `/llms-full`, `/llms-full.txt`, `/llms/[slug]`, and `/docs/llms.txt` via static files and rewrites.\n- **Public APIs**: `/api/changelog`, `/api/chat`, `/api/graphql/*`, `/api/mcp`,\n  `/api/og`, `/api/examples/companyos-ai-solutions-engineer-poc/[operation]`,\n  and operate builder API routes.\n\nRoute changes here affect SEO, external links, sitemap output, and agent-discovery flows. Keep `src/app/sitemap.ts`, `next.config.mjs` rewrites, `public/llms*.txt`, this README, and route wrappers aligned.\n\n## Marketing contract boundary\n\nThe `(landing-marketing)` route group is wrapped with the shared marketing contract boundary and backed by the ContractSpec route contract registry from `@lssm-tech/bundle.marketing/content`. Static routes, deterministic feature/changelog routes, and runtime-only registry pack families must stay covered by `src/marketing-contract-system.test.ts` when route files move or change.\n\n## Local Commands\n\n- `bun run dev` — bun --bun next dev\n- `bun run start` — bun --bun next start\n- `bun run build` — bun --bun next build\n- `bun run lint` — bun run lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run clean` — rimraf .next dist .turbo\n- `bun run llms:generate` — bun scripts/generate-llms-full.mjs\n- `bun run build:types` — tsgo --noEmit\n- `bun run test:unit` — invoke Bun’s test runner directly from the repository\n  root, scoped to this app. The command must begin with `bun test`; placing\n  `--cwd` before `test` invokes the root package script and unrelated suites.\n- `bun run test` — run the root-safe unit suite, then the package-context\n  CompanyOS route proof.\n- `bun run test:companyos-route` — verify the CompanyOS browser client and\n  server-only live route proof with the package-local Bun test configuration.\n\nFor a customer-call rehearsal, run:\n\n`bun run --cwd examples/companyos-ai-solutions-engineer-poc precall`\n\nThis validates the example/profile, committed recording and hashes, Chromium\nplus fixture behavior, and the same-origin host route. Optional request analysis\nis host-only, disabled by default, and requires\n`CONTRACTSPEC_COMPANYOS_LIVE_ANALYSIS=1` plus approved provider configuration.\nIt has no tools and returns analysis-only authority.\nLive proof is separately disabled unless\n`CONTRACTSPEC_COMPANYOS_LIVE_BROWSER=1`; even then, the route requires a\nsuccessful `ready-live` probe and an exact prepared-generation session binding\nbefore it creates the loopback fixture.\n\nThe live CompanyOS route proof is opt-in during generic `bun test` discovery.\nRun it through `test:companyos-route`: Bun's repository-root project\nconfiguration can corrupt the loopback Playwright proof state before mutation,\nwhile the package-local server test configuration observes and resets the exact\nexpected state. The scoped command remains part of `bun run test`, so CI keeps\nthe live-browser source, status, observed-state, and reset assertions.\n\n## Notes\n\n- Branding changes in this package must stay aligned with root docs, generated root AGENTS content, and `public/llms.txt`.\n- When updating the public shell, verify that docs and `/llms*` remain readable; this package serves more than the marketing homepage.\n- Keep `/docs/libraries/design-system` and `/llms/lib.design-system` aligned when documenting object references, adaptive panels, or other interaction primitives that downstream apps should adopt consistently.\n- Keep `/docs/libraries/translation-runtime`, `/llms/[lib.translation-runtime]`, and `@lssm-tech/lib.translation-runtime` README guidance aligned when documenting i18n runtime or adapter behavior.\n- Keep `/docs/guides/data-exchange-import-templates`, `/llms/lib.data-exchange-core`, `/llms/lib.data-exchange-client`, and `/llms/lib.data-exchange-server` aligned when documenting import templates, flexible column mapping, dry-runs, or mapping-review prompts.\n\n## Static-generation resource budget\n\n`bun run build` retains the required TypeScript prebuild and generates every\nconfigured route. `CONTRACTSPEC_BUILD_CPU_BUDGET` accepts a positive integer\nallocation; page-data/static generation use at most four workers and two page\nrenders per worker. Without an allocation, the worker count follows local\n`availableParallelism()` up to the same four-worker cap. Invalid overrides fail\nconfiguration instead of starting an oversized pool. Turbo hashes both the\nallocation and the budget helper.\n\nThe failed Railway build had compiled successfully before launching 47 workers\nagainst a 4-CPU/16-GB allocation. A local full build with budget four completed\nall 1,644 static tasks in 58.41 seconds overall, including the TypeScript gate.\nThe route count reflects that release snapshot; live runner memory/cgroup\nqualification remains required and should use the current route inventory.\n","sourcePath":"packages/apps/web-landing/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/README.md","blobSha":"7ce51d8297f24ce136c906fcfddcabf79bd30ffd","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"docspec_pipeline_source_cache_final_bcc.json","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"app-composition","areaTitle":"Application composition and product hosts","displayName":"app.web-landing","runtimes":[],"platforms":[],"kind":"apps","scope":"Workspace only","canonicalRoute":"/docs/packages/app.web-landing/","contextUrl":"/docs/packages/app.web-landing.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}