Skip to content

continuity.status

This device and repository identity, the record this checkout continues on its branch, how the local continuity store stands towards the remote's (from the refs alone, no network), every line of work with its heads, the handovers other devices published that this checkout could resume, and every refused record or broken lineage as a diagnostic. A diverged line — the same work continued twice — is reported; separate lines of work on separate devices are not a conflict.

This device and repository identity, the record this checkout continues on its branch, how the local continuity store stands towards the remote's (from the refs alone, no network), every line of work with its heads, the handovers other devices published that this checkout could resume, and every refused record or broken lineage as a diagnostic. A diverged line — the same work continued twice — is reported; separate lines of work on separate devices are not a conflict.

Exposure

Where this one definition is reachable. Absence is explicit: a surface not listed does not carry it.

surfaceas
MCPtool majordomus_continuity_status
HTTPGET /api/v1/continuity/status operationId continuity.status
command linemajordomus continuity status

Schemas

The canonical input and output, from the Rust types; the MCP tool schema and the OpenAPI parameters and responses are derived from these.

input · Empty

No input.

No properties: the capability takes no input.

JSON Schema 
{
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty",
  "type": "object"
}

output · Status

The answer of continuity status.
propertytyperequireddescription
branch string yes The branch this checkout is on, or DETACHED.
device reference yes This device.
diagnostics array yes Refused files, broken lineage, diverged lines.
head string | null no The commit it is on.
last_sync one of 2 no The last sync, as this checkout recorded it.
lines array yes Every line, by id.
next array no The command to run next, when there is an obvious one.
position one of 2 no The record this checkout continues on its branch.
repository string yes This repository's identity (32 hex), the same on every clone.
resumable array yes What other devices published that this checkout could resume, newest first.
store reference yes The stores.
working_tree reference yes Clean or dirty.
JSON Schema 
{
  "$defs": {
    "Device": {
      "description": "The device a record was written on: the mesh node key's id and the label its identity\nfile carries. The label is presentation; the node id is identity.",
      "properties": {
        "label": {
          "description": "The display label of the device's identity file (`macbook-pro`), or the first eight\nhex of its node id when it has none.",
          "type": "string"
        },
        "node": {
          "description": "The node id: the first 32 hex of the SHA-256 of the device's Ed25519 public key.",
          "type": "string"
        }
      },
      "required": [
        "node",
        "label"
      ],
      "type": "object"
    },
    "Diagnostic": {
      "description": "One finding about the declarative state, named by a stable code, tied to a path where\nthere is one, and carrying the command that reproduces it where there is one.",
      "properties": {
        "code": {
          "description": "A stable machine-readable code, e.g. `unknown_key`, `duplicate_identity`.",
          "type": "string"
        },
        "message": {
          "description": "What is wrong, for a person; the code is for a program.",
          "type": "string"
        },
        "path": {
          "description": "Repository-relative path of the file concerned, when there is one.",
          "type": [
            "string",
            "null"
          ]
        },
        "severity": {
          "$ref": "#/$defs/Severity",
          "description": "How bad."
        }
      },
      "required": [
        "severity",
        "code",
        "message"
      ],
      "type": "object"
    },
    "LineState": {
      "description": "Whether a line has one current record or several.",
      "oneOf": [
        {
          "const": "linear",
          "description": "One head: the line continues from it.",
          "type": "string"
        },
        {
          "const": "diverged",
          "description": "More than one head: the same work was continued in more than one place.",
          "type": "string"
        }
      ]
    },
    "LineView": {
      "description": "A line of work as `status` shows it.",
      "properties": {
        "heads": {
          "description": "Its heads.",
          "items": {
            "$ref": "#/$defs/RecordView"
          },
          "type": "array"
        },
        "id": {
          "description": "The line id.",
          "type": "string"
        },
        "records": {
          "description": "How many records it holds.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "state": {
          "$ref": "#/$defs/LineState",
          "description": "Linear or diverged."
        }
      },
      "required": [
        "id",
        "state",
        "records",
        "heads"
      ],
      "type": "object"
    },
    "Position": {
      "description": "The record this checkout continues on one branch.",
      "properties": {
        "at": {
          "description": "When, by this machine's clock.",
          "type": "string"
        },
        "line": {
          "description": "The line.",
          "type": "string"
        },
        "record": {
          "description": "The record: the parent of this checkout's next publication on the branch.",
          "type": "string"
        },
        "via": {
          "$ref": "#/$defs/Via",
          "description": "Published here or resumed here."
        }
      },
      "required": [
        "line",
        "record",
        "via",
        "at"
      ],
      "type": "object"
    },
    "RecordView": {
      "description": "One record as every surface shows it.",
      "properties": {
        "age_minutes": {
          "description": "Minutes since then, by this machine's clock; absent when either clock's reading is\nunusable.",
          "format": "int64",
          "type": [
            "integer",
            "null"
          ]
        },
        "branch": {
          "description": "The branch it was written on.",
          "type": [
            "string",
            "null"
          ]
        },
        "changed_total": {
          "description": "How many paths differed from HEAD at the origin.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "device": {
          "$ref": "#/$defs/Device",
          "description": "The device that published it."
        },
        "head": {
          "description": "The commit it was written at.",
          "type": [
            "string",
            "null"
          ]
        },
        "id": {
          "description": "The record id.",
          "type": "string"
        },
        "issue": {
          "description": "The issue.",
          "type": [
            "string",
            "null"
          ]
        },
        "line": {
          "description": "Its line.",
          "type": "string"
        },
        "objective": {
          "description": "The handover's `# Objective`, first line.",
          "type": "string"
        },
        "parent": {
          "description": "The record it continues.",
          "type": [
            "string",
            "null"
          ]
        },
        "published_at": {
          "description": "When it was published, by the publisher's clock.",
          "type": "string"
        },
        "session": {
          "description": "The episode it was published from.",
          "type": [
            "string",
            "null"
          ]
        },
        "task": {
          "description": "The task's title: the intent.",
          "type": [
            "string",
            "null"
          ]
        },
        "this_device": {
          "description": "Whether that device is this one.",
          "type": "boolean"
        },
        "trust": {
          "$ref": "#/$defs/Trust",
          "description": "Whether its signer is trusted here."
        },
        "working_tree": {
          "$ref": "#/$defs/WorkingTree",
          "description": "Clean or dirty at the origin."
        }
      },
      "required": [
        "id",
        "line",
        "device",
        "this_device",
        "trust",
        "working_tree",
        "changed_total",
        "published_at"
      ],
      "type": "object"
    },
    "Severity": {
      "description": "How bad a diagnostic is. `Error` excludes the file it concerns from the index and puts\nthe index into the degraded state; `Warning` and `Info` do neither.",
      "oneOf": [
        {
          "const": "info",
          "description": "Worth knowing; changes nothing.",
          "type": "string"
        },
        {
          "const": "warning",
          "description": "Something to look at; the object is still served.",
          "type": "string"
        },
        {
          "const": "error",
          "description": "The file is excluded and the index is degraded.",
          "type": "string"
        }
      ]
    },
    "StoreView": {
      "description": "The two stores, as refs.",
      "properties": {
        "records": {
          "description": "Records admitted.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "reference": {
          "description": "The local ref.",
          "type": "string"
        },
        "refused": {
          "description": "Files refused.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "remote": {
          "description": "The remote `sync` uses.",
          "type": [
            "string",
            "null"
          ]
        },
        "remote_tip": {
          "description": "The commit last fetched from or pushed to it.",
          "type": [
            "string",
            "null"
          ]
        },
        "sync": {
          "$ref": "#/$defs/SyncState",
          "description": "How they stand."
        },
        "tip": {
          "description": "Its commit.",
          "type": [
            "string",
            "null"
          ]
        }
      },
      "required": [
        "reference",
        "sync",
        "records",
        "refused"
      ],
      "type": "object"
    },
    "SyncNote": {
      "description": "What the last sync did, so that a later status can report it without the network.",
      "properties": {
        "at": {
          "description": "When, by this machine's clock.",
          "type": "string"
        },
        "detail": {
          "description": "What git said when it was not `ok`.",
          "type": [
            "string",
            "null"
          ]
        },
        "outcome": {
          "description": "`ok`, or `unreachable` when the remote could not be asked.",
          "type": "string"
        },
        "remote": {
          "description": "The remote.",
          "type": "string"
        }
      },
      "required": [
        "remote",
        "at",
        "outcome"
      ],
      "type": "object"
    },
    "SyncState": {
      "description": "How the local store stands towards the remote's, from the refs alone — no network.",
      "oneOf": [
        {
          "const": "no_remote",
          "description": "No remote is configured: the store is local, and that is a valid answer.",
          "type": "string"
        },
        {
          "const": "never_synced",
          "description": "Never synced with the remote.",
          "type": "string"
        },
        {
          "const": "in_sync",
          "description": "Both hold the same records.",
          "type": "string"
        },
        {
          "const": "pending",
          "description": "This store holds records the remote has not received: a sync publishes them.",
          "type": "string"
        },
        {
          "const": "behind",
          "description": "The last fetch brought records not merged yet.",
          "type": "string"
        },
        {
          "const": "diverged",
          "description": "Both of the above.",
          "type": "string"
        },
        {
          "const": "empty",
          "description": "The store is empty and nothing was ever fetched.",
          "type": "string"
        }
      ]
    },
    "Trust": {
      "description": "Whether the device that signed a record is one this repository trusts.",
      "oneOf": [
        {
          "const": "this_device",
          "description": "This device signed it.",
          "type": "string"
        },
        {
          "const": "trusted",
          "description": "The mesh declaration's trust list admits the key.",
          "type": "string"
        },
        {
          "const": "untrusted",
          "description": "The mesh declaration exists and does not admit the key: never resumed from.",
          "type": "string"
        },
        {
          "const": "undeclared",
          "description": "The repository declares no mesh, so no list exists to check the key against. The\nsignature still binds the record to its key; the plan warns.",
          "type": "string"
        }
      ]
    },
    "Via": {
      "description": "How this checkout came to stand on a record.",
      "oneOf": [
        {
          "const": "published",
          "description": "This checkout published it.",
          "type": "string"
        },
        {
          "const": "resumed",
          "description": "This checkout resumed from it.",
          "type": "string"
        }
      ]
    },
    "WorkingTree": {
      "description": "Whether the working tree had changes git does not hold in a commit.",
      "oneOf": [
        {
          "const": "clean",
          "description": "Nothing outside HEAD.",
          "type": "string"
        },
        {
          "const": "dirty",
          "description": "Modified, staged or untracked files that HEAD does not hold.",
          "type": "string"
        }
      ]
    }
  },
  "description": "The answer of `continuity status`.",
  "properties": {
    "branch": {
      "description": "The branch this checkout is on, or `DETACHED`.",
      "type": "string"
    },
    "device": {
      "$ref": "#/$defs/Device",
      "description": "This device."
    },
    "diagnostics": {
      "description": "Refused files, broken lineage, diverged lines.",
      "items": {
        "$ref": "#/$defs/Diagnostic"
      },
      "type": "array"
    },
    "head": {
      "description": "The commit it is on.",
      "type": [
        "string",
        "null"
      ]
    },
    "last_sync": {
      "anyOf": [
        {
          "$ref": "#/$defs/SyncNote"
        },
        {
          "type": "null"
        }
      ],
      "description": "The last sync, as this checkout recorded it."
    },
    "lines": {
      "description": "Every line, by id.",
      "items": {
        "$ref": "#/$defs/LineView"
      },
      "type": "array"
    },
    "next": {
      "description": "The command to run next, when there is an obvious one.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "position": {
      "anyOf": [
        {
          "$ref": "#/$defs/Position"
        },
        {
          "type": "null"
        }
      ],
      "description": "The record this checkout continues on its branch."
    },
    "repository": {
      "description": "This repository's identity (32 hex), the same on every clone.",
      "type": "string"
    },
    "resumable": {
      "description": "What other devices published that this checkout could resume, newest first.",
      "items": {
        "$ref": "#/$defs/RecordView"
      },
      "type": "array"
    },
    "store": {
      "$ref": "#/$defs/StoreView",
      "description": "The stores."
    },
    "working_tree": {
      "$ref": "#/$defs/WorkingTree",
      "description": "Clean or dirty."
    }
  },
  "required": [
    "repository",
    "device",
    "branch",
    "working_tree",
    "store",
    "lines",
    "resumable",
    "diagnostics"
  ],
  "title": "Status",
  "type": "object"
}

Policies

benchmark
required — a target on every transport the exposure declares; the cases are the input type's
cache
disabled — every call runs the handler

Benchmark targets

Derived from the registry for this repository: one requirement per transport, and the cases the input type provides. The whole matrix is on the benchmarks page.

transportstatecasestargets
directcovered1default
mcpcovered1default
httpcovered1default

Searches the titles and descriptions of every page this site publishes.