greplica 0.1.0

package/dist/apps/cli/repo-context.js

@@ -0,0 +1,58 @@
+import { execFileSync } from "node:child_process";
+import { realpathSync } from "node:fs";
+import { basename, resolve } from "node:path";
+export function detectRepoContext(cwd = process.cwd()) {
+    const repoRoot = canonicalPath(gitOptional(cwd, ["rev-parse", "--show-toplevel"]));
+    if (repoRoot === undefined)
+        return folderContext(cwd);
+    const remoteUrl = gitOptional(repoRoot, ["config", "--get", "remote.origin.url"]);
+    return {
+        repo_root: repoRoot,
+        remote_url: remoteUrl,
+        repo_name: remoteUrl === undefined ? basename(repoRoot) : repoName(remoteUrl, repoRoot),
+        default_branch: defaultBranch(repoRoot),
+    };
+}
+function folderContext(cwd) {
+    const folderRoot = canonicalPath(cwd) ?? resolve(cwd);
+    return {
+        repo_root: folderRoot,
+        repo_name: basename(folderRoot),
+        default_branch: "main",
+    };
+}
+function canonicalPath(path) {
+    if (path === undefined)
+        return undefined;
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+function defaultBranch(repoRoot) {
+    const remoteHead = gitOptional(repoRoot, ["symbolic-ref", "--quiet", "--short", "refs/remotes/origin/HEAD"]);
+    if (remoteHead?.startsWith("origin/"))
+        return remoteHead.slice("origin/".length);
+    return "main";
+}
+function repoName(remoteUrl, repoRoot) {
+    const withoutGit = remoteUrl.endsWith(".git") ? remoteUrl.slice(0, -4) : remoteUrl;
+    const lastPart = withoutGit.split(/[/:]/).filter(Boolean).at(-1);
+    return lastPart ?? basename(repoRoot);
+}
+function gitOptional(cwd, args) {
+    try {
+        const output = execFileSync("git", args, {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return output.length > 0 ? output : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=repo-context.js.map

package/dist/apps/cli/repo-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-context.js","sourceRoot":"","sources":["../../../apps/cli/repo-context.ts"],"names":[],"mappings":"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"}

package/dist/libs/agent-runner/codex.d.ts

@@ -0,0 +1,2 @@
+import type { AgentRunInput, AgentRunResult } from "./types.js";
+export declare function runCodexAgent(input: AgentRunInput): Promise<AgentRunResult>;

package/dist/libs/agent-runner/codex.js

@@ -0,0 +1,53 @@
+import { createWriteStream } from "node:fs";
+import { spawn } from "node:child_process";
+import { collectAgentMetrics } from "./metrics.js";
+export async function runCodexAgent(input) {
+    const startedAt = Date.now();
+    const transcript = createWriteStream(input.transcriptPath, { flags: "w" });
+    const result = await runCodexProcess(input, transcript);
+    transcript.end();
+    const elapsedMs = Date.now() - startedAt;
+    const metrics = collectAgentMetrics({
+        transcriptPath: input.transcriptPath,
+    });
+    return {
+        agent: "codex",
+        model: input.model,
+        elapsed_ms: elapsedMs,
+        transcript_path: input.transcriptPath,
+        final_message_path: input.finalMessagePath,
+        exit_code: result.exitCode,
+        signal: result.signal,
+        ...metrics,
+    };
+}
+function runCodexProcess(input, transcript) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("codex", [
+            "--ask-for-approval",
+            "never",
+            "exec",
+            "--json",
+            "--model",
+            input.model,
+            "--cd",
+            input.cwd,
+            "--sandbox",
+            "danger-full-access",
+            "--output-last-message",
+            input.finalMessagePath,
+            "-",
+        ], {
+            cwd: input.cwd,
+            env: input.env,
+            stdio: ["pipe", "pipe", "inherit"],
+        });
+        child.once("error", reject);
+        child.stdout.pipe(transcript);
+        child.stdin.end(input.prompt);
+        child.once("close", (exitCode, signal) => {
+            resolve({ exitCode, signal });
+        });
+    });
+}
+//# sourceMappingURL=codex.js.map

package/dist/libs/agent-runner/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../libs/agent-runner/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAoB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IACxD,UAAU,CAAC,GAAG,EAAE,CAAC;IAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACzC,MAAM,OAAO,GAAG,mBAAmB,CAAC;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;KACrC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,SAAS;QACrB,eAAe,EAAE,KAAK,CAAC,cAAc;QACrC,kBAAkB,EAAE,KAAK,CAAC,gBAAgB;QAC1C,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,OAAO;KACX,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,KAAoB,EACpB,UAAiC;IAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CACjB,OAAO,EACP;YACE,oBAAoB;YACpB,OAAO;YACP,MAAM;YACN,QAAQ;YACR,SAAS;YACT,KAAK,CAAC,KAAK;YACX,MAAM;YACN,KAAK,CAAC,GAAG;YACT,WAAW;YACX,oBAAoB;YACpB,uBAAuB;YACvB,KAAK,CAAC,gBAAgB;YACtB,GAAG;SACJ,EACD;YACE,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;SACnC,CACF,CAAC;QAEF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YACvC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/libs/agent-runner/metrics.d.ts

@@ -0,0 +1,10 @@
+export interface AgentMetricInput {
+    transcriptPath: string;
+}
+export interface AgentMetrics {
+    tool_calls: number;
+    input_tokens: number | null;
+    output_tokens: number | null;
+    total_tokens: number | null;
+}
+export declare function collectAgentMetrics(input: AgentMetricInput): AgentMetrics;

package/dist/libs/agent-runner/metrics.js

@@ -0,0 +1,72 @@
+import { existsSync, readFileSync } from "node:fs";
+export function collectAgentMetrics(input) {
+    const transcript = readOptional(input.transcriptPath);
+    const toolCalls = countToolCalls(transcript);
+    const usage = usageFromTranscript(transcript);
+    const inputTokens = usage?.input_tokens ?? null;
+    const outputTokens = usage?.output_tokens ?? null;
+    return {
+        tool_calls: toolCalls,
+        input_tokens: inputTokens,
+        output_tokens: outputTokens,
+        total_tokens: inputTokens === null || outputTokens === null ? null : inputTokens + outputTokens,
+    };
+}
+function countToolCalls(jsonl) {
+    if (jsonl.trim().length === 0)
+        return 0;
+    let count = 0;
+    for (const line of jsonl.split("\n")) {
+        const event = parseJsonLine(line);
+        if (!event)
+            continue;
+        if (isRecord(event) && event.type === "item.started" && isRecord(event.item) && event.item.type === "command_execution") {
+            count += 1;
+            continue;
+        }
+        const text = JSON.stringify(event).toLowerCase();
+        if (text.includes("exec_command") ||
+            text.includes("command_begin") ||
+            text.includes("command_start") ||
+            text.includes("\"type\":\"tool_call\"") ||
+            text.includes("\"type\":\"function_call\"")) {
+            count += 1;
+        }
+    }
+    return count;
+}
+function usageFromTranscript(jsonl) {
+    let latest;
+    for (const line of jsonl.split("\n")) {
+        const event = parseJsonLine(line);
+        if (!isRecord(event) || !isRecord(event.usage))
+            continue;
+        const inputTokens = event.usage.input_tokens;
+        const outputTokens = event.usage.output_tokens;
+        if (typeof inputTokens === "number" && typeof outputTokens === "number") {
+            latest = {
+                input_tokens: inputTokens,
+                output_tokens: outputTokens,
+            };
+        }
+    }
+    return latest;
+}
+function parseJsonLine(line) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return undefined;
+    }
+}
+function readOptional(path) {
+    return existsSync(path) ? readFileSync(path, "utf8") : "";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=metrics.js.map

package/dist/libs/agent-runner/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../libs/agent-runner/metrics.ts"],"names":[],"mappings":"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"}

package/dist/libs/agent-runner/types.d.ts

@@ -0,0 +1,23 @@
+export type AgentKind = "codex";
+export interface AgentRunInput {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    model: string;
+    prompt: string;
+    transcriptPath: string;
+    finalMessagePath: string;
+    proposalPath?: string;
+}
+export interface AgentRunResult {
+    agent: AgentKind;
+    model: string;
+    elapsed_ms: number;
+    tool_calls: number;
+    input_tokens: number | null;
+    output_tokens: number | null;
+    total_tokens: number | null;
+    transcript_path: string;
+    final_message_path: string;
+    exit_code: number | null;
+    signal: string | null;
+}

package/dist/libs/agent-runner/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/libs/agent-runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../libs/agent-runner/types.ts"],"names":[],"mappings":""}

package/dist/libs/config/greplica-config.d.ts

@@ -0,0 +1,24 @@
+export type EmbeddingProvider = "local" | "openai";
+export interface EmbeddingConfig {
+    provider: EmbeddingProvider;
+    model: string;
+    dimensions: number;
+    batchSize: number;
+}
+export interface GreplicaConfig {
+    version: 1;
+    embedding: EmbeddingConfig;
+}
+export interface EmbeddingConfigInput {
+    provider: EmbeddingProvider;
+    model?: string;
+    dimensions?: number;
+    batchSize?: number;
+}
+export declare const defaultGreplicaConfig: GreplicaConfig;
+export declare function defaultEmbeddingConfig(provider: EmbeddingProvider): EmbeddingConfig;
+export declare function greplicaConfigPath(): string;
+export declare function ensureGreplicaConfig(path?: string): GreplicaConfig;
+export declare function readGreplicaConfig(path?: string): GreplicaConfig;
+export declare function writeGreplicaConfig(config: GreplicaConfig, path?: string): void;
+export declare function updateEmbeddingConfig(input: EmbeddingConfigInput, path?: string): GreplicaConfig;

package/dist/libs/config/greplica-config.js

@@ -0,0 +1,121 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { greplicaHome } from "./greplica-home.js";
+const embeddingDefaults = {
+    local: {
+        provider: "local",
+        model: "all-mpnet-base-v2",
+        dimensions: 768,
+        batchSize: 16,
+    },
+    openai: {
+        provider: "openai",
+        model: "text-embedding-3-small",
+        dimensions: 1536,
+        batchSize: 100,
+    },
+};
+export const defaultGreplicaConfig = {
+    version: 1,
+    embedding: { ...embeddingDefaults.local },
+};
+export function defaultEmbeddingConfig(provider) {
+    return { ...embeddingDefaults[provider] };
+}
+export function greplicaConfigPath() {
+    return join(greplicaHome(), "config.json");
+}
+export function ensureGreplicaConfig(path = greplicaConfigPath()) {
+    if (!existsSync(path)) {
+        writeGreplicaConfig(defaultGreplicaConfig, path);
+        return cloneConfig(defaultGreplicaConfig);
+    }
+    return readGreplicaConfig(path);
+}
+export function readGreplicaConfig(path = greplicaConfigPath()) {
+    if (!existsSync(path))
+        return cloneConfig(defaultGreplicaConfig);
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Invalid Greplica config at ${path}: ${message}`);
+    }
+    return normalizeConfig(parsed, path);
+}
+export function writeGreplicaConfig(config, path = greplicaConfigPath()) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+export function updateEmbeddingConfig(input, path = greplicaConfigPath()) {
+    const base = defaultEmbeddingConfig(input.provider);
+    const config = {
+        version: 1,
+        embedding: {
+            ...base,
+            model: input.model ?? base.model,
+            dimensions: input.dimensions ?? base.dimensions,
+            batchSize: input.batchSize ?? base.batchSize,
+        },
+    };
+    writeGreplicaConfig(config, path);
+    return config;
+}
+function normalizeConfig(value, path) {
+    if (!isRecord(value))
+        throw new Error(`Invalid Greplica config at ${path}: expected an object.`);
+    const version = value.version === undefined ? 1 : value.version;
+    if (version !== 1)
+        throw new Error(`Invalid Greplica config at ${path}: unsupported version ${String(version)}.`);
+    const embeddingValue = value.embedding;
+    if (!isRecord(embeddingValue)) {
+        return cloneConfig(defaultGreplicaConfig);
+    }
+    const provider = parseProvider(embeddingValue.provider, path);
+    const defaults = defaultEmbeddingConfig(provider);
+    const model = parseString(embeddingValue.model, defaults.model, "embedding.model", path);
+    const dimensions = parsePositiveInteger(embeddingValue.dimensions, defaults.dimensions, "embedding.dimensions", path);
+    const batchSize = parsePositiveInteger(embeddingValue.batchSize, defaults.batchSize, "embedding.batchSize", path);
+    return {
+        version: 1,
+        embedding: {
+            provider,
+            model,
+            dimensions,
+            batchSize,
+        },
+    };
+}
+function parseProvider(value, path) {
+    if (value === "local" || value === "openai")
+        return value;
+    if (value === undefined)
+        return defaultGreplicaConfig.embedding.provider;
+    throw new Error(`Invalid Greplica config at ${path}: embedding.provider must be local or openai.`);
+}
+function parseString(value, fallback, field, path) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value === "string" && value.trim().length > 0)
+        return value.trim();
+    throw new Error(`Invalid Greplica config at ${path}: ${field} must be a non-empty string.`);
+}
+function parsePositiveInteger(value, fallback, field, path) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value === "number" && Number.isInteger(value) && value > 0)
+        return value;
+    throw new Error(`Invalid Greplica config at ${path}: ${field} must be a positive integer.`);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function cloneConfig(config) {
+    return {
+        version: config.version,
+        embedding: { ...config.embedding },
+    };
+}
+//# sourceMappingURL=greplica-config.js.map

package/dist/libs/config/greplica-config.js.map

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

package/dist/libs/config/greplica-home.d.ts

@@ -0,0 +1 @@
+export declare function greplicaHome(): string;

package/dist/libs/config/greplica-home.js

@@ -0,0 +1,6 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function greplicaHome() {
+    return process.env.GREPLICA_HOME ?? process.env.ENGINEERING_CONTEXT_HOME ?? join(homedir(), ".greplica");
+}
+//# sourceMappingURL=greplica-home.js.map

package/dist/libs/config/greplica-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"greplica-home.js","sourceRoot":"","sources":["../../../libs/config/greplica-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,CAAC,CAAC;AAC3G,CAAC"}

package/dist/libs/env/load-local-env.d.ts

@@ -0,0 +1,19 @@
+export declare function loadLocalEnv(file?: string): void;
+export interface LoadedEnvFile {
+    path: string;
+    loaded_keys: string[];
+    skipped_existing_keys: string[];
+}
+export interface LoadedRepoEnv {
+    repo_root: string;
+    initial_env_keys: Set<string>;
+    files: LoadedEnvFile[];
+}
+export type EnvVarSource = {
+    kind: "environment";
+} | {
+    kind: "file";
+    path: string;
+};
+export declare function loadRepoEnv(repoRoot: string): LoadedRepoEnv;
+export declare function envVarSource(name: string, env: LoadedRepoEnv): EnvVarSource | undefined;

package/dist/libs/env/load-local-env.js

@@ -0,0 +1,69 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+export function loadLocalEnv(file = ".env.local") {
+    const path = resolve(process.cwd(), file);
+    if (!existsSync(path))
+        return;
+    loadEnvFile(path);
+}
+export function loadRepoEnv(repoRoot) {
+    const initialEnvKeys = new Set(Object.keys(process.env).filter(hasEnvValue));
+    const repoEnvKeys = new Set(["OPENAI_API_KEY"]);
+    const files = [".env.local", ".env"]
+        .map((file) => loadEnvFile(resolve(repoRoot, file), repoEnvKeys))
+        .filter((file) => file !== undefined);
+    return {
+        repo_root: repoRoot,
+        initial_env_keys: initialEnvKeys,
+        files,
+    };
+}
+export function envVarSource(name, env) {
+    if (env.initial_env_keys.has(name) && hasEnvValue(name))
+        return { kind: "environment" };
+    const loadedFromFile = env.files.find((file) => file.loaded_keys.includes(name));
+    if (loadedFromFile)
+        return { kind: "file", path: loadedFromFile.path };
+    return hasEnvValue(name) ? { kind: "environment" } : undefined;
+}
+function loadEnvFile(path, allowedKeys) {
+    if (!existsSync(path))
+        return undefined;
+    const loadedKeys = [];
+    const skippedExistingKeys = [];
+    for (const line of readFileSync(path, "utf8").split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0 || trimmed.startsWith("#"))
+            continue;
+        const match = /^([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(trimmed);
+        if (!match)
+            continue;
+        const [, key, rawValue] = match;
+        if (allowedKeys && !allowedKeys.has(key))
+            continue;
+        if (hasEnvValue(key)) {
+            skippedExistingKeys.push(key);
+            continue;
+        }
+        process.env[key] = unquoteEnvValue(rawValue ?? "");
+        loadedKeys.push(key);
+    }
+    return {
+        path,
+        loaded_keys: loadedKeys,
+        skipped_existing_keys: skippedExistingKeys,
+    };
+}
+function unquoteEnvValue(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+function hasEnvValue(key) {
+    const value = process.env[key];
+    return value !== undefined && value.trim().length > 0;
+}
+//# sourceMappingURL=load-local-env.js.map

package/dist/libs/env/load-local-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-local-env.js","sourceRoot":"","sources":["../../../libs/env/load-local-env.ts"],"names":[],"mappings":"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"}

package/dist/libs/install/edit-marked-section.d.ts

@@ -0,0 +1 @@
+export declare function replaceOrAppendSection(content: string, marker: string, newSection: string): string;

package/dist/libs/install/edit-marked-section.js

@@ -0,0 +1,22 @@
+export function replaceOrAppendSection(content, marker, newSection) {
+    const section = newSection.trim();
+    if (!content.includes(marker)) {
+        return content.trim().length === 0 ? `${section}\n` : `${content.trimEnd()}\n\n${section}\n`;
+    }
+    const lines = content.split("\n");
+    const start = lines.findIndex((line) => line.includes(marker));
+    if (start < 0)
+        return `${content.trimEnd()}\n\n${section}\n`;
+    let end = lines.length;
+    for (let index = start + 1; index < lines.length; index += 1) {
+        if (lines[index].startsWith("## ")) {
+            end = index;
+            break;
+        }
+    }
+    const before = lines.slice(0, start).join("\n").trimEnd();
+    const after = lines.slice(end).join("\n").trimStart();
+    const parts = [before, section, after].filter((part) => part.length > 0);
+    return `${parts.join("\n\n")}\n`;
+}
+//# sourceMappingURL=edit-marked-section.js.map

package/dist/libs/install/edit-marked-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-marked-section.js","sourceRoot":"","sources":["../../../libs/install/edit-marked-section.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAc,EAAE,UAAkB;IACxF,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,OAAO,IAAI,CAAC;IAC/F,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,OAAO,OAAO,IAAI,CAAC;IAE7D,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,GAAG,GAAG,KAAK,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;IAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;IACtD,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzE,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;AACnC,CAAC"}

package/dist/libs/install/install.d.ts

@@ -0,0 +1,18 @@
+import type { RepoRef } from "../knowledge-graph/service.js";
+import { type InstallEmbedding, type InstallPlatform, type InstructionScope } from "./paths.js";
+export interface InstallOptions {
+    platform: InstallPlatform;
+    instructions: InstructionScope;
+    embedding: InstallEmbedding;
+    repo: RepoRef;
+}
+export interface InstallResult {
+    platform: InstallPlatform;
+    skills: string[];
+    instructionFile?: string;
+    embedding: InstallEmbedding;
+    configFile: string;
+    databasePath: string;
+    notes: string[];
+}
+export declare function installGreplica(options: InstallOptions): Promise<InstallResult>;

package/dist/libs/install/install.js

@@ -0,0 +1,80 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { envVarSource, loadRepoEnv } from "../env/load-local-env.js";
+import { greplicaConfigPath, updateEmbeddingConfig } from "../config/greplica-config.js";
+import { graphContextConfigFromGreplicaConfig } from "../knowledge-graph/graph-context/config.js";
+import { createLocalKnowledgeGraphService } from "../knowledge-graph/service.js";
+import { greplicaInstructionBlock } from "./instruction-blocks.js";
+import { replaceOrAppendSection } from "./edit-marked-section.js";
+import { packageRoot, platformPaths, skillNames, } from "./paths.js";
+export async function installGreplica(options) {
+    const projectRoot = options.repo.repo_root ?? process.cwd();
+    const paths = platformPaths(options.platform, projectRoot);
+    const skills = installSkills(paths.skillsRoot);
+    const instructionFile = installInstructions(options.instructions, paths.userInstructionFile, paths.projectInstructionFile);
+    const embedding = configureEmbedding(options.embedding, options.repo);
+    const service = createLocalKnowledgeGraphService(graphContextConfigFromGreplicaConfig(embedding.config));
+    const init = service.initRepo(options.repo);
+    const notes = [];
+    if (options.embedding === "local") {
+        notes.push("Local embeddings were configured without prewarming; the first graph-context query may download the local model.");
+    }
+    if (options.platform === "codex") {
+        notes.push("Restart Codex if the new skills do not appear immediately.");
+    }
+    else {
+        notes.push("Restart Claude Code if the new skills do not appear immediately.");
+    }
+    return {
+        platform: options.platform,
+        skills,
+        instructionFile,
+        embedding: options.embedding,
+        configFile: embedding.configPath,
+        databasePath: init.database_path,
+        notes,
+    };
+}
+function installSkills(skillsRoot) {
+    const root = packageRoot();
+    const installed = [];
+    mkdirSync(skillsRoot, { recursive: true });
+    for (const skillName of skillNames) {
+        const source = join(root, "skills", skillName);
+        if (!existsSync(join(source, "SKILL.md")))
+            throw new Error(`Bundled skill is missing: ${source}`);
+        const destination = join(skillsRoot, skillName);
+        const staged = `${destination}.tmp`;
+        rmSync(staged, { recursive: true, force: true });
+        cpSync(source, staged, { recursive: true });
+        rmSync(destination, { recursive: true, force: true });
+        renameSync(staged, destination);
+        installed.push(join(destination, "SKILL.md"));
+    }
+    return installed;
+}
+function installInstructions(scope, userFile, projectFile) {
+    if (scope === "none")
+        return undefined;
+    const file = scope === "user" ? userFile : projectFile;
+    const existing = existsSync(file) ? readFileSync(file, "utf8") : "";
+    const updated = replaceOrAppendSection(existing, "## Greplica", greplicaInstructionBlock);
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, updated, "utf8");
+    return resolve(file);
+}
+function configureEmbedding(provider, repo) {
+    const repoRoot = repo.repo_root ?? process.cwd();
+    if (provider === "openai") {
+        const env = loadRepoEnv(repoRoot);
+        if (envVarSource("OPENAI_API_KEY", env) === undefined) {
+            throw new Error("OPENAI_API_KEY is required for --embedding openai. Set it in the shell, target-root .env.local, or target-root .env.");
+        }
+    }
+    const config = updateEmbeddingConfig({ provider });
+    return {
+        config,
+        configPath: resolve(greplicaConfigPath()),
+    };
+}
+//# sourceMappingURL=install.js.map