@ramarivera/coding-agent-langfuse 0.1.48 → 0.1.51

package/README.md

@@ -54,14 +54,14 @@ real network cause, and preserves local state so reruns resume cleanly.
 ## Project tags and metadata
 
 Backfills and live followers can attach stable Langfuse dimensions based on the
-session cwd. Use this for client/workstream dashboards like ITSynch without
-guessing from host names or Windows paths in the Langfuse UI.
+session cwd. Use this for client/workstream dashboards without guessing from
+host names or Windows paths in the Langfuse UI.
 
 There are two config layers:
 
 - Global host config: `~/.config/coding-agent-langfuse/path-tags.json`
-- Optional project-local overlay: `.langfuse-ca.json` in the project directory
-  or any parent of the session cwd
+- Optional project-local overlays: every `.langfuse-ca.json` found while
+  walking from the session cwd up to the scanned home directory
 
 Global config uses prefix rules:
 
@@ -69,21 +69,23 @@ Global config uses prefix rules:
 {
   "rules": [
     {
-      "pathPrefix": "/Users/ramarivera/dev/itsynch",
-      "tags": ["itsynch", "client:itsynch"],
+      "pathPrefix": "/Users/example/dev/acme",
+      "tags": ["acme", "client:acme"],
       "metadata": {
-        "project_group": "itsynch",
-        "project_owner": "ramiro"
+        "project_group": "acme",
+        "project_owner": "platform-team"
       },
-      "projectName": "itsynch",
-      "projectFolder": "itsynch"
+      "projectName": "acme",
+      "projectFolder": "acme"
     }
   ]
 }
 ```
 
 Project-local config is intentionally smaller and overrides/extends the matched
-global rule:
+global rule. Parent overlays are applied before child overlays, so a config at
+`~/work/client-a/.langfuse-ca.json` can tag a whole workstream while nested
+repos add repo-specific fields:
 
 ```json
 {
@@ -91,7 +93,7 @@ global rule:
   "metadata": {
     "service": "portal"
   },
-  "projectName": "itsynch-portal"
+  "projectName": "acme-portal"
 }
 ```
 
@@ -112,9 +114,9 @@ npx @ramarivera/coding-agent-langfuse@latest \
   --path-tags-config "$HOME/.config/coding-agent-langfuse/path-tags.json"
 ```
 
-Generated services pass `--path-tags-config` when provided to
-`service install`; otherwise the package reads the default global config path if
-it exists.
+Generated services keep their command small and rely on the package's default
+global config plus upward project-local discovery. Use `--path-tags-config` only
+for one-off CLI runs that need a non-default global config path.
 
 ## Cost calculation
 

package/dist/backfill.d.ts

@@ -67,6 +67,7 @@ type OtlpOptions = {
     maxFieldBytes?: number;
     costRates?: CostCatalog;
     pathTagsConfig?: PathTagsConfig;
+    homeDir?: string;
 };
 type PathTagRule = {
     pathPrefix: string;

package/dist/backfill.js

@@ -196,7 +196,7 @@ function projectMetadata(cwd) {
         projectFolder: projectName,
     };
 }
