@phren/cli 0.1.38 → 0.1.40
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/dist/cli/session-background.js +4 -0
- package/dist/cli/session-stop.js +16 -0
- package/dist/cli-handlers.d.ts +2 -0
- package/dist/cli-handlers.js +40 -0
- package/dist/cli-registry.js +15 -1
- package/dist/generated/memory-ui-graph.browser.js +363 -293
- package/dist/hooks.d.ts +6 -0
- package/dist/hooks.js +6 -3
- package/dist/init/init-configure.d.ts +7 -2
- package/dist/init/init-configure.js +36 -10
- package/dist/init/init-preset.d.ts +3 -0
- package/dist/init/init-preset.js +122 -0
- package/dist/init/init-uninstall.js +9 -0
- package/dist/init/init-walkthrough.d.ts +2 -0
- package/dist/init/init-walkthrough.js +42 -17
- package/dist/init/init.d.ts +5 -0
- package/dist/init/init.js +62 -14
- package/dist/init/management-preset.d.ts +42 -0
- package/dist/init/management-preset.js +122 -0
- package/dist/init/preferences.d.ts +17 -0
- package/dist/init/preferences.js +3 -0
- package/dist/init/self-wiring.d.ts +5 -0
- package/dist/init/self-wiring.js +52 -0
- package/dist/init/setup.d.ts +5 -1
- package/dist/init/setup.js +19 -7
- package/dist/init/teardown.d.ts +15 -0
- package/dist/init/teardown.js +241 -0
- package/dist/link/doctor.js +41 -14
- package/dist/link/link.js +49 -26
- package/dist/memory-ui-graph.runtime.js +363 -293
- package/dist/status.js +13 -1
- package/dist/ui/scripts.js +35 -14
- package/package.json +1 -1
package/dist/hooks.d.ts
CHANGED
|
@@ -115,5 +115,11 @@ export declare function runPrePromptHooks(phrenPath: string, stdinJson: string,
|
|
|
115
115
|
export interface HookConfigOptions {
|
|
116
116
|
tools?: Set<string>;
|
|
117
117
|
allTools?: boolean;
|
|
118
|
+
/**
|
|
119
|
+
* Whether to install ~/.local/bin session wrappers. Defaults to the current
|
|
120
|
+
* management preset's `installWrappers` capability. Assisted/manual presets
|
|
121
|
+
* skip wrappers (hooks fall back to node/npx invocation).
|
|
122
|
+
*/
|
|
123
|
+
installWrappers?: boolean;
|
|
118
124
|
}
|
|
119
125
|
export declare function configureAllHooks(phrenPath: string, options?: HookConfigOptions): string[];
|
package/dist/hooks.js
CHANGED
|
@@ -11,6 +11,7 @@ import { hookConfigPath } from "./provider-adapters.js";
|
|
|
11
11
|
import { PACKAGE_SPEC } from "./package-metadata.js";
|
|
12
12
|
import { logger } from "./logger.js";
|
|
13
13
|
import { withFileLock } from "./shared/governance.js";
|
|
14
|
+
import { resolveManagementCapabilities } from "./init/management-preset.js";
|
|
14
15
|
export function commandExists(cmd) {
|
|
15
16
|
try {
|
|
16
17
|
const whichCmd = process.platform === "win32" ? "where.exe" : "which";
|
|
@@ -898,6 +899,8 @@ export function configureAllHooks(phrenPath, options = {}) {
|
|
|
898
899
|
: options.allTools
|
|
899
900
|
? new Set(["copilot", "cursor", "codex"])
|
|
900
901
|
: detectInstalledTools();
|
|
902
|
+
const installWrappers = options.installWrappers
|
|
903
|
+
?? resolveManagementCapabilities(phrenPath).installWrappers;
|
|
901
904
|
const lifecycle = buildLifecycleCommands(phrenPath);
|
|
902
905
|
// ── GitHub Copilot CLI (user-level: ~/.github/hooks/phren.json) ──────────
|
|
903
906
|
if (detected.has("copilot")) {
|
|
@@ -927,7 +930,7 @@ export function configureAllHooks(phrenPath, options = {}) {
|
|
|
927
930
|
catch (err) {
|
|
928
931
|
console.warn(`configureAllHooks: copilot hook config failed: ${errorMessage(err)}`);
|
|
929
932
|
}
|
|
930
|
-
if (isToolHookEnabled(phrenPath, "copilot"))
|
|
933
|
+
if (installWrappers && isToolHookEnabled(phrenPath, "copilot"))
|
|
931
934
|
installSessionWrapper("copilot", phrenPath);
|
|
932
935
|
}
|
|
933
936
|
// ── Cursor (user-level: ~/.cursor/hooks.json) ────────────────────────────
|
|
@@ -959,7 +962,7 @@ export function configureAllHooks(phrenPath, options = {}) {
|
|
|
959
962
|
catch (err) {
|
|
960
963
|
console.warn(`configureAllHooks: cursor hook config failed: ${errorMessage(err)}`);
|
|
961
964
|
}
|
|
962
|
-
if (isToolHookEnabled(phrenPath, "cursor"))
|
|
965
|
+
if (installWrappers && isToolHookEnabled(phrenPath, "cursor"))
|
|
963
966
|
installSessionWrapper("cursor", phrenPath);
|
|
964
967
|
}
|
|
965
968
|
// ── Codex (codex.json in phren path) ─────────────────────────────────────
|
|
@@ -990,7 +993,7 @@ export function configureAllHooks(phrenPath, options = {}) {
|
|
|
990
993
|
catch (err) {
|
|
991
994
|
console.warn(`configureAllHooks: codex hook config failed: ${errorMessage(err)}`);
|
|
992
995
|
}
|
|
993
|
-
if (isToolHookEnabled(phrenPath, "codex"))
|
|
996
|
+
if (installWrappers && isToolHookEnabled(phrenPath, "codex"))
|
|
994
997
|
installSessionWrapper("codex", phrenPath);
|
|
995
998
|
}
|
|
996
999
|
return configured;
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { repairPreexistingInstall } from "./setup.js";
|
|
2
|
+
import { type ManagementCapabilities, type ManagementPreset } from "./management-preset.js";
|
|
2
3
|
import type { InitOptions } from "./init.js";
|
|
3
4
|
/**
|
|
4
5
|
* Configure MCP for all detected AI coding tools (Claude, VS Code, Cursor, Copilot, Codex).
|
|
@@ -7,14 +8,18 @@ import type { InitOptions } from "./init.js";
|
|
|
7
8
|
export declare function configureMcpTargets(phrenPath: string, opts: {
|
|
8
9
|
mcpEnabled: boolean;
|
|
9
10
|
hooksEnabled: boolean;
|
|
11
|
+
caps?: ManagementCapabilities;
|
|
10
12
|
}, verb?: "Configured" | "Updated"): string;
|
|
11
13
|
/**
|
|
12
14
|
* Configure hooks if enabled, or log a disabled message.
|
|
13
15
|
* @param verb - label used in log messages, e.g. "Updated" or "Configured"
|
|
14
16
|
*/
|
|
15
|
-
export declare function configureHooksIfEnabled(phrenPath: string, hooksEnabled: boolean, verb: string): void;
|
|
17
|
+
export declare function configureHooksIfEnabled(phrenPath: string, hooksEnabled: boolean, verb: string, caps?: ManagementCapabilities): void;
|
|
16
18
|
export declare function applyOnboardingPreferences(phrenPath: string, opts: InitOptions): void;
|
|
17
|
-
export declare function writeWalkthroughEnvDefaults(phrenPath: string, opts: InitOptions
|
|
19
|
+
export declare function writeWalkthroughEnvDefaults(phrenPath: string, opts: InitOptions, presetContext?: {
|
|
20
|
+
preset: ManagementPreset;
|
|
21
|
+
explicit: boolean;
|
|
22
|
+
}): string[];
|
|
18
23
|
export declare function collectRepairedAssetLabels(repaired: ReturnType<typeof repairPreexistingInstall>): string[];
|
|
19
24
|
export declare function applyProjectStorageBindings(repoRoot: string, phrenPath: string): string[];
|
|
20
25
|
export declare function warmSemanticSearch(phrenPath: string, profile?: string): Promise<string>;
|
|
@@ -15,23 +15,29 @@ import { VERSION } from "./shared.js";
|
|
|
15
15
|
import { writeInstallPreferences, writeGovernanceInstallPreferences, } from "./preferences.js";
|
|
16
16
|
import { repairPreexistingInstall, ensureGovernanceFiles, ensureGitignoreEntry, upsertProjectEnvVar, detectProjectDir, bootstrapFromExisting, runPostInitVerify, } from "./setup.js";
|
|
17
17
|
import { log } from "./shared.js";
|
|
18
|
+
import { resolveManagementCapabilities, getManagementPreset } from "./management-preset.js";
|
|
18
19
|
/**
|
|
19
20
|
* Configure MCP for all detected AI coding tools (Claude, VS Code, Cursor, Copilot, Codex).
|
|
20
21
|
* @param verb - label used in log messages, e.g. "Updated" or "Configured"
|
|
21
22
|
*/
|
|
22
23
|
export function configureMcpTargets(phrenPath, opts, verb = "Configured") {
|
|
24
|
+
const caps = opts.caps ?? resolveManagementCapabilities(phrenPath);
|
|
23
25
|
// Install the stable ~/.local/bin/phren wrapper BEFORE writing any hook
|
|
24
26
|
// commands. buildLifecycleCommands prefers that wrapper (it carries an npx
|
|
25
27
|
// fallback, so it survives nvm switches and npx cache clears); if it doesn't
|
|
26
28
|
// yet exist, hook commands fall through to the ephemeral npx-cache entry path
|
|
27
29
|
// and break the next time npx prunes its cache. configureHooksIfEnabled runs
|
|
28
30
|
// later and re-installs the wrapper idempotently, emitting the user-facing
|
|
29
|
-
// "CLI wrapper" line — this early install is intentionally silent.
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
31
|
+
// "CLI wrapper" line — this early install is intentionally silent. Presets
|
|
32
|
+
// that opt out of wrappers (assisted/manual) skip it; hooks then use the
|
|
33
|
+
// node/npx invocation form.
|
|
34
|
+
if (caps.installWrappers) {
|
|
35
|
+
try {
|
|
36
|
+
installPhrenCliWrapper(phrenPath);
|
|
37
|
+
}
|
|
38
|
+
catch (err) {
|
|
39
|
+
debugLog(`configureMcpTargets: early wrapper install failed: ${errorMessage(err)}`);
|
|
40
|
+
}
|
|
35
41
|
}
|
|
36
42
|
let claudeStatus = "no_settings";
|
|
37
43
|
try {
|
|
@@ -90,10 +96,11 @@ export function configureMcpTargets(phrenPath, opts, verb = "Configured") {
|
|
|
90
96
|
* Configure hooks if enabled, or log a disabled message.
|
|
91
97
|
* @param verb - label used in log messages, e.g. "Updated" or "Configured"
|
|
92
98
|
*/
|
|
93
|
-
export function configureHooksIfEnabled(phrenPath, hooksEnabled, verb) {
|
|
99
|
+
export function configureHooksIfEnabled(phrenPath, hooksEnabled, verb, caps) {
|
|
100
|
+
const resolvedCaps = caps ?? resolveManagementCapabilities(phrenPath);
|
|
94
101
|
if (hooksEnabled) {
|
|
95
102
|
try {
|
|
96
|
-
const hooked = configureAllHooks(phrenPath, { allTools: true });
|
|
103
|
+
const hooked = configureAllHooks(phrenPath, { allTools: true, installWrappers: resolvedCaps.installWrappers });
|
|
97
104
|
if (hooked.length)
|
|
98
105
|
log(` ${verb} hooks: ${hooked.join(", ")}`);
|
|
99
106
|
}
|
|
@@ -104,6 +111,12 @@ export function configureHooksIfEnabled(phrenPath, hooksEnabled, verb) {
|
|
|
104
111
|
else {
|
|
105
112
|
log(` Hooks are disabled by preference (run: phren hooks-mode on)`);
|
|
106
113
|
}
|
|
114
|
+
// Presets that opt out of wrappers (assisted/manual) leave the user's PATH and
|
|
115
|
+
// ~/.local/bin untouched; hooks fall back to the node/npx invocation form.
|
|
116
|
+
if (!resolvedCaps.installWrappers) {
|
|
117
|
+
log(` CLI wrapper: skipped (${getManagementPreset(phrenPath)} preset) — use 'npx @phren/cli <command>' or a global install`);
|
|
118
|
+
return;
|
|
119
|
+
}
|
|
107
120
|
// Install phren CLI wrapper at ~/.local/bin/phren so the bare command works
|
|
108
121
|
const wrapperInstalled = installPhrenCliWrapper(phrenPath);
|
|
109
122
|
if (wrapperInstalled) {
|
|
@@ -158,13 +171,26 @@ export function applyOnboardingPreferences(phrenPath, opts) {
|
|
|
158
171
|
updateWorkflowPolicy(phrenPath, workflowPatch);
|
|
159
172
|
}
|
|
160
173
|
}
|
|
161
|
-
export function writeWalkthroughEnvDefaults(phrenPath, opts) {
|
|
174
|
+
export function writeWalkthroughEnvDefaults(phrenPath, opts, presetContext) {
|
|
162
175
|
const envFile = path.join(phrenPath, ".env");
|
|
163
176
|
let envContent = fs.existsSync(envFile) ? fs.readFileSync(envFile, "utf8") : "# phren feature flags — generated by init\n";
|
|
164
177
|
const envFlags = [];
|
|
178
|
+
const manualPreset = presetContext?.preset === "manual";
|
|
179
|
+
const presetExplicit = presetContext?.explicit === true;
|
|
165
180
|
const autoCaptureChoice = opts._walkthroughAutoCapture;
|
|
166
181
|
const hasAutoCaptureFlag = /^\s*PHREN_FEATURE_AUTO_CAPTURE=.*$/m.test(envContent);
|
|
167
|
-
if (
|
|
182
|
+
if (manualPreset) {
|
|
183
|
+
// Manual preset turns off the prompt-time/background automations. Force the
|
|
184
|
+
// flags to 0 only when the preset was explicitly chosen this run; on a plain
|
|
185
|
+
// re-init we respect any lines the user already set.
|
|
186
|
+
for (const key of ["PHREN_FEATURE_AUTO_CAPTURE", "PHREN_FEATURE_AUTO_EXTRACT", "PHREN_FEATURE_DAILY_MAINTENANCE"]) {
|
|
187
|
+
const present = new RegExp(`^\\s*${key}=.*$`, "m").test(envContent);
|
|
188
|
+
if (presetExplicit || !present) {
|
|
189
|
+
envFlags.push({ flag: `${key}=0`, label: `${key.replace("PHREN_FEATURE_", "").toLowerCase().replace(/_/g, " ")} disabled (manual preset)` });
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
}
|
|
193
|
+
else if (typeof autoCaptureChoice === "boolean") {
|
|
168
194
|
envFlags.push({
|
|
169
195
|
flag: `PHREN_FEATURE_AUTO_CAPTURE=${autoCaptureChoice ? "1" : "0"}`,
|
|
170
196
|
label: `Auto-capture ${autoCaptureChoice ? "enabled" : "disabled"}`,
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `phren preset [status|managed|assisted|manual]` — switch the management preset.
|
|
3
|
+
*
|
|
4
|
+
* Switching re-wires MCP/hooks for the new preset and, on a downgrade, tears down
|
|
5
|
+
* the phren-owned symlinks/wrappers/repo-mirrors the previous preset installed;
|
|
6
|
+
* on an upgrade it re-creates them. MCP registration stays on across all presets.
|
|
7
|
+
*/
|
|
8
|
+
import { debugLog, findPhrenPath, readRootManifest } from "../shared.js";
|
|
9
|
+
import { errorMessage } from "../utils.js";
|
|
10
|
+
import { configureClaude } from "./config.js";
|
|
11
|
+
import { configureMcpTargets, configureHooksIfEnabled } from "./init-configure.js";
|
|
12
|
+
import { repairPreexistingInstall } from "./setup.js";
|
|
13
|
+
import { getMcpEnabledPreference, getHooksEnabledPreference, setHooksEnabledPreference, setManagementPresetPreference, } from "./preferences.js";
|
|
14
|
+
import { MANAGEMENT_PRESETS, getManagementPreset, parseManagementPreset, presetSummaryLines, resolveManagementCapabilities, } from "./management-preset.js";
|
|
15
|
+
import { removePhrenHomeSymlinks, removePhrenWrappers, sweepAgentSkillSymlinks, sweepProjectMirrors } from "./teardown.js";
|
|
16
|
+
import { printSelfWiringSnippet } from "./self-wiring.js";
|
|
17
|
+
import { DEFAULT_PHREN_PATH, log, confirmPrompt } from "./shared.js";
|
|
18
|
+
function printCapabilityTable(caps) {
|
|
19
|
+
const row = (label, on) => log(` ${on ? "on " : "off"} ${label}`);
|
|
20
|
+
row("MCP server registration", true);
|
|
21
|
+
row("Lifecycle hooks", caps.hooksDefault);
|
|
22
|
+
row("~/.claude/CLAUDE.md symlink", caps.linkGlobalClaudeMd);
|
|
23
|
+
row("~/.claude/skills symlinks", caps.installSkillLinks);
|
|
24
|
+
row("~/.local/bin wrappers", caps.installWrappers);
|
|
25
|
+
row("SessionStart self-heal", caps.selfHeal);
|
|
26
|
+
row("Repo mirroring", caps.repoMirroring);
|
|
27
|
+
row("Lifecycle automations (maintenance, auto-commit)", caps.lifecycleAutomations);
|
|
28
|
+
}
|
|
29
|
+
export async function runPreset(arg, opts = {}) {
|
|
30
|
+
const phrenPath = findPhrenPath() || process.env.PHREN_PATH || DEFAULT_PHREN_PATH;
|
|
31
|
+
const manifest = readRootManifest(phrenPath);
|
|
32
|
+
const normalized = arg?.trim().toLowerCase();
|
|
33
|
+
if (!normalized || normalized === "status") {
|
|
34
|
+
const current = getManagementPreset(phrenPath);
|
|
35
|
+
log(`Management preset: ${current} — ${presetSummaryLines(current)}`);
|
|
36
|
+
printCapabilityTable(resolveManagementCapabilities(phrenPath));
|
|
37
|
+
log(`Change: phren preset <${MANAGEMENT_PRESETS.join("|")}>`);
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
const preset = parseManagementPreset(normalized);
|
|
41
|
+
if (!preset) {
|
|
42
|
+
throw new Error(`Invalid preset "${arg}". Use one of: ${MANAGEMENT_PRESETS.join(", ")}`);
|
|
43
|
+
}
|
|
44
|
+
if (manifest?.installMode === "project-local") {
|
|
45
|
+
throw new Error("preset switching is unsupported in project-local mode");
|
|
46
|
+
}
|
|
47
|
+
const previous = getManagementPreset(phrenPath);
|
|
48
|
+
const prevCaps = resolveManagementCapabilities(phrenPath);
|
|
49
|
+
if (preset === previous) {
|
|
50
|
+
log(`Already on the ${preset} preset.`);
|
|
51
|
+
printCapabilityTable(prevCaps);
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
// Persist first so caps resolution (incl. the self-heal path) sees the new preset.
|
|
55
|
+
setManagementPresetPreference(phrenPath, preset);
|
|
56
|
+
const caps = resolveManagementCapabilities(phrenPath);
|
|
57
|
+
const teardownNeeded = (prevCaps.linkGlobalClaudeMd && !caps.linkGlobalClaudeMd) ||
|
|
58
|
+
(prevCaps.installSkillLinks && !caps.installSkillLinks) ||
|
|
59
|
+
(prevCaps.installWrappers && !caps.installWrappers) ||
|
|
60
|
+
(prevCaps.repoMirroring && !caps.repoMirroring);
|
|
61
|
+
if (teardownNeeded && !opts.yes) {
|
|
62
|
+
const ok = await confirmPrompt(`Switching ${previous} → ${preset} will remove phren-owned symlinks/wrappers from your machine and repos. Continue?`);
|
|
63
|
+
if (!ok) {
|
|
64
|
+
// Revert the preference — the user declined the teardown.
|
|
65
|
+
setManagementPresetPreference(phrenPath, previous);
|
|
66
|
+
log("Aborted. Preset unchanged.");
|
|
67
|
+
return;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
log(`Switching management preset: ${previous} → ${preset}\n`);
|
|
71
|
+
// Hooks follow the preset default (manual disables them).
|
|
72
|
+
const mcpEnabled = getMcpEnabledPreference(phrenPath);
|
|
73
|
+
const hooksEnabled = caps.hooksDefault && (previous === "manual" ? true : getHooksEnabledPreference(phrenPath));
|
|
74
|
+
setHooksEnabledPreference(phrenPath, hooksEnabled);
|
|
75
|
+
try {
|
|
76
|
+
configureClaude(phrenPath, { mcpEnabled, hooksEnabled });
|
|
77
|
+
}
|
|
78
|
+
catch (err) {
|
|
79
|
+
debugLog(`preset: configureClaude failed: ${errorMessage(err)}`);
|
|
80
|
+
}
|
|
81
|
+
try {
|
|
82
|
+
configureMcpTargets(phrenPath, { mcpEnabled, hooksEnabled, caps }, "Updated");
|
|
83
|
+
}
|
|
84
|
+
catch (err) {
|
|
85
|
+
debugLog(`preset: configureMcpTargets failed: ${errorMessage(err)}`);
|
|
86
|
+
}
|
|
87
|
+
configureHooksIfEnabled(phrenPath, hooksEnabled, "Updated", caps);
|
|
88
|
+
// Teardown of artifacts the previous preset installed but the new one doesn't.
|
|
89
|
+
if (prevCaps.linkGlobalClaudeMd && !caps.linkGlobalClaudeMd)
|
|
90
|
+
removePhrenHomeSymlinks();
|
|
91
|
+
if (prevCaps.installSkillLinks && !caps.installSkillLinks)
|
|
92
|
+
sweepAgentSkillSymlinks(phrenPath);
|
|
93
|
+
if (prevCaps.installWrappers && !caps.installWrappers)
|
|
94
|
+
removePhrenWrappers();
|
|
95
|
+
if (prevCaps.repoMirroring && !caps.repoMirroring)
|
|
96
|
+
sweepProjectMirrors(phrenPath);
|
|
97
|
+
// Setup of artifacts the new preset adds but the previous one lacked.
|
|
98
|
+
const setupNeeded = (!prevCaps.linkGlobalClaudeMd && caps.linkGlobalClaudeMd) ||
|
|
99
|
+
(!prevCaps.installSkillLinks && caps.installSkillLinks) ||
|
|
100
|
+
(!prevCaps.repoMirroring && caps.repoMirroring);
|
|
101
|
+
if (setupNeeded) {
|
|
102
|
+
try {
|
|
103
|
+
repairPreexistingInstall(phrenPath, { caps, preset });
|
|
104
|
+
}
|
|
105
|
+
catch (err) {
|
|
106
|
+
debugLog(`preset: repair failed: ${errorMessage(err)}`);
|
|
107
|
+
}
|
|
108
|
+
try {
|
|
109
|
+
const { runLink } = await import("../link/link.js");
|
|
110
|
+
await runLink(phrenPath, {});
|
|
111
|
+
}
|
|
112
|
+
catch (err) {
|
|
113
|
+
debugLog(`preset: runLink failed: ${errorMessage(err)}`);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
log(`\nManagement preset set to ${preset}.`);
|
|
117
|
+
printCapabilityTable(caps);
|
|
118
|
+
if (preset !== "managed") {
|
|
119
|
+
printSelfWiringSnippet(phrenPath, preset);
|
|
120
|
+
}
|
|
121
|
+
log(`\nRestart your agent to apply changes.`);
|
|
122
|
+
}
|
|
@@ -10,6 +10,7 @@ import { FINDINGS_FILENAME } from "../data/access.js";
|
|
|
10
10
|
import { codexJsonCandidates, copilotMcpCandidates, cursorMcpCandidates, vscodeMcpCandidates, } from "../provider-adapters.js";
|
|
11
11
|
import { removeMcpServerAtPath, removeTomlMcpServer, isPhrenCommand, patchJsonFile, } from "./config.js";
|
|
12
12
|
import { DEFAULT_PHREN_PATH, log } from "./shared.js";
|
|
13
|
+
import { sweepProjectMirrors } from "./teardown.js";
|
|
13
14
|
const PHREN_NPM_PACKAGE_NAME = "@phren/cli";
|
|
14
15
|
function getNpmCommand() {
|
|
15
16
|
return process.platform === "win32" ? "npm.cmd" : "npm";
|
|
@@ -448,6 +449,14 @@ export async function runUninstall(opts = {}) {
|
|
|
448
449
|
catch (err) {
|
|
449
450
|
debugLog(`uninstall: skill symlink sweep failed: ${errorMessage(err)}`);
|
|
450
451
|
}
|
|
452
|
+
// Remove per-project repo mirror symlinks + phren-managed .git/info/exclude
|
|
453
|
+
// lines BEFORE deleting the store (this reads project config from the store).
|
|
454
|
+
try {
|
|
455
|
+
sweepProjectMirrors(phrenPath);
|
|
456
|
+
}
|
|
457
|
+
catch (err) {
|
|
458
|
+
debugLog(`uninstall: project mirror sweep failed: ${errorMessage(err)}`);
|
|
459
|
+
}
|
|
451
460
|
}
|
|
452
461
|
if (phrenPath && fs.existsSync(phrenPath)) {
|
|
453
462
|
try {
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import type { ProjectOwnershipMode } from "../project-config.js";
|
|
2
|
+
import { type ManagementPreset } from "./management-preset.js";
|
|
2
3
|
import type { ProactivityLevel } from "../proactivity.js";
|
|
3
4
|
import { type InitProjectDomain, type InferredInitScaffold } from "./setup.js";
|
|
4
5
|
import type { McpMode } from "./shared.js";
|
|
@@ -35,6 +36,7 @@ export interface WalkthroughResult {
|
|
|
35
36
|
mcp: McpMode;
|
|
36
37
|
hooks: McpMode;
|
|
37
38
|
projectOwnershipDefault: ProjectOwnershipMode;
|
|
39
|
+
managementPreset: ManagementPreset;
|
|
38
40
|
findingsProactivity: ProactivityLevel;
|
|
39
41
|
taskProactivity: ProactivityLevel;
|
|
40
42
|
lowConfidenceThreshold: number;
|
|
@@ -3,6 +3,7 @@
|
|
|
3
3
|
* Prompts the user through storage, identity, MCP, hooks, and feature configuration.
|
|
4
4
|
*/
|
|
5
5
|
import * as path from "path";
|
|
6
|
+
import { MANAGEMENT_PRESETS, presetSummaryLines } from "./management-preset.js";
|
|
6
7
|
import { PROJECT_OWNERSHIP_MODES } from "../project-config.js";
|
|
7
8
|
import { getMachineName } from "../machine-identity.js";
|
|
8
9
|
import { expandHomePath, homePath } from "../shared.js";
|
|
@@ -149,6 +150,7 @@ export async function runWalkthrough(phrenPath, options) {
|
|
|
149
150
|
mcp: "on",
|
|
150
151
|
hooks: "on",
|
|
151
152
|
projectOwnershipDefault: "phren-managed",
|
|
153
|
+
managementPreset: "managed",
|
|
152
154
|
findingsProactivity: "high",
|
|
153
155
|
taskProactivity: "high",
|
|
154
156
|
lowConfidenceThreshold: 0.7,
|
|
@@ -217,6 +219,7 @@ export async function runWalkthrough(phrenPath, options) {
|
|
|
217
219
|
mcp: "on",
|
|
218
220
|
hooks: "on",
|
|
219
221
|
projectOwnershipDefault: "phren-managed",
|
|
222
|
+
managementPreset: "managed",
|
|
220
223
|
findingsProactivity: "high",
|
|
221
224
|
taskProactivity: "high",
|
|
222
225
|
lowConfidenceThreshold: 0.7,
|
|
@@ -275,17 +278,30 @@ export async function runWalkthrough(phrenPath, options) {
|
|
|
275
278
|
else {
|
|
276
279
|
log(`Domain: ${inferredDomain} (inferred from project content)`);
|
|
277
280
|
}
|
|
281
|
+
printSection("Management Level");
|
|
282
|
+
log("How much of your machine should phren wire up?");
|
|
283
|
+
for (const p of MANAGEMENT_PRESETS)
|
|
284
|
+
log(` ${p}: ${presetSummaryLines(p)}`);
|
|
285
|
+
log(" Change later: phren preset <managed|assisted|manual>");
|
|
286
|
+
const managementPreset = await prompts.select("Management level", MANAGEMENT_PRESETS.map((p) => ({ value: p, name: p === "managed" ? "managed (recommended)" : p })), "managed");
|
|
278
287
|
printSection("Project Ownership");
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
288
|
+
let projectOwnershipDefault;
|
|
289
|
+
if (managementPreset !== "managed") {
|
|
290
|
+
projectOwnershipDefault = "detached";
|
|
291
|
+
log(`Using detached ownership — the ${managementPreset} preset never writes into your repos.`);
|
|
292
|
+
}
|
|
293
|
+
else {
|
|
294
|
+
log("Choose who owns repo-facing instruction files for projects you add.");
|
|
295
|
+
log(" phren-managed: Phren may mirror CLAUDE.md / AGENTS.md into the repo");
|
|
296
|
+
log(" detached: Phren keeps its own docs but does not write into the repo");
|
|
297
|
+
log(" repo-managed: keep the repo's existing CLAUDE/AGENTS files as canonical");
|
|
298
|
+
log(" Change later: phren config project-ownership <mode>");
|
|
299
|
+
projectOwnershipDefault = await prompts.select("Default project ownership", [
|
|
300
|
+
{ value: "detached", name: "detached (default)" },
|
|
301
|
+
{ value: "phren-managed", name: "phren-managed" },
|
|
302
|
+
{ value: "repo-managed", name: "repo-managed" },
|
|
303
|
+
], "detached");
|
|
304
|
+
}
|
|
289
305
|
printSection("MCP");
|
|
290
306
|
log("MCP mode registers phren as a tool server so your AI agent can call it");
|
|
291
307
|
log("directly: search memory, manage tasks, save findings, etc.");
|
|
@@ -294,13 +310,21 @@ export async function runWalkthrough(phrenPath, options) {
|
|
|
294
310
|
log(" Change later: phren mcp-mode on|off");
|
|
295
311
|
const mcp = (await prompts.confirm("Enable MCP?", true)) ? "on" : "off";
|
|
296
312
|
printSection("Hooks");
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
313
|
+
let hooks;
|
|
314
|
+
if (managementPreset === "manual") {
|
|
315
|
+
hooks = "off";
|
|
316
|
+
log("Skipped — the manual preset runs phren as an MCP server only (no hooks).");
|
|
317
|
+
log(" Enable later: phren preset assisted (or phren hooks-mode on)");
|
|
318
|
+
}
|
|
319
|
+
else {
|
|
320
|
+
log("Hooks run shell commands at session start, prompt submit, and session end.");
|
|
321
|
+
log(" - SessionStart: git pull (keeps memory in sync across machines)");
|
|
322
|
+
log(" - UserPromptSubmit: searches phren and injects relevant context");
|
|
323
|
+
log(" - Stop: commits and pushes any new findings after each response");
|
|
324
|
+
log(" What they touch: ~/.claude/settings.json (hooks section only)");
|
|
325
|
+
log(" Change later: phren hooks-mode on|off");
|
|
326
|
+
hooks = (await prompts.confirm("Enable hooks?", true)) ? "on" : "off";
|
|
327
|
+
}
|
|
304
328
|
printSection("Semantic Search (Optional)");
|
|
305
329
|
log("Phren can use a local embedding model for semantic (fuzzy) search via Ollama.");
|
|
306
330
|
log(" Best fit: paraphrase-heavy or weak-lexical queries.");
|
|
@@ -511,6 +535,7 @@ export async function runWalkthrough(phrenPath, options) {
|
|
|
511
535
|
mcp,
|
|
512
536
|
hooks,
|
|
513
537
|
projectOwnershipDefault,
|
|
538
|
+
managementPreset,
|
|
514
539
|
findingsProactivity,
|
|
515
540
|
taskProactivity,
|
|
516
541
|
lowConfidenceThreshold,
|
package/dist/init/init.d.ts
CHANGED
|
@@ -10,11 +10,14 @@ export { ensureGovernanceFiles, repairPreexistingInstall, runPostInitVerify, get
|
|
|
10
10
|
export { configureMcpTargets, warmSemanticSearch, runProjectLocalInit } from "./init-configure.js";
|
|
11
11
|
export { runMcpMode } from "./init-mcp-mode.js";
|
|
12
12
|
export { runHooksMode } from "./init-hooks-mode.js";
|
|
13
|
+
export { runPreset } from "./init-preset.js";
|
|
14
|
+
export { printSelfWiringSnippet } from "./self-wiring.js";
|
|
13
15
|
export { runUninstall } from "./init-uninstall.js";
|
|
14
16
|
import { type InitProjectDomain, type InferredInitScaffold } from "./setup.js";
|
|
15
17
|
import { type McpMode } from "./shared.js";
|
|
16
18
|
import { type ProjectOwnershipMode } from "../project-config.js";
|
|
17
19
|
import { type ProactivityLevel } from "../proactivity.js";
|
|
20
|
+
import { type ManagementPreset } from "./management-preset.js";
|
|
18
21
|
export { type McpMode, parseMcpMode } from "./shared.js";
|
|
19
22
|
type StorageLocationChoice = "global" | "project" | "custom";
|
|
20
23
|
type SkillsScope = "global" | "project";
|
|
@@ -32,6 +35,8 @@ export interface InitOptions {
|
|
|
32
35
|
mcp?: McpMode;
|
|
33
36
|
hooks?: McpMode;
|
|
34
37
|
projectOwnershipDefault?: ProjectOwnershipMode;
|
|
38
|
+
/** Management preset controlling phren's machine footprint (managed | assisted | manual). */
|
|
39
|
+
managementPreset?: ManagementPreset;
|
|
35
40
|
findingsProactivity?: ProactivityLevel;
|
|
36
41
|
taskProactivity?: ProactivityLevel;
|
|
37
42
|
lowConfidenceThreshold?: number;
|