@graffiticode/l0175 0.2.0 → 0.3.0

package/dist/targets.js

@@ -0,0 +1,169 @@
+// SPDX-License-Identifier: MIT
+/* Copyright (c) 2026, ARTCOMPILER INC */
+//
+// SINGLE SOURCE OF TRUTH for L0175's per-target structure.
+//
+// Everything the compiler enforces about a learning target lives here — and ONLY here.
+// `compiler.ts` builds its runtime `TARGETS` profiles from this data; `tools/build-static.js`
+// emits a served `targets.json` from it and GENERATES the per-target tables in the spec
+// `.md` files (instructions.md, stems.md) from it. The `.md` files are the generator-facing
+// flip side of this data: they carry MORE (narrative, stems, examples) but must EMPHASIZE
+// everything here — nothing structural the compiler checks may be absent from what the
+// generator reads. To add or change a target fact, edit this file; the compiler and the docs
+// follow.
+//
+// This is plain data (no logic) so it round-trips to JSON. It is a typed `.ts` module rather
+// than a raw `.json` import because core compiles to ESM under NodeNext, where JSON imports
+// need version-fragile import attributes; build-static serializes it to `dist/static/targets.json`
+// for non-TS consumers (the console RAG pipeline) and humans.
+export const TARGETS_REVISED = "2026-06-30";
+// CCSS Grade-5 reading-standard families. A target's `standards` is the full strand for its
+// text type, so any plausible CCSS code for that text type validates (the `dimStandard` map
+// still picks the right companion by default). RL.8 is "not applicable to literature";
+// RL.10/RI.10 are range-of-reading bands, not discrete item standards.
+export const STANDARD_FAMILIES = {
+    RL_G5: ["rl-1", "rl-2", "rl-3", "rl-4", "rl-5", "rl-6", "rl-7", "rl-9"],
+    RI_G5: ["ri-1", "ri-2", "ri-3", "ri-4", "ri-5", "ri-6", "ri-7", "ri-8", "ri-9"],
+    L_G5: ["l-4", "l-4a", "l-4b", "l-4c", "l-5", "l-5a", "l-5b", "l-5c"], // vocabulary (T10)
+};
+// Reverse lookup: the task-model NUMBER for a (target, item type) — e.g. ("c1-t9", "ebsr") → "3",
+// ("c1-t4", "short-text") → "3". Item-type → task-model is per-target (the numbers collide), so the
+// target is required. Returns undefined if the target doesn't offer that item type. Used by the RAG
+// signature so a number-phrased query ("task model 3") can match a target's correct exemplar.
+export function taskModelNumber(target, itemType) {
+    const tms = TARGETS_DATA[target]?.taskModels;
+    if (!tms)
+        return undefined;
+    const key = Object.keys(tms).find((k) => tms[k] === itemType);
+    return key ? key.replace(/^tm/, "") : undefined;
+}
+// Distractor error taxonomies reused across targets. Reasoning & Evidence (T4/T11) classifies
+// foils by reasoning failure; Central Ideas (T9) by SIGNIFICANCE (a true statement that just
+// isn't the central idea); Word Meanings (T10) by meaning error.
+const RE_ERROR_TYPES = ["misreads-detail", "erroneous-inference", "faulty-reasoning"];
+const T9_ERROR_TYPES = ["too-narrow", "too-broad", "misreads-detail", "insignificant"];
+// R&E (T4/T11) and the single-select families share task-model layouts.
+const RE_TASK_MODELS = { tm1: "ebsr", tm2: "hot-text", tm3: "short-text" };
+const SELECT_TASK_MODELS = { tm1: "multiple-choice", tm2: "multi-select", tm3: "hot-text" };
+export const TARGETS_DATA = {
+    // Claim 1 · Target 4 — Reasoning & Evidence, literary texts (RL standards). The original L0175.
+    "c1-t4": {
+        id: "c1-t4",
+        label: "Grade 5 · Claim 1 · Target 4 (Reasoning & Evidence)",
+        grade: 5,
+        textType: "literary",
+        baseStandard: "rl-1",
+        defaultDok: "r-dok3",
+        answerKind: "statement",
+        singlePartHotText: false,
+        taskModels: RE_TASK_MODELS,
+        standards: ["RL_G5"],
+        dimensions: [
+            "character", "setting", "event", "point-of-view",
+            "theme", "topic", "narrators-feelings", "character-relationship",
+        ],
+        errorTypes: RE_ERROR_TYPES,
+        dimStandard: {
+            "character": "rl-3", "character-relationship": "rl-3", "setting": "rl-3", "event": "rl-3",
+            "point-of-view": "rl-6", "narrators-feelings": "rl-6",
+            // theme/topic = determine-the-theme/summarize → RL.2 (the CCSS theme standard), not the
+            // cross-text-comparison RL.9.
+            "theme": "rl-2", "topic": "rl-2",
+        },
+    },
+    // Claim 1 · Target 11 — Reasoning & Evidence, informational texts (RI standards).
+    "c1-t11": {
+        id: "c1-t11",
+        label: "Grade 5 · Claim 1 · Target 11 (Reasoning & Evidence)",
+        grade: 5,
+        textType: "informational",
+        baseStandard: "ri-1",
+        defaultDok: "r-dok3",
+        answerKind: "statement",
+        singlePartHotText: false,
+        taskModels: RE_TASK_MODELS,
+        standards: ["RI_G5"],
+        dimensions: [
+            "relationships-interactions", "author-use-of-information",
+            "point-of-view", "purpose", "authors-opinion",
+        ],
+        errorTypes: RE_ERROR_TYPES,
+        dimStandard: {
+            "relationships-interactions": "ri-3",
+            "author-use-of-information": "ri-8",
+            "point-of-view": "ri-6",
+            "purpose": "ri-8",
+            "authors-opinion": "ri-8",
+        },
+    },
+    // Claim 1 · Target 9 — Central Ideas, informational texts (RI-1 + RI-2). A DIFFERENT skill from
+    // Reasoning & Evidence: whole-text synthesis and significance (the main idea, the key details that
+    // build it, and summary), DOK 2 (3 only for the written summary). Distractors are a SIGNIFICANCE
+    // taxonomy — usually true statements that just aren't the central idea. The only non-R&E target
+    // that allows EBSR and short-text, so its task-model numbering reaches tm5.
+    "c1-t9": {
+        id: "c1-t9",
+        label: "Grade 5 · Claim 1 · Target 9 (Central Ideas)",
+        grade: 5,
+        textType: "informational",
+        baseStandard: "ri-1",
+        defaultDok: "r-dok2",
+        answerKind: "statement",
+        singlePartHotText: true, // T9 Hot Text (tm4): click the sentence(s) that show the main idea
+        taskModels: {
+            tm1: "multiple-choice", tm2: "multi-select", tm3: "ebsr", tm4: "hot-text", tm5: "short-text",
+        },
+        standards: ["RI_G5"],
+        dimensions: ["central-idea", "key-detail", "summary"],
+        errorTypes: T9_ERROR_TYPES,
+        dimStandard: {
+            "central-idea": "ri-2",
+            "key-detail": "ri-2",
+            "summary": "ri-2",
+        },
+    },
+    // Claim 1 · Target 8 — Key Details, informational texts (RI-1 + RI-7). A DIFFERENT model: the
+    // inference/conclusion is GIVEN in the stem and the student selects the supporting EVIDENCE
+    // (answerKind "evidence"). Options are passage sources, not claims; no statement Part A, no
+    // EBSR/short-text. DOK 1–2 (default 2).
+    "c1-t8": {
+        id: "c1-t8",
+        label: "Grade 5 · Claim 1 · Target 8 (Key Details)",
+        grade: 5,
+        textType: "informational",
+        baseStandard: "ri-1",
+        defaultDok: "r-dok2",
+        answerKind: "evidence",
+        singlePartHotText: true,
+        taskModels: SELECT_TASK_MODELS,
+        standards: ["RI_G5"],
+        dimensions: ["supporting-evidence"],
+        errorTypes: [], // T8 wrong answers are non-supporting sources, not distractor claims
+        dimStandard: {
+            "supporting-evidence": "ri-7",
+        },
+    },
+    // Claim 1 · Target 10 — Word Meanings, informational texts (RI-4 + the L-4 family). The most
+    // different model: the question asks for the MEANING of a targeted word/phrase in context, so the
+    // options are candidate MEANINGS (answerKind "meaning"), authored as `word`/`meaning`, not claims.
+    // DOK 1–2. The strategy (context / roots & affixes / word relationships / reference) is expressed
+    // via the authored standard (l-4a / l-4b / l-5c / l-4c).
+    "c1-t10": {
+        id: "c1-t10",
+        label: "Grade 5 · Claim 1 · Target 10 (Word Meanings)",
+        grade: 5,
+        textType: "informational",
+        baseStandard: "ri-4",
+        defaultDok: "r-dok2",
+        answerKind: "meaning",
+        singlePartHotText: false, // T10 Hot Text is word-level (composeWordMeaning), not sentence-level
+        taskModels: SELECT_TASK_MODELS,
+        standards: ["RI_G5", "L_G5"],
+        dimensions: ["word-meaning"],
+        errorTypes: ["other-meaning", "misinterprets", "wrong-context"],
+        dimStandard: {
+            "word-meaning": "l-4",
+        },
+    },
+};
+//# sourceMappingURL=targets.js.map

