@adep/cli 0.1.17 → 0.2.1

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

@@ -0,0 +1,58 @@
+import Foundation
+import Security
+
+/// ownerKey 的 Keychain 存储（iOS，APP-009）。
+///
+/// PRD §2.11.5「设备身份与恢复」：ownerKey 移动端**只存 Keychain / Keystore**——
+/// 不落 UserDefaults / 沙盒文件 / JS 侧持久化（客户端产物等同公开，明文落盘等于
+/// 把设备身份直接交给解包者）。Keychain 由系统加密保护，应用卸载后条目随钥匙串
+/// 条目保留策略由系统管理（本实现用 kSecAttrAccessibleAfterFirstUnlock，设备
+/// 重启后首次解锁即可读，适合后台同步场景）。
+enum AdepKeychain {
+    private static let service = "adep.ownerKey"
+    private static let account = "default"
+
+    /// 读 ownerKey；无则返回 nil（首启未签发）。
+    static func loadOwnerKey() -> String? {
+        var query = baseQuery()
+        query[kSecReturnData as String] = true
+        query[kSecMatchLimit as String] = kSecMatchLimitOne
+        var item: CFTypeRef?
+        let status = SecItemCopyMatching(query as CFDictionary, &item)
+        guard status == errSecSuccess, let data = item as? Data else { return nil }
+        return String(data: data, encoding: .utf8)
+    }
+
+    /// 写 ownerKey（已存在则覆盖）。
+    @discardableResult
+    static func saveOwnerKey(_ key: String) -> Bool {
+        deleteOwnerKey()
+        var query = baseQuery()
+        query[kSecValueData as String] = Data(key.utf8)
+        return SecItemAdd(query as CFDictionary, nil) == errSecSuccess
+    }
+
+    /// 删 ownerKey（换装 / 恢复码认领时用）。
+    @discardableResult
+    static func deleteOwnerKey() -> Bool {
+        SecItemDelete(baseQuery() as CFDictionary) == errSecSuccess || errSecItemNotFoundCheck()
+    }
+
+    private static func baseQuery() -> [String: Any] {
+        return [
+            kSecClass as String: kSecClassGenericPassword,
+            kSecAttrService as String: service,
+            kSecAttrAccount as String: account,
+            kSecAttrAccessible as String: kSecAttrAccessibleAfterFirstUnlock,
+        ]
+    }
+
+    /// delete 在「无条目」时返回 errSecItemNotFound，等同成功（幂等删除）。
+    private static func errSecItemNotFoundCheck() -> Bool {
+        // 上一条删除若因条目不存在失败，这里重查一次确认「确实不存在」即可算成功。
+        var query = baseQuery()
+        query[kSecReturnData as String] = true
+        var item: CFTypeRef?
+        return SecItemCopyMatching(query as CFDictionary, &item) == errSecItemNotFound
+    }
+}

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

@@ -0,0 +1,82 @@
+import Foundation
+
+/// 原生侧权限门控（iOS，APP-009）。
+///
+/// 与 `bridge/gate.mjs`（host-side harness 镜像）**同规则**：`permissions` 白名单 contains
+/// 判定 + 审计记录。两侧独立实现、共用同一份清单契约（`adep.permissions.json`）与同一
+/// 错误码 `PERMISSION_DENIED`。规则刻意极简（没有第二种判定形态），漂移面最小；
+/// 模板单测钉住「Swift 源码引用同一清单文件名与错误码」。
+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)
+    }
+
+    private let permissions: [String]
+    private let audit: AdepAuditLog
+
+    private init(permissions: [String], audit: AdepAuditLog) {
+        self.permissions = permissions
+        self.audit = audit
+    }
+
+    /// 从 bundle 读权限清单并装配门控。
+    /// 清单缺失 → throw（调用方 fail-closed：门控建立不了 = 一切原生能力不可用）。
+    static func load(from bundle: Bundle) throws -> AdepPermissionGate {
+        guard let url = bundle.url(forResource: manifestFileName, withExtension: nil) else {
+            throw NSError(
+                domain: "AdepBridge", code: 1,
+                userInfo: [NSLocalizedDescriptionKey: "Bundle 缺少 \(manifestFileName)（CLI build 写入、cap sync 同步）"]
+            )
+        }
+        let data = try Data(contentsOf: url)
+        let object = try JSONSerialization.jsonObject(with: data) as? [String: Any]
+        let raw = object?["permissions"] as? [String] ?? []
+        return AdepPermissionGate(permissions: raw, audit: AdepAuditLog.shared)
+    }
+
+    /// 声明面判定 + 审计（尝试即记，无论放行还是拒绝）。
+    func check(_ capability: String) -> Result {
+        let declared = permissions.contains(capability)
+        audit.log(
+            ts: ISO8601DateFormatter().string(from: Date()),
+            capability: capability,
+            result: declared ? "granted" : "denied",
+            reason: declared ? "ok" : "not_declared"
+        )
+        if declared { return .granted }
+        return .denied(reason: "原生能力 \"\(capability)\" 未在应用 manifest 的 permissions 中声明（未声明即不可用，且不会在运行时申请）")
+    }
+}
+
+/// 设备侧审计日志（iOS）：沙盒 Documents/adep-audit.log 追加一行。
+/// 与 gate.mjs 的 AuditEntry 形状一致（ts / capability / result / reason）。
+public final class AdepAuditLog {
+    static let shared = AdepAuditLog()
+
+    private let fileURL: URL
+
+    private init() {
+        let documents = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
+        fileURL = documents.appendingPathComponent("adep-audit.log")
+    }
+
+    func log(ts: String, capability: String, result: String, reason: String) {
+        let line = "{\"ts\":\"\(ts)\",\"capability\":\"\(capability)\",\"result\":\"\(result)\",\"reason\":\"\(reason)\"}\n"
+        guard let data = line.data(using: .utf8) else { return }
+        if FileManager.default.fileExists(atPath: fileURL.path) {
+            if let handle = try? FileHandle(forWritingTo: fileURL) {
+                defer { try? handle.close() }
+                handle.seekToEndOfFile()
+                handle.write(data)
+            }
+        } else {
+            try? data.write(to: fileURL, options: .atomic)
+        }
+    }
+}

