@phren/cli 0.3.72 → 0.3.74

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 (81) hide show
  1. package/dist/bridge/agent-hooks.js +11 -1
  2. package/dist/bridge/browser-env.d.ts +1 -1
  3. package/dist/bridge/browser-env.js +34 -10
  4. package/dist/bridge/browser-watch.d.ts +12 -0
  5. package/dist/bridge/browser-watch.js +83 -0
  6. package/dist/bridge/claude-account-setup.js +3 -1
  7. package/dist/bridge/claude-accounts.d.ts +5 -1
  8. package/dist/bridge/claude-accounts.js +36 -6
  9. package/dist/bridge/claude-question-dialog.d.ts +2 -3
  10. package/dist/bridge/claude-question-dialog.js +129 -46
  11. package/dist/bridge/codex-servers.d.ts +2 -0
  12. package/dist/bridge/codex-servers.js +1 -1
  13. package/dist/bridge/command.js +24 -5
  14. package/dist/bridge/conductor-sets.d.ts +2 -1
  15. package/dist/bridge/conductor-sets.js +3 -2
  16. package/dist/bridge/dialog-observation.d.ts +4 -0
  17. package/dist/bridge/dialog-observation.js +24 -0
  18. package/dist/bridge/dispatch-clone.d.ts +33 -0
  19. package/dist/bridge/dispatch-clone.js +176 -0
  20. package/dist/bridge/dispatch-command.d.ts +14 -0
  21. package/dist/bridge/dispatch-command.js +98 -13
  22. package/dist/bridge/dispatch-idempotency.d.ts +85 -0
  23. package/dist/bridge/dispatch-idempotency.js +235 -0
  24. package/dist/bridge/dispatch-returns.d.ts +6 -0
  25. package/dist/bridge/dispatch-returns.js +131 -1
  26. package/dist/bridge/dispatch-wait.d.ts +32 -0
  27. package/dist/bridge/dispatch-wait.js +177 -0
  28. package/dist/bridge/dispatch.d.ts +68 -2
  29. package/dist/bridge/dispatch.js +839 -25
  30. package/dist/bridge/fanouts.js +20 -3
  31. package/dist/bridge/files.d.ts +1 -1
  32. package/dist/bridge/git-credential.d.ts +44 -0
  33. package/dist/bridge/git-credential.js +113 -0
  34. package/dist/bridge/git-host-auth.d.ts +9 -1
  35. package/dist/bridge/git-host-auth.js +18 -5
  36. package/dist/bridge/git-host-gitboy.js +8 -1
  37. package/dist/bridge/git-hosts.d.ts +12 -1
  38. package/dist/bridge/git-publish.js +3 -2
  39. package/dist/bridge/herdr.d.ts +4 -0
  40. package/dist/bridge/herdr.js +29 -3
  41. package/dist/bridge/install.d.ts +1 -1
  42. package/dist/bridge/install.js +8 -4
  43. package/dist/bridge/launch-worktree.d.ts +2 -0
  44. package/dist/bridge/launch-worktree.js +5 -1
  45. package/dist/bridge/pane-status.js +2 -19
  46. package/dist/bridge/protocol.d.ts +7 -0
  47. package/dist/bridge/schedule-watch.js +13 -2
  48. package/dist/bridge/server-launch.d.ts +2 -0
  49. package/dist/bridge/server-launch.js +251 -145
  50. package/dist/bridge/server-pane-routes.d.ts +1 -1
  51. package/dist/bridge/server-pane-routes.js +12 -9
  52. package/dist/bridge/server-routes.js +26 -8
  53. package/dist/bridge/server.js +12 -1
  54. package/dist/bridge/status-line-fast.d.ts +9 -0
  55. package/dist/bridge/status-line-fast.js +56 -0
  56. package/dist/bridge/terminal-herdr.d.ts +5 -1
  57. package/dist/bridge/terminal-herdr.js +65 -1
  58. package/dist/bridge/terminal-tmux.d.ts +6 -0
  59. package/dist/bridge/terminal-tmux.js +38 -11
  60. package/dist/bridge/terminal.d.ts +5 -1
  61. package/dist/bridge/transcript-claude.d.ts +7 -0
  62. package/dist/bridge/transcript-claude.js +227 -112
  63. package/dist/bridge/transcript-preview.d.ts +2 -1
  64. package/dist/bridge/transcript-preview.js +85 -3
  65. package/dist/bridge/transcripts.js +17 -11
  66. package/dist/bridge/turn-records.js +16 -4
  67. package/dist/bridge/usage.d.ts +7 -1
  68. package/dist/bridge/usage.js +47 -31
  69. package/dist/bridge/worker-close.d.ts +15 -0
  70. package/dist/bridge/worker-close.js +304 -3
  71. package/dist/bridge/worker-identity.d.ts +51 -0
  72. package/dist/bridge/worker-identity.js +289 -0
  73. package/dist/bridge-hook.mjs +22097 -19129
  74. package/dist/cli/browser-hint.d.ts +2 -0
  75. package/dist/cli/browser-hint.js +21 -0
  76. package/dist/cli/hooks-context.d.ts +2 -2
  77. package/dist/cli/hooks-context.js +3 -3
  78. package/dist/cli/hooks.js +20 -11
  79. package/dist/cli-registry.js +5 -3
  80. package/dist/modules/registry.js +1 -1
  81. package/package.json +3 -3
