@phren/cli 0.0.50 → 0.0.53

package/README.md

@@ -68,6 +68,17 @@ phren team join git@github.com:org/phren-team.git
 
 Each team store syncs independently. Run `phren team list` to see all registered stores.
 
+### Filtering Team Store Projects
+
+Subscribe to only the projects you care about:
+
+```bash
+phren store subscribe qualus-shared arc intranet ogrid
+phren store unsubscribe qualus-shared dendron powergrid-api
+```
+
+Unsubscribed projects still exist in the store but won't appear in search, UI, or context injection.
+
 ---
 
 MIT License. Made by [Ala Arab](https://github.com/alaarab).

package/mcp/dist/cli/actions.js

@@ -15,6 +15,19 @@ import { runSearch, runFragmentSearch, parseFragmentSearchArgs, runRelatedDocs,
 import { resolveRuntimeProfile } from "../runtime-profile.js";
 import { getProjectConsolidationStatus, CONSOLIDATION_ENTRY_THRESHOLD } from "../content/validate.js";
 import { listAllSessions } from "../tools/session.js";
+function resolveProjectStorePath(phrenPath, project) {
+    try {
+        const { getNonPrimaryStores } = require("../store-registry.js");
+        if (fs.existsSync(path.join(phrenPath, project)))
+            return phrenPath;
+        for (const store of getNonPrimaryStores(phrenPath)) {
+            if (fs.existsSync(path.join(store.path, project)))
+                return store.path;
+        }
+    }
+    catch { /* fall through */ }
+    return phrenPath;
+}
 async function runAndPrint(fn) {
     const result = await fn();
     if (result.lines.length > 0)
@@ -69,7 +82,8 @@ export async function handleTruths(project) {
         process.exit(1);
     }
     const phrenPath = getPhrenPath();
-    const truthsPath = path.join(phrenPath, project, "truths.md");
+    const storePath = resolveProjectStorePath(phrenPath, project);
+    const truthsPath = path.join(storePath, project, "truths.md");
     if (!fs.existsSync(truthsPath)) {
         console.log(`No truths pinned for "${project}" yet.`);
         console.log(`\nPin one: phren pin ${project} "your truth here"`);
@@ -375,7 +389,8 @@ export async function handleConsolidationStatus(args) {
         ? (() => {
             if (!isValidProjectName(project))
                 return null;
-            const dir = path.join(phrenPath, project);
+            const storePath = resolveProjectStorePath(phrenPath, project);
+            const dir = path.join(storePath, project);
             return fs.existsSync(dir) ? [dir] : [];
         })()
         : getProjectDirs(phrenPath, profile);

package/mcp/dist/cli/cli.js

@@ -79,7 +79,7 @@ export async function runCliCommand(command, args) {
         case "tasks":
             return handleTaskView(getProfile());
         case "sessions":
-            return handleSessionsView(args);
+            return await handleSessionsView(args);
         case "task":
             return handleTaskNamespace(args);
         case "finding":

package/mcp/dist/cli/namespaces.js

@@ -4,6 +4,19 @@ import { execFileSync } from "child_process";
 import { expandHomePath, findArchivedProjectNameCaseInsensitive, findProjectNameCaseInsensitive, getPhrenPath, getProjectDirs, homePath, hookConfigPath, normalizeProjectNameForCreate, readRootManifest, } from "../shared.js";
 import { isValidProjectName, errorMessage } from "../utils.js";
 import { logger } from "../logger.js";
+function resolveProjectStorePath(phrenPath, project) {
+    try {
+        const { getNonPrimaryStores } = require("../store-registry.js");
+        if (fs.existsSync(path.join(phrenPath, project)))
+            return phrenPath;
+        for (const store of getNonPrimaryStores(phrenPath)) {
+            if (fs.existsSync(path.join(store.path, project)))
+                return store.path;
+        }
+    }
+    catch { /* fall through */ }
+    return phrenPath;
+}
 import { readInstallPreferences, writeInstallPreferences } from "../init/preferences.js";
 import { buildSkillManifest, findLocalSkill, findSkill, getAllSkills } from "../skill/registry.js";
 import { detectSkillCollisions } from "../link/skills.js";
@@ -252,10 +265,17 @@ export function handleHooksNamespace(args) {
         const hooksEnabled = prefs.hooksEnabled !== false;
         const toolPrefs = prefs.hookTools && typeof prefs.hookTools === "object" ? prefs.hookTools : {};
         const project = getOptionValue(args.slice(1), "--project");
-        if (project && (!isValidProjectName(project) || !fs.existsSync(path.join(phrenPath, project)))) {
+        if (project && !isValidProjectName(project)) {
             console.error(`Project "${project}" not found.`);
             process.exit(1);
         }
+        if (project) {
+            const storePath = resolveProjectStorePath(phrenPath, project);
+            if (!fs.existsSync(path.join(storePath, project))) {
+                console.error(`Project "${project}" not found.`);
+                process.exit(1);
+            }
+        }
         const rows = HOOK_TOOLS.map((tool) => ({
             tool,
             hookType: "lifecycle",
@@ -663,7 +683,8 @@ export async function handleProjectsNamespace(args, profile) {
             process.exit(1);
         }
         const phrenPath = getPhrenPath();
-        const projectDir = path.join(phrenPath, name);
+        const storePath = resolveProjectStorePath(phrenPath, name);
+        const projectDir = path.join(storePath, name);
         if (!fs.existsSync(projectDir)) {
             console.error(`Project "${name}" not found.`);
             process.exit(1);
@@ -673,16 +694,16 @@ export async function handleProjectsNamespace(args, profile) {
         const summaryPath = path.join(projectDir, "summary.md");
         if (fs.existsSync(summaryPath))
             exported.summary = fs.readFileSync(summaryPath, "utf8");
-        const learningsResult = readFindings(phrenPath, name);
+        const learningsResult = readFindings(storePath, name);
         if (learningsResult.ok)
             exported.learnings = learningsResult.data;
         const findingsPath = path.join(projectDir, "FINDINGS.md");
         if (fs.existsSync(findingsPath))
             exported.findingsRaw = fs.readFileSync(findingsPath, "utf8");
-        const taskResult = readTasks(phrenPath, name);
+        const taskResult = readTasks(storePath, name);
         if (taskResult.ok) {
             exported.task = taskResult.data.items;
-            const taskRawPath = resolveTaskFilePath(phrenPath, name);
+            const taskRawPath = resolveTaskFilePath(storePath, name);
             if (taskRawPath && fs.existsSync(taskRawPath))
                 exported.taskRaw = fs.readFileSync(taskRawPath, "utf8");
         }
@@ -799,8 +820,9 @@ export async function handleProjectsNamespace(args, profile) {
         const phrenPath = getPhrenPath();
         if (subcommand === "archive") {
             const activeProject = findProjectNameCaseInsensitive(phrenPath, name);
-            const projectDir = activeProject ? path.join(phrenPath, activeProject) : path.join(phrenPath, name);
-            const archiveDir = path.join(phrenPath, `${activeProject ?? name}.archived`);
+            const storePath = resolveProjectStorePath(phrenPath, activeProject ?? name);
+            const projectDir = activeProject ? path.join(storePath, activeProject) : path.join(storePath, name);
+            const archiveDir = path.join(storePath, `${activeProject ?? name}.archived`);
             if (!fs.existsSync(projectDir)) {
                 console.error(`Project "${name}" not found.`);
                 process.exit(1);
@@ -826,8 +848,9 @@ export async function handleProjectsNamespace(args, profile) {
                 process.exit(1);
             }
             const archivedProject = findArchivedProjectNameCaseInsensitive(phrenPath, name);
-            const projectDir = path.join(phrenPath, archivedProject ?? name);
-            const archiveDir = path.join(phrenPath, `${archivedProject ?? name}.archived`);
+            const storePath = resolveProjectStorePath(phrenPath, archivedProject ?? name);
+            const projectDir = path.join(storePath, archivedProject ?? name);
+            const archiveDir = path.join(storePath, `${archivedProject ?? name}.archived`);
             if (!fs.existsSync(archiveDir)) {
                 const available = fs.readdirSync(phrenPath)
                     .filter((e) => e.endsWith(".archived"))
@@ -1323,8 +1346,10 @@ export async function handleFindingNamespace(args) {
             console.error("Usage: phren finding list <project>");
             process.exit(1);
         }
+        const phrenPath = getPhrenPath();
         const { readFindings } = await import("../data/access.js");
-        const result = readFindings(getPhrenPath(), project);
+        const storePath = resolveProjectStorePath(phrenPath, project);
+        const result = readFindings(storePath, project);
         if (!result.ok) {
             console.error(result.error);
             process.exit(1);
@@ -1510,6 +1535,8 @@ function printStoreUsage() {
     console.log("  phren store remove <name>               Remove a store (local only)");
     console.log("  phren store sync                        Pull all stores");
     console.log("  phren store activity [--limit N]         Recent team findings");
+    console.log("  phren store subscribe <name> <project...>   Subscribe store to projects");
+    console.log("  phren store unsubscribe <name> <project...> Unsubscribe store from projects");
 }
 export async function handleStoreNamespace(args) {
     const subcommand = args[0];
@@ -1644,7 +1671,8 @@ export async function handleStoreNamespace(args) {
         for (const store of teamStores) {
             if (!fs.existsSync(store.path))
                 continue;
-            const projectDirs = getProjectDirs(store.path);
+            const { getStoreProjectDirs } = await import("../store-registry.js");
+            const projectDirs = getStoreProjectDirs(store);
             for (const dir of projectDirs) {
                 const projectName = path.basename(dir);
                 const journalEntries = readTeamJournalEntries(store.path, projectName);
@@ -1703,6 +1731,42 @@ export async function handleStoreNamespace(args) {
         }
         return;
     }
+    if (subcommand === "subscribe") {
+        const storeName = args[1];
+        const projects = args.slice(2);
+        if (!storeName || projects.length === 0) {
+            console.error("Usage: phren store subscribe <store-name> <project1> [project2...]");
+            process.exit(1);
+        }
+        try {
+            const { subscribeStoreProjects } = await import("../store-registry.js");
+            subscribeStoreProjects(phrenPath, storeName, projects);
+            console.log(`Added ${projects.length} project(s) to "${storeName}"`);
+        }
+        catch (err) {
+            console.error(`Failed to subscribe: ${errorMessage(err)}`);
+            process.exit(1);
+        }
+        return;
+    }
+    if (subcommand === "unsubscribe") {
+        const storeName = args[1];
+        const projects = args.slice(2);
+        if (!storeName || projects.length === 0) {
+            console.error("Usage: phren store unsubscribe <store-name> <project1> [project2...]");
+            process.exit(1);
+        }
+        try {
+            const { unsubscribeStoreProjects } = await import("../store-registry.js");
+            unsubscribeStoreProjects(phrenPath, storeName, projects);
+            console.log(`Removed ${projects.length} project(s) from "${storeName}"`);
+        }
+        catch (err) {
+            console.error(`Failed to unsubscribe: ${errorMessage(err)}`);
+            process.exit(1);
+        }
+        return;
+    }
     console.error(`Unknown store subcommand: ${subcommand}`);
     printStoreUsage();
     process.exit(1);
@@ -1776,7 +1840,8 @@ function countStoreProjects(store) {
     if (!fs.existsSync(store.path))
         return 0;
     try {
-        return getProjectDirs(store.path).length;
+        const storeRegistry = require("../store-registry.js");
+        return storeRegistry.getStoreProjectDirs(store).length;
     }
     catch {
         return 0;

package/mcp/dist/cli/ops.js

@@ -49,7 +49,7 @@ export function handleTaskView(profile) {
     }
     console.log(`\n${totalActive} active, ${totalQueue} queued across ${docs.length} project(s).`);
 }
-export function handleSessionsView(args) {
+export async function handleSessionsView(args) {
     const phrenPath = getPhrenPath();
     const sessionId = args[0];
     if (sessionId) {
@@ -60,7 +60,7 @@ export function handleSessionsView(args) {
             console.error(`Session "${sessionId}" not found.`);
             process.exit(1);
         }
-        const artifacts = getSessionArtifacts(phrenPath, session.sessionId);
+        const artifacts = await getSessionArtifacts(phrenPath, session.sessionId);
         console.log(`Session: ${session.sessionId.slice(0, 8)}`);
         console.log(`Project: ${session.project ?? "—"}`);
         console.log(`Started: ${session.startedAt.slice(0, 16).replace("T", " ")}`);

package/mcp/dist/content/validate.js

@@ -7,6 +7,7 @@ import { errorMessage } from "../utils.js";
 import { countActiveFindings } from "./archive.js";
 import { isTaskFileName } from "../data/tasks.js";
 import { METADATA_REGEX } from "./metadata.js";
+import { getNonPrimaryStores, getStoreProjectDirs } from "../store-registry.js";
 /** Maximum allowed length for a single finding entry (token budget protection). */
 export const MAX_FINDING_LENGTH = 2000;
 function safeParseDate(s) {
@@ -74,6 +75,22 @@ export function checkConsolidationNeeded(phrenPath, profile) {
             results.push(status);
         }
     }
+    // Include projects from team stores
+    try {
+        for (const store of getNonPrimaryStores(phrenPath)) {
+            if (!fs.existsSync(store.path))
+                continue;
+            for (const dir of getStoreProjectDirs(store)) {
+                const status = getProjectConsolidationStatus(dir);
+                if (status && status.recommended) {
+                    results.push(status);
+                }
+            }
+        }
+    }
+    catch {
+        // store-registry not available or error loading, continue with primary only
+    }
     return results;
 }
 /**

package/mcp/dist/data/access.js

@@ -12,6 +12,7 @@ import { parseCitationComment, parseSourceComment, } from "../content/citation.j
 import { parseFindingLifecycle, } from "../finding/lifecycle.js";
 import { METADATA_REGEX, isCitationLine, isArchiveStart, isArchiveEnd, parseFindingId, parseAllContradictions, stripComments, normalizeFindingText, } from "../content/metadata.js";
 import { withSafeLock, ensureProject } from "../shared/data-utils.js";
+import { getNonPrimaryStores, getStoreProjectDirs } from "../store-registry.js";
 export { readTasks, readTasksAcrossProjects, resolveTaskItem, addTask, addTasks, completeTasks, completeTask, removeTask, removeTasks, updateTask, linkTaskIssue, pinTask, unpinTask, workNextTask, tidyDoneTasks, taskMarkdown, appendChildFinding, promoteTask, TASKS_FILENAME, TASK_FILE_ALIASES, canonicalTaskFilePath, resolveTaskFilePath, isTaskFileName, } from "./tasks.js";
 export { addProjectToProfile, listMachines, listProfiles, listProjectCards, removeProjectFromProfile, setMachineProfile, } from "../profile-store.js";
 export { loadShellState, resetShellState, saveShellState, } from "../shell/state-store.js";
@@ -559,6 +560,7 @@ export function readReviewQueueAcrossProjects(phrenPath, profile) {
         Conflicts: 2,
     };
     const items = [];
+    const seen = new Set(projects);
     for (const project of projects) {
         const result = readReviewQueue(phrenPath, project);
         if (!result.ok)
@@ -567,6 +569,30 @@ export function readReviewQueueAcrossProjects(phrenPath, profile) {
             items.push({ project, ...item });
         }
     }
+    // Include projects from team stores
+    try {
+        for (const store of getNonPrimaryStores(phrenPath)) {
+            if (!fs.existsSync(store.path))
+                continue;
+            const storeDirs = getStoreProjectDirs(store)
+                .map((d) => path.basename(d))
+                .filter((p) => p !== "global");
+            for (const storeProject of storeDirs) {
+                if (seen.has(storeProject))
+                    continue;
+                seen.add(storeProject);
+                const result = readReviewQueue(store.path, storeProject);
+                if (!result.ok)
+                    continue;
+                for (const item of result.data) {
+                    items.push({ project: storeProject, ...item });
+                }
+            }
+        }
+    }
+    catch {
+        // store-registry not available or error loading, continue with primary only
+    }
     items.sort((a, b) => {
         const aDate = a.date === "unknown" ? "" : a.date;
         const bDate = b.date === "unknown" ? "" : b.date;

package/mcp/dist/data/tasks.js

@@ -5,6 +5,7 @@ import { phrenErr, PhrenError, phrenOk, forwardErr, getProjectDirs, } from "../s
 import { validateTaskFormat } from "../shared/content.js";
 import { safeProjectPath } from "../utils.js";
 import { withSafeLock, ensureProject } from "../shared/data-utils.js";
+import { getNonPrimaryStores, getStoreProjectDirs } from "../store-registry.js";
 const ACTIVE_HEADINGS = new Set(["active", "in progress", "in-progress", "current", "wip"]);
 const QUEUE_HEADINGS = new Set(["queue", "queued", "task", "todo", "upcoming", "next"]);
 const DONE_HEADINGS = new Set(["done", "completed", "finished", "archived"]);
@@ -352,9 +353,11 @@ export function readTasks(phrenPath, project) {
     return phrenOk(parseTaskContent(project, taskPath, content));
 }
 export function readTasksAcrossProjects(phrenPath, profile) {
-    const projects = getProjectDirs(phrenPath, profile).map((dir) => path.basename(dir)).sort();
     const result = [];
-    for (const project of projects) {
+    const seen = new Set();
+    // Primary store projects (with profile filtering)
+    const primaryProjects = getProjectDirs(phrenPath, profile).map((dir) => path.basename(dir)).sort();
+    for (const project of primaryProjects) {
         const file = canonicalTaskFilePath(phrenPath, project);
         if (!file || !fs.existsSync(file))
             continue;
@@ -362,7 +365,29 @@ export function readTasksAcrossProjects(phrenPath, profile) {
         if (!parsed.ok)
             continue;
         result.push(parsed.data);
+        seen.add(project);
     }
+    // Non-primary store projects (no profile — team stores don't have profiles)
+    try {
+        for (const store of getNonPrimaryStores(phrenPath)) {
+            if (!fs.existsSync(store.path))
+                continue;
+            const storeProjects = getStoreProjectDirs(store).map((dir) => path.basename(dir));
+            for (const project of storeProjects) {
+                if (seen.has(project))
+                    continue;
+                seen.add(project);
+                const file = canonicalTaskFilePath(store.path, project);
+                if (!file || !fs.existsSync(file))
+                    continue;
+                const parsed = readTasks(store.path, project);
+                if (!parsed.ok)
+                    continue;
+                result.push(parsed.data);
+            }
+        }
+    }
+    catch { /* store-registry not available — primary only */ }
     return result;
 }
 export function resolveTaskItem(phrenPath, project, match) {