mios-map + tool-aware refine + OpenAI-standard simplification

Three stacked operator asks landed in one bundle:

1. "Open a map / directions to <PLACE>" path:
   * New mios-map shim. Bash, URL-encodes <PLACE>, builds the
     correct Google Maps URL (search or directions mode), opens
     via mios-open-url. Optional --directions [--from <origin>]
     for routed maps. Returns 0/1/64 with clear stderr.
   * Symlinked into /usr/local/{s,}bin via tmpfiles.d shim-links
     (also added mios-hermes-soul-sync that was missing -- shim
     count 37 -> 39).

2. "Prompt refining should be tool aware to be able to hint":
   * New /usr/share/mios/owui/tool-hints.yaml -- canonical-verb
     manifest with name + intent + example + tags for every
     mios-* shim (25 verbs) PLUS an intent_patterns block for
     composite asks ("near <PLACE>", "show me a picture of",
     "open a map / directions"). Operator-editable; adding a
     new shim is one YAML entry.
   * Pipe init now loads the YAML, renders a 3-column markdown
     table (Verb | Intent | Example), and substitutes into the
     {tool_table} placeholder in _REFINE_SYSTEM. Falls back to
     a noop string on YAML missing/parse error so refine never
     crashes from a manifest typo.

3. "Simplify to OpenAI API standards for Day-0 Agents
    understanding -- Do a pass on ALL system prompts" +
   "generisize this to be completely platform agnostic and
    plain generic english (or standard OpenAI patterns here)" +
   "ABSOLUTELY NO HARDCODED ENGLISH STANDARD Linux and Windows
    Terminologies" +
   "the prompt should use thinking to plan a course of action in
    the MiOS environments for it's refinements for global agents":
   * _REFINE_SYSTEM rewritten from ~200 hardcoded lines (intent
     table + 8 examples + MiOS-specific preamble) to ~95 lines of
     generic role + schema + rules + 4 high-signal examples.
   * Preamble is platform-agnostic: "You are a prompt refinement
     layer for a multi-agent system. Rewrite the user's raw
     request into a structured handoff the downstream orchestrator
     agent will execute." No "MiOS-Agent", no "Hermes", no
     "Operator: `mios`" -- the platform-specific verbs come from
     the injected {tool_table} alone.
   * New THINK FIRST section + THINKING line in the schema:
     model reasons step-by-step (intent restate -> verb scan ->
     step count -> delegate decision) before emitting the
     structured handoff. Capped at 80 tokens. Mirrors user
     language.
   * 200 lines of LEGACY_REFINE_DEAD_BODY pruned from the file
     entirely (was a leftover doc-anchor that wasn't loaded by
     anything).
   * Rendered prompt is now 8156 chars (down from ~22K).
   * Live verified: pipe init succeeds, render contains all 4
     example patterns, all 25 canonical verbs, the THINK FIRST
     directive, the "near <PLACE>" intent rule. OWUI restart
     clean.

Also: saved a project memory entry at
~/.claude/projects/C--/memory/project_mios.md so future Claude
sessions don't re-derive MiOS context from CLAUDE.md every time
(operator: "what is MiOS?! Remember!!").

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: mios-dev

usr/lib/tmpfiles.d/mios-shim-links.conf

@@ -85,3 +85,7 @@ L+ /usr/local/bin/mios-lan-status          - - - - /usr/libexec/mios/mios-lan-st
 L+ /usr/local/sbin/mios-lan-status         - - - - /usr/libexec/mios/mios-lan-status
 L+ /usr/local/bin/mios-gui-launch          - - - - /usr/libexec/mios/mios-gui-launch
 L+ /usr/local/sbin/mios-gui-launch         - - - - /usr/libexec/mios/mios-gui-launch
+L+ /usr/local/bin/mios-map                 - - - - /usr/libexec/mios/mios-map
+L+ /usr/local/sbin/mios-map                - - - - /usr/libexec/mios/mios-map
+L+ /usr/local/bin/mios-hermes-soul-sync    - - - - /usr/libexec/mios/mios-hermes-soul-sync
+L+ /usr/local/sbin/mios-hermes-soul-sync   - - - - /usr/libexec/mios/mios-hermes-soul-sync

usr/libexec/mios/mios-map

@@ -0,0 +1,103 @@
+#!/bin/bash
+# /usr/libexec/mios/mios-map <query> [--directions [<from>]] [--browser <name>]
+#
+# Open Google Maps for a query / address / "directions to X" in the
+# operator's default browser. Operator-flagged 2026-05-17: agent
+# refused "Open a map with directions to Chotto Matte Toronto" with
+# "the browser can't launch in this environment" -- it had access to
+# mios-open-url all along. This shim collapses the whole flow to one
+# call so the agent stops reinventing the URL.
+#
+# Examples:
+#   mios-map "Chotto Matte Toronto"
+#       -> https://www.google.com/maps/search/Chotto+Matte+Toronto
+#
+#   mios-map --directions "Toronto Congress Centre"
+#       -> https://www.google.com/maps/dir/?api=1&destination=Toronto+Congress+Centre
+#
+#   mios-map --directions "650 Dixon Road Toronto" --from "downtown Toronto"
+#       -> https://www.google.com/maps/dir/?api=1&origin=downtown+Toronto&destination=650+Dixon+Road+Toronto
+#
+# Exit codes:
+#   0 = URL constructed + opened in browser
+#   1 = mios-open-url failed
+#   64 = bad usage
+
+set -uo pipefail
+
+usage() {
+    cat <<'USAGE'
+usage: mios-map <query> [--directions [--from <origin>]] [--browser <name>]
+
+  <query>               Place name, address, or business name. Quote
+                        multi-word.
+  --directions          Open in directions mode (default destination
+                        is <query>).
+  --from <origin>       Set the origin for --directions (otherwise
+                        Google picks "Your location").
+  --browser <name>      Override the default browser (passed to
+                        mios-open-url).
+
+Returns 0 on dispatch. The browser opens to the constructed URL.
+USAGE
+}
+
+if [ "$#" -lt 1 ] || [ "$1" = "-h" ] || [ "$1" = "--help" ]; then
+    usage
+    [ "$#" -lt 1 ] && exit 64 || exit 0
+fi
+
+QUERY="$1"
+shift
+DIRECTIONS=0
+FROM=""
+BROWSER=""
+
+while [ "$#" -gt 0 ]; do
+    case "$1" in
+        --directions) DIRECTIONS=1; shift ;;
+        --from)       FROM="${2:-}"; shift 2 ;;
+        --browser)    BROWSER="${2:-}"; shift 2 ;;
+        *) echo "mios-map: unknown arg: $1" >&2; exit 64 ;;
+    esac
+done
+
+# URL-encode helper: rfc 3986 percent-encode anything that's not
+# unreserved (A-Z a-z 0-9 - . _ ~). Single-pass; relies on `od` for
+# byte iteration so multi-byte UTF-8 is handled correctly.
+urlencode() {
+    local s="$1" out=""
+    local LANG=C LC_ALL=C
+    local i ch
+    for ((i = 0; i < ${#s}; i++)); do
+        ch="${s:i:1}"
+        case "$ch" in
+            [A-Za-z0-9.~_-]) out+="$ch" ;;
+            ' ') out+="+" ;;
+            *) printf -v out '%s%%%02X' "$out" "'$ch" ;;
+        esac
+    done
+    printf '%s' "$out"
+}
+
+Q_ENC=$(urlencode "$QUERY")
+if [ "$DIRECTIONS" = "1" ]; then
+    URL="https://www.google.com/maps/dir/?api=1&destination=${Q_ENC}"
+    if [ -n "$FROM" ]; then
+        F_ENC=$(urlencode "$FROM")
+        URL="https://www.google.com/maps/dir/?api=1&origin=${F_ENC}&destination=${Q_ENC}"
+    fi
+else
+    URL="https://www.google.com/maps/search/${Q_ENC}"
+fi
+
+echo "[mios-map] query=$QUERY"
+echo "[mios-map] url=$URL"
+
+OPEN_ARGS=("$URL")
+[ -n "$BROWSER" ] && OPEN_ARGS+=("$BROWSER")
+if ! mios-open-url "${OPEN_ARGS[@]}"; then
+    echo "mios-map: mios-open-url failed for $URL" >&2
+    exit 1
+fi
+exit 0