grounder 0.0.1 → 0.1.0

package/dist/commands/require-linked.d.ts

@@ -0,0 +1,7 @@
+import { type LinkedProject } from "../connector/linked.js";
+/**
+ * Resolves the linked project for CLI commands.
+ * Writes the standard stderr hints and returns `null` on failure.
+ */
+export declare function requireLinkedProject(cwd: string): Promise<LinkedProject | null>;
+//# sourceMappingURL=require-linked.d.ts.map

package/dist/commands/require-linked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-linked.d.ts","sourceRoot":"","sources":["../../src/commands/require-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,wBAAwB,CAAC;AAElF;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWrF"}

package/dist/commands/require-linked.js

@@ -0,0 +1,19 @@
+import { resolveLinkedProject } from "../connector/linked.js";
+/**
+ * Resolves the linked project for CLI commands.
+ * Writes the standard stderr hints and returns `null` on failure.
+ */
+export async function requireLinkedProject(cwd) {
+    const result = await resolveLinkedProject(cwd);
+    if (!result.ok) {
+        if (result.error === "no-vault") {
+            process.stderr.write("No vault configured. Run: grounder vault init <path>\n");
+        }
+        else {
+            process.stderr.write("Folder not linked. Run: grounder init\n");
+        }
+        return null;
+    }
+    return result.value;
+}
+//# sourceMappingURL=require-linked.js.map

package/dist/commands/require-linked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-linked.js","sourceRoot":"","sources":["../../src/commands/require-linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}

package/dist/commands/status.d.ts

@@ -0,0 +1,7 @@
+export interface StatusOptions {
+    cwd?: string;
+    homeDir?: string;
+}
+export declare function runStatus(_argv: string[]): Promise<number>;
+export declare function runStatusWithOptions(options?: StatusOptions): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA8CD,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAgEvF"}

package/dist/commands/status.js

