npm - ilml-plugin-linkedin - Versions diffs - 1.2.0 → 1.2.2 - Mend

ilml-plugin-linkedin 1.2.0 → 1.2.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.

Files changed (4) hide show

package/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,28 @@
+# Changelog
+## 1.2.2
+- README polish based on real-user feedback:
+  - Cleaner top — removed the metadata bullet list (npm/tracker/license) that was the very first thing visitors saw on the npm page; now opens straight into "What it does"
+  - Removed the entire `Developer Notes` section — it was internal-only and not useful for end users (release process and architecture notes live in `CLAUDE.md` and the SDK's plugin spec)
+  - Clarified the `LINKEDIN_SEARCH_URL` instruction (no more raw URL parameters like `f_AL=true` — just "open LinkedIn → Jobs, set filters, copy URL")
+  - New **Author & contact** section with personal page, LinkedIn, and a **DigitalTwins.team** call-to-action for custom plugin development
+- `CHANGELOG.md` is now shipped in the npm tarball (added to `package.json#files`), so the npm package page renders release notes next to the README
+- New **Feedback & support** section in the README pointing at a dedicated **Support** node in iLiveMyLife (`0000019dde81b04f-2e534bb8ebad0000`) — users can write directly to the maintainer via the in-graph messenger or `ilml send` from the terminal
+## 1.2.1
+- Documentation overhaul — `README.md` rewritten in English, split into **User Guide** (install, configure, run, update) and **Developer Notes** (release process, architecture, security checklist)
+- Removed outdated `.env`-based user instructions — the plugin is now fully self-configuring via `ilml plugin install linkedin` + first-run prompts (or `ilml plugin config linkedin set KEY VALUE`)
+- Added `CHANGELOG.md` (this file)
+- Added `CLAUDE.md` — project-level guide for the AI assistant covering release process and key architecture pointers
+- Added a `Releases` node in the iLiveMyLife graph for in-app release notifications
+## 1.2.0
+- First public publish on npm as `ilml-plugin-linkedin`
+- `src/config.mjs` refactored to use `getPluginConfig()` from `@ilivemylife/graph-sdk` v1.0.17
+  - Resolved configuration is merged into `process.env` so the rest of the codebase (16+ files reading `process.env.X`) keeps working unchanged
+  - The manual `LINKEDIN_NAME` bootstrap check is removed — schema validation in the SDK handles it
+  - Works in both **production** (`ilml linkedin <command>`) and **development** (`node run.mjs` with `.env` next to manifest), without any code changes between modes
+- Bumped `@ilivemylife/graph-sdk` peer to `^1.0.17`
+- `package.json` polish for npm publish — `author`, `license: UNLICENSED`, `keywords`, strict `files: ["dist", "ilml-plugin.json"]` whitelist
+- `ilml-plugin.json` declares config via `config.sections[].fields[]` (richer manifest format supported by SDK 1.0.17): grouped fields with `label`, `hint`, types (`text`, `secret`, `path`, `nodeId`, `url`, `number`, `boolean`)
+- All sensitive files (`.env`, `cookies.json`, raw sources, internal handoff docs, runtime data) excluded from the npm tarball via `.npmignore`

package/README.md CHANGED Viewed

@@ -1,369 +1,219 @@
-# LinkedIn Automation Toolkit
-Автоматизация LinkedIn: подача заявок на вакансии, мониторинг входящих сообщений, управление контактами и рассылка сообщений.
----
-## Быстрый старт (5 минут)
-### Шаг 1. Установи Node.js
-Зайди на https://nodejs.org/ и нажми зелёную кнопку **LTS**. Запусти скачанный файл и нажимай "Next" до конца.
-Проверь что установилось — открой терминал и набери:
-```
-node --version
-```
-Должно показать версию (например `v22.x.x`).
-> **Как открыть терминал:**
-> - **Windows**: нажми `Win+R`, набери `cmd`, нажми Enter
-> - **Mac**: открой приложение Terminal (Cmd+Space → набери Terminal)
-### Шаг 2. Распакуй проект
-Распакуй `linkedin-auto-apply.zip` в любую папку (например на рабочий стол).
-### Шаг 3. Открой терминал в папке проекта
-- **Windows**: открой папку в проводнике → кликни на адресную строку вверху → набери `cmd` → Enter
-- **Mac**: Terminal → набери `cd ` (с пробелом) → перетащи папку в окно → Enter
-### Шаг 4. Установи зависимости
-```
-npm install
-```
-Подожди 1-2 минуты (скачается ~200 MB для встроенного браузера).
-### Шаг 5. Настрой конфигурацию
-Скопируй шаблон настроек:
-```
-copy .env.example .env
-```
-> На Mac/Linux: `cp .env.example .env`
-Открой файл `.env` в **Блокноте** (Windows) или **TextEdit** (Mac) и заполни:
-```ini
-# === Обязательные ===
-LINKEDIN_NAME=Иван Петров          # ← Твоё имя ТОЧНО как на LinkedIn
-LINKEDIN_LOGIN=ivan@gmail.com      # ← Email для входа в LinkedIn
-LINKEDIN_PASS=mypassword123        # ← Пароль от LinkedIn
-# === iLiveMyLife (нужно для подачи заявок) ===
-NODE_EASY_APPLY_MAIN=id_узла       # ← ID основного узла (см. Шаг 5б)
-NODE_EASY_APPLY_ERRORS=id_узла     # ← ID узла для ошибок (см. Шаг 5б)
-```
-> Токен iLiveMyLife не нужно прописывать в `.env` — он подхватывается автоматически после `ilml login` (Шаг 5б).
-> **LINKEDIN_NAME** — самая важная настройка. Открой свой LinkedIn профиль и скопируй имя точно как оно показано (включая язык и регистр).
-### Шаг 5б. Настрой iLiveMyLife (нужно для `npm run apply`)
-Бот использует AI-ассистента **Lifebot** для принятия решений: подавать ли на вакансию, как заполнять анкеты. Без этого шага `npm run apply` не запустится.
-> **Мониторинг сообщений** (`npm run sync-all`, `npm run today`) работает без iLiveMyLife. Этот шаг нужен только для автоматической подачи заявок.
-#### 1. Создай аккаунт
-Зайди на https://app.ilivemylife.io и зарегистрируйся (бесплатно).
- #### 2. Установи iLiveMyLife CLI и залогинься
-```
-npm install -g @ilivemylife/graph-sdk
-ilml login
-```
-> Подробнее о CLI: https://www.npmjs.com/package/@ilivemylife/graph-sdk
-CLI спросит email и пароль от iLiveMyLife. После успешного входа токен сохранится автоматически в `~/.ilivemylife/config.json` — бот подхватит его оттуда, ничего в `.env` прописывать не нужно.
-> **Бонус:** `ilml` CLI — это ещё и инструмент для работы с графом из терминала. Попробуй `ilml doctor` чтобы проверить что всё настроено, или `ilml help` для списка команд.
-#### 3. Создай главный узел для подачи заявок
-1. На главной странице нажми **+** (создать узел)
-2. Назови его **"LinkedIn Easy Apply"**
-3. Открой узел → в правом меню включи переключатель **AI-ассистент** (Lifebot)
-   > Это включает AI для этого узла. **Без этого бот не сможет принимать решения!**
-4. Скопируй **ID узла** из адресной строки: `https://app.ilivemylife.io/item/ВОТ_ЭТОТ_ДЛИННЫЙ_КОД`
-5. Вставь в `.env`: `NODE_EASY_APPLY_MAIN=скопированный_id`
-В **описании узла** (нажми на заголовок → редактировать) напиши правила для бота:
-```
-Правила для заполнения анкет:
-* Меня зовут Иван Петров
-* Мой город: Toronto, Ontario, Canada
-* Телефон: +1-416-xxx-xxxx
-* Email: ivan@gmail.com
-* Опыт программирования: 8 лет
-* Предпочитаю full-time, готов рассмотреть контракт
-* Я имею право работать в Канаде (PR)
-* Зарплатные ожидания: $120-150K CAD
-* Notice period: 14 дней
-```
-> Lifebot читает описание узла и все дочерние узлы внутри него. Чем подробнее напишешь — тем точнее бот заполнит анкеты.
-#### 4. Создай дочерние узлы с информацией о себе
-Внутри **"LinkedIn Easy Apply"** создай несколько узлов-карточек. Lifebot будет обращаться к ним при заполнении анкет:
-**Узел "Резюме"** — твой опыт работы:
-```
-Senior Software Engineer, 8 лет опыта.
-Последний проект: ...
-Образование: ...
-Языки: английский (свободно), русский (родной)
-```
-> Можно вставить подробно — все места работы, проекты, достижения. Или вместо создания нового узла — добавь ссылку на существующий узел с резюме, если он уже есть в графе.
-**Узел "Технологии и опыт"** — список навыков с годами:
-```
-Java - 8 лет
-Python - 5 лет
-React - 4 года
-AWS - 6 лет
-Docker/K8s - 3 года
-```
-> Когда анкета спросит "How many years of Python experience?" — Lifebot найдёт ответ здесь.
-**Узел "Критерии подачи"** — на какие вакансии подавать:
-```
-Подавать на: Software Engineer, Backend Developer, Full-stack, CTO
-НЕ подавать на: Sales, Marketing, Accounting, позиции не связанные с IT
-Локация: удалённо или Toronto
-```
-> Бот перед каждой вакансией спрашивает Lifebot "Should I apply?". Этот узел помогает принять решение.
-**Узел "Error log"** — сюда бот будет писать ошибки при заполнении форм:
-1. Создай узел **"Error log"** внутри главного
-2. AI-ассистент **не нужен** (это просто лог)
-3. Скопируй ID → в `.env`: `NODE_EASY_APPLY_ERRORS=скопированный_id`
-Итого структура будет такая:
-```
-LinkedIn Easy Apply          ← главный узел (AI включён)
-├── Резюме                   ← опыт работы, образование
-├── Технологии и опыт        ← навыки с годами
-├── Критерии подачи          ← на что подавать / не подавать
-└── Error log                ← сюда бот пишет ошибки
-```
-#### 5. Настрой дешёвый AI (экономия)
-По умолчанию Lifebot использует дорогую модель. Для бота достаточно быстрой дешёвой — она отвечает моментально и бесплатного баланса хватит надолго.
-Откройте **основной узел** (LinkedIn Easy Apply) → **Настройки узла** (иконка шестерёнки):
-| Настройка | Значение | Зачем |
-|-----------|----------|-------|
-| **AI Quality** | **Fast/Cheap** | GPT-3.5 достаточно для анкет, экономит баланс |
-| **Root Access** | **Off** | Боту не нужен доступ к остальному графу |
-> Эти настройки влияют только на этот узел. Остальные узлы будут использовать вашу обычную модель.
-### Шаг 6. Залогинься в LinkedIn
-```
-npm run login
-```
-Откроется браузер → автоматически введёт логин/пароль. Если LinkedIn попросит подтверждение (SMS код, капча) — сделай это вручную. После входа браузер закроется.
-> Эту команду нужно запускать **один раз**. Повторно — только если бот скажет "cookies expired".
-### Готово!
-Теперь можешь использовать любые команды из раздела ниже.
----
-## Обновление до новой версии
-Когда получишь новый `linkedin-auto-apply.zip`:
-### Если настроен `DATA_DIR` (рекомендуется)
-Если в `.env` указан `DATA_DIR` — данные хранятся отдельно от кода:
-1. Распакуй новый zip в **новую папку**
-2. Скопируй `.env` и `cookies.json` из старой папки
-3. Запусти `npm install`
-Всё — данные уже на месте, копировать ничего не нужно.
-### Если `DATA_DIR` не настроен
-1. Распакуй в **новую папку** (не поверх старой)
-2. Скопируй из старой папки в новую:
-   - папку `collected-profiles/` целиком (контакты, переписки, заявки)
-   - папку `market-research/` целиком (разведка вакансий)
-   - файл `.env` (настройки)
-   - файл `cookies.json` (сессия LinkedIn)
-3. Запусти `npm install`
-> **Совет:** настрой `DATA_DIR` в `.env` чтобы упростить будущие обновления (см. раздел "Путь к данным").
-### После обновления
-Запусти любую команду — данные автоматически обновятся до нового формата:
-```
-npm run today
-```
-> Сообщение `Schema migration: v0 → v1` при первом запуске — это нормально. Бэкапы создаются автоматически.
----
-## Основные команды
-### Мониторинг входящих (рекомендую запускать каждый день)
-| Команда | Что делает |
-|---------|-----------|
-| `npm run sync-all` | **Главная команда.** Сканирует входящие, читает новые сообщения, обогащает данные |
-| `npm run sync-all:safe` | То же, но **не открывает непрочитанные** — сохраняет unread-индикатор в LinkedIn UI |
-| `npm run today` | Показывает план на сегодня: кому ответить, что сделать (без браузера) |
-| `npm run sync-all:report` | Статистика без открытия браузера |
-| `npm run warm-scan` | Найти 1st-degree контактов в target-компаниях (без браузера) |
-### Сообщения
-| Команда | Что делает |
-|---------|-----------|
-| `npm run messages -- --list` | Быстрая статистика бесед (без браузера) |
-| `npm run messages -- --read "Имя Фамилия"` | Прочитать всю переписку с человеком |
-| `npm run messages -- --send "Имя" "Текст"` | Отправить сообщение |
-| `npm run messages -- --draft "Имя" "Текст"` | Подготовить черновик (не отправляет) |
-| `npm run messages:review` | Просмотреть все черновики перед отправкой |
-| `npm run messages:push` | Отправить все подтверждённые черновики |
-### Подача заявок на вакансии
-| Команда | Что делает |
-|---------|-----------|
-| `npm run apply` | Автоматическая подача на Easy Apply вакансии |
-| `npm run funnel` | Отправить connection requests рекрутерам |
-| `npm run sync` | Синхронизировать список контактов |
-### Поиск по заявкам
-Перед собеседованием — найди что ты отвечал при подаче:
-| Команда | Что делает |
-|---------|-----------|
-| `npm run search -- --company "Google"` | Все заявки в компанию |
-| `npm run search -- --job "senior engineer"` | Поиск по названию вакансии |
-| `npm run search -- --job-id 4387994033` | Все данные по конкретной вакансии |
----
-## Ежедневный рабочий процесс
-```
-npm run sync-all          ← Утром: синхронизировать входящие
-npm run today             ← Посмотреть что нужно сделать
-npm run apply             ← Подать заявки на новые вакансии
-```
----
-## Настройки в .env
-### Обязательные
-| Переменная | Пример | Описание |
-|---|---|---|
-| `LINKEDIN_NAME` | `John Smith` | Твоё имя как на LinkedIn (точное совпадение!) |
-| `LINKEDIN_LOGIN` | `john@gmail.com` | Email для входа |
-| `LINKEDIN_PASS` | `password123` | Пароль |
-### Для подачи заявок (Easy Apply)
-| Переменная | Пример | Описание |
-|---|---|---|
-| `City` | `Toronto` | Город для форм |
-| `LINKEDIN_SEARCH_URL` | `https://www.linkedin.com/jobs/...` | URL поиска вакансий с настроенными фильтрами |
-| `MAX_APPLY_FOR_RUN` | `50` | Максимум заявок за один запуск |
-| `CV_TEXT` | `Check my CV...` | Текст для полей Cover Letter |
-| `RESUME_PDF_URL` | `https://...pdf` | Ссылка на PDF резюме |
-| `RESUME_FILENAME` | `John_Smith_Resume.pdf` | Имя файла резюме |
-### Для iLiveMyLife (нужно для `npm run apply`)
-| Переменная | Описание |
-|---|---|
-| `NODE_EASY_APPLY_MAIN` | ID узла для решений бота (с AI-ассистентом!) |
-| `NODE_EASY_APPLY_ERRORS` | ID узла для логирования ошибок |
-> Токен подхватывается автоматически после `ilml login` (Шаг 5б). Прописывать в `.env` не нужно.
->
-> **NODE_EASY_APPLY_MAIN обязателен** для подачи заявок (`npm run apply`). Бот использует AI для заполнения анкет.
->
-> Мониторинг сообщений (`npm run sync-all`) работает без iLiveMyLife.
-### Путь к данным (опционально)
-| Переменная | Описание |
-|---|---|
-| `DATA_DIR` | Папка для хранения данных. По умолчанию — рядом с кодом |
-Если хочешь хранить данные отдельно от кода (удобнее при обновлениях):
-```ini
-DATA_DIR=D:\MyLinkedInData
-```
-Бот создаст `collected-profiles/` и `market-research/` внутри этой папки.
-> **С `DATA_DIR` обновление проще:** распаковал новый zip → `npm install` → готово. Данные остались на месте.
----
-## Где хранятся данные
-Все данные в папке `collected-profiles/` (создаётся автоматически):
-| Файл | Что внутри |
-|------|-----------|
-| `conversations.json` | Все переписки (сообщения, статусы, теги) |
-| `people.json` | Все контакты (имена, должности, компании) |
-| `jobs.json` | Поданные заявки |
-| `sync-state.json` | Когда последний раз синхронизировались |
-> **Бэкапы создаются автоматически** (`.backup` файлы). Если основной файл повредится — программа восстановит из бэкапа.
----
-## Решение проблем
-| Ошибка | Что делать |
-|---|---|
-| `No iLiveMyLife token found` | Запусти `ilml login` (Шаг 5б) |
-| `NODE_EASY_APPLY_MAIN is not configured` | Создай узел с тегом `assist` и добавь ID в `.env` (Шаг 5б) |
-| `LINKEDIN_NAME is not set in .env` | Открой `.env` и добавь `LINKEDIN_NAME=Твоё Имя` |
-| `cookies.json not found` | Запусти `npm run login` |
-| `cookies expired` / `Redirected to login` | Запусти `npm run login` заново |
-| `cookies.json is corrupted` | Удали `cookies.json` и запусти `npm run login` |
-| `Schema migration: v0 → v1` | Нормально! При обновлении данные автоматически приводятся к новому формату |
-| `Lifebot timeout` | AI перегружен. Бот повторит 2 раза, потом пропустит вакансию. При 3 подряд — остановится, попробуй позже |
-| `npm` не найден | Установи Node.js (Шаг 1) |
-| Браузер не закрылся | Закрой его вручную (или нажми Ctrl+C в терминале) |
-| `Cannot find module` | Запусти `npm install` |
-| Данные пропали | Проверь папку `collected-profiles/` — там должны быть `.backup` файлы |
-### Если ничего не помогает
-1. Удали `cookies.json`
-2. Запусти `npm run login`
-3. Попробуй команду заново
----
-## Дополнительные команды
-Полный список — в файле `COMMANDS.md`.
+# ilml-plugin-linkedin
+LinkedIn job-search and networking automation as a plugin for the [`ilml`](https://www.npmjs.com/package/@ilivemylife/graph-sdk) CLI.
+## What it does
+A toolkit that drives LinkedIn from your machine via a real browser (Puppeteer + stealth), with results synced into your [iLiveMyLife](https://ilivemylife.io) knowledge graph:
+- **Easy Apply** — auto-fills and submits LinkedIn job applications. The graph's AI assistant (**Lifebot**) reads your profile node to answer custom application questions in your voice.
+- **Inbox sync** — scans LinkedIn messages, detects changes, and mirrors threads into your graph.
+- **Message bot** — draft → review → send batch messaging workflow (you approve before anything is sent).
+- **Connection funnel** — process recruiter / founder / investor profiles in batches (connect, skip, message).
+- **Scout** — find jobs without applying; reports back which match your filters.
+- **Profile activity** — track who viewed your profile, who you visited, etc.
+All persistent data (job DB, profile DB, conversation history, cookies) is stored locally in a directory you choose — never in a cloud you don't control.
+---
+# User Guide
+## Prerequisites
+- **Node.js 18+** — [download](https://nodejs.org/) (the Long-Term Support version is fine).
+- **iLiveMyLife account** — free signup at [iLiveMyLife.io](https://ilivemylife.io).
+- **LinkedIn account** — your personal one.
+That's it. There's nothing to clone or compile.
+## Install
+One-time, on your machine:
+```bash
+# 1. Install the ilml CLI (skip if already installed)
+npm install -g @ilivemylife/graph-sdk
+# 2. Log in to your iLiveMyLife account
+ilml login
+# 3. Install this plugin
+ilml plugin install linkedin
+```
+That's the whole install. The bare-name `linkedin` resolves to `npm:ilml-plugin-linkedin` via the ilml plugin convention. The CLI downloads the latest version from npm, extracts it under `~/.ilivemylife/plugins/linkedin/`, and runs `npm install` for its runtime dependencies (mainly Puppeteer's bundled Chromium — first install takes a couple of minutes).
+Verify it's installed:
+```bash
+ilml plugin list
+ilml linkedin
+```
+## Configure
+The plugin needs a few things to know who you are and where to log activity. The first time you run any `ilml linkedin <command>`, the CLI will prompt you for the **required** fields. You can also pre-configure:
+```bash
+ilml plugin config linkedin set LINKEDIN_NAME "Your Full Name"
+ilml plugin config linkedin set NODE_EASY_APPLY_MAIN <node-id>
+ilml plugin config linkedin set NODE_EASY_APPLY_ERRORS <node-id>
+```
+To inspect (secret values are masked):
+```bash
+ilml plugin config linkedin
+```
+To change a value later or remove one:
+```bash
+ilml plugin config linkedin set LINKEDIN_NAME "New Name"
+ilml plugin config linkedin unset OPTIONAL_KEY
+ilml plugin config linkedin reset                      # wipe all; will re-prompt next run
+```
+### Configuration fields
+| Section | Field | Required | What it is |
+|---|---|---|---|
+| LinkedIn account | `LINKEDIN_NAME` | yes | Your full name **exactly** as it appears on LinkedIn (used to identify your own messages in threads). |
+| | `LINKEDIN_LOGIN` | no | LinkedIn email — only used for auto-fill during one-time login. |
+| | `LINKEDIN_PASS` | no, secret | LinkedIn password — only used for auto-fill during one-time login. Stored locally on disk; never sent anywhere. |
+| iLiveMyLife integration | `NODE_EASY_APPLY_MAIN` | yes | Node ID where job applications are tracked. See "Setting up your graph" below. |
+| | `NODE_EASY_APPLY_ERRORS` | yes | Node ID where Easy Apply errors are logged. |
+| | `NODE_RUN_REPORTS` | no | Node ID where end-of-session summaries are posted (enable notifications on it to get pings when long jobs finish). |
+| Data storage | `DATA_DIR` | no | Absolute path to a directory for the local DB / cookies. **Recommended** — keeps data outside the plugin install folder so it survives plugin updates. |
+| Apply bot | `City` | no | Default city for filters. Default: `Toronto`. |
+| | `MAX_APPLY_FOR_RUN` | no | Stop after this many applications per run. Default: `50`. |
+| | `LINKEDIN_SEARCH_URL` | no | Default LinkedIn jobs search URL — open LinkedIn → Jobs, set your filters, then make sure **Easy Apply** is on. Copy the resulting URL from the address bar and paste it here. |
+| Scouting | `LINKEDIN_SCOUT_URLS` | no | Comma-separated job search URLs to scan without applying. |
+| Resume / CV | `CV_TEXT`, `RESUME_PDF_URL`, `RESUME_FILENAME` | no | CV snippet, public PDF URL, suggested filename. Used in messages to recruiters. |
+| Funnel | `FUNNEL_USE_CUSTOM_MESSAGE` | no | Send a custom note with connection requests. Default: `false`. |
+| | `FUNNEL_MAX_CONNECTIONS` | no | Cap connection requests per run. Default: `20`. |
+| | `FUNNEL_MESSAGE` | no | Note text. Use `{name}` placeholder, e.g. `Hi {name}, I just applied for a role at your company`. |
+| | `FUNNEL_EXCLUDE_LOCATIONS` | no | Comma-separated locations to skip. |
+## Setting up your graph
+The Easy Apply bot uses iLiveMyLife's AI assistant (**Lifebot**) to answer custom application questions in your voice. Two graph nodes are required: a **main tracking node** with Lifebot enabled, and an **errors node** for failed applications.
+1. Open https://app.ilivemylife.io and create a node titled **"LinkedIn Easy Apply"** (or any name).
+2. Open the node's **settings** (right panel) and turn on **AI assistant**. This enables Lifebot for this node — without it, the bot can't answer questions and `ilml linkedin apply` will refuse to run.
+3. Copy the node ID from the URL: `https://app.ilivemylife.io/item/THIS-IS-THE-ID`.
+4. Set it: `ilml plugin config linkedin set NODE_EASY_APPLY_MAIN <id>`.
+5. In the node's **description**, write your answer rules — Lifebot reads this when filling forms. Example:
+   ```
+   Application question rules:
+   - My full name: Ivan Petrov
+   - City: Toronto, Ontario, Canada
+   - Phone: +1-416-xxx-xxxx
+   - Email: ivan@example.com
+   - Experience: Senior software engineer, 8 years
+   - Visa status: Permanent Resident, Canada
+   - Salary expectations: $120-150K CAD
+   - Notice period: 14 days
+   - Preferred work mode: hybrid or remote
+   ```
+6. (Optional but useful) Create child nodes inside "LinkedIn Easy Apply" with topical detail: `Resume`, `Tech stack`, `Interview availability`, etc. Lifebot reads the whole subtree and uses everything as context.
+7. Create a sibling node titled **"Easy Apply Errors"** (no AI needed). Copy its ID and set it: `ilml plugin config linkedin set NODE_EASY_APPLY_ERRORS <id>`.
+## First-time LinkedIn login
+LinkedIn requires an authenticated session, so a one-time browser login is needed. Run:
+```bash
+ilml linkedin login
+```
+A real browser window opens. Sign in to LinkedIn (manually solve any captcha or 2FA). When you see your feed, close the window — your session cookies are saved locally for future runs.
+## Daily commands
+| Command | What it does |
+|---|---|
+| `ilml linkedin apply` | Auto-apply to LinkedIn Easy Apply jobs. Stops after `MAX_APPLY_FOR_RUN`. |
+| `ilml linkedin sync` / `sync-all` | Pull the LinkedIn inbox into the local DB and the graph. |
+| `ilml linkedin today` | Faster sync of just today's activity. |
+| `ilml linkedin enrich` | Categorize and tag conversations. |
+| `ilml linkedin report` | Summary of the latest session. |
+| `ilml linkedin scout` | Scan jobs against `LINKEDIN_SCOUT_URLS` without applying. |
+| `ilml linkedin messages` | Batch messaging — draft, review, then push. Nothing sends without your approval. |
+| `ilml linkedin funnel` | Process a queue of recruiter / founder / investor profiles. |
+| `ilml linkedin visit` | Track profile visits. |
+| `ilml linkedin viewers` | List who viewed your profile. |
+| `ilml linkedin daily` | Compound routine combining several commands. |
+| `ilml linkedin login` | Re-save LinkedIn cookies after a session expires. |
+Run `ilml linkedin` (no subcommand) to see the list anytime.
+## Updating
+Updates ship via npm. The CLI checks the registry and only downloads when there's a newer version:
+```bash
+ilml plugin update linkedin    # check this plugin
+ilml plugin update             # check all installed plugins
+ilml update                    # update the SDK and all plugins together
+```
+You'll see one of:
+- `linkedin: already on latest version (1.2.1)` — nothing downloaded
+- `linkedin: 1.2.1 → 1.3.0` followed by re-install — newer version pulled
+Your saved configuration is preserved across updates (it lives outside the install dir). If a new version requires a new field, the next run will prompt you for just the new field.
+## Where data lives
+| Path | What's there | Survives plugin update? | Cleared by `ilml logout`? |
+|---|---|---|---|
+| `~/.ilivemylife/plugins/linkedin/` | Plugin code (re-extracted on update) | Replaced | No |
+| `~/.ilivemylife/plugins-state/linkedin.json` (or per-project local) | Your configured values | Yes | Yes (with that scope) |
+| Directory you set as `DATA_DIR` | Local DBs, cookies, scraped profiles | Yes | No (you manage it) |
+If you didn't set `DATA_DIR`, data files default to inside the plugin's install dir — meaning a plugin reinstall wipes them. Setting `DATA_DIR` to a sibling folder like `~/linkedin-plugin-data/` is strongly recommended.
+## Removing the plugin
+```bash
+ilml plugin remove linkedin
+```
+This wipes the install dir. To also clear your saved configuration in the active scope:
+```bash
+ilml plugin config linkedin reset
+```
+To clean up the data directory (cookies, DBs), delete the folder you set as `DATA_DIR` manually.
+## Feedback & support
+Bug reports, feature requests, and general questions land in the plugin's **Support** node inside iLiveMyLife. Send a message there and we'll get back to you:
+- In any iLiveMyLife app (web / mobile / desktop): open https://app.ilivemylife.io/item/0000019dde81b04f-2e534bb8ebad0000 and use the messenger panel
+- From the terminal: `ilml send 0000019dde81b04f-2e534bb8ebad0000 "your message"`
+## Links
+- This plugin on npm: https://www.npmjs.com/package/ilml-plugin-linkedin
+- `ilml` CLI on npm: https://www.npmjs.com/package/@ilivemylife/graph-sdk
+- iLiveMyLife: https://ilivemylife.io
+---
+## Author & contact
+**[Ilya Sorokin](https://www.digitaltwins.team/team/ilya-sorokin)** — creator of [iLiveMyLife.io](https://ilivemylife.io) and this plugin.
+- LinkedIn: [linkedin.com/in/ilyasorokin](https://www.linkedin.com/in/ilyasorokin/)
+- Email: info@ilivemylife.io
+### Need a custom plugin or extension?
+[**DigitalTwins.team**](https://www.digitaltwins.team/) — my consulting company — designs and builds custom automation, SDK extensions, and bespoke plugins for the iLiveMyLife ecosystem (and beyond). If you want to integrate your own workflow with iLiveMyLife, extend this plugin's behavior, or commission something new, get in touch.

package/ilml-plugin.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "linkedin",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "LinkedIn job automation: apply, scout, sync, funnel, messages",
   "commands": {
     "apply":       { "run": "node dist/run.mjs" },

package/package.json CHANGED Viewed

@@ -1,11 +1,12 @@
 {
   "name": "ilml-plugin-linkedin",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "ilml plugin: LinkedIn job automation — apply, scout, sync, funnel, messages",
   "type": "module",
   "files": [
     "dist",
-    "ilml-plugin.json"
+    "ilml-plugin.json",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build:plugin": "node scripts/build-plugin.mjs",