@phren/cli 0.2.16 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bridge/agent-hooks.d.ts +2 -0
- package/dist/bridge/agent-hooks.js +4 -0
- package/dist/bridge/code-note.d.ts +2 -1
- package/dist/bridge/code-note.js +13 -4
- package/dist/bridge/code-routes.d.ts +32 -14
- package/dist/bridge/code-routes.js +131 -8
- package/dist/bridge/dispatch-returns.d.ts +2 -0
- package/dist/bridge/dispatch-returns.js +12 -8
- package/dist/bridge/dispatch.d.ts +4 -1
- package/dist/bridge/dispatch.js +30 -5
- package/dist/bridge/install.d.ts +0 -4
- package/dist/bridge/install.js +3 -3
- package/dist/bridge/protocol.js +20 -1
- package/dist/bridge/schedule-watch.d.ts +2 -0
- package/dist/bridge/schedule-watch.js +16 -3
- package/dist/bridge/server-pane-routes.d.ts +7 -0
- package/dist/bridge/server-pane-routes.js +90 -11
- package/dist/bridge/server-routes.d.ts +2 -0
- package/dist/bridge/server-routes.js +44 -26
- package/dist/bridge/transcript-preview.d.ts +2 -0
- package/dist/bridge/transcript-preview.js +15 -0
- package/dist/bridge-hook.mjs +8842 -3209
- package/dist/cli/config-policy.js +25 -0
- package/dist/cli/extract.d.ts +0 -8
- package/dist/cli/extract.js +1 -1
- package/dist/cli-registry.js +7 -7
- package/dist/content/validate.d.ts +14 -3
- package/dist/content/validate.js +174 -114
- package/dist/data/access.d.ts +9 -0
- package/dist/data/access.js +18 -0
- package/dist/generated/memory-ui-graph.browser.js +520 -410
- package/dist/governance/policy.js +4 -3
- package/dist/hooks.d.ts +0 -15
- package/dist/hooks.js +1 -1
- package/dist/init/init-uninstall.js +13 -3
- package/dist/init/setup.js +19 -5
- package/dist/init/store-gitignore.d.ts +0 -5
- package/dist/init/store-gitignore.js +0 -8
- package/dist/link/context-imports.d.ts +15 -0
- package/dist/link/context-imports.js +101 -0
- package/dist/link/doctor.js +28 -4
- package/dist/mcp/profile.d.ts +0 -4
- package/dist/mcp/profile.js +0 -13
- package/dist/memory-ui-graph.runtime.js +520 -410
- package/dist/modules/code-package.js +10 -2
- package/dist/modules/registry.js +1 -1
- package/dist/profile-store.js +39 -3
- package/dist/project-topics.d.ts +1 -0
- package/dist/project-topics.js +9 -6
- package/dist/shared/retrieval.d.ts +0 -2
- package/dist/shared/retrieval.js +1 -1
- package/dist/tools/code.js +29 -21
- package/dist/tools/config.js +3 -0
- package/dist/tools/dispatch.js +1 -1
- package/dist/tools/finding.d.ts +11 -0
- package/dist/tools/finding.js +154 -99
- package/dist/ui/server.js +18 -1
- package/dist/update.js +21 -10
- package/package.json +7 -7
- package/starter/global/skills/conductor/SKILL.md +1 -1
|
@@ -26,6 +26,14 @@ function npmPath() {
|
|
|
26
26
|
entries.push(entry);
|
|
27
27
|
return entries.join(path.delimiter);
|
|
28
28
|
}
|
|
29
|
+
/** Run npm. On Windows npm is `npm.cmd`, which only a shell can start (a
|
|
30
|
+
* plain spawn of it fails with EINVAL), and the shell needs each argument quoted. */
|
|
31
|
+
function npm(args, options) {
|
|
32
|
+
const env = { ...process.env, PATH: npmPath() };
|
|
33
|
+
if (process.platform !== "win32")
|
|
34
|
+
return String(execFileSync("npm", args, { ...options, env }) ?? "");
|
|
35
|
+
return String(execFileSync("npm.cmd", args.map(arg => `"${arg}"`), { ...options, env, shell: true }) ?? "");
|
|
36
|
+
}
|
|
29
37
|
/** The entry file an installed package declares, without executing anything. */
|
|
30
38
|
function packageEntry(directory) {
|
|
31
39
|
const manifest = JSON.parse(fs.readFileSync(path.join(directory, "package.json"), "utf8"));
|
|
@@ -43,7 +51,7 @@ async function importDirectory(directory) {
|
|
|
43
51
|
}
|
|
44
52
|
function globalPackageDirectory() {
|
|
45
53
|
try {
|
|
46
|
-
const root =
|
|
54
|
+
const root = npm(["root", "-g"], { encoding: "utf8", timeout: 10_000 }).trim();
|
|
47
55
|
return root ? path.join(root, "@phren", "code") : undefined;
|
|
48
56
|
}
|
|
49
57
|
catch {
|
|
@@ -134,7 +142,7 @@ export async function installCodePackage(store) {
|
|
|
134
142
|
return code;
|
|
135
143
|
}
|
|
136
144
|
try {
|
|
137
|
-
|
|
145
|
+
npm(["install", "--prefix", packages, "@phren/code"], { stdio: "inherit", timeout: 120_000 });
|
|
138
146
|
}
|
|
139
147
|
catch {
|
|
140
148
|
throw new Error(`${CODE_PACKAGE_HINT}\nInstallation failed. Run: npm install --prefix ${packages} @phren/code`);
|
package/dist/modules/registry.js
CHANGED
|
@@ -143,7 +143,7 @@ export const BUILTIN_MODULES = [
|
|
|
143
143
|
tools: full(["code_search", "code_definition", "code_references", "code_outline", "code_usage"]),
|
|
144
144
|
cliCommands: ["code index", "code status", "code search", "code outline", "code refs", "code def", "code usage"],
|
|
145
145
|
agentHooks: [],
|
|
146
|
-
hookRoutes: [...routes("GET", ["/v1/code/tree", "/v1/code/usage-page", "/v1/code/
|
|
146
|
+
hookRoutes: [...routes("GET", ["/v1/code/tree", "/v1/code/usage-page", "/v1/code/changed", "/v1/code/change-counts", "/v1/code/status", "/v1/code/search", "/v1/code/outline", "/v1/code/outline-summary", "/v1/code/file-references", "/v1/code/definition", "/v1/code/references", "/v1/code/usage"]), ...routes("POST", ["/v1/code/note", "/v1/code/reindex", "/v1/code/disable"])],
|
|
147
147
|
capabilities: ["code"],
|
|
148
148
|
storeFiles: [], localFiles: ["<store>/.runtime/code/*.sqlite"],
|
|
149
149
|
phoneScreens: [{ screen: "CodeView", capability: "code" }], skills: ["code"],
|
package/dist/profile-store.js
CHANGED
|
@@ -104,12 +104,28 @@ export function setMachineProfile(phrenPath, machine, profile) {
|
|
|
104
104
|
const machinesPath = path.join(phrenPath, "machines.yaml");
|
|
105
105
|
return withSafeLock(machinesPath, () => {
|
|
106
106
|
const current = listMachines(phrenPath);
|
|
107
|
+
// writeMachines rebuilds the whole file, so rewriting one phren cannot parse
|
|
108
|
+
// from an empty map would drop every other machine's mapping. The file is
|
|
109
|
+
// git-synced, so conflict markers are the likely cause. A comments-only file
|
|
110
|
+
// (the shipped starter) also fails to parse and is fine to write into.
|
|
111
|
+
if (!current.ok && current.code !== PhrenError.FILE_NOT_FOUND && hasMachineEntries(machinesPath)) {
|
|
112
|
+
return phrenErr(`${machinesPath} could not be parsed, so phren will not rewrite it. Fix the file by hand (check for git conflict markers), then map again.`, PhrenError.MALFORMED_YAML);
|
|
113
|
+
}
|
|
107
114
|
const data = current.ok ? current.data : {};
|
|
108
115
|
data[machine] = profile;
|
|
109
116
|
writeMachines(phrenPath, data);
|
|
110
117
|
return phrenOk(`Mapped machine ${machine} -> ${profile}.`);
|
|
111
118
|
});
|
|
112
119
|
}
|
|
120
|
+
/** Does machines.yaml hold anything besides comments and blank lines? */
|
|
121
|
+
function hasMachineEntries(machinesPath) {
|
|
122
|
+
try {
|
|
123
|
+
return loadYamlDocument(fs.readFileSync(machinesPath, "utf8"), () => true) === true;
|
|
124
|
+
}
|
|
125
|
+
catch {
|
|
126
|
+
return false;
|
|
127
|
+
}
|
|
128
|
+
}
|
|
113
129
|
function pickEnumVal(value, allowed) {
|
|
114
130
|
return typeof value === "string" && allowed.includes(value) ? value : undefined;
|
|
115
131
|
}
|
|
@@ -235,14 +251,34 @@ export function listProfiles(phrenPath) {
|
|
|
235
251
|
}
|
|
236
252
|
return phrenOk(profiles);
|
|
237
253
|
}
|
|
254
|
+
/**
|
|
255
|
+
* Rewrite a profile's projects, keeping every other key (the `defaults:` policy
|
|
256
|
+
* block included) and the file's leading comment, the way writeMachines does.
|
|
257
|
+
*/
|
|
238
258
|
function writeProfile(file, name, projects, description) {
|
|
239
259
|
const backup = `${file}.bak`;
|
|
240
|
-
|
|
260
|
+
const existing = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : "";
|
|
261
|
+
if (existing)
|
|
241
262
|
fs.copyFileSync(file, backup);
|
|
263
|
+
// listProfiles already refused an unparsable file, so this parse succeeds.
|
|
264
|
+
const parsed = existing ? loadYamlDocument(existing, (text) => yaml.load(text, { schema: yaml.CORE_SCHEMA })) : undefined;
|
|
265
|
+
const rest = parsed && typeof parsed === "object" && !Array.isArray(parsed)
|
|
266
|
+
? { ...parsed }
|
|
267
|
+
: {};
|
|
268
|
+
delete rest.name;
|
|
269
|
+
delete rest.description;
|
|
270
|
+
delete rest.projects;
|
|
271
|
+
const headerLines = [];
|
|
272
|
+
for (const line of existing.split("\n")) {
|
|
273
|
+
if (!line.startsWith("#") && line.trim() !== "")
|
|
274
|
+
break;
|
|
275
|
+
headerLines.push(line);
|
|
276
|
+
}
|
|
277
|
+
const header = headerLines.length ? `${headerLines.join("\n").replace(/\n+$/, "")}\n` : "";
|
|
242
278
|
const normalized = [...new Set(projects)].sort();
|
|
243
|
-
const out = yaml.dump({ name, ...(description ? { description } : {}), projects: normalized }, { lineWidth: 1000 });
|
|
279
|
+
const out = yaml.dump({ name, ...(description ? { description } : {}), projects: normalized, ...rest }, { lineWidth: 1000 });
|
|
244
280
|
const tmpPath = `${file}.tmp-${crypto.randomUUID()}`;
|
|
245
|
-
fs.writeFileSync(tmpPath, out);
|
|
281
|
+
fs.writeFileSync(tmpPath, header + out);
|
|
246
282
|
fs.renameSync(tmpPath, file);
|
|
247
283
|
}
|
|
248
284
|
export function addProjectToProfile(phrenPath, profile, project) {
|
package/dist/project-topics.d.ts
CHANGED
|
@@ -71,6 +71,7 @@ export declare function readProjectTopics(phrenPath: string, project: string): {
|
|
|
71
71
|
source: ProjectTopicSource;
|
|
72
72
|
topics: ProjectTopic[];
|
|
73
73
|
domain?: string;
|
|
74
|
+
error?: string;
|
|
74
75
|
};
|
|
75
76
|
export declare function pinProjectTopicSuggestion(phrenPath: string, project: string, topic: ProjectTopic): {
|
|
76
77
|
ok: true;
|
package/dist/project-topics.js
CHANGED
|
@@ -57,7 +57,7 @@ const SOFTWARE_TOPICS = [
|
|
|
57
57
|
slug: "architecture",
|
|
58
58
|
label: "Architecture",
|
|
59
59
|
description: "System shape, module boundaries, design patterns, and structural decisions.",
|
|
60
|
-
keywords: ["architecture", "design", "pattern", "layer", "module", "system", "structure", "microservice", "monolith", "event-driven"
|
|
60
|
+
keywords: ["architecture", "design", "pattern", "layer", "module", "system", "structure", "microservice", "monolith", "event-driven"],
|
|
61
61
|
},
|
|
62
62
|
{
|
|
63
63
|
slug: "debugging",
|
|
@@ -81,7 +81,7 @@ const SOFTWARE_TOPICS = [
|
|
|
81
81
|
slug: "data",
|
|
82
82
|
label: "Data",
|
|
83
83
|
description: "Data models, serialization, parsing, validation, and data flow details.",
|
|
84
|
-
keywords: ["data", "
|
|
84
|
+
keywords: ["data", "serialize", "deserialize", "json", "csv", "transform", "validate", "parse", "format", "encode"],
|
|
85
85
|
},
|
|
86
86
|
{
|
|
87
87
|
slug: "mobile",
|
|
@@ -93,7 +93,7 @@ const SOFTWARE_TOPICS = [
|
|
|
93
93
|
slug: "ai_ml",
|
|
94
94
|
label: "AI / ML",
|
|
95
95
|
description: "Models, embeddings, prompts, inference, and ML-specific systems.",
|
|
96
|
-
keywords: ["ai", "ml", "model", "embedding", "vector", "llm", "prompt", "
|
|
96
|
+
keywords: ["ai", "ml", "model", "embedding", "vector", "llm", "prompt", "inference", "training", "neural", "gpt", "claude"],
|
|
97
97
|
},
|
|
98
98
|
{
|
|
99
99
|
slug: "general",
|
|
@@ -115,7 +115,7 @@ const DOMAIN_TOPICS = {
|
|
|
115
115
|
slug: "production",
|
|
116
116
|
label: "Production",
|
|
117
117
|
description: "Session workflow, recording choices, and production techniques.",
|
|
118
|
-
keywords: ["production", "recording", "session", "tracking", "workflow", "
|
|
118
|
+
keywords: ["production", "recording", "session", "tracking", "workflow", "producer"],
|
|
119
119
|
},
|
|
120
120
|
{
|
|
121
121
|
slug: "mixing",
|
|
@@ -259,7 +259,7 @@ const DOMAIN_TOPICS = {
|
|
|
259
259
|
slug: "style",
|
|
260
260
|
label: "Style",
|
|
261
261
|
description: "Tone, diction, constraints, and stylistic direction.",
|
|
262
|
-
keywords: ["style", "tone", "
|
|
262
|
+
keywords: ["style", "tone", "diction", "register", "aesthetic"],
|
|
263
263
|
},
|
|
264
264
|
{
|
|
265
265
|
slug: "research",
|
|
@@ -570,8 +570,11 @@ export function readProjectTopics(phrenPath, project) {
|
|
|
570
570
|
const normalized = ensureGeneralTopic(normalizeTopics(parsed.topics));
|
|
571
571
|
const validationError = validateTopics(normalized);
|
|
572
572
|
if (validationError) {
|
|
573
|
+
// Falling back silently made a rejected config indistinguishable from having
|
|
574
|
+
// none: `get_config topic` reported source "default" while the file sat
|
|
575
|
+
// plainly on disk, and the only trace was a debug line. Return the reason.
|
|
573
576
|
debugLog(`readProjectTopics: invalid ${configPath}: ${validationError}`);
|
|
574
|
-
return { source: "default", topics: builtinTopics };
|
|
577
|
+
return { source: "default", topics: builtinTopics, error: validationError };
|
|
575
578
|
}
|
|
576
579
|
return { source: "custom", topics: normalized, domain: typeof parsed.domain === "string" ? parsed.domain : undefined };
|
|
577
580
|
}
|
|
@@ -52,8 +52,6 @@ export declare function tokenRarity(db: SqlJsDatabase | null | undefined, queryT
|
|
|
52
52
|
*/
|
|
53
53
|
/** @internal Exported for tests. */
|
|
54
54
|
export declare function rrfMerge(tiers: DocRow[][], k?: number): DocRow[];
|
|
55
|
-
/** @internal Exported for tests. */
|
|
56
|
-
export declare function shouldRunVectorExpansion(rows: DocRow[] | null, prompt: string, desiredResults?: number): boolean;
|
|
57
55
|
declare function approximateTokens(text: string): number;
|
|
58
56
|
export declare function filterTaskByPriority(items: string[], allowedPriorities?: string[]): string[];
|
|
59
57
|
export declare function searchDocuments(db: SqlJsDatabase, safeQuery: string, prompt: string, keywords: string, detectedProject: string | null, searchAllProjects?: boolean, phrenPath?: string): DocRow[] | null;
|
package/dist/shared/retrieval.js
CHANGED
|
@@ -398,7 +398,7 @@ function semanticFallbackDocs(db, prompt, project) {
|
|
|
398
398
|
return scored;
|
|
399
399
|
}
|
|
400
400
|
/** @internal Exported for tests. */
|
|
401
|
-
|
|
401
|
+
function shouldRunVectorExpansion(rows, prompt, desiredResults = VECTOR_FALLBACK_SKIP_COUNT) {
|
|
402
402
|
if (!rows || rows.length === 0)
|
|
403
403
|
return true;
|
|
404
404
|
const targetCount = Math.max(2, Math.min(VECTOR_FALLBACK_SKIP_COUNT, desiredResults));
|
package/dist/tools/code.js
CHANGED
|
@@ -2,11 +2,11 @@ import { z } from "zod";
|
|
|
2
2
|
import { resolveStoreForProject } from "./types.js";
|
|
3
3
|
import { loadCodePackage, CODE_PACKAGE_HINT } from "../modules/code-package.js";
|
|
4
4
|
/**
|
|
5
|
-
* Read tools over the `code` module's local
|
|
5
|
+
* Read tools over the `code` module's local code index (stage 2).
|
|
6
6
|
*
|
|
7
|
-
* These answer
|
|
7
|
+
* These answer questions about functions, types and variables from the project's own index instead of a grep
|
|
8
8
|
* sweep: a definition, the references grouped by file, a file's outline, a
|
|
9
|
-
* ranked search and the
|
|
9
|
+
* ranked search and the most and least used functions and types. Every tool lives in the
|
|
10
10
|
* `code` module, so it is absent until the module is enabled and the project is
|
|
11
11
|
* indexed; the result is compact text, one line per hit, not a JSON dump.
|
|
12
12
|
*/
|
|
@@ -44,11 +44,11 @@ function usageLine(entry) {
|
|
|
44
44
|
export function register(server, ctx) {
|
|
45
45
|
server.registerTool("code_search", {
|
|
46
46
|
title: "◆ phren · code search",
|
|
47
|
-
description: "
|
|
47
|
+
description: "Find functions, methods, types (classes, structs, enums, interfaces) and variables in a project's code index by name, signature or doc text. Use this instead of grep when you want a declaration rather than raw text: results are ranked exact name, then prefix, then full-text relevance, then how often it is used, and each hit carries its kind, signature, doc and path:line. Pass `kind` to narrow to function, method, class, struct, enum, interface, type or variable.",
|
|
48
48
|
inputSchema: z.object({
|
|
49
49
|
project: z.string().describe("Project name, optionally store-qualified."),
|
|
50
|
-
query: z.string().describe("
|
|
51
|
-
kind: z.enum(["function", "method", "class", "struct", "enum", "interface", "type", "variable"]).optional().describe("Only
|
|
50
|
+
query: z.string().describe("A name, or words from its signature or doc comment."),
|
|
51
|
+
kind: z.enum(["function", "method", "class", "struct", "enum", "interface", "type", "variable"]).optional().describe("Only this kind."),
|
|
52
52
|
limit: z.number().int().min(1).max(100).optional().describe("Maximum hits. Defaults to 20."),
|
|
53
53
|
}),
|
|
54
54
|
}, async ({ project: projectInput, query, kind, limit }) => {
|
|
@@ -63,17 +63,21 @@ export function register(server, ctx) {
|
|
|
63
63
|
if (!result.available)
|
|
64
64
|
return text(noIndex(target.project));
|
|
65
65
|
if (result.value.length === 0)
|
|
66
|
-
return text(`
|
|
66
|
+
return text(`Nothing named or described "${query}" in ${target.project}.`);
|
|
67
67
|
return text(`${target.project}: ${result.value.length} match(es) for "${query}"\n${result.value.map(formatSymbolLine).join("\n")}`);
|
|
68
68
|
});
|
|
69
69
|
server.registerTool("code_definition", {
|
|
70
70
|
title: "◆ phren · code definition",
|
|
71
|
-
description: "Go to a
|
|
71
|
+
description: "Go to where a function, method, type or variable is defined, from a project's code index. Use this instead of grep: it accepts `Foo`, `Foo.bar` and `bar()` forms and returns the file and lines, signature, doc comment, the last change (a blame hash and date, never a name), a short source snippet and any Phren findings linked to it. When a common name matches several declarations it prefers an exported, non-variable one and reports how many candidates there were.",
|
|
72
72
|
inputSchema: z.object({
|
|
73
73
|
project: z.string().describe("Project name, optionally store-qualified."),
|
|
74
|
-
|
|
74
|
+
name: z.string().optional().describe("What to look up: Foo, Foo.bar or bar()."),
|
|
75
|
+
symbol: z.string().optional().describe("Deprecated: use name. Accepted until @phren/cli 0.3.1."),
|
|
75
76
|
}),
|
|
76
|
-
}, async ({ project: projectInput, symbol }) => {
|
|
77
|
+
}, async ({ project: projectInput, name: nameInput, symbol: legacyName }) => {
|
|
78
|
+
const symbol = nameInput ?? legacyName;
|
|
79
|
+
if (!symbol)
|
|
80
|
+
return text("Pass name: the function, type or variable to look up.");
|
|
77
81
|
const code = await loadCodePackage(ctx.phrenPath);
|
|
78
82
|
if (!code)
|
|
79
83
|
return text(CODE_PACKAGE_HINT);
|
|
@@ -85,7 +89,7 @@ export function register(server, ctx) {
|
|
|
85
89
|
if (!result.available)
|
|
86
90
|
return text(noIndex(target.project));
|
|
87
91
|
if (!result.value)
|
|
88
|
-
return text(`
|
|
92
|
+
return text(`Nothing named "${symbol}" in ${target.project}.`);
|
|
89
93
|
const { symbol: hit, candidates, snippet, blame } = result.value;
|
|
90
94
|
const lines = [
|
|
91
95
|
`${hit.file}:${hit.line}-${hit.endLine} ${hit.kind} ${hit.name}${hit.exported ? " (exported)" : ""}`,
|
|
@@ -100,13 +104,17 @@ export function register(server, ctx) {
|
|
|
100
104
|
});
|
|
101
105
|
server.registerTool("code_references", {
|
|
102
106
|
title: "◆ phren · code references",
|
|
103
|
-
description: "Find every
|
|
107
|
+
description: "Find every place a function, method, type or variable is used, from a project's code index, grouped by file. Use this instead of grep to answer who calls or uses it: it accepts `Foo`, `Foo.bar` and `bar()` forms and counts only uses the index could resolve to exactly one definition. Common-name ambiguity is reported as a candidate count.",
|
|
104
108
|
inputSchema: z.object({
|
|
105
109
|
project: z.string().describe("Project name, optionally store-qualified."),
|
|
106
|
-
|
|
110
|
+
name: z.string().optional().describe("What to look up: Foo, Foo.bar or bar()."),
|
|
111
|
+
symbol: z.string().optional().describe("Deprecated: use name. Accepted until @phren/cli 0.3.1."),
|
|
107
112
|
limit: z.number().int().min(1).max(500).optional().describe("Maximum reference lines. Defaults to 200."),
|
|
108
113
|
}),
|
|
109
|
-
}, async ({ project: projectInput, symbol, limit }) => {
|
|
114
|
+
}, async ({ project: projectInput, name: nameInput, symbol: legacyName, limit }) => {
|
|
115
|
+
const symbol = nameInput ?? legacyName;
|
|
116
|
+
if (!symbol)
|
|
117
|
+
return text("Pass name: the function, type or variable to look up.");
|
|
110
118
|
const code = await loadCodePackage(ctx.phrenPath);
|
|
111
119
|
if (!code)
|
|
112
120
|
return text(CODE_PACKAGE_HINT);
|
|
@@ -118,7 +126,7 @@ export function register(server, ctx) {
|
|
|
118
126
|
if (!result.available)
|
|
119
127
|
return text(noIndex(target.project));
|
|
120
128
|
if (!result.value)
|
|
121
|
-
return text(`
|
|
129
|
+
return text(`Nothing named "${symbol}" in ${target.project}.`);
|
|
122
130
|
const { symbol: hit, candidates, groups, total } = result.value;
|
|
123
131
|
const header = `references for ${hit.name} (${hit.file}:${hit.line} ${hit.kind}), ${total} in ${groups.length} file(s)`;
|
|
124
132
|
const note = candidates > 1 ? `\n${candidates} candidates shared this name; showing the best.` : "";
|
|
@@ -129,7 +137,7 @@ export function register(server, ctx) {
|
|
|
129
137
|
});
|
|
130
138
|
server.registerTool("code_outline", {
|
|
131
139
|
title: "◆ phren · code outline",
|
|
132
|
-
description: "List a file's
|
|
140
|
+
description: "List a file's functions, types and variables in source order, methods nested under their class or container. Use this before reading a large file: it is far cheaper than opening the source and it shows the structure with each declaration's line, signature and doc. The path is the project-relative path the index uses.",
|
|
133
141
|
inputSchema: z.object({
|
|
134
142
|
project: z.string().describe("Project name, optionally store-qualified."),
|
|
135
143
|
path: z.string().describe("Project-relative file path, as stored in the index."),
|
|
@@ -146,16 +154,16 @@ export function register(server, ctx) {
|
|
|
146
154
|
if (!result.available)
|
|
147
155
|
return text(noIndex(target.project));
|
|
148
156
|
if (result.value.length === 0)
|
|
149
|
-
return text(`No indexed
|
|
157
|
+
return text(`No functions, types or variables indexed for ${filePath} in ${target.project}.`);
|
|
150
158
|
const count = result.value.reduce((n, entry) => n + 1 + countOutline(entry.children), 0);
|
|
151
|
-
return text(`${target.project}/${filePath} (${count}
|
|
159
|
+
return text(`${target.project}/${filePath} (${count} declarations)\n${outlineLines(result.value).join("\n")}`);
|
|
152
160
|
});
|
|
153
161
|
server.registerTool("code_usage", {
|
|
154
162
|
title: "◆ phren · code usage",
|
|
155
|
-
description: "Show a project's
|
|
163
|
+
description: "Show a project's most used and least used functions and types, by how many places use them. Use this instead of grep to see what code is central and what is barely used: it returns the top and bottom N so rarely used code is visible too. Local variables are left out of the most-used list so a busy one-function local or a one-letter loop name cannot dominate it.",
|
|
156
164
|
inputSchema: z.object({
|
|
157
165
|
project: z.string().describe("Project name, optionally store-qualified."),
|
|
158
|
-
top: z.number().int().min(1).max(100).optional().describe("How many
|
|
166
|
+
top: z.number().int().min(1).max(100).optional().describe("How many most used and how many least used. Defaults to 10."),
|
|
159
167
|
}),
|
|
160
168
|
}, async ({ project: projectInput, top }) => {
|
|
161
169
|
const code = await loadCodePackage(ctx.phrenPath);
|
|
@@ -170,7 +178,7 @@ export function register(server, ctx) {
|
|
|
170
178
|
return text(noIndex(target.project));
|
|
171
179
|
const { top: hot, bottom: cold } = result.value;
|
|
172
180
|
const section = (label, entries) => entries.length === 0 ? `${label}\nnone` : `${label}\n${entries.map(usageLine).join("\n")}`;
|
|
173
|
-
return text(`${target.project}
|
|
181
|
+
return text(`${target.project} functions and types by how many places use them\n${section("most used", hot)}\n${section("least used", cold)}`);
|
|
174
182
|
});
|
|
175
183
|
}
|
|
176
184
|
function countOutline(entries) {
|
package/dist/tools/config.js
CHANGED
|
@@ -66,6 +66,9 @@ function getTopicConfigData(phrenPath, project) {
|
|
|
66
66
|
domain: result.domain ?? raw?.domain ?? null,
|
|
67
67
|
topics: result.topics,
|
|
68
68
|
pinnedTopics: raw?.pinnedTopics ?? [],
|
|
69
|
+
// A topic-config.json that exists but was rejected reported source
|
|
70
|
+
// "default" with no hint that the file was being ignored.
|
|
71
|
+
...(result.error ? { configError: result.error } : {}),
|
|
69
72
|
},
|
|
70
73
|
};
|
|
71
74
|
}
|
package/dist/tools/dispatch.js
CHANGED
|
@@ -21,7 +21,7 @@ export function register(server) {
|
|
|
21
21
|
});
|
|
22
22
|
server.registerTool("dispatch_returns", {
|
|
23
23
|
title: "◆ phren · dispatch returns",
|
|
24
|
-
description: "List unread returns from dispatched workers and mark them read: the worker finished (done, with its final reply), finished by asking the owner something (needs-you, with the question), is blocked on terminal input, or its pane is gone. Each row has the dispatch id, computer, project, label and the worker's target for hand_off.",
|
|
24
|
+
description: "List unread returns from dispatched workers and mark them read: the worker finished (done, with its final reply), finished by asking the owner something (needs-you, with the question), failed (the harness ended the turn on an error such as a usage limit, with the error), is blocked on terminal input, or its pane is gone. Each row has the dispatch id, computer, project, label and the worker's target for hand_off.",
|
|
25
25
|
inputSchema: {},
|
|
26
26
|
}, async () => {
|
|
27
27
|
try {
|
package/dist/tools/finding.d.ts
CHANGED
|
@@ -1,4 +1,15 @@
|
|
|
1
1
|
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
2
|
import { type McpContext } from "./types.js";
|
|
3
3
|
export declare function findConflictCandidates(phrenPath: string, project: string, finding: string): string[];
|
|
4
|
+
export interface TeamStoreSyncResult {
|
|
5
|
+
store: string;
|
|
6
|
+
pushed: boolean;
|
|
7
|
+
error?: string;
|
|
8
|
+
}
|
|
9
|
+
/**
|
|
10
|
+
* Commit and push the team-safe pathspecs of every attached team store. Team
|
|
11
|
+
* stores are independent repos, so push_changes runs this whatever happens to
|
|
12
|
+
* the primary store.
|
|
13
|
+
*/
|
|
14
|
+
export declare function syncTeamStores(phrenPath: string): Promise<TeamStoreSyncResult[]>;
|
|
4
15
|
export declare function register(server: McpServer, ctx: McpContext): void;
|