@phnx-labs/agents-cli 1.22.119 → 1.22.121

package/dist/lib/memory.js

@@ -1,36 +1,19 @@
-/**
- * Canonical agent memory resource — accumulated facts/preferences/knowledge
- * distinct from `rules` (instructions / AGENTS.md persona).
- *
- * Layout (project > user > system layering):
- *   ~/.agents/memory/MEMORY.md          always-read index
- *   ~/.agents/memory/<slug>.md          individual facts
- *   ~/.agents/.system/memory/           system layer
- *   <project>/.agents/memory/           project layer
- *
- * Sync fans out into each capable agent's version home under an agent-specific
- * target dir (see memoryTargetDir).
- */
 import * as fs from 'fs';
 import * as path from 'path';
 import { getUserAgentsDir, getSystemAgentsDir, getProjectAgentsDir, ensureAgentsDir, getRuntimeStateDir, } from './state.js';
 import { agentConfigDirName } from './agents.js';
 import { supports } from './capabilities.js';
 import { claudeProjectDirName } from './project-key.js';
-/** User-layer memory root (~/.agents/memory/). */
 export function getUserMemoryDir() {
     return path.join(getUserAgentsDir(), 'memory');
 }
-/** System-layer memory root (~/.agents/.system/memory/). */
 function getSystemMemoryDir() {
     return path.join(getSystemAgentsDir(), 'memory');
 }
-/** Project-layer memory root when a project agents dir exists. */
 function getProjectMemoryDir(cwd = process.cwd()) {
     const project = getProjectAgentsDir(cwd);
     return project ? path.join(project, 'memory') : null;
 }
-/** Ensure the user memory dir exists (creates MEMORY.md index if missing). */
 export function ensureUserMemoryDir() {
     ensureAgentsDir();
     const dir = getUserMemoryDir();
@@ -68,7 +51,6 @@ function summarize(content) {
     }
     return '(empty)';
 }
