@citeark/agent 0.3.20

package/schemas/research-card.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://citeark.com/schemas/research/card-1.0.json",
+  "title": "CiteArk derived research card",
+  "type": "object",
+  "required": ["schemaVersion", "kind", "generatedAt", "work", "sources", "claims", "experiments", "latestExecution", "verifiedConclusion", "canonicalRecords", "renderingPolicy", "cardDigest"],
+  "properties": {
+    "schemaVersion": { "const": "1.0" },
+    "kind": { "const": "citeark.research-card" },
+    "generatedAt": { "type": "string" },
+    "work": { "type": "object" },
+    "sources": { "type": "array" },
+    "claims": { "type": "array" },
+    "experiments": { "type": "array" },
+    "latestExecution": { "type": "object" },
+    "verifiedConclusion": { "$ref": "verified-conclusion.schema.json" },
+    "license": { "type": "object" },
+    "provenance": { "type": "object" },
+    "canonicalRecords": { "type": "object" },
+    "renderingPolicy": {
+      "type": "object",
+      "required": ["canonical", "verificationAuthority"],
+      "properties": {
+        "canonical": { "const": false },
+        "verificationAuthority": { "const": "primaryAssessment CAP Record" }
+      }
+    },
+    "cardDigest": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }
+  }
+}

package/schemas/research-inventory-draft.schema.json

