@yohakuforce/core 0.4.0

package/README.md

@@ -0,0 +1,65 @@
+# @yohakuforce/core
+
+Core CLI and knowledge graph engine for [yohakuforce](../../README.md).
+
+> **Status**: Phase 1 着手 (実装開始前のスケルトンのみ)。実装は順次進める。
+
+## 責務
+
+- Salesforce DX ソース (`force-app/`) → SQLite 知識グラフ (`.yohaku/graph.sqlite`)
+- 知識グラフ → 決定的な Markdown 派生物 (`docs/generated/`)
+- 入力ソース層の抽象化 (`LocalSourceAdapter` を Phase 1 で実装、`DxMcpSourceAdapter` を Phase 6 で追加)
+
+## CLI
+
+```
+yohaku graph build [--incremental] [--source local|dx-mcp]
+yohaku graph query <sql>
+yohaku graph schema [--format json|markdown]
+yohaku render <target> [--output <path>]
+yohaku validate <target>
+yohaku diff --from <ref> --to <ref> [--json]
+yohaku metrics [--period day|week|month]
+yohaku version
+```
+
+## ディレクトリ構造 (計画)
+
+```
+packages/core/
+├── package.json
+├── tsconfig.json / tsconfig.build.json
+├── vitest.config.ts
+├── biome.json
+├── src/
+│   ├── cli.ts                       (Phase 1 で実装)
+│   ├── index.ts                     (公開 API)
+│   ├── types/                       (TypeScript 型定義)
+│   │   ├── graph.ts
+│   │   ├── source-adapter.ts
+│   │   └── render.ts
+│   ├── schema/                      (JSON Schema 正本)
+│   │   └── graph.schema.json
+│   ├── merge/                       (HUMAN_MANAGED マージロジック)
+│   │   └── (Phase 1 で実装)
+│   ├── adapters/
+│   │   └── local/                   (LocalSourceAdapter)
+│   ├── graph/                       (SQLite 操作)
+│   └── render/                      (eta テンプレート描画)
+└── tests/
+    ├── unit/
+    └── golden/
+```
+
+## 設計原則
+
+1. **3 層分離**: 決定的処理は本パッケージで担う。AI 推測はここに混ぜない。
+2. **入出力の決定的性**: 同一入力 → 同一出力 をハッシュで検証 (ゴールデンテスト)
+3. **`force-app/` を読むだけ・書かない**: Layer 1 (正本) を侵さない
+4. **knowledge graph は CLI 経由でしか書き換えない**: AI / hooks から直接 INSERT 禁止
+
+## 関連ドキュメント
+
+- [`/IMPLEMENTATION_GUIDE.md`](../../IMPLEMENTATION_GUIDE.md) — 実装方針正本
+- [`/AGENTS.md`](../../AGENTS.md) — 自律ループ
+- [`/CONTRIBUTING.md`](../../CONTRIBUTING.md) — 開発フロー

package/dist/adapters/dx-mcp/dx-mcp-source-adapter.d.ts

@@ -0,0 +1,25 @@
+import type { FetchOptions, MetadataDescriptor, SourceAdapter } from "../../types/source-adapter.js";
+export interface DxMcpSourceAdapterOptions {
+    readonly orgAlias?: string;
+    /** MCP Server の HTTP エンドポイント。未指定なら stdio 経由 */
+    readonly endpoint?: string;
+    /** API バージョン (Salesforce 側) */
+    readonly apiVersion?: string;
+}
+export declare class DxMcpNotImplementedError extends Error {
+    constructor(message: string);
+}
+/**
+ * Phase 6 stub: Beta 仕様の MCP Server に接続せず、明示的にエラーを投げる。
+ * Phase 7 で公式 MCP TypeScript SDK 経由の実装に置き換える。
+ */
+export declare class DxMcpSourceAdapter implements SourceAdapter {
+    #private;
+    readonly kind: "dx-mcp";
+    constructor(options?: DxMcpSourceAdapterOptions);
+    get options(): DxMcpSourceAdapterOptions;
+    list(_options?: FetchOptions): Promise<readonly MetadataDescriptor[]>;
+    loadContent(_descriptor: MetadataDescriptor): Promise<string>;
+    computeSourceHash(): Promise<string>;
+}
+//# sourceMappingURL=dx-mcp-source-adapter.d.ts.map

