mb-workspace 1.0.0

package/.gitignore

@@ -0,0 +1,3 @@
+.projects/
+projects/
+node_modules/

package/README.md

@@ -0,0 +1,62 @@
+# MB Workspace
+
+One-command installer for MB Workspace, optimized for designer + developer collaboration with an AI-first workflow.
+
+## Quick install
+
+### WSL / Linux / macOS
+
+```bash
+npx mb-workspace
+```
+
+### Windows PowerShell
+
+```powershell
+npx mb-workspace
+```
+
+After install:
+
+```bash
+mb-ui
+```
+
+## Publish checklist
+
+1. Replace every `<YOUR_USER>` and `<YOUR_REPO>` placeholder in:
+   - `install.sh`
+   - `install.ps1`
+   - `bin/mb-workspace.js`
+2. Push this repo to GitHub as a public repository.
+3. Login to npm:
+
+```bash
+npm login
+```
+
+4. Publish:
+
+```bash
+npm publish
+```
+
+If the package name `mb-workspace` is already taken, change the `name` field in `package.json` and publish with a scoped name like `@yourname/mb-workspace`.
+
+## What the installer does
+
+- Clones or updates the MB Workspace repo into `~/.mb-workspace`
+- Adds `mb-tools` to PATH
+- Sets `MB_WORKSPACE_HOME`
+- Creates `projects/` and `.projects/`
+
+## Main commands
+
+- `mb-ui` — open project and task menu
+- `mb` — basic project launcher
+- `mb-start` — show branch and working tree state
+- `mb-task <name>` — create or switch task branch
+- `mb-save "message"` — commit and push current work
+- `mb-submit` — push current branch and mark it submitted
+- `mb-list` — list task branches and submitted state
+- `mb-home` — jump back to workspace home

package/bin/mb-workspace.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+
+const isWindows = process.platform === 'win32';
+
+function run(cmd, args) {
+  const result = spawnSync(cmd, args, {
+    stdio: 'inherit',
+    shell: false,
+  });
+
+  if (result.error) {
+    console.error('Failed to run:', cmd, result.error.message);
+    process.exit(1);
+  }
+
+  if (typeof result.status === 'number' && result.status !== 0) {
+    process.exit(result.status);
+  }
+}
+
+if (isWindows) {
+  run('powershell', [
+    '-NoProfile',
+    '-ExecutionPolicy',
+    'Bypass',
+    '-Command',
+    'irm https://raw.githubusercontent.com/camtm95/mb-workspace/main/install.ps1 | iex'
+  ]);
+} else {
+  run('bash', [
+    '-lc',
+    'curl -fsSL https://raw.githubusercontent.com/camtm95/mb-workspace/main/install.sh | bash'
+  ]);
+}

package/install.ps1

@@ -0,0 +1,29 @@
+$RepoUrl = "https://github.com/camtm95/mb-workspace.git"
+$InstallDir = if ($env:MB_WORKSPACE_HOME) { $env:MB_WORKSPACE_HOME } else { "$env:USERPROFILE\.mb-workspace" }
+$BinDir = "$InstallDir\mb-tools"
+
+Write-Host "Installing MB Workspace..."
+
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    Write-Host "Git is required."
+    exit 1
+}
+
+if (Test-Path "$InstallDir\.git") {
+    git -C $InstallDir pull --ff-only
+} else {
+    if (Test-Path $InstallDir) { Remove-Item $InstallDir -Recurse -Force }
+    git clone $RepoUrl $InstallDir
+}
+
+New-Item -ItemType Directory -Force -Path "$InstallDir\projects" | Out-Null
+New-Item -ItemType Directory -Force -Path "$InstallDir\.projects" | Out-Null
+
+[Environment]::SetEnvironmentVariable("MB_WORKSPACE_HOME", $InstallDir, "User")
+
+$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
+if ($currentPath -notlike "*$BinDir*") {
+    [Environment]::SetEnvironmentVariable("Path", "$currentPath;$BinDir", "User")
+}
+
+Write-Host "Installed. Reopen terminal, then run: mb-ui"

