@yohakuforce/core 0.4.0

package/dist/render/templates/executive-summary.eta

@@ -0,0 +1,68 @@
+# Executive Summary — Salesforce 構築物の全体像
+
+<!-- DETERMINISTIC_START id="meta" -->
+- 集計日時: <%= it.builtAt %>
+- yohaku version: <%= it.yohakuVersion %>
+- Salesforce API version: <%= it.salesforceApiVersion %>
+<!-- DETERMINISTIC_END id="meta" -->
+
+<!-- DETERMINISTIC_START id="footprint" -->
+## 構築規模 (上層部・承認者向け概観)
+
+| 区分 | 件数 |
+|---|---|
+| カスタム + 標準オブジェクト | <%= it.counts.objects %> |
+| フィールド | <%= it.counts.fields %> |
+| 入力規則 (Validation Rule) | <%= it.counts.validationRules %> |
+| Flow | <%= it.counts.flows %> |
+| Apex クラス | <%= it.counts.apexClasses %> |
+| Apex トリガー | <%= it.counts.apexTriggers %> |
+| 権限セット | <%= it.counts.permissionSets %> |
+| プロファイル | <%= it.counts.profiles %> |
+
+### カスタムオブジェクト
+<% if (it.customObjects.length === 0) { %>
+(カスタムオブジェクトなし)
+<% } else { %>
+<% it.customObjects.forEach(function(o){ %>
+- `<%= o %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="footprint" -->
+
+<!-- DETERMINISTIC_START id="quality" -->
+## 品質指標
+
+- Apex テストクラス数: <%= it.apexTestRatio.tests %>
+- Apex 非テストクラス数: <%= it.apexTestRatio.nonTests %>
+- テスト/非テスト比: <%= it.apexTestRatio.ratio %>
+<% if (it.apexTestRatio.ratio < 0.5 && it.apexTestRatio.nonTests > 0) { %>
+> ⚠️ テストクラス比率が 50% 未満です。リリース判断時はテストカバレッジレポート (Code Analyzer / Apex Test Result) を併読してください。
+<% } %>
+<!-- DETERMINISTIC_END id="quality" -->
+
+<!-- DETERMINISTIC_START id="trigger-map" -->
+## オブジェクト別トリガー配置
+
+<% if (it.triggersByObject.length === 0) { %>
+(トリガーなし)
+<% } else { %>
+| オブジェクト | トリガー |
+|---|---|
+<% it.triggersByObject.forEach(function(g){ %>
+| `<%= g.object %>` | <%= g.triggers.map(t=>"`"+t+"`").join(", ") %> |
+<% }) %>
+
+> 1 オブジェクトに複数トリガーがある場合は、ハンドラパターンへの集約余地を技術担当と確認してください (一般的なベストプラクティス)。
+<% } %>
+<!-- DETERMINISTIC_END id="trigger-map" -->
+
+<!-- AI_MANAGED_START id="narrative" -->
+## 上層部向けナラティブ (AI 生成、再生成で上書き)
+
+承認判断に必要な変更点・リスク・依存関係の総括。Phase 7-D で精度向上。
+<!-- AI_MANAGED_END id="narrative" -->
+
+<!-- HUMAN_MANAGED_START id="approver-notes" -->
+<!-- 承認者・上長向けの補足 (社内固有の判断材料)。AI は上書きしません。 -->
+<!-- HUMAN_MANAGED_END id="approver-notes" -->

package/dist/render/templates/flexi-page.eta

@@ -0,0 +1,47 @@
+# FlexiPage: <%= it.fp.fullyQualifiedName %>
+
+<!-- DETERMINISTIC_START id="quick-summary" -->
+> <%~ it.quickSummary %>
+<!-- DETERMINISTIC_END id="quick-summary" -->
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.fp.fullyQualifiedName %>`
+<% if (it.fp.masterLabel) { %>- Master Label: <%= it.fp.masterLabel %><% } %>
+<% if (it.fp.type) { %>- Type: `<%= it.fp.type %>`<% } %>
+<% if (it.fp.sobjectType) { %>- SObject: `<%= it.fp.sobjectType %>`<% } %>
+<% if (it.fp.pageTemplate) { %>- Template: `<%= it.fp.pageTemplate %>`<% } %>
+<% if (it.fp.description) { %>- Description: <%= it.fp.description %><% } %>
+- Source: `<%= it.fp.sourcePath %>`
+- Content hash: `<%= it.fp.contentHash %>`
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="regions" -->
+## Regions (<%= it.fp.regions.length %>)
+
+<% if (it.fp.regions.length === 0) { %>
+(リージョンなし)
+<% } else { %>
+<% it.fp.regions.forEach(function(r){ %>
+### Region: `<%= r.name %>`<%= r.type ? ` (${r.type})` : "" %>
+
+<% if (r.items.length === 0) { %>
+(項目なし)
+<% } else { %>
+| 項目 | 種別 | 内容 |
+|---|---|---|
+<% r.items.forEach(function(it){ %>
+| <%= it.componentName ? "Component" : "Field" %> | <%= it.componentName ? "コンポーネント" : "フィールド" %> | `<%= it.componentName || it.fieldName %>` |
+<% }) %>
+<% } %>
+
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="regions" -->
+
+<!-- AI_MANAGED_START id="purpose" -->
+このページの業務的位置づけ (AI 推測)。
+<!-- AI_MANAGED_END id="purpose" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 想定ユーザ・配置先タブやアプリの説明を人手記述。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->

package/dist/render/templates/flow.eta

@@ -0,0 +1,166 @@
+# Flow: <%= it.flow.fullyQualifiedName %>
+
+<!-- DETERMINISTIC_START id="quick-summary" -->
+> <%~ it.quickSummary %>
+<!-- DETERMINISTIC_END id="quick-summary" -->
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.flow.fullyQualifiedName %>`
+<% if (it.flow.label) { %>- Label: <%= it.flow.label %><% } %>
+- Type: <%= it.flow.type %>
+- Status: <%= it.flow.status %>
+<% if (it.flow.triggeringObject) { %>- Triggering Object: `<%= it.flow.triggeringObject %>`<% } %>
+- Source: `<%= it.flow.sourcePath %>`
+- Content hash: `<%= it.flow.contentHash %>`
+<% if (it.flow.description) { %>
+## Description
+<%= it.flow.description %>
+<% } %>
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="elements" -->
+## 構成要素 (<%= it.flow.body ? it.flow.body.elements.length : 0 %>)
+
+<% if (!it.flow.body || it.flow.body.elements.length === 0) { %>
+(検出要素なし)
+<% } else { %>
+| 種別 | API 名 | ラベル | 対象 |
+|---|---|---|---|
+<% it.flow.body.elements.forEach(function(e){ %>
+| <%= e.kind %> | `<%= e.name %>` | <%= e.label || "—" %> | <%= e.target ? "`"+e.target+"`" : "—" %> |
+<% }) %>
+<% } %>
+
+### 操作対象オブジェクト
+<% if (!it.flow.body || it.flow.body.recordObjects.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.flow.body.recordObjects.forEach(function(o){ %>
+- `<%= o %>`
+<% }) %>
+<% } %>
+
+### サブフロー / アクション呼び出し
+<% if (it.flow.body && it.flow.body.subflows.length > 0) { %>
+- サブフロー:
+<% it.flow.body.subflows.forEach(function(s){ %>
+  - `<%= s %>`
+<% }) %>
+<% } %>
+<% if (it.flow.body && it.flow.body.actionCalls.length > 0) { %>
+- アクション:
+<% it.flow.body.actionCalls.forEach(function(a){ %>
+  - `<%= a %>`
+<% }) %>
+<% } %>
+<% if (!it.flow.body || (it.flow.body.subflows.length === 0 && it.flow.body.actionCalls.length === 0)) { %>
+(検出なし)
+<% } %>
+<!-- DETERMINISTIC_END id="elements" -->
+
+<!-- DETERMINISTIC_START id="flow-diagram" -->
+## 処理フロー (詳細)
+
+<% if (it.flowchart) { %>
+```mermaid
+<%~ it.flowchart %>
+```
+
+<% if (it.flowchartDetails && it.flowchartDetails.length > 0) { %>
+**ノード詳細**
+
+| Step | 種別 | 内容 |
+|---|---|---|
+<% it.flowchartDetails.forEach(function(d){ %>
+| `<%~ d.id %>` | <%~ d.kind %> | `<%~ d.fullText %>` |
+<% }) %>
+<% } %>
+<% } else { %>
+(Flow body 未取得)
+<% } %>
+<!-- DETERMINISTIC_END id="flow-diagram" -->
+
+<!-- DETERMINISTIC_START id="dependencies" -->
+## Dependencies (<%= it.dependencies.length %>)
+
+<% if (it.dependencies.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.dependencies.forEach(function(d){ %>
+- <%= d.kind %>: `<%= d.from.kind %>:<%= d.from.fullyQualifiedName %>` → `<%= d.to.kind %>:<%= d.to.fullyQualifiedName %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="dependencies" -->
+
+<!-- DETERMINISTIC_START id="processing-sequence-table" -->
+## 処理詳細 — 実行シーケンス表
+
+<% if (!it.flowSequenceRows || it.flowSequenceRows.length === 0) { %>
+(処理シーケンスを構成できる要素なし)
+<% } else { %>
+| 順 | 要素名 | 種別 | 概要 |
+|---|---|---|---|
+<% it.flowSequenceRows.forEach(function(r){ %>
+| <%= r.order %> | `<%= r.name %>`<%= r.label ? " ("+r.label+")" : "" %> | <%= r.kind %> | <%~ r.summary %> |
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="processing-sequence-table" -->
+
+<!-- AI_MANAGED_START id="processing-overview-narrative" -->
+## 処理概要 — 自然言語での説明
+
+この Flow 全体の処理の流れを 1〜2 段落で記述する。「起動条件 → 主要な分岐 → 最終的な副作用 (作成/更新/通知)」を大きな粒度で説明する (AI 生成)。
+<!-- AI_MANAGED_END id="processing-overview-narrative" -->
+
+<!-- AI_MANAGED_START id="processing-details-narrative" -->
+## 処理詳細 — 要素ごとの自然言語説明
+
+各要素が何をしているかを順に詳述する。
+
+- **`<elementName>`**: この要素が扱うデータ / 条件 / 結果を 1〜2 行で書く
+
+(AI 生成、再生成で上書き)
+<!-- AI_MANAGED_END id="processing-details-narrative" -->
+
+<!-- AI_MANAGED_START id="purpose" -->
+この Flow の役割と用途 (AI 生成、再生成で上書き)。
+<!-- AI_MANAGED_END id="purpose" -->
+
+<!-- AI_MANAGED_START id="narrative" -->
+## この Flow は何で、なぜ存在するか
+
+この Flow が解いている業務上の課題と、なぜ Flow (Apex / Trigger ではなく) で実装したかを 2〜3 段落で記述する (AI 生成)。
+<!-- AI_MANAGED_END id="narrative" -->
+
+<!-- AI_MANAGED_START id="business-scenario" -->
+## 典型的な業務シナリオ
+
+この Flow が起動される典型ケースを「いつ / 誰の操作 / どのレコード変化」の粒度で具体例として書く (AI 生成)。
+<!-- AI_MANAGED_END id="business-scenario" -->
+
+<!-- AI_MANAGED_START id="operational-notes" -->
+## 運用上の留意点
+
+bulk 化制約 / 既存 Trigger との順序関係 / 失敗時の挙動 / 監視ポイントを記述する (AI 生成)。
+<!-- AI_MANAGED_END id="operational-notes" -->
+
+<!-- DETERMINISTIC_START id="auto-concerns" -->
+## 自動検出された懸念点 (<%= it.concerns ? it.concerns.length : 0 %>)
+
+<% if (!it.concerns || it.concerns.length === 0) { %>
+(検出なし)
+<% } else { %>
+<% it.concerns.forEach(function(c){ %>
+- **[<%= c.severity %>] <%= c.title %>**<% if (c.detail) { %> — <%= c.detail %><% } %>
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="auto-concerns" -->
+
+<!-- AI_MANAGED_START id="concerns" -->
+## 補足の懸念 (AI / 人手で追記)
+<!-- 業務的観点や運用観点での懸念を追記。AI 推測 / Phase 7-D 以降で精度向上。 -->
+<!-- AI_MANAGED_END id="concerns" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 業務文脈・運用上の留意点をここに記述。AI は上書きしません。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->

package/dist/render/templates/layout.eta

@@ -0,0 +1,68 @@
+# Layout: <%= it.layout.fullyQualifiedName %>
+
+<!-- DETERMINISTIC_START id="quick-summary" -->
+> <%~ it.quickSummary %>
+<!-- DETERMINISTIC_END id="quick-summary" -->
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.layout.fullyQualifiedName %>`
+- Object: `<%= it.layout.object %>`
+- Layout Name: <%= it.layout.layoutName %>
+- Source: `<%= it.layout.sourcePath %>`
+- Content hash: `<%= it.layout.contentHash %>`
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="sections" -->
+## セクション (<%= it.layout.sections.length %>)
+
+<% if (it.layout.sections.length === 0) { %>
+(セクションなし)
+<% } else { %>
+<% it.layout.sections.forEach(function(s, i){ %>
+### Section <%= i + 1 %>: <%= s.label %><%= s.columnsStyle ? ` _(${s.columnsStyle})_` : "" %>
+
+<% if (s.items.length === 0) { %>
+(項目なし)
+<% } else { %>
+| 列 | フィールド | 動作 |
+|---|---|---|
+<% s.items.forEach(function(it){ %>
+| <%= it.column %> | `<%= it.field %>` | <%= it.behavior %> |
+<% }) %>
+<% } %>
+
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="sections" -->
+
+<!-- DETERMINISTIC_START id="related-lists" -->
+## 関連リスト (<%= it.layout.relatedLists.length %>)
+
+<% if (it.layout.relatedLists.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.layout.relatedLists.forEach(function(rl){ %>
+- `<%= rl.relatedList %>`<% if (rl.fields.length > 0) { %> — フィールド: <%= rl.fields.map(function(f){ return "`" + f + "`"; }).join(", ") %><% } %>
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="related-lists" -->
+
+<!-- DETERMINISTIC_START id="quick-actions" -->
+## クイックアクション (<%= it.layout.quickActions.length %>)
+
+<% if (it.layout.quickActions.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.layout.quickActions.forEach(function(q){ %>
+- `<%= q %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="quick-actions" -->
+
+<!-- AI_MANAGED_START id="purpose" -->
+このレイアウトの業務的役割 (AI 推測)。
+<!-- AI_MANAGED_END id="purpose" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 想定ユーザ・操作の流れを人手記述。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->

package/dist/render/templates/lwc.eta

@@ -0,0 +1,118 @@
+# LWC: <%= it.lwc.fullyQualifiedName %>
+
+<!-- DETERMINISTIC_START id="quick-summary" -->
+> <%~ it.quickSummary %>
+<!-- DETERMINISTIC_END id="quick-summary" -->
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.lwc.fullyQualifiedName %>`
+<% if (it.lwc.masterLabel) { %>- Master Label: <%= it.lwc.masterLabel %><% } %>
+<% if (it.lwc.apiVersion) { %>- API Version: <%= it.lwc.apiVersion %><% } %>
+- Exposed: <%= it.lwc.isExposed ? "✓ true" : "false (内部利用)" %>
+<% if (it.lwc.targets.length > 0) { %>- Targets: <%= it.lwc.targets.map(function(t){ return "`" + t + "`"; }).join(", ") %><% } %>
+- Bundle 構成: JS<% if (it.lwc.hasHtml) { %> + HTML<% } %><% if (it.lwc.hasCss) { %> + CSS<% } %>
+<% if (it.lwc.description) { %>- Description: <%= it.lwc.description %><% } %>
+- Source: `<%= it.lwc.sourcePath %>`
+- Content hash: `<%= it.lwc.contentHash %>`
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="apex-imports" -->
+## Apex 呼び出し (<%= it.lwc.apexImports.length %>)
+
+<% if (it.lwc.apexImports.length === 0) { %>
+(なし)
+<% } else { %>
+| エイリアス | クラス | メソッド |
+|---|---|---|
+<% it.lwc.apexImports.forEach(function(a){ %>
+| `<%= a.methodAlias %>` | `<%= a.className %>` | `<%= a.methodName %>` |
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="apex-imports" -->
+
+<!-- DETERMINISTIC_START id="public-api" -->
+## 公開プロパティ (@api) (<%= it.lwc.publicProperties.length %>)
+
+<% if (it.lwc.publicProperties.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.lwc.publicProperties.forEach(function(p){ %>
+- `<%= p %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="public-api" -->
+
+<!-- DETERMINISTIC_START id="wires" -->
+## @wire 一覧 (<%= it.lwc.wires.length %>)
+
+<% if (it.lwc.wires.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.lwc.wires.forEach(function(w){ %>
+- `<%= w.target %>`<% if (w.bindingProperty) { %> → `<%= w.bindingProperty %>`<% } %>
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="wires" -->
+
+<!-- DETERMINISTIC_START id="events" -->
+## 発火する CustomEvent (<%= it.lwc.customEvents.length %>)
+
+<% if (it.lwc.customEvents.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.lwc.customEvents.forEach(function(e){ %>
+- `<%= e %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="events" -->
+
+<!-- DETERMINISTIC_START id="components" -->
+## 子コンポーネント / 標準コンポーネント
+
+### 子 LWC (<%= it.lwc.childComponents.length %>)
+<% if (it.lwc.childComponents.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.lwc.childComponents.forEach(function(c){ %>
+- `<%= c %>`
+<% }) %>
+<% } %>
+
+### 標準コンポーネント (<%= it.lwc.standardComponents.length %>)
+<% if (it.lwc.standardComponents.length === 0) { %>
+(なし)
+<% } else { %>
+| タグ | 出現回数 |
+|---|---|
+<% it.lwc.standardComponents.forEach(function(c){ %>
+| `<%= c.tag %>` | <%= c.count %> |
+<% }) %>
+<% } %>
+
+### LWC ディレクティブ
+<% if (it.lwc.directives.length === 0) { %>
+(なし)
+<% } else { %>
+<%= it.lwc.directives.map(function(d){ return "`" + d + "`"; }).join(", ") %>
+<% } %>
+<!-- DETERMINISTIC_END id="components" -->
+
+<!-- DETERMINISTIC_START id="labels" -->
+## Custom Label 参照 (<%= it.lwc.labelImports.length %>)
+
+<% if (it.lwc.labelImports.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.lwc.labelImports.forEach(function(l){ %>
+- `<%= l %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="labels" -->
+
+<!-- AI_MANAGED_START id="purpose" -->
+このコンポーネントの業務的役割と画面遷移上の位置 (AI 推測)。
+<!-- AI_MANAGED_END id="purpose" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 想定ユーザ・前提画面・運用上の留意点を人手記述。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->

package/dist/render/templates/named-credential.eta

@@ -0,0 +1,30 @@
+# NamedCredential: <%= it.nc.fullyQualifiedName %>
+
+<!-- DETERMINISTIC_START id="quick-summary" -->
+> <%~ it.quickSummary %>
+<!-- DETERMINISTIC_END id="quick-summary" -->
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.nc.fullyQualifiedName %>`
+<% if (it.nc.label) { %>- Label: <%= it.nc.label %><% } %>
+<% if (it.nc.endpoint) { %>- Endpoint: `<%= it.nc.endpoint %>`<% } %>
+<% if (it.nc.protocol) { %>- Protocol: `<%= it.nc.protocol %>`<% } %>
+<% if (it.nc.principalType) { %>- Principal Type: `<%= it.nc.principalType %>`<% } %>
+- シークレット: <%= it.nc.hasSecret ? "✓ あり (値そのものは出力しません)" : "—" %>
+- Source: `<%= it.nc.sourcePath %>`
+- Content hash: `<%= it.nc.contentHash %>`
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="security-note" -->
+## セキュリティ注記
+
+> 本ドキュメントには **シークレット (パスワード / OAuth トークン / 証明書 等)** の **値そのもの** を含めていません。値が必要な場合は force-app の生 XML、または Salesforce 組織の Setup から取得してください。本ファイルは **シークレットの存在のみ** を表示します。
+<!-- DETERMINISTIC_END id="security-note" -->
+
+<!-- AI_MANAGED_START id="purpose" -->
+この外部連携の業務的目的 (AI 推測)。
+<!-- AI_MANAGED_END id="purpose" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 連携先システム名・運用窓口・障害時の連絡先などを人手記述。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->

package/dist/render/templates/object.eta

@@ -0,0 +1,68 @@
+# <%= it.object.label %> (<%= it.object.fullyQualifiedName %>)
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.object.fullyQualifiedName %>`
+- Custom: <%= it.object.isCustom ? "true" : "false" %>
+<% if (it.object.sharingModel) { %>- Sharing Model: <%= it.object.sharingModel %><% } %>
+<% if (it.object.pluralLabel) { %>- Plural Label: <%= it.object.pluralLabel %><% } %>
+- Source: `<%= it.object.sourcePath %>`
+- Content hash: `<%= it.object.contentHash %>`
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="fields" -->
+## Fields (<%= it.fields.length %>)
+
+<% if (it.fields.length === 0) { %>
+(なし)
+<% } else { %>
+| API Name | Type | Required | Custom | References |
+|---|---|---|---|---|
+<% it.fields.forEach(function(f){ %>
+| `<%= f.fullyQualifiedName.split('.')[1] %>` | <%= f.type %> | <%= f.required ? "✓" : "" %> | <%= f.isCustom ? "✓" : "" %> | <%= (f.referenceTo || []).join(', ') %> |
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="fields" -->
+
+<!-- DETERMINISTIC_START id="validation-rules" -->
+## Validation Rules (<%= it.validationRules.length %>)
+
+<% if (it.validationRules.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.validationRules.forEach(function(v){ %>
+- `<%= v.fullyQualifiedName %>` <%= v.active ? "(active)" : "(inactive)" %>
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="validation-rules" -->
+
+<!-- DETERMINISTIC_START id="dependencies" -->
+## Dependencies (<%= it.dependencies.length %>)
+
+<% if (it.dependencies.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.dependencies.forEach(function(d){ %>
+- <%= d.kind %>: `<%= d.from.kind %>:<%= d.from.fullyQualifiedName %>` → `<%= d.to.kind %>:<%= d.to.fullyQualifiedName %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="dependencies" -->
+
+<!-- AI_MANAGED_START id="summary" -->
+このオブジェクトの役割と用途 (AI 生成、再生成で上書き)。
+<!-- AI_MANAGED_END id="summary" -->
+
+<!-- AI_MANAGED_START id="narrative" -->
+## このオブジェクトは何で、なぜ存在するか
+
+このオブジェクトが業務上どの実体を表しているか、なぜカスタムオブジェクトとして切り出されているかを 2〜3 段落で記述する (AI 生成)。
+<!-- AI_MANAGED_END id="narrative" -->
+
+<!-- AI_MANAGED_START id="business-domain" -->
+## 業務ドメインと位置付け
+
+このオブジェクトが属する業務領域 (請求 / 在庫 / 与信 / 案件 等) と、隣接オブジェクトとの関係を記述する (AI 生成)。
+<!-- AI_MANAGED_END id="business-domain" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 業務コンテキスト・運用上の留意点をここに記述。AI は上書きしません。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->

package/dist/render/templates/permission-set.eta

@@ -0,0 +1,80 @@
+# PermissionSet: <%= it.ps.fullyQualifiedName %>
+
+<!-- DETERMINISTIC_START id="quick-summary" -->
+> <%~ it.quickSummary %>
+<!-- DETERMINISTIC_END id="quick-summary" -->
+
+<!-- DETERMINISTIC_START id="overview" -->
+- API Name: `<%= it.ps.fullyQualifiedName %>`
+- Label: <%= it.ps.label %>
+<% if (it.ps.license) { %>- License: <%= it.ps.license %><% } %>
+<% if (it.ps.description) { %>- Description: <%= it.ps.description %><% } %>
+- Source: `<%= it.ps.sourcePath %>`
+- Content hash: `<%= it.ps.contentHash %>`
+<!-- DETERMINISTIC_END id="overview" -->
+
+<!-- DETERMINISTIC_START id="object-permissions" -->
+## オブジェクト権限 (<%= it.ps.body ? it.ps.body.objectPermissions.length : 0 %>)
+
+<% if (!it.ps.body || it.ps.body.objectPermissions.length === 0) { %>
+(なし)
+<% } else { %>
+| オブジェクト | C | R | U | D | View All | Modify All |
+|---|---|---|---|---|---|---|
+<% it.ps.body.objectPermissions.forEach(function(p){ %>
+| `<%= p.object %>` | <%= p.create ? "✓" : "—" %> | <%= p.read ? "✓" : "—" %> | <%= p.edit ? "✓" : "—" %> | <%= p.delete ? "✓" : "—" %> | <%= p.viewAll ? "✓" : "—" %> | <%= p.modifyAll ? "✓" : "—" %> |
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="object-permissions" -->
+
+<!-- DETERMINISTIC_START id="field-permissions" -->
+## フィールド権限 (<%= it.ps.body ? it.ps.body.fieldPermissions.length : 0 %>)
+
+<% if (!it.ps.body || it.ps.body.fieldPermissions.length === 0) { %>
+(なし)
+<% } else { %>
+| フィールド | Read | Edit |
+|---|---|---|
+<% it.ps.body.fieldPermissions.forEach(function(p){ %>
+| `<%= p.field %>` | <%= p.readable ? "✓" : "—" %> | <%= p.editable ? "✓" : "—" %> |
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="field-permissions" -->
+
+<!-- DETERMINISTIC_START id="class-accesses" -->
+## Apex クラス アクセス (<%= it.ps.body ? it.ps.body.classAccesses.length : 0 %>)
+
+<% if (!it.ps.body || it.ps.body.classAccesses.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.ps.body.classAccesses.forEach(function(c){ %>
+- `<%= c.apexClass %>` <%= c.enabled ? "✓ enabled" : "✗ disabled" %>
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="class-accesses" -->
+
+<!-- DETERMINISTIC_START id="user-permissions" -->
+## ユーザ権限 (システム権限) (<%= it.ps.body ? it.ps.body.userPermissions.length : 0 %>)
+
+<% if (!it.ps.body || it.ps.body.userPermissions.length === 0) { %>
+(なし)
+<% } else { %>
+<% it.ps.body.userPermissions.forEach(function(u){ %>
+- `<%= u %>`
+<% }) %>
+<% } %>
+<!-- DETERMINISTIC_END id="user-permissions" -->
+
+<!-- AI_MANAGED_START id="purpose" -->
+この PermissionSet の業務的役割 (AI 推測)。
+<!-- AI_MANAGED_END id="purpose" -->
+
+<!-- AI_MANAGED_START id="concerns" -->
+## 気になる点 (AI 推測)
+<!-- - 未割当 (assignment 0 件) -->
+<!-- - 過剰権限の可能性 -->
+<!-- AI_MANAGED_END id="concerns" -->
+
+<!-- HUMAN_MANAGED_START id="business-context" -->
+<!-- 対象業務ロール・想定ユーザを人手記述。AI は上書きしません。 -->
+<!-- HUMAN_MANAGED_END id="business-context" -->