package/templates/app-mobile/plugins/adep-bridge/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@adep/bridge",
+  "version": "0.1.0",
+  "private": true,
+  "description": "AgentDeploy 移动壳原生桥（APP-009）：原生侧权限门控 + ownerKey 存储（Keychain / Keystore）+ 原生能力 invoke 路由",
+  "main": "dist/plugin.js",
+  "types": "dist/plugin.d.ts",
+  "scripts": {
+    "verify": "node -e \"require('./dist/plugin.js')\""
+  },
+  "peerDependencies": {
+    "@capacitor/core": "^7.0.0"
+  }
+}

package/templates/app-mobile/template.json

@@ -0,0 +1,16 @@
+{
+  "code": "app-mobile",
+  "name": "移动应用壳（Capacitor）",
+  "description": "Capacitor 移动壳工程：WebView 消费 app/site/ 产物，在线运行时（云函数经 platformUrl 服务端执行）；原生桥（plugins/adep-bridge）承载原生侧权限门控与 ownerKey 存储（Keychain / Keystore）",
+  "version": "1.0.0",
+  "variables": [
+    {
+      "name": "projectSlug",
+      "description": "平台项目 slug（写入包名 / adep.app.json / bundle id 推导）"
+    },
+    { "name": "appName", "description": "应用显示名（iOS / Android 显示名）" },
+    { "name": "platformUrl", "description": "平台地址（页面侧 @adep/client 以此为 baseUrl invoke 云函数）" },
+    { "name": "iosBundleId", "description": "iOS bundle identifier（top.adep.<slug>，连字符合法）" },
+    { "name": "androidPackageId", "description": "Android applicationId（top.adep.<slug 连字符转下划线>，applicationId 不允许连字符）" }
+  ]
+}

package/templates/app-mobile/web/adep-bridge.js

@@ -0,0 +1,56 @@
+/**
+ * 页面侧桥（APP-009 移动壳，与桌面壳 preload.cjs **同形**——§3.2.8 硬约束④：移动与桌面桥
+ * 同形，同一套页面代码不区分运行壳）。
+ *
+ * CLI `adep app build --platform ios,android` 时把本文件复制为 `app/site/adep-bridge.js`
+ * 并在 `index.html` 注入 `<script src="/adep-bridge.js"></script>`（幂等），同时把
+ * `adep.app.json` 复制到 `app/site/adep.app.json`。页面加载时本脚本异步读取配置并暴露
+ * `window.__ADEP_APP__`——与桌面 preload 暴露的字段一一对应。
+ *
+ * 本文件**自包含**（不 import 任何 npm 包）：WebView 里 `@capacitor/core` 由页面 bundle
+ * 提供（`window.Capacitor` 运行时全局），壳不能假设 site 产物打包过它。
+ *
+ * 页面侧调用云函数（在线运行时）与桌面同款：
+ *
+ *   const client = createAdepClient({ baseUrl: window.__ADEP_APP__.platformUrl })
+ *   const result = await client.invokeFunction('hello', { name: 'world' })
+ *
+ * 设备端函数（离线运行时）请求原生能力：
+ *
+ *   const result = await window.__ADEP_APP__.invokeNative('geolocation', {})
+ *   // 未在 manifest permissions 声明 → 原生侧拒绝 { code: 'PERMISSION_DENIED' }
+ */
+;(async () => {
+  /** 壳配置（CLI build 时从壳工程 adep.app.json 复制进 site/；字段校验归 CLI schema）。 */
+  const response = await fetch('./adep.app.json')
+  const config = await response.json()
+
+  // 字符串 key 写法（与桌面 preload.cjs 同款）：`__ADEP_APP__` 是壳与页面约定的全局名，
+  // 以标识符出现会触发 no-underscore-dangle（lint），字符串形式表达「这是契约名不是变量」。
+  window['__ADEP_APP__'] = {
+    platformUrl: config.platformUrl,
+    projectSlug: config.projectSlug,
+    appName: config.appName || config.projectSlug,
+    // 本模板交付在线运行时（PRD §2.11 路径 A：函数在服务端执行，改逻辑不需要重新发版）。
+    // 移动离线运行时（设备端执行 + 原生能力）是后续单；桥的 invokeNative 入口已就位，
+    // 离线注入接上后页面调用形态不变。
+    mode: 'online',
+    /**
+     * 原生能力入口：经 Capacitor 插件 `@adep/bridge`（plugins/adep-bridge）→ 原生侧门控。
+     * 门控做在原生侧：未声明权限即不可用（PERMISSION_DENIED）且不在运行时申请。
+     */
+    invokeNative: (capability, args) => {
+      const plugin =
+        window.Capacitor &&
+        window.Capacitor.Plugins &&
+        window.Capacitor.Plugins.AdepBridge
+      if (!plugin) {
+        return Promise.reject({
+          code: 'NATIVE_BRIDGE_UNAVAILABLE',
+          message: '原生桥不可用：页面未运行在 AdepBridge 注入的移动壳内',
+        })
+      }
+      return plugin.invokeNative({ capability, args })
+    },
+  }
+})()