@phren/cli 0.1.44 → 0.1.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/dist/agents/providers/herdr.d.ts +18 -0
  2. package/dist/agents/providers/herdr.js +94 -0
  3. package/dist/agents/providers/spawner.d.ts +13 -0
  4. package/dist/agents/providers/spawner.js +63 -0
  5. package/dist/agents/registry.d.ts +28 -0
  6. package/dist/agents/registry.js +82 -0
  7. package/dist/agents/types.d.ts +51 -0
  8. package/dist/agents/types.js +42 -0
  9. package/dist/cli/actions.d.ts +1 -1
  10. package/dist/cli/actions.js +7 -2
  11. package/dist/cli/config-proactivity.d.ts +6 -6
  12. package/dist/cli/hooks.d.ts +1 -1
  13. package/dist/cli/hooks.js +14 -3
  14. package/dist/cli/search.js +29 -0
  15. package/dist/cli/session-stop.d.ts +1 -1
  16. package/dist/cli/session-tool-hook.d.ts +1 -1
  17. package/dist/cli-registry.d.ts +1 -1
  18. package/dist/cli-registry.js +2 -1
  19. package/dist/content/learning.js +24 -1
  20. package/dist/data/access.js +2 -1
  21. package/dist/generated/memory-ui-graph.browser.js +482 -319
  22. package/dist/governance/locks.js +6 -0
  23. package/dist/graph-core/index.d.ts +2 -0
  24. package/dist/graph-core/index.js +2 -0
  25. package/dist/graph-core/model.d.ts +84 -0
  26. package/dist/graph-core/model.js +445 -0
  27. package/dist/graph-core/types.d.ts +110 -0
  28. package/dist/graph-core/types.js +43 -0
  29. package/dist/index.js +4 -1
  30. package/dist/init/init-uninstall.d.ts +1 -0
  31. package/dist/init/init-uninstall.js +1 -1
  32. package/dist/init/setup.js +11 -4
  33. package/dist/link/context.js +2 -1
  34. package/dist/link/link.js +3 -2
  35. package/dist/link/skills.js +2 -1
  36. package/dist/memory-ui-graph.runtime.js +482 -319
  37. package/dist/phren-art.d.ts +7 -0
  38. package/dist/phren-art.js +6 -41
  39. package/dist/phren-core.d.ts +16 -0
  40. package/dist/phren-core.js +21 -0
  41. package/dist/phren-paths.js +8 -4
  42. package/dist/profile-store.js +3 -2
  43. package/dist/project-config.js +2 -1
  44. package/dist/shared/index.js +1 -1
  45. package/dist/shared/lookup-tail.d.ts +35 -0
  46. package/dist/shared/lookup-tail.js +100 -0
  47. package/dist/shared/retrieval.d.ts +28 -0
  48. package/dist/shared/retrieval.js +45 -0
  49. package/dist/shell/entry.d.ts +3 -3
  50. package/dist/shell/entry.js +19 -44
  51. package/dist/shell/graph/agents.d.ts +48 -0
  52. package/dist/shell/graph/agents.js +152 -0
  53. package/dist/shell/graph/canvas.d.ts +64 -0
  54. package/dist/shell/graph/canvas.js +256 -0
  55. package/dist/shell/graph/controller.d.ts +202 -0
  56. package/dist/shell/graph/controller.js +782 -0
  57. package/dist/shell/graph/glyphs.d.ts +12 -0
  58. package/dist/shell/graph/glyphs.js +31 -0
  59. package/dist/shell/graph/graph-view.d.ts +19 -0
  60. package/dist/shell/graph/graph-view.js +585 -0
  61. package/dist/shell/graph/layout.d.ts +87 -0
  62. package/dist/shell/graph/layout.js +335 -0
  63. package/dist/shell/graph/watch.d.ts +71 -0
  64. package/dist/shell/graph/watch.js +153 -0
  65. package/dist/shell/input.d.ts +3 -0
  66. package/dist/shell/input.js +26 -4
  67. package/dist/shell/intro.d.ts +37 -0
  68. package/dist/shell/intro.js +82 -0
  69. package/dist/shell/logo-fx.d.ts +35 -0
  70. package/dist/shell/logo-fx.js +128 -0
  71. package/dist/shell/render.d.ts +2 -2
  72. package/dist/shell/render.js +15 -28
  73. package/dist/shell/shell.d.ts +15 -1
  74. package/dist/shell/shell.js +50 -7
  75. package/dist/shell/startup.d.ts +40 -0
  76. package/dist/shell/startup.js +113 -0
  77. package/dist/shell/state-store.d.ts +1 -1
  78. package/dist/shell/state-store.js +1 -1
  79. package/dist/shell/types.js +1 -0
  80. package/dist/shell/view.d.ts +3 -0
  81. package/dist/shell/view.js +72 -63
  82. package/dist/store-registry.js +3 -3
  83. package/dist/test-global-setup.d.ts +1 -0
  84. package/dist/test-global-setup.js +22 -0
  85. package/dist/tool-registry.js +1 -0
  86. package/dist/ui/data.d.ts +15 -7
  87. package/dist/ui/data.js +102 -3
  88. package/dist/ui/server.js +6 -56
  89. package/dist/utils-fts.js +2 -1
  90. package/dist/utils-helpers.d.ts +1 -0
  91. package/dist/utils-helpers.js +6 -0
  92. package/dist/utils.d.ts +1 -1
  93. package/dist/utils.js +1 -1
  94. package/package.json +11 -7
