@rsconcept/rstool 1.4.1 → 1.4.2
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.
package/examples/README.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
Полные исполняемые сценарии поверх `RSToolWrapperClient` (stdio-обёртка) и готовые JSON-сессии для импорта. Короткие фрагменты кода для агентов — в [`../skills/rstool-helper/EXAMPLES.md`](../skills/rstool-helper/EXAMPLES.md); воркфлоу — [`../skills/rstool-helper/GUIDE.md`](../skills/rstool-helper/GUIDE.md).
|
|
4
4
|
|
|
5
|
+
**Агентам:** не добавляйте сюда разовые `build-*.ts` и папки по текущей задаче пользователя. Артефакты и скрипты — вне `rsconcept/rstool/` (см. «Границы правок» в GUIDE). В `examples/` — только сопровождаемые демо пакета.
|
|
6
|
+
|
|
5
7
|
## Как запускать
|
|
6
8
|
|
|
7
9
|
После `npm install @rsconcept/rstool` (нужен `tsx` или аналог):
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@rsconcept/rstool",
|
|
3
|
-
"version": "1.4.
|
|
3
|
+
"version": "1.4.2",
|
|
4
4
|
"description": "Agent-facing library for incremental RSForm construction, RSLang analysis, diagnostics, modeling, and evaluation. Wraps @rsconcept/domain with a deterministic session contract.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "IRBorisov",
|
|
@@ -20,6 +20,27 @@
|
|
|
20
20
|
- Модель: `setModelValues`, `evaluate`, `recalculateModel`.
|
|
21
21
|
- Перед сохранением сомнительной формулы — `analyzeExpression`.
|
|
22
22
|
|
|
23
|
+
## Границы правок: не трогай пакет rstool без запроса
|
|
24
|
+
|
|
25
|
+
Задача по КС, Portal или источнику пользователя **не означает** правку дерева `rsconcept/rstool/`.
|
|
26
|
+
Пакет — библиотека и справочник; каталог `examples/` — **штатные** демо пакета, а не место для разовых скриптов агента.
|
|
27
|
+
|
|
28
|
+
Правки в rstool уместны только если пользователь **явно** просит, например:
|
|
29
|
+
|
|
30
|
+
- доработать API, stdio, контракт, тесты rstool;
|
|
31
|
+
- добавить **общий** пример в пакет;
|
|
32
|
+
- обновить skill/docs rstool (в т.ч. это руководство).
|
|
33
|
+
|
|
34
|
+
### Как запускать rstool, не кладя скрипт в пакет
|
|
35
|
+
|
|
36
|
+
Из корня workspace Portal (после `pnpm install` и сборки `@rsconcept/domain`):
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
pnpm --filter @rsconcept/rstool exec tsx path/to/your/build-schema.ts
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
В скрипте импортируй API пакета (`@rsconcept/rstool` или относительный путь к `rsconcept/rstool/src` только если скрипт лежит вне пакета и это осознанный выбор). Либо используй stdio/MCP без отдельного файла.
|
|
43
|
+
|
|
23
44
|
## Что читать
|
|
24
45
|
|
|
25
46
|
Пути — относительно этого файла.
|
|
@@ -26,6 +26,10 @@ description: >-
|
|
|
26
26
|
|
|
27
27
|
Перед началом задачи rstool всегда открывай **GUIDE.md**, затем по необходимости **REFERENCE.md** / **EXAMPLES.md** / нужные `docs/*.md`.
|
|
28
28
|
|
|
29
|
+
## Не правь пакет rstool без запроса
|
|
30
|
+
|
|
31
|
+
Разовые скрипты и JSON для Portal — вне дерева пакета (каталог задачи, `.tmp/`, путь пользователя). См. **«Границы правок»** в GUIDE.md.
|
|
32
|
+
|
|
29
33
|
## Язык ответа пользователю
|
|
30
34
|
|
|
31
35
|
В тексте для пользователя используй термины предметной области («формальное определение», «конституента», «диагностики»), а не английские имена полей и методов API (`definitionFormal`, `applySchemaPatch`). Идентификаторы API — только в коде, patch-ах и JSON. Словарь API → текст: раздел «Язык ответа» в GUIDE.md. Термины КС (базовые понятия, базисное множество, ядро) — только из `docs/DOMAIN.md`, раздел **«Термины: не путать»**.
|