hopsule 0.9.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Hopsule
+
+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,57 @@
+# Hopsule CLI
+
+Decision-first, context-aware, portable memory system for your projects.
+
+## Install
+
+```bash
+npm install -g hopsule
+```
+
+## Other Installation Methods
+
+| Method | Command |
+|--------|---------|
+| **Homebrew** | `brew install hopsule/tap/hopsule` |
+| **Scoop** | `scoop bucket add hopsule https://github.com/Hopsule/scoop-bucket && scoop install hopsule` |
+| **Chocolatey** | `choco install hopsule` |
+| **Shell script** | `curl -fsSL https://raw.githubusercontent.com/Hopsule/cli-tool/main/install.sh \| bash` |
+
+## Usage
+
+```bash
+# Launch interactive TUI dashboard
+hopsule
+
+# Login with device auth
+hopsule login
+
+# List decisions
+hopsule list
+
+# Create a decision
+hopsule create
+
+# Show status
+hopsule status
+```
+
+## What is Hopsule?
+
+Hopsule is a decision-first, context-aware, portable memory system. It helps teams and individuals:
+
+- **Track architectural decisions** with full lifecycle (Draft -> Pending -> Accepted -> Deprecated)
+- **Preserve project memory** across time, people, and tools
+- **Share context** between projects, teams, and AI agents via Context Packs
+- **Enforce past decisions** in development workflows
+
+## Links
+
+- [Documentation](https://github.com/Hopsule/cli-tool#readme)
+- [GitHub](https://github.com/Hopsule/cli-tool)
+- [Website](https://hopsule.com)
+- [Issues](https://github.com/Hopsule/cli-tool/issues)
+
+## License
+
+MIT

package/bin/hopsule

@@ -0,0 +1,22 @@
+#!/bin/sh
+
+# Hopsule CLI - npm wrapper
+# This script launches the Go binary installed by the npm postinstall script.
+
+BASEDIR=$(dirname "$0")
+BINARY="$BASEDIR/hopsule"
+
+# Check for the actual Go binary (not this wrapper)
+if [ -f "${BINARY}" ] && [ ! "${BINARY}" -ef "$0" ]; then
+  exec "${BINARY}" "$@"
+fi
+
+# Fallback: look for hopsule.exe (shouldn't happen on unix but be safe)
+if [ -f "${BASEDIR}/hopsule.exe" ]; then
+  exec "${BASEDIR}/hopsule.exe" "$@"
+fi
+
+echo "Error: hopsule binary not found." >&2
+echo "Try reinstalling: npm install -g hopsule" >&2
+echo "Or install directly: brew install hopsule/tap/hopsule" >&2
+exit 1

package/bin/hopsule.cmd

@@ -0,0 +1,17 @@
+@echo off
+:: Hopsule CLI - Windows npm wrapper
+:: Launches the Go binary installed by the npm postinstall script.
+
+setlocal
+
+set "BASEDIR=%~dp0"
+set "BINARY=%BASEDIR%hopsule.exe"
+
+if exist "%BINARY%" (
+    "%BINARY%" %*
+    exit /b %ERRORLEVEL%
+)
+
+echo Error: hopsule binary not found. 1>&2
+echo Try reinstalling: npm install -g hopsule 1>&2
+exit /b 1

package/install.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const os = require("os");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const { execSync } = require("child_process");
+
+const PACKAGE = require("./package.json");
+const VERSION = PACKAGE.version;
+const REPO = "Hopsule/cli-tool";
+const BINARY_NAME = "hopsule";
+
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+};
+
+const ARCH_MAP = {
+  x64: "amd64",
+  arm64: "arm64",
+};
+
+function getPlatform() {
+  const platform = PLATFORM_MAP[os.platform()];
+  if (!platform) {
+    throw new Error(
+      `Unsupported platform: ${os.platform()}. ` +
+        `Supported: ${Object.keys(PLATFORM_MAP).join(", ")}`
+    );
+  }
+  return platform;
+}
+
+function getArch() {
+  const arch = ARCH_MAP[os.arch()];
+  if (!arch) {
+    throw new Error(
+      `Unsupported architecture: ${os.arch()}. ` +
+        `Supported: ${Object.keys(ARCH_MAP).join(", ")}`
+    );
+  }
+  return arch;
+}
+
+function getDownloadUrl(platform, arch) {
+  const ext = platform === "windows" ? "zip" : "tar.gz";
+  return `https://github.com/${REPO}/releases/download/v${VERSION}/${BINARY_NAME}-${platform}-${arch}.${ext}`;
+}
+
+function getBinaryPath() {
+  const binDir = path.join(__dirname, "bin");
+  const ext = os.platform() === "win32" ? ".exe" : "";
+  return path.join(binDir, `${BINARY_NAME}${ext}`);
+}
+
+function downloadFile(url) {
+  return new Promise((resolve, reject) => {
+    const follow = (url, redirects = 0) => {
+      if (redirects > 10) {
+        return reject(new Error("Too many redirects"));
+      }
+
+      https
+        .get(url, { headers: { "User-Agent": "hopsule-npm-installer" } }, (res) => {
+          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+            return follow(res.headers.location, redirects + 1);
+          }
+
+          if (res.statusCode !== 200) {
+            return reject(
+              new Error(`Download failed: HTTP ${res.statusCode} from ${url}`)
+            );
+          }
+
+          const chunks = [];
+          res.on("data", (chunk) => chunks.push(chunk));
+          res.on("end", () => resolve(Buffer.concat(chunks)));
+          res.on("error", reject);
+        })
+        .on("error", reject);
+    };
+
+    follow(url);
+  });
+}
+
+async function extractTarGz(buffer, destDir) {
+  const tmpFile = path.join(os.tmpdir(), `hopsule-${Date.now()}.tar.gz`);
+  fs.writeFileSync(tmpFile, buffer);
+
+  try {
+    execSync(`tar xzf "${tmpFile}" -C "${destDir}"`, { stdio: "pipe" });
+  } finally {
+    try {
+      fs.unlinkSync(tmpFile);
+    } catch (_) {}
+  }
+}
+
+async function extractZip(buffer, destDir) {
+  const tmpFile = path.join(os.tmpdir(), `hopsule-${Date.now()}.zip`);
+  fs.writeFileSync(tmpFile, buffer);
+
+  try {
+    if (os.platform() === "win32") {
+      execSync(
+        `powershell -Command "Expand-Archive -Path '${tmpFile}' -DestinationPath '${destDir}' -Force"`,
+        { stdio: "pipe" }
+      );
+    } else {
+      execSync(`unzip -o "${tmpFile}" -d "${destDir}"`, { stdio: "pipe" });
+    }
+  } finally {
+    try {
+      fs.unlinkSync(tmpFile);
+    } catch (_) {}
+  }
+}
+
+async function install() {
+  const platform = getPlatform();
+  const arch = getArch();
+  const url = getDownloadUrl(platform, arch);
+  const binDir = path.join(__dirname, "bin");
+  const binaryPath = getBinaryPath();
+
+  // Skip if binary already exists with correct version
+  if (fs.existsSync(binaryPath)) {
+    try {
+      const output = execSync(`"${binaryPath}" --version`, {
+        encoding: "utf8",
+        stdio: "pipe",
+      });
+      if (output.includes(VERSION)) {
+        console.log(`hopsule v${VERSION} already installed.`);
+        return;
+      }
+    } catch (_) {}
+  }
+
+  console.log(`Installing hopsule v${VERSION} for ${platform}/${arch}...`);
+  console.log(`Downloading from: ${url}`);
+
+  const buffer = await downloadFile(url);
+
+  // Ensure bin directory exists
+  if (!fs.existsSync(binDir)) {
+    fs.mkdirSync(binDir, { recursive: true });
+  }
+
+  // Extract based on platform
+  const tmpExtractDir = path.join(os.tmpdir(), `hopsule-extract-${Date.now()}`);
+  fs.mkdirSync(tmpExtractDir, { recursive: true });
+
+  try {
+    if (platform === "windows") {
+      await extractZip(buffer, tmpExtractDir);
+    } else {
+      await extractTarGz(buffer, tmpExtractDir);
+    }
+
+    // Find and move the binary
+    const ext = platform === "windows" ? ".exe" : "";
+    const extractedBinary = path.join(tmpExtractDir, `${BINARY_NAME}${ext}`);
+
+    if (!fs.existsSync(extractedBinary)) {
+      // Some archives nest in a directory
+      const files = fs.readdirSync(tmpExtractDir);
+      let found = false;
+      for (const f of files) {
+        const nested = path.join(tmpExtractDir, f, `${BINARY_NAME}${ext}`);
+        if (fs.existsSync(nested)) {
+          fs.copyFileSync(nested, binaryPath);
+          found = true;
+          break;
+        }
+      }
+      if (!found) {
+        throw new Error(
+          `Binary not found in archive. Contents: ${files.join(", ")}`
+        );
+      }
+    } else {
+      fs.copyFileSync(extractedBinary, binaryPath);
+    }
+
+    // Make executable on unix
+    if (platform !== "windows") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    console.log(`hopsule v${VERSION} installed successfully!`);
+  } finally {
+    try {
+      fs.rmSync(tmpExtractDir, { recursive: true, force: true });
+    } catch (_) {}
+  }
+}
+
+install().catch((err) => {
+  console.error(`Failed to install hopsule: ${err.message}`);
+  console.error("");
+  console.error("You can install manually from:");
+  console.error(`  https://github.com/${REPO}/releases/tag/v${VERSION}`);
+  console.error("");
+  console.error("Or use Homebrew: brew install hopsule/tap/hopsule");
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "hopsule",
+  "version": "0.9.1",
+  "description": "Decision-first, context-aware, portable memory system CLI",
+  "keywords": [
+    "cli",
+    "decisions",
+    "architecture",
+    "memory",
+    "context",
+    "governance",
+    "hopsule"
+  ],
+  "homepage": "https://hopsule.com",
+  "bugs": {
+    "url": "https://github.com/Hopsule/cli-tool/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Hopsule/cli-tool.git"
+  },
+  "license": "MIT",
+  "author": "Hopsule <hello@hopsule.com>",
+  "bin": {
+    "hopsule": "./bin/hopsule"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  }
+}