@lotics/cli 0.312.8 → 0.312.9

package/docs/design.md

@@ -259,38 +259,36 @@ catalog: one line per kind, the ones not yet filled standing empty, filled in pl
 to the record's own multi-select of those it needs. The papers a case gathers, the fees a record knows it
 owes. Worked: `examples/case`.
 
+`only` lists the kinds a block holds a line for, so each kind stands in the section whose job it is, once. The act making a paper (`paper: "<child>.<kind>"`) is its line's button while it applies, the upload in the ⋯.
+
 #### Templates
 
 A paper the business makes is an act's `template`, kept in the record's files field `into` — or several at
-once, `templates`: listed where the act stands, each made one as its file and each not yet made as a
-placeholder, the reader ticking which to make. A template no act names is made by nothing. Worked: `examples/case`.
+once, `templates`: listed where the act stands, each made one as its file, each not yet made a placeholder,
+the reader ticking which to make. Worked: `examples/case`.
 
 #### Intake
 
 A paper the business is brought and reads is an act's `intake`: the press takes the papers, an agent reads
 them, and each is filed as the line of its kind in the child the record `expect`s, while `fills` writes what
-they state into the record's fields — a single link as a row the agent finds among those the app reads of its
-entity — shown before it is saved. Worked: `examples/case`.
+they state into the record's fields — a single link as a row the agent finds among those the app reads — shown before it is saved. Worked: `examples/case`.
 
-An agent act — an `intake`, a `record`'s `fills` — spends a run on every press and writes what the record
-says, so it is stated only where the owner asked for an agent to do that job; otherwise a paper brought is its
-line of the `expect` block, and a person types what it states.
+An agent act — an `intake`, a `record`'s `fills` — spends a run on every press, so it is stated only where the
+owner asked for an agent to do that job; otherwise a paper brought is its `expect` line, and a person types what it states.
 
 #### Under
 
 A rows block with `under`: the documents that cover lines (an invoice over its fee lines) stand as headings
-over the lines they cover, and a line no document covers offers to make one. A document entered as it arrives,
-over lines already on file (a supplier bill), picks them from its own record instead: a rows block with `pick`.
-Choose one per document: a document a make covers lines by is never also picked into, since a pick does not check
-what the make does.
+over the lines they cover, and a line no document covers offers to make one. A document entered as it arrives over lines
+already on file (a supplier bill) picks them with `pick` instead; choose one per document.
 
 ### Calls
 
 #### Record act
 
-An act's `record`: the press records a call, visit or meeting — its audio, its transcript, its screen where
-captured — and files it as a new row of the record's `timeline` child (`into`), stamped `at` and `by`;
-`fills` lets an agent fill that row's fields from the transcript, where the owner asked for one. Worked: `examples/calls`.
+An act's `record`: the press records a call, visit or meeting — audio, transcript, screen where captured — and
+files it as a new row of the record's `timeline` child (`into`), stamped `at` and `by`; `fills` lets an agent fill
+that row's fields from the transcript, where the owner asked. Worked: `examples/calls`.
 
 ## The visual bar
 

package/docs/examples.md

@@ -57,7 +57,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "visits",
       "name": "Service visits",
