aether-cache 0.1.1__tar.gz → 0.1.2__tar.gz

{aether_cache-0.1.1 → aether_cache-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: aether-cache
-Version: 0.1.1
+Version: 0.1.2
 Summary: Shared memory for AI coding tools that stays true to your code.
 Project-URL: Homepage, https://github.com/anishchugh05/Aether-Cache-Redis-Compatible-Vector-Store
 Author: Anish Chugh
@@ -124,6 +124,7 @@ the engine only accepts connections from it, and your memories live in `~/.aethe
 | Command | What it does |
 |---|---|
 | `aether-cache setup` | One-time setup: engine, model, and AI tools |
+| `aether-cache add` | Adds the repo you're in (or a path) so the dashboard can check its files; the dashboard can also find and add repos for you |
 | `aether-cache ui` | Opens the dashboard: see what your AI remembers, and confirm or retire memories whose files changed |
 | `aether-cache status` | Is it running, and what's in this project's memory |
 | `aether-cache doctor` | Checks everything and tells you how to fix what's wrong |

{aether_cache-0.1.1 → aether_cache-0.1.2}/README.md

@@ -112,6 +112,7 @@ the engine only accepts connections from it, and your memories live in `~/.aethe
 | Command | What it does |
 |---|---|
 | `aether-cache setup` | One-time setup: engine, model, and AI tools |
+| `aether-cache add` | Adds the repo you're in (or a path) so the dashboard can check its files; the dashboard can also find and add repos for you |
 | `aether-cache ui` | Opens the dashboard: see what your AI remembers, and confirm or retire memories whose files changed |
 | `aether-cache status` | Is it running, and what's in this project's memory |
 | `aether-cache doctor` | Checks everything and tells you how to fix what's wrong |

{aether_cache-0.1.1 → aether_cache-0.1.2}/aether_cache/__init__.py

@@ -1,3 +1,3 @@
 """Aether Cache: shared memory for AI coding tools that stays true to your code."""
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"

{aether_cache-0.1.1 → aether_cache-0.1.2}/aether_cache/cli.py

@@ -179,6 +179,22 @@ def _tool_output(name: str, *tool_args) -> int:
     return 0
 
 
+def cmd_add(args) -> int:
+    from . import repos
+    from .server import EngineDown, store_down
+    try:
+        engine.ensure_running()
+        added = repos.add(args.path)
+    except repos.RepoError as e:
+        print(e)
+        return 1
+    except (engine.EngineError, EngineDown) as e:
+        print(store_down(e))
+        return 1
+    print(f"Added {added['name']} ({added['path']})" + (f", github.com/{added['github']}" if added["github"] else "") + ".")
+    return 0
+
+
 def cmd_serve(args) -> int:
     from .server import serve
     serve()
@@ -220,6 +236,9 @@ def main(argv=None) -> None:
         func=lambda a: _tool_output("sync_to_files"))
     sub.add_parser("check", help="retire memories whose linked files changed").set_defaults(
         func=lambda a: _tool_output("check_stale"))
+    p = sub.add_parser("add", help="add a repo so the dashboard can check its files (default: this folder)")
+    p.add_argument("path", nargs="?", default=".")
+    p.set_defaults(func=cmd_add)
     p = sub.add_parser("ui", help="open the dashboard: see and fix what your AI tools remember")
     p.add_argument("--port", type=int, help="port for the dashboard (default 7381)")
     p.add_argument("--no-open", action="store_true", help="don't open a browser, just print the link")

aether_cache-0.1.2/aether_cache/repos.py

