feat(hooks): token optimization — dedup, auto-route, prewarm, script-suggest (#14)

* feat(teleop): add native voice control prototype

* feat(cli): add scaffold command for Company OS folder structure

stackmemory scaffold creates company/, wiki/, skills/, clients/, raw/,
and .stackmemory/config.yml. Enables local context management with
file-based skill rot detection and tenant isolation.

* feat(daemon): add opt-out telemetry service

New DaemonTelemetryService collects anonymous usage snapshots:
- Daemon health (uptime, context saves, memory triggers, errors)
- Session counts (total heartbeats, active now)
- Skill audit entries, handoff counts
- No PII — instance ID is random hex

Runs daily (default 24h interval, first at boot+30s).
Stores rolling 90-snapshot history in ~/.stackmemory/telemetry.json.
Opt out: STACKMEMORY_TELEMETRY=0 or telemetry.enabled: false in config.

* feat(hooks): add self-healing daemon health check for SessionStart

* feat(daemon): add desire-path detector — auto-discover workflows, suggest skills

Three-component system in DaemonDesirePathService:
1. ActionStreamLogger — PostToolUse hook captures tool:target pairs
   to ~/.stackmemory/desire-paths/action-stream.jsonl (no data/content)
2. PatternDetector — sliding window extracts repeated sequences,
   filters by min 3 occurrences across 2+ sessions, scores by freq×sessions
3. SkillSuggester — generates skill.md files from top patterns with
   inputs/outputs inferred from sequence endpoints

- 10MB JSONL rotation, 10K entry scan cap for performance
- Opt out: STACKMEMORY_DESIRE_PATHS=0 or desirePaths.enabled: false
- Scans every 6h, first at boot+2m
- Suggestions written to ~/.stackmemory/desire-paths/suggestions/
- 3 adversarial review rounds: fixed separator injection, added scan cap,
  improved skill naming with target directory context

* fix(desire-paths): adaptive backoff — hourly when active, exponential to 12h when idle

* feat(cli): add hermes-sm wrapper with StackMemory integration

- Auto-starts daemon on session boot
- Writes session heartbeats for telemetry tracking
- Restores handoff context from previous sessions
- Sets STACKMEMORY_SESSION env for desire-path hook
- Determinism watcher + tracing
- bin/hermes-sm and bin/hermes-smd registered in package.json

* feat(desire-paths): auto-promote skills above 0.8 confidence + 5 sessions

* feat(daemon): add research stream scanner for market signal detection

* fix(test): replace bun:test import with vitest in desire-path-service test

* feat(tokens): replace char/4 heuristic with js-tiktoken (cl100k_base)

Centralizes token estimation across 14 files through
src/core/cache/token-estimator.ts and packages/sdk/src/token-estimator.ts.
Lazy-loads cl100k_base encoder with char/4 fallback if WASM fails.

Also ports context-budget hook to codex-sm exit handler for
compact/restart nudges matching Claude Code behavior.

* feat(skill-packs): add content licenses (CC-BY-4.0) to registry metadata

Skills are often prompt text (content) not code — content licenses like
CC-BY-4.0 fit better than MIT for these. Adds KnownLicenseSchema enum
with both code (MIT, Apache-2.0, ISC, BSD) and content (CC-BY-4.0,
CC-BY-SA-4.0, CC0-1.0) licenses while keeping the field open for custom
SPDX identifiers.

* feat(tasks): add local-first master-tasks.md task management

Markdown table parser + CLI commands + MCP tools for local-first task
steering. Tasks live in master-tasks.md, optionally sync to Linear/GH.

- Parser: parse/serialize/update/add/getNext for pipe-delimited md tables
- CLI: stackmemory tasks init/md list/md next/md add/md update
- MCP: get_next_master_task, update_master_task, create_master_task
- 19 tests covering parse, round-trip, priority sorting, file ops

* feat(hooks): token optimization — dedup escalation, auto-route, prewarm, script-suggest

- dedup-reads: escalate to [STOP] at 5+ reads (was soft-only at 3+)
- desire-path-hook: auto-route Bash→Glob/Read/Grep with inline suggestions
- prewarm-tools: SessionStart hook emits top deferred tool pre-fetch hint
- script-suggest: detects multi-tool patterns matching existing scripts

* feat(bench): add hook benchmark script + baseline report

Replays 7,589 action-stream entries through hook logic.
Result: 324K token savings projected (22% waste reduction).

---------

Co-authored-by: StackMemory Bot (CLI) <bot@stackmemory.ai>

Author: jonathanpeterwu

apps/teleop-native/Package.swift

@@ -0,0 +1,22 @@
+// swift-tools-version: 6.0
+
+import PackageDescription
+
+let package = Package(
+    name: "TeleopNative",
+    platforms: [
+        .iOS(.v17),
+        .macOS(.v14),
+    ],
+    products: [
+        .library(name: "TeleopUI", targets: ["TeleopUI"]),
+        .executable(name: "TeleopMac", targets: ["TeleopMac"]),
+    ],
+    targets: [
+        .target(name: "TeleopUI"),
+        .executableTarget(
+            name: "TeleopMac",
+            dependencies: ["TeleopUI"]
+        ),
+    ]
+)

apps/teleop-native/README.md

@@ -0,0 +1,29 @@
+# Teleop Native
+
+Native SwiftUI prototype for low-latency voice teleoperation on macOS and iOS.
+
+## OpenUI Result Summary
+
+- First screen is the control surface, not a landing page.
+- One primary animated voice button drives the interaction.
+- Visible text is limited to a tiny transient agent cue.
+- Telemetry is icon-first: signal, power, and motion are visual gauges.
+- Voice/chat owns intent. The button starts, interrupts, resumes, or reconnects.
+- WebRTC/media plumbing is intentionally a future integration layer behind the current `TeleopSession` state object.
+
+## Architecture Target
+
+`Mobile or macOS app -> WebRTC session -> global relay -> transceiver -> realtime agent -> teleop gateway -> device`
+
+The app should keep hard safety controls local to the device gateway. The model can interpret intent, but stop limits and degraded-network behavior should not depend on a cloud round trip.
+
+## Run Mac Prototype
+
+```bash
+cd apps/teleop-native
+swift run TeleopMac
+```
+
+## iOS
+
+Open `apps/teleop-native/Package.swift` in Xcode and use `TeleopUI` from a new iOS app target. The shared SwiftUI view is `TeleopHomeView`.

apps/teleop-native/Sources/TeleopMac/TeleopMacApp.swift

@@ -0,0 +1,13 @@
+import SwiftUI
+import TeleopUI
+
+@main
+struct TeleopMacApp: App {
+    var body: some Scene {
+        WindowGroup {
+            TeleopHomeView()
+                .frame(minWidth: 360, minHeight: 620)
+        }
+        .windowStyle(.hiddenTitleBar)
+    }
+}

apps/teleop-native/Sources/TeleopUI/TeleopHomeView.swift

@@ -0,0 +1,135 @@
+import SwiftUI
+
+public struct TeleopHomeView: View {
+    @StateObject private var session = TeleopSession()
+
+    public init() {}
+
+    public var body: some View {
+        ZStack {
+            TeleopBackground(state: session.state)
+
+            VStack(spacing: 26) {
+                TelemetryStrip(sample: session.telemetry, state: session.state)
+                    .padding(.top, 26)
+
+                Spacer(minLength: 20)
+
+                TeleopPulseButton(state: session.state) {
+                    session.pressPrimary()
+                }
+
+                if !session.agentSummary.isEmpty {
+                    AgentCue(text: session.agentSummary)
+                        .transition(.opacity.combined(with: .scale(scale: 0.96)))
+                }
+
+                Spacer(minLength: 32)
+            }
+            .padding(.horizontal, 24)
+            .padding(.bottom, 20)
+        }
+        .accessibilityElement(children: .contain)
+        .onDisappear {
+            session.stop()
+        }
+    }
+}
+
+private struct TeleopBackground: View {
+    let state: TeleopConnectionState
+
+    var body: some View {
+        LinearGradient(
+            colors: backgroundColors,
+            startPoint: .topLeading,
+            endPoint: .bottomTrailing
+        )
+        .ignoresSafeArea()
+        .animation(.easeInOut(duration: 0.35), value: state)
+    }
+
+    private var backgroundColors: [Color] {
+        switch state {
+        case .idle:
+            return [Color(red: 0.05, green: 0.06, blue: 0.07), Color(red: 0.0, green: 0.09, blue: 0.08)]
+        case .connecting:
+            return [Color(red: 0.03, green: 0.07, blue: 0.10), Color(red: 0.0, green: 0.18, blue: 0.16)]
+        case .live:
+            return [Color(red: 0.02, green: 0.11, blue: 0.08), Color(red: 0.10, green: 0.16, blue: 0.07)]
+        case .thinking:
+            return [Color(red: 0.10, green: 0.09, blue: 0.02), Color(red: 0.16, green: 0.11, blue: 0.02)]
+        case .fault:
+            return [Color(red: 0.12, green: 0.03, blue: 0.04), Color(red: 0.04, green: 0.02, blue: 0.03)]
+        }
+    }
+}
+
+private struct TelemetryStrip: View {
+    let sample: TelemetrySample
+    let state: TeleopConnectionState
+
+    var body: some View {
+        HStack(spacing: 18) {
+            GaugeGlyph(
+                systemName: "point.3.connected.trianglepath.dotted",
+                value: signalValue,
+                tint: .mint
+            )
+            GaugeGlyph(systemName: "bolt.fill", value: sample.battery, tint: .yellow)
+            GaugeGlyph(systemName: "waveform.path.ecg", value: motionValue, tint: .cyan)
+        }
+        .opacity(state == .idle ? 0.38 : 1)
+        .animation(.easeInOut(duration: 0.25), value: state)
+        .accessibilityLabel("Telemetry")
+    }
+
+    private var signalValue: Double {
+        state == .idle ? 0.12 : sample.signal
+    }
+
+    private var motionValue: Double {
+        state == .idle ? 0.08 : (sample.motion + 1.0) / 2.0
+    }
+}
+
+private struct GaugeGlyph: View {
+    let systemName: String
+    let value: Double
+    let tint: Color
+
+    var body: some View {
+        ZStack {
+            Circle()
+                .stroke(.white.opacity(0.12), lineWidth: 4)
+            Circle()
+                .trim(from: 0, to: max(0.05, min(1.0, value)))
+                .stroke(tint, style: StrokeStyle(lineWidth: 4, lineCap: .round))
+                .rotationEffect(.degrees(-90))
+            Image(systemName: systemName)
+                .font(.system(size: 17, weight: .semibold))
+                .foregroundStyle(.white.opacity(0.86))
+        }
+        .frame(width: 48, height: 48)
+        .animation(.smooth(duration: 0.18), value: value)
+    }
+}
+
+private struct AgentCue: View {
+    let text: String
+
+    var body: some View {
+        Text(text)
+            .font(.system(size: 13, weight: .medium, design: .rounded))
+            .foregroundStyle(.white.opacity(0.82))
+            .padding(.horizontal, 14)
+            .padding(.vertical, 8)
+            .background(.white.opacity(0.10), in: Capsule())
+            .accessibilityLabel(text)
+    }
+}
+
+#Preview {
+    TeleopHomeView()
+        .frame(width: 390, height: 740)
+}

