@tbox.cn/app-toolkit 0.2.0 → 0.3.0

package/src/views/modules.ts

@@ -9,11 +9,28 @@ import type { ViewSnapshot } from './context.js';
  * v4.4 D34：domainKeys/providerBindings/configEditable 显式化；integration 仅单域
  * （writable）时在场——多域/零域/共享键无单键落点；多域回退兜底键机器拆除
  * （派生统一 = domainOfService 去重集合，moduleDomainWritable 单源）。
+ * 2026-09-16 双缺陷批：loadModulesView 排除 provider 家族包（供给/实施载体非可配置
+ * 业务模块）——walk 声明集与 loadModuleDetailView 不变（装包仍合法，详情保持 200）。
  */
 
-/** GET /modules：纯模块清单（demand 不在——卡片展开 = GET /modules/:m） */
+/** 家族名归一（cli deriveModuleId 同源语义——依赖方向禁 import，故内联）：
+ *  `@tbox.cn/app-provider-x` / `@app/provider-y` / `provider-z` → `provider-*` */
+function familyName(s: string): string {
+  return s.replace(/^@tbox\.cn\/app-/, '').replace(/^@[^/]+\//, '');
+}
+
+/** provider 家族包判定（模块清单排除供给/实施载体；生态三先例同源：verify-cli 排除判定 /
+ *  guard-vendor-neutrality「provider-* 包」/ cli deriveModuleId 家族推导）。install id 与
+ *  包名 basename 双查 = 防 .tbox/app.json 登记漂移纵深；命名而非结构（provider-custom 零贡献
+ *  空壳与「零贡献合法」形态不可结构区分）；未来收敛 = manifest 显式角色标记（届时整体退场）。 */
+function isProviderFamily(mod: { id: string; pkg: string }): boolean {
+  return familyName(mod.id).startsWith('provider-') || familyName(mod.pkg).startsWith('provider-');
+}
+
+/** GET /modules：纯模块清单（demand 不在——卡片展开 = GET /modules/:m；provider 家族包不在清单） */
 export function loadModulesView(snapshot: ViewSnapshot): { modules: ModuleDeclaration[] } {
   const modules: ModuleDeclaration[] = snapshot.walk.modules
+    .filter((mod) => !isProviderFamily(mod))
     .map((mod) => ({
       id: mod.id,
       name: mod.descriptor.name,

package/src/views/providers.ts

@@ -42,10 +42,7 @@ export function loadProviderDetailView(snapshot: ViewSnapshot, provider: string,
   }
   if (include?.has('integrationSchemas')) {
     for (const [service, bucket] of Object.entries(services)) {
-      const schemaEntry = snapshot.walk.serviceSchemas[`${provider}\u0000${service}`];
-      bucket.integrationSchemas = {
-        configSchema: schemaEntry ? readSchemaRef(snapshot.appDir, schemaEntry.packageDir, schemaEntry.configSchema) : null,
-      };
+      bucket.integrationSchemas = { configSchema: resolveServiceConfigSchema(snapshot, provider, service) };
     }
   }
   const entries = Object.values(impls);
@@ -95,22 +92,15 @@ export function loadProviderServiceDetailView(
     implementations.push({ implementation: configured[service]?.implementation ?? `${provider}-inline@1`, credentialType: inlineDeclaration.credentialType });
   }
 
-  // integrationSchemas：catalog schema（复合键）优先；内联声明 configSchema 引用应用 config/schemas/
-  // （路径约束 H9——resolve 落 config/schemas/ 内 + realpath 复核，违例 400）
-  // v4.4 F5 消重：schema 表取自 snapshot.walk（原 walkManifests(appDir) 重复全量目录扫描）；
-  // v4.4 D33：credentialSchema 删净（结构归 GET /credential-types——组合单体纯 config）
-  let configSchema: object | null = null;
-  const schemaEntry = snapshot.walk.serviceSchemas[`${provider}\u0000${service}`];
-  if (schemaEntry) {
-    configSchema = readSchemaRef(snapshot.appDir, schemaEntry.packageDir, schemaEntry.configSchema);
-  } else if (inlineDeclaration) {
-    // 内联声明 schema 解析：引用文件在 integrations 节点（provider.configSchema）——
-    // 形状同 config/schemas/ 约束（路径来源 = 节点声明，由服务端读应用侧）
-    const inlineSchemaRef = (inline as { configSchema?: string } | undefined)?.configSchema;
-    if (typeof inlineSchemaRef === 'string') {
-      configSchema = readInlineSchema(snapshot.appDir, inlineSchemaRef);
-    }
-  }
+  // integrationSchemas：schema 解析收口 resolveServiceConfigSchema 单源（v4.7 D38——catalog 复合键 >
+  // 内联 ref，等价重构 O6/O7/O15 零改动即证）；内联 ref 来源 = 节点声明（provider.configSchema，
+  // 仅受控内联声明匹配本厂商名时）；路径约束 H9——resolve 落 config/schemas/ 内 + realpath 复核，违例 400
+  const configSchema = resolveServiceConfigSchema(
+    snapshot,
+    provider,
+    service,
+    inlineDeclaration ? (inline as { configSchema?: string } | undefined)?.configSchema : undefined,
+  );
 
   return {
     provider,
@@ -120,6 +110,22 @@ export function loadProviderServiceDetailView(
   };
 }
 
+/** per-(provider, service) schema 复合解析单源（v4.7 D38）：catalog 复合键（多 impl 声明序首个）
+ *  > 内联 ref（readInlineSchema 保持私有——H9 双钉子不扩暴露）；miss / 未声明 / 文件缺失 → null。
+ *  views 层 \u0000 复合键唯一消费点（组合单体 / 供给轴批量 / 层级核心 / 服务级 include 同源）。
+ *  （D36 registry 批若需跨包消费再升 index 导出——additive 零成本） */
+export function resolveServiceConfigSchema(
+  snapshot: ViewSnapshot,
+  provider: string,
+  service: string,
+  inlineRef?: string,
+): object | null {
+  const entry = snapshot.walk.serviceSchemas[`${provider}\u0000${service}`];
+  if (entry) return readSchemaRef(snapshot.appDir, entry.packageDir, entry.configSchema);
+  if (typeof inlineRef === 'string') return readInlineSchema(snapshot.appDir, inlineRef);
+  return null;
+}
+
 /** catalog schema 引用读取（相对包根；缺席 → null——SCHEMA_FILE_MISSING 归谓词 #6）。
  *  v4.4 导出共享：层级内嵌（integration-schemas.ts）/ 凭据结构清单（credential-types.ts）同源消费。 */
 export function readSchemaRef(_appDir: string, packageDir: string, ref: string | undefined): object | null {

package/tests/file-cache.test.ts

@@ -180,7 +180,9 @@ describe('Freshness Contract W3/W7 — agent 动线矩阵（工厂方法级；FX
       }),
     );
     const modules = await tk.loadModules();
-    expect(modules.modules.map((m) => m.id)).toContain('provider-x');
+    // provider 家族包不在清单（2026-09-16 bug-fix）——排除本身随目录新增即时生效；
+    // loadModules 新鲜度由下方 case c（module-sdk-y）承载，供给轴新鲜度见下两行
+    expect(modules.modules.map((m) => m.id)).not.toContain('provider-x');
     const providers = await tk.loadProviders();
     expect(providers.providers.map((p) => p.provider)).toContain('joycity');