@lore-co/cli 0.2.28 → 0.2.30

package/README.md

@@ -65,8 +65,9 @@ requirements, permissions, and hook approval still apply.
 
 ## Find the right command
 
-Run `lore help` for the command list, `lore help <command>` for its use case,
-options and examples, or `lore help self-host up` for a subcommand.
+Run `lore help` for everyday commands, `lore help --all` for every command,
+`lore help <command>` for its use case, options and examples, or
+`lore help self-host up` for a subcommand.
 `lore <command> --help` works too. Help does not require a workspace connection.
 
 Use `ask` to find existing knowledge, `remember` to save a reusable lesson,
@@ -426,7 +427,7 @@ content-free `guard_check` audit event.
 
 ```sh
 lore update
-lore update --version v0.2.28
+lore update --version v0.2.30
 ```
 
 `update` resolves the latest release to an exact tag, or uses the exact
@@ -449,7 +450,7 @@ receive timestamped backups, and customer-edited skill files are preserved with
 a warning. The report is by agent and lists only what you need to do:
 
 ```text
-✓ Lore 0.2.28 is installed
+✓ Lore 0.2.30 is installed
 ✓ Updated Lore for Claude Code and Codex
 
 Next
@@ -822,7 +823,7 @@ same-repository, non-draft pull requests bearing the corresponding
 `lore:codex-review` or `lore:devin-review` label.
 
 Generated jobs require a published standalone binary release and default to
-`treadiehq/lore-releases` at `v0.2.28`. Set `LORE_CLI_REPOSITORY` to the publicly
+`treadiehq/lore-releases` at `v0.2.30`. Set `LORE_CLI_REPOSITORY` to the publicly
 readable `owner/repository` and `LORE_CLI_VERSION` to an existing release tag
 when using another release source.
 

package/dist/approach-guidance.d.ts

@@ -1,7 +1,7 @@
-/** A request to save the current work as a reusable approach starts the save workflow. */
+/** A request to save the current work as a reusable runbook starts the save workflow. */
 export declare function approachWorkflowRequested(prompt: string): boolean;
 /**
- * `workflowStarted` is true once this session asked to save an approach, so a
+ * `workflowStarted` is true once this session asked to save a runbook, so a
  * continuation such as "go ahead and save it" after compaction still gets the
  * detailed instructions back.
  */

package/dist/approach-guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approach-guidance.d.ts","sourceRoot":"","sources":["../src/approach-guidance.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,EAAE,eAAe,UAAQ,GAAG,MAAM,GAAG,SAAS,CAmBhK"}
+{"version":3,"file":"approach-guidance.d.ts","sourceRoot":"","sources":["../src/approach-guidance.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,MAAM,EAAO,EAAE,eAAe,UAAQ,GAAG,MAAM,GAAG,SAAS,CAmBhK"}

package/dist/approach-guidance.js

@@ -1,28 +1,28 @@
-/** A request to save the current work as a reusable approach starts the save workflow. */
+/** A request to save the current work as a reusable runbook starts the save workflow. */
 export function approachWorkflowRequested(prompt) {
-    return /\bmake (?:this|that|it|the work) repeatable\b|\b(?:saved|reusable) approach\b/iu.test(prompt);
+    return /\bmake (?:this|that|it|the work) repeatable\b|\bmake (?:a|(?:this|that|it) (?:into )?a) runbook\b|\b(?:save|turn) (?:this|that|it) (?:as|into) a runbook\b|\b(?:saved|reusable) (?:approach|runbook)\b/iu.test(prompt);
 }
 /**
- * `workflowStarted` is true once this session asked to save an approach, so a
+ * `workflowStarted` is true once this session asked to save a runbook, so a
  * continuation such as "go ahead and save it" after compaction still gets the
  * detailed instructions back.
  */
 export function approachGuidance(prompt, agent, sessionId, retained = [], workflowStarted = false) {
     // A capability cue lets the agent recognize ordinary requests itself. Reuse
     // must not depend on the user knowing a feature name or a trigger phrase.
-    const discovery = `Lore can save and reuse reviewed approaches in Learnings. If the user asks to repeat earlier work or do it the way it was done before, list active approaches in this repository and choose by the task, without requiring an exact name. Prefer the Lore MCP tools when your host offers them (search_approaches, get_approach, use_approach, report_approach_run, decide_approach_run); they record the run without a shell command. Otherwise run \`lore approach --help\` and pass each request through \`--input <file>\` from a temporary JSON file; never pipe approach JSON inline or put its free-text values on the command line. Infer inputs from the request and repository; ask only for missing information or an ambiguous match. Use the saved version, check prerequisites before editing, and record the actual result. Your native session is ${JSON.stringify({ agent, sessionId })}.`;
+    const discovery = `Lore can save and reuse reviewed runbooks in Learnings (its tools and API call them approaches). If the user asks to repeat earlier work or do it the way it was done before, list active runbooks in this repository and choose by the task, without requiring an exact name. Prefer the Lore MCP tools when your host offers them (search_approaches, get_approach, use_approach, report_approach_run, decide_approach_run); they record the run without a shell command. Otherwise run \`lore runbook --help\` and pass each request through \`--input <file>\` from a temporary JSON file; never pipe runbook JSON inline or put its free-text values on the command line. Infer inputs from the request and repository; ask only for missing information or an ambiguous match. Use the saved version, check prerequisites before editing, and record the actual result. Your native session is ${JSON.stringify({ agent, sessionId })}.`;
     const detailed = workflowStarted || approachWorkflowRequested(prompt);