-      "description": "Engineers' visits to customers on site, booked and completed by the day.",
       "icon": "calendar",
       "entity": "service_visit",
       "register": {
@@ -149,7 +148,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "dispatch",
       "name": "Dispatch",
-      "description": "Each engineer's visits across the day, and the free time between them to book into.",
       "icon": "wrench",
       "entity": "service_visit",
       "register": {
@@ -229,7 +227,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "tien_do_thue",
       "name": "Tiến độ cho thuê",
-      "description": "Mỗi phiếu thuê một thanh từ ngày giao máy đến hạn trả, đọc theo hôm nay: phiếu nào sắp đến hạn, phiếu nào quá hạn; kéo thanh để dời ngày giao hoặc gia hạn trả, và nhận máy về khi khách trả.",
       "icon": "calendar-range",
       "theme": {"color": "teal"},
       "entity": "phieu_thue",
@@ -328,7 +325,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "lich_truc",
       "name": "Lịch trực",
-      "description": "Ai trực ca nào, ở ghế nào, trong tuần và trong tháng.",
       "icon": "users",
       "entity": "nha_si",
       "register": {
@@ -420,7 +416,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "stock",
       "name": "Stock",
-      "description": "What the store holds of each item, against its shelf and its minimum.",
       "icon": "boxes",
       "theme": {"color": "teal"},
       "entity": "stock_item",
@@ -587,7 +582,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "customers",
       "name": "Customers",
-      "description": "Who we sell to, what they owe, and what was said.",
       "icon": "users",
       "theme": {"color": "violet"},
       "entity": "customer",
@@ -823,6 +817,28 @@ Every key: the `model` reference, at the pages each section names under **Keys**
         {"alias": "thu_nhap", "type": "number", "notation": {"style": "currency", "currency": "VND"}}
       ]
     },
+    {
+      "alias": "giay_to",
+      "fields": [
+        {
+          "alias": "loai",
+          "type": "select",
+          "options": [
+            {"alias": "don_dang_ky", "color": "blue"},
+            {"alias": "can_cuoc", "color": "sky"},
+            {"alias": "giay_doi_tuong", "color": "violet"},
+            {"alias": "xac_nhan_nha_o", "color": "teal"},
+            {"alias": "xac_nhan_thu_nhap", "color": "amber"},
+            {"alias": "hon_nhan", "color": "indigo"}
+          ]
+        },
+        {"alias": "ho_so", "type": "select_record_link", "target_entity": "ho_so", "cardinality": "one"},
+        {"alias": "ngay_nhan", "type": "date"},
+        {"alias": "can_sua", "type": "text"},
+        {"alias": "tep", "type": "files"},
+        {"alias": "phai_sua", "type": "formula"}
+      ]
+    },
     {
       "alias": "phieu_thu",
       "fields": [
@@ -858,28 +874,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
         {"alias": "nguoi_thu", "type": "select_member"},
         {"alias": "da_chot", "type": "formula"}
       ]
-    },
-    {
-      "alias": "giay_to",
-      "fields": [
-        {
-          "alias": "loai",
-          "type": "select",
-          "options": [
-            {"alias": "don_dang_ky", "color": "blue"},
-            {"alias": "can_cuoc", "color": "sky"},
-            {"alias": "giay_doi_tuong", "color": "violet"},
-            {"alias": "xac_nhan_nha_o", "color": "teal"},
-            {"alias": "xac_nhan_thu_nhap", "color": "amber"},
-            {"alias": "hon_nhan", "color": "indigo"}
-          ]
-        },
-        {"alias": "ho_so", "type": "select_record_link", "target_entity": "ho_so", "cardinality": "one"},
-        {"alias": "ngay_nhan", "type": "date"},
-        {"alias": "can_sua", "type": "text"},
-        {"alias": "tep", "type": "files"},
-        {"alias": "phai_sua", "type": "formula"}
-      ]
     }
   ],
   "records": {
@@ -903,13 +897,13 @@ Every key: the `model` reference, at the pages each section names under **Keys**
       "figure": "phi_dich_vu"
     },
     "thanh_vien": {"title": "ho_ten", "subtitle": ["quan_he", "cccd"], "party": "person", "figure": "thu_nhap"},
+    "giay_to": {"title": "loai", "image": "tep", "starts": {"ngay_nhan": "today"}},
     "phieu_thu": {
       "title": "khoan",
       "subtitle": ["hinh_thuc", "ngay_thu"],
       "status": {"field": "trang_thai", "closed": ["da_thu", "huy"]},
       "figure": "so_tien"
-    },
-    "giay_to": {"title": "loai", "image": "tep", "starts": {"ngay_nhan": "today"}}
+    }
   },
   "templates": [
     {"alias": "don_dang_ky", "type": "html", "label": "Đơn đăng ký mua nhà ở xã hội"},
@@ -922,7 +916,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "ho_so",
       "name": "Hồ sơ nhà ở xã hội",
-      "description": "Bàn làm hồ sơ của từng dự án: nhận giấy tờ, lập và nộp hồ sơ cho chủ đầu tư, theo từng khâu duyệt tới bốc thăm và ký hợp đồng — hoặc làm hồ sơ rồi bàn giao cho khách tự nộp.",
       "icon": "folder-open",
       "theme": {"color": "blue"},
       "entity": "ho_so",
@@ -961,6 +954,13 @@ Every key: the `model` reference, at the pages each section names under **Keys**
                 "title": "Hộ gia đình",
                 "columns": ["ngay_sinh"],
                 "create": ["ho_ten", "quan_he", "ngay_sinh", "cccd", "thu_nhap"]
+              },
+              {
+                "rows": "giay_to",
+                "title": "Giấy tờ cá nhân",
+                "columns": ["ngay_nhan"],
+                "expect": "loai",
+                "only": ["can_cuoc", "hon_nhan"]
               }
             ],
             "acts": ["doc_giay_to", "giao_xu_ly", "chuyen_du_an"]