-function matchPathTags(cwd, config) {
+function matchPathTags(cwd, config, homeDir) {
     if (!cwd)
         return { tags: [], metadata: {} };
     const normalizedCwd = normalizeRulePath(cwd);
@@ -218,7 +218,7 @@ function matchPathTags(cwd, config) {
     const overlays = [
         globalMatch,
         config.project,
-        loadProjectLocalOverlay(cwd),
+        ...loadProjectLocalOverlays(cwd, homeDir),
     ].filter((overlay) => overlay !== undefined);
     return overlays.reduce((acc, overlay) => {
         if (!overlay)
@@ -236,9 +236,9 @@ function matchPathTags(cwd, config) {
         projectFolder: undefined,
     });
 }
-function mergeProjectMetadata(cwd, config) {
+function mergeProjectMetadata(cwd, config, homeDir) {
     const project = projectMetadata(cwd);
-    const pathTags = matchPathTags(cwd, config);
+    const pathTags = matchPathTags(cwd, config, homeDir);
     return {
         ...project,
         projectName: pathTags.projectName ?? project.projectName,
@@ -528,10 +528,12 @@ function loadPathTagsConfig(path) {
     });
     return { rules, project: normalizeProjectTagOverlay(root, path) };
 }
-function loadProjectLocalOverlay(cwd) {
-    const configPath = findProjectLocalConfig(cwd);
-    if (!configPath)
-        return undefined;
+function loadProjectLocalOverlays(cwd, homeDir) {
+    return findProjectLocalConfigs(cwd, homeDir)
+        .map((configPath) => loadProjectLocalOverlay(configPath))
+        .filter((overlay) => overlay !== undefined);
+}
+function loadProjectLocalOverlay(configPath) {
     const cached = projectLocalConfigCache.get(configPath);
     if (projectLocalConfigCache.has(configPath))
         return cached;
@@ -545,31 +547,26 @@ function loadProjectLocalOverlay(cwd) {
     projectLocalConfigCache.set(configPath, overlay);
     return overlay;
 }
-function findProjectLocalConfig(cwd) {
-    if (!cwd)
-        return undefined;
-    let current = cwd;
-    while (true) {
-        try {
-            current = statSync(current).isDirectory() ? current : dirname(current);
-            break;
-        }
-        catch {
-            const parent = dirname(current);
-            if (parent === current)
-                return undefined;
-            current = parent;
-        }
-    }
+function findProjectLocalConfigs(cwd, homeDir) {
+    const start = nearestExistingDirectory(cwd);
+    if (!start)
+        return [];
+    const home = homeDir ? nearestExistingDirectory(homeDir) ?? homeDir : homedir();
+    const stopAtHome = isSameOrChildPath(start, home);
+    const configPaths = [];
+    let current = start;
     while (true) {
         const candidate = join(current, projectLocalConfigFile);
         if (existsSync(candidate))
-            return candidate;
+            configPaths.push(candidate);
+        if (stopAtHome && sameNormalizedPath(current, home))
+            break;
         const parent = dirname(current);
         if (parent === current)
-            return undefined;
+            break;
         current = parent;
     }
+    return configPaths.reverse();
 }
 function normalizeProjectTagOverlay(value, sourcePath) {
     const root = asRecord(value);
@@ -596,6 +593,15 @@ function normalizeRulePath(path) {
     const normalized = path.replace(/\\/g, "/").replace(/\/+$/, "");
     return /^[a-z]:\//i.test(normalized) ? normalized.toLowerCase() : normalized;
 }
+function sameNormalizedPath(left, right) {
+    return normalizeRulePath(left) === normalizeRulePath(right);
+}
+function isSameOrChildPath(child, parent) {
+    const normalizedChild = normalizeRulePath(child);
+    const normalizedParent = normalizeRulePath(parent);
+    return normalizedChild === normalizedParent ||
+        normalizedChild.startsWith(`${normalizedParent}/`);
+}
 function loadCostCatalogFromEnv() {
     let catalog = { ...defaultCostRates };
     const path = process.env.CODING_AGENT_LANGFUSE_COST_RATES_PATH ??
@@ -1868,6 +1874,7 @@ function toOtlp(events, options = {}) {
     const maxFieldBytes = options.maxFieldBytes ?? defaultMaxFieldBytes;
     const costRates = options.costRates ?? loadCostCatalogFromEnv();
     const pathTagsConfig = options.pathTagsConfig ?? { rules: [] };
+    const projectConfigHomeDir = options.homeDir ?? process.env.HOME ?? homedir();
     const spansByTrace = new Map();
     for (const rawEvent of events) {
         const event = limitEventPayload(rawEvent, maxFieldBytes);
@@ -1882,7 +1889,7 @@ function toOtlp(events, options = {}) {
         const traceStartMs = sortedEvents[0]?.startMs ?? Date.now();
         const traceEndMs = Math.max(...sortedEvents.map((event) => event.endMs ?? event.startMs + 1), traceStartMs + 1);
         const shouldEmitRootSpan = sortedEvents.some((event) => event.recordId === "session");
-        const firstProject = mergeProjectMetadata(first.cwd, pathTagsConfig);
+        const firstProject = mergeProjectMetadata(first.cwd, pathTagsConfig, projectConfigHomeDir);
         const rootAttributes = [
             attr("service.name", `agent.${first.agent}`),
             attr("deployment.environment", "local"),
@@ -1962,7 +1969,7 @@ function toOtlp(events, options = {}) {
             const generation = isGenerationEvent(event);
             const usage = usageDetails(event.usage);
             const cost = generation ? calculateCost(event, usage, costRates) : undefined;
-            const eventProject = mergeProjectMetadata(event.cwd, pathTagsConfig);
+            const eventProject = mergeProjectMetadata(event.cwd, pathTagsConfig, projectConfigHomeDir);
             const attributes = [
                 attr("service.name", `agent.${event.agent}`),
                 attr("deployment.environment", "local"),
@@ -2205,6 +2212,7 @@ async function run(options) {
                 maxFieldBytes: options.maxFieldBytes,
                 costRates: options.costRates,
                 pathTagsConfig: options.pathTagsConfig,
+                homeDir: options.homeDir,
             });
         }
         catch (error) {
@@ -2232,6 +2240,7 @@ async function run(options) {
                     maxFieldBytes: options.maxFieldBytes,
                     costRates: options.costRates,
                     pathTagsConfig: options.pathTagsConfig,
+                    homeDir: options.homeDir,
                     auth: options.auth,
                 });
                 for (const event of batch) {

package/dist/service.js

@@ -36,11 +36,11 @@ Service options:
 `;
 }
 function parseServiceArgs(argv) {
-    const action = parseServiceAction(argv[0]);
     if (argv.includes("--help") || argv.includes("-h")) {
         console.log(serviceUsage());
         process.exit(0);
     }
+    const action = parseServiceAction(argv[0]);
     let platform = currentServicePlatform();
     let agents = [...allAgents];
     let endpoint = process.env.LANGFUSE_BACKFILL_ENDPOINT ?? defaultEndpoint;
@@ -56,8 +56,7 @@ function parseServiceArgs(argv) {
         process.env.LANGFUSE_BACKFILL_COST_RATES_PATH;
     let costRatesJson = process.env.CODING_AGENT_LANGFUSE_COST_RATES_JSON ??
         process.env.LANGFUSE_BACKFILL_COST_RATES_JSON;
-    let pathTagsConfigPath = process.env.CODING_AGENT_LANGFUSE_PATH_TAGS_CONFIG ??
-        process.env.LANGFUSE_BACKFILL_PATH_TAGS_CONFIG;
+    let pathTagsConfigPath;
     let since;
     let dryRun = false;
     let start = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ramarivera/coding-agent-langfuse",
-  "version": "0.1.48",
+  "version": "0.1.51",
   "description": "Universal coding-agent Langfuse backfiller and live OTLP helpers",
   "type": "module",
   "license": "MIT",