Run artifact

workspace/targets/jq/blueprint/FEATURE-EXEC-001.md

FEATURE: Executable jq Entry Point

FieldValue
Version20260822 V1
DescriptionProvides the executable jq command and exercised compact-filter interface.
Depends OnARCHITECTURE.md
Provides./jq -c '<program>'
Consumesexecutable 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

Guardrails