mnotes-cli 1.10.0 → 1.11.0

package/dist/commands/connect/__tests__/connect.test.js

@@ -43,6 +43,21 @@ const config_utils_1 = require("../config-utils");
 const claude_code_1 = require("../../../templates/claude-code");
 const codex_1 = require("../../../templates/codex");
 const openclaw_1 = require("../../../templates/openclaw");
+// Mock createClient so resolveWorkspace can validate workspaces without a real server
+vitest_1.vi.mock("../../../client", () => ({
+    createClient: () => ({
+        listWorkspaces: async () => ({
+            data: [
+                { id: "ws-123", name: "Test", slug: "test-123", isDefault: true },
+                { id: "ws-explicit-id", name: "Explicit", slug: "explicit-id", isDefault: false },
+                { id: "ws-new", name: "New", slug: "new", isDefault: false },
+            ],
+        }),
+        createWorkspace: async (name) => ({
+            data: { id: name, name, slug: name, isDefault: false },
+        }),
+    }),
+}));
 // -- Helper: capture stdout --
 function captureStdout(fn) {
     const chunks = [];

package/dist/commands/connect/__tests__/wizard.test.js

@@ -41,6 +41,19 @@ const wizard_1 = require("../wizard");
 const hooks_1 = require("../../../templates/claude-code/hooks");
 const skills_1 = require("../../../templates/claude-code/skills");
 const agents_1 = require("../../../templates/claude-code/agents");
+// Mock createClient so resolveWorkspace can validate workspaces without a real server
+vitest_1.vi.mock("../../../client", () => ({
+    createClient: () => ({
+        listWorkspaces: async () => ({
+            data: [
+                { id: "ws-123", name: "Test", slug: "test-123", isDefault: true },
+            ],
+        }),
+        createWorkspace: async (name) => ({
+            data: { id: name, name, slug: name, isDefault: false },
+        }),
+    }),
+}));
 function makeTmpDir() {
     return fs.mkdtempSync(path.join(os.tmpdir(), "mnotes-wizard-test-"));
 }

package/dist/commands/connect/index.js

@@ -38,9 +38,11 @@ exports.handleClaudeCode = handleClaudeCode;
 exports.registerConnectCommand = registerConnectCommand;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
 const config_utils_1 = require("./config-utils");
 const workspace_prompt_1 = require("./workspace-prompt");
 const config_1 = require("../../config");
+const client_1 = require("../../client");
 const claude_code_1 = require("../../templates/claude-code");
 const codex_1 = require("../../templates/codex");
 const openclaw_1 = require("../../templates/openclaw");
@@ -90,13 +92,45 @@ function printConnectionStatus() {
 /**
  * Resolves the workspace ID — uses --workspace flag if provided, otherwise
  * prompts interactively after validating the connection.
+ *
+ * When a workspace value is provided (flag, env, or config), validates it
+ * against the API by matching on ID or slug. If not found, prompts to create.
  */
 async function resolveWorkspace(opts) {
     // Check flag, env, dir map, global config
     const fromConfig = (0, config_1.resolveConfig)({ workspaceId: opts.workspace });
-    if (fromConfig.workspaceId)
-        return fromConfig.workspaceId;
-    // Nothing stored — interactive selection/creation
+    const candidate = fromConfig.workspaceId;
+    if (candidate) {
+        // Validate the candidate against the API
+        const client = (0, client_1.createClient)(opts.url, opts.apiKey);
+        let workspaces;
+        try {
+            const res = await client.listWorkspaces();
+            workspaces = res.data;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to fetch workspaces: ${message}`);
+        }
+        // Match by ID or slug
+        const match = workspaces.find((ws) => ws.id === candidate || ws.slug === candidate);
+        if (match) {
+            return match.id;
+        }
+        // Not found — ask user to create
+        process.stderr.write(`\nWorkspace "${candidate}" not found.\n`);
+        const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+        const answer = await new Promise((resolve) => rl.question(`Create workspace "${candidate}"? [Y/n] `, resolve));
+        rl.close();
+        if (answer.trim() === "" || answer.trim().toLowerCase() === "y") {
+            const created = await client.createWorkspace(candidate);
+            process.stderr.write(`Created workspace "${created.data.name}" (${created.data.id})\n`);
+            return created.data.id;
+        }
+        // User declined — fall through to interactive
+        process.stderr.write("Falling back to interactive workspace selection.\n");
+    }
+    // Nothing stored or user declined — interactive selection/creation
     const resolved = await (0, workspace_prompt_1.resolveWorkspaceInteractively)(opts.url, opts.apiKey);
     return resolved.id;
 }

package/dist/templates/claude-code.js

@@ -27,6 +27,38 @@ function generateClaudeCodeTemplate(opts) {
 7. **READ schema before editing.** Before creating or updating notes, call \`search_notes\` for \`type:config\` notes. Follow their conventions. If none exist, offer to create a starter schema note.
 8. **EVERY note must link.** Outbound \`[[wikilinks]]\` are mandatory — an orphan note is invisible.
 
+## Non-Negotiable Checklist
+
+These are not suggestions. Skip any step and the wiki degrades.
+
+### Session Start (before ANY work)
+- [ ] Call \`project_context_load\` with workspaceId "${opts.workspaceId}"
+- [ ] Call \`recall_knowledge\` for the user's topic — past you already figured things out
+- [ ] Call \`search_notes\` for related wiki pages
+- [ ] If the graph is empty, call \`populate_graph\` (idempotent)
+- [ ] Read any \`type:config\` schema notes before editing the wiki
+
+Do not skip this. Do not say "I'll check later." Do not assume you know what's in the wiki.
+
+### During Work (every time you learn something)
+- [ ] Non-obvious discovery? → \`knowledge_store\` immediately, do not batch
+- [ ] User drops a URL/paste/file? → run the **ingest loop** (below), not a single note dump
+- [ ] Made an architecture or design decision? → store with key \`arch/{component}\`
+- [ ] Fixed a bug? → store with key \`bug/{id}\`, include root cause
+- [ ] Found a gotcha or footgun? → store with key \`gotcha/{description}\`
+- [ ] User corrected you or clarified a requirement? → store it
+
+### What NOT to Store
+- Trivial changes (typo fixes, formatting)
+- Information obvious from reading the code
+- Duplicates — call \`recall_knowledge\` first to check
+
+### Session End (before finishing)
+- [ ] Call \`session_log\` with summary, decisions made, and follow-up actions
+- [ ] If you did meaningful work and didn't store anything yet — you forgot. Go back and store it.
+
+If you think "this isn't worth saving" — save it anyway. Future you has no context.
+
 ## The Ingest Loop
 
 When the user supplies a source (URL, paste, file):

package/dist/templates/codex.js

@@ -18,6 +18,32 @@ You are the author and maintainer of a living wiki. Raw sources are immutable in
 - If the graph is empty, call \`populate_graph\` (idempotent).
 - Read any notes tagged \`type:config\` before editing.
 
+### Non-Negotiable Checklist
+
+These are not suggestions. Skip any step and the wiki degrades.
+
+**Session Start (before ANY work):**
+- [ ] \`project_context_load\` with workspaceId "${opts.workspaceId}"
+- [ ] \`recall_knowledge\` for the user's topic
+- [ ] \`search_notes\` for related pages
+- [ ] \`populate_graph\` if graph is empty
+- [ ] Read \`type:config\` schema notes before editing
+
+Do not skip this. Do not assume you know what's in the wiki.
+
+**During Work (every time you learn something):**
+- [ ] Non-obvious discovery → \`knowledge_store\` immediately
+- [ ] Architecture/design decision → \`arch/{component}\`
+- [ ] Bug fix → \`bug/{id}\` with root cause
+- [ ] Gotcha/footgun → \`gotcha/{description}\`
+- [ ] User correction → store it
+
+**What NOT to store:** trivial changes, info obvious from code, duplicates (check \`recall_knowledge\` first).
+
+**Session End:**
+- [ ] \`session_log\` with summary, decisions, follow-ups
+- [ ] If you did meaningful work and stored nothing — go back and store it
+
 ### During Work
 - Recall before researching: \`recall_knowledge\`, \`search_notes\`.
 - Store discoveries via \`knowledge_store\` (key: \`<category>/<name>\`, tags: [category]).

package/dist/templates/openclaw.js

@@ -10,6 +10,28 @@ function generateOpenClawTemplate(opts) {
 
 You are the author of a living wiki. Notes are interlinked with \`[[wikilinks]]\`. Sources are immutable; your writing is the wiki.
 
+## Non-Negotiable Checklist
+
+Skip any step and the wiki degrades.
+
+**Session Start (before ANY work):**
+- [ ] \`recall_knowledge\` for the user's topic
+- [ ] \`search_notes\` for related pages
+- [ ] \`populate_graph\` if graph is empty
+
+Do not skip this. Do not assume you know what's in the wiki.
+
+**During Work:**
+- [ ] Non-obvious discovery → \`knowledge_store\` immediately
+- [ ] Decision made → \`decision/{topic}\`
+- [ ] Bug fixed → \`bug/{id}\` with root cause
+- [ ] User correction → store it
+
+**What NOT to store:** trivial changes, info obvious from code, duplicates.
+
+**Session End:**
+- [ ] If you did meaningful work and stored nothing — go back and store it
+
 ## Core Loops
 
 **Ingest** — when given a source (URL/paste): find 3+ related notes via \`recall_knowledge\`, update or create, link them with \`[[wikilinks]]\`, tag each with \`source/<slug>\`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mnotes-cli",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "CLI for m-notes AI knowledge base — manage notes, search, and CRUD from the terminal",
   "bin": {
     "mnotes": "./dist/index.js"