@kitelev/exocortex-cli 15.148.8 → 15.148.9

package/README.md

@@ -434,7 +434,7 @@ set -euo pipefail
 
 VAULT="$HOME/vault"
 DAILY="daily/$(date +%Y-%m-%d).md"
-CREATE_INSTANCE_CMD="<create-instance-command-uid>"
+CREATE_INSTANCE_CMD="1abe7877-a462-4bd5-9bd8-1f75fe7f50aa"  # Start Lunch (RFC 94e520da § Phase 7)
 
 npx @kitelev/exocortex-cli dyncommand exec "$CREATE_INSTANCE_CMD" \
   --target "$DAILY" \
@@ -451,6 +451,68 @@ verifier, install instructions, and a 7-day soak protocol — lives in
 [`examples/production-cron/`](../../examples/production-cron/) (RFC
 `94e520da` § Phase 5).
 
+#### Telegram bot integration (Phase 7 migration)
+
+> **Migration target (RFC `94e520da` § Phase 7, T7.1):** Telegram bot Claude
+> subprocess **must** invoke `dyncommand exec <uid>` rather than legacy
+> `command start <path>`.
+
+The legacy `exocortex command start <path-to-asset>` (`Doing` transition by
+file path) is **deprecated** as part of the Phase 7 sunset of the hardcoded
+plugin-command CLI surface. Equivalent vault-defined behaviour now lives
+behind a stable command UID:
+
+```bash
+# ✅ NEW canonical path — vault-defined command, stable UID, runtime-agnostic:
+LUNCH_CMD="1abe7877-a462-4bd5-9bd8-1f75fe7f50aa"   # "Start Lunch" command
+TODAY_DAILY="03 Knowledge/daily/$(date +%Y-%m-%d).md"
+
+exocortex dyncommand exec "$LUNCH_CMD" \
+  --target "$TODAY_DAILY" \
+  --vault ~/vault \
+  --output json
+
+# ⚠️ LEGACY (still works until Phase 7.3 sunset, ≥ 2 minor releases out):
+# exocortex command start "tasks/<lunch-task-uid>.md" --vault ~/vault
+```
+
+**What the bot subprocess Claude does:**
+
+1. Receives user phrase (e.g. «начать обедать»).
+2. Resolves the phrase to a vault `exocmd:Command` asset by `exo__Asset_label`
+   or `aliases:` (the `Start Lunch` command above carries `aliases: [начать
+   обедать]` so direct lookup works).
+3. Invokes `dyncommand exec <uid> --target <today-daily-note> --vault $VAULT`.
+4. Surfaces the JSON `successMessage` back to the user.
+
+**Why this is a real migration, not a rename:**
+
+- Adding a new bot phrase (e.g. «закрой задачу», «отправь в backlog») requires
+  **zero bot or CLI code changes** — only a new vault `exocmd:Command` asset.
+- The same UID drives plugin UI buttons, CLI invocations, cron jobs, and
+  Telegram routing. One definition, every runtime.
+- Backward compat: the legacy `command start` path keeps working through
+  Phase 7.2 (deprecation warning) and Phase 7.3 (sunset), so existing bot
+  configurations roll over without user-visible regression (RFC § R4).
+
+**Verification:**
+
+```bash
+# 1. Confirm command exists and precondition compiles:
+exocortex dyncommand show 1abe7877-a462-4bd5-9bd8-1f75fe7f50aa --vault ~/vault
+
+# 2. Dry-run on today's daily note (no writes):
+exocortex dyncommand exec 1abe7877-a462-4bd5-9bd8-1f75fe7f50aa \
+  --target "03 Knowledge/daily/$(date +%Y-%m-%d).md" \
+  --dry-run --vault ~/vault --output json
+```
+
+The canonical `Start Lunch` command lives at
+`03 Knowledge/exocmd/status/1abe7877-a462-4bd5-9bd8-1f75fe7f50aa.md` in the
+vault; its grounding (`93e4a830-0911-4589-91f2-49ac0acdb4d2`) is a
+`service_call createAsset` materialising a fresh `ems__Task` instance from
+the Lunch `TaskPrototype` (`4b571141-5fc3-4ddd-8f07-ca681fc8410a`).
+
 #### Troubleshooting
 
 - **`Precondition not satisfied`** — run `dyncommand show <uid>` to read the

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// @kitelev/exocortex-cli v15.148.8
+// @kitelev/exocortex-cli v15.148.9
 // CLI tool for Exocortex knowledge management system - SPARQL queries, task management, and more
 // License: MIT
 
