@stag-build/phonebook 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stag.build
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,283 @@
+<div align="center">
+
+# @stag-build/phonebook
+
+<p>A self-hosted, open-source alternative to Emerge Tools Snapshots: harvest your existing Compose <code>@Preview</code>s and SwiftUI <code>#Preview</code>s into a browsable, static HTML gallery — no SaaS account required.</p>
+
+![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)
+
+</div>
+
+Phonebook turns screenshots your team already has into a Storybook-style component gallery. No new test code, no design tokens to maintain by hand — it renders what's already in your codebase into a static site designers can open without installing anything. Each repo runs Phonebook independently; v1 is single-platform, so one Android repo (or one iOS repo) produces one bundle and one site.
+
+## Features
+
+- **Zero new test code** — reuses `@Preview` / `#Preview` you've already written
+- **No SaaS account** — self-hosted, runs entirely in your CI or locally
+- **MCP-first** — a coding agent can check setup, analyze coverage, add missing previews, and build the gallery for you
+- **Smart component grouping** — `component / state` cards inferred from preview names, no required annotation
+- **Cross-platform** — Android (Roborazzi + ComposablePreviewScanner, runs on the JVM, no emulator) and iOS (SnapshotPreviews, runs on a simulator)
+- **Version-aware setup** — `init`/`doctor` resolve library versions against your project's Kotlin version and catch Kotlin/Roborazzi metadata mismatches before they cause opaque compiler crashes
+
+## Demo
+
+![Phonebook gallery screenshot](docs/demo.png)
+
+*(replace with an actual screenshot of a generated gallery)*
+
+## How it works
+
+1. `phonebook generate` runs your platform's preview-rendering engine and harvests the output into a **bundle** (`manifest.json` + `images/`).
+   - Android: [Roborazzi](https://github.com/takahirom/roborazzi) + [ComposablePreviewScanner](https://github.com/sergio-sastre/ComposablePreviewScanner), run on the JVM via Robolectric. No emulator, works on Linux CI.
+   - iOS: [SnapshotPreviews](https://github.com/getsentry/SnapshotPreviews), run via `xcodebuild test` on a simulator. Requires macOS.
+2. `phonebook build` turns that bundle into a static site — by default it writes `index.html` directly into the bundle directory (reusing the images already there, no copying), so the site lands at `<bundle>/index.html`. Pass `-o <dir>` to instead copy everything into a standalone site directory (for publishing elsewhere, or later merging multiple bundles). Plain HTML/CSS/JS, works from `file://` or any static host.
+
+Install with `npm install -g @stag-build/phonebook`, or run without installing via `npx @stag-build/phonebook <cmd>`.
+
+## Using it with a coding agent (recommended)
+
+Most people won't run the CLI directly — Phonebook is built to be driven by a coding agent (Claude Code, Codex, etc.) through its MCP server. The agent adds previews, runs setup checks, and generates the gallery for you; the CLI underneath is the engine it calls.
+
+The server runs via `npx @stag-build/phonebook mcp` — no install step needed. Pick your client below.
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```sh
+claude mcp add phonebook -- npx -y @stag-build/phonebook mcp
+```
+
+</details>
+
+<details>
+<summary><strong>Codex CLI</strong></summary>
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.phonebook]
+command = "npx"
+args = ["-y", "@stag-build/phonebook", "mcp"]
+```
+
+</details>
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "phonebook": {
+      "command": "npx",
+      "args": ["-y", "@stag-build/phonebook", "mcp"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to `.cursor/mcp.json` (project) or `~/.cursor/mcp.json` (global):
+
+```json
+{
+  "mcpServers": {
+    "phonebook": {
+      "command": "npx",
+      "args": ["-y", "@stag-build/phonebook", "mcp"]
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary><strong>Xcode (Codex Agent)</strong> — Xcode 26.3+</summary>
+
+Add to `.codex/config.toml` at your project's workspace root. Xcode's agent runs with a minimal `PATH`, so the command wraps `npx` in a shell that adds the usual Homebrew/nvm locations first:
+
+```toml
+[mcp_servers.phonebook]
+command = "/bin/zsh"
+args = [
+  "-lc",
+  "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; npx -y @stag-build/phonebook mcp"
+]
+enabled = true
+```
+
+</details>
+
+<details>
+<summary><strong>Xcode (Claude Code Agent)</strong> — Xcode 26.3+</summary>
+
+Add the `mcpServers` block to `~/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "phonebook": {
+      "command": "/bin/zsh",
+      "args": [
+        "-lc",
+        "PATH=/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin; npx -y @stag-build/phonebook mcp"
+      ]
+    }
+  }
+}
+```
+
+</details>
+
+**Android Studio (Gemini Agent Mode):** not supported yet — its MCP integration only connects to remote `httpUrl` servers, not local stdio processes like Phonebook's. Use one of the terminal-based clients above (Claude Code, Codex CLI) from the Android repo instead.
+
+Then, from a chat in your Android or iOS repo, just ask:
+
+> "Use the phonebook MCP and create a catalog for my designer."
+
+The agent figures out the rest — checking setup, filling in missing previews, generating, and building the site. For more targeted asks, it also exposes: `check_setup` (setup diagnosis, same as `phonebook doctor`), `analyze_coverage` (components missing previews or dark variants), `get_preview_guidance`, `run_generate`, and `run_build`.
+
+## Quickstart: Android
+
+Run `phonebook init` first — it detects your project's Kotlin version and prints these instructions with **library versions resolved to be compatible with it** (e.g. Kotlin 2.0 projects get Roborazzi 1.60.0; Kotlin 2.2+ gets the latest). The versions below are what a current-Kotlin project gets (see `samples/android/app/build.gradle.kts` for a full working example):
+
+```kotlin
+// app/build.gradle.kts
+plugins {
+    id("io.github.takahirom.roborazzi") // root build.gradle.kts: version "1.72.0" apply false
+}
+
+roborazzi {
+    generateComposePreviewRobolectricTests {
+        enable = true
+        packages = listOf("dev.stag.phonebook.sample") // your app's package
+    }
+}
+
+dependencies {
+    testImplementation("org.robolectric:robolectric:4.14.1")
+    testImplementation("io.github.takahirom.roborazzi:roborazzi:1.72.0")
+    testImplementation("io.github.takahirom.roborazzi:roborazzi-compose:1.72.0")
+    testImplementation("io.github.sergio-sastre.ComposablePreviewScanner:android:0.9.3")
+    testImplementation("io.github.takahirom.roborazzi:roborazzi-compose-preview-scanner-support:1.72.0")
+    testImplementation("androidx.compose.ui:ui-test-junit4") // version from your Compose BOM, or pin one
+}
+```
+
+Add a `phonebook.config.json` next to `settings.gradle.kts`:
+
+```json
+{
+  "appName": "My Android App",
+  "platform": "android",
+  "android": { "modules": [":app"], "variant": "debug" }
+}
+```
+
+Then, from the repo containing Phonebook:
+
+```sh
+npx @stag-build/phonebook generate -C /path/to/your/android/repo
+npx @stag-build/phonebook build -C /path/to/your/android/repo
+```
+
+Open `phonebook-out/index.html`.
+
+## Quickstart: iOS
+
+Add the [SnapshotPreviews](https://github.com/getsentry/SnapshotPreviews) SPM package to your project and a small XCTest target that subclasses `SnapshotTest` (see `samples/ios` for a full working example):
+
+```swift
+// PhonebookSnapshotTests.swift
+import SnapshottingTests
+
+final class PhonebookSnapshotTests: SnapshotTest {
+    override class func snapshotPreviews() -> [String]? {
+        return nil // record every #Preview
+    }
+}
+```
+
+Add `phonebook.config.json` next to your `.xcodeproj`:
+
+```json
+{
+  "appName": "My iOS App",
+  "platform": "ios",
+  "ios": {
+    "project": "MyApp.xcodeproj",
+    "scheme": "MyApp",
+    "simulator": "iPhone 17 Pro"
+  }
+}
+```
+
+Your scheme must build and test the snapshot test target (see `PhonebookSample.xcscheme` in the sample). Then:
+
+```sh
+npx @stag-build/phonebook generate -C /path/to/your/ios/repo
+npx @stag-build/phonebook build -C /path/to/your/ios/repo
+```
+
+Open `phonebook-out/index.html`.
+
+## Naming convention
+
+Phonebook groups screenshots into `component / state` cards from your existing preview names — no required annotation. See [docs/naming-convention.md](docs/naming-convention.md) for the full rules and examples.
+
+## Configuration
+
+`phonebook.config.json`:
+
+| Key | Type | Default | Notes |
+| --- | --- | --- | --- |
+| `appName` | string | — | Required. Shown in the gallery header. |
+| `platform` | `"android"` \| `"ios"` | — | Required. |
+| `output` | string | `"phonebook-out"` | Bundle output directory, relative to the config file. |
+| `android.modules` | string[] | `[":app"]` | Gradle modules to record. |
+| `android.variant` | string | `"debug"` | Build variant; Phonebook runs `<module>:recordRoborazzi<Variant>`. |
+| `ios.project` | string | — | Path to `.xcodeproj`, relative to the config file. One of `project`/`workspace` required. |
+| `ios.workspace` | string | — | Path to `.xcworkspace`, relative to the config file. |
+| `ios.scheme` | string | — | Required. Scheme that includes the SnapshotPreviews test target. |
+| `ios.simulator` | string | `"iPhone 17 Pro"` | Simulator device name used for `-destination`. |
+| `ios.onlyTesting` | string | auto-detected | `-only-testing:` filter so `generate` runs just the snapshot class, not the app's whole test suite. Auto-derived from the `SnapshotTest` subclass; set `""` to run everything. |
+
+Both `generate` and `build` accept `-C <dir>` (project directory containing `phonebook.config.json`). `generate` takes `-o <dir>` to override the bundle output and `--allow-empty` to tolerate a run that records no previews. `build` takes an optional bundle path — with none, it uses the project's bundle directory — and `-o <dir>` for the site output; without `-o`, `build` writes `index.html` straight into the bundle directory and reuses its `images/` in place (no copying), which is what the quickstarts above do. Pass `-o <dir>` to instead copy the bundle's images into a separate, standalone site directory.
+
+## `phonebook init` and `phonebook doctor`
+
+`phonebook init` detects your platform and scaffolds `phonebook.config.json` plus the dependency/setup snippets — with library versions resolved against your project's Kotlin version and your app package filled in. It never edits your build files for you.
+
+`phonebook doctor` checks that everything `generate` needs is wired up: plugin and test dependencies (resolved through Gradle version catalogs when you use them), the scanner's `packages` value, Kotlin/Roborazzi compatibility, and the toolchain (JDK/Xcode/simulator). Add `--deep` to also compile the test sources — slower, but authoritative when a static check and reality disagree. On iOS, if SnapshotPreviews is linked but no `SnapshotTest` subclass exists yet, `doctor` names the exact target and folder to add it to (parsed from the `.pbxproj`), so you're never just told to "add the class" with no location.
+
+`phonebook init --write-snapshot-class` is the one exception to init's hands-off rule: when doctor's iOS check identifies the linking target *and* that target's source folder is one of Xcode's filesystem-synchronized groups, it writes `<folder>/PhonebookSnapshots.swift` directly — safe because a synchronized folder is picked up by Xcode automatically, so no `project.pbxproj` edit is made. It refuses (with the reason) in every other case: no SnapshotPreviews wiring yet, a non-synchronized-group project, or a subclass that already exists.
+
+`phonebook mcp` runs the MCP server — see "Using it with a coding agent" above for setup and example prompts.
+
+## Requirements
+
+**Android**: JDK 17+. No emulator needed — Roborazzi renders on the JVM via Robolectric, so `generate` runs on Linux CI.
+
+**iOS**: macOS with Xcode installed, plus a booted or bootable simulator (`generate` runs `xcodebuild test` against a named simulator destination). Requires a macOS runner in CI.
+
+See [docs/ci.md](docs/ci.md) for CI recipes and [docs/naming-convention.md](docs/naming-convention.md) for the naming rules.
+
+## Roadmap
+
+Post-v1 (M5), not yet built:
+
+- [ ] Search and filters in the generated gallery
+- [ ] Multi-bundle merge with a side-by-side view (cross-platform sites)
+- [ ] Version diffing between two runs (the manifest already carries commit + image hashes to enable this)
+- [ ] Additional CI recipe docs
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from './config.js';
+import { runDoctor } from './commands/doctor.js';
+import { runInit } from './commands/init.js';
+import { generateAndroid } from './engines/android.js';
+import { generateIos } from './engines/ios.js';
+import { buildSite } from './site/build.js';
+import { runMcpServer } from './mcp/server.js';
+const program = new Command();
+program
+    .name('phonebook')
+    .description('Static component gallery generated from native preview screenshots');
+program
+    .command('generate')
+    .description('Render all previews and produce a bundle (manifest + images)')
+    .option('-C, --dir <dir>', 'project directory containing phonebook.config.json', '.')
+    .option('-o, --output <dir>', 'bundle output directory (default from config, else phonebook-out)')
+    .option('--allow-empty', 'write an empty manifest (with a warning) instead of failing when no previews are recorded', false)
+    .action(async (opts) => {
+    const { config, projectDir } = await loadConfig(opts.dir);
+    const outputDir = resolve(projectDir, opts.output ?? config.output ?? 'phonebook-out');
+    const generate = config.platform === 'android' ? generateAndroid : generateIos;
+    const manifest = await generate(config, projectDir, outputDir, { allowEmpty: opts.allowEmpty });
+    console.log(`Recorded ${manifest.entries.length} previews -> ${outputDir}`);
+});
+program
+    .command('build')
+    .description('Build the static gallery site from a bundle')
+    .argument('[bundle]', 'bundle directory produced by `phonebook generate` (default: the output dir from phonebook.config.json)')
+    .option('-C, --dir <dir>', 'project directory containing phonebook.config.json', '.')
+    .option('-o, --output <dir>', 'site output directory (default: write index.html into the bundle directory itself, reusing its images/ with no copying)')
+    .action(async (bundle, opts) => {
+    let bundleDir;
+    if (bundle) {
+        bundleDir = resolve(bundle);
+    }
+    else {
+        const { config, projectDir } = await loadConfig(opts.dir);
+        bundleDir = resolve(projectDir, config.output ?? 'phonebook-out');
+        if (!existsSync(join(bundleDir, 'manifest.json'))) {
+            throw new Error(`No bundle found at ${bundleDir}. Run \`phonebook generate\` first, ` +
+                'or pass a bundle directory explicitly.');
+        }
+    }
+    const outDir = opts.output ? resolve(opts.output) : bundleDir;
+    const count = await buildSite(bundleDir, outDir);
+    console.log(`Built gallery with ${count} screenshots -> ${outDir}/index.html`);
+});
+program
+    .command('init')
+    .description('Detect the platform and scaffold phonebook.config.json')
+    .option('-C, --dir <dir>', 'project directory to initialize', '.')
+    .option('--write-snapshot-class', 'iOS only: write the missing SnapshotTest subclass, but only when the linking target uses Xcode ' +
+    "synchronized groups (so no project.pbxproj edit is needed) — the one exception to init's " +
+    'otherwise hands-off behavior', false)
+    .action(async (opts) => {
+    await runInit(opts.dir, { writeSnapshotClass: opts.writeSnapshotClass });
+});
+program
+    .command('doctor')
+    .description('Check that the project is correctly set up for `phonebook generate`')
+    .option('-C, --dir <dir>', 'project directory containing phonebook.config.json', '.')
+    .option('--deep', 'also compile the test sources (slower, catches build-time errors)', false)
+    .action(async (opts) => {
+    const ok = await runDoctor(opts.dir, { deep: opts.deep });
+    if (!ok)
+        process.exit(1);
+});
+program
+    .command('mcp')
+    .description('Run the Phonebook MCP server (stdio)')
+    .action(async () => {
+    await runMcpServer();
+});
+program.parseAsync().catch((err) => {
+    console.error(`error: ${err.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,33 @@
+import { findMissingTestHostNote, findSnapshotTestClassLocation, findSnapshotTestSubclass } from '../ios/snapshotTestClass.js';
+export { findMissingTestHostNote, findSnapshotTestClassLocation, findSnapshotTestSubclass };
+/** Parses the major version number out of `java -version`'s output (printed to stderr). */
+export declare function parseJavaMajorVersion(versionOutput: string): number | undefined;
+/** Parses the "Schemes:" section out of `xcodebuild -list` output. */
+export declare function parseXcodeSchemes(listOutput: string): string[];
+/** Parses device names out of `xcrun simctl list devices available` output. */
+export declare function parseAvailableSimulatorNames(simctlOutput: string): string[];
+/**
+ * Runs the same checks as `phonebook doctor` and returns the printed lines plus
+ * overall pass/fail, without writing to stdout. Shared by the CLI command and
+ * the MCP `check_setup` tool.
+ */
+export declare function collectDoctorChecks(dir: string, options?: {
+    deep?: boolean;
+}): Promise<{
+    lines: string[];
+    ok: boolean;
+}>;
+export declare function runDoctor(dir: string, options?: {
+    deep?: boolean;
+}): Promise<boolean>;
+/**
+ * Extracts the values configured in a `packages = listOf(...)` (Kotlin DSL)
+ * or `packages = ["a", "b"]` (Groovy) block. Returns undefined if no
+ * `packages = ...` assignment is present at all (as opposed to an empty list).
+ */
+export declare function extractConfiguredPackages(gradleText: string): string[] | undefined;
+/**
+ * Extracts compiler `e:` error lines from raw build output, dropping
+ * stack-frame continuation lines (indented, starting with "at ").
+ */
+export declare function extractCompilerErrors(output: string): string[];