easymd-cli 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easymd-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Google Docs for markdown — collaborate on the actual .md file in your repo, live with humans and AI agents. CLI: login, auto-sync, and open .md files for real-time editing.",
   "type": "module",
   "bin": {

package/src/cli/mcp.mjs

@@ -120,6 +120,34 @@ server.registerTool(
   },
 );
 
+server.registerTool(
+  'update_task_state',
+  {
+    title: 'Update task state',
+    description:
+      'Update the document\'s "Task State" block — the shared execution-handoff surface between humans and agents. Only the fields you pass change; the rest are preserved. Use this to keep the doc reflecting the current goal, decisions, open questions, failed approaches, the last command you validated (with its result), and the next concrete action. Updates appear live in the open editor.',
+    inputSchema: {
+      name: z.string().describe('Document name'),
+      goal: z.string().optional().describe('Current goal / what we are trying to achieve'),
+      decisions: z.string().optional().describe('Decisions made so far'),
+      openQuestions: z.string().optional().describe('Unresolved questions'),
+      failedApproaches: z.string().optional().describe('Approaches tried that did not work'),
+      lastValidated: z.string().optional().describe('Last command you ran to validate, and its result (e.g. "`npm test` → 18 passing, 2 failing")'),
+      nextAction: z.string().optional().describe('The next concrete action'),
+    },
+  },
+  async ({ name, ...fields }) => {
+    try {
+      const state = Object.fromEntries(Object.entries(fields).filter(([, v]) => v !== undefined && v !== ''));
+      if (!Object.keys(state).length) return fail('Provide at least one field to update.');
+      await api('/api/cli/documents', { method: 'POST', body: JSON.stringify({ name, op: 'task', state }) });
+      return ok(`Updated Task State for "${name}" (${Object.keys(state).join(', ')}).`);
+    } catch (e) {
+      return fail(e.message);
+    }
+  },
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);
 console.error(`easymd MCP ready → ${BASE} ${TOKEN ? '(authenticated)' : '(NOT logged in — run `easymd login`)'}`);

package/src/cli/sync.js

@@ -5,6 +5,22 @@ import { requireCredentials } from './config.js';
 
 const IGNORE_DIRS = new Set(['node_modules', '.git', 'dist', '.next', '.turbo', 'build', 'coverage']);
 
+// "Load-bearing" agent files excluded from auto-sync by default. The account's
+// `sync_special` setting (toggled in the dashboard) opts back in.
+const SPECIAL_MD = new Set(['claude.md', 'readme.md', 'agents.md']);
+const isSpecial = (filePath) => SPECIAL_MD.has(basename(filePath).toLowerCase());
+
+// Ask the server whether this account wants the special files included.
+async function syncSpecialEnabled(creds) {
+  try {
+    const res = await fetch(`${creds.url}/api/cli/settings`, { headers: { Authorization: `Bearer ${creds.token}` } });
+    if (res.ok) return Boolean((await res.json()).syncSpecial);
+  } catch {
+    /* default to excluding on error */
+  }
+  return false;
+}
+
 // Document name sent to the server: repo-relative path without the .md extension.
 // The server slugs it (e.g. "docs/spec" → "docs-spec") and namespaces it to the account.
 function docNameFor(filePath, root) {
@@ -50,7 +66,9 @@ async function collectMarkdown(dir, root, out = []) {
 // One-shot: push every .md under `root` to the account.
 export async function syncDir(root, { quiet = false } = {}) {
   const creds = await requireCredentials();
-  const files = await collectMarkdown(root, root);
+  const includeSpecial = await syncSpecialEnabled(creds);
+  let files = await collectMarkdown(root, root);
+  if (!includeSpecial) files = files.filter((f) => !isSpecial(f));
   if (!files.length) {
     if (!quiet) console.log('No .md files found.');
     return { ok: 0, fail: 0 };
@@ -74,10 +92,12 @@ export async function syncDir(root, { quiet = false } = {}) {
 // Long-running: watch `root` and push .md files as they're added/changed.
 export async function watchDir(root, { quiet = false } = {}) {
   const creds = await requireCredentials();
+  const includeSpecial = await syncSpecialEnabled(creds);
   const log = (...a) => !quiet && console.log(...a);
 
   const pending = new Map(); // path -> timer (debounce)
   const push = (filePath) => {
+    if (!includeSpecial && isSpecial(filePath)) return; // skip CLAUDE/README/AGENTS by default
     clearTimeout(pending.get(filePath));
     pending.set(
       filePath,