@open330/oac-tracking 2026.2.17

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Open330
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,357 @@
+import { z } from 'zod';
+
+declare const taskSourceValues: readonly ["lint", "todo", "test-gap", "dead-code", "github-issue", "github-pr-review", "custom"];
+declare const taskComplexityValues: readonly ["trivial", "simple", "moderate", "complex"];
+declare const contributionTaskStatusValues: readonly ["success", "partial", "failed"];
+type TaskSource = (typeof taskSourceValues)[number];
+type TaskComplexity = (typeof taskComplexityValues)[number];
+type ContributionTaskStatus = (typeof contributionTaskStatusValues)[number];
+type AgentProviderId = string;
+declare const contributionTaskSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    title: z.ZodString;
+    source: z.ZodEnum<["lint", "todo", "test-gap", "dead-code", "github-issue", "github-pr-review", "custom"]>;
+    complexity: z.ZodEnum<["trivial", "simple", "moderate", "complex"]>;
+    status: z.ZodEnum<["success", "partial", "failed"]>;
+    tokensUsed: z.ZodNumber;
+    duration: z.ZodNumber;
+    filesChanged: z.ZodArray<z.ZodString, "many">;
+    pr: z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        url: z.ZodString;
+        status: z.ZodEnum<["open", "merged", "closed"]>;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    }, {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    }>>;
+    linkedIssue: z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        url: string;
+    }, {
+        number: number;
+        url: string;
+    }>>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    taskId: string;
+    title: string;
+    source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+    status: "success" | "partial" | "failed";
+    complexity: "trivial" | "simple" | "moderate" | "complex";
+    tokensUsed: number;
+    duration: number;
+    filesChanged: string[];
+    pr?: {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    } | undefined;
+    linkedIssue?: {
+        number: number;
+        url: string;
+    } | undefined;
+    error?: string | undefined;
+}, {
+    taskId: string;
+    title: string;
+    source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+    status: "success" | "partial" | "failed";
+    complexity: "trivial" | "simple" | "moderate" | "complex";
+    tokensUsed: number;
+    duration: number;
+    filesChanged: string[];
+    pr?: {
+        number: number;
+        status: "open" | "merged" | "closed";
+        url: string;
+    } | undefined;
+    linkedIssue?: {
+        number: number;
+        url: string;
+    } | undefined;
+    error?: string | undefined;
+}>;
+declare const contributionLogSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1.0">;
+    runId: z.ZodString;
+    timestamp: z.ZodString;
+    contributor: z.ZodObject<{
+        githubUsername: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        githubUsername: string;
+        email?: string | undefined;
+    }, {
+        githubUsername: string;
+        email?: string | undefined;
+    }>;
+    repo: z.ZodObject<{
+        fullName: z.ZodString;
+        headSha: z.ZodString;
+        defaultBranch: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    }, {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    }>;
+    budget: z.ZodObject<{
+        provider: z.ZodString;
+        totalTokensBudgeted: z.ZodNumber;
+        totalTokensUsed: z.ZodNumber;
+        estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    }, {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    }>;
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        title: z.ZodString;
+        source: z.ZodEnum<["lint", "todo", "test-gap", "dead-code", "github-issue", "github-pr-review", "custom"]>;
+        complexity: z.ZodEnum<["trivial", "simple", "moderate", "complex"]>;
+        status: z.ZodEnum<["success", "partial", "failed"]>;
+        tokensUsed: z.ZodNumber;
+        duration: z.ZodNumber;
+        filesChanged: z.ZodArray<z.ZodString, "many">;
+        pr: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            url: z.ZodString;
+            status: z.ZodEnum<["open", "merged", "closed"]>;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        }, {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        }>>;
+        linkedIssue: z.ZodOptional<z.ZodObject<{
+            number: z.ZodNumber;
+            url: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            number: number;
+            url: string;
+        }, {
+            number: number;
+            url: string;
+        }>>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }, {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }>, "many">;
+    metrics: z.ZodObject<{
+        tasksDiscovered: z.ZodNumber;
+        tasksAttempted: z.ZodNumber;
+        tasksSucceeded: z.ZodNumber;
+        tasksFailed: z.ZodNumber;
+        totalDuration: z.ZodNumber;
+        totalFilesChanged: z.ZodNumber;
+        totalLinesAdded: z.ZodNumber;
+        totalLinesRemoved: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    }, {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    version: "1.0";
+    runId: string;
+    timestamp: string;
+    contributor: {
+        githubUsername: string;
+        email?: string | undefined;
+    };
+    repo: {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    };
+    budget: {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    };
+    tasks: {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }[];
+    metrics: {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    };
+}, {
+    version: "1.0";
+    runId: string;
+    timestamp: string;
+    contributor: {
+        githubUsername: string;
+        email?: string | undefined;
+    };
+    repo: {
+        fullName: string;
+        headSha: string;
+        defaultBranch: string;
+    };
+    budget: {
+        provider: string;
+        totalTokensBudgeted: number;
+        totalTokensUsed: number;
+        estimatedCostUsd?: number | undefined;
+    };
+    tasks: {
+        taskId: string;
+        title: string;
+        source: "lint" | "todo" | "test-gap" | "dead-code" | "github-issue" | "github-pr-review" | "custom";
+        status: "success" | "partial" | "failed";
+        complexity: "trivial" | "simple" | "moderate" | "complex";
+        tokensUsed: number;
+        duration: number;
+        filesChanged: string[];
+        pr?: {
+            number: number;
+            status: "open" | "merged" | "closed";
+            url: string;
+        } | undefined;
+        linkedIssue?: {
+            number: number;
+            url: string;
+        } | undefined;
+        error?: string | undefined;
+    }[];
+    metrics: {
+        tasksDiscovered: number;
+        tasksAttempted: number;
+        tasksSucceeded: number;
+        tasksFailed: number;
+        totalDuration: number;
+        totalFilesChanged: number;
+        totalLinesAdded: number;
+        totalLinesRemoved: number;
+    };
+}>;
+type ContributionTask = z.infer<typeof contributionTaskSchema>;
+type ContributionLog = z.infer<typeof contributionLogSchema>;
+declare function parseContributionLog(input: unknown): ContributionLog;
+
+declare function writeContributionLog(log: ContributionLog, repoPath: string): Promise<string>;
+
+interface Leaderboard {
+    generatedAt: string;
+    entries: LeaderboardEntry[];
+    repoStats: {
+        totalContributions: number;
+        totalTokensUsed: number;
+        totalPRsCreated: number;
+        totalPRsMerged: number;
+        firstContribution: string;
+        lastContribution: string;
+    };
+}
+interface LeaderboardEntry {
+    githubUsername: string;
+    totalRuns: number;
+    totalTasksCompleted: number;
+    totalTokensDonated: number;
+    totalFilesChanged: number;
+    totalLinesChanged: number;
+    totalPRsCreated: number;
+    totalPRsMerged: number;
+    favoriteTaskSource: TaskSource;
+    firstContribution: string;
+    lastContribution: string;
+}
+declare function buildLeaderboard(repoPath: string): Promise<Leaderboard>;
+
+export { type AgentProviderId, type ContributionLog, type ContributionTask, type ContributionTaskStatus, type Leaderboard, type LeaderboardEntry, type TaskComplexity, type TaskSource, buildLeaderboard, contributionLogSchema, contributionTaskSchema, parseContributionLog, writeContributionLog };

