Merge pull request #88 from Corvidae-Coding-Projects/develop

release: promote develop to main

Author: dollspace-gay

.claude/hooks/work-check.py

@@ -1,33 +1,33 @@
 #!/usr/bin/env python3
-# /// script
-# requires-python = ">=3.10"
-# dependencies = []
-# ///
-"""
-Crosslink Agent Prompt MCP Server
 
-An MCP server that provides reliable prompt delivery to tmux-based agent sessions.
-Wraps `crosslink agent prompt` to avoid the pitfalls of raw `tmux send-keys`.
 
-Usage:
-    Registered in .claude/settings.json as an MCP server.
-    Claude calls mcp__crosslink-agent-prompt__agent_prompt(session, prompt) to send prompts.
-"""
+
+
+
+
+
+
+
+
+
+
+
+
 
 import json
 import sys
 import io
 import subprocess
 from typing import Any
 
-# Fix Windows encoding issues
+
 sys.stdin = io.TextIOWrapper(sys.stdin.buffer, encoding='utf-8')
 sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8', line_buffering=True)
 sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
 
 
 def log(message: str) -> None:
-    """Log to stderr (visible in MCP server logs)."""
+
     print(f"[agent-prompt] {message}", file=sys.stderr)
 
 
@@ -62,7 +62,7 @@ def log(message: str) -> None:
 
 
 def handle_agent_prompt(arguments: dict[str, Any]) -> dict[str, Any]:
-    """Handle the agent_prompt tool call by delegating to crosslink CLI."""
+
     session = arguments.get('session', '').strip()
     prompt = arguments.get('prompt', '')
     submit = arguments.get('submit', True)
@@ -116,7 +116,7 @@ def handle_agent_prompt(arguments: dict[str, Any]) -> dict[str, Any]:
 
 
 def handle_request(request: dict[str, Any]) -> dict[str, Any] | None:
-    """Handle an MCP JSON-RPC request."""
+
     method = request.get('method', '')
     request_id = request.get('id')
     params = request.get('params', {})
@@ -182,7 +182,7 @@ def handle_request(request: dict[str, Any]) -> dict[str, Any] | None:
 
 
 def main():
-    """Main MCP server loop - reads JSON-RPC from stdin, writes to stdout."""
+
     log("Starting agent-prompt MCP server")
 
     while True:

.claude/mcp/agent-prompt-server.py

@@ -1,15 +1,12 @@
-# Multi-agent collaboration (machine-local)
 agent.json
 .hub-cache/
 .knowledge-cache/
 keys/
 integrations/
 
-# Machine-local overrides
 hook-config.local.json
 rules.local/
 
-# Machine-local runtime state (never commit — regenerated per machine)
 .active-issue
 .last-hydrated-ref
 .promoted-uuids

.crosslink/.gitignore

@@ -1,6 +1,6 @@
-# Forecast Visual Design System
+# Crosslink Visual Design System
 
-Reference for the Forecast brand visual language as implemented in crosslink docs and reusable across projects.
+Reference for the Crosslink brand visual language as implemented in crosslink docs and reusable across projects.
 
 ## Brand Palette (from `_brand.yml`)
 
@@ -25,13 +25,13 @@ Reference for the Forecast brand visual language as implemented in crosslink doc
 
 Shapes use only: ellipses, circles, rounded rectangles. No triangles or crescents.
 
-All shapes use `mix-blend-mode: multiply` — no alpha transparency on shapes. This creates the layered, overlapping Forecast look where colors interact.
+All shapes use `mix-blend-mode: multiply` — no alpha transparency on shapes. This creates the layered, overlapping Crosslink look where colors interact.
 
 ## Confetti Dots
 
 Small colored circles scattered as decorative accents, always with `mix-blend-mode: multiply`.
 
-### Color distribution (from forecast.bio homepage)
+### Color distribution (from Crosslink visual palette)
 
 Weighted random sampling matching the original site's `kConfetti` array:
 
@@ -54,7 +54,7 @@ Grey-dominant with colored accents. This keeps confetti subtle while the colored
 ### Animated confetti (footer JS)
 
 - 14 dots, 11px diameter
-- Positioned in a **cone shape** emanating up-right from the Forecast wordmark
+- Positioned in a **cone shape** emanating up-right from the Crosslink wordmark
 - Cone origin at logo baseline, slope drifts upward (-0.28 rise per px)
 - Spread grows with distance (cone half-angle 0.22)
 - Extra noise (±10px) on both axes for fuzzy edges
@@ -98,10 +98,10 @@ Small 2-4 shape compositions for feature cards, each evocative of the feature:
 
 ## Footer
 
-Matches forecast.bio card pages:
+Matches Crosslink documentation pages:
 1. Thin rule (`#ede3e3`, 220px)
 2. Wordmark + animated confetti cone (same row, flex, aligned to baseline)
