TL;DR

# Install Ninja
git clone https://github.com/tunafysh/ninja.git
cd ninja && cargo build --release
sudo cp target/release/shurikenctl /usr/local/bin/

# Install a service
shurikenctl install service.shuriken

# Configure and start
shurikenctl configure service-name
shurikenctl start service-name

~/.ninja/
├── shurikens/{name}/      # Installed services
│   ├── .ninja/
│   │   ├── manifest.toml  # Service definition
│   │   ├── options.toml   # User config
│   │   ├── config.tmpl    # Template
│   │   └── manage.ns      # Management script
│   └── [service files]
└── blacksmith/            # Built packages

[shuriken]
name = "my-service"
id = "com.example.service"
version = "1.0.0"
type = "daemon"

[shuriken.management]
type = "script"
script-path = "manage.ns"

[config]
config-path = "server.conf"

[logs]
log-path = "logs/service.log"

function start()
    local result = proc.spawn("bin/server")
    fs.write(".ninja/service.pid", tostring(result.pid))
end

function stop()
    local pid = fs.read(".ninja/service.pid")
    proc.kill_pid(tonumber(pid))
    fs.remove(".ninja/service.pid")
end

[server]
host = {{ host }}
port = {{ port }}
root = {{ root }}

host = "localhost"
port = 8080

shurikenctl configure service-name

[MAGIC: "HSRZEG"]
[metadata_length: u16]
[metadata: CBOR]
[archive_length: u32]
[archive: tar.gz]
[signature: SHA-256]

# List services
shurikenctl list

# Start/stop
shurikenctl start {name}
shurikenctl stop {name}

# Configure
shurikenctl configure {name}

# Build package
shurikenctl forge

# Run script
shurikenctl run script.ns

# Start API server
shurikenctl api --port 8080

-- Filesystem
fs.read(path)
fs.write(path, content)
fs.exists(path)
fs.create_dir(path)

-- Process
proc.spawn(command)
proc.kill_pid(pid)

-- Shell
shell.exec(command)

-- Environment
env.os          -- "linux", "windows", "macos"
env.get(key)

-- Time
time.sleep(seconds)
time.now(format)

-- Logging
log.info(message)
log.error(message)

# Select and manage
select myapp
start
stop
configure

# Configuration
set port 8080
toggle debug
configure {
  host = "localhost"
  port = 8080
}

# Scripts
execute script.ns

GET    /api/shurikens              # List all
GET    /api/shurikens/states       # Get states
POST   /api/shurikens/{name}/start # Start
POST   /api/shurikens/{name}/stop  # Stop

# Service won't start
cat ~/.ninja/shurikens/{name}/.ninja/shuriken.lck
tail -f ~/.ninja/shurikens/{name}/logs/service.log

# Stale lock file (CAREFUL!)
ps aux | grep {name}
shurikenctl lockpick {name}

# Configuration issues
shurikenctl configure {name}
cat ~/.ninja/shurikens/{name}/{config-path}