feat(cli): add @pleaseai/code-style CLI package

Ship a ultracite-style setup CLI that wires PleaseAI's shared code style
into any project with one command (bunx @pleaseai/code-style). Inspired
by @naverpay/code-style-cli and Hayden Bleasel's ultracite.

What it does:
- Auto-detects the user's package manager (bun → pnpm → yarn → npm)
- Presents a @clack/prompts checkbox UI of PleaseAI style tools,
  marking already-installed ones
- Installs the selected packages as devDependencies
- Writes eslint.config.mjs, sets package.json#prettier, copies .editorconfig
- Manages an idempotent marker block in AGENTS.md so AI coding assistants
  see PleaseAI style rules without being trapped by a full file rewrite

Subcommands:
- init (default): interactive setup
- update:         refresh only the AGENTS.md rules block
- doctor:         report current project config status

Extras:
- ko/en i18n with LC_ALL/LANG detection and --lang override
- --yes/-y non-interactive mode for CI
- rules.md shipped in the tarball as the canonical style reference
- 35 unit tests covering PM detection, marker-block idempotency,
  package.json I/O and locale handling
- Registered with release-please so the CLI versions independently

The bin is exposed under both `pleaseai-code-style` and `please-style`.

Author: amondnet

.release-please-manifest.json

@@ -1,4 +1,5 @@
 {
   "packages/eslint-config": "0.0.3",
-  "packages/perttier-config": "0.0.1"
+  "packages/perttier-config": "0.0.1",
+  "packages/cli": "0.0.1"
 }

bun.lock

