convene-cli 1.0.3 → 1.0.5

package/dist/commands/init.js

@@ -34,13 +34,15 @@ function upsertMarkerBlock(content, block) {
     const sep = content.length === 0 ? '' : content.endsWith('\n') ? '\n' : '\n\n';
     return content + sep + block + '\n';
 }
-function writeIfChanged(file, content, backup = true) {
+// Every file this writes lives inside the git repo, so git history IS the backup —
+// dropping a sibling `.bak` just litters the working tree (and shows up as untracked
+// noise / risks being committed). The only `.bak` we keep is for the user's GLOBAL
+// ~/.claude/settings.json, which is outside any repo (see registerHook).
+function writeIfChanged(file, content) {
     const exists = node_fs_1.default.existsSync(file);
     const old = exists ? node_fs_1.default.readFileSync(file, 'utf8') : null;
     if (old === content)
         return 'unchanged';
-    if (exists && backup)
-        node_fs_1.default.writeFileSync(file + '.bak', old);
     node_fs_1.default.writeFileSync(file, content);
     return exists ? 'updated' : 'created';
 }
@@ -81,8 +83,7 @@ function ensureGitignoreGuard(top) {
         next = next + sep + guard;
     }
     if (next !== old) {
-        if (node_fs_1.default.existsSync(file))
-            node_fs_1.default.writeFileSync(file + '.bak', old);
+        // .gitignore is git-tracked — no .bak (git history is the backup).
         node_fs_1.default.writeFileSync(file, next);
     }
     // Belt-and-suspenders: confirm the join-token-bearing file is actually trackable.
@@ -174,6 +175,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 +246,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)
@@ -321,6 +383,14 @@ async function init(opts) {
     // 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/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.3",
+  "version": "1.0.5",
   "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",