@pachca/cli 2026.5.0 → 2026.5.2

package/dist/data/workflows.json

@@ -522,6 +522,22 @@
             }
         ]
     },
+    {
+        "title": "Создать гостя в чат",
+        "skill": "pachca-users",
+        "steps": [
+            {
+                "description": "Выбери активный чат, в который добавить гостя — узнай его ID",
+                "command": "pachca chats list",
+                "notes": "Чат должен быть активным (не архивным) и принадлежать вашей компании. У токена должно быть право добавлять в него участников."
+            },
+            {
+                "description": "Создай гостя: роль `guest` и ровно один чат в `--chat-ids`",
+                "command": "pachca users create --email=\"guest@example.com\" --role=guest --chat-ids='[12345]'",
+                "notes": "Для роли `guest` `chat_ids` обязателен и должен содержать ровно один чат. Нарушение (не передан, пусто, больше одного, чат не существует, архивный или нет прав) → `400` с элементом `errors`, где `key` — `chat_ids`."
+            }
+        ]
+    },
     {
         "title": "Найти сотрудника по имени или email",
         "skill": "pachca-users",

package/dist/lib/manifest.js

@@ -0,0 +1,72 @@
+/**
+ * D2 — single oclif.manifest.json parsing/normalization logic.
+ *
+ * Used by both the `introspect` command (runtime) and the build-time
+ * commands.json emitter (scripts/emit-commands.ts) that feeds the docs
+ * Commands page. One source of data (oclif.manifest.json), one parsing
+ * logic — no second implementation in the docs component.
+ */
+/** `pachca introspect` (no arg) — list every command with metadata. */
+export function listCommandEntries(commands) {
+    return Object.entries(commands).map(([id, meta]) => ({
+        command: `pachca ${id.replace(/:/g, ' ')}`,
+        summary: (meta.summary || meta.description || ''),
+        method: (meta.apiMethod || null),
+        path: (meta.apiPath || null),
+        scope: (meta.scope || null),
+        plan: (meta.plan || null),
+    }));
+}
+/** `pachca introspect <command>` — full metadata for one command. */
+export function normalizeCommand(commandId, cmdMeta, baseFlagNames) {
+    const requiredFlagNames = new Set(cmdMeta.requiredFlags || []);
+    const flagsMeta = cmdMeta.flags;
+    const flags = flagsMeta
+        ? Object.entries(flagsMeta)
+            .filter(([name]) => !baseFlagNames.has(name))
+            .map(([name, meta]) => ({
+            name,
+            type: (meta.type || 'string'),
+            required: requiredFlagNames.has(name),
+            description: (meta.description || ''),
+            ...(meta.options ? { options: meta.options } : {}),
+            ...(meta.maxLength ? { maxLength: meta.maxLength } : {}),
+        }))
+        : [];
+    const argsMeta = cmdMeta.args;
+    const args = argsMeta
+        ? Object.entries(argsMeta).map(([name, meta]) => ({
+            name,
+            required: (meta.required || false),
+            description: (meta.description || ''),
+        }))
+        : [];
+    return {
+        command: `pachca ${commandId.replace(/:/g, ' ')}`,
+        summary: (cmdMeta.summary || cmdMeta.description || ''),
+        method: (cmdMeta.apiMethod || null),
+        path: (cmdMeta.apiPath || null),
+        scope: (cmdMeta.scope || null),
+        plan: (cmdMeta.plan || null),
+        ...(args.length > 0 ? { args } : {}),
+        flags,
+    };
+}
+/**
+ * Group every command by its topic/section (the part before the first ':',
+ * e.g. "messages:create" → "messages"; "doctor" → "doctor"). Used by the
+ * build-time emitter for the docs Commands page.
+ */
+export function groupCommandsBySection(commands, baseFlagNames) {
+    const bySection = new Map();
+    for (const [id, meta] of Object.entries(commands)) {
+        const section = id.includes(':') ? id.split(':')[0] : id;
+        const normalized = normalizeCommand(id, meta, baseFlagNames);
+        if (!bySection.has(section))
+            bySection.set(section, []);
+        bySection.get(section).push(normalized);
+    }
+    return [...bySection.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([section, cmds]) => ({ section, commands: cmds }));
+}

package/dist/output.js

@@ -7,6 +7,11 @@ import { stringify as yamlStringify } from 'yaml';
 export function outputData(data, opts) {
     if (opts.quiet)
         return;
+    // C7 — named plain mode (additive; existing formats untouched).
+    if (opts.plain) {
+        outputPlain(data, opts);
+        return;
+    }
     const format = opts.format;
     if (format === 'json') {
         outputJson(data);
@@ -49,6 +54,32 @@ function outputCsv(data, opts) {
         process.stdout.write(row.join(',') + '\n');
     }
 }
+/**
+ * C7 — plain mode. Variant of outputCsv for scripts: TSV, no header,
+ * `id` column first (if present), no color, no truncation. Same column
+ * selection as csv/table (OutputOptions.columns). Tabs/newlines inside
+ * values are collapsed to spaces so every record stays on one line
+ * (safe for cut/awk).
+ */
+function outputPlain(data, opts) {
+    const items = Array.isArray(data) ? data : [data];
+    if (items.length === 0)
+        return;
+    let columns = opts.columns || Object.keys(items[0]);
+    if (!opts.columns && columns.includes('id')) {
+        columns = ['id', ...columns.filter((c) => c !== 'id')];
+    }
+    for (const item of items) {
+        const row = columns.map((col) => {
+            const val = item[col];
+            if (val == null)
+                return '';
+            const str = typeof val === 'object' ? JSON.stringify(val) : String(val);
+            return str.replace(/[\t\n\r]+/g, ' ');
+        });
+        process.stdout.write(row.join('\t') + '\n');
+    }
+}
 function outputTable(data, opts) {
     const items = Array.isArray(data) ? data : [data];
     if (items.length === 0) {

package/dist/profiles.js

@@ -4,6 +4,12 @@ import * as os from 'node:os';
 import * as TOML from 'smol-toml';
 const CONFIG_FILENAME = 'config.toml';
 function getConfigDir() {
+    // C8 — explicit override (highest priority). Guarded: when PACHCA_HOME is
+    // unset the path is byte-identical to before, so existing behavior is
+    // preserved. Useful for isolating config in CI/tests/agents.
+    if (process.env.PACHCA_HOME) {
+        return path.join(process.env.PACHCA_HOME, 'pachca');
+    }
     // XDG_CONFIG_HOME on Unix, LOCALAPPDATA on Windows
     if (process.env.XDG_CONFIG_HOME) {
         return path.join(process.env.XDG_CONFIG_HOME, 'pachca');