@phren/cli 0.2.15 → 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.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 +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
package/dist/status.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { moduleEnabled } from "./modules/runtime.js";
|
|
1
2
|
import * as fs from "fs";
|
|
2
3
|
import * as path from "path";
|
|
3
4
|
import { fileURLToPath } from "url";
|
|
@@ -7,7 +8,7 @@ import { mergeConfig, getWorkflowPolicy } from "./shared/governance.js";
|
|
|
7
8
|
import { getMcpEnabledPreference, getHooksEnabledPreference } from "./init/init.js";
|
|
8
9
|
import { getManagementPreset, resolveManagementCapabilities } from "./init/management-preset.js";
|
|
9
10
|
import { getTelemetrySummary } from "./telemetry.js";
|
|
10
|
-
import { runGit
|
|
11
|
+
import { runGit, errorMessage } from "./utils.js";
|
|
11
12
|
import { logger } from "./logger.js";
|
|
12
13
|
import { readRuntimeHealth, resolveTaskFilePath, FINDINGS_FILENAME } from "./data/access.js";
|
|
13
14
|
import { assessSyncOutage } from "./shared/governance.js";
|
|
@@ -15,6 +16,8 @@ import { resolveRuntimeProfile } from "./runtime-profile.js";
|
|
|
15
16
|
import { renderPhrenArt } from "./phren-art.js";
|
|
16
17
|
import { RESET, BOLD, DIM, GREEN, YELLOW, RED, CYAN } from "./shell/render.js";
|
|
17
18
|
import { storeWeight } from "./store-weight.js";
|
|
19
|
+
import { activeStoreAuthFailure, storeAuthDetail } from "./sync/auth.js";
|
|
20
|
+
import { describeAutoSave } from "./sync/outcome.js";
|
|
18
21
|
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
19
22
|
function readPackageVersion() {
|
|
20
23
|
try {
|
|
@@ -41,9 +44,6 @@ function countQueueItems(phrenPath, project) {
|
|
|
41
44
|
const queueFile = path.join(phrenPath, project, "review.md");
|
|
42
45
|
return countBullets(queueFile);
|
|
43
46
|
}
|
|
44
|
-
function runGit(cwd, args) {
|
|
45
|
-
return runGitShared(cwd, args, EXEC_TIMEOUT_QUICK_MS, debugLog);
|
|
46
|
-
}
|
|
47
47
|
function hasCommandHook(value) {
|
|
48
48
|
if (!Array.isArray(value))
|
|
49
49
|
return false;
|
|
@@ -81,14 +81,15 @@ export async function runStatus() {
|
|
|
81
81
|
? `${resolved.taskMode} ${DIM}(project override)${RESET}`
|
|
82
82
|
: resolved.taskMode;
|
|
83
83
|
console.log(` ${DIM}sensitivity${RESET} ${projectSensitivity}`);
|
|
84
|
-
|
|
84
|
+
if (moduleEnabled(phrenPath, "tasks", profile))
|
|
85
|
+
console.log(` ${DIM}task mode${RESET} ${projectTaskMode}`);
|
|
85
86
|
if (resolved.proactivity.base || resolved.proactivity.findings || resolved.proactivity.tasks) {
|
|
86
87
|
const parts = [];
|
|
87
88
|
if (resolved.proactivity.base)
|
|
88
89
|
parts.push(`base:${resolved.proactivity.base}`);
|
|
89
90
|
if (resolved.proactivity.findings)
|
|
90
91
|
parts.push(`findings:${resolved.proactivity.findings}`);
|
|
91
|
-
if (resolved.proactivity.tasks)
|
|
92
|
+
if (moduleEnabled(phrenPath, "tasks", profile) && resolved.proactivity.tasks)
|
|
92
93
|
parts.push(`tasks:${resolved.proactivity.tasks}`);
|
|
93
94
|
console.log(` ${DIM}proactivity${RESET} ${parts.join(" ")} ${DIM}(project override)${RESET}`);
|
|
94
95
|
}
|
|
@@ -104,7 +105,7 @@ export async function runStatus() {
|
|
|
104
105
|
try {
|
|
105
106
|
const w = storeWeight(phrenPath, profile);
|
|
106
107
|
const k = (n) => (n >= 1000 ? `${(n / 1000).toFixed(n >= 10000 ? 0 : 1)}k` : String(n));
|
|
107
|
-
console.log(` ${DIM}weight${RESET} ${k(w.findings)} words of findings · ${k(w.reference)} archived · ${k(w.tasks)} in tasks · ${k(w.skills)} in skills ·
|
|
108
|
+
console.log(` ${DIM}weight${RESET} ${k(w.findings)} words of findings · ${k(w.reference)} archived${moduleEnabled(phrenPath, "tasks", profile) ? ` · ${k(w.tasks)} in tasks` : ""} · ${k(w.skills)} in skills · AGENTS.md ${w.globalClaude} words`);
|
|
108
109
|
}
|
|
109
110
|
catch (err) {
|
|
110
111
|
logger.debug("status", `weight: ${errorMessage(err)}`);
|
|
@@ -325,10 +326,12 @@ export async function runStatus() {
|
|
|
325
326
|
for (const store of stores) {
|
|
326
327
|
const exists = store.available !== false;
|
|
327
328
|
const existsLabel = exists ? `${GREEN}yes${RESET}` : `${RED}no${RESET}`;
|
|
328
|
-
|
|
329
|
+
const auth = exists ? activeStoreAuthFailure(store.path) : undefined;
|
|
330
|
+
const syncDetail = auth ? ` ${YELLOW}${storeAuthDetail(auth)}${RESET}` : store.remote ? ` remote=${DIM}${store.remote}${RESET}` : "";
|
|
331
|
+
console.log(` ${store.name} ${DIM}(${store.role}, ${store.sync})${RESET} path=${existsLabel}${syncDetail}`);
|
|
329
332
|
}
|
|
330
|
-
// A store
|
|
331
|
-
// project it claims cannot be written until
|
|
333
|
+
// A store attached here whose folder is gone is not cosmetic: any
|
|
334
|
+
// project it claims cannot be written until the folder is back.
|
|
332
335
|
const { describeUnavailableStore } = await import("./store-registry.js");
|
|
333
336
|
for (const store of stores.filter((s) => s.available === false)) {
|
|
334
337
|
console.log(` ${YELLOW}! ${describeUnavailableStore(store)}${RESET}`);
|
|
@@ -350,15 +353,15 @@ export async function runStatus() {
|
|
|
350
353
|
for (const dir of projectDirs) {
|
|
351
354
|
const projName = path.basename(dir);
|
|
352
355
|
totalFindings += countBullets(path.join(phrenPath, projName, FINDINGS_FILENAME));
|
|
353
|
-
const taskPath = resolveTaskFilePath(phrenPath, projName);
|
|
356
|
+
const taskPath = moduleEnabled(phrenPath, "tasks", profile) ? resolveTaskFilePath(phrenPath, projName) : null;
|
|
354
357
|
if (taskPath)
|
|
355
358
|
totalTask += countBullets(taskPath);
|
|
356
359
|
totalQueue += countQueueItems(phrenPath, projName);
|
|
357
360
|
}
|
|
358
|
-
console.log(`\n ${DIM}phren holds${RESET} ${projectDirs.length} projects, ${totalFindings} findings, ${totalTask} tasks, ${totalQueue} queued`);
|
|
361
|
+
console.log(`\n ${DIM}phren holds${RESET} ${projectDirs.length} projects, ${totalFindings} findings${moduleEnabled(phrenPath, "tasks", profile) ? `, ${totalTask} tasks` : ""}, ${totalQueue} queued`);
|
|
359
362
|
const gitTarget = manifest?.installMode === "project-local" && manifest.workspaceRoot ? manifest.workspaceRoot : phrenPath;
|
|
360
|
-
const isGitRepo = runGit(gitTarget, ["rev-parse", "--is-inside-work-tree"]) === "true";
|
|
361
|
-
const hasOriginRemote = isGitRepo && Boolean(runGit(gitTarget, ["remote", "get-url", "origin"]));
|
|
363
|
+
const isGitRepo = runGit(gitTarget, ["rev-parse", "--is-inside-work-tree"], EXEC_TIMEOUT_QUICK_MS, debugLog) === "true";
|
|
364
|
+
const hasOriginRemote = isGitRepo && Boolean(runGit(gitTarget, ["remote", "get-url", "origin"], EXEC_TIMEOUT_QUICK_MS, debugLog));
|
|
362
365
|
const runtime = readRuntimeHealth(phrenPath);
|
|
363
366
|
if (manifest?.installMode === "project-local") {
|
|
364
367
|
console.log(`\n ${DIM}sync${RESET} workspace-managed`);
|
|
@@ -371,13 +374,16 @@ export async function runStatus() {
|
|
|
371
374
|
}
|
|
372
375
|
else {
|
|
373
376
|
console.log(`\n ${DIM}sync${RESET} auto-save ${runtime.lastAutoSave?.status || "n/a"}`);
|
|
377
|
+
if (runtime.lastAutoSave?.status === "sync-failed" || runtime.lastAutoSave?.status === "error") {
|
|
378
|
+
console.log(` ${RED}${describeAutoSave(runtime.lastAutoSave, runtime.lastSync)}${RESET}`);
|
|
379
|
+
}
|
|
374
380
|
console.log(` last pull ${runtime.lastSync?.lastPullStatus || "n/a"}${runtime.lastSync?.lastPullAt ? ` @ ${runtime.lastSync.lastPullAt}` : ""}`);
|
|
375
381
|
console.log(` last push ${runtime.lastSync?.lastPushStatus || "n/a"}${runtime.lastSync?.lastPushAt ? ` @ ${runtime.lastSync.lastPushAt}` : ""}`);
|
|
376
382
|
console.log(` unsynced commits ${runtime.lastSync?.unsyncedCommits ?? 0}`);
|
|
377
383
|
if (runtime.lastSync?.lastSuccessfulPushAt) {
|
|
378
384
|
console.log(` last successful push ${runtime.lastSync.lastSuccessfulPushAt}`);
|
|
379
385
|
}
|
|
380
|
-
if (runtime.lastSync?.lastPushDetail) {
|
|
386
|
+
if (runtime.lastSync?.lastPushDetail && !activeStoreAuthFailure(phrenPath)) {
|
|
381
387
|
console.log(` push detail ${runtime.lastSync.lastPushDetail}`);
|
|
382
388
|
}
|
|
383
389
|
const outage = assessSyncOutage(runtime.lastSync);
|
|
@@ -387,14 +393,14 @@ export async function runStatus() {
|
|
|
387
393
|
}
|
|
388
394
|
// Recent changes (git log)
|
|
389
395
|
if (isGitRepo) {
|
|
390
|
-
const log = runGit(gitTarget, ["log", "--oneline", "-5", "--no-decorate"]);
|
|
396
|
+
const log = runGit(gitTarget, ["log", "--oneline", "-5", "--no-decorate"], EXEC_TIMEOUT_QUICK_MS, debugLog);
|
|
391
397
|
if (log) {
|
|
392
398
|
console.log(`\n ${DIM}recent${RESET}`);
|
|
393
399
|
for (const line of log.split("\n")) {
|
|
394
400
|
console.log(` ${DIM}${line}${RESET}`);
|
|
395
401
|
}
|
|
396
402
|
}
|
|
397
|
-
const dirty = runGit(gitTarget, ["status", "--porcelain"]);
|
|
403
|
+
const dirty = runGit(gitTarget, ["status", "--porcelain"], EXEC_TIMEOUT_QUICK_MS, debugLog);
|
|
398
404
|
if (dirty) {
|
|
399
405
|
const count = dirty.split("\n").filter(Boolean).length;
|
|
400
406
|
console.log(` ${YELLOW}${count} uncommitted change(s)${RESET}`);
|
|
@@ -403,6 +409,21 @@ export async function runStatus() {
|
|
|
403
409
|
else {
|
|
404
410
|
console.log(`\n ${DIM}${gitTarget} is not a git repo${RESET}`);
|
|
405
411
|
}
|
|
412
|
+
// Health: the same data Phren Hook serves at /v1/health/details.
|
|
413
|
+
if (moduleEnabled(phrenPath, "hook", profile)) {
|
|
414
|
+
try {
|
|
415
|
+
const { hookRequest } = await import("./bridge/client.js");
|
|
416
|
+
const { healthDetails, formatHealth } = await import("./bridge/health.js");
|
|
417
|
+
const hook = await hookRequest("/v1/health", undefined, undefined, 2_000).catch(() => undefined);
|
|
418
|
+
const health = await healthDetails({ store: phrenPath, hookVersion: typeof hook?.version === "string" ? hook.version : undefined });
|
|
419
|
+
console.log(`\n ${BOLD}Health${RESET} ${DIM}(${health.computer.name})${RESET}`);
|
|
420
|
+
for (const line of formatHealth(health, { dim: DIM, reset: RESET, red: RED, yellow: YELLOW, green: GREEN }))
|
|
421
|
+
console.log(line);
|
|
422
|
+
}
|
|
423
|
+
catch (err) {
|
|
424
|
+
logger.debug("status", `health: ${errorMessage(err)}`);
|
|
425
|
+
}
|
|
426
|
+
}
|
|
406
427
|
// Telemetry
|
|
407
428
|
const telemetry = getTelemetrySummary(phrenPath);
|
|
408
429
|
const firstLine = telemetry.split("\n")[0];
|
package/dist/store-registry.d.ts
CHANGED
|
@@ -32,15 +32,29 @@ export interface TeamBootstrap {
|
|
|
32
32
|
description?: string;
|
|
33
33
|
default_role?: StoreRole;
|
|
34
34
|
}
|
|
35
|
+
/**
|
|
36
|
+
* The synced registry at the store root. It holds the primary store's entry
|
|
37
|
+
* only, so every machine on this personal store agrees on its id. Team and
|
|
38
|
+
* readonly stores used to live here too, which pushed one machine's `team
|
|
39
|
+
* join` onto every other machine and left doctor failing forever there.
|
|
40
|
+
*/
|
|
35
41
|
export declare const STORES_FILENAME = "stores.yaml";
|
|
42
|
+
/**
|
|
43
|
+
* The stores attached on this machine, under `.runtime/` (never synced).
|
|
44
|
+
* Using the personal store must never connect a machine to a team store.
|
|
45
|
+
*/
|
|
46
|
+
export declare const ATTACHED_STORES_FILENAME = "attached-stores.yaml";
|
|
36
47
|
export declare function storesFilePath(phrenPath: string): string;
|
|
48
|
+
export declare function attachedStoresFilePath(phrenPath: string): string;
|
|
37
49
|
export declare function generateStoreId(): string;
|
|
38
50
|
/**
|
|
39
|
-
* What a registry read actually found
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
*
|
|
51
|
+
* What a registry read actually found: the primary store from the synced
|
|
52
|
+
* stores.yaml plus the stores attached on this machine. `registry` is what
|
|
53
|
+
* could be honored; `problems` says what couldn't; `lossy` means one of the
|
|
54
|
+
* two files EXISTS but the result does not fully represent it (unreadable,
|
|
55
|
+
* unparsable, entries skipped, or validation failed). Mutators must refuse to
|
|
56
|
+
* write while a read is lossy — writing back would silently destroy the
|
|
57
|
+
* entries we skipped.
|
|
44
58
|
*/
|
|
45
59
|
export interface RegistryReadResult {
|
|
46
60
|
registry: StoreRegistry | null;
|
|
@@ -49,28 +63,40 @@ export interface RegistryReadResult {
|
|
|
49
63
|
}
|
|
50
64
|
export declare function readStoreRegistryDetailed(phrenPath: string): RegistryReadResult;
|
|
51
65
|
export declare function readStoreRegistry(phrenPath: string): StoreRegistry | null;
|
|
66
|
+
/**
|
|
67
|
+
* Writes this machine's view of the stores: the primary entry to the synced
|
|
68
|
+
* stores.yaml (only when it changed) and every other store to the machine's
|
|
69
|
+
* own attached-stores.yaml.
|
|
70
|
+
*/
|
|
52
71
|
export declare function writeStoreRegistry(phrenPath: string, registry: StoreRegistry): void;
|
|
53
72
|
/** True when a store's directory exists on this machine. */
|
|
54
73
|
export declare function storePathExists(storePath: string): boolean;
|
|
55
74
|
/**
|
|
56
|
-
* Resolve the full list of stores. This is the **key
|
|
57
|
-
* -
|
|
58
|
-
* -
|
|
59
|
-
*
|
|
75
|
+
* Resolve the full list of stores on this machine. This is the **key
|
|
76
|
+
* backward-compat function**:
|
|
77
|
+
* - The primary comes from the synced stores.yaml, or is implicit when the
|
|
78
|
+
* file is missing
|
|
79
|
+
* - Then every store attached on this machine (.runtime/attached-stores.yaml)
|
|
80
|
+
* - Then PHREN_FEDERATION_PATHS entries as readonly stores
|
|
60
81
|
*
|
|
61
82
|
* Every returned entry carries `available`, recording whether its path exists
|
|
62
|
-
* here.
|
|
63
|
-
* must be able to see that a store claims a project before
|
|
64
|
-
*
|
|
65
|
-
* claims this project" and its writes would land in the primary store.
|
|
83
|
+
* here. Attached stores whose folder is gone are deliberately **still
|
|
84
|
+
* returned**: callers must be able to see that a store claims a project before
|
|
85
|
+
* deciding what to do, otherwise its writes would land in the primary store.
|
|
66
86
|
*/
|
|
67
87
|
export declare function resolveAllStores(phrenPath: string): StoreEntry[];
|
|
68
|
-
/**
|
|
88
|
+
/**
|
|
89
|
+
* Non-primary entries in the synced stores.yaml that this machine does not use:
|
|
90
|
+
* joined on another machine with an older phren. Attached ones were moved into
|
|
91
|
+
* attached-stores.yaml; the rest mean nothing here.
|
|
92
|
+
*/
|
|
93
|
+
export declare function ignoredSyncedStores(phrenPath: string): StoreEntry[];
|
|
94
|
+
/** Stores attached on this machine whose directory is missing. */
|
|
69
95
|
export declare function getUnavailableStores(phrenPath: string): StoreEntry[];
|
|
70
96
|
/**
|
|
71
|
-
* One actionable sentence about a store
|
|
72
|
-
* Shared by write routing, `phren status`, and `phren doctor` so all
|
|
73
|
-
* the same store, the same expected path, and the same remedy.
|
|
97
|
+
* One actionable sentence about a store attached on this machine whose folder
|
|
98
|
+
* is gone. Shared by write routing, `phren status`, and `phren doctor` so all
|
|
99
|
+
* three name the same store, the same expected path, and the same remedy.
|
|
74
100
|
*/
|
|
75
101
|
export declare function describeUnavailableStore(store: StoreEntry): string;
|
|
76
102
|
/** The primary store (role=primary). Falls back to implicit entry. */
|
|
@@ -84,7 +110,7 @@ export declare function findStoreByName(phrenPath: string, name: string): StoreE
|
|
|
84
110
|
/** Get project directories for a store, filtered by the store's subscription list (if set). */
|
|
85
111
|
export declare function getStoreProjectDirs(store: StoreEntry): string[];
|
|
86
112
|
export declare function readTeamBootstrap(storePath: string): TeamBootstrap | null;
|
|
87
|
-
/**
|
|
113
|
+
/** Attach a store on this machine. Creates stores.yaml for the primary if needed. Uses file locking. */
|
|
88
114
|
export declare function addStoreToRegistry(phrenPath: string, entry: StoreEntry): void;
|
|
89
115
|
/** Remove a store entry by name. Refuses to remove primary. Uses file locking. */
|
|
90
116
|
export declare function removeStoreFromRegistry(phrenPath: string, name: string): StoreEntry;
|
package/dist/store-registry.js
CHANGED
|
@@ -2,12 +2,23 @@ import * as fs from "fs";
|
|
|
2
2
|
import * as crypto from "crypto";
|
|
3
3
|
import * as path from "path";
|
|
4
4
|
import * as yaml from "js-yaml";
|
|
5
|
-
import { expandHomePath, atomicWriteText } from "./phren-paths.js";
|
|
5
|
+
import { expandHomePath, atomicWriteText, runtimeDir } from "./phren-paths.js";
|
|
6
6
|
import { withFileLock } from "./governance/locks.js";
|
|
7
7
|
import { isRecord, loadYamlDocument, PhrenError } from "./phren-core.js";
|
|
8
8
|
import { getProjectDirs } from "./shared.js";
|
|
9
9
|
// ── Constants ────────────────────────────────────────────────────────────────
|
|
10
|
+
/**
|
|
11
|
+
* The synced registry at the store root. It holds the primary store's entry
|
|
12
|
+
* only, so every machine on this personal store agrees on its id. Team and
|
|
13
|
+
* readonly stores used to live here too, which pushed one machine's `team
|
|
14
|
+
* join` onto every other machine and left doctor failing forever there.
|
|
15
|
+
*/
|
|
10
16
|
export const STORES_FILENAME = "stores.yaml";
|
|
17
|
+
/**
|
|
18
|
+
* The stores attached on this machine, under `.runtime/` (never synced).
|
|
19
|
+
* Using the personal store must never connect a machine to a team store.
|
|
20
|
+
*/
|
|
21
|
+
export const ATTACHED_STORES_FILENAME = "attached-stores.yaml";
|
|
11
22
|
const TEAM_BOOTSTRAP_FILENAME = ".phren-team.yaml";
|
|
12
23
|
const VALID_ROLES = new Set(["primary", "team", "readonly"]);
|
|
13
24
|
const VALID_SYNC_MODES = new Set(["managed-git", "pull-only"]);
|
|
@@ -15,6 +26,9 @@ const VALID_SYNC_MODES = new Set(["managed-git", "pull-only"]);
|
|
|
15
26
|
export function storesFilePath(phrenPath) {
|
|
16
27
|
return path.join(phrenPath, STORES_FILENAME);
|
|
17
28
|
}
|
|
29
|
+
export function attachedStoresFilePath(phrenPath) {
|
|
30
|
+
return path.join(runtimeDir(phrenPath), ATTACHED_STORES_FILENAME);
|
|
31
|
+
}
|
|
18
32
|
// ── ID generation ────────────────────────────────────────────────────────────
|
|
19
33
|
export function generateStoreId() {
|
|
20
34
|
return crypto.randomUUID().replace(/-/g, "").slice(0, 8);
|
|
@@ -27,25 +41,29 @@ function deterministicIdFromPath(storePath) {
|
|
|
27
41
|
return crypto.createHash("sha256").update(storePath).digest("hex").slice(0, 8);
|
|
28
42
|
}
|
|
29
43
|
export function readStoreRegistryDetailed(phrenPath) {
|
|
30
|
-
const
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
parsed = loadYamlDocument(raw, (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA }));
|
|
44
|
+
const synced = readSyncedRegistry(phrenPath);
|
|
45
|
+
const attached = readAttachedStores(phrenPath, synced.registry);
|
|
46
|
+
const problems = [...synced.problems, ...attached.problems];
|
|
47
|
+
const lossy = synced.lossy || attached.lossy;
|
|
48
|
+
if (!synced.registry && attached.stores.length === 0)
|
|
49
|
+
return { registry: null, problems, lossy };
|
|
50
|
+
const primary = synced.registry?.stores.find((s) => s.role === "primary") ?? implicitPrimaryStore(phrenPath);
|
|
51
|
+
const registry = { version: 1, stores: [primary, ...attached.stores] };
|
|
52
|
+
const err = validateRegistry(registry);
|
|
53
|
+
if (err) {
|
|
54
|
+
problems.push(`${ATTACHED_STORES_FILENAME} failed validation: ${err}`);
|
|
55
|
+
return { registry: synced.registry ? { version: 1, stores: [primary] } : null, problems, lossy: true };
|
|
43
56
|
}
|
|
44
|
-
|
|
45
|
-
|
|
57
|
+
return { registry, problems, lossy };
|
|
58
|
+
}
|
|
59
|
+
/** The synced stores.yaml as written, including entries this machine ignores. */
|
|
60
|
+
function readSyncedRegistry(phrenPath) {
|
|
61
|
+
const parsed = readYamlFile(storesFilePath(phrenPath), STORES_FILENAME);
|
|
62
|
+
if (!parsed.exists || parsed.problems.length > 0) {
|
|
63
|
+
return { registry: null, problems: parsed.problems, lossy: parsed.exists };
|
|
46
64
|
}
|
|
47
65
|
const problems = [];
|
|
48
|
-
const { registry, skippedEntries } = normalizeRegistry(parsed, problems);
|
|
66
|
+
const { registry, skippedEntries } = normalizeRegistry(parsed.value, problems, STORES_FILENAME);
|
|
49
67
|
if (!registry) {
|
|
50
68
|
return { registry: null, problems, lossy: true };
|
|
51
69
|
}
|
|
@@ -57,6 +75,59 @@ export function readStoreRegistryDetailed(phrenPath) {
|
|
|
57
75
|
}
|
|
58
76
|
return { registry, problems, lossy: skippedEntries > 0 };
|
|
59
77
|
}
|
|
78
|
+
function readAttachedStores(phrenPath, synced) {
|
|
79
|
+
const parsed = readYamlFile(attachedStoresFilePath(phrenPath), ATTACHED_STORES_FILENAME);
|
|
80
|
+
if (!parsed.exists)
|
|
81
|
+
return { stores: migrateSyncedAttachments(phrenPath, synced), problems: [], lossy: false };
|
|
82
|
+
if (parsed.problems.length > 0)
|
|
83
|
+
return { stores: [], problems: parsed.problems, lossy: true };
|
|
84
|
+
const problems = [];
|
|
85
|
+
const { registry, skippedEntries } = normalizeRegistry(parsed.value, problems, ATTACHED_STORES_FILENAME, true);
|
|
86
|
+
if (!registry)
|
|
87
|
+
return { stores: [], problems, lossy: true };
|
|
88
|
+
const stores = registry.stores.filter((s) => s.role !== "primary");
|
|
89
|
+
if (stores.length < registry.stores.length) {
|
|
90
|
+
problems.push(`${ATTACHED_STORES_FILENAME}: the primary store belongs in ${STORES_FILENAME} — entry skipped.`);
|
|
91
|
+
}
|
|
92
|
+
return { stores, problems, lossy: skippedEntries > 0 || stores.length < registry.stores.length };
|
|
93
|
+
}
|
|
94
|
+
/**
|
|
95
|
+
* One-time move from the old layout, where team stores were listed in the
|
|
96
|
+
* synced stores.yaml. Only stores whose folder exists here were ever attached
|
|
97
|
+
* on this machine; the rest came from another machine and are dropped. The
|
|
98
|
+
* synced file is left as it is: machines still on an older phren read it.
|
|
99
|
+
*/
|
|
100
|
+
function migrateSyncedAttachments(phrenPath, synced) {
|
|
101
|
+
const listed = synced?.stores.filter((s) => s.role !== "primary") ?? [];
|
|
102
|
+
if (listed.length === 0)
|
|
103
|
+
return [];
|
|
104
|
+
const attached = listed.filter((s) => storePathExists(s.path));
|
|
105
|
+
try {
|
|
106
|
+
writeAttachedStores(phrenPath, attached);
|
|
107
|
+
}
|
|
108
|
+
catch (err) {
|
|
109
|
+
// Still honor them for this read; the next read retries the move.
|
|
110
|
+
console.warn(`phren: could not write ${attachedStoresFilePath(phrenPath)}: ${String(err)}`);
|
|
111
|
+
}
|
|
112
|
+
return attached;
|
|
113
|
+
}
|
|
114
|
+
function readYamlFile(filePath, label) {
|
|
115
|
+
if (!fs.existsSync(filePath))
|
|
116
|
+
return { exists: false, problems: [] };
|
|
117
|
+
let raw;
|
|
118
|
+
try {
|
|
119
|
+
raw = fs.readFileSync(filePath, "utf8");
|
|
120
|
+
}
|
|
121
|
+
catch (err) {
|
|
122
|
+
return { exists: true, problems: [`${label} is unreadable: ${String(err)}`] };
|
|
123
|
+
}
|
|
124
|
+
try {
|
|
125
|
+
return { exists: true, value: loadYamlDocument(raw, (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA })), problems: [] };
|
|
126
|
+
}
|
|
127
|
+
catch (err) {
|
|
128
|
+
return { exists: true, problems: [`${label} is not valid YAML: ${String(err)}`] };
|
|
129
|
+
}
|
|
130
|
+
}
|
|
60
131
|
/** Registry read problems already warned about, keyed by path + content. */
|
|
61
132
|
const warnedRegistryProblems = new Set();
|
|
62
133
|
export function readStoreRegistry(phrenPath) {
|
|
@@ -78,22 +149,45 @@ export function readStoreRegistry(phrenPath) {
|
|
|
78
149
|
}
|
|
79
150
|
return result.registry;
|
|
80
151
|
}
|
|
152
|
+
/**
|
|
153
|
+
* Writes this machine's view of the stores: the primary entry to the synced
|
|
154
|
+
* stores.yaml (only when it changed) and every other store to the machine's
|
|
155
|
+
* own attached-stores.yaml.
|
|
156
|
+
*/
|
|
81
157
|
export function writeStoreRegistry(phrenPath, registry) {
|
|
82
158
|
const err = validateRegistry(registry);
|
|
83
159
|
if (err)
|
|
84
160
|
throw new Error(`${PhrenError.VALIDATION_ERROR}: ${err}`);
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
161
|
+
writeSyncedPrimary(phrenPath, registry.stores.find((s) => s.role === "primary"));
|
|
162
|
+
writeAttachedStores(phrenPath, registry.stores.filter((s) => s.role !== "primary"));
|
|
163
|
+
}
|
|
164
|
+
function writeSyncedPrimary(phrenPath, primary) {
|
|
165
|
+
const current = readSyncedRegistry(phrenPath);
|
|
166
|
+
const existing = current.registry?.stores.find((s) => s.role === "primary");
|
|
167
|
+
if (existing && sameEntry(existing, primary))
|
|
168
|
+
return;
|
|
169
|
+
// Keep what older phren versions on other machines still list here.
|
|
170
|
+
const others = current.lossy ? [] : current.registry?.stores.filter((s) => s.role !== "primary") ?? [];
|
|
171
|
+
const portable = { version: 1, stores: [primary, ...others].map(portableEntry) };
|
|
95
172
|
atomicWriteText(storesFilePath(phrenPath), yaml.dump(portable, { lineWidth: 200 }));
|
|
96
173
|
}
|
|
174
|
+
function writeAttachedStores(phrenPath, stores) {
|
|
175
|
+
fs.mkdirSync(runtimeDir(phrenPath), { recursive: true });
|
|
176
|
+
const portable = { version: 1, stores: stores.map(portableEntry) };
|
|
177
|
+
atomicWriteText(attachedStoresFilePath(phrenPath), yaml.dump(portable, { lineWidth: 200 }));
|
|
178
|
+
}
|
|
179
|
+
/**
|
|
180
|
+
* Collapse paths to a ~ prefix for portability. `available` is computed at
|
|
181
|
+
* resolve time and is never written.
|
|
182
|
+
*/
|
|
183
|
+
function portableEntry({ available: _available, ...s }) {
|
|
184
|
+
return { ...s, path: collapsePath(s.path) };
|
|
185
|
+
}
|
|
186
|
+
function sameEntry(a, b) {
|
|
187
|
+
return a.id === b.id && a.name === b.name && a.path === b.path && a.role === b.role
|
|
188
|
+
&& a.sync === b.sync && a.remote === b.remote
|
|
189
|
+
&& (a.projects ?? []).join("\n") === (b.projects ?? []).join("\n");
|
|
190
|
+
}
|
|
97
191
|
// ── Resolution ───────────────────────────────────────────────────────────────
|
|
98
192
|
/** True when a store's directory exists on this machine. */
|
|
99
193
|
export function storePathExists(storePath) {
|
|
@@ -105,16 +199,17 @@ export function storePathExists(storePath) {
|
|
|
105
199
|
}
|
|
106
200
|
}
|
|
107
201
|
/**
|
|
108
|
-
* Resolve the full list of stores. This is the **key
|
|
109
|
-
* -
|
|
110
|
-
* -
|
|
111
|
-
*
|
|
202
|
+
* Resolve the full list of stores on this machine. This is the **key
|
|
203
|
+
* backward-compat function**:
|
|
204
|
+
* - The primary comes from the synced stores.yaml, or is implicit when the
|
|
205
|
+
* file is missing
|
|
206
|
+
* - Then every store attached on this machine (.runtime/attached-stores.yaml)
|
|
207
|
+
* - Then PHREN_FEDERATION_PATHS entries as readonly stores
|
|
112
208
|
*
|
|
113
209
|
* Every returned entry carries `available`, recording whether its path exists
|
|
114
|
-
* here.
|
|
115
|
-
* must be able to see that a store claims a project before
|
|
116
|
-
*
|
|
117
|
-
* claims this project" and its writes would land in the primary store.
|
|
210
|
+
* here. Attached stores whose folder is gone are deliberately **still
|
|
211
|
+
* returned**: callers must be able to see that a store claims a project before
|
|
212
|
+
* deciding what to do, otherwise its writes would land in the primary store.
|
|
118
213
|
*/
|
|
119
214
|
export function resolveAllStores(phrenPath) {
|
|
120
215
|
const registry = readStoreRegistry(phrenPath);
|
|
@@ -135,21 +230,30 @@ export function resolveAllStores(phrenPath) {
|
|
|
135
230
|
}
|
|
136
231
|
return stores.map((s) => ({ ...s, available: storePathExists(s.path) }));
|
|
137
232
|
}
|
|
138
|
-
/**
|
|
233
|
+
/**
|
|
234
|
+
* Non-primary entries in the synced stores.yaml that this machine does not use:
|
|
235
|
+
* joined on another machine with an older phren. Attached ones were moved into
|
|
236
|
+
* attached-stores.yaml; the rest mean nothing here.
|
|
237
|
+
*/
|
|
238
|
+
export function ignoredSyncedStores(phrenPath) {
|
|
239
|
+
readStoreRegistry(phrenPath); // runs the one-time move first
|
|
240
|
+
const synced = readSyncedRegistry(phrenPath).registry?.stores.filter((s) => s.role !== "primary") ?? [];
|
|
241
|
+
const attached = new Set(resolveAllStores(phrenPath).map((s) => s.id));
|
|
242
|
+
return synced.filter((s) => !attached.has(s.id));
|
|
243
|
+
}
|
|
244
|
+
/** Stores attached on this machine whose directory is missing. */
|
|
139
245
|
export function getUnavailableStores(phrenPath) {
|
|
140
246
|
return resolveAllStores(phrenPath).filter((s) => s.available === false);
|
|
141
247
|
}
|
|
142
248
|
/**
|
|
143
|
-
* One actionable sentence about a store
|
|
144
|
-
* Shared by write routing, `phren status`, and `phren doctor` so all
|
|
145
|
-
* the same store, the same expected path, and the same remedy.
|
|
249
|
+
* One actionable sentence about a store attached on this machine whose folder
|
|
250
|
+
* is gone. Shared by write routing, `phren status`, and `phren doctor` so all
|
|
251
|
+
* three name the same store, the same expected path, and the same remedy.
|
|
146
252
|
*/
|
|
147
253
|
export function describeUnavailableStore(store) {
|
|
148
|
-
const
|
|
149
|
-
|
|
150
|
-
:
|
|
151
|
-
return (`Store "${store.name}" (role=${store.role}) is declared in ${STORES_FILENAME} but is not attached on this machine — ` +
|
|
152
|
-
`expected path: ${store.path}. Attach it with: ${attach}`);
|
|
254
|
+
const restore = store.remote ? `git clone ${store.remote} "${store.path}"` : `restore the folder`;
|
|
255
|
+
return (`Store "${store.name}" (role=${store.role}) is attached on this machine but its folder is missing — ` +
|
|
256
|
+
`expected path: ${store.path}. Either ${restore}, or detach it with: phren store remove ${store.name}`);
|
|
153
257
|
}
|
|
154
258
|
/** The primary store (role=primary). Falls back to implicit entry. */
|
|
155
259
|
export function getPrimaryStore(phrenPath) {
|
|
@@ -210,15 +314,20 @@ export function readTeamBootstrap(storePath) {
|
|
|
210
314
|
function readRegistryForMutation(phrenPath) {
|
|
211
315
|
const result = readStoreRegistryDetailed(phrenPath);
|
|
212
316
|
if (result.lossy) {
|
|
213
|
-
throw new Error(`${PhrenError.VALIDATION_ERROR}: ${storesFilePath(phrenPath)} exists but could not be fully read — ` +
|
|
317
|
+
throw new Error(`${PhrenError.VALIDATION_ERROR}: the store registry (${storesFilePath(phrenPath)} or ${attachedStoresFilePath(phrenPath)}) exists but could not be fully read — ` +
|
|
214
318
|
`refusing to rewrite it (that would drop the entries phren cannot parse). ` +
|
|
215
319
|
`Fix the file by hand first. Problems: ${result.problems.join(" | ")}`);
|
|
216
320
|
}
|
|
217
321
|
return result.registry;
|
|
218
322
|
}
|
|
219
|
-
/**
|
|
323
|
+
/** Mutations change this machine's attachments, so they lock that file. */
|
|
324
|
+
function registryLockPath(phrenPath) {
|
|
325
|
+
fs.mkdirSync(runtimeDir(phrenPath), { recursive: true });
|
|
326
|
+
return attachedStoresFilePath(phrenPath);
|
|
327
|
+
}
|
|
328
|
+
/** Attach a store on this machine. Creates stores.yaml for the primary if needed. Uses file locking. */
|
|
220
329
|
export function addStoreToRegistry(phrenPath, entry) {
|
|
221
|
-
withFileLock(
|
|
330
|
+
withFileLock(registryLockPath(phrenPath), () => {
|
|
222
331
|
let registry = readRegistryForMutation(phrenPath);
|
|
223
332
|
if (!registry) {
|
|
224
333
|
// First time — also add the implicit primary store
|
|
@@ -233,7 +342,7 @@ export function addStoreToRegistry(phrenPath, entry) {
|
|
|
233
342
|
}
|
|
234
343
|
/** Remove a store entry by name. Refuses to remove primary. Uses file locking. */
|
|
235
344
|
export function removeStoreFromRegistry(phrenPath, name) {
|
|
236
|
-
return withFileLock(
|
|
345
|
+
return withFileLock(registryLockPath(phrenPath), () => {
|
|
237
346
|
const registry = readRegistryForMutation(phrenPath);
|
|
238
347
|
if (!registry)
|
|
239
348
|
throw new Error(`${PhrenError.FILE_NOT_FOUND}: No stores.yaml found`);
|
|
@@ -250,7 +359,7 @@ export function removeStoreFromRegistry(phrenPath, name) {
|
|
|
250
359
|
}
|
|
251
360
|
/** Update the projects[] claim list for a store. Uses file locking. */
|
|
252
361
|
export function updateStoreProjects(phrenPath, storeName, projects) {
|
|
253
|
-
withFileLock(
|
|
362
|
+
withFileLock(registryLockPath(phrenPath), () => {
|
|
254
363
|
const registry = readRegistryForMutation(phrenPath);
|
|
255
364
|
if (!registry)
|
|
256
365
|
throw new Error(`${PhrenError.FILE_NOT_FOUND}: No stores.yaml found`);
|
|
@@ -263,7 +372,7 @@ export function updateStoreProjects(phrenPath, storeName, projects) {
|
|
|
263
372
|
}
|
|
264
373
|
/** Add projects to a store's subscription list. Deduplicates. Uses file locking. */
|
|
265
374
|
export function subscribeStoreProjects(phrenPath, storeName, projects) {
|
|
266
|
-
withFileLock(
|
|
375
|
+
withFileLock(registryLockPath(phrenPath), () => {
|
|
267
376
|
const registry = readRegistryForMutation(phrenPath);
|
|
268
377
|
if (!registry)
|
|
269
378
|
throw new Error(`${PhrenError.FILE_NOT_FOUND}: No stores.yaml found`);
|
|
@@ -280,7 +389,7 @@ export function subscribeStoreProjects(phrenPath, storeName, projects) {
|
|
|
280
389
|
}
|
|
281
390
|
/** Remove projects from a store's subscription list. Uses file locking. */
|
|
282
391
|
export function unsubscribeStoreProjects(phrenPath, storeName, projects) {
|
|
283
|
-
withFileLock(
|
|
392
|
+
withFileLock(registryLockPath(phrenPath), () => {
|
|
284
393
|
const registry = readRegistryForMutation(phrenPath);
|
|
285
394
|
if (!registry)
|
|
286
395
|
throw new Error(`${PhrenError.FILE_NOT_FOUND}: No stores.yaml found`);
|
|
@@ -334,17 +443,17 @@ const ROLE_ALIASES = { secondary: "team" };
|
|
|
334
443
|
* `problems`, and the valid remainder is kept. Callers see `skippedEntries`
|
|
335
444
|
* so mutators can refuse to persist a lossy read.
|
|
336
445
|
*/
|
|
337
|
-
function normalizeRegistry(parsed, problems) {
|
|
446
|
+
function normalizeRegistry(parsed, problems, label, allowEmpty = false) {
|
|
338
447
|
if (!isRecord(parsed) || parsed.version !== 1 || !Array.isArray(parsed.stores)) {
|
|
339
|
-
problems.push(`${
|
|
448
|
+
problems.push(`${label} has an unrecognized shape (expected \`version: 1\` and a \`stores:\` list).`);
|
|
340
449
|
return { registry: null, skippedEntries: 0 };
|
|
341
450
|
}
|
|
342
451
|
const stores = [];
|
|
343
452
|
let skippedEntries = 0;
|
|
344
453
|
for (const [index, raw] of parsed.stores.entries()) {
|
|
345
|
-
const skip = (
|
|
454
|
+
const skip = (entry, reason) => {
|
|
346
455
|
skippedEntries += 1;
|
|
347
|
-
problems.push(`${
|
|
456
|
+
problems.push(`${label}: store ${entry} ${reason} — entry skipped.`);
|
|
348
457
|
};
|
|
349
458
|
if (!isRecord(raw)) {
|
|
350
459
|
skip(`#${index + 1}`, "is not a mapping");
|
|
@@ -352,12 +461,12 @@ function normalizeRegistry(parsed, problems) {
|
|
|
352
461
|
}
|
|
353
462
|
const id = typeof raw.id === "string" ? raw.id : "";
|
|
354
463
|
const name = typeof raw.name === "string" ? raw.name : "";
|
|
355
|
-
const
|
|
464
|
+
const entryLabel = name ? `"${name}"` : `#${index + 1}`;
|
|
356
465
|
const rawPath = typeof raw.path === "string" ? raw.path : "";
|
|
357
466
|
const rawRole = typeof raw.role === "string" ? raw.role : "";
|
|
358
467
|
const aliasedRole = ROLE_ALIASES[rawRole];
|
|
359
468
|
if (aliasedRole) {
|
|
360
|
-
problems.push(`${
|
|
469
|
+
problems.push(`${label}: store ${entryLabel} has role "${rawRole}" — reading it as "${aliasedRole}" (valid roles: primary|team|readonly).`);
|
|
361
470
|
}
|
|
362
471
|
const roleValue = aliasedRole ?? rawRole;
|
|
363
472
|
const role = isStoreRole(roleValue) ? roleValue : null;
|
|
@@ -373,7 +482,7 @@ function normalizeRegistry(parsed, problems) {
|
|
|
373
482
|
!rawPath && "path",
|
|
374
483
|
!role && `a valid role (got "${rawRole || "(none)"}")`,
|
|
375
484
|
].filter(Boolean);
|
|
376
|
-
skip(
|
|
485
|
+
skip(entryLabel, `is missing ${missing.join(", ")}`);
|
|
377
486
|
continue;
|
|
378
487
|
}
|
|
379
488
|
stores.push({
|
|
@@ -386,8 +495,8 @@ function normalizeRegistry(parsed, problems) {
|
|
|
386
495
|
projects: projects && projects.length > 0 ? projects : undefined,
|
|
387
496
|
});
|
|
388
497
|
}
|
|
389
|
-
if (stores.length === 0) {
|
|
390
|
-
problems.push(`${
|
|
498
|
+
if (stores.length === 0 && !allowEmpty) {
|
|
499
|
+
problems.push(`${label} contains no usable store entries.`);
|
|
391
500
|
return { registry: null, skippedEntries };
|
|
392
501
|
}
|
|
393
502
|
return { registry: { version: 1, stores }, skippedEntries };
|
package/dist/store-weight.d.ts
CHANGED
|
@@ -1,8 +1,3 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* How much text a store carries, by kind. None of the tidying phren does stays
|
|
3
|
-
* done unless the weight is visible, so `phren status` prints this and doctor
|
|
4
|
-
* warns when the parts an agent pays for every session have grown.
|
|
5
|
-
*/
|
|
6
1
|
import { homePath } from "./phren-paths.js";
|
|
7
2
|
export interface StoreWeight {
|
|
8
3
|
projects: number;
|
|
@@ -12,7 +7,7 @@ export interface StoreWeight {
|
|
|
12
7
|
reference: number;
|
|
13
8
|
tasks: number;
|
|
14
9
|
skills: number;
|
|
15
|
-
/** Words in the global
|
|
10
|
+
/** Words in the global AGENTS.md every session loads. */
|
|
16
11
|
globalClaude: number;
|
|
17
12
|
}
|
|
18
13
|
export declare function storeWeight(phrenPath: string, profile?: string): StoreWeight;
|