@@ -0,0 +1,43 @@
1
+ /**
2
+ * Shared graph payload contract.
3
+ *
4
+ * This module is consumed by three hosts: the browser 3D viewer (bundled by
5
+ * esbuild from `browser/`), the VS Code webview (via the same bundle), and the
6
+ * terminal graph view in `phren shell` (compiled by tsc). It must therefore
7
+ * stay free of DOM, node builtins, and any import outside `src/graph-core/`.
8
+ */
9
+ // ── Holographic-archive palette ─────────────────────────────────────────
10
+ /** The void. Every layer sits on this near-black indigo. */
11
+ export const BG_COLOR = "#05060f";
12
+ /** Amber used for selection / focused links — the single warm accent. */
13
+ export const ACCENT_AMBER = "#ffd166";
14
+ /** Cyan used for live pulses, HUD borders and hover accents. */
15
+ export const ACCENT_CYAN = "#67e8f9";
16
+ export const TOPIC_COLORS = {
17
+ architecture: "#46c8ff",
18
+ debugging: "#ff5470",
19
+ security: "#ff7847",
20
+ performance: "#ffb648",
21
+ testing: "#3ce8a4",
22
+ devops: "#2ee6c8",
23
+ tooling: "#6d8dff",
24
+ api: "#4f7dff",
25
+ database: "#38b6ff",
26
+ frontend: "#b48bff",
27
+ auth: "#ff9346",
28
+ data: "#2ed3e8",
29
+ mobile: "#43e0a8",
30
+ ai_ml: "#9d7bff",
31
+ general: "#7f8db3",
32
+ };
33
+ export const KIND_COLORS = {
34
+ project: "#f5b342",
35
+ entity: "#38e1ff",
36
+ reference: "#42e099",
37
+ "task-active": "#3ae374",
38
+ "task-queue": "#48b2ff",
39
+ "task-done": "#5c6b8a",
40
+ other: "#7f8db3",
41
+ };
42
+ // Distinct colors per store — up to 6 stores, then cycles
43
+ export const STORE_COLORS = ["#f5b342", "#9d7bff", "#2ed3e8", "#ff5470", "#43e0a8", "#f472b6"];
package/dist/index.js CHANGED
@@ -102,8 +102,11 @@ async function main() {
102
102
  indexReady = false;
103
103
  db = await buildIndex(phrenPath, profile);
104
104
  indexReady = true;
105
+ // buildIndex() hands back its cached handle inside the debounce
106
+ // window, so oldDb can be the very database we just installed.
105
107
  try {
106
- oldDb?.close();
108
+ if (oldDb && oldDb !== db)
109
+ oldDb.close();
107
110
  }
108
111
  catch (err) {
109
112
  logger.warn("rebuildIndex", `dbClose: ${errorMessage(err)}`);
@@ -1,3 +1,4 @@
1
+ export declare function shouldUninstallCurrentGlobalPackage(): boolean;
1
2
  export declare function runUninstall(opts?: {
2
3
  yes?: boolean;
3
4
  }): Promise<void>;
@@ -37,7 +37,7 @@ function runSyncCommand(command, args) {
37
37
  };
38
38
  }
39
39
  }
