@yohakuforce/core 0.4.0

package/dist/schema/graph.schema.json

@@ -0,0 +1,446 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://yohakuforce.dev/schemas/graph.schema.json",
+  "title": "yohakuforce Knowledge Graph",
+  "description": "Salesforce メタデータから構築される知識グラフのスキーマ。.yohaku/graph.sqlite の論理スキーマと 1:1 で対応する。Phase 1 では標準形のみ対応、例外形は Phase 7 以降。",
+  "type": "object",
+  "required": ["meta", "objects", "fields", "validationRules", "flows", "apexClasses", "apexTriggers", "permissionSets", "profiles", "recordTypes", "approvalProcesses", "sharingRules", "layouts", "customMetadataRecords", "namedCredentials", "remoteSiteSettings", "lwcs", "auraBundles", "flexiPages", "visualforcePages", "visualforceComponents", "customApplications", "dependencies", "tags"],
+  "properties": {
+    "meta": { "$ref": "#/$defs/GraphMeta" },
+    "objects": { "type": "array", "items": { "$ref": "#/$defs/SObject" } },
+    "fields": { "type": "array", "items": { "$ref": "#/$defs/Field" } },
+    "validationRules": { "type": "array", "items": { "$ref": "#/$defs/ValidationRule" } },
+    "flows": { "type": "array", "items": { "$ref": "#/$defs/Flow" } },
+    "apexClasses": { "type": "array", "items": { "$ref": "#/$defs/ApexClass" } },
+    "apexTriggers": { "type": "array", "items": { "$ref": "#/$defs/ApexTrigger" } },
+    "permissionSets": { "type": "array", "items": { "$ref": "#/$defs/PermissionSet" } },
+    "profiles": { "type": "array", "items": { "$ref": "#/$defs/Profile" } },
+    "recordTypes": { "type": "array", "items": { "$ref": "#/$defs/RecordType" } },
+    "approvalProcesses": { "type": "array", "items": { "$ref": "#/$defs/ApprovalProcess" } },
+    "sharingRules": { "type": "array", "items": { "$ref": "#/$defs/SharingRule" } },
+    "layouts": { "type": "array", "items": { "$ref": "#/$defs/Layout" } },
+    "customMetadataRecords": { "type": "array", "items": { "$ref": "#/$defs/CustomMetadataRecord" } },
+    "namedCredentials": { "type": "array", "items": { "$ref": "#/$defs/NamedCredential" } },
+    "remoteSiteSettings": { "type": "array", "items": { "$ref": "#/$defs/RemoteSiteSetting" } },
+    "lwcs": { "type": "array", "items": { "$ref": "#/$defs/LightningWebComponent" } },
+    "auraBundles": { "type": "array", "items": { "$ref": "#/$defs/AuraBundle" } },
+    "flexiPages": { "type": "array", "items": { "$ref": "#/$defs/FlexiPage" } },
+    "visualforcePages": { "type": "array", "items": { "$ref": "#/$defs/VisualforcePage" } },
+    "visualforceComponents": { "type": "array", "items": { "$ref": "#/$defs/VisualforceComponent" } },
+    "customApplications": { "type": "array", "items": { "$ref": "#/$defs/CustomApplication" } },
+    "dependencies": { "type": "array", "items": { "$ref": "#/$defs/Dependency" } },
+    "tags": { "type": "array", "items": { "$ref": "#/$defs/Tag" } }
+  },
+  "$defs": {
+    "GraphMeta": {
+      "type": "object",
+      "required": ["yohakuVersion", "builtAt", "sourceAdapter", "salesforceApiVersion", "sourceHash"],
+      "properties": {
+        "yohakuVersion": { "type": "string" },
+        "builtAt": { "type": "string", "format": "date-time" },
+        "sourceAdapter": { "type": "string", "enum": ["local", "dx-mcp"] },
+        "salesforceApiVersion": { "type": "string" },
+        "sourceHash": {
+          "type": "string",
+          "description": "force-app/ 全体の決定的ハッシュ。同一値なら graph も同一になることが保証される"
+        },
+        "incremental": { "type": "boolean" }
+      }
+    },
+    "EntityRef": {
+      "type": "object",
+      "required": ["kind", "fullyQualifiedName"],
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["object", "field", "validationRule", "flow", "apexClass", "apexTrigger", "permissionSet", "profile", "recordType", "approvalProcess", "sharingRule", "layout", "customMetadataRecord", "namedCredential", "remoteSiteSetting", "lwc", "auraBundle", "flexiPage", "visualforcePage", "visualforceComponent", "customApplication"]
+        },
+        "fullyQualifiedName": {
+          "type": "string",
+          "description": "例: Account / Account.Industry / Account.RequireWebsite_VR"
+        }
+      }
+    },
+    "SObject": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "label", "isCustom", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "label": { "type": "string" },
+        "pluralLabel": { "type": "string" },
+        "description": { "type": "string" },
+        "isCustom": { "type": "boolean" },
+        "sharingModel": {
+          "type": "string",
+          "enum": [
+            "Private",
+            "Read",
+            "ReadSelect",
+            "ReadWrite",
+            "ReadWriteTransfer",
+            "FullAccess",
+            "ControlledByParent",
+            "ControlledByCampaign",
+            "ControlledByLeadOrContact"
+          ]
+        },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string", "description": "ファイル内容の SHA-256" }
+      }
+    },
+    "Field": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "type", "isCustom", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "type": {
+          "type": "string",
+          "description": "Salesforce のフィールド型 (Text/Number/Lookup/MasterDetail/Picklist/...) "
+        },
+        "required": { "type": "boolean" },
+        "unique": { "type": "boolean" },
+        "isCustom": { "type": "boolean" },
+        "referenceTo": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Lookup/MasterDetail の参照先オブジェクト"
+        },
+        "picklistValues": { "type": "array", "items": { "type": "string" } },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "ValidationRule": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "active", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "active": { "type": "boolean" },
+        "errorConditionFormula": { "type": "string" },
+        "errorMessage": { "type": "string" },
+        "errorDisplayField": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "Flow": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "type", "status", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "type": {
+          "type": "string",
+          "description": "AutoLaunchedFlow / Screen / RecordTriggered / Scheduled / etc."
+        },
+        "status": { "type": "string", "enum": ["Active", "Draft", "Obsolete", "InvalidDraft"] },
+        "triggeringObject": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "ApexClass": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "apiVersion", "isTest", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "apiVersion": { "type": "string" },
+        "isTest": { "type": "boolean" },
+        "isInterface": { "type": "boolean" },
+        "isAbstract": { "type": "boolean" },
+        "linesOfCode": { "type": "integer", "minimum": 0 },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "ApexTrigger": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "events", "apiVersion", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "events": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["beforeInsert", "afterInsert", "beforeUpdate", "afterUpdate", "beforeDelete", "afterDelete", "afterUndelete"]
+          }
+        },
+        "apiVersion": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "PermissionSet": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "label", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "license": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "Profile": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "userLicense": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "RecordType": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "active", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "active": { "type": "boolean" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "ApprovalProcess": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "active", "entryCriteria", "steps", "initialSubmissionActions", "finalApprovalActions", "finalRejectionActions", "recallActions", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "active": { "type": "boolean" },
+        "entryCriteria": { "type": "array" },
+        "steps": { "type": "array" },
+        "initialSubmissionActions": { "type": "array" },
+        "finalApprovalActions": { "type": "array" },
+        "finalRejectionActions": { "type": "array" },
+        "recallActions": { "type": "array" },
+        "recordEditability": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "Layout": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "layoutName", "sections", "relatedLists", "quickActions", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "layoutName": { "type": "string" },
+        "sections": { "type": "array" },
+        "relatedLists": { "type": "array" },
+        "quickActions": { "type": "array", "items": { "type": "string" } },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "CustomMetadataRecord": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "type", "recordName", "values", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "type": { "type": "string" },
+        "recordName": { "type": "string" },
+        "label": { "type": "string" },
+        "protected": { "type": "boolean" },
+        "values": { "type": "array" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "NamedCredential": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "hasSecret", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "label": { "type": "string" },
+        "endpoint": { "type": "string" },
+        "principalType": { "type": "string" },
+        "protocol": { "type": "string" },
+        "hasSecret": { "type": "boolean" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "LightningWebComponent": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "isExposed", "targets", "hasHtml", "hasCss", "apexImports", "labelImports", "publicProperties", "wires", "customEvents", "childComponents", "standardComponents", "directives", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "apiVersion": { "type": "string" },
+        "masterLabel": { "type": "string" },
+        "description": { "type": "string" },
+        "isExposed": { "type": "boolean" },
+        "targets": { "type": "array", "items": { "type": "string" } },
+        "hasHtml": { "type": "boolean" },
+        "hasCss": { "type": "boolean" },
+        "apexImports": { "type": "array" },
+        "labelImports": { "type": "array", "items": { "type": "string" } },
+        "publicProperties": { "type": "array", "items": { "type": "string" } },
+        "wires": { "type": "array" },
+        "customEvents": { "type": "array", "items": { "type": "string" } },
+        "childComponents": { "type": "array", "items": { "type": "string" } },
+        "standardComponents": { "type": "array" },
+        "directives": { "type": "array", "items": { "type": "string" } },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "AuraBundle": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "bundleKind", "hasController", "hasHelper", "hasRenderer", "hasStyle", "attributes", "handlers", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "bundleKind": { "type": "string", "enum": ["Component", "Application", "Event", "Interface", "Tokens"] },
+        "apiVersion": { "type": "string" },
+        "description": { "type": "string" },
+        "hasController": { "type": "boolean" },
+        "hasHelper": { "type": "boolean" },
+        "hasRenderer": { "type": "boolean" },
+        "hasStyle": { "type": "boolean" },
+        "attributes": { "type": "array", "items": { "type": "string" } },
+        "handlers": { "type": "array", "items": { "type": "string" } },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "FlexiPage": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "regions", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "type": { "type": "string" },
+        "sobjectType": { "type": "string" },
+        "pageTemplate": { "type": "string" },
+        "masterLabel": { "type": "string" },
+        "description": { "type": "string" },
+        "regions": { "type": "array" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "VisualforcePage": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "extensions", "hasMarkup", "markupCounts", "methodReferences", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "apiVersion": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "controller": { "type": "string" },
+        "extensions": { "type": "array", "items": { "type": "string" } },
+        "standardController": { "type": "string" },
+        "renderAs": { "type": "string" },
+        "availableInTouch": { "type": "boolean" },
+        "confirmationTokenRequired": { "type": "boolean" },
+        "hasMarkup": { "type": "boolean" },
+        "markupCounts": { "type": "array" },
+        "methodReferences": { "type": "array", "items": { "type": "string" } },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "VisualforceComponent": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "attributes", "hasMarkup", "markupCounts", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "apiVersion": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "controller": { "type": "string" },
+        "attributes": { "type": "array" },
+        "hasMarkup": { "type": "boolean" },
+        "markupCounts": { "type": "array" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "CustomApplication": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "formFactors", "tabs", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "navType": { "type": "string" },
+        "formFactors": { "type": "array", "items": { "type": "string" } },
+        "tabs": { "type": "array", "items": { "type": "string" } },
+        "utilityBar": { "type": "string" },
+        "brandColor": { "type": "string" },
+        "logo": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "RemoteSiteSetting": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "active", "disableProtocolSecurity", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "url": { "type": "string" },
+        "description": { "type": "string" },
+        "active": { "type": "boolean" },
+        "disableProtocolSecurity": { "type": "boolean" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "SharingRule": {
+      "type": "object",
+      "required": ["fullyQualifiedName", "object", "kind", "accessLevel", "sharedTo", "criteriaItems", "sourcePath", "contentHash"],
+      "properties": {
+        "fullyQualifiedName": { "type": "string" },
+        "object": { "type": "string" },
+        "kind": { "type": "string", "enum": ["criteriaBased", "ownerBased", "territoryBased"] },
+        "label": { "type": "string" },
+        "description": { "type": "string" },
+        "accessLevel": { "type": "string" },
+        "sharedTo": { "type": "object" },
+        "criteriaItems": { "type": "array" },
+        "criteriaBooleanFilter": { "type": "string" },
+        "ownerSource": { "type": "string" },
+        "sourcePath": { "type": "string" },
+        "contentHash": { "type": "string" }
+      }
+    },
+    "Dependency": {
+      "type": "object",
+      "required": ["from", "to", "kind"],
+      "description": "エンティティ間の参照関係 (多対多)。例: ApexClass から SObject への参照、Flow から Field への参照",
+      "properties": {
+        "from": { "$ref": "#/$defs/EntityRef" },
+        "to": { "$ref": "#/$defs/EntityRef" },
+        "kind": {
+          "type": "string",
+          "enum": ["references", "extends", "implements", "queries", "writes", "triggers", "grants", "uses"]
+        },
+        "evidencePath": {
+          "type": "string",
+          "description": "参照が検出されたソースのパスや行番号 (再現性検証用)"
+        }
+      }
+    },
+    "Tag": {
+      "type": "object",
+      "required": ["entity", "namespace", "value"],
+      "description": "domain / feature / release などの論理タグ",
+      "properties": {
+        "entity": { "$ref": "#/$defs/EntityRef" },
+        "namespace": { "type": "string", "enum": ["domain", "feature", "release", "custom"] },
+        "value": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/schema/validate.d.ts

@@ -0,0 +1,8 @@
+import { type ErrorObject } from "ajv/dist/2020.js";
+export declare class GraphSchemaValidationError extends Error {
+    readonly errors: readonly ErrorObject[];
+    constructor(errors: readonly ErrorObject[]);
+}
+export declare function validateGraph(data: unknown): void;
+export declare function loadGraphSchema(): Record<string, unknown>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/schema/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/schema/validate.ts"],"names":[],"mappings":"AAIA,OAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAgB7D,qBAAa,0BAA2B,SAAQ,KAAK;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;gBAC5B,MAAM,EAAE,SAAS,WAAW,EAAE;CAY3C;AAaD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAKjD;AAED,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzD"}

package/dist/schema/validate.js

@@ -0,0 +1,49 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import addFormats from "ajv-formats";
+import Ajv2020, {} from "ajv/dist/2020.js";
+const here = dirname(fileURLToPath(import.meta.url));
+const SCHEMA_PATH = resolve(here, "graph.schema.json");
+let cachedValidator;
+function loadValidator() {
+    if (cachedValidator !== undefined)
+        return cachedValidator;
+    const schema = JSON.parse(readFileSync(SCHEMA_PATH, "utf8"));
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    addFormats(ajv);
+    cachedValidator = ajv.compile(schema);
+    return cachedValidator;
+}
+export class GraphSchemaValidationError extends Error {
+    errors;
+    constructor(errors) {
+        const summary = errors
+            .slice(0, 5)
+            .map((e) => formatAjvError(e))
+            .join("\n  - ");
+        const truncated = errors.length > 5 ? `\n  ...and ${errors.length - 5} more` : "";
+        super(`Knowledge graph failed schema validation: ${errors.length} error(s)\n  - ${summary}${truncated}`);
+        this.errors = errors;
+        this.name = "GraphSchemaValidationError";
+    }
+}
+function formatAjvError(err) {
+    const path = err.instancePath !== "" ? err.instancePath : "(root)";
+    const params = err.params !== undefined && Object.keys(err.params).length > 0
+        ? ` [${Object.entries(err.params)
+            .map(([k, v]) => `${k}=${JSON.stringify(v)}`)
+            .join(", ")}]`
+        : "";
+    return `${path}: ${err.message ?? "validation failed"}${params}`;
+}
+export function validateGraph(data) {
+    const validator = loadValidator();
+    if (!validator(data)) {
+        throw new GraphSchemaValidationError(validator.errors ?? []);
+    }
+}
+export function loadGraphSchema() {
+    return JSON.parse(readFileSync(SCHEMA_PATH, "utf8"));
+}
+//# sourceMappingURL=validate.js.map

package/dist/schema/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/schema/validate.ts"],"names":[],"mappings":"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"}

package/dist/secrets/apply.d.ts

@@ -0,0 +1,17 @@
+import type { KnowledgeGraph } from "../types/graph.js";
+import type { SecretRule } from "./rules.js";
+/**
+ * 知識グラフの「ユーザ入力由来の自由文」フィールドにマスキングを適用する。
+ *
+ * 対象 (= AI プロンプト / 生成 Markdown / SQLite に流れ、機密が紛れ得る箇所):
+ *   - validationRules[].errorConditionFormula / errorMessage
+ *   - customMetadataRecords[].values[].value / label
+ *
+ * 対象外 (= 構造的識別子。マスキングすると docs が破壊される):
+ *   - fullyQualifiedName / sourcePath / contentHash / type / recordName
+ *   - その他、Salesforce のメタデータ識別子
+ *
+ * Apex / Flow 等の body は将来的に対象に含める余地がある (v0.4.0+ で検討)。
+ */
+export declare function maskGraphSensitiveFields(graph: KnowledgeGraph, rules: readonly SecretRule[]): KnowledgeGraph;
+//# sourceMappingURL=apply.d.ts.map

package/dist/secrets/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/secrets/apply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,cAAc,CAkChB"}

package/dist/secrets/apply.js

@@ -0,0 +1,44 @@
+import { maskContent } from "./mask.js";
+/**
+ * 知識グラフの「ユーザ入力由来の自由文」フィールドにマスキングを適用する。
+ *
+ * 対象 (= AI プロンプト / 生成 Markdown / SQLite に流れ、機密が紛れ得る箇所):
+ *   - validationRules[].errorConditionFormula / errorMessage
+ *   - customMetadataRecords[].values[].value / label
+ *
+ * 対象外 (= 構造的識別子。マスキングすると docs が破壊される):
+ *   - fullyQualifiedName / sourcePath / contentHash / type / recordName
+ *   - その他、Salesforce のメタデータ識別子
+ *
+ * Apex / Flow 等の body は将来的に対象に含める余地がある (v0.4.0+ で検討)。
+ */
+export function maskGraphSensitiveFields(graph, rules) {
+    if (rules.length === 0)
+        return graph;
+    const maybeMask = (value) => {
+        if (value === undefined || value === "")
+            return value;
+        return maskContent(value, rules).masked;
+    };
+    return {
+        ...graph,
+        validationRules: graph.validationRules.map((vr) => ({
+            ...vr,
+            ...(vr.errorConditionFormula !== undefined && {
+                errorConditionFormula: maybeMask(vr.errorConditionFormula),
+            }),
+            ...(vr.errorMessage !== undefined && {
+                errorMessage: maybeMask(vr.errorMessage),
+            }),
+        })),
+        customMetadataRecords: graph.customMetadataRecords.map((cmr) => ({
+            ...cmr,
+            label: maybeMask(cmr.label),
+            values: cmr.values.map((v) => ({
+                ...v,
+                value: maskContent(v.value, rules).masked,
+            })),
+        })),
+    };
+}
+//# sourceMappingURL=apply.js.map

package/dist/secrets/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/secrets/apply.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAqB,EACrB,KAA4B;IAE5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAErC,MAAM,SAAS,GAAG,CAAC,KAAyB,EAAsB,EAAE;QAClE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC;QACtD,OAAO,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC;IAC1C,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,KAAK;QACR,eAAe,EAAE,KAAK,CAAC,eAAe,CAAC,GAAG,CACxC,CAAC,EAAE,EAAkB,EAAE,CAAC,CAAC;YACvB,GAAG,EAAE;YACL,GAAG,CAAC,EAAE,CAAC,qBAAqB,KAAK,SAAS,IAAI;gBAC5C,qBAAqB,EAAE,SAAS,CAAC,EAAE,CAAC,qBAAqB,CAAC;aAC3D,CAAC;YACF,GAAG,CAAC,EAAE,CAAC,YAAY,KAAK,SAAS,IAAI;gBACnC,YAAY,EAAE,SAAS,CAAC,EAAE,CAAC,YAAY,CAAC;aACzC,CAAC;SACH,CAAC,CACH;QACD,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,CAAC,GAAG,CACpD,CAAC,GAAG,EAAwB,EAAE,CAAC,CAAC;YAC9B,GAAG,GAAG;YACN,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;YAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CACpB,CAAC,CAAC,EAA2B,EAAE,CAAC,CAAC;gBAC/B,GAAG,CAAC;gBACJ,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,MAAM;aAC1C,CAAC,CACH;SACF,CAAC,CACH;KACF,CAAC;AACJ,CAAC"}

package/dist/secrets/index.d.ts

@@ -0,0 +1,7 @@
+export { DEFAULT_RULES } from "./rules.js";
+export type { SecretRule, SensitivityLevel } from "./rules.js";
+export { maskContent } from "./mask.js";
+export type { MaskingResult, MaskingHit } from "./mask.js";
+export { loadSecretsRules, SecretsRulesError } from "./load.js";
+export type { LoadOptions } from "./load.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/secrets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/secrets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/secrets/index.js

@@ -0,0 +1,4 @@
+export { DEFAULT_RULES } from "./rules.js";
+export { maskContent } from "./mask.js";
+export { loadSecretsRules, SecretsRulesError } from "./load.js";
+//# sourceMappingURL=index.js.map

package/dist/secrets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/secrets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/secrets/load.d.ts

@@ -0,0 +1,16 @@
+import type { SecretRule } from "./rules.js";
+export declare class SecretsRulesError extends Error {
+    constructor(message: string);
+}
+export interface LoadOptions {
+    readonly rootPath?: string;
+    readonly rulesFile?: string;
+    /** ユーザのルールをデフォルトにマージ。同 id があればユーザ優先 */
+    readonly mergeWithDefaults?: boolean;
+}
+/**
+ * `<rootPath>/.yohaku/secrets-rules.yaml` を読み込み、SecretRule[] を返す。
+ * ファイルが無ければ DEFAULT_RULES を返す。
+ */
+export declare function loadSecretsRules(options?: LoadOptions): readonly SecretRule[];
+//# sourceMappingURL=load.d.ts.map

package/dist/secrets/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/secrets/load.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAK/D,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AA4DD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,WAAgB,GAAG,SAAS,UAAU,EAAE,CAoBjF"}