refactor: rename kq:// scheme, markers, env and remaining brand refs to kqs

Author: bimawa

.kiro/steering/conventions.md

@@ -1,17 +1,17 @@
-# Conventions Steering: kq
+# Conventions Steering: kqs
 
 ## Repository Structure
 
 ### Два репозитория
 
 ```
 VideoCatDoc/                    # корневой репозиторий проекта (пример)
-├── README.md                   # АВТОГЕНЕРИРУЕТСЯ kq: канбан, статусы, ссылки
+├── README.md                   # АВТОГЕНЕРИРУЕТСЯ kqs: канбан, статусы, ссылки
 ├── docs/                       # документация проекта рядом с кодом
 └── src/
 
 ~/.knowledge/                   # knowledge-репозиторий (путь настраивается)
-├── knowledge.toml              # конфиг kq
+├── knowledge.toml              # конфиг kqs
 ├── README.md                   # описание knowledge-репозитория
 ├── docs/                       # база знаний (markdown)
 ├── tasks/                      # задачи (TASK-NNN.md)
@@ -37,15 +37,15 @@ VideoCatDoc/                    # корневой репозиторий про
 ### README-блок (автогенерация)
 
 ```markdown
-<!-- kq:start -->
+<!-- kqs:start -->
 ## 🎯 Статус
