website·Indexed 31 days ago
https://shellraining.xyzA personal knowledge base and technical documentation collection covering source code analysis (WaveSurfer, VitePress, hlchunk), Model Context Protocol (MCP) architecture and registry, web fundamentals (Promises/A+, XSS, DOM), and development tool guides for Vite, Tree-sitter, and TypeScript.
Beyond basic scalar and compound types, Rust's core library includes several essential types for memory and function management:
The MCP Registry is a centralized service (similar to an app store) that provides a list of available MCP servers to various MCP clients. It does not host the actual server code; instead, it stores metadata and references to where the code is hosted (e.g., npm, PyPI).
Key architectural constraints:
Clients typically do not query the official registry directly. Instead, they use intermediate mirrors (Marketplaces/Aggregators) that perform ETL (Extract, Transform, Load) operations on the registry data to enhance it before serving it to the end-user.
import.meta is a host-defined object with a null prototype used to access metadata about the current module. Common properties include:
url: The full URL of the module (including query parameters and fragments). In Node.js, this is the file path with the file:// protocol.resolve: A method to resolve a module identifier relative to the current module's URL.The DOM (Document Object Model) represents a web page as a tree of nodes, typically rooted at the <html> element. Common node types include:
document: The root node of the document.element: HTML tags like <div>, <pre>, etc.text: The actual text content within elements.comment: HTML comments.roots capability is declared by the client during initialization. When enabled, it informs the server that it can perform operations (such as reading or writing) on the client's filesystem within the boundaries defined by these roots. This is typically used to identify project root directories, codebase locations, or configuration paths. It is primarily useful for servers communicating via stdio rather than remote transports.Generating a spectrogram involves several key steps to transform raw audio into a visual frequency representation:
fftSample) is required. A larger fftSample provides finer frequency resolution but increases computational load and can cause temporal blurring (longer streaks in the time dimension).noverlap value is used to determine the overlap between FFT windows. For example, a 75% overlap means the window steps forward by 25% of the sample length each time.colorMap to visualize frequency strength..vitepress/config.ts file using a resolveConfig function during the creation of the Vite development server. To make this configuration available to the client, VitePress uses a Vite plugin that creates a virtual module @siteData. When the client requests this module, the server serializes the configuration data and returns it as a JavaScript module containing a deserialization function. On the client side, this data is initialized via initData and injected into the Vue application using the provide API, allowing components to access the configuration via useData.Dotfiles are hidden files (starting with a dot) used as configuration for tools. They are typically stored in one of three locations:
.prettierrc.json).~/.zshrc).$XDG_CONFIG_HOME environment variable, defaulting to $HOME/.config (e.g., ~/.config/nvim/init.lua).There are fundamental differences between import (ES6) and require (CommonJS):
import provides a live reference to the module's content. require imports a shallow copy of the exported object. If a value is changed inside the module, import reflects the change, while require may not if the value was a primitive copied during export.import is resolved during the compilation phase and must be placed at the top level of the file. require is a function that can be called dynamically anywhere in the code.// Example of require's shallow copy behavior
// lib.js
let counter = 3;
function incCounter() {
counter++;
}
module.exports = {
counter: counter,
incCounter: incCounter,
};
// main.js
const mod = require('./lib');
console.log(mod.counter); // 3
mod.incCounter();
console.log(mod.counter); // 3 (Still 3 because counter was copied by value)Alma uses a hybrid memory architecture based on a SQLite vector database stored at ~/Library/Application Support/alma/chat_threads.db. It consists of two main mechanisms:
SearchChatHistory tool that allows the AI to perform keyword-based searches across the full chat history to find details not captured by the structured memory system.