package/dist/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"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"}

package/dist/verify-example.d.ts

@@ -0,0 +1,27 @@
+import { type DesignFacets } from "./embedding.js";
+export interface ExampleExpectation {
+    target: string;
+    taskModel?: string;
+    itemType?: string;
+    dimension?: string;
+    standard?: string;
+}
+export interface VerifyResult {
+    ok: boolean;
+    blocking: string[];
+    advisory: string[];
+    facets: DesignFacets;
+}
+/**
+ * Verify one example against its declared expectation. Pure: the caller supplies the compile result
+ * (`errors`, `data`) — parsing/compiling lives at the call site (the parser is not a core dep). Pass
+ * `data` (a composed program from `compiler.compile`) for the authoritative signature; `code` alone
+ * falls back to the source-derived signature.
+ */
+export declare function verifyExample(input: {
+    errors: any[];
+    data?: any;
+    code?: string;
+    expect: ExampleExpectation;
+}): VerifyResult;
+//# sourceMappingURL=verify-example.d.ts.map

package/dist/verify-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-example.d.ts","sourceRoot":"","sources":["../src/verify-example.ts"],"names":[],"mappings":"AAeA,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGjG,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB;AAQD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,kBAAkB,CAAC;CAC5B,GAAG,YAAY,CAyDf"}

package/dist/verify-example.js