@@ -0,0 +1,75 @@
+# @pleaseai/code-style
+
+CLI that wires PleaseAI's shared code style into any project — installs the
+eslint/prettier/editorconfig packages and manages the `AGENTS.md` rules block
+so AI coding assistants know how to write code that passes lint on the first
+try.
+
+Inspired by [ultracite](https://github.com/haydenbleasel/ultracite) and
+NaverPay's [`@naverpay/code-style-cli`](https://github.com/NaverPayDev/code-style).
+
+## Usage
+
+From the root of any project that has a `package.json`:
+
+```bash
+bunx @pleaseai/code-style         # same as `init`
+bunx @pleaseai/code-style init    # interactive setup
+bunx @pleaseai/code-style update  # re-apply the AGENTS.md rules block only
+bunx @pleaseai/code-style doctor  # check current project status
+```
+
+Also works with `npx`, `pnpm dlx`, and `yarn dlx`.
+
+## What it does
+
+The `init` command:
+
+1. Detects your package manager (bun → pnpm → yarn → npm, based on lockfile).
+2. Shows a checkbox UI listing PleaseAI code-style tools; already-installed
+   ones are labelled `(installed)` / `(설치됨)`.
+3. Installs the packages you selected as dev dependencies.
+4. Writes / updates the corresponding config files.
+
+### Supported tools
+
+| Tool | npm package(s) | Config file |
+| --- | --- | --- |
+| eslint-config | `@pleaseai/eslint-config`, `eslint` | `eslint.config.mjs` |
+| prettier-config | `@pleaseai/prettier-config`, `prettier` | `package.json#prettier` |
+| editorconfig | `@pleaseai/editorconfig` | `.editorconfig` (copied from `node_modules`) |
+| agents-md | — | `AGENTS.md` (marker-managed block) |
+
+## `AGENTS.md` block
+
+The CLI owns only the content between these markers — everything else in
+`AGENTS.md` is your content and is preserved verbatim:
+
+```md
+<!-- pleaseai-code-style:start -->
+...managed content...
+<!-- pleaseai-code-style:end -->
+```
+
+Re-run `pleaseai-code-style update` any time you upgrade `@pleaseai/code-style`
+to refresh just this block. The full rules list is shipped as
+`node_modules/@pleaseai/code-style/rules.md` for reference.
+
+## Options
+
+| Flag | Description |
+| --- | --- |
+| `--yes`, `-y` | Accept defaults, overwrite existing files without prompting |
+| `--lang <ko\|en>` | Force the CLI locale (defaults to `$LANG`) |
+| `--help`, `-h` | Print help |
+| `--version`, `-v` | Print version |
+
+## Localisation
+
+The CLI auto-detects your locale from `LC_ALL` / `LANG` / `LC_MESSAGES` and
+currently ships Korean and English messages. Override with `--lang ko` or
+`--lang en`.
+
+## License
+
+MIT

packages/cli/README.md

@@ -0,0 +1,55 @@
+{
+  "name": "@pleaseai/code-style",
+  "type": "module",
+  "version": "0.0.1",
+  "description": "CLI to set up PleaseAI code style (eslint, prettier, editorconfig, AGENTS.md) in any project",
+  "author": "PleaseAI",
+  "license": "MIT",
+  "homepage": "https://github.com/pleaseai/code-style#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pleaseai/code-style.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "cli",
+    "code-style",
+    "eslint",
+    "prettier",
+    "editorconfig",
+    "agents",
+    "pleaseai"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "bin": {
+    "pleaseai-code-style": "./dist/index.mjs",
+    "please-style": "./dist/index.mjs"
+  },
+  "files": [
+    "dist",
+    "rules.md"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.12",
+    "@types/node": "^22.10.0",
+    "tsdown": "^0.21.5",
+    "typescript": "^6.0.2"
+  }
+}

packages/cli/package.json

@@ -0,0 +1,68 @@
+# PleaseAI Code Style Rules
+
+Canonical rules for `@pleaseai/code-style`. The `@pleaseai/eslint-config` package
+(based on `@antfu/eslint-config`) is the single source of truth — this document
+summarises the parts that an AI coding assistant needs to know _before_ writing
+code, so generated output passes lint on the first try.
+
+## Formatting
+
+- **No semicolons** at the end of statements.
+- **Single quotes** for strings; template literals are fine when interpolating.
+- **2-space indentation**, never tabs.
+- **Trailing commas** in multi-line arrays, objects, and parameter lists.
+- **LF** line endings.
+- Soft line length ~100, hard limit 120.
+
+## Modules
+
+- **ESM only** (`"type": "module"`). Never emit `require`/`module.exports`.
+- Use `import` / `export` statements.
+- Source extensions: `.ts`, `.tsx`, `.mjs`, `.mts`.
+- Import ordering (auto-fixable): node builtins → external → internal aliases →
+  parent → sibling → index, with a blank line between groups and alphabetised
+  within each group.
+- Prefer **named exports**. Reserve default exports for framework-required
+  entry points (e.g. a Next.js page, a Vite plugin).
+
+## TypeScript
+
+- `target: ES2022`, `moduleResolution: bundler`.
+- `strict: true` — no implicit `any`, no unchecked indexed access hacks.
+- Prefer `type` aliases over `interface` unless `extends`/declaration merging
+  is actually needed.
+- Use `const` by default; `let` only when reassignment is required; never `var`.
+- Avoid `any`; use `unknown` and narrow, or define a precise type.
+- Add explicit return types on exported functions and public class methods.
+- No unused imports or variables (auto-removed by `eslint --fix`).
+
+## Code Quality
+
+- Prefer **early returns** over deeply nested conditionals.
+- Use **optional chaining** (`?.`) and **nullish coalescing** (`??`).
+- Prefer `async`/`await` over raw `.then()` chains.
+- No `console.log` in production code paths — use a logger or remove before
+  commit. `console.warn`/`console.error` are acceptable for CLI tooling.
+- Throw `Error` instances (or subclasses), never bare strings or objects.
+
+## File Organisation
+
+- One primary export per file when practical.
+- Target file size ≤ 500 lines; split when a file grows past that.
+- Colocate tests as `*.test.ts` next to the source they cover.
+- Avoid barrel re-exports (`index.ts` that just re-exports everything) for
+  internal modules — they defeat tree-shaking.
+
+## JSON & `package.json`
+
+- `package.json` keys are sorted by `eslint-plugin-package-json`.
+- Declare `engines.node` (>= 22 for PleaseAI projects).
+- Libraries must ship an explicit `exports` map; no bare `main`-only fields.
+- `"type": "module"` is required.
+
+## Commit Messages
+
+- Conventional Commits: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`,
+  `chore:`, `build:`, `ci:`, `perf:`, `style:`, `revert:`.
+- Subject ≤ 72 chars, imperative mood, no trailing period.
+- Body explains **why**, not **what** — the diff already shows the what.

packages/cli/rules.md

@@ -0,0 +1,184 @@
+import type { Tool, ToolApplyResult, ToolContext } from './tools.js'
+import { copyFileSync, existsSync, writeFileSync } from 'node:fs'
+import { resolve as joinPath } from 'node:path'
+import { confirm, isCancel } from '@clack/prompts'
+import {
+  readFileOrNull,
+  readPackageJson,
+  upsertMarkerBlock,
+  writePackageJson,
+} from './fs-utils.js'
+import { t } from './i18n.js'
+
+async function confirmOverwrite(file: string, auto: boolean): Promise<boolean> {
+  if (auto) {
+    return true
+  }
+  const answer = await confirm({
+    message: t('overwritePrompt')(file),
+    initialValue: false,
+  })
+  if (isCancel(answer)) {
+    return false
+  }
+  return answer === true
+}
+
+// --- eslint-config ----------------------------------------------------------
+
+const ESLINT_CONFIG_TEMPLATE = `import pleaseai from '@pleaseai/eslint-config'
+
+export default pleaseai()
+`
+
+async function applyEslintConfig(ctx: ToolContext): Promise<ToolApplyResult> {
+  const result: ToolApplyResult = { created: [], updated: [], skipped: [] }
+  const target = joinPath(ctx.cwd, 'eslint.config.mjs')
+  const label = 'eslint.config.mjs'
+
+  if (existsSync(target)) {
+    const ok = await confirmOverwrite(label, ctx.autoAccept)
+    if (!ok) {
+      result.skipped.push(label)
+      return result
+    }
+    writeFileSync(target, ESLINT_CONFIG_TEMPLATE)
+    result.updated.push(label)
+    return result
+  }
+
+  writeFileSync(target, ESLINT_CONFIG_TEMPLATE)
+  result.created.push(label)
+  return result
+}
+
+// --- prettier-config --------------------------------------------------------
+
+async function applyPrettierConfig(ctx: ToolContext): Promise<ToolApplyResult> {
+  const result: ToolApplyResult = { created: [], updated: [], skipped: [] }
+  const pkg = readPackageJson(ctx.cwd)
+  const label = 'package.json#prettier'
+
+  if (pkg.prettier === '@pleaseai/prettier-config') {
+    // Already configured — nothing to do.
+    return result
+  }
+
+  if (pkg.prettier != null) {
+    const ok = await confirmOverwrite(label, ctx.autoAccept)
+    if (!ok) {
+      result.skipped.push(label)
+      return result
+    }
+  }
+
+  pkg.prettier = '@pleaseai/prettier-config'
+  writePackageJson(pkg, ctx.cwd)
+  result.updated.push(label)
+  return result
+}
+
+// --- editorconfig -----------------------------------------------------------
+
+async function applyEditorConfig(ctx: ToolContext): Promise<ToolApplyResult> {
+  const result: ToolApplyResult = { created: [], updated: [], skipped: [] }
+  const target = joinPath(ctx.cwd, '.editorconfig')
+  const source = joinPath(ctx.cwd, 'node_modules', '@pleaseai', 'editorconfig', '.editorconfig')
+  const label = '.editorconfig'
+
+  if (!existsSync(source)) {
+    // Package not installed yet (e.g. install step failed). Skip silently.
+    result.skipped.push(label)
+    return result
+  }
+
+  if (existsSync(target)) {
+    const ok = await confirmOverwrite(label, ctx.autoAccept)
+    if (!ok) {
+      result.skipped.push(label)
+      return result
+    }
+    copyFileSync(source, target)
+    result.updated.push(label)
+    return result
+  }
+
+  copyFileSync(source, target)
+  result.created.push(label)
+  return result
+}
+
+// --- AGENTS.md --------------------------------------------------------------
+
+const AGENTS_BODY = `# PleaseAI Code Style
+
+These rules are managed by \`@pleaseai/code-style\`. Run \`pleaseai-code-style update\`
+to refresh this block. Do not edit between the marker comments — your changes
+will be overwritten.
+
+- Formatter: \`@pleaseai/eslint-config\` (wraps \`@antfu/eslint-config\`)
+- No semicolons, single quotes, 2-space indent, trailing commas, LF line endings
+- ESM only — never emit \`require\`/\`module.exports\`
+- TypeScript: \`strict: true\`, prefer \`type\` over \`interface\`, no implicit \`any\`
+- Prefer named exports, early returns, \`async\`/\`await\`, optional chaining
+- File size target: ≤ 500 lines; colocate \`*.test.ts\` with the source
+- Conventional Commits for all commit messages
+
+For the full rules (what an AI coding assistant needs to know before writing code),
+read \`node_modules/@pleaseai/code-style/rules.md\`.`
+
+export async function applyAgentsMd(ctx: ToolContext): Promise<ToolApplyResult> {
+  const result: ToolApplyResult = { created: [], updated: [], skipped: [] }
+  const target = joinPath(ctx.cwd, 'AGENTS.md')
+  const label = 'AGENTS.md'
+  const existing = readFileOrNull(target)
+  const next = upsertMarkerBlock(existing, AGENTS_BODY)
+
+  if (existing == null) {
+    writeFileSync(target, next)
+    result.created.push(label)
+    return result
+  }
+
+  if (existing === next) {
+    // No-op — already up to date.
+    return result
+  }
+
+  writeFileSync(target, next)
+  result.updated.push(label)
+  return result
+}
+
+// --- Registry ---------------------------------------------------------------
+
+export const TOOLS: Tool[] = [
+  {
+    id: 'eslint-config',
+    label: '@pleaseai/eslint-config (eslint.config.mjs)',
+    packages: ['@pleaseai/eslint-config', 'eslint'],
+    apply: applyEslintConfig,
+  },
+  {
+    id: 'prettier-config',
+    label: '@pleaseai/prettier-config (package.json#prettier)',
+    packages: ['@pleaseai/prettier-config', 'prettier'],
+    apply: applyPrettierConfig,
+  },
+  {
+    id: 'editorconfig',
+    label: '@pleaseai/editorconfig (.editorconfig)',
+    packages: ['@pleaseai/editorconfig'],
+    apply: applyEditorConfig,
+  },
+  {
+    id: 'agents-md',
+    label: 'AGENTS.md (AI coding rules block)',
+    packages: [],
+    apply: applyAgentsMd,
+  },
+]
+
+export function findTool(id: string): Tool | undefined {
+  return TOOLS.find(t => t.id === id)
+}