-/** Layer dirs highest-priority first. */
 function getMemoryLayerDirs(cwd = process.cwd()) {
     const out = [];
     const project = getProjectMemoryDir(cwd);
@@ -82,7 +64,6 @@ function getMemoryLayerDirs(cwd = process.cwd()) {
         out.push({ layer: 'system', dir: system });
     return out;
 }
-/** List memory facts with project > user > system override on name. */
 export function listMemoryFacts(cwd = process.cwd()) {
     const seen = new Set();
     const results = [];
@@ -114,7 +95,6 @@ export function listMemoryFacts(cwd = process.cwd()) {
     }
     return results.sort((a, b) => a.name.localeCompare(b.name));
 }
-/** Read one fact by name (winning layer). */
 export function readMemoryFact(name, cwd = process.cwd()) {
     const slug = slugify(name);
     for (const { layer, dir } of getMemoryLayerDirs(cwd)) {
@@ -132,7 +112,6 @@ export function readMemoryFact(name, cwd = process.cwd()) {
     }
     return null;
 }
-/** Write a fact into the user layer. Returns the absolute path. */
 export function addMemoryFact(name, body) {
     const dir = ensureUserMemoryDir();
     const slug = slugify(name);
@@ -144,7 +123,6 @@ export function addMemoryFact(name, body) {
     rebuildMemoryIndex(dir);
     return filePath;
 }
-/** Remove a fact from the user layer. Returns true if a file was deleted. */
 export function removeMemoryFact(name) {
     const dir = getUserMemoryDir();
     const slug = slugify(name);
@@ -156,7 +134,6 @@ export function removeMemoryFact(name) {
         rebuildMemoryIndex(dir);
     return true;
 }
-/** Rebuild MEMORY.md index from sibling fact files in a single layer dir. */
 function rebuildMemoryIndex(dir) {
     let facts = [];
     try {
@@ -190,10 +167,6 @@ function rebuildMemoryIndex(dir) {
     }
     fs.writeFileSync(path.join(dir, 'MEMORY.md'), lines.join('\n'), 'utf-8');
 }
-/**
- * Per-agent target directory (relative to version home) for synced memory.
- * Claude/Codex/OpenClaw/Grok get native-ish paths; others get a generic memory/.
- */
 export function memoryTargetDir(agent) {
     switch (agent) {
         case 'claude':
@@ -207,7 +180,6 @@ export function memoryTargetDir(agent) {
             return path.join(agentConfigDirName(agent), 'memory');
     }
 }
-/** Copy canonical layered memory into one version home. Returns fact names written. */
 export function syncMemoryToVersionHome(agent, versionHome, cwd = process.cwd()) {
     if (!supports(agent, 'memory').ok)
         return [];
@@ -215,9 +187,6 @@ export function syncMemoryToVersionHome(agent, versionHome, cwd = process.cwd())
     const targetRel = memoryTargetDir(agent);
     const targetDir = path.join(versionHome, targetRel);
     fs.mkdirSync(targetDir, { recursive: true });
-    // Managed manifest tracks which fact files *we* wrote. On sync we only
-    // remove previously-managed names that are no longer in the canonical set —
-    // never wipe every .md (user-authored native memory must survive).
     const managedManifestPath = path.join(targetDir, '.agents-cli-memory.json');
     let previouslyManaged = [];
     try {
@@ -226,18 +195,18 @@ export function syncMemoryToVersionHome(agent, versionHome, cwd = process.cwd())
             previouslyManaged = raw.facts.filter((f) => typeof f === 'string');
         }
     }
-    catch { /* missing or corrupt → treat as first managed sync */ }
+    catch { }
     const desiredNames = new Set(facts.map((f) => f.name));
     const managedThisSync = new Set(desiredNames);
     for (const name of previouslyManaged) {
         if (desiredNames.has(name))
             continue;
         if (name === 'MEMORY')
-            continue; // index rewritten below
+            continue;
         try {
             fs.unlinkSync(path.join(targetDir, `${name}.md`));
         }
-        catch { /* ignore */ }
+        catch { }
     }
     const written = [];
     for (const fact of facts) {
@@ -246,9 +215,8 @@ export function syncMemoryToVersionHome(agent, versionHome, cwd = process.cwd())
             fs.copyFileSync(fact.path, dest);
             written.push(fact.name);
         }
-        catch { /* skip unreadable */ }
+        catch { }
     }
-    // Always write an index from the winning layers.
     const indexSrc = (() => {
         for (const { dir } of getMemoryLayerDirs(cwd)) {
             const p = path.join(dir, 'MEMORY.md');
@@ -262,7 +230,7 @@ export function syncMemoryToVersionHome(agent, versionHome, cwd = process.cwd())
             fs.copyFileSync(indexSrc, path.join(targetDir, 'MEMORY.md'));
             managedThisSync.add('MEMORY');
         }
-        catch { /* ignore */ }
+        catch { }
     }
     else {
         rebuildMemoryIndex(targetDir);
@@ -271,37 +239,13 @@ export function syncMemoryToVersionHome(agent, versionHome, cwd = process.cwd())
     try {
         fs.writeFileSync(managedManifestPath, JSON.stringify({ facts: [...managedThisSync].sort() }, null, 2) + '\n', 'utf-8');
     }
-    catch { /* best-effort */ }
+    catch { }
     return written;
 }
-/**
- * Canonical shared dir for Claude Code's NATIVE per-project auto-memory —
- * `<versionHome>/.claude/projects/<project-key>/memory/*.md`, the freeform
- * notes Claude writes for itself during a session. Distinct from the layered
- * `memory` resource above (~/.agents/memory/ facts synced into
- * `.claude/memory/`): this dir is keyed by project (via
- * {@link claudeProjectDirName}), not by agent version, and Claude Code itself
- * decides what goes in it — agents-cli only makes the directory
- * version-independent, never writes into it.
- */
 export function getClaudeProjectMemoryDir(cwd) {
     const projectKey = claudeProjectDirName(path.resolve(cwd));
     return path.join(getRuntimeStateDir(), 'claude-project-memory', projectKey);
 }
-/**
- * Make Claude Code's native per-project memory dir version-independent by
- * symlinking `<versionHome>/.claude/projects/<project-key>/memory/` into the
- * one canonical dir every installed Claude version's home shares for this
- * project (PHNX-2817). Without this, `getVersionHomePath` gives every
- * installed version its own isolated HOME, so a note written under one
- * version is invisible under another — the directory is just empty there.
- *
- * Idempotent and safe to call on every sync: a dir already linked to the
- * canonical target is left alone; a PRE-EXISTING real directory with content
- * (the common case today, since this bug has always left one behind) has its
- * files migrated into the canonical dir first — never discarded — before
- * being replaced by the symlink.
- */
 export function syncClaudeProjectMemoryDir(versionHome, cwd = process.cwd()) {
     const projectKey = claudeProjectDirName(path.resolve(cwd));
     const canonicalDir = path.join(getRuntimeStateDir(), 'claude-project-memory', projectKey);
@@ -312,42 +256,36 @@ export function syncClaudeProjectMemoryDir(versionHome, cwd = process.cwd()) {
     try {
         existing = fs.lstatSync(nativeMemoryDir);
     }
-    catch { /* nothing there yet */ }
+    catch { }
     if (existing?.isSymbolicLink()) {
         let currentTarget;
         try {
             currentTarget = fs.readlinkSync(nativeMemoryDir);
         }
-        catch { /* dangling link */ }
+        catch { }
         if (currentTarget === canonicalDir)
-            return; // already wired correctly
-        fs.unlinkSync(nativeMemoryDir); // stale/foreign link — replace below
+            return;
+        fs.unlinkSync(nativeMemoryDir);
     }
     else if (existing?.isDirectory()) {
-        // Migrate first (never clobber content already promoted to canonical by
-        // an earlier-synced version home), then remove the now-redundant copy.
         fs.cpSync(nativeMemoryDir, canonicalDir, { recursive: true, force: false, errorOnExist: false });
         fs.rmSync(nativeMemoryDir, { recursive: true, force: true });
     }
     else if (existing) {
-        return; // an unexpected file at this path — leave it alone rather than destroy it
+        return;
     }
     fs.mkdirSync(projectDir, { recursive: true });
     try {
         fs.symlinkSync(canonicalDir, nativeMemoryDir, process.platform === 'win32' ? 'junction' : undefined);
     }
     catch (err) {
-        // A concurrent sync (e.g. two `agents run claude` launches racing on a
-        // first-ever project) can win this exact link between our lstat above
-        // and this call. If it landed the same canonical target, that's the
-        // outcome we wanted — treat it as success rather than throwing.
         if (err?.code !== 'EEXIST')
             throw err;
         let racedTarget;
         try {
             racedTarget = fs.readlinkSync(nativeMemoryDir);
         }
-        catch { /* not even a symlink — fall through to rethrow */ }
+        catch { }
         if (racedTarget !== canonicalDir)
             throw err;
     }

package/dist/lib/menubar/download-menubar.d.ts

@@ -1,46 +1,11 @@
-/**
- * On-demand download + verification of the macOS menu-bar helper
- * ("MenubarHelper.app").
- *
- * Mirrors the ComputerHelper download model the computer subsystem used before
- * it was extracted (PHNX-4075): the
- * helper ships as a signed + notarized `.app` zipped as a GitHub release asset
- * on the helper's own `menubar/v<x.y.z>` tag, NOT the CLI's tag (see
- * `helper-versions.ts`). A fresh `npm i -g` machine whose tarball lacks a
- * bundled copy fetches the asset for the pinned helper version, verifies its
- * sha256 + code signature before install.
- *
- * The one difference — and the reason this is not the ComputerHelper spec — is
- * the DESIGNATED-REQUIREMENT pin. macOS keys the menu bar's Accessibility (TCC)
- * grant to the bundle's designated requirement (bundle id
- * `com.phnx-labs.agents-menubar` + Developer ID Team `2HTP252L87`), and
- * re-validates each new version against it. A downloaded bundle whose DR drops
- * either pin would silently revoke the user's grant, so `MENUBAR_HELPER_SPEC`
- * sets `expectedBundleId` and the shared `verifyHelperApp` enforces the DR
- * before the bundle is ever installed. This matches the release-time gate in
- * `scripts/verify-menubar-helper.sh`.
- */
 import { type HelperSpec } from '../helper-download.js';
-/** The zipped `.app` release asset name. */
 export declare const MENUBAR_HELPER_ASSET = "MenubarHelper.app.zip";
-/** The bundle directory name once extracted. */
 export declare const MENUBAR_HELPER_APP_NAME = "MenubarHelper.app";
-/** The bundle id the Accessibility grant (and thus the designated requirement)
- *  is keyed to — the same value `install-menubar.ts`'s `SERVICE_LABEL_BASE` and
- *  `scripts/verify-menubar-helper.sh` pin. */
 export declare const MENUBAR_HELPER_BUNDLE_ID = "com.phnx-labs.agents-menubar";
-/** MenubarHelper identity + verification policy — DR-pinned (see docblock). */
 export declare const MENUBAR_HELPER_SPEC: HelperSpec;
-/** Release-asset URLs for the menu-bar helper zip + its checksum at `v<version>`. */
 export declare function menubarHelperAssetUrls(version: string): {
     zip: string;
     sha256: string;
 };
-/** Cache dir for the downloaded menu-bar helper, one subdir per release tag. */
 export declare function menubarHelperCacheDir(version: string): string;
-/**
- * Download the menu-bar helper release asset for `version`, verify sha256 +
- * signature + DR pin, and return the path to the extracted `MenubarHelper.app`
- * in the cache. A missing asset is a hard error naming the exact tag.
- */
 export declare function downloadMenubarHelperApp(version: string): Promise<string>;

package/dist/lib/menubar/download-menubar.js

@@ -1,35 +1,7 @@
-/**
- * On-demand download + verification of the macOS menu-bar helper
- * ("MenubarHelper.app").
- *
- * Mirrors the ComputerHelper download model the computer subsystem used before
- * it was extracted (PHNX-4075): the
- * helper ships as a signed + notarized `.app` zipped as a GitHub release asset
- * on the helper's own `menubar/v<x.y.z>` tag, NOT the CLI's tag (see
- * `helper-versions.ts`). A fresh `npm i -g` machine whose tarball lacks a
- * bundled copy fetches the asset for the pinned helper version, verifies its
- * sha256 + code signature before install.
- *
- * The one difference — and the reason this is not the ComputerHelper spec — is
- * the DESIGNATED-REQUIREMENT pin. macOS keys the menu bar's Accessibility (TCC)
- * grant to the bundle's designated requirement (bundle id
- * `com.phnx-labs.agents-menubar` + Developer ID Team `2HTP252L87`), and
- * re-validates each new version against it. A downloaded bundle whose DR drops
- * either pin would silently revoke the user's grant, so `MENUBAR_HELPER_SPEC`
- * sets `expectedBundleId` and the shared `verifyHelperApp` enforces the DR
- * before the bundle is ever installed. This matches the release-time gate in
- * `scripts/verify-menubar-helper.sh`.
- */
 import { EXPECTED_TEAM_ID, downloadHelperApp, helperAssetUrls, helperCacheDir } from '../helper-download.js';
-/** The zipped `.app` release asset name. */
 export const MENUBAR_HELPER_ASSET = 'MenubarHelper.app.zip';
-/** The bundle directory name once extracted. */
 export const MENUBAR_HELPER_APP_NAME = 'MenubarHelper.app';
-/** The bundle id the Accessibility grant (and thus the designated requirement)
- *  is keyed to — the same value `install-menubar.ts`'s `SERVICE_LABEL_BASE` and
- *  `scripts/verify-menubar-helper.sh` pin. */
 export const MENUBAR_HELPER_BUNDLE_ID = 'com.phnx-labs.agents-menubar';
-/** MenubarHelper identity + verification policy — DR-pinned (see docblock). */
 export const MENUBAR_HELPER_SPEC = {
     helper: 'menubar',
     assetName: MENUBAR_HELPER_ASSET,
@@ -37,24 +9,14 @@ export const MENUBAR_HELPER_SPEC = {
     cacheSubdir: ['menubar', 'mac-helper'],
     expectedTeamId: EXPECTED_TEAM_ID,
     expectedBundleId: MENUBAR_HELPER_BUNDLE_ID,
-    // No local build exists in this repo: the source is phnx-labs/agi-menu. The
-    // staging script downloads + verifies the same published asset into
-    // bin/MenubarHelper.app, which the installer resolves from a checkout.
     localBuildHint: 'scripts/stage-menubar-helper.sh (stages the published menubar/v<floor> asset into bin/MenubarHelper.app; source: https://github.com/phnx-labs/agi-menu)',
 };
-/** Release-asset URLs for the menu-bar helper zip + its checksum at `v<version>`. */
 export function menubarHelperAssetUrls(version) {
     return helperAssetUrls(MENUBAR_HELPER_SPEC, version);
 }
-/** Cache dir for the downloaded menu-bar helper, one subdir per release tag. */
 export function menubarHelperCacheDir(version) {
     return helperCacheDir(MENUBAR_HELPER_SPEC, version);
 }
-/**
- * Download the menu-bar helper release asset for `version`, verify sha256 +
- * signature + DR pin, and return the path to the extracted `MenubarHelper.app`
- * in the cache. A missing asset is a hard error naming the exact tag.
- */
 export function downloadMenubarHelperApp(version) {
     return downloadHelperApp(MENUBAR_HELPER_SPEC, version);
 }