ReviewsSummaryRevision `reviews.summary-revision@1`

Generated at 2026-09-26 00:45:03 UTC from openvibe-contracts v0.53.0 and openvibe-sdk v0.11.0.

Version: 1.0.0
Owner: reviews
Visibility: first-party
Status: active
Compatibility: backward
Schema: https://openvibe.network/contracts/reviews/summary-revision.v1.json

reviews.summary-revision@1: one immutable summary revision as OpenVibe.Reviews shows it (server/reviews/service.js summaryRevisionView): the overview and each point with the signals it cites and whether they are still live signals of the entity, its authorship (AI proposals name the workflow and run), the latest review, the system reason of a pending revision and the public correction note. A summary never carries a rating. Readers see the author of a person's revision as "an editor".

Fields

Field	Type	Required	Description	Constraints
`number`	integer	yes		`minimum 1`
`status`	enum	yes		`one of "published", "rejected", "superseded", "pending_system", "pending_ai", "draft"`
`overview`	string	yes
`points`	array of object	yes
`points[].key`	string	yes	overview, pro:<i> or con:<i>.
`points[].kind`	enum	yes		`one of "overview", "pro", "con"`
`points[].text`	string \| null	yes	null for the overview (its text is overview).
`points[].supported`	boolean	yes
`points[].citations`	array of object	yes
`points[].citations[].signal_id`	string	yes
`points[].citations[].ok`	boolean	yes
`points[].citations[].status`	enum	yes		`one of "active", "superseded", "withdrawn", "missing"`
`points[].citations[].in_entity`	boolean	yes
`points[].citations[].superseded_by`	string \| null	yes
`authorship`	object \| null	yes
`disclosure`	object \| null	yes
`review`	object \| null	yes
`system`	object \| null	yes	A revision Reviews prepared after a cited signal left: { reason, signals, base_revision, dropped_points }.
`correction`	object \| null	yes
`author`	string \| null	yes
`message`	string \| null	yes
`created_at`	string	yes		`format date-time`

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: ai-pending

{
  "number": 3,
  "status": "pending_ai",
  "overview": "Well-reviewed for comfort; battery life is the common complaint.",
  "points": [
    {
      "key": "overview",
      "kind": "overview",
      "text": null,
      "supported": true,
      "citations": [
        {
          "signal_id": "sig_01JAC2S3G4H5J6K7M8N9P0Q1R2",
          "ok": true,
          "status": "active",
          "in_entity": true,
          "superseded_by": null
        }
      ]
    },
    {
      "key": "pro:0",
      "kind": "pro",
      "text": "Comfortable over long sessions",
      "supported": true,
      "citations": [
        {
          "signal_id": "sig_01JAC2S4G4H5J6K7M8N9P0Q1R2",
          "ok": true,
          "status": "active",
          "in_entity": true,
          "superseded_by": null
        }
      ]
    }
  ],
  "authorship": {
    "mode": "ai",
    "workflow": {
      "id": "reviews.summarize_entity",
      "runId": "run_01JAC8R9S0T1V2W3X4Y5Z6A7B8"
    },
    "stub_provider": false
  },
  "disclosure": {
    "mode": "ai",
    "short": "AI-generated",
    "long": "AI-generated by workflow reviews.summarize_entity, not yet reviewed by a person."
  },
  "review": null,
  "system": null,
  "correction": null,
  "author": "svc:ai",
  "message": "AI proposal",
  "created_at": "2026-09-24T09:40:12.000Z"
}

Valid: published

{
  "number": 2,
  "status": "published",
  "overview": "Well-reviewed for comfort; battery life is the common complaint.",
  "points": [
    {
      "key": "overview",
      "kind": "overview",
      "text": null,
      "supported": true,
      "citations": [
        {
          "signal_id": "sig_01JAC2S3G4H5J6K7M8N9P0Q1R2",
          "ok": true,
          "status": "active",
          "in_entity": true,
          "superseded_by": null
        }
      ]
    },
    {
      "key": "pro:0",
      "kind": "pro",
      "text": "Comfortable over long sessions",
      "supported": true,
      "citations": [
        {
          "signal_id": "sig_01JAC2S4G4H5J6K7M8N9P0Q1R2",
          "ok": true,
          "status": "active",
          "in_entity": true,
          "superseded_by": null
        }
      ]
    }
  ],
  "authorship": {
    "mode": "human",
    "workflow": null,
    "stub_provider": false
  },
  "disclosure": null,
  "review": null,
  "system": null,
  "correction": null,
  "author": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "message": null,
  "created_at": "2026-09-24T09:40:12.000Z"
}

Rejected: bad-status

{
  "number": 2,
  "status": "live",
  "overview": "Well-reviewed for comfort; battery life is the common complaint.",
  "points": [
    {
      "key": "overview",
      "kind": "overview",
      "text": null,
      "supported": true,
      "citations": [
        {
          "signal_id": "sig_01JAC2S3G4H5J6K7M8N9P0Q1R2",
          "ok": true,
          "status": "active",
          "in_entity": true,
          "superseded_by": null
        }
      ]
    },
    {
      "key": "pro:0",
      "kind": "pro",
      "text": "Comfortable over long sessions",
      "supported": true,
      "citations": [
        {
          "signal_id": "sig_01JAC2S4G4H5J6K7M8N9P0Q1R2",
          "ok": true,
          "status": "active",
          "in_entity": true,
          "superseded_by": null
        }
      ]
    }
  ],
  "authorship": {
    "mode": "human",
    "workflow": null,
    "stub_provider": false
  },
  "disclosure": null,
  "review": null,
  "system": null,
  "correction": null,
  "author": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "message": null,
  "created_at": "2026-09-24T09:40:12.000Z"
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('reviews.summary-revision@1', value);   // { valid, errors: [{ path, message }] }

ReviewsSummaryRevision reviews.summary-revision@1

Fields

Examples

Validate

ReviewsSummaryRevision `reviews.summary-revision@1`