-3. Copyright notice (`© 2026 Forecast Bio, Inc. · Built with Quarto`)
+3. Copyright notice (`© 2026 Crosslink contributors · Built with Quarto`)
 
 Footer is injected via `include-after-body` and JS-relocated into Quarto's `<main class="content">` for proper content-column alignment.
 

…owledge/forecast-visual-design-system.md …wledge/crosslink-visual-design-system.md.crosslink/knowledge/forecast-visual-design-system.md renamed to .crosslink/knowledge/crosslink-visual-design-system.md .crosslink/knowledge/forecast-visual-design-system.md renamed to .crosslink/knowledge/crosslink-visual-design-system.md

@@ -1,43 +0,0 @@
-### C Best Practices
-
-#### Memory Safety
-- Always check return values of malloc/calloc
-- Free all allocated memory (use tools like valgrind)
-- Initialize all variables before use
-- Use sizeof() with the variable, not the type
-
-```c
-// GOOD: Safe memory allocation
-int *arr = malloc(n * sizeof(*arr));
-if (arr == NULL) {
-    return -1;  // Handle allocation failure
-}
-// ... use arr ...
-free(arr);
-
-// BAD: Unchecked allocation
-int *arr = malloc(n * sizeof(int));
-arr[0] = 1;  // Crash if malloc failed
-```
-
-#### Buffer Safety
-- Always bounds-check array access
-- Use `strncpy`/`snprintf` instead of `strcpy`/`sprintf`
-- Validate string lengths before copying
-
-```c
-// GOOD: Safe string copy
-char dest[64];
-strncpy(dest, src, sizeof(dest) - 1);
-dest[sizeof(dest) - 1] = '\0';
-
-// BAD: Buffer overflow risk
-char dest[64];
-strcpy(dest, src);  // No bounds check
-```
-
-#### Security
-- Never use `gets()` (use `fgets()`)
-- Validate all external input
-- Use constant-time comparison for secrets
-- Avoid integer overflow in size calculations

.crosslink/rules/c.md

@@ -1,39 +0,0 @@
-### C++ Best Practices
-
-#### Modern C++ (C++17+)
-- Use smart pointers (`unique_ptr`, `shared_ptr`) over raw pointers
-- Use RAII for resource management
-- Prefer `std::string` and `std::vector` over C arrays
-- Use `auto` for complex types, explicit types for clarity
-
-```cpp
-// GOOD: Modern C++ with smart pointers
-auto config = std::make_unique<Config>();
-auto users = std::vector<User>{};
-
-// BAD: Manual memory management
-Config* config = new Config();
-// ... forgot to delete
-```
-
-#### Error Handling
-- Use exceptions for exceptional cases
-- Use `std::optional` for values that may not exist
-- Use `std::expected` (C++23) or result types for expected failures
-
-```cpp
-// GOOD: Optional for missing values
-std::optional<User> findUser(const std::string& id) {
-    auto it = users.find(id);
-    if (it == users.end()) {
-        return std::nullopt;
-    }
-    return it->second;
-}
-```
-
-#### Security
-- Validate all input boundaries
-- Use `std::string_view` for non-owning string references
-- Avoid C-style casts; use `static_cast`, `dynamic_cast`
-- Never use `sprintf`; use `std::format` or streams

.crosslink/rules/cpp.md

@@ -1,51 +0,0 @@
-### C# Best Practices
-
-#### Code Style
-- Follow .NET naming conventions (PascalCase for public, camelCase for private)
-- Use `var` when type is obvious from right side
-- Use expression-bodied members for simple methods
-- Enable nullable reference types
-
-```csharp
-// GOOD: Modern C# style
-public class UserService
-{
-    private readonly IUserRepository _repository;
-
-    public UserService(IUserRepository repository)
-        => _repository = repository;
-
-    public async Task<User?> GetUserAsync(string id)
-        => await _repository.FindByIdAsync(id);
-}
-```
-
-#### Error Handling
-- Use specific exception types
-- Never catch and swallow exceptions silently
-- Use `try-finally` or `using` for cleanup
-
-```csharp
-// GOOD: Proper async error handling
-public async Task<Result<User>> GetUserAsync(string id)
-{
-    try
-    {
-        var user = await _repository.FindByIdAsync(id);
-        return user is null
-            ? Result<User>.NotFound()
-            : Result<User>.Ok(user);
-    }
-    catch (DbException ex)
-    {
-        _logger.LogError(ex, "Database error fetching user {Id}", id);
-        throw;
-    }
-}
-```
-
-#### Security
-- Use parameterized queries (never string interpolation for SQL)
-- Validate all input with data annotations or FluentValidation
-- Use ASP.NET's built-in anti-forgery tokens
-- Store secrets in Azure Key Vault or similar