@@ -0,0 +1,134 @@
+"""
+Finding and adding the git repos whose memories Aether Cache manages.
+
+Adding a repo just records where it lives (aether:repo:<project> -> folder), which lets the dashboard check
+its memories' files from anywhere. Nothing is read from the repo beyond git metadata; nothing leaves the machine.
+"""
+import os
+import platform
+import re
+import subprocess
+import time
+from pathlib import Path
+from typing import List, Optional
+
+from . import server
+
+# Where people usually keep code. Only these are searched, a few levels deep, and only when asked.
+SEARCH_ROOTS = ["Desktop", "Documents", "Projects", "projects", "Developer", "dev", "code", "Code", "src",
+                "repos", "git", "GitHub", "workspace", "work", "Sites"]
+SKIP = {"node_modules", "Library", "Applications", "venv", ".venv", "env", "__pycache__", "build", "dist", "target",
+        "vendor", "Pods", "DerivedData", ".Trash", "Pictures", "Music", "Movies", "Downloads"}
+MAX_DEPTH = 4
+MAX_RESULTS = 300
+TIME_BUDGET = 3.0  # seconds; a huge Documents folder shouldn't make the dashboard hang
+
+
+class RepoError(Exception):
+    pass
+
+
+def git_top(path: Path) -> Optional[Path]:
+    """The repo's top folder if path is inside a git repo, else None."""
+    try:
+        out = subprocess.run(["git", "rev-parse", "--show-toplevel"], cwd=path, capture_output=True, text=True, timeout=5)
+    except (OSError, subprocess.SubprocessError):
+        return None
+    return Path(out.stdout.strip()) if out.returncode == 0 and out.stdout.strip() else None
+
+
+def github_remote(path: Path) -> Optional[str]:
+    """"owner/repo" if the repo's origin is on GitHub (read from local git config, no network), else None."""
+    try:
+        out = subprocess.run(["git", "config", "--get", "remote.origin.url"], cwd=path, capture_output=True, text=True, timeout=5)
+    except (OSError, subprocess.SubprocessError):
+        return None
+    m = re.search(r"github\.com[:/]([\w.-]+)/([\w.-]+?)(?:\.git)?/?$", out.stdout.strip())
+    return f"{m.group(1)}/{m.group(2)}" if m else None
+
+
+def discover() -> List[dict]:
+    """Git repos in the usual code folders under your home folder, newest first."""
+    home = Path.home()
+    roots = [home / r for r in SEARCH_ROOTS if (home / r).is_dir()]
+    found, seen = [], set()
+    deadline = time.monotonic() + TIME_BUDGET
+
+    def walk(folder: Path, depth: int) -> None:
+        if depth > MAX_DEPTH or len(found) >= MAX_RESULTS or time.monotonic() > deadline:
+            return
+        try:
+            entries = list(os.scandir(folder))
+        except OSError:
+            return  # no permission (e.g. macOS-protected folders); skip quietly
+        if any(e.name == ".git" for e in entries):
+            real = folder.resolve()
+            if real not in seen:
+                seen.add(real)
+                try:
+                    modified = (folder / ".git").stat().st_mtime
+                except OSError:
+                    modified = 0
+                found.append({"path": str(folder), "modified": modified})
+            return  # don't look for repos inside a repo
+        for e in entries:
+            if e.is_dir(follow_symlinks=False) and not e.name.startswith(".") and e.name not in SKIP:
+                walk(Path(e.path), depth + 1)
+
+    for root in roots:
+        walk(root, 1)
+    found.sort(key=lambda r: -r["modified"])
+    for r in found:
+        r["name"] = Path(r["path"]).name
+        r["github"] = github_remote(Path(r["path"]))
+    return found
+
+
+def add(path: str) -> dict:
+    """Adds a project by folder (for a git repo, any folder inside it works). Returns {name, path, github}."""
+    folder = Path(path).expanduser()
+    if not folder.is_dir():
+        raise RepoError(f"{path} isn't a folder.")
+    # A git repo is added by its top folder (so memories match from any subfolder). A plain folder works too:
+    # file fingerprints don't need git, and the AI tools treat a non-git folder as a project named after it.
+    top = git_top(folder) or folder.resolve()
+    name = top.name
+    existing = server.db().get(server.REPO_KEY + name)
+    if existing and Path(existing).resolve() != top.resolve() and Path(existing).is_dir():
+        raise RepoError(f"A different repo with the same folder name, {name}, is already added ({existing}). "
+                        f"Projects are named after their folder, so rename one of the folders to keep both.")
+    server.db().set(server.REPO_KEY + name, str(top))
+    return {"name": name, "path": str(top), "github": github_remote(top)}
+
+
+def remove(name: str) -> None:
+    """Forgets where a repo lives. Its memories are kept; it just stops being listed if it has none."""
+    server.db().set(server.REPO_KEY + name, "")  # the engine has no DEL; an empty location means "not added"
+
+
+def pick_folder() -> Optional[str]:
+    """Opens this computer's own folder picker and returns the chosen path, or None if cancelled.
+    Raises RepoError if there's no picker available (then the user can type a path instead)."""
+    system = platform.system()
+    if system == "Darwin":
+        # "tell me to activate" brings the picker to the front without asking to control another app
+        script = ('tell me to activate\n'
+                  'POSIX path of (choose folder with prompt "Choose a project folder to add to Aether Cache")')
+        cmd = ["osascript", "-e", script]
+    elif system == "Windows":
+        ps = ("Add-Type -AssemblyName System.Windows.Forms; $d = New-Object System.Windows.Forms.FolderBrowserDialog; "
+              "$d.Description = 'Choose a git repo to add to Aether Cache'; "
+              "if ($d.ShowDialog() -eq 'OK') { $d.SelectedPath }")
+        cmd = ["powershell", "-NoProfile", "-Command", ps]
+    else:
+        cmd = ["zenity", "--file-selection", "--directory", "--title=Choose a git repo to add to Aether Cache"]
+    try:
+        out = subprocess.run(cmd, capture_output=True, text=True, timeout=600)
+    except FileNotFoundError:
+        raise RepoError("This computer has no folder picker available. Paste the folder's path instead.")
+    except subprocess.TimeoutExpired:
+        return None
+    if out.returncode != 0:  # cancelled
+        return None
+    chosen = out.stdout.strip()
+    return (chosen.rstrip("/\\") or chosen) or None