package/dist/adapters/dx-mcp/dx-mcp-source-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dx-mcp-source-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/dx-mcp/dx-mcp-source-adapter.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,aAAa;;IACtD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;gBAGtB,OAAO,GAAE,yBAA8B;IAInD,IAAI,OAAO,IAAI,yBAAyB,CAEvC;IAEK,IAAI,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAQrE,WAAW,CAAC,WAAW,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAM7D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAK3C"}

package/dist/adapters/dx-mcp/dx-mcp-source-adapter.js

@@ -0,0 +1,45 @@
+// Salesforce DX MCP Server (Beta) アダプタ — Phase 6 stub 実装
+//
+// 詳細 ADR: .agents/knowledge/decisions/2026-05-07-dx-mcp-adapter-pattern.md
+//
+// 設計方針:
+// - SourceAdapter インタフェース互換 (LocalSourceAdapter と差し替え可能)
+// - Beta 仕様の流動性に対応するため、本 stub では「未接続」を明示的に投げる
+// - Phase 7 で MCP GA 後に本実装する
+//
+// このアダプタを有効化する条件:
+// - 利用者の環境に Salesforce DX MCP Server が稼働している
+// - sf CLI が認証済み org に接続している
+// - yohaku graph build --source dx-mcp で明示的に opt-in
+export class DxMcpNotImplementedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DxMcpNotImplementedError";
+    }
+}
+/**
+ * Phase 6 stub: Beta 仕様の MCP Server に接続せず、明示的にエラーを投げる。
+ * Phase 7 で公式 MCP TypeScript SDK 経由の実装に置き換える。
+ */
+export class DxMcpSourceAdapter {
+    kind = "dx-mcp";
+    #options;
+    constructor(options = {}) {
+        this.#options = options;
+    }
+    get options() {
+        return this.#options;
+    }
+    async list(_options) {
+        throw new DxMcpNotImplementedError("DxMcpSourceAdapter is not yet wired to a live Salesforce DX MCP Server. " +
+            "This is a Phase 6 stub; Phase 7 will integrate the official MCP TypeScript SDK once the Beta GA is reached. " +
+            "For now, please use --source local (default).");
+    }
+    async loadContent(_descriptor) {
+        throw new DxMcpNotImplementedError("DxMcpSourceAdapter.loadContent is not yet implemented (Phase 6 stub).");
+    }
+    async computeSourceHash() {
+        throw new DxMcpNotImplementedError("DxMcpSourceAdapter.computeSourceHash is not yet implemented (Phase 6 stub).");
+    }
+}
+//# sourceMappingURL=dx-mcp-source-adapter.js.map

package/dist/adapters/dx-mcp/dx-mcp-source-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dx-mcp-source-adapter.js","sourceRoot":"","sources":["../../../src/adapters/dx-mcp/dx-mcp-source-adapter.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,2EAA2E;AAC3E,EAAE;AACF,QAAQ;AACR,yDAAyD;AACzD,8CAA8C;AAC9C,6BAA6B;AAC7B,EAAE;AACF,kBAAkB;AAClB,6CAA6C;AAC7C,6BAA6B;AAC7B,oDAAoD;AAgBpD,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,QAAiB,CAAC;IACzB,QAAQ,CAA4B;IAE7C,YAAY,UAAqC,EAAE;QACjD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAuB;QAChC,MAAM,IAAI,wBAAwB,CAChC,0EAA0E;YACxE,8GAA8G;YAC9G,+CAA+C,CAClD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,WAA+B;QAC/C,MAAM,IAAI,wBAAwB,CAChC,uEAAuE,CACxE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB;QACrB,MAAM,IAAI,wBAAwB,CAChC,6EAA6E,CAC9E,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/dx-mcp/index.d.ts

@@ -0,0 +1,3 @@
+export { DxMcpSourceAdapter, DxMcpNotImplementedError } from "./dx-mcp-source-adapter.js";
+export type { DxMcpSourceAdapterOptions } from "./dx-mcp-source-adapter.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/dx-mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/dx-mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,YAAY,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/adapters/dx-mcp/index.js