@@ -0,0 +1,101 @@
+import path from "node:path";
+import { currentBranch, findGitRoot } from "../connector/git.js";
+import { homeConfigPath, readHomeConfig, withHomeDir } from "../connector/home.js";
+import { findLinkedRepoRoot, readRepoConfig, repoConfigPath, } from "../connector/repo.js";
+import { resolveLogsDir, resolveNotesDir, resolveVaultRoot } from "../connector/vault.js";
+const LABEL_WIDTH = 12;
+const VAULT_INIT = "grounder vault init <path>";
+const REPO_INIT = "grounder init";
+const REPO_INIT_FORCE = "grounder init --force";
+function section(title) {
+    return `${title}\n`;
+}
+function statusLine(label, value) {
+    return `  ${label.padEnd(LABEL_WIDTH)}${value}\n`;
+}
+function errorDetail(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function writeGitLine(gitRoot) {
+    if (!gitRoot) {
+        return;
+    }
+    const branch = await currentBranch(gitRoot);
+    const gitValue = branch !== undefined ? `${gitRoot}  (branch: ${branch})` : gitRoot;
+    process.stdout.write(statusLine("Git:", gitValue));
+}
+async function tryReadHome() {
+    try {
+        return { home: await readHomeConfig(), invalid: null };
+    }
+    catch (error) {
+        return { home: null, invalid: errorDetail(error) };
+    }
+}
+async function tryReadRepo(linkedRoot) {
+    try {
+        return { repo: await readRepoConfig(linkedRoot), invalid: null };
+    }
+    catch (error) {
+        return { repo: null, invalid: errorDetail(error) };
+    }
+}
+export async function runStatus(_argv) {
+    return runStatusWithOptions({});
+}
+export async function runStatusWithOptions(options = {}) {
+    return withHomeDir(options.homeDir, async () => {
+        const cwd = path.resolve(options.cwd ?? process.cwd());
+        const { home, invalid: homeInvalid } = await tryReadHome();
+        const gitRoot = await findGitRoot(cwd);
+        const linkedRoot = await findLinkedRepoRoot(cwd, gitRoot);
+        const { repo, invalid: repoInvalid } = linkedRoot
+            ? await tryReadRepo(linkedRoot)
+            : { repo: null, invalid: null };
+        process.stdout.write(section("Machine"));
+        if (homeInvalid) {
+            process.stdout.write(statusLine("Config:", `invalid → run: ${VAULT_INIT}`));
+        }
+        else if (!home) {
+            process.stdout.write(statusLine("Config:", `missing → run: ${VAULT_INIT}`));
+        }
+        else {
+            process.stdout.write(statusLine("Config:", homeConfigPath()));
+            process.stdout.write(statusLine("Vault:", resolveVaultRoot(home)));
+        }
+        process.stdout.write("\n");
+        process.stdout.write(section("Project"));
+        if (!linkedRoot) {
+            process.stdout.write(statusLine("Linked:", "no"));
+            if (home) {
+                process.stdout.write(statusLine("Config:", `missing → run: ${REPO_INIT}`));
+            }
+            return 0;
+        }
+        if (repoInvalid || !repo) {
+            const fix = home ? REPO_INIT_FORCE : VAULT_INIT;
+            process.stdout.write(statusLine("Linked:", `incomplete → run: ${fix}`));
+            process.stdout.write(statusLine("Folder:", linkedRoot));
+            process.stdout.write(statusLine("Config:", repoInvalid ? `invalid → run: ${REPO_INIT_FORCE}` : `missing → run: ${REPO_INIT}`));
+            await writeGitLine(gitRoot);
+            return 0;
+        }
+        if (!home) {
+            process.stdout.write(statusLine("Linked:", `incomplete → run: ${VAULT_INIT}`));
+            process.stdout.write(statusLine("Folder:", linkedRoot));
+            process.stdout.write(statusLine("Config:", repoConfigPath(linkedRoot)));
+            process.stdout.write(statusLine("Id:", repo.projectId));
+            await writeGitLine(gitRoot);
+            return 0;
+        }
+        process.stdout.write(statusLine("Linked:", "yes"));
+        process.stdout.write(statusLine("Folder:", linkedRoot));
+        process.stdout.write(statusLine("Config:", repoConfigPath(linkedRoot)));
+        process.stdout.write(statusLine("Id:", repo.projectId));
+        process.stdout.write(statusLine("Notes:", resolveNotesDir(home, repo)));
+        process.stdout.write(statusLine("Logs:", resolveLogsDir(home, repo)));
+        await writeGitLine(gitRoot);
+        return 0;
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAmB,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACpG,OAAO,EACL,kBAAkB,EAElB,cAAc,EACd,cAAc,GACf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAO1F,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAChD,MAAM,SAAS,GAAG,eAAe,CAAC;AAClC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,GAAG,KAAK,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa;IAC9C,OAAO,KAAK,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,OAAsB;IAChD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,cAAc,MAAM,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;IACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACzD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,UAAkB;IAElB,IAAI,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;IACrD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAe;IAC7C,OAAO,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAyB,EAAE;IACpE,OAAO,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,WAAW,EAAE,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,UAAU;YAC/C,CAAC,CAAC,MAAM,WAAW,CAAC,UAAU,CAAC;YAC/B,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAElC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACzC,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,kBAAkB,UAAU,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;aAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,kBAAkB,UAAU,EAAE,CAAC,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC;YAC9D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QAEzC,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;YAClD,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,kBAAkB,SAAS,EAAE,CAAC,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,qBAAqB,GAAG,EAAE,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,UAAU,CACR,SAAS,EACT,WAAW,CAAC,CAAC,CAAC,kBAAkB,eAAe,EAAE,CAAC,CAAC,CAAC,kBAAkB,SAAS,EAAE,CAClF,CACF,CAAC;YACF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,qBAAqB,UAAU,EAAE,CAAC,CAAC,CAAC;YAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YACxD,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;QAE5B,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commands/vault/init.d.ts

@@ -0,0 +1,11 @@
+export interface VaultInitOptions {
+    vaultPath: string;
+    yes?: boolean;
+    force?: boolean;
+    homeDir?: string;
+    /** Agent ids to install for. Defaults to auto-detecting installed agents. */
+    agents?: string[];
+}
+export declare function runVaultInit(argv: string[]): Promise<number>;
+export declare function runVaultInitWithOptions(options: VaultInitOptions): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/vault/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/vault/init.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBlE;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DxF"}

package/dist/commands/vault/init.js

@@ -0,0 +1,73 @@
+import { mkdir } from "node:fs/promises";
+import { resolveAgents } from "../../agents/index.js";
+import { homeConfigPath, readHomeConfig, withHomeDir, writeHomeConfig, } from "../../connector/home.js";
+import { flagBool, flagStrings, parseArgs } from "../../util/parse-args.js";
+import { resolveUserPath } from "../../util/path.js";
+import { confirm } from "../../util/prompt.js";
+import { projectsParent } from "../../vault/layout.js";
+export async function runVaultInit(argv) {
+    const { positional, flags, repeated } = parseArgs(argv);
+    const vaultPathArg = positional[0];
+    const yes = flagBool(flags, "yes", "y");
+    const force = flagBool(flags, "force", "f");
+    const agents = flagStrings(repeated, "agent");
+    if (!vaultPathArg) {
+        process.stderr.write("Usage: grounder vault init <path>\n");
+        return 1;
+    }
+    return runVaultInitWithOptions({
+        vaultPath: vaultPathArg,
+        yes,
+        force,
+        agents: agents.length > 0 ? agents : undefined,
+    });
+}
+export async function runVaultInitWithOptions(options) {
+    return withHomeDir(options.homeDir, async () => {
+        const vaultRoot = resolveUserPath(options.vaultPath);
+        const yes = options.yes ?? false;
+        const force = options.force ?? false;
+        const homeDir = options.homeDir;
+        const existingHome = await readHomeConfig();
+        const projectsDir = projectsParent(vaultRoot);
+        const agents = await resolveAgents(options.agents);
+        if (existingHome && existingHome.vaultRoot !== vaultRoot && !force) {
+            process.stderr.write(`Home config already exists with vault ${existingHome.vaultRoot}. Use --force to overwrite.\n`);
+            return 1;
+        }
+        process.stdout.write(`Vault root: ${vaultRoot}\n`);
+        process.stdout.write("Will write:\n");
+        process.stdout.write(`  home   ${homeConfigPath(homeDir)}\n`);
+        process.stdout.write("  vault  10-Projects/ (if missing)\n");
+        for (const agent of agents) {
+            process.stdout.write(`  ${agent.id.padEnd(8)} (${agent.name} artifacts)\n`);
+        }
+        if (agents.length === 0) {
+            process.stdout.write("  (no supported agents detected — skipping agent artifacts)\n");
+        }
+        process.stdout.write("\n");
+        if (!yes) {
+            const proceed = await confirm("Proceed?");
+            if (!proceed) {
+                process.stdout.write("Aborted.\n");
+                return 0;
+            }
+        }
+        await writeHomeConfig({ vaultRoot });
+        await mkdir(projectsDir, { recursive: true });
+        process.stdout.write("✓ Wrote home config\n");
+        process.stdout.write(`✓ Vault scaffold: ${projectsDir}\n`);
+        for (const agent of agents) {
+            const result = await agent.install({ force, homeDir });
+            for (const [artifactPath, status] of Object.entries(result.artifacts)) {
+                const label = status === "skipped" ? "already exists (skipped)" : `installed: ${artifactPath}`;
+                process.stdout.write(`✓ ${agent.name} command ${label}\n`);
+            }
+            if (Object.keys(result.artifacts).length === 0) {
+                process.stdout.write(`✓ ${agent.name}: no artifacts to install yet\n`);
+            }
+        }
+        return 0;
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/vault/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/commands/vault/init.ts"],"names":[],"mappings":"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"}

package/dist/connector/git.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Walks upward from `startDir` looking for a `.git` entry.
+ * @returns Absolute git root, or `null` if none is found.
+ */
+export declare function findGitRoot(startDir: string): Promise<string | null>;
+/**
+ * Best-effort branch name via `git rev-parse --abbrev-ref HEAD`.
+ * @returns Branch name, or `undefined` if git fails / output is empty
+ *   / detached HEAD (`abbrev-ref` prints `HEAD`), etc.
+ */
+export declare function currentBranch(gitRoot: string): Promise<string | undefined>;
+//# sourceMappingURL=git.d.ts.map

package/dist/connector/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/connector/git.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAc1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAchF"}

package/dist/connector/git.js

@@ -0,0 +1,53 @@
+import { execFile } from "node:child_process";
+import { access } from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+async function isGitRoot(dir) {
+    try {
+        await access(path.join(dir, ".git"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Walks upward from `startDir` looking for a `.git` entry.
+ * @returns Absolute git root, or `null` if none is found.
+ */
+export async function findGitRoot(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        if (await isGitRoot(current)) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+/**
+ * Best-effort branch name via `git rev-parse --abbrev-ref HEAD`.
+ * @returns Branch name, or `undefined` if git fails / output is empty
+ *   / detached HEAD (`abbrev-ref` prints `HEAD`), etc.
+ */
+export async function currentBranch(gitRoot) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+            cwd: gitRoot,
+            encoding: "utf8",
+        });
+        const branch = String(stdout).trim();
+        if (!branch || branch === "HEAD") {
+            return undefined;
+        }
+        return branch;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/connector/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/connector/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,MAAM,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;YACnF,GAAG,EAAE,OAAO;YACZ,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACjC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/connector/home.d.ts

@@ -0,0 +1,13 @@
+export interface HomeConfig {
+    vaultRoot: string;
+}
+export declare function resolveHomeDir(override?: string): string;
+export declare function homeConfigPath(homeDir?: string): string;
+/**
+ * Runs `fn` with home config resolved under `homeDir` (for tests/sandboxing).
+ * Sets `GROUNDER_HOME` for the call, then restores it. No-op if `homeDir` is unset.
+ */
+export declare function withHomeDir<T>(homeDir: string | undefined, fn: () => Promise<T>): Promise<T>;
+export declare function readHomeConfig(): Promise<HomeConfig | null>;
+export declare function writeHomeConfig(config: HomeConfig): Promise<void>;
+//# sourceMappingURL=home.d.ts.map

package/dist/connector/home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../src/connector/home.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC,CAgBZ;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjE;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvE"}

package/dist/connector/home.js

@@ -0,0 +1,52 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileExists } from "../util/fs.js";
+export function resolveHomeDir(override) {
+    if (override) {
+        return override;
+    }
+    return process.env.GROUNDER_HOME ?? os.homedir();
+}
+export function homeConfigPath(homeDir) {
+    return path.join(resolveHomeDir(homeDir), ".grounder", "config.json");
+}
+/**
+ * Runs `fn` with home config resolved under `homeDir` (for tests/sandboxing).
+ * Sets `GROUNDER_HOME` for the call, then restores it. No-op if `homeDir` is unset.
+ */
+export async function withHomeDir(homeDir, fn) {
+    if (!homeDir) {
+        return fn();
+    }
+    const previous = process.env.GROUNDER_HOME;
+    process.env.GROUNDER_HOME = homeDir;
+    try {
+        return await fn();
+    }
+    finally {
+        if (previous === undefined) {
+            delete process.env.GROUNDER_HOME;
+        }
+        else {
+            process.env.GROUNDER_HOME = previous;
+        }
+    }
+}
+export async function readHomeConfig() {
+    const configPath = homeConfigPath();
+    if (!(await fileExists(configPath))) {
+        return null;
+    }
+    const raw = JSON.parse(await readFile(configPath, "utf8"));
+    if (typeof raw.vaultRoot !== "string" || raw.vaultRoot.length === 0) {
+        throw new Error(`Invalid home config at ${configPath}: missing vaultRoot`);
+    }
+    return { vaultRoot: raw.vaultRoot };
+}
+export async function writeHomeConfig(config) {
+    const configPath = homeConfigPath();
+    await mkdir(path.dirname(configPath), { recursive: true });
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+//# sourceMappingURL=home.js.map

package/dist/connector/home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/connector/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM3C,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAA2B,EAC3B,EAAoB;IAEpB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,QAAQ,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAwB,CAAC;IAClF,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,qBAAqB,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAkB;IACtD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC"}

package/dist/connector/linked.d.ts

@@ -0,0 +1,25 @@
+import { type HomeConfig } from "./home.js";
+import { type RepoConfig } from "./repo.js";
+/** Home config + linked repo marker resolved from a cwd. */
+export interface LinkedProject {
+    home: HomeConfig;
+    repo: RepoConfig;
+    /** Directory that contains `.grounder.json`. */
+    linkedRoot: string;
+    /** Nearest git root when present. */
+    gitRoot: string | null;
+}
+export type LinkedProjectError = "no-vault" | "not-linked";
+export type ResolveLinkedProjectResult = {
+    ok: true;
+    value: LinkedProject;
+} | {
+    ok: false;
+    error: LinkedProjectError;
+};
+/**
+ * Resolves home vault config and the linked project marker for `cwd`.
+ * Does not write to stderr — callers map {@link LinkedProjectError} to UX.
+ */
+export declare function resolveLinkedProject(cwd: string): Promise<ResolveLinkedProjectResult>;
+//# sourceMappingURL=linked.d.ts.map

package/dist/connector/linked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked.d.ts","sourceRoot":"","sources":["../../src/connector/linked.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAsB,KAAK,UAAU,EAAkB,MAAM,WAAW,CAAC;AAEhF,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,YAAY,CAAC;AAE3D,MAAM,MAAM,0BAA0B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAE7C;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAkB3F"}

package/dist/connector/linked.js

@@ -0,0 +1,24 @@
+import { findGitRoot } from "./git.js";
+import { readHomeConfig } from "./home.js";
+import { findLinkedRepoRoot, readRepoConfig } from "./repo.js";
+/**
+ * Resolves home vault config and the linked project marker for `cwd`.
+ * Does not write to stderr — callers map {@link LinkedProjectError} to UX.
+ */
+export async function resolveLinkedProject(cwd) {
+    const home = await readHomeConfig();
+    if (!home) {
+        return { ok: false, error: "no-vault" };
+    }
+    const gitRoot = await findGitRoot(cwd);
+    const linkedRoot = await findLinkedRepoRoot(cwd, gitRoot);
+    if (!linkedRoot) {
+        return { ok: false, error: "not-linked" };
+    }
+    const repo = await readRepoConfig(linkedRoot);
+    if (!repo) {
+        return { ok: false, error: "not-linked" };
+    }
+    return { ok: true, value: { home, repo, linkedRoot, gitRoot } };
+}
+//# sourceMappingURL=linked.js.map

package/dist/connector/linked.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked.js","sourceRoot":"","sources":["../../src/connector/linked.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAmB,cAAc,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAmB,cAAc,EAAE,MAAM,WAAW,CAAC;AAkBhF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW;IACpD,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;AAClE,CAAC"}

package/dist/connector/project-id.d.ts

@@ -0,0 +1,17 @@
+export type ProjectIdSource = "flag" | "package.json" | "git-remote" | "basename";
+export interface DetectedProjectId {
+    id: string;
+    source: ProjectIdSource;
+}
+/**
+ * Detects the project id for a given link root.
+ * Tries to detect it from the package.json, git remote, and folder name.
+ *
+ * @param linkRoot - The root directory of the link.
+ * @param override - An optional project id to use instead of detecting one.
+ * @param gitRoot - An optional git root to use instead of detecting one.
+ * @returns The detected project id.
+ */
+export declare function detectProjectId(linkRoot: string, override?: string, gitRoot?: string | null): Promise<DetectedProjectId>;
+export declare function formatProjectIdSource(source: ProjectIdSource): string;
+//# sourceMappingURL=project-id.d.ts.map

package/dist/connector/project-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.d.ts","sourceRoot":"","sources":["../../src/connector/project-id.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,eAAe,CAAC;CACzB;AAkDD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAmC5B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAWrE"}

package/dist/connector/project-id.js

@@ -0,0 +1,102 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { sanitizeProjectId } from "../util/project-id.js";
+async function readPackageName(repoRoot) {
+    const packagePath = path.join(repoRoot, "package.json");
+    try {
+        const raw = JSON.parse(await readFile(packagePath, "utf8"));
+        return typeof raw.name === "string" && raw.name.length > 0 ? raw.name : null;
+    }
+    catch {
+        return null;
+    }
+}
+function parseRemoteSlug(url) {
+    const trimmed = url.trim();
+    const scpMatch = /^[^@]+@[^:]+:(.+)$/.exec(trimmed);
+    const rawPath = scpMatch ? scpMatch[1] : trimmed.replace(/^[^:]+:\/\//, "");
+    const lastSegment = rawPath.split("/").filter(Boolean).pop();
+    if (!lastSegment) {
+        return null;
+    }
+    return lastSegment.replace(/\.git$/i, "");
+}
+async function readGitRemoteSlug(repoRoot) {
+    const configPath = path.join(repoRoot, ".git", "config");
+    try {
+        const contents = await readFile(configPath, "utf8");
+        const lines = contents.split("\n");
+        let inOrigin = false;
+        for (const line of lines) {
+            const section = /^\[remote "(.+)"\]$/.exec(line.trim());
+            if (section) {
+                inOrigin = section[1] === "origin";
+                continue;
+            }
+            if (inOrigin) {
+                const urlMatch = /^\s*url\s*=\s*(.+)$/.exec(line);
+                if (urlMatch) {
+                    return parseRemoteSlug(urlMatch[1]);
+                }
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+/**
+ * Detects the project id for a given link root.
+ * Tries to detect it from the package.json, git remote, and folder name.
+ *
+ * @param linkRoot - The root directory of the link.
+ * @param override - An optional project id to use instead of detecting one.
+ * @param gitRoot - An optional git root to use instead of detecting one.
+ * @returns The detected project id.
+ */
+export async function detectProjectId(linkRoot, override, gitRoot) {
+    if (override) {
+        const id = sanitizeProjectId(override);
+        if (!id) {
+            throw new Error(`Invalid project id: ${override}`);
+        }
+        return { id, source: "flag" };
+    }
+    const packageName = await readPackageName(linkRoot);
+    if (packageName) {
+        const id = sanitizeProjectId(packageName);
+        if (id) {
+            return { id, source: "package.json" };
+        }
+    }
+    if (gitRoot !== null) {
+        const remoteRoot = gitRoot ?? linkRoot;
+        const remoteSlug = await readGitRemoteSlug(remoteRoot);
+        if (remoteSlug) {
+            const id = sanitizeProjectId(remoteSlug);
+            if (id) {
+                return { id, source: "git-remote" };
+            }
+        }
+    }
+    const basename = path.basename(linkRoot);
+    const id = sanitizeProjectId(basename);
+    if (!id) {
+        throw new Error("Could not detect a valid project id");
+    }
+    return { id, source: "basename" };
+}
+export function formatProjectIdSource(source) {
+    switch (source) {
+        case "flag":
+            return "from --id";
+        case "package.json":
+            return "from package.json";
+        case "git-remote":
+            return "from git remote";
+        case "basename":
+            return "from folder name";
+    }
+}
+//# sourceMappingURL=project-id.js.map

package/dist/connector/project-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-id.js","sourceRoot":"","sources":["../../src/connector/project-id.ts"],"names":[],"mappings":"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"}

package/dist/connector/repo.d.ts

@@ -0,0 +1,9 @@
+export interface RepoConfig {
+    version: 1;
+    projectId: string;
+}
+export declare function repoConfigPath(repoRoot: string): string;
+export declare function findLinkedRepoRoot(cwd: string, gitRoot?: string | null): Promise<string | null>;
+export declare function readRepoConfig(repoRoot: string): Promise<RepoConfig | null>;
+export declare function writeRepoConfig(repoRoot: string, config: RepoConfig): Promise<void>;
+//# sourceMappingURL=repo.d.ts.map

package/dist/connector/repo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/connector/repo.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,MAAM,GAAG,IAAW,GAC5B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBxB;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAYjF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzF"}