-<!-- kq генерирует: канбан, статистику, ссылки на docs -->
-<!-- kq:end -->
+<!-- kqs генерирует: канбан, статистику, ссылки на docs -->
+<!-- kqs:end -->
 ```
 
-- kq пишет ТОЛЬКО между маркерами `<!-- kq:start -->` / `<!-- kq:end -->`
+- kqs пишет ТОЛЬКО между маркерами `<!-- kqs:start -->` / `<!-- kqs:end -->`
 - Ручные правки вне маркеров неприкосновенны
-- Если маркеров нет — kq НЕ трогает README (первый раз вставляет маркеры с пустым блоком)
+- Если маркеров нет — kqs НЕ трогает README (первый раз вставляет маркеры с пустым блоком)
 
 ## Git Workflow
 

.kiro/steering/principles.md

@@ -1,4 +1,4 @@
-# Project Principles: kq
+# Project Principles: kqs
 
 > Status: Active
 > Last Updated: 2026-07-09
@@ -31,7 +31,7 @@
 **Level:** MUST  
 **Rule:** Никакого веб-сервера, REST API, Web UI. Chistый CLI + background daemon.  
 Obsidian (или любой markdown-редактор) — интерфейс для чтения и редактирования.  
-**Reason:** kq не заменяет Obsidian. kq решает то, чего нет в Obsidian: sync, 
+**Reason:** kqs не заменяет Obsidian. kqs решает то, чего нет в Obsidian: sync, 
 поиск, AI, таски.  
 **Applies to:** PRD, SPEC, TASKS, EXEC, REVIEW
 
@@ -64,17 +64,17 @@ Push — только по команде `kqs push`.
 ### P-006: README is Auto-Generated
 
 **Level:** SHOULD  
-**Rule:** kq обновляет README проекта после каждого push. Ручные правки 
-сохраняются — kq пишет только между маркерами `<!-- kq:start -->`.  
+**Rule:** kqs обновляет README проекта после каждого push. Ручные правки
+сохраняются — kqs пишет только между маркерами `<!-- kqs:start -->`.
 **Reason:** README всегда актуален. Никто не забывает обновить статус задач.  
 **Applies to:** PRD, SPEC, TASKS, EXEC
 
 ### P-007: Minimal Surprise
 
 **Level:** SHOULD  
-**Rule:** kq не делает ничего, что пользователь не просил. Watcher коммитит 
-локально — не пушит. kqs push спрашивает при конфликте.  
-**Reason:** Доверие пользователя. kq — инструмент, а не автопилот.  
+**Rule:** kqs не делает ничего, что пользователь не просил. Watcher коммитит
+локально — не пушит. kqs push спрашивает при конфликте.
+**Reason:** Доверие пользователя. kqs — инструмент, а не автопилот.
 **Applies to:** SPEC, TASKS, EXEC, REVIEW
 
 ### P-008: Trace Graph is a Cache
@@ -87,14 +87,14 @@ Push — только по команде `kqs push`.
 ### P-009: Cross-Repo Scanning — Pull, Not Push
 
 **Level:** SHOULD
-**Rule:** kq сканирует внешние репозитории через локальную файловую систему (предполагается clone), не через API. kq НЕ пушит изменения в code-repos.
-**Reason:** Безопасность и изоляция. kq не заходит в чужой CI/CD.
+**Rule:** kqs сканирует внешние репозитории через локальную файловую систему (предполагается clone), не через API. kqs НЕ пушит изменения в code-repos.
+**Reason:** Безопасность и изоляция. kqs не заходит в чужой CI/CD.
 **Applies to:** SPEC, TASKS, EXEC
 
 ### P-010: Code Anchors — Convention, Not Enforced
 
 **Level:** SHOULD
-**Rule:** Аннотации `@doc-anchor` и `@see` в исходниках — опциональный стандарт. kq не ломает сборку при их отсутствии, только предупреждает в `kqs check`.
+**Rule:** Аннотации `@doc-anchor` и `@see` в исходниках — опциональный стандарт. kqs не ломает сборку при их отсутствии, только предупреждает в `kqs check`.
 **Reason:** Адаптация gradual. Насилие над командой не работает.
 **Applies to:** PRD, SPEC, TASKS
 

.kiro/steering/product.md

@@ -1,14 +1,14 @@
-# Product Steering: kq — Git-native Knowledge Platform
+# Product Steering: kqs — Git-native Knowledge Platform
 
 ## Product Vision
 
-kq — CLI-инструмент для управления знаниями и документацией в Git + markdown.
+kqs — CLI-инструмент для управления знаниями и документацией в Git + markdown.
 Синхронизация, поиск (полнотекстовый + векторный), AI-помощь, трекинг задач
 и **трассировка зависимостей** между документацией и кодом —
 всё в одном бинарнике, без серверов и баз данных.
 
 Obsidian (или любой markdown-редактор) — интерфейс для чтения и редактирования.
-kq решает то, чего нет в Obsidian: multi-repo sync, кросс-репозиторный поиск,
+kqs решает то, чего нет в Obsidian: multi-repo sync, кросс-репозиторный поиск,
 AI из CLI, управление задачами, авто-обновление README
 и **глубокая трассировка** требований до кода.
 
@@ -29,7 +29,7 @@ AI из CLI, управление задачами, авто-обновлени
 - Знания рядом с кодом: docs и tasks в Git, не в Notion/Confluence
 - Поиск без API-ключей: семантический поиск работает полностью офлайн
 - README всегда актуален: канбан-доска и статусы задач обновляются автоматически
-- **Трассировка без боли: kq сам находит сирот и битые ссылки между docs и кодом**
+- **Трассировка без боли: kqs сам находит сирот и битые ссылки между docs и кодом**
 - Любой участник работает в удобном редакторе — это просто .md файлы
 
 ## Product Boundaries
@@ -72,7 +72,7 @@ AI из CLI, управление задачами, авто-обновлени
 
 ## Domain Glossary
 
-- **knowledge.toml** — конфигурационный файл kq
+- **knowledge.toml** — конфигурационный файл kqs
 - **kqs** — название CLI-утилиты (пакет `kqs` на crates.io)
 - **Watcher** — модуль отслеживания файловой системы
 - **sqlite-vec** — SQLite extension для векторного поиска

.kiro/steering/tech-stack.md

@@ -1,4 +1,4 @@
-# Tech Stack Steering: kq
+# Tech Stack Steering: kqs
 
 ## Runtime / Platform
 

README.md

@@ -49,7 +49,7 @@ kqs --doc doc new adr "Title"
 kqs check traceability
 
 # Via env
-KQ_MODE=dev kqs check scan
+KQS_MODE=dev kqs check scan
 ```
 
 In dev mode, doc-only commands (`kqs doc new`, `kqs typespec new`, `kqs readme`)
