open-index/open-npm huggingface dataset:
npm package: @sigaostudios/bootstrap
Description: Bootstrap installer for Sigao AI DevKit - handles authentication and setup automatically
Author: Sigao Studios
Latest version: 1.1.4

# @sigaostudios/bootstrap

🚀 **One-command bootstrap for Sigao AI DevKit on fresh systems**

This package handles all the prerequisites and authentication needed to run the Sigao CLI on a fresh Linux/WSL system.

## What it does

1. ✅ Installs Node.js (if not present)
2. ✅ Installs GitHub CLI (if not present)
3. ✅ Authenticates with GitHub (with read:packages scope)
4. ✅ Configures npm to access @sigaostudios packages
5. ✅ Launches the Sigao CLI installer

## Usage

On a fresh WSL/Linux system, just run:

```bash
npx @sigaostudios/bootstrap
```

### ⚠️ WSL Users with PATH Issues

If you see "CMD.EXE was started" or "apt-get is not recognized", you have Windows npm in your PATH. Use this instead:

```bash
# First ensure Linux npm is installed
sudo apt update && sudo apt install -y npm

# Then run with Linux npx explicitly
/usr/bin/npx @sigaostudios/bootstrap
```

That's it! No need to worry about tokens, authentication, or prerequisites.

## Requirements

- Linux or WSL (Windows Subsystem for Linux)
- sudo access (for installing system packages)
- Internet connection

## What happens during bootstrap

1. **Prerequisites Check**: The bootstrap will check for Node.js and GitHub CLI, installing them if needed.

2. **GitHub Authentication**: You'll be prompted to authenticate with GitHub (if not already authenticated). This is done through the GitHub CLI's interactive auth flow.

3. **npm Configuration**: The bootstrap automatically configures npm to access the private @sigaostudios packages using your GitHub token.

4. **Sigao CLI Launch**: Finally, it launches the main Sigao CLI installer.

## For WSL Users

Make sure you're running this inside WSL, not in Windows Command Prompt or PowerShell.

**Common Issue**: If Windows paths are in your PATH before Linux paths (often from fnm, nvm-windows, or other Windows Node managers), you'll need to use `/usr/bin/npx` instead of just `npx` to ensure Linux tools are used.

## Troubleshooting

If you encounter issues:

1. **sudo password**: You'll need to enter your sudo password to install system packages
2. **GitHub auth**: Make sure to complete the GitHub authentication flow when prompted
3. **Network issues**: Ensure you have a stable internet connection

## Development