package/install.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+REPO_URL="https://github.com/camtm95/mb-workspace.git"
+INSTALL_DIR="${MB_WORKSPACE_HOME:-$HOME/.mb-workspace}"
+BIN_DIR="$INSTALL_DIR/mb-tools"
+
+detect_profile() {
+  if [ -n "${ZSH_VERSION:-}" ]; then
+    echo "$HOME/.zshrc"
+  elif [ -n "${BASH_VERSION:-}" ]; then
+    if [ -f "$HOME/.bashrc" ]; then
+      echo "$HOME/.bashrc"
+    else
+      echo "$HOME/.bash_profile"
+    fi
+  else
+    echo "$HOME/.profile"
+  fi
+}
+
+PROFILE_FILE="$(detect_profile)"
+
+echo "🚀 Installing MB Workspace..."
+echo "📁 Install dir: $INSTALL_DIR"
+
+command -v git >/dev/null 2>&1 || {
+  echo "❌ Git chưa được cài."
+  exit 1
+}
+
+mkdir -p "$INSTALL_DIR"
+
+if [ -d "$INSTALL_DIR/.git" ]; then
+  echo "🔄 Existing install found, updating..."
+  git -C "$INSTALL_DIR" pull --ff-only
+else
+  echo "📦 Cloning repository..."
+  rm -rf "$INSTALL_DIR"
+  git clone "$REPO_URL" "$INSTALL_DIR"
+fi
+
+mkdir -p "$INSTALL_DIR/projects" "$INSTALL_DIR/.projects"
+chmod +x "$BIN_DIR"/*
+
+touch "$PROFILE_FILE"
+
+if ! grep -q 'MB_WORKSPACE_HOME=' "$PROFILE_FILE" 2>/dev/null; then
+  {
+    echo ''
+    echo '# >>> mb-workspace >>>'
+    echo "export MB_WORKSPACE_HOME=\"$INSTALL_DIR\""
+    echo 'export PATH="$MB_WORKSPACE_HOME/mb-tools:$PATH"'
+    echo '# <<< mb-workspace <<<'
+  } >> "$PROFILE_FILE"
+fi
+
+export MB_WORKSPACE_HOME="$INSTALL_DIR"
+export PATH="$MB_WORKSPACE_HOME/mb-tools:$PATH"
+
+echo ""
+echo "✅ MB Workspace installed."
+echo "👉 Run this once:"
+echo "source \"$PROFILE_FILE\""
+echo ""
+echo "👉 Then run:"
+echo "mb-ui"

package/mb-tools/_mb-common.sh

@@ -0,0 +1,31 @@
+#!/usr/bin/env bash
+
+mb_script_dir() {
+  cd "$(dirname "${BASH_SOURCE[0]}")" && pwd
+}
+
+mb_workspace() {
+  local script_dir
+  script_dir="$(mb_script_dir)"
+  if [ -n "${MB_WORKSPACE_HOME:-}" ]; then
+    printf '%s\n' "$MB_WORKSPACE_HOME"
+  else
+    cd "$script_dir/.." && pwd
+  fi
+}
+
+mb_projects_dir() {
+  printf '%s/projects\n' "$(mb_workspace)"
+}
+
+mb_state_dir() {
+  printf '%s/.projects\n' "$(mb_workspace)"
+}
+
+mb_submitted_file() {
+  printf '%s/.mb_submitted\n' "$(mb_state_dir)"
+}
+
+mb_repo_root() {
+  git rev-parse --show-toplevel 2>/dev/null
+}

package/mb-tools/mb

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKSPACE="${MB_WORKSPACE_HOME:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+PROJECTS_DIR="$WORKSPACE/projects"
+
+mkdir -p "$PROJECTS_DIR"
+
+echo "=== MB WORKSPACE ==="
+echo "1. Mở project có sẵn"
+echo "2. Clone project mới"
+read -r -p "Chọn (1/2): " choice
+
+if [ "$choice" = "1" ]; then
+  echo "Danh sách project:"
+  ls "$PROJECTS_DIR" 2>/dev/null || true
+
+  read -r -p "Nhập tên project: " project
+
+  if [ -d "$PROJECTS_DIR/$project" ]; then
+    cd "$PROJECTS_DIR/$project" || exit 1
+    echo "Đã vào project: $project"
+    exec "${SHELL:-bash}" -lc 'mb-start; exec "${SHELL:-bash}"'
+  else
+    echo "❌ Project không tồn tại"
+    exit 1
+  fi
+
+elif [ "$choice" = "2" ]; then
+  read -r -p "Nhập git repo URL: " repo
+
+  name=$(basename "$repo" .git)
+
+  git clone "$repo" "$PROJECTS_DIR/$name"
+
+  cd "$PROJECTS_DIR/$name" || exit 1
+  echo "Đã clone và vào project: $name"
+
+  exec "${SHELL:-bash}" -lc 'mb-start; exec "${SHELL:-bash}"'
+else
+  echo "❌ Lựa chọn không hợp lệ"
+  exit 1
+fi

package/mb-tools/mb-home

@@ -0,0 +1,9 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKSPACE="${MB_WORKSPACE_HOME:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+
+cd "$WORKSPACE"
+echo "🏠 Về workspace: $WORKSPACE"
+exec "${SHELL:-bash}"

package/mb-tools/mb-list

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+set -e
+
+SUBMITTED_FILE="${MB_WORKSPACE_HOME:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}/.projects/.mb_submitted"
+mkdir -p "$(dirname "$SUBMITTED_FILE")"
+touch "$SUBMITTED_FILE"
+
+CURRENT=$(git branch --show-current)
+
+echo "=== TASK LIST ==="
+
+git branch --format='%(refname:short)' | grep -vE '^(master|main)$' | while IFS= read -r branch; do
+  MARK=""
+  if grep -Fxq "$branch" "$SUBMITTED_FILE"; then
+    MARK="(submitted)"
+  fi
+
+  if [ "$branch" = "$CURRENT" ]; then
+    echo "* $branch $MARK (đang làm)"
+  else
+    echo "  $branch $MARK"
+  fi
+done

package/mb-tools/mb-save

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -e
+
+MSG=${1:-}
+
+if [ -z "$MSG" ]; then
+  echo "❌ Nhập message commit"
+  exit 1
+fi
+
+git add .
+git commit -m "$MSG"
+
+BRANCH=$(git branch --show-current)
+
+git push origin "$BRANCH"
+
+echo "💾 Đã lưu: $MSG"

package/mb-tools/mb-start

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+
+BRANCH=$(git branch --show-current)
+
+echo "=== MB START ==="
+echo "Branch hiện tại: $BRANCH"
+
+if ! git diff --quiet || ! git diff --cached --quiet; then
+  echo "⚠️ Bạn đang có thay đổi chưa commit"
+else
+  echo "✅ Working tree sạch"
+fi

package/mb-tools/mb-submit

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -e
+
+BRANCH=$(git branch --show-current)
+WORKSPACE="${MB_WORKSPACE_HOME:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+SUBMITTED_FILE="$WORKSPACE/.projects/.mb_submitted"
+
+mkdir -p "$(dirname "$SUBMITTED_FILE")"
+touch "$SUBMITTED_FILE"
+
+git push origin "$BRANCH"
+
+grep -Fxq "$BRANCH" "$SUBMITTED_FILE" || echo "$BRANCH" >> "$SUBMITTED_FILE"
+
+echo "🚀 Đã push branch: $BRANCH"
+echo "👉 Tạo Merge Request tại GitLab/GitHub: origin/$BRANCH → master hoặc main"

package/mb-tools/mb-task

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -e
+
+TASK=${1:-}
+
+if [ -z "$TASK" ]; then
+  echo "❌ Thiếu tên task"
+  exit 1
+fi
+
+if ! git diff --quiet || ! git diff --cached --quiet; then
+  echo "⚠️ Bạn có thay đổi chưa commit. Hãy mb-save trước."
+  exit 1
+fi
+
+git fetch
+
+if git show-ref --verify --quiet "refs/heads/$TASK"; then
+  git checkout "$TASK"
+else
+  git checkout -b "$TASK"
+fi
+
+echo "🚀 Đang làm task: $TASK"

package/mb-tools/mb-ui

@@ -0,0 +1,78 @@
+#!/usr/bin/env bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKSPACE="${MB_WORKSPACE_HOME:-$(cd "$SCRIPT_DIR/.." && pwd)}"
+PROJECTS_DIR="$WORKSPACE/projects"
+SUBMITTED_FILE="$WORKSPACE/.projects/.mb_submitted"
+
+mkdir -p "$PROJECTS_DIR" "$(dirname "$SUBMITTED_FILE")"
+touch "$SUBMITTED_FILE"
+
+GREEN="\033[1;32m"
+YELLOW="\033[1;33m"
+GRAY="\033[0;37m"
+CYAN="\033[1;36m"
+RESET="\033[0m"
+
+echo -e "${CYAN}┌──────────── MB WORKSPACE ────────────┐${RESET}"
+mapfile -t projects < <(find "$PROJECTS_DIR" -mindepth 1 -maxdepth 1 -type d -printf '%f\n' | sort)
+for i in "${!projects[@]}"; do
+    echo -e "│  [${i}] ${projects[$i]}"
+done
+echo -e "│  [C] Clone project mới"
+echo -e "│  [Q] Thoát"
+echo -e "${CYAN}└──────────────────────────────────────┘${RESET}"
+read -r -p "Chọn project hoặc clone: " choice
+
+if [[ "$choice" == "C" || "$choice" == "c" ]]; then
+    read -r -p "Nhập URL repo: " repo
+    name=$(basename "$repo" .git)
+    git clone "$repo" "$PROJECTS_DIR/$name"
+    cd "$PROJECTS_DIR/$name" || exit 1
+    echo "Đã clone và vào project: $name"
+elif [[ "$choice" == "Q" || "$choice" == "q" ]]; then
+    exit 0
+elif [[ "$choice" =~ ^[0-9]+$ ]] && [ "$choice" -lt "${#projects[@]}" ]; then
+    project=${projects[$choice]}
+    cd "$PROJECTS_DIR/$project" || exit 1
+    echo "Đã chọn project: $project"
+else
+    echo "❌ Lựa chọn không hợp lệ"
+    exit 1
+fi
+
+echo -e "\n${CYAN}┌────────── TASK MENU ──────────┐${RESET}"
+CURRENT=$(git branch --show-current)
+mapfile -t branches < <(git branch --format='%(refname:short)' | grep -vE '^(master|main)$')
+
+for i in "${!branches[@]}"; do
+    task=${branches[$i]}
+    status="Pending"
+    if [ "$task" = "$CURRENT" ]; then status="Doing"; fi
+    if grep -Fxq "$task" "$SUBMITTED_FILE"; then status="Submitted"; fi
+
+    color=$GRAY
+    if [ "$status" = "Doing" ]; then color=$GREEN; fi
+    if [ "$status" = "Pending" ]; then color=$YELLOW; fi
+
+    echo -e "│  [${i}] $task (${color}${status}${RESET})"
+done
+echo -e "│  [N] Tạo task mới"
+echo -e "│  [Q] Thoát"
+echo -e "${CYAN}└──────────────────────────────┘${RESET}"
+
+read -r -p "Chọn task: " task_choice
+if [[ "$task_choice" =~ ^[0-9]+$ ]] && [ "$task_choice" -lt "${#branches[@]}" ]; then
+    git checkout "${branches[$task_choice]}"
+    echo "Đang làm task: ${branches[$task_choice]}"
+elif [[ "$task_choice" == "N" || "$task_choice" == "n" ]]; then
+    read -r -p "Nhập tên task mới: " new_task
+    git checkout -b "$new_task"
+    echo "Tạo và chuyển sang task: $new_task"
+elif [[ "$task_choice" == "Q" || "$task_choice" == "q" ]]; then
+    exit 0
+else
+    echo "❌ Lựa chọn không hợp lệ"
+    exit 1
+fi

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "mb-workspace",
+  "version": "1.0.0",
+  "description": "One-command installer for MB Workspace",
+  "bin": {
+    "mb-workspace": "bin/mb-workspace.js"
+  },
+  "files": [
+    "bin",
+    "install.sh",
+    "install.ps1",
+    "mb-tools",
+    "README.md",
+    ".gitignore"
+  ],
+  "keywords": [
+    "workspace",
+    "designer",
+    "cli",
+    "installer"
+  ],
+  "license": "MIT"
+}