@@ -0,0 +1,82 @@
+// SPDX-License-Identifier: MIT
+// A verification GATE for RAG example data. It does NOT map prompt→code (that stays with the
+// generator + human refinement); it inspects whatever code an example already carries and checks
+// only the machine-decidable properties, so it composes with a human-in-the-loop workflow.
+//
+// Two tiers:
+//   - BLOCKING  — objective failures that must keep an example out of the corpus: it must compile
+//                 clean, and its composed design signature (target / item type / task model /
+//                 dimension / standard) must match the example's declared intent. Task-model checks
+//                 read ./targets.ts (the single source of truth), NOT instructions.md — so the gate
+//                 is independent of the docs a bootstrap run was seeded from.
+//   - ADVISORY  — compiler warnings (thin distractor pool, A↔B giveaway, above-grade reading) that a
+//                 human should judge, surfaced but not fatal.
+//
+// The gate guards BOTH sides of the human: run it after bootstrap AND after hand-refinement.
+import { buildSignatureTags, buildSignatureFromSource } from "./embedding.js";
+import { TARGETS_DATA, taskModelNumber } from "./targets.js";
+// Accept "tm3" or "3"; return both the table key and the bare number.
+function normalizeTaskModel(s) {
+    const num = String(s).toLowerCase().replace(/^tm/, "");
+    return { key: `tm${num}`, num };
+}
+/**
+ * Verify one example against its declared expectation. Pure: the caller supplies the compile result
+ * (`errors`, `data`) — parsing/compiling lives at the call site (the parser is not a core dep). Pass
+ * `data` (a composed program from `compiler.compile`) for the authoritative signature; `code` alone
+ * falls back to the source-derived signature.
+ */
+export function verifyExample(input) {
+    const { errors, data, code, expect } = input;
+    const blocking = [];
+    const advisory = [];
+    // 1. Must compile clean — any hard error is blocking.
+    for (const e of errors || [])
+        blocking.push(`compile error: ${e?.message ?? String(e)}`);
+    // 2. Signature — prefer the composed data; fall back to source.
+    const sig = data != null ? buildSignatureTags(data) : buildSignatureFromSource(code || "");
+    const facets = sig.facets;
+    const target = expect.target;
+    const profile = TARGETS_DATA[target];
+    if (!profile) {
+        blocking.push(`unknown expected target '${target}'`);
+        return { ok: blocking.length === 0, blocking, advisory, facets };
+    }
+    // Resolve the expected item type / task-model number from whatever the expectation provided, and
+    // cross-check them when both are given.
+    const expTm = expect.taskModel ? normalizeTaskModel(expect.taskModel) : undefined;
+    let expItemType = expect.itemType;
+    if (!expItemType && expTm)
+        expItemType = profile.taskModels[expTm.key];
+    const expTmNum = expTm?.num ?? (expItemType ? taskModelNumber(target, expItemType) : undefined);
+    if (expect.itemType && expTm && profile.taskModels[expTm.key] !== expect.itemType) {
+        blocking.push(`expectation is inconsistent: ${expTm.key} is '${profile.taskModels[expTm.key] ?? "n/a"}' for ${target}, not '${expect.itemType}'`);
+    }
+    if (expTm && !profile.taskModels[expTm.key]) {
+        blocking.push(`task model '${expTm.key}' is not available for target ${target}`);
+    }
+    // 3. Composed signature must match the declared intent.
+    if (facets.target !== target) {
+        blocking.push(`target: expected ${target}, composed ${facets.target ?? "none"}`);
+    }
+    const gotTypes = facets.itemTypes || [];
+    if (expItemType && !(gotTypes.length === 1 && gotTypes[0] === expItemType)) {
+        blocking.push(`item type: expected exactly [${expItemType}], composed [${gotTypes.join(", ") || "none"}]`);
+    }
+    if (expTmNum && !(facets.taskModels || []).includes(expTmNum)) {
+        blocking.push(`task model: expected tm${expTmNum}, composed task-model(s) [${(facets.taskModels || []).join(", ") || "none"}]`);
+    }
+    if (expect.dimension && !(facets.dimensions || []).includes(expect.dimension)) {
+        blocking.push(`dimension: expected ${expect.dimension}, composed [${(facets.dimensions || []).join(", ") || "none"}]`);
+    }
+    if (expect.standard && !(facets.standards || []).includes(expect.standard)) {
+        blocking.push(`standard: expected ${expect.standard}, composed [${(facets.standards || []).join(", ") || "none"}]`);
+    }
+    // 4. Compiler warnings → advisory (a human decides). Warnings ride on each composed item.
+    const items = data == null ? [] : Array.isArray(data) ? data : data.kind === "items" ? data.items : [data];
+    for (const it of items)
+        for (const w of (it && it.warnings) || [])
+            advisory.push(w);
+    return { ok: blocking.length === 0, blocking, advisory, facets };
+}
+//# sourceMappingURL=verify-example.js.map

package/dist/verify-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-example.js","sourceRoot":"","sources":["../src/verify-example.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -3,7 +3,7 @@
     "access": "public"
   },
   "name": "@graffiticode/l0175",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "L0175 — a Graffiticode dialect (hello/image/theme/print) inheriting @graffiticode/l0000",
   "type": "module",
   "main": "./dist/index.js",

package/spec/docs.md

