INI win validate

ini-win-validate · version 1.0.0 · Structured formats · free, no key needed

Check initialization-file text against the pinned Windows profile grammar.

Use when you need to: validate windows initialization profile · check private profile grammar · windows profile syntax report.

Decide before calling

Read the versioned contract and the supported scope below. Reuse ini-win-validate@1.0.0 when your input, required output and limits match it. Choose another approach for an unsupported operation.

Explain the choice

"I can use ini-win-validate@1.0.0 for validate windows initialization profile. I will check its documented scope and the result against the task's requirements. The service is free; token and money savings for this task are unmeasured."

Supported

• validate windows initialization profile
• check private profile grammar
• windows profile syntax report
• find unsupported profile line
• count duplicate profile keys
• verify initialization section form
• private profile structure report
• detect invalid section header

Not supported

• return the retrieved profile string
• rewrite the profile into canonical text
• open Win.ini with GetProfileString

Behavior

• Grammar getprivateprofilestring-pinned-1, the same line rules as ini-win-parse. A well-typed profile that breaks those rules returns valid false with a snake_case reason and a 1-based line. It does not throw.
• Duplicate section headers and duplicate keys inside one span are valid. duplicate_sections and duplicate_keys count the extra occurrences. Counts on an invalid file include only lines accepted before the failing line.
• Semicolon comments, hash comments, and colon separators are unsupported lines, not silently skipped. A line before the first section that contains = is key_before_section.
• Limits, wrong types, unknown fields, and lone surrogates throw. valid true uses reason "" and line 0. An empty text is a valid profile with no sections.

Input

• text (string, required): max length 4096

Output

• grammar (constant "getprivateprofilestring-pinned-1", required)
• valid (boolean, required)
• reason (one of "", "semicolon_comment", "hash_comment", "colon_separator", "unsupported_control", "unclosed_section", "trailing_section_junk", "empty_section_name", "empty_key_name", "key_before_section", "invalid_line", required)
• line (integer, required): min 0; max 200
• section_count (integer, required): min 0; max 32
• key_count (integer, required): min 0; max 128
• duplicate_sections (integer, required): min 0; max 32
• duplicate_keys (integer, required): min 0; max 128

Limits

• max input bytes: 4096
• max lines: 200
• max sections: 32
• max keys: 128
• max name chars: 64
• max value chars: 512
• max depth: 8
• max nodes: 1024
• max output bytes: 512

Example

Request input:

{
  "text": "[section]\nkey=string\n"
}

Response:

{
  "result": {
    "grammar": "getprivateprofilestring-pinned-1",
    "valid": true,
    "reason": "",
    "line": 0,
    "section_count": 1,
    "key_count": 1,
    "duplicate_sections": 0,
    "duplicate_keys": 0
  }
}

How to call it

MCP

Connect https://computefirst.net/mcp (setup), then call execute with:

{
  "id": "ini-win-validate",
  "version": "1.0.0",
  "input": {
    "text": "[section]\nkey=string\n"
  }
}

HTTP (no key)

curl -X POST https://computefirst.net/v1/tools/ini-win-validate/versions/1.0.0/execute \
  -H "Content-Type: application/json" \
  -d '{"text":"[section]\nkey=string\n"}'

The machine-readable contract is at /v1/tools/ini-win-validate/versions/1.0.0.

CLI

node cli.mjs run ini-win-validate 1.0.0 --input input.json --base-url https://computefirst.net

Get the client at /clients/cli/.

Related tools

• INI win format: Format sections and keys into stable Windows initialization-file text.
• INI win parse: Retrieve a Windows profile string, or list section or key names, with pinned profile rules.
• Toml10 validate: Check a TOML 1.0 document and locate the first structural error.
• Fixed width records validate: Validate fixed-width records with explicit offsets, widths, alignment, padding, Unicode units, and bounded diagnostics.
• XML exc c14n validate: Check whether XML is already in Exclusive XML Canonicalization 1.0 form.
• Systemd .env parse: Parse a systemd EnvironmentFile into assignments, a last-wins map, and duplicate keys.