.crosslink/rules/csharp.md

@@ -1,57 +0,0 @@
-# Phoenix & LiveView Rules
-
-## HEEx Template Syntax (Critical)
-- **Attributes use `{}`**: `<div id={@id}>` — never `<%= %>` in attributes
-- **Body values use `{}`**: `{@value}` — use `<%= %>` only for blocks (if/for/cond)
-- **Class lists require `[]`**: `class={["base", @flag && "active"]}` — bare `{}` is invalid
-- **No `else if`**: Use `cond` for multiple conditions
-- **Comments**: `<%!-- comment --%>`
-- **Literal curlies**: Use `phx-no-curly-interpolation` on parent tag
-
-## Phoenix v1.8
-- Wrap templates with `<Layouts.app flash={@flash}>` (already aliased)
-- `current_scope` errors → move routes to proper `live_session`, pass to Layouts.app
-- `<.flash_group>` only in layouts.ex
-- Use `<.icon name="hero-x-mark">` for icons, `<.input>` for form fields
-
-## LiveView
-- Use `<.link navigate={}>` / `push_navigate`, not deprecated `live_redirect`
-- Hooks with own DOM need `phx-update="ignore"`
-- Avoid LiveComponents unless necessary
-- No inline `<script>` tags — use assets/js/app.js
-
-## Streams (Always use for collections)
-```elixir
-stream(socket, :items, items)           # append
-stream(socket, :items, items, at: -1)   # prepend
-stream(socket, :items, items, reset: true)  # filter/refresh
-```
-Template: `<div id="items" phx-update="stream">` with `:for={{id, item} <- @streams.items}`
-- Streams aren't enumerable — refetch + reset to filter
-- Empty states: `<div class="hidden only:block">Empty</div>` as sibling
-
-## Forms
-```elixir
-# LiveView: always use to_form
-assign(socket, form: to_form(changeset))
-```
-```heex
-<%!-- Template: always @form, never @changeset --%>
-<.form for={@form} id="my-form" phx-submit="save">
-  <.input field={@form[:name]} type="text" />
-</.form>
-```
-- Never `<.form let={f}>` or `<.form for={@changeset}>`
-
-## Router
-- Scope alias is auto-prefixed: `scope "/", AppWeb do` → `live "/users", UserLive` = `AppWeb.UserLive`
-
-## Ecto
-- Preload associations accessed in templates
-- Use `Ecto.Changeset.get_field/2` to read changeset fields
-- Don't cast programmatic fields (user_id) — set explicitly
-
-## Testing
-- Use `has_element?(view, "#my-id")`, not raw HTML matching
-- Debug selectors: `LazyHTML.filter(LazyHTML.from_fragment(render(view)), "selector")`
-

.crosslink/rules/elixir-phoenix.md

@@ -1,39 +0,0 @@
-# Elixir Core Rules
-
-## Critical Mistakes to Avoid
-- **No early returns**: Last expression in a block is always returned
-- **No list indexing with brackets**: Use `Enum.at(list, i)`, not `list[i]`
-- **No struct access syntax**: Use `struct.field`, not `struct[:field]` (structs don't implement Access)
-- **Rebinding in blocks doesn't work**: `socket = if cond, do: assign(socket, :k, v)` - bind the result, not inside
-- **`%{}` matches ANY map**: Use `map_size(map) == 0` guard for empty maps
-- **No `String.to_atom/1` on user input**: Memory leak risk
-- **No nested modules in same file**: Causes cyclic dependencies
-
-## Pattern Matching & Functions
-- Match on function heads over `if`/`case` in bodies
-- Use guards: `when is_binary(name) and byte_size(name) > 0`
-- Use `with` for chaining `{:ok, _}` / `{:error, _}` operations
-- Predicates end with `?` (not `is_`): `valid?/1` not `is_valid/1`
-- Reserve `is_thing` names for guard macros
-
-## Data Structures
-- Prepend to lists: `[new | list]` not `list ++ [new]`
-- Structs for known shapes, maps for dynamic data, keyword lists for options
-- Use `Enum` over recursion; use `Stream` for large collections
-
-## OTP
-- `GenServer.call/3` for sync (prefer for back-pressure), `cast/2` for fire-and-forget
-- DynamicSupervisor/Registry require names: `{DynamicSupervisor, name: MyApp.MySup}`
-- `Task.async_stream(coll, fn, timeout: :infinity)` for concurrent enumeration
-
-## Testing & Debugging
-- `mix test path/to/test.exs:123` - run specific test
-- `mix test --failed` - rerun failures
-- `dbg/1` for debugging output
-
-## Documentation Lookup
-```bash
-mix usage_rules.docs Enum.zip/1              # Function docs
-mix usage_rules.search_docs "query" -p pkg   # Search package docs
-```
-