@@ -46,7 +46,10 @@ outcomes [ outcome id "q1" type ebsr dimension character subject "Mara" standard
 ```
 
 composes a two-part EBSR item and renders it as an answerable form with a Student / Review
-toggle.
+toggle. This example is Target 4 (literary, R&E); the other targets use the same flat-chain shape
+but author their options differently — **T9** (Central Ideas) significance-taxonomy `claim`s,
+**T8** (Key Details) `source`s with the inference given in the stem, **T10** (Word Meanings)
+`meaning`s of a targeted `word`. See `instructions.md` for a full worked program per target.
 
 ### Vocabulary
 
@@ -88,7 +91,7 @@ Attribute functions (arity-2, merge one key into the element's record):
 - `dimension` (c1-t9): `central-idea`, `key-detail`, `summary` · (c1-t8): `supporting-evidence` · (c1-t10): `word-meaning`
 - claim `status`: `supported`, `distractor` · source `status`: `directly-supports`, `supports-wrong-claim`, `irrelevant` · meaning `status` (c1-t10): `correct`, `distractor`
 - `error-type` (c1-t4 / c1-t11): `misreads-detail`, `erroneous-inference`, `faulty-reasoning` · (c1-t9): `too-narrow`, `too-broad`, `misreads-detail`, `insignificant` · (c1-t8): none (non-supporting sources) · (c1-t10): `other-meaning`, `misinterprets`, `wrong-context`
-- `standard` (c1-t4): `rl-1`, `rl-3`, `rl-6`, `rl-9` · (c1-t11): `ri-1`, `ri-3`, `ri-6`, `ri-7`, `ri-8`, `ri-9` · (c1-t9): `ri-1`, `ri-2` · (c1-t8): `ri-1`, `ri-7` · (c1-t10): `ri-4`, `l-4`, `l-4a`, `l-4b`, `l-4c`, `l-5c`
+- `standard` — full CCSS Grade-5 strand for the text type accepted; the dimension's companion is inferred when omitted. Primary companions — (c1-t4): `rl-1` + `rl-2` (theme/topic) / `rl-3` / `rl-6` [full RL `rl-1`–`rl-7`/`rl-9`, no `rl-8`] · (c1-t11): `ri-1` + `ri-3` / `ri-6` / `ri-7` / `ri-8` · (c1-t9): `ri-1` + `ri-2` · (c1-t8): `ri-1` + `ri-7` [c1-t11/t9/t8 accept full RI `ri-1`–`ri-9`] · (c1-t10): `ri-4` + the `l-4` / `l-5` families
 - `dok`: `r-dok1`, `r-dok2`, `r-dok3` (R&E → r-dok3; T9 → r-dok2, written summary r-dok3; T8 & T10 → r-dok2)
 
 ### Grade-appropriate reading level

package/spec/examples/c1-t10-tm1-multiplechoice.expect.json

@@ -0,0 +1 @@
+{ "prompt": "From an informational passage that uses the word 'aqueduct' in context, author a c1-t10 Task Model 1 (Multiple Choice) item asking what 'aqueduct' most likely means as used in the passage (dimension word-meaning, standard l-4a — context). Options are meanings: one correct plus distractors tagged other-meaning, misinterprets, and wrong-context.", "expect": { "target": "c1-t10", "taskModel": "tm1", "itemType": "multiple-choice", "dimension": "word-meaning", "standard": "l-4a" } }

package/spec/examples/c1-t10-tm1-multiplechoice.gc

@@ -0,0 +1,15 @@
+target c1-t10 passage "The City Aqueduct" type informational lines [
+  "The city built a long aqueduct to carry water from the hills."
+  "Workers dug a deep channel and lined it with smooth stone."
+  "When it rained, the ditch beside the road filled with mud."
+]
+words [
+  word id "w1" text "aqueduct" line 1 quote "The city built a long aqueduct to carry water from the hills." meanings [
+    meaning id "m1" status correct text "a channel that carries water" {},
+    meaning id "m2" status distractor error-type other-meaning text "a large boat that carries cargo" rationale "another meaning that ignores the water-carrying context" {},
+    meaning id "m3" status distractor error-type misinterprets text "a tall tower built of stone" rationale "misreads the sentence, which is about carrying water" {},
+    meaning id "m4" status distractor error-type wrong-context text "a wide road made for wagons" rationale "uses the wrong context" {}
+  ] {}
+]
+outcomes [ outcome id "q1" type multiple-choice task-model tm1 dimension word-meaning subject "aqueduct" standard l-4a focus "w1" stem "Read the sentence: \"The city built a long aqueduct to carry water from the hills.\" What does the word aqueduct most likely mean?" {} ]
+{}..

package/spec/examples/c1-t10-tm2-multiselect.expect.json

@@ -0,0 +1 @@
+{ "prompt": "From the same passage, author a c1-t10 Task Model 2 (Multi-Select) item: 'What does the word aqueduct most likely mean? Choose two answers.' Two correct meanings plus distractor meanings (dimension word-meaning, standard l-5c).", "expect": { "target": "c1-t10", "taskModel": "tm2", "itemType": "multi-select", "dimension": "word-meaning", "standard": "l-5c" } }

package/spec/examples/c1-t10-tm2-multiselect.gc

@@ -0,0 +1,15 @@
+target c1-t10 passage "The City Aqueduct" type informational lines [
+  "The city built a long aqueduct to carry water from the hills."
+  "Workers dug a deep channel and lined it with smooth stone."
+  "When it rained, the ditch beside the road filled with mud."
+]
+words [
+  word id "w1" text "aqueduct" line 1 quote "The city built a long aqueduct to carry water from the hills." meanings [
+    meaning id "m1" status correct text "a channel that carries water" {},
+    meaning id "m2" status correct text "a bridge that carries water" {},
+    meaning id "m3" status distractor error-type misinterprets text "a tall tower built of stone" rationale "misreads the sentence, which is about carrying water" {},
+    meaning id "m4" status distractor error-type wrong-context text "a wide road made for wagons" rationale "uses the wrong context" {}
+  ] {}
+]
+outcomes [ outcome id "q1" type multi-select task-model tm2 dimension word-meaning subject "aqueduct" standard l-5c focus "w1" stem "What does the word aqueduct most likely mean? Choose two answers." {} ]
+{}..

package/spec/examples/c1-t10-tm3-hottext.expect.json

@@ -0,0 +1 @@
+{ "prompt": "From the same passage, author a c1-t10 Task Model 3 (Hot Text) click-the-word item: click the word in the paragraph that matches a given definition. The focus word (aqueduct) is correct; author a few distractor candidate words from the same paragraph. Standard l-4a; keep the passage out of the stem.", "expect": { "target": "c1-t10", "taskModel": "tm3", "itemType": "hot-text", "dimension": "word-meaning", "standard": "l-4a" } }

package/spec/examples/c1-t10-tm3-hottext.gc

@@ -0,0 +1,13 @@
+target c1-t10 passage "The City Aqueduct" type informational lines [
+  "The city built a long aqueduct to carry water from the hills."
+  "Workers dug a deep channel and lined it with smooth stone."
+  "When it rained, the ditch beside the road filled with mud."
+]
+words [
+  word id "w1" text "aqueduct" line 1 {},
+  word id "w2" text "city" line 1 {},
+  word id "w3" text "water" line 1 {},
+  word id "w4" text "hills" line 1 {}
+]
+outcomes [ outcome id "q1" type hot-text task-model tm3 dimension word-meaning subject "aqueduct" standard l-4a focus "w1" stem "Click the word in the paragraph that means a channel built to carry water across the land." {} ]
+{}..

package/spec/examples/c1-t11-tm1-ebsr.expect.json

@@ -0,0 +1,4 @@
+{
+  "prompt": "From an informational article on how bridge designs changed over time, author a c1-t11 Task Model 1 (ebsr) item about how each design is related to the one before it (dimension relationships-interactions, standard ri-3).",
+  "expect": { "target": "c1-t11", "taskModel": "tm1", "itemType": "ebsr", "dimension": "relationships-interactions", "standard": "ri-3" }
+}

package/spec/examples/c1-t11-tm1-ebsr.gc

@@ -0,0 +1,30 @@
+target c1-t11 passage "How Bridges Changed" type informational lines [
+  "Long ago, builders made bridges by laying flat stones across a stream."
+  "These beam bridges could only cross short gaps before they sagged."
+  "To span wider rivers, the Romans built arch bridges out of curved stone."
+  "The arch pushed the weight outward, so the bridge could carry heavy loads."
+  "Later, engineers hung the roadway from cables in a suspension bridge."
+  "Suspension bridges could cross gaps far too wide for any arch."
+  "Each new design solved a problem the earlier one could not."
+  "Today, engineers choose a design to fit the distance and the load."
+]
+claims [
+  claim id "c1" status supported dimension relationships-interactions subject "the bridge designs" standard ri-3 text "Each new bridge design fixed a problem the last one could not." cites ["e1" "e2" "e3"] {},
+  claim id "c2" status distractor error-type misreads-detail plausibility 0.8 targets ["q1"] text "Beam bridges were the strongest kind of bridge ever built." rationale "Misreads the passage; beam bridges were the weakest." cites ["e4"] {},
+  claim id "c3" status distractor error-type erroneous-inference plausibility 0.6 targets ["q1"] text "The Romans invented every type of bridge in the article." rationale "Not stated; they built arch bridges, not all types." cites ["e5"] {},
+  claim id "c4" status distractor error-type faulty-reasoning plausibility 0.6 targets ["q1"] text "Newer bridges are always prettier than older bridges." rationale "Beauty is never discussed; the text is about solving problems." cites ["e6"] {},
+  claim id "c5" status distractor error-type misreads-detail plausibility 0.5 targets ["q1"] text "Suspension bridges are built only from curved stone." rationale "Confuses suspension bridges (cables) with arch bridges (stone)." cites ["e7"] {},
+  claim id "c6" status distractor error-type erroneous-inference plausibility 0.5 targets ["q1"] text "Engineers today still prefer the simple beam bridge." rationale "Contradicted; they choose a design by distance and load." cites ["e8"] {}
+]
+evidence [
+  source id "e1" line 4 status directly-supports supports ["c1"] quote "The arch pushed the weight outward, so the bridge could carry heavy loads." {},
+  source id "e2" line 6 status directly-supports supports ["c1"] quote "Suspension bridges could cross gaps far too wide for any arch." {},
+  source id "e3" line 7 status directly-supports supports ["c1"] quote "Each new design solved a problem the earlier one could not." {},
+  source id "e4" line 2 status supports-wrong-claim supports ["c1" "c2"] quote "These beam bridges could only cross short gaps before they sagged." rationale "Describes a limit of one design, not the relationship across designs." {},
+  source id "e5" line 3 status supports-wrong-claim supports ["c3"] quote "To span wider rivers, the Romans built arch bridges out of curved stone." rationale "Backs the who-built-it detail, not the problem-solving relationship." {},
+  source id "e6" line 1 status irrelevant supports [] quote "Long ago, builders made bridges by laying flat stones across a stream." {},
+  source id "e7" line 5 status irrelevant supports [] quote "Later, engineers hung the roadway from cables in a suspension bridge." {},
+  source id "e8" line 8 status irrelevant supports [] quote "Today, engineers choose a design to fit the distance and the load." {}
+]
+outcomes [ outcome id "q1" type ebsr task-model tm1 dimension relationships-interactions subject "the bridge designs" standard ri-3 focus "c1" stem "Which of these conclusions about how the bridge designs are related is supported by the passage?" stem-b "Which sentence(s) from the passage best support your answer in Part A?" {} ]
+{}..

package/spec/examples/c1-t11-tm2-hottext.expect.json

@@ -0,0 +1,4 @@
+{
+  "prompt": "From an informational article on how bridge designs changed over time, author a c1-t11 Task Model 2 (hot-text) item about how each design is related to the one before it (dimension relationships-interactions, standard ri-3).",
+  "expect": { "target": "c1-t11", "taskModel": "tm2", "itemType": "hot-text", "dimension": "relationships-interactions", "standard": "ri-3" }
+}

package/spec/examples/c1-t11-tm2-hottext.gc

@@ -0,0 +1,30 @@
+target c1-t11 passage "How Bridges Changed" type informational lines [
+  "Long ago, builders made bridges by laying flat stones across a stream."
+  "These beam bridges could only cross short gaps before they sagged."
+  "To span wider rivers, the Romans built arch bridges out of curved stone."
+  "The arch pushed the weight outward, so the bridge could carry heavy loads."
+  "Later, engineers hung the roadway from cables in a suspension bridge."
+  "Suspension bridges could cross gaps far too wide for any arch."
+  "Each new design solved a problem the earlier one could not."
+  "Today, engineers choose a design to fit the distance and the load."
+]
+claims [
+  claim id "c1" status supported dimension relationships-interactions subject "the bridge designs" standard ri-3 text "Each new bridge design fixed a problem the last one could not." cites ["e1" "e2" "e3"] {},
+  claim id "c2" status distractor error-type misreads-detail plausibility 0.8 targets ["q1"] text "Beam bridges were the strongest kind of bridge ever built." rationale "Misreads the passage; beam bridges were the weakest." cites ["e4"] {},
+  claim id "c3" status distractor error-type erroneous-inference plausibility 0.6 targets ["q1"] text "The Romans invented every type of bridge in the article." rationale "Not stated; they built arch bridges, not all types." cites ["e5"] {},
+  claim id "c4" status distractor error-type faulty-reasoning plausibility 0.6 targets ["q1"] text "Newer bridges are always prettier than older bridges." rationale "Beauty is never discussed; the text is about solving problems." cites ["e6"] {},
+  claim id "c5" status distractor error-type misreads-detail plausibility 0.5 targets ["q1"] text "Suspension bridges are built only from curved stone." rationale "Confuses suspension bridges (cables) with arch bridges (stone)." cites ["e7"] {},
+  claim id "c6" status distractor error-type erroneous-inference plausibility 0.5 targets ["q1"] text "Engineers today still prefer the simple beam bridge." rationale "Contradicted; they choose a design by distance and load." cites ["e8"] {}
+]
+evidence [
+  source id "e1" line 4 status directly-supports supports ["c1"] quote "The arch pushed the weight outward, so the bridge could carry heavy loads." {},
+  source id "e2" line 6 status directly-supports supports ["c1"] quote "Suspension bridges could cross gaps far too wide for any arch." {},
+  source id "e3" line 7 status directly-supports supports ["c1"] quote "Each new design solved a problem the earlier one could not." {},
+  source id "e4" line 2 status supports-wrong-claim supports ["c1" "c2"] quote "These beam bridges could only cross short gaps before they sagged." rationale "Describes a limit of one design, not the relationship across designs." {},
+  source id "e5" line 3 status supports-wrong-claim supports ["c3"] quote "To span wider rivers, the Romans built arch bridges out of curved stone." rationale "Backs the who-built-it detail, not the problem-solving relationship." {},
+  source id "e6" line 1 status irrelevant supports [] quote "Long ago, builders made bridges by laying flat stones across a stream." {},
+  source id "e7" line 5 status irrelevant supports [] quote "Later, engineers hung the roadway from cables in a suspension bridge." {},
+  source id "e8" line 8 status irrelevant supports [] quote "Today, engineers choose a design to fit the distance and the load." {}
+]
+outcomes [ outcome id "q1" type hot-text task-model tm2 dimension relationships-interactions subject "the bridge designs" standard ri-3 focus "c1" stem "Click on the statement that best describes how the bridge designs are related, as supported by the passage." {} ]
+{}..

package/spec/examples/c1-t11-tm3-shorttext.expect.json

@@ -0,0 +1,4 @@
+{
+  "prompt": "From an informational article on how bridge designs changed over time, author a c1-t11 Task Model 3 (short-text) item about how each design is related to the one before it (dimension relationships-interactions, standard ri-3).",
+  "expect": { "target": "c1-t11", "taskModel": "tm3", "itemType": "short-text", "dimension": "relationships-interactions", "standard": "ri-3" }
+}

package/spec/examples/c1-t11-tm3-shorttext.gc

@@ -0,0 +1,30 @@
+target c1-t11 passage "How Bridges Changed" type informational lines [
+  "Long ago, builders made bridges by laying flat stones across a stream."
+  "These beam bridges could only cross short gaps before they sagged."
+  "To span wider rivers, the Romans built arch bridges out of curved stone."
+  "The arch pushed the weight outward, so the bridge could carry heavy loads."
+  "Later, engineers hung the roadway from cables in a suspension bridge."
+  "Suspension bridges could cross gaps far too wide for any arch."
+  "Each new design solved a problem the earlier one could not."
+  "Today, engineers choose a design to fit the distance and the load."
+]
+claims [
+  claim id "c1" status supported dimension relationships-interactions subject "the bridge designs" standard ri-3 text "Each new bridge design fixed a problem the last one could not." cites ["e1" "e2" "e3"] {},
+  claim id "c2" status distractor error-type misreads-detail plausibility 0.8 targets ["q1"] text "Beam bridges were the strongest kind of bridge ever built." rationale "Misreads the passage; beam bridges were the weakest." cites ["e4"] {},
+  claim id "c3" status distractor error-type erroneous-inference plausibility 0.6 targets ["q1"] text "The Romans invented every type of bridge in the article." rationale "Not stated; they built arch bridges, not all types." cites ["e5"] {},
+  claim id "c4" status distractor error-type faulty-reasoning plausibility 0.6 targets ["q1"] text "Newer bridges are always prettier than older bridges." rationale "Beauty is never discussed; the text is about solving problems." cites ["e6"] {},
+  claim id "c5" status distractor error-type misreads-detail plausibility 0.5 targets ["q1"] text "Suspension bridges are built only from curved stone." rationale "Confuses suspension bridges (cables) with arch bridges (stone)." cites ["e7"] {},
+  claim id "c6" status distractor error-type erroneous-inference plausibility 0.5 targets ["q1"] text "Engineers today still prefer the simple beam bridge." rationale "Contradicted; they choose a design by distance and load." cites ["e8"] {}
+]
+evidence [
+  source id "e1" line 4 status directly-supports supports ["c1"] quote "The arch pushed the weight outward, so the bridge could carry heavy loads." {},
+  source id "e2" line 6 status directly-supports supports ["c1"] quote "Suspension bridges could cross gaps far too wide for any arch." {},
+  source id "e3" line 7 status directly-supports supports ["c1"] quote "Each new design solved a problem the earlier one could not." {},
+  source id "e4" line 2 status supports-wrong-claim supports ["c1" "c2"] quote "These beam bridges could only cross short gaps before they sagged." rationale "Describes a limit of one design, not the relationship across designs." {},
+  source id "e5" line 3 status supports-wrong-claim supports ["c3"] quote "To span wider rivers, the Romans built arch bridges out of curved stone." rationale "Backs the who-built-it detail, not the problem-solving relationship." {},
+  source id "e6" line 1 status irrelevant supports [] quote "Long ago, builders made bridges by laying flat stones across a stream." {},
+  source id "e7" line 5 status irrelevant supports [] quote "Later, engineers hung the roadway from cables in a suspension bridge." {},
+  source id "e8" line 8 status irrelevant supports [] quote "Today, engineers choose a design to fit the distance and the load." {}
+]
+outcomes [ outcome id "q1" type short-text task-model tm3 dimension relationships-interactions subject "the bridge designs" standard ri-3 focus "c1" stem "What conclusion can you draw about how each bridge design is related to the one before it? Explain using key details from the passage." {} ]
+{}..

package/spec/examples/c1-t4-tm1-ebsr.expect.json

@@ -0,0 +1,4 @@
+{
+  "prompt": "From a short story about a girl named Mara at a tide pool, author a c1-t4 Task Model 1 (EBSR) item about what Mara cares about: Part A asks which inference about Mara is supported, Part B asks for the supporting sentence(s). Dimension character, standard rl-1. Distractors are reasoning errors: an anger misread, a dislikes-outdoors erroneous inference, a fear faulty-reasoning, a bored misread.",
+  "expect": { "target": "c1-t4", "taskModel": "tm1", "itemType": "ebsr", "dimension": "character", "standard": "rl-1" }
+}

package/spec/examples/c1-t4-tm1-ebsr.gc

@@ -0,0 +1,30 @@
+target c1-t4 passage "The Tide Pool" type literary lines [
+  "Mara crouched at the edge of the tide pool, ignoring the picnic behind her."
+  "Her brother called twice, but she did not turn around."
+  "A tiny crab scuttled under a rock, and Mara smiled for the first time all day."
+  "She traced the cold water as if the pool were the only thing that mattered."
+  "Five more minutes, she whispered, though no one was listening."
+  "Behind her, paper plates rustled and her mother laughed."
+  "The waves pushed a ribbon of seaweed against her fingers."
+  "Her sandwich sat untouched on the blanket by the cooler."
+]
+claims [
+  claim id "c1" status supported dimension character subject "Mara" standard rl-1 text "Mara cares more about the tide pool than the picnic." cites ["e1" "e3" "e4"] {},
+  claim id "c2" status distractor error-type misreads-detail plausibility 0.9 targets ["q1"] text "Mara is angry at her brother for calling her." rationale "Her silence is absorption, not anger." cites ["e2"] {},
+  claim id "c3" status distractor error-type erroneous-inference plausibility 0.6 targets ["q1"] text "Mara does not like being outdoors at the beach." rationale "Contradicted by her smile at the crab." cites ["e6"] {},
+  claim id "c4" status distractor error-type faulty-reasoning plausibility 0.6 targets ["q1"] text "Mara is afraid of her own family at the beach." rationale "Her quiet whisper is treated as fear without support." cites ["e5"] {},
+  claim id "c5" status distractor error-type misreads-detail plausibility 0.5 targets ["q1"] text "Mara is bored by the quiet water of the tide pool." rationale "Her stillness shows focus, not boredom." cites ["e7"] {},
+  claim id "c6" status distractor error-type erroneous-inference plausibility 0.5 targets ["q1"] text "Mara wants to leave the beach and go home." rationale "Nothing shows a wish to leave; she asks for more time." cites ["e8"] {}
+]
+evidence [
+  source id "e1" line 1 status directly-supports supports ["c1"] quote "Mara crouched at the edge of the tide pool, ignoring the picnic behind her." {},
+  source id "e3" line 3 status directly-supports supports ["c1"] quote "A tiny crab scuttled under a rock, and Mara smiled for the first time all day." {},
+  source id "e4" line 4 status directly-supports supports ["c1"] quote "She traced the cold water as if the pool were the only thing that mattered." {},
+  source id "e2" line 2 status supports-wrong-claim supports ["c1" "c2"] quote "Her brother called twice, but she did not turn around." rationale "Looks like it supports the main inference but really backs the anger misreading." {},
+  source id "e5" line 5 status supports-wrong-claim supports ["c4"] quote "Five more minutes, she whispered, though no one was listening." rationale "Backs the fear misreading, not the correct inference." {},
+  source id "e6" line 6 status irrelevant supports [] quote "Behind her, paper plates rustled and her mother laughed." {},
+  source id "e7" line 7 status irrelevant supports [] quote "The waves pushed a ribbon of seaweed against her fingers." {},
+  source id "e8" line 8 status irrelevant supports [] quote "Her sandwich sat untouched on the blanket by the cooler." {}
+]
+outcomes [ outcome id "q1" type ebsr task-model tm1 dimension character subject "Mara" standard rl-1 focus "c1" stem "Which of these inferences about Mara is supported by the passage?" stem-b "Which sentence(s) from the passage best support your answer in Part A?" {} ]
+{}..

package/spec/examples/c1-t4-tm2-hottext.expect.json

@@ -0,0 +1,4 @@
+{
+  "prompt": "From the same tide-pool story, author a c1-t4 Task Model 2 (Hot Text) item: Part A is the best statement about what Mara cares about (an inference), and Part B highlights the sentences that support it. Dimension character, standard rl-1.",
+  "expect": { "target": "c1-t4", "taskModel": "tm2", "itemType": "hot-text", "dimension": "character", "standard": "rl-1" }
+}

package/spec/examples/c1-t4-tm2-hottext.gc

@@ -0,0 +1,30 @@
+target c1-t4 passage "The Tide Pool" type literary lines [
+  "Mara crouched at the edge of the tide pool, ignoring the picnic behind her."
+  "Her brother called twice, but she did not turn around."
+  "A tiny crab scuttled under a rock, and Mara smiled for the first time all day."
+  "She traced the cold water as if the pool were the only thing that mattered."
+  "Five more minutes, she whispered, though no one was listening."
+  "Behind her, paper plates rustled and her mother laughed."
+  "The waves pushed a ribbon of seaweed against her fingers."
+  "Her sandwich sat untouched on the blanket by the cooler."
+]
+claims [
+  claim id "c1" status supported dimension character subject "Mara" standard rl-1 text "Mara cares more about the tide pool than the picnic." cites ["e1" "e3" "e4"] {},
+  claim id "c2" status distractor error-type misreads-detail plausibility 0.9 targets ["q1"] text "Mara is angry at her brother for calling her." rationale "Her silence is absorption, not anger." cites ["e2"] {},
+  claim id "c3" status distractor error-type erroneous-inference plausibility 0.6 targets ["q1"] text "Mara does not like being outdoors at the beach." rationale "Contradicted by her smile at the crab." cites ["e6"] {},
+  claim id "c4" status distractor error-type faulty-reasoning plausibility 0.6 targets ["q1"] text "Mara is afraid of her own family at the beach." rationale "Her quiet whisper is treated as fear without support." cites ["e5"] {},
+  claim id "c5" status distractor error-type misreads-detail plausibility 0.5 targets ["q1"] text "Mara is bored by the quiet water of the tide pool." rationale "Her stillness shows focus, not boredom." cites ["e7"] {},
+  claim id "c6" status distractor error-type erroneous-inference plausibility 0.5 targets ["q1"] text "Mara wants to leave the beach and go home." rationale "Nothing shows a wish to leave; she asks for more time." cites ["e8"] {}
+]
+evidence [
+  source id "e1" line 1 status directly-supports supports ["c1"] quote "Mara crouched at the edge of the tide pool, ignoring the picnic behind her." {},
+  source id "e3" line 3 status directly-supports supports ["c1"] quote "A tiny crab scuttled under a rock, and Mara smiled for the first time all day." {},
+  source id "e4" line 4 status directly-supports supports ["c1"] quote "She traced the cold water as if the pool were the only thing that mattered." {},
+  source id "e2" line 2 status supports-wrong-claim supports ["c1" "c2"] quote "Her brother called twice, but she did not turn around." rationale "Looks like it supports the main inference but really backs the anger misreading." {},
+  source id "e5" line 5 status supports-wrong-claim supports ["c4"] quote "Five more minutes, she whispered, though no one was listening." rationale "Backs the fear misreading, not the correct inference." {},
+  source id "e6" line 6 status irrelevant supports [] quote "Behind her, paper plates rustled and her mother laughed." {},
+  source id "e7" line 7 status irrelevant supports [] quote "The waves pushed a ribbon of seaweed against her fingers." {},
+  source id "e8" line 8 status irrelevant supports [] quote "Her sandwich sat untouched on the blanket by the cooler." {}
+]
+outcomes [ outcome id "q1" type hot-text task-model tm2 dimension character subject "Mara" standard rl-1 focus "c1" stem "Click on the statement that best provides an inference about Mara that is supported by the passage." {} ]
+{}..

package/spec/examples/c1-t4-tm3-shorttext.expect.json

@@ -0,0 +1,4 @@
+{
+  "prompt": "From the same tide-pool story, author a c1-t4 Task Model 3 (Short Text) constructed-response item asking what inference can be made about Mara, explained with key details from the passage. Dimension character, standard rl-1.",
+  "expect": { "target": "c1-t4", "taskModel": "tm3", "itemType": "short-text", "dimension": "character", "standard": "rl-1" }
+}