@cats-inc/cats-platform 0.1.0

package/.env.example

@@ -0,0 +1,188 @@
+# Cats environment template
+# Copy to .env for local development.
+# Packaged desktop also reads ~/.cats/desktop/.env for desktop-host overrides
+# and ~/.cats/platform/config/.env for sidecar-only overrides.
+
+APP_ENV=development
+CATS_HOST=127.0.0.1
+CATS_PORT=8181
+# Desktop host overrides. Keep these on loopback so packaged Electron does not
+# inherit LAN-facing binds from CATS_HOST / CATS_RUNTIME_HOST.
+CATS_DESKTOP_APP_HOST=127.0.0.1
+CATS_DESKTOP_RUNTIME_HOST=127.0.0.1
+# Dev web host for Vite (`npm run dev:web` / `npm run preview:web`). Leave blank
+# to reuse `CATS_HOST`. Use `0.0.0.0` for same-LAN browser testing.
+CATS_WEB_HOST=
+# Optional dev/preview ports for the Vite renderer host.
+CATS_WEB_DEV_PORT=
+CATS_WEB_PREVIEW_PORT=
+# Optional proxy target for the Vite renderer host. Leave blank to proxy to the
+# local Cats app server on `127.0.0.1:$CATS_PORT`.
+CATS_WEB_PROXY_TARGET=
+# Defaults to ~/.cats/platform/state/chat-state.local.json when blank.
+CATS_PLATFORM_DIR=
+CATS_DESKTOP_DIR=
+CATS_RUNTIME_DIR=
+# Debug-only phase trace for cats-platform cold-start investigation. Writes
+# structured startup events to stderr/stdout capture when true.
+CATS_PLATFORM_STARTUP_TRACE=false
+# Advanced desktop escape hatch. Uncomment to force quit-on-close even if the
+# in-app system tray preference is enabled.
+# CATS_DESKTOP_FORCE_QUIT_ON_CLOSE=true
+# Advanced desktop escape hatch. Set false to force packaged startup audits to
+# collect readiness checks serially instead of in parallel.
+CATS_DESKTOP_SETUP_AUDIT_PARALLEL=true
+# Desktop first-run onboarding policy. Default setup_status shows the packaged
+# CLI installer page before /setup when setup is not complete, without blocking
+# on CLI inventory. Use cli_inventory_gate to restore the zero-CLI gate.
+CATS_DESKTOP_BOOTSTRAP_ONBOARDING_MODE=setup_status
+# Mobile pairing is on by default. Set to false to hide Settings > Desktop >
+# Mobile pairing entirely and short-circuit `/api/mobile/*`. For same-LAN
+# phone access, the desktop app server must bind beyond loopback, for example
+# `CATS_DESKTOP_APP_HOST=0.0.0.0` in packaged desktop or `CATS_HOST=0.0.0.0`
+# in a built Node run. Re-run `npm run build:mobile:check` after Expo SDK
+# bumps before shipping a desktop artifact.
+CATS_DESKTOP_MOBILE_PAIRING_ENABLED=true
+# Optional dev/package override for the static Expo export root. Leave blank to
+# use `build/mobile` in dev and `resources/mobile` in packaged desktop.
+CATS_MOBILE_BUNDLE_ROOT=
+# Skip the mobile bundle step (`expo export`) inside the desktop installer
+# build chain. Useful when the host architecture has no compatible Hermes
+# binary (e.g. Linux ARM64 — react-native ships only linux64-bin/hermesc).
+# When set to a truthy value (`true`, `1`, `yes`, `on`), the installer runs
+# `build:no-mobile` and seeds an empty `build/mobile/.skip-marker`. The
+# resulting artifact has no OTA-updatable mobile bundle, so pair this with
+# CATS_DESKTOP_MOBILE_PAIRING_ENABLED=false at runtime.
+CATS_SKIP_MOBILE=false
+# Compatibility aliases: CATS_INC_HOST / CATS_INC_PORT
+
+# Platform authentication (PLAN-089). Auth defaults to enabled for normal
+# workspaces. `false` is an unsafe dev/test escape hatch and is rejected after
+# setup is complete.
+CATS_AUTH_ENABLED=
+# Required before creating the first local admin or issuing browser/mobile
+# sessions. Use a long random value; tokens are stored only as HMAC hashes.
+CATS_AUTH_SESSION_SECRET=
+# Browser and Cats Mobile session TTLs in milliseconds.
+CATS_AUTH_SESSION_TTL_MS=
+CATS_AUTH_MOBILE_SESSION_TTL_MS=
+# Local/Google login throttling. Keep these non-empty only when tuning tests or
+# deployments with unusual LAN threat models.
+CATS_AUTH_LOGIN_FAILURE_LIMIT=
+CATS_AUTH_LOGIN_LOCKOUT_MS=
+CATS_AUTH_ACCOUNT_DAILY_FAILURE_CAP=
+CATS_AUTH_ACCOUNT_COOLDOWN_MS=
+CATS_AUTH_SUBNET_DAILY_FAILURE_CAP=
+# Comma-separated browser origins allowed to perform pre-auth mutations such as
+# setup first-admin creation and local login. Defaults include the app server
+# origin plus Vite dev origins. Reverse proxies must preserve the browser's
+# Origin header and list their public origin here; Cats does not trust arbitrary
+# X-Forwarded-* headers to reconstruct an origin.
+CATS_AUTH_ALLOWED_BROWSER_ORIGINS=
+# Optional Google identity provider. Browser GIS uses the web client ID.
+# Cats Mobile must use explicit mobile audiences.
+CATS_AUTH_GOOGLE_CLIENT_ID=
+CATS_AUTH_GOOGLE_MOBILE_AUDIENCES=
+CATS_AUTH_GOOGLE_HD=
+
+# Runtime boundary
+CATS_RUNTIME_BASE_URL=http://127.0.0.1:3110
+CATS_RUNTIME_API_KEY=
+# Bounded self-healing for stale runtime leases. Set to 0 to disable.
+CATS_RUNTIME_STALE_SESSION_RETRY_LIMIT=1
+# Debug-only live trace for sequential/runtime stream debugging. Browser trace is
+# exposed at window.__catsLiveTrace and server trace at GET /api/debug/live-trace.
+CATS_DEBUG_LIVE_TRACE=false
+# Debug-only override. Keep this false for normal product behavior so deleting a
+# chat / parallel group / cat also deletes linked cats-runtime sessions.
+CATS_DEBUG_KEEP_RUNTIME_SESSIONS_ON_PRODUCT_DELETE=false
+# Session-create budget (ms) for cats-runtime to bring a provider session up.
+# Default 60000. Increase only when investigating slow provider boot.
+CATS_RUNTIME_SESSION_CREATE_TIMEOUT_MS=
+# Threshold (ms) before logging a slow-session-create warning. Defaults to a
+# fraction of the session-create budget; override only for diagnostics.
+CATS_RUNTIME_SESSION_CREATE_SLOW_WARNING_MS=
+# Idle timeout (ms) for an in-flight runtime stream/turn. Default 120000.
+CATS_RUNTIME_MESSAGE_IDLE_TIMEOUT_MS=
+# Legacy compound setup timeout (ms). When set, becomes the fallback for both
+# CATS_RUNTIME_SETUP_SCAN_PROXY_TIMEOUT_MS and
+# CATS_RUNTIME_SETUP_APPLY_PROXY_TIMEOUT_MS below; explicit per-step values
+# still win. Leave blank for the explicit defaults.
+CATS_RUNTIME_SETUP_PROXY_TIMEOUT_MS=
+# Setup wizard proxy scan budget (ms). Default 120000.
+CATS_RUNTIME_SETUP_SCAN_PROXY_TIMEOUT_MS=
+# Setup wizard proxy apply budget (ms). Default 30000.
+CATS_RUNTIME_SETUP_APPLY_PROXY_TIMEOUT_MS=
+
+# Optional override for the provider capability bootstrap YAML path
+# (ADR-082 / PLAN-080). Defaults to
+# `${platformConfigDir}/provider-capability-bootstrap.yaml` (typically
+# `~/.cats/platform/config/provider-capability-bootstrap.yaml`).
+CATS_PROVIDER_CAPABILITY_BOOTSTRAP_CONFIG=
+
+# Provider-agent observation/decision flow for chat dispatch (SPEC-082). Default
+# false. Turn on to let strong direct Cats produce typed observations and
+# tool-request decisions through the per-turn supervisor. Required for the
+# `cat_tool` mode of the natural-product-intent gate below.
+CATS_CHAT_PROVIDER_AGENT_DECISION_ENABLED=false
+
+# Natural-language Work/Code intent in direct chat (SPEC-105 / ADR-102).
+# - off                : default; no no-slash product suggestions. Owners can
+#                        always still type explicit /work or /code.
+# - cat_tool           : strong direct Cats receive the proposeProductIntake
+#                        tool grant and can ask the owner to confirm Work/Code
+#                        intake. Pairs with the per-owner profile setting
+#                        `naturalProductIntentProposalsEnabled` (defaults to
+#                        true so deployments can opt in without per-owner
+#                        migration).
+# - heuristic_prefilter : experimental v1 PLAN-093 keyword detector backstop.
+#                        Detector-only: the proposal tool is NOT exposed in
+#                        this mode. Not a default; intended for migration only.
+# Effective mode resolution: `off` if either this gate or the owner setting is
+# off. Otherwise the effective mode equals this deployment value.
+CATS_CHAT_NATURAL_PRODUCT_INTENT_MODE=off
+
+# Cat limits
+CATS_MAX_BOSS_CATS=1
+CATS_MAX_CATS=5
+CATS_MAX_CHAT_PARTICIPANTS=5
+# Max audience size for sequential/concurrent group routing.
+CATS_MAX_AUDIENCE_PARTICIPANTS=3
+
+# Parallel chat limits
+CATS_MAX_PARALLEL_CHATS=3
+
+# Telegram bot integration (optional; only required if you bind a Telegram bot).
+# Default Telegram bot token used as the fallback when a bot binding does not
+# carry its own token.
+CATS_TELEGRAM_BOT_TOKEN=
+# Webhook secret token. Telegram is required to send this in
+# `X-Telegram-Bot-Api-Secret-Token` for webhook ingress to be accepted; leave
+# blank to disable that header check.
+CATS_TELEGRAM_WEBHOOK_SECRET=
+# Maximum allowed Telegram webhook body size (bytes). Leave blank for the
+# library default.
+CATS_TELEGRAM_WEBHOOK_MAX_BYTES=
+
+# Optional helper for webhook-mode scripts/windows|linux|macos/*tailscale-funnel*
+# Leave blank to use Tailscale's default HTTPS port selection.
+TAILSCALE_HTTPS_PORT=
+
+# Optional helper settings for webhook-mode scripts/windows|linux|macos/*ngrok-tunnel*
+# If omitted, ngrok falls back to any existing global ngrok CLI configuration.
+CATS_NGROK_AUTHTOKEN=
+CATS_NGROK_DOMAIN=
+
+# Server startup orchestration (advanced — used by the desktop launcher and
+# CLI/integration tests; leave blank for normal local dev).
+# Startup mode: `standalone` (default) or `app-managed` when a parent host
+# process orchestrates the lifecycle.
+CATS_STARTUP_MODE=
+# Ready-output format: `plain` (text) or `json`. Defaults to `plain` for
+# `standalone` and `json` for `app-managed`.
+CATS_READY_OUTPUT=
+# Free-form identifier of the parent process managing this server lifecycle.
+CATS_MANAGED_BY=
+# Override the platform package root used to resolve bundled config example
+# paths. Mostly for packaged builds; rarely needed in dev.
+CATS_PLATFORM_PACKAGE_ROOT=

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,271 @@
+# Cats
+
+> The flagship platform app from Cats Inc.
+
+## Overview
+
+`Cats` is the flagship product brand for the platform. This standalone repo hosts
+the technical platform host packaged as `@cats-inc/cats-platform`
+(extracted from the original monorepo in 2026-07 with full history).
+It talks to `cats-runtime` as its execution boundary and keeps the product
+model in this repo rather than inheriting it from earlier prototypes.
+
+`Cats Inc` remains the umbrella brand. `Cats` remains the public product name,
+`cats-platform` is the host repo/package target, `cats-runtime` remains the
+runtime boundary, and `cats-one` is reserved for the one-shot bootstrap
+installer path. The persistent host executable is `cats-platform`.
+
+The current slices are:
+
+- a Node app/runtime core on `CATS_PORT` (default `8181`, with `CATS_INC_PORT`
+  kept as a compatibility alias)
+- a `cats-runtime` health and app-shell API
+- a chat-first `React/Vite` renderer with a route-gated setup wizard, settings
+  surfaces, and a preview-ready side pane
+- a 2-step setup wizard that optionally configures a Guide Cat from truthful
+  runtime-backed provider/model choices, then lands on `/lobby`
+- file-backed chat state, cat execution, and transcript persistence
+- runtime-backed channel activation, mode-aware sleep/wake entry, and routed messaging through `cats-runtime`
+- a global orchestrator surface, direct-cat routing, deterministic `@mention`
+  handling, transcript export, visible presence states, and machine-readable
+  room-routing / wake-request state
+- `My Cats` private-lane entry that reopens an existing direct room or opens a
+  direct draft lane when needed
+- a transcript-adjacent operator loop with pending approvals, progress,
+  activity, trace, run inspection, approve/reroute/retry/acknowledge action
+  seams, and machine-readable delivery/budget/workflow governance summaries
+- a first `Cats Work` dashboard plus project/work-item/task detail slice above
+  the shared operator inbox, control-plane, recovery, artifact, activity, and
+  timeline reads
+- a first `Cats Code` dashboard above shared code-targeted tasks plus
+  build/preview artifact output without inventing a separate code schema
+- contract-first orchestrator planning, approval-gated dispatch, and
+  execution-loop routes that now expose checkpoint-driven multi-step execution
+  plans, recovery actions, and Team 6 MCP tool-plane metadata while staying
+  above the existing direct `cats-runtime` API path
+- an Electron desktop host that now supervises local `cats-runtime` + `cats-platform`,
+  can produce a real Windows NSIS installer, stages cross-platform packaging
+  outputs, persists host-readable bootstrap state, keeps the bootstrap bridge
+  sandboxed, supports tray/background lifecycle, and owns the packaged
+  bootstrap/remediation seam plus a manual-check update skeleton
+- cross-layer packaged bootstrap diagnostics with host-owned service logs,
+  product-owned onboarding history, host-issued bootstrap attempt ids, and one
+  aggregated recovery chronology across runtime, product, and host state
+- a repo-owned packaged setup helper baseline for Windows native CLI, WSL,
+  Docker Desktop, and Ollama flows, with the repo-owned first-run provider
+  scan plus resumable setup recovery surfaced through the desktop host
+- a repo-owned self-hosted provider-helper baseline shipped in the npm package:
+  Unix host install/check/upgrade scripts for the 12-provider host matrix, plus
+  Windows aggregate WSL / Docker / check / bulk-upgrade helpers outside the
+  packaged wizard flow
+- a Telegram Boss Cat inbox bridge with durable inbox-to-room links, webhook diagnostics, and transport-owned reply delivery
+- product-owned per-Cat companion box sidecar storage, Cat-scoped ingestion APIs,
+  direct companion-session hydration metadata, and Cats-owned retrieval context
+- Cats-owned canonical memory extraction, source-scoped promotion rules,
+  companion source update/delete convergence, policy-aware retrieval assembly,
+  auto-synced companion mutations plus curated cat/owner durable notes, and
+  pre-reset / pre-compaction flush payloads for companion, owner, and channel
+  memory
+- provider-agnostic cat memory checkpoints plus channel-scoped execution leases
+- transcript-adjacent live runtime event tapes that retain recent progress,
+  text, and tool milestones instead of collapsing to a single indicator line
+- runtime-backed provider capability hints in selection surfaces, sourced from
+  `cats-runtime` event capability truth instead of provider-name heuristics
+- live content-block transcript rendering in chat surfaces, sourced from the
+  runtime-owned `content_block` stream contract
+
+## Current Status
+
+- [x] Bootstrap `cats-platform/` from `project-bootstrap`
+- [x] Establish `cats-runtime` as the only runtime boundary
+- [x] Add a minimal Node/TypeScript HTTP entrypoint and smoke tests
+- [x] Choose `React/Vite` as the initial renderer approach
+- [x] Add the first multi-channel chat UI shell
+- [x] Add initial file-backed chat-state persistence
+- [x] Add local channel setup and persistence
+- [x] Add basic runtime-backed channel operations
+- [x] Add a global cat registry, chat assignment, mention routing, and transcript export
+- [x] Separate cat identity and memory from provider-specific execution state
+- [x] Add first-run `/setup` onboarding with optional Guide Cat setup,
+      truthful selector states, and `/lobby`-first entry routing
+- [x] Land chat session sleep/wake lifecycle, direct Cat chat defaults, stable
+      room-routing / wake semantics, and room-header presence indicators
+- [x] Land Cat-private room entry from `My Cats` plus Telegram binding markers
+      without auto-persisting new direct rooms
+- [x] Land transcript-adjacent operator approvals, progress, activity, and run
+      inspection surfaces
+- [x] Land a first `Cats Work` dashboard and project/work-item/task detail
+      surface above shared core task/operator reads
+- [x] Land machine-readable governance/workflow summaries for approval,
+      delivery, budget, reroute, retry, and workflow continuation contracts
+- [x] Land product-owned companion box storage, Cat-scoped ingest/read routes,
+      and direct companion-session hydration contracts without visible UI
+      changes
+- [x] Land the first Electron desktop-host slice with app-managed readiness,
+      local sidecar supervision, and bootstrap prerequisite checks
+- [x] Land cross-layer packaged bootstrap diagnostics with product onboarding
+      history, host/service logs, and an aggregated recovery chronology
+- [x] Ship repo-owned self-hosted provider helpers for Unix host paths plus
+      Windows WSL/Docker/check/upgrade operational surfaces without depending
+      on `environment-bootstrap` at runtime
+- [x] Land Cats-owned canonical memory records, retrieval context assembly, and
+      memory flush seams without adding an external RAG dependency; curated
+      cat/owner notes plus companion source mutations now sync into canonical
+      retrieval, carry lineage-aware flush payloads, and replace stale hits
+- [x] Land transcript-adjacent live event tapes in Chat and Code so recent
+      progress, text, and tool milestones stay visible while runs are active
+- [x] Land runtime-backed provider capability hints in selection surfaces so
+      Cats can read stepwise text/tool/progress truth from `cats-runtime`
+- [x] Land explicit provider capability bootstrap config so strong/weak startup
+      treatment only comes from operator YAML rules, with Chat/Work/Code live
+      Claude/Codex smoke verified under that fixture
+- [x] Land runtime-backed live content blocks in Chat, Work, and Code so the
+      typing indicator can render stable block snapshots instead of only a
+      flat event list
+- [ ] Add productization layers beyond the current Phase 2 chat core
+
+## Still Open
+
+The current implementation has closed the main phase-2 product gaps, but
+several Phase 3 items remain:
+
+- richer orchestrator automation beyond explicit `@mention` routing
+- split-view chat surfaces for preview/debug context
+- polling-first Telegram onboarding so bot-token setup does not require public
+  ingress by default
+- automatic resume after owner or incident decisions, richer live runtime
+  state, and deeper converge/group planning beyond the current execution-loop
+  and action seams
+- richer first-run remediation polish, branded/signed release assets, and
+  broader expert-only capability packs beyond the current Windows NSIS-first
+  packaged setup baseline and the new repo-owned self-hosted helper surface
+- offline transcript normalization and ingestion handoff hooks
+- richer semantic indexing and archive export beyond the current local
+  canonical-memory and retrieval substrate
+- LINE entrypoints, richer Telegram room-rotation policy, and fuller desktop
+  packaging beyond the current host slice
+
+## Quick Start
+
+> [!NOTE]
+> Upgrading an existing local workspace? Review
+> [docs/release-notes.md](./docs/release-notes.md) for behavior changes and
+> migration notes before running the setup commands below.
+
+```bash
+cd cats-platform
+cp .env.example .env
+npm install
+npm run dev:server
+# in a second terminal
+npm run dev:web
+```
+
+Default endpoints:
+
+- App API: `http://127.0.0.1:8181`
+- Renderer dev server: `http://127.0.0.1:5173`
+- Runtime dependency: `http://127.0.0.1:3110`
+
+The chat shell persists local state, including created channels,
+global cats, channel cat assignments, execution targets, execution
+lease metadata, memory checkpoints, and transcripts, to
+`~/.cats/platform/state/chat-state.local.json`.
+Override the platform storage root with `CATS_PLATFORM_DIR` when needed.
+
+For a built run:
+
+```bash
+npm run build
+npm start
+```
+
+The Node server will serve the built web UI from `build/renderer/` when available.
+
+For the desktop-host slice:
+
+```bash
+npm run desktop:start
+```
+
+That command builds `build/server/`, `build/renderer/`, and `build/desktop/`, then starts
+the Electron host that supervises local `cats-runtime` and `cats-platform` sidecars.
+
+For host-package smoke validation, the local tarball path now mirrors the
+future `@cats-inc/cats-platform` host package while using the installed
+command `cats-platform`. The separate one-shot bootstrap publication target is
+reserved as `cats-one`.
+
+For staged packaging outputs:
+
+```bash
+npm run desktop:stage
+```
+
+That command keeps the self-hosted npm path intact while generating
+cross-platform packaging manifests under `build/desktop-packaging/`.
+
+For a real Windows installer:
+
+```bash
+npm run desktop:package:windows
+npm run desktop:package:windows -- --sidecar-layout bundle
+npm run desktop:package:windows -- --sidecar-layout split
+```
+
+Those commands build `cats-runtime`, build `cats-platform`, and produce an NSIS installer
+under `release/`. `--sidecar-layout bundle` forces both sidecars into single-file
+bundles for the packaged app, while `--sidecar-layout split` keeps the original
+multi-file layout.
+
+For macOS/Linux unsigned or test packages:
+
+```bash
+npm run desktop:package:macos
+npm run desktop:package:linux
+node scripts/build-desktop-installer.mjs --target macos --arch x64 --format dmg --sidecar-layout split
+node scripts/build-desktop-installer.mjs --target linux --arch arm64 --format deb --sidecar-layout bundle
+```
+
+For unpacked validation on Unix targets:
+
+```bash
+./scripts/macos/test-macos-package-smoke.sh
+./scripts/linux/test-linux-package-smoke.sh
+```
+
+For a post-install validation pass on Windows:
+
+```powershell
+.\scripts\windows\Test-WindowsInstallerSmoke.ps1
+```
+
+## Documentation
+
+See [docs/](./docs/) for project details:
+
+- [Requirements](./docs/requirements.md)
+- [Architecture](./docs/architecture.md)
+- [API](./docs/api.md)
+- [Setup Guide](./docs/setup-guide.md)
+- [Testing](./docs/testing.md)
+- [Contributing](./CONTRIBUTING.md)
+
+## Project Structure
+
+```text
+cats-platform/
+├── desktop/host/  # Desktop host bootstrap and supervision
+├── src/app/       # Platform-level server and renderer assembly
+├── src/products/  # Product slices such as Cats Chat
+├── src/shared/    # Types shared by server and renderer
+├── tests/         # Node built-in test runner coverage
+├── docs/          # Product, API, architecture, and delivery docs
+├── scripts/       # Cross-platform project automation scripts
+├── config/        # Future app and orchestration config
+└── assets/        # Future product assets
+```
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](./LICENSE).