40
- function shouldUninstallCurrentGlobalPackage() {
40
+ export function shouldUninstallCurrentGlobalPackage() {
41
41
  // `npm uninstall -g` resolves against the machine's real npm prefix, which
42
42
  // no amount of PHREN_PATH/HOME redirection sandboxes. A test that spawns
43
43
  // `phren uninstall` against temp directories would therefore delete the
@@ -5,6 +5,7 @@ import * as fs from "fs";
5
5
  import * as path from "path";
6
6
  import * as os from "os";
7
7
  import * as yaml from "js-yaml";
8
+ import { loadYamlDocument } from "../phren-core.js";
8
9
  import { atomicWriteText, debugLog, findProjectNameCaseInsensitive, findProjectNamesByCanonicalKey, projectSlugFromPath, hookConfigPath, EXEC_TIMEOUT_QUICK_MS, readRootManifest, sessionsDir, runtimeHealthFile, isRecord, } from "../shared.js";
9
10
  import { ensurePrivateDir, homePath } from "../phren-paths.js";
10
11
  import { isLiveForeignPhrenRoot, phrenRootFromGlobalClaudeLink } from "./guard-globals.js";
@@ -45,7 +46,7 @@ function pruneLegacySampleProjectsFromProfiles(phrenPath) {
45
46
  continue;
46
47
  const fullPath = path.join(profilesDir, file);
47
48
  try {
48
- const parsed = yaml.load(fs.readFileSync(fullPath, "utf8"), { schema: yaml.CORE_SCHEMA });
49
+ const parsed = loadYamlDocument(fs.readFileSync(fullPath, "utf8"), (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA }));
49
50
  if (!isRecord(parsed))
50
51
  continue;
51
52
  const originalProjects = normalizeProjects(parsed.projects);
@@ -88,11 +89,17 @@ export function resolvePreferredHomeDir(phrenPath) {
88
89
  if (scoreAgentFootprint(resolvedUserProfile) > 0)
89
90
  return resolvedUserProfile;
90
91
  }
92
+ // An explicit HOME/USERPROFILE is authoritative. Only fall back to
93
+ // os.homedir() and the store's parent when neither is set — otherwise a
94
+ // caller that deliberately points HOME elsewhere (the test suite, a
95
+ // sandbox) loses the footprint contest to the developer's real home and
96
+ // we write symlinks into it.
91
97
  const candidates = [
92
98
  resolvedHome,
93
99
  resolvedUserProfile,
94
- path.resolve(os.homedir()),
95
- path.resolve(path.dirname(phrenPath)),
100
+ ...(resolvedHome || resolvedUserProfile
101
+ ? []
102
+ : [path.resolve(os.homedir()), path.resolve(path.dirname(phrenPath))]),
96
103
  ].filter((entry) => Boolean(entry && entry.trim()));
97
104
  const unique = [...new Set(candidates)];
98
105
  let bestPath = null;
@@ -1267,7 +1274,7 @@ export function updateMachinesYaml(phrenPath, machine, profile) {
1267
1274
  const profileName = profile?.trim() || (activeProfile.ok ? (activeProfile.data || "") : "") || "personal";
1268
1275
  let hasExistingMapping = false;
1269
1276
  try {
1270
- const loaded = yaml.load(fs.readFileSync(machinesFile, "utf8"), { schema: yaml.CORE_SCHEMA });
1277
+ const loaded = loadYamlDocument(fs.readFileSync(machinesFile, "utf8"), (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA }));
1271
1278
  if (loaded && typeof loaded === "object" && !Array.isArray(loaded)) {
1272
1279
  hasExistingMapping = Object.prototype.hasOwnProperty.call(loaded, machineName);
1273
1280
  }
@@ -1,6 +1,7 @@
1
1
  import * as fs from "fs";
2
2
  import * as path from "path";
3
3
  import * as yaml from "js-yaml";
4
+ import { loadYamlDocument } from "../phren-core.js";
4
5
  import { isValidProjectName } from "../utils.js";
5
6
  import { homeDir, homePath } from "../shared.js";
6
7
  import { resolveTaskFilePath } from "../data/tasks.js";
@@ -25,7 +26,7 @@ function allKnownProjects(phrenPath) {
25
26
  for (const f of fs.readdirSync(profilesDir)) {
26
27
  if (!f.endsWith(".yaml"))
27
28
  continue;
28
- const data = yaml.load(fs.readFileSync(path.join(profilesDir, f), "utf8"), { schema: yaml.CORE_SCHEMA });
29
+ const data = loadYamlDocument(fs.readFileSync(path.join(profilesDir, f), "utf8"), (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA }));
29
30
  for (const p of (data?.projects ?? []))
30
31
  projects.add(p);
31
32
  }
package/dist/link/link.js CHANGED
@@ -2,6 +2,7 @@ import * as fs from "fs";
2
2
  import * as path from "path";
3
3
  import * as readline from "readline";
4
4
  import * as yaml from "js-yaml";
5
+ import { loadYamlDocument } from "../phren-core.js";
5
6
  import { execFileSync } from "child_process";
6
7
  import { ROOT } from "../package-metadata.js";
7
8
  import { configureMcpTargets, ensureGovernanceFiles, getHooksEnabledPreference, getMcpEnabledPreference, isVersionNewer, patchJsonFile, setMcpEnabledPreference, } from "../init/init.js";
@@ -48,14 +49,14 @@ export function findProfileFile(phrenPath, profileName) {
48
49
  for (const f of fs.readdirSync(profilesDir)) {
49
50
  if (!f.endsWith(".yaml"))
50
51
  continue;
51
- const data = yaml.load(fs.readFileSync(path.join(profilesDir, f), "utf8"), { schema: yaml.CORE_SCHEMA });
52
+ const data = loadYamlDocument(fs.readFileSync(path.join(profilesDir, f), "utf8"), (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA }));
52
53
  if (data?.name === profileName)
53
54
  return path.join(profilesDir, f);
54
55
  }
55
56
  return null;
56
57
  }
57
58
  export function getProfileProjects(profileFile) {
58
- const data = yaml.load(fs.readFileSync(profileFile, "utf8"), { schema: yaml.CORE_SCHEMA });
59
+ const data = loadYamlDocument(fs.readFileSync(profileFile, "utf8"), (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA }));
59
60
  return Array.isArray(data?.projects) ? data.projects : [];
60
61
  }
61
62
  function currentPackageVersion() {
@@ -1,6 +1,7 @@
1
1
  import * as fs from "fs";
2
2
  import * as path from "path";
3
3
  import * as yaml from "js-yaml";
4
+ import { loadYamlDocument } from "../phren-core.js";
4
5
  import { debugLog } from "../shared.js";
5
6
  import { errorMessage } from "../utils.js";
6
7
  import { buildSharedLifecycleCommands } from "../hooks.js";
@@ -16,7 +17,7 @@ export function parseSkillFrontmatter(rawContent) {
16
17
  if (!match)
17
18
  return { frontmatter: null, body: content };
18
19
  try {
19
- const parsed = yaml.load(match[1]);
20
+ const parsed = loadYamlDocument(match[1], (text) => yaml.load(text));
20
21
  return { frontmatter: parsed && typeof parsed === "object" ? parsed : null, body: match[2] };
21
22
  }
22
23
  catch (err) {