{aether_cache-0.1.1 → aether_cache-0.1.2}/aether_cache/ui/index.html

@@ -84,7 +84,8 @@ nav.rail {
 }
 .wordmark { display: flex; align-items: center; gap: 10px; padding: 18px 20px 22px; font-weight: 600; font-size: var(--t-md); letter-spacing: -0.01em; }
 .rail h2 { font-size: var(--t-xs); font-weight: 500; color: var(--rail-2); margin: 0 20px var(--s2); }
-.projects { list-style: none; margin: 0; padding: 0 10px; overflow-y: auto; flex: 1; }
+.projects { list-style: none; margin: 0; padding: 0 10px; overflow-y: auto; flex: 0 1 auto; }
+.projects:empty { display: none; }
 .project {
   display: block; width: 100%; text-align: left; border: 0; background: none; color: inherit; cursor: pointer;
   padding: 9px 10px; border-radius: 6px; transition: background-color 150ms ease;
@@ -93,7 +94,7 @@ nav.rail {
 .project .meta { display: block; font-size: var(--t-xs); color: var(--rail-2); }
 .project .meta .hot { color: var(--rail-stale); }
 .project[aria-current="true"] { background: var(--rail-active); }
-.engine { display: flex; align-items: center; gap: var(--s2); padding: 14px 20px; font-size: var(--t-xs); color: var(--rail-2); border-top: 1px solid var(--rail-active); }
+.engine { display: flex; align-items: center; gap: var(--s2); margin-top: auto; padding: 14px 20px; font-size: var(--t-xs); color: var(--rail-2); border-top: 1px solid var(--rail-active); }
 .engine .dot { width: 7px; height: 7px; border-radius: 50%; background: #3BBF8E; flex-shrink: 0; }
 .engine.down .dot { background: var(--rail-stale); }
 .engine .ver { margin-left: auto; font-family: var(--mono); }
@@ -252,6 +253,38 @@ ol.timeline .details { font-size: var(--t-sm); color: var(--ink-2); margin: 1px
 .blocker p { color: var(--ink-2); }
 .blocker code { font-family: var(--mono); font-size: 0.9em; color: var(--ink); background: var(--surface); border: 1px solid var(--rule); padding: 2px 6px; border-radius: 4px; }
 
+/* ---------- add a project ---------- */
+.add-project {
+  display: flex; align-items: center; gap: 8px; width: calc(100% - 20px); margin: 6px 10px 12px; padding: 8px 10px;
+  border: 1px dashed color-mix(in srgb, var(--rail-2) 55%, transparent); border-radius: 6px; background: none;
+  color: var(--rail-ink); font-size: var(--t-sm); cursor: pointer; transition: background-color 150ms ease, border-color 150ms ease, transform 160ms var(--ease-out);
+}
+.add-project:active { transform: scale(0.98); }
+.add-project[aria-current="true"] { background: var(--rail-active); border-style: solid; border-color: var(--rail-active); }
+.source-tabs { margin-bottom: var(--s4); }
+.repo-row { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 16px; align-items: center; padding: 12px 16px; }
+.repo-row + .repo-row { border-top: 1px solid var(--rule); }
+.repo-row .name { font-weight: 500; overflow-wrap: anywhere; }
+.repo-row .where { display: block; font-size: var(--t-xs); color: var(--ink-2); overflow-wrap: break-word; }
+.repo-row .gh { display: block; font-size: var(--t-xs); color: var(--ink-2); }
+.added-word { font-size: var(--t-xs); font-weight: 600; color: var(--fresh); display: inline-flex; gap: 6px; align-items: center; }
+.path-form { display: flex; gap: var(--s2); flex-wrap: wrap; margin-top: 6px; }
+.path-label { display: block; margin-top: var(--s5); font-size: var(--t-sm); font-weight: 500; }
+.path-form input { flex: 1 1 280px; border: 1px solid var(--rule); border-radius: 6px; background: var(--surface); height: 34px; padding: 0 12px; font-family: var(--mono); font-size: var(--t-xs); }
+.path-form input:focus { outline: none; border-color: var(--focus); box-shadow: 0 0 0 3px color-mix(in srgb, var(--focus) 20%, transparent); }
+.note { padding: 18px 20px; font-size: var(--t-sm); color: var(--ink-2); }
+.note p { margin: 0 0 10px; max-width: 70ch; } .note p:last-child { margin-bottom: 0; }
+.note .example { background: var(--surface-2); border-radius: 6px; padding: 10px 14px; color: var(--ink); font-size: var(--t-md); max-width: none; }
+.note strong { color: var(--ink); font-weight: 600; }
+.head-links { display: flex; flex-wrap: wrap; gap: 4px 14px; align-items: baseline; margin-top: 2px; font-size: var(--t-xs); color: var(--ink-2); }
+.head-links a { color: var(--ink-2); text-underline-offset: 3px; text-decoration-color: var(--rule); }
+.linkish { border: 0; background: none; padding: 0; color: var(--ink-2); font-size: var(--t-xs); text-decoration: underline; text-underline-offset: 3px; text-decoration-color: var(--rule); cursor: pointer; }
+[hidden] { display: none !important; }
+@media (hover: hover) and (pointer: fine) {
+  .add-project:hover { background: var(--rail-active); border-color: var(--rail-2); }
+  .head-links a:hover, .linkish:hover { color: var(--ink); text-decoration-color: currentColor; }
+}
+
 /* ---------- small screens ---------- */
 @media (max-width: 900px) {
   .app, .app.has-detail { grid-template-columns: 1fr; grid-template-rows: auto 1fr; height: auto; min-height: 100vh; }
@@ -260,6 +293,7 @@ ol.timeline .details { font-size: var(--t-sm); color: var(--ink-2); margin: 1px
   .rail h2, .engine { display: none; }
   .projects { display: flex; gap: 4px; padding: 8px 8px 8px 0; overflow: visible; }
   .project { width: auto; max-width: 200px; padding: 6px 10px; }
+  .add-project { width: auto; margin: 0 8px 0 0; flex-shrink: 0; white-space: nowrap; }
   .page { padding: 20px 16px 56px; }
   .pair { grid-template-columns: 1fr; }
   aside.detail { position: fixed; inset: 0; z-index: 10; border-left: 0; }
@@ -300,6 +334,7 @@ const state = {
   projects: [], project: null, filter: "any", q: "",
   memories: [], attention: null, selected: null, detail: null,
   version: "", engineUp: true, loadingList: false, listLoaded: false,
+  view: "project", source: "local", discovered: null, discovering: false,
 };
 const REDUCED = matchMedia("(prefers-reduced-motion: reduce)").matches;
 
@@ -329,6 +364,9 @@ function icon(name, size = 14) {
     search: '<circle cx="7" cy="7" r="4.75"/><path d="M10.5 10.5 14 14"/>',
     arrow: '<path d="M2 8h11M9.5 4.5 13 8l-3.5 3.5"/>',
     close: '<path d="M4 4l8 8M12 4l-8 8"/>',
+    plus: '<path d="M8 3v10M3 8h10"/>',
+    folder: '<path d="M2 4.5A1.5 1.5 0 0 1 3.5 3h2.6l1.5 1.5h4.9A1.5 1.5 0 0 1 14 6v5.5a1.5 1.5 0 0 1-1.5 1.5h-9A1.5 1.5 0 0 1 2 11.5z"/>',
+    check: '<path d="M3 8.5 6.5 12 13 4.5"/>',
   };
   const svg = document.createElementNS("http://www.w3.org/2000/svg", "svg");
   svg.setAttribute("viewBox", "0 0 16 16"); svg.setAttribute("width", size); svg.setAttribute("height", size);
@@ -491,6 +529,7 @@ async function refreshAll() {
 }
 
 async function selectProject(name) {
+  showView("project");
   state.project = name; state.q = ""; state.filter = "any"; state.selected = null; state.detail = null;
   state.memories = []; state.listLoaded = false; state.attention = null;
   try { sessionStorage.setItem("aether-project", name); } catch (e) {}
@@ -500,6 +539,146 @@ async function selectProject(name) {
   try { await refreshAll(); } catch (e) { notify(e.message); }
 }
 
+// ---------- add a project ----------
+function showView(view) {
+  state.view = view;
+  document.getElementById("project-view").hidden = view !== "project";
+  document.getElementById("add-view").hidden = view !== "add";
+  if (view === "add") document.querySelector(".app").classList.remove("has-detail");
+  renderProjects();
+}
+
+async function openAdd(firstRun) {
+  state.firstRun = !!firstRun;
+  showView("add");
+  renderAdd();
+  document.querySelector("#add-view h1")?.focus();
+  if (!state.discovered && !state.discovering) {
+    state.discovering = true;
+    try { state.discovered = (await api("/api/discover")).repos; }
+    catch (e) { state.discovered = []; notify(e.message); }
+    finally { state.discovering = false; renderAdd(); }
+  }
+}
+
+async function addRepo(path, button) {
+  if (button) button.disabled = true;
+  try {
+    const { project } = await api("/api/projects/add", { path });
+    notify(`Added ${project.name}.`);
+    if (state.discovered) {
+      const found = state.discovered.find((r) => r.path === project.path);
+      if (found) found.added = true;
+      else state.discovered.unshift({ name: project.name, path: project.path, github: project.github, added: true });
+    }
+    await loadProjects();
+    renderProjects();
+    renderAdd();
+    return project;
+  } catch (e) {
+    notify(e.message);
+    if (button) button.disabled = false;
+    return null;
+  }
+}
+
+async function chooseFolder(button) {
+  button.disabled = true;
+  try {
+    const { path } = await api("/api/pick-folder", {});
+    if (path) await addRepo(path);
+  } catch (e) {
+    notify(e.message);
+    document.getElementById("path-input")?.focus();
+  } finally {
+    button.disabled = false;
+  }
+}
+
+async function removeProject(name) {
+  try {
+    await api("/api/projects/remove", { name });
+    notify(`Removed ${name} from the dashboard.`);
+    if (state.discovered) state.discovered.forEach((r) => { if (r.name === name) r.added = false; });
+    state.project = null;
+    await loadProjects();
+    if (state.projects.length) await selectProject(state.projects[0].name); else openAdd(true);
+  } catch (e) { notify(e.message); }
+}
+
+function renderAdd() {
+  const view = document.getElementById("add-view");
+  const filter = state.addFilter || "";
+  const sourceTabs = h("div", { class: "tabs source-tabs", role: "group", "aria-label": "Where your repos are" },
+    [["local", "On this computer"], ["github", "GitHub"]].map(([key, label]) =>
+      h("button", { type: "button", "aria-pressed": state.source === key ? "true" : "false",
+                    onclick: () => { state.source = key; renderAdd(); } }, label)));
+
+  let body;
+  if (state.source === "github") {
+    body = h("div", { class: "panel note" },
+      h("p", {}, h("strong", {}, "GitHub is coming later. "), "Connecting GitHub will let a team share one project memory, and flag pull requests that would make memories stale before they merge."),
+      h("p", {}, "For now, add repos you’ve cloned on this computer. That’s where your AI tools actually work, so it’s where their memories live, and it means nothing ever leaves your machine."));
+  } else {
+    const pick = h("button", { class: "btn primary", type: "button", onclick: () => chooseFolder(pick) }, icon("folder", 14), " Choose a folder…");
+    pick.style.display = "inline-flex"; pick.style.alignItems = "center"; pick.style.gap = "6px";
+    const filterInput = h("input", { type: "search", placeholder: "Filter repos by name or folder", "aria-label": "Filter the repos found",
+                                     value: filter, autocomplete: "off", spellcheck: "false" });
+    filterInput.addEventListener("input", () => { state.addFilter = filterInput.value; renderRepoList(); });
+    const pathInput = h("input", { id: "path-input", type: "text", placeholder: "~/code/my-repo", spellcheck: "false" });
+    const addPath = h("button", { class: "btn", type: "button", onclick: async () => {
+      if (pathInput.value.trim() && await addRepo(pathInput.value.trim(), addPath)) pathInput.value = ""; } }, "Add path");
+    pathInput.addEventListener("keydown", (e) => { if (e.key === "Enter") addPath.click(); });
+    body = [
+      h("div", { class: "toolbar" }, h("div", { class: "search" }, icon("search", 15), filterInput), pick),
+      h("div", { id: "repo-list" }),
+      h("label", { class: "path-label", for: "path-input" }, "Or paste a project folder’s path"),
+      h("div", { class: "path-form" }, pathInput, addPath),
+    ];
+  }
+  put(view,
+    h("div", { class: "page-head" },
+      h("h1", { tabindex: "-1" }, state.firstRun ? "Pick the repos you work in" : "Add a project"),
+      h("p", { class: "lede", style: "margin-top:6px" }, state.firstRun
+        ? "Aether Cache keeps your AI tools’ memories per repo and checks them against the code. Add the repos you use with AI. Only their location is saved, and nothing leaves this computer."
+        : "Add a repo so its memories show up here and get checked against its files. Only its location is saved, and nothing leaves this computer.")),
+    sourceTabs, body);
+  if (state.source === "local") renderRepoList();
+}
+
+function renderRepoList() {
+  const box = document.getElementById("repo-list");
+  if (!box) return;
+  if (state.discovering || !state.discovered) {
+    put(box, h("div", { class: "panel skeleton", "aria-busy": "true", "aria-label": "Looking for git repos" },
+      h("p", { class: "note", style: "padding-bottom:0" }, "Looking for git repos in your usual code folders…"),
+      [60, 44, 52].map((w, i) => h("div", { class: "repo-row", style: i ? "border-top:1px solid var(--rule)" : "" },
+        h("span", {}, h("span", { class: "bar", style: `width:${w}%;margin-bottom:8px` }), h("span", { class: "bar", style: `width:${w + 20}%` })), h("span")))));
+    return;
+  }
+  const f = (state.addFilter || "").toLowerCase();
+  const repos = state.discovered.filter((r) => !f || r.name.toLowerCase().includes(f) || r.path.toLowerCase().includes(f));
+  if (!state.discovered.length) {
+    put(box, h("div", { class: "panel note" }, h("p", {}, h("strong", {}, "No git repos found "),
+      "in Desktop, Documents, Projects, Developer, code, or similar folders. Choose a folder, or paste its path below.")));
+    return;
+  }
+  if (!repos.length) { put(box, h("div", { class: "panel empty" }, `No repos match “${state.addFilter}”.`)); return; }
+  put(box, h("div", { class: "panel" }, h("div", { role: "list", "aria-label": `${plural(repos.length, "repo")} found` },
+    repos.map((r) => {
+      const add = h("button", { class: "btn", type: "button", onclick: () => addRepo(r.path, add) }, "Add");
+      return h("div", { class: "repo-row", role: "listitem" },
+        h("div", {},
+          h("span", { class: "name" }, r.name),
+          h("span", { class: "where mono" }, pathNodes(r.path.replace(/^\/Users\/[^/]+|^\/home\/[^/]+/, "~"))),
+          r.github ? h("span", { class: "gh" }, `github.com/${r.github}`) : null),
+        r.added
+          ? h("span", { class: "actions" }, h("span", { class: "added-word" }, icon("check", 13), "Added"),
+              h("button", { class: "btn", type: "button", onclick: () => selectProject(r.name) }, "Open"))
+          : add);
+    }))));
+}
+
 // ---------- actions ----------
 const wait = (ms) => new Promise((r) => setTimeout(r, REDUCED ? 0 : ms));
 
@@ -555,18 +734,30 @@ function renderEngine() {
 function renderProjects() {
   put(document.getElementById("projects"), state.projects.map((p) => {
     const total = p.counts.active + p.counts.stale + p.counts.retired + p.counts.superseded;
-    return h("li", {}, h("button", { class: "project", type: "button", "aria-current": p.name === state.project ? "true" : "false",
+    return h("li", {}, h("button", { class: "project", type: "button", "aria-current": state.view === "project" && p.name === state.project ? "true" : "false",
                                      onclick: () => selectProject(p.name), title: p.name },
       h("span", { class: "name" }, p.name),
       h("span", { class: "meta" }, plural(total, "memory", "memories"),
         p.counts.stale ? [", ", h("span", { class: "hot" }, `${p.counts.stale} stale`)] : null)));
   }));
+  const heading = document.getElementById("projects-h");
+  if (heading) heading.hidden = !state.projects.length;
+  const add = document.getElementById("add-project");
+  if (add) add.setAttribute("aria-current", state.view === "add" ? "true" : "false");
 }
 
+const totalOf = (p) => p.counts.active + p.counts.stale + p.counts.retired + p.counts.superseded;
+
 function renderHead() {
   const p = state.projects.find((x) => x.name === state.project);
-  put(document.getElementById("head"), p ? [h("h1", {}, p.name),
-    h("span", { class: "repo mono" }, p.repo || "Repo location not known yet")] : null);
+  if (!p) { put(document.getElementById("head")); return; }
+  const remove = p.repo && totalOf(p) === 0
+    ? h("button", { class: "linkish", type: "button", onclick: () => removeProject(p.name) }, "Remove from dashboard") : null;
+  put(document.getElementById("head"), h("h1", {}, p.name),
+    h("div", { class: "head-links" },
+      h("span", { class: "mono" }, p.repo ? pathNodes(p.repo) : "Repo location not known yet"),
+      p.github ? h("a", { href: `https://github.com/${p.github}`, target: "_blank", rel: "noopener noreferrer" }, `github.com/${p.github}`) : null,
+      remove));
 }
 
 function renderAttention() {
@@ -626,6 +817,9 @@ function renderAttention() {
         ? "These went stale because files they depend on changed, so your AI no longer sees them. Confirm the ones that are still true and retire the rest."
         : "Your AI saved facts that may contradict each other. Decide which one holds."),
       h("div", { class: "panel" }, items));
+  } else if (state.projects.some((x) => x.name === state.project && totalOf(x) === 0)) {
+    put(sec, head, h("div", { class: "panel calm" }, pip("active"),
+      h("span", {}, h("strong", {}, "Nothing to decide yet. "), "When a file that a memory depends on changes, the memory shows up here.")));
   } else if (a.checked_files) {
     put(sec, head, h("div", { class: "panel calm" }, pip("active"),
       h("span", {}, h("strong", {}, "Nothing to decide. "), "Every linked file still matches what its memory was based on.")));
@@ -658,6 +852,14 @@ function renderList() {
   }
   if (!state.memories.length) {
     const kind = state.filter === "any" ? "" : STATE_WORD[state.filter] + " ";
+    const p = state.projects.find((x) => x.name === state.project);
+    if (p && totalOf(p) === 0 && !state.q) {
+      put(list, h("div", { class: "panel note" },
+        h("p", {}, h("strong", {}, "No memories yet. "), "Open your AI tool in this repo and ask it to remember something that a future session should know, for example:"),
+        h("p", { class: "example" }, "“Remember that our tests need DOCKER_HOST set. It depends on docker-compose.yml.”"),
+        h("p", {}, "It will show up here, and Aether Cache will flag it if docker-compose.yml changes.")));
+      return;
+    }
     put(list, h("div", { class: "panel empty" }, state.q ? `No ${kind}memories match “${state.q}”.` : `No ${kind}memories in this project.`));
     return;
   }
@@ -723,10 +925,11 @@ function renderShell() {
   put(document.getElementById("root"), h("div", { class: "app" },
     h("nav", { class: "rail", "aria-label": "Projects" },
       h("div", { class: "wordmark" }, mark, "Aether Cache"),
-      h("h2", {}, "Projects"),
+      h("h2", { id: "projects-h" }, "Projects"),
       h("ul", { class: "projects", id: "projects" }),
+      h("button", { class: "add-project", id: "add-project", type: "button", onclick: () => openAdd(false) }, icon("plus", 14), "Add project"),
       h("div", { class: "engine", id: "engine", role: "status" })),
-    h("main", {}, h("div", { class: "page" },
+    h("main", {}, h("div", { class: "page", id: "add-view", hidden: true }), h("div", { class: "page", id: "project-view" },
       h("div", { class: "page-head", id: "head" }),
       h("section", { id: "attention", "aria-labelledby": "attention-h" }),
       h("section", { "aria-labelledby": "mem-h" },
@@ -758,14 +961,8 @@ document.addEventListener("keydown", (e) => { if (e.key === "Escape" && state.se
     renderBlocker("Can’t load your memories", h("p", {}, e.message));
     return;
   }
-  if (!state.projects.length) {
-    renderBlocker("No memories yet",
-      h("p", {}, "Open your AI tool in any git repo and ask it to remember something, for example:"),
-      h("p", {}, h("code", {}, "Remember that our tests need DOCKER_HOST set. It depends on docker-compose.yml.")),
-      h("p", {}, "Then refresh this page."));
-    return;
-  }
   renderShell();
+  if (!state.projects.length) { renderProjects(); openAdd(true); return; }
   renderProjects(); renderHead(); renderAttention(); renderList();
   try { await refreshAll(); } catch (e) { notify(e.message); }
 })();

{aether_cache-0.1.1 → aether_cache-0.1.2}/aether_cache/ui.py

@@ -19,6 +19,7 @@ from urllib.parse import parse_qs, urlparse
 import redis
 
 from . import __version__, config, engine, server
+from . import repos as repo_tools
 
 PAGE = Path(__file__).resolve().parent / "ui" / "index.html"
 FONTS = {f.name: f for f in (PAGE.parent / "fonts").glob("*.woff2")}  # only these files are ever served
@@ -120,13 +121,44 @@ def api_projects(_q, _body) -> dict:
         if status == "stale" and not last_reason(m["id"]).endswith(FILE_CHANGE):
             status = "retired"
         p["counts"][status] += 1
+    for name, repo in repos.items():  # added repos show up even before they have any memories
+        projects.setdefault(name, {"name": name, "counts": dict.fromkeys(STATUSES + ("retired",), 0)})
     for name, p in projects.items():
         repo = repos.get(name)
         p["repo"] = repo if repo and Path(repo).is_dir() else None
+        p["github"] = repo_tools.github_remote(Path(p["repo"])) if p["repo"] else None
     order = sorted(projects.values(), key=lambda p: (-p["counts"]["stale"], p["name"].lower()))
     return {"projects": order, "version": __version__}
 
 
+def api_discover(_q, _body) -> dict:
+    added = {str(Path(v).resolve()) for v in repo_locations().values() if Path(v).is_dir()}
+    found = repo_tools.discover()
+    for r in found:
+        r["added"] = str(Path(r["path"]).resolve()) in added
+        del r["modified"]
+    return {"repos": found}
+
+
+def api_add(_q, body) -> dict:
+    try:
+        return {"project": repo_tools.add(_need(body, "path"))}
+    except repo_tools.RepoError as e:
+        raise ApiError(400, str(e))
+
+
+def api_remove(_q, body) -> dict:
+    repo_tools.remove(_need(body, "name"))
+    return {"ok": True}
+
+
+def api_pick(_q, _body) -> dict:
+    try:
+        return {"path": repo_tools.pick_folder()}
+    except repo_tools.RepoError as e:
+        raise ApiError(501, str(e))
+
+
 def api_memories(q, _body) -> dict:
     project = _need(q, "project")
     status = q.get("status", "any")
@@ -228,6 +260,10 @@ ROUTES = {
     ("POST", "/api/confirm"): api_confirm,
     ("POST", "/api/retire"): api_retire,
     ("POST", "/api/resolve"): api_resolve,
+    ("GET", "/api/discover"): api_discover,
+    ("POST", "/api/projects/add"): api_add,
+    ("POST", "/api/projects/remove"): api_remove,
+    ("POST", "/api/pick-folder"): api_pick,
 }
 
 

{aether_cache-0.1.1 → aether_cache-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "aether-cache"
-version = "0.1.1"
+version = "0.1.2"
 description = "Shared memory for AI coding tools that stays true to your code."
 readme = "README.md"
 requires-python = ">=3.10"