@dockydoo/cli 0.1.0

package/LICENSE

@@ -0,0 +1,33 @@
+DockyDoo CLI License
+
+Copyright (c) 2026 DockyDoo. All rights reserved.
+
+This package ("the Software") distributes the DockyDoo command-line tool
+("docky") in prebuilt binary form, together with a thin Node.js launcher
+("bin/docky.js").
+
+1. License grant. Subject to the terms below, DockyDoo grants you a personal,
+   non-exclusive, non-transferable, revocable license to download, install, and
+   run the Software to use the DockyDoo service.
+
+2. Restrictions. You may not, and may not permit others to: (a) reverse
+   engineer, decompile, or disassemble the binary, except to the extent this
+   restriction is prohibited by applicable law; (b) redistribute, sell, sublicense,
+   rent, or lease the binary; (c) remove or alter any proprietary notices; or
+   (d) use the Software to build a competing product.
+
+3. The launcher. The Node.js launcher source in bin/docky.js may be read and
+   modified for the sole purpose of running the binary; it is provided as-is.
+
+4. No source. The DockyDoo source code is proprietary and is not included or
+   licensed under this agreement.
+
+5. No warranty. 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.
+
+6. Limitation of liability. IN NO EVENT SHALL DOCKYDOO BE LIABLE FOR ANY CLAIM,
+   DAMAGES, OR OTHER LIABILITY ARISING FROM OR IN CONNECTION WITH THE SOFTWARE OR
+   ITS USE.
+
+For questions about licensing, contact: hello@dockydoo.dev

package/README.md

@@ -0,0 +1,55 @@
+# @dockydoo/cli
+
+The DockyDoo CLI: `docky` compiles your code into a living, verified
+documentation graph, on your machine, free and offline.
+
+> This is the public **distribution** package. The DockyDoo source is private;
+> only the prebuilt `docky` binaries are published here and to npm.
+
+## Install
+
+```bash
+npm install -g @dockydoo/cli
+docky --help
+```
+
+Then in a project:
+
+```bash
+docky build                 # compile .docky/graph.json
+docky ask "safe to ship?"   # query the graph for a tiny token cost
+```
+
+Prefer a raw binary? Grab one from the
+[Releases](https://github.com/dockydoo/cli/releases) page.
+
+## How distribution works
+
+`@dockydoo/cli` is a thin launcher. The actual binary is delivered by a
+per-platform optional dependency, and npm installs only the one that matches
+your machine:
+
+| Platform        | Package                      | Rust target               |
+| --------------- | ---------------------------- | ------------------------- |
+| macOS (Apple)   | `@dockydoo/cli-darwin-arm64` | `aarch64-apple-darwin`    |
+| macOS (Intel)   | `@dockydoo/cli-darwin-x64`   | `x86_64-apple-darwin`     |
+| Linux x64       | `@dockydoo/cli-linux-x64`    | `x86_64-unknown-linux-gnu`|
+| Linux arm64     | `@dockydoo/cli-linux-arm64`  | `aarch64-unknown-linux-gnu`|
+| Windows x64     | `@dockydoo/cli-win32-x64`    | `x86_64-pc-windows-msvc`  |
+
+No postinstall download, no network at install time: each platform package
+carries its binary and declares `os`/`cpu` so npm picks the right one. The
+`bin/docky.js` launcher resolves that package and execs the binary.
+
+## Releasing (maintainers)
+
+Releases are cut from the private monorepo's `release-cli` workflow, which
+cross-compiles `docky` for every target, then runs:
+
+```bash
+cd cli
+node scripts/build-platform-packages.mjs <artifacts-dir> <version>
+# publishes dist/* (platform packages) then the main wrapper
+```
+
+See `cli/scripts/targets.mjs` for the target table.

package/bin/docky.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+// @dockydoo/cli launcher. This package ships no binary itself; the actual
+// `docky` executable is delivered by a per-platform optional dependency
+// (@dockydoo/cli-<os>-<cpu>). npm installs only the one matching the host
+// (enforced by the platform package's `os`/`cpu` fields), and this shim execs
+// it with the user's args. No network at install, no postinstall download.
+//
+// The DockyDoo source stays private; only these prebuilt binaries are public.
+
+'use strict'
+
+const path = require('node:path')
+const { spawnSync } = require('node:child_process')
+
+// node platform-arch -> the platform package that carries its binary.
+const PACKAGES = {
+  'darwin-arm64': '@dockydoo/cli-darwin-arm64',
+  'darwin-x64': '@dockydoo/cli-darwin-x64',
+  'linux-x64': '@dockydoo/cli-linux-x64',
+  'linux-arm64': '@dockydoo/cli-linux-arm64',
+  'win32-x64': '@dockydoo/cli-win32-x64',
+}
+
+function resolveBinary() {
+  const key = `${process.platform}-${process.arch}`
+  const pkg = PACKAGES[key]
+  if (!pkg) {
+    throw new Error(
+      `docky: unsupported platform "${key}". ` +
+        `Supported: ${Object.keys(PACKAGES).join(', ')}.`,
+    )
+  }
+  const binName = process.platform === 'win32' ? 'docky.exe' : 'docky'
+  let pkgJson
+  try {
+    pkgJson = require.resolve(`${pkg}/package.json`)
+  } catch {
+    throw new Error(
+      `docky: the platform package "${pkg}" is not installed.\n` +
+        `This usually means it was skipped (e.g. --no-optional or an offline\n` +
+        `cache). Install it explicitly with: npm install ${pkg}`,
+    )
+  }
+  return path.join(path.dirname(pkgJson), 'bin', binName)
+}
+
+function main() {
+  let bin
+  try {
+    bin = resolveBinary()
+  } catch (err) {
+    process.stderr.write(`${err.message}\n`)
+    process.exit(1)
+  }
+  const result = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' })
+  if (result.error) {
+    process.stderr.write(`docky: failed to run binary: ${result.error.message}\n`)
+    process.exit(1)
+  }
+  // Forward the child's exit code (and signal, if any).
+  if (typeof result.status === 'number') process.exit(result.status)
+  process.exit(result.signal ? 1 : 0)
+}
+
+main()

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@dockydoo/cli",
+  "version": "0.1.0",
+  "description": "DockyDoo CLI - living product documentation compiled from your code.",
+  "homepage": "https://github.com/dockydoo/cli",
+  "bugs": "https://github.com/dockydoo/cli/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dockydoo/cli.git"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "bin": {
+    "docky": "bin/docky.js"
+  },
+  "files": [
+    "bin/docky.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "dockydoo",
+    "docky",
+    "documentation",
+    "docs",
+    "code",
+    "cli"
+  ],
+  "optionalDependencies": {
+    "@dockydoo/cli-darwin-arm64": "0.1.0",
+    "@dockydoo/cli-darwin-x64": "0.1.0",
+    "@dockydoo/cli-linux-x64": "0.1.0",
+    "@dockydoo/cli-linux-arm64": "0.1.0",
+    "@dockydoo/cli-win32-x64": "0.1.0"
+  }
+}