freddie 0.0.72 → 0.0.74

package/AGENTS.md

@@ -44,10 +44,26 @@ Witness 2026-05-03: test.js 12/12 green @ 195L (asserts `host.plugins().length>=
 
 **gm-cc plugin integration** (2026-05-04) — gm-cc npm package (v2.0.727) successfully integrated via `plugins/gm-cc/plugin.js`. Plugin auto-discovers 12 SKILL.md files from gm-cc package, extracts name/description from YAML frontmatter, registers via `pi.skills.register({name: 'gm:'+name, description, content, source:'gm-cc'})`. Skills: browser, code-search, create-lang-plugin, gm, gm-complete, gm-emit, gm-execute, governance, pages, planning, ssh, update-docs. All accessible via `gm:*` namespace in pi.skills registry.
 
+## Multi-project workspace system (2026-05-04)
+
+Freddie supports multiple isolated projects, each with its own home directory and plugin set. Registry at `~/.freddie/projects.json` stores `{ active, projects: [{name, path, created_at}] }`. Default project (`~/.freddie`) is protected from deletion.
+
+Code:
+- `src/projects.js` — CRUD: `loadRegistry()`, `listProjects()`, `getActiveProject()`, `createProject({name, projectPath})`, `deleteProject(name)`, `setActiveProject(name)`, `applyActiveProjectFromRegistry()`. 
+- `src/home.js` — added `applyHomeOverride(absPath)` to set `FREDDIE_HOME` env and clear cached home.
+- `src/host/index.js` — `bootHost()` calls `applyActiveProjectFromRegistry()` before plugin discovery, so plugins resolve against active project root.
+- `plugins/gui-projects/plugin.js` — GUI plugin exposing `GET /api/projects`, `POST /api/projects` (create), `DELETE /api/projects/:name`, `POST /api/projects/active` (switch).
+- `src/web/app.js` — `#/projects` route, project pill in topbar, full CRUD UI.
+
+Isolation boundary: Each project gets its own sessions DB, config.json, skills/, plugins/, cron.db, batches/, logs/, auth.json (all under `getFreddieHome()`). Plugins re-read paths per-request via `getFreddieHome()`.
+
+**Runtime switch caveat** — Switching active project calls `resetHostForTests()` and clears caches but does NOT re-discover plugins in the running dashboard. UI alerts user to restart dashboard for plugin reload. New process auto-picks up active project via `applyActiveProjectFromRegistry()` on `bootHost()`. Gap: if user switches project then uses a plugin-registered tool before restarting, the OLD project's tool set loads. `/api/health` returns `{ freddie_home: "<active-project-path>" }` after project switch. Needs improvement: in-process plugin re-discovery on project switch.
+
 ## Layout
 
 ```
-src/home.js                      # getFreddieHome, applyProfileOverride
+src/home.js                      # getFreddieHome, applyProfileOverride, applyHomeOverride
+src/projects.js                  # Multi-project registry CRUD (loadRegistry, createProject, deleteProject, setActiveProject)
 src/config.js                    # loadConfig, saveConfigValue, DEFAULT_CONFIG, _config_version migrations
 src/sessions.js                  # better-sqlite3 + FTS5
 src/auth.js                      # FileAuthStore for credentials
@@ -176,6 +192,7 @@ One `test.js` at project root. ≤200 lines. Plain assertions, real data, real s
 | Toolsets | `src/toolsets.js` |
 | Session store | `src/sessions.js` (better-sqlite3 + FTS5) |
 | Home + profiles | `src/home.js` |
+| Multi-project registry | `src/projects.js` (isolated FREDDIE_HOME per project) |
 | Structured logging | `src/observability/log.js` |
 | Config | `src/config.js` |
 | Commands | `src/commands/registry.js` |
@@ -234,6 +251,8 @@ All 12 test.js named groups passing: home+config+skin, sessions+FTS5, tools+tool
 
 ## Learning audit
 
+- 2026-05-04 (session 1): Multi-project workspace system documented. Registry, CRUD ops, isolation boundaries, GUI plugin, and runtime plugin switch caveat added. 4 facts ingested to rs-learn: project/freddie-multi-project-registry, reference/freddie-projects-module, reference/freddie-gui-projects-endpoints, feedback/freddie-project-switch-reload-limitation. Reach check passed (in-reach). AGENTS.md updated with new subsystem section + Layout entries + subsystem guide row.
+- 2026-05-04 (session 2): Audit cycle — 5 queries fired (pi-ai env keys, profile safe paths, libsql async debt, browser syntax errors, plugin architecture contract). rs-learn store still returning "No recall results" or off-topic trajectory entries. All 5 recalls failed. 0 items migrated; all AGENTS.md facts retained (safe default). Ingest path confirmed live (4 facts accepted), but retrieval side empty. Likely requires backend indexing rebuild or cross-session propagation.
 - 2026-05-01: 5 items queried (pi-ai keys, profile paths, cache safety, floosie composition, browser errors); rs-learn store unavailable (exec:recall returned no results). 0 items migrated. New facts (anentrypoint-design build, dashboard live-rerender caveat, libuv spawn caveat) ingested directly into rs-learn; audit will retry in future sessions.
 - 2026-05-01 (session 2): 5 items queried (pi-ai env keys, profile safe paths, cache safety, floosie composition, browser syntax errors). rs-learn store still empty. 0 items migrated. Refined anentrypoint-design source/dist skew entry in AGENTS.md to include silent-failure pageerror diagnostic. New fact `reference/anentrypoint-design-dist-rebuild` ingested.
 - 2026-05-03: Pre-rename validation snapshot recorded (all 12 test.js groups, CLI, tools, 284 files, version drift). Baseline stored to isolate post-rename regressions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "freddie",
-  "version": "0.0.72",
+  "version": "0.0.74",
   "type": "module",
   "description": "Open JS agent harness built on pi-mono, floosie, xstate, and anentrypoint-design",
   "bin": {
@@ -26,7 +26,7 @@
     "plugsdk": "^1.0.15",
     "xstate": "^5.31.0",
     "zod": "^4.0.0",
-    "anentrypoint-design": "^0.0.48"
+    "anentrypoint-design": "^0.0.53"
   },
   "optionalDependencies": {
     "@libsql/darwin-arm64": "0.3.19",

package/plugins/gui-projects/plugin.js

@@ -0,0 +1,29 @@
+import { listProjects, getActiveProject, createProject, deleteProject, setActiveProject } from '../../src/projects.js'
+import { resetHostForTests } from '../../src/host/index.js'
+
+export default {
+    name: 'gui-projects',
+    surfaces: 'gui',
+    register({ gui }) {
+        gui.route('GET', '/api/projects', (_, res) => res.json({ active: getActiveProject(), projects: listProjects() }))
+        gui.route('POST', '/api/projects', (req, res) => {
+            try {
+                const { name, path: projectPath } = req.body || {}
+                const created = createProject({ name, projectPath })
+                res.json(created)
+            } catch (e) { res.status(400).json({ error: e.message }) }
+        })
+        gui.route('DELETE', '/api/projects/:name', (req, res) => {
+            try { deleteProject(req.params.name); res.json({ ok: true }) }
+            catch (e) { res.status(400).json({ error: e.message }) }
+        })
+        gui.route('POST', '/api/projects/active', (req, res) => {
+            try {
+                const { name } = req.body || {}
+                const proj = setActiveProject(name)
+                resetHostForTests()
+                res.json({ ok: true, active: proj, note: 'restart dashboard to load new project plugins' })
+            } catch (e) { res.status(400).json({ error: e.message }) }
+        })
+    },
+}

package/src/home.js

@@ -27,6 +27,13 @@ export function applyProfileOverride(name) {
     _cached = null
 }
 
+export function applyHomeOverride(absPath) {
+    if (!absPath) { delete process.env.FREDDIE_HOME; _cached = null; return }
+    process.env.FREDDIE_HOME = absPath
+    _cached = null
+    ensure(absPath)
+}
+
 export function getProfilesRoot() {
     if (process.env.FREDDIE_PROFILES_ROOT) return process.env.FREDDIE_PROFILES_ROOT
     if (process.env.FREDDIE_HOME) return path.join(process.env.FREDDIE_HOME, 'profiles')

package/src/host/index.js

@@ -2,6 +2,7 @@ import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { createHost, discoverPlugins } from './host.js'
 import { getFreddieHome } from '../home.js'
+import { applyActiveProjectFromRegistry } from '../projects.js'
 
 let _host = null
 let _loaded = false
@@ -18,6 +19,7 @@ export async function bootHost(extraRoots = []) {
     const h = host()
     if (_loaded) return h
     _loaded = true
+    if (!process.env.FREDDIE_HOME && !process.env.FREDDIE_PROFILE) applyActiveProjectFromRegistry()
     const roots = [REPO_PLUGINS, path.join(getFreddieHome(), 'plugins'), path.join(process.cwd(), '.freddie', 'plugins'), ...extraRoots]
     const plugins = await discoverPlugins(roots)
     await h.load(plugins)

package/src/projects.js

@@ -0,0 +1,79 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import { applyHomeOverride } from './home.js'
+
+const REGISTRY_PATH = path.join(os.homedir(), '.freddie', 'projects.json')
+
+const DEFAULT_REGISTRY = {
+    active: 'default',
+    projects: [
+        { name: 'default', path: path.join(os.homedir(), '.freddie'), created_at: new Date().toISOString() },
+    ],
+}
+
+function ensureRegistry() {
+    const dir = path.dirname(REGISTRY_PATH)
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true })
+    if (!fs.existsSync(REGISTRY_PATH)) {
+        fs.writeFileSync(REGISTRY_PATH, JSON.stringify(DEFAULT_REGISTRY, null, 2))
+    }
+}
+
+export function loadRegistry() {
+    ensureRegistry()
+    try {
+        const raw = JSON.parse(fs.readFileSync(REGISTRY_PATH, 'utf8'))
+        if (!raw.projects || !Array.isArray(raw.projects)) return DEFAULT_REGISTRY
+        if (!raw.projects.find(p => p.name === 'default')) raw.projects.unshift(DEFAULT_REGISTRY.projects[0])
+        if (!raw.active) raw.active = 'default'
+        return raw
+    } catch { return DEFAULT_REGISTRY }
+}
+
+function saveRegistry(reg) {
+    ensureRegistry()
+    fs.writeFileSync(REGISTRY_PATH, JSON.stringify(reg, null, 2))
+}
+
+export function listProjects() { return loadRegistry().projects }
+
+export function getActiveProject() {
+    const reg = loadRegistry()
+    return reg.projects.find(p => p.name === reg.active) || reg.projects[0]
+}
+
+export function createProject({ name, projectPath }) {
+    if (!name || !projectPath) throw new Error('name and path are required')
+    if (!path.isAbsolute(projectPath)) throw new Error('path must be absolute')
+    const reg = loadRegistry()
+    if (reg.projects.find(p => p.name === name)) throw new Error('project name already exists')
+    if (!fs.existsSync(projectPath)) fs.mkdirSync(projectPath, { recursive: true })
+    reg.projects.push({ name, path: projectPath, created_at: new Date().toISOString() })
+    saveRegistry(reg)
+    return reg.projects[reg.projects.length - 1]
+}
+
+export function deleteProject(name) {
+    if (name === 'default') throw new Error('cannot delete default project')
+    const reg = loadRegistry()
+    reg.projects = reg.projects.filter(p => p.name !== name)
+    if (reg.active === name) reg.active = 'default'
+    saveRegistry(reg)
+}
+
+export function setActiveProject(name) {
+    const reg = loadRegistry()
+    const proj = reg.projects.find(p => p.name === name)
+    if (!proj) throw new Error('unknown project: ' + name)
+    reg.active = name
+    saveRegistry(reg)
+    applyHomeOverride(proj.path)
+    return proj
+}
+
+export function applyActiveProjectFromRegistry() {
+    const proj = getActiveProject()
+    if (proj) applyHomeOverride(proj.path)
+    return proj
+}

package/src/web/app.js

@@ -13,6 +13,7 @@ window.__debug.agents = () => ({ registered: true, active: AppState.agents?.acti
 const j = async (u, opts) => { try { const r = await fetch(u, opts); if (!r.ok) throw new Error(r.status + ' ' + r.statusText); return await r.json() } catch (e) { return { __error: String(e) } } }
 
 const ROUTES = [
+    { path: '#/projects',  label: 'Projects',      glyph: '◆' },
     { path: '#/home',      label: 'Home',          glyph: '⌂' },
     { path: '#/chat',      label: 'Chat',          glyph: '⌨' },
     { path: '#/sessions',  label: 'Sessions',      glyph: '✉' },
@@ -40,6 +41,7 @@ const AppState = {
     chat: { messages: [], draft: '', streaming: false },
     batch: { results: null, running: false },
     agents: { count: 0, active: null },
+    projects: { active: null, all: [] },
 }
 function applyTheme() { document.body.setAttribute('data-theme', AppState.theme) }
 applyTheme()
@@ -77,6 +79,51 @@ function toChatMsg(m, key) {
 }
 
 const PAGES = {
+    '#/projects': async () => {
+        const data = await j('/api/projects')
+        const all = data.projects || []
+        const active = data.active || null
+        AppState.projects = { active, all }
+        return [
+            Hero({ title: 'Projects', body: 'Each project is its own ~/.freddie home: separate sessions, agents, skills, config, env, cron, batches. Switch the active project to swap everything.', accent: active ? 'active · ' + active.name : 'no project active' }),
+            kpi([[all.length, 'Projects'], [active?.name || '—', 'Active'], [active?.path?.length > 30 ? '…'+active.path.slice(-28) : (active?.path || '—'), 'Path']]),
+            Panel({ title: 'Add a project', children: h('form', { class: 'row-form', onsubmit: async (ev) => {
+                ev.preventDefault()
+                const f = ev.target.elements
+                const r = await j('/api/projects', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: f.name.value, path: f.path.value }) })
+                if (r.__error || r.error) { alert('Error: ' + (r.error || r.__error)); return }
+                f.name.value = ''; f.path.value = ''; rerender()
+            } },
+                h('input', { name: 'name', placeholder: 'project name (e.g. penguins)', required: true }),
+                h('input', { name: 'path', placeholder: 'absolute path (e.g. C:\\dev\\penguins)', required: true, style: 'flex:2' }),
+                h('button', { type: 'submit', class: 'primary' }, 'Add')) }),
+            Panel({ title: 'All projects', count: all.length, right: active ? Chip({ tone: 'ok', children: 'active: ' + active.name }) : null,
+                children: h('div', {}, ...all.map(p => h('div', { class: 'row', style: 'cursor:pointer', onclick: async () => {
+                    if (p.name === active?.name) return
+                    const r = await j('/api/projects/active', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ name: p.name }) })
+                    if (r.__error || r.error) { alert('Switch failed: ' + (r.error || r.__error)); return }
+                    alert('Switched to project "' + p.name + '". Restart the dashboard to load its plugins/data, then reload this page.')
+                    rerender()
+                } },
+                    h('span', { class: 'code' }, p.name === active?.name ? '●' : '○'),
+                    h('span', { class: 'title' }, p.name + (p.name === active?.name ? '  (active)' : '')),
+                    h('span', { class: 'meta' }, p.path),
+                    p.name !== 'default' ? h('button', { class: 'danger', style: 'margin-left:8px',
+                        onclick: async (ev) => { ev.stopPropagation(); if (!confirm('Remove project "'+p.name+'" from registry? Files on disk are kept.')) return; await fetch('/api/projects/' + p.name, { method: 'DELETE' }); rerender() } }, 'remove') : null,
+                ))) }),
+            Panel({ title: 'How encapsulation works', children: Receipt({ rows: [
+                ['Sessions DB', '<project>/sessions.db'],
+                ['Config', '<project>/config.json'],
+                ['Skills', '<project>/skills/'],
+                ['Plugins', '<project>/plugins/ + repo/plugins'],
+                ['Cron jobs', '<project>/cron.db'],
+                ['Batches', '<project>/batches/'],
+                ['Logs', '<project>/logs/'],
+                ['Auth credentials', '<project>/auth.json'],
+            ]}) }),
+        ]
+    },
+
     '#/chat': async () => {
         const messages = AppState.chat.messages.map((m, i) => toChatMsg(m, 'm' + i))
         return AICat({
@@ -455,8 +502,15 @@ function render(state) {
         onkeydown: (ev) => { if (ev.key === 'Enter') doSearch(ev.target.value) },
         style: 'min-width:240px',
     })
+    const projectPill = h('a', {
+        href: '#/projects',
+        class: 'project-pill',
+        title: state.projects.active ? 'Active project: ' + state.projects.active.name + ' — ' + state.projects.active.path : 'No active project',
+        style: 'display:inline-flex;align-items:center;gap:6px;padding:4px 12px;border-radius:999px;background:var(--panel-2);color:var(--panel-text);text-decoration:none;font-size:12px;font-weight:500',
+    }, h('span', { style: 'opacity:0.6' }, '◆'), h('span', {}, state.projects.active?.name || 'default'))
     const topbarWithControls = h('header', { class: 'app-topbar' },
         Brand({ name: 'freddie', leaf: 'dashboard' }),
+        projectPill,
         h('div', { style: 'flex:1' }),
         searchInput,
         themeBtn,
@@ -480,11 +534,17 @@ function render(state) {
 
 let _mount
 
+async function refreshProject() {
+    const data = await j('/api/projects')
+    if (!data.__error) AppState.projects = { active: data.active || null, all: data.projects || [] }
+}
+
 async function go() {
-    AppState.hash = location.hash || '#/home'
+    AppState.hash = location.hash || '#/projects'
     AppState.ts = new Date().toLocaleTimeString()
     AppState.body = EmptyState({ text: 'loading…', glyph: '◌' })
     if (_mount) _mount()
+    refreshProject()
     let body
     if (AppState.hash.startsWith('#/session/')) {
         body = await pageSessionDetail(AppState.hash.slice('#/session/'.length))