@@ -223,7 +223,7 @@ relevance_threshold = 0.7
 kqs readme
 ```
 
-Generates between the `<!-- kq:start -->` / `<!-- kq:end -->` markers:
+Generates between the `<!-- kqs:start -->` / `<!-- kqs:end -->` markers:
 
 1. **Kanban Board** — tasks by status (todo/in_progress/review/done)
 2. **Table of Contents** — document tree with clickable links

justfile

@@ -1,4 +1,4 @@
-# kq development commands
+# kqs development commands
 
 set shell := ["bash", "-uc", "unset CARGO_TARGET_DIR; eval $@", "bash"]
 

kq-core/src/git.rs

@@ -33,7 +33,7 @@ pub fn auto_commit(repo: &Repository, dir: &Path) -> Result<Option<Oid>> {
         return Ok(None); // No changes — skip commit
     }
 
-    let signature = Signature::now("kq", "kq@knowledge").context("Failed to create git signature")?;
+    let signature = Signature::now("kqs", "kqs@knowledge").context("Failed to create git signature")?;
 
     let message = format!("docs: auto-sync [{}]", chrono::Utc::now().format("%Y-%m-%d %H:%M:%S"));
 

kq-core/src/init.rs

@@ -81,7 +81,7 @@ pub fn init(path: Option<PathBuf>, remote: Option<String>, force: bool) -> Resul
     // 8. Create initial commit
     let tree_oid = index.write_tree().context("Failed to write git tree")?;
     let tree = repo.find_tree(tree_oid).context("Failed to find git tree")?;
-    let signature = git2::Signature::now("kq init", "kq@local").context("Failed to create git signature")?;
+    let signature = git2::Signature::now("kqs init", "kqs@local").context("Failed to create git signature")?;
     repo.commit(
         Some("HEAD"),
         &signature,
@@ -120,7 +120,7 @@ mod tests {
     /// Helper to create a unique temporary directory for each test.
     fn unique_temp_dir() -> PathBuf {
         let n = TEST_COUNTER.fetch_add(1, Ordering::SeqCst);
-        let dir = std::env::temp_dir().join(format!("kq_init_test_{}_{}", std::process::id(), n));
+        let dir = std::env::temp_dir().join(format!("kqs_init_test_{}_{}", std::process::id(), n));
         let _ = fs::remove_dir_all(&dir);
         fs::create_dir_all(&dir).unwrap();
         dir

kq-core/src/lib.rs

@@ -19,58 +19,58 @@ pub mod watcher;
 use std::path::Path;
 use std::sync::OnceLock;
 
-/// Operating mode for kq.
+/// Operating mode for kqs.
 #[derive(Debug, Clone, Copy, PartialEq, Eq)]
-pub enum KqMode {
+pub enum KqsMode {
     /// Running in a developer project — limited read-only ops on docs.
     Dev,
     /// Running in the knowledge repo — full access to all commands.
     Doc,
 }
 
-impl std::fmt::Display for KqMode {
+impl std::fmt::Display for KqsMode {
     fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
         match self {
-            KqMode::Dev => write!(f, "dev"),
-            KqMode::Doc => write!(f, "doc"),
+            KqsMode::Dev => write!(f, "dev"),
+            KqsMode::Doc => write!(f, "doc"),
         }
     }
 }
 
 /// Global mode, set once at startup.
-static CURRENT_MODE: OnceLock<KqMode> = OnceLock::new();
+static CURRENT_MODE: OnceLock<KqsMode> = OnceLock::new();
 
 /// Set the global mode explicitly (from CLI --dev/--doc).
-pub fn set_mode(mode: KqMode) {
+pub fn set_mode(mode: KqsMode) {
     let _ = CURRENT_MODE.set(mode);
 }
 
 /// Get the current mode.
-pub fn mode() -> KqMode {
-    *CURRENT_MODE.get().expect("KqMode not initialized")
+pub fn mode() -> KqsMode {
+    *CURRENT_MODE.get().expect("KqsMode not initialized")
 }
 
 /// Detect mode from environment and filesystem.
-pub fn detect_mode(path: &Path) -> KqMode {
-    if let Ok(val) = std::env::var("KQ_MODE") {
+pub fn detect_mode(path: &Path) -> KqsMode {
+    if let Ok(val) = std::env::var("KQS_MODE") {
         match val.as_str() {
-            "dev" => return KqMode::Dev,
-            "doc" => return KqMode::Doc,
+            "dev" => return KqsMode::Dev,
+            "doc" => return KqsMode::Doc,
             _ => {}
         }
     }
     if std::env::var("CI").map(|v| v == "true").unwrap_or(false) {
-        return KqMode::Doc;
+        return KqsMode::Doc;
     }
     if path.join("docs").exists() && path.join("TypeSpec").exists() {
-        return KqMode::Doc;
+        return KqsMode::Doc;
     }
-    KqMode::Dev
+    KqsMode::Dev
 }
 
 pub fn is_dev() -> bool {
-    mode() == KqMode::Dev
+    mode() == KqsMode::Dev
 }
 pub fn is_doc() -> bool {
-    mode() == KqMode::Doc
+    mode() == KqsMode::Doc
 }

kq-core/src/llm_help.rs

@@ -1,12 +1,12 @@
-/// Generate a comprehensive system prompt for LLMs working with kq.
+/// Generate a comprehensive system prompt for LLMs working with kqs.
 ///
 /// This is auto-generated from the actual codebase state — doc types,
 /// command definitions, and schema. Always current, never stale.
 pub fn generate() -> String {
     let mut out = String::with_capacity(4096);
 
-    out.push_str("# kq — Knowledge Platform CLI\n\n");
-    out.push_str("You are an AI assistant integrated with **kq**, a Git-native knowledge management tool.\n");
+    out.push_str("# kqs — Knowledge Platform CLI\n\n");
+    out.push_str("You are an AI assistant integrated with **kqs**, a Git-native knowledge management tool.\n");
     out.push_str("You create and manage documentation, TypeSpec models, and traceability links.\n\n");
 
     out.push_str("## Modes\n\n");
@@ -15,7 +15,7 @@ pub fn generate() -> String {
     out.push_str("- **dev mode** (auto-detected: no `docs/`, or `--dev` flag)\n");
     out.push_str("  Read-only access to docs: scan, check, notify.\n");
     out.push_str("- **CI mode** (auto: `CI=true` env) — doc mode for automated trace checks.\n");
-    out.push_str("- Override: `kqs --dev <cmd>` or `kqs --doc <cmd>` or `KQ_MODE=dev|doc` env.\n\n");
+    out.push_str("- Override: `kqs --dev <cmd>` or `kqs --doc <cmd>` or `KQS_MODE=dev|doc` env.\n\n");
 
     out.push_str("## Document Types & Hierarchy\n\n");
     out.push_str("Each document has a **type** and **ID** (auto-numbered: BFT-001, ADR-002).\n");
@@ -40,7 +40,7 @@ pub fn generate() -> String {
     out.push_str("Every document starts with YAML front matter. ALWAYS include these fields:\n\n");
     out.push_str("```yaml\n");
     out.push_str("---\n");