@@ -0,0 +1,2 @@
1
+ /** Claim the notice atomically: parallel prompt hooks share the session marker. */
2
+ export declare function browserHint(phrenPath: string, prompt: string, session: string | undefined, proactivity: string): string | undefined;
@@ -0,0 +1,21 @@
1
+ import { createHash } from "node:crypto";
2
+ import { closeSync, existsSync, openSync } from "node:fs";
3
+ import { browserSocketPath } from "../bridge/browser-socket.js";
4
+ import { sessionMarker } from "../shared.js";
5
+ /** Claim the notice atomically: parallel prompt hooks share the session marker. */
6
+ export function browserHint(phrenPath, prompt, session, proactivity) {
7
+ if (!session || proactivity === "low" || proactivity === "off" || process.env.PHREN_PROACTIVITY === "off"
8
+ || process.env.PHREN_BROWSER_SOCKET || process.env.PHREN_BROWSER_WATCH === "0"
9
+ || !/\b(?:playwright|browser|ui\s+walk(?:through)?|screenshots?)\b/i.test(prompt)
10
+ || (process.platform !== "win32" && !existsSync(browserSocketPath())))
11
+ return undefined;
12
+ try {
13
+ const key = createHash("sha256").update(session).digest("hex");
14
+ closeSync(openSync(sessionMarker(phrenPath, `browser-hint-${key}`), "wx", 0o600));
15
+ }
16
+ catch {
17
+ return undefined;
18
+ }
19
+ return 'To let the owner watch this browser in Phren, start Playwright after: eval "$(phren browser env)"'
20
+ + (/\bbun\b/i.test(prompt) ? "; Bun: use --preload <shim> and shim.initPage({ page }); see phren browser env." : "");
21
+ }
@@ -24,11 +24,11 @@ export { resolveRuntimeProfile } from "../runtime-profile.js";
24
24
  export { detectProjectDir, ensureLocalGitRepo, isProjectTracked, repairPreexistingInstall, } from "../init/setup.js";
25
25
  export { getProactivityLevelForTask, getProactivityLevelForFindings } from "../proactivity.js";
26
26
  export { hasExplicitFindingSignal, shouldAutoCaptureFindingsForLevel } from "../proactivity.js";
27
- export { FINDING_SENSITIVITY_CONFIG } from "./config.js";
27
+ export { FINDING_SENSITIVITY_CONFIG } from "./config-policy.js";
28
28
  export { isFeatureEnabled, errorMessage } from "../utils.js";
29
29
  export { bootstrapPhrenDotEnv } from "../phren-dotenv.js";
