pi-compass 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +74 -0
- package/dist/analyzers/build-script-detector.d.ts +3 -0
- package/dist/analyzers/build-script-detector.d.ts.map +1 -0
- package/dist/analyzers/build-script-detector.js +75 -0
- package/dist/analyzers/build-script-detector.js.map +1 -0
- package/dist/analyzers/convention-detector.d.ts +3 -0
- package/dist/analyzers/convention-detector.d.ts.map +1 -0
- package/dist/analyzers/convention-detector.js +47 -0
- package/dist/analyzers/convention-detector.js.map +1 -0
- package/dist/analyzers/directory-tree.d.ts +4 -0
- package/dist/analyzers/directory-tree.d.ts.map +1 -0
- package/dist/analyzers/directory-tree.js +60 -0
- package/dist/analyzers/directory-tree.js.map +1 -0
- package/dist/analyzers/entry-point-detector.d.ts +3 -0
- package/dist/analyzers/entry-point-detector.d.ts.map +1 -0
- package/dist/analyzers/entry-point-detector.js +87 -0
- package/dist/analyzers/entry-point-detector.js.map +1 -0
- package/dist/analyzers/framework-detector.d.ts +3 -0
- package/dist/analyzers/framework-detector.d.ts.map +1 -0
- package/dist/analyzers/framework-detector.js +63 -0
- package/dist/analyzers/framework-detector.js.map +1 -0
- package/dist/analyzers/index.d.ts +8 -0
- package/dist/analyzers/index.d.ts.map +1 -0
- package/dist/analyzers/index.js +8 -0
- package/dist/analyzers/index.js.map +1 -0
- package/dist/analyzers/key-file-detector.d.ts +3 -0
- package/dist/analyzers/key-file-detector.d.ts.map +1 -0
- package/dist/analyzers/key-file-detector.js +32 -0
- package/dist/analyzers/key-file-detector.js.map +1 -0
- package/dist/analyzers/package-detector.d.ts +3 -0
- package/dist/analyzers/package-detector.d.ts.map +1 -0
- package/dist/analyzers/package-detector.js +78 -0
- package/dist/analyzers/package-detector.js.map +1 -0
- package/dist/codemap-formatter.d.ts +4 -0
- package/dist/codemap-formatter.d.ts.map +1 -0
- package/dist/codemap-formatter.js +72 -0
- package/dist/codemap-formatter.js.map +1 -0
- package/dist/codemap-generator.d.ts +10 -0
- package/dist/codemap-generator.d.ts.map +1 -0
- package/dist/codemap-generator.js +80 -0
- package/dist/codemap-generator.js.map +1 -0
- package/dist/codemap-injector.d.ts +12 -0
- package/dist/codemap-injector.d.ts.map +1 -0
- package/dist/codemap-injector.js +20 -0
- package/dist/codemap-injector.js.map +1 -0
- package/dist/fs-utils.d.ts +3 -0
- package/dist/fs-utils.d.ts.map +1 -0
- package/dist/fs-utils.js +21 -0
- package/dist/fs-utils.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +69 -0
- package/dist/index.js.map +1 -0
- package/dist/onboard-command.d.ts +5 -0
- package/dist/onboard-command.d.ts.map +1 -0
- package/dist/onboard-command.js +33 -0
- package/dist/onboard-command.js.map +1 -0
- package/dist/onboard-tools.d.ts +4 -0
- package/dist/onboard-tools.d.ts.map +1 -0
- package/dist/onboard-tools.js +77 -0
- package/dist/onboard-tools.js.map +1 -0
- package/dist/project.d.ts +4 -0
- package/dist/project.d.ts.map +1 -0
- package/dist/project.js +20 -0
- package/dist/project.js.map +1 -0
- package/dist/storage.d.ts +12 -0
- package/dist/storage.d.ts.map +1 -0
- package/dist/storage.js +46 -0
- package/dist/storage.js.map +1 -0
- package/dist/tour-command.d.ts +5 -0
- package/dist/tour-command.d.ts.map +1 -0
- package/dist/tour-command.js +26 -0
- package/dist/tour-command.js.map +1 -0
- package/dist/tour-generator.d.ts +6 -0
- package/dist/tour-generator.d.ts.map +1 -0
- package/dist/tour-generator.js +204 -0
- package/dist/tour-generator.js.map +1 -0
- package/dist/types.d.ts +89 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/package.json +71 -0
- package/src/analyzers/build-script-detector.ts +85 -0
- package/src/analyzers/convention-detector.ts +52 -0
- package/src/analyzers/directory-tree.ts +65 -0
- package/src/analyzers/entry-point-detector.ts +98 -0
- package/src/analyzers/framework-detector.ts +76 -0
- package/src/analyzers/index.ts +7 -0
- package/src/analyzers/key-file-detector.ts +36 -0
- package/src/analyzers/package-detector.ts +87 -0
- package/src/codemap-formatter.ts +90 -0
- package/src/codemap-generator.ts +110 -0
- package/src/codemap-injector.ts +44 -0
- package/src/fs-utils.ts +19 -0
- package/src/index.ts +90 -0
- package/src/onboard-command.ts +60 -0
- package/src/onboard-tools.ts +116 -0
- package/src/project.ts +29 -0
- package/src/storage.ts +82 -0
- package/src/tour-command.ts +50 -0
- package/src/tour-generator.ts +237 -0
- package/src/types.ts +104 -0
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { existsSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
import { readTextFile, readJsonFile } from "../fs-utils.js";
|
|
4
|
+
export function detectPackages(cwd) {
|
|
5
|
+
const results = [];
|
|
6
|
+
const npmPkg = readJsonFile(join(cwd, "package.json"));
|
|
7
|
+
if (npmPkg) {
|
|
8
|
+
const deps = Object.keys(npmPkg.dependencies ?? {});
|
|
9
|
+
const devDeps = Object.keys(npmPkg.devDependencies ?? {});
|
|
10
|
+
const name = typeof npmPkg.name === "string" ? npmPkg.name : "";
|
|
11
|
+
const version = typeof npmPkg.version === "string" ? npmPkg.version : null;
|
|
12
|
+
results.push({
|
|
13
|
+
manager: "npm",
|
|
14
|
+
name,
|
|
15
|
+
...(version ? { version } : {}),
|
|
16
|
+
dependencies: [...deps, ...devDeps],
|
|
17
|
+
});
|
|
18
|
+
}
|
|
19
|
+
const goMod = readTextFile(join(cwd, "go.mod"));
|
|
20
|
+
if (goMod) {
|
|
21
|
+
const moduleMatch = goMod.match(/^module\s+(\S+)/m);
|
|
22
|
+
const deps = [...goMod.matchAll(/^\t(\S+)\s/gm)].map((m) => m[1]);
|
|
23
|
+
results.push({
|
|
24
|
+
manager: "go",
|
|
25
|
+
name: moduleMatch?.[1] ?? "",
|
|
26
|
+
dependencies: deps,
|
|
27
|
+
});
|
|
28
|
+
}
|
|
29
|
+
const cargo = readTextFile(join(cwd, "Cargo.toml"));
|
|
30
|
+
if (cargo) {
|
|
31
|
+
const nameMatch = cargo.match(/^name\s*=\s*"([^"]+)"/m);
|
|
32
|
+
const versionMatch = cargo.match(/^version\s*=\s*"([^"]+)"/m);
|
|
33
|
+
const deps = [...cargo.matchAll(/^\[(?:dev-)?dependencies\.([^\]]+)\]/gm)].map((m) => m[1]);
|
|
34
|
+
const inlineDeps = [...cargo.matchAll(/^(\w[\w-]*)\s*=\s*(?:"|{)/gm)]
|
|
35
|
+
.map((m) => m[1])
|
|
36
|
+
.filter((d) => d !== "name" && d !== "version" && d !== "edition" && d !== "authors");
|
|
37
|
+
const cargoVersion = versionMatch?.[1];
|
|
38
|
+
results.push({
|
|
39
|
+
manager: "cargo",
|
|
40
|
+
name: nameMatch?.[1] ?? "",
|
|
41
|
+
...(cargoVersion ? { version: cargoVersion } : {}),
|
|
42
|
+
dependencies: [...new Set([...deps, ...inlineDeps])],
|
|
43
|
+
});
|
|
44
|
+
}
|
|
45
|
+
const pyproject = readTextFile(join(cwd, "pyproject.toml"));
|
|
46
|
+
if (pyproject) {
|
|
47
|
+
const nameMatch = pyproject.match(/^name\s*=\s*"([^"]+)"/m);
|
|
48
|
+
const versionMatch = pyproject.match(/^version\s*=\s*"([^"]+)"/m);
|
|
49
|
+
const depsSection = pyproject.match(/^dependencies\s*=\s*\[([\s\S]*?)\]/m);
|
|
50
|
+
const deps = depsSection
|
|
51
|
+
? [...depsSection[1].matchAll(/"([^">=<\s]+)/g)].map((m) => m[1])
|
|
52
|
+
: [];
|
|
53
|
+
const hasPoetry = pyproject.includes("[tool.poetry]");
|
|
54
|
+
const pyVersion = versionMatch?.[1];
|
|
55
|
+
results.push({
|
|
56
|
+
manager: hasPoetry ? "poetry" : "pip",
|
|
57
|
+
name: nameMatch?.[1] ?? "",
|
|
58
|
+
...(pyVersion ? { version: pyVersion } : {}),
|
|
59
|
+
dependencies: deps,
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
const composer = readJsonFile(join(cwd, "composer.json"));
|
|
63
|
+
if (composer) {
|
|
64
|
+
results.push({
|
|
65
|
+
manager: "composer",
|
|
66
|
+
name: typeof composer.name === "string" ? composer.name : "",
|
|
67
|
+
dependencies: Object.keys(composer.require ?? {}),
|
|
68
|
+
});
|
|
69
|
+
}
|
|
70
|
+
if (existsSync(join(cwd, "build.gradle")) || existsSync(join(cwd, "build.gradle.kts"))) {
|
|
71
|
+
results.push({ manager: "gradle", name: "", dependencies: [] });
|
|
72
|
+
}
|
|
73
|
+
if (existsSync(join(cwd, "pom.xml"))) {
|
|
74
|
+
results.push({ manager: "maven", name: "", dependencies: [] });
|
|
75
|
+
}
|
|
76
|
+
return results;
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=package-detector.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"package-detector.js","sourceRoot":"","sources":["../../src/analyzers/package-detector.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemap-formatter.d.ts","sourceRoot":"","sources":["../src/codemap-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAmE9D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB1E"}
|
|
@@ -0,0 +1,72 @@
|
|
|
1
|
+
import { formatDirectoryTree } from "./analyzers/directory-tree.js";
|
|
2
|
+
export function formatCodemapMarkdown(codemap) {
|
|
3
|
+
const sections = [
|
|
4
|
+
`## Codebase Map: ${codemap.projectName}`,
|
|
5
|
+
`Generated: ${codemap.generatedAt} | Hash: ${codemap.contentHash}`,
|
|
6
|
+
];
|
|
7
|
+
if (codemap.directoryTree.length > 0) {
|
|
8
|
+
sections.push("", "### Directory Structure", "```", formatDirectoryTree(codemap.directoryTree), "```");
|
|
9
|
+
}
|
|
10
|
+
if (codemap.packages.length > 0) {
|
|
11
|
+
sections.push("", "### Packages");
|
|
12
|
+
for (const pkg of codemap.packages) {
|
|
13
|
+
const version = pkg.version ? ` v${pkg.version}` : "";
|
|
14
|
+
sections.push(`- **${pkg.name || "(unnamed)"}**${version} (${pkg.manager})`);
|
|
15
|
+
if (pkg.dependencies.length > 0) {
|
|
16
|
+
const depList = pkg.dependencies.slice(0, 20).join(", ");
|
|
17
|
+
const more = pkg.dependencies.length > 20 ? ` (+${pkg.dependencies.length - 20} more)` : "";
|
|
18
|
+
sections.push(` Dependencies: ${depList}${more}`);
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
if (codemap.frameworks.length > 0) {
|
|
23
|
+
sections.push("", "### Frameworks");
|
|
24
|
+
for (const fw of codemap.frameworks) {
|
|
25
|
+
const version = fw.version ? ` v${fw.version}` : "";
|
|
26
|
+
const confidence = fw.confidence === "likely" ? " (likely)" : "";
|
|
27
|
+
sections.push(`- ${fw.name}${version}${confidence}`);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
if (codemap.entryPoints.length > 0) {
|
|
31
|
+
sections.push("", "### Entry Points");
|
|
32
|
+
for (const ep of codemap.entryPoints) {
|
|
33
|
+
sections.push(`- \`${ep.path}\` (${ep.kind})`);
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
if (codemap.buildScripts.length > 0) {
|
|
37
|
+
sections.push("", "### Build / Test / Deploy");
|
|
38
|
+
for (const script of codemap.buildScripts) {
|
|
39
|
+
sections.push(`- **${script.name}**: \`${script.command}\` (${script.source})`);
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
if (codemap.conventions.length > 0) {
|
|
43
|
+
sections.push("", "### Conventions");
|
|
44
|
+
for (const conv of codemap.conventions) {
|
|
45
|
+
sections.push(``, `#### ${conv.source}`, conv.content);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
if (codemap.keyFiles.length > 0) {
|
|
49
|
+
sections.push("", "### Key Files");
|
|
50
|
+
for (const kf of codemap.keyFiles) {
|
|
51
|
+
sections.push(`- \`${kf.path}\` -- ${kf.description}`);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
return sections.join("\n");
|
|
55
|
+
}
|
|
56
|
+
export function truncateCodemap(markdown, maxChars) {
|
|
57
|
+
if (markdown.length <= maxChars)
|
|
58
|
+
return markdown;
|
|
59
|
+
const lines = markdown.split("\n");
|
|
60
|
+
let length = 0;
|
|
61
|
+
const kept = [];
|
|
62
|
+
for (const line of lines) {
|
|
63
|
+
if (length + line.length + 1 > maxChars) {
|
|
64
|
+
kept.push("", "... (codemap truncated, run /onboard to see full output)");
|
|
65
|
+
break;
|
|
66
|
+
}
|
|
67
|
+
kept.push(line);
|
|
68
|
+
length += line.length + 1;
|
|
69
|
+
}
|
|
70
|
+
return kept.join("\n");
|
|
71
|
+
}
|
|
72
|
+
//# sourceMappingURL=codemap-formatter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemap-formatter.js","sourceRoot":"","sources":["../src/codemap-formatter.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { CodeMap } from "./types.js";
|
|
2
|
+
export declare function computeContentHash(cwd: string): string;
|
|
3
|
+
export declare function generateCodemap(cwd: string, projectId: string, projectName: string): CodeMap;
|
|
4
|
+
export interface CodemapResult {
|
|
5
|
+
readonly codemap: CodeMap;
|
|
6
|
+
readonly fromCache: boolean;
|
|
7
|
+
readonly stale: boolean;
|
|
8
|
+
}
|
|
9
|
+
export declare function getOrGenerateCodemap(cwd: string, projectId: string, projectName: string, baseDir?: string): CodemapResult;
|
|
10
|
+
//# sourceMappingURL=codemap-generator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemap-generator.d.ts","sourceRoot":"","sources":["../src/codemap-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,YAAY,CAAC;AA4BtD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmBtD;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAsBT;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAkBf"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { readFileSync, readdirSync } from "node:fs";
|
|
3
|
+
import { join } from "node:path";
|
|
4
|
+
import { buildDirectoryTree, detectPackages, detectFrameworks, detectEntryPoints, detectBuildScripts, detectConventions, detectKeyFiles, } from "./analyzers/index.js";
|
|
5
|
+
import { loadCachedCodemap, saveCachedCodemap } from "./storage.js";
|
|
6
|
+
const HASH_FILES = [
|
|
7
|
+
"package.json",
|
|
8
|
+
"package-lock.json",
|
|
9
|
+
"tsconfig.json",
|
|
10
|
+
"go.mod",
|
|
11
|
+
"go.sum",
|
|
12
|
+
"Cargo.toml",
|
|
13
|
+
"Cargo.lock",
|
|
14
|
+
"pyproject.toml",
|
|
15
|
+
"composer.json",
|
|
16
|
+
"composer.lock",
|
|
17
|
+
"pom.xml",
|
|
18
|
+
"build.gradle",
|
|
19
|
+
"build.gradle.kts",
|
|
20
|
+
];
|
|
21
|
+
export function computeContentHash(cwd) {
|
|
22
|
+
const hash = createHash("sha256");
|
|
23
|
+
for (const file of HASH_FILES) {
|
|
24
|
+
try {
|
|
25
|
+
hash.update(readFileSync(join(cwd, file), "utf-8"));
|
|
26
|
+
}
|
|
27
|
+
catch {
|
|
28
|
+
// absent
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
try {
|
|
32
|
+
const entries = readdirSync(cwd).sort();
|
|
33
|
+
hash.update(entries.join("\n"));
|
|
34
|
+
}
|
|
35
|
+
catch {
|
|
36
|
+
// absent
|
|
37
|
+
}
|
|
38
|
+
return hash.digest("hex").substring(0, 16);
|
|
39
|
+
}
|
|
40
|
+
export function generateCodemap(cwd, projectId, projectName) {
|
|
41
|
+
const directoryTree = buildDirectoryTree(cwd);
|
|
42
|
+
const packages = detectPackages(cwd);
|
|
43
|
+
const frameworks = detectFrameworks(packages);
|
|
44
|
+
const entryPoints = detectEntryPoints(cwd, packages);
|
|
45
|
+
const buildScripts = detectBuildScripts(cwd);
|
|
46
|
+
const conventions = detectConventions(cwd);
|
|
47
|
+
const keyFiles = detectKeyFiles(cwd);
|
|
48
|
+
return {
|
|
49
|
+
projectId,
|
|
50
|
+
projectName,
|
|
51
|
+
generatedAt: new Date().toISOString(),
|
|
52
|
+
contentHash: computeContentHash(cwd),
|
|
53
|
+
directoryTree,
|
|
54
|
+
packages,
|
|
55
|
+
frameworks,
|
|
56
|
+
entryPoints,
|
|
57
|
+
buildScripts,
|
|
58
|
+
conventions,
|
|
59
|
+
keyFiles,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
export function getOrGenerateCodemap(cwd, projectId, projectName, baseDir) {
|
|
63
|
+
const cached = loadCachedCodemap(projectId, baseDir);
|
|
64
|
+
if (cached) {
|
|
65
|
+
const currentHash = computeContentHash(cwd);
|
|
66
|
+
if (cached.contentHash === currentHash) {
|
|
67
|
+
return { codemap: cached.data, fromCache: true, stale: false };
|
|
68
|
+
}
|
|
69
|
+
return { codemap: cached.data, fromCache: true, stale: true };
|
|
70
|
+
}
|
|
71
|
+
const codemap = generateCodemap(cwd, projectId, projectName);
|
|
72
|
+
const entry = {
|
|
73
|
+
data: codemap,
|
|
74
|
+
contentHash: codemap.contentHash,
|
|
75
|
+
createdAt: codemap.generatedAt,
|
|
76
|
+
};
|
|
77
|
+
saveCachedCodemap(projectId, entry, baseDir);
|
|
78
|
+
return { codemap, fromCache: false, stale: false };
|
|
79
|
+
}
|
|
80
|
+
//# sourceMappingURL=codemap-generator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemap-generator.js","sourceRoot":"","sources":["../src/codemap-generator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { CodeMap, CompassState } from "./types.js";
|
|
2
|
+
export interface BeforeAgentStartEvent {
|
|
3
|
+
type: "before_agent_start";
|
|
4
|
+
prompt: string;
|
|
5
|
+
systemPrompt: string;
|
|
6
|
+
}
|
|
7
|
+
export interface InjectionResult {
|
|
8
|
+
systemPrompt: string;
|
|
9
|
+
}
|
|
10
|
+
export declare function buildCodemapInjection(codemap: CodeMap, stale: boolean, maxChars: number): string;
|
|
11
|
+
export declare function handleBeforeAgentStart(event: BeforeAgentStartEvent, state: CompassState, maxChars: number): InjectionResult | undefined;
|
|
12
|
+
//# sourceMappingURL=codemap-injector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemap-injector.d.ts","sourceRoot":"","sources":["../src/codemap-injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGxD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAQR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAY7B"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { formatCodemapMarkdown, truncateCodemap } from "./codemap-formatter.js";
|
|
2
|
+
export function buildCodemapInjection(codemap, stale, maxChars) {
|
|
3
|
+
const markdown = formatCodemapMarkdown(codemap);
|
|
4
|
+
const truncated = truncateCodemap(markdown, maxChars);
|
|
5
|
+
const staleNote = stale
|
|
6
|
+
? "\n\n> This codemap may be outdated. Run `/onboard` to refresh."
|
|
7
|
+
: "";
|
|
8
|
+
return `\n\n${truncated}${staleNote}`;
|
|
9
|
+
}
|
|
10
|
+
export function handleBeforeAgentStart(event, state, maxChars) {
|
|
11
|
+
if (state.codemapInjected)
|
|
12
|
+
return undefined;
|
|
13
|
+
if (!state.cachedCodemap)
|
|
14
|
+
return undefined;
|
|
15
|
+
const block = buildCodemapInjection(state.cachedCodemap.data, state.stale, maxChars);
|
|
16
|
+
if (!block)
|
|
17
|
+
return undefined;
|
|
18
|
+
return { systemPrompt: event.systemPrompt + block };
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=codemap-injector.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"codemap-injector.js","sourceRoot":"","sources":["../src/codemap-injector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAYhF,MAAM,UAAU,qBAAqB,CACnC,OAAgB,EAChB,KAAc,EACd,QAAgB;IAEhB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,KAAK;QACrB,CAAC,CAAC,gEAAgE;QAClE,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO,OAAO,SAAS,GAAG,SAAS,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAA4B,EAC5B,KAAmB,EACnB,QAAgB;IAEhB,IAAI,KAAK,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,CAAC,KAAK,CAAC,aAAa;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,KAAK,GAAG,qBAAqB,CACjC,KAAK,CAAC,aAAa,CAAC,IAAI,EACxB,KAAK,CAAC,KAAK,EACX,QAAQ,CACT,CAAC;IACF,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAE7B,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,GAAG,KAAK,EAAE,CAAC;AACtD,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAQzE"}
|
package/dist/fs-utils.js
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
2
|
+
export function readTextFile(path) {
|
|
3
|
+
try {
|
|
4
|
+
return readFileSync(path, "utf-8");
|
|
5
|
+
}
|
|
6
|
+
catch {
|
|
7
|
+
return null;
|
|
8
|
+
}
|
|
9
|
+
}
|
|
10
|
+
export function readJsonFile(path) {
|
|
11
|
+
const text = readTextFile(path);
|
|
12
|
+
if (text === null)
|
|
13
|
+
return null;
|
|
14
|
+
try {
|
|
15
|
+
return JSON.parse(text);
|
|
16
|
+
}
|
|
17
|
+
catch {
|
|
18
|
+
return null;
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
//# sourceMappingURL=fs-utils.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../src/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,+BAA+B,CAAC;AAgBvC,MAAM,CAAC,OAAO,WAAW,EAAE,EAAE,YAAY,GAAG,IAAI,CAsE/C"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { detectProject } from "./project.js";
|
|
2
|
+
import { ensureStorageLayout, loadCachedCodemap } from "./storage.js";
|
|
3
|
+
import { computeContentHash } from "./codemap-generator.js";
|
|
4
|
+
import { handleBeforeAgentStart as buildInjection, } from "./codemap-injector.js";
|
|
5
|
+
import { handleOnboardCommand, COMMAND_NAME as ONBOARD_CMD } from "./onboard-command.js";
|
|
6
|
+
import { handleTourCommand, COMMAND_NAME as TOUR_CMD } from "./tour-command.js";
|
|
7
|
+
import { registerOnboardTools } from "./onboard-tools.js";
|
|
8
|
+
const DEFAULT_MAX_INJECTION_CHARS = 6000;
|
|
9
|
+
export default function (pi) {
|
|
10
|
+
let state = {
|
|
11
|
+
project: null,
|
|
12
|
+
turnCount: 0,
|
|
13
|
+
codemapInjected: false,
|
|
14
|
+
cachedCodemap: null,
|
|
15
|
+
stale: false,
|
|
16
|
+
};
|
|
17
|
+
const stateRef = {
|
|
18
|
+
get: () => state,
|
|
19
|
+
set: (s) => { state = s; },
|
|
20
|
+
};
|
|
21
|
+
pi.on("session_start", async (_event, ctx) => {
|
|
22
|
+
try {
|
|
23
|
+
const project = await detectProject(pi, ctx.cwd);
|
|
24
|
+
ensureStorageLayout(project.id);
|
|
25
|
+
const cached = loadCachedCodemap(project.id);
|
|
26
|
+
let stale = false;
|
|
27
|
+
if (cached) {
|
|
28
|
+
const currentHash = computeContentHash(project.root);
|
|
29
|
+
stale = cached.contentHash !== currentHash;
|
|
30
|
+
}
|
|
31
|
+
state = { ...state, project, cachedCodemap: cached, stale };
|
|
32
|
+
registerOnboardTools(pi, stateRef);
|
|
33
|
+
}
|
|
34
|
+
catch (err) {
|
|
35
|
+
console.error("[pi-compass] session_start error:", err);
|
|
36
|
+
}
|
|
37
|
+
});
|
|
38
|
+
pi.on("before_agent_start", (event, _ctx) => {
|
|
39
|
+
try {
|
|
40
|
+
if (!state.project)
|
|
41
|
+
return;
|
|
42
|
+
const result = buildInjection(event, state, DEFAULT_MAX_INJECTION_CHARS);
|
|
43
|
+
if (result) {
|
|
44
|
+
state = { ...state, codemapInjected: true };
|
|
45
|
+
return result;
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
catch (err) {
|
|
49
|
+
console.error("[pi-compass] before_agent_start error:", err);
|
|
50
|
+
}
|
|
51
|
+
});
|
|
52
|
+
pi.on("turn_end", (_event, _ctx) => {
|
|
53
|
+
try {
|
|
54
|
+
state = { ...state, turnCount: state.turnCount + 1 };
|
|
55
|
+
}
|
|
56
|
+
catch (err) {
|
|
57
|
+
console.error("[pi-compass] turn_end error:", err);
|
|
58
|
+
}
|
|
59
|
+
});
|
|
60
|
+
pi.registerCommand(ONBOARD_CMD, {
|
|
61
|
+
description: "Generate a structured codebase map for the current project",
|
|
62
|
+
handler: (args, ctx) => handleOnboardCommand(args, ctx, pi, stateRef),
|
|
63
|
+
});
|
|
64
|
+
pi.registerCommand(TOUR_CMD, {
|
|
65
|
+
description: "Take a guided tour of a specific area of the codebase",
|
|
66
|
+
handler: (args, ctx) => handleTourCommand(args, ctx, pi, stateRef),
|
|
67
|
+
});
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
|
|
2
|
+
import type { StateRef } from "./types.js";
|
|
3
|
+
export declare const COMMAND_NAME = "onboard";
|
|
4
|
+
export declare function handleOnboardCommand(args: string, ctx: ExtensionCommandContext, pi: ExtensionAPI, stateRef: StateRef): Promise<void>;
|
|
5
|
+
//# sourceMappingURL=onboard-command.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"onboard-command.d.ts","sourceRoot":"","sources":["../src/onboard-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,QAAQ,EAAuB,MAAM,YAAY,CAAC;AAEhE,eAAO,MAAM,YAAY,YAAY,CAAC;AAEtC,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,uBAAuB,EAC5B,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Cf"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { generateCodemap } from "./codemap-generator.js";
|
|
2
|
+
import { formatCodemapMarkdown } from "./codemap-formatter.js";
|
|
3
|
+
import { saveCachedCodemap } from "./storage.js";
|
|
4
|
+
export const COMMAND_NAME = "onboard";
|
|
5
|
+
export async function handleOnboardCommand(args, ctx, pi, stateRef) {
|
|
6
|
+
const state = stateRef.get();
|
|
7
|
+
if (!state.project) {
|
|
8
|
+
ctx.ui.notify("No project detected. Run from within a git repository.", "error");
|
|
9
|
+
return;
|
|
10
|
+
}
|
|
11
|
+
const forceRefresh = args.trim() === "--refresh";
|
|
12
|
+
if (!forceRefresh && state.cachedCodemap && !state.stale) {
|
|
13
|
+
const markdown = formatCodemapMarkdown(state.cachedCodemap.data);
|
|
14
|
+
pi.sendUserMessage(`Here is the cached codebase map for ${state.project.name}:\n\n${markdown}`, { deliverAs: "followUp" });
|
|
15
|
+
return;
|
|
16
|
+
}
|
|
17
|
+
const codemap = generateCodemap(state.project.root, state.project.id, state.project.name);
|
|
18
|
+
const entry = {
|
|
19
|
+
data: codemap,
|
|
20
|
+
contentHash: codemap.contentHash,
|
|
21
|
+
createdAt: codemap.generatedAt,
|
|
22
|
+
};
|
|
23
|
+
saveCachedCodemap(state.project.id, entry);
|
|
24
|
+
stateRef.set({
|
|
25
|
+
...state,
|
|
26
|
+
cachedCodemap: entry,
|
|
27
|
+
stale: false,
|
|
28
|
+
codemapInjected: false,
|
|
29
|
+
});
|
|
30
|
+
const markdown = formatCodemapMarkdown(codemap);
|
|
31
|
+
pi.sendUserMessage(`Here is the codebase map for ${state.project.name}:\n\n${markdown}`, { deliverAs: "followUp" });
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=onboard-command.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"onboard-command.js","sourceRoot":"","sources":["../src/onboard-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,GAA4B,EAC5B,EAAgB,EAChB,QAAkB;IAElB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,wDAAwD,EAAE,OAAO,CAAC,CAAC;QACjF,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,WAAW,CAAC;IAEjD,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACzD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACjE,EAAE,CAAC,eAAe,CAChB,uCAAuC,KAAK,CAAC,OAAO,CAAC,IAAI,QAAQ,QAAQ,EAAE,EAC3E,EAAE,SAAS,EAAE,UAAU,EAAE,CAC1B,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,EAClB,KAAK,CAAC,OAAO,CAAC,EAAE,EAChB,KAAK,CAAC,OAAO,CAAC,IAAI,CACnB,CAAC;IAEF,MAAM,KAAK,GAAwB;QACjC,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,WAAW;KAC/B,CAAC;IACF,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAE3C,QAAQ,CAAC,GAAG,CAAC;QACX,GAAG,KAAK;QACR,aAAa,EAAE,KAAK;QACpB,KAAK,EAAE,KAAK;QACZ,eAAe,EAAE,KAAK;KACvB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,EAAE,CAAC,eAAe,CAChB,gCAAgC,KAAK,CAAC,OAAO,CAAC,IAAI,QAAQ,QAAQ,EAAE,EACpE,EAAE,SAAS,EAAE,UAAU,EAAE,CAC1B,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"onboard-tools.d.ts","sourceRoot":"","sources":["../src/onboard-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAiG3C,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,YAAY,EAChB,QAAQ,EAAE,QAAQ,GACjB,IAAI,CAaN"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import { Type } from "@sinclair/typebox";
|
|
2
|
+
import { getOrGenerateCodemap } from "./codemap-generator.js";
|
|
3
|
+
import { formatCodemapMarkdown } from "./codemap-formatter.js";
|
|
4
|
+
import { detectAvailableTopics, getOrGenerateTour, formatTourMarkdown } from "./tour-generator.js";
|
|
5
|
+
const CodemapParams = Type.Object({});
|
|
6
|
+
const TourParams = Type.Object({
|
|
7
|
+
topic: Type.Optional(Type.String({ description: "Tour topic (e.g., 'auth', 'api', 'testing'). Omit to list available topics." })),
|
|
8
|
+
});
|
|
9
|
+
function createCodemapTool(stateRef) {
|
|
10
|
+
return {
|
|
11
|
+
name: "codebase_map",
|
|
12
|
+
label: "Codebase Map",
|
|
13
|
+
description: "Returns a structured map of the current codebase including directory tree, packages, frameworks, entry points, build scripts, and conventions",
|
|
14
|
+
promptSnippet: "Get or generate a structured map of the current codebase",
|
|
15
|
+
parameters: CodemapParams,
|
|
16
|
+
async execute(_toolCallId, _params, _signal, _onUpdate, _ctx) {
|
|
17
|
+
const state = stateRef.get();
|
|
18
|
+
if (!state.project) {
|
|
19
|
+
throw new Error("No project detected.");
|
|
20
|
+
}
|
|
21
|
+
const { codemap } = getOrGenerateCodemap(state.project.root, state.project.id, state.project.name);
|
|
22
|
+
const markdown = formatCodemapMarkdown(codemap);
|
|
23
|
+
return {
|
|
24
|
+
content: [{ type: "text", text: markdown }],
|
|
25
|
+
details: { projectId: codemap.projectId, contentHash: codemap.contentHash },
|
|
26
|
+
};
|
|
27
|
+
},
|
|
28
|
+
};
|
|
29
|
+
}
|
|
30
|
+
function createTourTool(stateRef) {
|
|
31
|
+
return {
|
|
32
|
+
name: "code_tour",
|
|
33
|
+
label: "Code Tour",
|
|
34
|
+
description: "Returns a guided walkthrough of a specific area of the codebase, or lists available topics",
|
|
35
|
+
promptSnippet: "Get a guided code tour for a specific topic or area",
|
|
36
|
+
parameters: TourParams,
|
|
37
|
+
async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
|
|
38
|
+
const state = stateRef.get();
|
|
39
|
+
if (!state.project) {
|
|
40
|
+
throw new Error("No project detected.");
|
|
41
|
+
}
|
|
42
|
+
const codemap = state.cachedCodemap?.data
|
|
43
|
+
?? getOrGenerateCodemap(state.project.root, state.project.id, state.project.name).codemap;
|
|
44
|
+
if (!params.topic) {
|
|
45
|
+
const topics = detectAvailableTopics(state.project.root, codemap);
|
|
46
|
+
return {
|
|
47
|
+
content: [{
|
|
48
|
+
type: "text",
|
|
49
|
+
text: topics.length > 0
|
|
50
|
+
? `Available tour topics: ${topics.join(", ")}`
|
|
51
|
+
: "No tour topics detected.",
|
|
52
|
+
}],
|
|
53
|
+
details: { topics },
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
const tour = getOrGenerateTour(state.project.root, params.topic, codemap, state.project.id);
|
|
57
|
+
return {
|
|
58
|
+
content: [{ type: "text", text: formatTourMarkdown(tour) }],
|
|
59
|
+
details: { topic: tour.topic, steps: tour.steps.length },
|
|
60
|
+
};
|
|
61
|
+
},
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
export function registerOnboardTools(pi, stateRef) {
|
|
65
|
+
const guidelines = [
|
|
66
|
+
"Use codebase_map to understand the overall project structure. Use code_tour to walk through specific areas in detail.",
|
|
67
|
+
];
|
|
68
|
+
pi.registerTool({
|
|
69
|
+
...createCodemapTool(stateRef),
|
|
70
|
+
promptGuidelines: guidelines,
|
|
71
|
+
});
|
|
72
|
+
pi.registerTool({
|
|
73
|
+
...createTourTool(stateRef),
|
|
74
|
+
promptGuidelines: guidelines,
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=onboard-tools.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"onboard-tools.js","sourceRoot":"","sources":["../src/onboard-tools.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C,wBAAsB,aAAa,CACjC,EAAE,EAAE,YAAY,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,CAAC,CAgBtB"}
|
package/dist/project.js
ADDED
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import { basename } from "node:path";
|
|
3
|
+
function hashString(input) {
|
|
4
|
+
return createHash("sha256").update(input).digest("hex").substring(0, 12);
|
|
5
|
+
}
|
|
6
|
+
export async function detectProject(pi, cwd) {
|
|
7
|
+
const name = basename(cwd);
|
|
8
|
+
const remoteResult = await pi.exec("git", ["remote", "get-url", "origin"], { cwd });
|
|
9
|
+
if (remoteResult.code === 0) {
|
|
10
|
+
const remote = remoteResult.stdout.trim();
|
|
11
|
+
return { id: hashString(remote), name, root: cwd, remote };
|
|
12
|
+
}
|
|
13
|
+
const rootResult = await pi.exec("git", ["rev-parse", "--show-toplevel"], { cwd });
|
|
14
|
+
if (rootResult.code === 0) {
|
|
15
|
+
const root = rootResult.stdout.trim();
|
|
16
|
+
return { id: hashString(root), name, root, remote: "" };
|
|
17
|
+
}
|
|
18
|
+
return { id: "global", name, root: cwd, remote: "" };
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=project.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAgB,EAChB,GAAW;IAEX,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE3B,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACpF,IAAI,YAAY,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACnF,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACvD,CAAC"}
|