Skip to content

Commit 04dda43

Browse files
AlexMikhalevAlexMikhalev
authored
Merge pull request #218 from terraphim/svelte5-upgrade
Complete Svelte 5 Upgrade with Novel Editor Autocomplete Integration
2 parents b8353d0 + 78c1575 commit 04dda43

134 files changed

Lines changed: 23925 additions & 21165 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.docs/summary-AGENTS.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Summary: AGENTS.md
2+
3+
## File Purpose
4+
Agent development guide providing build commands, code style guidelines, and development workflow instructions for the Terraphim AI project.
5+
6+
## Key Functionality
7+
- **Build Commands**: Rust and Svelte development commands with feature flags
8+
- **Code Style Guidelines**: Rust and frontend coding standards and conventions
9+
- **Development Workflow**: Quality assurance, testing, and deployment patterns
10+
- **Documentation Management**: Guidelines for using the `.docs/` folder organization
11+
12+
## Important Details
13+
- **Rust Guidelines**: Use tokio for async, snake_case naming, Result<T,E> error handling
14+
- **Frontend Guidelines**: Svelte with TypeScript, Bulma CSS, yarn package manager
15+
- **Testing Philosophy**: No mocks, use IDE diagnostics, check test coverage
16+
- **Development Tools**: tmux for background tasks, gh tool for GitHub issues
17+
- **Quality Assurance**: Pre-commit hooks, conventional commits, no sleep/timeout commands
18+
- **Documentation Organization**: Uses `.docs/` folder for file summaries and comprehensive overview
19+
20+
## Architecture Impact
21+
- Establishes consistent development patterns across the project
22+
- Ensures code quality and maintainability standards
23+
- Provides clear guidelines for new contributors
24+
- Defines testing and deployment workflows
25+
- Mandates `/init` command steps for documentation maintenance

‎.docs/summary-CLAUDE.md‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# Summary: CLAUDE.md
2+
3+
## File Purpose
4+
Primary guidance file for Claude Code when working with the Terraphim AI repository, providing comprehensive development guidelines and project context.
5+
6+
## Key Functionality
7+
- **Development Guidelines**: Rust, async programming, and concurrent systems best practices
8+
- **Memory Management**: Documentation organization using `.docs/` folder structure
9+
- **Agent Instructions**: Consolidated machine-readable instructions for AI agents
10+
- **Mandatory /init Command**: Two-step process for documentation maintenance
11+
12+
## Important Details
13+
- **Rust Expertise**: Focus on tokio async runtime, error handling, and performance
14+
- **Documentation Organization**: Uses `.docs/` folder for file summaries and comprehensive overview
15+
- **Agent Systems**: Two agent systems (Superpowers Skills and Terraphim .agents)
16+
- **Quality Standards**: No mocks in tests, IDE diagnostics, comprehensive testing
17+
- **Development Tools**: tmux for background tasks, gh tool for GitHub issues
18+
19+
## Architecture Impact
20+
- Establishes core development principles for the entire project
21+
- Defines documentation structure and maintenance workflows
22+
- Provides comprehensive guidance for AI agents working on the codebase
23+
- Ensures consistent code quality and development practices
24+
- Mandates systematic documentation updates through `/init` command

‎.docs/summary-Cargo.toml.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Summary: Cargo.toml
2+
3+
## Purpose
4+
This is the root Cargo.toml file for the Terraphim AI workspace, defining the multi-crate project structure, dependencies, and build configuration.
5+
6+
## Key Functionality
7+
- Defines a Rust workspace with multiple crates under `crates/*`, `terraphim_server`, and `desktop/src-tauri`
8+
- Excludes experimental crate `terraphim_agent_application` from builds
9+
- Sets default members to `terraphim_server` for focused development
10+
- Specifies Rust edition 2024 for all workspace members
11+
- Provides shared workspace dependencies including Tokio for async runtime, Reqwest for HTTP, Serde for serialization, and error handling libraries
12+
13+
## Important Details
14+
- Uses resolver version 2 for dependency resolution
15+
- Includes OpenRouter AI integration dependencies in workspace scope
16+
- Features like `openrouter`, `mcp-rust-sdk` can be enabled for specific functionality
17+
- Establishes common async and serialization patterns across the entire project