@@ -0,0 +1,2 @@
+export { DxMcpSourceAdapter, DxMcpNotImplementedError } from "./dx-mcp-source-adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/dx-mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/dx-mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/adapters/local/index.d.ts

@@ -0,0 +1,5 @@
+export { LocalSourceAdapter } from "./local-source-adapter.js";
+export type { LocalSourceAdapterOptions } from "./local-source-adapter.js";
+export { readSfdxProject, SfdxProjectError } from "./sfdx-project.js";
+export type { SfdxProjectConfig, PackageDirectory } from "./sfdx-project.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/adapters/local/index.js

@@ -0,0 +1,3 @@
+export { LocalSourceAdapter } from "./local-source-adapter.js";
+export { readSfdxProject, SfdxProjectError } from "./sfdx-project.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/adapters/local/local-source-adapter.d.ts

@@ -0,0 +1,19 @@
+import type { FetchOptions, MetadataDescriptor, SourceAdapter } from "../../types/source-adapter.js";
+export interface LocalSourceAdapterOptions {
+    readonly rootPath: string;
+    /**
+     * パッケージディレクトリの明示指定。指定なしの場合 sfdx-project.json を読む。
+     * sfdx-project.json も無ければ ["force-app"] にフォールバック。
+     */
+    readonly packageDirectories?: readonly string[];
+}
+export declare class LocalSourceAdapter implements SourceAdapter {
+    #private;
+    readonly kind: "local";
+    constructor(options: LocalSourceAdapterOptions);
+    get packageDirectories(): readonly string[];
+    list(options?: FetchOptions): Promise<readonly MetadataDescriptor[]>;
+    loadContent(descriptor: MetadataDescriptor): Promise<string>;
+    computeSourceHash(): Promise<string>;
+}
+//# sourceMappingURL=local-source-adapter.d.ts.map

package/dist/adapters/local/local-source-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-source-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/local/local-source-adapter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,+BAA+B,CAAC;AAKvC,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACjD;AAED,qBAAa,kBAAmB,YAAW,aAAa;;IACtD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;gBAIrB,OAAO,EAAE,yBAAyB;IAK9C,IAAI,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAE1C;IAEK,IAAI,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC;IAuBpE,WAAW,CAAC,UAAU,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5D,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAM3C"}

package/dist/adapters/local/local-source-adapter.js