@@ -794,7 +794,7 @@ exo__BacklinksTableBlock_columns:${f==="[]"?" []":f}
 --- END PREVIEW ---
 `)}o(xK,"printDryRunReport");function CK(n,e){let r=[`--- MIGRATION ${e.apply?"APPLY":"DRY RUN"} ---`,`Migrated pairs: ${n.pairs.length}`,`Skipped configs: ${n.skipped.length}`];e.apply&&(r.push(`Files written to: ${e.outDir}/ (relative to vault root)`),r.push(`Total files written: ${n.pairs.length*2} (${n.pairs.length} Layout + ${n.pairs.length} Block)`));for(let i of n.skipped)r.push(`  SKIPPED: ${i.sourcePath} \u2014 ${i.reason}`);return r.push(`--- END SUMMARY ---
 `),r.join(`
-`)}o(CK,"formatSummary");function IK(n,e){return{mode:e.apply?"apply":"dry-run",outDir:e.outDir,pairsCount:n.pairs.length,skippedCount:n.skipped.length,pairs:n.pairs.map(t=>({sourceUid:t.sourceUid,sourcePath:t.sourcePath,layoutUid:t.layout.uid,blockUid:t.block.uid,warnings:t.warnings})),skipped:n.skipped}}o(IK,"summariseResult");function $D(n){n.addCommand(pO()),n.addCommand(_O()),n.addCommand(SO())}o($D,"addQuerySubcommands");function BD(n){let e=new xe;e.name("exocortex").description("CLI tool for Exocortex knowledge management system").version(n??"15.148.8");let t=e.command("exoql").description("ExoQL query execution and cache management");$D(t);let r=e.command("sparql").description("(deprecated) Use 'exoql' instead");return $D(r),r.hook("preAction",()=>{console.error('\u26A0\uFE0F  "sparql" is deprecated. Use "exoql" instead.')}),e.addCommand(CF()),e.addCommand(PF()),e.addCommand(OF()),e.addCommand(DF()),e.addCommand(NF()),e.addCommand($F()),e.addCommand(qF()),e.addCommand(rD()),e.addCommand(sD()),e.addCommand(uD()),e.addCommand(hD()),e.addCommand(pD()),e.addCommand(gD()),e.addCommand(CD()),e.addCommand(OD()),e.addCommand(jD()),e}o(BD,"createProgram");BD().parse();0&&(module.exports={createProgram});
+`)}o(CK,"formatSummary");function IK(n,e){return{mode:e.apply?"apply":"dry-run",outDir:e.outDir,pairsCount:n.pairs.length,skippedCount:n.skipped.length,pairs:n.pairs.map(t=>({sourceUid:t.sourceUid,sourcePath:t.sourcePath,layoutUid:t.layout.uid,blockUid:t.block.uid,warnings:t.warnings})),skipped:n.skipped}}o(IK,"summariseResult");function $D(n){n.addCommand(pO()),n.addCommand(_O()),n.addCommand(SO())}o($D,"addQuerySubcommands");function BD(n){let e=new xe;e.name("exocortex").description("CLI tool for Exocortex knowledge management system").version(n??"15.148.9");let t=e.command("exoql").description("ExoQL query execution and cache management");$D(t);let r=e.command("sparql").description("(deprecated) Use 'exoql' instead");return $D(r),r.hook("preAction",()=>{console.error('\u26A0\uFE0F  "sparql" is deprecated. Use "exoql" instead.')}),e.addCommand(CF()),e.addCommand(PF()),e.addCommand(OF()),e.addCommand(DF()),e.addCommand(NF()),e.addCommand($F()),e.addCommand(qF()),e.addCommand(rD()),e.addCommand(sD()),e.addCommand(uD()),e.addCommand(hD()),e.addCommand(pD()),e.addCommand(gD()),e.addCommand(CD()),e.addCommand(OD()),e.addCommand(jD()),e}o(BD,"createProgram");BD().parse();0&&(module.exports={createProgram});
 /*! Bundled license information:
 
 reflect-metadata/Reflect.js:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitelev/exocortex-cli",
-  "version": "15.148.8",
+  "version": "15.148.9",
   "description": "CLI tool for Exocortex knowledge management system - SPARQL queries, task management, and more",
   "main": "dist/index.js",
   "bin": {