FEATURE: Executable jq Entry Point
| Field | Value |
|---|---|
| Version | 20260822 V1 |
| Description | Provides the executable jq command and exercised compact-filter interface. |
| Depends On | ARCHITECTURE.md |
| Provides | ./jq -c '<program>' |
| Consumes | executable boundary |
Intent
Provide an executable named jq at the application root. The command accepts the exercised -c option and a jq filter program, then evaluates that program against JSON supplied on standard input.
Interface
./jq -c '<program>'
stdin: JSON value(s)
stdout: one compact JSON value per generated output line
The executable must be runnable directly and must not require package installation or external runtime dependencies.
Programmatic Acceptance
=== AC exec-entry-conformance ===
Intent: The executable entry point passes the corpus slice containing the primitive interface programs.
import json import os import subprocess import sys
select = r"^(true|false|null|1)$" result = subprocess.run( [sys.executable, "sources/run_conformance.py", "--select", select, "--json"], capture_output=True, text=True, env={**os.environ, "JQ": f"{os.getcwd()}/jq"}, ) print(result.stdout) print(result.stderr, file=sys.stderr) report = json.loads(result.stdout) summary = report["summary"] assert sum(summary.values()) > 0 assert summary["fail"] == 0 assert summary["error"] == 0 assert result.returncode == 0 === END AC exec-entry-conformance ===
=== AC exec-is-runnable ===
Intent: The deliverable is directly executable at the application root.
import os import stat
mode = os.stat("jq").st_mode assert stat.S_ISREG(mode) assert mode & stat.S_IXUSR === END AC exec-is-runnable ===
User Acceptance
- None.
Guardrails
- The executable is named exactly
jq. -cis the only required command-line option.- Do not add a wrapper around another jq executable.