Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,8 @@ the engine live in the [engine repository](https://github.com/andreibesleaga/age

Run from the repository root, with the engine checked out beside it at
`../agentic-system-core` and Node 22.13 or later (without them the equivalence tests are
skipped):
skipped). To compare with another engine checkout, set `AGSC_ENGINE_DIR` to its path
([docs/MAINTAINING.md](docs/MAINTAINING.md), "The equivalence proof"):

```bash
python -m venv .venv && .venv/bin/pip install -e ".[test]"
Expand All @@ -38,8 +39,9 @@ Tests are deterministic: fixed data, no clock, no network. Write the failing tes
## What you may change, and what you may not

- **Do not edit** the vector copies under `tests/fixtures/vectors/`; copy them again from
the engine. Do not type `src/agentic_system_core/data/spec-index.json`; derive it with
the command in [docs/MAINTAINING.md](docs/MAINTAINING.md).
the engine. Do not type `src/agentic_system_core/data/spec-index.json` or
`src/agentic_system_core/data/context.jsonld`; derive them with the commands in
[docs/MAINTAINING.md](docs/MAINTAINING.md).
- **A rule, a vector or the engine is wrong:** propose the change in the engine
repository; this package follows in its next release.
- **Do not add a runtime dependency.** `pyproject.toml` has `dependencies = []` and the
Expand Down
57 changes: 57 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,64 @@ differently (SemVer's `1.1.0-rc.1` is `1.1.0rc1` here).

## [Unreleased]

## [1.1.0] - 2026-11-13

The package of specification `1.1.0`: the specification version and the package version move together (README, "Version").

- Changed: the package version and `SPEC_VERSION` are `1.1.0`; `agsc --version` prints `agsc 1.1.0 (Python package; specification 1.1.0)` (AGSC-00-14, AGSC-09-11). The vector copies carry the specification version the release edits in place (AGSC-00-16): `options.spec_version` of every case, and the implementation's version in the expected output of `cli-0002` and `build-0025`. `data/spec-index.json` is regenerated from the specification of 1.1.0 and names it.
- Changed: `links.link_warnings` reports AGSC-E315 for a `related` that joins a cluster, at either end, at parity with the engine (AGSC-03-25 and AGSC-05-20; the copy of `links-0020`); `data/relations.json` carries the cell of `related`, and the AGSC-10-15 table names `lint-0065`.
- Docs: the README links the "Ideas after 1.1" of the engine's roadmap; the readings and the ten questions above trace to the engine's 1.1 EARS row PRD-074, written since.
- Changed: the 1.1 errata of 2026-11-10, at parity with the engine. The Dataset block of the home page is the node `@id` = the Bundle IRI and names one creator `Person` by `@id`, and `catalog_block` writes the opt-in DCAT 3 catalogue block of `discovery.dcat` (AGSC-06-41; `disc-0037`, the successor of the withdrawn `disc-0027`). The agent card carries a responder's `securitySchemes` and `securityRequirements`, a `credential` responder without them is the warning AGSC-E210, and `served_declarations` leaves out an `a2a-card` that gets no card (AGSC-06-34, AGSC-11-16; `disc-0035`, `disc-0038`). The checker refuses a `webmcp` surface version that is not a `YYYY-MM-DD` date with AGSC-E210 (AGSC-11-16; `disc-0036`). `HIGHER_LEVEL_CASES` gains `disc-0035` to `disc-0038` and `lint-0063` (AGSC-10-15 as amended). The vector copies are refreshed. README: the second known difference, the card's security members.
- Docs: README, `docs/MAINTAINING.md` corrected and extended (tests, CI jobs, release steps); `AGENTS.md` and `docs/ARCHITECTURE.md` added.
- Added: `graph.to_jsonld` and `graph.restrict_to` write `graph.jsonld` and the per-item `/pages/<slug>.jsonld` files (AGSC-05-09, AGSC-06-02) from the same triples as `graph.nq`, as the engine's `src/knowledge/jsonld.js` does; `run-vectors` now runs `graph-0028`.
- Added: `data/context.jsonld`, the published context (AGSC-06-32) as the engine's `tools/gen-ns` derives it, read by `context.published()`; the suite fails when it drifts from the engine's.
- Added: `areas/build_tree.py` checks the files a whole build wrote against `build-0020` to `build-0028` (AGSC-00-05, AGSC-01-19, AGSC-01-20, AGSC-05-07, AGSC-06-01, AGSC-06-18, AGSC-07-19, AGSC-07-20), member for member as the engine's handler does; the suite runs it over the engine's build of each case. `run-vectors` still reports them as not run (README, "What runs here").
- Changed: the source distribution ships `SECURITY.md` and `data/context.jsonld`.
- Tests: the environment variable `AGSC_ENGINE_DIR` names the engine checkout the suite compares with; unset, it is `../agentic-system-core` as before.
- Tests: two fitness functions: the package imports only the standard library, and only `cli.py` starts a process.
- Changed: the vector copies under `tests/fixtures/vectors/` are the 1.1 engine's seven areas (156 files; `disc-0013`, `disc-0014`, `disc-0019` and `build-0024` are withdrawn there), and the drift test also fails when a file is missing or extra (AGSC-09-04; EARS row PRD-010).
- Changed: `data/spec-index.json` is regenerated from the 1.1 specification: 385 rules and 105 registered codes, among them AGSC-E005, AGSC-E313 to E317, AGSC-E417 to E423 and AGSC-E512 (AGSC-09-15; PRD-010); the declared version stays the one constant `SPEC_VERSION`.
- Changed: `HIGHER_LEVEL_CASES` is the AGSC-10-15 table as amended for 1.1.0 (72 cases; PRD-010).
- Added: `relations.py` and `data/relations.json`, the relation table of AGSC-03-01 as the engine's `src/knowledge/relations.js` holds it; `links.py` and `graph.py` read their key lists, inverses and RDF properties from it instead of their own copies (AGSC-03-01, AGSC-05-16; PRD-002).
- Added: `links.link_warnings`, the warnings AGSC-E313 (a self-link, AGSC-03-23), AGSC-E314 (two relations a pair cannot both hold, AGSC-03-24), AGSC-E315 (a target of an unexpected kind, AGSC-03-25) and AGSC-E316 (superseding a stable item, AGSC-03-26); `run-vectors` passes `links-0010` to `links-0017` (PRD-003).
- Added: `derive.readings`, the readings of the Link graph with their reasons (AGSC-05-33, `graph-0029`), as the engine's `src/knowledge/derive.js` gives them (PRD-023; the 1.1 EARS row comes with the engine's B12 requirements pass).
- Added: `questions.answer`, the ten questions of AGSC-05-34 (`graph-0030` to `graph-0039`), as the engine's `src/knowledge/questions.js` answers them (PRD-023; 1.1 EARS row as above).
- Added: `skos.skos_view` and `skos.scheme_record`, the SKOS view `export --skos` writes, byte for byte (AGSC-05-36, `graph-0040`; PRD-060); `rdf.turtle` takes the prefix block it writes.
- Added: a frontmatter nested deeper than 64 levels is the warning AGSC-E105 and is still read (AGSC-02-02 as amended for 1.1, `fm-0021`, `fm-0026`; PRD-003); `yamlsubset.depth` counts block nesting.
- Changed: `/llms.txt` and `/llms-full.txt` follow the 1.1 layout: the blockquote straight after the H1, then the provenance comment, the backslash, `[`, `]` and `(` of a link line escaped, and no `bundle_version` line on a restricted node (AGSC-06-13a as amended for 1.1, AGSC-11-20; `disc-0024`, `disc-0025`, `disc-0034`; PRD-060).
- Added: `site.security_txt(..., policy=)` writes the declared disclosure page as `Policy` (AGSC-06-36 as amended for 1.1, `build-0035`; PRD-047), and `site.now_line(..., visibility=)` gives a restricted node's line without the content version and the fingerprint (AGSC-06-22 with AGSC-11-20, `build-0036`; PRD-010).
- Changed: `run-vectors` reports as not run, each with its reason, the cases it cannot run: `build-0031` and `build-0032` (it writes no HTML), `build-0037` (it has no chunk writer), and the domain-layer cases `fm-0022` to `fm-0025`, `fm-0027`, `graph-0042`, `graph-0044` to `graph-0046`, `links-0018`, `links-0019` ("domain layer: engine only in 1.1") (AGSC-09-02; PRD-010).
- Changed: `bundle-0018` and `bundle-0019` (the `.diagram` grammar, AGSC-01-42) are reported not run with the reason "needs the diagram compiler (Level 3)"; the `bundle` area keeps its own reason (PRD-010).
- Tests: `test_link_parity.py` compares the Link warnings, the readings and the ten answers with the engine's on 120 seeded generated graphs; a fitness function keeps one source for the relation table.
- Added: `validate-wellknown` requires, at Level 2 and above, the `digest`, `agsc-chunk-count` and `agsc-chunk-set` of the chunks surface link of a document of 1.1.0 or later (AGSC-E202) and recomputes the count and the set commitment over the chunk lines read, a sharded file's shards included (AGSC-E201), as the engine's `requireChunkFacts` and `recomputeChunkFacts` do (AGSC-06-44, AGSC-09-93 (b); `disc-0033`; PRD-061, PRD-024).
- Added: `validate-wellknown` compares an `agsc-ledger-length` with the entries of the ledger read, from a file at every Level and from a URL at Level 2 and above (AGSC-E201; AGSC-06-44, AGSC-09-93 (c); the engine's `checkLedgerLength`; PRD-024).
- Added: `validate-wellknown` resolves an `a2a-card` declared on the node's own origin and warns AGSC-E210 when the node serves no card there; a card on another origin is not read (AGSC-11-16, AGSC-11-17, decision D-15; the engine's `checkCardTarget`; PRD-024).
- Added: given a URL, `validate-wellknown` reads the `Link` header of the node's home page and warns AGSC-E202 when it carries no `describedby` link to the discovery document (AGSC-06-25, AGSC-06-40, I-104; the engine's `homeLinkFindings`; `disc-0026` validator cases; PRD-020).
- Added: `validate-wellknown --max-requests <1..2000>` (default 500): every request of a run, its peer and its redirects included, counts against one budget, and the request past it is AGSC-E906 (AGSC-11-06, AGSC-11-10(c), I-083; the engine's `--max-requests`; PRD-024). An injected fetcher keeps its call `fetcher(url, dev, cap=n)`; the budget is spent once per call.
- Changed: the `chunks` surface of a restricted node (`agsc-access` `credential`) is not read by `validate-wellknown`, as it is not served unauthenticated (AGSC-11-20); an E906 while reading a surface target stays AGSC-E906 (the engine's `checkSurface`; PRD-024).
- Changed: `validate-wellknown` accepts `immutable` on a versioned copy under `/ns/<x.y.z>/` (AGSC-06-06, AGSC-11-05; `build-0034`; PRD-020), and knows the 1.1 attributes `agsc-chunk-count`, `agsc-chunk-set` and `agsc-ledger-length` (AGSC-06-44), so a newer document gets no AGSC-E506 for them.
- Changed: a response header sent on several lines is read as one value joined with ", ", as Node gives it to the engine's checker, so a split `Link` field is read whole (RFC 9110 section 5.3; PRD-024).
- Added: `signposting.home_links`, `signposting.license_url` and `signposting.dataset_block`: the FAIR Signposting links of `/` (AGSC-06-40, `disc-0026`), the licence URL (AGSC-06-44) and the home page's Dataset block with licence, creator, free access, downloads and the two PROV-O terms (AGSC-06-19, AGSC-06-41, `disc-0027`), as the engine's `headers.homeLinks` and `front-page.datasetBlock` give them (PRD-020).
- Added: `catalogue.catalogue_files`, the opt-in `/.well-known/ard.json` and `/.well-known/ai-catalog.json` with the SHA-256 of the exact bytes of each entry's target, `urn:air` identifiers and the domain-name rule (AGSC-E209, AGSC-E202 without `bundle.id`) (AGSC-06-42; `disc-0028`, `disc-0029`; the engine's `ai-catalog.js`; PRD-024).
- Added: `agentcard.card_bytes` and `agentcard.card_findings`, the A2A 1.0 agent card of a node that declares `a2a-card` and a responder, with the A2A-only rule: no card, and the warning AGSC-E210, when a responder is not `a2a:` or the `a2a-card` version is not a bare A2A version; a card without a responder is the error AGSC-E210 (AGSC-06-07, AGSC-06-34, AGSC-11-21; `disc-0030`, `disc-0031`; the engine's `a2a-card.ts`; PRD-024).
- Changed: `run-vectors` reads a case's reader version as the case states it, so `disc-0023` (a 1.1 reader and a `1.99.0` document) runs; `SPEC_VERSION` stays the one default (AGSC-00-21, AGSC-09-93; PRD-010).
- Added: `context.CONTEXT_VERSION`, the constant `1.0.0` of the persistent context address, which no longer follows the ontology version (AGSC-05-09 as amended for 1.1; `graph-0043` runs; the engine's `jsonld.js` `CONTEXT_VERSION`; PRD-060). The 1.0 name `context.ONTOLOGY_VERSION` stays, with the same value, and is deprecated.
- Changed: `run-vectors` reports four more cases as not run, each with its reason: `build-0029` and `build-0030` ("needs the engine's build and the query page (Level 3)", AGSC-06-39), `disc-0032` (it reads every file of a whole build, the HTML home page among them, AGSC-06-41) and `graph-0041` (`export --closure` with the OWL 2 RL rules of AGSC-05-37) (AGSC-09-02; PRD-010). The README lists every case not run and the counts.
- Tests: `test_equivalence.py` also compares the two checkers on the minimal fixture and on `agsc-demo-node` as the engine builds them, and on twelve new fixture cases of the 1.1 checks (chunk facts, ledger length, agent card); `test_wellknown_facts.py` and `test_web_connection.py` state the new checks; a fitness function keeps every connection in `net.py`.
- Changed: every area handler is guarded as the engine's are: a pass that left a member of a case's `expected` unread is a fail, and a case that states no member cannot pass (`areas/_expected_reads.py`, the engine's `tests/conformance/areas/_expected-reads.js`; AGSC-09-02, AGSC-09-06; PRD-010). The `jcs` and `slug` handlers are now held to it too.
- Fixed: `slug-0006` reads `engine_features_used`: the non-portable regular-expression features the slug pattern uses, named as the engine's `slug.js` names them (AGSC-01-10; PRD-010). A changed list used to pass here.
- Fixed: each entry of `graph-0018`'s `forbidden` is checked by its own reading, as the engine's `forbiddenCheck` does (no datatype on a language-tagged literal, no `^^xsd:string` in Turtle, no `asc:status` triple when no status is authored, predicates not in prefixed-name order), and an entry no reading knows fails (AGSC-05-10; PRD-010). Three of the four entries used to pass whatever the output was.
- Changed: `disc-0020` and `disc-0021` are reported not run with their reason: the engine builds the whole link table of AGSC-06-08 with its writer and compares the bytes, and this package's link-set writer covers part of that table (AGSC-09-02; PRD-010). They used to pass on a check of the stated document alone.
- Fixed: a target path that names a directory no longer stops `validate-wellknown` with a traceback: it is a target not found on disk (AGSC-E901), so an `a2a-card` there is a card not served, the warning AGSC-E210, as in the engine's `checkCardTarget` (AGSC-11-16; PRD-024).
- Fixed: a response field that Node's reader keeps only once (`Content-Type`, `ETag`, `Location` and fifteen more, `net.FIRST_LINE_ONLY`) is read from its first line when it is sent twice, as the engine's checker reads it; other repeated fields are still joined with ", " (PRD-024).
- Not added: `site.header_set` has no `/query/*` block, because no case this package runs reads it (the query page of `build-0029` and `build-0030` is not run here).
- Fixed: `validate-vectors` checks the `superseded_by` link: only a withdrawn vector may carry it (AGSC-E201), it is a vector id (AGSC-E204) and it names a vector of the same set (AGSC-E201) (AGSC-09-04; the engine's `tools/validate-vectors`; PRD-010). It used to be ignored.
- Fixed: `validate-vectors` refuses a folder where not one JSON file sits at `<area>/<prefix>-<nnnn>[-words].json` with one AGSC-E901 and judges none of its files, as the engine's `isVectorPath` rule does (AGSC-09-04, AGSC-09-90; PRD-010). One area folder used to pass, and a site's `skills/index.json` was judged as a vector.
- Changed: `validate-vectors` reports a missing folder as an AGSC-E901 finding with exit 1, as the engine does (AGSC-09-90; PRD-010); it used to be a usage fault, exit 2.
- Docs: the README names the one known difference from the engine's checker: a digest target or ledger that is a directory is `EISDIR` there and AGSC-E901 here; `test_equivalence.py` pins it (PRD-024).
- Tests: `test_actor_pattern.py` reads the engine from `AGSC_ENGINE_DIR` like every other engine test, and a fitness function fails on a test that spells out the engine path; `test_vectors.py` compares both validators on the vector copies, two `superseded_by` changes, one area folder, a skills index and a missing folder (PRD-010).
- Fixed: a link-shaped key (`peer-ref`, `mentions` or a foreign relation name) is the warning AGSC-E304, as the engine reports it, not AGSC-E207: one key, one code (AGSC-03-03; `links.LINK_SHAPED_UNKNOWN`, compared with the engine's `relations.js`; PRD-010).
- Fixed: `validate-wellknown` refuses a `webmcp` `agsc-surface-version` that has the form `YYYY-MM-DD` and names no day, such as `2026-13-45` (AGSC-E210, AGSC-11-16), as the engine's checker does (PRD-024).

## [1.0.1] - 2026-10-21

Expand Down
2 changes: 2 additions & 0 deletions MANIFEST.in
Original file line number Diff line number Diff line change
@@ -1,7 +1,9 @@
include README.md
include CHANGELOG.md
include LICENSE
include SECURITY.md
recursive-include src/agentic_system_core/data *.json
recursive-include src/agentic_system_core/data *.jsonld
recursive-include tests *.py
recursive-include tests/fixtures *
global-exclude __pycache__/*
Expand Down
Loading