‎.docs/summary-Earthfile‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Summary: Earthfile
2+
3+
## Purpose
4+
This Earthfile defines the build pipeline for Terraphim AI using Earthly, providing multi-platform builds, cross-compilation, and deployment automation.
5+
6+
## Key Functionality
7+
- Defines comprehensive build pipeline with targets for different platforms and use cases
8+
- Supports cross-compilation for multiple architectures (x86_64, ARM64, ARMv7)
9+
- Includes Rust toolchain setup, dependency management, and binary building
10+
- Provides Docker image creation for various deployment scenarios
11+
- Integrates frontend build process and documentation generation
12+
- Features caching and optimization for faster builds
13+
14+
## Important Details
15+
- Uses Ubuntu 20.04 as base image with Rust 1.85.0 toolchain
16+
- Supports musl and glibc targets for static and dynamic linking
17+
- Includes Node.js and Yarn setup for frontend dependencies
18+
- Provides separate targets for native builds, cross-compilation, and containerization
19+
- Integrates with mdbook for documentation and Netlify for deployment
20+
- Handles multi-stage builds with artifact saving and loading

‎.docs/summary-README.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Summary: README.md
2+
3+
## Purpose
4+
This is the main project README for Terraphim AI, serving as the primary documentation and entry point for users, developers, and contributors.
5+
6+
## Key Functionality
7+
- Introduces Terraphim as a privacy-first AI assistant with local operation and deterministic behavior
8+
- Explains core concepts: Haystacks (data sources), Knowledge Graphs, Profiles, Roles, and Rolegraphs
9+
- Provides comprehensive getting started guide with quick start, installation methods (Homebrew, Docker, Debian), and development setup
10+
- Documents configuration for storage backends (local vs cloud), environment variables, and deployment scenarios
11+
- Includes terminology definitions, contribution guidelines, and code style standards
12+
- Features build/lint/test commands for both Rust backend and Svelte frontend
13+
14+
## Important Details
15+
- Emphasizes privacy-first design with local infrastructure operation
16+
- Supports multiple installation methods for end users and developers
17+
- Includes detailed code style guidelines for Rust (Tokio, snake_case, Result<T,E>) and frontend (Svelte, Bulma CSS)
18+
- Mandates conventional commits and pre-commit checks for contributions
19+
- Documents deployment patterns using Caddy reverse proxy and 1Password CLI for secrets
20+
- Contains troubleshooting guides and links to additional documentation

‎.docs/summary-agents_history.txt‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Summary: agents_history.txt
2+
3+
## Purpose
4+
This text file contains a chronological log of agent interactions and development activities within the Terraphim AI system.
5+
6+
## Key Functionality
7+
- Records session-based development activities and progress tracking
8+
- Documents implementation of major features like TruthForge, VM execution, and multi-agent workflows
9+
- Tracks completion of phases, test results, and technical achievements
10+
- Includes debugging sessions, issue resolution, and system status updates
11+
12+
## Important Details
13+
- Covers development from October 2025 with detailed session logs
14+
- Documents completion of TruthForge Phase 5 UI development with vanilla JavaScript
15+
- Records VM execution system implementation with Firecracker integration
16+
- Tracks multi-agent system integration and testing progress
17+
- Includes security testing phases and vulnerability fixes
18+
- Features dynamic model selection system implementation

‎.docs/summary-agents_instructions.json‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
{
2+
"version": "1.0.0",
3+
"description": "Terraphim AI agent instructions and configuration"
4+
}

‎.docs/summary-build_config.toml‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
[build]
2+
target = "x86_64-unknown-linux-gnu"
3+
release = true
4+
5+
[profile.release]
6+
opt-level = 3
7+
lto = true

‎.docs/summary-crates-terraphim_kg_agents-Cargo.toml‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
[package]
2+
name = "terraphim_kg_agents"
3+
version = "0.1.0"
4+
edition = "2021"
5+
6+
[dependencies]
7+
tokio = { version = "1.0", features = ["full"] }
8+
serde = { version = "1.0", features = ["derive"] }
9+
thiserror = "1.0"

‎.docs/summary-desktop-package.json‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
{
2+
"name": "terraphim-search-ui",
3+
"private": true,
4+
"version": "0.0.0",
5+
"type": "module"
6+
}

0 commit comments

Comments
 (0)