@appaflytech/zeyrek-ai-mcp 0.0.35 → 0.0.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (210) hide show
  1. package/.env.example +15 -0
  2. package/README.md +5 -5
  3. package/dist/config.js +37 -0
  4. package/dist/index.js +2 -0
  5. package/dist/knowledge/access.js +802 -0
  6. package/dist/knowledge/backendConstraints.js +18 -1
  7. package/dist/knowledge/case.js +41 -0
  8. package/dist/knowledge/componentCatalog.js +655 -424
  9. package/dist/knowledge/componentEvents.js +140 -23
  10. package/dist/knowledge/connectDataBind.js +843 -0
  11. package/dist/knowledge/connectDataDefinition.js +344 -0
  12. package/dist/knowledge/connectDataExecute.js +93 -0
  13. package/dist/knowledge/connectDataRules.js +128 -0
  14. package/dist/knowledge/decision.js +121 -0
  15. package/dist/knowledge/expressionPrelude.js +59 -0
  16. package/dist/knowledge/layoutSummary.js +140 -2
  17. package/dist/knowledge/microserviceParameters.js +58 -0
  18. package/dist/knowledge/mining.js +94 -0
  19. package/dist/knowledge/mobileComponentCatalog.js +864 -0
  20. package/dist/knowledge/mobileComponentEvents.js +239 -0
  21. package/dist/knowledge/mobileStore.js +321 -0
  22. package/dist/knowledge/normalize.js +235 -84
  23. package/dist/knowledge/outlines.js +36 -0
  24. package/dist/knowledge/platform/lint.js +385 -0
  25. package/dist/knowledge/platform/mobile.js +142 -0
  26. package/dist/knowledge/platform/mobileLayoutLint.js +324 -0
  27. package/dist/knowledge/platform/mobileRules.js +231 -0
  28. package/dist/knowledge/platform/mobileSpacing.js +82 -0
  29. package/dist/knowledge/platform/mobileTabs.js +108 -0
  30. package/dist/knowledge/platform/nativeBoxModel.js +44 -0
  31. package/dist/knowledge/platform/profile.js +25 -0
  32. package/dist/knowledge/platform/resolve.js +122 -0
  33. package/dist/knowledge/platform/web.js +39 -0
  34. package/dist/knowledge/policy.js +18 -4
  35. package/dist/knowledge/process.js +510 -0
  36. package/dist/knowledge/reservedTables.js +79 -0
  37. package/dist/knowledge/rowFilter.js +43 -0
  38. package/dist/knowledge/rules.js +423 -37
  39. package/dist/knowledge/schemaGuard.js +11 -0
  40. package/dist/knowledge/styleResolve.js +53 -19
  41. package/dist/knowledge/styleResolveNative.js +527 -0
  42. package/dist/knowledge/themeResolve.js +4 -4
  43. package/dist/knowledge/themeSchema.js +1 -2
  44. package/dist/observability/trace.js +6 -3
  45. package/dist/platform/argumentAliases.js +128 -0
  46. package/dist/platform/bodyFile.js +103 -0
  47. package/dist/platform/capture/actions.js +398 -0
  48. package/dist/platform/capture/browser.js +1 -0
  49. package/dist/platform/capture/capture.js +683 -0
  50. package/dist/platform/capture/console-log.js +122 -0
  51. package/dist/platform/capture/index.js +11 -0
  52. package/dist/platform/capture/readiness.js +103 -0
  53. package/dist/platform/capture/summary.js +77 -0
  54. package/dist/platform/capture/target.js +5 -0
  55. package/dist/platform/capture/targets/studio-mobile.js +15 -0
  56. package/dist/platform/capture/targets/studio-web.js +5 -0
  57. package/dist/platform/diagnostics.js +10 -4
  58. package/dist/platform/domSummary.js +1 -1
  59. package/dist/platform/errors.js +163 -10
  60. package/dist/platform/http.js +29 -8
  61. package/dist/platform/impersonation.js +45 -0
  62. package/dist/platform/jsonArray.js +24 -0
  63. package/dist/platform/responses.js +39 -5
  64. package/dist/platform/schemaReadMemory.js +60 -0
  65. package/dist/platform/secrets.js +19 -1
  66. package/dist/platform/strictArguments.js +68 -12
  67. package/dist/platform/tokenVault.js +187 -4
  68. package/dist/resources/examples/bpm-gorev-kontrol.json +294 -0
  69. package/dist/resources/examples/bpm-iso-dokuman.json +228 -0
  70. package/dist/resources/examples/bpm-satinalma.json +376 -0
  71. package/dist/resources/examples/connect-data-convert-verify.json +107 -0
  72. package/dist/resources/examples/connect-data-dropdown-roles.json +66 -0
  73. package/dist/resources/examples/connect-data-edit-m2m.json +73 -0
  74. package/dist/resources/examples/connect-data-query-params.json +50 -0
  75. package/dist/resources/examples/connect-data-table-entity.json +147 -0
  76. package/dist/resources/examples/connect-data-workflow-microservice.json +65 -0
  77. package/dist/resources/examples/middleware-authenticate.json +1 -1
  78. package/dist/resources/examples/mobile-app-shell-drawer.json +244 -0
  79. package/dist/resources/examples/mobile-app-shell-stack.json +157 -0
  80. package/dist/resources/examples/mobile-app-shell-tab.json +208 -0
  81. package/dist/resources/examples/mobile-form-screen.json +365 -0
  82. package/dist/resources/examples/mobile-list-detail-form.json +703 -0
  83. package/dist/resources/examples/page-detail-profile.json +2 -1
  84. package/dist/resources/examples/page-dynamic-form.json +3 -2
  85. package/dist/resources/examples/page-flex-sections.json +1 -1
  86. package/dist/resources/examples/page-html-embed.json +1 -1
  87. package/dist/resources/examples/workflow-basic.json +8 -2
  88. package/dist/resources/guides/access.md +810 -0
  89. package/dist/resources/guides/bpm.md +691 -0
  90. package/dist/resources/guides/case.md +153 -0
  91. package/dist/resources/guides/component.md +93 -6
  92. package/dist/resources/guides/decision.md +185 -0
  93. package/dist/resources/guides/entity.md +50 -8
  94. package/dist/resources/guides/expressions.md +14 -5
  95. package/dist/resources/guides/functions.md +1 -1
  96. package/dist/resources/guides/getting-started.md +38 -1
  97. package/dist/resources/guides/layout.md +11 -7
  98. package/dist/resources/guides/merge.md +37 -3
  99. package/dist/resources/guides/microservice.md +87 -2
  100. package/dist/resources/guides/middleware.md +68 -4
  101. package/dist/resources/guides/mobile-layout.md +193 -0
  102. package/dist/resources/guides/mobile-publish.md +124 -0
  103. package/dist/resources/guides/mobile.md +549 -0
  104. package/dist/resources/guides/page.md +463 -83
  105. package/dist/resources/guides/theme.md +8 -3
  106. package/dist/resources/guides/translation.md +1 -1
  107. package/dist/resources/guides/workflow.md +58 -1
  108. package/dist/resources/read.js +41 -0
  109. package/dist/resources/rules.js +11 -5
  110. package/dist/resources/schema-fingerprint.json +7 -5
  111. package/dist/resources/schemas/AccessExplanationDto.json +144 -0
  112. package/dist/resources/schemas/AccessMatrixDto.json +170 -0
  113. package/dist/resources/schemas/AccessPermissionDto.json +57 -0
  114. package/dist/resources/schemas/AccessPolicyDto.json +223 -0
  115. package/dist/resources/schemas/AccessResourceDto.json +86 -0
  116. package/dist/resources/schemas/AppSessionDto.json +53 -0
  117. package/dist/resources/schemas/ConnectDataDescribeDto.json +344 -0
  118. package/dist/resources/schemas/ConnectDataRequestModel.json +202 -0
  119. package/dist/resources/schemas/ConnectDataResultDto.json +421 -0
  120. package/dist/resources/schemas/ConnectorCredentialDto.json +70 -0
  121. package/dist/resources/schemas/ConvertConnectDataToMicroserviceCommand.json +37 -0
  122. package/dist/resources/schemas/CreateAccessPolicyCommand.json +209 -0
  123. package/dist/resources/schemas/CreateDecisionCommand.json +221 -0
  124. package/dist/resources/schemas/CreateEntityCommand.json +118 -0
  125. package/dist/resources/schemas/CreateMicroserviceCommand.json +13 -1
  126. package/dist/resources/schemas/CreateProcessDefinitionCommand.json +1337 -0
  127. package/dist/resources/schemas/CreateQueryCommand.json +4 -0
  128. package/dist/resources/schemas/CreateWorkflowCommand.json +146 -1
  129. package/dist/resources/schemas/DataJobDto.json +6 -1
  130. package/dist/resources/schemas/DecisionDto.json +302 -0
  131. package/dist/resources/schemas/DetachConnectDataMicroserviceCommand.json +28 -0
  132. package/dist/resources/schemas/ExplainAccessQuery.json +33 -0
  133. package/dist/resources/schemas/GenerateProcessDocumentCommand.json +116 -0
  134. package/dist/resources/schemas/GlobalFunctionUpdateResultDto.json +25 -1
  135. package/dist/resources/schemas/MicroserviceDto.json +15 -3
  136. package/dist/resources/schemas/OrganizationProjectDto.json +335 -0
  137. package/dist/resources/schemas/OrganizationSchemaDto.json +196 -0
  138. package/dist/resources/schemas/OrganizationSchemaVersionDto.json +207 -0
  139. package/dist/resources/schemas/PatchProcessDefinitionCommand.json +76 -0
  140. package/dist/resources/schemas/PreviewMicroserviceCommand.json +10 -1
  141. package/dist/resources/schemas/PreviewWorkflowCommand.json +25 -1
  142. package/dist/resources/schemas/ProcessDefinitionDto.json +1480 -0
  143. package/dist/resources/schemas/ProcessSimulationDto.json +96 -0
  144. package/dist/resources/schemas/SaveConnectorCredentialCommand.json +90 -0
  145. package/dist/resources/schemas/SaveProcessEventSourceCommand.json +61 -0
  146. package/dist/resources/schemas/SaveProcessMailSourceCommand.json +89 -0
  147. package/dist/resources/schemas/SignProcessTaskCommand.json +73 -0
  148. package/dist/resources/schemas/SimulateProcessDefinitionQuery.json +92 -0
  149. package/dist/resources/schemas/StartMobileBuildCommand.json +54 -0
  150. package/dist/resources/schemas/StepDto.json +25 -1
  151. package/dist/resources/schemas/UpdateAccessPolicyCommand.json +209 -0
  152. package/dist/resources/schemas/UpdateDecisionCommand.json +216 -0
  153. package/dist/resources/schemas/UpdateEntityCommand.json +118 -0
  154. package/dist/resources/schemas/UpdateMicroserviceCommand.json +13 -1
  155. package/dist/resources/schemas/UpdateProcessDefinitionCommand.json +1357 -0
  156. package/dist/resources/schemas/UpdateQueryCommand.json +4 -0
  157. package/dist/resources/schemas/UpdateViewCommand.json +0 -2
  158. package/dist/resources/schemas/UpdateWorkflowCommand.json +146 -1
  159. package/dist/resources/schemas/UpsertMobileStoreSettingsCommand.json +274 -0
  160. package/dist/resources/schemas/ValidateProcessDefinitionQuery.json +1339 -0
  161. package/dist/server.js +31 -1
  162. package/dist/tools/access.js +369 -2
  163. package/dist/tools/accessOperations.js +135 -0
  164. package/dist/tools/accessPolicies.js +170 -0
  165. package/dist/tools/accessRuntime.js +203 -0
  166. package/dist/tools/applications.js +60 -3
  167. package/dist/tools/bpm.js +343 -0
  168. package/dist/tools/bpmGovernance.js +266 -0
  169. package/dist/tools/bpmOperations.js +230 -0
  170. package/dist/tools/bpmReporting.js +154 -0
  171. package/dist/tools/bpmRouting.js +150 -0
  172. package/dist/tools/bpmRuntime.js +396 -0
  173. package/dist/tools/case.js +178 -0
  174. package/dist/tools/caseRuntime.js +89 -0
  175. package/dist/tools/common.js +10 -1
  176. package/dist/tools/components.js +118 -14
  177. package/dist/tools/connectData.js +450 -0
  178. package/dist/tools/connectors.js +193 -0
  179. package/dist/tools/datasources.js +3 -3
  180. package/dist/tools/decisions.js +206 -0
  181. package/dist/tools/dependencies.js +1 -1
  182. package/dist/tools/deployments.js +38 -3
  183. package/dist/tools/designSchemaPatch.js +34 -9
  184. package/dist/tools/dtos.js +36 -5
  185. package/dist/tools/entities.js +79 -12
  186. package/dist/tools/externalComponents.js +26 -5
  187. package/dist/tools/flows.js +119 -17
  188. package/dist/tools/folders.js +1 -1
  189. package/dist/tools/imports.js +5 -2
  190. package/dist/tools/layouts.js +50 -17
  191. package/dist/tools/merges.js +2 -2
  192. package/dist/tools/microservices.js +77 -25
  193. package/dist/tools/mobile.js +280 -0
  194. package/dist/tools/mobileStore.js +556 -0
  195. package/dist/tools/modules.js +48 -0
  196. package/dist/tools/organizationStructure.js +137 -0
  197. package/dist/tools/pages.js +465 -98
  198. package/dist/tools/platformInfo.js +28 -8
  199. package/dist/tools/profileWrite.js +92 -0
  200. package/dist/tools/projects.js +71 -9
  201. package/dist/tools/rows.js +69 -13
  202. package/dist/tools/schemaOps.js +61 -1
  203. package/dist/tools/screenWrite.js +36 -7
  204. package/dist/tools/screens.js +95 -5
  205. package/dist/tools/templates.js +26 -1
  206. package/dist/tools/translations.js +1 -1
  207. package/dist/tools/variables.js +11 -5
  208. package/dist/tools/workflows.js +10 -5
  209. package/package.json +2 -2
  210. package/dist/platform/screenshot.js +0 -1162
