convene-cli 1.0.2 → 1.0.4

package/dist/commands/init.js

@@ -174,6 +174,66 @@ function seedMemory(top, slug, baseUrl) {
         /* memory seed is best-effort */
     }
 }
+// ── Cross-agent rule files ───────────────────────────────────────────────────
+// AGENTS.md (written above) is the keystone — Codex, Windsurf, Cursor, and Cline
+// auto-read it. These add each agent's NATIVE rule file so they reliably pick
+// Convene up and call the `convene` CLI themselves. No per-prompt FRESH injection
+// outside Claude Code (and, later, Codex) — see CONVENE_PROTOCOL.md.
+function writeCursorRule(top, block) {
+    const file = node_path_1.default.join(top, '.cursor', 'rules', 'convene.mdc');
+    const frontmatter = '---\ndescription: Convene AI coordination bus — read channel context and post updates\nalwaysApply: true\n---\n\n';
+    const old = node_fs_1.default.existsSync(file) ? node_fs_1.default.readFileSync(file, 'utf8') : null;
+    const content = old !== null ? upsertMarkerBlock(old, block) : frontmatter + block + '\n';
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true });
+    const r = writeIfChanged(file, content);
+    log(`${r === 'unchanged' ? '·' : '✓'} .cursor/rules/convene.mdc (${r}) — Cursor auto-applies it every chat`);
+}
+function writeClineRule(top, block) {
+    const file = node_path_1.default.join(top, '.clinerules', 'convene.md');
+    const old = node_fs_1.default.existsSync(file) ? node_fs_1.default.readFileSync(file, 'utf8') : '';
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true });
+    const r = writeIfChanged(file, upsertMarkerBlock(old, block));
+    log(`${r === 'unchanged' ? '·' : '✓'} .clinerules/convene.md (${r}) — Cline workspace rule`);
+}
+function writeGeminiSettings(top) {
+    const file = node_path_1.default.join(top, '.gemini', 'settings.json');
+    let obj = {};
+    if (node_fs_1.default.existsSync(file)) {
+        try {
+            obj = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8')) || {};
+        }
+        catch {
+            log('· .gemini/settings.json (left as-is — unparseable JSON)');
+            return;
+        }
+    }
+    obj.context = obj.context && typeof obj.context === 'object' ? obj.context : {};
+    const cur = obj.context.fileName;
+    let names = Array.isArray(cur) ? cur : typeof cur === 'string' ? [cur] : [];
+    if (!names.includes('AGENTS.md'))
+        names = [...names, 'AGENTS.md'];
+    obj.context.fileName = names;
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true });
+    const r = writeIfChanged(file, JSON.stringify(obj, null, 2) + '\n');
+    log(`${r === 'unchanged' ? '·' : '✓'} .gemini/settings.json (${r}) — Gemini CLI reads AGENTS.md each prompt`);
+}
+function writeAiderConf(top) {
+    // No YAML parser bundled, so write-if-absent (don't risk clobbering an existing config).
+    const file = node_path_1.default.join(top, '.aider.conf.yml');
+    if (node_fs_1.default.existsSync(file)) {
+        log('· .aider.conf.yml (exists) — add `read: [AGENTS.md, CONVENE_PROTOCOL.md]` so Aider loads Convene');
+        return;
+    }
+    node_fs_1.default.writeFileSync(file, 'read:\n  - AGENTS.md\n  - CONVENE_PROTOCOL.md\n');
+    log('✓ .aider.conf.yml (created) — Aider loads the Convene instructions at startup');
+}
+function writeAgentRules(top, slug, member, baseUrl) {
+    const block = (0, protocol_1.conveneBlock)(slug, member, baseUrl);
+    writeCursorRule(top, block);
+    writeClineRule(top, block);
+    writeGeminiSettings(top);
+    writeAiderConf(top);
+}
 async function init(opts) {
     const top = (0, git_1.gitToplevel)();
     if (!top)
@@ -185,6 +245,7 @@ async function init(opts) {
     const skipHook = opts.noHook === true || opts.hook === false;
     const skipGithook = opts.noGithook === true || opts.githook === false;
     const skipJoinToken = opts.noJoinToken === true || opts.joinToken === false;
+    const skipAgentRules = opts.noAgentRules === true || opts.agentRules === false;
     let slug = opts.slug || existing?.slug;
     let displayName = opts.name || existing?.displayName;
     let joinToken = existing?.joinToken; // reuse if present (keeps init idempotent)
@@ -296,11 +357,39 @@ async function init(opts) {
     else {
         log('· CONVENE_PROTOCOL.md (exists — left as-is)');
     }
-    // 7. hook
+    // 7. hook (global, per-machine — fires in every repo, no-op outside convene repos)
     registerHook(skipHook);
+    // 7a. committed project hook — the repo CARRIES the same `convene fetch` hook in
+    //     .claude/settings.json, so a teammate who opens it auto-connects (Claude Code
+    //     applies project hooks after a one-time trust prompt; identical command de-dups
+    //     against the global hook, so no double-fire).
+    if (skipHook) {
+        log('Skipped committed project hook (--no-hook).');
+    }
+    else {
+        const r = (0, hook_1.ensureProjectHookRegistered)(top);
+        if (r === 'manual') {
+            log('· .claude/settings.json left as-is (existing settings unparseable).');
+        }
+        else {
+            log(`${r === 'registered' ? '✓' : '·'} .claude/settings.json (committed \`convene fetch\` hook — teammates auto-connect on open)`);
+            if ((0, git_1.gitPathIsIgnored)(top, node_path_1.default.join('.claude', 'settings.json'))) {
+                log('  ⚠ .claude/settings.json is git-ignored — commit it (or drop the .claude ignore) so teammates inherit the hook;');
+                log('    otherwise they connect via `convene setup`.');
+            }
+        }
+    }
     // 7b. committed git pre-push hook — the tool-agnostic backstop that auto-posts a
     //     [STATUS] when work is pushed (fires for Codex/Cowork/humans, not just Claude).
     installGitHookStep(top, skipGithook);
+    // 7c. Cross-agent rule files so Codex/Cursor/Cline/Gemini/Aider pick Convene up too
+    //     (AGENTS.md already covers the auto-readers; these add each agent's native file).
+    if (skipAgentRules) {
+        log('Skipped cross-agent rule files (--no-agent-rules).');
+    }
+    else {
+        writeAgentRules(top, slug, member, baseUrl);
+    }
     // 8. memory seed (best-effort, outside the repo)
     seedMemory(top, slug, baseUrl);
     // 9. teammate one-liner

package/dist/commands/join.js

@@ -62,6 +62,13 @@ async function join(opts) {
         : hook === 'already'
             ? 'Hook already registered.'
             : 'Could not auto-register the hook — run `convene doctor --fix` or add it manually.');
+    // Ensure the repo carries the committed `convene fetch` hook (.claude/settings.json)
+    // so the next teammate auto-connects on open. Idempotent; de-dups with the global hook.
+    if (top) {
+        const pr = (0, hook_1.ensureProjectHookRegistered)(top);
+        if (pr === 'registered')
+            log('Wrote committed project hook (.claude/settings.json) — commit it so teammates auto-connect.');
+    }
     // The tool-agnostic backstop: auto-post a [STATUS] when you push (works even
     // for tools without a per-prompt hook).
     if (top) {

package/dist/hook.js

@@ -10,6 +10,8 @@ exports.hookIsRegistered = hookIsRegistered;
 exports.withHook = withHook;
 exports.serializeSettings = serializeSettings;
 exports.ensureHookRegistered = ensureHookRegistered;
+exports.projectSettingsPath = projectSettingsPath;
+exports.ensureProjectHookRegistered = ensureProjectHookRegistered;
 /**
  * Claude Code UserPromptSubmit hook registration in ~/.claude/settings.json.
  *
@@ -81,3 +83,33 @@ function ensureHookRegistered() {
         return 'manual';
     }
 }
+/** The repo's COMMITTED, shared project settings file (vs settings.local.json, which is personal/gitignored). */
+function projectSettingsPath(toplevel) {
+    return node_path_1.default.join(toplevel, '.claude', 'settings.json');
+}
+/**
+ * Ensure the SAME `convene fetch` hook in the repo's committed `.claude/settings.json`,
+ * so a teammate who opens the repo gets it automatically (Claude Code applies
+ * project hooks after a one-time per-repo trust prompt). Identical to the global
+ * hook command, so Claude Code de-dups them — no double-fire if both are present.
+ * Idempotent + merge-safe: never clobbers other project settings.
+ */
+function ensureProjectHookRegistered(toplevel) {
+    const p = projectSettingsPath(toplevel);
+    const raw = readSettingsRaw(p);
+    const settings = parseSettings(raw);
+    if (settings === null)
+        return 'manual'; // unparseable — don't clobber
+    if (hookIsRegistered(settings))
+        return 'already';
+    try {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(p), { recursive: true });
+        if (raw !== null)
+            node_fs_1.default.writeFileSync(p + '.bak', raw);
+        node_fs_1.default.writeFileSync(p, serializeSettings(withHook(settings)));
+        return 'registered';
+    }
+    catch {
+        return 'manual';
+    }
+}

package/dist/index.js

@@ -124,6 +124,7 @@ program
     .option('--no-hook', 'do not register the UserPromptSubmit hook')
     .option('--no-githook', 'do not install the git pre-push auto-status hook')
     .option('--no-join-token', 'do not mint/commit a self-serve join token (use for public repos)')
+    .option('--no-agent-rules', 'do not write Cursor/Cline/Gemini/Aider rule files (Claude/Codex via AGENTS.md still work)')
     .option('--force', 'commit a join token even if the repo looks public (overrides the guard)')
     .option('--yes', 'non-interactive')
     .option('--offline', 'write local files only (no API calls)')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convene-cli",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Convene CLI — AI development coordination bus client + UserPromptSubmit hook. Install: npm i -g convene-cli; then `convene setup`.",
   "license": "MIT",
   "homepage": "https://dev.convene.live",