@@ -1002,19 +1002,18 @@ Every key: the `model` reference, at the pages each section names under **Keys**
                 "title": "Giấy tờ",
                 "columns": ["ngay_nhan"],
                 "create": ["loai", "ngay_nhan", "can_sua", "tep"],
-                "expect": "loai"
+                "expect": "loai",
+                "only": ["don_dang_ky", "giay_doi_tuong", "xac_nhan_nha_o", "xac_nhan_thu_nhap"]
               }
             ]
           },
           {
             "title": "Bộ hồ sơ",
-            "description": "Các mẫu đơn in từ thông tin của hồ sơ.",
             "at": ["ngay_nhan_giay_to", "ngay_lap_ho_so"],
             "acts": ["tao_giay_to", "nop_cdt"]
           },
           {
             "title": "Chủ đầu tư",
-            "description": "Hồ sơ trọn gói nộp chủ đầu tư, chờ chủ đầu tư rồi Sở Xây dựng duyệt trước ngày bốc thăm.",
             "at": ["ngay_nop_cdt", "ngay_cdt_duyet", "ngay_so_xd_duyet"],
             "fields": ["loai_can"],
             "when": {"dich_vu": ["tron_goi"]}
@@ -1323,7 +1322,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "khach_tiem_nang",
       "name": "Khách tiềm năng",
-      "description": "Mọi người mình có thể bán dịch vụ, từ tín hiệu đầu tiên đến khi chuyển vào CRM: mở một khách để đọc vì sao nên gọi lúc này, liên hệ ngay, ghi lại lần chạm, xếp bước tiếp theo, và chuyển đổi khi đã có cuộc trò chuyện.",
       "icon": "radar",
       "theme": {"color": "violet"},
       "entity": "khach_tiem_nang",
@@ -1373,18 +1371,11 @@ Every key: the `model` reference, at the pages each section names under **Keys**
           },
           {
             "title": "Chuyển đổi",
-            "description": "Khách đã trả lời và muốn đi tiếp: chuyển đổi tạo liên hệ và công ty trong sổ khách hàng.",
             "at": ["da_lien_he"],
             "fields": ["nguon", "lien_he", "cong_ty"],
             "acts": ["chuyen_doi"]
           },
-          {
-            "title": "Loại",
-            "description": "Khách không đi tiếp: ghi lý do để lần sau không tìm lại.",
-            "at": ["loai"],
-            "fields": ["ly_do_loai"],
-            "acts": ["loai"]
-          }
+          {"title": "Loại", "at": ["loai"], "fields": ["ly_do_loai"], "acts": ["loai"]}
         ]
       },
       "acts": [
@@ -1533,7 +1524,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "de_nghi_chi",
       "name": "Đề nghị thanh toán",
-      "description": "Chỉ huy trưởng lập đề nghị chi cho dự án của mình, kèm chứng từ, rồi gửi giám đốc duyệt.",
       "icon": "hand-coins",
       "theme": {"color": "amber"},
       "entity": "de_nghi",
@@ -1693,7 +1683,6 @@ Every key: the `model` reference, at the pages each section names under **Keys**
     {
       "alias": "dong_tien",
       "name": "Dòng tiền",
-      "description": "Giám đốc xem trong kỳ: tiền vào, tiền ra, dòng tiền ròng qua các kỳ, chi vào đâu, thu từ ai, và những dòng sao kê còn chưa khớp.",
       "icon": "chart-line",
       "theme": {"color": "emerald"},
       "dashboard": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.312.8",
+  "version": "0.312.9",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {