@lattices/cli 0.4.9 → 0.4.11

package/bin/infer.ts

@@ -0,0 +1,406 @@
+/**
+ * Lattices inference wrapper — thin layer over Vercel AI SDK.
+ *
+ * Features:
+ *  - Multi-provider: groq, openai, anthropic, google, xai
+ *  - Credential loading: env vars → .env.local/.env → ~/.lattices/inference.json → ~/.config/speakeasy/settings.json
+ *  - Instrumented: every call logged with timing, model, token usage
+ *  - Simple API: `await infer("do something", { provider: "groq" })`
+ */
+
+import { generateText, type ModelMessage } from "ai";
+import { createOpenAI } from "@ai-sdk/openai";
+import { createAnthropic } from "@ai-sdk/anthropic";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createXai } from "@ai-sdk/xai";
+import { readFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+
+// ── Types ──────────────────────────────────────────────────────────
+
+export type ProviderName = "groq" | "openai" | "anthropic" | "google" | "xai" | "minimax";
+
+export interface InferOptions {
+  provider?: ProviderName;
+  model?: string;
+  system?: string;
+  messages?: ModelMessage[];
+  temperature?: number;
+  maxTokens?: number;
+  /** Tag for logging — e.g. "hands-off", "voice-fallback" */
+  tag?: string;
+  /** Abort signal for cancellation/timeout */
+  abortSignal?: AbortSignal;
+}
+
+export interface InferResult {
+  text: string;
+  provider: ProviderName;
+  model: string;
+  durationMs: number;
+  usage?: {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+  };
+}
+
+// ── Default models per provider ────────────────────────────────────
+
+const PROVIDER_NAMES: ProviderName[] = ["groq", "openai", "anthropic", "google", "xai", "minimax"];
+const VOICE_PROVIDER_PRIORITY: ProviderName[] = ["groq", "xai", "openai", "google", "anthropic", "minimax"];
+
+const DEFAULT_MODELS: Record<ProviderName, string> = {
+  groq: "llama-3.3-70b-versatile",
+  openai: "gpt-4o-mini",
+  anthropic: "claude-sonnet-4-6",
+  google: "gemini-2.0-flash",
+  xai: "grok-4-1-fast-non-reasoning",
+  minimax: "MiniMax-M2.5-highspeed",
+};
+
+const VOICE_DEFAULT_MODELS: Record<ProviderName, string> = {
+  ...DEFAULT_MODELS,
+  groq: "llama-3.1-8b-instant",
+};
+
+// ── Credential loading ─────────────────────────────────────────────
+
+interface CredentialStore {
+  groq?: string;
+  openai?: string;
+  anthropic?: string;
+  google?: string;
+  xai?: string;
+  minimax?: string;
+}
+
+let _cachedCreds: CredentialStore | null = null;
+let _cachedLocalEnv: Record<string, string> | null = null;
+
+function parseDotEnv(content: string): Record<string, string> {
+  const env: Record<string, string> = {};
+
+  for (const rawLine of content.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+
+    const match = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
+    if (!match) continue;
+
+    const [, key, rawValue] = match;
+    let value = rawValue.trim();
+    const quote = value[0];
+    if ((quote === `"` || quote === `'`) && value.endsWith(quote)) {
+      value = value.slice(1, -1);
+    } else {
+      value = value.replace(/\s+#.*$/, "").trim();
+    }
+
+    env[key] = value;
+  }
+
+  return env;
+}
+
+function loadLocalEnv(): Record<string, string> {
+  if (_cachedLocalEnv) return _cachedLocalEnv;
+
+  const repoRoot = join(import.meta.dir, "..");
+  const candidates = [
+    join(repoRoot, ".env"),
+    join(repoRoot, ".env.local"),
+    join(process.cwd(), ".env"),
+    join(process.cwd(), ".env.local"),
+  ];
+
+  const env: Record<string, string> = {};
+  for (const file of Array.from(new Set(candidates))) {
+    if (!existsSync(file)) continue;
+    try {
+      Object.assign(env, parseDotEnv(readFileSync(file, "utf-8")));
+    } catch {}
+  }
+
+  _cachedLocalEnv = env;
+  return env;
+}
+
+export function getInferenceEnv(name: string): string | undefined {
+  return process.env[name] || loadLocalEnv()[name];
+}
+
+function firstInferenceEnv(names: string[]): string | undefined {
+  for (const name of names) {
+    const value = getInferenceEnv(name);
+    if (value) return value;
+  }
+}
+
+function normalizeProvider(value: string | undefined): ProviderName | undefined {
+  const provider = value?.trim().toLowerCase();
+  return PROVIDER_NAMES.includes(provider as ProviderName) ? (provider as ProviderName) : undefined;
+}
+
+function assignGrokAlias(creds: CredentialStore) {
+  const key = getInferenceEnv("GROK_API_KEY");
+  if (!key) return;
+
+  // People often say/type "Grok" when they mean Groq. Use the key shape to
+  // route the alias without making xAI and Groq credentials interchangeable.
+  if (!creds.groq && key.startsWith("gsk_")) creds.groq = key;
+  if (!creds.xai && key.startsWith("xai-")) creds.xai = key;
+}
+
+function loadCredentials(): CredentialStore {
+  if (_cachedCreds) return _cachedCreds;
+
+  const creds: CredentialStore = {};
+
+  // Layer 1: env vars (highest priority)
+  const groqKey = getInferenceEnv("GROQ_API_KEY");
+  const openaiKey = getInferenceEnv("OPENAI_API_KEY");
+  const anthropicKey = getInferenceEnv("ANTHROPIC_API_KEY");
+  const googleKey = getInferenceEnv("GOOGLE_GENERATIVE_AI_API_KEY");
+  const xaiKey = getInferenceEnv("XAI_API_KEY");
+  const minimaxKey = getInferenceEnv("MINIMAX_API_KEY");
+  if (groqKey) creds.groq = groqKey;
+  if (openaiKey) creds.openai = openaiKey;
+  if (anthropicKey) creds.anthropic = anthropicKey;
+  if (googleKey) creds.google = googleKey;
+  if (xaiKey) creds.xai = xaiKey;
+  if (minimaxKey) creds.minimax = minimaxKey;
+  assignGrokAlias(creds);
+
+  // Layer 2: ~/.lattices/inference.json
+  const latticesConfig = join(homedir(), ".lattices", "inference.json");
+  if (existsSync(latticesConfig)) {
+    try {
+      const cfg = JSON.parse(readFileSync(latticesConfig, "utf-8"));
+      if (cfg.keys) {
+        if (!creds.groq && cfg.keys.groq) creds.groq = cfg.keys.groq;
+        if (!creds.openai && cfg.keys.openai) creds.openai = cfg.keys.openai;
+        if (!creds.anthropic && cfg.keys.anthropic) creds.anthropic = cfg.keys.anthropic;
+        if (!creds.google && cfg.keys.google) creds.google = cfg.keys.google;
+        if (!creds.xai && cfg.keys.xai) creds.xai = cfg.keys.xai;
+        if (!creds.minimax && cfg.keys.minimax) creds.minimax = cfg.keys.minimax;
+      }
+    } catch {}
+  }
+
+  // Layer 3: ~/.config/speakeasy/settings.json (fallback)
+  const speakeasyConfig = join(homedir(), ".config", "speakeasy", "settings.json");
+  if (existsSync(speakeasyConfig)) {
+    try {
+      const cfg = JSON.parse(readFileSync(speakeasyConfig, "utf-8"));
+      const p = cfg.providers || {};
+      if (!creds.groq && p.groq?.apiKey) creds.groq = p.groq.apiKey;
+      if (!creds.openai && p.openai?.apiKey) creds.openai = p.openai.apiKey;
+      if (!creds.anthropic && p.anthropic?.apiKey) creds.anthropic = p.anthropic.apiKey;
+      if (!creds.google && p.gemini?.apiKey) creds.google = p.gemini.apiKey;
+      if (!creds.xai && p.xai?.apiKey) creds.xai = p.xai.apiKey;
+      if (!creds.minimax && p.minimax?.apiKey) creds.minimax = p.minimax.apiKey;
+    } catch {}
+  }
+
+  _cachedCreds = creds;
+  return creds;
+}
+
+/** Clear cached credentials (call if config changes at runtime) */
+export function clearCredentialCache() {
+  _cachedCreds = null;
+  _cachedLocalEnv = null;
+}
+
+/** List which providers have credentials available */
+export function availableProviders(): ProviderName[] {
+  const creds = loadCredentials();
+  return (Object.keys(creds) as ProviderName[]).filter((k) => !!creds[k]);
+}
+
+/** Voice/hands-off defaults favor the lowest-latency configured provider. */
+export function resolveVoiceInferenceOptions(): { provider: ProviderName; model: string } {
+  const configuredProvider = normalizeProvider(firstInferenceEnv([
+    "LATTICES_VOICE_PROVIDER",
+    "LATTICES_HANDSOFF_PROVIDER",
+    "LATTICES_INFER_PROVIDER",
+  ]));
+
+  const creds = loadCredentials();
+  const provider = configuredProvider
+    ?? VOICE_PROVIDER_PRIORITY.find((name) => !!creds[name])
+    ?? "groq";
+
+  const model = firstInferenceEnv([
+    "LATTICES_VOICE_MODEL",
+    "LATTICES_HANDSOFF_MODEL",
+    "LATTICES_INFER_MODEL",
+  ]) ?? VOICE_DEFAULT_MODELS[provider];
+
+  return { provider, model };
+}
+
+// ── Provider factory ───────────────────────────────────────────────
+
+function getModel(provider: ProviderName, modelId: string) {
+  const creds = loadCredentials();
+
+  switch (provider) {
+    case "groq": {
+      const groq = createOpenAI({
+        baseURL: "https://api.groq.com/openai/v1",
+        apiKey: creds.groq,
+      });
+      return groq(modelId);
+    }
+    case "openai": {
+      const openai = createOpenAI({ apiKey: creds.openai });
+      return openai(modelId);
+    }
+    case "anthropic": {
+      const anthropic = createAnthropic({ apiKey: creds.anthropic });
+      return anthropic(modelId);
+    }
+    case "google": {
+      const google = createGoogleGenerativeAI({ apiKey: creds.google });
+      return google(modelId);
+    }
+    case "xai": {
+      const xai = createXai({ apiKey: creds.xai });
+      return xai(modelId);
+    }
+    case "minimax": {
+      // MiniMax uses OpenAI-compatible chat completions API
+      const minimax = createOpenAI({
+        baseURL: "https://api.minimax.io/v1",
+        apiKey: creds.minimax,
+      });
+      return minimax.chat(modelId);
+    }
+  }
+}
+
+// ── Logging ────────────────────────────────────────────────────────
+
+function log(tag: string, msg: string) {
+  const ts = new Date().toISOString().slice(11, 23);
+  console.error(`[${ts}] infer${tag ? `/${tag}` : ""}: ${msg}`);
+}
+
+// ── Main inference function ────────────────────────────────────────
+
+/**
+ * Run inference against any supported provider.
+ *
+ * @example
+ * // Simple
+ * const { text } = await infer("What windows do I have?", { provider: "groq" })
+ *
+ * // With system prompt and messages
+ * const { text } = await infer("tile chrome left", {
+ *   provider: "groq",
+ *   system: "You are a workspace assistant...",
+ *   tag: "hands-off",
+ * })
+ *
+ * // With conversation history
+ * const { text } = await infer("now the other one right", {
+ *   provider: "groq",
+ *   messages: [
+ *     { role: "user", content: "tile chrome left" },
+ *     { role: "assistant", content: '{"actions":[...]}' },
+ *   ],
+ * })
+ */
+export async function infer(
+  prompt: string,
+  options: InferOptions = {}
+): Promise<InferResult> {
+  const provider = options.provider ?? "groq";
+  const modelId = options.model ?? DEFAULT_MODELS[provider];
+  const tag = options.tag ?? "";
+
+  // Check credentials
+  const creds = loadCredentials();
+  if (!creds[provider]) {
+    throw new Error(
+      `No API key for provider "${provider}". Set it in env, .env.local, ~/.lattices/inference.json, or ~/.config/speakeasy/settings.json`
+    );
+  }
+
+  const model = getModel(provider, modelId);
+
+  // Build messages
+  const messages: ModelMessage[] = [
+    ...(options.messages ?? []),
+    { role: "user", content: prompt },
+  ];
+
+  log(tag, `→ ${provider}/${modelId} (${prompt.length} chars)`);
+  const start = performance.now();
+
+  try {
+    const result = await generateText({
+      model,
+      system: options.system,
+      messages,
+      temperature: options.temperature ?? 0.3,
+      maxOutputTokens: options.maxTokens ?? 1024,
+      abortSignal: options.abortSignal,
+    });
+
+    const durationMs = Math.round(performance.now() - start);
+
+    const usage = result.usage
+      ? {
+          promptTokens: result.usage.inputTokens,
+          completionTokens: result.usage.outputTokens,
+          totalTokens: result.usage.totalTokens,
+        }
+      : undefined;
+
+    log(
+      tag,
+      `← ${durationMs}ms | ${usage?.totalTokens ?? "?"} tokens | ${result.text.length} chars`
+    );
+
+    return {
+      text: result.text,
+      provider,
+      model: modelId,
+      durationMs,
+      usage,
+    };
+  } catch (err: any) {
+    const durationMs = Math.round(performance.now() - start);
+    log(tag, `✗ ${durationMs}ms | ${err.message ?? err}`);
+    throw err;
+  }
+}
+
+// ── Convenience: infer with automatic JSON parsing ─────────────────
+
+export async function inferJSON<T = any>(
+  prompt: string,
+  options: InferOptions = {}
+): Promise<{ data: T; raw: InferResult }> {
+  const result = await infer(prompt, options);
+
+  // Extract JSON from response (handle markdown fences)
+  let cleaned = result.text
+    .replace(/```json\s*/g, "")
+    .replace(/```\s*/g, "")
+    .trim();
+
+  const start = cleaned.indexOf("{");
+  const end = cleaned.lastIndexOf("}");
+  if (start === -1 || end === -1) {
+    throw new Error(`No JSON found in response: ${result.text.slice(0, 200)}`);
+  }
+  cleaned = cleaned.slice(start, end + 1);
+
+  const data = JSON.parse(cleaned) as T;
+  return { data, raw: result };
+}

package/bin/lattices-app.ts

@@ -8,15 +8,15 @@ import { get } from "node:https";
 import type { IncomingMessage } from "node:http";
 
 const __dirname = import.meta.dir;
-const appDir = resolve(__dirname, "../app");
+const appDir = resolve(__dirname, "../apps/mac");
 const cliRoot = resolve(__dirname, "..");
 const bundlePath = resolve(appDir, "Lattices.app");
 const binaryDir = resolve(bundlePath, "Contents/MacOS");
 const binaryPath = resolve(binaryDir, "Lattices");
-const entitlementsPath = resolve(__dirname, "../app/Lattices.entitlements");
+const entitlementsPath = resolve(__dirname, "../apps/mac/Lattices.entitlements");
 const resourcesDir = resolve(bundlePath, "Contents/Resources");
 const iconPath = resolve(__dirname, "../assets/AppIcon.icns");
-const tapSoundPath = resolve(__dirname, "../app/Resources/tap.wav");
+const tapSoundPath = resolve(__dirname, "../apps/mac/Resources/tap.wav");
 
 const REPO = "arach/lattices";
 const RELEASE_APP_ASSET_NAMES = ["Lattices.dmg"];
@@ -68,6 +68,27 @@ function packageVersion(): string {
   }
 }
 
+function gitRevision(): string {
+  try {
+    return execSync("git rev-parse --short HEAD", {
+      cwd: cliRoot,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    }).trim();
+  } catch {
+    return "unknown";
+  }
+}
+
+function xmlEscape(value: string): string {
+  return value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&apos;");
+}
+
 function launch(extraArgs: string[] = []): void {
   if (isRunning()) {
     console.log("lattices app is already running.");
@@ -133,9 +154,35 @@ function signBundle(): void {
   } catch {}
 }
 
-function writeInfoPlist(): void {
+type BundleBuildMetadata = {
+  channel?: "dev" | "release";
+  track?: string;
+  revision?: string;
+  timestamp?: string;
+};
+
+function buildMetadataPlist(metadata: BundleBuildMetadata): string {
+  if (metadata.channel !== "dev") return "";
+
+  const track = metadata.track ?? "latest";
+  const revision = metadata.revision ?? gitRevision();
+  const timestamp = metadata.timestamp ?? new Date().toISOString();
+
+  return `    <key>LatticesBuildChannel</key>
+    <string>dev</string>
+    <key>LatticesBuildTrack</key>
+    <string>${xmlEscape(track)}</string>
+    <key>LatticesBuildRevision</key>
+    <string>${xmlEscape(revision)}</string>
+    <key>LatticesBuildTimestamp</key>
+    <string>${xmlEscape(timestamp)}</string>
+`;
+}
+
+function writeInfoPlist(metadata: BundleBuildMetadata = {}): void {
   mkdirSync(resolve(bundlePath, "Contents"), { recursive: true });
   const version = packageVersion();
+  const buildMetadata = buildMetadataPlist(metadata);
   const plist = `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
@@ -167,7 +214,7 @@ function writeInfoPlist(): void {
     <string>${version}</string>
     <key>CFBundleShortVersionString</key>
     <string>${version}</string>
-    <key>LSMinimumSystemVersion</key>
+${buildMetadata}    <key>LSMinimumSystemVersion</key>
     <string>13.0</string>
     <key>LSUIElement</key>
     <true/>
@@ -209,7 +256,7 @@ function buildFromSource(): boolean {
 
   mkdirSync(binaryDir, { recursive: true });
   execSync(`cp '${builtPath}' '${binaryPath}'`);
-  writeInfoPlist();
+  writeInfoPlist({ channel: "dev", track: "latest" });
   syncBundleResources();
 
   // Re-sign the bundle so macOS TCC recognizes a stable identity across rebuilds.
@@ -381,7 +428,10 @@ if (cmd === "build") {
     console.error("Swift is required. Install with: xcode-select --install");
     process.exit(1);
   }
-  buildFromSource();
+  if (!buildFromSource()) {
+    console.error("Build failed.");
+    process.exit(1);
+  }
 } else if (cmd === "quit") {
   if (quit()) {
     console.log("lattices app stopped.");

package/bin/lattices-dev

@@ -4,7 +4,7 @@
 set -euo pipefail
 
 SCRIPT_PATH="$(readlink -f "$0" 2>/dev/null || python3 -c "import os,sys; print(os.path.realpath(sys.argv[1]))" "$0")"
-APP_DIR="$(cd "$(dirname "$SCRIPT_PATH")/../app" && pwd)"
+APP_DIR="$(cd "$(dirname "$SCRIPT_PATH")/../apps/mac" && pwd)"
 ROOT="$(cd "$(dirname "$SCRIPT_PATH")/.." && pwd)"
 LOG_FILE="$HOME/.lattices/lattices.log"
 BINARY="$APP_DIR/.build/release/Lattices"
@@ -15,6 +15,8 @@ ENTITLEMENTS="$APP_DIR/Lattices.entitlements"
 ICON="$ROOT/assets/AppIcon.icns"
 TAP_SOUND="$APP_DIR/Resources/tap.wav"
 VERSION="$(node -p "require('$ROOT/package.json').version" 2>/dev/null || echo '0.1.0')"
+GIT_REVISION="$(git -C "$ROOT" rev-parse --short HEAD 2>/dev/null || echo 'unknown')"
+BUILD_TIMESTAMP="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
 
 red()   { printf "\033[31m%s\033[0m\n" "$*"; }
 green() { printf "\033[32m%s\033[0m\n" "$*"; }
@@ -93,6 +95,14 @@ write_info_plist() {
     <string>$VERSION</string>
     <key>CFBundleShortVersionString</key>
     <string>$VERSION</string>
+    <key>LatticesBuildChannel</key>
+    <string>dev</string>
+    <key>LatticesBuildTrack</key>
+    <string>latest</string>
+    <key>LatticesBuildRevision</key>
+    <string>$GIT_REVISION</string>
+    <key>LatticesBuildTimestamp</key>
+    <string>$BUILD_TIMESTAMP</string>
     <key>LSMinimumSystemVersion</key>
     <string>13.0</string>
     <key>LSUIElement</key>
@@ -177,6 +187,31 @@ cmd_clear_logs() {
     fi
 }
 
+cmd_link() {
+    if ! command -v bun >/dev/null 2>&1; then
+        red "bun not found. Install: curl -fsSL https://bun.sh/install | bash"
+        exit 1
+    fi
+    cd "$ROOT"
+    bun link
+    bun link @lattices/cli
+    if command -v lattices >/dev/null 2>&1; then
+        green "Linked. \`lattices\` -> $(command -v lattices)"
+    else
+        red "Linked, but \`lattices\` is not on PATH. Add bun's global bin to PATH:"
+        dim "  export PATH=\"\$HOME/.bun/bin:\$PATH\""
+    fi
+}
+
+cmd_unlink() {
+    if ! command -v bun >/dev/null 2>&1; then
+        red "bun not found."
+        exit 1
+    fi
+    bun remove -g @lattices/cli >/dev/null 2>&1 || true
+    green "Unlinked."
+}
+
 cmd_status() {
     if pgrep -x Lattices >/dev/null 2>&1; then
         local pid=$(pgrep -x Lattices)
@@ -198,6 +233,8 @@ cmd_status() {
 cmd_help() {
     echo "lattices-dev — Lattices development commands"
     echo ""
+    echo "  link         Symlink \`lattices\` to this checkout (bun link)"
+    echo "  unlink       Remove the bun link"
     echo "  restart      Quit + rebuild + relaunch"
     echo "  build        Build release binary"
     echo "  quit         Stop the running app"
@@ -210,6 +247,8 @@ cmd_help() {
 }
 
 case "${1:-help}" in
+    link)       cmd_link ;;
+    unlink)     cmd_unlink ;;
     restart)    cmd_restart ;;
     build)      cmd_build ;;
     quit|stop)  cmd_quit ;;

package/bin/lattices.ts

@@ -549,7 +549,7 @@ function resolvePanes(dir: string): PaneConfig[] {
 
 function detectProjectType(dir: string): string | null {
   // Check for lattices-style hybrid project (Swift app + Node CLI)
-  if (existsSync(resolve(dir, "app/Package.swift")) && existsSync(resolve(dir, "bin/lattices-app.ts")))
+  if (existsSync(resolve(dir, "apps/mac/Package.swift")) && existsSync(resolve(dir, "bin/lattices-app.ts")))
     return "lattices-app";
   if (existsSync(resolve(dir, "Package.swift"))) return "swift";
   if (existsSync(resolve(dir, "Cargo.toml"))) return "rust";

package/docs/agent-execution-plan.md

@@ -443,10 +443,10 @@ Those existing RPC names can remain stable while their internals are replaced.
 
 Files likely involved:
 
-- `app/Sources/LatticesApi.swift`
-- new planner/executor files under `app/Sources/`
-- `app/Sources/WindowTiler.swift`
-- `app/Sources/WorkspaceManager.swift`
+- `apps/mac/Sources/LatticesApi.swift`
+- new planner/executor files under `apps/mac/Sources/`
+- `apps/mac/Sources/WindowTiler.swift`
+- `apps/mac/Sources/WorkspaceManager.swift`
 
 Deliverables:
 
@@ -474,9 +474,9 @@ Deliverables:
 
 Files likely involved:
 
-- `app/Sources/VoiceIntentResolver.swift`
-- `app/Sources/IntentEngine.swift`
-- `app/Sources/HandsOffSession.swift`
+- `apps/mac/Sources/VoiceIntentResolver.swift`
+- `apps/mac/Sources/IntentEngine.swift`
+- `apps/mac/Sources/HandsOffSession.swift`
 
 Deliverables:
 
@@ -488,8 +488,8 @@ Deliverables:
 
 Files likely involved:
 
-- `app/Sources/HUDController.swift`
-- `app/Sources/PaletteCommand.swift`
+- `apps/mac/Sources/HUDController.swift`
+- `apps/mac/Sources/PaletteCommand.swift`
 
 Deliverables: