{
  "schemaVersion": "artifactDefinition.v2",
  "definitionId": "CNI.artifactDefinition.v2",
  "artifactId": "CNI",
  "title": "Companion Navigation Index",
  "artifactType": "Index",
  "format": "xlsx",
  "productTier": "Basic",
  "definitionRole": "contract",
  "sourceModel": {
    "body": "canonical human-readable body in this Contract and the matching Example JSON",
    "jsonDefinition": "machine-readable contract and validation model",
    "jsonExample": "curated realistic example data fixture"
  },
  "purpose": "Prevent cross-book duplication and help users navigate the complete companion system.",
  "sections": [
    {
      "order": 1,
      "id": "title_page",
      "title": "Title Page",
      "contentType": "metadata",
      "required": true,
      "hint": null
    },
    {
      "order": 2,
      "id": "abstract",
      "title": "Abstract",
      "contentType": "narrative",
      "required": true,
      "hint": {
        "text": "Use this artifact as an evidence-backed working record. A completed field without an owner, date or source reference is not audit-ready.",
        "bookReference": "Volume 1, S-00-01-00 Context of the Organization (Clause 4"
      }
    },
    {
      "order": 3,
      "id": "document_control",
      "title": "Document Control",
      "contentType": "control_table",
      "required": true,
      "hint": null
    },
    {
      "order": 4,
      "id": "instructions",
      "title": "Instructions",
      "contentType": "ordered_list",
      "required": true,
      "hint": {
        "text": "Keep the artifact synchronized with its operational system of record and retain review evidence before external use.",
        "bookReference": "Volume 1, S-00-01-00 Context of the Organization (Clause 4"
      },
      "intro": "Complete the Working sheets using the example tabs as a model. Follow the workbook usage rules below."
    },
    {
      "order": 5,
      "id": "companion_navigation_index",
      "title": "Companion navigation index",
      "contentType": "register_table",
      "required": true,
      "hint": {
        "text": "Example rows demonstrate the expected level of specificity. Replace them with organization-specific records before operational use.",
        "bookReference": "Volume 1, S-00-01-00 Context of the Organization (Clause 4"
      },
      "columns": [
        {
          "name": "Artifact ID",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the artifact id.",
          "example": "CNI-001"
        },
        {
          "name": "Artifact title",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the artifact title.",
          "example": "Production access review"
        },
        {
          "name": "Canonical volume",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the canonical volume.",
          "example": "Defined and evidenced"
        },
        {
          "name": "Product tier",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the product tier.",
          "example": "Arcfield API"
        },
        {
          "name": "Distribution class",
          "type": "text",
          "required": "yes",
          "description": "Volume-specific, Shared Core, volume variant, or referenced.",
          "example": "Shared Core — included in Volumes 1, 2, 5"
        },
        {
          "name": "Canonical artifact ID",
          "type": "text",
          "required": "yes",
          "description": "Canonical companion artifact ID for this row.",
          "example": "CSSAQ"
        },
        {
          "name": "Included in volumes",
          "type": "text",
          "required": "yes",
          "description": "Volumes that include this artifact.",
          "example": "1, 2, 5"
        },
        {
          "name": "Asset type",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the asset type.",
          "example": "Defined and evidenced"
        },
        {
          "name": "Primary workflow",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the primary workflow.",
          "example": "Defined and evidenced"
        },
        {
          "name": "Purpose",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the purpose.",
          "example": "Defined and evidenced"
        },
        {
          "name": "Related artifact",
          "type": "artifactRef",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the related artifact.",
          "example": "Defined and evidenced",
          "artifactRef": {
            "scope": "companion",
            "value": "artifactId",
            "cardinality": "one",
            "separator": ";",
            "description": "Cell values are companion Contract artifactId values."
          }
        },
        {
          "name": "Dependency",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the dependency.",
          "example": "Defined and evidenced"
        },
        {
          "name": "Delivery status",
          "type": "select",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the delivery status.",
          "example": "Complete"
        },
        {
          "name": "Canonical location",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the canonical location.",
          "example": "GRC / evidence / 2026-Q3"
        },
        {
          "name": "Owner",
          "type": "select",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the owner.",
          "example": "ISMS Manager",
          "valueSet": "domain.owner",
          "options": [
            "ISMS Manager",
            "Control Owner",
            "Risk Owner",
            "Process Owner",
            "Asset Owner",
            "IT Security",
            "HR",
            "Legal",
            "Executive Management",
            "Internal Audit"
          ],
          "validation": {
            "allowBlank": false,
            "errorTitle": "Invalid value",
            "error": "Select a value from the list."
          }
        },
        {
          "name": "Last review",
          "type": "text",
          "required": "yes",
          "description": "Prevent cross-book duplication and help users navigate the complete companion system. Record the last review.",
          "example": "Defined and evidenced"
        }
      ],
      "minimumExampleRows": 5
    },
    {
      "order": 6,
      "id": "companion_navigation_index_review",
      "title": "Companion Navigation Index review",
      "contentType": "decision_table",
      "required": true,
      "hint": {
        "text": "Close each review with an explicit decision, unresolved actions and a traceable evidence reference.",
        "bookReference": "Volume 1, S-00-01-00 Context of the Organization (Clause 4"
      }
    },
    {
      "order": 7,
      "id": "external_references",
      "title": "References",
      "contentType": "reference_table",
      "required": true
    }
  ],
  "validationRules": [
    {
      "id": "required-sections-present",
      "description": "All required Contract sections must be present in the Example."
    },
    {
      "id": "example-matches-schema-columns",
      "description": "Example table rows should use the Contract column names for schema-backed sections."
    }
  ],
  "generation": {
    "source": "Contract.json",
    "method": "curated-json",
    "note": "Contract.json and Example.json are SSOT."
  },
  "editorialStandard": {
    "isoAnchors": [
      {
        "label": "ISO/IEC 27001:2022",
        "href": "https://www.iso.org/standard/82875.html",
        "role": "Normative source this artifact implements or cites."
      },
      {
        "label": "ISO/IEC 27001:2022 8.1",
        "href": "https://www.iso.org/standard/82875.html",
        "role": "Operational planning and control this register evidences."
      },
      {
        "label": "ISO/IEC 27001:2022 7.5",
        "href": "https://www.iso.org/standard/82875.html",
        "role": "Documented information: identify, review and cite this workbook by version."
      }
    ],
    "bookSources": [
      {
        "series": "ISO 27001 for Software Companies",
        "volume": 1,
        "volumeTitle": "Building the ISMS",
        "chapterId": "S-00-01-00",
        "chapterTitle": "Context of the Organization (Clause 4",
        "primary": true,
        "role": "Primary operating chapter for this companion artifact.",
        "href": "https://www.amazon.com/dp/9789908983448"
      },
      {
        "series": "ISO 27001 for Software Companies",
        "volume": 1,
        "volumeTitle": "Building the ISMS",
        "chapterId": "S-00-03-00",
        "chapterTitle": "Planning, Risk & Objectives (Clause 6)",
        "primary": false,
        "role": "Documented information, review and version discipline.",
        "href": "https://www.amazon.com/dp/9789908983448"
      }
    ],
    "acronyms": [
      {
        "abbr": "ISMS",
        "longForm": "Information Security Management System"
      },
      {
        "abbr": "SaaS",
        "longForm": "Software as a Service"
      },
      {
        "abbr": "CIA",
        "longForm": "Confidentiality, Integrity, and Availability"
      },
      {
        "abbr": "CI/CD",
        "longForm": "Continuous Integration / Continuous Delivery"
      },
      {
        "abbr": "CI",
        "longForm": "Continuous Integration"
      },
      {
        "abbr": "CD",
        "longForm": "Continuous Delivery"
      },
      {
        "abbr": "API",
        "longForm": "Application Programming Interface"
      },
      {
        "abbr": "CHG",
        "longForm": "Change"
      },
      {
        "abbr": "CNI",
        "longForm": "Container Network Interface"
      },
      {
        "abbr": "GRC",
        "longForm": "Governance, Risk, and Compliance"
      },
      {
        "abbr": "JSON",
        "longForm": "JavaScript Object Notation"
      },
      {
        "abbr": "PR",
        "longForm": "Pull Request"
      }
    ],
    "must": [
      "Keep one live row per record on Working sheets. Do not merge several cases into one row.",
      "Example sheets must contain realistic Arcfield rows for every required sheet. Empty required cells are not an example."
    ],
    "mustNot": [
      "Do not invent live rows in the renderer. Example data lives in the Example JSON.",
      "Do not treat Ex example tabs as working sheets. Do not put live data on system sheets."
    ],
    "softwareCompanyAdaptations": [
      "Use Arcfield as the worked example (cover variant A).",
      "Name SaaS, CI/CD, privileged access or supplier interfaces in example rows where they affect this register."
    ],
    "exampleWorkbook": {
      "workedExampleOrg": "Arcfield",
      "requiredSheets": [
        "companion_navigation_index",
        "companion_navigation_index_review"
      ],
      "minExampleRows": 5,
      "coverFromExample": true
    }
  },
  "editorialContractId": "editorial.xlsx.register.v1",
  "contentContractId": "content.register.index.v1"
}