@pugi/cli 1.0.0-alpha.26 → 1.0.0-alpha.261

package/README.md

@@ -1,25 +1,36 @@
-# @pugi/cli
+# Pugi CLI
 
-Pugi CLI - terminal-native software execution system.
+Pugi is an AI product team in your terminal. Describe what you want in plain words and a team of AI specialists plans it, builds it, tests it and checks its security, then you publish it. Works on your own repository or a new project, on macOS and Linux.
 
 ## Install
 
 ```bash
-npm install -g @pugi/cli
+curl -fsSL https://pugi.io/install | sh   # macOS and Linux, no Node needed
+npm install -g @pugi/cli                  # or with npm
+brew install pugi-io/tap/pugi             # or with Homebrew
 ```
 
 ## Usage
 
 ```bash
+pugi              # interactive session in the current folder
+pugi run "..."    # one-shot task
+pugi login        # sign in with your Pugi account
 pugi --help
-pugi              # interactive TUI
-pugi run "..."    # one-shot prompt
 ```
 
+## What else is Pugi
+
+- Web console: https://app.pugi.io (build sites and apps from a brief, preview, publish)
+- Desktop apps, editor and browser extensions: https://pugi.io/download
+- Free logo maker and brand kit: https://logo.pugi.io
+- For AI agents (MCP server, Claude Code and Cursor plugins): https://pugi.io/agents.md
+- Plans: https://pugi.io/pricing
+
 ## License
 
-MIT - see LICENSE for upstream attribution.
+MIT - see LICENSE for upstream attribution and THIRD_PARTY_NOTICES.md for ported code.
 
-## Homepage
+## Support
 
-https://pugi.io
+support@pugi.io · https://pugi.io

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,39 @@
+# Third-party notices
+
+Code in this repository that was copied or ported from other open-source
+projects, with the licence it was taken under. (The upstream OpenCode fork
+itself is described in `NOTICE.md`.)
+
+## cloudflare/vibesdk — deterministic TypeScript code fixer
+
+| Field | Value |
+|---|---|
+| Source | https://github.com/cloudflare/vibesdk, `worker/services/code-fixer/` |
+| Commit | `9da158d82c597a0e8f4bf033cdccd1053fb6fb15` (2026-09-07) |
+| License | MIT |
+| Where | `packages/opencode/src/code-fixer/vibesdk/` (every file carries a header naming its source file) |
+| Pugi changes | Logger shim (`logger.ts`), local `CodeIssue` type, statement-level splice printing that keeps untouched code and comments byte for byte (`utils/ast.ts`), import-first TS2304 (`../resolve-name.ts`), the `allowStubs` switch (no invented code before publish), the `PUGI-STUB` marker on invented code, exact-name-only default→named conversion, no silent removal of an unresolved import, unique-candidate typo fixes (TS2614), in-place TS2724 edits. Each change is marked `Pugi:` in the source. |
+
+```
+MIT License
+
+Copyright (c) 2025 Cloudflare
+
+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/bin/pugi

@@ -1,8 +1,95 @@
-echo "Error: @pugi/cli postinstall did not run — binary is missing." >&2
-echo "" >&2
-echo "This happens when --ignore-scripts was passed during install, or" >&2
-echo "when using a package manager that skips postinstall by default." >&2
-echo "" >&2
-echo "Fix: cd node_modules/@pugi/cli && node postinstall.mjs" >&2
-echo "Or reinstall without --ignore-scripts." >&2
-exit 1
+#!/usr/bin/env node
+// `bin/pugi` of the @pugi/cli npm package (PUG-44). It runs the native Pugi
+// binary from the platform package @pugi/cli-<os>-<arch>.
+//
+// Why a Node launcher: npm's Windows shims run the bin target by its name, and
+// cmd and PowerShell will not start an exe without the .exe extension, so a
+// native binary copied to `bin/pugi` never started from them. The shebang makes
+// npm's cmd-shim run this file with node. It also works when install scripts
+// are blocked (npm 12 does that by default for global installs): it needs no
+// postinstall. On POSIX under npm or bun, the postinstall replaces this file
+// with the native binary so no extra process runs (postinstall.mjs).
+//
+// The engine finds files that ship in the wrapper (the bundled skills) through
+// PUGI_CLI_PACKAGE_DIR, because the binary it runs lives in another package.
+"use strict"
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+
+const PACKAGE_DIR_ENV = "PUGI_CLI_PACKAGE_DIR"
+const PLATFORMS = { darwin: "darwin", linux: "linux", win32: "windows" }
+const ARCHES = { x64: "x64", arm64: "arm64" }
+
+function platformPackage(platform, arch) {
+  return `@pugi/cli-${PLATFORMS[platform] || platform}-${ARCHES[arch] || arch}`
+}
+
+/** The platform package's binary, resolved from the wrapper whether npm nested or hoisted it. */
+function resolveBinary(packageDir, platform, arch) {
+  const name = platformPackage(platform, arch)
+  const manifest = (() => {
+    try {
+      return require.resolve(`${name}/package.json`, { paths: [packageDir] })
+    } catch {
+      return undefined
+    }
+  })()
+  if (!manifest) return { name }
+  const binary = path.join(path.dirname(manifest), "bin", platform === "win32" ? "pugi.exe" : "pugi")
+  return fs.existsSync(binary) ? { name, binary } : { name }
+}
+
+function run() {
+  const packageDir = path.dirname(path.dirname(fs.realpathSync(__filename)))
+  const found = resolveBinary(packageDir, process.platform, process.arch)
+  if (!found.binary) {
+    console.error(`Pugi could not find its program for ${process.platform}-${process.arch}: the package ${found.name} is not installed.`)
+    console.error("It is an optional dependency of @pugi/cli, so it must not be skipped. Reinstall with:")
+    console.error("  npm install -g @pugi/cli")
+    process.exit(1)
+  }
+
+  const child = childProcess.spawn(found.binary, process.argv.slice(2), {
+    stdio: "inherit",
+    env: { ...process.env, [PACKAGE_DIR_ENV]: packageDir },
+  })
+
+  // Windows: the child shares the console and gets Ctrl+C, Ctrl+Break and the
+  // close event itself; child.kill() would be TerminateProcess, so the launcher
+  // only keeps itself alive and waits. POSIX: forward, so a signal sent to the
+  // launcher's pid alone also reaches the engine. A Ctrl+C the terminal sends
+  // to the whole group then arrives twice; the engine coalesces it.
+  const handlers = new Map()
+  const ignored = process.platform === "win32" ? ["SIGINT", "SIGBREAK"] : []
+  const forwarded = process.platform === "win32" ? [] : ["SIGINT", "SIGTERM", "SIGHUP"]
+  for (const signal of ignored) handlers.set(signal, () => {})
+  for (const signal of forwarded) {
+    handlers.set(signal, () => {
+      try {
+        child.kill(signal)
+      } catch {
+        // The child has already exited.
+      }
+    })
+  }
+  for (const [signal, handler] of handlers) process.on(signal, handler)
+
+  child.on("error", (error) => {
+    console.error(`Pugi could not start ${found.binary}: ${error.message}`)
+    process.exit(1)
+  })
+  child.on("exit", (code, signal) => {
+    for (const [name, handler] of handlers) process.removeListener(name, handler)
+    if (signal && process.platform !== "win32") {
+      process.kill(process.pid, signal)
+      return
+    }
+    process.exit(typeof code === "number" ? code : 1)
+  })
+}
+
+if (require.main === module) run()
+
+module.exports = { PACKAGE_DIR_ENV, platformPackage, resolveBinary }