30
30
  export { finalizeTaskSession } from "../task/lifecycle.js";
31
31
  export { appendFindingJournal } from "../finding/journal.js";
32
- export { getHooksEnabledPreference } from "../init/init.js";
32
+ export { getHooksEnabledPreference } from "../init/preferences.js";
33
33
  export { isToolHookEnabled } from "../hooks.js";
34
34
  export { runDoctor } from "../link/link.js";
@@ -4,7 +4,7 @@
4
4
  import { getPhrenPath, readRootManifest, appendAuditLog, } from "../shared.js";
5
5
  import { updateRuntimeHealth, } from "../shared/governance.js";
6
6
  import { detectProject } from "../shared/index.js";
7
- import { getHooksEnabledPreference } from "../init/init.js";
7
+ import { getHooksEnabledPreference } from "../init/preferences.js";
8
8
  import { isToolHookEnabled } from "../hooks.js";
9
9
  import { isProjectHookEnabled } from "../project-config.js";
10
10
  import { resolveRuntimeProfile } from "../runtime-profile.js";
@@ -46,11 +46,11 @@ export { resolveRuntimeProfile } from "../runtime-profile.js";
46
46
  export { detectProjectDir, ensureLocalGitRepo, isProjectTracked, repairPreexistingInstall, } from "../init/setup.js";
47
47
  export { getProactivityLevelForTask, getProactivityLevelForFindings } from "../proactivity.js";
48
48
  export { hasExplicitFindingSignal, shouldAutoCaptureFindingsForLevel } from "../proactivity.js";
49
- export { FINDING_SENSITIVITY_CONFIG } from "./config.js";
49
+ export { FINDING_SENSITIVITY_CONFIG } from "./config-policy.js";
50
50
  export { isFeatureEnabled, errorMessage } from "../utils.js";
51
51
  export { bootstrapPhrenDotEnv } from "../phren-dotenv.js";
52
52
  export { finalizeTaskSession } from "../task/lifecycle.js";
53
53
  export { appendFindingJournal } from "../finding/journal.js";
54
- export { getHooksEnabledPreference } from "../init/init.js";
54
+ export { getHooksEnabledPreference } from "../init/preferences.js";
55
55
  export { isToolHookEnabled } from "../hooks.js";
56
56
  export { runDoctor } from "../link/link.js";
package/dist/cli/hooks.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { browserHint } from "./browser-hint.js";
1
2
  import { moduleEnabled } from "../modules/runtime.js";
2
3
  // cli-hooks.ts — Thin orchestrator. Delegates to focused modules:
3
4
  // shared-retrieval.ts — shared search, scoring, ranking, snippet selection
@@ -11,14 +12,15 @@ import { loadIndexForHook, detectProject, } from "../shared/index.js";
11
12
  import { isProjectHookEnabled } from "../project-config.js";
12
13
  import { checkConsolidationNeeded, } from "../shared/content.js";
13
14
  import { buildRobustFtsQuery, extractKeywordEntries, isFeatureEnabled, clampInt, clampFloat, errorMessage, } from "../utils.js";
14
- import { getHooksEnabledPreference } from "../init/init.js";
15
+ import { getHooksEnabledPreference } from "../init/preferences.js";
16
+ import { classifyClaudePromptText } from "../bridge/input-classification.js";
15
17
  import { logger } from "../logger.js";
16
18
  import { isToolHookEnabled, runPrePromptHooks } from "../hooks.js";
17
19
  import { handleExtractMemories } from "./extract.js";
18
20
  import { appendAuditLog } from "../shared.js";
19
21
  import { updateRuntimeHealth } from "../shared/governance.js";
20
- import { getProactivityLevelForTask, getProactivityLevelForFindings } from "../proactivity.js";
21
- import { FINDING_SENSITIVITY_CONFIG } from "./config.js";
22
+ import { getProactivityLevel, getProactivityLevelForTask, getProactivityLevelForFindings } from "../proactivity.js";
23
+ import { FINDING_SENSITIVITY_CONFIG } from "./config-policy.js";
22
24
  import * as fs from "fs";