This package is part of the [Sigao AI DevKit](https://github.com/sigaostudios/sigao-ai-devkit) monorepo.

## License

MIT
npm package: @sigaostudios/sigao-provision
Description: Environment provisioning tool for setting up development environments with various tools and configurations
Author: Sigao Studios
Latest version: 1.0.9

# Sigao Provision

Environment provisioning tool extracted from sigao-cli. This standalone tool provides a modular system for setting up development environments with various tools and configurations.

## Installation

```bash
npm install -g sigao-provision
```

Or run directly with npx:

```bash
npx sigao-provision
```

## Usage

### Interactive Mode

Run without arguments to interactively select modules to install:

```bash
sigao-provision install
```

### Install Specific Modules

```bash
sigao-provision install node docker python
```

### Install All Modules

```bash
sigao-provision install --all
```

### List Available Modules

```bash
sigao-provision install --list
```

### Check Installed Modules

```bash
sigao-provision check
```

### Dry Run Mode

Preview what would be installed without making changes:

```bash
sigao-provision install --dry-run
```

## Available Modules

### Core Tools
- **shell** - Shell configuration (bash/zsh)
- **essentials** - Essential tools (git, gh, ripgrep, curl, wget)
- **git-enhanced** - Git configuration and SSH setup

### Development Environments
- **node** - Node.js via NVM
- **python** - Python via pyenv
- **python-tools** - Python development tools (black, ruff, mypy, pytest)
- **dotnet** - .NET SDK
- **docker** - Docker and Docker Compose
- **cargo** - Rust toolchain

### CLI Tools
- **cli-tools** - Modern CLI tools (bat, eza, fd, fzf, htop, etc.)
- **shell-enhancements** - Starship prompt and custom aliases
- **direnv** - Directory-based environment management
- **claude** - Claude Code CLI
- **azure-cli** - Azure CLI

## Module Dependencies

The tool automatically handles module dependencies. For example:
- `git-enhanced` depends on `git` (from essentials)
- `python-tools` depends on `python`
- Most modules benefit from having `shell` configured first

## Platform Support

- Ubuntu/Debian (apt)
- macOS (brew)
- Fedora/RHEL (dnf)
- Arch Linux (pacman)
- WSL (Windows Subsystem for Linux)

## Features

- **Modular Architecture**: Each tool is a separate module that can be installed independently
- **Dependency Resolution**: Automatically installs required dependencies
- **Cross-Platform**: Works on Linux, macOS, and WSL
- **Idempotent**: Safe to run multiple times
- **Progress Indicators**: Visual feedback during installation
- **Dry Run Mode**: Preview changes before applying
- **Configuration Collection**: Collects user preferences upfront

## Development

```bash
# Clone the repository
git clone <repository-url>
cd sigao-provision

# Install dependencies
npm install

# Run locally
npm start

# Run with custom command
node src/index.js install --list
```

## Architecture

- **BaseInstaller**: Base class for all installers
- **Module Registry**: Dynamic module loading system
- **Platform Detection**: Automatic OS and package manager detection
- **Shell Utilities**: Cross-platform command execution
- **Logger**: Colored console output with levels

## License

MIT
npm package: @sigauth/core
Description: SigAuth Integrations Core for lifting authentication and authorization
Author: Ben Hacker
Latest version: 0.1.4

# @sigauth/core

The core library for SigAuth integrations, providing the fundamental logic for authentication, authorization, and permission management. This package is used by framework-specific integrations like `@sigauth/express` and `@sigauth/nest`.

## Features

- **JWT Verification**: Validates access tokens and handles token refreshing using `jose`.
- **Permission Building**: A fluent API for constructing standardized permission strings.
- **OIDC Integration**: Core logic for handling OIDC authentication flows.

## Usage

### PermissionBuilder

Helper class to construct permission strings in the format `ident:assetId:appId:containerId`.

```typescript
import { PermissionBuilder } from '@sigauth/core';

const permission = new PermissionBuilder('read', 123) // ident, appId
    .withAssetId(456)
    .withContainerId(789)
    .build();

// Output: "read:456:123:789"
```

### SigauthVerifier

The main class for handling authentication logic.

```typescript
import { SigauthVerifier } from '@sigauth/core';

const verifier = new SigauthVerifier({
    authUrl: 'https://auth.example.com',
    clientId: 'your-client-id',
    // ... other options
});

// Verify a request
const result = await verifier.verify(req);
```
npm package: @sigauth/express
Description: SigAuth Express Integration for lifting authentication and authorization
Author: Ben Hacker
Latest version: 0.1.2

# @sigauth/express

Express middleware integration for SigAuth, enabling easy authentication and authorization in your Express applications.

## Installation

```bash
pnpm add @sigauth/express
```

## Usage

Register the middleware in your Express application.

```typescript
import express from 'express';
import { sigauthExpress } from '@sigauth/express';

const app = express();

app.use(
    sigauthExpress({
        authUrl: 'https://auth.example.com',
        clientId: 'your-client-id',
        authenticateRoutes: ['/protected/*'],
        // ... other options
    }),
);

app.get('/protected/resource', (req, res) => {
    // Access user information
    console.log(req.user);
    res.send(`Hello, ${req.user.sub}`);
});

app.listen(3000);
```

## Features

- **Automatic Authentication**: Intercepts requests to protected routes and redirects to the auth provider if necessary.
- **Token Management**: Handles access and refresh tokens via cookies.
- **Request Augmentation**: Adds `req.user` and `req.sigauth` to the Express request object for easy access to user data and verifier methods.
- **OIDC Callback Handling**: Automatically handles the OIDC callback route (`/sigauth/oidc/auth`).