feat: add project list tool and lint fix workflow

Author: phernandez

README.md

@@ -30,37 +30,43 @@ For a practical runbook, see [Memory + Task Flow](./MEMORY_TASK_FLOW.md).
 
 ## Installation
 
-Clone and install:
+### Install in OpenClaw (local directory)
+
 ```bash
 git clone https://github.com/basicmachines-co/openclaw-basic-memory.git
 cd openclaw-basic-memory
 bun install
+openclaw plugins install -l "$PWD"
 ```
 
-### Optional: Install Companion Skills
-
-You can pair this plugin with skills from
-[`basic-memory-skills`](https://github.com/basicmachines-co/basic-memory-skills):
+Then set this plugin as the memory slot owner in your OpenClaw config:
 
-- `memory-tasks` — structured task tracking that survives compaction
-- `memory-reflect` — periodic consolidation of recent notes into durable memory
-- `memory-defrag` — periodic cleanup/reorganization of memory files
+```json5
+{
+  plugins: {
+    entries: {
+      "basic-memory": {
+        enabled: true
+      }
+    },
+    slots: {
+      memory: "basic-memory"
+    }
+  }
+}
+```
 
-Install (workspace-local):
+Restart OpenClaw gateway after install/config changes, then verify:
 
 ```bash
-git clone https://github.com/basicmachines-co/basic-memory-skills.git
-cp -r basic-memory-skills/memory-tasks ~/.openclaw/workspace/skills/
-cp -r basic-memory-skills/memory-reflect ~/.openclaw/workspace/skills/
-cp -r basic-memory-skills/memory-defrag ~/.openclaw/workspace/skills/
+openclaw plugins list
+openclaw plugins info basic-memory
 ```
 
-If you want these skills available to multiple workspaces/agents on the same machine,
-install to `~/.openclaw/skills/` instead.
+### Manual Load Path (Dev Alternative)
 
-After installation, start a new OpenClaw session so the refreshed skill set is loaded.
+If you prefer loading directly from a path in config instead of `plugins install`:
 
-Add to your OpenClaw config:
 ```json5
 {
   plugins: {
@@ -71,11 +77,37 @@ Add to your OpenClaw config:
       "basic-memory": {
         enabled: true
       }
+    },
+    slots: {
+      memory: "basic-memory"
     }
   }
 }
 ```
 
+### Optional: Install Companion Skills
+
+You can pair this plugin with skills from
+[`basic-memory-skills`](https://github.com/basicmachines-co/basic-memory-skills):
+
+- `memory-tasks` — structured task tracking that survives compaction
+- `memory-reflect` — periodic consolidation of recent notes into durable memory
+- `memory-defrag` — periodic cleanup/reorganization of memory files
+
+Install (workspace-local):
+
+```bash
+git clone https://github.com/basicmachines-co/basic-memory-skills.git
+cp -r basic-memory-skills/memory-tasks ~/.openclaw/workspace/skills/
+cp -r basic-memory-skills/memory-reflect ~/.openclaw/workspace/skills/
+cp -r basic-memory-skills/memory-defrag ~/.openclaw/workspace/skills/
+```
+
+If you want these skills available to multiple workspaces/agents on the same machine,
+install to `~/.openclaw/skills/` instead.
+
+After installation, start a new OpenClaw session so the refreshed skill set is loaded.
+
 ## Configuration
 
 ### Minimal (zero-config)
@@ -344,6 +376,30 @@ bun run lint          # Linting
 bun test              # Run tests (156 tests)
 ```
 
+## Publish to npm
+
+This package is published as `@openclaw/basic-memory`.
+
+```bash
+# 1) Verify release readiness (types + tests + npm pack dry run)
+just release-check
+
+# 2) Inspect publish payload
+just release-pack
+
+# 3) Authenticate once (if needed)
+npm login
+
+# 4) Publish current version from package.json
+just release-publish
+```
+
+For a full release (version bump + publish + push tag):
+
+```bash
+just release patch   # or: minor, major, 0.2.0, etc.
+```
+
 ### Project Structure
 ```
 openclaw-basic-memory/

biome.json

@@ -31,6 +31,24 @@
       "semicolons": "asNeeded"
     }
   },