package/dist/index.js

@@ -0,0 +1,316 @@
+// src/log-schema.ts
+import { z } from "zod";
+var taskSourceValues = [
+  "lint",
+  "todo",
+  "test-gap",
+  "dead-code",
+  "github-issue",
+  "github-pr-review",
+  "custom"
+];
+var taskComplexityValues = ["trivial", "simple", "moderate", "complex"];
+var contributionTaskStatusValues = ["success", "partial", "failed"];
+var githubUsernameSchema = z.string().min(1).max(39).regex(/^(?!-)[A-Za-z0-9-]+(?<!-)$/, "Invalid GitHub username.");
+var contributionTaskSchema = z.object({
+  taskId: z.string().min(1),
+  title: z.string().min(1),
+  source: z.enum(taskSourceValues),
+  complexity: z.enum(taskComplexityValues),
+  status: z.enum(contributionTaskStatusValues),
+  tokensUsed: z.number().int().nonnegative(),
+  duration: z.number().nonnegative(),
+  filesChanged: z.array(z.string().min(1)),
+  pr: z.object({
+    number: z.number().int().positive(),
+    url: z.string().url(),
+    status: z.enum(["open", "merged", "closed"])
+  }).optional(),
+  linkedIssue: z.object({
+    number: z.number().int().positive(),
+    url: z.string().url()
+  }).optional(),
+  error: z.string().min(1).optional()
+});
+var contributionLogSchema = z.object({
+  version: z.literal("1.0"),
+  runId: z.string().min(1),
+  timestamp: z.string().datetime({ offset: true }),
+  contributor: z.object({
+    githubUsername: githubUsernameSchema,
+    email: z.string().email().optional()
+  }),
+  repo: z.object({
+    fullName: z.string().min(1).regex(/^[^\s/]+\/[^\s/]+$/, "Expected repository in owner/repo format."),
+    headSha: z.string().regex(/^[A-Fa-f0-9]{7,40}$/, "Expected git SHA (7-40 hex chars)."),
+    defaultBranch: z.string().min(1)
+  }),
+  budget: z.object({
+    provider: z.string().min(1),
+    totalTokensBudgeted: z.number().int().nonnegative(),
+    totalTokensUsed: z.number().int().nonnegative(),
+    estimatedCostUsd: z.number().nonnegative().optional()
+  }),
+  tasks: z.array(contributionTaskSchema),
+  metrics: z.object({
+    tasksDiscovered: z.number().int().nonnegative(),
+    tasksAttempted: z.number().int().nonnegative(),
+    tasksSucceeded: z.number().int().nonnegative(),
+    tasksFailed: z.number().int().nonnegative(),
+    totalDuration: z.number().nonnegative(),
+    totalFilesChanged: z.number().int().nonnegative(),
+    totalLinesAdded: z.number().int().nonnegative(),
+    totalLinesRemoved: z.number().int().nonnegative()
+  })
+});
+function parseContributionLog(input) {
+  return contributionLogSchema.parse(input);
+}
+
+// src/logger.ts
+import { randomUUID as randomUUID2 } from "crypto";
+import { mkdir as mkdir2, rename as rename2, rm as rm2, writeFile as writeFile2 } from "fs/promises";
+import { join as join2, resolve as resolve2 } from "path";
+
+// src/leaderboard.ts
+import { randomUUID } from "crypto";
+import { mkdir, readFile, readdir, rename, rm, writeFile } from "fs/promises";
+import { join, resolve } from "path";
+var OAC_DIRECTORY = ".oac";
+var CONTRIBUTIONS_DIRECTORY = "contributions";
+var LEADERBOARD_FILENAME = "leaderboard.json";
+var EMPTY_TIMESTAMP = "";
+async function buildLeaderboard(repoPath) {
+  const repoRoot = resolve(repoPath);
+  const oacPath = join(repoRoot, OAC_DIRECTORY);
+  const contributionsPath = join(oacPath, CONTRIBUTIONS_DIRECTORY);
+  const logs = await readContributionLogs(contributionsPath);
+  const aggregates = /* @__PURE__ */ new Map();
+  const repoStats = {
+    totalContributions: logs.length,
+    totalTokensUsed: 0,
+    totalPRsCreated: 0,
+    totalPRsMerged: 0,
+    firstContribution: EMPTY_TIMESTAMP,
+    lastContribution: EMPTY_TIMESTAMP
+  };
+  for (const log of logs) {
+    const username = log.contributor.githubUsername;
+    const accumulator = aggregates.get(username) ?? createAccumulator(username, log.timestamp);
+    accumulator.totalRuns += 1;
+    accumulator.totalTasksCompleted += log.tasks.filter((task) => task.status !== "failed").length;
+    accumulator.totalTokensDonated += log.budget.totalTokensUsed;
+    accumulator.totalFilesChanged += log.metrics.totalFilesChanged;
+    accumulator.totalLinesChanged += log.metrics.totalLinesAdded + log.metrics.totalLinesRemoved;
+    accumulator.firstContribution = minIsoTimestamp(accumulator.firstContribution, log.timestamp);
+    accumulator.lastContribution = maxIsoTimestamp(accumulator.lastContribution, log.timestamp);
+    for (const task of log.tasks) {
+      if (task.pr) {
+        accumulator.totalPRsCreated += 1;
+        if (task.pr.status === "merged") {
+          accumulator.totalPRsMerged += 1;
+        }
+      }
+      accumulator.sourceCounts.set(
+        task.source,
+        (accumulator.sourceCounts.get(task.source) ?? 0) + 1
+      );
+    }
+    aggregates.set(username, accumulator);
+    repoStats.totalTokensUsed += log.budget.totalTokensUsed;
+    repoStats.firstContribution = minIsoTimestamp(repoStats.firstContribution, log.timestamp);
+    repoStats.lastContribution = maxIsoTimestamp(repoStats.lastContribution, log.timestamp);
+    repoStats.totalPRsCreated += log.tasks.filter((task) => Boolean(task.pr)).length;
+    repoStats.totalPRsMerged += log.tasks.filter((task) => task.pr?.status === "merged").length;
+  }
+  const entries = Array.from(aggregates.values()).map((entry) => ({
+    githubUsername: entry.githubUsername,
+    totalRuns: entry.totalRuns,
+    totalTasksCompleted: entry.totalTasksCompleted,
+    totalTokensDonated: entry.totalTokensDonated,
+    totalFilesChanged: entry.totalFilesChanged,
+    totalLinesChanged: entry.totalLinesChanged,
+    totalPRsCreated: entry.totalPRsCreated,
+    totalPRsMerged: entry.totalPRsMerged,
+    favoriteTaskSource: getFavoriteTaskSource(entry.sourceCounts),
+    firstContribution: entry.firstContribution,
+    lastContribution: entry.lastContribution
+  })).sort((a, b) => {
+    if (b.totalTasksCompleted !== a.totalTasksCompleted) {
+      return b.totalTasksCompleted - a.totalTasksCompleted;
+    }
+    if (b.totalRuns !== a.totalRuns) {
+      return b.totalRuns - a.totalRuns;
+    }
+    if (b.totalTokensDonated !== a.totalTokensDonated) {
+      return b.totalTokensDonated - a.totalTokensDonated;
+    }
+    return a.githubUsername.localeCompare(b.githubUsername);
+  });
+  const leaderboard = {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    entries,
+    repoStats
+  };
+  await mkdir(oacPath, { recursive: true });
+  const leaderboardPath = join(oacPath, LEADERBOARD_FILENAME);
+  const payload = `${JSON.stringify(leaderboard, null, 2)}
+`;
+  await writeFileAtomically(leaderboardPath, payload);
+  return leaderboard;
+}
+function createAccumulator(githubUsername, initialTimestamp) {
+  return {
+    githubUsername,
+    totalRuns: 0,
+    totalTasksCompleted: 0,
+    totalTokensDonated: 0,
+    totalFilesChanged: 0,
+    totalLinesChanged: 0,
+    totalPRsCreated: 0,
+    totalPRsMerged: 0,
+    firstContribution: initialTimestamp,
+    lastContribution: initialTimestamp,
+    sourceCounts: /* @__PURE__ */ new Map()
+  };
+}
+async function readContributionLogs(contributionsPath) {
+  let fileNames;
+  try {
+    const entries = await readdir(contributionsPath, { withFileTypes: true, encoding: "utf8" });
+    fileNames = entries.filter((entry) => entry.isFile() && entry.name.endsWith(".json")).map((entry) => entry.name).sort();
+  } catch (error) {
+    if (isFileNotFoundError(error)) {
+      return [];
+    }
+    throw error;
+  }
+  const logs = await Promise.all(
+    fileNames.map(async (fileName) => {
+      const filePath = join(contributionsPath, fileName);
+      try {
+        const fileContent = await readFile(filePath, "utf8");
+        const parsedJson = JSON.parse(fileContent);
+        const parsedLog = contributionLogSchema.safeParse(parsedJson);
+        if (!parsedLog.success) {
+          console.warn(
+            `[tracking] Skipping invalid contribution log "${fileName}": ${parsedLog.error.issues[0]?.message ?? "Schema validation failed."}`
+          );
+          return null;
+        }
+        return parsedLog.data;
+      } catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown read error";
+        console.warn(`[tracking] Skipping unreadable contribution log "${fileName}": ${message}`);
+        return null;
+      }
+    })
+  );
+  return logs.filter((log) => log !== null);
+}
+function getFavoriteTaskSource(sourceCounts) {
+  if (sourceCounts.size === 0) {
+    return "custom";
+  }
+  let favorite = "custom";
+  let favoriteCount = -1;
+  for (const [source, count] of sourceCounts.entries()) {
+    if (count > favoriteCount) {
+      favorite = source;
+      favoriteCount = count;
+      continue;
+    }
+    if (count === favoriteCount && source.localeCompare(favorite) < 0) {
+      favorite = source;
+    }
+  }
+  return favorite;
+}
+function minIsoTimestamp(a, b) {
+  if (!a) {
+    return b;
+  }
+  if (!b) {
+    return a;
+  }
+  return Date.parse(a) <= Date.parse(b) ? a : b;
+}
+function maxIsoTimestamp(a, b) {
+  if (!a) {
+    return b;
+  }
+  if (!b) {
+    return a;
+  }
+  return Date.parse(a) >= Date.parse(b) ? a : b;
+}
+function isFileNotFoundError(error) {
+  if (typeof error !== "object" || error === null) {
+    return false;
+  }
+  const code = error.code;
+  return code === "ENOENT";
+}
+async function writeFileAtomically(destinationPath, content) {
+  const tempPath = `${destinationPath}.${process.pid}.${randomUUID()}.tmp`;
+  try {
+    await writeFile(tempPath, content, { encoding: "utf8", flag: "wx" });
+    await rename(tempPath, destinationPath);
+  } finally {
+    await rm(tempPath, { force: true });
+  }
+}
+
+// src/logger.ts
+var OAC_DIRECTORY2 = ".oac";
+var CONTRIBUTIONS_DIRECTORY2 = "contributions";
+async function writeContributionLog(log, repoPath) {
+  const parsedLog = contributionLogSchema.parse(log);
+  const contributionsPath = resolve2(repoPath, OAC_DIRECTORY2, CONTRIBUTIONS_DIRECTORY2);
+  await mkdir2(contributionsPath, { recursive: true });
+  const timestamp = formatFileTimestamp(parsedLog.timestamp);
+  const username = toSafeFilenameSegment(parsedLog.contributor.githubUsername);
+  const filename = `${timestamp}-${username}.json`;
+  const filePath = join2(contributionsPath, filename);
+  const payload = `${JSON.stringify(parsedLog, null, 2)}
+`;
+  await writeFileAtomically2(filePath, payload);
+  try {
+    await buildLeaderboard(repoPath);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "Unknown leaderboard error";
+    console.warn(`[tracking] Contribution log written, but leaderboard refresh failed: ${message}`);
+  }
+  return filePath;
+}
+function formatFileTimestamp(timestamp) {
+  const date = new Date(timestamp);
+  const yyyy = String(date.getUTCFullYear());
+  const mm = String(date.getUTCMonth() + 1).padStart(2, "0");
+  const dd = String(date.getUTCDate()).padStart(2, "0");
+  const hh = String(date.getUTCHours()).padStart(2, "0");
+  const min = String(date.getUTCMinutes()).padStart(2, "0");
+  const sec = String(date.getUTCSeconds()).padStart(2, "0");
+  return `${yyyy}-${mm}-${dd}-${hh}${min}${sec}`;
+}
+function toSafeFilenameSegment(value) {
+  const sanitized = value.trim().replace(/[^A-Za-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return sanitized || "unknown";
+}
+async function writeFileAtomically2(destinationPath, content) {
+  const tempPath = `${destinationPath}.${process.pid}.${randomUUID2()}.tmp`;
+  try {
+    await writeFile2(tempPath, content, { encoding: "utf8", flag: "wx" });
+    await rename2(tempPath, destinationPath);
+  } finally {
+    await rm2(tempPath, { force: true });
+  }
+}
+export {
+  buildLeaderboard,
+  contributionLogSchema,
+  contributionTaskSchema,
+  parseContributionLog,
+  writeContributionLog
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/log-schema.ts","../src/logger.ts","../src/leaderboard.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport const taskSourceValues = [\n  \"lint\",\n  \"todo\",\n  \"test-gap\",\n  \"dead-code\",\n  \"github-issue\",\n  \"github-pr-review\",\n  \"custom\",\n] as const;\n\nexport const taskComplexityValues = [\"trivial\", \"simple\", \"moderate\", \"complex\"] as const;\n\nexport const contributionTaskStatusValues = [\"success\", \"partial\", \"failed\"] as const;\n\nexport type TaskSource = (typeof taskSourceValues)[number];\nexport type TaskComplexity = (typeof taskComplexityValues)[number];\nexport type ContributionTaskStatus = (typeof contributionTaskStatusValues)[number];\nexport type AgentProviderId = string;\n\nconst githubUsernameSchema = z\n  .string()\n  .min(1)\n  .max(39)\n  .regex(/^(?!-)[A-Za-z0-9-]+(?<!-)$/, \"Invalid GitHub username.\");\n\nexport const contributionTaskSchema = z.object({\n  taskId: z.string().min(1),\n  title: z.string().min(1),\n  source: z.enum(taskSourceValues),\n  complexity: z.enum(taskComplexityValues),\n  status: z.enum(contributionTaskStatusValues),\n  tokensUsed: z.number().int().nonnegative(),\n  duration: z.number().nonnegative(),\n  filesChanged: z.array(z.string().min(1)),\n  pr: z\n    .object({\n      number: z.number().int().positive(),\n      url: z.string().url(),\n      status: z.enum([\"open\", \"merged\", \"closed\"]),\n    })\n    .optional(),\n  linkedIssue: z\n    .object({\n      number: z.number().int().positive(),\n      url: z.string().url(),\n    })\n    .optional(),\n  error: z.string().min(1).optional(),\n});\n\nexport const contributionLogSchema = z.object({\n  version: z.literal(\"1.0\"),\n  runId: z.string().min(1),\n  timestamp: z.string().datetime({ offset: true }),\n  contributor: z.object({\n    githubUsername: githubUsernameSchema,\n    email: z.string().email().optional(),\n  }),\n  repo: z.object({\n    fullName: z\n      .string()\n      .min(1)\n      .regex(/^[^\\s/]+\\/[^\\s/]+$/, \"Expected repository in owner/repo format.\"),\n    headSha: z.string().regex(/^[A-Fa-f0-9]{7,40}$/, \"Expected git SHA (7-40 hex chars).\"),\n    defaultBranch: z.string().min(1),\n  }),\n  budget: z.object({\n    provider: z.string().min(1),\n    totalTokensBudgeted: z.number().int().nonnegative(),\n    totalTokensUsed: z.number().int().nonnegative(),\n    estimatedCostUsd: z.number().nonnegative().optional(),\n  }),\n  tasks: z.array(contributionTaskSchema),\n  metrics: z.object({\n    tasksDiscovered: z.number().int().nonnegative(),\n    tasksAttempted: z.number().int().nonnegative(),\n    tasksSucceeded: z.number().int().nonnegative(),\n    tasksFailed: z.number().int().nonnegative(),\n    totalDuration: z.number().nonnegative(),\n    totalFilesChanged: z.number().int().nonnegative(),\n    totalLinesAdded: z.number().int().nonnegative(),\n    totalLinesRemoved: z.number().int().nonnegative(),\n  }),\n});\n\nexport type ContributionTask = z.infer<typeof contributionTaskSchema>;\nexport type ContributionLog = z.infer<typeof contributionLogSchema>;\n\nexport function parseContributionLog(input: unknown): ContributionLog {\n  return contributionLogSchema.parse(input);\n}\n","import { randomUUID } from \"node:crypto\";\nimport { mkdir, rename, rm, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\n\nimport { buildLeaderboard } from \"./leaderboard.js\";\nimport { type ContributionLog, contributionLogSchema } from \"./log-schema.js\";\n\nconst OAC_DIRECTORY = \".oac\";\nconst CONTRIBUTIONS_DIRECTORY = \"contributions\";\n\nexport async function writeContributionLog(\n  log: ContributionLog,\n  repoPath: string,\n): Promise<string> {\n  const parsedLog = contributionLogSchema.parse(log);\n  const contributionsPath = resolve(repoPath, OAC_DIRECTORY, CONTRIBUTIONS_DIRECTORY);\n\n  await mkdir(contributionsPath, { recursive: true });\n\n  const timestamp = formatFileTimestamp(parsedLog.timestamp);\n  const username = toSafeFilenameSegment(parsedLog.contributor.githubUsername);\n  const filename = `${timestamp}-${username}.json`;\n  const filePath = join(contributionsPath, filename);\n\n  const payload = `${JSON.stringify(parsedLog, null, 2)}\\n`;\n  await writeFileAtomically(filePath, payload);\n  try {\n    await buildLeaderboard(repoPath);\n  } catch (error) {\n    const message = error instanceof Error ? error.message : \"Unknown leaderboard error\";\n    console.warn(`[tracking] Contribution log written, but leaderboard refresh failed: ${message}`);\n  }\n\n  return filePath;\n}\n\nfunction formatFileTimestamp(timestamp: string): string {\n  const date = new Date(timestamp);\n  const yyyy = String(date.getUTCFullYear());\n  const mm = String(date.getUTCMonth() + 1).padStart(2, \"0\");\n  const dd = String(date.getUTCDate()).padStart(2, \"0\");\n  const hh = String(date.getUTCHours()).padStart(2, \"0\");\n  const min = String(date.getUTCMinutes()).padStart(2, \"0\");\n  const sec = String(date.getUTCSeconds()).padStart(2, \"0\");\n\n  return `${yyyy}-${mm}-${dd}-${hh}${min}${sec}`;\n}\n\nfunction toSafeFilenameSegment(value: string): string {\n  const sanitized = value\n    .trim()\n    .replace(/[^A-Za-z0-9-]/g, \"-\")\n    .replace(/-+/g, \"-\")\n    .replace(/^-|-$/g, \"\");\n\n  return sanitized || \"unknown\";\n}\n\nasync function writeFileAtomically(destinationPath: string, content: string): Promise<void> {\n  const tempPath = `${destinationPath}.${process.pid}.${randomUUID()}.tmp`;\n\n  try {\n    await writeFile(tempPath, content, { encoding: \"utf8\", flag: \"wx\" });\n    await rename(tempPath, destinationPath);\n  } finally {\n    await rm(tempPath, { force: true });\n  }\n}\n","import { randomUUID } from \"node:crypto\";\nimport { mkdir, readFile, readdir, rename, rm, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\n\nimport { type ContributionLog, type TaskSource, contributionLogSchema } from \"./log-schema.js\";\n\nconst OAC_DIRECTORY = \".oac\";\nconst CONTRIBUTIONS_DIRECTORY = \"contributions\";\nconst LEADERBOARD_FILENAME = \"leaderboard.json\";\nconst EMPTY_TIMESTAMP = \"\";\n\ninterface LeaderboardAccumulator {\n  githubUsername: string;\n  totalRuns: number;\n  totalTasksCompleted: number;\n  totalTokensDonated: number;\n  totalFilesChanged: number;\n  totalLinesChanged: number;\n  totalPRsCreated: number;\n  totalPRsMerged: number;\n  firstContribution: string;\n  lastContribution: string;\n  sourceCounts: Map<TaskSource, number>;\n}\n\nexport interface Leaderboard {\n  generatedAt: string;\n  entries: LeaderboardEntry[];\n  repoStats: {\n    totalContributions: number;\n    totalTokensUsed: number;\n    totalPRsCreated: number;\n    totalPRsMerged: number;\n    firstContribution: string;\n    lastContribution: string;\n  };\n}\n\nexport interface LeaderboardEntry {\n  githubUsername: string;\n  totalRuns: number;\n  totalTasksCompleted: number;\n  totalTokensDonated: number;\n  totalFilesChanged: number;\n  totalLinesChanged: number;\n  totalPRsCreated: number;\n  totalPRsMerged: number;\n  favoriteTaskSource: TaskSource;\n  firstContribution: string;\n  lastContribution: string;\n}\n\nexport async function buildLeaderboard(repoPath: string): Promise<Leaderboard> {\n  const repoRoot = resolve(repoPath);\n  const oacPath = join(repoRoot, OAC_DIRECTORY);\n  const contributionsPath = join(oacPath, CONTRIBUTIONS_DIRECTORY);\n  const logs = await readContributionLogs(contributionsPath);\n\n  const aggregates = new Map<string, LeaderboardAccumulator>();\n  const repoStats = {\n    totalContributions: logs.length,\n    totalTokensUsed: 0,\n    totalPRsCreated: 0,\n    totalPRsMerged: 0,\n    firstContribution: EMPTY_TIMESTAMP,\n    lastContribution: EMPTY_TIMESTAMP,\n  };\n\n  for (const log of logs) {\n    const username = log.contributor.githubUsername;\n    const accumulator = aggregates.get(username) ?? createAccumulator(username, log.timestamp);\n\n    accumulator.totalRuns += 1;\n    accumulator.totalTasksCompleted += log.tasks.filter((task) => task.status !== \"failed\").length;\n    accumulator.totalTokensDonated += log.budget.totalTokensUsed;\n    accumulator.totalFilesChanged += log.metrics.totalFilesChanged;\n    accumulator.totalLinesChanged += log.metrics.totalLinesAdded + log.metrics.totalLinesRemoved;\n    accumulator.firstContribution = minIsoTimestamp(accumulator.firstContribution, log.timestamp);\n    accumulator.lastContribution = maxIsoTimestamp(accumulator.lastContribution, log.timestamp);\n\n    for (const task of log.tasks) {\n      if (task.pr) {\n        accumulator.totalPRsCreated += 1;\n        if (task.pr.status === \"merged\") {\n          accumulator.totalPRsMerged += 1;\n        }\n      }\n\n      accumulator.sourceCounts.set(\n        task.source,\n        (accumulator.sourceCounts.get(task.source) ?? 0) + 1,\n      );\n    }\n\n    aggregates.set(username, accumulator);\n\n    repoStats.totalTokensUsed += log.budget.totalTokensUsed;\n    repoStats.firstContribution = minIsoTimestamp(repoStats.firstContribution, log.timestamp);\n    repoStats.lastContribution = maxIsoTimestamp(repoStats.lastContribution, log.timestamp);\n    repoStats.totalPRsCreated += log.tasks.filter((task) => Boolean(task.pr)).length;\n    repoStats.totalPRsMerged += log.tasks.filter((task) => task.pr?.status === \"merged\").length;\n  }\n\n  const entries: LeaderboardEntry[] = Array.from(aggregates.values())\n    .map((entry) => ({\n      githubUsername: entry.githubUsername,\n      totalRuns: entry.totalRuns,\n      totalTasksCompleted: entry.totalTasksCompleted,\n      totalTokensDonated: entry.totalTokensDonated,\n      totalFilesChanged: entry.totalFilesChanged,\n      totalLinesChanged: entry.totalLinesChanged,\n      totalPRsCreated: entry.totalPRsCreated,\n      totalPRsMerged: entry.totalPRsMerged,\n      favoriteTaskSource: getFavoriteTaskSource(entry.sourceCounts),\n      firstContribution: entry.firstContribution,\n      lastContribution: entry.lastContribution,\n    }))\n    .sort((a, b) => {\n      if (b.totalTasksCompleted !== a.totalTasksCompleted) {\n        return b.totalTasksCompleted - a.totalTasksCompleted;\n      }\n      if (b.totalRuns !== a.totalRuns) {\n        return b.totalRuns - a.totalRuns;\n      }\n      if (b.totalTokensDonated !== a.totalTokensDonated) {\n        return b.totalTokensDonated - a.totalTokensDonated;\n      }\n      return a.githubUsername.localeCompare(b.githubUsername);\n    });\n\n  const leaderboard: Leaderboard = {\n    generatedAt: new Date().toISOString(),\n    entries,\n    repoStats,\n  };\n\n  await mkdir(oacPath, { recursive: true });\n  const leaderboardPath = join(oacPath, LEADERBOARD_FILENAME);\n  const payload = `${JSON.stringify(leaderboard, null, 2)}\\n`;\n  await writeFileAtomically(leaderboardPath, payload);\n\n  return leaderboard;\n}\n\nfunction createAccumulator(\n  githubUsername: string,\n  initialTimestamp: string,\n): LeaderboardAccumulator {\n  return {\n    githubUsername,\n    totalRuns: 0,\n    totalTasksCompleted: 0,\n    totalTokensDonated: 0,\n    totalFilesChanged: 0,\n    totalLinesChanged: 0,\n    totalPRsCreated: 0,\n    totalPRsMerged: 0,\n    firstContribution: initialTimestamp,\n    lastContribution: initialTimestamp,\n    sourceCounts: new Map<TaskSource, number>(),\n  };\n}\n\nasync function readContributionLogs(contributionsPath: string): Promise<ContributionLog[]> {\n  let fileNames: string[];\n  try {\n    const entries = await readdir(contributionsPath, { withFileTypes: true, encoding: \"utf8\" });\n    fileNames = entries\n      .filter((entry) => entry.isFile() && entry.name.endsWith(\".json\"))\n      .map((entry) => entry.name)\n      .sort();\n  } catch (error) {\n    if (isFileNotFoundError(error)) {\n      return [];\n    }\n    throw error;\n  }\n\n  const logs = await Promise.all(\n    fileNames.map(async (fileName): Promise<ContributionLog | null> => {\n      const filePath = join(contributionsPath, fileName);\n\n      try {\n        const fileContent = await readFile(filePath, \"utf8\");\n        const parsedJson = JSON.parse(fileContent) as unknown;\n        const parsedLog = contributionLogSchema.safeParse(parsedJson);\n\n        if (!parsedLog.success) {\n          console.warn(\n            `[tracking] Skipping invalid contribution log \"${fileName}\": ${parsedLog.error.issues[0]?.message ?? \"Schema validation failed.\"}`,\n          );\n          return null;\n        }\n\n        return parsedLog.data;\n      } catch (error) {\n        const message = error instanceof Error ? error.message : \"Unknown read error\";\n        console.warn(`[tracking] Skipping unreadable contribution log \"${fileName}\": ${message}`);\n        return null;\n      }\n    }),\n  );\n\n  return logs.filter((log): log is ContributionLog => log !== null);\n}\n\nfunction getFavoriteTaskSource(sourceCounts: Map<TaskSource, number>): TaskSource {\n  if (sourceCounts.size === 0) {\n    return \"custom\";\n  }\n\n  let favorite: TaskSource = \"custom\";\n  let favoriteCount = -1;\n\n  for (const [source, count] of sourceCounts.entries()) {\n    if (count > favoriteCount) {\n      favorite = source;\n      favoriteCount = count;\n      continue;\n    }\n\n    if (count === favoriteCount && source.localeCompare(favorite) < 0) {\n      favorite = source;\n    }\n  }\n\n  return favorite;\n}\n\nfunction minIsoTimestamp(a: string, b: string): string {\n  if (!a) {\n    return b;\n  }\n  if (!b) {\n    return a;\n  }\n  return Date.parse(a) <= Date.parse(b) ? a : b;\n}\n\nfunction maxIsoTimestamp(a: string, b: string): string {\n  if (!a) {\n    return b;\n  }\n  if (!b) {\n    return a;\n  }\n  return Date.parse(a) >= Date.parse(b) ? a : b;\n}\n\nfunction isFileNotFoundError(error: unknown): boolean {\n  if (typeof error !== \"object\" || error === null) {\n    return false;\n  }\n\n  const code = (error as { code?: unknown }).code;\n  return code === \"ENOENT\";\n}\n\nasync function writeFileAtomically(destinationPath: string, content: string): Promise<void> {\n  const tempPath = `${destinationPath}.${process.pid}.${randomUUID()}.tmp`;\n\n  try {\n    await writeFile(tempPath, content, { encoding: \"utf8\", flag: \"wx\" });\n    await rename(tempPath, destinationPath);\n  } finally {\n    await rm(tempPath, { force: true });\n  }\n}\n"],"mappings":"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","names":["randomUUID","mkdir","rename","rm","writeFile","join","resolve","OAC_DIRECTORY","CONTRIBUTIONS_DIRECTORY","resolve","mkdir","join","writeFileAtomically","randomUUID","writeFile","rename","rm"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@open330/oac-tracking",
+  "version": "2026.2.17",
+  "description": "Contribution logging and leaderboard tracking for OAC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Open330/open-agent-contribution.git",
+    "directory": "packages/tracking"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {
+    "zod": "^3.24.2",
+    "@open330/oac-core": "2026.2.17"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.6",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}