23
25
  // ── Re-exports from focused modules ─────────────────────────────────────────
24
26
  // Citations
@@ -81,6 +83,10 @@ export async function handleHookPrompt() {
81
83
  if (!input)
82
84
  process.exit(0);
83
85
  const { prompt, cwd, sessionId } = input;
86
+ // A background agent's result or a teammate's message is not the owner asking anything:
87
+ // the context pass (about a second on a busy store) has nothing to answer.
88
+ if (classifyClaudePromptText(prompt).category === "notification")
89
+ process.exit(0);
84
90
  if (!getHooksEnabledPreference(getPhrenPath())) {
85
91
  appendAuditLog(getPhrenPath(), "hook_prompt", "status=disabled");
86
92
  process.exit(0);
@@ -93,6 +99,17 @@ export async function handleHookPrompt() {
93
99
  process.exit(0);
94
100
  }
95
101
  updateRuntimeHealth(getPhrenPath(), { lastPromptAt: new Date().toISOString() });
102
+ const detectedProject = cwd ? detectProject(getPhrenPath(), cwd, profile) : null;
103
+ if (detectedProject)
104
+ debugLog(`Detected project: ${detectedProject}`);
105
+ if (!isProjectHookEnabled(getPhrenPath(), detectedProject, "UserPromptSubmit")) {
106
+ appendAuditLog(getPhrenPath(), "hook_prompt", `status=project_disabled project=${detectedProject}`);
107
+ process.exit(0);
108
+ }
109
+ const resolvedConfig = mergeConfig(getPhrenPath(), detectedProject ?? undefined);
110
+ const watchHint = browserHint(getPhrenPath(), prompt, sessionId, resolvedConfig.proactivity.base ?? getProactivityLevel(getPhrenPath()));
111
+ if (watchHint)
112
+ console.log(watchHint);
96
113
  const keywordEntries = extractKeywordEntries(prompt);
97
114
  const keywords = keywordEntries.join(" ");
98
115
  if (!keywords)
@@ -126,17 +143,9 @@ export async function handleHookPrompt() {
126
143
  const db = await loadIndexForHook(getPhrenPath(), profile);
127
144
  stage.indexMs = Date.now() - tIndex0;
128
145
  const intent = detectTaskIntent(prompt);
129
- const detectedProject = cwd ? detectProject(getPhrenPath(), cwd, profile) : null;
130
- if (detectedProject)
131
- debugLog(`Detected project: ${detectedProject}`);
132
- if (!isProjectHookEnabled(getPhrenPath(), detectedProject, "UserPromptSubmit")) {
133
- appendAuditLog(getPhrenPath(), "hook_prompt", `status=project_disabled project=${detectedProject}`);
134
- process.exit(0);
135
- }
136
146
  // Resolve git context AFTER the enabled check — it spawns 3 git processes and is
137
147
  // wasted work when the project has hooks disabled.
138
148
  const gitCtx = moduleEnabled(getPhrenPath(), "git") ? getGitContext(cwd) : null;
139
- const resolvedConfig = mergeConfig(getPhrenPath(), detectedProject ?? undefined);
140
149
  const safeQuery = buildRobustFtsQuery(keywords, detectedProject, getPhrenPath());
141
150
  if (!safeQuery)
142
151
  process.exit(0);
@@ -141,7 +141,7 @@ const TEAM_SUBCOMMANDS = [
141
141
  export const REGISTRY = [
142
142
  { name: "browser", topic: "setup", usage: "phren browser <env|ask>", summary: "Watch a browser or ask the owner for help", standalone: true,
143
143
  subcommands: [
144
- { name: "env", usage: "phren browser env", summary: "Print browser watching environment" },
144
+ { name: "env", usage: "phren browser env [--session <name>] [--json | --fish]", summary: 'Start Playwright after eval "$(phren browser env)"; see Bun preload guidance in output' },
145
145
  { name: "ask", usage: 'phren browser ask "<reason>" [--browser <id>] [--timeout <s>]', summary: "Wait for owner help (900 s default); Ctrl-C cancels" },
146
146
  ],
147
147
  run: async (args) => { const { runBrowser } = await import("./bridge/browser-env.js"); return runBrowser(args); } },
@@ -155,7 +155,7 @@ export const REGISTRY = [
155
155
  },
156
156
  },
157
157
  {
158
- name: "bridge", topic: "setup", usage: "phren bridge <install|status|doctor|update|rollback|uninstall|enroll-computer|accounts|discover|link|fanouts archive|git-host|speech-key set|speech-voice|speech-model|speech-region>",
158
+ name: "bridge", topic: "setup", usage: "phren bridge <install|status|doctor|update|rollback|uninstall|enroll-computer|accounts|discover|link|fanouts archive|git-host|git-credential|speech-key set|speech-voice|speech-model|speech-region>",
159
159
  summary: "Install Phren Hook and enroll phone or computer connections",
160
160
  subcommands: [
161
161
  { name: "enroll-computer", usage: "phren bridge enroll-computer <name> [--accept <public-key-file>]", summary: "Print or accept a restricted computer dispatch key" },
@@ -176,9 +176,11 @@ export const REGISTRY = [
176
176
  },
177
177
  },
178
178
  {
179
- name: "dispatch", topic: "core", usage: "phren dispatch <computer|anywhere> <project> --label <label> --prompt <brief> [--harness codex|claude|opencode|copilot] [--model <model>] [--effort <effort>] [--account <id>] [--permission-mode <mode>] [--keep-open]",
179
+ name: "dispatch", topic: "core", usage: "phren dispatch <computer|anywhere|local> <project> --prompt <brief> | --prompt-file <path|-> [--harness codex|claude|opencode|copilot] [--label <label>] [--idempotency-key <key>] [--worktree [--branch <name>]] [--model <model>] [--effort <effort>] [--account <id>] [--permission-mode <mode>] [--keep-open]",
180
180
  summary: "Dispatch a worker brief through Phren Hook",
181
181
  subcommands: [{ name: "status", usage: "phren dispatch status", summary: "List local dispatch receipts" },
182
+ { name: "wait", usage: "phren dispatch wait <dispatch-id> [--timeout <seconds>] [--json] [--follow]", summary: "Follow one local dispatch to its end as NDJSON; exits 0 done, 1 failed or gone, 124 timeout" },
183
+ { name: "close", usage: "phren dispatch close <dispatch-id> | phren dispatch close --idempotency-key <key>", summary: "Cancel a running local dispatch by id or idempotency key: stop its agent and close its pane" },
182
184
  { name: "returns", usage: "phren dispatch returns [--watch [--json] [--consume]]", summary: "List unread worker returns (done, needs you, blocked, gone) and mark them read; --watch prints them as they land until Ctrl-C, leaving them unread unless --consume" },
183
185
  { name: "sessions", usage: "phren dispatch sessions", summary: "List live agent sessions on this and every enrolled computer" },
184
186
  { name: "usage", usage: "phren dispatch usage [--json]", summary: "Show agent usage on this and every enrolled computer, merged by account" },
@@ -135,7 +135,7 @@ export const BUILTIN_MODULES = [
135
135
  schemaVersion: 1, name: "conductor", version: VERSION, defaultEnabled: false, requires: ["memory", "hook"],
136
136
  tools: full(["dispatch", "dispatch_returns", "dispatch_approve", "hand_off", "live_sessions", "account_usage", "machine_health", "authority", "dispatch_report", "owner_inbox", "move_session", "helper"]), cliCommands: ["dispatch", "dispatch status", "dispatch returns", "dispatch sessions", "dispatch usage", "dispatch report", "hand-off", "move", "conductor", "conductor grants", "conductor status", "conductor make", "conductor stop", "conductor sets", "conductor integrator", "owner-inbox", "authority", "bridge enroll-computer"], agentHooks: [],
137
137
  hookRoutes: [...routes("GET", ["/v1/dispatch", "/v1/dispatch/capacity", "/v1/conductor/move/status", "/v1/conductor/move/launch", "/v1/conductor/move/operation", "/v1/conductor/move/notification", "/v1/dispatch/brief", "/v1/conductor", "/v1/conductor/grants", "/v1/computers", "/v1/sets", "/v1/authority", "/v1/owner-inbox", "/v1/conductor/integrator"]),
138
- ...routes("POST", ["/v1/conductor/call", "/v1/conductor/move/prepare", "/v1/conductor/move/commit", "/v1/conductor/move/operate", "/v1/conductor/move/ack", "/v1/conductor/move/notice", "/v1/dispatch", "/v1/dispatch/workers", "/v1/dispatch/returns", "/v1/dispatch/approve", "/v1/dispatch/report", "/v1/dispatch/close", "/v1/dispatch/close-self", "/v1/owner-inbox", "/v1/conductor/integrator", "/v1/hand-off", "/v1/hand-off/status", "/v1/conductor/grants", "/v1/conductor/make", "/v1/conductor/stop", "/v1/sets/name", "/v1/sets/link", "/v1/authority", "/v1/authority/confirm"]), ...routes("DELETE", ["/v1/conductor/grants", "/v1/authority"])],
138
+ ...routes("POST", ["/v1/conductor/call", "/v1/conductor/move/prepare", "/v1/conductor/move/commit", "/v1/conductor/move/operate", "/v1/conductor/move/ack", "/v1/conductor/move/notice", "/v1/dispatch", "/v1/dispatch/workers", "/v1/dispatch/returns", "/v1/dispatch/approve", "/v1/dispatch/report", "/v1/dispatch/close", "/v1/dispatch/close-self", "/v1/dispatch/cancel", "/v1/dispatch/returns/ack", "/v1/owner-inbox", "/v1/conductor/integrator", "/v1/hand-off", "/v1/hand-off/status", "/v1/conductor/grants", "/v1/conductor/make", "/v1/conductor/stop", "/v1/sets/name", "/v1/sets/link", "/v1/authority", "/v1/authority/confirm"]), ...routes("DELETE", ["/v1/conductor/grants", "/v1/authority"])],
139
139
  capabilities: ["dispatch", "moveConductorToComputer", "conductorSets", "setLink", "ownerInbox", "workerReports", "queuedHandOff"], storeFiles: ["global/skills/conductor/**"],
140
140
  localFiles: ["<bridge>/hooks.yaml", "<bridge>/conductor.yaml", "<bridge>/conductor-role.json", "<bridge>/conductor-moves/**", "<bridge>/conductor/brief.md", "<bridge>/authority.yaml", "<bridge>/authority-confirmations.json", "<bridge>/dispatches/*.json", "<bridge>/hand-offs/*.json", "<bridge>/worker-reports/*.json", "<bridge>/closed-workers/*.json", "<bridge>/owner-inbox.json", "<bridge>/integrator.json"], phoneScreens: [], skills: ["conductor"],
141
141
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@phren/cli",
3
- "version": "0.3.72",
3
+ "version": "0.3.74",
4
4
  "description": "Knowledge layer for AI agents - CLI, MCP server, and data layer",
5
5
  "type": "module",
6
6
  "bin": {
@@ -207,13 +207,13 @@
207
207
  "dependencies": {
208
208
  "@modelcontextprotocol/sdk": "^1.32.0",
209
209
  "chalk": "^6.0.1",
210
- "glob": "^13.0.6",
210
+ "glob": "^14.0.2",
211
211
  "inquirer": "^14.2.3",
212
212
  "js-yaml": "^5.4.2",
213
213
  "sql.js-fts5": "^1.4.0",
214
214
  "uqr": "0.1.3",
215
215
  "ws": "8.22.0",
216
- "zod": "^4.6.5"
216
+ "zod": "^4.6.6"
217
217
  },
218
218
  "engines": {
219
219
  "node": ">=22.19.0"