Merge pull request #103 from codervisor:copilot/implement-spec-181

Deprecate TypeScript core in favor of Rust implementation (spec 181)

Author: tikazyq

.github/workflows/copilot-setup-steps.yml

@@ -40,9 +40,6 @@ jobs:
       - name: Install JavaScript dependencies
         run: pnpm install --frozen-lockfile
 
-      - name: Build lean-spec CLI (TypeScript)
-        run: pnpm --filter lean-spec run build
-
       - name: Set up Rust toolchain
         uses: actions-rust-lang/setup-rust-toolchain@v1
 

CONTRIBUTING.md

@@ -36,10 +36,10 @@ pnpm typecheck    # Type check all packages (with caching)
 All packages in the monorepo maintain synchronized versions automatically. The root `package.json` serves as the single source of truth.
 
 **Packages:**
-- `lean-spec` (CLI package)
-- `@leanspec/core` (shared core library)
+- `lean-spec` (CLI package - wrapper for Rust binary)
 - `@leanspec/ui` (web UI package)
 - `@leanspec/mcp` (MCP server wrapper)
+- `@leanspec/desktop` (Tauri desktop app)
 
 ### Automated Version Sync
 
@@ -121,9 +121,10 @@ This project uses [Turborepo](https://turbo.build/) to manage the monorepo with
 - **Task dependencies** - Dependencies built first automatically
 
 **Packages:**
-- `packages/cli` - Main CLI tool (published as `lean-spec`)
-- `packages/core` - Core spec parsing/validation library (internal)
-- `packages/web` - Live specs showcase (Next.js app)
+- `packages/cli` - CLI wrapper for Rust binary (published as `lean-spec`)
+- `packages/mcp` - MCP server wrapper (published as `@leanspec/mcp`)
+- `packages/ui` - Web UI bundle (published as `@leanspec/ui`)
+- `packages/desktop` - Tauri desktop app (not published to npm)
 - `docs-site/` - Git submodule pointing to `codervisor/lean-spec-docs` (Docusaurus)
 
 **Key files:**
@@ -134,7 +135,19 @@ This project uses [Turborepo](https://turbo.build/) to manage the monorepo with
 **Build specific package:**
 ```bash
 turbo run build --filter=lean-spec
-turbo run build --filter=@leanspec/core
+turbo run build --filter=@leanspec/ui
+```
+
+**Rust Development:**
+```bash
+# Build Rust binaries
+pnpm rust:build
+
+# Run Rust tests
+pnpm rust:test
+
+# Copy binaries to packages
+pnpm rust:copy
 ```
 
 ## Testing

docs/agents/PUBLISHING.md

@@ -1,6 +1,16 @@
 # Publishing Releases
 
-**Publish both CLI and UI packages to npm with synchronized versions:**
+**Publish CLI and UI packages to npm with synchronized versions:**
+
+## Architecture Overview
+
+With the Rust migration complete (spec 181):
+- **CLI** (`lean-spec`) - JavaScript wrapper that invokes Rust binary
+- **MCP** (`@leanspec/mcp`) - JavaScript wrapper that invokes Rust MCP binary  
+- **UI** (`@leanspec/ui`) - Next.js app with inlined utilities
+- **Platform packages** - Rust binaries for each platform (published separately)
+
+The Rust binaries are distributed via optional dependencies (e.g., `lean-spec-darwin-arm64`).
 
 ## Publishing Dev Versions
 
@@ -48,12 +58,12 @@ The `.github/workflows/publish-dev.yml` workflow will automatically:
 
 ⚠️ **CRITICAL**: All steps must be completed in order. Do NOT skip steps.
 
-1. **Version bump**: Update version in all package.json files (root, cli, core, ui, mcp) for consistency
+1. **Version bump**: Update version in all package.json files (root, cli, ui, mcp) for consistency
 2. **Update CHANGELOG.md**: Add release notes with date and version
 3. **Type check**: Run `pnpm typecheck` to catch type errors (REQUIRED before release)
-4. **Test**: Run `pnpm test:run` to ensure tests pass (web DB tests may fail - that's OK)
+4. **Test**: Run `pnpm test:run` to ensure tests pass
 5. **Build**: Run `pnpm build` to build all packages
-6. **Validate**: Run `node bin/lean-spec.js validate` and `cd docs-site && npm run build` to ensure everything works
+6. **Validate**: Run `node bin/lean-spec.js validate --warnings-only` and `cd docs-site && npm run build` to ensure everything works
 7. **Commit & Tag**: 
    ```bash
    git add -A && git commit -m "feat: release version X.Y.Z with [brief description]"
@@ -64,10 +74,9 @@ The `.github/workflows/publish-dev.yml` workflow will automatically:
    - ⚠️ **CRITICAL**: This step prevents `workspace:*` from leaking into npm packages
    - Creates backups of original package.json files
    - Replaces all `workspace:*` dependencies with actual versions
-9. **Publish to npm**: For each package (core, cli, mcp, ui):
+9. **Publish to npm**: For each package (cli, mcp, ui):
    ```bash
-   cd packages/core && npm publish --access public
-   cd ../cli && npm publish --access public
+   cd packages/cli && npm publish --access public
    cd ../mcp && npm publish --access public
    cd ../ui && npm publish --access public
    ```
@@ -90,7 +99,6 @@ The `.github/workflows/publish-dev.yml` workflow will automatically:
    [List enhancements]
    
    ### 📦 Published Packages
-   - `@leanspec/[email protected]`
    - `[email protected]`
    - `@leanspec/[email protected]`
    - `@leanspec/[email protected]`
@@ -119,14 +127,12 @@ The `.github/workflows/publish-dev.yml` workflow will automatically:
 
 ## Critical - Workspace Dependencies
 
-- The `@leanspec/core` package MUST NOT be in `packages/cli/package.json` dependencies
-- tsup config has `noExternal: ['@leanspec/core']` which bundles the core package
-- NEVER add `@leanspec/core` back to dependencies - it will cause `workspace:*` errors
+- The CLI package is now a thin wrapper for Rust binaries - no need for bundling
 - If you see `workspace:*` in published dependencies, the package is broken and must be republished
 
 ## Package Publication Notes
 
 **Important**: 
-- Do NOT publish `@leanspec/core` or `@leanspec/web` - they are internal packages
 - The `@leanspec/ui` package IS published to npm as a public scoped package
 - Both `lean-spec` (CLI) and `@leanspec/ui` are published automatically via GitHub Actions when a release is created
+- Platform-specific binary packages (e.g., `lean-spec-darwin-arm64`) are published separately via the rust-binaries workflow

package.json

@@ -11,7 +11,7 @@
     "sync-rust-versions": "tsx scripts/sync-rust-versions.ts",
     "publish:platforms": "tsx scripts/publish-platform-packages.ts",
     "publish:main": "tsx scripts/publish-main-packages.ts",
-    "dev": "turbo run dev --filter=@leanspec/ui --filter=@leanspec/core",
+    "dev": "turbo run dev --filter=@leanspec/ui",
     "dev:web": "turbo run dev --filter=@leanspec/ui",
     "dev:cli": "turbo run dev --filter=lean-spec",
     "dev:desktop": "pnpm --filter @leanspec/desktop dev:desktop",

packages/README.md

@@ -6,67 +6,83 @@ This directory contains the LeanSpec monorepo packages.
 
 ```
 packages/
-├── core/       - @leanspec/core: Platform-agnostic spec parsing & validation
-├── cli/        - lean-spec: CLI tool and MCP server (Node.js)
-├── mcp/        - @leanspec/mcp: MCP server wrapper (spec 102)
-└── ui/         - @leanspec/ui: Standalone UI bundle + launcher (spec 087)
+├── cli/        - lean-spec: CLI wrapper for Rust binary
+├── mcp/        - @leanspec/mcp: MCP server wrapper
+├── desktop/    - @leanspec/desktop: Tauri desktop app
+└── ui/         - @leanspec/ui: Standalone UI bundle + launcher
 ```
 
-## @leanspec/core
+## Architecture (Post Rust Migration)
 
-**Platform-agnostic spec parsing and validation library.**
+**As of spec 181**, the core functionality has migrated to Rust:
 
-The core package provides:
-- Type definitions (`SpecInfo`, `SpecFrontmatter`, etc.)
-- Frontmatter parsing (using gray-matter)
-- Validators (frontmatter, structure, line count)
-- Utilities (stats, insights, filters)
-- Abstract storage interface (`SpecStorage`)
-
-**No file system dependencies** - uses storage adapters for platform-specific I/O.
-
-### Usage
+```
+┌─────────────────┐
+│   Desktop App   │
+│ @leanspec/desktop│  ──► Rust backend (leanspec-core)
+└─────────────────┘
 
-```typescript
-import { 
-  parseFrontmatterFromString,
-  FrontmatterValidator,
-  type SpecStorage 
-} from '@leanspec/core';
+┌─────────────────┐
+│   UI App        │
+│  @leanspec/ui   │  ──► Next.js (inlined utilities)
+└─────────────────┘
 
-// Parse frontmatter from markdown content
-const content = await storage.readFile('spec.md');
-const frontmatter = parseFrontmatterFromString(content);
+┌─────────────────┐
+│   CLI           │
+│   lean-spec     │  ──► Rust binary (leanspec-cli)
+└─────────────────┘
 
-// Validate spec
-const validator = new FrontmatterValidator();
-const result = await validator.validate(spec);
+┌─────────────────┐
+│   MCP Server    │
+│ @leanspec/mcp   │  ──► Rust binary (leanspec-mcp)
+└─────────────────┘
 ```
 
+**Key changes:**
+- `@leanspec/core` TypeScript package has been deprecated and deleted
+- CLI is now a thin wrapper that invokes the Rust binary
+- MCP server runs the Rust MCP binary
+- UI inlines minimal utilities (frontmatter, atomic file ops)
+- Desktop uses Tauri with Rust backend
+
 ## lean-spec (CLI)
 
-**Command-line interface and MCP server.**
+**JavaScript wrapper for Rust CLI binary.**
+
+The CLI package provides:
+- Platform detection and binary resolution
+- Fallback to locally built Rust binaries for development
+- Templates for `lean-spec init`
+
+### Usage
+
+```bash
+# Install globally
+npm install -g lean-spec
 
-Implements:
-- All CLI commands (`list`, `create`, `update`, `validate`, etc.)
-- MCP server for AI agent integration
-- FileSystemStorage adapter (Node.js fs operations)
-- Terminal output formatting
+# Or run via npx
+npx lean-spec list
+npx lean-spec create my-feature
+```
 
 ### Development
 
 ```bash
-cd packages/cli
-pnpm install
-pnpm build
-pnpm test
+# Build Rust binaries first
+cd rust && cargo build --release
+
+# Copy binaries to packages
+node scripts/copy-rust-binaries.mjs
+
+# Test CLI
+node bin/lean-spec.js --version
 ```
 
 ## @leanspec/mcp
 
 **MCP server integration wrapper.**
 
-Simple passthrough wrapper that delegates to `lean-spec mcp`. Makes MCP setup more discoverable with a dedicated package name.
+Simple passthrough wrapper that delegates to the Rust MCP binary. Makes MCP setup more discoverable with a dedicated package name.
 
 ### Usage
 
@@ -75,36 +91,39 @@ Simple passthrough wrapper that delegates to `lean-spec mcp`. Makes MCP setup mo
 npx -y @leanspec/mcp
 ```
 
-The package automatically installs `lean-spec` as a dependency and runs `lean-spec mcp`. See [MCP Integration docs](https://lean-spec.dev/docs/guide/usage/ai-assisted/mcp-integration) for setup instructions.
-
-## Storage Adapters
-
-The core package uses abstract storage interfaces to enable platform independence:
-
-### FileSystemStorage (CLI)
-
-```typescript
-// packages/cli/src/adapters/fs-storage.ts
-import { FileSystemStorage } from './adapters/fs-storage.js';
-
-const storage = new FileSystemStorage();
-const content = await storage.readFile('/path/to/spec/README.md');
-```
+See [MCP Integration docs](https://lean-spec.dev/docs/guide/usage/ai-assisted/mcp-integration) for setup instructions.
 
 ## @leanspec/ui
 
 **Published UI bundle and launcher.**
 
 Contains the Next.js application and exposes a CLI (`npx @leanspec/ui`). Used automatically by `lean-spec ui` outside the monorepo.
 
+The UI package inlines minimal utilities (formerly from `@leanspec/core`):
+- `createUpdatedFrontmatter` - Update spec metadata
+- `atomicWriteFile` - Safe file writing
+
 ### Development
 
 ```bash
 pnpm --filter @leanspec/ui build    # build Next.js app and prepare artifacts
 node packages/ui/bin/ui.js --dry-run
 ```
 
-The build script produces `.next/standalone` and prepares assets for publishing via the GitHub Actions workflow.
+## @leanspec/desktop
+
+**Tauri desktop application.**
+
+Cross-platform desktop app using:
+- Rust backend (Tauri commands for spec operations)
+- React/Vite frontend
+- Shared UI components with web app
+
+### Development
+
+```bash
+pnpm --filter @leanspec/desktop dev:desktop
+```
 
 ## Building
 
@@ -115,8 +134,8 @@ pnpm build
 
 Build specific package:
 ```bash
-pnpm --filter @leanspec/core build
-pnpm --filter lean-spec build
+pnpm --filter @leanspec/ui build
+pnpm --filter @leanspec/desktop build
 ```
 
 ## Testing
@@ -128,49 +147,27 @@ pnpm test
 
 Run tests for specific package:
 ```bash
-pnpm --filter @leanspec/core test
-pnpm --filter lean-spec test
+pnpm --filter @leanspec/ui test
 ```
 
 ## Publishing
 
-The CLI package (`lean-spec`), the MCP wrapper (`@leanspec/mcp`), and the UI bundle (`@leanspec/ui`) are published to npm. The core package (`@leanspec/core`) is currently workspace-only but can be published if needed for external use.
+Published packages:
+- `lean-spec` - CLI (wrapper + Rust binary via optional dependencies)
+- `@leanspec/mcp` - MCP server wrapper
+- `@leanspec/ui` - Web UI bundle
 
-## Architecture
-
-```
-┌─────────────────┐
-│   UI App        │
-│  @leanspec/ui   │
-└────────┬────────┘
-         │
-         │ uses Core
-         │
-         ▼
-┌─────────────────┐
-│  @leanspec/core │  ◄── Platform-agnostic
-│                 │
-│  • Types        │
-│  • Parsers      │
-│  • Validators   │
-│  • Utilities    │
-└────────┬────────┘
-         │
-         │ uses FileSystemStorage
-         │
-         ▼
-┌─────────────────┐
-│   CLI & MCP     │
-│   lean-spec     │
-└─────────────────┘
-```
+Platform-specific binary packages (published separately):
+- `lean-spec-darwin-arm64`
+- `lean-spec-darwin-x64`
+- `lean-spec-linux-arm64`
+- `lean-spec-linux-x64`
+- `lean-spec-windows-x64`
 
 ## Migration Notes
 
-The monorepo was created in spec 067 by:
-1. Creating `packages/core/` with extracted shared logic
-2. Moving existing code to `packages/cli/`
-3. Implementing `FileSystemStorage` adapter in CLI
-4. Core package exports validators, parsers, and utilities
-
-**Zero breaking changes** for end users - the `lean-spec` CLI works identically to before.
+**Spec 181 (TypeScript Deprecation)**:
+- Deleted `@leanspec/core` TypeScript package
+- CLI now invokes Rust binary directly
+- UI inlines 2 utility functions (~50 lines)
+- Single source of truth in Rust