-    out.push_str("id: BFT-001          # Auto-assigned by kq. Keep it.\n");
+    out.push_str("id: BFT-001          # Auto-assigned by kqs. Keep it.\n");
     out.push_str("title: \"Meaningful Title\"\n");
     out.push_str("status: Draft | Proposed | Accepted | Approved | Deprecated\n");
     out.push_str("revision: 1           # Increment on semantic changes.\n");
@@ -69,7 +69,7 @@ pub fn generate() -> String {
 
     out.push_str("### Step 2: Create documents\n\n");
     out.push_str("```bash\n");
-    out.push_str("# Create each document type. kq assigns IDs and places files.\n");
+    out.push_str("# Create each document type. kqs assigns IDs and places files.\n");
     out.push_str("kqs doc new bft \"Video Catalog Search\"\n");
     out.push_str("kqs doc new frd \"Video Processing\"\n");
     out.push_str("kqs doc new adr \"PostgreSQL for Metadata\"\n");
@@ -153,7 +153,7 @@ pub fn generate() -> String {
 
     out.push_str("## Rules for You\n\n");
     out.push_str("1. Always `kqs doc new <type> \"title\"` first, then `cat` the result, then rewrite content.\n");
-    out.push_str("2. Never create files directly in `docs/`. Let kq handle paths and IDs.\n");
+    out.push_str("2. Never create files directly in `docs/`. Let kqs handle paths and IDs.\n");
     out.push_str("3. Fill `needs`, `covers`, `code_anchors` in Front Matter for every document.\n");
     out.push_str("4. Always run `kqs check traceability-deep --deep` at the end to verify links.\n");
     out.push_str("5. Run `kqs readme` last to update the Table of Contents.\n");