@lore-co/cli 0.1.9 → 0.1.11

package/README.md

@@ -1,11 +1,11 @@
 # Lore CLI
 
-The Lore connector installs native Codex and Claude Code lifecycle hooks and
-the Lore OpenCode plugin. For each supported prompt, Lore attempts to retrieve
-relevant engineering context. A first prompt is observed on its own; later
-prompts are paired with the previous assistant response when valid pending
-state is available. Integration and network failures fail open so they do not
-block the agent.
+The Lore connector installs native Codex, Claude Code, Cursor, and Polytoken
+lifecycle hooks plus the Lore OpenCode plugin. For each supported prompt, Lore
+attempts to retrieve relevant engineering context. A first prompt is observed
+on its own; later prompts are paired with the previous assistant response when
+valid pending state is available. Integration and network failures fail open so they
+do not block the agent.
 
 ## Install and connect
 
@@ -13,20 +13,32 @@ block the agent.
 pnpm install --global @lore-co/cli
 
 lore connect \
-  --url https://api.uselore.co \
   --token "$LORE_WORKSPACE_TOKEN" \
   --agent claude \
   --agent codex \
-  --agent opencode
+  --agent cursor \
+  --agent opencode \
+  --agent polytoken
 
 lore doctor
 ```
 
 The package requires Node.js 22 or newer and installs the `lore` command.
 
-`connect` auto-detects the `codex`, `claude`, and `opencode` executables and an
-existing `~/.config/opencode/opencode.json`. Repeat `--agent claude`,
-`--agent codex`, or `--agent opencode` for an explicit headless install.
+`connect` auto-detects the `codex`, `claude`, `cursor`, `opencode`, and
+`polytoken` executables plus existing Cursor, OpenCode, and Polytoken
+configuration directories.
+Repeat `--agent claude`, `--agent codex`, `--agent cursor`, or
+`--agent opencode` for an explicit headless install. `--agent polytoken`
+updates `$XDG_CONFIG_HOME/polytoken/hooks.json` (normally
+`~/.config/polytoken/hooks.json`). `--agent t3code` detects and configures the
+supported Claude, Codex, Cursor, or OpenCode provider instances that T3 Code
+delegates to. It reads `$T3CODE_HOME/userdata/settings.json` or
+`~/.t3/userdata/settings.json`, follows custom provider homes, and does not
+modify T3 settings or secrets. External OpenCode servers must be configured on
+the server. Cursor ACP sessions require a live canary because Cursor does not
+guarantee lifecycle hooks in ACP mode. Lore does not install a duplicate T3
+lifecycle layer.
 Configuration is stored in `~/.lore/config.json` with mode `0600`.
 Before writing that file or any agent integration, `connect` calls the
 authenticated workspace identity endpoint and validates the strict response
@@ -34,6 +46,10 @@ and server version. Revoked credentials, unreachable servers, timeouts, and
 incompatible servers leave local configuration untouched. Either
 `LORE_WORKSPACE_TOKEN` or the legacy `LORE_TOKEN` can provide the token; if
 both are set, they must match.
+New token connections default to `https://api.uselore.co` and use
+`https://uselore.co` for receipt links. Self-hosted deployments must pass
+`--url` and may pass `--dashboard-url`; reconnecting without a new token keeps
+the existing self-hosted endpoints.
 For a review-first rollout in a personal vault or component catalog, follow the
 [OpenCode pilot runbook](../../docs/opencode-pilot.md).
 
@@ -41,7 +57,7 @@ For a review-first rollout in a personal vault or component catalog, follow the
 
 ```sh
 lore update
-lore update --version v0.1.9
+lore update --version v0.1.11
 ```
 
 `update` resolves the latest release to an exact tag, or uses the exact
@@ -51,11 +67,12 @@ version before replacing the current target. `LORE_REPO` selects another
 GitHub repository and `LORE_RELEASE_BASE_URL` selects an HTTPS release mirror;
 `LORE_BIN_DIR` overrides the standalone install directory.
 
-The command merges Lore-owned entries into `~/.codex/hooks.json` and
-`~/.claude/settings.json`, and merges `@lore-co/opencode` into the
-`plugin` array in `~/.config/opencode/opencode.json`. Existing settings, hooks,
-keys, and plugins are retained. Changed agent config files receive timestamped
-backups, and rerunning `connect` does not duplicate entries or backups.
+The command merges Lore-owned entries into `~/.codex/hooks.json`,
+`~/.claude/settings.json`, and `~/.cursor/hooks.json`, and merges
+`@lore-co/opencode` into the `plugin` array in
+`~/.config/opencode/opencode.json`. Existing settings, hooks, keys, and plugins
+are retained. Changed agent config files receive timestamped backups, and
+rerunning `connect` does not duplicate entries or backups.
 
 ## Inspect or remove
 
@@ -102,14 +119,19 @@ command has subcommand-specific `--help`, and `up`, `down`, and `status` support
 
 ## Runtime behavior
 
-The Claude/Codex command-hook handler:
+The Claude/Codex/Cursor/Polytoken command-hook handler:
 
-- reads native hook JSON from standard input;
+- reads native hook JSON from standard input and normalizes Cursor and
+  Polytoken event names;
 - observes and enriches the first prompt in a new session;