@@ -4,7 +4,10 @@ import { reservedTenantTables } from './reservedTables.js';
4
4
  import { headersAccessNames, isHeadersAccessGuarded } from './flowGuards.js';
5
5
  import { callsItself, functionCallRefs, isValidParameterName, mentionsAwait, nameProblem, sourceOf, callPrefix } from './functionGuards.js';
6
6
  import { backendPolicyRules } from './backendConstraints.js';
7
+ import { accessPolicyRules } from './access.js';
7
8
  import { themePolicyRules } from './themeRules.js';
9
+ import { processPolicyRules } from './process.js';
10
+ import { mobileStorePolicyRules } from './mobileStore.js';
8
11
  const terminalStepTypes = new Set(['response', 'convert', 'revert']);
9
12
  const DESCRIPTION_EXEMPT_STEPS = new Set(['start']);
10
13
  const stepKindMatrix = {
@@ -19,6 +22,7 @@ const stepKindMatrix = {
19
22
  email: ['workflow', 'automation', 'middleware'],
20
23
  'file-upload': ['workflow', 'automation', 'middleware'],
21
24
  microfunction: ['workflow', 'automation', 'middleware'],
25
+ process: ['workflow', 'automation'],
22
26
  variable: ['middleware'],
23
27
  'set-user': ['middleware'],
24
28
  setcookie: ['middleware'],
@@ -146,13 +150,24 @@ export function readsBeforeGuard(source, root) {
146
150
  * code.ts:49). Eşleşme yoksa flow-engine.ts:79 sessizce durur. Studio tarafında da zincir
147
151
  * `sourceBranch === 'always'` ile çizilir (EventActionsStart.svelte:47, EventActionsItem.svelte:298).
148
152
  * condition dalları rule id'sidir (serbest), microservice'te 'success' yalnız eski şema için
149
- * yaşatılır (microservice.ts:144).
153
+ * yaşatılır (microservice.ts:174 `isHasSuccess`). 'error' dalı 2026-09-26'dan beri motorun
154
+ * KENDİSİ tanır (ADR 0004, ZM-07/g-02): bağlıysa hata anında `always` hiç koşmaz, sürer
155
+ * (microservice.ts:182 `hasBranch`) — eski motor tanımadığı dalı hiç aramadığı için bu ekleme
156
+ * geriye dönük zararsızdır.
150
157
  */
151
158
  const flowBranchNames = {
152
159
  start: ['always'],
153
- microservice: ['always', 'success'],
160
+ microservice: ['always', 'success', 'error'],
154
161
  confirm: ['yes', 'no', 'always'],
155
162
  function: ['always'],
163
+ haptic: ['always'],
164
+ location: ['always', 'error'],
165
+ 'notification-permission': ['always'],
166
+ 'notification-schedule': ['always', 'error'],
167
+ 'notification-cancel': ['always'],
168
+ bpm: ['always', 'success', 'fail'],
169
+ permission: ['always'],
170
+ 'open-settings': ['always'],
156
171
  end: []
157
172
  };
158
173
  /**
@@ -163,8 +178,19 @@ const flowBranchNames = {
163
178
  */
164
179
  export const knownFlowStepTypes = new Set([
165
180
  'start', 'end', 'query', 'setter', 'download', 'condition', 'redirect', 'setcookie', 'alert', 'confirm',
166
- 'microservice', 'validation', 'flow-trigger', 'storage', 'navigate', 'code', 'function'
181
+ 'microservice', 'validation', 'flow-trigger', 'storage', 'navigate', 'code', 'function', 'share',
182
+ 'haptic', 'location', 'notification-permission', 'notification-schedule', 'notification-cancel', 'bpm',
183
+ 'permission', 'open-settings'
167
184
  ]);
185
+ /**
186
+ * Cihaz yeteneği adımlarının kapalı kümeleri — `@ng-apps/flow` `tasks/device/device.functions.ts`
187
+ * `HAPTIC_STYLES`/`LOCATION_ACCURACIES`'in aynası (`test/flow-step-parity.test.ts` bağlar); backend
188
+ * `FlowDtoValidator` aynı kümeyle 400 döner. Kök `docs/adr/0003-cihaz-yetenegi-adimlari.md`.
189
+ */
190
+ export const hapticStyles = new Set(['success', 'warning', 'error', 'light', 'medium', 'heavy', 'selection']);
191
+ export const locationAccuracies = new Set(['low', 'balanced', 'high']);
192
+ /** `permission` adımının kipleri — `@ng-apps/flow` `PERMISSION_MODES`'un aynası (kök ADR 0010); tür adını gateway bilmez, backend doğrular. */
193
+ export const permissionStepModes = new Set(['request', 'check']);
168
194
  const flowFreeBranchTypes = new Set(['condition']);
169
195
  /** `condition.types.ts` ConditionArgumentRuleType — motorun tanıdığı üçlü. */
170
196
  const conditionRuleTypes = new Set(['if', 'else-if', 'else']);
@@ -176,16 +202,17 @@ const conditionRuleIdPattern = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}
176
202
  // Runtime.svelte'de HAM verilir (`argument: step.args`), yani bu alanlarda ifade değerlendirilmez.
177
203
  const flowLiteralTextFields = new Map([
178
204
  ['alert', ['message', 'description']],
179
- ['confirm', ['message', 'title', 'confirmText', 'cancelText']]
205
+ ['confirm', ['message', 'title', 'confirmText', 'cancelText']],
206
+ ['share', ['title']],
207
+ ['notification-schedule', ['name', 'title', 'path']],
208
+ ['notification-cancel', ['name']]
180
209
  ]);
181
210
  const flowExpressionLooking = /\$\{|\b(?:Steps|Page|Row|Widget|LocalStorage|state|self|item|event|error|cookie)\s*(?:\?\.|\.|\[)/;
182
- // Barındırıcıya özel tipler (`navigate` web'de, `confirm`/`download` mobilde register edilmez)
183
- // BURADA kural üretmez. `navigate`i gateway normalizasyonu zaten `redirect`e çeviriyor
184
- // (normalize.ts `normalizeFlowHostGaps`) — `redirect` iki barındırıcıda da koşar, yani vaka
185
- // uyarılmaz, ORTADAN KALKAR. Geriye kalan `confirm`/`download` tek başına kusur değildir: sayfa
186
- // tek bir uygulamaya aittir (`Page.ApplicationId`), uygulamanın tipi web ya da mobile'dır
187
- // (`ApplicationType.cs`) ve gateway hangisi olduğunu bilmez. Mobil ayağı uygulama tarafında
188
- // kapanır (`ScreenRuntime.tsx`), lint'te değil.
211
+ // Barındırıcıya özel tipler BURADA kural üretmez. `navigate`i gateway normalizasyonu zaten
212
+ // `redirect`e çeviriyor (normalize.ts `normalizeFlowHostGaps`) — `redirect` iki barındırıcıda da
213
+ // koşar, yani vaka uyarılmaz, ORTADAN KALKAR. Gateway uygulamanın tipini platform profilinden bilir
214
+ // ve barındırıcı sözlüğü `platform/*.ts`'tedir (`profile.steps`); mobil farkları orada `MOB-005`
215
+ // olarak konuşulur (`platform/lint.ts`). Yeni mobil runtime `confirm`/`download`'ı kaydeder.
189
216
  const flowUnregisteredStepTypes = new Set(['end', 'query']);
190
217
  const flowSetterIterateeTypes = new Set(['change', 'fill']);
191
218
  function flowStepList(value) {
@@ -305,25 +332,71 @@ function writesRolesWithoutSlug(entityId, parameters) {
305
332
  }
306
333
  const rolesSlugMessage = "Built-in 'roles' entity'sine slug YAZMADAN rol satırı ÜRETİLİYOR (operation create/upsert). Insert 200 döner, satır role_list'te görünür ve page.roleIds ile bağlanır — ama yetkilendirme SLUG karşılaştırır: platformun get-user sorgusu roles+user_roles join'inden slug dizisi üretir ve Authorized(user.roles) o rol için hiçbir zaman tutmaz. fields'a slug'ı ekleyin ('super-admin' slug'ını vermeyin — platform süper yöneticiyi o slug ile arar). Upsert'te slug'ı İFADEYLE üretmeyin: UPDATE yolunda ifade yeniden değerlendirilir ve var olan rolün slug'ı sessizce değişir (MS-016) — üretilen slug'ı yalnız create ucunda yazın. Rolü kullanıcıya bağlamak ayrı bir user_roles satırıdır.";
307
334
  const contractKeys = ['returnDtoId', 'parameterDtoId', 'returnBehavior', 'parameterBehavior'];
308
- const filterOperators = new Set(['eq', 'neq', 'lt', 'lte', 'gt', 'gte', 'contains', 'icontains', 'in', 'notin', 'startswith', 'endswith', 'istartswith', 'iendswith', 'isnull', 'isnotnull']);
335
+ /**
336
+ * Filtre işleci sözlüğü — backend `OperatorType` enum'u (paketlenmiş `Filter` şeması; eşitliği
337
+ * `test/filter-operators.test.ts` kilitler). Studio filtre ARAYÜZÜNÜN sözlüğü (`notContains`, `between`…,
338
+ * `componentCatalog.ts`) ayrı bir kavramdır: arayüz onları bu işleçlere çevirir.
339
+ */
340
+ export const filterOperators = new Set(['eq', 'neq', 'lt', 'lte', 'gt', 'gte', 'contains', 'icontains', 'in', 'notin', 'startswith', 'endswith', 'istartswith', 'iendswith', 'isnull', 'isnotnull']);
341
+ /** Ajanların sık yazdığı yanlış adlar → doğru işleç. Yalnız ÖNERİLİR, sessizce çevrilmez. */
342
+ const filterOperatorSuggestions = {
343
+ ne: 'neq', '!=': 'neq', '<>': 'neq', noteq: 'neq', notequal: 'neq', notequals: 'neq', not_eq: 'neq',
344
+ '=': 'eq', '==': 'eq', equal: 'eq', equals: 'eq',
345
+ '<': 'lt', '<=': 'lte', '>': 'gt', '>=': 'gte',
346
+ like: 'contains', ilike: 'icontains', nin: 'notin', 'not in': 'notin', not_in: 'notin'
347
+ };
309
348
  function flattenFilterTree(filters) {
310
349
  return filters
311
350
  .filter((filter) => Boolean(filter) && typeof filter === 'object')
312
351
  .flatMap(filter => [filter, ...flattenFilterTree(asArray(filter.children))]);
313
352
  }
353
+ /**
354
+ * Bilinmeyen işleçler, öneriyle: `status: 'ne' (neq mı demek istedin?)`. Grup çocukları da okunur. Ad
355
+ * büyük/küçük harfe DUYARLI eşlenir — backend de öyle eşler (`GetValueFromDescription` `==`); `NEQ`
356
+ * bilinmeyendir ve küçük harfli adı önerilir.
357
+ */
358
+ function unknownFilterOperators(filters) {
359
+ return flattenFilterTree(filters)
360
+ .filter(filter => filter.operator !== undefined && filter.operator !== null && !filterOperators.has(String(filter.operator)))
361
+ .map(filter => {
362
+ const operator = String(filter.operator);
363
+ const lower = operator.toLowerCase();
364
+ const suggestion = filterOperators.has(lower) ? lower : filterOperatorSuggestions[lower];
365
+ return `${String(filter.field ?? filter.fieldSlug ?? filter.fieldId ?? '?')}: '${operator}'${suggestion ? ` (${suggestion} mı demek istedin?)` : ''}`;
366
+ });
367
+ }
368
+ const unknownOperatorConsequence = "Bilinmeyen işleç yola ve backend sürümüne göre ya 400 alır ya sessizce 'eq'e düşer ve sorgu yanlış sonuç döner (2026-09-27'den sonraki backend uç çağrısının `filters` parametresini 400 ile reddeder; workflow tablo adımı hâlâ sessizce 'eq' yapar); ad büyük/küçük harfe duyarlıdır — doğru işleci yazın";
314
369
  function unknownOperatorFindings(ruleId, owner, filters) {
315
- const unknownOperators = flattenFilterTree(filters)
316
- .filter(filter => filter.operator !== undefined && filter.operator !== null && !filterOperators.has(String(filter.operator).toLowerCase()))
317
- .map(filter => `${String(filter.fieldSlug ?? filter.fieldId ?? '?')}: '${String(filter.operator)}'`);
370
+ const unknownOperators = unknownFilterOperators(filters);
318
371
  return unknownOperators.length > 0
319
372
  ? [{
320
373
  ruleId,
321
374
  severity: 'block',
322
- message: `${owner}: bilinmeyen filtre operatörü — ${unknownOperators.join(', ')}. Platform bilinmeyen operatörü 400 ile REDDETMEZ, sessizce 'eq'e düşürür (EnumExtensions.GetValueFromDescription null → default) ve uç testten geçip yanlış çalışır. Geçerli sözlük: ${[...filterOperators].join(' · ')} ('like' yok — metin araması için 'contains'/'icontains').`,
375
+ message: `${owner}: bilinmeyen filtre işleci — ${unknownOperators.join(', ')}. ${unknownOperatorConsequence}. Geçerli sözlük: ${[...filterOperators].join(' · ')} ('like' yok — metin araması için 'contains'/'icontains').`,
323
376
  guide: 'ngapps://guides/microservice'
324
377
  }]
325
378
  : [];
326
379
  }
380
+ /**
381
+ * Çalışma anında gelen filtre (`row_list.filters`, `microservice_execute` `filters` parametresi): dizi ya
382
+ * da JSON dizesi. Bilinmeyen işleç varsa hata METNİ döner — araç isteği göndermeden 400 verir
383
+ * (plans/mobil-plantcare-acigi g-03). Ayrıştırılamayan değer backend'e bırakılır.
384
+ */
385
+ export function filterOperatorError(owner, filters) {
386
+ let parsed = filters;
387
+ if (typeof filters === 'string') {
388
+ try {
389
+ parsed = JSON.parse(filters);
390
+ }
391
+ catch {
392
+ return undefined;
393
+ }
394
+ }
395
+ const unknownOperators = Array.isArray(parsed) ? unknownFilterOperators(parsed) : [];
396
+ return unknownOperators.length > 0
397
+ ? `${owner}: bilinmeyen filtre işleci — ${unknownOperators.join(', ')}. İstek GÖNDERİLMEDİ. ${unknownOperatorConsequence}. Geçerli sözlük: ${[...filterOperators].join(' · ')}.`
398
+ : undefined;
399
+ }
327
400
  function isReadOperation(parameters) {
328
401
  const operation = String(parameters?.operation ?? '').toLowerCase();
329
402
  return !writeOperations.has(operation);
@@ -433,6 +506,27 @@ const isRecord = (value) => Boolean(value) && typeof value === 'object' && !Arra
433
506
  const functionsGuide = 'ngapps://guides/functions';
434
507
  /** FN-006: bu kadar dolu satırdan uzun gövde yorumsuz kalmaz; tek satırlık `return` yorum istemez. */
435
508
  const FUNCTION_COMMENT_MIN_LINES = 5;
509
+ /**
510
+ * BPM-022: `process.*` sistem işlemi karşılığı olan `Page.bpm` üyeleri (backend
511
+ * `SystemOperationConstants`, zeyrek-backend/docs/bpm/sablon-paketleri.md §Sistem işlemleri).
512
+ * `start`, `cases`, `documents`, `analytics`, `exportLog`, `offline`, `legalHold(s)` karşılıksızdır;
513
+ * onları kullanan akışa uyarı vermek yol gösteremeyen gürültüdür.
514
+ */
515
+ const PAGE_BPM_SYSTEM_MEMBERS = new Set([
516
+ 'definitions', 'users', 'directory', 'tasks', 'task', 'instances', 'instance', 'timeline', 'signal',
517
+ 'batch', 'batchOperation', 'delegations', 'delegate', 'delegation', 'handover', 'notifications',
518
+ 'notification', 'preferences', 'override', 'report'
519
+ ]);
520
+ /**
521
+ * BPM-022: karşılığı olan üyenin sistem işlemi OLMAYAN alt çağrıları (bpm.runtime.ts). Bunlar ve
522
+ * `batch('start', …)` eski yolda kalır; taze bağlam incelemesi (2026-09-23) üye düzeyindeki bakışın
523
+ * `instance(id).exportLedger()` gibi rehberin kendi önerdiği çağrıları uyardığını buldu.
524
+ */
525
+ const PAGE_BPM_UNMAPPED_CALLS = new Set([
526
+ 'tasks.calendar', 'task.comment', 'task.workedMinutes', 'task.assistant', 'instance.exportLedger',
527
+ 'instance.watch', 'instance.unwatch', 'instance.comments', 'handover.history', 'override.conflicts',
528
+ 'batchOperation.get'
529
+ ]);
436
530
  export const policyRules = [
437
531
  {
438
532
  id: 'MS-001',
@@ -712,7 +806,7 @@ export const policyRules = [
712
806
  return [{
713
807
  ruleId: 'WF-005',
714
808
  severity: 'block',
715
- message: `'${stepLabel(step)}' step'i (${step.type}) ${kind} tipinde kullanılamaz. İzin matrisi: variable/set-user/setcookie/redirect yalnız middleware; convert yalnız workflow; revert yalnız automation; response workflow+middleware.`,
809
+ message: `'${stepLabel(step)}' step'i (${step.type}) ${kind} tipinde kullanılamaz. İzin matrisi: variable/set-user/setcookie/redirect yalnız middleware; convert yalnız workflow; revert yalnız automation; response workflow+middleware; process workflow+automation.`,
716
810
  guide: 'ngapps://guides/workflow'
717
811
  }];
718
812
  });
@@ -2251,6 +2345,48 @@ export const policyRules = [
2251
2345
  }];
2252
2346
  })
2253
2347
  },
2348
+ {
2349
+ id: 'FLOW-028',
2350
+ module: 'flow',
2351
+ appliesTo: ['create', 'update'],
2352
+ sourceRef: "Yetki şablonu (access.json 1.7.0) 33 kod adımında platformun oturum uçlarına ham fetch atıyordu ('/api/' + project + '/runtime/' + application + '/auth/me' ve '/auth/sign-in'). Ham istek ng-apps-flow/src/api/instance.ts'in yaptıklarını atlar: X-Environment çözümü (resolveRuntimeEnvironment; elle ayrıştırma /preview şeridinde index -1 verir), CSRF başlığı (çerezli POST 403 CsrfTokenMismatchException — S2-37 · S3-7), 401'de tek refresh + yeniden deneme, ve ExecuteMicroserviceBehavior'ın microservice.execute kararı ile gölge günlüğü. Düzeltme 2026-09-22: giriş ve oturum bilgisi access.session.create / access.session.get system operation'larına taşındı (backend ADR 0004); çıkış 2026-10-01'de access.session.delete ile eklendi. Dış API'ye fetch meşrudur; kural yalnız göreli platform yollarını (/api/, /m/, /runtime/) görür",
2353
+ check: definition => flowAllSteps(definition)
2354
+ .filter(step => step.type === 'code')
2355
+ .flatMap((step) => {
2356
+ const body = String((step.args ?? {}).value ?? '');
2357
+ if (!/\bfetch\s*\(|XMLHttpRequest/.test(body) || !/['"`]\/(api|m|runtime)\/|\/runtime\//.test(body))
2358
+ return [];
2359
+ return [{
2360
+ ruleId: 'FLOW-028',
2361
+ severity: 'warn',
2362
+ message: `'${flowStepLabel(step)}' code adımı platformun kendi ucuna ham istek atıyor. Bu yol runtime'ın istek katmanını atlar: X-Environment elle kurulur, CSRF başlığı yoktur (çerezli POST 403 CsrfTokenMismatchException), 401'de oturum yenilenmez ve istek microservice.execute kararını ve gölge günlüğünü hiç görmez. Platform davranışını çağırmanın yolu microservice adımıdır: karşılığı olan bir system operation varsa (microservice_system_operation_list — giriş için access.session.create, oturumdaki kullanıcı için access.session.get, çıkış için access.session.delete) source:'system' bir uç açın ve akışa type:'microservice' adımı koyun; sonuç Steps.<adım>.data'dadır, kod adımı yalnız onu biçimler.`,
2363
+ guide: 'ngapps://guides/page'
2364
+ }];
2365
+ })
2366
+ },
2367
+ {
2368
+ id: 'FLOW-037',
2369
+ module: 'flow',
2370
+ appliesTo: ['create', 'update'],
2371
+ sourceRef: "mobile-qm koşusu 2026-10-01: çıkış akışı oturumu storage adımları (ZY_App_qm/ZY_AppRefresh_qm/ZY_Csrf_qm = '') ve kod adımında cookie.remove ile kapatmaya çalıştı. Platformun oturum çerezleri (AppSessionConstants: ZY_App_ · ZY_AppRefresh_ · ZY_Csrf_) sunucunun HttpOnly Set-Cookie'sidir: web'de document.cookie onları göremez, mobilde akışın cookie/storage deposu Keychain/kv-store'dur ve iOS NSHTTPCookieStorage'a ulaşmaz. Refresh ailesi sunucuda iptal edilmediği için kapat-aç sonrası auth/refresh oturumu yeniden yazdı (kullanıcı girişli açıldı). Çıkış access.session.delete system operation'ıdır (guard 2026-10-01'den beri session: süresi dolmuş jetonda 401, runtime yenileyip tekrarlar; uç isAnonymous:true kalır): aileyi iptal eder, üç çerezi yanıtla siler",
2372
+ check: definition => flowAllSteps(definition)
2373
+ .flatMap((step) => {
2374
+ const args = (step.args ?? {});
2375
+ const name = String(args.name ?? '');
2376
+ const body = String(args.value ?? '');
2377
+ const touchesSessionCookie = (step.type === 'storage' || step.type === 'setcookie')
2378
+ ? /^ZY_(App|AppRefresh|Csrf)_/.test(name)
2379
+ : step.type === 'code' && /\bcookie\s*\.\s*(remove|set)\s*\(/.test(body) && /['"`]ZY_(App|AppRefresh|Csrf)_/.test(body);
2380
+ if (!touchesSessionCookie)
2381
+ return [];
2382
+ return [{
2383
+ ruleId: 'FLOW-037',
2384
+ severity: 'warn',
2385
+ message: `'${flowStepLabel(step)}' adımı platformun oturum çerezine (ZY_App_ · ZY_AppRefresh_ · ZY_Csrf_) akıştan dokunuyor. Bu çerezler sunucunun HttpOnly çerezleridir: akışın cookie/storage deposu onlara ulaşmaz (mobilde Keychain/kv-store, web'de document.cookie) ve refresh ailesi sunucuda açık kaldığı için kullanıcı kapat-aç sonrası yeniden girişli olur. Çıkış için source:'system', systemOperation:'access.session.delete', isAnonymous:true bir uç açın ve akışa type:'microservice' adımı koyun, ardından redirect ile giriş sayfasına gidin — uç refresh ailesini iptal eder ve üç çerezi yanıtla siler. Uygulamanın kendi değerleri (ör. 'beni hatırla' bayrağı) storage'da kalabilir.`,
2386
+ guide: 'ngapps://guides/access'
2387
+ }];
2388
+ })
2389
+ },
2254
2390
  {
2255
2391
  id: 'FLOW-020',
2256
2392
  module: 'flow',
@@ -2374,7 +2510,7 @@ export const policyRules = [
2374
2510
  id: 'FLOW-022',
2375
2511
  module: 'flow',
2376
2512
  appliesTo: ['create', 'update'],
2377
- sourceRef: "alert.ts `const { message, alertType, description } = task.argument` → toast.error(message, { description }) / dialog.alert(message); confirm.ts `dialog.confirm(message, { title, confirmText, cancelText })` (boş çerçeve metni dialog.functions.ts resolveDialogFrame'de sabit metne düşer). Argüman Runtime.svelte'de HAM geçer (`argument: step.args`) — bu alanlarda hiçbir ifade değerlendirilmez, yazılan metin ekranda harfi harfine görünür (2026-09-06·2 koşusu S-13'ün ikinci turu: rehber hata mesajını göstermek için alert adımını öneriyordu)",
2513
+ sourceRef: "alert.ts `const { message, alertType, description } = task.argument` → toast.error(message, { description }) / dialog.alert(message); confirm.ts `dialog.confirm(message, { title, confirmText, cancelText })` (boş çerçeve metni dialog.functions.ts resolveDialogFrame'de sabit metne düşer). Argüman Runtime.svelte'de HAM geçer (`argument: step.args`) — bu alanlarda hiçbir ifade değerlendirilmez, yazılan metin ekranda harfi harfine görünür (2026-09-06·2 koşusu S-13'ün ikinci turu: rehber hata mesajını göstermek için alert adımını öneriyordu). share adımında (2026-09-25) yalnız `title` düz metindir: @ng-apps/flow resolveShareContent onu olduğu gibi verir, `message` ve `path` ifadedir",
2378
2514
  check: definition => flowAllSteps(definition)
2379
2515
  .flatMap((step) => {
2380
2516
  const type = String(step.type ?? '');
@@ -2387,16 +2523,221 @@ export const policyRules = [
2387
2523
  .map(field => ({
2388
2524
  ruleId: 'FLOW-022',
2389
2525
  severity: 'warn',
2390
- message: `'${flowStepLabel(step)}' ${type} adımının '${field}' alanı ifade içeriyor ama bu alan DÜZ METİNDİR: ${type}.ts task.argument.${field}'i doğrudan ekrana geçirir ve args hiçbir yerde değerlendirilmez (Runtime.svelte \`argument: step.args\`). Kullanıcı ifadenin sonucunu değil ifadenin KENDİSİNİ görür. Ucun mesajını göstermek için bir setter (ya da code) adımı kullanın — value { type: 'code', ref: 'Steps.error?.message' }; hata metninin nerede durduğu page.md §hata yolu'nda.`,
2526
+ message: type.startsWith('notification-')
2527
+ ? `'${flowStepLabel(step)}' ${type} adımının '${field}' alanı ifade içeriyor ama bu alan DÜZ METİNDİR (kök ADR 0003): ${field === 'name' ? 'bildirimin kimliği' : field === 'path' ? 'açılacak sayfanın slug\'ı' : 'bildirim başlığı'} olduğu gibi kullanılır, ifade değerlendirilmez. Değişen içeriği ifade olan 'message' (gövde) ya da 'query' (sayfanın sorgusu) alanına yazın.`
2528
+ : type === 'share'
2529
+ ? `'${flowStepLabel(step)}' share adımının '${field}' alanı ifade içeriyor ama bu alan DÜZ METİNDİR: başlık paylaşım penceresine olduğu gibi gider (iOS'ta e-posta konusu, Android'de seçici başlığı), ifade değerlendirilmez. Değişen içeriği ifade olan 'message' alanına yazın — ör. message: "'Şuna bak: ' + Page.properties.name"; bağlantı 'path' alanındadır.`
2530
+ : `'${flowStepLabel(step)}' ${type} adımının '${field}' alanı ifade içeriyor ama bu alan DÜZ METİNDİR: ${type}.ts task.argument.${field}'i doğrudan ekrana geçirir ve args hiçbir yerde değerlendirilmez (Runtime.svelte \`argument: step.args\`). Kullanıcı ifadenin sonucunu değil ifadenin KENDİSİNİ görür. Ucun mesajını göstermek için bir setter (ya da code) adımı kullanın — value { type: 'code', ref: 'Steps.error?.message' }; hata metninin nerede durduğu page.md §hata yolu'nda.`,
2391
2531
  guide: 'ngapps://guides/page'
2392
2532
  }));
2393
2533
  })
2394
2534
  },
2535
+ {
2536
+ id: 'FLOW-035',
2537
+ module: 'flow',
2538
+ appliesTo: ['create', 'update'],
2539
+ sourceRef: "share adımının argümanı StepManagementArgument'ın Title/Message/Path alanlarında saklanır (StepType.cs `share`, kök docs/adr/0001-share-akis-adimi.md); url/link/text gibi anahtarlar sözleşmede YOKTUR ve platform onları 200 ile sessizce düşürür — adım hiçbir şey paylaşmadan akış sürer. `message` ve `path` İFADEDİR (@ng-apps/flow resolveShareContent → runCode): tırnaksız 'https://…' JS'te etiket + yorumdur, undefined döner",
2540
+ check: definition => flowAllSteps(definition)
2541
+ .filter(step => step.type === 'share')
2542
+ .flatMap((step) => {
2543
+ const args = (step.args ?? {});
2544
+ const filled = (key) => typeof args[key] === 'string' && String(args[key]).trim().length > 0;
2545
+ const findings = [];
2546
+ const strayLinks = ['url', 'link', 'href'].filter(filled);
2547
+ const strayTexts = ['text', 'body', 'content'].filter(filled);
2548
+ if (strayLinks.length > 0) {
2549
+ findings.push({
2550
+ ruleId: 'FLOW-035',
2551
+ severity: filled('path') ? 'warn' : 'block',
2552
+ message: `'${flowStepLabel(step)}' share adımının bağlantısı args.${strayLinks.join('/args.')} alanında: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür ve adım bağlantısız kalır. Bağlantıyı args.path'e ifade olarak yazın — ör. "'https://ornek.app/urun/' + Page.queryParams.id".`,
2553
+ guide: 'ngapps://guides/page'
2554
+ });
2555
+ }
2556
+ if (strayTexts.length > 0) {
2557
+ findings.push({
2558
+ ruleId: 'FLOW-035',
2559
+ severity: filled('message') ? 'warn' : 'block',
2560
+ message: `'${flowStepLabel(step)}' share adımının metni args.${strayTexts.join('/args.')} alanında: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu sessizce düşürür. Metni args.message'a ifade olarak yazın — ör. "'Şuna bak: ' + Page.properties.name".`,
2561
+ guide: 'ngapps://guides/page'
2562
+ });
2563
+ }
2564
+ for (const key of ['message', 'path']) {
2565
+ const value = typeof args[key] === 'string' ? String(args[key]).trim() : '';
2566
+ if (/^[a-z][a-z\d+\-.]*:\/\//i.test(value)) {
2567
+ findings.push({
2568
+ ruleId: 'FLOW-035',
2569
+ severity: 'block',
2570
+ message: `'${flowStepLabel(step)}' share adımının '${key}' alanı tırnaksız bir adres: '${value}'. Bu alan İFADEDİR — tırnaksız adres JS'te etiket + yorumdur, undefined döner ve hiçbir şey paylaşılmaz. Dize olarak yazın: "'${value}'".`,
2571
+ guide: 'ngapps://guides/page'
2572
+ });
2573
+ }
2574
+ }
2575
+ return findings;
2576
+ })
2577
+ },
2578
+ {
2579
+ id: 'FLOW-029',
2580
+ module: 'flow',
2581
+ appliesTo: ['create', 'update'],
2582
+ sourceRef: "Cihaz yeteneği adımlarının argümanı StepManagementArgument'ın mevcut alanlarındadır (kök docs/adr/0003-cihaz-yetenegi-adimlari.md): haptic.value = stil, location.value = doğruluk, location.isRaw = adres çözülmesin. İkisi de DÜZ METİNDİR (@ng-apps/flow hapticStyle/locationAccuracy), kümede olmayan değer backend FlowDtoValidator'da 400 alır; style/accuracy/reverseGeocode gibi anahtarlar sözleşmede YOKTUR ve platform onları 200 ile sessizce düşürür — adım varsayılanla (medium / balanced / adresli) koşar",
2583
+ check: definition => flowAllSteps(definition)
2584
+ .filter(step => step.type === 'haptic' || step.type === 'location')
2585
+ .flatMap((step) => {
2586
+ const args = (step.args ?? {});
2587
+ // Backend (FlowDtoValidator) yalnız tamamen boşluk olanı boş sayar; kümeyle karşılaştırmayı kırpmadan yapar.
2588
+ const raw = typeof args.value === 'string' ? args.value : '';
2589
+ const value = raw.trim() ? raw : '';
2590
+ const haptic = step.type === 'haptic';
2591
+ const allowed = haptic ? hapticStyles : locationAccuracies;
2592
+ const field = haptic ? 'stil' : 'doğruluk';
2593
+ const findings = [];
2594
+ const stray = (haptic ? ['style', 'type', 'feedback'] : ['accuracy', 'precision'])
2595
+ .filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
2596
+ if (value && !allowed.has(value)) {
2597
+ const unquoted = value.replace(/^['"`](.*)['"`]$/, '$1');
2598
+ const trimmed = value.trim();
2599
+ findings.push({
2600
+ ruleId: 'FLOW-029',
2601
+ severity: 'block',
2602
+ message: allowed.has(unquoted)
2603
+ ? `'${flowStepLabel(step)}' ${step.type} adımının ${field} değeri tırnaklı yazılmış: ${value}. Bu alan DÜZ METİNDİR, ifade değil — args.value: '${unquoted}' yazın.`
2604
+ : allowed.has(trimmed)
2605
+ ? `'${flowStepLabel(step)}' ${step.type} adımının ${field} değerinin çevresinde boşluk var: '${value}'. Platform kırpmadan karşılaştırır ve 400 döner — args.value: '${trimmed}' yazın.`
2606
+ : `'${flowStepLabel(step)}' ${step.type} adımının ${field} değeri '${value}' tanınmıyor; platform 400 döner. Kullanılabilir: ${[...allowed].join(', ')} (boş → ${haptic ? 'medium' : 'balanced'}).`,
2607
+ guide: 'ngapps://guides/mobile'
2608
+ });
2609
+ }
2610
+ if (stray.length > 0) {
2611
+ findings.push({
2612
+ ruleId: 'FLOW-029',
2613
+ severity: value ? 'warn' : 'block',
2614
+ message: `'${flowStepLabel(step)}' ${step.type} adımının ${field} değeri args.${stray.join('/args.')} alanında: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür ve adım varsayılanla (${haptic ? 'medium' : 'balanced'}) koşar. Değeri args.value'ya düz metin olarak yazın — ör. args.value: '${haptic ? 'success' : 'high'}'.`,
2615
+ guide: 'ngapps://guides/mobile'
2616
+ });
2617
+ }
2618
+ if (!haptic && ['reverseGeocode', 'address', 'geocode'].some(key => args[key] !== undefined)) {
2619
+ findings.push({
2620
+ ruleId: 'FLOW-029',
2621
+ severity: 'warn',
2622
+ message: `'${flowStepLabel(step)}' location adımında adres anahtarı sözleşmede YOK ve sessizce düşer. Adres varsayılan olarak çözülür (cihazda; web'de hep null); kapatmak için args.isRaw: true yazın.`,
2623
+ guide: 'ngapps://guides/mobile'
2624
+ });
2625
+ }
2626
+ return findings;
2627
+ })
2628
+ },
2629
+ {
2630
+ id: 'FLOW-038',
2631
+ module: 'flow',
2632
+ appliesTo: ['create', 'update'],
2633
+ sourceRef: "İzin adımının argümanı StepManagementArgument'ın mevcut alanlarındadır (kök docs/adr/0010-izin-katalogu-tarama-ve-derlemede-budama.md): permission.value = izin türü (katalog anahtarı, DÜZ METİN — ifade değil: backend kullanım taramasında bu değeri yazılı okur ve mağaza derlemesinin taşıdığı izinleri ondan hesaplar), permission.name = kip (@ng-apps/flow PERMISSION_MODES; boş = request). Türü ya da kipi geçersiz adım backend FlowDtoValidator'da 422 alır; kind/mode/permission gibi anahtarlar sözleşmede YOKTUR ve platform onları 200 ile sessizce düşürür. Hangi türlerin desteklendiğini gateway bilmez: mobile_store_get { detail: ['permissions'] }",
2634
+ check: definition => flowAllSteps(definition)
2635
+ .filter(step => step.type === 'permission')
2636
+ .flatMap((step) => {
2637
+ const args = (step.args ?? {});
2638
+ const kind = typeof args.value === 'string' ? args.value : '';
2639
+ const mode = typeof args.name === 'string' ? args.name : '';
2640
+ const stray = ['kind', 'mode', 'permission', 'type'].filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
2641
+ const findings = [];
2642
+ const unquoted = kind.replace(/^['"`](.*)['"`]$/, '$1');
2643
+ if (!kind.trim()) {
2644
+ findings.push({
2645
+ ruleId: 'FLOW-038',
2646
+ severity: 'block',
2647
+ message: `'${flowStepLabel(step)}' permission adımının türü yok: args.value izin anahtarını ister (varsayılanı yoktur; platform 422 döner). Uygulamanın isteyebileceği izinler: mobile_store_get { detail: ['permissions'] } — support: 'supported' satırlarının key'i.`,
2648
+ guide: 'ngapps://guides/mobile'
2649
+ });
2650
+ }
2651
+ else if (unquoted !== kind) {
2652
+ findings.push({
2653
+ ruleId: 'FLOW-038',
2654
+ severity: 'block',
2655
+ message: `'${flowStepLabel(step)}' permission adımının türü tırnaklı yazılmış: ${kind}. Bu alan DÜZ METİNDİR, ifade değil — args.value: '${unquoted}' yazın.`,
2656
+ guide: 'ngapps://guides/mobile'
2657
+ });
2658
+ }
2659
+ else if (flowExpressionLooking.test(kind) || /\{\{/.test(kind) || !/^[a-z][A-Za-z0-9]*$/.test(kind)) {
2660
+ findings.push({
2661
+ ruleId: 'FLOW-038',
2662
+ severity: 'block',
2663
+ message: `'${flowStepLabel(step)}' permission adımının türü yazılı bir izin anahtarı değil: '${kind}'. Tür İFADE olamaz — mağaza derlemesinin hangi izni taşıyacağı bu değerden, akış koşmadan hesaplanır. Türe göre dallanmak için condition adımıyla her tür için ayrı bir permission adımı kurun.`,
2664
+ guide: 'ngapps://guides/mobile'
2665
+ });
2666
+ }
2667
+ if (mode.trim() && !permissionStepModes.has(mode)) {
2668
+ findings.push({
2669
+ ruleId: 'FLOW-038',
2670
+ severity: 'block',
2671
+ message: `'${flowStepLabel(step)}' permission adımının kipi '${mode}' tanınmıyor; platform 422 döner. Kullanılabilir: ${[...permissionStepModes].join(', ')} (boş → request). check yalnız okur, sistem penceresi açmaz.`,
2672
+ guide: 'ngapps://guides/mobile'
2673
+ });
2674
+ }
2675
+ if (stray.length > 0) {
2676
+ findings.push({
2677
+ ruleId: 'FLOW-038',
2678
+ severity: kind.trim() ? 'warn' : 'block',
2679
+ message: `'${flowStepLabel(step)}' permission adımında args.${stray.join('/args.')} alanı var: bu anahtar StepManagementArgument sözleşmesinde YOK, platform onu 200 ile sessizce düşürür. Tür args.value'ya, kip args.name'e düz metin olarak yazılır — ör. args: { value: '<izin anahtarı>', name: 'check' }.`,
2680
+ guide: 'ngapps://guides/mobile'
2681
+ });
2682
+ }
2683
+ return findings;
2684
+ })
2685
+ },
2686
+ {
2687
+ id: 'FLOW-030',
2688
+ module: 'flow',
2689
+ appliesTo: ['create', 'update'],
2690
+ sourceRef: "Yerel bildirim adımlarının argümanı StepManagementArgument'ın mevcut alanlarındadır (kök docs/adr/0003-cihaz-yetenegi-adimlari.md): notification-schedule name = kimlik (düz metin, aynı kimlik eskisinin yerini alır), title düz metin, message ve value İFADE, path sayfa; notification-cancel name = kimlik ('*' hepsi). Zamanın türü value'nun sonucunun şeklinden okunur (@ng-apps/flow notificationTrigger): 'HH:mm' her gün, { weekday: 1-7, time: 'HH:mm' } her hafta (1 = Pazartesi), ISO tarih-saat bir kez. Eksik name/value backend FlowDtoValidator'da 400 alır; id/at/daily/weekly/body gibi anahtarlar sözleşmede YOKTUR ve platform onları 200 ile sessizce düşürür",
2691
+ check: definition => flowAllSteps(definition)
2692
+ .filter(step => step.type === 'notification-schedule' || step.type === 'notification-cancel')
2693
+ .flatMap((step) => {
2694
+ const args = (step.args ?? {});
2695
+ const text = (key) => typeof args[key] === 'string' ? String(args[key]).trim() : '';
2696
+ const findings = [];
2697
+ const schedule = step.type === 'notification-schedule';
2698
+ const stray = ['id', 'identifier', 'at', 'daily', 'weekly', 'time', 'body', 'text']
2699
+ .filter(key => args[key] !== undefined && args[key] !== null && args[key] !== '');
2700
+ if (!text('name')) {
2701
+ findings.push({
2702
+ ruleId: 'FLOW-030',
2703
+ severity: 'block',
2704
+ message: `'${flowStepLabel(step)}' ${step.type} adımının kimliği yok: args.name düz metin olarak yazılmalı (ör. 'sulama')${schedule ? ' — aynı kimlikle yeniden planlama eskisinin yerini alır' : " — '*' bütün planlı bildirimleri siler"}. Platform eksik kimliği 400 ile reddeder.`,
2705
+ guide: 'ngapps://guides/mobile'
2706
+ });
2707
+ }
2708
+ if (schedule && !text('value')) {
2709
+ findings.push({
2710
+ ruleId: 'FLOW-030',
2711
+ severity: 'block',
2712
+ message: `'${flowStepLabel(step)}' notification-schedule adımının zamanı yok: args.value bir İFADEDİR ve sonucu 'HH:mm' (her gün), { weekday: 1-7, time: 'HH:mm' } (her hafta, 1 = Pazartesi) ya da ISO tarih-saattir (bir kez) — ör. "tp_saat.value" ya da "'08:30'".`,
2713
+ guide: 'ngapps://guides/mobile'
2714
+ });
2715
+ }
2716
+ const literal = /^'([^']*)'$/.exec(text('value'))?.[1];
2717
+ if (schedule && literal !== undefined && !/^([01]?\d|2[0-3]):[0-5]\d$/.test(literal) && Number.isNaN(Date.parse(literal))) {
2718
+ findings.push({
2719
+ ruleId: 'FLOW-030',
2720
+ severity: 'block',
2721
+ message: `'${flowStepLabel(step)}' notification-schedule adımının zamanı '${literal}' okunamaz: 'HH:mm' (00:00–23:59), ISO tarih-saat ya da { weekday, time } nesnesi yazın. Çalışmada adım error dalına düşer (status: 'invalid').`,
2722
+ guide: 'ngapps://guides/mobile'
2723
+ });
2724
+ }
2725
+ if (stray.length > 0) {
2726
+ findings.push({
2727
+ ruleId: 'FLOW-030',
2728
+ severity: 'warn',
2729
+ message: `'${flowStepLabel(step)}' ${step.type} adımında args.${stray.join('/args.')} sözleşmede YOK ve platform onu sessizce düşürür. Kimlik args.name, zaman args.value (ifade), metin args.message (ifade), başlık args.title.`,
2730
+ guide: 'ngapps://guides/mobile'
2731
+ });
2732
+ }
2733
+ return findings;
2734
+ })
2735
+ },
2395
2736
  {
2396
2737
  id: 'FLOW-023',
2397
2738
  module: 'flow',
2398
2739
  appliesTo: ['create', 'update'],
2399
- sourceRef: "Adım tipi sözlüğü backend'indir (StepType.cs) ama koşan tipler barındırıcıdan gelir: flow-engine.ts start·setter·code·condition·microservice·validation·flow-trigger register eder, web Runtime.svelte alert·confirm·redirect·download·storage·setcookie ekler, mobil ScreenRuntime.tsx alert·redirect·navigate·storage·setcookie ekler. navigate web'de, confirm/download mobilde YOKTUR; end ve query hiçbir barındırıcıda yoktur (Studio kataloğu da bunu visibility ile söyler: navigate 'mobile', confirm/download 'web'; End eklenebilir adımlar arasında değil — EventActionsAdd.svelte). Register edilmemiş tipe gelen akış SESSİZCE durur: flow-engine.ts process() callback bulamazsa hiçbir şey yapmaz (next yok, completed/stopped yok, hata yok, log yok), run() Promise'i çözülmez ve flowRunFinished() hiç koşmaz — __ngAppsFlowActivity.running sıfıra inmez, page_screenshot'ın hazır bekleyişi her eylemde bütçesini sonuna kadar yakar",
2740
+ sourceRef: "Adım tipi sözlüğü backend'indir (StepType.cs) ama koşan tipler barındırıcıdan gelir: flow-engine.ts start·setter·code·condition·microservice·validation·flow-trigger register eder, web Runtime.svelte alert·confirm·redirect·download·storage·setcookie ekler, mobil @ng-apps/ui-native runtime-tasks.ts alert·confirm·redirect·navigate·storage·setcookie·download ekler. navigate web'de YOKTUR; end ve query hiçbir barındırıcıda yoktur (Studio kataloğu da bunu visibility ile söyler: navigate 'mobile', End eklenebilir adımlar arasında değil — EventActionsAdd.svelte). Register edilmemiş tipe gelen akış SESSİZCE durur: flow-engine.ts process() callback bulamazsa hiçbir şey yapmaz (next yok, completed/stopped yok, hata yok, log yok), run() Promise'i çözülmez ve flowRunFinished() hiç koşmaz — __ngAppsFlowActivity.running sıfıra inmez, page_screenshot'ın hazır bekleyişi her eylemde bütçesini sonuna kadar yakar",
2400
2741
  check: definition => {
2401
2742
  const steps = flowAllSteps(definition);
2402
2743
  // Studio her akış tuvaline dekoratif bir End düğümü koyar ve onu sildirmez; zararlı olan
@@ -2723,27 +3064,27 @@ export const policyRules = [
2723
3064
  })
2724
3065
  },
2725
3066
  {
2726
- id: 'FLOW-027',
3067
+ id: 'BPM-022',
2727
3068
  module: 'flow',
2728
3069
  appliesTo: ['create', 'update'],
2729
- sourceRef: "2026-10-01 kanban ölçüm turu: steps ve errorSteps'te AYNI stepId ('start') flow_create'te 500 `An item with the same key has already been added. Key: start [ArgumentException]` verdi — platform adımları tek sözlüğe stepId anahtarıyla koyuyor, hata mesajı çakışmanın stepId olduğunu söylemiyor",
2730
- check: definition => {
2731
- const counts = new Map();
2732
- for (const step of flowAllSteps(definition)) {
2733
- if (!step.stepId)
2734
- continue;
2735
- counts.set(step.stepId, (counts.get(step.stepId) ?? 0) + 1);
2736
- }
2737
- const repeated = [...counts].filter(([, count]) => count > 1).map(([stepId]) => stepId);
2738
- return repeated.length === 0
3070
+ sourceRef: "bpm-management 1.1.0 sayfaları süreç çalışma zamanına yalnız source: system mikroservislerle gider (plans/bpm-sistem-mikroservis D-1 a, ADR-0004); Page.bpm aynı uçlara mikroservissiz gider, rehberi okuyan ajanlar yine de yazdı (plans/bpm/demo koşuları)",
3071
+ check: definition => flowAllSteps(definition).flatMap((step) => {
3072
+ const calls = [...new Set(flowExpressionSites(step)
3073
+ .flatMap(site => [...site.expression.matchAll(/\bPage\s*\.\s*bpm\b(?:\s*\.\s*([A-Za-z_$][\w$]*))?(\s*\((?:[^()]|\([^()]*\))*\))?(?:\s*\.\s*([A-Za-z_$][\w$]*))?/g)])
3074
+ .filter(([, member = '', callArguments = '', subCall]) => member === ''
3075
+ || (PAGE_BPM_SYSTEM_MEMBERS.has(member)
3076
+ && !(subCall && PAGE_BPM_UNMAPPED_CALLS.has(`${member}.${subCall}`))
3077
+ && !(member === 'batch' && /^\s*\(\s*['"]start['"]/.test(callArguments))))
3078
+ .map(([, member, , subCall]) => (member ? `Page.bpm.${member}${subCall ? `(…).${subCall}` : ''}` : 'Page.bpm')))];
3079
+ return calls.length === 0
2739
3080
  ? []
2740
3081
  : [{
2741
- ruleId: 'FLOW-027',
2742
- severity: 'block',
2743
- message: `stepId'ler akışta (steps + errorSteps birlikte) benzersiz olmalı; tekrar edenler: ${repeated.map(id => `'${id}'`).join(', ')}. Platform bunları tek sözlüğe anahtar olarak koyar ve "An item with the same key has already been added" ile 500 verir (mesaj stepId'den söz etmez). errorSteps'te de kendi 'start' adımı gerekiyorsa ona farklı bir stepId verin (örn. 'err_start').`,
2744
- guide: 'ngapps://guides/page'
3082
+ ruleId: 'BPM-022',
3083
+ severity: 'warn',
3084
+ message: `'${flowStepLabel(step)}' adımı Page.bpm çağırıyor (${calls.join(', ')}). Sayfa akışı süreç çalışma zamanıyla source: system mikroservis üzerinden konuşur: microservice_system_operation_list ile process.* işlemini seçin, microservice_create { source: 'system', systemOperation } ile ucu kurun ve çağrıyı bir microservice adımına taşıyın; sonucu okuyan code adımı Steps.<adım>.data / .error'dan okur. Page.bpm eski yoldur — izin ve görünürlük kararı sistem işleminde aynı servisten gelir, uç Studio'da ve microservice_execute ile görünür.`,
3085
+ guide: 'ngapps://guides/bpm'
2745
3086
  }];
2746
- }
3087
+ })
2747
3088
  },
2748
3089
  {
2749
3090
  id: 'MS-013',
@@ -2986,10 +3327,55 @@ export const policyRules = [
2986
3327
  }];
2987
3328
  }
2988
3329
  },
3330
+ {
3331
+ id: 'MW-006',
3332
+ module: 'workflow',
3333
+ appliesTo: ['create', 'update', 'preview'],
3334
+ sourceRef: "Kimlik devri değeri triggerSource'ta DEĞİL context'te durur: WorkflowContext.SetTriggerSource triggerSource'a { type, id, name, slug, roles, pathAndQuery }, context'e { type, name, roles, path, impersonatedUserId, language } yazar (WorkflowContext.cs:216-235). triggerSource.impersonatedUserId her zaman undefined okunur ve önizleme hep jeton yoluna düşer (ZM-22, koşu 37)",
3335
+ check: (definition) => {
3336
+ const readers = workflowSteps(definition).filter(step => /\btriggerSource\s*\.\s*impersonatedUserId\b/.test(JSON.stringify(step.rule ?? {})));
3337
+ return readers.length === 0
3338
+ ? []
3339
+ : [{
3340
+ ruleId: 'MW-006',
3341
+ severity: 'warn',
3342
+ message: `'${readers.map(stepLabel).join(', ')}' kimlik devrini triggerSource.impersonatedUserId'den okuyor; bu alan yok, değer hep undefined gelir. Doğrusu context.impersonatedUserId — ve yalnız start adımının impersonation dalında: değer yalnız doğrulanmış Studio önizlemesinde dolar, başka yerde yetki kararı için kullanılmaz (platform_guide('middleware') Tarif 1c).`,
3343
+ guide: 'ngapps://guides/middleware'
3344
+ }];
3345
+ }
3346
+ },
3347
+ {
3348
+ id: 'MW-007',
3349
+ module: 'workflow',
3350
+ appliesTo: ['create', 'update', 'preview'],
3351
+ sourceRef: "Sayfa middleware'inin variable adımı WorkflowContext değişkenine yazar ve sayfa yanıtı bu değişkenleri Page.variables olarak istemciye taşır (GetPageBySlugQuery → PageAppDto.Map(workflowContext.ClientVariables), önbellek isabetinde ExecutePageBehavior). rule.isPrivate işaretli değişken sunucuda kalır (WorkflowContext.AddPrivateVariable). qm '[SY] Settings Setter' { ...settings.data } ile sso_client_secret'ı istemciye verdi (2026-10-02)",
3352
+ check: (definition, context) => {
3353
+ if (context.workflowKind !== 'middleware')
3354
+ return [];
3355
+ const exposing = workflowSteps(definition).filter(step => {
3356
+ if (step.type !== 'variable' || step.rule?.isPrivate === true)
3357
+ return false;
3358
+ const expression = String(step.rule?.expression ?? '');
3359
+ return /\.\.\.\s*[A-Za-z_$]/.test(expression) || /secret|password|passwd|api_?key|private_?key/i.test(expression);
3360
+ });
3361
+ return exposing.length === 0
3362
+ ? []
3363
+ : [{
3364
+ ruleId: 'MW-007',
3365
+ severity: 'warn',
3366
+ message: `'${exposing.map(stepLabel).join(', ')}' değişkeni bütün bir kaydı yayıyor ya da gizli değer adı taşıyor. Bu middleware bir SAYFAYA bağlanırsa değişken Page.variables ile istemciye gider (tarayıcıda/cihazda okunur). Gizli değer taşıyan değişkene rule.isPrivate: true verin — aynı istekteki sonraki middleware'ler okumaya devam eder, istemciye gitmez (sayfanın akışları istemcide koşar ve Page.variables'ı okur: işaretli değişken orada undefined'dır); istemcinin gerçekten ihtiyaç duyduğu alanları ayrı bir değişkende izin listesiyle kurun: '({ app_name: settings.data.app_name })' (platform_guide('middleware') Tarif 2). Yalnız microservice uçlarına bağlı middleware'de değişken istemciye dönmez.`,
3367
+ guide: 'ngapps://guides/middleware'
3368
+ }];
3369
+ }
3370
+ },
2989
3371
  // Backend doğrulayıcılarının aynası (ENT-015…018, MS-017, WF-026, QRY/VIEW/DTO/ROW/DS/PRJ/TR/FLD/FILE/EXT):
2990
3372
  // tek liste `backendConstraints.ts`'te durur, buradan yalnız politika motoruna katılır.
2991
3373
  ...themePolicyRules,
2992
- ...backendPolicyRules()
3374
+ ...mobileStorePolicyRules,
3375
+ ...backendPolicyRules(),
3376
+ // Organizasyon şeması, erişim politikası ve alan koruması (ORG/ACC/PROT) — `access.ts`.
3377
+ ...accessPolicyRules(),
3378
+ ...processPolicyRules()
2993
3379
  ];
2994
3380
  /**
2995
3381
  * WF-MF-001'in ikinci yarısı. Bir adımın koşup koşmayacağı yalnız GÖVDEDEN anlaşılamaz: karar