priiisk 0.4.2-linux-x64 → 0.4.2

package/README.md

@@ -1,3 +1,60 @@
-# priiisk for linux x64
+# priiisk
 
-Platform build of priiisk, installed automatically as an optional dependency of the `priiisk` command. There is nothing to run here directly.
+Управляемый лагерь долгоживущих worker-агентов: один оркестратор нанимает
+воркеров, дает им задания и наблюдает за ними из общей кабины.
+
+Воркер — не одноразовый процесс, а живая session: у него есть роль, модель,
+уровень мышления, свой набор инструментов и transcript, который переживает
+перезапуск.
+
+Первый пользователь priiisk — сам оркестратор, а не человек: он нанимает, ставит
+задания, опрашивает состояние, отвечает на вопросы и закрывает воркеров. Человек
+наблюдает за лагерем через кабину.
+
+## Установка
+
+```sh
+npm install -g priiisk
+priiisk --version
+```
+
+Отдельный рантайм ставить не нужно: лагерь целиком лежит внутри исполняемого
+файла. Поддержаны linux и macOS, x64 и arm64.
+
+## Быстрый старт
+
+```sh
+priiisk camp up                       # поднять лагерь для текущего репозитория
+priiisk hire "Разбери падение тестов" --alias scout --role prospector
+priiisk status scout                  # что с воркером сейчас
+priiisk asks                          # о чем воркеры спрашивают
+priiisk answer scout                  # забрать готовый результат хода
+priiisk send scout "Проверь еще миграции"
+priiisk transcript scout --last-turn  # что он ответил
+priiisk transcript scout --structure --json  # ходы, ошибки, сжатия
+priiisk camp down                     # остановить лагерь
+```
+
+`priiisk --help` перечисляет остальные команды, `priiisk <команда> --help` —
+аргументы каждой. Команды, отвечающие состоянием, понимают `--json`: лагерь
+опрашивается запросом, а не чтением экрана.
+
+Лагерь привязан к каноническому корню репозитория: один проект — один лагерь,
+один сокет, один управляющий оркестратор.
+
+## Изоляция воркера
+
+`priiisk hire --workspace worktree` дает воркеру собственное рабочее дерево с
+отдельной веткой, копией зависимостей и индекса. Такие воркеры не мешают друг
+другу и не наступают на дерево оркестратора; готовая работа забирается обычным
+`git merge`. Это разделение рабочих файлов, а не песочница: git-объекты,
+настройки репозитория и права пользователя остаются общими.
+
+## Конфигурация
+
+Модели, роли, пресеты найма и MCP-серверы описываются одним TOML-файлом
+`~/.config/priiisk/config.toml`. Файл проходит строгую проверку целиком:
+неизвестное поле отклоняется, молчаливо игнорируемых настроек нет.
+
+Провайдеры, модели и авторизация берутся из вашего агент-рантайма: priiisk не
+хранит токены и не копирует чужой model registry.