-- uses `last_assistant_message`, not a potentially stale transcript;
+- uses `last_assistant_message`, Cursor's `afterAgentResponse`, or Polytoken's
+  `post_model_turn`, not a potentially stale transcript;
 - stores pending state and failed turn requests under `~/.lore`;
 - retries one queued request on a later prompt;
-- redacts common API keys, bearer tokens, passwords, and private keys;
+- redacts common and contextual credentials, authenticated URLs, authorization
+  headers, cookies, provider tokens, and private keys before transport;
+- re-scans returned context immediately before Claude, Codex, Cursor, or Polytoken
+  injection and preserves `[REDACTED:<KIND>]` audit markers;
 - times out network calls and always fails open without writing hook errors.
 
 First prompts use `POST /v1/observations` and audited
@@ -126,7 +148,7 @@ all-repositories evidence may become organization-only and apply across
 repositories. Native retrieval still requires a strong lexical, structural,
 symbol, or semantic match. Observations, paired turns, OpenCode plugin events,
 and deliveries are visible through Lore activity. OpenCode uses its plugin
-lifecycle and never runs through the Claude/Codex command-hook parser.
+lifecycle and never runs through the command-hook parser.
 
 ## External hosts
 
@@ -226,7 +248,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` at `v0.1.9`. Set `LORE_CLI_REPOSITORY` to the publicly
+`treadiehq/lore` at `v0.1.11`. 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/cli.d.ts

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import { type CommandHookAgentName } from "./runtime.js";
 export declare const LORE_OPENCODE_PLUGIN = "@lore-co/opencode";
-declare const CONFIGURED_AGENT_NAMES: readonly ["claude", "codex", "opencode"];
+export declare const DEFAULT_HOSTED_API_URL = "https://api.uselore.co";
+export declare const DEFAULT_HOSTED_DASHBOARD_URL = "https://uselore.co";
+declare const CONFIGURED_AGENT_NAMES: readonly ["claude", "codex", "cursor", "opencode", "polytoken"];
 export type ConfiguredAgentName = (typeof CONFIGURED_AGENT_NAMES)[number];
 export interface LorePaths {
     home: string;
@@ -14,7 +16,11 @@ export interface LorePaths {
     queue: string;
     codexHooks: string;
     claudeSettings: string;
+    cursorHooks: string;
+    cursorUserData: string;
     openCodeConfig: string;
+    polytokenHooks: string;
+    t3Settings: string;
 }
 export interface ConnectorConfig {
     version: 1;
@@ -22,16 +28,35 @@ export interface ConnectorConfig {
     dashboardUrl?: string;
     token: string;
     agents: ConfiguredAgentName[];
+    agentConfigPaths?: Partial<Record<ConfiguredAgentName, string[]>>;
     connectedAt: string;
     timeoutMs: number;
 }
-export declare function getLorePaths(home?: string): LorePaths;
+export declare function getLorePaths(home?: string, environment?: NodeJS.ProcessEnv): LorePaths;
 export declare function mergeLoreHooks(input: Record<string, unknown>, agent: CommandHookAgentName, paths: LorePaths): Record<string, unknown>;
 export declare function removeLoreHooks(input: Record<string, unknown>): Record<string, unknown>;
 export declare function countLoreHooks(input: Record<string, unknown>): number;
+export declare function mergeLoreCursorHooks(input: Record<string, unknown>, paths: LorePaths): Record<string, unknown>;
+export declare function removeLoreCursorHooks(input: Record<string, unknown>): Record<string, unknown>;
+export declare function countLoreCursorHooks(input: Record<string, unknown>): number;
+export declare function mergeLorePolytokenHooks(input: unknown, paths: LorePaths): unknown[];
+export declare function removeLorePolytokenHooks(input: unknown): unknown[];
+export declare function countLorePolytokenHooks(input: unknown): number;
 export declare function mergeLoreOpenCodePlugin(input: Record<string, unknown>): Record<string, unknown>;
 export declare function removeLoreOpenCodePlugin(input: Record<string, unknown>): Record<string, unknown>;
 export declare function countLoreOpenCodePlugins(input: Record<string, unknown>): number;
+export declare function resolveConnectEndpoints(options?: {
+    apiUrl?: string;
+    dashboardUrl?: string;
+    environment?: NodeJS.ProcessEnv;
+    existing?: Pick<ConnectorConfig, "apiUrl" | "dashboardUrl"> | null;
+    preferHostedDefault?: boolean;
+}): Pick<ConnectorConfig, "apiUrl" | "dashboardUrl">;
+export interface AgentInstallation {
+    agent: ConfiguredAgentName;
+    configPath: string;
+}
+export declare function t3CodeProviderInstallations(settings: unknown, paths: LorePaths): AgentInstallation[];
 export declare function runCli(args?: readonly string[]): Promise<void>;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAuBA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,cAAc,CAAC;AAUtB,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AACxD,QAAA,MAAM,sBAAsB,0CAA2C,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAI1E,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmID,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAqBrD;AAuED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,SAAS,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBrE;AASD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAczB;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAIR;AAu1BD,wBAAsB,MAAM,CAC1B,IAAI,GAAE,SAAS,MAAM,EAA0B,GAC9C,OAAO,CAAC,IAAI,CAAC,CAuDf"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}