pmat 3.18.1

PMAT - Zero-config AI context generation and code quality toolkit (CLI, MCP, HTTP)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

# Scripts Directory

This directory contains utility scripts for the MCP Agent Toolkit project.

## Installation

pmat is installed from crates.io — this is the single supported install method:

```bash
# Latest
cargo install pmat

# Specific version
cargo install pmat --version 3.18.1
```

## Testing

The installation scripts have comprehensive test coverage:

### Unit Tests (`install.test.ts`)

- Platform detection logic
- URL construction
- Version handling
- Error cases

### Integration Tests (`install.integration.test.ts`)

- Verifies GitHub releases exist
- Checks asset naming conventions
- Tests download URLs are accessible

Run tests with:

```bash
make test-scripts
```

## Platform Support

Both installers support the following Rust target triples:

- `x86_64-unknown-linux-gnu` (Linux x64)
- `aarch64-unknown-linux-gnu` (Linux ARM64)
- `x86_64-apple-darwin` (macOS Intel)
- `aarch64-apple-darwin` (macOS Apple Silicon)
- `x86_64-pc-windows-msvc` (Windows x64)

## Available Scripts

### mcp-install.ts

Installation and management script for the MCP server that provides smart
rebuild detection and idempotent installation.

**Usage:**

```bash
./scripts/mcp-install.ts              # Smart install (rebuilds only if source changed)
./scripts/mcp-install.ts --status     # Check installation and build status
./scripts/mcp-install.ts --check      # Check if rebuild is needed
./scripts/mcp-install.ts --reinstall  # Force complete reinstall
./scripts/mcp-install.ts --help       # Show help
```

**Note:** The standard `make install` command is now idempotent and will
automatically remove any existing installation before installing the new
version.

### validate-docs.ts

Validates documentation consistency and naming conventions across the project.

**Usage:**

```bash
./scripts/validate-docs.ts  # Run validation
# Or via make:
make validate-docs
```

### validate-github-actions-status.ts

Checks the status of GitHub Actions workflows and provides detailed failure
analysis.

**Usage:**

```bash
./scripts/validate-github-actions-status.ts  # Check CI status
# Or via make:
make ci-status

# With GitHub token for higher rate limits:
GITHUB_TOKEN=your_token make ci-status
```

**Features:**

- Shows latest workflow run status for each workflow
- Provides detailed failure analysis for failed jobs
- Lists specific steps that failed
- Offers common fixes for typical failures
- Exits with non-zero code if any workflows are failing

## Installation Methods

The MCP server can be installed/reinstalled in several ways:

1. **Standard Installation (Recommended)**
   ```bash
   make install  # Idempotent - removes old version first
   ```

2. **Full Reinstall with Script**
   ```bash
   ./scripts/mcp-reinstall.ts
   ```

3. **Manual Uninstall/Install**
   ```bash
   make uninstall
   make install
   ```

All methods ensure a clean installation by removing any existing versions first.