@phren/cli 0.1.10 → 0.1.11

package/dist/tools/tasks.js

@@ -3,7 +3,7 @@ import { z } from "zod";
 import * as fs from "fs";
 import * as path from "path";
 import { isValidProjectName } from "../utils.js";
-import { addTask as addTaskStore, addTasks as addTasksBatch, taskMarkdown, completeTask as completeTaskStore, completeTasks as completeTasksBatch, removeTask as removeTaskStore, removeTasks as removeTasksBatch, linkTaskIssue, pinTask, workNextTask, tidyDoneTasks, readTasks, readTasksAcrossProjects, resolveTaskItem, TASKS_FILENAME, updateTask as updateTaskStore, promoteTask, } from "../data/access.js";
+import { addTask as addTaskStore, addTasks as addTasksBatch, taskMarkdown, completeTask as completeTaskStore, completeTasks as completeTasksBatch, removeTask as removeTaskStore, removeTasks as removeTasksBatch, linkTaskIssue, pinTask, unpinTask, workNextTask, tidyDoneTasks, readTasks, readTasksAcrossProjects, resolveTaskItem, TASKS_FILENAME, updateTask as updateTaskStore, promoteTask, } from "../data/access.js";
 import { applyGravity } from "../data/tasks.js";
 import { buildTaskIssueBody, createGithubIssueForTask, parseGithubIssueUrl, resolveProjectGithubRepo, } from "../task/github.js";
 import { clearTaskCheckpoint } from "../session/checkpoints.js";
@@ -551,4 +551,32 @@ export function register(server, ctx) {
             return mcpResponse({ ok: true, message: result.data, data: { project, keep: keep ?? 30, dryRun: dry_run ?? false } });
         });
     });
+    server.registerTool("pin_task", {
+        title: "◆ phren · pin task",
+        description: "Pin or unpin a task. Pinned tasks always appear in hook context regardless of priority, " +
+            "so they stay visible across every prompt.",
+        inputSchema: z.object({
+            project: z.string().describe("Project name."),
+            item: z.string().describe("Partial text or task ID (A1, Q3) to match."),
+            unpin: z.boolean().optional().describe("If true, unpin instead of pin."),
+        }),
+    }, async ({ project: projectInput, item, unpin: shouldUnpin }) => {
+        const resolved = resolveStoreForProject(ctx, projectInput);
+        const project = resolved.project;
+        const targetPath = resolved.phrenPath;
+        if (!isValidProjectName(project))
+            return mcpResponse({ ok: false, error: `Invalid project name: "${project}"` });
+        const denied = permissionDeniedError(targetPath, "pin_task", project);
+        if (denied)
+            return mcpResponse({ ok: false, error: denied });
+        return withWriteQueue(async () => {
+            const result = shouldUnpin
+                ? unpinTask(targetPath, project, item)
+                : pinTask(targetPath, project, item);
+            if (!result.ok)
+                return mcpResponse({ ok: false, error: result.error });
+            refreshTaskIndex(updateFileInIndex, targetPath, project);
+            return mcpResponse({ ok: true, message: result.data, data: { project, item, pinned: !shouldUnpin } });
+        });
+    });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phren/cli",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "Knowledge layer for AI agents — CLI, MCP server, and data layer",
   "type": "module",
   "bin": {
@@ -66,6 +66,13 @@
     "skills",
     "scripts/preuninstall.mjs"
   ],
+  "scripts": {
+    "build": "node ../../scripts/build.mjs",
+    "dev": "tsx src/index.ts",
+    "lint": "biome lint --config-path ../../biome.json src/",
+    "test": "echo 'Run tests from repo root: pnpm -w test'",
+    "preuninstall": "node scripts/preuninstall.mjs"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.28.0",
     "chalk": "^5.6.2",
@@ -94,12 +101,5 @@
     "type": "git",
     "url": "git+https://github.com/alaarab/phren.git",
     "directory": "packages/cli"
-  },
-  "scripts": {
-    "build": "node ../../scripts/build.mjs",
-    "dev": "tsx src/index.ts",
-    "lint": "biome lint --config-path ../../biome.json src/",
-    "test": "echo 'Run tests from repo root: pnpm -w test'",
-    "preuninstall": "node scripts/preuninstall.mjs"
   }
-}
+}

package/starter/global/CLAUDE.md

@@ -3,6 +3,15 @@
 <!-- Copy this file to your personal phren instance's global/CLAUDE.md and fill in your own preferences. -->
 <!-- This becomes ~/.claude/CLAUDE.md after syncing. Claude reads it at the start of every session. -->
 
+## Memory
+
+**Use Phren for all knowledge persistence, not Claude Code's built-in auto memory.** Do not write to `~/.claude/projects/.../memory/` files. Instead:
+
+- Save knowledge → `add_finding(project, finding)`
+- Recall knowledge → `search_knowledge(query)`
+- Track tasks → `add_task()` / `complete_task()` / `get_tasks()`
+- Track sessions → `session_start()` / `session_end()`
+
 ## How I Work
 
 <!-- Your non-negotiable rules. Examples: -->

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Ala Arab
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.