-    const instructions = ["Prefer the Lore MCP approach tools when your host offers them; prepare_approach, draft_approach, and save_approach carry the same contract as the CLI operations. Otherwise run `lore approach --help` for the JSON command contract, write each request to a temporary JSON file, and pass its path with `--input`; do not pipe the JSON inline, so summaries, notes, and other free text stay off the command line. Both paths use this folder's existing connection.",
+    const instructions = ["Prefer the Lore MCP runbook tools when your host offers them; prepare_approach, draft_approach, and save_approach carry the same contract as the CLI operations. Otherwise run `lore runbook --help` for the JSON command contract, write each request to a temporary JSON file, and pass its path with `--input`; do not pipe the JSON inline, so summaries, notes, and other free text stay off the command line. Both paths use this folder's existing connection.",
         `For source preparation, use an explicit Lore source session if the user supplied one. Otherwise your native session reference is ${JSON.stringify({ externalSessionId: sessionId, agent })}. Resolve it with prepare; never invent a Lore session UUID. If it is not captured yet, use explicit source notes and describe missing evidence.`,
         "For saving: prepare the source, preserve human corrections, show the name, inputs, steps, prerequisites, and checks, then keep a draft. Save only after the user reviews and asks to save. Missing final work or checks must stay a draft. Agent saves are proposals and need owner or admin approval in Learnings before reuse.",
-        "For sources: when a correction in the session was already captured as an active learning in this repository, pass its id in learningIds and cite it from the step, prerequisite, check, or stop condition it supports. Pass further captured sessions in sessionIds. Cite only ids that prepare returned under sources. Do not create learnings while saving an approach; an uncaptured correction stays an uncited item for the reviewer.",
+        "For sources: when a correction in the session was already captured as an active learning in this repository, pass its id in learningIds and cite it from the step, prerequisite, check, or stop condition it supports. Pass further captured sessions in sessionIds. Cite only ids that prepare returned under sources. Do not create learnings while saving a runbook; an uncaptured correction stays an uncited item for the reviewer.",
         "Separate task inputs from repository dependencies: resource names, fields, and sort direction can vary per run. Preserve the actual helper names, module paths, and required contracts in prerequisites; do not turn existing helpers into unconstrained inputs. A renamed or replaced helper needs a decision. Aim for 3–7 essential steps and durable constraints, excluding incidental tool failures and restrictions specific to the original task. Required result checks must apply to every supported use; keep optional diagnostics in the steps, not in checks. Do not require reproducing a historical defect when adding new work. Check that stop conditions do not contradict the declared inputs.",
         "Keep the user experience short: show a plain-language preview of what will repeat and ask to save. Keep command contracts, source IDs, version bookkeeping, and reporting internal. Derive inputs and checks yourself; ask the user only for information you cannot infer.",
-        "For reuse: list active approaches in this repository, choose by the task without requiring an exact name, infer the inputs from the request and repository, and use its exact version. Ask only when information is missing or the match is ambiguous. Check prerequisites before editing. Changed or unknown prerequisites require needs_input and a specific user decision. Execute with your normal tools and permissions, report actual artifacts/checks, and keep missing evidence unknown. Updating the shared approach is a separate reviewed revision.",
+        "For reuse: list active runbooks in this repository, choose by the task without requiring an exact name, infer the inputs from the request and repository, and use its exact version. Ask only when information is missing or the match is ambiguous. Check prerequisites before editing. Changed or unknown prerequisites require needs_input and a specific user decision. Execute with your normal tools and permissions, report actual artifacts/checks, and keep missing evidence unknown. Updating the shared runbook is a separate reviewed revision.",
     ].join("\n");
     // Confirm each complete part in the host's current context. New workflow
     // instructions still go out after discovery; compaction restores both, and
-    // the instructions too once the session has started saving an approach.
+    // the instructions too once the session has started saving a runbook.
     return [discovery, ...(detailed ? [instructions] : [])]
         .filter(part => !retained.some(text => text.includes(part)))
         .join("\n\n") || undefined;

package/dist/approach-guidance.js.map

@@ -1 +1 @@
-{"version":3,"file":"approach-guidance.js","sourceRoot":"","sources":["../src/approach-guidance.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,OAAO,iFAAiF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa,EAAE,SAAiB,EAAE,WAA8B,EAAE,EAAE,eAAe,GAAG,KAAK;IAC1I,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,q0BAAq0B,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC;IAC/3B,MAAM,QAAQ,GAAG,eAAe,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,CAAC,ycAAyc;QAC7d,oIAAoI,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,kJAAkJ;QAC7U,kUAAkU;QAClU,4aAA4a;QAC5a,irBAAirB;QACjrB,4QAA4Q;QAC5Q,giBAAgiB;KACjiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACpD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"approach-guidance.js","sourceRoot":"","sources":["../src/approach-guidance.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,OAAO,0MAA0M,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjO,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,KAAa,EAAE,SAAiB,EAAE,WAA8B,EAAE,EAAE,eAAe,GAAG,KAAK;IAC1I,4EAA4E;IAC5E,0EAA0E;IAC1E,MAAM,SAAS,GAAG,w2BAAw2B,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC;IACl6B,MAAM,QAAQ,GAAG,eAAe,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,CAAC,ucAAuc;QAC3d,oIAAoI,IAAI,CAAC,SAAS,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,kJAAkJ;QAC7U,kUAAkU;QAClU,0aAA0a;QAC1a,irBAAirB;QACjrB,4QAA4Q;QAC5Q,6hBAA6hB;KAC9hB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,yEAAyE;IACzE,2EAA2E;IAC3E,sEAAsE;IACtE,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SACpD,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;AAC/B,CAAC"}

package/dist/approach.d.ts

@@ -1,6 +1,6 @@
 import { LoreClient } from "@lore-co/sdk";
 import type { ConnectorConfig } from "./cli.js";
-export declare const APPROACH_HELP = "lore approach \u2014 save and reuse a reviewed way of working\n\nUsage: lore approach <operation> --input <JSON-file|->\n\nWrite the request to a temporary JSON file and pass its path. Standard input (-)\nis for programs that pipe JSON; an agent should not put approach JSON or its\nfree-text values on the command line. Hosts that offer the Lore MCP tools\n(search_approaches, get_approach, prepare_approach, use_approach,\nreport_approach_run, decide_approach_run) record the same operations without a\nshell command; prefer them when available.\n\nOperations (JSON response):\n  prepare  {repo?, sessionId?, externalSessionId?, agent?, sessionIds?, learningIds?, notes?, task?}\n           Reads captured source work. sessionId is Lore's UUID; externalSessionId\n           resolves the current native agent session. sessionIds adds further\n           captured sessions (10 at most) and learningIds adds active learnings\n           from the same repository (50 at most). Pass notes for missing work.\n           The response lists every source under \"sources\" with its current state.\n  draft    {repo?, document, source, agent, requestId}\n           Keeps a draft using the exact source from prepare. Does not activate it.\n  list     {repo?, query?, status?}  (defaults to active in the current repository)\n  get      {id, version?}\n  revise   {id, expectedVersion, document}  (creates a separate draft version)\n  save     {id, expectedVersion, validation}\n           Only after the user reviews and asks to save. Describe the actual final\n           artifact and checks; keep a draft when these are missing.\n           Submits for owner or admin approval in Learnings before reuse.\n  use      {id, version, repo?, agent, sessionId, inputs, requestId}\n           Returns steps and records a run. Check current prerequisites BEFORE\n           editing. The agent executes with its normal tools and permissions.\n  report   {id, outcome, summary, prerequisiteChecks, checks, artifacts, adjustment?}\n           Outcomes: needs_input, completed, failed, unknown, stopped.\n           Each prerequisite: {prerequisite, result: passed|changed|unknown, detail}\n           Each check: {check, result: passed|failed|unknown, output}\n  decide   {id, action: continue|stop, reason}\n           Record the user's explicit decision for a paused run; never infer it.\n  runs     {id}\n\nDocument: {name, purpose, inputs: [{name, description, required}], steps: string[],\n           prerequisites: string[], checks: string[], stopConditions: string[],\n           citations?: [{field: steps|prerequisites|checks|stopConditions, index,\n                         sources: [{kind: session|learning, id}]}]}\nCite the learning or session an item rests on; cite only ids from prepare's\nsources. Items without a citation are allowed and are shown as unsupported for\nreview. Citing never creates a learning: capture a missing correction separately.\nDraft variable task values (resource, fields, ordering) as inputs. Preserve actual\nrepository helper names, module paths, and contracts as prerequisites; replacing\na dependency requires a decision. Keep essential steps and durable constraints,\nnot incidental tool failures or the original task's chosen input values.\nAim for 3\u20137 essential steps. Every result check is REQUIRED for every supported\nuse. Put optional diagnostics in steps, not checks; reproducing the source\ndefect must not block new work with no prior defect.\nStop conditions must not contradict the inputs the approach supports.\nUse the exact prerequisite/check text in reports. Missing evidence is unknown;\nGuard authorization is not proof of execution. A one-run adjustment does not\nchange the shared approach. Request IDs are UUIDs; reuse them on uncertain retries.\nUse source snapshots returned by prepare, never construct them yourself.\nThese commands use the current folder's existing Lore connection.\n";
+export declare const APPROACH_HELP = "lore runbook \u2014 save and reuse a reviewed runbook\n\nUsage: lore runbook <operation> --input <JSON-file|->\n       (lore approach is the same command; runbooks were called approaches)\n\nWrite the request to a temporary JSON file and pass its path. Standard input (-)\nis for programs that pipe JSON; an agent should not put runbook JSON or its\nfree-text values on the command line. Hosts that offer the Lore MCP tools\n(search_approaches, get_approach, prepare_approach, use_approach,\nreport_approach_run, decide_approach_run) record the same operations without a\nshell command; prefer them when available.\n\nOperations (JSON response):\n  prepare  {repo?, scope?, sessionId?, externalSessionId?, agent?, sessionIds?, learningIds?, notes?, task?}\n           Reads captured source work. sessionId is Lore's UUID; externalSessionId\n           resolves the current native agent session. sessionIds adds further\n           captured sessions (10 at most) and learningIds adds active learnings\n           from the same repository (50 at most). Pass notes for missing work.\n           The response lists every source under \"sources\" with its current state.\n           scope \"workspace\" makes a runbook for the whole workspace, such as a\n           release or incident runbook: sources may come from any repository\n           where Lore is on, and an owner or admin approves it.\n  draft    {repo?, scope?, document, source, agent, requestId}\n           Keeps a draft using the exact source from prepare. Does not activate it.\n  list     {repo?, query?, status?}  (defaults to active in the current repository)\n  get      {id, version?}\n  revise   {id, expectedVersion, document}  (creates a separate draft version)\n  save     {id, expectedVersion, validation}\n           Only after the user reviews and asks to save. Describe the actual final\n           artifact and checks; keep a draft when these are missing.\n           Submits for owner or admin approval in Learnings before reuse.\n  use      {id, version, repo?, agent, sessionId, inputs, requestId}\n           Returns steps and records a run. Check current prerequisites BEFORE\n           editing. The agent executes with its normal tools and permissions.\n  report   {id, outcome, summary, prerequisiteChecks, checks, artifacts, adjustment?}\n           Outcomes: needs_input, completed, failed, unknown, stopped.\n           Each prerequisite: {prerequisite, result: passed|changed|unknown, detail}\n           Each check: {check, result: passed|failed|unknown, output}\n  decide   {id, action: continue|stop, reason}\n           Record the user's explicit decision for a paused run; never infer it.\n  runs     {id}\n\nDocument: {name, purpose, inputs: [{name, description, required}], steps: string[],\n           prerequisites: string[], checks: string[], stopConditions: string[],\n           stopAtSteps?: [{condition, step}] (a stop condition about one step),\n           citations?: [{field: steps|prerequisites|checks|stopConditions, index,\n                         sources: [{kind: session|learning, id}]}]}\nCite the learning or session an item rests on; cite only ids from prepare's\nsources. Items without a citation are allowed and are shown as unsupported for\nreview. Citing never creates a learning: capture a missing correction separately.\nDraft variable task values (resource, fields, ordering) as inputs. Preserve actual\nrepository helper names, module paths, and contracts as prerequisites; replacing\na dependency requires a decision. Keep essential steps and durable constraints,\nnot incidental tool failures or the original task's chosen input values.\nAim for 3\u20137 essential steps. Every result check is REQUIRED for every supported\nuse. Put optional diagnostics in steps, not checks; reproducing the source\ndefect must not block new work with no prior defect.\nStop conditions must not contradict the inputs the runbook supports.\nUse the exact prerequisite/check text in reports. Missing evidence is unknown;\nGuard authorization is not proof of execution. Describe any step you changed in\nthe report's adjustment; reviewers are offered it for the next version, and the\nshared runbook changes only when they approve one. Request IDs are UUIDs; reuse them on uncertain retries.\nUse source snapshots returned by prepare, never construct them yourself.\nThese commands use the current folder's existing Lore connection.\n";
 export declare function runApproachCommand(args: readonly string[], config: ConnectorConfig | null): Promise<void>;
 export declare function executeApproachCommand(client: LoreClient, operation: string, value: Record<string, unknown>, repo: string): Promise<unknown>;
 //# sourceMappingURL=approach.d.ts.map

package/dist/approach.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approach.d.ts","sourceRoot":"","sources":["../src/approach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,eAAO,MAAM,aAAa,62HA0DzB,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/G;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BlJ"}
+{"version":3,"file":"approach.d.ts","sourceRoot":"","sources":["../src/approach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAIhD,eAAO,MAAM,aAAa,61IAgEzB,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB/G;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA0BlJ"}

package/dist/approach.js

@@ -3,25 +3,29 @@ import { LoreClient, SharedMemoryApiError } from "@lore-co/sdk";
 import { z } from "zod";
 import { repositoryScopeFromDirectory } from "@lore-co/core/repository-location";
 import { openNoFollow } from "@lore-co/core/no-follow";
-export const APPROACH_HELP = `lore approach — save and reuse a reviewed way of working
+export const APPROACH_HELP = `lore runbook — save and reuse a reviewed runbook
 
-Usage: lore approach <operation> --input <JSON-file|->
+Usage: lore runbook <operation> --input <JSON-file|->
+       (lore approach is the same command; runbooks were called approaches)
 
 Write the request to a temporary JSON file and pass its path. Standard input (-)
-is for programs that pipe JSON; an agent should not put approach JSON or its
+is for programs that pipe JSON; an agent should not put runbook JSON or its
 free-text values on the command line. Hosts that offer the Lore MCP tools
 (search_approaches, get_approach, prepare_approach, use_approach,
 report_approach_run, decide_approach_run) record the same operations without a
 shell command; prefer them when available.
 
 Operations (JSON response):
-  prepare  {repo?, sessionId?, externalSessionId?, agent?, sessionIds?, learningIds?, notes?, task?}
+  prepare  {repo?, scope?, sessionId?, externalSessionId?, agent?, sessionIds?, learningIds?, notes?, task?}
            Reads captured source work. sessionId is Lore's UUID; externalSessionId
            resolves the current native agent session. sessionIds adds further
            captured sessions (10 at most) and learningIds adds active learnings
            from the same repository (50 at most). Pass notes for missing work.
            The response lists every source under "sources" with its current state.
-  draft    {repo?, document, source, agent, requestId}
+           scope "workspace" makes a runbook for the whole workspace, such as a
+           release or incident runbook: sources may come from any repository
+           where Lore is on, and an owner or admin approves it.
+  draft    {repo?, scope?, document, source, agent, requestId}
            Keeps a draft using the exact source from prepare. Does not activate it.
   list     {repo?, query?, status?}  (defaults to active in the current repository)
   get      {id, version?}
@@ -43,6 +47,7 @@ Operations (JSON response):
 
 Document: {name, purpose, inputs: [{name, description, required}], steps: string[],
            prerequisites: string[], checks: string[], stopConditions: string[],
+           stopAtSteps?: [{condition, step}] (a stop condition about one step),
            citations?: [{field: steps|prerequisites|checks|stopConditions, index,
                          sources: [{kind: session|learning, id}]}]}
 Cite the learning or session an item rests on; cite only ids from prepare's
@@ -55,10 +60,11 @@ not incidental tool failures or the original task's chosen input values.
 Aim for 3–7 essential steps. Every result check is REQUIRED for every supported
 use. Put optional diagnostics in steps, not checks; reproducing the source
 defect must not block new work with no prior defect.
-Stop conditions must not contradict the inputs the approach supports.
+Stop conditions must not contradict the inputs the runbook supports.
 Use the exact prerequisite/check text in reports. Missing evidence is unknown;
-Guard authorization is not proof of execution. A one-run adjustment does not
-change the shared approach. Request IDs are UUIDs; reuse them on uncertain retries.
+Guard authorization is not proof of execution. Describe any step you changed in
+the report's adjustment; reviewers are offered it for the next version, and the
+shared runbook changes only when they approve one. Request IDs are UUIDs; reuse them on uncertain retries.
 Use source snapshots returned by prepare, never construct them yourself.
 These commands use the current folder's existing Lore connection.
 `;
@@ -69,7 +75,7 @@ export async function runApproachCommand(args, config) {
     }
     const [operation, flag, path] = args;
     if (!operation || flag !== "--input" || !path || args.length !== 3)
-        throw new Error("Usage: lore approach <operation> --input <JSON-file|->. See lore approach --help.");
+        throw new Error("Usage: lore runbook <operation> --input <JSON-file|->. See lore runbook --help.");
     if (!config)
         throw new Error("Lore is not connected. Run lore connect --login.");
     let raw = "";
@@ -77,7 +83,7 @@ export async function runApproachCommand(args, config) {
         for await (const chunk of process.stdin) {
             raw += String(chunk);
             if (Buffer.byteLength(raw) > 256000)
-                throw new Error("Approach input is too large.");
+                throw new Error("Runbook input is too large.");
         }
     }
     else {
@@ -100,7 +106,7 @@ export async function runApproachCommand(args, config) {
     }
     catch (error) {
         if (error instanceof SharedMemoryApiError)
-            throw new Error(`Lore approach ${operation} failed (HTTP ${error.status}). Check the source, current version, permissions, and workspace review policy. No success was confirmed.`);
+            throw new Error(`Lore runbook ${operation} failed (HTTP ${error.status}). Check the source, current version, permissions, and workspace review policy. No success was confirmed.`);
         throw error;
     }
 }
@@ -130,7 +136,7 @@ export async function executeApproachCommand(client, operation, value, repo) {
         case "report": return client.reportApproachRun(identity(), input);
         case "decide": return client.decideApproachRun(identity(), input);
         case "runs": return client.listApproachRuns(identity());
-        default: throw new Error("Unknown approach operation. See lore approach --help.");
+        default: throw new Error("Unknown runbook operation. See lore runbook --help.");
     }
 }
 //# sourceMappingURL=approach.js.map

package/dist/approach.js.map

@@ -1 +1 @@
-{"version":3,"file":"approach.js","sourceRoot":"","sources":["../src/approach.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"approach.js","sourceRoot":"","sources":["../src/approach.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -2,7 +2,7 @@
 import { parseDirectoryRules, checkDirectory, checkDirectoryRules, checkLoreAccess, checkWorkspaceRepository, capturePauseMessage, LORE_DISABLED_MESSAGE, loreDisabled } from "./directory-policy.js";
 import { reportCommand, runTelemetryCommand, telemetryEnabled, trackedCommand, TELEMETRY_HELP } from "./telemetry.js";
 import { secureWindowsDirectory, windowsPermissionsArePrivate } from "./windows-permissions.js";
-import { COMMAND_GUIDES, ROOT_HELP, helpTopic } from "./command-help.js";
+import { ALL_HELP, COMMAND_GUIDES, ROOT_HELP, helpTopic } from "./command-help.js";
 import { runShareCommand } from "./share.js";
 import { resolveConnectProject, validateConnectProjectOptions } from "./connect-project.js";
 import { captureDirectories } from "./capture-scope.js";
@@ -3914,7 +3914,7 @@ async function printCommandHelp(path) {
         case "drafts":
             await runDraftsCommand(args, null);
             return;
-        case "approach":
+        case "runbook":
             await runApproachCommand(args, null);
             return;
         case "skill":
@@ -3987,6 +3987,8 @@ async function executeCli(args = process.argv.slice(2)) {
         const path = args.slice(1);
         if (!path.length || (path.length === 1 && ["--help", "-h"].includes(path[0])))
             process.stdout.write(ROOT_HELP);
+        else if (path.length === 1 && path[0] === "--all")
+            process.stdout.write(ALL_HELP);
         else
             await printCommandHelp(path);
         return;
@@ -4008,8 +4010,8 @@ async function executeCli(args = process.argv.slice(2)) {
         return;
     }
     const commandArgs = args.slice(1);
-    if (["ask", "chat", "learnings", "review", "remember", "drafts", "share", "resume", "continue", "approach", "skill"].includes(command) && !(command === "skill" && commandArgs[0] === "discover")) {
-        const decision = await checkDirectory(process.cwd(), getLorePaths(["approach", "skill"].includes(command) ? process.env.LORE_HOME : undefined).home);
+    if (["ask", "chat", "learnings", "review", "remember", "drafts", "share", "resume", "continue", "approach", "runbook", "skill"].includes(command) && !(command === "skill" && commandArgs[0] === "discover")) {
+        const decision = await checkDirectory(process.cwd(), getLorePaths(["approach", "runbook", "skill"].includes(command) ? process.env.LORE_HOME : undefined).home);
         if (!decision.allowed)
             throw new Error(`Lore is off in this folder. ${decision.reason}`);
     }
@@ -4066,7 +4068,9 @@ async function executeCli(args = process.argv.slice(2)) {
         case "drafts":
             await runDraftsCommand(commandArgs, await readConnectorConfig(getLorePaths(), process.cwd()));
             return;
+        // Runbooks were called approaches; both commands stay.
         case "approach":
+        case "runbook":
             await runApproachCommand(commandArgs, await readConnectorConfig(getLorePaths(process.env.LORE_HOME), process.cwd()));
             return;
         case "skill":