Add SITREP inspection feature

[gitosaurus]

Add the ability to produce RDF report of ACX file, a "SITREP" or "SITuation REPort". This is not only the state of the objects in the game, but proximity and vocabulary. It is intended to be enough information to understand the game state without having to read binary ACX.

Lay the Archetype-side groundwork for the situation report feature:

• Extract 'ROLL CALL' as a reusable method on main, called after
  initialization and after each turn's events
• Add 'INVENTORY NAMES' message to list_inventory, which gathers
  inventory item names into a list without printing them
• Refactor 'INVENTORY' to use 'INVENTORY NAMES' internally, so the
  name-gathering and display logic are separated
• Add 'SITREP' method on main that assembles exits, visible objects,
  and inventory as a structured PairValue list of key-value pairs
• SITREP is not called automatically; it is available on demand

Rewrite inspect_universe for proper RDF/Turtle output

The --inspect flag now produces well-formed Turtle with:

• Proper prefixes: archetype:, type:, object:, attr:, msg:, xsd:
• Attribute values rendered via asRDF() (e.g., attr:desc "dank cellar")
  instead of just listing attribute names
• Type hierarchy via rdfs:Class and rdfs:subClassOf
• Instance typing via rdf:type (Turtle 'a' shorthand)
• Vocabulary: verb/noun phrases as archetype:verbPhrase and
  archetype:nounPhrase predicates on each object
• Proximate objects as archetype:proximate on archetype:situation
• Methods (--full flag): archetype:respondsTo msg:MESSAGE_NAME
  with URI-encoded message names

Without --full, only object identity, types, and attribute values are
emitted — this is the "state-only" view suitable for external parsers
or AI systems that need to understand the game situation without
knowing the internal method implementations.

As part of this work, change the Archetype list literal syntax to use square brackets instead of curly braces; the latter worked but was visually easy to confuse with compound statements.

[Copilot]

Pull request overview

This PR lays groundwork for a “SITREP” (situation report) feature and modernizes the --inspect output to emit RDF/Turtle, alongside a syntax change for Archetype list literals from {} to [].

Changes:

• Add an optional --sitrep path to --update to append a structured situation report (SITREP + parser context).
• Rewrite --inspect to emit Turtle with richer type/attribute/method modeling and parser vocabulary/proximity output.
• Introduce Value::asRDF() and switch list literal display syntax from {} to [], with updated/added tests.

Reviewed changes

Copilot reviewed 19 out of 19 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
src/update_universe.hh	Extends update_universe API to optionally append sitrep output.
src/update_universe.cc	Implements sitrep emission and parser-context dump after UPDATE.
src/main.cc	Adds --sitrep and --full flags and wires them into update/inspect flows.
src/inspect_universe.hh	Extends inspect_universe signature with include_methods toggle.
src/inspect_universe.cc	Rewrites inspection output as Turtle with prefixes, types, attributes, methods, and parser vocabulary/proximity.
src/Value.hh	Adds asRDF() to the Value interface and concrete value types.
src/Value.cc	Implements asRDF() for values and updates PairValue display + RDF rendering.
src/TestValue.cc	Updates list display expectations to the new [] syntax.
src/TestInspectUniverse.hh	Adds a new test suite for Turtle output structure.
src/TestInspectUniverse.cc	Adds tests for type output and Turtle syntax constraints for vocabulary/proximity.
src/TestExpression.hh	Adds tests for list literal parsing and REPL output formatting.
src/TestExpression.cc	Implements list literal parsing tests and REPL display regression test.
src/SystemParser.hh	Updates friend declarations to match new inspect signature and sitrep helper.
src/SystemObject.hh	Updates friend declarations to match new inspect signature and sitrep helper.
src/ReadEvalPrintLoop.cc	Adjusts REPL output formatting to => <display> only.
src/Object.hh	Updates inspect_universe friend declaration signature.
src/Expression.cc	Switches list literal parsing from {} to [].
src/CMakeLists.txt	Adds new TestInspectUniverse to the build.
games/intrptr.arch	Adds ROLL CALL and SITREP methods and refactors inventory listing; updates list literal usage to [].

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The PR description calls out object: as a prefix, but the emitted Turtle declares @prefix obj: <object/> and all instances use obj:. If external tooling/docs expect object:, this will be a breaking change; either switch back to object: or update the PR description and any downstream expectations consistently.

[Copilot]

inspect_universe(..., include_methods=false) still emits the vocabulary and proximate-object sections unconditionally. The PR description says the non---full output should be “state-only” (identity/types/attribute values only). If that contract is intended, gate the vocabulary/proximity emission behind include_methods (or a separate flag) so default --inspect stays minimal and machine-friendly.

[Copilot]

With --sitrep, the appended lines use prefixed names (obj:, type:, archetype:, xsd:) but the output does not include any @prefix declarations (and lines like SITREP ..., PROXIMATE (...) are not valid Turtle triples). If this is meant to be parseable RDF/Turtle as the help text suggests, consider emitting the same prefix block as --inspect (or full URIs) and output valid Turtle statements (e.g., triples) rather than custom labels.

[Copilot]

Calling dispatch_to_universe("SITREP") will create a new message ID via Messages.index() if the saved game doesn’t already contain that message name. Even if SITREP is unavailable and you “silently skip”, the universe is still mutated and then re-serialized (out << Universe::instance()), potentially changing the saved file just because --sitrep was requested. To avoid this, use a non-mutating lookup (e.g., Messages.find() + error) when sending optional messages like SITREP.

Suggested change

	try {
	Value sitrep_val = dispatch_to_universe("SITREP");
	result += "SITREP " + sitrep_val->asRDF() + "\n";
	} catch (const std::exception&) {
	// SITREP not available; silently skip
	if (Messages.find("SITREP") >= 0) {
	try {
	Value sitrep_val = dispatch_to_universe("SITREP");
	result += "SITREP " + sitrep_val->asRDF() + "\n";
	} catch (const std::exception&) {
	// SITREP failed at runtime; silently skip
	}

[Copilot]

identifier_of() linearly scans Universe::instance().ObjectIdentifiers on every ObjectValue::asRDF() call. In RDF export paths (inspect + sitrep), this can become O(N^2) for large universes with many object references/attributes. Consider building a reverse map once (object_id -> identifier_id) and reusing it, or adding an efficient reverse lookup facility to Universe.

[Copilot]

The --sitrep usage string claims the appended report is “RDF/Turtle”, but the current --sitrep output path doesn’t emit Turtle prefixes/triples (it prints labeled collections like SITREP (...), PROXIMATE (...)). Either adjust the help text to describe the actual format, or update the output to be well-formed Turtle so users can pipe it directly into RDF tooling.

[Copilot]

inspect_universe currently evaluates every attribute expression (attr.second->evaluate()) without setting self/context and without guarding against non-literal expressions. This can produce incorrect values (wrong context), trigger side effects, or even mutate game state during inspection. Consider limiting inspection to ValueExpression-backed attributes (as before), or setting a ContextScope with selfObject = obj and ensuring evaluation is side-effect-free before calling evaluate().