@@ -0,0 +1,214 @@
+import { existsSync, readFileSync } from "node:fs";
+import { isAbsolute, relative, resolve } from "node:path";
+import { combineHashes, sha256 } from "../../util/hash.js";
+import { walkFiles } from "../../util/walk.js";
+import { readSfdxProject } from "./sfdx-project.js";
+export class LocalSourceAdapter {
+    kind = "local";
+    #rootPath;
+    #packageDirectories;
+    constructor(options) {
+        this.#rootPath = options.rootPath;
+        this.#packageDirectories = resolvePackageDirectories(options);
+    }
+    get packageDirectories() {
+        return this.#packageDirectories;
+    }
+    async list(options) {
+        const allowedTypes = options?.types ? new Set(options.types) : undefined;
+        const seen = new Map();
+        for (const pkgDir of this.#packageDirectories) {
+            const sourceRoot = resolve(this.#rootPath, pkgDir);
+            if (!existsSync(sourceRoot))
+                continue;
+            for (const filePath of walkFiles(sourceRoot)) {
+                const descriptor = describeFile(filePath, this.#rootPath);
+                if (descriptor === undefined)
+                    continue;
+                if (allowedTypes !== undefined && !allowedTypes.has(descriptor.type))
+                    continue;
+                if (!seen.has(descriptor.sourcePath)) {
+                    seen.set(descriptor.sourcePath, descriptor);
+                }
+            }
+        }
+        return Array.from(seen.values()).toSorted((a, b) => a.fullyQualifiedName.localeCompare(b.fullyQualifiedName));
+    }
+    async loadContent(descriptor) {
+        const path = isAbsolute(descriptor.sourcePath)
+            ? descriptor.sourcePath
+            : resolve(this.#rootPath, descriptor.sourcePath);
+        return readFileSync(path, "utf8");
+    }
+    async computeSourceHash() {
+        const descriptors = await this.list();
+        const parts = descriptors.map((d) => `${d.fullyQualifiedName}|${d.contentHash}`);
+        const dirsPart = `pkgDirs:${[...this.#packageDirectories].toSorted().join(",")}`;
+        return combineHashes([...parts, dirsPart]);
+    }
+}
+function resolvePackageDirectories(options) {
+    if (options.packageDirectories !== undefined && options.packageDirectories.length > 0) {
+        return options.packageDirectories;
+    }
+    const config = readSfdxProject(options.rootPath);
+    return config.packageDirectories.map((d) => d.path);
+}
+const EXTENSION_CLASSIFIERS = [
+    { suffix: ".object-meta.xml", type: "CustomObject", directoryHint: "objects" },
+    { suffix: ".field-meta.xml", type: "CustomField", directoryHint: "fields" },
+    { suffix: ".validationRule-meta.xml", type: "ValidationRule", directoryHint: "validationRules" },
+    { suffix: ".flow-meta.xml", type: "Flow", directoryHint: "flows" },
+    { suffix: ".cls", type: "ApexClass", directoryHint: "classes" },
+    { suffix: ".trigger", type: "ApexTrigger", directoryHint: "triggers" },
+    { suffix: ".permissionset-meta.xml", type: "PermissionSet", directoryHint: "permissionsets" },
+    { suffix: ".profile-meta.xml", type: "Profile", directoryHint: "profiles" },
+    { suffix: ".recordType-meta.xml", type: "RecordType", directoryHint: "recordTypes" },
+    {
+        suffix: ".approvalProcess-meta.xml",
+        type: "ApprovalProcess",
+        directoryHint: "approvalProcesses",
+    },
+    { suffix: ".sharingRules-meta.xml", type: "SharingRules", directoryHint: "sharingRules" },
+    { suffix: ".layout-meta.xml", type: "Layout", directoryHint: "layouts" },
+    { suffix: ".md-meta.xml", type: "CustomMetadataRecord", directoryHint: "customMetadata" },
+    {
+        suffix: ".namedCredential-meta.xml",
+        type: "NamedCredential",
+        directoryHint: "namedCredentials",
+    },
+    {
+        suffix: ".remoteSite-meta.xml",
+        type: "RemoteSiteSetting",
+        directoryHint: "remoteSiteSettings",
+    },
+    // LWC bundle 起点
+    { suffix: ".js-meta.xml", type: "LightningWebComponent", directoryHint: "lwc" },
+    // Aura bundle 起点 (3 種を 1 タイプに集約)
+    { suffix: ".cmp-meta.xml", type: "AuraBundle", directoryHint: "aura" },
+    { suffix: ".app-meta.xml", type: "AuraBundle", directoryHint: "aura" },
+    { suffix: ".evt-meta.xml", type: "AuraBundle", directoryHint: "aura" },
+    // FlexiPage
+    { suffix: ".flexipage-meta.xml", type: "FlexiPage", directoryHint: "flexipages" },
+    // Visualforce
+    { suffix: ".page-meta.xml", type: "VisualforcePage", directoryHint: "pages" },
+    { suffix: ".component-meta.xml", type: "VisualforceComponent", directoryHint: "components" },
+    // Lightning App / CustomApplication (in applications/, AuraBundle と区別)
+    // suffix .app-meta.xml は AuraBundle と衝突するので、classifyFile でディレクトリ判別
+];
+function classifyFile(fileName, segments) {
+    // .cls-meta.xml と .trigger-meta.xml は ApexClass/Trigger 本体ではないので除外
+    if (fileName.endsWith(".cls-meta.xml") || fileName.endsWith(".trigger-meta.xml")) {
+        return undefined;
+    }
+    // CustomApplication: applications/<Name>.app-meta.xml は AuraBundle ではなく Lightning App
+    if (fileName.endsWith(".app-meta.xml") && segments.includes("applications")) {
+        return { type: "CustomApplication", directoryHint: "applications" };
+    }
+    for (const c of EXTENSION_CLASSIFIERS) {
+        if (fileName.endsWith(c.suffix)) {
+            return { type: c.type, directoryHint: c.directoryHint };
+        }
+    }
+    return undefined;
+}
+function describeFile(absolutePath, projectRoot) {
+    // Windows 互換: relative() は OS のパス区切りを返すため、保存・分割前に
+    // forward slash に正規化する。これにより sourcePath が OS 間で再現可能になる。
+    const relativePath = relative(projectRoot, absolutePath).replaceAll("\\", "/");
+    const segments = relativePath.split("/");
+    const fileName = segments.at(-1) ?? "";
+    const classification = classifyFile(fileName, segments);
+    if (classification === undefined)
+        return undefined;
+    const fqn = inferFullyQualifiedName(classification.type, segments);
+    if (fqn === undefined)
+        return undefined;
+    let content;
+    try {
+        content = readFileSync(absolutePath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+    return {
+        type: classification.type,
+        fullyQualifiedName: fqn,
+        sourcePath: relativePath,
+        contentHash: sha256(content),
+    };
+}
+function inferFullyQualifiedName(type, segments) {
+    const fileName = segments.at(-1) ?? "";
+    switch (type) {
+        case "CustomObject": {
+            const idx = segments.indexOf("objects");
+            return segments[idx + 1];
+        }
+        case "CustomField": {
+            const idx = segments.indexOf("objects");
+            const objectName = segments[idx + 1];
+            const fieldFile = fileName.replace(/\.field-meta\.xml$/, "");
+            if (objectName === undefined)
+                return undefined;
+            return `${objectName}.${fieldFile}`;
+        }
+        case "ValidationRule": {
+            const idx = segments.indexOf("objects");
+            const objectName = segments[idx + 1];
+            const ruleFile = fileName.replace(/\.validationRule-meta\.xml$/, "");
+            if (objectName === undefined)
+                return undefined;
+            return `${objectName}.${ruleFile}`;
+        }
+        case "Flow":
+            return fileName.replace(/\.flow-meta\.xml$/, "");
+        case "ApexClass":
+            return fileName.replace(/\.cls(-meta\.xml)?$/, "");
+        case "ApexTrigger":
+            return fileName.replace(/\.trigger(-meta\.xml)?$/, "");
+        case "PermissionSet":
+            return fileName.replace(/\.permissionset-meta\.xml$/, "");
+        case "Profile":
+            return fileName.replace(/\.profile-meta\.xml$/, "");
+        case "RecordType": {
+            const idx = segments.indexOf("objects");
+            const objectName = segments[idx + 1];
+            const rtFile = fileName.replace(/\.recordType-meta\.xml$/, "");
+            if (objectName === undefined)
+                return undefined;
+            return `${objectName}.${rtFile}`;
+        }
+        case "ApprovalProcess":
+            // 命名: <Object>.<ProcessName>.approvalProcess-meta.xml
+            return fileName.replace(/\.approvalProcess-meta\.xml$/, "");
+        case "SharingRules":
+            // SharingRules ファイルは <Object>.sharingRules-meta.xml の形 (1 オブジェクト 1 ファイル)
+            return fileName.replace(/\.sharingRules-meta\.xml$/, "");
+        case "Layout":
+            // 命名: <Object>-<LayoutName>.layout-meta.xml
+            return fileName.replace(/\.layout-meta\.xml$/, "");
+        case "CustomMetadataRecord":
+            // 命名: <Type>.<RecordDeveloperName>.md-meta.xml
+            return fileName.replace(/\.md-meta\.xml$/, "");
+        case "NamedCredential":
+            return fileName.replace(/\.namedCredential-meta\.xml$/, "");
+        case "RemoteSiteSetting":
+            return fileName.replace(/\.remoteSite-meta\.xml$/, "");
+        case "LightningWebComponent":
+            return fileName.replace(/\.js-meta\.xml$/, "");
+        case "AuraBundle":
+            return fileName.replace(/\.(cmp|app|evt)-meta\.xml$/, "");
+        case "FlexiPage":
+            return fileName.replace(/\.flexipage-meta\.xml$/, "");
+        case "VisualforcePage":
+            return fileName.replace(/\.page-meta\.xml$/, "");
+        case "VisualforceComponent":
+            return fileName.replace(/\.component-meta\.xml$/, "");
+        case "CustomApplication":
+            return fileName.replace(/\.app-meta\.xml$/, "");
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=local-source-adapter.js.map

package/dist/adapters/local/local-source-adapter.js.map

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

package/dist/adapters/local/sfdx-project.d.ts

@@ -0,0 +1,14 @@
+export interface PackageDirectory {
+    readonly path: string;
+    readonly default: boolean;
+}
+export interface SfdxProjectConfig {
+    readonly packageDirectories: readonly PackageDirectory[];
+    readonly sourceApiVersion?: string;
+    readonly namespace?: string;
+}
+export declare class SfdxProjectError extends Error {
+    constructor(message: string);
+}
+export declare function readSfdxProject(rootPath: string): SfdxProjectConfig;
+//# sourceMappingURL=sfdx-project.d.ts.map

package/dist/adapters/local/sfdx-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sfdx-project.d.ts","sourceRoot":"","sources":["../../../src/adapters/local/sfdx-project.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAqBnE"}

package/dist/adapters/local/sfdx-project.js

@@ -0,0 +1,76 @@
+// sfdx-project.json の最小読み取り
+// 仕様: https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_ws_config.htm
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const DEFAULT_PACKAGE_DIRECTORIES = [
+    { path: "force-app", default: true },
+];
+export class SfdxProjectError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SfdxProjectError";
+    }
+}
+export function readSfdxProject(rootPath) {
+    const path = join(rootPath, "sfdx-project.json");
+    if (!existsSync(path)) {
+        return { packageDirectories: DEFAULT_PACKAGE_DIRECTORIES };
+    }
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (err) {
+        throw new SfdxProjectError(`Failed to read sfdx-project.json: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new SfdxProjectError(`sfdx-project.json is not valid JSON: ${err.message}`);
+    }
+    return normalizeConfig(parsed);
+}
+function normalizeConfig(parsed) {
+    if (parsed === null || typeof parsed !== "object") {
+        throw new SfdxProjectError("sfdx-project.json must be a JSON object");
+    }
+    const obj = parsed;
+    const rawDirs = obj.packageDirectories;
+    const packageDirectories = normalizePackageDirectories(rawDirs);
+    return {
+        packageDirectories,
+        sourceApiVersion: typeof obj.sourceApiVersion === "string" ? obj.sourceApiVersion : undefined,
+        namespace: typeof obj.namespace === "string" ? obj.namespace : undefined,
+    };
+}
+function normalizePackageDirectories(value) {
+    if (!Array.isArray(value) || value.length === 0) {
+        return DEFAULT_PACKAGE_DIRECTORIES;
+    }
+    const dirs = [];
+    for (const entry of value) {
+        if (entry === null || typeof entry !== "object")
+            continue;
+        const e = entry;
+        if (typeof e.path !== "string")
+            continue;
+        dirs.push({
+            path: e.path,
+            default: e.default === true,
+        });
+    }
+    if (dirs.length === 0)
+        return DEFAULT_PACKAGE_DIRECTORIES;
+    if (!dirs.some((d) => d.default)) {
+        const firstDir = dirs[0];
+        if (firstDir !== undefined) {
+            const promoted = { path: firstDir.path, default: true };
+            const tail = dirs.slice(1);
+            return [promoted, ...tail];
+        }
+    }
+    return dirs;
+}
+//# sourceMappingURL=sfdx-project.js.map

package/dist/adapters/local/sfdx-project.js.map

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

package/dist/change-summary/index.d.ts

@@ -0,0 +1,4 @@
+export { deterministic, ai, human, } from "./types.js";
+export type { Source, Tracked, ChangeCategoryKind, ChangeKind as ChangeSummaryChangeKind, ScopeSize, SarifFinding, ChangeEntry, CategorySection, HumanAnnotations, ChangeSummary, } from "./types.js";
+export { validateChangeSummary, loadChangeSummarySchema, ChangeSummaryValidationError, } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/change-summary/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/change-summary/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,EAAE,EACF,KAAK,GACN,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,UAAU,IAAI,uBAAuB,EACrC,SAAS,EACT,YAAY,EACZ,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,eAAe,CAAC"}

package/dist/change-summary/index.js

@@ -0,0 +1,3 @@
+export { deterministic, ai, human, } from "./types.js";
+export { validateChangeSummary, loadChangeSummarySchema, ChangeSummaryValidationError, } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/change-summary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/change-summary/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,EAAE,EACF,KAAK,GACN,MAAM,YAAY,CAAC;AAapB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,eAAe,CAAC"}