main
SEC - Structured Ergonomic Cheatsheet & Code Assistant
____ _____ ____
/ ___|| ____/ ___|
\___ \| _|| |
___) | |__| |___
|____/|_____\____|
Author: Simon the Coder
<simon@luxhebros.com>
Specification Version: 1.0.0-alpha
Runtime Environment: Python 3.10+ / Gravitiny Applet Platform
License: MIT Open Source License
1. Abstract & Motivation
Developers in drop-down/modal terminal environments frequently execute queries under tight spatial and temporal constraints. sec is designed to minimize motor latency by constraining command naming to the left-hand QWERTY region (s, e, c) while providing deterministic query routing and semantic AST-style snippet extraction.
2. Mathematical & Heuristic Routing Architecture
The QueryRouter class decomposes freeform CLI tokens T = \{t_1, t_2, \dots, t_n\} through prioritized candidate generation:
- Programming Language Scoping: Maps
t_1 \in \mathcal{L}to canonical StackOverflow question endpoints. - Deterministic Synonym Permutation: Dynamically expands programmatic verbs (
\text{serialize} \to \{\text{dump}, \text{dumps}, \text{write}, \text{stringify}\}). - Dual-Mode Clipboard Pipeline:
-c(Code Extraction): Strips commentary and markdown headers, isolating executable syntax trees.-c a(Full Context): Captures complete documentation cards.
3. Invocation Examples
# Language-scoped snippet retrieval
sec python json serialize -c
# System utility lookup
sec tar extract
# Diagnostic query
sec linux memory usage
# Full context clipboard copy
sec docker container prune -c a
4. Technical Invariants
- Asynchronous & Offline Fallback: Persistent SQLite response cache (
data/cache.db). - Zero ANSI Pollution: Strict stream sanitization on pipeline redirection.
- Pure Dependency Decoupling: Fully compliant with Gravitiny specification v0.1.0.
Description
Ergonomic, heuristic-routed CLI cheat sheet and code snippet assistant powered by cheat.sh
62 KiB
Languages
Python
100%