aiwg/agentic/code/addons/rlm/schemas/citation-tuple.json

Deployment tool and support utility for AI context. Copies agents, skills, commands, rules, and behaviors into the paths each AI platform reads (Claude Code, Codex, Copilot, Cursor, Warp, OpenClaw, and 6 more) so one source of truth works across 10 platfo

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://aiwg.io/schemas/rlm/citation-tuple.json",
  "title": "RLM Citation Tuple",
  "description": "Citation linking an RLM-emitted finding to a specific artifact + content version. Issued by sub-agents when rlm-batch runs with --require-citations. Verified downstream by `aiwg verify-citations --rlm`.",
  "type": "object",
  "required": ["artifact_id"],
  "properties": {
    "artifact_id": {
      "type": "string",
      "description": "Project-relative path to the cited artifact. Matches the existing index `artifactId` convention (src/artifacts/types.ts, src/artifacts/audit/types.ts).",
      "minLength": 1,
      "examples": [
        "src/auth/login.ts",
        ".aiwg/requirements/UC-007.md"
      ]
    },
    "content_hash": {
      "type": "string",
      "description": "sha256 of the artifact content, truncated to the first 16 hex chars. Matches src/artifacts/index-builder.ts:243. Omit for path-only fallback citations (artifact not in the index).",
      "pattern": "^[0-9a-f]{16}$",
      "examples": [
        "a8f9c2d4e5f60718",
        "b3d1e9c2f48a5b6c"
      ]
    },
    "lines": {
      "type": "string",
      "description": "Cited line range. `L<start>-<end>` for a range, `L<n>` for a single line. Omit for whole-file citations.",
      "pattern": "^L\\d+(-\\d+)?$",
      "examples": ["L42-58", "L101", "L1-50"]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "artifact_id": "src/auth/login.ts",
      "content_hash": "a8f9c2d4e5f60718",
      "lines": "L42-58"
    },
    {
      "artifact_id": "src/auth/sessionManager.ts",
      "content_hash": "b3d1e9c2f48a5b6c",
      "lines": "L101"
    },
    {
      "artifact_id": "src/legacy/auth.py",
      "lines": "L88"
    }
  ],
  "x-inline-form": {
    "description": "When rendered inline in markdown output, use bracketed form `[artifact_id@content_hash, lines]` or `[artifact_id, lines]` for path-only fallback.",
    "pattern": "\\[(?<artifact_id>[^@\\]]+)(@(?<content_hash>[0-9a-f]{16}))?(, (?<lines>L\\d+(-\\d+)?))?\\]",
    "examples": [
      "[src/auth/login.ts@a8f9c2d4e5f60718, L42-58]",
      "[src/legacy/auth.py, L88]"
    ]
  },
  "x-references": {
    "issues": ["#1205", "#1223"],
    "epic": "#1196",
    "adr": ".aiwg/architecture/adr-rlm-index-integration.md",
    "skill": "agentic/code/addons/rlm/skills/rlm-batch/SKILL.md",
    "hash_implementation": "src/artifacts/index-builder.ts:243"
  }
}