@adep/cli 0.4.1 → 0.4.5

package/templates/app-mobile/plugins/adep-bridge/ios/Sources/AdepPermissionGate.swift

@@ -9,14 +9,29 @@ import Foundation
 public final class AdepPermissionGate {
     /// 与 bridge/gate.mjs 共用的契约常量。
     public static let permissionDenied = "PERMISSION_DENIED"
-    /// 与 CLI 写入文件名一致的契约常量（app/site/adep.permissions.json → cap sync → Public/）。
-    static let manifestFileName = "adep.permissions.json"
 
     public enum Result {
         case granted
         case denied(reason: String)
     }
 
+    /// 与 CLI 写入文件名一致的契约常量（app/site/adep.permissions.json → cap sync → Public/）。
+    static let manifestFileName = "adep.permissions.json"
+
+    /// 清单可能所在的**包内子目录**，按查找顺序排列（`nil` = 包根）。命中即停。
+    ///
+    /// 候选表已收敛到 `AdepShellConfig.candidateSubdirectories`（APP-027）——权限清单与
+    /// 壳配置（`adep.app.json`）走同一条定位路径。两处各写一份的后果是「一个资源看得到、
+    /// 另一个看不到」，而症状分别是「门控不可用」与「身份签发静默跳过」。
+    ///
+    /// 这里保留同义入口（而不是删掉）：文档与排障笔记引用的就是这个符号名。
+    static var manifestCandidateSubdirectories: [String?] { AdepShellConfig.candidateSubdirectories }
+
+    /// 按候选顺序定位清单；全缺返回 nil（调用方 fail-closed）。
+    static func manifestURL(in bundle: Bundle) -> URL? {
+        AdepShellConfig.resourceURL(named: manifestFileName, in: bundle)
+    }
+
     private let permissions: [String]
     private let audit: AdepAuditLog
 
@@ -25,13 +40,19 @@ public final class AdepPermissionGate {
         self.audit = audit
     }
 
+    /// 已加载的声明清单（只读；启动日志与测试断言用，不对外暴露实现细节）。
+    var declaredPermissions: [String] { permissions }
+
     /// 从 bundle 读权限清单并装配门控。
     /// 清单缺失 → throw（调用方 fail-closed：门控建立不了 = 一切原生能力不可用）。
     static func load(from bundle: Bundle) throws -> AdepPermissionGate {
-        guard let url = bundle.url(forResource: manifestFileName, withExtension: nil) else {
+        guard let url = manifestURL(in: bundle) else {
             throw NSError(
                 domain: "AdepBridge", code: 1,
-                userInfo: [NSLocalizedDescriptionKey: "Bundle 缺少 \(manifestFileName)（CLI build 写入、cap sync 同步）"]
+                userInfo: [
+                    NSLocalizedDescriptionKey:
+                        "Bundle 缺少 \(manifestFileName)（候选位置：包根 / site/ / public/；CLI build 写入、cap sync 或 xtool resources 复制）"
+                ]
             )
         }
         let data = try Data(contentsOf: url)

package/templates/app-mobile/plugins/adep-bridge/ios/Sources/AdepShellConfig.swift

@@ -0,0 +1,54 @@
+import Foundation
+
+/// 壳内随包资源的定位（APP-027 抽出；原先是 `AdepPermissionGate` 的私有候选表）。
+///
+/// 为什么需要候选表（APP-018 现场实测）：`Bundle.url(forResource:withExtension:)` **不递归
+/// 子目录**——本机 flat bundle 实测：根下的文件命中，`site/x.json` 与 `site/sub/deep.txt`
+/// 全返回 nil。而两条壳的落点都在子目录里，且 CLI 改不了另一条壳的落点：
+/// - `site/`：xtool 壳（`xtool.yml` 的 `resources: [app/site]`，Packer 的 `copyItem` 递归复制到
+///   `<.app>/site/`）；
+/// - `public/`：Capacitor 壳（`cap sync` 把 `webDir: app/site` 同步进 iOS `Public/`）。
+///
+/// 包根那条留着兼容「平铺到 .app 根」的打包方式。**顺序固定**：根优先（若有平铺副本，
+/// 用它，避免同包两份各说各话时读到的不是期望那份）。
+///
+/// ⚠️ 这张表是**唯一真相源**：`AdepPermissionGate`（权限清单）与 `AdepIdentity`（壳配置）
+/// 都经此处定位。两处各写一份候选表的后果是「一个资源看得到、另一个看不到」，
+/// 而症状分别是「门控不可用」与「身份签发静默跳过」——两个都像功能没做。
+///
+/// ⚠️ 不要改用 `url(forResource:withExtension:subdirectory:)` 拼三遍——那是同一个非递归
+/// 语义换了个写法；也不要指望 Foundation 未来会递归（不是它的契约）。
+public enum AdepShellConfig {
+    /// 壳配置文件名（CLI `adep app build` 写入 `app/site/` 后随 cap sync / xtool resources 进包）。
+    public static let configFileName = "adep.app.json"
+
+    /// 包内候选子目录（`nil` = 包根），按查找顺序排列。命中即停。
+    public static let candidateSubdirectories: [String?] = [nil, "site", "public"]
+
+    /// 按候选顺序定位随包资源；全缺返回 nil（调用方决定 fail-closed 还是跳过）。
+    public static func resourceURL(named fileName: String, in bundle: Bundle) -> URL? {
+        for subdirectory in candidateSubdirectories {
+            guard let subdirectory else {
+                // 包根：走 Bundle 的资源查找（只命中根，不会递归——这正是候选表存在的原因）。
+                if let root = bundle.url(forResource: fileName, withExtension: nil) {
+                    return root
+                }
+                continue
+            }
+            let candidate = bundle.bundleURL
+                .appendingPathComponent(subdirectory, isDirectory: true)
+                .appendingPathComponent(fileName, isDirectory: false)
+            if FileManager.default.fileExists(atPath: candidate.path) {
+                return candidate
+            }
+        }
+        return nil
+    }
+
+    /// 读随包资源的字节；缺失或读失败返回 nil（读取失败与「不在包里」对调用方的语义相同：
+    /// 拿不到内容——但调用方必须把这两件事记成不同的日志，否则排障时会误以为是打包问题）。
+    public static func data(named fileName: String, in bundle: Bundle) -> Data? {
+        guard let url = resourceURL(named: fileName, in: bundle) else { return nil }
+        return try? Data(contentsOf: url)
+    }
+}