+  "overrides": [
+    {
+      "includes": ["**/*.test.ts"],
+      "linter": {
+        "rules": {
+          "style": {
+            "noNonNullAssertion": "off"
+          },
+          "complexity": {
+            "noBannedTypes": "off"
+          },
+          "suspicious": {
+            "noExplicitAny": "off"
+          }
+        }
+      }
+    }
+  ],
   "linter": {
     "domains": {
       "project": "none"

bm-client.test.ts

@@ -1,9 +1,9 @@
 import { beforeEach, describe, expect, it, jest } from "bun:test"
 import {
   BmClient,
-  isProjectAlreadyExistsError,
   isMissingEditNoteCommandError,
   isNoteNotFoundError,
+  isProjectAlreadyExistsError,
   isUnsupportedStripFrontmatterError,
   parseJsonOutput,
   stripFrontmatter,
@@ -47,18 +47,18 @@ Warning: something happened
           new Error("No such option: --strip-frontmatter"),
         ),
       ).toBe(true)
-      expect(isUnsupportedStripFrontmatterError(new Error("different error"))).toBe(
-        false,
-      )
+      expect(
+        isUnsupportedStripFrontmatterError(new Error("different error")),
+      ).toBe(false)
     })
 
     it("detects missing edit-note command errors", () => {
       expect(
         isMissingEditNoteCommandError(new Error("No such command 'edit-note'")),
       ).toBe(true)
-      expect(isMissingEditNoteCommandError(new Error("validation failed"))).toBe(
-        false,
-      )
+      expect(
+        isMissingEditNoteCommandError(new Error("validation failed")),
+      ).toBe(false)
     })
 
     it("detects note-not-found errors and excludes missing command errors", () => {
@@ -199,9 +199,7 @@ describe("BmClient behavior", () => {
   })
 
   it("ensureProject throws when project creation fails for other reasons", async () => {
-    const execRaw = jest
-      .fn()
-      .mockRejectedValue(new Error("permission denied"))
+    const execRaw = jest.fn().mockRejectedValue(new Error("permission denied"))
     ;(client as any).execRaw = execRaw
 
     await expect(client.ensureProject("/tmp/memory")).rejects.toThrow(
@@ -230,13 +228,49 @@ describe("BmClient behavior", () => {
     ])
   })
 
+  it("listProjects runs bm project list --format json", async () => {
+    const execRaw = jest.fn().mockResolvedValue(
+      JSON.stringify([
+        {
+          name: "alpha",
+          path: "/tmp/alpha",
+          display_name: "Alpha Project",
+          is_private: true,
+          is_default: true,
+        },
+      ]),
+    )
+    ;(client as any).execRaw = execRaw
+
+    const projects = await client.listProjects()
+
+    expect(execRaw).toHaveBeenCalledWith([
+      "project",
+      "list",
+      "--format",
+      "json",
+    ])
+    expect(projects).toEqual([
+      {
+        name: "alpha",
+        path: "/tmp/alpha",
+        display_name: "Alpha Project",
+        is_private: true,
+        is_default: true,
+      },
+    ])
+  })
+
   it("indexConversation does not create fallback note on non-not-found edit errors", async () => {
     ;(client as any).editNote = jest
       .fn()
       .mockRejectedValue(new Error("No such command 'edit-note'"))
     ;(client as any).writeNote = jest.fn()
 
-    await client.indexConversation("user message long enough", "assistant reply long enough")
+    await client.indexConversation(
+      "user message long enough",
+      "assistant reply long enough",
+    )
 
     expect((client as any).writeNote).not.toHaveBeenCalled()
   })
@@ -252,7 +286,10 @@ describe("BmClient behavior", () => {
       file_path: "conversations/x.md",
     })
 
-    await client.indexConversation("user message long enough", "assistant reply long enough")
+    await client.indexConversation(
+      "user message long enough",
+      "assistant reply long enough",
+    )
 
     expect((client as any).writeNote).toHaveBeenCalledTimes(1)
     const [title, content, folder] = (client as any).writeNote.mock.calls[0]

bm-client.ts

@@ -69,6 +69,15 @@ export interface RecentResult {
   created_at: string
 }
 
+export interface ProjectListResult {
+  name: string
+  path: string
+  display_name?: string | null
+  is_private?: boolean
+  is_default?: boolean
+  isDefault?: boolean
+}
+
 /**
  * Extract JSON from CLI output that may contain non-JSON prefix lines
  * (warnings, log messages, etc). Finds the first line starting with
@@ -219,6 +228,27 @@ export class BmClient {
     }
   }
 
+  async listProjects(): Promise<ProjectListResult[]> {
+    const out = await this.execRaw(["project", "list", "--format", "json"])
+    const parsed = parseJsonOutput(out)
+
+    if (Array.isArray(parsed)) {
+      return parsed as ProjectListResult[]
+    }
+
+    if (parsed && typeof parsed === "object") {
+      const asRecord = parsed as Record<string, unknown>
+      if (Array.isArray(asRecord.projects)) {
+        return asRecord.projects as ProjectListResult[]
+      }
+      if (Array.isArray(asRecord.items)) {
+        return asRecord.items as ProjectListResult[]
+      }
+    }
+
+    throw new Error("invalid bm project list response")
+  }
+
   async search(query: string, limit = 10): Promise<SearchResult[]> {
     // search-notes outputs JSON natively (no --format flag needed)
     // Try hybrid search (FTS + vector) first, fall back to FTS if semantic is disabled
@@ -268,7 +298,11 @@ export class BmClient {
         if (!isUnsupportedStripFrontmatterError(err)) {
           throw err
         }
-        const fallbackOut = await this.execTool(["tool", "read-note", identifier])
+        const fallbackOut = await this.execTool([
+          "tool",
+          "read-note",
+          identifier,
+        ])
         const fallbackResult = parseJsonOutput(fallbackOut) as NoteResult
         fallbackResult.content = stripFrontmatter(fallbackResult.content)
         return fallbackResult
@@ -349,7 +383,10 @@ export class BmClient {
     }
 
     if (options.expected_replacements !== undefined) {
-      args.push("--expected-replacements", String(options.expected_replacements))
+      args.push(
+        "--expected-replacements",
+        String(options.expected_replacements),
+      )
     }
 
     try {
@@ -419,7 +456,11 @@ export class BmClient {
     const oldPath = resolve(projectPath, existing.file_path)
 
     // Write to new folder (this creates the note at the new location)
-    const result = await this.writeNote(existing.title, existing.content, newFolder)
+    const result = await this.writeNote(
+      existing.title,
+      existing.content,
+      newFolder,
+    )
 
     // Delete old file
     try {

commands/cli.ts

@@ -79,7 +79,11 @@ export function registerCli(
           async (
             identifier: string,
             opts: {
-              operation: "append" | "prepend" | "find_replace" | "replace_section"
+              operation:
+                | "append"
+                | "prepend"
+                | "find_replace"
+                | "replace_section"
               content: string
               findText?: string
               section?: string

config.test.ts

@@ -103,9 +103,9 @@ describe("config", () => {
     })
 
     it("should throw error for unknown config keys", () => {
-      expect(() =>
-        parseConfig({ unknownKey: "value" }),
-      ).toThrow("basic-memory config has unknown keys: unknownKey")
+      expect(() => parseConfig({ unknownKey: "value" })).toThrow(
+        "basic-memory config has unknown keys: unknownKey",
+      )
     })
 
     it("should handle complete config object", () => {