@opscompass/skills 0.1.0 → 0.2.1

package/skills/opscompass-oracle-licensing/api/entitlement-deployment/entitlement-deployment

@@ -1,26 +0,0 @@
-[
-  {"Server":"NTX3-HOST06-DC3","VM":"NTX-APPLICATIONPROD-LX02","Instance":"TRKP1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"3/5/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-INTERFACEDEV-LX01","Instance":"INVD1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/11/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-ARRAYDEV-LX01","Instance":"INVQ2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"3/14/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-CAPACITORDEV-LX01","Instance":"DWHS01","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/11/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-MONITORDEV-LX01","Instance":"HISTDR2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"5/3/18"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-ALARMDEV-LX02","Instance":"INVT2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/9/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-CARDDEV-LX01","Instance":"MEND2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"1/1/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-DRIVERDEV-LX01","Instance":"HISTQA","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/26/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-CIRCUITDEV-LX01","Instance":"REPD1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/24/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-BANDWIDTHDEV-LX01","Instance":"RMANCP1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"3/3/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-MONITORDEV-LX01","Instance":"TRK2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/13/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-ALARMDEV-LX02","Instance":"INVT1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/9/25"},
-  {"Server":"NTX5-HOST01-DC1","VM":"NTX-MONITORDEV-LX01","Instance":"INVT2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/9/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-APPLICATIONDEV-LX02","Instance":"DWHS02","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/11/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-PROGRAMDEV-LX02","Instance":"INVD2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"4/11/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-FIREWALLDEV-LX02","Instance":"HISTDR1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"5/3/18"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-CAPACITORDEV-LX02","Instance":"INVQ1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"3/14/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-ALARMDEV-LX02","Instance":"MEND1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"1/1/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-APPLICATIONDEV-LX02","Instance":"RMANCP2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"3/3/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-CARDDEV-LX02","Instance":"TRK1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/13/25"},
-  {"Server":"NTX5-HOST02-DC1","VM":"NTX-ARRAYDEV-LX02","Instance":"REPD2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/23/25"},
-  {"Server":"NTX6-HOST01-DC1","VM":"NTX-FIREWALLPROD-LX01","Instance":"INVP2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/2/13"},
-  {"Server":"NTX6-HOST01-DC1","VM":"NTX-PIXELPROD-LX01","Instance":"TRKP2","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"3/5/25"},
-  {"Server":"NTX6-HOST02-DC1","VM":"NTX-SYSTEMPROD-LX02","Instance":"INVP1","Edition":"Enterprise Edition","Version":"19.0.0.0.0","DB Created":"2/2/13"}
-]

package/skills/opscompass-oracle-licensing/api/entitlement-usage/entitlement-usage.json

@@ -1,114 +0,0 @@
-[
-  {
-    "Product": "Oracle Active Data Guard",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 16
-  },
-  {
-    "Product": "Oracle Advanced Compression",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 16
-  },
-  {
-    "Product": "Oracle Advanced Security",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  },
-  {
-    "Product": "Oracle Advanced Security",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 32
-  },
-  {
-    "Product": "Oracle Database Enterprise Edition",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 32
-  },
-  {
-    "Product": "Oracle Database Enterprise Edition",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  },
-  {
-    "Product": "Oracle Database Vault",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  },
-  {
-    "Product": "Oracle Database Vault",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 32
-  },
-  {
-    "Product": "Oracle Diagnostics Pack",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 16
-  },
-  {
-    "Product": "Oracle Diagnostics Pack",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  },
-  {
-    "Product": "Oracle GoldenGate",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 16
-  },
-  {
-    "Product": "Oracle GoldenGate",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  },
-  {
-    "Product": "Oracle Partitioning",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 16
-  },
-  {
-    "Product": "Oracle Partitioning",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  },
-  {
-    "Product": "Oracle Real Application Clusters",
-    "Metric": "Processor",
-    "Limitation": "Full Use",
-    "Limited To": "",
-    "Usage": 32
-  },
-  {
-    "Product": "Oracle Real Application Clusters",
-    "Metric": "Named User Plus",
-    "Limitation": "Limited Use Other",
-    "Limited To": "Test / Dev",
-    "Usage": 400
-  }
-]

package/skills/opscompass-oracle-licensing/assets/mock-entitlements/deployment-details.json

@@ -1,61 +0,0 @@
-{
-  "organization": "OpsCompass Demo",
-  "assessmentScope": "oracle-licensing",
-  "generatedAt": "2026-04-23T00:00:00Z",
-  "deployments": [
-    {
-      "deploymentId": "prod-microchip",
-      "environment": "prod",
-      "platform": "nutanix",
-      "databaseName": "REPP1",
-      "databaseHostname": "NTX-MICROCHIPPROD-LX02",
-      "oracleVersion": "19.0.0.0.0",
-      "oracleEdition": "Enterprise Edition",
-      "vmName": "ntx-microchipprod-lx02",
-      "clusterName": "ntx1-prod-dc1",
-      "hostName": "ntx1-host08-dc1",
-      "provisionedVcpu": 8,
-      "estimatedLicensableCores": 8,
-      "notes": [
-        "Production Oracle workload",
-        "Mapped through Nutanix VM latest configuration"
-      ]
-    },
-    {
-      "deploymentId": "prod-sensor",
-      "environment": "prod",
-      "platform": "nutanix",
-      "databaseName": "REPP2",
-      "databaseHostname": "NTX-SENSORPROD-LX02",
-      "oracleVersion": "19.0.0.0.0",
-      "oracleEdition": "Enterprise Edition",
-      "vmName": "ntx-sensorprod-lx02",
-      "clusterName": "ntx3-prod-dc3",
-      "hostName": "ntx3-host03-dc3",
-      "provisionedVcpu": 16,
-      "estimatedLicensableCores": 16,
-      "notes": [
-        "Production Oracle workload",
-        "Higher CPU footprint than standard 8-vCPU pattern"
-      ]
-    },
-    {
-      "deploymentId": "dev-bandwidth",
-      "environment": "dev",
-      "platform": "nutanix",
-      "databaseName": "RMANCP1",
-      "databaseHostname": "NTX-BANDWIDTHDEV-LX01",
-      "oracleVersion": "19.0.0.0.0",
-      "oracleEdition": "Enterprise Edition",
-      "vmName": "ntx-bandwidthdev-lx01",
-      "clusterName": "ntx2-dev-dc1",
-      "hostName": "ntx2-host02-dc1",
-      "provisionedVcpu": 4,
-      "estimatedLicensableCores": 4,
-      "notes": [
-        "Development Oracle workload",
-        "Candidate for lower licensing priority"
-      ]
-    }
-  ]
-}

package/skills/opscompass-oracle-licensing/assets/mock-entitlements/license-usage-map.json

@@ -1,70 +0,0 @@
-{
-  "organization": "OpsCompass Demo",
-  "assessmentScope": "oracle-licensing",
-  "generatedAt": "2026-04-23T00:00:00Z",
-  "entitlements": [
-    {
-      "licensePoolId": "ee-processor-pool",
-      "licenseMetric": "processor",
-      "licenseType": "Oracle Database Enterprise Edition",
-      "entitledQuantity": 24,
-      "allocatedQuantity": 20,
-      "unallocatedQuantity": 4,
-      "limitedUse": false
-    },
-    {
-      "licensePoolId": "diag-tuning-pack-pool",
-      "licenseMetric": "processor",
-      "licenseType": "Diagnostics Pack + Tuning Pack",
-      "entitledQuantity": 8,
-      "allocatedQuantity": 16,
-      "unallocatedQuantity": -8,
-      "limitedUse": false
-    }
-  ],
-  "usageMap": [
-    {
-      "deploymentId": "prod-microchip",
-      "databaseName": "REPP1",
-      "assignedLicensePoolIds": [
-        "ee-processor-pool",
-        "diag-tuning-pack-pool"
-      ],
-      "consumedQuantity": {
-        "Oracle Database Enterprise Edition": 8,
-        "Diagnostics Pack + Tuning Pack": 8
-      },
-      "featureSignals": [
-        "CONTROL_MANAGEMENT_PACK_ACCESS=DIAGNOSTIC+TUNING"
-      ]
-    },
-    {
-      "deploymentId": "prod-sensor",
-      "databaseName": "REPP2",
-      "assignedLicensePoolIds": [
-        "ee-processor-pool",
-        "diag-tuning-pack-pool"
-      ],
-      "consumedQuantity": {
-        "Oracle Database Enterprise Edition": 16,
-        "Diagnostics Pack + Tuning Pack": 16
-      },
-      "featureSignals": [
-        "CONTROL_MANAGEMENT_PACK_ACCESS=DIAGNOSTIC+TUNING"
-      ]
-    },
-    {
-      "deploymentId": "dev-bandwidth",
-      "databaseName": "RMANCP1",
-      "assignedLicensePoolIds": [
-        "ee-processor-pool"
-      ],
-      "consumedQuantity": {
-        "Oracle Database Enterprise Edition": 4
-      },
-      "featureSignals": [
-        "CONTROL_MANAGEMENT_PACK_ACCESS=NONE"
-      ]
-    }
-  ]
-}

package/skills/opscompass-oracle-licensing/assets/mock-entitlements/overall-compliance.json

@@ -1,36 +0,0 @@
-{
-  "organization": "OpsCompass Demo",
-  "assessmentScope": "oracle-licensing",
-  "generatedAt": "2026-04-23T00:00:00Z",
-  "summary": {
-    "overallStatus": "non-compliant",
-    "deploymentsReviewed": 3,
-    "deploymentsCompliant": 1,
-    "deploymentsWithFindings": 2,
-    "licenseDeficiencyCount": 2,
-    "limitedUseIssues": 0
-  },
-  "findings": [
-    {
-      "deploymentId": "prod-microchip",
-      "databaseName": "REPP1",
-      "severity": "medium",
-      "findingType": "management-pack-overconsumption",
-      "message": "Diagnostics Pack + Tuning Pack usage is assigned, but the shared pool is oversubscribed.",
-      "recommendedAction": "Reconcile management pack entitlement assignments or reduce pack usage."
-    },
-    {
-      "deploymentId": "prod-sensor",
-      "databaseName": "REPP2",
-      "severity": "high",
-      "findingType": "processor-license-deficiency",
-      "message": "Current processor consumption exceeds the remaining available Enterprise Edition entitlement.",
-      "recommendedAction": "Add processor entitlements, reallocate underused licenses, or reduce deployment CPU footprint."
-    }
-  ],
-  "recommendations": [
-    "Prioritize REPP2 for remediation because it combines the largest CPU footprint with pack usage.",
-    "Review whether development environments require Enterprise Edition or can be right-sized.",
-    "Use the current deployment map when modeling the AWS target-state license plan."
-  ]
-}

package/skills/opscompass-oracle-licensing/scripts/fake-entitlements-api.tool.js

@@ -1,31 +0,0 @@
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-const API_ROOT = path.resolve(fileURLToPath(new URL("../api", import.meta.url)));
-const PAYLOAD_FILES = {
-    "deployment-details": path.join(API_ROOT, "entitlement-deployment", "entitlement-deployment"),
-    "license-usage-map": path.join(API_ROOT, "entitlement-usage", "entitlement-usage.json"),
-    "overall-compliance": path.join(API_ROOT, "entitlement-compliance", "entitlement-compliance.json"),
-};
-export const fakeEntitlementsApiTool = {
-    name: "opscompass_oracle_licensing_fake_entitlements",
-    label: "read entitlement fixture",
-    description: "Read one of the checked-in Oracle entitlement API fixtures.",
-    parameters: {
-        type: "object",
-        properties: {
-            payload: { type: "string", enum: Object.keys(PAYLOAD_FILES) },
-            showPath: { type: "boolean" },
-        },
-        required: ["payload"],
-        additionalProperties: false,
-    },
-    async execute(input) {
-        const value = input;
-        if (!value?.payload || !Object.hasOwn(PAYLOAD_FILES, value.payload))
-            throw new Error("invalid entitlement payload");
-        const file = PAYLOAD_FILES[value.payload];
-        const text = await readFile(file, "utf8");
-        return { content: [{ type: "text", text: value.showPath ? `[entitlements] ${file}\n${text}` : text }] };
-    },
-};

package/skills/opscompass-oracle-licensing/scripts/fake_entitlements_api.js

@@ -1,72 +0,0 @@
-import { readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { isMainModule } from "../.opscompass-runtime/tools/cli-entrypoint.js";
-const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-const API_ROOT = path.join(ROOT, "api");
-export const PAYLOAD_FILES = {
-    "deployment-details": path.join(API_ROOT, "entitlement-deployment", "entitlement-deployment"),
-    "license-usage-map": path.join(API_ROOT, "entitlement-usage", "entitlement-usage.json"),
-    "overall-compliance": path.join(API_ROOT, "entitlement-compliance", "entitlement-compliance.json"),
-};
-function isPayloadName(value) {
-    return typeof value === "string" && Object.hasOwn(PAYLOAD_FILES, value);
-}
-function parseArgs(argv) {
-    if (!argv.length) {
-        throw new Error("the following arguments are required: payload");
-    }
-    const payload = argv[0];
-    let showPath = false;
-    for (const flag of argv.slice(1)) {
-        if (flag === "--show-path") {
-            showPath = true;
-        }
-        else {
-            throw new Error(`unrecognized arguments: ${flag}`);
-        }
-    }
-    if (!isPayloadName(payload)) {
-        throw new Error(`invalid choice: '${payload}' (choose from deployment-details, license-usage-map, overall-compliance)`);
-    }
-    return { payload, showPath };
-}
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}
-function isMissingFileError(error) {
-    return error instanceof Error && error.code === "ENOENT";
-}
-export function main(argv = process.argv.slice(2)) {
-    try {
-        const args = parseArgs(argv);
-        const payloadPath = PAYLOAD_FILES[args.payload];
-        if (args.showPath) {
-            console.error(`[entitlements] ${args.payload} -> ${payloadPath}`);
-        }
-        let data;
-        try {
-            data = JSON.parse(readFileSync(payloadPath, "utf8"));
-        }
-        catch (error) {
-            if (isMissingFileError(error)) {
-                console.error(`Error: missing payload file: ${payloadPath}`);
-                return 2;
-            }
-            if (error instanceof SyntaxError) {
-                console.error(`Error: invalid JSON in ${payloadPath}: ${error.message}`);
-                return 2;
-            }
-            throw error;
-        }
-        console.log(JSON.stringify(data, null, 2));
-        return 0;
-    }
-    catch (error) {
-        console.error(`Error: ${errorMessage(error)}`);
-        return 2;
-    }
-}
-if (isMainModule(import.meta.url)) {
-    process.exitCode = main();
-}