karnel-termux 4.15.0 → 4.15.2

package/README.md

@@ -8,7 +8,7 @@
 
 <p align="center">
   <a href="https://github.com/israelmarques1024-dotcom/karnel-termux">
-    <img src="https://img.shields.io/badge/version-4.15.0-0078D4?style=for-the-badge" alt="Version">
+    <img src="https://img.shields.io/badge/version-4.15.2-0078D4?style=for-the-badge" alt="Version">
   </a>
   <a href="https://www.npmjs.com/package/karnel-termux">
     <img src="https://img.shields.io/npm/v/karnel-termux?style=for-the-badge&logo=npm&color=cb3837" alt="npm">
@@ -59,7 +59,7 @@ Created by **Israel Marques**.
 ### Via checksummed GitHub release (recommended)
 
 ```bash
-version=4.15.0
+version=4.15.2
 tmpdir=$(mktemp -d) && trap 'rm -rf "$tmpdir"' EXIT
 base="https://github.com/israelmarques1024-dotcom/karnel-termux/releases/download/v$version"
 curl -fsSL "$base/karnel-termux-install.sh" -o "$tmpdir/karnel-termux-install.sh"

package/docs/CHANGELOG.md

@@ -1,5 +1,29 @@
 # Documentation Changelog
 
+## 4.15.2 - 2026-08-16
+
+- Implemented the previously missing `karnel brain add "text"` subcommand.
+  `karnel brain save` (interactive) told non-interactive users to use
+  `karnel brain add` when a terminal was unavailable, but the subcommand did
+  not exist and fell through to "Unknown subcommand". `add` now saves a memory
+  non-interactively with optional `--title`, `--category` and `--tags`.
+- Fixed memory slug lookup in `karnel brain show/relate/edit/delete`. The help
+  documents `karnel brain show slug-name`, but stored memories use
+  `YYYY-MM-DD_<slug>.md` filenames and lookups required the exact, full,
+  date-prefixed basename. A shared `_brain_find_memory` helper now resolves the
+  bare slug (falls back to `*_<slug>.md`) so the documented short form works.
+- Removed a duplicated `glow` rendering block in `karnel brain show`.
+- `karnel brain search` (and related memory search in `ask`/`save` suggestions and
+  `delete` relation clean-up) now falls back to `grep -r` when `ripgrep` is not
+  installed, instead of failing with "ripgrep not found". Environments without
+  `rg` (fresh minimal containers, CI runners) can now search memories.
+
+- Fixed the plugin registry pin: `PLUGIN_REGISTRY_COMMIT` now points to
+  `f19d3cd` (registry commit that pins reviewed plugin sources to commits/
+  tags instead of moving `main`), with the matching registry checksum
+  `ea82bf2f...`. Plugin updates previously failed with a "Checksum mismatch"
+  whenever a plugin repository advanced ahead of the stale registry snapshot.
+
 ## 4.15.0 - 2026-08-14
 
 - Replaced the unavailable GGA fork with the official Gentleman Guardian

package/karnel/RELEASE_COMMIT

@@ -1 +1 @@
-0cb37fa9cbd9b82b371fdae9fd07c2041bfc4b19
+c91732e5ece58c3a6b01d604a88b1cb1f3d64b0e

package/karnel/cli/commands/brain.sh

@@ -54,6 +54,66 @@ _brain_title() {
 	fi
 }
 
+_brain_find_memory() {
+	local slug="$1"
+	if [[ -z "$slug" ]]; then
+		return 1
+	fi
+	local f
+	f=$(find "$BRAIN_DIR" -name "${slug}.md" 2>/dev/null | head -1)
+	if [[ -z "$f" ]]; then
+		f=$(find "$BRAIN_DIR" -name "*_${slug}.md" 2>/dev/null | head -1)
+	fi
+	[[ -n "$f" ]] && echo "$f"
+}
+
+_brain_rg() {
+	local -a flags=()
+	local list=0
+	local pattern=""
+	while [[ $# -gt 0 ]]; do
+		case "$1" in
+		-i)
+			flags+=(-i)
+			shift
+			;;
+		-l)
+			list=1
+			shift
+			;;
+		--glob | --no-heading)
+			shift
+			;;
+		-e)
+			pattern="$2"
+			shift 2
+			;;
+		*)
+			pattern="$1"
+			shift
+			;;
+		esac
+	done
+
+	if [[ -z "$pattern" ]]; then
+		return 1
+	fi
+
+	if command -v rg &>/dev/null; then
+		if ((list)); then
+			rg "${flags[@]}" -l --glob '*.md' "$pattern" "$BRAIN_DIR" 2>/dev/null
+		else
+			rg "${flags[@]}" -n --no-heading --glob '*.md' "$pattern" "$BRAIN_DIR" 2>/dev/null
+		fi
+	else
+		if ((list)); then
+			grep -r -E "${flags[@]}" -l --include='*.md' "$pattern" "$BRAIN_DIR" 2>/dev/null
+		else
+			grep -r -E -n "${flags[@]}" --include='*.md' "$pattern" "$BRAIN_DIR" 2>/dev/null
+		fi
+	fi
+}
+
 _brain_slug_escape() {
 	printf '%s\n' "$1" | sed 's/[\/&]/\\&/g; s/\n/\\n/g'
 }
@@ -199,6 +259,7 @@ brain_help() {
 	echo
 	printf "    ${D_CYAN}%-12s${NC} %s\n" "init" "Initialize brain directory and GitHub repo"
 	printf "    ${D_CYAN}%-12s${NC} %s\n" "save" "Save a new memory interactively"
+	printf "    ${D_CYAN}%-12s${NC} %s\n" "add" "Quick non-interactive save"
 	printf "    ${D_CYAN}%-12s${NC} %s\n" "search" "Search memories by keywords or tags"
 	printf "    ${D_CYAN}%-12s${NC} %s\n" "ls" "List memories by category"
 	printf "    ${D_CYAN}%-12s${NC} %s\n" "edit" "Edit a memory in your \$EDITOR"
@@ -214,6 +275,7 @@ brain_help() {
 	echo
 	printf "    ${D_CYAN}karnel brain init${NC}              # Create local brain\n"
 	printf "    ${D_CYAN}karnel brain save${NC}              # Interactive save\n"
+	printf "    ${D_CYAN}karnel brain add TEXT${NC}          # Quick non-interactive save\n"
 	printf "    ${D_CYAN}karnel brain search react${NC}      # Search all memories\n"
 	printf "    ${D_CYAN}karnel brain ls${NC}                # List all categories\n"
 	printf "    ${D_CYAN}karnel brain ls react${NC}          # List react category\n"
@@ -381,7 +443,7 @@ brain_save() {
 					done
 					$already || related_slugs+=("$match_slug")
 				fi
-			done < <(rg -l -i "tags:.*$tag" "$BRAIN_DIR" 2>/dev/null || true)
+			done < <(_brain_rg -i "tags:.*$tag" || true)
 		done
 		IFS=$' \t\n'
 
@@ -445,6 +507,86 @@ brain_save() {
 	echo
 }
 
+# ── Add (non-interactive) ───────────────────────────────────
+
+brain_add() {
+	_brain_ensure || return 1
+
+	if [[ $# -lt 1 ]]; then
+		log_error "Usage: karnel brain add \"your text\" [--title T] [--category C] [--tags a,b]"
+		return 1
+	fi
+
+	local title="" category="" tags_input=""
+	local -a content_parts=()
+	while [[ $# -gt 0 ]]; do
+		case "$1" in
+		--title | -t)
+			title="$2"
+			shift 2
+			;;
+		--category | -c)
+			category="$2"
+			shift 2
+			;;
+		--tags)
+			tags_input="$2"
+			shift 2
+			;;
+		--)
+			shift
+			content_parts+=("$*")
+			break
+			;;
+		*)
+			content_parts+=("$1")
+			shift
+			;;
+		esac
+	done
+
+	local text
+	text=$(echo "${content_parts[*]}" | sed 's/^[[:space:]]*//; s/[[:space:]]*$//')
+	if [[ -z "$text" ]]; then
+		log_error "Memory text cannot be empty"
+		return 1
+	fi
+
+	if [[ -z "$title" ]]; then
+		title=$(echo "$text" | head -1 | cut -c1-60)
+	fi
+	if [[ -z "$title" ]]; then
+		title="memory-$(date +%Y%m%d-%H%M%S)"
+	fi
+
+	if [[ -z "$category" ]]; then
+		category="general"
+	fi
+	category=$(_brain_slug "$category")
+
+	local tags_formatted=""
+	if [[ -n "$tags_input" ]]; then
+		tags_formatted=$(echo "$tags_input" | sed 's/, */, /g' | sed 's/^, \|, $//g')
+	fi
+
+	local slug date_prefix
+	slug=$(_brain_slug "$title")
+	date_prefix=$(date +%Y-%m-%d)
+
+	mkdir -p "$BRAIN_DIR/$category"
+	local filepath="$BRAIN_DIR/$category/${date_prefix}_${slug}.md"
+
+	{
+		_brain_frontmatter "$title" "$tags_formatted" "$category" ""
+		echo
+		echo "$text"
+	} >"$filepath"
+
+	echo
+	log_success "Memory saved to ${D_CYAN}$category/${date_prefix}_${slug}.md${D_NC}"
+	echo
+}
+
 # ── Search ──────────────────────────────────────────────────
 
 brain_search() {
@@ -463,15 +605,10 @@ brain_search() {
 	separator
 	echo
 
-	if ! command -v rg &>/dev/null; then
-		log_error "ripgrep not found — this shouldn't happen"
-		return 1
-	fi
-
 	local -a results=()
 	while IFS=':' read -r file line content; do
 		results+=("$file|$line|$content")
-	done < <(rg -n -i "$query" "$BRAIN_DIR" --glob '*.md' --no-heading 2>/dev/null || true)
+	done < <(_brain_rg -i "$query" || true)
 
 	if [[ ${#results[@]} -eq 0 ]]; then
 		log_warn "No results for: $query"
@@ -632,8 +769,8 @@ brain_relate() {
 		file_b=$(_brain_pick_file "Second memory (# or name)")
 		[[ -z "$file_b" ]] && return 0
 	else
-		file_a=$(find "$BRAIN_DIR" -name "${slug_a}.md" 2>/dev/null | head -1)
-		file_b=$(find "$BRAIN_DIR" -name "${slug_b}.md" 2>/dev/null | head -1)
+		file_a=$(_brain_find_memory "$slug_a")
+		file_b=$(_brain_find_memory "$slug_b")
 
 		if [[ -z "$file_a" ]]; then
 			log_error "Memory not found: $slug_a"
@@ -687,7 +824,7 @@ brain_show() {
 	local file=""
 
 	if [[ -n "$slug" ]]; then
-		file=$(find "$BRAIN_DIR" -name "${slug}.md" 2>/dev/null | head -1)
+		file=$(_brain_find_memory "$slug")
 		if [[ -z "$file" ]]; then
 			log_error "Memory not found: $slug"
 			return 1
@@ -1077,7 +1214,7 @@ brain_edit() {
 	local file=""
 
 	if [[ -n "$slug" ]]; then
-		file=$(find "$BRAIN_DIR" -name "${slug}.md" 2>/dev/null | head -1)
+		file=$(_brain_find_memory "$slug")
 		if [[ -z "$file" ]]; then
 			log_error "Memory not found: $slug"
 			return 1
@@ -1132,7 +1269,7 @@ brain_delete() {
 	local file=""
 
 	if [[ -n "$slug" ]]; then
-		file=$(find "$BRAIN_DIR" -name "${slug}.md" 2>/dev/null | head -1)
+		file=$(_brain_find_memory "$slug")
 		if [[ -z "$file" ]]; then
 			log_error "Memory not found: $slug"
 			return 1
@@ -1163,7 +1300,7 @@ brain_delete() {
 	file_slug=$(basename "$file" .md)
 	while IFS= read -r rfile; do
 		_brain_remove_related "$rfile" "$file_slug"
-	done < <(rg -l "$file_slug" "$BRAIN_DIR" --glob '*.md' 2>/dev/null || true)
+	done < <(_brain_rg "$file_slug" || true)
 
 	if [[ "$file" != "$BRAIN_DIR"/* ]]; then
 		log_error "Refusing to delete file outside brain directory"
@@ -1404,7 +1541,7 @@ EOF
 		if [[ -n "$f" ]]; then
 			matching_files+=("$f")
 		fi
-	done < <(rg -i -l "$clean_query" "$BRAIN_DIR" --glob '*.md' 2>/dev/null | head -n 5 || true)
+	done < <(_brain_rg -i "$clean_query" | head -n 5 || true)
 
 	if [[ ${#matching_files[@]} -eq 0 ]]; then
 		local -a words=($clean_query)
@@ -1423,7 +1560,7 @@ EOF
 				if [[ -n "$f" ]]; then
 					matching_files+=("$f")
 				fi
-			done < <(rg -i -l -e "$word_regex" "$BRAIN_DIR" --glob '*.md' 2>/dev/null | head -n 5 || true)
+			done < <(_brain_rg -i -e "$word_regex" | head -n 5 || true)
 		fi
 	fi
 
@@ -1529,6 +1666,9 @@ brain_main() {
 	save)
 		brain_save
 		;;
+	add)
+		brain_add "$@"
+		;;
 	search)
 		brain_search "$@"
 		;;

package/karnel/tools/plugins/install.sh

@@ -1,8 +1,8 @@
 # shellcheck shell=bash
 
 PLUGINS_DIR="${KARNEL_DATA}/plugins"
-PLUGIN_REGISTRY_COMMIT="561780eb76b10ddac161fe5eeec6e5a4dd0db2f2"
-PLUGIN_REGISTRY_SHA256="a2fdad6519b5e6b979a7e6df21250bd348012df90c6cf79ccd946d1568edb40c"
+PLUGIN_REGISTRY_COMMIT="f19d3cdd87c67f0a8fa052565ab23c74aea4b27b"
+PLUGIN_REGISTRY_SHA256="ea82bf2f9182b5967c0ba9769882a92d8d1aa9ec430fbbbf0dcb21591907b620"
 PLUGIN_REGISTRY_URL="https://raw.githubusercontent.com/israelmarques1024-dotcom/karnel-plugins/${PLUGIN_REGISTRY_COMMIT}/registry.json"
 PLUGIN_DISPATCH_FOUND=0
 PLUGIN_SEMVER_RE='^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)(-((0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*)(\.(0|[1-9][0-9]*|[0-9A-Za-z-]*[A-Za-z-][0-9A-Za-z-]*))*))?(\+([0-9A-Za-z-]+)(\.[0-9A-Za-z-]+)*)?$'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "karnel-termux",
-  "version": "4.15.0",
+  "version": "4.15.2",
   "description": "Modular Dev Environment for Termux — install languages, databases, AI agents, editors, and more with one command",
   "bin": {
     "karnel": "karnel/bin/karnel"