apps/teleop-native/Sources/TeleopUI/TeleopPulseButton.swift

@@ -0,0 +1,104 @@
+import SwiftUI
+
+struct TeleopPulseButton: View {
+    let state: TeleopConnectionState
+    let action: () -> Void
+
+    @State private var pulse = false
+
+    var body: some View {
+        Button(action: action) {
+            ZStack {
+                ForEach(0..<3, id: \.self) { index in
+                    Circle()
+                        .stroke(ringColor.opacity(0.30), lineWidth: 2)
+                        .frame(width: 170 + CGFloat(index * 42), height: 170 + CGFloat(index * 42))
+                        .scaleEffect(pulse ? 1.12 : 0.86)
+                        .opacity(pulse ? 0.0 : 0.55)
+                        .animation(
+                            .easeOut(duration: 1.45)
+                                .repeatForever(autoreverses: false)
+                                .delay(Double(index) * 0.18),
+                            value: pulse
+                        )
+                }
+
+                Circle()
+                    .fill(buttonFill)
+                    .frame(width: 168, height: 168)
+                    .shadow(color: ringColor.opacity(0.34), radius: 30, y: 16)
+
+                Image(systemName: iconName)
+                    .font(.system(size: 58, weight: .semibold))
+                    .foregroundStyle(.white)
+                    .symbolEffect(.pulse, options: .repeating, value: isAnimated)
+            }
+            .frame(width: 280, height: 280)
+        }
+        .buttonStyle(.plain)
+        .accessibilityLabel(accessibilityLabel)
+        .onAppear {
+            pulse = true
+        }
+        .onChange(of: state) { _, newState in
+            pulse = newState != .idle
+        }
+    }
+
+    private var iconName: String {
+        switch state {
+        case .idle:
+            return "mic.fill"
+        case .connecting:
+            return "antenna.radiowaves.left.and.right"
+        case .live:
+            return "waveform"
+        case .thinking:
+            return "hand.raised.fill"
+        case .fault:
+            return "exclamationmark.triangle.fill"
+        }
+    }
+
+    private var accessibilityLabel: String {
+        switch state {
+        case .idle:
+            return "Start voice teleoperation"
+        case .connecting:
+            return "Cancel connection"
+        case .live:
+            return "Interrupt or stop motion"
+        case .thinking:
+            return "Resume live control"
+        case .fault:
+            return "Reconnect"
+        }
+    }
+
+    private var buttonFill: LinearGradient {
+        LinearGradient(
+            colors: [ringColor.opacity(0.95), ringColor.opacity(0.48)],
+            startPoint: .topLeading,
+            endPoint: .bottomTrailing
+        )
+    }
+
+    private var ringColor: Color {
+        switch state {
+        case .idle:
+            return .teal
+        case .connecting:
+            return .cyan
+        case .live:
+            return .green
+        case .thinking:
+            return .orange
+        case .fault:
+            return .red
+        }
+    }
+
+    private var isAnimated: Bool {
+        state == .connecting || state == .live || state == .thinking
+    }
+}