@@ -0,0 +1,366 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://citeark.com/schemas/research/inventory-draft-1.0.json",
+  "title": "Paper research inventory draft",
+  "description": "Source content only. The host adds normalized versions and pending dispositions; reproduction planning happens later.",
+  "type": "object",
+  "required": ["work", "sources", "claims"],
+  "properties": {
+    "reading": {
+      "type": "object",
+      "required": [
+        "schemaVersion",
+        "overview",
+        "mainline",
+        "branches"
+      ],
+      "properties": {
+        "schemaVersion": {
+          "const": "1.0"
+        },
+        "overview": {
+          "type": "string",
+          "minLength": 1
+        },
+        "mainline": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^(object|claim|hypothesis|source):.+"
+          }
+        },
+        "branches": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "parent",
+              "children"
+            ],
+            "properties": {
+              "parent": {
+                "type": "string",
+                "pattern": "^(object|claim|hypothesis|source):.+"
+              },
+              "children": {
+                "type": "array",
+                "uniqueItems": true,
+                "items": {
+                  "type": "string",
+                  "pattern": "^(object|claim|hypothesis|source):.+"
+                }
+              }
+            }
+          }
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "target",
+              "title"
+            ],
+            "properties": {
+              "target": {
+                "type": "string",
+                "pattern": "^(object|claim|hypothesis|source):.+"
+              },
+              "title": {
+                "type": "string",
+                "minLength": 1
+              },
+              "subtype": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "researchRelations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "from",
+          "to",
+          "predicate",
+          "basis",
+          "sourceLocators"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "from": {
+            "type": "string",
+            "pattern": "^(object|claim|hypothesis|source):.+"
+          },
+          "to": {
+            "type": "string",
+            "pattern": "^(object|claim|hypothesis|source):.+"
+          },
+          "predicate": {
+            "enum": [
+              "about",
+              "describes",
+              "derivedFrom",
+              "assertedIn",
+              "attributedTo",
+              "plannedFor",
+              "requires",
+              "used",
+              "generated",
+              "follows",
+              "associatedWith",
+              "partOf",
+              "evidenceFor",
+              "assesses",
+              "basedOn"
+            ]
+          },
+          "basis": {
+            "enum": [
+              "declared",
+              "inferred"
+            ]
+          },
+          "sourceLocators": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "object",
+              "required": [
+                "sourceId",
+                "locator"
+              ],
+              "properties": {
+                "sourceId": {
+                  "type": "string"
+                },
+                "locator": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          },
+          "note": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "researchObjects": {
+      "type": "array",
+      "description": "Independently addressable scientific objects, reused by explicit identity across routes.",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "role",
+          "title"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "sourceId": {
+            "type": "string",
+            "description": "Identity of an existing material source. Use sourceLocators for mentions; a derived split gets its own identity."
+          },
+          "role": {
+            "enum": [
+              "dataset",
+              "sample",
+              "model",
+              "checkpoint",
+              "code",
+              "method",
+              "observation",
+              "material", "question", "concept", "premise", "argument", "research-plan", "research-activity", "source-assessment", "person", "organization", "instrument"
+            ]
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "description": {
+            "type": "string"
+          },
+          "observationKind": {"enum": ["scalar", "table", "matrix", "series", "collection"], "description": "Source-grounded representation of an observation collection; not its scientific conclusion."},
+          "basis": {
+            "enum": [
+              "declared",
+              "inferred"
+            ]
+          },
+          "identity": {
+            "type": "object",
+            "description": "Only source-grounded identities: URI, revision, digest, split, architecture, seed. Omit unknown values."
+          },
+          "conditions": {},
+          "sourceLocators": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "sourceId",
+                "locator"
+              ],
+              "properties": {
+                "sourceId": {
+                  "type": "string"
+                },
+                "locator": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              }
+            }
+          },
+          "derivedFromIds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "prospective": {
+            "type": "boolean",
+            "description": "True for expected objects that this planned run has not produced."
+          },
+          "limitations": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "work": {
+      "type": "object", "required": ["title", "authors", "abstract", "significance"],
+      "properties": {
+        "title": { "type": "string" }, "authors": { "type": "array", "items": { "type": "string" } },
+        "abstract": { "type": "string", "description": "An objective summary in your own words, 80–120 words." },
+        "significance": { "type": "string", "description": "Separate plain-language meaning and limits." }
+      }
+    },
+    "sources": {
+      "type": "array", "items": {
+        "type": "object", "required": ["id", "kind", "uri"],
+        "properties": {
+          "id": { "type": "string" }, "kind": { "enum": ["paper", "repository", "dataset", "supplement", "checkpoint"] },
+          "uri": { "type": "string" }
+        }
+      }
+    },
+    "hypotheses": {
+      "type": "array",
+      "description": "Source-proposed explanations, distinct from empirical claims and scientific assessments. No execution disposition or support verdict.",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "statement",
+          "sourceLocator"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "statement": {
+            "type": "string",
+            "minLength": 1
+          },
+          "sourceLocator": {
+            "type": "object",
+            "required": [
+              "sourceId",
+              "locator"
+            ],
+            "properties": {
+              "sourceId": {
+                "type": "string"
+              },
+              "locator": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          },
+          "objectIds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string"
+            }
+          },
+          "conditions": {},
+          "limitations": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "claims": {
+      "type": "array", "minItems": 1, "items": {
+        "type": "object", "required": ["id", "type", "statement", "sourceLocator", "reportedMeasurements"],
+        "properties": {
+          "objectIds": {
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "id": { "type": "string" }, "type": { "enum": ["finding", "measurement", "method", "limitation"] },
+          "statement": { "type": "string" }, "sourceLocator": { "$ref": "#/$defs/locator" },
+          "conditions": { "description": "Necessary source-reported conditions; label unknowns explicitly." },
+          "relations": { "description": "Source-grounded comparisons and relationships with other results." },
+          "ambiguities": { "description": "Preserve source contradictions and unresolved source interpretation." },
+          "verificationHint": { "type": "string", "description": "Optional initial direction, not a completed verification plan." },
+          "reportedMeasurements": {
+            "type": "array", "description": "Empty for qualitative findings without a reliable numeric reference.",
+            "items": {
+              "type": "object", "required": ["id", "metric", "unit", "value"],
+              "properties": {
+                "objectIds": {
+                  "type": "array",
+                  "uniqueItems": true,
+                  "items": {
+                    "type": "string",
+                    "minLength": 1
+                  }
+                },
+                "observationId": {"type": "string", "minLength": 1, "description": "Explicit source observation collection identity in researchObjects; numerical rows retain their own measurement IDs."},
+                "id": { "type": "string" }, "metric": { "type": "string" }, "unit": { "type": "string" },
+                "value": { "type": "number" }, "sourceLocator": { "$ref": "#/$defs/locator" },
+                "dimensions": { "type": "object" }, "conditions": {}, "aggregation": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "locator": {
+      "type": "object", "required": ["sourceId", "locator"],
+      "properties": { "sourceId": { "type": "string" }, "locator": { "type": "string" } }
+    }
+  }
+}