@remotedraw/cli 0.2.1 → 0.3.0

package/dist/locales/index.d.ts

@@ -15,7 +15,6 @@ export declare const LOCALES: {
         aliases: string[];
         catalog: {
             readonly "language.word": "Language";
-            readonly "language.prompt.helper": "Sets the language of the RemoteDraw CLI. Generated code and files stay in English.";
             readonly "language.saved": "Language set to {language}. Change it any time with: remotedraw language";
             readonly "language.current": "Language: {language} ({locale})";
             readonly "language.source.flag": "Set for this run by --language.";
@@ -51,6 +50,24 @@ export declare const LOCALES: {
             readonly "help.command.createInput": "Create or print a test input request payload.";
             readonly "help.command.examples": "List or install example projects.";
             readonly "help.command.agent": "Print or install the RemoteDraw agent skill.";
+            readonly "help.command.scan": "Read a codebase and propose where RemoteDraw fits.";
+            readonly "help.command.project": "Create a dashboard project and API key without scaffolding.";
+            readonly "project.help.usage": "  remotedraw project create --name <name> [--key-name <name>] [--env <dir>] [--format json]";
+            readonly "project.help.body": "Creates a dashboard project and a project-scoped development API key. Nothing is scaffolded; use it when the integration already has its files.";
+            readonly "project.help.env": "Pass --env <dir> to write REMOTEDRAW_API_BASE_URL, REMOTEDRAW_PROJECT_ID, and REMOTEDRAW_API_KEY into <dir>/.env.local instead of printing the key.";
+            readonly "project.help.auth": "Needs a signed-in CLI (remotedraw login) or REMOTEDRAW_CLI_TOKEN.";
+            readonly "project.error.unknownSubcommand": "Unknown project subcommand: {subcommand}. Expected create.";
+            readonly "project.error.nameRequired": "--name is required for project create.";
+            readonly "project.created": "Created project {name} ({id}).";
+            readonly "project.keyWritten": "Wrote the API key to {path}.";
+            readonly "project.keyOnce": "API key (shown once): {key}";
+            readonly "project.keyRule": "Keep rd_sk_... keys in backend secrets only; never in browser bundles, mobile apps, or source control.";
+            readonly "cloud.warning.clientTree": "src/remotedraw/createRemoteDrawSession.ts reads REMOTEDRAW_API_KEY and must run server-side. Move it to your API route, server action, Convex action, or serverless function before use; a browser bundle must never import it.";
+            readonly "scan.help.usage": "  remotedraw scan [--path <dir>] [--format json]";
+            readonly "scan.help.body": "Detects web, server, and iOS projects, existing RemoteDraw wiring, and where an rd_sk_ key may live; then lists integration options and the product questions to ask the user before building.";
+            readonly "scan.help.privacy": "Reads manifests and file names only. Reports env variable names, never values.";
+            readonly "scan.help.json": "Pass --format json for the machine-readable report agents should read.";
+            readonly "scan.error.missingPath": "Path does not exist: {path}";
             readonly "help.startHere": "Start here:";
             readonly "guide.title": "RemoteDraw integration guide";
             readonly "guide.intro": "Choose the surface your customer already has:";
@@ -152,22 +169,22 @@ export declare const LOCALES: {
             readonly "choice.preset.sketch.summary": "Normalized input for your own receiver surface.";
             readonly "choice.preset.sketch.explanation": "Choose this when your product owns the photo, map, PDF, canvas, or other receiver UI. RemoteDraw supplies the input primitives without prescribing a component design.";
             readonly "choice.preset.sketch.docs": "Open sketch docs";
-            readonly "choice.preset.photoMarkup.summary": "Annotations on top of a photo.";
-            readonly "choice.preset.photoMarkup.explanation": "Use this for inspections, feedback, or instructions on imagery. Your app supplies the photo and keeps the link with the drawings.";
+            readonly "choice.preset.photoMarkup.summary": "Draw on a photo your app is already showing on a screen.";
+            readonly "choice.preset.photoMarkup.explanation": "Your receiver renders the photo — on the desktop, laptop, or display someone is looking at — and a phone marks it up from across the room. The phone never takes or uploads the picture; your app supplies it and keeps the link with the drawings. Use this for reviewing an inspection photo at a desk, giving feedback on imagery, or annotating a screenshot.";
             readonly "choice.preset.photoMarkup.docs": "Open photo markup docs";
-            readonly "choice.preset.pdfMarkup.summary": "Annotations on a PDF page.";
-            readonly "choice.preset.pdfMarkup.explanation": "Use this for document review. Your app renders the right page and maps RemoteDraw coordinates onto that fixed view.";
+            readonly "choice.preset.pdfMarkup.summary": "Draw on a PDF page your app is already showing on a screen.";
+            readonly "choice.preset.pdfMarkup.explanation": "Use this for document review at a desk: your receiver renders the right page and a phone marks it. RemoteDraw renders no PDFs — your app owns the page and maps RemoteDraw coordinates onto that fixed view.";
             readonly "choice.preset.pdfMarkup.docs": "Open PDF markup docs";
-            readonly "choice.preset.mapMarkup.summary": "Drawings and directions on a map.";
-            readonly "choice.preset.mapMarkup.explanation": "Use this for routes, locations, or spatial feedback. Your app owns the map and viewport; RemoteDraw syncs the input.";
+            readonly "choice.preset.mapMarkup.summary": "Draw routes and directions on the map your app is showing.";
+            readonly "choice.preset.mapMarkup.explanation": "Use this for routes, locations, or spatial feedback marked from a phone onto a map on a desktop or wall display. Your app owns the map and the camera; RemoteDraw carries the input in geographic board space. The board's coordinateSpace.bounds is a fixed fence — size it larger than the camera you open on.";
             readonly "choice.preset.mapMarkup.docs": "Open map markup docs";
             readonly "choice.preset.screenMarkup.label": "Screen annotation";
             readonly "choice.preset.screenMarkup.hint": "Mark up a screen or window your receiver shares.";
             readonly "choice.preset.screenMarkup.summary": "Annotations on a screen or application view.";
-            readonly "choice.preset.screenMarkup.explanation": "Use this for support, demos, and UI feedback. Your receiver supplies the screen image the phone marks are projected onto.";
+            readonly "choice.preset.screenMarkup.explanation": "Use this for support, demos, and UI feedback: the screen being marked is the receiver's, and the phone is the pen. Your receiver supplies the screen image the phone marks are projected onto.";
             readonly "choice.preset.screenMarkup.docs": "Open screen markup docs";
             readonly "choice.preset.designReview.summary": "Focused visual feedback on a design.";
-            readonly "choice.preset.designReview.explanation": "Use this for design reviews with arrows, shapes, and freehand lines. Your product owns comments, versions, and decisions.";
+            readonly "choice.preset.designReview.explanation": "Use this for design reviews with arrows, shapes, and freehand lines drawn from a phone onto the design open on a reviewer's screen. Your product owns comments, versions, and decisions.";
             readonly "choice.preset.designReview.docs": "Open design review docs";
             readonly "choice.preset.pointer.summary": "Live pointing without persistent ink.";
             readonly "choice.preset.pointer.explanation": "Use this for presentations and guidance where the phone acts as a pointer and movement matters more than stored ink.";
@@ -200,7 +217,6 @@ export declare const LOCALES: {
             readonly "wizard.control.back": "Esc back";
             readonly "wizard.control.quitCtrlC": "Ctrl+C quit";
             readonly "wizard.control.quitQ": "q quit";
-            readonly "wizard.control.move": "↑/↓ move";
             readonly "wizard.control.steps": "←/→ steps";
             readonly "wizard.control.choose": "↑/↓ choose";
             readonly "wizard.control.docs": "d open docs";
@@ -218,7 +234,6 @@ export declare const LOCALES: {
             readonly "wizard.tagline.setup": "phone → canvas · project setup";
             readonly "wizard.tagline": "phone → canvas";
             readonly "wizard.docs.openFailed": "Could not open the documentation. Use {url}";
-            readonly "wizard.docs.button": "[ {label} ↗ ]";
             readonly "new.help.usage.bare": "  remotedraw new";
             readonly "new.help.usage.named": "  remotedraw new --app-name <name> [options]";
             readonly "new.help.interactive": "Run without options for the interactive setup flow.";
@@ -286,7 +301,7 @@ export declare const LOCALES: {
             readonly "doctor.sdk.ok": "{package} is listed in package.json dependencies.";
             readonly "doctor.sdk.missing": "Add {package}@{range} to dependencies or rerun remotedraw init.";
             readonly "doctor.apiKey.ok": "Server-side API key shape looks correct.";
-            readonly "doctor.apiKey.missing": "Keep an rd_sk_... key in backend secrets only.";
+            readonly "doctor.apiKey.missing": "No rd_sk_... key found in this project's environment (REMOTEDRAW_API_KEY). When you add one, keep it in backend secrets only.";
             readonly "doctor.label.deployment": "deployment";
             readonly "doctor.label.deploymentReachable": "deployment reachable";
             readonly "doctor.label.apiKeyAccepted": "API key accepted";
@@ -419,7 +434,7 @@ export declare const LOCALES: {
         endonym: string;
         tags: string[];
         aliases: string[];
-        catalog: Partial<Record<"language.word" | "language.prompt.helper" | "language.saved" | "language.current" | "language.source.flag" | "language.source.env" | "language.source.config" | "language.source.default" | "language.available" | "language.unknown" | "language.saveFailed" | "language.help.title" | "language.help.usage.list" | "language.help.usage.set" | "language.help.body" | "language.help.override" | "word.usage" | "word.options" | "word.commands" | "word.next" | "word.examples" | "help.title" | "help.usage.main" | "help.command.guide" | "help.command.options" | "help.command.language" | "help.command.login" | "help.command.logout" | "help.command.whoami" | "help.command.new" | "help.command.init" | "help.command.dev" | "help.command.doctor" | "help.command.update" | "help.command.createInput" | "help.command.examples" | "help.command.agent" | "help.startHere" | "guide.title" | "guide.intro" | "guide.path.webIos" | "guide.path.webOwned" | "guide.path.svelteIos" | "guide.path.desktop" | "guide.path.ownIos" | "guide.note.keys" | "guide.note.provisioning" | "guide.note.offline" | "options.title" | "options.machineReadable" | "options.help.body" | "field.appName" | "field.target" | "field.sender" | "field.sdk" | "field.preset" | "field.packageManager" | "field.apiBaseUrl" | "field.project" | "field.folder" | "field.sdkShort" | "field.sender.helper" | "field.sdk.helper" | "field.appName.error" | "field.appName.preview" | "choice.target.web.label" | "choice.target.web.summary" | "choice.target.web.explanation" | "choice.target.web.docs" | "choice.target.desktop.label" | "choice.target.desktop.summary" | "choice.target.desktop.explanation" | "choice.target.desktop.docs" | "choice.target.ios.label" | "choice.target.ios.summary" | "choice.target.ios.explanation" | "choice.target.ios.docs" | "choice.target.headless.label" | "choice.target.headless.summary" | "choice.target.headless.explanation" | "choice.target.headless.docs" | "choice.sender.remotedrawIos.label" | "choice.sender.remotedrawIos.hint.scan" | "choice.sender.remotedrawIos.hint.joinUrl" | "choice.sender.remotedrawIos.summary" | "choice.sender.remotedrawIos.explanation" | "choice.sender.remotedrawIos.docs" | "choice.sender.embeddedWeb.label" | "choice.sender.embeddedWeb.hint" | "choice.sender.embeddedWeb.summary" | "choice.sender.embeddedWeb.explanation" | "choice.sender.embeddedWeb.docs" | "choice.sender.ownIos.label" | "choice.sender.ownIos.hint" | "choice.sender.ownIos.summary" | "choice.sender.ownIos.explanation" | "choice.sender.ownIos.docs" | "choice.sender.headless.label" | "choice.sender.headless.hint.noUi" | "choice.sender.headless.hint.httpRoutes" | "choice.sender.headless.summary" | "choice.sender.headless.explanation" | "choice.sender.headless.docs" | "choice.sdk.react.label" | "choice.sdk.react.hint" | "choice.sdk.react.summary" | "choice.sdk.react.explanation" | "choice.sdk.react.docs" | "choice.sdk.svelte.label" | "choice.sdk.svelte.hint" | "choice.sdk.svelte.summary" | "choice.sdk.svelte.explanation" | "choice.sdk.svelte.docs" | "choice.sdk.js.label.client" | "choice.sdk.js.label.noFramework" | "choice.sdk.js.hint.client" | "choice.sdk.js.hint.noFramework" | "choice.sdk.js.summary" | "choice.sdk.js.explanation" | "choice.sdk.js.docs" | "choice.sdk.swift.label" | "choice.sdk.swift.hint" | "choice.sdk.swift.summary" | "choice.sdk.swift.explanation" | "choice.sdk.swift.docs" | "choice.sdk.headless.label" | "choice.sdk.headless.hint" | "choice.sdk.headless.summary" | "choice.sdk.headless.explanation" | "choice.sdk.headless.docs" | "choice.preset.approval.summary" | "choice.preset.approval.explanation" | "choice.preset.approval.docs" | "choice.preset.sketch.label" | "choice.preset.sketch.hint" | "choice.preset.sketch.summary" | "choice.preset.sketch.explanation" | "choice.preset.sketch.docs" | "choice.preset.photoMarkup.summary" | "choice.preset.photoMarkup.explanation" | "choice.preset.photoMarkup.docs" | "choice.preset.pdfMarkup.summary" | "choice.preset.pdfMarkup.explanation" | "choice.preset.pdfMarkup.docs" | "choice.preset.mapMarkup.summary" | "choice.preset.mapMarkup.explanation" | "choice.preset.mapMarkup.docs" | "choice.preset.screenMarkup.label" | "choice.preset.screenMarkup.hint" | "choice.preset.screenMarkup.summary" | "choice.preset.screenMarkup.explanation" | "choice.preset.screenMarkup.docs" | "choice.preset.designReview.summary" | "choice.preset.designReview.explanation" | "choice.preset.designReview.docs" | "choice.preset.pointer.summary" | "choice.preset.pointer.explanation" | "choice.preset.pointer.docs" | "choice.packageManager.npm.summary" | "choice.packageManager.npm.explanation" | "choice.packageManager.npm.docs" | "choice.packageManager.pnpm.summary" | "choice.packageManager.pnpm.explanation" | "choice.packageManager.pnpm.docs" | "choice.packageManager.yarn.summary" | "choice.packageManager.yarn.explanation" | "choice.packageManager.yarn.docs" | "choice.packageManager.bun.summary" | "choice.packageManager.bun.explanation" | "choice.packageManager.bun.docs" | "wizard.title.setup" | "wizard.title.review" | "wizard.title.confirm" | "wizard.title.executing" | "wizard.title.success" | "wizard.title.error" | "wizard.title.interrupted" | "wizard.title.cancelled" | "wizard.confirm.no" | "wizard.confirm.yes" | "wizard.hint.replaceDefault" | "wizard.hint.edit" | "wizard.control.next" | "wizard.control.back" | "wizard.control.quitCtrlC" | "wizard.control.quitQ" | "wizard.control.move" | "wizard.control.steps" | "wizard.control.choose" | "wizard.control.docs" | "wizard.control.forward" | "wizard.control.backArrow" | "wizard.control.confirm" | "wizard.progress.step" | "wizard.card.help" | "wizard.card.summary" | "wizard.value.default" | "wizard.executing.detail" | "wizard.created.at" | "wizard.next.command" | "wizard.docs.line" | "wizard.tagline.setup" | "wizard.tagline" | "wizard.docs.openFailed" | "wizard.docs.button" | "new.help.usage.bare" | "new.help.usage.named" | "new.help.interactive" | "new.help.option.path" | "new.help.option.target" | "new.help.option.sender" | "new.help.option.sdk" | "new.help.option.preset" | "new.help.option.packageManager" | "new.help.option.apiBaseUrl" | "new.help.option.force" | "new.help.option.offline" | "new.help.option.nonInteractive" | "new.help.option.format" | "new.help.option.dryRun" | "new.help.option.language" | "init.help.usage" | "init.help.body" | "prompt.control.move" | "prompt.control.select" | "prompt.control.quit" | "prompt.intro.setup" | "scaffold.verb.created" | "scaffold.verb.initialized" | "scaffold.verb.installedExample" | "scaffold.headline" | "scaffold.choices" | "scaffold.choice.app" | "scaffold.choice.sdk" | "scaffold.choice.sender" | "scaffold.choice.starter" | "scaffold.wrote" | "scaffold.wouldWrite" | "scaffold.next.install" | "scaffold.next.secrets" | "scaffold.next.createInput" | "scaffold.next.render" | "cloud.skipped" | "cloud.dashboardProject" | "cloud.devKey" | "cloud.projectId" | "cloud.warning.placeholder" | "cloud.warning.offline" | "cloud.warning.dryRun" | "login.already" | "login.complete" | "login.credential" | "login.help.title" | "login.help.usage" | "login.help.body" | "logout.done" | "logout.none" | "logout.help.title" | "logout.help.usage" | "whoami.notLoggedIn" | "whoami.api" | "whoami.anonymous" | "whoami.help.title" | "whoami.help.usage" | "doctor.title" | "doctor.config.ok" | "doctor.config.missing" | "doctor.package.ok" | "doctor.package.missing" | "doctor.sdk.ok" | "doctor.sdk.missing" | "doctor.apiKey.ok" | "doctor.apiKey.missing" | "doctor.label.deployment" | "doctor.label.deploymentReachable" | "doctor.label.apiKeyAccepted" | "doctor.label.cliVersion" | "doctor.network.offline" | "doctor.network.noOrigin" | "doctor.health.ok" | "doctor.health.failed" | "doctor.key.skippedNoKey" | "doctor.key.skippedNoHealth" | "doctor.key.liveOne" | "doctor.key.liveMany" | "doctor.version.offline" | "doctor.version.unknown" | "doctor.version.stale" | "doctor.version.latest" | "doctor.probe.noNetwork" | "doctor.probe.noNetworkKey" | "doctor.probe.nonJson" | "doctor.probe.rejected" | "doctor.baseUrl.placeholder" | "doctor.baseUrl.invalid" | "doctor.baseUrl.default" | "doctor.baseUrl.production" | "doctor.baseUrl.override" | "doctor.baseUrl.origin.flag" | "doctor.baseUrl.origin.project" | "doctor.help.usage" | "doctor.help.checks" | "doctor.help.baseUrl" | "doctor.help.network" | "doctor.help.version" | "doctor.help.offline" | "update.unreachable" | "update.alreadyLatest" | "update.available" | "update.ephemeral" | "update.runToInstall" | "update.availableRun" | "update.failed" | "update.done" | "update.help.usage" | "update.help.body" | "update.help.global" | "update.help.check" | "update.help.silence" | "dev.title" | "dev.apiBaseUrl" | "dev.hosted" | "dev.step1" | "dev.step1.detail" | "dev.step2" | "dev.step3" | "dev.step3.detail" | "dev.help.usage" | "dev.help.body" | "createInput.title" | "createInput.warning" | "createInput.footer" | "createInput.error.noFetch" | "createInput.error.noKey" | "createInput.error.apiStatus" | "createInput.help.usage" | "createInput.help.option.preset" | "createInput.help.option.label" | "createInput.help.option.externalId" | "createInput.help.option.apiBaseUrl" | "createInput.help.option.apiKey" | "createInput.help.option.expiresInMs" | "examples.title" | "examples.reactIos" | "examples.reactOwnedSender" | "examples.rawHttp" | "examples.iosOwnedSender" | "examples.installOne" | "examples.help.usage.list" | "examples.help.usage.install" | "agent.title" | "agent.intro" | "agent.printSkill" | "agent.installSkill" | "agent.wouldWrite" | "agent.installed" | "agent.next" | "agent.error.exists" | "agent.help.usage.bare" | "agent.help.usage.print" | "agent.help.usage.install" | "agent.help.paths" | "agent.help.body" | "cloud.authorize" | "cloud.browserOpened" | "cloud.browserFailed" | "cloud.error.notLoggedIn" | "cloud.error.authStatus" | "cloud.error.authExpired" | "cloud.error.noFetch" | "cloud.error.unreachable" | "cloud.error.endpointMissing" | "cloud.error.invalidResponse" | "cloud.error.requestFailed" | "cloud.error.badOrigin" | "cloud.error.configUnreadable" | "cloud.error.envConflict" | "notice.update.available" | "notice.update.ephemeral" | "notice.update.install" | "error.appNameRequired" | "error.plan.ownIosNeedsSwift" | "error.plan.swiftNeedsOwnIos" | "error.plan.iosNeedsOwnIos" | "error.plan.headlessSenderSdk" | "error.unknownChoice" | "error.refuseOverwrite" | "error.expectedHttpOrigin" | "error.expectedBareOrigin" | "error.noHome" | "error.unknownCommand" | "error.unsupportedOption" | "error.optionNoValue" | "error.optionNeedsValue" | "error.expiresInMs" | "error.interactiveNeedsTty" | "error.noChoices" | "error.httpsDocsOnly" | "error.httpUrlsOnly", string>>;
+        catalog: Partial<Record<"language.word" | "language.saved" | "language.current" | "language.source.flag" | "language.source.env" | "language.source.config" | "language.source.default" | "language.available" | "language.unknown" | "language.saveFailed" | "language.help.title" | "language.help.usage.list" | "language.help.usage.set" | "language.help.body" | "language.help.override" | "word.usage" | "word.options" | "word.commands" | "word.next" | "word.examples" | "help.title" | "help.usage.main" | "help.command.guide" | "help.command.options" | "help.command.language" | "help.command.login" | "help.command.logout" | "help.command.whoami" | "help.command.new" | "help.command.init" | "help.command.dev" | "help.command.doctor" | "help.command.update" | "help.command.createInput" | "help.command.examples" | "help.command.agent" | "help.command.scan" | "help.command.project" | "project.help.usage" | "project.help.body" | "project.help.env" | "project.help.auth" | "project.error.unknownSubcommand" | "project.error.nameRequired" | "project.created" | "project.keyWritten" | "project.keyOnce" | "project.keyRule" | "cloud.warning.clientTree" | "scan.help.usage" | "scan.help.body" | "scan.help.privacy" | "scan.help.json" | "scan.error.missingPath" | "help.startHere" | "guide.title" | "guide.intro" | "guide.path.webIos" | "guide.path.webOwned" | "guide.path.svelteIos" | "guide.path.desktop" | "guide.path.ownIos" | "guide.note.keys" | "guide.note.provisioning" | "guide.note.offline" | "options.title" | "options.machineReadable" | "options.help.body" | "field.appName" | "field.target" | "field.sender" | "field.sdk" | "field.preset" | "field.packageManager" | "field.apiBaseUrl" | "field.project" | "field.folder" | "field.sdkShort" | "field.sender.helper" | "field.sdk.helper" | "field.appName.error" | "field.appName.preview" | "choice.target.web.label" | "choice.target.web.summary" | "choice.target.web.explanation" | "choice.target.web.docs" | "choice.target.desktop.label" | "choice.target.desktop.summary" | "choice.target.desktop.explanation" | "choice.target.desktop.docs" | "choice.target.ios.label" | "choice.target.ios.summary" | "choice.target.ios.explanation" | "choice.target.ios.docs" | "choice.target.headless.label" | "choice.target.headless.summary" | "choice.target.headless.explanation" | "choice.target.headless.docs" | "choice.sender.remotedrawIos.label" | "choice.sender.remotedrawIos.hint.scan" | "choice.sender.remotedrawIos.hint.joinUrl" | "choice.sender.remotedrawIos.summary" | "choice.sender.remotedrawIos.explanation" | "choice.sender.remotedrawIos.docs" | "choice.sender.embeddedWeb.label" | "choice.sender.embeddedWeb.hint" | "choice.sender.embeddedWeb.summary" | "choice.sender.embeddedWeb.explanation" | "choice.sender.embeddedWeb.docs" | "choice.sender.ownIos.label" | "choice.sender.ownIos.hint" | "choice.sender.ownIos.summary" | "choice.sender.ownIos.explanation" | "choice.sender.ownIos.docs" | "choice.sender.headless.label" | "choice.sender.headless.hint.noUi" | "choice.sender.headless.hint.httpRoutes" | "choice.sender.headless.summary" | "choice.sender.headless.explanation" | "choice.sender.headless.docs" | "choice.sdk.react.label" | "choice.sdk.react.hint" | "choice.sdk.react.summary" | "choice.sdk.react.explanation" | "choice.sdk.react.docs" | "choice.sdk.svelte.label" | "choice.sdk.svelte.hint" | "choice.sdk.svelte.summary" | "choice.sdk.svelte.explanation" | "choice.sdk.svelte.docs" | "choice.sdk.js.label.client" | "choice.sdk.js.label.noFramework" | "choice.sdk.js.hint.client" | "choice.sdk.js.hint.noFramework" | "choice.sdk.js.summary" | "choice.sdk.js.explanation" | "choice.sdk.js.docs" | "choice.sdk.swift.label" | "choice.sdk.swift.hint" | "choice.sdk.swift.summary" | "choice.sdk.swift.explanation" | "choice.sdk.swift.docs" | "choice.sdk.headless.label" | "choice.sdk.headless.hint" | "choice.sdk.headless.summary" | "choice.sdk.headless.explanation" | "choice.sdk.headless.docs" | "choice.preset.approval.summary" | "choice.preset.approval.explanation" | "choice.preset.approval.docs" | "choice.preset.sketch.label" | "choice.preset.sketch.hint" | "choice.preset.sketch.summary" | "choice.preset.sketch.explanation" | "choice.preset.sketch.docs" | "choice.preset.photoMarkup.summary" | "choice.preset.photoMarkup.explanation" | "choice.preset.photoMarkup.docs" | "choice.preset.pdfMarkup.summary" | "choice.preset.pdfMarkup.explanation" | "choice.preset.pdfMarkup.docs" | "choice.preset.mapMarkup.summary" | "choice.preset.mapMarkup.explanation" | "choice.preset.mapMarkup.docs" | "choice.preset.screenMarkup.label" | "choice.preset.screenMarkup.hint" | "choice.preset.screenMarkup.summary" | "choice.preset.screenMarkup.explanation" | "choice.preset.screenMarkup.docs" | "choice.preset.designReview.summary" | "choice.preset.designReview.explanation" | "choice.preset.designReview.docs" | "choice.preset.pointer.summary" | "choice.preset.pointer.explanation" | "choice.preset.pointer.docs" | "choice.packageManager.npm.summary" | "choice.packageManager.npm.explanation" | "choice.packageManager.npm.docs" | "choice.packageManager.pnpm.summary" | "choice.packageManager.pnpm.explanation" | "choice.packageManager.pnpm.docs" | "choice.packageManager.yarn.summary" | "choice.packageManager.yarn.explanation" | "choice.packageManager.yarn.docs" | "choice.packageManager.bun.summary" | "choice.packageManager.bun.explanation" | "choice.packageManager.bun.docs" | "wizard.title.setup" | "wizard.title.review" | "wizard.title.confirm" | "wizard.title.executing" | "wizard.title.success" | "wizard.title.error" | "wizard.title.interrupted" | "wizard.title.cancelled" | "wizard.confirm.no" | "wizard.confirm.yes" | "wizard.hint.replaceDefault" | "wizard.hint.edit" | "wizard.control.next" | "wizard.control.back" | "wizard.control.quitCtrlC" | "wizard.control.quitQ" | "wizard.control.steps" | "wizard.control.choose" | "wizard.control.docs" | "wizard.control.forward" | "wizard.control.backArrow" | "wizard.control.confirm" | "wizard.progress.step" | "wizard.card.help" | "wizard.card.summary" | "wizard.value.default" | "wizard.executing.detail" | "wizard.created.at" | "wizard.next.command" | "wizard.docs.line" | "wizard.tagline.setup" | "wizard.tagline" | "wizard.docs.openFailed" | "new.help.usage.bare" | "new.help.usage.named" | "new.help.interactive" | "new.help.option.path" | "new.help.option.target" | "new.help.option.sender" | "new.help.option.sdk" | "new.help.option.preset" | "new.help.option.packageManager" | "new.help.option.apiBaseUrl" | "new.help.option.force" | "new.help.option.offline" | "new.help.option.nonInteractive" | "new.help.option.format" | "new.help.option.dryRun" | "new.help.option.language" | "init.help.usage" | "init.help.body" | "prompt.control.move" | "prompt.control.select" | "prompt.control.quit" | "prompt.intro.setup" | "scaffold.verb.created" | "scaffold.verb.initialized" | "scaffold.verb.installedExample" | "scaffold.headline" | "scaffold.choices" | "scaffold.choice.app" | "scaffold.choice.sdk" | "scaffold.choice.sender" | "scaffold.choice.starter" | "scaffold.wrote" | "scaffold.wouldWrite" | "scaffold.next.install" | "scaffold.next.secrets" | "scaffold.next.createInput" | "scaffold.next.render" | "cloud.skipped" | "cloud.dashboardProject" | "cloud.devKey" | "cloud.projectId" | "cloud.warning.placeholder" | "cloud.warning.offline" | "cloud.warning.dryRun" | "login.already" | "login.complete" | "login.credential" | "login.help.title" | "login.help.usage" | "login.help.body" | "logout.done" | "logout.none" | "logout.help.title" | "logout.help.usage" | "whoami.notLoggedIn" | "whoami.api" | "whoami.anonymous" | "whoami.help.title" | "whoami.help.usage" | "doctor.title" | "doctor.config.ok" | "doctor.config.missing" | "doctor.package.ok" | "doctor.package.missing" | "doctor.sdk.ok" | "doctor.sdk.missing" | "doctor.apiKey.ok" | "doctor.apiKey.missing" | "doctor.label.deployment" | "doctor.label.deploymentReachable" | "doctor.label.apiKeyAccepted" | "doctor.label.cliVersion" | "doctor.network.offline" | "doctor.network.noOrigin" | "doctor.health.ok" | "doctor.health.failed" | "doctor.key.skippedNoKey" | "doctor.key.skippedNoHealth" | "doctor.key.liveOne" | "doctor.key.liveMany" | "doctor.version.offline" | "doctor.version.unknown" | "doctor.version.stale" | "doctor.version.latest" | "doctor.probe.noNetwork" | "doctor.probe.noNetworkKey" | "doctor.probe.nonJson" | "doctor.probe.rejected" | "doctor.baseUrl.placeholder" | "doctor.baseUrl.invalid" | "doctor.baseUrl.default" | "doctor.baseUrl.production" | "doctor.baseUrl.override" | "doctor.baseUrl.origin.flag" | "doctor.baseUrl.origin.project" | "doctor.help.usage" | "doctor.help.checks" | "doctor.help.baseUrl" | "doctor.help.network" | "doctor.help.version" | "doctor.help.offline" | "update.unreachable" | "update.alreadyLatest" | "update.available" | "update.ephemeral" | "update.runToInstall" | "update.availableRun" | "update.failed" | "update.done" | "update.help.usage" | "update.help.body" | "update.help.global" | "update.help.check" | "update.help.silence" | "dev.title" | "dev.apiBaseUrl" | "dev.hosted" | "dev.step1" | "dev.step1.detail" | "dev.step2" | "dev.step3" | "dev.step3.detail" | "dev.help.usage" | "dev.help.body" | "createInput.title" | "createInput.warning" | "createInput.footer" | "createInput.error.noFetch" | "createInput.error.noKey" | "createInput.error.apiStatus" | "createInput.help.usage" | "createInput.help.option.preset" | "createInput.help.option.label" | "createInput.help.option.externalId" | "createInput.help.option.apiBaseUrl" | "createInput.help.option.apiKey" | "createInput.help.option.expiresInMs" | "examples.title" | "examples.reactIos" | "examples.reactOwnedSender" | "examples.rawHttp" | "examples.iosOwnedSender" | "examples.installOne" | "examples.help.usage.list" | "examples.help.usage.install" | "agent.title" | "agent.intro" | "agent.printSkill" | "agent.installSkill" | "agent.wouldWrite" | "agent.installed" | "agent.next" | "agent.error.exists" | "agent.help.usage.bare" | "agent.help.usage.print" | "agent.help.usage.install" | "agent.help.paths" | "agent.help.body" | "cloud.authorize" | "cloud.browserOpened" | "cloud.browserFailed" | "cloud.error.notLoggedIn" | "cloud.error.authStatus" | "cloud.error.authExpired" | "cloud.error.noFetch" | "cloud.error.unreachable" | "cloud.error.endpointMissing" | "cloud.error.invalidResponse" | "cloud.error.requestFailed" | "cloud.error.badOrigin" | "cloud.error.configUnreadable" | "cloud.error.envConflict" | "notice.update.available" | "notice.update.ephemeral" | "notice.update.install" | "error.appNameRequired" | "error.plan.ownIosNeedsSwift" | "error.plan.swiftNeedsOwnIos" | "error.plan.iosNeedsOwnIos" | "error.plan.headlessSenderSdk" | "error.unknownChoice" | "error.refuseOverwrite" | "error.expectedHttpOrigin" | "error.expectedBareOrigin" | "error.noHome" | "error.unknownCommand" | "error.unsupportedOption" | "error.optionNoValue" | "error.optionNeedsValue" | "error.expiresInMs" | "error.interactiveNeedsTty" | "error.noChoices" | "error.httpsDocsOnly" | "error.httpUrlsOnly", string>>;
     };
 };
 export type Locale = keyof typeof LOCALES;

package/dist/locales/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locales/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAawB,CAAC;AAE7C,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,OAAO,CAAC;AAE1C,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,MAAa,CAAC;AAE1C,eAAO,MAAM,iBAAiB,EAA2B,MAAM,EAAE,CAAC;AAElE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locales/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAC7B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAG7B,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAawB,CAAC;AAE7C,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,OAAO,CAAC;AAE1C,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,MAAa,CAAC;AAE1C,eAAO,MAAM,iBAAiB,EAA2B,MAAM,EAAE,CAAC;AAElE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC"}

package/dist/locales/nl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nl.d.ts","sourceRoot":"","sources":["../../src/locales/nl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,EAAE,EAAE,aA6lBhB,CAAC"}
+{"version":3,"file":"nl.d.ts","sourceRoot":"","sources":["../../src/locales/nl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;GAMG;AACH,eAAO,MAAM,EAAE,EAAE,aA8mBhB,CAAC"}

package/dist/locales/nl.js

@@ -8,7 +8,6 @@
 export const nl = {
     // ── Taalkeuze ─────────────────────────────────────────────────────────
     "language.word": "Taal",
-    "language.prompt.helper": "Stelt de taal van de RemoteDraw-CLI in. Gegenereerde code en bestanden blijven Engels.",
     "language.saved": "Taal ingesteld op {language}. Wijzig dit wanneer je wilt met: remotedraw language",
     "language.current": "Taal: {language} ({locale})",
     "language.source.flag": "Voor deze opdracht ingesteld met --language.",
@@ -46,6 +45,24 @@ export const nl = {
     "help.command.createInput": "Maak of toon een testverzoek voor tekeninvoer.",
     "help.command.examples": "Toon of installeer voorbeeldprojecten.",
     "help.command.agent": "Toon of installeer de RemoteDraw-agentskill.",
+    "help.command.scan": "Lees een codebase en stel voor waar RemoteDraw past.",
+    "help.command.project": "Maak een dashboardproject en API-sleutel zonder starterscode.",
+    "project.help.usage": "  remotedraw project create --name <naam> [--key-name <naam>] [--env <map>] [--format json]",
+    "project.help.body": "Maakt een dashboardproject en een projectgebonden ontwikkel-API-sleutel. Er wordt niets gescaffold; gebruik dit als de integratie haar bestanden al heeft.",
+    "project.help.env": "Geef --env <map> op om REMOTEDRAW_API_BASE_URL, REMOTEDRAW_PROJECT_ID en REMOTEDRAW_API_KEY naar <map>/.env.local te schrijven in plaats van de sleutel te tonen.",
+    "project.help.auth": "Vereist een ingelogde CLI (remotedraw login) of REMOTEDRAW_CLI_TOKEN.",
+    "project.error.unknownSubcommand": "Onbekend project-subcommando: {subcommand}. Verwacht: create.",
+    "project.error.nameRequired": "--name is verplicht voor project create.",
+    "project.created": "Project {name} ({id}) aangemaakt.",
+    "project.keyWritten": "API-sleutel geschreven naar {path}.",
+    "project.keyOnce": "API-sleutel (eenmalig getoond): {key}",
+    "project.keyRule": "Bewaar rd_sk_...-sleutels uitsluitend in backend-secrets; nooit in browserbundels, mobiele apps of versiebeheer.",
+    "cloud.warning.clientTree": "src/remotedraw/createRemoteDrawSession.ts leest REMOTEDRAW_API_KEY en moet server-side draaien. Verplaats het naar je API-route, server action, Convex action of serverless functie voordat je het gebruikt; een browserbundel mag het nooit importeren.",
+    "scan.help.usage": "  remotedraw scan [--path <map>] [--format json]",
+    "scan.help.body": "Herkent web-, server- en iOS-projecten, bestaande RemoteDraw-koppelingen en waar een rd_sk_-sleutel mag staan; toont daarna integratieopties en de productvragen die je de gebruiker stelt voordat je bouwt.",
+    "scan.help.privacy": "Leest alleen manifesten en bestandsnamen. Toont namen van omgevingsvariabelen, nooit waarden.",
+    "scan.help.json": "Gebruik --format json voor het machineleesbare rapport dat agents moeten lezen.",
+    "scan.error.missingPath": "Pad bestaat niet: {path}",
     "help.startHere": "Begin hier:",
     // ── guide ─────────────────────────────────────────────────────────────
     "guide.title": "RemoteDraw-integratiegids",
@@ -154,19 +171,19 @@ export const nl = {
     "choice.preset.sketch.summary": "Genormaliseerde invoer voor een eigen ontvangeroppervlak.",
     "choice.preset.sketch.explanation": "Kies dit wanneer jouw product de foto, kaart, PDF, canvas of andere receiver-UI beheert. RemoteDraw levert de invoerprimitieven zonder een voorgeschreven componentontwerp.",
     "choice.preset.sketch.docs": "Schetsdocs openen",
-    "choice.preset.photoMarkup.summary": "Aantekeningen bovenop een foto.",
-    "choice.preset.photoMarkup.explanation": "Gebruik dit voor inspecties, feedback of aanwijzingen op beeldmateriaal. Je app levert de foto en bewaart de relatie met de tekeningen.",
+    "choice.preset.photoMarkup.summary": "Teken op een foto die je app al op een scherm toont.",
+    "choice.preset.photoMarkup.explanation": "Je ontvanger toont de foto — op de desktop, laptop of display waar iemand naar kijkt — en een telefoon zet er markeringen op. De telefoon maakt of uploadt de foto nooit; je app levert die en bewaart de relatie met de tekeningen. Gebruik dit voor het beoordelen van een inspectiefoto aan een bureau, feedback op beeldmateriaal of het annoteren van een schermafbeelding.",
     "choice.preset.photoMarkup.docs": "Fotoannotatiedocs openen",
-    "choice.preset.pdfMarkup.summary": "Aantekeningen op een PDF-pagina.",
-    "choice.preset.pdfMarkup.explanation": "Gebruik dit voor documentreview. Je app rendert de juiste pagina en koppelt RemoteDraw-coördinaten aan die vaste weergave.",
+    "choice.preset.pdfMarkup.summary": "Teken op een PDF-pagina die je app al op een scherm toont.",
+    "choice.preset.pdfMarkup.explanation": "Gebruik dit voor documentreview aan een bureau: je ontvanger rendert de juiste pagina en een telefoon markeert die. RemoteDraw rendert geen PDF's — je app beheert de pagina en koppelt RemoteDraw-coördinaten aan die vaste weergave.",
     "choice.preset.pdfMarkup.docs": "PDF-annotatiedocs openen",
-    "choice.preset.mapMarkup.summary": "Tekeningen en aanwijzingen op een kaart.",
-    "choice.preset.mapMarkup.explanation": "Gebruik dit voor routes, locaties of ruimtelijke feedback. Je app beheert de kaart en viewport; RemoteDraw synchroniseert de invoer.",
+    "choice.preset.mapMarkup.summary": "Teken routes en aanwijzingen op de kaart die je app toont.",
+    "choice.preset.mapMarkup.explanation": "Gebruik dit voor routes, locaties of ruimtelijke feedback die vanaf een telefoon op een kaart op een desktop of wanddisplay worden gezet. Je app beheert de kaart en de camera; RemoteDraw draagt de invoer in geografische board-ruimte. De coordinateSpace.bounds van het board is een vast hek — maak het groter dan de camera waarmee je opent.",
     "choice.preset.mapMarkup.docs": "Kaartannotatiedocs openen",
     "choice.preset.screenMarkup.label": "Schermannotatie",
     "choice.preset.screenMarkup.hint": "Teken over een scherm of venster dat je ontvanger deelt.",
     "choice.preset.screenMarkup.summary": "Aantekeningen op een scherm of applicatieweergave.",
-    "choice.preset.screenMarkup.explanation": "Gebruik dit voor support, demo's en UI-feedback. Je ontvanger levert het schermbeeld waarop de telefoonmarkeringen worden geprojecteerd.",
+    "choice.preset.screenMarkup.explanation": "Gebruik dit voor support, demo's en UI-feedback: het scherm dat gemarkeerd wordt is dat van de ontvanger en de telefoon is de pen. Je ontvanger levert het schermbeeld waarop de telefoonmarkeringen worden geprojecteerd.",
     "choice.preset.screenMarkup.docs": "Schermaantekeningdocs openen",
     "choice.preset.designReview.summary": "Gerichte visuele feedback op een ontwerp.",
     "choice.preset.designReview.explanation": "Gebruik dit voor ontwerpbeoordelingen met pijlen, vormen en vrije lijnen. Je product beheert opmerkingen, versies en besluitvorming.",
@@ -204,7 +221,6 @@ export const nl = {
     "wizard.control.back": "Esc terug",
     "wizard.control.quitCtrlC": "Ctrl+C stoppen",
     "wizard.control.quitQ": "q stoppen",
-    "wizard.control.move": "↑/↓ bewegen",
     "wizard.control.steps": "←/→ stappen",
     "wizard.control.choose": "↑/↓ kiezen",
     "wizard.control.docs": "d docs openen",
@@ -222,7 +238,6 @@ export const nl = {
     "wizard.tagline.setup": "telefoon → canvas · projectsetup",
     "wizard.tagline": "telefoon → canvas",
     "wizard.docs.openFailed": "Kon de documentatie niet openen. Gebruik {url}",
-    "wizard.docs.button": "[ {label} ↗ ]",
     // ── new / init ────────────────────────────────────────────────────────
     "new.help.usage.bare": "  remotedraw new",
     "new.help.usage.named": "  remotedraw new --app-name <naam> [opties]",
@@ -294,7 +309,7 @@ export const nl = {
     "doctor.sdk.ok": "{package} staat in de dependencies van package.json.",
     "doctor.sdk.missing": "Voeg {package}@{range} toe aan de dependencies of voer remotedraw init opnieuw uit.",
     "doctor.apiKey.ok": "De vorm van de server-API-sleutel klopt.",
-    "doctor.apiKey.missing": "Bewaar een rd_sk_...-sleutel uitsluitend in backend-secrets.",
+    "doctor.apiKey.missing": "Geen rd_sk_...-sleutel gevonden in de omgeving van dit project (REMOTEDRAW_API_KEY). Bewaar die, zodra je er een toevoegt, uitsluitend in backend-secrets.",
     "doctor.label.deployment": "deployment",
     "doctor.label.deploymentReachable": "deployment bereikbaar",
     "doctor.label.apiKeyAccepted": "API-sleutel geaccepteerd",

package/dist/packageManagers.d.ts

@@ -0,0 +1,75 @@
+/**
+ * One table for the four package managers RemoteDraw supports, and the
+ * detection that picks the right one for a project.
+ *
+ * Two things go wrong without this. First, every surface that prints a command
+ * invents its own spelling, and they drift: `pnpm install` is not `pnpm add`,
+ * `npx` is not `pnpm dlx`, and Yarn Berry has no global install at all. Second,
+ * the CLI defaults to npm and tells a pnpm user to run `npm install` in a
+ * pnpm project - a command that works, and quietly leaves a `package-lock.json`
+ * next to their `pnpm-lock.yaml`.
+ *
+ * The table below is the single source of truth. `tests/api/docs-route-coverage`
+ * style parity tests keep the docs snippets generated from it rather than typed
+ * out beside it.
+ */
+export declare const packageManagerIds: readonly ["npm", "pnpm", "yarn", "bun"];
+export type PackageManagerId = (typeof packageManagerIds)[number];
+export type PackageManagerCommands = {
+    /** Install everything the manifest already declares. */
+    install: string;
+    /** Add a dependency to the project. */
+    add: string;
+    /**
+     * Install a CLI globally. `null` where the manager has no such concept:
+     * Yarn Berry removed `yarn global`, and points people at `yarn dlx` instead.
+     */
+    addGlobal: string | null;
+    /** Run a published binary without installing it first. */
+    dlx: string;
+    /** Run a script from package.json. */
+    run: string;
+    /** The lockfiles this manager writes, most specific first. */
+    lockfiles: string[];
+};
+export declare const packageManagerCommands: Record<PackageManagerId, PackageManagerCommands>;
+export declare function isPackageManagerId(value: string): value is PackageManagerId;
+/**
+ * How a reader of the docs gets the CLI. A manager without a global install
+ * runs it straight from the registry instead, which is a real answer rather
+ * than a caveat.
+ */
+export declare function cliInstallCommand(manager: PackageManagerId, packageName: string): string;
+/** `npm install @remotedraw/react`, `pnpm add @remotedraw/react`, ... */
+export declare function addPackageCommand(manager: PackageManagerId, packageName: string): string;
+/**
+ * Every manager sets `npm_config_user_agent` when it runs a script or a binary
+ * it installed, and the name comes first: "pnpm/10.4.1 npm/? node/v24.0.0".
+ * This is the only signal that reports the manager actually in use rather than
+ * one inferred from files on disk.
+ */
+export declare function packageManagerFromUserAgent(env: Record<string, string | undefined>): PackageManagerId | undefined;
+type DetectRuntime = {
+    env: Record<string, string | undefined>;
+    exists: (filePath: string) => boolean | Promise<boolean>;
+    readFile: (filePath: string) => Promise<string>;
+};
+/**
+ * Walks up from `dir` looking for the nearest declaration, because the answer
+ * usually lives at the root of a monorepo rather than in the package being
+ * scaffolded into it.
+ *
+ * Order: the `packageManager` field (explicit), then a lockfile (evidence),
+ * then the running manager's user agent (ambient), then npm.
+ */
+export declare function detectPackageManager(dir: string, runtime: DetectRuntime, options?: {
+    pathModule?: {
+        join: (...parts: string[]) => string;
+        dirname: (p: string) => string;
+    };
+}): Promise<{
+    manager: PackageManagerId;
+    reason: string;
+}>;
+export {};
+//# sourceMappingURL=packageManagers.d.ts.map

package/dist/packageManagers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageManagers.d.ts","sourceRoot":"","sources":["../src/packageManagers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,yCAA0C,CAAC;AAEzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAAG;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,gBAAgB,EAChB,sBAAsB,CAqCvB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,gBAAgB,GAAG,SAAS,CAK9B;AAED,KAAK,aAAa,GAAG;IACnB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD,CAAC;AAmBF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;KAAE,CAAA;CAAO,GACtG,OAAO,CAAC;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAsCxD"}

package/dist/packageManagers.js

@@ -0,0 +1,146 @@
+/**
+ * One table for the four package managers RemoteDraw supports, and the
+ * detection that picks the right one for a project.
+ *
+ * Two things go wrong without this. First, every surface that prints a command
+ * invents its own spelling, and they drift: `pnpm install` is not `pnpm add`,
+ * `npx` is not `pnpm dlx`, and Yarn Berry has no global install at all. Second,
+ * the CLI defaults to npm and tells a pnpm user to run `npm install` in a
+ * pnpm project - a command that works, and quietly leaves a `package-lock.json`
+ * next to their `pnpm-lock.yaml`.
+ *
+ * The table below is the single source of truth. `tests/api/docs-route-coverage`
+ * style parity tests keep the docs snippets generated from it rather than typed
+ * out beside it.
+ */
+export const packageManagerIds = ["npm", "pnpm", "yarn", "bun"];
+export const packageManagerCommands = {
+    npm: {
+        install: "npm install",
+        add: "npm install",
+        addGlobal: "npm install -g",
+        dlx: "npx",
+        run: "npm run",
+        lockfiles: ["package-lock.json", "npm-shrinkwrap.json"],
+    },
+    pnpm: {
+        install: "pnpm install",
+        add: "pnpm add",
+        addGlobal: "pnpm add -g",
+        dlx: "pnpm dlx",
+        run: "pnpm",
+        lockfiles: ["pnpm-lock.yaml"],
+    },
+    yarn: {
+        install: "yarn install",
+        add: "yarn add",
+        // Berry (Yarn 2+) dropped global installs entirely, and classic's
+        // `yarn global add` is deprecated. `yarn dlx` is the one answer that is
+        // correct on both.
+        addGlobal: null,
+        dlx: "yarn dlx",
+        run: "yarn",
+        lockfiles: ["yarn.lock"],
+    },
+    bun: {
+        install: "bun install",
+        add: "bun add",
+        addGlobal: "bun add -g",
+        dlx: "bunx",
+        run: "bun run",
+        lockfiles: ["bun.lock", "bun.lockb"],
+    },
+};
+export function isPackageManagerId(value) {
+    return packageManagerIds.includes(value);
+}
+/**
+ * How a reader of the docs gets the CLI. A manager without a global install
+ * runs it straight from the registry instead, which is a real answer rather
+ * than a caveat.
+ */
+export function cliInstallCommand(manager, packageName) {
+    const commands = packageManagerCommands[manager];
+    return commands.addGlobal
+        ? `${commands.addGlobal} ${packageName}`
+        : `${commands.dlx} ${packageName}`;
+}
+/** `npm install @remotedraw/react`, `pnpm add @remotedraw/react`, ... */
+export function addPackageCommand(manager, packageName) {
+    return `${packageManagerCommands[manager].add} ${packageName}`;
+}
+/**
+ * Every manager sets `npm_config_user_agent` when it runs a script or a binary
+ * it installed, and the name comes first: "pnpm/10.4.1 npm/? node/v24.0.0".
+ * This is the only signal that reports the manager actually in use rather than
+ * one inferred from files on disk.
+ */
+export function packageManagerFromUserAgent(env) {
+    const agent = env.npm_config_user_agent?.trim();
+    if (!agent)
+        return undefined;
+    const name = agent.split("/")[0]?.trim().toLowerCase() ?? "";
+    return isPackageManagerId(name) ? name : undefined;
+}
+/**
+ * Corepack's `packageManager` field, e.g. "pnpm@10.4.1+sha512...". It is the
+ * project's own declaration, so it outranks anything inferred.
+ */
+function managerFromManifest(contents) {
+    try {
+        const parsed = JSON.parse(contents);
+        if (typeof parsed.packageManager !== "string")
+            return undefined;
+        const name = parsed.packageManager.split("@")[0]?.trim().toLowerCase() ?? "";
+        return isPackageManagerId(name) ? name : undefined;
+    }
+    catch {
+        // A malformed package.json is the caller's problem, not a reason to fail
+        // a question that has a perfectly good fallback.
+        return undefined;
+    }
+}
+/**
+ * Walks up from `dir` looking for the nearest declaration, because the answer
+ * usually lives at the root of a monorepo rather than in the package being
+ * scaffolded into it.
+ *
+ * Order: the `packageManager` field (explicit), then a lockfile (evidence),
+ * then the running manager's user agent (ambient), then npm.
+ */
+export async function detectPackageManager(dir, runtime, options = {}) {
+    const join = options.pathModule?.join ?? ((...parts) => parts.join("/"));
+    const dirname = options.pathModule?.dirname ??
+        ((value) => value.slice(0, Math.max(value.lastIndexOf("/"), 0)));
+    let current = dir;
+    // A repo root is a handful of levels up at most; the bound is only here so a
+    // symlink loop cannot turn detection into a hang.
+    for (let depth = 0; depth < 32; depth += 1) {
+        const manifest = join(current, "package.json");
+        if (await runtime.exists(manifest)) {
+            const declared = managerFromManifest(await runtime.readFile(manifest));
+            if (declared) {
+                return {
+                    manager: declared,
+                    reason: `${manifest} declares packageManager: ${declared}`,
+                };
+            }
+        }
+        for (const manager of packageManagerIds) {
+            for (const lockfile of packageManagerCommands[manager].lockfiles) {
+                if (await runtime.exists(join(current, lockfile))) {
+                    return { manager, reason: `found ${join(current, lockfile)}` };
+                }
+            }
+        }
+        const parent = dirname(current);
+        if (!parent || parent === current)
+            break;
+        current = parent;
+    }
+    const ambient = packageManagerFromUserAgent(runtime.env);
+    if (ambient) {
+        return { manager: ambient, reason: `running under ${ambient}` };
+    }
+    return { manager: "npm", reason: "no lockfile or declaration found" };
+}

package/dist/scan.d.ts

@@ -0,0 +1,77 @@
+import { type PackageManagerId } from "./packageManagers.js";
+export type ScanRuntime = {
+    cwd: string;
+    exists: (filePath: string) => boolean | Promise<boolean>;
+    readFile: (filePath: string) => Promise<string>;
+    readdir?: (dirPath: string) => Promise<string[]>;
+    /** Only read for `npm_config_user_agent`, when nothing on disk answers. */
+    env?: Record<string, string | undefined>;
+};
+export type ScanProjectKind = "web" | "server" | "ios" | "library" | "unknown";
+export type ScanProject = {
+    /** Directory relative to the scan root; `.` for the root itself. */
+    path: string;
+    name?: string;
+    kind: ScanProjectKind;
+    /** Framework and runtime signals, deduplicated, stable order. */
+    frameworks: string[];
+    /** Human-readable proof for every claim above, so the agent can verify. */
+    evidence: string[];
+    /** For web projects: whether server-side code was found *inside* them. */
+    serverSide?: string[];
+};
+export type ScanRecommendation = {
+    id: string;
+    title: string;
+    fit: "strong" | "possible";
+    receiver: string;
+    sender: string;
+    keyLocation: string;
+    why: string;
+    commands: string[];
+    packages: string[];
+};
+export type ScanReport = {
+    ok: true;
+    command: "scan";
+    schemaVersion: 1;
+    root: string;
+    /**
+     * The manager this project already uses, and the evidence for it. An agent
+     * that installs with the wrong one leaves a second lockfile behind, which is
+     * a mess a human then has to notice and clean up.
+     */
+    packageManager: {
+        id: PackageManagerId;
+        reason: string;
+        /** Ready to run, so nothing downstream has to spell them itself. */
+        commands: {
+            install: string;
+            add: string;
+            dlx: string;
+            run: string;
+        };
+    };
+    projects: ScanProject[];
+    remotedraw: {
+        configured: boolean;
+        configFiles: string[];
+        packages: string[];
+        envKeys: string[];
+        swiftPackage: boolean;
+    };
+    keyBoundary: {
+        /** Directories where an `rd_sk_` key may live. Empty means "none found". */
+        serverSide: string[];
+        warning?: string;
+    };
+    recommendations: ScanRecommendation[];
+    /** Product decisions the agent must ask the user, not decide. */
+    questions: string[];
+    /** Hard rules for whatever the agent builds next. */
+    rules: string[];
+};
+export declare function scanProject(root: string, runtime: ScanRuntime): Promise<ScanReport>;
+export declare const INTEGRATION_RULES: string[];
+export declare function renderScanText(report: ScanReport): string;
+//# sourceMappingURL=scan.d.ts.map

package/dist/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"AAiBA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,WAAW,GAAG;IACxB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,CAAC;IACtB,iEAAiE;IACjE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,IAAI,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,cAAc,EAAE;QACd,EAAE,EAAE,gBAAgB,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,oEAAoE;QACpE,QAAQ,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,CAAC;KACtE,CAAC;IACF,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,UAAU,EAAE;QACV,UAAU,EAAE,OAAO,CAAC;QACpB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,WAAW,EAAE;QACX,4EAA4E;QAC5E,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,eAAe,EAAE,kBAAkB,EAAE,CAAC;IACtC,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAoPF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA6KrB;AA6HD,eAAO,MAAM,iBAAiB,UAa7B,CAAC;AAEF,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,UAiDhD"}