miloc-pi

Локальный Pi package для agentic development extensions. Source of truth для default-загрузки extensions: package.json#pi.extensions.

Package surface

Сейчас по умолчанию зарегистрированы 5 extension entrypoints: ask-user-question, ast-structural-edit, devext-doctor, model-roles и todo-context. Все остальные локальные дубли OMP-owned capabilities и test fixtures убраны из default surface, пока они не будут портированы из OMP, оформлены как thin wrappers или явно оставлены как Miloc-specific extensions.

Полная русскоязычная документация по каждому extension находится в docs/extensions/. Ownership/status matrix находится в docs/extension-ownership-matrix.md. HTML smoke gallery генерируется отдельно в docs/extension-gallery/, чтобы не затирать эти файлы.

Install

npm install --ignore-scripts
npm run check
pi install -l /Users/ravius/projects/miloc-pi

После install smoke для текущего reduced default surface: /devext doctor. helloTool оставлен только как isolated test fixture, но больше не входит в default package surface. Старые representative tool smoke для goalSet, goal, planMode, /plan, loopControl, toolRouter, runAgent и task больше не доказывают default package surface; эти tools проверяются только как legacy/local code до OMP-based замены.

Active Extensions

| Extension | Decision | Risk | Commands | Tools | Hooks | Summary | Entrypoint | |---|---|---|---|---|---|---|---| | ask-user-question | compat-wrapper | medium | none | ask, askUserQuestion | none | Активный OMP-compatible human-in-the-loop tool; askUserQuestion оставлен как legacy alias. | ./extensions/ask-user-question/index.ts | | ast-structural-edit | compat-wrapper | high | none | ast_grep, ast_edit, resolve, ast_apply | none | Активный OMP-shaped AST wrapper: ast_grep ищет, ast_edit строит preview, resolve применяет или отклоняет его. | ./extensions/ast-structural-edit/index.ts | | devext-doctor | keep | low | devext | none | none | Показывает краткий health/status установленного extension-пакета после install smoke. | ./extensions/devext-doctor/index.ts | | model-roles | compat-wrapper | medium | models, model-roles | none | none | Активный OMP-style model selector wrapper: /models открывает temporary selection, /models status показывает список, /models assign пишет modelRoles. | ./extensions/model-roles/index.ts | | todo-context | compat-wrapper | medium | todo | todo_write | none | Активный OMP-style todo wrapper: todo_write меняет session-backed phases, /todo показывает и редактирует тот же список. | ./extensions/todo-context/index.ts |

Disabled By Default

| Extension | Decision | Reason | |---|---|---| | hello-tool | fixture-only | Isolated registration/TypeBox smoke fixture; не входит в default package surface. | | goal | OMP-port-backlog | Локальный hidden-context goal отключен; goal/goalSet fail-closed до порта OMP GoalRuntime. | | plan | OMP-port-backlog | Локальный write-blocking mode engine отключен; /plan/planMode fail-closed до порта OMP plan mode. | | loop | disabled | Local auto-follow-up engine удален; /loop/loopControl report-only/fail-closed до порта OMP loop mode. | | tools-ast-grep | OMP-port-backlog | Должен стать частью OMP AST protocol: ast_grep, ast_edit, hidden resolve. | | tools-ast-edit | OMP-port-backlog | Текущая preview-only версия больше не primary; нужен OMP-compatible boundary. | | tools-ast-apply | compat-wrapper | Регистрирует OMP-compatible resolve для AST preview finalization; ast_apply оставлен legacy alias. | | tools-lsp | OMP-port-backlog | Regex/file-scan helper удален; lsp fail-closed до порта OMP LSP stack. | | agents | OMP-port-backlog | Локальный synthetic execution отключен; task/runAgent fail-closed до порта OMP TaskTool. | | tool-router | compat-wrapper | /tools теперь inspect-first, explicit preset switch идет через setActiveTools; остается disabled до runtime proof. | | security-gate | disabled | Локальный blocking hook отключен; /security-audit report-only до порта OMP approval policy. | | tools-dev-context | disabled | Mixed shell/eval/job/checkpoint bundle fail-closed; конкретные pieces надо портировать отдельно как OMP-backed plugins. | | dynamic-loader | disabled | apply/rollback fail-closed; read-only catalog до порта OMP plugin manager/marketplace. | | browser | disabled | Mock driver удален; local tool fail-closed до порта OMP BrowserTool. | | live-terminal | disabled | Lifecycle observer удален; /live report-only до порта OMP bash/job/PTY streaming. | | tools-debug | disabled | Local Node subprocess wrapper удален; debug fail-closed до порта OMP DAP debug tool. |

Cleanup Decisions

| Extension | Decision | Reason | |---|---|---| | hello | delete | command-only SDK smoke; дублирует проверку загрузки пакета и не решает рабочую задачу miloc-pi. | | hello-command | delete | учебный slash-command пример; отдельный command demo не нужен после переноса smoke-проверки в isolated tests. | | lifecycle-trace | delete | observer пересекается с прежней live-terminal идеей и не проверяет ожидаемый process-log behavior. | | session-state-demo | delete | demo кода для appendEntry/getEntries; regression ценность покрывается реальными goal/loop custom entries. |