package/build/desktop/bootstrapDiagnostics.d.ts

@@ -0,0 +1,39 @@
+import type { DesktopBootstrapAggregationBundle, DesktopBootstrapEvent, DesktopBootstrapEventError, DesktopBootstrapEventReference, DesktopBootstrapEventStatus, DesktopHealthStatus, DesktopHostDiagnosticsState, DesktopManagedServiceLog, DesktopProductBootstrapDiagnostics, ManagedServiceName } from './contracts.js';
+export declare function createBootstrapAttemptId(now?: Date): string;
+export declare function toDesktopBootstrapStatus(value: DesktopHealthStatus | DesktopBootstrapEventStatus | null | undefined, fallback?: DesktopBootstrapEventStatus): DesktopBootstrapEventStatus;
+export declare function toDesktopBootstrapError(error: unknown): DesktopBootstrapEventError | null;
+export declare function createDesktopBootstrapEvent(input: {
+    layer: DesktopBootstrapEvent['layer'];
+    kind: string;
+    timestamp?: string;
+    attemptId?: string | null;
+    summary: string;
+    status?: DesktopBootstrapEventStatus | null;
+    context?: Record<string, unknown> | null;
+    error?: DesktopBootstrapEventError | null;
+    reference?: DesktopBootstrapEventReference | null;
+}): DesktopBootstrapEvent;
+export declare function appendHostEvent(state: DesktopHostDiagnosticsState, event: DesktopBootstrapEvent): DesktopHostDiagnosticsState;
+export declare function appendRuntimeEvent(state: DesktopHostDiagnosticsState, event: DesktopBootstrapEvent): DesktopHostDiagnosticsState;
+export declare function updateServiceLogs(state: DesktopHostDiagnosticsState, logs: DesktopManagedServiceLog[], now: string): DesktopHostDiagnosticsState;
+export declare function buildDesktopAggregationBundle(input: {
+    generatedAt: string;
+    attemptId: string | null;
+    runtimeEvents: DesktopBootstrapEvent[];
+    product: DesktopProductBootstrapDiagnostics | null;
+    hostEvents: DesktopBootstrapEvent[];
+    runtimeFallback: {
+        status: DesktopBootstrapEventStatus;
+        summary: string;
+    };
+    productFallback?: {
+        status: DesktopBootstrapEventStatus;
+        summary: string;
+    };
+    hostFallback: {
+        status: DesktopBootstrapEventStatus;
+        summary: string;
+    };
+}): DesktopBootstrapAggregationBundle;
+export declare function createEmptyDesktopDiagnosticsState(serviceNames: ManagedServiceName[]): DesktopHostDiagnosticsState;
+//# sourceMappingURL=bootstrapDiagnostics.d.ts.map

