Add generated to-many relationship count accessors

Author: fatbobman

Docs/Development/DesignNotes.md

@@ -209,11 +209,12 @@ func removeFromTags(_ tags: Set<Tag>) {
 
 ```swift
 @PersistentModel(
+  generateToManyCount: true,
 )
 ```
 
 - 对多 getter（`Set<T>` / `[T]`）当前固定生成，不提供独立策略开关。
-- 不生成任何 `*Count` 访问器，建议使用 `NSManagedObjectContext.count(for:)` + `NSPredicate`。
+- 默认生成 `relationshipNameCount` 访问器；如需关闭，可显式写 `generateToManyCount: false`。
 - 所有对多关系都不生成 setter，统一通过便利方法进行关系修改。
 - `Set<T>` 生成单个和批量 `add/remove` 便利方法。
 - `[T]` 生成单个和批量 `add/remove`，以及 `insertInto*(_:at:)` 便利方法。
@@ -380,7 +381,7 @@ func insertIntoTags(_ tag: Tag, at index: Int) {
 - ordered/unordered 与属性类型的一致性
 
 无论源码如何声明，工具都会强制检查模型层 inverse 是否配置；缺失 inverse 一律为 `[ERROR]`。
-v1 不自动生成 `*Count`；若需要数量，推荐通过 `NSManagedObjectContext.count(for:)` + `NSPredicate` 计算。
+v1 默认生成 `*Count`；若不希望暴露这类成员，可显式关闭 `generateToManyCount`。
 
 ---
 
@@ -418,7 +419,7 @@ public final class Item: NSManagedObject {
 
     // 宏生成的关系便利方法
     public func addToTags(_ tag: Tag) { ... }
-    // v1 不自动生成 tagsCount，需使用 context.count(for:)
+    public var tagsCount: Int { ... }
 }
 ```
 

Docs/Development/ImplementationPlan.md

@@ -181,7 +181,7 @@
 - [ ] validate 工具完成并接入 CI
 - [ ] generate 工具完成并接入命令入口
 - [ ] 规范文档与实现行为一致
-- [x] `tagsCount` 决策收敛（v1 不自动生成 `*Count`，通过文档与诊断引导 `context.count(for:)`）
+- [x] `tagsCount` 决策收敛（v1 默认生成 `*Count`，并提供 `generateToManyCount: false` 开关）
 
 ## 7. Current Sprint Plan (PersistentModel)
 

Docs/Development/Specification.md

@@ -67,6 +67,7 @@ Runtime schema / runtime model builder 的 v1 边界：
 - `Paths`（可组合子路径，含 relationship/composition）
 - `__cdFieldTable`（路径映射元信息）
 - `convenience init`（默认不生成；可通过 `generateInit: true` 开启）
+- 对多关系 `*Count` 访问器（默认生成；可通过 `generateToManyCount: false` 关闭）
 
 `@objc` 注入规则：
 
@@ -81,13 +82,14 @@ Runtime schema / runtime model builder 的 v1 边界：
 ```swift
 @PersistentModel(
   generateInit: false,
+  generateToManyCount: true,
 )
 ```
 
 当前策略语义：
 
 - 对多 getter（`Set<T>` / `[T]`）当前固定生成，不提供单独策略开关。
-- 不生成任何 `*Count` 访问器，推荐改用 `NSManagedObjectContext.count(for:)` + `NSPredicate`。
+- 默认生成 `relationshipNameCount` 访问器，基于底层 `NSSet` / `NSOrderedSet` 的 `count` 暴露轻量计数读取。
 - `Set<T>` 生成单个和批量 `add/remove` 便利方法。
 - `[T]` 生成单个和批量 `add/remove`，以及 `insertInto*(_:at:)` 便利方法。
 
@@ -237,7 +239,7 @@ relationship declaration 规则：
 
 ### Count
 
-- 当前不自动生成 `*Count`。  
+- 当前默认自动生成 `*Count`；如需关闭，使用 `generateToManyCount: false`。  
 
 ## 5. Constructor Contract
 

Docs/Development/ToolingCLI.md

@@ -211,6 +211,7 @@ v1 的版本与发行策略分为两层：
     "format": "none",
     "headerTemplate": null,
     "generateInit": false,
+    "generateToManyCount": true,
     "defaultDecodeFailurePolicy": "fallbackToDefaultValue"
   },
   "validate": {
@@ -260,6 +261,8 @@ v1 的版本与发行策略分为两层：
         }
       }
     },
+    "generateInit": false,
+    "generateToManyCount": true,
     "include": [],
     "exclude": [],
     "level": "conformance",
@@ -535,8 +538,7 @@ v1 的版本与发行策略分为两层：
 ### 4.4 宏生成策略参数（映射到当前宏能力）
 
 - `--generate-init <true|false>`
-- `--relationship-setter-policy <none|warning|plain>`
-- `--relationship-count-policy <none|warning|plain>`
+- `--generate-to-many-count <true|false>`
 - `--default-decode-failure-policy <fallbackToDefaultValue|debugAssertNil>`
 
 说明：这些参数作为“生成代码默认策略”，具体属性仍允许在代码层用 `@Attribute(...)` 覆盖。
@@ -568,6 +570,7 @@ v1 的版本与发行策略分为两层：
   - CLI 显式传入的相对路径相对当前工作目录解析。
 - `emitExtensionStubs`: optional, bool，默认 `false`。
 - `generateInit`: optional, bool，默认 `false`。
+- `generateToManyCount`: optional, bool，默认 `true`。
 - `defaultDecodeFailurePolicy`: optional, enum(`fallbackToDefaultValue`,`debugAssertNil`)，默认 `fallbackToDefaultValue`。
 
 ## 5. `validate` 参数设计（v1）
@@ -583,8 +586,7 @@ v1 的版本与发行策略分为两层：
 - `--split-by-entity <bool>`
 - `--header-template <path>`
 - `--generate-init <bool>`
-- `--relationship-setter-policy <none|warning|plain>`
-- `--relationship-count-policy <none|warning|plain>`
+- `--generate-to-many-count <bool>`
 - `--default-decode-failure-policy <fallbackToDefaultValue|debugAssertNil>`
 - `--type-mappings`
   - v1 不单独提供 CLI 参数，推荐在 JSON 配置中声明。
@@ -629,6 +631,7 @@ v1 的版本与发行策略分为两层：
 - `headerTemplate`: optional, string/null，默认 `null`。
 - `emitExtensionStubs`: optional, bool，默认 `false`。
 - `generateInit`: optional, bool，默认 `false`。
+- `generateToManyCount`: optional, bool，默认 `true`。
 - `defaultDecodeFailurePolicy`: optional, enum(`fallbackToDefaultValue`,`debugAssertNil`)，默认 `fallbackToDefaultValue`。
 - `include`: optional, array<string>，默认 `[]`。
 - `exclude`: optional, array<string>，默认 `[]`。

Docs/PersistentModelGuide.md

@@ -98,6 +98,8 @@ For a valid model type, the macro generates:
 - conditional `fetchRequest()` when the type does not already declare one
 - optional convenience `init(...)` when `generateInit: true`
 - to-many relationship getters
+- to-many relationship count accessors such as `tagsCount` (enabled by default; disable with
+  `generateToManyCount: false`)
 - unordered to-many helpers: single-value and batch `addTo*` / `removeFrom*`
 - ordered to-many helpers: single-value and batch `addTo*` / `removeFrom*`, plus
   `insertInto*(_:at:)`
@@ -807,6 +809,31 @@ convenience init(
 )
 ```
 
+## To-Many Count Accessors
+
+`@PersistentModel` generates `relationshipNameCount` accessors for to-many relationships by
+default.
+
+```swift
+@PersistentModel
+final class Tag: NSManagedObject {
+  @Relationship(inverse: "tag", deleteRule: .nullify)
+  var items: Set<Item>
+}
+```
+
+Generated surface:
+
+```swift
+var itemsCount: Int
+```
+
+Disable this when you do not want the extra generated members:
+
+```swift
+@PersistentModel(generateToManyCount: false)
+```
+
 ## Runtime Schema for Tests and Debugging
 
 `@PersistentModel` also emits runtime schema metadata.

README.md

@@ -196,6 +196,7 @@ It gives you:
 
 - explicit attribute/relationship metadata
 - generated Core Data accessors
+- lightweight `relationshipNameCount` accessors for to-many relationships
 - generated to-many relationship helper APIs
 - typed key/path metadata for sort and predicate construction
 - runtime schema metadata for tests and debug workflows

Sources/CDETool/Commands/BootstrapConfigCommand.swift

@@ -181,6 +181,7 @@ private func relocateBootstrapTemplate(
         ),
         emitExtensionStubs: generate.emitExtensionStubs,
         generateInit: generate.generateInit,
+        generateToManyCount: generate.generateToManyCount,
         defaultDecodeFailurePolicy: generate.defaultDecodeFailurePolicy
       )
     },
