libnoa 0.1.1

AI-native distributed version control system with per-agent workspace isolation, JSONL append-only logs, snapshot-based history, and full git protocol compatibility
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

# دليل مساحات العمل

مساحات العمل هي سياقات عمل معزولة، مشابهة لفروع Git. لكل مساحة عمل لقطة رأس وسجل وكيل خاص بها.

## إنشاء مساحات العمل

```bash
noa workspace create feature-1
noa workspace create agent-debug --agent bot-42
```

علامة `--agent` تربط مساحة العمل بمعرف وكيل محدد.

## تبديل مساحات العمل

```bash
noa workspace switch feature-1
noa status
# On workspace: feature-1 (head: noa_abc123)
```

## عرض مساحات العمل

```bash
noa workspace list
#   default             head: noa_abc123 base: noa_empty
# * feature-1           head: noa_def456 base: noa_abc123
```

علامة `*` تشير إلى مساحة العمل النشطة.

## دمج مساحات العمل

```bash
noa workspace switch default
noa workspace merge feature-1
# Merged feature-1 into default -> noa_ghi789
```

إذا تم اكتشاف تعارضات:

```
Conflicts detected:
  CONFLICT: src/main.rs
Merged feature-1 into default -> noa_ghi789
```

استراتيجية الحل الافتراضية هي upstream-wins (theirs). ستدعم الإصدارات المستقبلية حل التعارضات اليدوي.

## حذف مساحات العمل

```bash
noa workspace delete feature-1
# Deleted workspace 'feature-1'
```

لا يمكنك حذف مساحة العمل النشطة.

## نمط سير العمل

```mermaid
flowchart TD
    S1["1. noa workspace create feature-1"]
    S2["2. noa workspace switch feature-1"]
    S3["3. (الوكيل يكتب ملفات وينشئ لقطات)"]
    S4["4. noa workspace switch default"]
    S5["5. noa workspace merge feature-1"]
    S6["6. noa workspace delete feature-1"]
    S1 --> S2 --> S3 --> S4 --> S5 --> S6
```

## نمط تعدد الوكلاء

يحصل كل وكيل على مساحة عمل خاصة به:

```mermaid
graph TD
    A1["Agent-001"] --> W1["workspace agent-001<br/>agent-logs/agent-001.log"]
    A2["Agent-002"] --> W2["workspace agent-002<br/>agent-logs/agent-002.log"]
    AN["Agent-N"] --> WN["workspace agent-N<br/>agent-logs/agent-N.log"]
```

لكل مساحة عمل سجل وكيل مستقل (`.noa/agent-logs/agent-001.log`)، مما يتيح كتابة متزامنة بدون أقفال. خطوة التوحيد تدمج جميع السجلات حسب الطابع الزمني لإنشاء تاريخ موحد.

> **ملاحظة**: يستخدم redb قفل ملف حصري، لذا لا يمكن لعدة عمليات CLI فتح نفس قاعدة البيانات بشكل متزامن. للتزامن الحقيقي متعدد العمليات، استخدم noa-server HTTP API.