@seomi/ssh 0.1.1 → 0.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @seomi/ssh
 
-**English** | [Русский](./README.ru.md)
+**English** | [Русский](https://github.com/Mikeekb/seomi-ssh/blob/main/README.ru.md)
 
 > One command sets up passwordless SSH access for an AI agent to your servers.
 
@@ -102,7 +102,7 @@ $ seomi-ssh init
 
 | Guide | Description |
 |-------|-------------|
-| [`init` command](docs/init.md) | SSH setup behavior, `.claude/.env` configuration, examples, troubleshooting |
+| [`init` command](https://github.com/Mikeekb/seomi-ssh/blob/main/docs/init.md) | SSH setup behavior, `.claude/.env` configuration, examples, troubleshooting |
 
 ## License
 

package/README.ru.md

@@ -1,6 +1,6 @@
 # @seomi/ssh
 
-[English](./README.md) | **Русский**
+[English](https://github.com/Mikeekb/seomi-ssh/blob/main/README.md) | **Русский**
 
 > Одной командой настраивает беспарольный SSH-доступ для AI-агента к вашим серверам.
 
@@ -102,7 +102,7 @@ $ seomi-ssh init
 
 | Раздел | Описание |
 |--------|----------|
-| [Команда `init`](docs/init.md) | Поведение `init`, конфигурация `.claude/.env`, примеры, диагностика |
+| [Команда `init`](https://github.com/Mikeekb/seomi-ssh/blob/main/docs/init.md) | Поведение `init`, конфигурация `.claude/.env`, примеры, диагностика |
 
 ## Лицензия
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seomi/ssh",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "One-command CLI installer that sets up passwordless SSH access for AI agents in any project (dev/prod/custom servers) and writes the access map into AGENTS.md / CLAUDE.md.",
   "type": "module",
   "bin": {
@@ -34,6 +34,14 @@
     "deploy"
   ],
   "license": "SEE LICENSE IN LICENSE",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mikeekb/seomi-ssh.git"
+  },
+  "homepage": "https://github.com/Mikeekb/seomi-ssh#readme",
+  "bugs": {
+    "url": "https://github.com/Mikeekb/seomi-ssh/issues"
+  },
   "publishConfig": {
     "access": "public"
   },

package/src/commands/init.mjs

@@ -15,13 +15,14 @@
  */
 
 import { mkdir, copyFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { logger } from '../lib/logger.mjs';
 import { promptServers, toEnvUpdates } from '../lib/server-prompt.mjs';
 import { mergeEnv } from '../lib/env-writer.mjs';
 import { ensureSshKey } from '../lib/ssh-key-setup.mjs';
-import { detectAgentMdTargets } from '../lib/agent-md-target.mjs';
+import { detectAgentMdTargets, ensureClaudeImportStub, isClaudeImportStub } from '../lib/agent-md-target.mjs';
 import { renderAgentMdBlock } from '../lib/agent-md-renderer.mjs';
 import { insertOrUpdate } from '../lib/markers.mjs';
 
@@ -117,6 +118,10 @@ export async function initCommand( options = {} ) {
 	if ( dryRun ) {
 		const { targets } = await detectAgentMdTargets( { cwd, interactive: false } );
 		logger.info( `[dry-run] managed-блок был бы записан в: ${ targets.join( ', ' ) || '(none)' }` );
+		const wouldStub = targets.some( ( f ) => f.endsWith( 'AGENTS.md' ) ) && ! existsSync( join( cwd, 'CLAUDE.md' ) );
+		if ( wouldStub ) {
+			logger.info( '[dry-run] был бы создан CLAUDE.md с импортом @AGENTS.md (Claude Code не читает AGENTS.md)' );
+		}
 		process.stdout.write( '\n--- managed block preview ---\n' + block + '--- end preview ---\n' );
 	} else {
 		const { targets } = await detectAgentMdTargets( {
@@ -128,9 +133,26 @@ export async function initCommand( options = {} ) {
 			logger.warn( 'Целевой файл инструкций не выбран — managed-блок не записан.' );
 		}
 		for ( const file of targets ) {
+			const name = file.split( /[\\/]/ ).pop();
+			// CLAUDE.md, который лишь импортирует AGENTS.md, — это редирект, а не
+			// носитель блока: писать в него блок значит снова продублировать
+			// контент. Оставляем его чистым импортом `@AGENTS.md`.
+			if ( name === 'CLAUDE.md' && isClaudeImportStub( file ) ) {
+				logger.info( `${ name }: оставлен как импорт @AGENTS.md (блок живёт в AGENTS.md)` );
+				continue;
+			}
 			const res = await insertOrUpdate( file, block, { namespace: MARKER_NS } );
 			logger.success( `${ res.action }: ${ file }` );
 		}
+		// Claude Code не читает AGENTS.md — если блок лёг туда и CLAUDE.md нет,
+		// создаём однострочный CLAUDE.md с импортом, чтобы Claude Code видел те
+		// же инструкции (включая доступы по SSH).
+		if ( targets.length > 0 ) {
+			const stub = await ensureClaudeImportStub( { cwd } );
+			if ( stub.created ) {
+				logger.success( 'Создан CLAUDE.md (импорт @AGENTS.md) — Claude Code теперь читает AGENTS.md' );
+			}
+		}
 	}
 
 	// --- 6. Copy the access skill ----------------------------------------

package/src/lib/agent-md-target.mjs

@@ -1,11 +1,14 @@
 /**
  * Target-aware detection for AI agent instructions files (AGENTS.md / CLAUDE.md).
  *
- * Claude Code reads `CLAUDE.md` if present and IGNORES `AGENTS.md` next to it.
- * Other agents (e.g. ai-factory tooling) treat `AGENTS.md` as the universal
- * standard. This detector lets `init` / `update` / `doctor` keep the managed
- * `seomi-ssh` block in the file the project actually uses — and, when both
- * coexist, synchronize the block into both so no agent loses context.
+ * Claude Code reads `CLAUDE.md` and NEVER `AGENTS.md` — not even when no
+ * CLAUDE.md exists next to it (see https://code.claude.com/docs/en/memory →
+ * "AGENTS.md"). Other agents (Cursor, ai-factory tooling, etc.) treat
+ * `AGENTS.md` as the universal standard. To satisfy both without duplicating
+ * content, we keep the managed `seomi-ssh` block in `AGENTS.md` (the single
+ * source of truth) and drop a one-line `CLAUDE.md` that imports it via
+ * `@AGENTS.md` — so Claude Code reads the same instructions. See
+ * `ensureClaudeImportStub` below.
  *
  * Decision tree:
  *   1. Both files exist          → targets = [AGENTS.md, CLAUDE.md]      (source='both')
@@ -15,7 +18,8 @@
  *   5. Neither, interactive=true → select prompt → user / skipped        (source='user'|'skipped')
  */
 
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
+import { writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { logger } from './logger.mjs';
 
@@ -23,6 +27,19 @@ export const DEFAULT_TARGET = 'AGENTS.md';
 const AGENTS_FILE = 'AGENTS.md';
 const CLAUDE_FILE = 'CLAUDE.md';
 
+/**
+ * One-line `CLAUDE.md` that imports `AGENTS.md`. The HTML comment is stripped
+ * by Claude Code before the file enters context (it only documents the file for
+ * humans), so the effective payload is just the `@AGENTS.md` import directive.
+ */
+export const CLAUDE_IMPORT_STUB = `<!--
+  Managed by @seomi/ssh. Claude Code loads CLAUDE.md but never AGENTS.md,
+  so this stub imports AGENTS.md — the agent-agnostic source of truth — keeping
+  Claude Code and other agents on the same instructions. Edit AGENTS.md, not this.
+-->
+@AGENTS.md
+`;
+
 /**
  * Detect which agent-instructions file(s) the project uses and return absolute
  * paths to be updated with the managed `seomi-ssh` block.
@@ -105,3 +122,51 @@ export async function detectAgentMdTargets( { cwd, interactive = false, defaultN
 	logger.success( `[agent-md] targets: ${ targets.join( ', ' ) }` );
 	return { targets, source: 'user' };
 }
+
+/**
+ * Is `claudePath` a thin import stub (it imports AGENTS.md and carries no
+ * managed seomi-ssh block of its own)? Lets callers tell an intended
+ * `@AGENTS.md` redirect apart from a real duplicated block.
+ *
+ * @param {string} claudePath — absolute path to the candidate CLAUDE.md
+ * @returns {boolean}
+ */
+export function isClaudeImportStub( claudePath ) {
+	if ( ! existsSync( claudePath ) ) return false;
+	const text = readFileSync( claudePath, 'utf8' );
+	const importsAgents = /(^|\n)[ \t]*@AGENTS\.md[ \t]*(\r?\n|$)/.test( text );
+	const hasManagedBlock = /<!--\s*seomi-ssh:start\s*-->/.test( text );
+	return importsAgents && ! hasManagedBlock;
+}
+
+/**
+ * Ensure Claude Code can read the project's instructions when the managed block
+ * lives in `AGENTS.md`. Claude Code never reads `AGENTS.md`, so when only that
+ * file exists we drop a one-line `CLAUDE.md` that imports it (`@AGENTS.md`).
+ *
+ * Idempotent and non-destructive: does nothing when there is no `AGENTS.md`, or
+ * when a `CLAUDE.md` already exists (we never overwrite a user's CLAUDE.md).
+ *
+ * @param {object} opts
+ * @param {string} opts.cwd — project root
+ * @returns {Promise<{ created: boolean, reason: 'created'|'no-agents'|'claude-exists', path: string }>}
+ */
+export async function ensureClaudeImportStub( { cwd } = {} ) {
+	if ( ! cwd ) throw new Error( 'ensureClaudeImportStub: `cwd` is required' );
+
+	const agentsPath = join( cwd, AGENTS_FILE );
+	const claudePath = join( cwd, CLAUDE_FILE );
+
+	if ( ! existsSync( agentsPath ) ) {
+		logger.debug( '[agent-md] import stub skipped — no AGENTS.md to import' );
+		return { created: false, reason: 'no-agents', path: claudePath };
+	}
+	if ( existsSync( claudePath ) ) {
+		logger.debug( '[agent-md] import stub skipped — CLAUDE.md already exists' );
+		return { created: false, reason: 'claude-exists', path: claudePath };
+	}
+
+	await writeFile( claudePath, CLAUDE_IMPORT_STUB, 'utf8' );
+	logger.success( '[agent-md] created CLAUDE.md (@AGENTS.md import) so Claude Code reads AGENTS.md' );
+	return { created: true, reason: 'created', path: claudePath };
+}