protoyard 0.0.0 → 1.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dailybot, Inc.
+
+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

@@ -1,11 +1,22 @@
 # protoyard
 
-**Protoyard: build prototypes that feel real.** Real behavior. Fake infrastructure.
+The Protoyard command line under its short name. `protoyard` is a thin
+wrapper that runs [`@protoyard/cli`](../cli/README.md) at exactly the same
+version (lockstep, [ADR-028](../../docs/DECISIONS.md)):
 
-This `0.0.0` version only reserves the package name. The first npm release is
-in preparation. Until then, use Protoyard from its repository:
+```bash
+npx protoyard --version
+npx protoyard doctor --json
+npm install --save-dev protoyard   # then: npx protoyard <command>
+```
 
-- Live showcase: https://protoyard.app
-- Source and docs: https://github.com/DailybotHQ/protoyard
+Every command, flag and `--json` envelope is the CLI's own. The wrapper loads
+`@protoyard/cli` in the same process, so arguments, standard input and output,
+signals and the exit code pass through unchanged. If `@protoyard/cli` is
+missing, the wrapper says so and exits 1.
 
-MIT © Dailybot, Inc.
+Inside the Protoyard repository, use `pnpm protoyard <command>`. That root
+script runs the CLI from source, and no workspace package installs a second
+`protoyard` bin.
+
+See the [Protoyard documentation](https://protoyard.app/docs/) for the commands.

package/bin/protoyard.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// `protoyard` (unscoped): hand over to @protoyard/cli in this same process,
+// so argv, stdin/stdout/stderr, signals and the exit code are the CLI's own.
+import { pathToFileURL } from 'node:url';
+import { resolveCliBin } from '../index.js';
+
+let bin;
+try {
+  bin = resolveCliBin();
+} catch (error) {
+  process.stderr.write(`protoyard: ${error instanceof Error ? error.message : String(error)}\n`);
+  process.exit(1);
+}
+await import(pathToFileURL(bin).href);

package/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The absolute path of the installed @protoyard/cli executable (its
+ * package.json `bin.protoyard`). `entry` is the resolved @protoyard/cli
+ * module; by default it is resolved from this package.
+ */
+export declare function resolveCliBin(entry?: string): string;

package/index.js

@@ -0,0 +1,55 @@
+// @ts-check
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const CLI = '@protoyard/cli';
+
+/**
+ * @protoyard/cli exports only its API (and only the `import` condition when
+ * packed), so its manifest is found from the resolved entry: walk up to the
+ * package.json named @protoyard/cli, then read its `bin.protoyard`. That is
+ * ./bin/protoyard.mjs in this repository and ./dist/bin.js when installed.
+ *
+ * @param {string} [entry]
+ * @returns {string}
+ */
+export function resolveCliBin(entry) {
+  let resolved = entry;
+  if (!resolved) {
+    try {
+      resolved = fileURLToPath(import.meta.resolve(CLI));
+    } catch {
+      throw new Error(
+        `${CLI} is not installed next to protoyard. Reinstall protoyard (npm install protoyard), or run npx protoyard.`
+      );
+    }
+  }
+  for (let dir = dirname(resolved); ; dir = dirname(dir)) {
+    const manifestPath = join(dir, 'package.json');
+    if (existsSync(manifestPath)) {
+      /** @type {{ name?: unknown, bin?: unknown }} */
+      let manifest = {};
+      try {
+        manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+      } catch {
+        // unreadable manifest: keep walking
+      }
+      if (manifest.name === CLI) {
+        const bin =
+          typeof manifest.bin === 'string'
+            ? manifest.bin
+            : manifest.bin && typeof manifest.bin === 'object'
+              ? /** @type {Record<string, unknown>} */ (manifest.bin).protoyard
+              : undefined;
+        if (typeof bin !== 'string') throw new Error(`${manifestPath} declares no protoyard bin.`);
+        const path = resolve(dir, bin);
+        if (!path.startsWith(`${dir}/`) && !path.startsWith(`${dir}\\`)) {
+          throw new Error(`${manifestPath} points its bin outside the package.`);
+        }
+        return path;
+      }
+    }
+    if (dirname(dir) === dir) throw new Error(`No ${CLI} package.json above ${resolved}.`);
+  }
+}

package/package.json

@@ -1,12 +1,47 @@
 {
   "name": "protoyard",
-  "version": "0.0.0",
-  "description": "Protoyard: build prototypes that feel real. Real behavior. Fake infrastructure. This version only reserves the name; the first release is coming.",
-  "homepage": "https://protoyard.app",
-  "repository": { "type": "git", "url": "git+https://github.com/DailybotHQ/protoyard.git" },
-  "bugs": { "url": "https://github.com/DailybotHQ/protoyard/issues" },
+  "version": "1.1.1",
+  "description": "The protoyard command line under its short name: `npx protoyard` runs @protoyard/cli at the same version.",
   "license": "MIT",
-  "author": "Dailybot, Inc.",
-  "keywords": ["prototype", "prototyping", "svelte", "vite", "mock-data", "agents"],
-  "files": ["README.md"]
-}
+  "type": "module",
+  "sideEffects": false,
+  "homepage": "https://protoyard.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DailybotHQ/protoyard.git",
+    "directory": "packages/protoyard"
+  },
+  "keywords": [
+    "protoyard",
+    "prototype",
+    "cli"
+  ],
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "bin": {
+    "protoyard": "./bin/protoyard.mjs"
+  },
+  "files": [
+    "LICENSE",
+    "bin",
+    "index.js",
+    "index.d.ts",
+    "README.md"
+  ],
+  "dependencies": {
+    "@protoyard/cli": "1.1.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.20.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json"
+  }
+}