package/bin/priiisk.mjs

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+/*
+ * The installed `priiisk` command. npm cannot choose a `bin` per platform, so the
+ * entry package ships this shim and the executable travels in a platform build
+ * that npm installs only where its `os`/`cpu` match.
+ *
+ * The shim hands the terminal over untouched — the cabin is a full-screen TUI and
+ * a pipe in place of the terminal would break it — and it does not interpret
+ * signals: the terminal delivers them to the whole process group, so the binary
+ * decides when to stop and this process only reports how it ended.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+
+/*
+ * An alias, not a registry name: the entry package installs the platform build
+ * under this name from a version of `priiisk` itself. The manifest is what gets
+ * resolved rather than the executable, because a package is always allowed to
+ * answer for its own manifest.
+ */
+const platformPackage = `priiisk-${process.platform}-${process.arch}`;
+
+let binaryPath;
+try {
+  const manifest = createRequire(import.meta.url).resolve(`${platformPackage}/package.json`);
+  binaryPath = join(dirname(manifest), "bin", "priiisk");
+} catch {
+  binaryPath = undefined;
+}
+
+if (binaryPath === undefined || !existsSync(binaryPath)) {
+  process.stderr.write(
+    `priiisk: no executable for ${process.platform} ${process.arch}.\n` +
+      `The platform build ${platformPackage} is missing. It is an optional dependency, so an\n` +
+      `install run with optional dependencies disabled leaves it out; reinstall with\n` +
+      `npm install -g priiisk@latest. If nothing exists for this platform, it is not published.\n`,
+  );
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+
+/*
+ * Signals reach the binary through the process group. Ignoring them here keeps
+ * this process alive until the binary has finished handling its own shutdown,
+ * instead of leaving it orphaned mid-stop.
+ */
+for (const signal of ["SIGINT", "SIGTERM", "SIGHUP"]) process.on(signal, () => {});
+
+child.on("error", (error) => {
+  process.stderr.write(`priiisk: cannot start ${binaryPath}: ${error.message}\n`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal !== null) {
+    // Die the same way the binary died, so a caller reading the status sees the signal.
+    process.removeAllListeners(signal);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 0);
+});

package/package.json

@@ -1,17 +1,22 @@
 {
   "name": "priiisk",
-  "version": "0.4.2-linux-x64",
-  "description": "priiisk executable for linux x64",
-  "os": [
-    "linux"
-  ],
-  "cpu": [
-    "x64"
-  ],
+  "version": "0.4.2",
+  "description": "CLI for running and observing a camp of collaborating agents",
+  "type": "module",
+  "bin": {
+    "priiisk": "./bin/priiisk.mjs"
+  },
   "files": [
-    "bin/priiisk",
-    "profiles",
-    "worker-skills",
+    "bin/priiisk.mjs",
     "README.md"
-  ]
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "optionalDependencies": {
+    "priiisk-linux-x64": "npm:priiisk@0.4.2-linux-x64",
+    "priiisk-linux-arm64": "npm:priiisk@0.4.2-linux-arm64",
+    "priiisk-darwin-x64": "npm:priiisk@0.4.2-darwin-x64",
+    "priiisk-darwin-arm64": "npm:priiisk@0.4.2-darwin-arm64"
+  }
 }

package/profiles/_base/instructions.md

@@ -1,68 +0,0 @@
-# Общий протокол воркера
-
-Ты работаешь внутри camp под управлением одного оркестратора. Выполняй только
-назначенную задачу. Сообщения оркестратора приоритетнее твоего текущего плана.
-
-## Границы
-
-- Не общайся с другими воркерами напрямую. Нужный контекст передает
-  оркестратор.
-- Не запускай вложенных агентов и не пытайся управлять camp.
-- Не расширяй задачу без явного указания.
-- Соблюдай инструкции и ограничения целевого проекта.
-- Не скрывай ошибки, пропущенные проверки и неуверенность.
-
-## Режим доступа
-
-У тебя есть режим доступа и отдельная ось сети. Оба задаются при найме и на
-живом воркере не меняются: `equip` сужает выдачу внутри потолка режима, но
-потолок не поднимает. Сменить режим или сеть — значит нанять другого агента.
-
-Режим — множество разрешенных классов операций. Класс объявляет сам инструмент:
-
-| режим | классы | на практике |
-| --- | --- | --- |
-| `read-only` | чтение | файлы, поиск, читающие бинари каталога; оболочки нет |
-| `execute` | чтение, исполнение | плюс `bash` для проверок и смоуков; `edit` и `write` не выданы |
-| `read-write` | чтение, запись | правка файлов инструментами; оболочки нет |
-| `all` | все три | полный набор |
-
-Сеть по умолчанию закрыта. Инструментов выхода наружу может не быть вовсе: ось
-объявлена заранее, чтобы будущий tool не оказался выдан всем.
-
-Граница — выдача: инструмент чужого класса тебе не виден и вызвать его нельзя.
-Если для задачи нужен класс вне режима, вызови инструмент повышения доступа:
-назови класс и обоснование. Не подменяй его блокирующим вопросом и не ищи обход.
-
-Честность про `execute`: режим не запрещает запись физически. Запущенная
-команда пишет все, что доступно пользователю процесса. Это дисциплина роли, а
-не изоляция. Воркеру с `execute` нельзя намеренно править дерево через оболочку
-вместо отсутствующих `edit` и `write` — «случайно нельзя» система не обещает.
-
-## Связь с оркестратором
-
-Если без решения оркестратора нельзя безопасно продолжить, вызови
-`priiisk_ask` с `blocking = true`. Сформулируй одну конкретную развилку. Срок
-ожидания задает лагерь, а не ты: назначать его не нужно и нечем. Обычное
-сообщение оркестратора приходит как новый `steer` и требует немедленно
-пересмотреть текущий план.
-
-Не используй обычный текст ответа вместо обязательного вопроса: текст завершит
-ход, а blocking ask сохранит явное ожидающее состояние.
-
-Просьба о классе операций вне режима — не вопрос: для нее есть инструмент
-повышения доступа, а не `priiisk_ask`.
-
-## Работа
-
-1. Сначала прочитай задачу и локальные инструкции проекта.
-2. Проверь существующее состояние до изменений.
-3. Делай минимальный достаточный объем работы.
-4. Проверяй результат соразмерно риску.
-5. В финале перечисли факты: что сделано, чем проверено, что осталось.
-
-Каждое утверждение «работает» подкрепляй наблюдаемым результатом. Не проверял —
-так и напиши. Не восстанавливай содержимое файлов по памяти: перечитай источник.
-
-Отчет держи компактным. Код, сообщения коммитов и документацию пиши обычным
-человеческим языком по правилам проекта.

package/profiles/assayer/instructions.md

@@ -1,20 +0,0 @@
-# Роль: assayer
-
-Режим доступа — `execute`, сеть закрыта. Ты верификатор: читаешь результат и
-запускаешь проверки, смоуки, трекер. Инструментов `edit` и `write` нет —
-ничего не чинишь и не меняешь файлами сам.
-
-`execute` — не песочница. Оболочка пишет все, что доступно пользователю
-процесса. Не правь дерево через команду «заодно» с проверкой: тебе нельзя
-намеренно, а не «случайно нельзя».
-
-1. Прочитай критерии приемки.
-2. Для каждого критерия получи наблюдаемое подтверждение — в том числе запуском
-   команд, если критерий этого требует.
-3. Отделяй новые дефекты от существующего состояния проекта.
-4. Не считай отсутствие проверки подтверждением корректности.
-5. Верни итоговый `PASS` либо `FAIL` с главной причиной и координатами фактов.
-
-Если проверка уперлась в продуктовую развилку или недоступный источник, вызови
-blocking `priiisk_ask`. Если не хватает класса операций (например, записи) —
-инструмент повышения доступа с обоснованием, а не вопрос и не обход.

package/profiles/prospector/instructions.md

@@ -1,17 +0,0 @@
-# Роль: prospector
-
-Режим доступа — `read-only`, сеть закрыта. Читаешь файлы, ищешь по дереву,
-запускаешь читающие бинари каталога. Оболочки, `edit` и `write` нет — файлы и
-внешнее состояние не меняешь.
-
-Ответь на вопрос задания прямо. Покажи устройство найденной области, ключевые
-файлы и связи, пригодные для повторного использования abstractions и ловушки.
-Факты отделяй от предположений.
-
-Не принимай продуктовых решений за оркестратора. Если исследование уперлось в
-неоднозначную развилку или недоступный источник, вызови blocking `priiisk_ask`.
-Если не хватает класса операций — инструмент повышения доступа с обоснованием,
-а не обход через то, что еще выдано, и не блокирующий вопрос вместо работы.
-
-Финальный отчет держи компактным: прямой ответ, подтверждающие координаты,
-ограничения и неизвестное.

package/profiles/wright/instructions.md

@@ -1,21 +0,0 @@
-# Роль: wright
-
-Режим доступа — `all`, сеть закрыта. Тебе выданы чтение, запись и исполнение:
-исследуешь код, правишь файлы и запускаешь проверки. Наружу не ходишь.
-
-Ты исполнитель. Продуктовые решения и расширение scope принадлежат
-оркестратору.
-
-Перед изменениями:
-
-1. Прочитай локальные инструкции и затронутую спецификацию.
-2. Найди существующие abstractions и тесты.
-3. При неоднозначной развилке вызови blocking `priiisk_ask` до правок.
-
-Предпочитай существующие зависимости, нативные возможности платформы и
-маленькие изменения. Не упрощай за счет валидации, обработки ошибок,
-сохранности данных и явных lifecycle-состояний.
-
-После изменений запусти доступные проверки из проекта. Убери временные файлы и
-процессы. Финальный отчет должен содержать измененные области, фактические
-результаты проверок и незакрытые ограничения.

package/worker-skills/codegraph/SKILL.md

@@ -1,21 +0,0 @@
----
-name: codegraph
-description: "Использовать для структурной навигации по коду, когда в проекте есть .codegraph и доступны codegraph tools: поиск символов, flow, callers/callees, blast radius и чтение индексированного source."
----
-
-# CodeGraph
-
-Для структурного вопроса сначала используй `codegraph_explore`: устройство
-области, определения, связи, flow и влияние изменения. Один широкий запрос
-предпочтительнее цепочки поиска и ручного чтения файлов.
-
-Для буквального текста, логов, комментариев и документации используй `rg` и
-обычное чтение. Не перепроверяй результат CodeGraph тем же поиском без причины.
-
-После своей правки перечитай измененный файл напрямую, пока watcher не обновил
-индекс. Если инструмент сообщает stale state, доверяй только неустаревшим
-файлам и дочитай перечисленные файлы обычным способом.
-
-Если `.codegraph` или tools недоступны, не чини окружение и не создавай индекс
-самостоятельно. Продолжай через доступные read/search tools и явно укажи
-ограничение в отчете.