@phren/cli 0.2.15 → 0.3.0
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 +195 -2
- package/dist/bridge/agent-hooks.js +1049 -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 +23 -0
- package/dist/bridge/code-note.js +51 -0
- package/dist/bridge/code-routes.d.ts +151 -0
- package/dist/bridge/code-routes.js +442 -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 +125 -0
- package/dist/bridge/dispatch-returns.js +283 -0
- package/dist/bridge/dispatch-tree.d.ts +54 -0
- package/dist/bridge/dispatch-tree.js +198 -0
- package/dist/bridge/dispatch.d.ts +210 -0
- package/dist/bridge/dispatch.js +286 -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 +28 -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 +61 -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 +54 -0
- package/dist/bridge/schedule-watch.js +255 -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 +36 -0
- package/dist/bridge/server-pane-routes.js +479 -0
- package/dist/bridge/server-routes.d.ts +108 -0
- package/dist/bridge/server-routes.js +556 -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 +96 -0
- package/dist/bridge/transcript-preview.js +491 -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 +46545 -21051
- package/dist/cli/actions.js +14 -1
- package/dist/cli/config-policy.js +25 -0
- 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.d.ts +0 -8
- package/dist/cli/extract.js +4 -7
- 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 +17 -4
- package/dist/content/validate.js +200 -122
- 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 +16 -1
- package/dist/data/access.js +31 -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 +525 -419
- 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 +11 -8
- 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 -15
- package/dist/hooks.js +14 -1
- 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 +15 -5
- package/dist/init/init-walkthrough.js +1 -1
- 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 +68 -593
- package/dist/init/shared.js +2 -0
- package/dist/init/store-gitignore.d.ts +1 -6
- package/dist/init/store-gitignore.js +2 -8
- package/dist/init/teardown.d.ts +1 -1
- package/dist/init/teardown.js +2 -2
- package/dist/link/context-imports.d.ts +15 -0
- package/dist/link/context-imports.js +101 -0
- package/dist/link/context.js +1 -1
- package/dist/link/doctor.d.ts +22 -1
- package/dist/link/doctor.js +128 -58
- 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 -19
- package/dist/mcp/profile.js +64 -22
- package/dist/memory-ui-graph.runtime.js +525 -419
- package/dist/modules/code-package.d.ts +16 -0
- package/dist/modules/code-package.js +160 -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 +43 -8
- package/dist/project-config.d.ts +19 -1
- package/dist/project-config.js +29 -3
- package/dist/project-topics.d.ts +1 -0
- package/dist/project-topics.js +13 -10
- 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 -3
- package/dist/shared/retrieval.js +101 -12
- 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 +186 -0
- package/dist/tools/config.js +8 -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.d.ts +11 -0
- package/dist/tools/finding.js +180 -123
- 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 +52 -7
- package/dist/update.js +22 -11
- 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 +49 -7
- 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
package/dist/tools/session.js
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { nonInteractiveGitEnv } from "../utils-helpers.js";
|
|
2
|
+
import { moduleEnabled } from "../modules/runtime.js";
|
|
1
3
|
import { mcpResponse, resolveStoreForProject } from "./types.js";
|
|
2
4
|
import { z } from "zod";
|
|
3
5
|
import * as fs from "fs";
|
|
@@ -14,15 +16,15 @@ import { readTasks } from "../data/tasks.js";
|
|
|
14
16
|
import { readFindings, FINDINGS_FILENAME } from "../data/access.js";
|
|
15
17
|
import { getActiveTaskForSession } from "../task/lifecycle.js";
|
|
16
18
|
import { listTaskCheckpoints, writeTaskCheckpoint } from "../session/checkpoints.js";
|
|
17
|
-
import { findMostRecentSummaryWithProject as findMostRecentSummaryRecord, writeLastSummary
|
|
19
|
+
import { findMostRecentSummaryWithProject as findMostRecentSummaryRecord, writeLastSummary, } from "../session/artifacts.js";
|
|
18
20
|
import { markImpactEntriesCompletedForSession } from "../finding/impact.js";
|
|
19
|
-
import { debugError, scanSessionFiles,
|
|
21
|
+
import { debugError, scanSessionFiles, runtimeSessionsDir, sessionFileForId, readSessionStateFile, writeSessionStateFile, } from "../session/utils.js";
|
|
20
22
|
import { getRuntimeHealth } from "../governance/policy.js";
|
|
21
23
|
import { getProjectSourcePath, readProjectConfig } from "../project-config.js";
|
|
22
24
|
const STALE_SESSION_MS = 24 * 60 * 60 * 1000; // 24 hours
|
|
23
25
|
function collectGitStatusSnapshot(cwd) {
|
|
24
26
|
try {
|
|
25
|
-
const output = execFileSync("git", ["status", "--short"], { cwd, encoding: "utf8" }).trim();
|
|
27
|
+
const output = execFileSync("git", ["status", "--short"], { env: nonInteractiveGitEnv(), cwd, encoding: "utf8" }).trim();
|
|
26
28
|
if (!output)
|
|
27
29
|
return { gitStatus: "", editedFiles: [] };
|
|
28
30
|
const lines = output.split("\n").map((line) => line.trim()).filter(Boolean);
|
|
@@ -96,7 +98,7 @@ const MAX_SESSION_MAP_ENTRIES = 200;
|
|
|
96
98
|
const _sessionMap = new Map();
|
|
97
99
|
/** Find the most recent *active* (not ended) session file by mtime. */
|
|
98
100
|
function findMostRecentSession(phrenPath) {
|
|
99
|
-
const dir =
|
|
101
|
+
const dir = runtimeSessionsDir(phrenPath);
|
|
100
102
|
const results = scanSessionFiles(dir, readSessionStateFile, (state) => !state.endedAt, { errorScope: "findMostRecentSession" });
|
|
101
103
|
if (results.length === 0)
|
|
102
104
|
return null;
|
|
@@ -108,7 +110,7 @@ export function resolveActiveSessionScope(phrenPath, project) {
|
|
|
108
110
|
const envScope = normalizeMemoryScope(process.env.PHREN_SCOPE);
|
|
109
111
|
if (envScope)
|
|
110
112
|
return envScope;
|
|
111
|
-
const dir =
|
|
113
|
+
const dir = runtimeSessionsDir(phrenPath);
|
|
112
114
|
const results = scanSessionFiles(dir, readSessionStateFile, (state) => {
|
|
113
115
|
if (state.endedAt)
|
|
114
116
|
return false;
|
|
@@ -128,10 +130,6 @@ export function resolveActiveSessionScope(phrenPath, project) {
|
|
|
128
130
|
}
|
|
129
131
|
return normalizeMemoryScope(bestState?.agentScope);
|
|
130
132
|
}
|
|
131
|
-
/** Write the last summary for fast retrieval by next session_start. */
|
|
132
|
-
function writeLastSummary(phrenPath, summary, sessionId, project) {
|
|
133
|
-
writeLastSummaryRecord(phrenPath, { summary, sessionId, project, endedAt: new Date().toISOString() });
|
|
134
|
-
}
|
|
135
133
|
/** Find the most recent session with a summary (including ended sessions).
|
|
136
134
|
* @internal Exported for tests. */
|
|
137
135
|
export function findMostRecentSummary(phrenPath) {
|
|
@@ -163,7 +161,7 @@ function resolveSessionFile(phrenPath, sessionId, connectionId) {
|
|
|
163
161
|
}
|
|
164
162
|
/** Remove session files older than 24 hours. */
|
|
165
163
|
function cleanupStaleSessions(phrenPath) {
|
|
166
|
-
const dir =
|
|
164
|
+
const dir = runtimeSessionsDir(phrenPath);
|
|
167
165
|
// Scan all session files (keep all, we'll filter and unlink manually)
|
|
168
166
|
const results = scanSessionFiles(dir, (filePath) => readSessionStateFile(filePath) ?? null, () => true, // accept everything — we decide inside the loop
|
|
169
167
|
{ includeMtime: false, errorScope: "cleanupStaleSessions" });
|
|
@@ -230,7 +228,7 @@ function incrementSessionCounter(phrenPath, field, count = 1, sessionId, project
|
|
|
230
228
|
}
|
|
231
229
|
/** List all sessions (both active and ended) from the sessions directory, sorted newest first. */
|
|
232
230
|
export function listAllSessions(phrenPath, limit = 50) {
|
|
233
|
-
const dir =
|
|
231
|
+
const dir = runtimeSessionsDir(phrenPath);
|
|
234
232
|
// scanSessionFiles returns results sorted by mtime (newest first)
|
|
235
233
|
const results = scanSessionFiles(dir, readSessionStateFile, () => true, { errorScope: "listAllSessions" });
|
|
236
234
|
const entries = [];
|
|
@@ -357,6 +355,7 @@ function computeSessionDiff(phrenPath, project, lastSessionEnd) {
|
|
|
357
355
|
}
|
|
358
356
|
export function register(server, ctx) {
|
|
359
357
|
const { phrenPath } = ctx;
|
|
358
|
+
const tasksEnabled = moduleEnabled(phrenPath, "tasks", ctx.profile);
|
|
360
359
|
server.registerTool("session_start", {
|
|
361
360
|
title: "◆ phren · session start",
|
|
362
361
|
description: "Mark the start of a new session and retrieve context from prior sessions. Call this at the start of a conversation when not using hooks. Returns prior session summary and recent project findings. The returned sessionId should be passed to session_end and session_context to avoid cross-client collisions.",
|
|
@@ -565,7 +564,7 @@ export function register(server, ctx) {
|
|
|
565
564
|
// session_start can restore project context even after a normal session_end.
|
|
566
565
|
const effectiveSummary = endedState.summary;
|
|
567
566
|
if (effectiveSummary) {
|
|
568
|
-
writeLastSummary(phrenPath, effectiveSummary, state.sessionId, endedState.project);
|
|
567
|
+
writeLastSummary(phrenPath, { summary: effectiveSummary, sessionId: state.sessionId, project: endedState.project });
|
|
569
568
|
}
|
|
570
569
|
if (endedState.project && isValidProjectName(endedState.project)) {
|
|
571
570
|
const projectStorePath = (() => {
|
|
@@ -579,7 +578,7 @@ export function register(server, ctx) {
|
|
|
579
578
|
}
|
|
580
579
|
})();
|
|
581
580
|
try {
|
|
582
|
-
const trackedActiveTask = getActiveTaskForSession(projectStorePath, state.sessionId, endedState.project);
|
|
581
|
+
const trackedActiveTask = moduleEnabled(projectStorePath, "tasks", ctx.profile) ? getActiveTaskForSession(projectStorePath, state.sessionId, endedState.project) : null;
|
|
583
582
|
const activeTask = trackedActiveTask ?? (() => {
|
|
584
583
|
const tasks = readTasks(projectStorePath, endedState.project);
|
|
585
584
|
if (!tasks.ok)
|
|
@@ -591,7 +590,7 @@ export function register(server, ctx) {
|
|
|
591
590
|
const projectConfig = readProjectConfig(projectStorePath, endedState.project);
|
|
592
591
|
const snapshotRoot = getProjectSourcePath(projectStorePath, endedState.project, projectConfig) ||
|
|
593
592
|
path.join(projectStorePath, endedState.project);
|
|
594
|
-
const { gitStatus, editedFiles } = collectGitStatusSnapshot(snapshotRoot);
|
|
593
|
+
const { gitStatus, editedFiles } = moduleEnabled(projectStorePath, "git", ctx.profile) ? collectGitStatusSnapshot(snapshotRoot) : { gitStatus: "", editedFiles: [] };
|
|
595
594
|
const resumptionHint = extractResumptionHint(effectiveSummary, activeTask.line, activeTask.context || "No prior attempt captured");
|
|
596
595
|
writeTaskCheckpoint(phrenPath, {
|
|
597
596
|
project: endedState.project,
|
|
@@ -626,17 +625,17 @@ export function register(server, ctx) {
|
|
|
626
625
|
PHREN_SESSION_ID: state.sessionId,
|
|
627
626
|
PHREN_DURATION_MINS: String(durationMins),
|
|
628
627
|
PHREN_FINDINGS_ADDED: String(endedState.findingsAdded),
|
|
629
|
-
PHREN_TASKS_COMPLETED: String(Number.isFinite(endedState.tasksCompleted) ? endedState.tasksCompleted : 0),
|
|
628
|
+
...(tasksEnabled ? { PHREN_TASKS_COMPLETED: String(Number.isFinite(endedState.tasksCompleted) ? endedState.tasksCompleted : 0) } : {}),
|
|
630
629
|
...(endedState.project ? { PHREN_PROJECT: endedState.project } : {}),
|
|
631
630
|
});
|
|
632
631
|
return mcpResponse({
|
|
633
632
|
ok: true,
|
|
634
|
-
message: `Session ended. Duration: ~${durationMins} min. ${endedState.findingsAdded} finding(s) added
|
|
633
|
+
message: `Session ended. Duration: ~${durationMins} min. ${endedState.findingsAdded} finding(s) added${tasksEnabled ? `, ${Number.isFinite(endedState.tasksCompleted) ? endedState.tasksCompleted : 0} task(s) completed` : ""}.${summary ? " Summary saved for next session." : ""}`,
|
|
635
634
|
data: {
|
|
636
635
|
sessionId: state.sessionId,
|
|
637
636
|
durationMins,
|
|
638
637
|
findingsAdded: endedState.findingsAdded,
|
|
639
|
-
tasksCompleted: Number.isFinite(endedState.tasksCompleted) ? endedState.tasksCompleted : 0,
|
|
638
|
+
...(tasksEnabled ? { tasksCompleted: Number.isFinite(endedState.tasksCompleted) ? endedState.tasksCompleted : 0 } : {}),
|
|
640
639
|
},
|
|
641
640
|
});
|
|
642
641
|
});
|
|
@@ -664,7 +663,7 @@ export function register(server, ctx) {
|
|
|
664
663
|
`Started: ${state.startedAt}`,
|
|
665
664
|
`Duration: ~${durationMins} min`,
|
|
666
665
|
`Findings added: ${state.findingsAdded}`,
|
|
667
|
-
`Tasks completed: ${Number.isFinite(state.tasksCompleted) ? state.tasksCompleted : 0}
|
|
666
|
+
...(tasksEnabled ? [`Tasks completed: ${Number.isFinite(state.tasksCompleted) ? state.tasksCompleted : 0}`] : []),
|
|
668
667
|
];
|
|
669
668
|
if (state.summary)
|
|
670
669
|
parts.push(`Prior summary: ${state.summary}`);
|
|
@@ -672,10 +671,10 @@ export function register(server, ctx) {
|
|
|
672
671
|
});
|
|
673
672
|
server.registerTool("session_history", {
|
|
674
673
|
title: "◆ phren · session history",
|
|
675
|
-
description: "List past sessions with their duration, findings count, and summary. Optionally drill into a specific session to see all
|
|
674
|
+
description: "List past sessions with their duration, findings count, and summary. Optionally drill into a specific session to see all artifacts created during it.",
|
|
676
675
|
inputSchema: z.object({
|
|
677
676
|
limit: z.number().optional().describe("Max sessions to return (default 20)."),
|
|
678
|
-
sessionId: z.string().optional().describe("If provided, return full artifacts
|
|
677
|
+
sessionId: z.string().optional().describe("If provided, return full session artifacts for this session instead of listing all sessions."),
|
|
679
678
|
project: z.string().optional().describe("Filter sessions and artifacts by project."),
|
|
680
679
|
}),
|
|
681
680
|
}, async ({ limit, sessionId: targetSessionId, project }) => {
|
|
@@ -693,7 +692,7 @@ export function register(server, ctx) {
|
|
|
693
692
|
`Status: ${session.status}`,
|
|
694
693
|
`Duration: ~${session.durationMins ?? 0} min`,
|
|
695
694
|
`Findings: ${artifacts.findings.length}`,
|
|
696
|
-
`Tasks: ${artifacts.tasks.length}
|
|
695
|
+
...(tasksEnabled ? [`Tasks: ${artifacts.tasks.length}`] : []),
|
|
697
696
|
];
|
|
698
697
|
if (session.summary)
|
|
699
698
|
parts.push(`\nSummary: ${session.summary}`);
|
|
@@ -722,7 +721,7 @@ export function register(server, ctx) {
|
|
|
722
721
|
const dur = s.durationMins != null ? `${s.durationMins}m` : "?";
|
|
723
722
|
const status = s.status === "active" ? " ●" : "";
|
|
724
723
|
const findings = s.findingsAdded > 0 ? ` ${s.findingsAdded}f` : "";
|
|
725
|
-
const tasks = s.tasksCompleted > 0 ? ` ${s.tasksCompleted}t` : "";
|
|
724
|
+
const tasks = tasksEnabled && s.tasksCompleted > 0 ? ` ${s.tasksCompleted}t` : "";
|
|
726
725
|
const date = s.startedAt.slice(0, 16).replace("T", " ");
|
|
727
726
|
return `${id}${status} ${date} ${dur}${findings}${tasks} ${proj}${s.summary ? " " + s.summary.slice(0, 60) : ""}`;
|
|
728
727
|
});
|
package/dist/tools/tasks.js
CHANGED
|
@@ -370,9 +370,15 @@ export function register(server, ctx) {
|
|
|
370
370
|
promote: z.boolean().optional().describe("If true, clear the speculative flag on this task (confirm the user wants it)."),
|
|
371
371
|
move_to_active: z.boolean().optional().describe("Used with promote: also move the task to the Active section."),
|
|
372
372
|
work_next: z.boolean().optional().describe("If true, pick the highest-priority Queue item and move it to Active. Ignores item param."),
|
|
373
|
+
item: z.unknown().optional().describe("Not read here: item is a top-level parameter beside updates."),
|
|
373
374
|
}).describe("Fields to update. All are optional."),
|
|
374
375
|
}),
|
|
375
|
-
}, async ({ project: projectInput, item, updates }) => {
|
|
376
|
+
}, async ({ project: projectInput, item, updates: given }) => {
|
|
377
|
+
// A caller that nests item inside updates would otherwise hear only that item is missing.
|
|
378
|
+
const { item: misplacedItem, ...updates } = given;
|
|
379
|
+
if (misplacedItem !== undefined) {
|
|
380
|
+
return mcpResponse({ ok: false, error: "item is a top-level parameter, not a field of updates. Pass it beside updates: { project, item, updates }." });
|
|
381
|
+
}
|
|
376
382
|
const resolved = resolveStoreForProject(ctx, projectInput);
|
|
377
383
|
const project = resolved.project;
|
|
378
384
|
const targetPath = resolved.phrenPath;
|
|
@@ -453,7 +459,7 @@ export function register(server, ctx) {
|
|
|
453
459
|
if (!repo) {
|
|
454
460
|
return mcpResponse({
|
|
455
461
|
ok: false,
|
|
456
|
-
error: "Could not infer a GitHub repo. Add a GitHub URL to
|
|
462
|
+
error: "Could not infer a GitHub repo. Add a GitHub URL to AGENTS.md or summary.md, or link an existing issue instead.",
|
|
457
463
|
});
|
|
458
464
|
}
|
|
459
465
|
const created = createGithubIssueForTask({
|
package/dist/tools/types.d.ts
CHANGED
|
@@ -28,8 +28,8 @@ export interface McpContext {
|
|
|
28
28
|
*/
|
|
29
29
|
export type StoreAccessMode = "read" | "write";
|
|
30
30
|
/**
|
|
31
|
-
* Error raised when a project is claimed by a store that is
|
|
32
|
-
*
|
|
31
|
+
* Error raised when a project is claimed by a store that is attached on this
|
|
32
|
+
* machine but whose directory is missing. Distinct class so callers
|
|
33
33
|
* can special-case it if they ever want to offer an interactive fix.
|
|
34
34
|
*/
|
|
35
35
|
export declare class StoreUnavailableError extends Error {
|
package/dist/tools/types.js
CHANGED
|
@@ -2,8 +2,8 @@ import { parseStoreQualified } from "../store-routing.js";
|
|
|
2
2
|
import { describeUnavailableStore, resolveAllStores } from "../store-registry.js";
|
|
3
3
|
import { logger } from "../logger.js";
|
|
4
4
|
/**
|
|
5
|
-
* Error raised when a project is claimed by a store that is
|
|
6
|
-
*
|
|
5
|
+
* Error raised when a project is claimed by a store that is attached on this
|
|
6
|
+
* machine but whose directory is missing. Distinct class so callers
|
|
7
7
|
* can special-case it if they ever want to offer an interactive fix.
|
|
8
8
|
*/
|
|
9
9
|
export class StoreUnavailableError extends Error {
|