@@ -216,6 +217,7 @@ private func relocateBootstrapTemplate(
           currentDirectoryURL: currentDirectoryURL
         ),
         generateInit: validate.generateInit,
+        generateToManyCount: validate.generateToManyCount,
         defaultDecodeFailurePolicy: validate.defaultDecodeFailurePolicy,
         include: validate.include,
         exclude: validate.exclude,

Sources/CDETool/Commands/GenerateCommand.swift

@@ -72,6 +72,10 @@ struct GenerateCommand: ParsableCommand {
   @Option(name: .long, help: "Whether to generate a convenience init (true/false).")
   var generateInit: Bool?
 
+  @Option(
+    name: .long, help: "Whether to generate to-many relationship count accessors (true/false).")
+  var generateToManyCount: Bool?
+
   @Option(name: .long, help: "Decode failure policy: fallbackToDefaultValue/debugAssertNil.")
   var defaultDecodeFailurePolicy: ToolingDecodeFailurePolicy?
 

Sources/CDETool/Commands/ValidateCommand.swift

@@ -58,6 +58,13 @@ struct ValidateCommand: ParsableCommand {
     help: "Whether generated source is expected to include a convenience init (true/false).")
   var generateInit: Bool?
 
+  @Option(
+    name: .long,
+    help:
+      "Whether generated source is expected to include to-many relationship count accessors (true/false)."
+  )
+  var generateToManyCount: Bool?
+
   @Option(
     name: .long, help: "Expected decode failure policy: fallbackToDefaultValue/debugAssertNil.")
   var defaultDecodeFailurePolicy: ToolingDecodeFailurePolicy?

Sources/CDETool/Support/GenerateCommandSupport.swift

@@ -41,6 +41,7 @@ enum GenerateCommandSupport {
       overrides.format = command.format
       overrides.emitExtensionStubs = command.emitExtensionStubs
       overrides.generateInit = command.generateInit
+      overrides.generateToManyCount = command.generateToManyCount
       overrides.defaultDecodeFailurePolicy = command.defaultDecodeFailurePolicy
       overrides.headerTemplate = command.headerTemplate.map {
         makeAbsoluteURL(fromCLIPath: $0).path
@@ -84,6 +85,7 @@ enum GenerateCommandSupport {
       headerTemplate: command.headerTemplate.map { makeAbsoluteURL(fromCLIPath: $0).path },
       emitExtensionStubs: command.emitExtensionStubs,
       generateInit: command.generateInit,
+      generateToManyCount: command.generateToManyCount,
       defaultDecodeFailurePolicy: command.defaultDecodeFailurePolicy
     )