Workspace Intelligence / JSON Schema
Workspai Workspace Intelligence History
Defines the versioned workspace intelligence history v1 boundary used by Workspai and its consumers.
- Schema version
workspace-intelligence-history.v1- Contract path
contracts/workspace-intelligence/workspace-intelligence-history.v1.json- Publication
- embedded-type, json-schema
- Defined fields
- 21
- Artifact bindings
- 1
Why this contract exists
Architecture role
Defines a versioned interoperability boundary used by Workspai and contract-aware consumers.
Consumption boundary
- • Workspai CLI
- • Workspace Intelligence consumers
- • IDEs and agents
Related commands
Commands are linked only when the runtime contract identifies a direct production relationship. Supporting contracts may be consumed without having a single producer command.
Produced artifacts
These durable files are emitted by registered commands and validated against this contract.
| Artifact path | Schema | Producer |
|---|---|---|
| .workspai/reports/workspace-intelligence-history.json | workspace-intelligence-history.v1 | workspai workspace verify --from-impact .workspai/reports/workspace-impact-last-run.json --json workspai workspace feedback record --json |
Field reference
Every declared schema property or published capability path is listed here. Required means the contract declares or publishes that field at the shown boundary.
| Field path | Type | Required | Meaning | Constraints |
|---|---|---|---|---|
| entries | array | Yes | Defines the entries value at this contract boundary. | — |
| entries[].actionId | string | No | Defines the actionid value at this contract boundary. | — |
| entries[].affectedProjects | integer | No | Defines the affectedprojects value at this contract boundary. | minimum: 0 |
| entries[].applied | integer | No | Defines the applied value at this contract boundary. | minimum: 0 |
| entries[].blockingReasons | integer | No | Defines the blockingreasons value at this contract boundary. | minimum: 0 |
| entries[].evidenceSha256 | string | No | Defines the evidencesha256 value at this contract boundary. | — |
| entries[].failed | integer | No | Defines the failed value at this contract boundary. | minimum: 0 |
| entries[].freshness | enum | No | Defines the freshness value at this contract boundary. | enum: fresh, stale, unknown |
| entries[].gatePassed | boolean | No | Defines the gatepassed value at this contract boundary. | — |
| entries[].generatedAt | string | Yes | Defines the generatedat value at this contract boundary. | format: date-time |
| entries[].kind | enum | No | Defines the kind value at this contract boundary. | enum: verify, agent-action, doctor-fix |
| entries[].outcome | enum | No | Defines the outcome value at this contract boundary. | enum: ok, failed |
| entries[].policyViolations | integer | No | Defines the policyviolations value at this contract boundary. | minimum: 0 |
| entries[].remainingBlockers | integer | No | Defines the remainingblockers value at this contract boundary. | minimum: 0 |
| entries[].risk | string | No | Defines the risk value at this contract boundary. | — |
| entries[].scope | string | No | Defines the scope value at this contract boundary. | — |
| entries[].skipped | integer | No | Defines the skipped value at this contract boundary. | minimum: 0 |
| entries[].summary | string | No | Defines the summary value at this contract boundary. | — |
| entries[].verdict | enum | No | Defines the verdict value at this contract boundary. | enum: ready, needs-attention, blocked |
| retention | integer | Yes | Defines the retention value at this contract boundary. | minimum: 1 |
| schemaVersion | string | Yes | Defines the schemaversion value at this contract boundary. | const: "workspace-intelligence-history.v1" |
Canonical machine-readable definition
The raw synchronized contract remains authoritative. The educational sections above are projections of this definition.
Show raw JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://getrapidkit.com/schemas/workspace-intelligence-history.v1.json",
"title": "Workspai Workspace Intelligence History",
"type": "object",
"required": [
"schemaVersion",
"retention",
"entries"
],
"properties": {
"schemaVersion": {
"const": "workspace-intelligence-history.v1"
},
"retention": {
"type": "integer",
"minimum": 1
},
"entries": {
"type": "array",
"items": {
"type": "object",
"required": [
"generatedAt"
],
"properties": {
"generatedAt": {
"type": "string",
"format": "date-time"
},
"kind": {
"enum": [
"verify",
"agent-action",
"doctor-fix"
]
},
"verdict": {
"enum": [
"ready",
"needs-attention",
"blocked"
]
},
"risk": {
"type": "string"
},
"affectedProjects": {
"type": "integer",
"minimum": 0
},
"freshness": {
"enum": [
"fresh",
"stale",
"unknown"
]
},
"gatePassed": {
"type": "boolean"
},
"blockingReasons": {
"type": "integer",
"minimum": 0
},
"policyViolations": {
"type": "integer",
"minimum": 0
},
"actionId": {
"type": "string"
},
"scope": {
"type": "string"
},
"summary": {
"type": "string"
},
"outcome": {
"enum": [
"ok",
"failed"
]
},
"evidenceSha256": {
"type": "string"
},
"applied": {
"type": "integer",
"minimum": 0
},
"failed": {
"type": "integer",
"minimum": 0
},
"skipped": {
"type": "integer",
"minimum": 0
},
"remainingBlockers": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": true
}
}
},
"additionalProperties": false
}