@phren/cli 0.2.14 → 0.2.16
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.
- package/README.md +2 -2
- package/dist/agent-instructions.d.ts +12 -0
- package/dist/agent-instructions.js +52 -0
- package/dist/bridge/agent-hook-stores.d.ts +32 -0
- package/dist/bridge/agent-hook-stores.js +67 -0
- package/dist/bridge/agent-hooks.d.ts +193 -2
- package/dist/bridge/agent-hooks.js +1045 -38
- package/dist/bridge/canary.d.ts +27 -0
- package/dist/bridge/canary.js +189 -0
- package/dist/bridge/changes.d.ts +57 -0
- package/dist/bridge/changes.js +403 -0
- package/dist/bridge/client.d.ts +3 -0
- package/dist/bridge/client.js +36 -0
- package/dist/bridge/code-note.d.ts +22 -0
- package/dist/bridge/code-note.js +42 -0
- package/dist/bridge/code-routes.d.ts +133 -0
- package/dist/bridge/code-routes.js +319 -0
- package/dist/bridge/codex-threads.d.ts +27 -0
- package/dist/bridge/codex-threads.js +442 -0
- package/dist/bridge/command.d.ts +7 -0
- package/dist/bridge/command.js +50 -5
- package/dist/bridge/computer-names.d.ts +4 -0
- package/dist/bridge/computer-names.js +16 -0
- package/dist/bridge/computers.d.ts +9 -0
- package/dist/bridge/computers.js +111 -0
- package/dist/bridge/context.d.ts +14 -0
- package/dist/bridge/context.js +149 -0
- package/dist/bridge/dispatch-command.d.ts +3 -0
- package/dist/bridge/dispatch-command.js +93 -0
- package/dist/bridge/dispatch-hosts.d.ts +23 -0
- package/dist/bridge/dispatch-hosts.js +25 -0
- package/dist/bridge/dispatch-returns.d.ts +123 -0
- package/dist/bridge/dispatch-returns.js +279 -0
- package/dist/bridge/dispatch-tree.d.ts +54 -0
- package/dist/bridge/dispatch-tree.js +198 -0
- package/dist/bridge/dispatch.d.ts +207 -0
- package/dist/bridge/dispatch.js +261 -0
- package/dist/bridge/enroll.d.ts +31 -0
- package/dist/bridge/enroll.js +236 -0
- package/dist/bridge/fanout-messages.d.ts +74 -0
- package/dist/bridge/fanout-messages.js +230 -0
- package/dist/bridge/fanouts.d.ts +160 -0
- package/dist/bridge/fanouts.js +702 -0
- package/dist/bridge/file-range.d.ts +16 -0
- package/dist/bridge/file-range.js +90 -0
- package/dist/bridge/files.d.ts +20 -0
- package/dist/bridge/files.js +54 -0
- package/dist/bridge/git-publish.d.ts +23 -0
- package/dist/bridge/git-publish.js +145 -0
- package/dist/bridge/git-worktrees.d.ts +21 -0
- package/dist/bridge/git-worktrees.js +150 -0
- package/dist/bridge/git.d.ts +54 -0
- package/dist/bridge/git.js +552 -0
- package/dist/bridge/grants.d.ts +31 -0
- package/dist/bridge/grants.js +181 -0
- package/dist/bridge/hand-off.d.ts +79 -0
- package/dist/bridge/hand-off.js +151 -0
- package/dist/bridge/health.d.ts +128 -0
- package/dist/bridge/health.js +260 -0
- package/dist/bridge/herdr.d.ts +79 -6
- package/dist/bridge/herdr.js +292 -27
- package/dist/bridge/hook-main.js +2 -0
- package/dist/bridge/install.d.ts +32 -1
- package/dist/bridge/install.js +225 -38
- package/dist/bridge/launch-worktree.d.ts +21 -0
- package/dist/bridge/launch-worktree.js +70 -0
- package/dist/bridge/limits.d.ts +20 -0
- package/dist/bridge/limits.js +65 -0
- package/dist/bridge/locate.d.ts +16 -0
- package/dist/bridge/locate.js +75 -0
- package/dist/bridge/metrics.d.ts +29 -0
- package/dist/bridge/metrics.js +71 -0
- package/dist/bridge/model-switch.d.ts +35 -0
- package/dist/bridge/model-switch.js +250 -0
- package/dist/bridge/models.d.ts +46 -0
- package/dist/bridge/models.js +257 -0
- package/dist/bridge/opencode-approvals.d.ts +6 -0
- package/dist/bridge/opencode-approvals.js +60 -0
- package/dist/bridge/pane-text.d.ts +15 -0
- package/dist/bridge/pane-text.js +23 -0
- package/dist/bridge/peers.d.ts +27 -0
- package/dist/bridge/peers.js +130 -0
- package/dist/bridge/projects.d.ts +12 -1
- package/dist/bridge/projects.js +268 -20
- package/dist/bridge/protocol.d.ts +35 -2
- package/dist/bridge/protocol.js +42 -7
- package/dist/bridge/push.d.ts +83 -0
- package/dist/bridge/push.js +199 -0
- package/dist/bridge/questions.d.ts +38 -0
- package/dist/bridge/questions.js +205 -0
- package/dist/bridge/schedule-format.d.ts +103 -0
- package/dist/bridge/schedule-format.js +266 -0
- package/dist/bridge/schedule-launch.d.ts +11 -0
- package/dist/bridge/schedule-launch.js +169 -0
- package/dist/bridge/schedule-watch.d.ts +52 -0
- package/dist/bridge/schedule-watch.js +242 -0
- package/dist/bridge/schedules.d.ts +48 -0
- package/dist/bridge/schedules.js +205 -0
- package/dist/bridge/server-launch.d.ts +14 -0
- package/dist/bridge/server-launch.js +218 -0
- package/dist/bridge/server-overview.d.ts +45 -0
- package/dist/bridge/server-overview.js +102 -0
- package/dist/bridge/server-pane-routes.d.ts +29 -0
- package/dist/bridge/server-pane-routes.js +400 -0
- package/dist/bridge/server-routes.d.ts +106 -0
- package/dist/bridge/server-routes.js +538 -0
- package/dist/bridge/server-stream.d.ts +46 -0
- package/dist/bridge/server-stream.js +253 -0
- package/dist/bridge/server.d.ts +3 -15
- package/dist/bridge/server.js +162 -264
- package/dist/bridge/session-servers.d.ts +24 -0
- package/dist/bridge/session-servers.js +136 -0
- package/dist/bridge/side-questions.d.ts +74 -0
- package/dist/bridge/side-questions.js +252 -0
- package/dist/bridge/simulators.d.ts +28 -0
- package/dist/bridge/simulators.js +198 -0
- package/dist/bridge/speech-transcribe.d.ts +24 -0
- package/dist/bridge/speech-transcribe.js +124 -0
- package/dist/bridge/speech.d.ts +35 -0
- package/dist/bridge/speech.js +98 -0
- package/dist/bridge/steps.d.ts +13 -0
- package/dist/bridge/steps.js +222 -0
- package/dist/bridge/tab-activity.d.ts +18 -0
- package/dist/bridge/tab-activity.js +99 -0
- package/dist/bridge/terminal-choice.d.ts +64 -0
- package/dist/bridge/terminal-choice.js +281 -0
- package/dist/bridge/transcript-claude.d.ts +22 -0
- package/dist/bridge/transcript-claude.js +353 -0
- package/dist/bridge/transcript-codex.d.ts +30 -0
- package/dist/bridge/transcript-codex.js +282 -0
- package/dist/bridge/transcript-copilot.d.ts +4 -0
- package/dist/bridge/transcript-copilot.js +14 -0
- package/dist/bridge/transcript-opencode.d.ts +5 -0
- package/dist/bridge/transcript-opencode.js +26 -0
- package/dist/bridge/transcript-preview.d.ts +94 -0
- package/dist/bridge/transcript-preview.js +476 -0
- package/dist/bridge/transcripts.d.ts +81 -4
- package/dist/bridge/transcripts.js +332 -67
- package/dist/bridge/transport.d.ts +3 -0
- package/dist/bridge/transport.js +96 -15
- package/dist/bridge/uploads.d.ts +15 -0
- package/dist/bridge/uploads.js +44 -2
- package/dist/bridge/usage.d.ts +124 -0
- package/dist/bridge/usage.js +859 -0
- package/dist/bridge-hook.mjs +41246 -21385
- package/dist/cli/actions.js +14 -1
- package/dist/cli/config-proactivity.d.ts +3 -1
- package/dist/cli/config-proactivity.js +35 -3
- package/dist/cli/config.js +4 -1
- package/dist/cli/extract.js +3 -6
- package/dist/cli/govern.js +5 -2
- package/dist/cli/hooks-globs.js +1 -1
- package/dist/cli/hooks.d.ts +1 -1
- package/dist/cli/hooks.js +9 -7
- package/dist/cli/namespaces-projects.js +12 -6
- package/dist/cli/namespaces-store.js +37 -6
- package/dist/cli/namespaces-tasks.js +1 -1
- package/dist/cli/schedules.d.ts +1 -0
- package/dist/cli/schedules.js +164 -0
- package/dist/cli/session-background.js +1 -1
- package/dist/cli/session-git.d.ts +8 -5
- package/dist/cli/session-git.js +45 -120
- package/dist/cli/session-start.js +3 -1
- package/dist/cli/session-stop.js +19 -8
- package/dist/cli/team.js +13 -10
- package/dist/cli-handlers.d.ts +1 -1
- package/dist/cli-handlers.js +8 -4
- package/dist/cli-help.d.ts +5 -4
- package/dist/cli-help.js +15 -15
- package/dist/cli-registry.d.ts +4 -1
- package/dist/cli-registry.js +119 -6
- package/dist/content/archive.js +2 -2
- package/dist/content/citation.d.ts +11 -0
- package/dist/content/citation.js +18 -0
- package/dist/content/learning.js +2 -0
- package/dist/content/summarize.d.ts +14 -15
- package/dist/content/summarize.js +60 -5
- package/dist/content/validate.d.ts +3 -1
- package/dist/content/validate.js +26 -8
- package/dist/core/project-registry.d.ts +26 -0
- package/dist/core/project-registry.js +573 -0
- package/dist/core/project.js +2 -3
- package/dist/data/access.d.ts +7 -1
- package/dist/data/access.js +13 -3
- package/dist/data/tasks.d.ts +18 -3
- package/dist/data/tasks.js +8 -7
- package/dist/entrypoint.js +44 -10
- package/dist/fanout/adapters/claude.d.ts +2 -0
- package/dist/fanout/adapters/claude.js +7 -0
- package/dist/fanout/adapters/codex.d.ts +2 -0
- package/dist/fanout/adapters/codex.js +9 -0
- package/dist/fanout/adapters/opencode.d.ts +4 -0
- package/dist/fanout/adapters/opencode.js +9 -0
- package/dist/fanout/adapters/types.d.ts +21 -0
- package/dist/fanout/adapters/types.js +3 -0
- package/dist/fanout/command.d.ts +2 -0
- package/dist/fanout/command.js +78 -0
- package/dist/fanout/launcher.d.ts +27 -0
- package/dist/fanout/launcher.js +156 -0
- package/dist/fanout/opencode-serve.d.ts +24 -0
- package/dist/fanout/opencode-serve.js +191 -0
- package/dist/fanout/picker.d.ts +91 -0
- package/dist/fanout/picker.js +51 -0
- package/dist/fanout/usage.d.ts +5 -0
- package/dist/fanout/usage.js +51 -0
- package/dist/fanout/watchdog.d.ts +10 -0
- package/dist/fanout/watchdog.js +27 -0
- package/dist/filenames.d.ts +9 -0
- package/dist/filenames.js +11 -0
- package/dist/finding/context.js +4 -22
- package/dist/generated/memory-ui-graph.browser.js +279 -283
- package/dist/governance/policy-constants.d.ts +11 -0
- package/dist/governance/policy-constants.js +9 -0
- package/dist/governance/policy.d.ts +5 -8
- package/dist/governance/policy.js +7 -5
- package/dist/graph-core/camera.d.ts +24 -0
- package/dist/graph-core/camera.js +18 -0
- package/dist/graph-core/index.d.ts +2 -0
- package/dist/graph-core/index.js +2 -0
- package/dist/graph-core/labels.d.ts +77 -0
- package/dist/graph-core/labels.js +124 -0
- package/dist/graph-core/model.d.ts +13 -0
- package/dist/graph-core/model.js +33 -0
- package/dist/graph-core/types.d.ts +2 -0
- package/dist/home-paths.d.ts +7 -0
- package/dist/home-paths.js +21 -0
- package/dist/hooks.d.ts +3 -0
- package/dist/hooks.js +13 -0
- package/dist/index.js +24 -2
- package/dist/init/guard-globals.d.ts +1 -1
- package/dist/init/guard-globals.js +4 -4
- package/dist/init/init-configure.js +3 -3
- package/dist/init/init-uninstall.js +2 -2
- package/dist/init/init-walkthrough.d.ts +2 -0
- package/dist/init/init-walkthrough.js +17 -6
- package/dist/init/init.js +26 -6
- package/dist/init/management-preset.d.ts +1 -1
- package/dist/init/management-preset.js +2 -2
- package/dist/init/preferences.js +1 -1
- package/dist/init/self-wiring.js +1 -1
- package/dist/init/setup.d.ts +3 -26
- package/dist/init/setup.js +49 -588
- package/dist/init/shared.js +2 -0
- package/dist/init/store-gitignore.d.ts +1 -1
- package/dist/init/store-gitignore.js +2 -0
- package/dist/init/teardown.d.ts +1 -1
- package/dist/init/teardown.js +2 -2
- package/dist/link/context.js +1 -1
- package/dist/link/doctor.d.ts +22 -1
- package/dist/link/doctor.js +100 -54
- package/dist/link/link.js +29 -61
- package/dist/link/refresh.js +2 -2
- package/dist/link/skills.js +26 -5
- package/dist/machine-identity.d.ts +3 -0
- package/dist/machine-identity.js +6 -0
- package/dist/mcp/profile.d.ts +2 -15
- package/dist/mcp/profile.js +64 -9
- package/dist/memory-ui-graph.runtime.js +279 -283
- package/dist/modules/code-package.d.ts +16 -0
- package/dist/modules/code-package.js +152 -0
- package/dist/modules/command.d.ts +2 -0
- package/dist/modules/command.js +67 -0
- package/dist/modules/config.d.ts +4 -0
- package/dist/modules/config.js +70 -0
- package/dist/modules/manifest.d.ts +41 -0
- package/dist/modules/manifest.js +1 -0
- package/dist/modules/provision.d.ts +3 -0
- package/dist/modules/provision.js +84 -0
- package/dist/modules/registry.d.ts +16 -0
- package/dist/modules/registry.js +250 -0
- package/dist/modules/runtime.d.ts +15 -0
- package/dist/modules/runtime.js +59 -0
- package/dist/package-metadata.js +10 -2
- package/dist/phren-dotenv.js +4 -2
- package/dist/phren-paths.d.ts +3 -2
- package/dist/phren-paths.js +4 -5
- package/dist/profile-store.js +4 -5
- package/dist/project-config.d.ts +19 -1
- package/dist/project-config.js +29 -3
- package/dist/project-topics.js +4 -4
- package/dist/provider-adapters.js +1 -4
- package/dist/query-correlation.js +6 -6
- package/dist/session/artifacts.js +5 -5
- package/dist/session/checkpoints.js +5 -0
- package/dist/session/utils.d.ts +2 -2
- package/dist/session/utils.js +6 -6
- package/dist/shared/content.d.ts +1 -1
- package/dist/shared/content.js +1 -1
- package/dist/shared/data-utils.js +1 -1
- package/dist/shared/fragment-graph.d.ts +1 -1
- package/dist/shared/fragment-graph.js +5 -5
- package/dist/shared/index.js +48 -7
- package/dist/shared/retrieval.d.ts +18 -1
- package/dist/shared/retrieval.js +100 -11
- package/dist/shared/search-fallback.js +4 -6
- package/dist/shared/sqljs.d.ts +2 -0
- package/dist/shared/sqljs.js +4 -2
- package/dist/shared.d.ts +0 -1
- package/dist/shared.js +0 -1
- package/dist/shell/input.d.ts +1 -5
- package/dist/shell/input.js +16 -10
- package/dist/shell/palette.d.ts +2 -2
- package/dist/shell/palette.js +3 -7
- package/dist/shell/render.d.ts +3 -1
- package/dist/shell/render.js +4 -4
- package/dist/shell/shell.js +4 -1
- package/dist/shell/types.d.ts +1 -0
- package/dist/shell/types.js +4 -0
- package/dist/shell/view.d.ts +0 -4
- package/dist/shell/view.js +19 -27
- package/dist/skill/registry.js +25 -17
- package/dist/skill/state.d.ts +3 -0
- package/dist/skill/state.js +13 -7
- package/dist/status.js +38 -17
- package/dist/store-registry.d.ts +44 -18
- package/dist/store-registry.js +169 -60
- package/dist/store-weight.d.ts +1 -6
- package/dist/store-weight.js +4 -2
- package/dist/sync/auth-doctor.d.ts +8 -0
- package/dist/sync/auth-doctor.js +27 -0
- package/dist/sync/auth.d.ts +27 -0
- package/dist/sync/auth.js +114 -0
- package/dist/sync/conflict-resolve.d.ts +9 -0
- package/dist/sync/conflict-resolve.js +146 -0
- package/dist/sync/git-state.d.ts +4 -0
- package/dist/sync/git-state.js +49 -0
- package/dist/sync/outcome.d.ts +34 -0
- package/dist/sync/outcome.js +57 -0
- package/dist/sync/pull.d.ts +15 -7
- package/dist/sync/pull.js +84 -35
- package/dist/sync/store-merge.d.ts +29 -0
- package/dist/sync/store-merge.js +137 -0
- package/dist/sync/task-merge.d.ts +22 -0
- package/dist/sync/task-merge.js +158 -0
- package/dist/task/github.js +1 -1
- package/dist/task/lifecycle.d.ts +5 -0
- package/dist/task/lifecycle.js +67 -23
- package/dist/terminal-text.d.ts +5 -0
- package/dist/terminal-text.js +11 -0
- package/dist/test-global-setup.js +7 -0
- package/dist/tool-registry.d.ts +1 -1
- package/dist/tool-registry.js +3 -1
- package/dist/tools/code.d.ts +3 -0
- package/dist/tools/code.js +178 -0
- package/dist/tools/config.js +5 -0
- package/dist/tools/data.js +14 -7
- package/dist/tools/dispatch.d.ts +2 -0
- package/dist/tools/dispatch.js +66 -0
- package/dist/tools/finding.js +43 -41
- package/dist/tools/ops.js +5 -2
- package/dist/tools/search.js +21 -8
- package/dist/tools/session.js +21 -22
- package/dist/tools/tasks.js +8 -2
- package/dist/tools/types.d.ts +2 -2
- package/dist/tools/types.js +2 -2
- package/dist/ui/assets.js +1 -1
- package/dist/ui/data.js +14 -15
- package/dist/ui/deep-void.d.ts +1 -1
- package/dist/ui/deep-void.js +0 -1
- package/dist/ui/graph-chrome.d.ts +1 -1
- package/dist/ui/graph-chrome.js +51 -0
- package/dist/ui/page.js +5 -5
- package/dist/ui/scripts.js +67 -30
- package/dist/ui/server.js +34 -6
- package/dist/update.js +1 -1
- package/dist/utils-fts.js +1 -0
- package/dist/utils-helpers.d.ts +7 -0
- package/dist/utils-helpers.js +17 -0
- package/dist/utils.d.ts +1 -1
- package/dist/utils.js +1 -1
- package/package.json +45 -3
- package/plugins/opencode/phren-transcript.js +340 -0
- package/starter/README.md +4 -4
- package/starter/global/{CLAUDE.md → AGENTS.md} +2 -2
- package/starter/global/skills/conductor/SKILL.md +106 -0
- package/starter/global/skills/fanout/SKILL.md +20 -0
- package/starter/global/skills/phren-discover/SKILL.md +6 -6
- package/starter/global/skills/phren-init/SKILL.md +4 -4
- package/starter/global/skills/phren-sync/SKILL.md +3 -3
- package/starter/templates/frontend/reference/README.md +1 -1
- package/starter/templates/library/reference/README.md +1 -1
- package/starter/templates/monorepo/reference/README.md +1 -1
- package/starter/templates/python-project/reference/README.md +1 -1
- /package/starter/templates/frontend/{CLAUDE.md → AGENTS.md} +0 -0
- /package/starter/templates/library/{CLAUDE.md → AGENTS.md} +0 -0
- /package/starter/templates/monorepo/{CLAUDE.md → AGENTS.md} +0 -0
- /package/starter/templates/python-project/{CLAUDE.md → AGENTS.md} +0 -0
|
@@ -0,0 +1,250 @@
|
|
|
1
|
+
import * as fs from "node:fs";
|
|
2
|
+
import * as path from "node:path";
|
|
3
|
+
import * as yaml from "js-yaml";
|
|
4
|
+
import { z } from "zod";
|
|
5
|
+
import { VERSION } from "../package-metadata.js";
|
|
6
|
+
const core = (names) => names.map(name => ({ name, profiles: ["core", "full"] }));
|
|
7
|
+
const full = (names) => names.map(name => ({ name, profiles: ["full"] }));
|
|
8
|
+
const routes = (method, paths) => paths.map(path => ({ method, path }));
|
|
9
|
+
// DELETE is only used by conductor grants today; the manifest type stays open.
|
|
10
|
+
export const BUILTIN_MODULES = [
|
|
11
|
+
{
|
|
12
|
+
schemaVersion: 1, name: "memory", version: VERSION, defaultEnabled: true, requires: [],
|
|
13
|
+
tools: [
|
|
14
|
+
...core(["search_knowledge", "get_memory_detail", "get_project_summary", "add_finding", "revise_finding", "session", "phren_admin"]),
|
|
15
|
+
...full([
|
|
16
|
+
"list_projects", "get_findings", "store_list", "supersede_finding", "retract_finding",
|
|
17
|
+
"resolve_contradiction", "get_contradictions", "edit_finding", "remove_finding", "push_changes",
|
|
18
|
+
"pin_memory", "get_truths", "memory_feedback", "export_project", "import_project", "manage_project",
|
|
19
|
+
"search_fragments", "get_related_docs", "read_graph", "link_findings", "cross_project_fragments",
|
|
20
|
+
"session_start", "session_end", "session_context", "session_history",
|
|
21
|
+
"add_project", "health_check", "doctor_fix", "list_hook_errors", "get_review_queue", "manage_review_item",
|
|
22
|
+
"list_skills", "read_skill", "write_skill", "remove_skill", "toggle_skill",
|
|
23
|
+
"list_hooks", "toggle_hooks", "add_custom_hook", "remove_custom_hook", "get_config", "set_config",
|
|
24
|
+
"get_notes", "add_note", "edit_note", "remove_note", "promote_note", "get_topic_summaries", "set_topic_summary",
|
|
25
|
+
]),
|
|
26
|
+
],
|
|
27
|
+
cliCommands: [
|
|
28
|
+
"init", "quickstart", "add", "projects", "search", "status", "doctor", "web-ui", "graph", "shell",
|
|
29
|
+
"add-finding", "pin", "review", "session-context", "sessions", "finding", "note", "notes",
|
|
30
|
+
"search-fragments", "related-docs", "truths", "promote", "skills", "detect-skills", "hooks", "config",
|
|
31
|
+
"maintain", "consolidation-status", "quality-feedback", "mcp-mode", "hooks-mode", "preset", "snippet",
|
|
32
|
+
"verify", "uninstall", "update", "profile", "store", "team", "modules list", "modules enable", "modules disable",
|
|
33
|
+
"hook-prompt", "hook-session-start", "hook-stop", "hook-context", "hook-tool", "background-sync",
|
|
34
|
+
"background-maintenance", "background-reindex", "debug-injection", "inspect-index", "skill-list",
|
|
35
|
+
"policy", "workflow", "index-policy", "govern-memories", "prune-memories", "consolidate-memories", "link",
|
|
36
|
+
],
|
|
37
|
+
agentHooks: [
|
|
38
|
+
{ agents: ["claude", "codex", "copilot", "cursor"], events: ["SessionStart"], handler: "phren hook-session-start" },
|
|
39
|
+
{ agents: ["claude", "codex", "copilot", "cursor"], events: ["UserPromptSubmit"], handler: "phren hook-prompt" },
|
|
40
|
+
{ agents: ["claude", "codex", "copilot", "cursor"], events: ["Stop"], handler: "phren hook-stop" },
|
|
41
|
+
{ agents: ["claude"], events: ["PostToolUse"], handler: "phren hook-tool" },
|
|
42
|
+
],
|
|
43
|
+
hookRoutes: [], capabilities: ["memory"],
|
|
44
|
+
storeFiles: [
|
|
45
|
+
"phren.root.yaml", "machines.yaml", "profiles/*.yaml", ".config/modules.yaml", ".config/*.json",
|
|
46
|
+
"<project>/AGENTS.md", "<project>/summary.md", "<project>/FINDINGS.md", "<project>/truths.md",
|
|
47
|
+
"<project>/review.md", "<project>/notes/*.md", "<project>/reference/**", "<project>/skills/**",
|
|
48
|
+
"<project>/phren.project.yaml", "<project>/preferences.json", ".runtime/sessions/session-*.json",
|
|
49
|
+
".runtime/sessions/last-summary.json",
|
|
50
|
+
],
|
|
51
|
+
localFiles: [],
|
|
52
|
+
phoneScreens: [{ screen: "ProjectsView", capability: "memory" }, { screen: "SearchView", capability: "memory" }],
|
|
53
|
+
skills: ["phren-init", "phren-sync", "phren-profiles", "phren-discover", "phren-consolidate", "phren-summarize"],
|
|
54
|
+
},
|
|
55
|
+
{
|
|
56
|
+
schemaVersion: 1, name: "tasks", version: VERSION, defaultEnabled: false, requires: ["memory"],
|
|
57
|
+
tools: [
|
|
58
|
+
...core(["get_tasks", "add_task", "manage_task"]),
|
|
59
|
+
...full(["complete_task", "remove_task", "update_task", "tidy_done_tasks", "pin_task"]),
|
|
60
|
+
],
|
|
61
|
+
cliCommands: ["task", "tasks", "config task-mode", "config proactivity.tasks"], agentHooks: [], hookRoutes: [], capabilities: ["tasks"],
|
|
62
|
+
storeFiles: ["<project>/tasks.md", ".sessions/checkpoint-*.json"], localFiles: [],
|
|
63
|
+
phoneScreens: [{ screen: "TasksView", capability: "tasks" }], skills: [],
|
|
64
|
+
},
|
|
65
|
+
{
|
|
66
|
+
schemaVersion: 1, name: "hook", version: VERSION, defaultEnabled: false, requires: ["memory"],
|
|
67
|
+
tools: [],
|
|
68
|
+
cliCommands: [
|
|
69
|
+
"bridge", "bridge install", "bridge update", "bridge uninstall", "bridge rollback", "bridge status",
|
|
70
|
+
"bridge doctor", "bridge usage", "bridge usage-statusline", "bridge hook", "bridge serve", "bridge ssh",
|
|
71
|
+
"bridge fanouts archive", "canary",
|
|
72
|
+
],
|
|
73
|
+
agentHooks: [
|
|
74
|
+
{ agents: ["codex", "claude"], events: ["SessionStart", "UserPromptSubmit", "Stop", "PermissionRequest"], handler: "bridge-hook.mjs hook <agent>" },
|
|
75
|
+
{ agents: ["claude"], events: ["PreCompact"], handler: "bridge-hook.mjs hook claude" },
|
|
76
|
+
{ agents: ["copilot"], events: ["SessionStart", "UserPromptSubmit"], handler: "bridge-hook.mjs hook copilot" },
|
|
77
|
+
],
|
|
78
|
+
hookRoutes: [
|
|
79
|
+
...routes("GET", [
|
|
80
|
+
"/v1/health", "/v1/health/details", "/v1/health/peers", "/v1/muxes", "/v1/activity", "/v1/metrics", "/v1/web-servers", "/v1/simulators",
|
|
81
|
+
"/v1/simulators/screenshot", "/v1/simulators/apps", "/v1/files", "/v1/models", "/v1/projects/files",
|
|
82
|
+
"/v1/uploads/image", "/v1/files/range", "/v1/usage", "/v1/push/status", "/v1/projects/locate", "/v1/projects/repos",
|
|
83
|
+
"/v1/workspaces", "/v1/workspaces/panes", "/v1/transcripts/blob", "/v1/transcripts/history",
|
|
84
|
+
"/v1/subagents", "/v1/subagents/transcript", "/v1/subagents/messages",
|
|
85
|
+
]),
|
|
86
|
+
...routes("POST", [
|
|
87
|
+
"/v1/push/register", "/v1/push/answer", "/v1/push/target", "/v1/files", "/v1/projects/add", "/v1/simulators/action",
|
|
88
|
+
"/v1/workspaces/launch", "/v1/workspaces/create", "/v1/workspaces/focus", "/v1/workspaces/rename",
|
|
89
|
+
"/v1/workspaces/close", "/v1/prompt", "/v1/model", "/v1/side-question/dismiss", "/v1/keys", "/v1/secret", "/v1/upload",
|
|
90
|
+
"/v1/approvals/answer", "/v1/questions/answer", "/v1/subagents/resume", "/v1/subagents/archive-finished", "/v1/canary",
|
|
91
|
+
"/v1/speech",
|
|
92
|
+
]),
|
|
93
|
+
...routes("WS", ["/v1/transcripts", "/v1/status", "/v1/overview", "/v1/speech/transcribe"]),
|
|
94
|
+
],
|
|
95
|
+
capabilities: [
|
|
96
|
+
"hook", "transcript", "progress", "images", "prompt", "stop", "terminal", "shell", "herdr",
|
|
97
|
+
"webServers", "webPreview", "activity", "approvals", "questions", "accountUsage", "providers",
|
|
98
|
+
"files", "repositoryFiles", "subagents", "sideQuestions", "approvalPush", "simulators", "overviewStream", "speech", "transcribe",
|
|
99
|
+
],
|
|
100
|
+
storeFiles: [".runtime/sessions/opencode-*.events.jsonl", ".runtime/approvals/opencode-*.json"],
|
|
101
|
+
localFiles: ["<bridge>/installed.json", "<bridge>/versions/**", "<bridge>/current", "<bridge>/dispatch", "<bridge>/computer-id", "<bridge>/canary.json", "<bridge>/canary-daily"],
|
|
102
|
+
phoneScreens: [{ screen: "LiveSessionsView", capability: "hook" }, { screen: "AgentChatView", capability: "transcript" }],
|
|
103
|
+
skills: [],
|
|
104
|
+
},
|
|
105
|
+
{
|
|
106
|
+
schemaVersion: 1, name: "git", version: VERSION, defaultEnabled: false, requires: ["memory"],
|
|
107
|
+
tools: full(["auto_extract_findings"]), cliCommands: ["maintain extract", "extract-memories"],
|
|
108
|
+
agentHooks: [
|
|
109
|
+
{ agents: ["codex", "claude"], events: ["PreToolUse", "PostToolUse"], handler: "bridge-hook.mjs hook <agent>" },
|
|
110
|
+
],
|
|
111
|
+
hookRoutes: routes("POST", [
|
|
112
|
+
"/v1/diff", "/v1/web-servers/session", "/v1/git/status", "/v1/git/log", "/v1/git/branches", "/v1/git/pulls",
|
|
113
|
+
"/v1/git/tree", "/v1/git/worktrees", "/v1/git/stage", "/v1/git/unstage", "/v1/git/discard",
|
|
114
|
+
"/v1/git/commit", "/v1/git/push", "/v1/git/pr",
|
|
115
|
+
]),
|
|
116
|
+
capabilities: ["git", "diff"], storeFiles: [], localFiles: ["<bridge>/changes/**", "<bridge>/changes-scratch/**"],
|
|
117
|
+
phoneScreens: [{ screen: "AgentChangesView", capability: "git" }], skills: [],
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
schemaVersion: 1, name: "schedules", version: VERSION, defaultEnabled: false, requires: ["memory"],
|
|
121
|
+
tools: [], cliCommands: ["schedule"], agentHooks: [],
|
|
122
|
+
hookRoutes: routes("POST", ["/v1/schedules", "/v1/schedules/run", "/v1/schedules/history"]),
|
|
123
|
+
capabilities: ["schedules"], storeFiles: ["<project>/schedules.yaml", ".runtime/agent-fanouts/<run-id>/**"],
|
|
124
|
+
localFiles: ["<bridge>/schedule-runs.jsonl"],
|
|
125
|
+
phoneScreens: [{ screen: "SchedulesView", capability: "schedules" }], skills: [],
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
schemaVersion: 1, name: "conductor", version: VERSION, defaultEnabled: false, requires: ["memory", "hook"],
|
|
129
|
+
tools: full(["dispatch", "dispatch_returns", "hand_off", "live_sessions"]), cliCommands: ["dispatch", "dispatch status", "dispatch returns", "dispatch sessions", "hand-off", "conductor", "conductor grants", "bridge enroll-computer"], agentHooks: [],
|
|
130
|
+
hookRoutes: [...routes("GET", ["/v1/dispatch", "/v1/dispatch/capacity", "/v1/conductor/grants"]),
|
|
131
|
+
...routes("POST", ["/v1/dispatch", "/v1/dispatch/workers", "/v1/dispatch/returns", "/v1/conductor/grants"]), ...routes("DELETE", ["/v1/conductor/grants"])],
|
|
132
|
+
capabilities: ["dispatch"], storeFiles: ["global/skills/conductor/**"],
|
|
133
|
+
localFiles: ["<bridge>/hooks.yaml", "<bridge>/conductor.yaml", "<bridge>/dispatches/*.json"], phoneScreens: [], skills: ["conductor"],
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
schemaVersion: 1, name: "fanout", version: VERSION, defaultEnabled: false, requires: ["memory", "hook"],
|
|
137
|
+
tools: [], cliCommands: ["fanout"], agentHooks: [], hookRoutes: [], capabilities: [],
|
|
138
|
+
storeFiles: [".config/fanout.yaml"], localFiles: ["<store>/.runtime/agent-fanouts/**"],
|
|
139
|
+
phoneScreens: [], skills: ["fanout"],
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
schemaVersion: 1, name: "code", version: VERSION, defaultEnabled: false, requires: ["memory"],
|
|
143
|
+
tools: full(["code_search", "code_definition", "code_references", "code_outline", "code_usage"]),
|
|
144
|
+
cliCommands: ["code index", "code status", "code search", "code outline", "code refs", "code def", "code usage"],
|
|
145
|
+
agentHooks: [],
|
|
146
|
+
hookRoutes: [...routes("GET", ["/v1/code/tree", "/v1/code/usage-page", "/v1/code/recent", "/v1/code/status", "/v1/code/search", "/v1/code/outline", "/v1/code/outline-summary", "/v1/code/file-references", "/v1/code/definition", "/v1/code/references", "/v1/code/usage"]), ...routes("POST", ["/v1/code/note", "/v1/code/reindex", "/v1/code/disable"])],
|
|
147
|
+
capabilities: ["code"],
|
|
148
|
+
storeFiles: [], localFiles: ["<store>/.runtime/code/*.sqlite"],
|
|
149
|
+
phoneScreens: [{ screen: "CodeView", capability: "code" }], skills: ["code"],
|
|
150
|
+
},
|
|
151
|
+
];
|
|
152
|
+
const overrides = z.record(z.string(), z.boolean());
|
|
153
|
+
const configSchema = z.object({
|
|
154
|
+
version: z.literal(1),
|
|
155
|
+
enabled: overrides.optional(),
|
|
156
|
+
profiles: z.record(z.string(), z.object({ enabled: overrides.optional() }).strict()).optional(),
|
|
157
|
+
}).strict();
|
|
158
|
+
export function readConfig(store) {
|
|
159
|
+
let source;
|
|
160
|
+
try {
|
|
161
|
+
source = fs.readFileSync(path.join(store, ".config", "modules.yaml"), "utf8");
|
|
162
|
+
}
|
|
163
|
+
catch (error) {
|
|
164
|
+
if (error.code === "ENOENT")
|
|
165
|
+
return undefined;
|
|
166
|
+
throw new Error("Cannot read .config/modules.yaml.");
|
|
167
|
+
}
|
|
168
|
+
let config;
|
|
169
|
+
try {
|
|
170
|
+
config = configSchema.parse(yaml.load(source, { schema: yaml.CORE_SCHEMA }));
|
|
171
|
+
}
|
|
172
|
+
catch {
|
|
173
|
+
throw new Error("Invalid .config/modules.yaml: expected version: 1 and boolean module overrides.");
|
|
174
|
+
}
|
|
175
|
+
return validateConfig(config, true);
|
|
176
|
+
}
|
|
177
|
+
/** Warned once per process so serve's migrate-then-snapshot double read stays one line. */
|
|
178
|
+
const warnedUnknownModules = new Set();
|
|
179
|
+
/**
|
|
180
|
+
* Unknown keys belong to a newer CLI that enabled a module this build (the
|
|
181
|
+
* Hook) does not know; they are ignored, kept for writes, and warned about
|
|
182
|
+
* once instead of failing every Hook connection.
|
|
183
|
+
*/
|
|
184
|
+
export function validateConfig(input, warnUnknown = false) {
|
|
185
|
+
const parsed = configSchema.safeParse(input);
|
|
186
|
+
if (!parsed.success)
|
|
187
|
+
throw new Error("Invalid .config/modules.yaml: expected version: 1 and boolean module overrides.");
|
|
188
|
+
const config = parsed.data;
|
|
189
|
+
const names = new Set(BUILTIN_MODULES.map(module => module.name));
|
|
190
|
+
const unknown = new Set();
|
|
191
|
+
for (const values of [config.enabled, ...Object.values(config.profiles ?? {}).map(profile => profile.enabled)]) {
|
|
192
|
+
for (const [name, value] of Object.entries(values ?? {})) {
|
|
193
|
+
if (!names.has(name)) {
|
|
194
|
+
unknown.add(name);
|
|
195
|
+
continue;
|
|
196
|
+
}
|
|
197
|
+
if (name === "memory" && !value)
|
|
198
|
+
throw new Error("The memory module cannot be disabled.");
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
for (const name of unknown) {
|
|
202
|
+
if (!warnUnknown || warnedUnknownModules.has(name))
|
|
203
|
+
continue;
|
|
204
|
+
warnedUnknownModules.add(name);
|
|
205
|
+
console.error(`warning: unknown module "${name}" in .config/modules.yaml ignored by Hook ${VERSION}`);
|
|
206
|
+
}
|
|
207
|
+
return config;
|
|
208
|
+
}
|
|
209
|
+
/** Reads never mutate configuration or enable dependencies implicitly. */
|
|
210
|
+
export function enabled(store, profile) {
|
|
211
|
+
return resolveModules(readConfig(store), profile);
|
|
212
|
+
}
|
|
213
|
+
export function resolveModules(config, profile) {
|
|
214
|
+
const selected = profile && config?.profiles && Object.hasOwn(config.profiles, profile) ? config.profiles[profile].enabled : undefined;
|
|
215
|
+
const modules = BUILTIN_MODULES.filter(module => selected?.[module.name] ?? config?.enabled?.[module.name] ?? module.defaultEnabled);
|
|
216
|
+
const names = new Set(modules.map(module => module.name));
|
|
217
|
+
for (const module of modules) {
|
|
218
|
+
for (const dependency of module.requires) {
|
|
219
|
+
if (!names.has(dependency))
|
|
220
|
+
throw new Error(`Module "${module.name}" requires enabled module "${dependency}".`);
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
return modules;
|
|
224
|
+
}
|
|
225
|
+
export function moduleSource(config, name, profile) {
|
|
226
|
+
if (profile && Object.hasOwn(config?.profiles ?? {}, profile) && Object.hasOwn(config?.profiles?.[profile].enabled ?? {}, name))
|
|
227
|
+
return "profile";
|
|
228
|
+
return Object.hasOwn(config?.enabled ?? {}, name) ? "store" : "default";
|
|
229
|
+
}
|
|
230
|
+
export function toolOwner(name) {
|
|
231
|
+
return BUILTIN_MODULES.find(module => module.tools.some(tool => tool.name === name));
|
|
232
|
+
}
|
|
233
|
+
export function commandOwner(command) {
|
|
234
|
+
command = command.toLowerCase();
|
|
235
|
+
let owner;
|
|
236
|
+
let length = 0;
|
|
237
|
+
for (const module of BUILTIN_MODULES)
|
|
238
|
+
for (const entry of module.cliCommands) {
|
|
239
|
+
if ((command === entry || command.startsWith(entry + " ")) && entry.length > length) {
|
|
240
|
+
owner = module;
|
|
241
|
+
length = entry.length;
|
|
242
|
+
}
|
|
243
|
+
}
|
|
244
|
+
return owner;
|
|
245
|
+
}
|
|
246
|
+
export function disabledHint(name) {
|
|
247
|
+
if (name === "code")
|
|
248
|
+
return "phren code needs @phren/code: run phren modules enable code";
|
|
249
|
+
return `module ${name} is disabled; enable it with phren modules enable ${name}`;
|
|
250
|
+
}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import type { ModuleManifest } from "./manifest.js";
|
|
2
|
+
export interface ModuleSnapshot {
|
|
3
|
+
store: string;
|
|
4
|
+
profile: string;
|
|
5
|
+
modules: readonly ModuleManifest[];
|
|
6
|
+
generation: string;
|
|
7
|
+
has(name: string): boolean;
|
|
8
|
+
}
|
|
9
|
+
export declare function moduleSnapshot(store: string, profile?: string, legacyHook?: boolean): ModuleSnapshot;
|
|
10
|
+
export declare function moduleEnabled(store: string, name: string, profile?: string): boolean;
|
|
11
|
+
export declare function requireModule(store: string, name: string, profile?: string): void;
|
|
12
|
+
export declare function migrateInstalledModules(store: string, legacyHook?: boolean): void;
|
|
13
|
+
/** The version in <bridge>/installed.json, or undefined when no Hook is installed. */
|
|
14
|
+
export declare function installedHookVersion(): string | undefined;
|
|
15
|
+
export declare function activateModules(store: string, profile?: string, legacyHook?: boolean): ModuleSnapshot;
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
import { homedir } from "node:os";
|
|
5
|
+
import { resolveRuntimeProfile } from "../runtime-profile.js";
|
|
6
|
+
import { installPreferencesFile } from "../phren-paths.js";
|
|
7
|
+
import { migrateModules } from "./config.js";
|
|
8
|
+
import { BUILTIN_MODULES, resolveModules, disabledHint, readConfig } from "./registry.js";
|
|
9
|
+
/** The runtime profile for module gating; unscoped while a store is still being set up. */
|
|
10
|
+
function snapshotProfile(store) {
|
|
11
|
+
try {
|
|
12
|
+
return resolveRuntimeProfile(store);
|
|
13
|
+
}
|
|
14
|
+
catch {
|
|
15
|
+
return "";
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
export function moduleSnapshot(store, profile = snapshotProfile(store), legacyHook = false) {
|
|
19
|
+
const config = readConfig(store);
|
|
20
|
+
const hasStore = !!config || fs.existsSync(path.join(store, "phren.root.yaml")) || fs.existsSync(installPreferencesFile(store));
|
|
21
|
+
const modules = !hasStore && legacyHook
|
|
22
|
+
? BUILTIN_MODULES.filter(module => ["hook", "git", "schedules", "conductor"].includes(module.name))
|
|
23
|
+
: resolveModules(config ?? (hasStore ? { version: 1, enabled: { tasks: true } } : undefined), profile);
|
|
24
|
+
const names = new Set(modules.map(module => module.name));
|
|
25
|
+
const generation = createHash("sha256").update(JSON.stringify([store, profile, modules.map(module => [module.name, module.version])])).digest("hex").slice(0, 16);
|
|
26
|
+
return { store, profile, modules, generation, has: name => names.has(name) };
|
|
27
|
+
}
|
|
28
|
+
export function moduleEnabled(store, name, profile) {
|
|
29
|
+
return moduleSnapshot(store, profile).has(name);
|
|
30
|
+
}
|
|
31
|
+
export function requireModule(store, name, profile) {
|
|
32
|
+
if (!moduleEnabled(store, name, profile))
|
|
33
|
+
throw new Error(disabledHint(name));
|
|
34
|
+
}
|
|
35
|
+
export function migrateInstalledModules(store, legacyHook = false) {
|
|
36
|
+
const hookRoot = process.env.PHREN_BRIDGE_HOME || path.join(homedir(), ".local", "share", "phren", "bridge");
|
|
37
|
+
const installedHook = legacyHook || fs.existsSync(path.join(hookRoot, "installed.json"));
|
|
38
|
+
// A store without .config was never set up; migration must not create it and
|
|
39
|
+
// make `phren add` believe the store is ready.
|
|
40
|
+
if (!fs.existsSync(path.join(store, ".config")))
|
|
41
|
+
return;
|
|
42
|
+
if (readConfig(store) || fs.existsSync(path.join(store, "phren.root.yaml")) || fs.existsSync(installPreferencesFile(store)))
|
|
43
|
+
migrateModules(store, installedHook);
|
|
44
|
+
}
|
|
45
|
+
/** The version in <bridge>/installed.json, or undefined when no Hook is installed. */
|
|
46
|
+
export function installedHookVersion() {
|
|
47
|
+
const hookRoot = process.env.PHREN_BRIDGE_HOME || path.join(homedir(), ".local", "share", "phren", "bridge");
|
|
48
|
+
try {
|
|
49
|
+
const parsed = JSON.parse(fs.readFileSync(path.join(hookRoot, "installed.json"), "utf8"));
|
|
50
|
+
return typeof parsed.version === "string" && parsed.version.trim() ? parsed.version.trim() : undefined;
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return undefined;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
export function activateModules(store, profile = snapshotProfile(store), legacyHook = false) {
|
|
57
|
+
migrateInstalledModules(store, legacyHook);
|
|
58
|
+
return moduleSnapshot(store, profile, legacyHook);
|
|
59
|
+
}
|
package/dist/package-metadata.js
CHANGED
|
@@ -5,9 +5,17 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
|
5
5
|
export const ROOT = path.join(__dirname, "..");
|
|
6
6
|
const PACKAGE_JSON_PATH = path.join(ROOT, "package.json");
|
|
7
7
|
function readPackageJson() {
|
|
8
|
-
|
|
8
|
+
// The Hook bundle is copied alone into the bridge's version folder, where
|
|
9
|
+
// no package.json sits beside it; the build inlines PHREN_HOOK_VERSION.
|
|
10
|
+
try {
|
|
11
|
+
return JSON.parse(fs.readFileSync(PACKAGE_JSON_PATH, "utf8"));
|
|
12
|
+
}
|
|
13
|
+
catch {
|
|
14
|
+
return {};
|
|
15
|
+
}
|
|
9
16
|
}
|
|
17
|
+
const BUNDLED_VERSION = typeof PHREN_HOOK_VERSION === "string" ? PHREN_HOOK_VERSION : "0.0.0";
|
|
10
18
|
const PACKAGE_JSON = readPackageJson();
|
|
11
19
|
export const PACKAGE_NAME = PACKAGE_JSON.name || "phren";
|
|
12
|
-
export const VERSION = PACKAGE_JSON.version ||
|
|
20
|
+
export const VERSION = PACKAGE_JSON.version || BUNDLED_VERSION;
|
|
13
21
|
export const PACKAGE_SPEC = `${PACKAGE_NAME}@${VERSION}`;
|
package/dist/phren-dotenv.js
CHANGED
|
@@ -4,7 +4,9 @@ import * as path from "path";
|
|
|
4
4
|
let _loadedEnvKey;
|
|
5
5
|
let _loadedEnvPath = null;
|
|
6
6
|
let _loadedEnvMtimeMs = -1;
|
|
7
|
-
|
|
7
|
+
// Private copy: importing homeDir from phren-paths here would create a cycle,
|
|
8
|
+
// since phren-paths imports this module and bootstraps it at module load.
|
|
9
|
+
function dotenvHomeDir() {
|
|
8
10
|
return process.env.HOME || process.env.USERPROFILE || os.homedir();
|
|
9
11
|
}
|
|
10
12
|
function parseAndApplyDotEnv(filePath) {
|
|
@@ -28,7 +30,7 @@ function resolveDotEnvPath(phrenPath) {
|
|
|
28
30
|
const candidates = [
|
|
29
31
|
phrenPath ? path.join(phrenPath, ".env") : null,
|
|
30
32
|
envPath ? path.join(envPath, ".env") : null,
|
|
31
|
-
path.join(
|
|
33
|
+
path.join(dotenvHomeDir(), ".phren", ".env"),
|
|
32
34
|
].filter((candidate) => Boolean(candidate));
|
|
33
35
|
const seen = new Set();
|
|
34
36
|
for (const candidate of candidates) {
|
package/dist/phren-paths.d.ts
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { homeDir } from "./home-paths.js";
|
|
1
2
|
export type InstallMode = "shared" | "project-local";
|
|
2
3
|
export type SyncMode = "managed-git" | "workspace-git";
|
|
3
4
|
export interface PhrenRootManifest {
|
|
@@ -11,7 +12,7 @@ export interface InstallContext extends PhrenRootManifest {
|
|
|
11
12
|
phrenPath: string;
|
|
12
13
|
}
|
|
13
14
|
export declare const ROOT_MANIFEST_FILENAME = "phren.root.yaml";
|
|
14
|
-
export
|
|
15
|
+
export { homeDir };
|
|
15
16
|
export declare function homePath(...parts: string[]): string;
|
|
16
17
|
export declare function expandHomePath(input: string): string;
|
|
17
18
|
export declare function defaultPhrenPath(): string;
|
|
@@ -26,7 +27,7 @@ export interface AtomicWriteOptions {
|
|
|
26
27
|
*/
|
|
27
28
|
mode?: number;
|
|
28
29
|
}
|
|
29
|
-
export declare function atomicWriteText(filePath: string, content: string, opts?: AtomicWriteOptions): void;
|
|
30
|
+
export declare function atomicWriteText(filePath: string, content: string | Uint8Array, opts?: AtomicWriteOptions): void;
|
|
30
31
|
/**
|
|
31
32
|
* Create (or tighten) a directory that holds per-user private data — runtime
|
|
32
33
|
* logs, session transcripts, credential stores.
|
package/dist/phren-paths.js
CHANGED
|
@@ -4,18 +4,17 @@ import * as path from "path";
|
|
|
4
4
|
import * as crypto from "crypto";
|
|
5
5
|
import * as yaml from "js-yaml";
|
|
6
6
|
import { bootstrapPhrenDotEnv } from "./phren-dotenv.js";
|
|
7
|
+
import { homeDir } from "./home-paths.js";
|
|
7
8
|
import { PhrenError, isRecord, loadYamlDocument, RESERVED_PROJECT_DIR_NAMES } from "./phren-core.js";
|
|
8
9
|
import { errorMessage, isValidProjectName, safeProjectPath } from "./utils.js";
|
|
9
|
-
import { FINDINGS_FILENAME } from "./
|
|
10
|
+
import { FINDINGS_FILENAME } from "./filenames.js";
|
|
10
11
|
bootstrapPhrenDotEnv();
|
|
11
12
|
function stderrLog(msg) { try {
|
|
12
13
|
process.stderr.write("[phren] " + msg + "\n");
|
|
13
14
|
}
|
|
14
15
|
catch { } }
|
|
15
16
|
export const ROOT_MANIFEST_FILENAME = "phren.root.yaml";
|
|
16
|
-
export
|
|
17
|
-
return process.env.HOME || process.env.USERPROFILE || os.homedir();
|
|
18
|
-
}
|
|
17
|
+
export { homeDir };
|
|
19
18
|
export function homePath(...parts) {
|
|
20
19
|
return path.join(homeDir(), ...parts);
|
|
21
20
|
}
|
|
@@ -685,7 +684,7 @@ export function computePhrenLiveStateToken(phrenPath) {
|
|
|
685
684
|
for (const projectDir of projectDirs) {
|
|
686
685
|
const project = path.basename(projectDir);
|
|
687
686
|
parts.push(`project:${project}`);
|
|
688
|
-
for (const file of ["
|
|
687
|
+
for (const file of ["AGENTS.md", "summary.md", FINDINGS_FILENAME, "tasks.md", "review.md", "truths.md", "topic-config.json", "phren.project.yaml"]) {
|
|
689
688
|
pushFileToken(parts, path.join(projectDir, file));
|
|
690
689
|
}
|
|
691
690
|
pushDirTokens(parts, path.join(projectDir, "reference"));
|
package/dist/profile-store.js
CHANGED
|
@@ -6,11 +6,10 @@ import { loadYamlDocument } from "./phren-core.js";
|
|
|
6
6
|
import { phrenErr, PhrenError, phrenOk, forwardErr, getProjectDirs, readRootManifest, } from "./shared.js";
|
|
7
7
|
import { defaultMachineName, getMachineName } from "./machine-identity.js";
|
|
8
8
|
import { errorMessage, isValidProjectName } from "./utils.js";
|
|
9
|
-
import { TASK_FILE_ALIASES } from "./
|
|
10
|
-
import { FINDINGS_FILENAME } from "./data/access.js";
|
|
9
|
+
import { FINDINGS_FILENAME, TASK_FILE_ALIASES } from "./filenames.js";
|
|
11
10
|
import { withSafeLock } from "./shared/data-utils.js";
|
|
12
11
|
import { logger } from "./logger.js";
|
|
13
|
-
import { VALID_FINDING_SENSITIVITY, VALID_PROACTIVITY_LEVELS, VALID_TASK_MODES, VALID_RISKY_SECTIONS, } from "./governance/policy.js";
|
|
12
|
+
import { VALID_FINDING_SENSITIVITY, VALID_PROACTIVITY_LEVELS, VALID_TASK_MODES, VALID_RISKY_SECTIONS, } from "./governance/policy-constants.js";
|
|
14
13
|
import { getNonPrimaryStores, getStoreProjectDirs } from "./store-registry.js";
|
|
15
14
|
export function resolveActiveProfile(phrenPath, requestedProfile) {
|
|
16
15
|
const manifest = readRootManifest(phrenPath);
|
|
@@ -289,7 +288,7 @@ export function removeProjectFromProfile(phrenPath, profile, project) {
|
|
|
289
288
|
function buildProjectCard(dir) {
|
|
290
289
|
const name = path.basename(dir);
|
|
291
290
|
const summaryFile = path.join(dir, "summary.md");
|
|
292
|
-
const claudeFile = path.join(dir, "
|
|
291
|
+
const claudeFile = path.join(dir, "AGENTS.md");
|
|
293
292
|
const summarySource = fs.existsSync(summaryFile)
|
|
294
293
|
? fs.readFileSync(summaryFile, "utf8")
|
|
295
294
|
: fs.existsSync(claudeFile)
|
|
@@ -299,7 +298,7 @@ function buildProjectCard(dir) {
|
|
|
299
298
|
.split("\n")
|
|
300
299
|
.map((line) => line.trim())
|
|
301
300
|
.find((line) => line && !line.startsWith("#")) || "";
|
|
302
|
-
const docs = ["
|
|
301
|
+
const docs = ["AGENTS.md", FINDINGS_FILENAME, "summary.md", "review.md"]
|
|
303
302
|
.filter((file) => fs.existsSync(path.join(dir, file)));
|
|
304
303
|
const taskFile = TASK_FILE_ALIASES.find((file) => fs.existsSync(path.join(dir, file)));
|
|
305
304
|
if (taskFile)
|
package/dist/project-config.d.ts
CHANGED
|
@@ -25,7 +25,14 @@ export interface ProjectAccessControl {
|
|
|
25
25
|
}
|
|
26
26
|
export interface ProjectConfig {
|
|
27
27
|
ownership?: ProjectOwnershipMode;
|
|
28
|
+
/**
|
|
29
|
+
* The folder the project was last added from, on whichever machine that was.
|
|
30
|
+
* Kept for older CLIs; a synced store shares it across every computer, so
|
|
31
|
+
* it is only authoritative on the machine that wrote it.
|
|
32
|
+
*/
|
|
28
33
|
sourcePath?: string;
|
|
34
|
+
/** Per-machine source folders, keyed by `getMachineName()`. Wins over `sourcePath`. */
|
|
35
|
+
sourcePaths?: Record<string, string>;
|
|
29
36
|
skills?: boolean;
|
|
30
37
|
hooks?: {
|
|
31
38
|
enabled?: boolean;
|
|
@@ -47,7 +54,18 @@ export declare function clearProjectConfigCache(): void;
|
|
|
47
54
|
export declare function readProjectConfig(phrenPath: string, project: string): ProjectConfig;
|
|
48
55
|
export declare function writeProjectConfig(phrenPath: string, project: string, patch: Partial<ProjectConfig>): ProjectConfig;
|
|
49
56
|
export declare function updateProjectConfigOverrides(phrenPath: string, project: string, updater: (current: ProjectConfigOverrides) => ProjectConfigOverrides): ProjectConfig;
|
|
50
|
-
|
|
57
|
+
/**
|
|
58
|
+
* Where this project's source lives on this machine. The store syncs between
|
|
59
|
+
* computers, so the shared `sourcePath` is often another machine's folder:
|
|
60
|
+
* this machine's `sourcePaths` entry wins, and the shared value is only used
|
|
61
|
+
* when nothing more specific was recorded.
|
|
62
|
+
*/
|
|
63
|
+
export declare function getProjectSourcePath(phrenPath: string, project: string, config?: ProjectConfig, machine?: string): string | undefined;
|
|
64
|
+
/**
|
|
65
|
+
* Record `sourceRoot` as this machine's folder for the project, alongside the
|
|
66
|
+
* legacy shared `sourcePath` older CLIs read.
|
|
67
|
+
*/
|
|
68
|
+
export declare function recordProjectSourcePath(phrenPath: string, project: string, sourceRoot: string, patch?: Partial<ProjectConfig>, machine?: string): ProjectConfig;
|
|
51
69
|
export declare function getProjectOwnershipDefault(phrenPath: string): ProjectOwnershipMode;
|
|
52
70
|
export declare function getProjectOwnershipMode(phrenPath: string, project: string, config?: ProjectConfig): ProjectOwnershipMode;
|
|
53
71
|
export declare function isProjectHookEnabled(phrenPath: string, project: string | null | undefined, event: ProjectHookEvent, config?: ProjectConfig): boolean;
|
package/dist/project-config.js
CHANGED
|
@@ -7,7 +7,8 @@ import { readInstallPreferences } from "./init/preferences.js";
|
|
|
7
7
|
import { debugLog } from "./shared.js";
|
|
8
8
|
import { errorMessage } from "./utils.js";
|
|
9
9
|
import { storeAwareProjectPath } from "./store-routing.js";
|
|
10
|
-
import { withFileLock } from "./
|
|
10
|
+
import { withFileLock } from "./governance/locks.js";
|
|
11
|
+
import { getMachineName } from "./machine-identity.js";
|
|
11
12
|
export const PROJECT_OWNERSHIP_MODES = ["phren-managed", "detached", "repo-managed"];
|
|
12
13
|
export const PROJECT_HOOK_EVENTS = ["UserPromptSubmit", "Stop", "SessionStart", "PostToolUse"];
|
|
13
14
|
export function parseProjectOwnershipMode(raw) {
|
|
@@ -107,10 +108,35 @@ export function updateProjectConfigOverrides(phrenPath, project, updater) {
|
|
|
107
108
|
return next;
|
|
108
109
|
});
|
|
109
110
|
}
|
|
110
|
-
|
|
111
|
-
|
|
111
|
+
/**
|
|
112
|
+
* Where this project's source lives on this machine. The store syncs between
|
|
113
|
+
* computers, so the shared `sourcePath` is often another machine's folder:
|
|
114
|
+
* this machine's `sourcePaths` entry wins, and the shared value is only used
|
|
115
|
+
* when nothing more specific was recorded.
|
|
116
|
+
*/
|
|
117
|
+
export function getProjectSourcePath(phrenPath, project, config, machine = getMachineName()) {
|
|
118
|
+
const resolved = config ?? readProjectConfig(phrenPath, project);
|
|
119
|
+
const perMachine = resolved.sourcePaths && typeof resolved.sourcePaths === "object" && !Array.isArray(resolved.sourcePaths)
|
|
120
|
+
? resolved.sourcePaths[machine]
|
|
121
|
+
: undefined;
|
|
122
|
+
const raw = typeof perMachine === "string" && perMachine.trim() ? perMachine : resolved.sourcePath;
|
|
112
123
|
return typeof raw === "string" && raw.trim() ? path.resolve(raw) : undefined;
|
|
113
124
|
}
|
|
125
|
+
/**
|
|
126
|
+
* Record `sourceRoot` as this machine's folder for the project, alongside the
|
|
127
|
+
* legacy shared `sourcePath` older CLIs read.
|
|
128
|
+
*/
|
|
129
|
+
export function recordProjectSourcePath(phrenPath, project, sourceRoot, patch = {}, machine = getMachineName()) {
|
|
130
|
+
const current = readProjectConfig(phrenPath, project);
|
|
131
|
+
const existing = current.sourcePaths && typeof current.sourcePaths === "object" && !Array.isArray(current.sourcePaths)
|
|
132
|
+
? current.sourcePaths
|
|
133
|
+
: {};
|
|
134
|
+
return writeProjectConfig(phrenPath, project, {
|
|
135
|
+
...patch,
|
|
136
|
+
sourcePath: sourceRoot,
|
|
137
|
+
sourcePaths: { ...existing, [machine]: sourceRoot },
|
|
138
|
+
});
|
|
139
|
+
}
|
|
114
140
|
export function getProjectOwnershipDefault(phrenPath) {
|
|
115
141
|
return parseProjectOwnershipMode(readInstallPreferences(phrenPath).projectOwnershipDefault) ?? "phren-managed";
|
|
116
142
|
}
|
package/dist/project-topics.js
CHANGED
|
@@ -2,11 +2,11 @@ import * as crypto from "crypto";
|
|
|
2
2
|
import * as fs from "fs";
|
|
3
3
|
import * as path from "path";
|
|
4
4
|
import { debugLog } from "./shared.js";
|
|
5
|
-
import { withFileLock } from "./
|
|
5
|
+
import { withFileLock } from "./governance/locks.js";
|
|
6
6
|
import { STOP_WORDS, errorMessage, extractKeywords, isValidProjectName } from "./utils.js";
|
|
7
7
|
import { storeAwareProjectPath } from "./store-routing.js";
|
|
8
8
|
import { walkDirectory } from "./shared/data-utils.js";
|
|
9
|
-
import { FINDINGS_FILENAME } from "./
|
|
9
|
+
import { FINDINGS_FILENAME } from "./filenames.js";
|
|
10
10
|
const TOPIC_CONFIG_FILENAME = "topic-config.json";
|
|
11
11
|
const AUTO_TOPIC_MARKER_RE = /^<!--\s*phren:auto-topic(?:\s+slug=([a-z0-9_-]+))?\s*-->$/;
|
|
12
12
|
const ARCHIVED_SECTION_RE = /^## Archived (\d{4}-\d{2}-\d{2})$/;
|
|
@@ -412,7 +412,7 @@ function countByTerm(terms) {
|
|
|
412
412
|
}
|
|
413
413
|
function readTopicInputContent(phrenPath, project) {
|
|
414
414
|
const parts = [];
|
|
415
|
-
for (const file of ["
|
|
415
|
+
for (const file of ["AGENTS.md", FINDINGS_FILENAME]) {
|
|
416
416
|
const filePath = storeAwareProjectPath(phrenPath, project, file);
|
|
417
417
|
if (!filePath || !fs.existsSync(filePath))
|
|
418
418
|
continue;
|
|
@@ -898,7 +898,7 @@ function tokenizeSuggestionTerms(text) {
|
|
|
898
898
|
}
|
|
899
899
|
function collectSuggestionCorpus(phrenPath, project) {
|
|
900
900
|
const parts = [];
|
|
901
|
-
for (const file of ["
|
|
901
|
+
for (const file of ["AGENTS.md", "summary.md", FINDINGS_FILENAME]) {
|
|
902
902
|
const filePath = storeAwareProjectPath(phrenPath, project, file);
|
|
903
903
|
if (!filePath || !fs.existsSync(filePath))
|
|
904
904
|
continue;
|
|
@@ -1,10 +1,7 @@
|
|
|
1
1
|
import * as fs from "fs";
|
|
2
|
-
import * as os from "os";
|
|
3
2
|
import * as path from "path";
|
|
3
|
+
import { homeDir } from "./phren-paths.js";
|
|
4
4
|
export const HOOK_TOOL_NAMES = ["claude", "copilot", "cursor", "codex"];
|
|
5
|
-
function homeDir(env = process.env) {
|
|
6
|
-
return env.HOME || env.USERPROFILE || os.homedir();
|
|
7
|
-
}
|
|
8
5
|
function joinPortable(base, ...parts) {
|
|
9
6
|
const usePosix = base.startsWith("/") && !base.includes("\\");
|
|
10
7
|
if (usePosix) {
|
|
@@ -86,10 +86,10 @@ export function markCorrelationsHelpful(phrenPath, sessionId, docKey) {
|
|
|
86
86
|
debugLog(`query-correlation mark-helpful failed: ${errorMessage(err)}`);
|
|
87
87
|
}
|
|
88
88
|
}
|
|
89
|
-
/**
|
|
90
|
-
*
|
|
91
|
-
*/
|
|
92
|
-
function
|
|
89
|
+
/** Lowercased whitespace-separated keywords for overlap comparison. Unlike the
|
|
90
|
+
* search fallback it keeps punctuation and does not stem: correlation keys
|
|
91
|
+
* are stored keyword strings, compared as written. */
|
|
92
|
+
function keywordSet(text) {
|
|
93
93
|
return new Set(text
|
|
94
94
|
.toLowerCase()
|
|
95
95
|
.split(/\s+/)
|
|
@@ -113,14 +113,14 @@ export function getCorrelatedDocs(phrenPath, keywords, limit = 3) {
|
|
|
113
113
|
const lines = raw.split("\n").filter(Boolean);
|
|
114
114
|
// Only look at last RECENT_WINDOW entries to keep it fast
|
|
115
115
|
const recent = lines.slice(-RECENT_WINDOW);
|
|
116
|
-
const queryTokens =
|
|
116
|
+
const queryTokens = keywordSet(keywords);
|
|
117
117
|
if (queryTokens.size === 0)
|
|
118
118
|
return [];
|
|
119
119
|
const docScores = new Map();
|
|
120
120
|
for (const line of recent) {
|
|
121
121
|
try {
|
|
122
122
|
const entry = JSON.parse(line);
|
|
123
|
-
const entryTokens =
|
|
123
|
+
const entryTokens = keywordSet(entry.keywords);
|
|
124
124
|
// Calculate overlap between current query and past query
|
|
125
125
|
let overlap = 0;
|
|
126
126
|
for (const t of queryTokens) {
|