エージェントが書いた App Intent を Siri に喋らせる前に — 副作用で分類して確認ゲートを挟む設計

struct ReplaceCollectionIntent: ClassifiedIntent {
    static let title: LocalizedStringResource = "コレクションを今日のおすすめに入れ替え"
    static let sideEffect: SideEffect = .irreversible
 
    // アシスタントに勝手に完結させず、確認を必須にする
    static let openAppWhenRun: Bool = false
 
    @Parameter(title: "対象コレクション")
    var collection: CollectionEntity
 
    @MainActor
    func perform() async throws -> some IntentResult & ProvidesDialog {
        let store = CollectionStore.shared
        let current = try store.count(in: collection.id)
 
        // 破壊的操作の前に、件数を添えて明示的な確認を取る
        try await requestConfirmation(
            result: .result(dialog: "現在の \(current) 枚を今日のおすすめに入れ替えます。元には戻せません。"),
            confirmationActionName: .go
        )
 
        let snapshot = try store.snapshot(collection.id)   // 復元用の退避
        do {
            try await store.replaceWithDailyPicks(collection.id)
        } catch {
            try? store.restore(snapshot)                    // 失敗時は必ず戻す
            throw error
        }
        return .result(dialog: "入れ替えました。直前の状態は履歴から復元できます。")
    }
}

struct BulkDeleteIntent: ClassifiedIntent {
    static let title: LocalizedStringResource = "選択して一括削除"
    static let sideEffect: SideEffect = .irreversible
 
    // 対象が曖昧な破壊的操作は、アシスタント内で完結させない
    static let openAppWhenRun: Bool = true
 
    @MainActor
    func perform() async throws -> some IntentResult {
        // 削除自体はしない。削除候補を絞った状態でアプリの管理画面を開く
        AppRouter.shared.route(to: .collectionManager(mode: .deletionReview))
        return .result()
    }
}

struct CollectionEntity: AppEntity {
    let id: String
    let name: String
 
    static let typeDisplayRepresentation: TypeDisplayRepresentation = "コレクション"
    var displayRepresentation: DisplayRepresentation { .init(title: "\(name)") }
 
    static let defaultQuery = CollectionQuery()
}
 
struct CollectionQuery: EntityQuery {
    func entities(for ids: [String]) async throws -> [CollectionEntity] {
        // 渡された ID を鵜呑みにせず、存在するものだけに絞る
        try CollectionStore.shared.existing(ids: ids)
    }
 
    func suggestedEntities() async throws -> [CollectionEntity] {
        // 破壊的操作の候補には、システムコレクションを出さない
        try CollectionStore.shared.userEditableCollections()
    }
}

@Parameter(title: "削除する枚数")
var count: Int
 
func validate() throws {
    guard count > 0 else {
        throw $count.needsValueError("1 以上を指定してください")
    }
    guard count <= 200 else {
        // アシスタントが桁を取り違えても、一撃で大量削除させない
        throw $count.needsValueError("一度に削除できるのは 200 枚までです")
    }
}

// scripts/check-intent-gates.mjs
import { readFileSync, readdirSync } from "node:fs";
import { join } from "node:path";
 
function swiftFiles(dir) {
  return readdirSync(dir, { withFileTypes: true }).flatMap((e) => {
    const p = join(dir, e.name);
    if (e.isDirectory()) return swiftFiles(p);
    return e.name.endsWith(".swift") ? [p] : [];
  });
}
 
// 雑な struct 分割。厳密なパーサではないが、ゲート欠落の検出には十分
function structs(src) {
  const out = [];
  const re = /struct\s+(\w+)\s*:\s*[^{]*ClassifiedIntent[^{]*\{/g;
  let m;
  while ((m = re.exec(src))) {
    let depth = 1, i = re.lastIndex;
    for (; i < src.length && depth > 0; i++) {
      if (src[i] === "{") depth++;
      else if (src[i] === "}") depth--;
    }
    out.push({ name: m[1], body: src.slice(m.index, i) });
  }
  return out;
}
 
const violations = [];
for (const file of swiftFiles("Sources")) {
  const src = readFileSync(file, "utf8");
  for (const s of structs(src)) {
    const irreversible = /sideEffect\s*:\s*SideEffect\s*=\s*\.irreversible/.test(s.body);
    if (!irreversible) continue;
    const gated =
      /requestConfirmation\s*\(/.test(s.body) ||
      /openAppWhenRun\s*(:\s*Bool)?\s*=\s*true/.test(s.body);
    if (!gated) {
      violations.push(`${file}: ${s.name} は不可逆分類ですが確認ゲートがありません`);
    }
  }
}
 
if (violations.length) {
  console.error("❌ 確認ゲート欠落:\n" + violations.join("\n"));
  process.exit(1);
}
console.log("✅ すべての不可逆 Intent に確認ゲートがあります");