package/build/desktop/bootstrapDiagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapDiagnostics.d.ts","sourceRoot":"","sources":["../../desktop/host/bootstrapDiagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,iCAAiC,EACjC,qBAAqB,EACrB,0BAA0B,EAC1B,8BAA8B,EAC9B,2BAA2B,EAE3B,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,kCAAkC,EAClC,kBAAkB,EACnB,MAAM,gBAAgB,CAAC;AA8GxB,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAGvE;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,mBAAmB,GAAG,2BAA2B,GAAG,IAAI,GAAG,SAAS,EAC3E,QAAQ,GAAE,2BAAoC,GAC7C,2BAA2B,CAO7B;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,0BAA0B,GAAG,IAAI,CAmBnC;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,KAAK,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,KAAK,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC1C,SAAS,CAAC,EAAE,8BAA8B,GAAG,IAAI,CAAC;CACnD,GAAG,qBAAqB,CAYxB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,2BAA2B,EAClC,KAAK,EAAE,qBAAqB,GAC3B,2BAA2B,CAU7B;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,2BAA2B,EAClC,KAAK,EAAE,qBAAqB,GAC3B,2BAA2B,CAa7B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,2BAA2B,EAClC,IAAI,EAAE,wBAAwB,EAAE,EAChC,GAAG,EAAE,MAAM,GACV,2BAA2B,CAM7B;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,OAAO,EAAE,kCAAkC,GAAG,IAAI,CAAC;IACnD,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,eAAe,EAAE;QACf,MAAM,EAAE,2BAA2B,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,eAAe,CAAC,EAAE;QAChB,MAAM,EAAE,2BAA2B,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,2BAA2B,CAAC;QACpC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,GAAG,iCAAiC,CAyCpC;AAED,wBAAgB,kCAAkC,CAChD,YAAY,EAAE,kBAAkB,EAAE,GACjC,2BAA2B,CAe7B"}