Initial Comms Framework

[hbjydev]

This pull request introduces the initial project scaffolding for the Lucid system, establishing core structure, build/test automation, and basic API endpoints. The main changes include setting up workspace configuration, adding CI workflows, creating the foundational crates for the API and agent, and providing an initial OpenAPI schema and authentication handler stubs.

Project Structure and Workspace Setup

• Added Cargo.toml workspace configuration, including shared dependencies and member crates for agent, api, and common (Cargo.toml).
• Created initial crate setup for lucid-agent and lucid-api, including minimal Cargo.toml files and a basic test for the agent (agent/Cargo.toml, api/Cargo.toml, agent/src/lib.rs) [1] [2] [3].

Continuous Integration and Automation

• Introduced GitHub Actions workflows for building, releasing, and validating pull requests, including matrix builds for multiple targets and checks for formatting, linting, and OpenAPI schema consistency (.github/workflows/build.yml, .github/workflows/pr.yml) [1] [2].

API Service Foundations

• Implemented the basic API service structure, including configuration management, context passing, error handling, and server startup (api/src/config.rs, api/src/context/mod.rs, api/src/error.rs, api/src/lib.rs, api/src/main.rs) [1] [2] [3] [4] [5].
• Added initial authentication endpoint handlers with OpenAPI documentation stubs (api/src/handlers/auth/mod.rs, api/src/handlers/mod.rs) [1] [2].

OpenAPI and Documentation

• Added an initial OpenAPI schema describing the authentication endpoints and error responses (api/openapi.json).
• Added AGENTS.md with guidelines for contributing to agent development and coding standards (AGENTS.md).
• Updated README.adoc to outline planned features and documentation links.

These changes lay the groundwork for further development by establishing the project's structure, automation, and initial API contract.

---

Closes #2

[Copilot]

Pull request overview

Introduces initial scaffolding for the Lucid system across Rust workspace crates (api, agent, common) plus a new Vite/React “console” frontend, along with CI workflows and baseline OpenAPI generation.

Changes:

• Added Rust workspace + initial lucid-api, lucid-agent, and lucid-common crates (config/context/error handling, auth stubs, shared params/views/caller).
• Added console frontend scaffold (Vite config, TS config, TanStack Router, Tailwind/Shadcn UI primitives, static assets, Biome config).
• Added CI workflows for build/test/fmt/clippy and OpenAPI schema drift checks, plus initial docs.

Reviewed changes

Copilot reviewed 52 out of 58 changed files in this pull request and generated 11 comments.

Show a summary per file

File	Description
console/vite.config.ts	Vite plugin setup (TanStack Router, devtools, Tailwind, TS path mapping).
console/tsconfig.json	TypeScript config + path aliasing for console.
console/src/styles.css	Tailwind/Shadcn theme + base styles.
console/src/routes/index.tsx	Console landing route component.
console/src/routes/__root.tsx	Root route + TanStack devtools mounting.
console/src/router.tsx	Router factory + module registration typing.
console/src/main.tsx	Console entrypoint mounting RouterProvider + TooltipProvider.
console/src/lib/utils.ts	cn helper (clsx + tailwind-merge).
console/src/hooks/use-mobile.ts	useIsMobile hook for responsive behavior.
console/src/components/ui/tooltip.tsx	Tooltip primitives wrapper.
console/src/components/ui/skeleton.tsx	Skeleton loading component.
console/src/components/ui/sidebar.tsx	Sidebar system (provider, layouts, menu primitives).
console/src/components/ui/sheet.tsx	Sheet (dialog) primitives wrapper.
console/src/components/ui/separator.tsx	Separator primitive wrapper.
console/src/components/ui/label.tsx	Label primitive wrapper.
console/src/components/ui/input.tsx	Styled input component.
console/src/components/ui/field.tsx	Fieldset/field layout helpers + error rendering.
console/src/components/ui/dropdown-menu.tsx	Dropdown menu primitives wrapper.
console/src/components/ui/card.tsx	Card layout primitives.
console/src/components/ui/button.tsx	Button variants via CVA.
console/src/components/ui/breadcrumb.tsx	Breadcrumb primitives.
console/public/tanstack-word-logo-white.svg	Static console asset.
console/public/robots.txt	Robots policy for console.
console/public/manifest.json	Web app manifest for console.
console/public/logo512.png	Static console icon asset.
console/public/logo192.png	Static console icon asset.
console/public/favicon.ico	Static console favicon.
console/package.json	Console dependencies/scripts (Vite, Biome, TanStack, Tailwind, etc.).
console/index.html	Console HTML entry.
console/components.json	Shadcn component generator config.
console/biome.json	Biome formatter/linter configuration for console.
console/.gitignore	Console-specific ignores.
common/src/views/mod.rs	Shared API view models (pagination + error response).
common/src/views/auth/mod.rs	Auth response view (AuthLoginResponse).
common/src/params/mod.rs	Shared API input params (pagination + auth params re-export).
common/src/params/auth/mod.rs	Auth login request params (AuthLoginParams).
common/src/lib.rs	lucid-common module exports.
common/src/caller.rs	Caller/authz abstraction + tests.
common/Cargo.toml	lucid-common crate manifest + feature flags.
api/src/server.rs	Axum router + middleware + OpenAPI router wiring + default error responses injection.
api/src/main.rs	API binary entry (config parse, OpenAPI dump, serve).
api/src/lib.rs	lucid-api module exports.
api/src/handlers/mod.rs	Handlers module scaffold.
api/src/handlers/auth/mod.rs	Auth endpoint stubs + utoipa annotations.
api/src/error.rs	API error type + IntoResponse mapping.
api/src/context/mod.rs	API context wrapper.
api/src/config.rs	CLI/env configuration for API service.
api/openapi.json	Generated OpenAPI snapshot checked into repo.
api/Cargo.toml	lucid-api crate manifest.
agent/src/lib.rs	Minimal agent crate stub + test.
agent/Cargo.toml	lucid-agent crate manifest.
README.adoc	Project README updates (features placeholder).
Cargo.toml	Workspace members + shared dependency versions.
AGENTS.md	Contribution guidelines (deps in workspace, run fmt, test expectations).
.github/workflows/pr.yml	PR validation (test/fmt/clippy/OpenAPI drift).
.github/workflows/build.yml	Multi-target release build + artifact packaging + GitHub release draft.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.