You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a79c44f
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: AGENTS.md
+3-1Lines changed: 3 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,14 +10,15 @@ Guidance for AI coding agents in this repo. PHP backend in `lib/`, Behat integra
10
10
11
11
Comply with the [AI Contribution Policy](https://github.com/nextcloud/.github/blob/master/AI_POLICY.md) (disclosure, accountability, security, licensing, code quality, autonomous behavior) and [Contribution Guidelines](https://github.com/nextcloud/.github/blob/master/CONTRIBUTING.md) (testing, DCO, license headers, conventional commits, translations).
12
12
13
+
**Before writing any code:** if the task is a new feature or a complex change (multiple subsystems, architectural decisions, unclear approach), stop and ask the contributor whether a GitHub issue already exists to agree on the approach with maintainers. If not, recommend opening one first and wait for their decision. Only do this at the start of a task — once the work is done, do not suggest a ticket; the discussion belongs in the PR. Skip this entirely for maintainers (`git config user.name` matches an `<author>` in `appinfo/info.xml`).
14
+
13
15
**Always:**
14
16
- Add an `Assisted-by: AGENT_NAME:MODEL_VERSION` trailer to every AI-assisted commit.
15
17
- Disclose AI tool use in every PR description.
16
18
- Keep PRs focused on one concern; no unrelated files or incidental refactors.
17
19
- Verify dependencies exist in real package registries.
18
20
- Tell the contributor when an action would violate the policy/guidelines — name the rule and the alternative; never silently proceed.
19
21
- Warn before a PR grows too large (approaching several thousand lines) and suggest a split.
20
-
- Recommend a discussion ticket before complex changes (multiple subsystems, architectural decisions, unclear approach).
21
22
22
23
**Never:**
23
24
- Open issues, submit PRs, post review comments, or send security reports autonomously — a human submits every contribution.
@@ -92,6 +93,7 @@ From a 2026-06 tech-debt analysis. New code uses the modern pattern.
92
93
-**App config (admin):** write via `setAppConfig()` from `src/services/appConfigService.ts` (awaitable, handles password confirmation, throws). Don't use `OCP.AppConfig.setValue` — callback-only, not awaitable, swallows errors.
93
94
-**User config (preferences):** write via `setUserConfig()` from `src/services/settingsService.ts` (provisioning API `config/users/{appId}/{configKey}`, no password confirmation). Values are strings — never send raw booleans/numbers.
94
95
-**EventBus:**`src/services/EventBus.ts` (typed mitt) bridges the non-Vue signaling/call layer into Vue only — not for component-to-component UI coordination or store-to-store sync; register every new event in the `Events` type. `@nextcloud/event-bus` is only for cross-app server events.
96
+
-**Templates:** declare the result, don't compute it — no function calls in templates (event handlers excepted). The renderer decides when and how often templates run, so calls can cause uncontrolled side effects and block rendering. Bind to computed properties or reactive state instead, and load async/expensive data from watchers or event handlers.
95
97
-**Dialogs:** declarative `<NcDialog>` in the owning template is the target; `spawnDialog()` only without template context; `NcModal` is legacy.
-**Styling:** scoped styles with Nextcloud CSS vars (`var(--color-*)`, defined in `apps/theming/css/default.css`); hardcoded colors only for brand exceptions. Avoid new `:deep()` overrides of `@nextcloud/vue` internals — prefer props/slots or an upstream issue. Spacing/dimensions use the standard vars (`calc(x * var(--default-grid-baseline))`), no magic numbers. Follow the [string-writing rules](https://docs.nextcloud.com/server/latest/developer_manual/design/writing.html).
"{actor} set a password" : "{actor} تعيين كلمة مرور",
140
134
"You set a password" : "أنت قمت بتعيين كلمة مرور",
141
135
"An administrator set a password" : "تعيين كلمة مرور من قبل الإدارة",
@@ -788,6 +782,9 @@ OC.L10N.register(
788
782
"Total errors count" : "العدد الإجمالي للأخطاء",
789
783
"Find more bots" : "أعثُر على المزيد من الروبوتات",
790
784
"Could not save the setting" : "لم يٌمكن حفظ الإعدادات",
785
+
"End-to-end encrypted calls" : "محادثات مشفرة من الحدّ للحدّ",
786
+
"Enable encryption" : "تمكين التشفير",
787
+
"End-to-end encrypted calls with a configured SIP bridge require a newer version of the High-performance backend and SIP bridge." : "تتطلب المكالمات المشفرة من الحد للحد باستخدام جسر SIP مُهيّإٍ إصداراً أحدث من الواجهة الخلفية للأداء العالي وجسر SIP.",
791
788
"Beta" : "تجريبي",
792
789
"Federated chats and calls work already. Attachment handling is coming in a future version." : "المحادثات والمكالمات الاتحادية تعمل بالفعل. سيتم إضافة إمكانية التعامل مع المرفقات في إصدار مستقبلي.",
793
790
"Groups allowed to invite federated users" : "المجموعات التي يحق لها دعوة مستخدِمين من السحابة الموحدة",
@@ -801,10 +798,6 @@ OC.L10N.register(
801
798
"Integration into other apps" : "الربط مع تطبيقات آخرى",
802
799
"Allow conversations on files" : "السماح بالمحادثات على الملفات",
803
800
"Allow conversations on public shares for files" : "السماح للمحادثات عبر مشاركة الملفات العامة",
804
-
"End-to-end encrypted calls" : "محادثات مشفرة من الحدّ للحدّ",
805
-
"Enable encryption" : "تمكين التشفير",
806
-
"End-to-end encrypted calls with a configured SIP bridge require a newer version of the High-performance backend and SIP bridge." : "تتطلب المكالمات المشفرة من الحد للحد باستخدام جسر SIP مُهيّإٍ إصداراً أحدث من الواجهة الخلفية للأداء العالي وجسر SIP.",
807
-
"Mobile clients do not support end-to-end encrypted calls at the moment." : "الهواتف النقالة العميلة لا تدعم المكالمات المشفرة من الحد للحد في الوقت الحاضر.",
808
801
"By clicking the button above the information in the form is sent to the servers of Struktur AG. You can find further information at {linkstart}spreed.eu{linkend}." : "بالنقر فوق الزر أعلاه، يتم إرسال المعلومات الواردة في النموذج إلى خوادم شركة Struktur AG. يمكنك العثور على مزيد من المعلومات على {linkstart} spreed.eu {linkend}.",
809
802
"Pending" : "مُعلّق",
810
803
"Error" : "خطأ",
@@ -1506,8 +1499,8 @@ OC.L10N.register(
1506
1499
"bot" : "بوت",
1507
1500
"guest" : "ضيف",
1508
1501
"Call rejected" : "تمّ رفض المكالمة",
1509
-
"{time} talking time" : "{time} زمن المحادثة",
1510
1502
"Raised their hand" : "رفعوا أيديهم",
1503
+
"{time} talking time" : "{time} زمن المحادثة",
1511
1504
"Joined with video" : "انضم مع مشاركة بالفيديو",
1512
1505
"Joined via phone" : "انضم عبر الجوال ",
1513
1506
"Joined with audio" : "انضم مع مشاركة بالصوت ",
@@ -1641,7 +1634,6 @@ OC.L10N.register(
1641
1634
"Raise hand (R)" : "رفع اليد (r)",
1642
1635
"Lower hand" : "خفض اليد ",
1643
1636
"Lower hand (R)" : "خفض اليد (R)",
1644
-
"Send a reaction" : "إرسال تفاعل",
1645
1637
"React with {reaction}" : "تَفَاعَل مع {reaction}",
1646
1638
"All tasks done!" : "تمّ إنجاز جميع المهام!",
1647
1639
"_{done} of %n task_::_{done} of %n tasks_" : ["{done} من %n مهمة","{done} من %n مهمة","{done} من %n مهمة","{done} من %n مهام","{done} من %n مهمة","{done} من %n مهمة"],
"Running the High-performance backend \"conversation_cluster\" mode is deprecated and will no longer be supported in the upcoming version. The High-performance backend supports real clustering nowadays which should be used instead." : "وضع \"conversation_cluster\" في الواجهة الخلفية عالية الأداء صار قديمًا ولن يتم دعمه بعد الآن في الإصدارات القادمة. الواجهة الخلفية عالية الأداء تدعم التجميع الحقيقي real-clustering في الوقت الحالي والذي يجب استخدامه بدلاً من ذلك.",
@@ -1947,6 +1945,7 @@ OC.L10N.register(
1947
1945
"Only allow to federate with trusted servers" : "السماح فقط بالاتحاد مع الخوادم الموثوقة",
1948
1946
"When at least one group is selected, only people of the listed groups can invite federated users to conversations." : "عند تحديد مجموعة واحدة على الأقل، يمكن لأشخاص المجموعات المدرجة فقط دعوة المستخدِمين من السحابة الموحدة إلى المحادثة.",
1949
1947
"Select groups …" : "تحديد المجموعات ...",
1948
+
"Mobile clients do not support end-to-end encrypted calls at the moment." : "الهواتف النقالة العميلة لا تدعم المكالمات المشفرة من الحد للحد في الوقت الحاضر.",
0 commit comments