@knowttl/mg-axi 0.1.1 → 0.1.3

package/dist/docs.js

@@ -37,6 +37,8 @@ const READ_AREA_LABELS = [
     ["entra user ", "users"],
     ["entra group ", "groups"],
     ["entra directory-role ", "roles"],
+    ["entra directory-role-template ", "roles"],
+    ["entra scoped-role-membership ", "roles"],
     ["entra role-assignment ", "roles"],
     ["entra pim ", "roles"],
     ["entra device ", "devices"],
@@ -70,14 +72,20 @@ const READ_AREA_LABELS = [
     ["entra tenant-information ", "tenant information"],
     ["entra sign-in ", "sign-ins and audit logs"],
     ["entra directory-audit ", "sign-ins and audit logs"],
+    ["entra provisioning ", "sign-ins and audit logs"],
     ["entra application ", "applications and consent grants"],
     ["entra service-principal ", "applications and consent grants"],
     ["entra risky-user ", "risk"],
     ["entra risk-detection ", "risk"],
+    ["entra risky-service-principal ", "risk"],
+    ["entra service-principal-risk-detection ", "risk"],
     ["entra conditional-access ", "Conditional Access"],
     ["entra identity-provider ", "identity providers"],
     ["entra federation-configuration ", "federation configurations"],
     ["entra data-policy-operation ", "data policy operations"],
+    ["entra fraud-protection-provider ", "risk prevention"],
+    ["entra web-application-firewall-provider ", "risk prevention"],
+    ["entra web-application-firewall-verification ", "risk prevention"],
     ["entra access-review ", "access reviews"],
     ["entra entitlement catalog ", "entitlement catalogs and access packages"],
     ["entra entitlement access-package ", "entitlement catalogs and access packages"],
@@ -200,6 +208,19 @@ export function skillDocument() {
         "Configuration defaults to `~/.mg-axi/config.json`; `MG_AXI_CONFIG` selects a separate file.",
         "`mg-axi setup` shows the selected path and writes nothing.",
         "",
+        "Agent discovery has two install paths, and either suffices alone.",
+        "For ambient context at every agent session start instead of the skill, install the CLI globally and opt into the session hook:",
+        "",
+        "```sh",
+        "npm install --global @knowttl/mg-axi",
+        "mg-axi setup hooks",
+        "```",
+        "",
+        "This installs a `SessionStart` hook for Claude Code, Codex and OpenCode that prints a short local-only summary (configured profile names with tenant labels, auth-cache presence, write posture and version).",
+        "The hook makes no network, Graph or sign-in call, and prints a short `not configured` record with exit 0 when unconfigured.",
+        "Restart the agent session after running the installer.",
+        "No other ordinary command installs hooks, plugins or configuration.",
+        "",
         "## Selecting a profile",
         "",
         "Read leaves accept `--profile <name>`.",
@@ -224,14 +245,14 @@ export function skillDocument() {
 // remains unimplemented. Family membership comes from the inventory
 // owningSlice and shipped status comes from the catalogue, so a merged
 // write slice flips its own row without touching this template. Blocked,
-// deprecated and unavailable variants never count as pending.
+// deprecated, unavailable and deferred-out-of-v1 variants never count as pending.
 function initialWriteStatus(rows) {
     const families = new Map();
     for (const row of rows) {
         const operation = /^v1\.0:(.+)$/.exec(row.id)?.[1];
         if (operation === undefined || row.owningSlice === null || !/^WRITE-0[1-9]$/.test(row.owningSlice))
             continue;
-        if (row.disposition === "intentionally-blocked" || row.disposition === "deprecated" || row.disposition === "unavailable")
+        if (row.disposition === "intentionally-blocked" || row.disposition === "deprecated" || row.disposition === "unavailable" || row.disposition === "deferred")
             continue;
         families.set(row.owningSlice, [...(families.get(row.owningSlice) ?? []), operation]);
     }
@@ -246,7 +267,79 @@ function initialWriteStatus(rows) {
     }
     return { shipped, pending };
 }
-const DISPOSITIONS = ["named-command", "reviewed-raw-read", "scheduled", "intentionally-blocked", "deprecated", "unavailable", "excluded"];
+const DISPOSITIONS = ["named-command", "reviewed-raw-read", "scheduled", "deferred", "intentionally-blocked", "deprecated", "unavailable", "excluded"];
+// FULL-01 audit record (2026-10-07, latest origin/main at PR #78): the cutoff
+// is met when no v1.0 row is left scheduled, so the counts below are read
+// from the same generated inventory the Counts section reports. Beta stays
+// scheduled by definition and was never agreed for v1.
+function auditRecord(rows) {
+    const v1 = (disposition) => rows.filter(row => row.id.startsWith("v1.0:") && row.disposition === disposition).length;
+    const betaScheduled = rows.filter(row => row.id.startsWith("beta:") && row.disposition === "scheduled").length;
+    const named = v1("named-command");
+    const raw = v1("reviewed-raw-read");
+    const scheduled = v1("scheduled");
+    if (scheduled !== 0)
+        throw new Error(`FULL-01 audit blocked: ${scheduled} v1.0 rows remain scheduled`);
+    return [
+        "## FULL-01 audit record",
+        "",
+        "FULL-01 audit (2026-10-07): every agreed v1.0 read has a named command or an",
+        "explicit reviewed blocked/unavailable/deprecated/deferred disposition, and no",
+        "v1.0 row is left scheduled. The deferred tail is declared out of v1.",
+        `- v1.0 named-command: ${named}, reviewed-raw-read: ${raw}, scheduled: ${scheduled}`,
+        `- v1.0 deferred (out of v1): ${v1("deferred")}, intentionally-blocked: ${v1("intentionally-blocked")}, deprecated: ${v1("deprecated")}, unavailable: ${v1("unavailable")}`,
+        `- beta scheduled (never agreed for v1): ${betaScheduled}`,
+        `PR #78 (historical point-in-time) proposed 275 named / 19 raw (294 backed); the generated inventory carries ${named} named / ${raw} raw (${named + raw} backed).`,
+        "",
+    ];
+}
+// COMPLETE-01 audit record (2026-10-07, latest origin/main at this change):
+// the full agreed Entra capability audit including later writes. Five writes
+// ship as named, gated commands through the WRITE-00 mutation coordinator,
+// WRITE-N carries explicit reviewed deferred/blocked/deprecated dispositions
+// rather than scheduled, and no agreed v1.0 operation, read or write, is
+// left merely scheduled. Beta stays scheduled by definition and was never
+// agreed for v1. The declined EXT-02c access-review history reads stay out.
+function completeAuditRecord(rows) {
+    const v1 = (disposition) => rows.filter(row => row.id.startsWith("v1.0:") && row.disposition === disposition).length;
+    const betaScheduled = rows.filter(row => row.id.startsWith("beta:") && row.disposition === "scheduled").length;
+    const named = v1("named-command");
+    const raw = v1("reviewed-raw-read");
+    const scheduled = v1("scheduled");
+    const writeRows = rows.filter(row => row.id.startsWith("v1.0:") && row.disposition === "named-command" && !row.id.includes(":GET:"));
+    const writeN = (version, disposition) => rows.filter(row => row.owningSlice === "WRITE-N" && row.id.startsWith(`${version}:`) && row.disposition === disposition).length;
+    const writeNScheduled = rows.filter(row => row.owningSlice === "WRITE-N" && row.disposition === "scheduled").length;
+    const declinedOut = rows.filter(row => row.owningSlice === "EXT-02c"
+        && (row.disposition === "named-command" || row.disposition === "reviewed-raw-read"));
+    if (scheduled !== 0)
+        throw new Error(`COMPLETE-01 audit blocked: ${scheduled} v1.0 rows remain scheduled`);
+    if (writeNScheduled !== 0)
+        throw new Error(`COMPLETE-01 audit blocked: ${writeNScheduled} WRITE-N rows remain scheduled`);
+    const writeStatus = initialWriteStatus(rows);
+    const expectedWrites = ["WRITE-01", "WRITE-02", "WRITE-03", "WRITE-04", "WRITE-05"];
+    const missing = expectedWrites.filter(slice => !writeStatus.shipped.some(entry => entry.startsWith(`${slice} `)));
+    if (writeStatus.pending.length > 0 || missing.length > 0) {
+        throw new Error(`COMPLETE-01 audit blocked: pending writes: ${[...missing, ...writeStatus.pending].join(", ")}`);
+    }
+    if (declinedOut.length > 0)
+        throw new Error(`COMPLETE-01 audit blocked: declined EXT-02c rows ship: ${declinedOut.map(row => row.id).join(", ")}`);
+    return [
+        "## COMPLETE-01 audit record",
+        "",
+        "COMPLETE-01 audit (2026-10-07): the full agreed Entra capability audit including later writes.",
+        "Five writes ship as named, gated commands through the WRITE-00 mutation coordinator; WRITE-N carries explicit",
+        "reviewed deferred/blocked/deprecated dispositions rather than scheduled; no agreed v1.0 operation, read or",
+        "write, is left merely scheduled. Beta stays scheduled by definition and was never agreed for v1.",
+        "The declined EXT-02c access-review history reads (ReadWrite least privilege, SAS URLs) stay out.",
+        `- v1.0 named-command: ${named} (${named - writeRows.length} reads plus ${writeRows.length} writes below), reviewed-raw-read: ${raw}, scheduled: ${scheduled}`,
+        `- v1.0 deferred (out of v1): ${v1("deferred")}, intentionally-blocked: ${v1("intentionally-blocked")}, deprecated: ${v1("deprecated")}, unavailable: ${v1("unavailable")}`,
+        `- beta scheduled (never agreed for v1): ${betaScheduled}`,
+        `- shipped writes: ${writeStatus.shipped.join(", ")}.`,
+        `- WRITE-N (remaining agreed mutations): deferred ${writeN("v1.0", "deferred")}, intentionally-blocked ${writeN("v1.0", "intentionally-blocked")} v1.0 plus ${writeN("beta", "intentionally-blocked")} beta, deprecated ${writeN("v1.0", "deprecated")} v1.0 plus ${writeN("beta", "deprecated")} beta, scheduled ${writeNScheduled}.`,
+        "- outstanding upstream limitations (already documented in the repo): P1 for Conditional Access and P2 for risk-based CA, PIM P2 or ID Governance, riskyUsers P2 and Workload Identities Premium for workload risk with hidden riskDetail/riskLevel without it (docs/graph-coverage.md); conservative P1/P2 Graph prerequisite for sign-in/audit logs, registration report excludes disabled users, no tenant-wide method enumeration (docs/graph-coverage.md); v1.0 group-members route omits service principals (README.md member-read warning); 14 unavailable rows with no documented v1.0 GET contract, invitation Create-only Methods table, org-scoped certificateBasedAuthConfiguration routes only, contacts sync-behavior reads without operation permission docs (inventory reasons); EXT-02c history reads need AccessReview.ReadWrite.All with no read scope and return SAS download URLs (docs/coverage.md); write-side limits beside each command, revoke lag/external-user scope/unknown outcome, CA update lockout gates with no concurrency promise, dismissal is not remediation (README.md, docs/execution.md).",
+        "",
+    ];
+}
 // The capability report is generated from the catalogue: every executable
 // read leaf owns one row with its inventory disposition and owning slice,
 // and the counts separate implemented leaves from inventory dispositions.
@@ -273,6 +366,7 @@ export function capabilityDocument() {
     const deferredProviderRows = rows.filter(row => row.owningSlice === "EXT-03" && row.reason.startsWith("Deferred to a later EXT-03 "));
     const deferredFederationRows = rows.filter(row => row.owningSlice === "EXT-01" && row.reason.startsWith("Deferred by firstmate federation-configuration scope "));
     const deferredDataPolicyRows = rows.filter(row => row.owningSlice === "EXT-03" && row.reason.startsWith("Deferred by firstmate data-policy-operations scope "));
+    const deferredRiskPreventionRows = rows.filter(row => row.owningSlice === "EXT-03" && row.reason.startsWith("Deferred by firstmate risk-prevention scope "));
     const unavailableInvitationRows = rows.filter(row => row.owningSlice === "EXT-03" && row.reason.startsWith("Marked unavailable by firstmate EXT-03b decision: "));
     const deferredOrganizationRows = rows.filter(row => row.owningSlice === "EXT-01" && row.reason.startsWith("Deferred by firstmate organization scope "));
     const unavailableCertAuthRows = rows.filter(row => row.owningSlice === "EXT-01" && row.reason.startsWith("Marked unavailable by firstmate mg-ext-01d decision: "));
@@ -285,10 +379,12 @@ export function capabilityDocument() {
     const deferredContractRows = rows.filter(row => row.owningSlice === "EXT-04" && row.reason.startsWith("Deferred by firstmate contracts scope "));
     const deferredDelegatedAdminRows = rows.filter(row => row.owningSlice === "EXT-04" && row.reason.startsWith("Deferred by firstmate delegated-admin scope "));
     const deferredMtoRows = rows.filter(row => row.owningSlice === "EXT-04" && row.reason.startsWith("Deferred by firstmate multi-tenant-organization scope "));
+    const deferredReportsRows = rows.filter(row => row.owningSlice === "EXT-04" && row.reason.startsWith("Deferred by firstmate reports scope "));
     const deferredGroupLifecycleRows = rows.filter(row => row.owningSlice === "EXT-01" && row.reason.startsWith("Deferred by firstmate group-lifecycle scope "));
     const deferredCustomSecurityRows = rows.filter(row => row.owningSlice === "EXT-01" && row.reason.startsWith("Deferred by firstmate custom-security-attributes scope "));
     const deferredAccessReviewRows = rows.filter(row => row.owningSlice === "EXT-02c");
     const deferredEntitlementRows = rows.filter(row => row.owningSlice === "EXT-02" && row.reason.startsWith("Deferred by firstmate entitlement-management scope "));
+    const deferredAppLookupRows = rows.filter(row => row.owningSlice === "READ-07" && row.reason.startsWith("Deferred by firstmate application-lookups scope "));
     const readCount = readLeaves.length + 2;
     const localCount = LEAVES.length - readCount - writeLeaves.length;
     return [
@@ -298,9 +394,11 @@ export function capabilityDocument() {
         "",
         "This is the supported Entra read surface, not full Entra coverage.",
         "Only the commands below have an implemented, tested leaf; every other",
-        "operation remains scheduled, blocked, deprecated or excluded until its own slice ships.",
-        "Inventory dispositions are discovery-time records from INV-01; the command",
-        "list below is the implemented truth and never counts scheduled work as complete.",
+        "v1.0 operation is deferred out of v1, and every other beta operation remains",
+        "scheduled (never agreed for v1), blocked, deprecated, unavailable or excluded.",
+        "Inventory dispositions are generated records from INV-01 joined to the catalogue;",
+        "the command list below is the implemented truth and never counts deferred or",
+        "scheduled work as complete.",
         "",
         "## Counts",
         "",
@@ -309,6 +407,8 @@ export function capabilityDocument() {
         `- local leaves: ${localCount} (home, profile, login and setup views)`,
         ...DISPOSITIONS.map(disposition => `- inventory ${disposition}: ${count(disposition)}`),
         "",
+        ...auditRecord(rows),
+        ...completeAuditRecord(rows),
         "## Commands",
         "",
         "| Command | Operation | Inventory (v1.0) | Owning slice |",
@@ -320,49 +420,61 @@ export function capabilityDocument() {
         "## EXT-01 domain scope decisions",
         "",
         "Firstmate decision R1: approve narrowing this change to the eight v1.0 domain reads above.",
-        "The operations below remain scheduled with an explicit deferred disposition to a later EXT-01 subfamily; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Federation stays out because it can carry signing-certificate material.",
         "Firstmate decision R2: keep the write-family status section as the coverage fix added to scope (resolved-kept).",
         "Both firstmate decisions must also be stated in the PR body by the delivery phase.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredDomainRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredDomainRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-03 identity-provider scope decisions",
         "",
         "This change covers the four v1.0 workforce identity-provider reads above (list, show, count, available-types).",
-        "The four beta operations below remain scheduled with an explicit deferred disposition to a later EXT-03 subfamily.",
+        "The four beta operations below remain scheduled (never agreed for v1) for a later EXT-03 subfamily.",
         "Identity-provider reads support v1.0 only; beta needs its own review.",
         "Workforce context only; no external-customer (B2C/External ID tenant) support is claimed.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredProviderRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredProviderRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 federation-configuration scope decisions",
         "",
         "This change covers the four v1.0 workforce directory federation-configuration reads above (federation-configuration list, show, count and available-types).",
-        "The four beta operations below remain scheduled with an explicit deferred disposition to a later EXT-01 subfamily; no new commands or raw access are approved.",
+        "The four beta operations below remain scheduled (never agreed for v1) for a later EXT-01 subfamily; no new commands or raw access are approved.",
         "Federation-configuration reads support v1.0 only; beta needs its own review.",
         "signingCertificate carries the public token-signing key only and is omitted from default selects; no private key material exists on these resources and the domains navigation property needs its own review.",
-        "Workforce context only; domain federationConfiguration sub-reads (/domains/{domain-id}/federationConfiguration) stay scheduled in the later domain federation subfamily.",
+        "Workforce context only; domain federationConfiguration sub-reads (/domains/{domain-id}/federationConfiguration) carry the deferred disposition in v1.0 (out of v1) and remain scheduled in beta (never agreed for v1) in the later domain federation subfamily.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredFederationRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredFederationRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-03 data-policy-operations scope decisions",
         "",
         "This change covers the three v1.0 workforce data-policy-operation reads above (data-policy-operation list, show and count).",
-        "The three beta operations below remain scheduled with an explicit deferred disposition to a later EXT-03 subfamily; no new commands or raw access are approved.",
+        "The three beta operations below remain scheduled (never agreed for v1) for a later EXT-03 subfamily; no new commands or raw access are approved.",
         "Data-policy-operation reads support v1.0 only; beta needs its own review.",
         "storageLocation always renders as the redaction marker; export submission (POST /users/{id}/exportPersonalData) belongs to no read slice.",
         "Workforce context only; no external-customer support is claimed.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredDataPolicyRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredDataPolicyRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
+        "",
+        "## EXT-03 risk-prevention scope decisions",
+        "",
+        "This change covers the ten v1.0 workforce risk-prevention reads above (fraud-protection-provider list, show and count; web-application-firewall-provider list, show and count; web-application-firewall-verification list, show, count and provider show).",
+        "The eleven beta operations below remain scheduled (never agreed for v1) for a later EXT-03 subfamily; no new commands or raw access are approved.",
+        "Risk-prevention reads support v1.0 only; beta needs its own review.",
+        "API keys, client secrets and other key material (Arkose privateKey/publicKey, HUMAN serverToken, Akamai clientSecret/clientToken/accessToken, Cloudflare apiToken) are never selectable and never projected; application profiles are refused before credentials because Graph documents no supported application permission.",
+        "Workforce context only; no external-customer support is claimed.",
+        "",
+        "| Inventory operation | Disposition | Owning slice | Deferral reason |",
+        "|---|---|---|---|",
+        ...deferredRiskPreventionRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-03 invitations scope decisions",
         "",
@@ -378,12 +490,12 @@ export function capabilityDocument() {
         "## EXT-01 organization scope decisions",
         "",
         "The organization scope covers the five organization/branding/localization reads above; the remaining subfamilies need the separate contracts described below.",
-        "The operations below remain scheduled with an explicit deferred disposition to a later EXT-01 subfamily; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Stream image and CSS bytes stay out because they need a separate binary-output contract; beta-only settings, partner and theme contracts need separate review.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredOrganizationRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredOrganizationRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 certificate-auth scope decisions",
         "",
@@ -405,61 +517,61 @@ export function capabilityDocument() {
         "## EXT-01 group lifecycle scope decisions",
         "",
         "This change covers the six v1.0 group lifecycle policy and group setting template reads above (list, show, count per family).",
-        "The operations below remain scheduled with an explicit deferred disposition to a later EXT-01 subfamily; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Beta policies and templates need their own review; delta-token sync needs its own change-tracking contract beyond the approved list/show/count reads; the POST lookup actions need their own request and projection review.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredGroupLifecycleRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredGroupLifecycleRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 custom-security-attributes scope decisions",
         "",
         "This change covers the nine v1.0 attribute-set, custom-security-attribute-definition and allowed-value reads above (list, show, count per family).",
-        "The nine beta operations below remain scheduled with an explicit deferred disposition to a later EXT-01 subfamily; no new commands or raw access are approved.",
+        "The nine beta operations below remain scheduled (never agreed for v1) for a later EXT-01 subfamily; no new commands or raw access are approved.",
         "Beta attribute sets, definitions and allowed values need their own review; definition $expand (inline allowedValues) is not reviewed here and stays on the dedicated allowed-value list/show reads.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredCustomSecurityRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredCustomSecurityRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 on-premises-synchronization scope decisions",
         "",
         "This change covers the two v1.0 on-premises-synchronization reads above (on-premises-synchronization list and show).",
-        "The $count scalar and the three beta operations below remain scheduled with an explicit deferred disposition to later EXT-01 subfamilies; no new commands or raw access are approved.",
+        "The $count scalar below carries the deferred disposition (out of v1) and the three beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "On-premises-synchronization reads support v1.0 only; beta needs its own review.",
         "Scalar counts need a separate query and response contract from the approved list/show reads.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredOnPremSyncRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredOnPremSyncRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 terms-of-use scope decisions",
         "",
         "This change covers the six v1.0 agreement and agreement-acceptance reads above (agreement list/show, one agreement's acceptance list/show, and tenant-wide acceptance list/show).",
-        "The acceptances $count scalar, the agreement file/localization/files/versions sub-reads and the beta operations below remain scheduled with an explicit deferred disposition to later EXT-01 subfamilies; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Terms-of-use reads support v1.0 only; beta needs its own review.",
         "Scalar counts need a separate query and response contract from the approved list/show reads; agreement file contents and localizations need a separate binary-output and projection contract, and file bytes are never downloaded or printed.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredTermsOfUseRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredTermsOfUseRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 directory-objects scope decisions",
         "",
         "This change covers the three v1.0 directory-object reads above (directory-object list, show and count).",
-        "The delta sync, the POST lookup/validation actions and the beta operations below remain scheduled with an explicit deferred disposition to later EXT-01 subfamilies; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Directory-object reads support v1.0 only; beta needs its own review.",
         "Delta-token sync needs its own change-tracking contract beyond the approved list/show/count reads; the POST lookup and validation actions need their own request and projection review.",
         "Rows are polymorphic: only the base-type properties plus the @odata.type discriminator are projected, so subtype secrets or credentials can never appear.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredDirectoryObjectRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredDirectoryObjectRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 deleted-items scope decisions",
         "",
         "This change covers the eleven v1.0 deleted directory-item reads above (deleted-user, deleted-group, deleted-application, deleted-service-principal and deleted-administrative-unit list and count, plus deleted-item show).",
-        "The rows below remain scheduled with an explicit deferred disposition; no new commands or raw access are approved for them.",
+        "The rows below carry the deferred (v1.0, out of v1) or scheduled (beta, never agreed for v1) disposition shown; no new commands or raw access are approved for them.",
         "Deleted-item reads support v1.0 only; beta needs its own review.",
         "Untyped list/count commands do not exist because upstream requires the OData cast as part of the list URI.",
         "Device casts carry no documented v1.0 permission contract: the list/get pages name the supported types and device is not among them.",
@@ -468,12 +580,12 @@ export function capabilityDocument() {
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredDeletedItemsRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredDeletedItemsRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-01 contacts scope decisions",
         "",
         "This change covers the three v1.0 top-level contact reads above (contact list, show and count), the ten v1.0 manager/directReports navigation reads above (show-manager, list/show/count-direct-reports with user/contact casts), and the eighteen v1.0 memberOf/transitiveMemberOf navigation reads above (list/show/count-member-of with transitive and group/administrativeUnit casts).",
-        "The delta sync, the POST lookup actions and the beta operations below remain scheduled with an explicit deferred disposition to later EXT-01 subfamilies; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Contact reads support v1.0 only; beta needs its own review.",
         "Delta-token sync needs its own change-tracking contract beyond the approved reads; the POST lookup actions need their own request and projection review.",
         "Contacts are personal data: top-level default rows carry id, displayName, mail and companyName only; navigation rows carry the @odata.type discriminator plus id and displayName only, and identifying fields need an explicit --select.",
@@ -481,35 +593,43 @@ export function capabilityDocument() {
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredContactRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredContactRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         ...unavailableContactRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-04 partner contracts scope decisions",
         "",
         "Firstmate scope: approve narrowing this change to the three v1.0 partner-contract reads above (list, show, count).",
-        "The operations below remain scheduled with an explicit deferred disposition to a later EXT-04 subfamily; no new commands or raw access are approved.",
+        "The v1.0 operations below carry the deferred disposition (out of v1) and the beta operations remain scheduled (never agreed for v1); no new commands or raw access are approved.",
         "Beta contracts need their own review; delta-token sync needs its own change-tracking contract beyond the approved list/show/count reads.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredContractRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`), "",
+        ...deferredContractRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`), "",
         "## EXT-04 delegated-admin scope decisions",
         "",
-        "Firstmate scope: approve narrowing this change to the twelve v1.0 delegated-admin reads above (customer list/show, relationship list/show, access-assignment list/show, operation list/show, request list/show and service-management-detail list/show).",
-        "The operations below remain scheduled with an explicit deferred disposition to a later EXT-04 subfamily; no new commands or raw access are approved.",
-        "Scalar counts need a separate query and response contract from the approved list/show reads; the tenantRelationship container root needs its own projection review; multi-tenant-organization reads shipped in the section below, and tenant-lookup functions ship as tenant-information show under the mg-ext-04e function-argument contract.",
+        "Firstmate scope: approve narrowing this change to the eighteen v1.0 delegated-admin reads above (customer list/show/count, relationship list/show/count, access-assignment list/show/count, operation list/show/count, request list/show/count and service-management-detail list/show/count).",
+        "The operation below carries the deferred disposition (out of v1); no new commands or raw access are approved.",
+        "The tenantRelationship container root needs its own projection review; multi-tenant-organization reads shipped in the section below, and tenant-lookup functions ship as tenant-information show under the mg-ext-04e function-argument contract.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredDelegatedAdminRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`), "",
+        ...deferredDelegatedAdminRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`), "",
         "## EXT-04 multi-tenant-organization scope decisions",
         "",
         "Firstmate scope: approve narrowing this change to the four v1.0 multi-tenant-organization reads above (organization show, join-request show, tenant list/count).",
-        "The single-member read below remains scheduled with an explicit deferred disposition: its documented least privilege is the write scope MultiTenantOrganization.ReadWrite.All in both delegated and application modes, so no named command or raw access is approved for it until its own least-privilege review lands.",
+        "The single-member read below carries the deferred disposition (out of v1): its documented least privilege is the write scope MultiTenantOrganization.ReadWrite.All in both delegated and application modes, so no named command or raw access is approved for it until its own least-privilege review lands.",
+        "",
+        "| Inventory operation | Disposition | Owning slice | Deferral reason |",
+        "|---|---|---|---|",
+        ...deferredMtoRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`), "",
+        "## EXT-04 reports scope decisions",
+        "",
+        "Firstmate scope: approve deferring the v1.0 relying-party summary read below; no named command or raw access is approved for it.",
+        "The relying-party summary read below carries the deferred disposition (out of v1): its period function argument needs a new session-guard function-argument binding beyond the three allowlisted tenant-lookup/commerce routes, and the request-path guard must stay byte-identical to origin/main apart from READ_SCOPES additions, so no named command or raw access is approved for it until its own guard review lands.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredMtoRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`), "",
+        ...deferredReportsRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`), "",
         "## EXT-04 tenant-lookup scope decisions",
         "",
         "Firstmate scope: approve the mg-ext-04e function-argument contract with the three v1.0 reads it unblocks (tenant-information show by domain name or tenant ID, subscription show by commerce subscription ID).",
@@ -519,7 +639,7 @@ export function capabilityDocument() {
         "## EXT-02 access-review scope decisions",
         "",
         "The access-review scope covers the ten reads above (definition, instance, decision, contacted-reviewer and stage list/show reads).",
-        "The legacy accessReviews and unified alias reads below are split into the EXT-02c follow-up to limit this piece's size; beta-only operations stay deferred (\"beta needs its own review\").",
+        "The legacy accessReviews and unified alias reads below carry the deferred disposition (out of v1) under the captain-declined EXT-02c follow-up (see docs/build-plan.md); beta-only operations remain scheduled (\"beta needs its own review\").", ,
         "The history reads below are blocked: their documented least privilege is the write scope AccessReview.ReadWrite.All (no read scope), and history instances return SAS download URLs in downloadUri.",
         "No new commands or raw access are approved for any row below.",
         "",
@@ -530,17 +650,26 @@ export function capabilityDocument() {
         "## EXT-02 entitlement-management scope decisions",
         "",
         "The entitlement-management scope covers the eighteen reads above (catalog, access-package, assignment-policy and resource-role-scope list/show/count reads plus assignment and assignment-request list/show/count reads).",
-        "Approval and subject reads carry personal data and stay scheduled for later parts with no new commands or raw access approved; so do assignment and request navigation sub-reads (assignment target/accessPackage/assignmentPolicy, request accessPackage/assignment/requestor), the top-level assignment-policy and resource-role-scope lists, catalog navigation reads (accessPackages, resources, resourceScopes, resourceRoles, customWorkflowExtensions), package navigation reads (catalog, incompatible sets), policy navigation reads (questions, custom-extension stages), role/scope link expansion, filterByCurrentUser and additionalAccess functions (parenthesised function segments need their own session-guard binding review), and every beta operation below. Raw $expand review is a separate change: the named assignment and request reads flatten one fixed documented expansion in code, and no user-supplied $expand exists on any route.",
+        "Approval and subject reads carry personal data and stay deferred (out of v1) for later parts with no new commands or raw access approved; so do assignment and request navigation sub-reads (assignment target/accessPackage/assignmentPolicy, request accessPackage/assignment/requestor), the top-level assignment-policy and resource-role-scope lists, catalog navigation reads (accessPackages, resources, resourceScopes, resourceRoles, customWorkflowExtensions), package navigation reads (catalog, incompatible sets), policy navigation reads (questions, custom-extension stages), role/scope link expansion, filterByCurrentUser and additionalAccess functions (parenthesised function segments need their own session-guard binding review), while every beta operation below remains scheduled (never agreed for v1). Raw $expand review is a separate change: the named assignment and request reads flatten one fixed documented expansion in code, and no user-supplied $expand exists on any route.",
         "",
         "| Inventory operation | Disposition | Owning slice | Deferral reason |",
         "|---|---|---|---|",
-        ...deferredEntitlementRows.map(row => `| \`${row.id}\` | ${row.disposition} (deferred) | ${row.owningSlice} | ${row.reason} |`),
+        ...deferredEntitlementRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## EXT-02 lifecycle-workflows scope decisions",
         "",
-        "This change covers the twenty-four v1.0 lifecycle-workflows first-, second- and third-part reads above (workflow, workflow-template and task-definition list/show/count reads, the tenant settings show, top-level run and user/subject processing-result list/show/count reads, plus task-report list/show/count reads with the task and taskDefinition singles).",
-        "Run-nested and third-level processing results, taskProcessingResults sub-reads, reprocessed runs, subject sub-reads, workflow tasks, template tasks, versions, insights, deleted items and custom task extensions stay scheduled for follow-up parts with no new commands or raw access approved; so do the six top-level summary functions, which stay deferred because they need bracketed start/end arguments outside the session-guard function-binding allowlist while the request-path guard cannot change beyond READ_SCOPES additions. Every beta operation and every mutation (no workflow create/update/delete/activate/run, no settings update, no restore) stays out.",
-        "No new commands or raw access are approved for any lifecycle-workflows row outside the twenty-four above.",
+        "This change covers the thirty-three v1.0 lifecycle-workflows first-, second-, third- and fourth-part reads above (workflow, workflow-template and task-definition list/show/count reads, the tenant settings show, top-level run and user/subject processing-result list/show/count reads, task-report list/show/count reads with the task and taskDefinition singles, plus run-nested user/subject/task processing-result list/show/count reads).",
+        "Third-level processing results, taskProcessingResults sub-reads under a user or subject result, reprocessed runs, subject sub-reads, workflow tasks, template tasks, versions, insights, deleted items and custom task extensions stay deferred (out of v1) for follow-up parts with no new commands or raw access approved; so do the six summary functions (the run user/subject summaries plus the four top-level ones), which stay deferred because they need bracketed start/end arguments outside the session-guard function-binding allowlist while the request-path guard cannot change beyond READ_SCOPES additions. Every beta operation below remains scheduled (never agreed for v1) and every mutation (no workflow create/update/delete/activate/run, no settings update, no restore) stays out.",
+        "No new commands or raw access are approved for any lifecycle-workflows row outside the thirty-three above.",
+        "",
+        "## READ-07 application lookups scope decisions",
+        "",
+        "This change covers seven v1.0 application and service-principal reads above (application and service-principal federated-credential list/show reads with credential metadata only, service-principal app-role-assigned-to list/show reads, and the service-principal app-role-assignment show companion).",
+        "The four parenthesised lookups below carry the deferred disposition (out of v1): the (appId='...') alternate-key forms and the federated-credential (name='...') function forms each need a new session-guard binding, and the request-path guard must stay byte-identical to origin/main apart from READ_SCOPES additions, so no named command or raw access is approved for them until their own guard review lands.", ,
+        "",
+        "| Inventory operation | Disposition | Owning slice | Deferral reason |",
+        "|---|---|---|---|",
+        ...deferredAppLookupRows.map(row => `| \`${row.id}\` | ${row.disposition} | ${row.owningSlice} | ${row.reason} |`),
         "",
         "## Named writes",
         "",
@@ -553,7 +682,7 @@ export function capabilityDocument() {
         `Shipped initial writes: ${writeStatus.shipped.length ? writeStatus.shipped.join(", ") : "none"}.`,
         `Pending initial writes: ${writeStatus.pending.length ? writeStatus.pending.join(", ") : "none"}.`,
         "Extended families (EXT-01 through EXT-04) and the full-Entra audit (FULL-01, COMPLETE-01) own the remaining",
-        "scheduled rows; see docs/build-plan.md for their dispatch.",
+        "deferred rows out of v1; see docs/build-plan.md for their dispatch.",
         "",
     ].join("\n");
 }

package/dist/doctor.js

@@ -44,8 +44,8 @@ export async function runDoctor(args) {
             // surfaced row, remainder buffered in a discarded cursor. Doctor keeps
             // no cursor and accepts none; recovery reruns doctor, not the read.
             const result = (await listUsers(args.session, { limit: "1" }, selected.profile, operation, `npx -y @knowttl/mg-axi ${DOCTOR_CHECK} --help`, name));
-            if (!result.count.complete && result.count.reason !== "row limit reached; buffered remainder is preserved in the cursor") {
-                throw new AxiError(`Doctor read incomplete: ${result.count.reason}`, "GRAPH_ERROR", [rerun]);
+            if (!result.complete && result.reason !== "row limit reached; buffered remainder is preserved in the cursor") {
+                throw new AxiError(`Doctor read incomplete: ${result.reason}`, "GRAPH_ERROR", [rerun]);
             }
             profiles.push({ name, mode: selected.profile.mode, check: DOCTOR_CHECK, status: "ok",
                 detail: result.users.length ? "1 user row returned" : "0 users matched; the absence of results is the answer" });

package/dist/entra-access-reviews.js

@@ -1,4 +1,5 @@
 import { AxiError } from "axi-sdk-js";
+import { listTotals } from "./list-totals.js";
 // EXT-02 access-reviews subfamily: the read-only access-review mapping.
 // See README.md for the supported commands and usage. Operation construction
 // stays beside its command; the shared session owns URLs, credentials, paging,
@@ -236,6 +237,7 @@ const ACCESS_REVIEW_DENIAL_HINTS = [
 const DEFINITION_LIST = {
     command: "entra access-review definition list",
     key: "definitions",
+    noun: "access-review definitions",
     known: DEFINITION_KNOWN,
     knownList: KNOWN_DEFINITION_FIELDS,
     defaultSelect: DEFAULT_DEFINITION_LIST_SELECT,
@@ -249,6 +251,7 @@ const DEFINITION_LIST = {
 const INSTANCE_LIST = {
     command: "entra access-review instance list",
     key: "instances",
+    noun: "access-review instances",
     known: INSTANCE_KNOWN,
     knownList: KNOWN_INSTANCE_FIELDS,
     defaultSelect: DEFAULT_INSTANCE_LIST_SELECT,
@@ -261,6 +264,7 @@ const INSTANCE_LIST = {
 const DECISION_LIST = {
     command: "entra access-review decision list",
     key: "decisions",
+    noun: "access-review decisions",
     known: DECISION_KNOWN,
     knownList: KNOWN_DECISION_FIELDS,
     defaultSelect: DEFAULT_DECISION_SELECT,
@@ -273,6 +277,7 @@ const DECISION_LIST = {
 const CONTACTED_REVIEWER_LIST = {
     command: "entra access-review contacted-reviewer list",
     key: "contactedReviewers",
+    noun: "contacted reviewers",
     known: CONTACTED_REVIEWER_KNOWN,
     knownList: KNOWN_CONTACTED_REVIEWER_FIELDS,
     defaultSelect: DEFAULT_CONTACTED_REVIEWER_LIST_SELECT,
@@ -286,6 +291,7 @@ const CONTACTED_REVIEWER_LIST = {
 const STAGE_LIST = {
     command: "entra access-review stage list",
     key: "stages",
+    noun: "access-review stages",
     known: STAGE_KNOWN,
     knownList: KNOWN_STAGE_FIELDS,
     defaultSelect: DEFAULT_STAGE_LIST_SELECT,
@@ -347,16 +353,17 @@ async function listCollection(shape, session, flags, profile, operation, help, p
     if (!result.complete) {
         return {
             [shape.key]: rows,
-            count: { returned: rows.length, complete: false, reason: result.reason },
+            ...listTotals(rows.length, result.total, shape.noun, false),
+            complete: false,
+            reason: result.reason,
             cursor: result.cursor,
             help: [...truncationHints, resumeHint, ...standing],
         };
     }
-    const count = { returned: rows.length, complete: true };
     if (!rows.length) {
-        return { [shape.key]: rows, count, help: [shape.emptyNote, ...standing] };
+        return { [shape.key]: rows, ...listTotals(rows.length, result.total, shape.noun, true), complete: true, help: [shape.emptyNote, ...standing] };
     }
-    return { [shape.key]: rows, count, help: [...truncationHints, ...standing] };
+    return { [shape.key]: rows, ...listTotals(rows.length, result.total, shape.noun, true), complete: true, help: [...truncationHints, ...standing] };
 }
 async function showOne(key, command, known, knownList, defaultSelect, session, flags, profile, operation, help, profileName, params, malformed) {
     const { select, fields } = selectedFields(flags, defaultSelect, known, knownList, help);